@smarthome.exchange/integrations 1.0.0 → 3.0.0

package/dist_ts/integrations/esphome/esphome.validation.js

@@ -0,0 +1,66 @@
+export const esphomeData = (valueArg, fieldsArg, labelArg) => {
+    if (!valueArg || typeof valueArg !== 'object' || (Object.getPrototypeOf(valueArg) !== Object.prototype && Object.getPrototypeOf(valueArg) !== null)) {
+        throw new TypeError(`${labelArg} must be a plain data object.`);
+    }
+    const captured = Object.create(null);
+    for (const key of Reflect.ownKeys(valueArg)) {
+        const field = Object.getOwnPropertyDescriptor(valueArg, key);
+        if (typeof key !== 'string' || !fieldsArg.includes(key) || !field || !field.enumerable || !('value' in field)) {
+            throw new TypeError(`${labelArg} contains an unsupported field or accessor.`);
+        }
+        captured[key] = field.value;
+    }
+    return captured;
+};
+export const esphomeIdentifier = (valueArg, labelArg) => {
+    if (typeof valueArg !== 'string' || !valueArg || valueArg.trim() !== valueArg || valueArg.length > 256 || /[\p{Cc}\p{Cs}]/u.test(valueArg)) {
+        throw new TypeError(`${labelArg} must be a non-empty identifier without surrounding whitespace or control characters.`);
+    }
+    return valueArg;
+};
+export const esphomeTimeout = (valueArg, defaultArg) => {
+    const value = valueArg ?? defaultArg;
+    if (typeof value !== 'number' || !Number.isInteger(value) || value < 1 || value > 2147483647) {
+        throw new TypeError('ESPHome timeouts must be integers from 1 through 2147483647.');
+    }
+    return value;
+};
+export const esphomeMac = (valueArg) => {
+    if (typeof valueArg !== 'string' || !/^(?:[a-f\d]{12}|(?:[a-f\d]{2}:){5}[a-f\d]{2})$/i.test(valueArg))
+        return undefined;
+    return valueArg.replace(/:/g, '').toLowerCase();
+};
+export const captureEsphomeConfig = (valueArg) => {
+    const value = esphomeData(valueArg, ['homeId', 'host', 'port', 'name', 'deviceName', 'expectedMacAddress', 'expectedModel', 'credentialKey', 'credentialSource', 'initialSnapshotTimeoutMs', 'commandTimeoutMs'], 'ESPHome configuration');
+    const host = esphomeIdentifier(value.host, 'ESPHome host');
+    if (/\s/.test(host))
+        throw new TypeError('ESPHome host must not contain whitespace.');
+    const port = value.port ?? 6053;
+    if (typeof port !== 'number' || !Number.isInteger(port) || port < 1 || port > 65535)
+        throw new TypeError('ESPHome port must be an integer from 1 through 65535.');
+    const mac = esphomeMac(value.expectedMacAddress);
+    if (!mac)
+        throw new TypeError('ESPHome expectedMacAddress must be a complete MAC address.');
+    if (value.credentialSource !== undefined && value.credentialSource !== 'provider' && value.credentialSource !== 'store')
+        throw new TypeError('ESPHome credential source must be provider or store.');
+    if (value.credentialSource !== undefined && value.credentialKey === undefined)
+        throw new TypeError('ESPHome credential source requires a credential reference.');
+    return Object.freeze({
+        homeId: esphomeIdentifier(value.homeId, 'ESPHome configuration homeId'), host, port,
+        deviceName: esphomeIdentifier(value.deviceName, 'ESPHome selected device name'), expectedMacAddress: mac,
+        expectedModel: value.expectedModel === undefined ? undefined : esphomeIdentifier(value.expectedModel, 'ESPHome selected model'),
+        name: value.name === undefined ? undefined : esphomeIdentifier(value.name, 'ESPHome display name'),
+        credentialKey: value.credentialKey === undefined ? undefined : esphomeIdentifier(value.credentialKey, 'ESPHome credential reference'),
+        credentialSource: value.credentialSource,
+        initialSnapshotTimeoutMs: esphomeTimeout(value.initialSnapshotTimeoutMs, 15000), commandTimeoutMs: esphomeTimeout(value.commandTimeoutMs, 5000),
+    });
+};
+export const captureEsphomeCredentials = (valueArg) => {
+    const value = esphomeData(valueArg, ['psk'], 'ESPHome credential provider result');
+    const psk = value.psk;
+    if (psk !== undefined && psk !== null && (typeof psk !== 'string' || !/^[A-Za-z0-9+/]{43}=$/.test(psk) || Buffer.from(psk, 'base64').length !== 32 || Buffer.from(psk, 'base64').toString('base64') !== psk)) {
+        throw new TypeError('ESPHome Noise credentials require a canonical base64-encoded 32-byte key.');
+    }
+    return Object.freeze({ psk: psk });
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXNwaG9tZS52YWxpZGF0aW9uLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvaW50ZWdyYXRpb25zL2VzcGhvbWUvZXNwaG9tZS52YWxpZGF0aW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUVBLE1BQU0sQ0FBQyxNQUFNLFdBQVcsR0FBRyxDQUFDLFFBQWlCLEVBQUUsU0FBNEIsRUFBRSxRQUFnQixFQUEyQixFQUFFO0lBQ3hILElBQUksQ0FBQyxRQUFRLElBQUksT0FBTyxRQUFRLEtBQUssUUFBUSxJQUFJLENBQUMsTUFBTSxDQUFDLGNBQWMsQ0FBQyxRQUFRLENBQUMsS0FBSyxNQUFNLENBQUMsU0FBUyxJQUFJLE1BQU0sQ0FBQyxjQUFjLENBQUMsUUFBUSxDQUFDLEtBQUssSUFBSSxDQUFDLEVBQUUsQ0FBQztRQUNwSixNQUFNLElBQUksU0FBUyxDQUFDLEdBQUcsUUFBUSwrQkFBK0IsQ0FBQyxDQUFDO0lBQ2xFLENBQUM7SUFDRCxNQUFNLFFBQVEsR0FBNEIsTUFBTSxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQTRCLENBQUM7SUFDekYsS0FBSyxNQUFNLEdBQUcsSUFBSSxPQUFPLENBQUMsT0FBTyxDQUFDLFFBQVEsQ0FBQyxFQUFFLENBQUM7UUFDNUMsTUFBTSxLQUFLLEdBQUcsTUFBTSxDQUFDLHdCQUF3QixDQUFDLFFBQVEsRUFBRSxHQUFHLENBQUMsQ0FBQztRQUM3RCxJQUFJLE9BQU8sR0FBRyxLQUFLLFFBQVEsSUFBSSxDQUFDLFNBQVMsQ0FBQyxRQUFRLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxLQUFLLElBQUksQ0FBQyxLQUFLLENBQUMsVUFBVSxJQUFJLENBQUMsQ0FBQyxPQUFPLElBQUksS0FBSyxDQUFDLEVBQUUsQ0FBQztZQUM5RyxNQUFNLElBQUksU0FBUyxDQUFDLEdBQUcsUUFBUSw2Q0FBNkMsQ0FBQyxDQUFDO1FBQ2hGLENBQUM7UUFDRCxRQUFRLENBQUMsR0FBRyxDQUFDLEdBQUcsS0FB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TUFBTSxLQUFLLEdBQUcsV0FBVyxDQUFDLFFBQVEsRUFBRSxDQUFDLEtBQUssQ0FBQyxFQUFFLG9DQUFvQyxDQUFDLENBQUM7SUFDbkYsTUFBTSxHQUFHLEdBQUcsS0FBSyxDQUFDLEdBQUcsQ0FBQztJQUN0QixJQUFJLEdBQUcsS0FBSyxTQUFTLElBQUksR0FBRyxLQUFLLElBQUksSUFBSSxDQUFDLE9BQU8sR0FBRyxLQUFLLFFBQVEsSUFBSSxDQUFDLHNCQUFzQixDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsSUFBSSxNQUFNLENBQUMsSUFBSSxDQUFDLEdBQUcsRUFBRSxRQUFRLENBQUMsQ0FBQyxNQUFNLEtBQUssRUFBRSxJQUFJLE1BQU0sQ0FBQyxJQUFJLENBQUMsR0FBRyxFQUFFLFFBQVEsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxRQUFRLENBQUMsS0FBSyxHQUFHLENBQUMsRUFBRSxDQUFDO1FBQzdNLE1BQU0sSUFBSSxTQUFTLENBQUMsMkVBQTJFLENBQUMsQ0FBQztJQUNuRyxDQUFDO0lBQ0QsT0FBTyxNQUFNLENBQUMsTUFBTSxDQUFDLEVBQUUsR0FBRyxFQUFFLEdBQWdDLEVBQUUsQ0FBQyxDQUFDO0FBQ2xFLENBQUMsQ0FBQyJ9

package/dist_ts/integrations/homeassistant/homeassistant.classes.client.d.ts

@@ -1,10 +1,22 @@
+import { NativeIntegrationOwner, type INativeSetupLease } from '../../core/classes.nativeintegrationowner.js';
+import type { INativeIntegrationSetupContext } from '../../core/types.js';
 import type * as homeAssistantWebsocket from 'home-assistant-js-websocket';
-import type { IHomeAssistantHomeassistantConfig, IHomeAssistantClient, IHomeAssistantNormalizedConfig, IHomeAssistantServiceCall, IHomeAssistantWebsocketApi, IHomeAssistantTargetScope, THomeAssistantWebSocketFactory } from './homeassistant.types.js';
+import type { IHomeAssistantHomeassistantConfig, IHomeAssistantClient, IHomeAssistantNormalizedConfig, IHomeAssistantOperationSession, IHomeAssistantServiceCall, IHomeAssistantWebsocketApi, IHomeAssistantTargetScope, THomeAssistantWebSocketFactory } from './homeassistant.types.js';
+interface IHomeAssistantClientOwnership {
+    readonly owner: NativeIntegrationOwner;
+    readonly lease: INativeSetupLease;
+}
 export declare const normalizeHomeAssistantConfig: (configArg: IHomeAssistantHomeassistantConfig) => IHomeAssistantNormalizedConfig;
 export declare class HomeAssistantClient implements IHomeAssistantClient {
     private readonly api;
     private readonly webSocketFactory?;
     private readonly config;
+    private readonly context;
+    private readonly owner;
+    private readonly standalone;
+    private lease?;
+    private initStarted;
+    private ownedDestroyPromise?;
     private readonly handlers;
     private readonly lifetimeAbortController;
     private readonly ownedSockets;
@@ -15,7 +27,9 @@ export declare class HomeAssistantClient implements IHomeAssistantClient {
     private entityPlatforms;
     private services;
     private readonly catalogueUnsubscribes;
-    private readonly serviceSettlements;
+    private readonly actualWork;
+    private readonly cleanup;
+    private retryPromise?;
     private connectionReady;
     private snapshotReady;
     private requiredEntitiesPresent;
@@ -30,16 +44,28 @@ export declare class HomeAssistantClient implements IHomeAssistantClient {
     private lifecycle;
     private readonly handleReady;
     private readonly handleDisconnected;
-    constructor(configArg: IHomeAssistantHomeassistantConfig, api: IHomeAssistantWebsocketApi, webSocketFactory?: THomeAssistantWebSocketFactory | undefined);
+    constructor(configArg: IHomeAssistantHomeassistantConfig, contextArg: INativeIntegrationSetupContext, api?: IHomeAssistantWebsocketApi, webSocketFactory?: THomeAssistantWebSocketFactory | undefined, ownershipArg?: IHomeAssistantClientOwnership);
     get connected(): boolean;
     init(abortSignalArg?: AbortSignal): Promise<void>;
+    private initializeOwned;
+    private initialize;
     getSnapshot(): homeAssistantWebsocket.HassEntities;
     getEntityPlatforms(): Record<string, string>;
     getServices(): ReadonlySet<string>;
     getTargetScope(): IHomeAssistantTargetScope;
-    subscribe(handlerArg: () => void): () => void;
+    subscribe(handlerArg: () => void | Promise<void>, abortSignalArg?: AbortSignal): () => Promise<void>;
+    /** Caller cancellation may settle first; the owner retains the actual continuation. */
+    withOperation<TResult>(workArg: (sessionArg: IHomeAssistantOperationSession) => Promise<TResult>, abortSignalArg?: AbortSignal): Promise<TResult>;
+    private admitOperation;
     callService(requestArg: IHomeAssistantServiceCall, abortSignalArg?: AbortSignal): Promise<unknown>;
+    private dispatchService;
     destroy(): Promise<void>;
+    private destroyOwned;
+    retryCleanup(): Promise<void>;
+    private retryOwnedCleanup;
+    private trackWork;
+    private ownCleanup;
+    private closeResource;
     private performDestroy;
     private createConnection;
     private createManagedSocket;
@@ -68,4 +94,6 @@ export declare class HomeAssistantClient implements IHomeAssistantClient {
     private shouldIncludeEntityId;
     private filterSnapshot;
     private emitChange;
+    private fenceSubscribers;
 }
+export {};