@enyo-energy/energy-app-sdk 0.0.59 → 0.0.60

package/dist/cjs/energy-app-permission.type.cjs

@@ -24,4 +24,10 @@ var EnergyAppPermissionTypeEnum;
     EnergyAppPermissionTypeEnum["Timeseries"] = "Timeseries";
     EnergyAppPermissionTypeEnum["EnergyManagerInfo"] = "EnergyManagerInfo";
     EnergyAppPermissionTypeEnum["ElectricityTariff"] = "ElectricityTariff";
+    EnergyAppPermissionTypeEnum["WeatherForecastRegister"] = "WeatherForecastRegister";
+    EnergyAppPermissionTypeEnum["WeatherForecastUse"] = "WeatherForecastUse";
+    EnergyAppPermissionTypeEnum["PvForecastRegister"] = "PvForecastRegister";
+    EnergyAppPermissionTypeEnum["PvForecastUse"] = "PvForecastUse";
+    EnergyAppPermissionTypeEnum["PvSystemRegister"] = "PvSystemRegister";
+    EnergyAppPermissionTypeEnum["PvSystemUse"] = "PvSystemUse";
 })(EnergyAppPermissionTypeEnum || (exports.EnergyAppPermissionTypeEnum = EnergyAppPermissionTypeEnum = {}));

package/dist/cjs/energy-app-permission.type.d.cts

