@smarthome.exchange/integrations 1.0.0 → 3.0.0

package/dist_ts/integrations/denonavr/denonavr.types.d.ts

@@ -1,92 +1,60 @@
-export type TDenonavrZone = 'Main' | 'Zone2' | 'Zone3';
-export type TDenonavrPowerState = 'ON' | 'STANDBY' | 'OFF' | string;
-export type TDenonavrMediaState = 'on' | 'off' | 'playing' | 'paused' | 'stopped' | 'idle' | string;
-export type TDenonavrReceiverType = 'avr' | 'avr-x' | 'avr-x-2016' | string;
-export type TDenonavrCommand = 'turn_on' | 'turn_off' | 'volume_up' | 'volume_down' | 'set_volume' | 'mute' | 'select_source' | 'play' | 'pause' | 'stop' | 'play_pause' | 'previous_track' | 'next_track' | 'get_command';
+export type TDenonavrModel = 'AVR-1913' | 'AVR-2113CI' | 'NR1605' | 'SR5009';
 export interface IDenonavrConfig {
-    host?: string;
-    port?: number;
+    homeId: string;
+    host: string;
+    descriptionUrl: string;
+    expectedUdn: string;
+    model: TDenonavrModel;
+    maximumVolumeDb: number;
     name?: string;
-    model?: string;
-    manufacturer?: string;
-    serialNumber?: string;
-    receiverType?: TDenonavrReceiverType;
-    descriptionPort?: number;
-    showAllSources?: boolean;
-    zone2?: boolean;
-    zone3?: boolean;
-    sourceMap?: Record<string, string>;
-    receiverInfo?: IDenonavrReceiverInfo;
-    zones?: IDenonavrZoneState[];
-    snapshot?: IDenonavrSnapshot;
-}
-export interface IHomeAssistantDenonavrConfig extends IDenonavrConfig {
-}
-export interface IDenonavrReceiverInfo {
-    host?: string;
     port?: number;
-    name?: string;
-    friendlyName?: string;
-    manufacturer?: string;
-    modelName?: string;
-    modelNumber?: string;
-    serialNumber?: string;
-    receiverType?: TDenonavrReceiverType;
-    receiverPort?: number;
-    presentationUrl?: string;
-    softwareVersion?: string;
+    timeoutMs?: number;
+    maxPendingOperations?: number;
+    maxDescriptionBytes?: number;
 }
