@enyo-energy/energy-app-sdk 0.0.45 → 0.0.47

package/dist/cjs/implementations/appliances/appliance-manager.cjs

@@ -179,6 +179,27 @@ class ApplianceManager {
         }
         return matches;
     }
+    /**
+     * Gets an appliance by its unique ID.
+     * @param applianceId The ID of the appliance to retrieve
+     * @returns The appliance if found, null otherwise
+     */
+    async findApplianceById(applianceId) {
+        try {
+            const appliance = await this.energyApp.useAppliances().getById(applianceId);
+            if (appliance) {
+                // Update cache with the fetched appliance
+                this.updateCache(appliance);
+                return appliance;
+            }
+        }
+        catch (error) {
+            if (this.config.enableLogging) {
+                console.error(`Failed to get appliance ${applianceId}: ${error}`);
+            }
+        }
+        return null;
+    }
     /**
      * Finds an appliance using multiple strategies.
      * @param searchValue The value to search for

package/dist/cjs/implementations/appliances/appliance-manager.d.cts

@@ -109,6 +109,12 @@ export declare class ApplianceManager {
      * @returns Array of matching appliances
      */
     findByIdentifier(identifier: string): Promise<EnyoAppliance[]>;
+    /**
+     * Gets an appliance by its unique ID.
+     * @param applianceId The ID of the appliance to retrieve
+     * @returns The appliance if found, null otherwise
+     */
+    findApplianceById(applianceId: string): Promise<EnyoAppliance | null>;
     /**
      * Finds an appliance using multiple strategies.
      * @param searchValue The value to search for

package/dist/cjs/types/enyo-authentication.d.cts

@@ -19,8 +19,16 @@ export interface EnyoOauthAuthentication {
     clientIdName?: EnyoPackageConfigurationTranslatedValue[];
     clientSecretName?: EnyoPackageConfigurationTranslatedValue[];
 }
+/**
+ * OAuth authentication start configuration
+ * Contains the required redirect URL and optional client credentials
+ */
 export interface EnyoOauthAuthenticationStart {
+    /** The redirect URL where the OAuth provider should send the user after authentication */
+    enyoRedirectUrl: string;
+    /** Optional client ID if the user needs to provide their own OAuth app credentials */
     clientId?: string;
+    /** Optional client secret if the user needs to provide their own OAuth app credentials */
     clientSecret?: string;
 }
 export interface EnyoOauthAuthenticationRedirectUrlResponse {
@@ -47,9 +55,15 @@ export interface EnyoUsernamePasswordAuthenticationResponse {
     username: string;
     password: string;
 }
+/**
+ * OAuth authentication response containing authorization code and/or additional parameters
+ * The code is optional to support different OAuth flows and providers
+ */
 export interface EnyoOauthAuthenticationResponse {
-    code: string;
-    challenge: string;
+    /** OAuth authorization code - optional to support various OAuth flows */
+    code?: string;
+    /** Additional URL parameters that may be returned by the OAuth provider */
+    urlParams?: Record<string, string>;
 }
 export interface EnyoAuthenticationResponse {
     requestId: string;

package/dist/cjs/types/enyo-inverter-appliance.d.cts

@@ -1,3 +1,8 @@
+export interface EnyoInverterDcString {
+    index: number;
+    name?: string;
+}
 export interface EnyoInverterApplianceMetadata {
     maxPvProductionW?: number;
+    dcStrings?: EnyoInverterDcString[];
 }

package/dist/cjs/version.cjs

@@ -9,7 +9,7 @@ exports.getSdkVersion = getSdkVersion;
 /**
  * Current version of the enyo Energy App SDK.
  */
-exports.SDK_VERSION = '0.0.45';
+exports.SDK_VERSION = '0.0.47';
 /**
  * Gets the current SDK version.
  * @returns The semantic version string of the SDK

package/dist/cjs/version.d.cts

@@ -5,7 +5,7 @@
 /**
  * Current version of the enyo Energy App SDK.
  */
-export declare const SDK_VERSION = "0.0.45";
+export declare const SDK_VERSION = "0.0.47";
 /**
  * Gets the current SDK version.
  * @returns The semantic version string of the SDK

package/dist/implementations/appliances/appliance-manager.d.ts

@@ -109,6 +109,12 @@ export declare class ApplianceManager {
      * @returns Array of matching appliances
      */
     findByIdentifier(identifier: string): Promise<EnyoAppliance[]>;
+    /**
+     * Gets an appliance by its unique ID.
+     * @param applianceId The ID of the appliance to retrieve
+     * @returns The appliance if found, null otherwise
+     */
+    findApplianceById(applianceId: string): Promise<EnyoAppliance | null>;
     /**
      * Finds an appliance using multiple strategies.
      * @param searchValue The value to search for

package/dist/implementations/appliances/appliance-manager.js

@@ -176,6 +176,27 @@ export class ApplianceManager {
         }
         return matches;
     }
+    /**
+     * Gets an appliance by its unique ID.
+     * @param applianceId The ID of the appliance to retrieve
+     * @returns The appliance if found, null otherwise
+     */
+    async findApplianceById(applianceId) {
+        try {
+            const appliance = await this.energyApp.useAppliances().getById(applianceId);
+            if (appliance) {
+                // Update cache with the fetched appliance
+                this.updateCache(appliance);
+                return appliance;
+            }
+        }
+        catch (error) {
+            if (this.config.enableLogging) {
+                console.error(`Failed to get appliance ${applianceId}: ${error}`);
+            }
+        }
+        return null;
+    }
     /**
      * Finds an appliance using multiple strategies.
      * @param searchValue The value to search for

package/dist/types/enyo-authentication.d.ts

@@ -19,8 +19,16 @@ export interface EnyoOauthAuthentication {
     clientIdName?: EnyoPackageConfigurationTranslatedValue[];
     clientSecretName?: EnyoPackageConfigurationTranslatedValue[];
 }
+/**
+ * OAuth authentication start configuration
+ * Contains the required redirect URL and optional client credentials
+ */
 export interface EnyoOauthAuthenticationStart {
+    /** The redirect URL where the OAuth provider should send the user after authentication */
+    enyoRedirectUrl: string;
+    /** Optional client ID if the user needs to provide their own OAuth app credentials */
     clientId?: string;
+    /** Optional client secret if the user needs to provide their own OAuth app credentials */
     clientSecret?: string;
 }
 export interface EnyoOauthAuthenticationRedirectUrlResponse {
@@ -47,9 +55,15 @@ export interface EnyoUsernamePasswordAuthenticationResponse {
     username: string;
     password: string;
 }
+/**
+ * OAuth authentication response containing authorization code and/or additional parameters
+ * The code is optional to support different OAuth flows and providers
+ */
 export interface EnyoOauthAuthenticationResponse {
-    code: string;
-    challenge: string;
+    /** OAuth authorization code - optional to support various OAuth flows */
+    code?: string;
+    /** Additional URL parameters that may be returned by the OAuth provider */
+    urlParams?: Record<string, string>;
 }
 export interface EnyoAuthenticationResponse {
     requestId: string;

package/dist/types/enyo-inverter-appliance.d.ts

@@ -1,3 +1,8 @@
+export interface EnyoInverterDcString {
+    index: number;
+    name?: string;
+}
 export interface EnyoInverterApplianceMetadata {
     maxPvProductionW?: number;
+    dcStrings?: EnyoInverterDcString[];
 }

package/dist/version.d.ts

@@ -5,7 +5,7 @@
 /**
  * Current version of the enyo Energy App SDK.
  */
-export declare const SDK_VERSION = "0.0.45";
+export declare const SDK_VERSION = "0.0.47";
 /**
  * Gets the current SDK version.
  * @returns The semantic version string of the SDK

package/dist/version.js

@@ -5,7 +5,7 @@
 /**
  * Current version of the enyo Energy App SDK.
  */
-export const SDK_VERSION = '0.0.45';
+export const SDK_VERSION = '0.0.47';
 /**
  * Gets the current SDK version.
  * @returns The semantic version string of the SDK

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enyo-energy/energy-app-sdk",
-  "version": "0.0.45",
+  "version": "0.0.47",
   "description": "enyo Energy App SDK",
   "type": "module",
   "main": "dist/index.js",