@@ -1,4 +1,4 @@
-export type EnergyAppPermissionType = 'RestrictedInternetAccess' | 'NetworkDeviceDiscovery' | 'NetworkDeviceSearch' | 'NetworkDeviceAccess' | 'Modbus' | 'Storage' | 'Appliance' | 'AllAppliances' | 'SendDataBusValues' | 'SubscribeDataBus' | 'SendDataBusCommands' | 'OcppServer' | 'ChargingCard' | 'Vehicle' | 'Charge' | 'SecretManager' | 'LocationZipCode' | 'LocationCoordinates' | 'Timeseries' | 'EnergyManagerInfo' | 'ElectricityTariff';
+export type EnergyAppPermissionType = 'RestrictedInternetAccess' | 'NetworkDeviceDiscovery' | 'NetworkDeviceSearch' | 'NetworkDeviceAccess' | 'Modbus' | 'Storage' | 'Appliance' | 'AllAppliances' | 'SendDataBusValues' | 'SubscribeDataBus' | 'SendDataBusCommands' | 'OcppServer' | 'ChargingCard' | 'Vehicle' | 'Charge' | 'SecretManager' | 'LocationZipCode' | 'LocationCoordinates' | 'Timeseries' | 'EnergyManagerInfo' | 'ElectricityTariff' | 'WeatherForecastRegister' | 'WeatherForecastUse' | 'PvForecastRegister' | 'PvForecastUse' | 'PvSystemRegister' | 'PvSystemUse';
 export declare enum EnergyAppPermissionTypeEnum {
     RestrictedInternetAccess = "RestrictedInternetAccess",
     NetworkDeviceDiscovery = "NetworkDeviceDiscovery",
@@ -20,5 +20,11 @@ export declare enum EnergyAppPermissionTypeEnum {
     LocationCoordinates = "LocationCoordinates",
     Timeseries = "Timeseries",
     EnergyManagerInfo = "EnergyManagerInfo",
-    ElectricityTariff = "ElectricityTariff"
+    ElectricityTariff = "ElectricityTariff",
+    WeatherForecastRegister = "WeatherForecastRegister",
+    WeatherForecastUse = "WeatherForecastUse",
+    PvForecastRegister = "PvForecastRegister",
+    PvForecastUse = "PvForecastUse",
+    PvSystemRegister = "PvSystemRegister",
+    PvSystemUse = "PvSystemUse"
 }

package/dist/cjs/enyo-energy-app-sdk.d.cts

@@ -19,6 +19,9 @@ import { EnergyAppTimeseries } from "./packages/energy-app-timeseries.cjs";
 import { EnyoPackageChannel } from "./enyo-package-channel.cjs";
 import { EnergyAppEnergyManager } from "./packages/energy-app-energy-manager.cjs";
 import { EnergyAppElectricityTariff } from "./packages/energy-app-electricity-tariff.cjs";
+import { EnergyAppWeatherForecasting } from "./packages/energy-app-weather-forecasting.cjs";
+import { EnergyAppPvForecasting } from "./packages/energy-app-pv-forecasting.cjs";
+import { EnergyAppPvSystem } from "./packages/energy-app-pv-system.cjs";
 export declare enum EnergyAppStateEnum {
     Launching = "launching",
     Running = "running",
@@ -34,7 +37,7 @@ export declare enum EnergyAppStateEnum {
  */
 export interface EnyoEnergyAppSdk {
     /** Register a callback that gets called when the package is initialized */
-    register: (callback: (packageName: string, version: number, channel: EnyoPackageChannel) => void) => void;
+    register: (callback: (packageName: string, version: number, channel: EnyoPackageChannel) => void | Promise<void>) => void;
     /** Register a callback that gets called when the system is shutting down */
     onShutdown: (callback: () => Promise<void>) => void;
     /** Update the state of the Energy App. Default state set is launching*/
@@ -83,4 +86,10 @@ export interface EnyoEnergyAppSdk {
     useEnergyManager: () => EnergyAppEnergyManager;
     /** Get the Electricity Tariff API for managing electricity tariffs */
     useElectricityTariff: () => EnergyAppElectricityTariff;
+    /** Get the Weather Forecasting API for managing weather forecast providers and retrieving weather forecasts */
+    useWeatherForecasting: () => EnergyAppWeatherForecasting;
+    /** Get the PV Forecasting API for managing PV forecast providers and retrieving PV forecasts */
+    usePvForecasting: () => EnergyAppPvForecasting;
+    /** Get the PV System API for managing PV system registrations and configurations */
+    usePvSystem: () => EnergyAppPvSystem;
 }

package/dist/cjs/implementations/data-bus/data-bus-command-handler.cjs

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataBusCommandHandler = exports.CommandTimeoutError = void 0;
+const enyo_data_bus_value_js_1 = require("../../types/enyo-data-bus-value.cjs");
+/**
+ * Error thrown when a command does not receive an acknowledgment within the configured timeout.
+ */
+class CommandTimeoutError extends Error {
+    /**
+     * The ID of the command message that timed out.
+     */
+    messageId;
+    /**
+     * The timeout duration in milliseconds that was exceeded.
+     */
+    timeoutMs;
+    /**
+     * Creates a new CommandTimeoutError.
+     * @param messageId - The ID of the command message that timed out
+     * @param timeoutMs - The timeout duration in milliseconds
+     */
+    constructor(messageId, timeoutMs) {
+        super(`Command ${messageId} timed out after ${timeoutMs}ms without acknowledgment`);
+        this.name = 'CommandTimeoutError';
+        this.messageId = messageId;
+        this.timeoutMs = timeoutMs;
+    }
+}
+exports.CommandTimeoutError = CommandTimeoutError;
+/**
+ * Utility class that wraps an {@link EnergyAppDataBus} to provide promise-based command sending
+ * with automatic acknowledgment matching and timeout handling.
+ *
+ * Commands are sent via the data bus and the handler waits for a matching
+ * {@link EnyoDataBusMessageEnum.CommandAcknowledgeV1} message. The returned promise resolves
+ * with the acknowledgment for all answer types (Accepted, Rejected, NotSupported) — the
+ * consumer is responsible for inspecting the `data.answer` field. The promise only rejects
+ * on timeout or when {@link dispose} is called.
+ *
+ * @example
+ * ```typescript
+ * const commandHandler = new DataBusCommandHandler(energyApp.useDataBus());
+ *
+ * try {
+ *     const ack = await commandHandler.sendCommand(myStartChargeCommand);
+ *     if (ack.data.answer === EnyoCommandAcknowledgeAnswerEnum.Accepted) {
+ *         console.log('Command accepted');
+ *     } else {
+ *         console.log('Rejected:', ack.data.rejectionReason);
+ *     }
+ * } catch (error) {
+ *     if (error instanceof CommandTimeoutError) {
+ *         console.error('No acknowledgment within timeout');
+ *     }
+ * }
+ *
+ * // Clean up when done
+ * commandHandler.dispose();
+ * ```
+ */
+class DataBusCommandHandler {
+    dataBus;
+    defaultTimeoutMs;
+    pendingCommands = new Map();
+    listenerId;
+    disposed = false;
+    /**
+     * Creates a new DataBusCommandHandler.
+     * @param dataBus - The data bus instance to send commands through and listen for acknowledgments on
+     * @param options - Optional configuration options
+     */
+    constructor(dataBus, options) {
+        this.dataBus = dataBus;
+        this.defaultTimeoutMs = options?.defaultTimeoutMs ?? 10_000;
+        this.listenerId = this.dataBus.listenForMessages([enyo_data_bus_value_js_1.EnyoDataBusMessageEnum.CommandAcknowledgeV1], (entry) => this.handleAcknowledge(entry));
+    }
+    /**
+     * Sends a command message on the data bus and waits for its acknowledgment.
+     *
+     * The returned promise resolves with the {@link EnyoDataBusCommandAcknowledgeV1} for all
+     * acknowledgment answer types (Accepted, Rejected, NotSupported). It only rejects when:
+     * - The timeout is exceeded (throws {@link CommandTimeoutError})
+     * - The handler has been disposed
+     *
+     * @param command - The command message to send. Its `id` field is used to correlate
+     *   the acknowledgment response.
+     * @param options - Optional per-call options to override the default timeout
+     * @returns A promise that resolves with the command acknowledgment
+     * @throws {CommandTimeoutError} If no acknowledgment is received within the timeout
+     * @throws {Error} If the handler has been disposed
+     */
+    sendCommand(command, options) {
+        if (this.disposed) {
+            return Promise.reject(new Error('DataBusCommandHandler has been disposed'));
+        }
+        const timeoutMs = options?.timeoutMs ?? this.defaultTimeoutMs;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pendingCommands.delete(command.id);
+                reject(new CommandTimeoutError(command.id, timeoutMs));
+            }, timeoutMs);
+            // Store the pending entry BEFORE calling sendMessage to handle
+            // synchronous acknowledgment (e.g. DemoDataBus notifies listeners inline).
+            this.pendingCommands.set(command.id, { resolve, reject, timer });
+            this.dataBus.sendMessage([command]);
+        });
+    }
+    /**
+     * Disposes the command handler by unsubscribing from the data bus,
+     * rejecting all pending commands, and clearing internal state.
+     *
+     * After calling dispose, any subsequent calls to {@link sendCommand} will reject immediately.
+     */
+    dispose() {
+        if (this.disposed) {
+            return;
+        }
+        this.disposed = true;
+        this.dataBus.unsubscribe(this.listenerId);
+        for (const [messageId, pending] of this.pendingCommands) {
+            clearTimeout(pending.timer);
+            pending.reject(new Error(`DataBusCommandHandler disposed while waiting for acknowledgment of command ${messageId}`));
+        }
+        this.pendingCommands.clear();
+    }
+    /**
+     * Handles an incoming CommandAcknowledgeV1 message by resolving the
+     * corresponding pending command promise, if one exists.
+     */
+    handleAcknowledge(ack) {
+        const pending = this.pendingCommands.get(ack.data.messageId);
+        if (!pending) {
+            return;
+        }
+        clearTimeout(pending.timer);
+        this.pendingCommands.delete(ack.data.messageId);
+        pending.resolve(ack);
+    }
+}
+exports.DataBusCommandHandler = DataBusCommandHandler;

