homebridge-salus-cloud 0.1.2 → 0.1.4

package/README.md

@@ -94,11 +94,19 @@ Examples:
 - Automatic token refresh before expiry and on `401` responses.
 - Exponential backoff retries for transient network/API failures.
 - API base fallback between `/api/v1` and `/api/v2`.
+- Automatic compatibility fallback to legacy Salus cloud auth/API (`/users/sign_in.json` + `/apiv1`) when modern API returns persistent authorization errors (for example `response_code=900008`).
 - Flexible shadow parser for multiple payload shapes.
 - Flexible write payload fallback for service-api compatibility changes.
 - Immediate short re-poll after write to keep HomeKit state aligned.
 - Detailed logs for auth, discovery, shadow sync, writes, retries, and failures.
 
+## 900008 troubleshooting
+
+If logs show `response_code=900008` from modern `service-api`, this plugin now auto-switches into legacy compatibility mode and retries using the older Salus cloud stack. You will see:
+
+- `Switching to legacy Salus cloud compatibility mode (...)`
+- `Authenticated with Salus cloud (legacy API compatibility mode)`
+
 ## Salus features not cleanly mappable to HomeKit
 
 These are intentionally not represented as extra virtual accessories:

package/dist/salusCloudClient.d.ts

@@ -5,16 +5,25 @@ export declare class SalusCloudClient {
     private readonly config;
     private session;
     private authRequestInFlight;
+    private legacySession;
+    private legacyAuthRequestInFlight;
     private readonly requestTimeoutMs;
     private readonly maxRetries;
     private readonly retryBaseDelayMs;
     private readonly verboseLogging;
     private readonly allowInsecureTls;
     private readonly serviceApiBaseCandidates;
+    private readonly legacyApiBaseCandidates;
     private readonly cognitoEndpoint;
     private readonly cognitoClientId;
     private readonly configuredCompanyCode;
+    private companyCodeCandidates;
+    private activeCompanyCode;
+    private hasWarnedAboutAuthCompanyCode;
     private activeServiceApiBaseUrl;
+    private activeLegacyApiBaseUrl;
+    private apiTransportMode;
+    private hasWarnedAboutLegacyFallback;
     private readonly propertyCacheByDsn;
     private readonly deviceIdToDsn;
     private readonly deviceKeyToDsn;
@@ -27,8 +36,15 @@ export declare class SalusCloudClient {
     constructor(log: Logging, config: SalusPlatformConfig);
     getCloudBaseUrl(): string;
     listDevices(): Promise<SalusDevice[]>;
+    private listDevicesModern;
+    private listDevicesLegacy;
     listProperties(dsn: string): Promise<SalusPropertyMap>;
+    private listPropertiesModern;
+    private listPropertiesLegacy;
     setDatapoint(dsn: string, propertyName: string, value: unknown): Promise<void>;
+    private setDatapointModern;
+    private setDatapointLegacy;
+    private switchToLegacyTransport;
     private rememberPreferredWriteAttempt;
     private rebuildDeviceIndex;
     private replacePropertyCache;
@@ -38,16 +54,25 @@ export declare class SalusCloudClient {
     private findDeviceIdByDsn;
     private findDeviceKeyByDsn;
     private updateCachedProperty;
+    private refreshCompanyCodeCandidates;
+    private rotateCompanyCodeCandidate;
     private ensureLoggedIn;
     private login;
     private refreshSession;
+    private ensureLegacyLoggedIn;
+    private loginLegacy;
+    private authenticateLegacyWithPassword;
     private authenticateWithPassword;
     private authenticateWithRefreshToken;
     private cognitoInitiateAuth;
     private requestServiceJsonWithPathFallback;
+    private requestLegacyJsonWithPathFallback;
     private requestServiceJson;
+    private requestLegacyJson;
     private buildServiceHeaders;
+    private buildLegacyHeaders;
     private getOrderedServiceApiBaseUrls;
+    private getOrderedLegacyApiBaseUrls;
     private retryDelay;
     private fetchWithTimeout;
 }