@smarthome.exchange/integrations 1.0.0 → 2.0.0

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

@@ -1,20 +1,87 @@
-import type { ISimpleLocalConfig, ISimpleLocalIntegrationProfile, ISimpleLocalSnapshot, TSimpleLocalRawData } from '../../core/index.js';
+import type { ISimpleLocalIntegrationProfile, ISimpleLocalSnapshot, TSimpleLocalRawData } from '../../core/classes.simplelocalintegration.js';
 export declare const pioneerDomain = "pioneer";
 export declare const pioneerDefaultName = "Pioneer";
 export declare const pioneerDefaultPort = 23;
 export declare const pioneerMaxVolume = 185;
-export declare const pioneerMaxSourceNumbers = 60;
-export type TPioneerRawData = TSimpleLocalRawData;
-export interface IPioneerSnapshot extends ISimpleLocalSnapshot {
-}
-export interface IPioneerConfig extends ISimpleLocalConfig {
-    url?: string;
-    macAddress?: string;
-    deviceId?: string;
-    sources?: Record<string, string>;
-    sourceScanLimit?: number;
-    commandTimeoutMs?: number;
+export type TPioneerModel = 'SC-95';
+export interface IPioneerConfig {
+    homeId: string;
+    host: string;
+    descriptionUrl: string;
+    expectedUdn: string;
+    model: TPioneerModel;
+    allowUnencryptedLan: true;
+    maximumVolumeRaw: number;
+    name?: string;
+    port?: number;
+    timeoutMs?: number;
+    maxPendingOperations?: number;
+    maxDescriptionBytes?: number;
+    maxFrameBytes?: number;
 }
 export interface IHomeAssistantPioneerConfig extends IPioneerConfig {
 }
+export interface IPioneerIdentity {
+    readonly udn: string;
+    readonly model: TPioneerModel;
+    readonly manufacturer: 'Pioneer';
+    readonly reportedManufacturer: string;
+    readonly name: string;
+    readonly serialNumber?: string;
+    readonly source: 'selected-upnp-description';
+    readonly trust: 'unauthenticated-lan';
+    readonly observedAt: string;
+}
+export interface IPioneerSnapshot {
+    readonly homeId: string;
+    readonly host: string;
+    readonly port: number;
+    readonly name: string;
+    readonly identity: IPioneerIdentity;
+    readonly power: boolean;
+    readonly muted: boolean;
+    readonly volumeRaw: number;
+    readonly inputId: string;
+    readonly observedInputs: readonly string[];
+    readonly maximumVolumeRaw: number;
+    readonly observedAt: string;
+}
+export type TPioneerControl = {
+    feature: 'power';
+    value: boolean;
+} | {
+    feature: 'muted';
+    value: boolean;
+} | {
+    feature: 'volume_raw';
+    value: number;
+} | {
+    feature: 'input';
+    value: string;
+};
+export interface IPioneerEffectResult {
+    readonly dispatch: 'written';
+    readonly outcome: 'observed-target' | 'indeterminate';
+    readonly commandAcknowledged: false;
+    readonly causalityConfirmed: false;
+    readonly snapshot: IPioneerSnapshot;
+}
+export interface IPioneerManualEntry {
+    host?: string;
+    descriptionUrl?: string;
+    expectedUdn?: string;
+    id?: string;
+    name?: string;
+    manufacturer?: string;
+    model?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface IPioneerOfflineConfig {
+    name?: string;
+    uniqueId?: string;
+    metadata?: Record<string, unknown>;
+}
+export type TPioneerRawData = TSimpleLocalRawData;
+export interface IPioneerOfflineSnapshot extends ISimpleLocalSnapshot {
+}
 export declare const pioneerProfile: ISimpleLocalIntegrationProfile;

package/dist_ts/integrations/pioneer/pioneer.types.js

@@ -1,83 +1,19 @@
-export const pioneerDomain = "pioneer";
-export const pioneerDefaultName = "Pioneer";
+export const pioneerDomain = 'pioneer';
+export const pioneerDefaultName = 'Pioneer';
 export const pioneerDefaultPort = 23;
 export const pioneerMaxVolume = 185;
-export const pioneerMaxSourceNumbers = 60;
 export const pioneerProfile = {
-    domain: pioneerDomain,
-    displayName: "Pioneer",
-    manufacturer: "Pioneer",
-    model: "Pioneer local integration",
-    defaultName: pioneerDefaultName,
-    defaultPort: pioneerDefaultPort,
-    defaultProtocol: 'telnet',
-    status: "control-runtime",
-    platforms: [
-        "media_player",
-    ],
-    serviceDomains: [
-        "media_player",
-    ],
-    controlServices: [
-        "select_source",
-        "set_volume_level",
-        "turn_off",
-        "turn_on",
-        "volume_mute",
-        "volume_down",
-        "volume_up",
-    ],
-    discoverySources: [
-        'manual',
-        'custom',
-    ],
-    discoveryKeywords: [
-        "pioneer",
-        "Pioneer",
-    ],
+    domain: pioneerDomain, displayName: 'Pioneer selected SC-95 receiver', manufacturer: 'Pioneer', model: 'SC-95',
+    defaultName: pioneerDefaultName, defaultPort: pioneerDefaultPort, defaultProtocol: 'tcp', status: 'control-runtime',
+    platforms: ['media_player'], serviceDomains: ['media_player'],
+    controlServices: ['turn_on', 'turn_off', 'volume_mute', 'set_volume_raw', 'select_source'], discoverySources: ['manual'],
+    discoveryKeywords: ['pioneer'],
     metadata: {
-        "source": "home-assistant/core",
-        "upstreamPath": "homeassistant/components/pioneer",
-        "upstreamDomain": "pioneer",
-        "iotClass": "local_polling",
-        "qualityScale": "legacy",
-        "configFlow": false,
-        "requirements": [],
-        "documentation": "https://www.home-assistant.io/integrations/pioneer",
-        "runtime": {
-            "type": "control-runtime",
-            "services": [
-                "snapshot",
-                "status",
-                "refresh",
-                "select_source",
-                "set_volume_level",
-                "turn_off",
-                "turn_on",
-                "volume_mute",
-                "volume_down",
-                "volume_up",
-            ],
-            "platforms": [
-                "media_player",
-            ],
-            "controls": "native Pioneer telnet commands for power, mute, source, and volume; injected executors remain supported",
-        },
-        "localApi": {
-            "implemented": [
-                "native Pioneer AVR Telnet/TCP polling on port 23 using ?P, ?V, ?M, ?RGBxx, and ?F",
-                "native Pioneer AVR Telnet/TCP control using PO, PF, VU, VD, xxxVL, MO, MF, and xxFN",
-                "manual local setup for Pioneer endpoints, snapshots, rawData, snapshotProvider, and injected native clients",
-                "runtime mapping for Pioneer device snapshots and Home Assistant platform metadata",
-                "safe command delegation to injected client.execute or commandExecutor",
-            ],
-            "explicitUnsupported": [
-                "Pioneer pairing, subscriptions, and event streams because the Home Assistant source only documents polling Telnet commands",
-                "media_play and media_pause because the Home Assistant Pioneer source declares features but exposes no concrete Telnet command implementation",
-                "Home Assistant entity registry migrations and repair flows",
-                "claiming write success for commands outside the documented Pioneer Telnet command set without injected client.execute or commandExecutor",
-            ],
+        source: 'native-typescript', upstreamDomain: pioneerDomain, upstreamPath: 'homeassistant/components/pioneer',
+        localApi: {
+            implemented: ['selected SC-95/CUXJ main-zone protocol', 'exact home-scoped admission', 'absolute raw integer volume', 'receiver-observed physical input selection'],
+            explicitUnsupported: ['injected clients or executors', 'native runtime snapshots', 'arbitrary ASCII commands', 'toggles or relative controls', 'dB or percentage volume conversion', 'advanced zones or media playback', 'automatic retry or reconnect'],
         },
     },
 };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGlvbmVlci50eXBlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3RzL2ludGVncmF0aW9ucy9waW9uZWVyL3Bpb25lZXIudHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsTUFBTSxDQUFDLE1BQU0sYUFBYSxHQUFHLFNBQVMsQ0FBQztBQUN2QyxNQUFNLENBQUMsTUFBTSxrQkFBa0IsR0FBRyxTQUFTLENBQUM7QUFDNUMsTUFBTSxDQUFDLE1BQU0sa0JBQWtCLEdBQUcsRUFBRSxDQUFDO0FBQ3JDLE1BQU0sQ0FBQyxNQUFNLGdCQUFnQixHQUFHLEdBQUcsQ0FBQztBQUNwQyxNQUFNLENBQUMsTUFBTSx1QkFBdUIsR0FBRyxFQUFFLENBQUM7QUFjMUMsTUFBTSxDQUFDLE1BQU0sY0FBYyxHQUFtQztJQUM1RCxNQUFNLEVBQUUsYUFBYTtJQUNyQixXQUFXLEVBQUUsU0FBUztJQUN0QixZQUFZLEVBQUUsU0FBUztJQUN2QixLQUFLLEVBQUUsMkJBQTJCO0lBQ2xDLFdBQVcsRUFBRSxrQkFBa0I7SUFDL0IsV0FBVyxFQUFFLGtCQUFrQjtJQUMvQixlQUFlLEVBQUUsUUFBUTtJQUN6QixNQUFNLEVBQUUsaUJBQWlCO0lBQ3pCLFNBQVMsRUFBRTtRQUNULGNBQWM7S0FDZjtJQUNELGNBQWMsRUFBRTtRQUNkLGNBQWM7S0FDZjtJQUNELGVBQWUsRUFBRTtRQUNmLGVBQWU7UUFDZixrQkFBa0I7UUFDbEIsVUFBVTtRQUNWLFNBQVM7UUFDVCxhQUFhO1FBQ2IsYUFBYTtRQUNiLFdBQVc7S0FDWjtJQUNELGdCQUFnQixFQUFFO1FBQ2hCLFFBQVE7UUFDUixRQUFRO0tBQ1Q7SUFDRCxpQkFBaUIsRUFBRTtRQUNqQixTQUFTO1FBQ1QsU0FBUztLQUNWO0lBQ0QsUUFBUSxFQUFFO1FBQ1IsUUFBUSxFQUFFLHFCQUFxQjtRQUMvQixjQUFjLEVBQUUsa0NBQWtDO1FBQ2xELGdCQUFnQixFQUFFLFNBQVM7UUFDM0IsVUFBVSxFQUFFLGVBQWU7UUFDM0IsY0FBYyxFQUFFLFFBQVE7UUFDeEIsWUFBWSxFQUFFLEtBQUs7UUFDbkIsY0FBYyxFQUFFLEVBQUU7UUFDbEIsZUFBZSxFQUFFLG9EQUFvRDtRQUNyRSxTQUFTLEVBQUU7WUFDVCxNQUFNLEVBQUUsaUJBQWlCO1lBQ3pCLFVBQVUsRUFBRTtnQkFDVixVQUFVO2dCQUNWLFFBQVE7Z0JBQ1IsU0FBUztnQkFDVCxlQUFlO2dCQUNmLGtCQUFrQjtnQkFDbEIsVUFBVTtnQkFDVixTQUFTO2dCQUNULGFBQWE7Z0JBQ2IsYUFBYTtnQkFDYixXQUFXO2FBQ1o7WUFDRCxXQUFXLEVBQUU7Z0JBQ1gsY0FBYzthQUNmO1lBQ0QsVUFBVSxFQUFFLHlHQUF5RztTQUN0SDtRQUNELFVBQVUsRUFBRTtZQUNWLGFBQWEsRUFBRTtnQkFDYixtRkFBbUY7Z0JBQ25GLHFGQUFxRjtnQkFDckYsNkdBQTZHO2dCQUM3RyxtRkFBbUY7Z0JBQ25GLHVFQUF1RTthQUN4RTtZQUNELHFCQUFxQixFQUFFO2dCQUNyQiw0SEFBNEg7Z0JBQzVILDhJQUE4STtnQkFDOUksNERBQTREO2dCQUM1RCwwSUFBMEk7YUFDM0k7U0FDRjtLQUNGO0NBQ0YsQ0FBQyJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGlvbmVlci50eXBlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3RzL2ludGVncmF0aW9ucy9waW9uZWVyL3Bpb25lZXIudHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsTUFBTSxDQUFDLE1BQU0sYUFBYSxHQUFHLFNBQVMsQ0FBQztBQUN2QyxNQUFNLENBQUMsTUFBTSxrQkFBa0IsR0FBRyxTQUFTLENBQUM7QUFDNUMsTUFBTSxDQUFDLE1BQU0sa0JBQWtCLEdBQUcsRUFBRSxDQUFDO0FBQ3JDLE1BQU0sQ0FBQyxNQUFNLGdCQUFnQixHQUFHLEdBQUcsQ0FBQztBQWdGcEMsTUFBTSxDQUFDLE1BQU0sY0FBYyxHQUFtQztJQUM1RCxNQUFNLEVBQUUsYUFBYSxFQUFFLFdBQVcsRUFBRSxpQ0FBaUMsRUFBRSxZQUFZLEVBQUUsU0FBUyxFQUFFLEtBQUssRUFBRSxPQUFPO0lBQzlHLFdBQVcsRUFBRSxrQkFBa0IsRUFBRSxXQUFXLEVBQUUsa0JBQWtCLEVBQUUsZUFBZSxFQUFFLEtBQUssRUFBRSxNQUFNLEVBQUUsaUJBQWlCO0lBQ25ILFNBQVMsRUFBRSxDQUFDLGNBQWMsQ0FBQyxFQUFFLGNBQWMsRUFBRSxDQUFDLGNBQWMsQ0FBQztJQUM3RCxlQUFlLEVBQUUsQ0FBQyxTQUFTLEVBQUUsVUFBVSxFQUFFLGFBQWEsRUFBRSxnQkFBZ0IsRUFBRSxlQUFlLENBQUMsRUFBRSxnQkFBZ0IsRUFBRSxDQUFDLFFBQVEsQ0FBQztJQUN4SCxpQkFBaUIsRUFBRSxDQUFDLFNBQVMsQ0FBQztJQUM5QixRQUFRLEVBQUU7UUFDUixNQUFNLEVBQUUsbUJBQW1CLEVBQUUsY0FBYyxFQUFFLGFBQWEsRUFBRSxZQUFZLEVBQUUsa0NBQWtDO1FBQzVHLFFBQVEsRUFBRTtZQUNSLFdBQVcsRUFBRSxDQUFDLHdDQUF3QyxFQUFFLDZCQUE2QixFQUFFLDZCQUE2QixFQUFFLDRDQUE0QyxDQUFDO1lBQ25LLG1CQUFtQixFQUFFLENBQUMsK0JBQStCLEVBQUUsMEJBQTBCLEVBQUUsMEJBQTBCLEVBQUUsOEJBQThCLEVBQUUsb0NBQW9DLEVBQUUsa0NBQWtDLEVBQUUsOEJBQThCLENBQUM7U0FDelA7S0FDRjtDQUNGLENBQUMifQ==

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

@@ -0,0 +1,10 @@
+import type { IPioneerConfig, TPioneerControl } from './pioneer.types.js';
+export declare function pioneerRecord(value: unknown, allowed?: readonly string[]): Record<string, unknown>;
+export declare function pioneerText(value: unknown, label: string, maximum?: number): string;
+export declare function pioneerHost(value: unknown): string;
+export declare function pioneerUdn(value: unknown): string;
+export declare function pioneerDescription(value: unknown, host: string): string;
+export declare function pioneerVolume(value: unknown): number;
+export declare const pioneerConfigKeys: readonly ['homeId', 'host', 'descriptionUrl', 'expectedUdn', 'model', 'allowUnencryptedLan', 'maximumVolumeRaw', 'name', 'port', 'timeoutMs', 'maxPendingOperations', 'maxDescriptionBytes', 'maxFrameBytes'];
+export declare function normalizePioneerConfig(value: unknown): Readonly<Required<Omit<IPioneerConfig, 'name'>> & Pick<IPioneerConfig, 'name'>>;
+export declare function validatePioneerControl(value: unknown): TPioneerControl;

package/dist_ts/integrations/pioneer/pioneer.validation.js

@@ -0,0 +1,85 @@
+import * as plugins from '../../plugins.js';
+export function pioneerRecord(value, allowed) {
+    if (!value || typeof value !== 'object' || Array.isArray(value) || ![Object.prototype, null].includes(Object.getPrototypeOf(value))) {
+        throw new TypeError('Pioneer 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('Pioneer input contains an unsupported field or accessor.');
+        }
+        Object.defineProperty(result, key, { value: descriptor.value, enumerable: true });
+    }
+    return result;
+}
+export function pioneerText(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(`Pioneer ${label} must be bounded text without control characters.`);
+    }
+    return value;
+}
+export function pioneerHost(value) {
+    if (typeof value !== 'string' || plugins.net.isIP(value) !== 4)
+        throw new TypeError('Pioneer 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('Pioneer requires a selected private or loopback IPv4 host.');
+    }
+    return value;
+}
+export function pioneerUdn(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('Pioneer requires an exact UPnP UUID.');
+    return value.toLowerCase();
+}
+export function pioneerDescription(value, host) {
+    const url = new URL(pioneerText(value, 'description URL', 2048));
+    if (url.protocol !== 'http:' || url.hostname !== host || url.username || url.password || url.hash || url.search || url.pathname === '/') {
+        throw new TypeError('Pioneer description must select an HTTP path at the receiver IP without credentials, query or fragment.');
+    }
+    return url.href;
+}
+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('Pioneer numeric bound is invalid.');
+    return value;
+}
+export function pioneerVolume(value) {
+    if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 0 || value > 185)
+        throw new TypeError('Pioneer volume must be a raw integer from 0 through 185.');
+    return value;
+}
+export const pioneerConfigKeys = ['homeId', 'host', 'descriptionUrl', 'expectedUdn', 'model', 'allowUnencryptedLan', 'maximumVolumeRaw', 'name', 'port', 'timeoutMs', 'maxPendingOperations', 'maxDescriptionBytes', 'maxFrameBytes'];
+export function normalizePioneerConfig(value) {
+    const config = pioneerRecord(value, pioneerConfigKeys);
+    const host = pioneerHost(config.host);
+    if (config.model !== 'SC-95')
+        throw new TypeError('Pioneer model has no admitted vendor profile.');
+    if (config.allowUnencryptedLan !== true)
+        throw new TypeError('Pioneer requires an explicit plaintext LAN acknowledgement.');
+    return Object.freeze({
+        homeId: pioneerText(config.homeId, 'home ID'), host, descriptionUrl: pioneerDescription(config.descriptionUrl, host),
+        expectedUdn: pioneerUdn(config.expectedUdn), model: config.model, allowUnencryptedLan: config.allowUnencryptedLan,
+        maximumVolumeRaw: pioneerVolume(config.maximumVolumeRaw),
+        ...(config.name === undefined ? {} : { name: pioneerText(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), maxFrameBytes: integer(config.maxFrameBytes, 512, 16, 4096),
+    });
+}
+export function validatePioneerControl(value) {
+    const control = pioneerRecord(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_raw')
+        return { feature: 'volume_raw', value: pioneerVolume(control.value) };
+    if (control.feature === 'input' && typeof control.value === 'string' && /^\d{2}$/.test(control.value))
+        return { feature: 'input', value: control.value };
+    throw new TypeError('Pioneer supports one explicit power, mute, raw volume or observed physical input control.');
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGlvbmVlci52YWxpZGF0aW9uLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvaW50ZWdyYXRpb25zL3Bpb25lZXIvcGlvbmVlci52YWxpZGF0aW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sa0JBQWtCLENBQUM7QUFHNUMsTUFBTSxVQUFVLGFBQWEsQ0FBQyxLQUFjLEVBQUUsT0FBMkI7SUFDdkUsSUFBSSxDQUFDLEtBQUssSUFBSSxPQUFPLEtBQUssS0FBSyxRQUFRLElBQUksS0FBSyxDQUFDLE9BQU8sQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLENBQUMsTUFBTSxDQUFDLFNBQVMsRUFBRSxJQUFJLENBQUMsQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDLGNBQWMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxFQUFFLENBQUM7UUFDcEksTUFBTSxJQUFJLFNBQVMsQ0FBQyw0Q0FBNEMsQ0FBQyxDQUFDO0lBQ3BFLENBQUM7SUFDRCxNQUFNLE1BQU0sR0FBNEIsRUFBRSxDQUFDO0lBQzNDLEtBQUssTUFBTSxHQUFHLElBQUksT0FBTyxDQUFDLE9BQU8sQ0FBQyxLQUFLLENBQUMsRUFBRSxDQUFDO1FBQ3pDLE1BQU0sVUFBVSxHQUFHLE1BQU0sQ0FBQyx3QkFBd0IsQ0FBQyxLQUFLLEVBQUUsR0FBRyxDQUFDLENBQUM7UUFDL0QsSUFBSSxPQUFPLEdBQUcsS0FBSyxRQUFRLElBQUksQ0FBQyxPQUFPLElBQUksQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBQyxDQUFDLElBQUksQ0FBQyxVQUFVLElBQUksQ0FBQyxDQUFDLE9BQU8sSUFBSSxVQUFVLENBQUMsSUFBSSxDQUFDLFVBQVUsQ0FBQyxVQUFVLEVBQUUsQ0FBQztZQUN4SSxNQUFNLElBQUksU0FBUyxDQUFDLDBEQUEwRCxDQUFDLENBQUM7UUFDbEYsQ0FBQztRQUNELE1BQU0sQ0FBQyxjQUFjLENBQUMsTUFBTSxFQUFF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

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

@@ -1,39 +1,16 @@
-import type { ISoundtouchCommandRequest, ISoundtouchConfig, ISoundtouchSnapshot } from './soundtouch.types.js';
+import * as plugins from '../../plugins.js';
+import type { ISoundtouchConfig, ISoundtouchSetupContext, ISoundtouchSnapshot, TSoundtouchClientEvent } from './soundtouch.types.js';
+/** Owns one selected published protocol and a bounded logical operation lifetime. */
 export declare class SoundtouchClient {
-    private readonly config;
-    constructor(config: ISoundtouchConfig);
-    getSnapshot(): Promise<ISoundtouchSnapshot>;
-    validateConnection(): Promise<ISoundtouchSnapshot>;
-    execute(requestArg: ISoundtouchCommandRequest): Promise<unknown>;
+    #private;
+    constructor(configArg: ISoundtouchConfig, contextArg: ISoundtouchSetupContext);
+    isHealthy(): boolean;
+    getSnapshot(signalArg?: AbortSignal): Promise<ISoundtouchSnapshot>;
+    setVolume(valueArg: number, signalArg?: AbortSignal): Promise<plugins.ecobridgeDeviceManager.IBoseSoundTouchControlResult>;
+    setMuted(valueArg: boolean, signalArg?: AbortSignal): Promise<plugins.ecobridgeDeviceManager.IBoseSoundTouchControlResult>;
+    writeFeature(idArg: string, valueArg: plugins.shxInterfaces.data.TDeviceStateValue, signalArg?: AbortSignal): Promise<plugins.ecobridgeDeviceManager.IBoseSoundTouchControlResult>;
+    subscribe(handlerArg: (eventArg: TSoundtouchClientEvent) => void, signalArg?: AbortSignal): () => void;
     destroy(): Promise<void>;
-    private setPower;
-    private setVolume;
-    private setMute;
-    private selectSource;
-    private playPreset;
-    private playMedia;
-    private playUrl;
-    private sendKey;
-    private sendSelectXml;
-    private findPreset;
-    private contentItemXml;
-    private fetchText;
-    private optionalText;
-    private requestText;
-    private rawRequest;
-    private parseDeviceInfo;
-    private parseStatus;
-    private parseContentItem;
-    private parseVolume;
-    private parsePresets;
-    private parseZoneStatus;
-    private normalizeSnapshot;
-    private manualSnapshot;
-    private ensureCommandTransport;
-    private executorResultToText;
-    private volumePercent;
-    private port;
-    private dlnaPort;
-    private baseUrl;
-    private cloneValue;
+    /** Explicit cleanup retry only; never repeats an HTTP control or observation. */
+    retryCleanup(): Promise<void>;
 }