package/dist/cjs/implementations/data-bus/data-bus-command-handler.d.cts

@@ -0,0 +1,114 @@
+import { EnergyAppDataBus } from "../../packages/energy-app-data-bus.cjs";
+import { EnyoDataBusCommandAcknowledgeV1, EnyoDataBusMessage } from "../../types/enyo-data-bus-value.cjs";
+/**
+ * Configuration options for the {@link DataBusCommandHandler}.
+ */
+export interface DataBusCommandHandlerOptions {
+    /**
+     * Default timeout in milliseconds to wait for a command acknowledgment.
+     * Individual calls to {@link DataBusCommandHandler.sendCommand} can override this value.
+     * @default 10000
+     */
+    defaultTimeoutMs?: number;
+}
+/**
+ * Per-call options for {@link DataBusCommandHandler.sendCommand}.
+ */
+export interface SendCommandOptions {
+    /**
+     * Timeout in milliseconds for this specific command.
+     * Overrides the default timeout configured in {@link DataBusCommandHandlerOptions}.
+     */
+    timeoutMs?: number;
+}
+/**
+ * Error thrown when a command does not receive an acknowledgment within the configured timeout.
+ */
+export declare class CommandTimeoutError extends Error {
+    /**
+     * The ID of the command message that timed out.
+     */
+    readonly messageId: string;
+    /**
+     * The timeout duration in milliseconds that was exceeded.
+     */
+    readonly timeoutMs: number;
+    /**
+     * Creates a new CommandTimeoutError.
+     * @param messageId - The ID of the command message that timed out
+     * @param timeoutMs - The timeout duration in milliseconds
+     */
+    constructor(messageId: string, timeoutMs: number);
+}
+/**
+ * Utility class that wraps an {@link EnergyAppDataBus} to provide promise-based command sending
+ * with automatic acknowledgment matching and timeout handling.
+ *
+ * Commands are sent via the data bus and the handler waits for a matching
+ * {@link EnyoDataBusMessageEnum.CommandAcknowledgeV1} message. The returned promise resolves
+ * with the acknowledgment for all answer types (Accepted, Rejected, NotSupported) — the
+ * consumer is responsible for inspecting the `data.answer` field. The promise only rejects
+ * on timeout or when {@link dispose} is called.
+ *
+ * @example
+ * ```typescript
+ * const commandHandler = new DataBusCommandHandler(energyApp.useDataBus());
+ *
+ * try {
+ *     const ack = await commandHandler.sendCommand(myStartChargeCommand);
+ *     if (ack.data.answer === EnyoCommandAcknowledgeAnswerEnum.Accepted) {
+ *         console.log('Command accepted');
+ *     } else {
+ *         console.log('Rejected:', ack.data.rejectionReason);
+ *     }
+ * } catch (error) {
+ *     if (error instanceof CommandTimeoutError) {
+ *         console.error('No acknowledgment within timeout');
+ *     }
+ * }
+ *
+ * // Clean up when done
+ * commandHandler.dispose();
+ * ```
+ */
+export declare class DataBusCommandHandler {
+    private readonly dataBus;
+    private readonly defaultTimeoutMs;
+    private readonly pendingCommands;
+    private readonly listenerId;
+    private disposed;
+    /**
+     * Creates a new DataBusCommandHandler.
+     * @param dataBus - The data bus instance to send commands through and listen for acknowledgments on
+     * @param options - Optional configuration options
+     */
+    constructor(dataBus: EnergyAppDataBus, options?: DataBusCommandHandlerOptions);
+    /**
+     * Sends a command message on the data bus and waits for its acknowledgment.
+     *
+     * The returned promise resolves with the {@link EnyoDataBusCommandAcknowledgeV1} for all
+     * acknowledgment answer types (Accepted, Rejected, NotSupported). It only rejects when:
+     * - The timeout is exceeded (throws {@link CommandTimeoutError})
+     * - The handler has been disposed
+     *
+     * @param command - The command message to send. Its `id` field is used to correlate
+     *   the acknowledgment response.
+     * @param options - Optional per-call options to override the default timeout
+     * @returns A promise that resolves with the command acknowledgment
+     * @throws {CommandTimeoutError} If no acknowledgment is received within the timeout
+     * @throws {Error} If the handler has been disposed
+     */
+    sendCommand(command: EnyoDataBusMessage, options?: SendCommandOptions): Promise<EnyoDataBusCommandAcknowledgeV1>;
+    /**
+     * Disposes the command handler by unsubscribing from the data bus,
+     * rejecting all pending commands, and clearing internal state.
+     *
+     * After calling dispose, any subsequent calls to {@link sendCommand} will reject immediately.
+     */
+    dispose(): void;
+    /**
+     * Handles an incoming CommandAcknowledgeV1 message by resolving the
+     * corresponding pending command promise, if one exists.
+     */
+    private handleAcknowledge;
+}