-export interface IDenonavrMediaInfo {
-    title?: string;
-    artist?: string;
-    album?: string;
-    band?: string;
-    frequency?: string;
-    station?: string;
-    imageUrl?: string;
-    contentType?: string;
+export interface IHomeAssistantDenonavrConfig extends IDenonavrConfig {
 }
-export interface IDenonavrZoneState {
-    zone: TDenonavrZone;
-    name?: string;
-    power?: TDenonavrPowerState;
-    state?: TDenonavrMediaState;
-    volumeDb?: number;
-    volumeLevel?: number;
-    muted?: boolean;
-    source?: string;
-    sourceList?: string[];
-    sourceMap?: Record<string, string>;
-    soundMode?: string;
-    soundModeRaw?: string;
-    soundModeList?: string[];
-    dynamicEq?: boolean;
-    ecoMode?: string;
-    media?: IDenonavrMediaInfo;
-    available?: boolean;
+export interface IDenonavrIdentity {
+    readonly udn: string;
+    readonly manufacturer: 'Denon' | 'Marantz';
+    readonly model: TDenonavrModel;
+    readonly name: string;
+    readonly serialNumber?: string;
+    readonly source: 'selected-upnp-description';
+    readonly observedAt: string;
 }
+/** Receiver settings are observations, not proof of electrical or acoustic effects. */
 export interface IDenonavrSnapshot {
-    receiverInfo: IDenonavrReceiverInfo;
-    zones: IDenonavrZoneState[];
-    events?: IDenonavrEvent[];
-    lastUpdated?: string;
-}
-export interface IDenonavrCommandRequest {
-    command: TDenonavrCommand;
-    zone?: TDenonavrZone;
-    source?: string;
-    volumeLevel?: number;
-    volumeDb?: number;
-    muted?: boolean;
-    path?: string;
+    readonly homeId: string;
+    readonly host: string;
+    readonly port: number;
+    readonly name: string;
+    readonly identity: IDenonavrIdentity;
+    readonly power: 'on' | 'standby';
+    readonly muted: boolean;
+    readonly volumeDb: number | null;
+    readonly input: string;
+    readonly observedInputs: readonly string[];
+    readonly maximumVolumeDb: number;
+    readonly observedAt: string;
 }
-export interface IDenonavrEvent {
-    type: 'telnet' | 'http' | 'state';
-    zone?: TDenonavrZone;
-    event?: string;
-    parameter?: string;
-    command?: TDenonavrCommand;
-    timestamp: number;
+export type TDenonavrControl = {
+    feature: 'power';
+    value: boolean;
+} | {
+    feature: 'muted';
+    value: boolean;
+} | {
+    feature: 'volume_db';
+    value: number;
+} | {
+    feature: 'input';
+    value: string;
+};
+export interface IDenonavrEffectResult {
+    readonly dispatch: 'written';
+    readonly outcome: 'observed-target' | 'indeterminate';
+    readonly snapshot: IDenonavrSnapshot;
 }
 export interface IDenonavrSsdpRecord {
     st?: string;
@@ -95,20 +63,17 @@ export interface IDenonavrSsdpRecord {
     headers?: Record<string, string | undefined>;
     upnp?: Record<string, string | undefined>;
 }
-export interface IDenonavrMdnsRecord {
-    name?: string;
-    type?: string;
-    host?: string;
-    port?: number;
-    txt?: Record<string, string | undefined>;
-}
 export interface IDenonavrManualEntry {
     host?: string;
-    port?: number;
+    descriptionUrl?: string;
+    expectedUdn?: string;
     id?: string;
     name?: string;
     manufacturer?: string;
     model?: string;
-    serialNumber?: string;
     metadata?: Record<string, unknown>;
 }
+export interface IDenonavrIntegrationOptions {
+    readonly homeId?: string;
+    readonly capacity?: number;
+}

package/dist_ts/integrations/denonavr/denonavr.validation.d.ts

@@ -0,0 +1,10 @@
+import type { IDenonavrConfig, TDenonavrControl, TDenonavrModel } from './denonavr.types.js';
+export declare function denonavrRecord(value: unknown, allowed?: readonly string[]): Record<string, unknown>;
+export declare function denonavrText(value: unknown, label: string, maximum?: number): string;
+export declare function denonavrHost(value: unknown): string;
+export declare function denonavrModel(value: unknown): TDenonavrModel;
+export declare function denonavrUdn(value: unknown): string;
+export declare function denonavrDescription(value: unknown, host: string): string;
+export declare function denonavrVolume(value: unknown): number;
+export declare function normalizeDenonavrConfig(value: unknown): Readonly<Required<Omit<IDenonavrConfig, 'name'>> & Pick<IDenonavrConfig, 'name'>>;
+export declare function validateDenonavrControl(value: unknown): TDenonavrControl;

package/dist_ts/integrations/denonavr/denonavr.validation.js

@@ -0,0 +1,86 @@
+import * as plugins from '../../plugins.js';
+export function denonavrRecord(value, allowed) {
+    if (!value || typeof value !== 'object' || Array.isArray(value) || ![Object.prototype, null].includes(Object.getPrototypeOf(value))) {
+        throw new TypeError('DenonAVR input must be a plain data object.');
+    }
+    const result = {};
+    for (const key of Reflect.ownKeys(value)) {
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (typeof key !== 'string' || (allowed && !allowed.includes(key)) || !descriptor || !('value' in descriptor) || !descriptor.enumerable) {
+            throw new TypeError('DenonAVR input contains an unsupported field or accessor.');
+        }
+        Object.defineProperty(result, key, { value: descriptor.value, enumerable: true });
+    }
+    return result;
+}
+export function denonavrText(value, label, maximum = 256) {
+    if (typeof value !== 'string' || !value || value.length > maximum || value !== value.trim() || /[\p{Cc}\p{Cs}]/u.test(value)) {
+        throw new TypeError(`DenonAVR ${label} must be bounded text without control characters.`);
+    }
+    return value;
+}
+export function denonavrHost(value) {
+    if (typeof value !== 'string' || plugins.net.isIP(value) !== 4)
+        throw new TypeError('DenonAVR requires a selected private IPv4 address.');
+    const [first, second, , last] = value.split('.').map(Number);
+    if (!(first === 10 || first === 127 || (first === 172 && second >= 16 && second <= 31) || (first === 192 && second === 168)) || last === 0 || last === 255) {
+        throw new TypeError('DenonAVR requires a selected private or loopback host IPv4 address.');
+    }
+    return value;
+}
+export function denonavrModel(value) {
+    if (value !== 'AVR-1913' && value !== 'AVR-2113CI' && value !== 'NR1605' && value !== 'SR5009')
+        throw new TypeError('DenonAVR model has no documented selected-receiver profile.');
+    return value;
+}
+export function denonavrUdn(value) {
+    if (typeof value !== 'string' || !/^uuid:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value))
+        throw new TypeError('DenonAVR requires an exact UPnP UUID.');
+    return value.toLowerCase();
+}
+export function denonavrDescription(value, host) {
+    const text = denonavrText(value, 'description URL', 2048);
+    const url = new URL(text);
+    if (url.protocol !== 'http:' || url.hostname !== host || url.username || url.password || url.search || url.hash || url.pathname === '/') {
+        throw new TypeError('DenonAVR description URL must select an HTTP path at the receiver IP without credentials, query or fragment.');
+    }
+    return url.href;
+}
+export function denonavrVolume(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value) || value < -79.5 || value > 18 || !Number.isInteger(value * 2)) {
+        throw new TypeError('DenonAVR absolute volume must be -79.5 through 18 dB in half-decibel steps.');
+    }
+    return value;
+}
+function integer(value, fallback, minimum, maximum) {
+    if (value === undefined)
+        return fallback;
+    if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < minimum || value > maximum)
+        throw new RangeError('DenonAVR numeric bound is invalid.');
+    return value;
+}
+export function normalizeDenonavrConfig(value) {
+    const config = denonavrRecord(value, ['homeId', 'host', 'descriptionUrl', 'expectedUdn', 'model', 'maximumVolumeDb', 'name', 'port', 'timeoutMs', 'maxPendingOperations', 'maxDescriptionBytes']);
+    const host = denonavrHost(config.host);
+    return Object.freeze({
+        homeId: denonavrText(config.homeId, 'home ID'), host,
+        descriptionUrl: denonavrDescription(config.descriptionUrl, host), expectedUdn: denonavrUdn(config.expectedUdn),
+        model: denonavrModel(config.model), maximumVolumeDb: denonavrVolume(config.maximumVolumeDb),
+        ...(config.name === undefined ? {} : { name: denonavrText(config.name, 'name', 128) }),
+        port: integer(config.port, 23, 1, 65535), timeoutMs: integer(config.timeoutMs, 5000, 1, 60000),
+        maxPendingOperations: integer(config.maxPendingOperations, 16, 1, 128), maxDescriptionBytes: integer(config.maxDescriptionBytes, 65536, 256, 1048576),
+    });
+}
+export function validateDenonavrControl(value) {
+    const control = denonavrRecord(value, ['feature', 'value']);
+    if (control.feature === 'power' && typeof control.value === 'boolean')
+        return { feature: 'power', value: control.value };
+    if (control.feature === 'muted' && typeof control.value === 'boolean')
+        return { feature: 'muted', value: control.value };
+    if (control.feature === 'volume_db')
+        return { feature: 'volume_db', value: denonavrVolume(control.value) };
+    if (control.feature === 'input')
+        return { feature: 'input', value: denonavrText(control.value, 'physical input', 25) };
+    throw new TypeError('DenonAVR supports one explicit power, mute, absolute volume or observed physical input control.');
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVub25hdnIudmFsaWRhdGlvbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3RzL2ludGVncmF0aW9ucy9kZW5vbmF2ci9kZW5vbmF2ci52YWxpZGF0aW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sa0JBQWtCLENBQUM7QUFHNUMsTUFBTSxVQUFVLGNBQWMsQ0FBQyxLQUFjLEVBQUUsT0FBMkI7SUFDeEUsSUFBSSxDQUFDLEtBQUssSUFBSSxPQUFPLEtBQUssS0FBSyxRQUFRLElBQUksS0FBSyxDQUFDLE9BQU8sQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLENBQUMsTUFBTSxDQUFDLFNBQVMsRUFBRSxJQUFJLENBQUMsQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDLGNBQWMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxFQUFFLENBQUM7UUFDcEksTUFBTSxJQUFJLFNBQVMsQ0FBQyw2Q0FBNkMsQ0FBQyxDQUFDO0lBQ3JFLENBQUM7SUFDRCxNQUFNLE1BQU0sR0FBNEIsRUFBRSxDQUFDO0lBQzNDLEtBQUssTUFBTSxHQUFHLElBQUksT0FBTyxDQUFDLE9BQU8sQ0FBQyxLQUFLLENBQUMsRUFBRSxDQUFDO1FBQ3pDLE1BQU0sVUFBVSxHQUFHLE1BQU0sQ0FBQyx3QkFBd0IsQ0FBQyxLQUFLLEVBQUUsR0FBRyxDQUFDLENBQUM7UUFDL0QsSUFBSSxPQUFPLEdBQUcsS0FBSyxRQUFRLElBQUksQ0FBQyxPQUFPLElBQUksQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBQyxDQUFDLElBQUksQ0FBQyxVQUFVLElBQUksQ0FBQyxDQUFDLE9BQU8sSUFBSSxVQUFVLENBQUMsSUFBSSxDQUFDLFVBQVUsQ0FBQyxVQUFVLEVBQUUsQ0FBQztZQUN4SSxNQUFNLElBQUksU0FBUyxDQUFDLDJEQUEyRCxDQUFDLENBQUM7UUFDbkYsQ0FBQztRQUNELE1BQU0sQ0FBQyxjQUFjLENBQUMsTUFBTSxF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

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

@@ -1,16 +1,17 @@
 import * as plugins from '../../plugins.js';
-import type { IEsphomeClientCommand, IEsphomeCommandResult, IEsphomeConfig, IEsphomeEvent, IEsphomeSnapshot } from './esphome.types.js';
+import type { IEsphomeClientCommand, IEsphomeCommandResult, IEsphomeConfig, IEsphomeEvent, IEsphomeSnapshot, TEsphomeCredentials } from './esphome.types.js';
 type TEsphomeEventHandler = (eventArg: IEsphomeEvent) => void;
 type TNativeClient = plugins.esphomeNativeApi.EspHomeClient;
 export declare class EsphomeClient {
     private readonly connection;
-    constructor(configArg: IEsphomeConfig, nativeClientArg?: TNativeClient);
+    constructor(configArg: IEsphomeConfig, nativeClientArg?: TNativeClient, credentialsArg?: TEsphomeCredentials);
     connectLive(signalArg?: AbortSignal): Promise<void>;
     isHealthy(): boolean;
     getSnapshot(): Promise<IEsphomeSnapshot>;
-    onEvent(handlerArg: TEsphomeEventHandler): () => void;
+    onEvent(handlerArg: TEsphomeEventHandler, signalArg?: AbortSignal): () => void;
     sendCommand(commandArg: IEsphomeClientCommand, signalArg?: AbortSignal): Promise<IEsphomeCommandResult>;
     destroy(): Promise<void>;
+    retryCleanup(): Promise<void>;
 }
 export declare class EsphomeNativeApiConnection {
     private readonly native;
@@ -19,27 +20,38 @@ export declare class EsphomeNativeApiConnection {
     private readonly setupTimeoutMs;
     private readonly commandTimeoutMs;
     private readonly requireEncryption;
+    private readonly config;
     private readonly handlers;
-    private readonly subscriptions;
+    private readonly cleanup;
+    private readonly operations;
     private readonly pendingCommands;
     private readonly lifetime;
     private ready;
     private connecting;
     private destroyed;
-    constructor(configArg: IEsphomeConfig, nativeClientArg?: TNativeClient);
+    private subscriptionsStarted;
+    private identityMismatch;
+    private closePromise?;
+    private retryPromise?;
+    constructor(configArg: IEsphomeConfig, nativeClientArg?: TNativeClient, credentialsArg?: TEsphomeCredentials);
+    private startSubscriptions;
     connect(signalArg?: AbortSignal): Promise<void>;
     isHealthy(): boolean;
     getSnapshot(): IEsphomeSnapshot;
-    onEvent(handlerArg: TEsphomeEventHandler): () => void;
+    onEvent(handlerArg: TEsphomeEventHandler, signalArg?: AbortSignal): () => void;
     sendCommand(commandArg: IEsphomeClientCommand, signalArg?: AbortSignal): Promise<IEsphomeCommandResult>;
+    private executeTrackedCommand;
     destroy(): Promise<void>;
+    retryCleanup(): Promise<void>;
+    private track;
+    private drain;
     private executeCommand;
     private entityDescriptor;
     private refreshReadiness;
+    private assertIdentity;
     private entityId;
     private eventEntityId;
     private waitForInitialStates;
     private emit;
-    private timeout;
 }
 export {};