@homebridge-plugins/homebridge-eufy-security 4.7.1 → 5.0.0-beta.0

package/dist/account/temporary-authentication.js

@@ -0,0 +1,348 @@
+import { discoverCompleteDeviceSnapshot, } from '../device/snapshot.js';
+const FLOW_TIMEOUT = Symbol('flow-timeout');
+/**
+ * Narrows a full SDK client to the observation-only surface of an interactive authentication flow.
+ *
+ * The returned client exposes no persistent write, momentary action, rename, reboot, or raw transport
+ * operation, so authenticating and discovering an account cannot change device state.
+ */
+export function observationOnlyAuthenticationClient(client) {
+    return {
+        login: () => client.login(),
+        solveCaptcha: (answer) => client.solveCaptcha(answer),
+        submitVerifyCode: (code) => client.submitVerifyCode(code),
+        discover: () => discoverCompleteDeviceSnapshot(client),
+        disconnect: () => client.disconnect(),
+    };
+}
+/** Owns one isolated SDK client for an interactive authentication flow. */
+export class TemporaryAuthentication {
+    ownership;
+    persistence;
+    clientFactory;
+    options;
+    runtimeActivity;
+    runtimeStandDown;
+    client;
+    leases = [];
+    stores;
+    cleanupPromise;
+    preparation;
+    flowTimer;
+    flowDeadline;
+    cleanupDeadline;
+    state = 'new';
+    terminalResult;
+    continuationPending = false;
+    inputConfiguration;
+    constructor(ownership, persistence, clientFactory, options, runtimeActivity, runtimeStandDown) {
+        this.ownership = ownership;
+        this.persistence = persistence;
+        this.clientFactory = clientFactory;
+        this.options = options;
+        this.runtimeActivity = runtimeActivity;
+        this.runtimeStandDown = runtimeStandDown;
+    }
+    async start(input) {
+        if (this.state !== 'new') {
+            return { status: 'failed' };
+        }
+        this.state = 'starting';
+        this.inputConfiguration = input.configuration;
+        this.armFlowDeadline();
+        try {
+            const runtime = this.runtimeActivity ? await this.waitForFlow(this.runtimeActivity.fresh()) : null;
+            if (runtime === FLOW_TIMEOUT) {
+                return this.expire();
+            }
+            if (runtime) {
+                const stoodDown = this.runtimeStandDown
+                    ? await this.waitForFlow(this.runtimeStandDown.requestStandDown())
+                    : false;
+                if (stoodDown === FLOW_TIMEOUT) {
+                    return this.expire();
+                }
+                if (!stoodDown) {
+                    this.state = 'settled';
+                    const result = { status: 'plugin-running', ...runtime };
+                    this.terminalResult = result;
+                    return result;
+                }
+            }
+            if (this.isSettled()) {
+                return this.terminalResult ?? { status: 'closed' };
+            }
+            this.preparation = this.prepare(input);
+            const preparationResult = await this.waitForFlow(this.preparation);
+            if (preparationResult === FLOW_TIMEOUT) {
+                return this.expire();
+            }
+            if (preparationResult) {
+                await this.cleanup(false);
+                return preparationResult;
+            }
+            if (this.state !== 'starting' || !this.client) {
+                return this.terminalResult ?? { status: 'closed' };
+            }
+            this.state = 'active';
+            const result = await this.waitForFlow(this.client.login());
+            if (this.state !== 'active') {
+                return this.terminalResult ?? { status: 'closed' };
+            }
+            return result === FLOW_TIMEOUT ? this.expire() : await this.apply(result);
+        }
+        catch {
+            if (this.isSettled()) {
+                return this.terminalResult ?? { status: 'closed' };
+            }
+            return this.fail();
+        }
+    }
+    async prepare(input) {
+        const account = input.configuration.username?.trim().toLowerCase();
+        const password = input.configuration.password;
+        if (!account || !password) {
+            throw new TypeError('temporary authentication requires account credentials');
+        }
+        const activeAccount = await this.persistence.active?.();
+        const activeConfiguration = activeAccount?.configuration?.load();
+        if (activeConfiguration) {
+            if (activeConfiguration.username?.trim().toLowerCase() !== activeAccount.account) {
+                throw new Error('active account generation has mismatched configuration');
+            }
+            this.inputConfiguration = {
+                ...activeConfiguration,
+                username: input.configuration.username,
+                password: input.configuration.password,
+                country: input.configuration.country,
+                trustedDeviceName: input.configuration.trustedDeviceName,
+                entityPreferences: {
+                    ...input.configuration.entityPreferences,
+                    ...activeConfiguration.entityPreferences,
+                },
+            };
+        }
+        if (this.state === 'settled') {
+            return this.terminalResult ?? { status: 'closed' };
+        }
+        const accountScopes = activeAccount && activeAccount.account !== account ? [activeAccount.account, account] : [account];
+        for (const accountScope of accountScopes) {
+            const ownership = await this.ownership.acquire(accountScope, 'temporary-authentication');
+            if (this.isSettled()) {
+                if (ownership.state === 'owner') {
+                    this.leases.push(ownership.lease);
+                }
+                return this.terminalResult ?? { status: 'closed' };
+            }
+            if (ownership.state === 'owner-conflict') {
+                this.state = 'settled';
+                const result = { status: 'blocked', owner: ownership.owner };
+                this.terminalResult = result;
+                return result;
+            }
+            this.leases.push(ownership.lease);
+        }
+        this.stores = await this.persistence.stage(account);
+        if (this.isSettled()) {
+            await this.boundedStore(this.stores.discard());
+            return this.terminalResult ?? { status: 'closed' };
+        }
+        this.client = this.clientFactory({
+            account,
+            password,
+            country: this.inputConfiguration.country,
+            trustedDeviceName: this.inputConfiguration.trustedDeviceName,
+            sessionStore: this.stores.session,
+            pushStore: this.stores.push,
+        });
+        return undefined;
+    }
+    async submitCaptcha(answer) {
+        if (this.challenge !== 'captcha') {
+            return { status: 'failed' };
+        }
+        return this.continue(() => this.client.solveCaptcha(answer));
+    }
+    async submitTwoFactor(code) {
+        if (this.challenge !== 'two-factor') {
+            return { status: 'failed' };
+        }
+        return this.continue(() => this.client.submitVerifyCode(code));
+    }
+    challenge;
+    async continue(operation) {
+        if (this.state !== 'active' || !this.client || this.continuationPending) {
+            return { status: 'failed' };
+        }
+        this.continuationPending = true;
+        try {
+            const result = await this.waitForFlow(operation());
+            if (this.state !== 'active') {
+                return this.terminalResult ?? { status: 'closed' };
+            }
+            return result === FLOW_TIMEOUT ? this.expire() : await this.apply(result);
+        }
+        catch {
+            if (this.isSettled()) {
+                return this.terminalResult ?? { status: 'closed' };
+            }
+            return this.fail();
+        }
+        finally {
+            this.continuationPending = false;
+        }
+    }
+    async close() {
+        if (this.state === 'settled') {
+            await this.cleanupPromise;
+            return { status: 'closed' };
+        }
+        this.state = 'settled';
+        const result = { status: 'closed' };
+        this.terminalResult = result;
+        await this.cleanup(false);
+        return result;
+    }
+    async apply(result) {
+        if (result.status === 'captcha') {
+            this.challenge = 'captcha';
+            return { status: 'captcha', image: result.image, retry: result.retry };
+        }
+        if (result.status === '2fa') {
+            this.challenge = 'two-factor';
+            return { status: 'two-factor', method: result.method };
+        }
+        this.challenge = undefined;
+        const snapshot = await this.waitForFlow(this.client.discover());
+        if (this.state !== 'active') {
+            return this.terminalResult ?? { status: 'closed' };
+        }
+        if (snapshot === FLOW_TIMEOUT) {
+            return this.expire();
+        }
+        this.stores.configuration.save(this.inputConfiguration);
+        this.stores.snapshot.save(snapshot);
+        this.state = 'settled';
+        const cleaned = await this.cleanup(true);
+        const terminalResult = { status: cleaned ? 'restart-required' : 'failed' };
+        this.terminalResult = terminalResult;
+        return terminalResult;
+    }
+    cleanup(commit) {
+        this.cleanupPromise ??= this.performCleanup(commit);
+        return this.cleanupPromise;
+    }
+    async fail() {
+        this.state = 'settled';
+        await this.cleanup(false);
+        this.terminalResult = { status: 'failed' };
+        return this.terminalResult;
+    }
+    async performCleanup(commit) {
+        clearTimeout(this.flowTimer);
+        this.cleanupDeadline ??= Date.now() + this.options.cleanupTimeoutMs;
+        let successful = true;
+        let safeToRelease = true;
+        if (this.preparation) {
+            safeToRelease = await this.bounded(this.preparation);
+            successful = safeToRelease;
+            if (!safeToRelease) {
+                void this.preparation.then(() => this.releaseAfterPreparation(), () => this.releaseAfterPreparation());
+            }
+        }
+        if (this.client) {
+            successful = await this.bounded(this.client.disconnect());
+            safeToRelease = successful && safeToRelease;
+        }
+        if (commit && successful) {
+            const commitOutcome = this.stores ? await this.boundedCommit(this.stores) : 'failure';
+            successful = commitOutcome === 'success';
+            if (commitOutcome === 'failure' && this.stores) {
+                safeToRelease = (await this.boundedStore(this.stores.discard())) !== 'timeout';
+            }
+            else if (commitOutcome === 'timeout') {
+                safeToRelease = false;
+            }
+        }
+        else {
+            const discardOutcome = this.stores ? await this.boundedStore(this.stores.discard()) : 'success';
+            successful = discardOutcome === 'success' && successful;
+            safeToRelease = discardOutcome !== 'timeout' && safeToRelease;
+        }
+        if (safeToRelease) {
+            for (const lease of [...this.leases].reverse()) {
+                successful = (await this.boundedRelease(lease)) && successful;
+            }
+        }
+        return successful;
+    }
+    /**
+     * Races one cleanup operation against the session's remaining window, answering `'timeout'` when it expires.
+     *
+     * `onTimeout` is how a caller withdraws the work it started, for an operation that accepts an abort signal;
+     * the timer is unreferenced so a waiting deadline never holds the process open on its own.
+     */
+    async withDeadline(operation, onTimeout) {
+        let timer;
+        const timeout = new Promise((resolve) => {
+            timer = setTimeout(() => {
+                onTimeout?.();
+                resolve('timeout');
+            }, this.remainingCleanupMs());
+            timer.unref();
+        });
+        try {
+            return await Promise.race([operation, timeout]);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async bounded(operation) {
+        return (await this.withDeadline(operation.then(() => true).catch(() => false))) === true;
+    }
+    async boundedRelease(lease) {
+        const result = await this.withDeadline(lease.release().catch(() => 'timeout'));
+        return result !== 'timeout' && result.state === 'stopped';
+    }
+    async boundedStore(operation) {
+        return this.withDeadline(operation.then(() => 'success').catch(() => 'failure'));
+    }
+    async boundedCommit(stores) {
+        const controller = new AbortController();
+        return this.withDeadline(stores
+            .commit(controller.signal)
+            .then(() => 'success')
+            .catch(() => 'failure'), () => controller.abort());
+    }
+    isSettled() {
+        return this.state === 'settled';
+    }
+    remainingCleanupMs() {
+        this.cleanupDeadline ??= Date.now() + this.options.cleanupTimeoutMs;
+        return Math.max(0, this.cleanupDeadline - Date.now());
+    }
+    async releaseAfterPreparation() {
+        this.cleanupDeadline = Date.now() + this.options.cleanupTimeoutMs;
+        for (const lease of [...this.leases].reverse()) {
+            await this.boundedRelease(lease);
+        }
+        this.leases.length = 0;
+    }
+    armFlowDeadline() {
+        this.flowDeadline = new Promise((resolve) => {
+            this.flowTimer = setTimeout(() => resolve(FLOW_TIMEOUT), this.options.flowTimeoutMs);
+            this.flowTimer.unref();
+        });
+    }
+    waitForFlow(operation) {
+        return Promise.race([operation, this.flowDeadline]);
+    }
+    async expire() {
+        this.state = 'settled';
+        await this.cleanup(false);
+        this.terminalResult = { status: 'timed-out' };
+        return this.terminalResult;
+    }
+}
+//# sourceMappingURL=temporary-authentication.js.map

package/dist/account/temporary-authentication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporary-authentication.js","sourceRoot":"","sources":["../../src/account/temporary-authentication.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,8BAA8B,GAG/B,MAAM,uBAAuB,CAAC;AAG/B,MAAM,YAAY,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;AAmC5C;;;;;GAKG;AACH,MAAM,UAAU,mCAAmC,CAAC,MAA+B;IACjF,OAAO;QACL,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;QAC3B,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC;QACrD,gBAAgB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC;QACzD,QAAQ,EAAE,GAAG,EAAE,CAAC,8BAA8B,CAAC,MAAM,CAAC;QACtD,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE;KACtC,CAAC;AACJ,CAAC;AAkED,2EAA2E;AAC3E,MAAM,OAAO,uBAAuB;IAef,SAAS;IACT,WAAW;IACX,aAAa;IACb,OAAO;IACP,eAAe;IACf,gBAAgB;IAnB3B,MAAM,CAAiC;IAC9B,MAAM,GAAqB,EAAE,CAAC;IACvC,MAAM,CAAmB;IACzB,cAAc,CAAoB;IAClC,WAAW,CAAsD;IACjE,SAAS,CAAkB;IAC3B,YAAY,CAAgC;IAC5C,eAAe,CAAU;IACzB,KAAK,GAA8C,KAAK,CAAC;IACzD,cAAc,CAAiC;IAC/C,mBAAmB,GAAG,KAAK,CAAC;IAC5B,kBAAkB,CAAc;IAExC,YACmB,SAA6B,EAC7B,WAAiC,EACjC,aAAmD,EACnD,OAAuC,EACvC,eAA0C,EAC1C,gBAA4C;yBAL5C,SAAS;2BACT,WAAW;6BACX,aAAa;uBACb,OAAO;+BACP,eAAe;gCACf,gBAAgB;IAChC,CAAC;IAEJ,KAAK,CAAC,KAAK,CAAC,KAAmC;QAC7C,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YACzB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAC9B,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC;QACxB,IAAI,CAAC,kBAAkB,GAAG,KAAK,CAAC,aAAa,CAAC;QAC9C,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACnG,IAAI,OAAO,KAAK,YAAY,EAAE,CAAC;gBAC7B,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;YACvB,CAAC;YACD,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB;oBACrC,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,CAAC;oBAClE,CAAC,CAAC,KAAK,CAAC;gBACV,IAAI,SAAS,KAAK,YAAY,EAAE,CAAC;oBAC/B,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;gBACvB,CAAC;gBACD,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;oBACvB,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,OAAO,EAAW,CAAC;oBACjE,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC;oBAC7B,OAAO,MAAM,CAAC;gBAChB,CAAC;YACH,CAAC;YACD,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;gBACrB,OAAO,IAAI,CAAC,cAAc,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YACrD,CAAC;YAED,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACvC,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACnE,IAAI,iBAAiB,KAAK,YAAY,EAAE,CAAC;gBACvC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;YACvB,CAAC;YACD,IAAI,iBAAiB,EAAE,CAAC;gBACtB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC1B,OAAO,iBAAiB,CAAC;YAC3B,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC9C,OAAO,IAAI,CAAC,cAAc,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YACrD,CAAC;YACD,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;YACtB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YAC3D,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC5B,OAAO,IAAI,CAAC,cAAc,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YACrD,CAAC;YACD,OAAO,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5E,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;gBACrB,OAAO,IAAI,CAAC,cAAc,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YACrD,CAAC;YACD,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,KAAmC;QACvD,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACnE,MAAM,QAAQ,GAAG,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC;QAC9C,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1B,MAAM,IAAI,SAAS,CAAC,uDAAuD,CAAC,CAAC;QAC/E,CAAC;QACD,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;QACxD,MAAM,mBAAmB,GAAG,aAAa,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;QACjE,IAAI,mBAAmB,EAAE,CAAC;YACxB,IAAI,mBAAmB,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,aAAc,CAAC,OAAO,EAAE,CAAC;gBAClF,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;YAC5E,CAAC;YACD,IAAI,CAAC,kBAAkB,GAAG;gBACxB,GAAG,mBAAmB;gBACtB,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC,QAAQ;gBACtC,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC,QAAQ;gBACtC,OAAO,EAAE,KAAK,CAAC,aAAa,CAAC,OAAO;gBACpC,iBAAiB,EAAE,KAAK,CAAC,aAAa,CAAC,iBAAiB;gBACxD,iBAAiB,EAAE;oBACjB,GAAG,KAAK,CAAC,aAAa,CAAC,iBAAiB;oBACxC,GAAG,mBAAmB,CAAC,iBAAiB;iBACzC;aACF,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,cAAc,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QACrD,CAAC;QACD,MAAM,aAAa,GACjB,aAAa,IAAI,aAAa,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACpG,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;YACzC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,EAAE,0BAA0B,CAAC,CAAC;YACzF,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;gBACrB,IAAI,SAAS,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;oBAChC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;gBACpC,CAAC;gBACD,OAAO,IAAI,CAAC,cAAc,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YACrD,CAAC;YACD,IAAI,SAAS,CAAC,KAAK,KAAK,gBAAgB,EAAE,CAAC;gBACzC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;gBACvB,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAW,CAAC;gBACtE,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC;gBAC7B,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACpD,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YACrB,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/C,OAAO,IAAI,CAAC,cAAc,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QACrD,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC;YAC/B,OAAO;YACP,QAAQ;YACR,OAAO,EAAE,IAAI,CAAC,kBAAmB,CAAC,OAAO;YACzC,iBAAiB,EAAE,IAAI,CAAC,kBAAmB,CAAC,iBAAiB;YAC7D,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YACjC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;SAC5B,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MAAc;QAChC,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAC9B,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,IAAY;QAChC,IAAI,IAAI,CAAC,SAAS,KAAK,YAAY,EAAE,CAAC;YACpC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAC9B,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IAClE,CAAC;IAEO,SAAS,CAA4B;IAErC,KAAK,CAAC,QAAQ,CAAC,SAAqC;QAC1D,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACxE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAC9B,CAAC;QACD,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC;YACnD,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC5B,OAAO,IAAI,CAAC,cAAc,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YACrD,CAAC;YACD,OAAO,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5E,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;gBACrB,OAAO,IAAI,CAAC,cAAc,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YACrD,CAAC;YACD,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;QACrB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,mBAAmB,GAAG,KAAK,CAAC;QACnC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,cAAc,CAAC;YAC1B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAC9B,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAW,CAAC;QAC7C,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC;QAC7B,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,MAAmB;QACrC,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;YAC3B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QACzE,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAC5B,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC;YAC9B,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QACzD,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjE,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC,cAAc,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QACrD,CAAC;QACD,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,MAAO,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAmB,CAAC,CAAC;QAC1D,IAAI,CAAC,MAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,cAAc,GAAkC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC1G,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,OAAO,cAAc,CAAC;IACxB,CAAC;IAEO,OAAO,CAAC,MAAe;QAC7B,IAAI,CAAC,cAAc,KAAK,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAEO,KAAK,CAAC,IAAI;QAChB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,cAAc,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,MAAe;QAC1C,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7B,IAAI,CAAC,eAAe,KAAK,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC;QACpE,IAAI,UAAU,GAAG,IAAI,CAAC;QACtB,IAAI,aAAa,GAAG,IAAI,CAAC;QACzB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,aAAa,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACrD,UAAU,GAAG,aAAa,CAAC;YAC3B,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,KAAK,IAAI,CAAC,WAAW,CAAC,IAAI,CACxB,GAAG,EAAE,CAAC,IAAI,CAAC,uBAAuB,EAAE,EACpC,GAAG,EAAE,CAAC,IAAI,CAAC,uBAAuB,EAAE,CACrC,CAAC;YACJ,CAAC;QACH,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;YAC1D,aAAa,GAAG,UAAU,IAAI,aAAa,CAAC;QAC9C,CAAC;QACD,IAAI,MAAM,IAAI,UAAU,EAAE,CAAC;YACzB,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACtF,UAAU,GAAG,aAAa,KAAK,SAAS,CAAC;YACzC,IAAI,aAAa,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAC/C,aAAa,GAAG,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC;YACjF,CAAC;iBAAM,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;gBACvC,aAAa,GAAG,KAAK,CAAC;YACxB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAChG,UAAU,GAAG,cAAc,KAAK,SAAS,IAAI,UAAU,CAAC;YACxD,aAAa,GAAG,cAAc,KAAK,SAAS,IAAI,aAAa,CAAC;QAChE,CAAC;QACD,IAAI,aAAa,EAAE,CAAC;YAClB,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC/C,UAAU,GAAG,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,IAAI,UAAU,CAAC;YAChE,CAAC;QACH,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,YAAY,CAAI,SAAqB,EAAE,SAAsB;QACzE,IAAI,KAAqB,CAAC;QAC1B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,EAAE;YACjD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACtB,SAAS,EAAE,EAAE,CAAC;gBACd,OAAO,CAAC,SAAS,CAAC,CAAC;YACrB,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC;YAC9B,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;QAClD,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAM,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,SAA2B;QAC/C,OAAO,CAAC,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC3F,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,KAAqB;QAChD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAkB,CAAC,CAAC,CAAC;QACxF,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC;IAC5D,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,SAA2B;QACpD,OAAO,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAkB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAkB,CAAC,CAAC,CAAC;IACrG,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,MAAuB;QACjD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC,YAAY,CACtB,MAAM;aACH,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;aACzB,IAAI,CAAC,GAAG,EAAE,CAAC,SAAkB,CAAC;aAC9B,KAAK,CAAC,GAAG,EAAE,CAAC,SAAkB,CAAC,EAClC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CACzB,CAAC;IACJ,CAAC;IAEO,SAAS;QACf,OAAO,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC;IAClC,CAAC;IAEO,kBAAkB;QACxB,IAAI,CAAC,eAAe,KAAK,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC;QACpE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACxD,CAAC;IAEO,KAAK,CAAC,uBAAuB;QACnC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC;QAClE,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YAC/C,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IACzB,CAAC;IAEO,eAAe;QACrB,IAAI,CAAC,YAAY,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC1C,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YACrF,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,WAAW,CAAI,SAAqB;QAC1C,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,IAAI,CAAC,YAAa,CAAC,CAAC,CAAC;IACvD,CAAC;IAEO,KAAK,CAAC,MAAM;QAClB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,cAAc,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;CACF"}

package/dist/configuration.js

@@ -0,0 +1,167 @@
+import bundledFfmpegPath from 'ffmpeg-for-homebridge';
+import { PLATFORM_NAME } from './settings.js';
+export const DEFAULT_COUNTRY = 'US';
+export const DEFAULT_TRUSTED_DEVICE_NAME = 'Homebridge Eufy';
+export const DEFAULT_POLLING_INTERVAL_MINUTES = 10;
+/** No declared ceiling on concurrent media, which is what the plugin has always behaved as. */
+export const DEFAULT_MAX_CONCURRENT_MEDIA_SESSIONS = 0;
+export const DEFAULT_WARM_UP_EVENTS = ['doorbellPress'];
+const ENTITY_PREFERENCE_KEYS = new Set(['represented', 'audio', 'snapshotMode']);
+const SNAPSHOT_MODES = new Set(['Cloud', 'Live', 'Refresh']);
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function optionalString(config, key) {
+    const value = config[key];
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value !== 'string') {
+        throw new TypeError(`${key} must be a string`);
+    }
+    return value;
+}
+function parseEntityPreferences(value) {
+    if (value === undefined) {
+        return {};
+    }
+    if (!isRecord(value)) {
+        throw new TypeError('entityPreferences must be an object keyed by SDK entity serial');
+    }
+    return Object.fromEntries(Object.entries(value).map(([serial, candidate]) => {
+        if (serial.length === 0 || !isRecord(candidate)) {
+            throw new TypeError(`entityPreferences.${serial || '<empty>'} must be an object`);
+        }
+        for (const key of Object.keys(candidate)) {
+            if (!ENTITY_PREFERENCE_KEYS.has(key)) {
+                throw new TypeError(`entityPreferences.${serial}.${key} is not a V5 entity preference`);
+            }
+        }
+        if (candidate.represented !== undefined && typeof candidate.represented !== 'boolean') {
+            throw new TypeError(`entityPreferences.${serial}.represented must be a boolean`);
+        }
+        if (candidate.audio !== undefined && typeof candidate.audio !== 'boolean') {
+            throw new TypeError(`entityPreferences.${serial}.audio must be a boolean`);
+        }
+        if (candidate.snapshotMode !== undefined && !SNAPSHOT_MODES.has(candidate.snapshotMode)) {
+            throw new TypeError(`entityPreferences.${serial}.snapshotMode must be Cloud, Live, or Refresh`);
+        }
+        return [serial, { ...candidate }];
+    }));
+}
+function parseDiscardedV4Settings(value) {
+    if (value === undefined) {
+        return [];
+    }
+    if (!Array.isArray(value) ||
+        value.some((entry) => typeof entry !== 'string' || !entry.match(/^[A-Za-z][A-Za-z0-9]{0,63}$/))) {
+        throw new TypeError('discardedV4Settings must contain bounded setting names');
+    }
+    return [...new Set(value)].sort();
+}
+/** Validates a Homebridge block and resolves the current defaults. */
+export function parseConfig(value) {
+    if (!isRecord(value)) {
+        throw new TypeError('configuration must be an object');
+    }
+    if (value.platform !== PLATFORM_NAME) {
+        throw new TypeError(`platform must be ${PLATFORM_NAME}`);
+    }
+    if (value.capabilities !== undefined) {
+        throw new TypeError('capabilities cannot be supplied by configuration');
+    }
+    const country = optionalString(value, 'country') ?? DEFAULT_COUNTRY;
+    if (!/^[a-z]{2}$/i.test(country)) {
+        throw new TypeError('country must be a two-letter country code');
+    }
+    const trustedDeviceName = optionalString(value, 'trustedDeviceName') ?? DEFAULT_TRUSTED_DEVICE_NAME;
+    if (trustedDeviceName.length === 0) {
+        throw new TypeError('trustedDeviceName must not be empty');
+    }
+    const pollingIntervalMinutes = value.pollingIntervalMinutes ?? DEFAULT_POLLING_INTERVAL_MINUTES;
+    if (!Number.isInteger(pollingIntervalMinutes) || pollingIntervalMinutes < 0) {
+        throw new TypeError('pollingIntervalMinutes must be a non-negative integer');
+    }
+    const maxConcurrentMediaSessions = value.maxConcurrentMediaSessions ?? DEFAULT_MAX_CONCURRENT_MEDIA_SESSIONS;
+    if (!Number.isInteger(maxConcurrentMediaSessions) || maxConcurrentMediaSessions < 0) {
+        throw new TypeError('maxConcurrentMediaSessions must be a non-negative integer');
+    }
+    const warmUpEvents = parseWarmUpEvents(value.warmUpEvents);
+    const configuredFfmpegPath = optionalString(value, 'ffmpegPath');
+    if (configuredFfmpegPath === '') {
+        throw new TypeError('ffmpegPath must not be empty');
+    }
+    return {
+        platform: PLATFORM_NAME,
+        username: optionalString(value, 'username'),
+        password: optionalString(value, 'password'),
+        country: country.toUpperCase(),
+        trustedDeviceName,
+        pollingIntervalMinutes: pollingIntervalMinutes,
+        maxConcurrentMediaSessions: maxConcurrentMediaSessions,
+        warmUpEvents,
+        ffmpegPath: configuredFfmpegPath ?? bundledFfmpegPath,
+        entityPreferences: parseEntityPreferences(value.entityPreferences),
+        discardedV4Settings: parseDiscardedV4Settings(value.discardedV4Settings),
+        discardedV4Acknowledged: value.discardedV4Acknowledged === true,
+    };
+}
+/**
+ * Whether a resolved FFmpeg path names the binary bundled with the plugin or one an administrator chose.
+ *
+ * The two are different builds with different encoder sets on the same host, so an adaptation failure cannot be
+ * attributed without knowing which one ran. It is decided by comparing the resolved value with the bundled
+ * one rather than by remembering which branch produced it, because a configuration this plugin serialized
+ * carries the resolved path back as an explicit setting and would otherwise report the bundled binary as a
+ * chosen one.
+ */
+export function ffmpegPathSource(path) {
+    return path === bundledFfmpegPath ? 'bundled' : 'configured';
+}
+/**
+ * The chosen warm-up events, refusing anything unrecognised rather than dropping it.
+ *
+ * Silently ignoring an unknown entry would leave a user who mistyped one believing a camera is warmed when it
+ * is not. Duplicates collapse and the declared order is restored, so the stored list is comparable however the
+ * interface happened to build it.
+ */
+function parseWarmUpEvents(value) {
+    if (value === undefined) {
+        return [...DEFAULT_WARM_UP_EVENTS];
+    }
+    if (!Array.isArray(value)) {
+        throw new TypeError('warmUpEvents must be an array');
+    }
+    for (const entry of value) {
+        if (typeof entry !== 'string' || entry.length === 0) {
+            throw new TypeError('warmUpEvents entries must be non-empty strings');
+        }
+    }
+    return [...new Set(value)].sort();
+}
+export function serializeConfig(config) {
+    return {
+        platform: PLATFORM_NAME,
+        username: config.username,
+        password: config.password,
+        country: config.country,
+        trustedDeviceName: config.trustedDeviceName,
+        pollingIntervalMinutes: config.pollingIntervalMinutes,
+        maxConcurrentMediaSessions: config.maxConcurrentMediaSessions,
+        warmUpEvents: [...config.warmUpEvents],
+        ffmpegPath: config.ffmpegPath,
+        entityPreferences: Object.fromEntries(Object.entries(config.entityPreferences).map(([serial, preference]) => [serial, { ...preference }])),
+        ...(config.discardedV4Settings.length > 0 ? { discardedV4Settings: [...config.discardedV4Settings] } : {}),
+        ...(config.discardedV4Acknowledged ? { discardedV4Acknowledged: true } : {}),
+    };
+}
+/** Applies preference defaults without adding a serial to persisted configuration. */
+export function resolveEntityPreference(config, serial) {
+    const preference = config.entityPreferences[serial];
+    return {
+        represented: preference?.represented ?? true,
+        audio: preference?.audio ?? true,
+        snapshotMode: preference?.snapshotMode ?? 'Refresh',
+    };
+}
+//# sourceMappingURL=configuration.js.map

package/dist/configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../src/configuration.ts"],"names":[],"mappings":"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"}

package/dist/device/member-evidence.js

@@ -0,0 +1,66 @@
+function addEvidence(evidence, member) {
+    const previous = evidence.get(member.id);
+    if (previous) {
+        if (previous.kind !== member.kind ||
+            previous.type !== member.type ||
+            previous.writable !== member.writable ||
+            previous.property !== member.property) {
+            throw new TypeError(`device manifest contains conflicting member evidence: ${member.id}`);
+        }
+        return;
+    }
+    evidence.set(member.id, member);
+}
+/** Indexes one described device without assigning HomeKit meaning to its members. */
+export function indexDeviceMemberEvidence(manifest) {
+    const evidence = new Map();
+    for (const detail of manifest.details) {
+        for (const read of detail.reads) {
+            const id = `${detail.capability}.${read.accessor}.read`;
+            addEvidence(evidence, { id, kind: 'read', type: read.type, writable: read.writable, property: read.property });
+        }
+        for (const action of detail.actions) {
+            let kind;
+            switch (action.form) {
+                case 'stateful':
+                    kind = 'persistent-operation';
+                    break;
+                case 'momentary':
+                    kind = 'momentary-action';
+                    break;
+                default:
+                    throw new TypeError(`device manifest contains an unsupported action form: ${String(action.form)}`);
+            }
+            const member = kind === 'persistent-operation' ? (action.reflects ?? action.name) : action.name;
+            const id = `${detail.capability}.${member}.${kind}`;
+            addEvidence(evidence, { id, kind });
+        }
+        for (const event of detail.events) {
+            const id = `${detail.capability}.${event}.event`;
+            addEvidence(evidence, { id, kind: 'event' });
+        }
+    }
+    return evidence;
+}
+/** Indexes product identity and semantic members once from one complete SDK manifest. */
+export function indexDeviceEvidence(manifest) {
+    return {
+        product: { ...(manifest.model === undefined ? {} : { model: manifest.model }) },
+        members: indexDeviceMemberEvidence(manifest),
+    };
+}
+/** Matches an exact SDK product model without consulting display or transport fields. */
+export function satisfiesProductRequirement(evidence, requirement) {
+    return requirement === undefined || evidence.model === requirement.model;
+}
+/** Matches every required member plus at least one alternative when alternatives are declared. */
+export function satisfiesMemberRequirements(evidence, requirements, alternatives = []) {
+    const matches = (requirement) => {
+        const installed = evidence.get(requirement.id);
+        return (installed?.kind === requirement.kind &&
+            (requirement.type === undefined || installed.type === requirement.type) &&
+            (requirement.writable === undefined || installed.writable === requirement.writable));
+    };
+    return requirements.every(matches) && (alternatives.length === 0 || alternatives.some(matches));
+}
+//# sourceMappingURL=member-evidence.js.map

package/dist/device/member-evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"member-evidence.js","sourceRoot":"","sources":["../../src/device/member-evidence.ts"],"names":[],"mappings":"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"}