package/dist/cjs/index.cjs

@@ -37,6 +37,12 @@ __exportStar(require("./packages/energy-app-energy-manager.cjs"), exports);
 __exportStar(require("./types/enyo-electricity-tariff.cjs"), exports);
 __exportStar(require("./packages/energy-app-electricity-tariff.cjs"), exports);
 __exportStar(require("./types/enyo-pv-forecast.cjs"), exports);
+__exportStar(require("./types/enyo-forecasting.cjs"), exports);
+__exportStar(require("./packages/energy-app-weather-forecasting.cjs"), exports);
+__exportStar(require("./packages/energy-app-pv-forecasting.cjs"), exports);
+__exportStar(require("./types/enyo-pv-system.cjs"), exports);
+__exportStar(require("./packages/energy-app-pv-system.cjs"), exports);
+__exportStar(require("./implementations/data-bus/data-bus-command-handler.cjs"), exports);
 class EnergyApp {
     energyAppSdk;
     constructor() {
@@ -159,6 +165,32 @@ class EnergyApp {
     useElectricityTariff() {
         return this.energyAppSdk.useElectricityTariff();
     }
+    /**
+     * Gets the Weather Forecasting API for managing weather forecast providers and retrieving weather forecasts.
+     * Provides methods to register/deregister weather forecast providers, list available providers,
+     * and fetch weather forecasts by zip code or coordinates.
+     * @returns The Weather Forecasting API instance
+     */
+    useWeatherForecasting() {
+        return this.energyAppSdk.useWeatherForecasting();
+    }
+    /**
+     * Gets the PV Forecasting API for managing PV forecast providers and retrieving PV forecasts.
+     * Provides methods to register/deregister PV forecast providers and fetch power production forecasts.
+     * @returns The PV Forecasting API instance
+     */
+    usePvForecasting() {
+        return this.energyAppSdk.usePvForecasting();
+    }
+    /**
+     * Gets the PV System API for managing PV system registrations and configurations.
+     * Provides methods to register, retrieve, update, and remove PV systems
+     * including DC string orientations, peak power, associated appliances, and feature flags.
+     * @returns The PV System API instance
+     */
+    usePvSystem() {
+        return this.energyAppSdk.usePvSystem();
+    }
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

package/dist/cjs/index.d.cts

@@ -20,6 +20,9 @@ import { EnergyAppTimeseries } from "./packages/energy-app-timeseries.cjs";
 import { EnyoPackageChannel } from "./enyo-package-channel.cjs";
 import { EnergyAppEnergyManager } from "./packages/energy-app-energy-manager.cjs";
 import { EnergyAppElectricityTariff } from "./packages/energy-app-electricity-tariff.cjs";
+import { EnergyAppWeatherForecasting } from "./packages/energy-app-weather-forecasting.cjs";
+import { EnergyAppPvForecasting } from "./packages/energy-app-pv-forecasting.cjs";
+import { EnergyAppPvSystem } from "./packages/energy-app-pv-system.cjs";
 export * from './energy-app-package-definition.cjs';
 export * from './version.cjs';
 export * from './implementations/ocpp/ocpp16.cjs';
@@ -41,6 +44,12 @@ export * from './packages/energy-app-energy-manager.cjs';
 export * from './types/enyo-electricity-tariff.cjs';
 export * from './packages/energy-app-electricity-tariff.cjs';
 export * from './types/enyo-pv-forecast.cjs';
+export * from './types/enyo-forecasting.cjs';
+export * from './packages/energy-app-weather-forecasting.cjs';
+export * from './packages/energy-app-pv-forecasting.cjs';
+export * from './types/enyo-pv-system.cjs';
+export * from './packages/energy-app-pv-system.cjs';
+export * from './implementations/data-bus/data-bus-command-handler.cjs';
 export declare class EnergyApp implements EnyoEnergyAppSdk {
     private readonly energyAppSdk;
     constructor();
@@ -96,6 +105,26 @@ export declare class EnergyApp implements EnyoEnergyAppSdk {
      * @returns The Electricity Tariff API instance
      */
     useElectricityTariff(): EnergyAppElectricityTariff;
+    /**
+     * Gets the Weather Forecasting API for managing weather forecast providers and retrieving weather forecasts.
+     * Provides methods to register/deregister weather forecast providers, list available providers,
+     * and fetch weather forecasts by zip code or coordinates.
+     * @returns The Weather Forecasting API instance
+     */
+    useWeatherForecasting(): EnergyAppWeatherForecasting;
+    /**
+     * Gets the PV Forecasting API for managing PV forecast providers and retrieving PV forecasts.
+     * Provides methods to register/deregister PV forecast providers and fetch power production forecasts.
+     * @returns The PV Forecasting API instance
+     */
+    usePvForecasting(): EnergyAppPvForecasting;
+    /**
+     * Gets the PV System API for managing PV system registrations and configurations.
+     * Provides methods to register, retrieve, update, and remove PV systems
+     * including DC string orientations, peak power, associated appliances, and feature flags.
+     * @returns The PV System API instance
+     */
+    usePvSystem(): EnergyAppPvSystem;
     /**
      * Gets the current SDK version.
      * @returns The semantic version string of the SDK

package/dist/cjs/packages/energy-app-pv-forecasting.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/packages/energy-app-pv-forecasting.d.cts

@@ -0,0 +1,63 @@
+import { PvForecastProviderRegistration, PvForecastProviderInfo, PvForecastResponse } from "../types/enyo-forecasting.cjs";
+/**
+ * Interface for managing PV forecast providers and retrieving PV forecasts.
+ * Allows energy apps to register PV forecast providers and fetch power production forecasts.
+ */
+export interface EnergyAppPvForecasting {
+    /**
+     * Registers a new PV forecast provider or updates an existing one.
+     * Uses upsert logic based on forecastId - if a provider with the same ID exists,
+     * it will be updated; otherwise, a new provider will be created.
+     *
+     * @param registration - The forecast provider registration data
+     * @returns Promise that resolves when the provider has been registered
+     *
+     * @example
+     * ```typescript
+     * await pvForecasting.registerForecast({
+     *     forecastId: 'solcast-1',
+     *     name: 'Solcast Forecast',
+     *     vendor: 'Solcast'
+     * });
+     * ```
+     */
+    registerForecast(registration: PvForecastProviderRegistration): Promise<void>;
+    /**
+     * Removes a registered PV forecast provider by its ID.
+     * If the provider does not exist, this operation is a no-op.
+     *
+     * @param forecastId - The unique identifier of the forecast provider to remove
+     * @returns Promise that resolves when the provider has been removed
+     */
+    deregisterForecast(forecastId: string): Promise<void>;
+    /**
+     * Retrieves all registered PV forecast providers.
+     *
+     * @returns Promise that resolves to an array of all registered PV forecast providers
+     *
+     * @example
+     * ```typescript
+     * const providers = await pvForecasting.listForecasts();
+     * providers.forEach(p => console.log(`${p.name} (${p.vendor})`));
+     * ```
+     */
+    listForecasts(): Promise<PvForecastProviderInfo[]>;
+    /**
+     * Fetches a PV power production forecast for a specific PV system.
+     * Returns forecasted power output entries based on the PV system's configuration.
+     *
+     * @param forecastId - The unique identifier of the forecast provider to use
+     * @param pvSystemId - The unique identifier of the PV system to get the forecast for
+     * @returns Promise that resolves to the PV forecast data with resolution and entries
+     *
+     * @example
+     * ```typescript
+     * const forecast = await pvForecasting.getPvForecast('solcast-1', 'pv-system-001');
+     * console.log(`Resolution: ${forecast.resolution}`);
+     * forecast.entries.forEach(e =>
+     *     console.log(`${e.timestampIso}: ${e.forecastedKw} kW`)
+     * );
+     * ```
+     */
+    getPvForecast(forecastId: string, pvSystemId: string): Promise<PvForecastResponse>;
+}

package/dist/cjs/packages/energy-app-pv-system.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/packages/energy-app-pv-system.d.cts

@@ -0,0 +1,70 @@
+import { PvSystemRegistration, PvSystemInfo } from "../types/enyo-pv-system.cjs";
+/**
+ * Interface for managing PV systems.
+ * Allows energy apps to register, retrieve, update, and remove PV system configurations
+ * including DC string orientations, peak power, associated appliances, and feature flags.
+ */
+export interface EnergyAppPvSystem {
+    /**
+     * Registers a new PV system.
+     * The PV system describes the physical installation including peak power,
+     * DC string configurations with module count and orientation, optional appliances,
+     * and feature flags.
+     *
+     * @param pvSystem - The PV system registration data
+     * @returns Promise that resolves to the registered PV system info including its generated ID
+     *
+     * @example
+     * ```typescript
+     * const pvSystem = await pvSystemApi.registerPvSystem({
+     *     kWp: 10.5,
+     *     dcStrings: [
+     *         { numberOfModules: 12, orientation: PvOrientationEnum.South, orientationSource: 'user' },
+     *         { numberOfModules: 8, orientation: PvOrientationEnum.West }
+     *     ],
+     *     appliances: [
+     *         { applianceId: 'inv-1', applianceType: EnergyAppApplianceTypeEnum.Inverter }
+     *     ],
+     *     features: ['only-grid-feed-in']
+     * });
+     * console.log(`Registered PV system: ${pvSystem.pvSystemId}`);
+     * ```
+     */
+    registerPvSystem(pvSystem: PvSystemRegistration): Promise<PvSystemInfo>;
+    /**
+     * Retrieves a registered PV system by its ID.
+     *
+     * @param pvSystemId - The unique identifier of the PV system
+     * @returns Promise that resolves to the PV system info, or null if not found
+     */
+    getPvSystem(pvSystemId: string): Promise<PvSystemInfo | null>;
+    /**
+     * Updates an existing PV system configuration.
+     * Allows changing the kWp, DC string configurations, appliances, and features
+     * of a registered PV system.
+     *
+     * @param pvSystemId - The unique identifier of the PV system to update
+     * @param pvSystem - The updated PV system registration data
+     * @returns Promise that resolves to the updated PV system info
+     *
+     * @example
+     * ```typescript
+     * const updated = await pvSystemApi.updatePvSystem('pv-system-001', {
+     *     kWp: 12.0,
+     *     dcStrings: [
+     *         { numberOfModules: 14, orientation: PvOrientationEnum.South },
+     *         { numberOfModules: 10, orientation: PvOrientationEnum.West }
+     *     ]
+     * });
+     * ```
+     */
+    updatePvSystem(pvSystemId: string, pvSystem: PvSystemRegistration): Promise<PvSystemInfo>;
+    /**
+     * Removes a registered PV system by its ID.
+     * If the PV system does not exist, this operation is a no-op.
+     *
+     * @param pvSystemId - The unique identifier of the PV system to remove
+     * @returns Promise that resolves when the PV system has been removed
+     */
+    removePvSystem(pvSystemId: string): Promise<void>;
+}

package/dist/cjs/packages/energy-app-weather-forecasting.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/packages/energy-app-weather-forecasting.d.cts

@@ -0,0 +1,89 @@
+import { WeatherForecastRegistration, WeatherForecastInfo, WeatherForecastByZipCodeRequest, WeatherForecastByCoordinatesRequest, WeatherForecastResponse } from "../types/enyo-forecasting.cjs";
+/**
+ * Interface for managing weather forecast providers and retrieving weather forecasts.
+ * Allows energy apps to register weather forecast providers and fetch forecasts
+ * using either zip code or geographic coordinates depending on the provider's requirements.
+ */
+export interface EnergyAppWeatherForecasting {
+    /**
+     * Registers a new weather forecast provider or updates an existing one.
+     * Uses upsert logic based on forecastId - if a provider with the same ID exists,
+     * it will be updated; otherwise, a new provider will be created.
+     *
+     * @param registration - The forecast provider registration data
+     * @returns Promise that resolves when the provider has been registered
+     *
+     * @example
+     * ```typescript
+     * await weatherForecasting.registerForecast({
+     *     forecastId: 'openweather-1',
+     *     name: 'OpenWeather Forecast',
+     *     vendor: 'OpenWeather',
+     *     locationType: WeatherForecastLocationTypeEnum.ZipCode
+     * });
+     * ```
+     */
+    registerForecast(registration: WeatherForecastRegistration): Promise<void>;
+    /**
+     * Removes a registered weather forecast provider by its ID.
+     * If the provider does not exist, this operation is a no-op.
+     *
+     * @param forecastId - The unique identifier of the forecast provider to remove
+     * @returns Promise that resolves when the provider has been removed
+     */
+    deregisterForecast(forecastId: string): Promise<void>;
+    /**
+     * Retrieves all registered weather forecast providers.
+     *
+     * @returns Promise that resolves to an array of all registered weather forecast providers
+     *
+     * @example
+     * ```typescript
+     * const providers = await weatherForecasting.listForecasts();
+     * providers.forEach(p => console.log(`${p.name} (${p.vendor})`));
+     * ```
+     */
+    listForecasts(): Promise<WeatherForecastInfo[]>;
+    /**
+     * Fetches a weather forecast using a zip code.
+     * The forecast provider must be configured with locationType 'zip-code'.
+     *
+     * @param forecastId - The unique identifier of the forecast provider to use
+     * @param request - The request containing the zip code
+     * @returns Promise that resolves to the weather forecast data with resolution and entries
+     *
+     * @example
+     * ```typescript
+     * const forecast = await weatherForecasting.getWeatherForecastByZipCode(
+     *     'openweather-1',
+     *     { zipCode: '80331' }
+     * );
+     * console.log(`Resolution: ${forecast.resolution}`);
+     * forecast.entries.forEach(e =>
+     *     console.log(`${e.timestampIso}: ${e.outdoorTemperatureCelsius}°C`)
+     * );
+     * ```
+     */
+    getWeatherForecastByZipCode(forecastId: string, request: WeatherForecastByZipCodeRequest): Promise<WeatherForecastResponse>;
+    /**
+     * Fetches a weather forecast using geographic coordinates.
+     * The forecast provider must be configured with locationType 'coordinates'.
+     *
+     * @param forecastId - The unique identifier of the forecast provider to use
+     * @param request - The request containing latitude and longitude
+     * @returns Promise that resolves to the weather forecast data with resolution and entries
+     *
+     * @example
+     * ```typescript
+     * const forecast = await weatherForecasting.getWeatherForecastByCoordinates(
+     *     'weather-api-1',
+     *     { latitude: 48.1351, longitude: 11.5820 }
+     * );
+     * console.log(`Resolution: ${forecast.resolution}`);
+     * forecast.entries.forEach(e =>
+     *     console.log(`${e.timestampIso}: ${e.outdoorTemperatureCelsius}°C`)
+     * );
+     * ```
+     */
+    getWeatherForecastByCoordinates(forecastId: string, request: WeatherForecastByCoordinatesRequest): Promise<WeatherForecastResponse>;
+}