Skip to content

v2.0.0

Latest

Choose a tag to compare

@nik-solcast nik-solcast released this 22 Jul 06:55
· 7 commits to main since this release
7eea3be

What's Changed

BREAKING CHANGES

  • Method naming changes across all client classes for consistency

    • Standardized naming pattern: {Method}{ContextPrefix}{Resource} (e.g., GetForecastAdvancedPvPower)
    • LiveClient method names now properly prefixed with "Live":
      • GetAdvancedPvPowerGetLiveAdvancedPvPower
      • GetAggregationsGetLiveAggregations
      • GetRooftopPvPowerGetLiveRooftopPvPower
      • GetRadiationAndWeatherGetLiveRadiationAndWeather
    • ForecastClient method names now properly prefixed with "Forecast":
      • GetAdvancedPvPowerGetForecastAdvancedPvPower
      • GetAggregationsGetForecastAggregations
      • GetRooftopPvPowerGetForecastRooftopPvPower
      • GetRadiationAndWeatherGetForecastRadiationAndWeather
    • HistoricClient method names now properly prefixed with "Historic":
      • GetAdvancedPvPowerGetHistoricAdvancedPvPower
      • GetRooftopPvPowerGetHistoricRooftopPvPower
      • GetRadiationAndWeatherGetHistoricRadiationAndWeather
    • TmyClient method names now properly prefixed with "Tmy":
      • GetAdvancedPvPowerGetTmyAdvancedPvPower
      • GetRooftopPvPowerGetTmyRooftopPvPower
      • GetRadiationAndWeatherGetTmyRadiationAndWeather
  • SDK update checking is now opt-in instead of opt-out

    • Changed default checkForUpdates parameter from true to false in BaseClient constructor
    • Environment variable renamed from SUPPRESS_SDK_UPDATE_CHECK to CHECK_SDK_UPDATE
    • Function renamed from IsSdkUpdateCheckSuppressed() to IsSdkUpdateCheckEnabled()
    • Update logic changed from suppression-based (default ON) to enablement-based (default OFF)
    • Updated user message to reflect opt-in nature: "Automatic update checks are opt-in. Enable by setting CHECK_SDK_UPDATE='true'"

Added

  • Support for verbose output control via SOLCAST_VERBOSE_OUTPUT environment variable
    • When set to true, API responses are logged to stderr for debugging and MCP scenarios
    • Default behavior remains silent for normal usage

Improved

  • Enhanced error handling and exception management
    • Added comprehensive try-catch blocks to all API methods
    • Improved parameter details in error messages for better debugging
    • Added proper HTTP status code reporting in exceptions
    • Maintained proper exception hierarchy (UnauthorizedApiKeyException, HttpRequestException, etc.)

Full Changelog: v1.0.2...v2.0.0