homebridge-http-advanced-platform 2.0.0-alpha.6

package/dist/settings.js

@@ -0,0 +1,51 @@
+import { readFileSync } from 'node:fs';
+import { ActionError } from './types.js';
+export class SettingsValidationError extends ActionError {
+    constructor(field, requirement) {
+        super('config');
+        this.message = `Shared settings: ${field} ${requirement}`;
+    }
+}
+export function validateSettings(value) {
+    const object = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
+    if (!object(value))
+        throw new SettingsValidationError('httpAdvanced', 'must be an object');
+    const number = (field, v, zero = false, integer = false) => {
+        if (v !== undefined && (typeof v !== 'number' || !Number.isFinite(v) || (zero ? v < 0 : v <= 0) || (integer && !Number.isInteger(v)))) {
+            throw new SettingsValidationError(field, `must be a ${integer ? 'whole ' : ''}number ${zero ? 'of zero or greater' : 'greater than zero'}`);
+        }
+    };
+    number('requestTimeout', value.requestTimeout);
+    for (const key of ['uriCallsDelay', 'setterDelay', 'writeConfirmationTimeout'])
+        number(key, value[key], true);
+    for (const section of ['refresh', 'coordinator', 'recovery']) {
+        if (value[section] !== undefined && !object(value[section]))
+            throw new SettingsValidationError(section, 'must be an object');
+    }
+    const settings = value;
+    for (const key of ['activeInterval', 'idleInterval', 'idleAfter'])
+        number(`refresh.${key}`, settings.refresh?.[key]);
+    for (const key of ['concurrency', 'perOrigin', 'maxQueue'])
+        number(`coordinator.${key}`, settings.coordinator?.[key], false, true);
+    if (Object.keys(settings.coordinator ?? {}).some(key => !['concurrency', 'perOrigin', 'maxQueue'].includes(key)))
+        throw new SettingsValidationError('coordinator', 'supports only concurrency, perOrigin and maxQueue');
+    for (const key of ['retryInterval', 'maxRetryInterval', 'reminderInterval'])
+        number(`recovery.${key}`, settings.recovery?.[key]);
+    number('recovery.quietPeriod', settings.recovery?.quietPeriod, true);
+    if ((settings.recovery?.maxRetryInterval ?? 30) < (settings.recovery?.retryInterval ?? 5))
+        throw new SettingsValidationError('recovery.maxRetryInterval', 'must be at least recovery.retryInterval (defaults: 30 and 5 seconds)');
+}
+export function readGlobalSettings(api, log) {
+    try {
+        // child bridges use the same config path; defaults do not require a platform instance
+        const settings = JSON.parse(readFileSync(api.user.configPath(), 'utf8')).httpAdvanced ?? {};
+        validateSettings(settings);
+        return settings;
+    }
+    catch (error) {
+        if (error instanceof ActionError)
+            log.warn('HTTP Advanced shared settings invalid; using built-in defaults');
+        return {};
+    }
+}
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,25 @@
+import { type ActionConfig, type DeviceConfig } from './types.js';
+import { Coordinator } from './coordinator.js';
+import type { GlobalSettings } from './settings.js';
+export interface HTTPResult {
+    body: string;
+    status: number;
+    location?: string;
+    retryAfter?: string;
+}
+export declare class Transport {
+    readonly coordinator: Coordinator;
+    readonly defaults: GlobalSettings;
+    private readonly httpAgent;
+    private readonly httpsAgent;
+    readonly stats: {
+        timeouts: number;
+        httpErrors: number;
+        aborted: number;
+        bytes: number;
+    };
+    constructor(coordinator: Coordinator, defaults?: GlobalSettings);
+    request(action: ActionConfig, config: DeviceConfig, owner: string, priority?: boolean, depth?: number, deadline?: number | undefined): Promise<HTTPResult>;
+    private follow;
+    shutdown(): void;
+}

package/dist/transport.js

@@ -0,0 +1,139 @@
+import http from 'node:http';
+import https from 'node:https';
+import { ActionError } from './types.js';
+export class Transport {
+    coordinator;
+    defaults;
+    httpAgent = new http.Agent({ keepAlive: true, maxSockets: 4, maxFreeSockets: 2 });
+    httpsAgent = new https.Agent({ keepAlive: true, maxSockets: 4, maxFreeSockets: 2 });
+    stats = { timeouts: 0, httpErrors: 0, aborted: 0, bytes: 0 };
+    constructor(coordinator, defaults = {}) {
+        this.coordinator = coordinator;
+        this.defaults = defaults;
+    }
+    async request(action, config, owner, priority = false, depth = 0, deadline = priority ? Date.now() + (action.timeout ?? this.defaults.requestTimeout ?? 10000) : undefined) {
+        if (depth > 10)
+            throw new ActionError('http');
+        let url;
+        try {
+            url = new URL(action.url);
+        }
+        catch {
+            return Promise.reject(new ActionError('config'));
+        }
+        if (!['http:', 'https:'].includes(url.protocol))
+            return Promise.reject(new ActionError('config'));
+        const result = await this.coordinator.submit(url.origin, owner, config.uriCallsDelay ?? this.defaults.uriCallsDelay ?? 0, priority, async (signal) => {
+            // background work gets its request budget when admitted, including subsequent redirects
+            deadline ??= Date.now() + (action.timeout ?? this.defaults.requestTimeout ?? 10000);
+            const remaining = deadline - Date.now();
+            if (remaining <= 0)
+                throw new ActionError('timeout');
+            const controller = new AbortController();
+            const abort = () => controller.abort(new ActionError('aborted'));
+            signal.addEventListener('abort', abort, { once: true });
+            if (signal.aborted)
+                abort();
+            const timer = setTimeout(() => controller.abort(new ActionError('timeout')), remaining);
+            const headers = { ...action.headers };
+            // 1.3.0 always sent supplied credentials immediately, even with immediately:false
+            if ((config.username || config.password) && !Object.keys(headers).some(k => k.toLowerCase() === 'authorization')) {
+                headers.Authorization = `Basic ${Buffer.from(`${config.username || ''}:${config.password || ''}`).toString('base64')}`;
+            }
+            try {
+                const result = await this.follow(url, action.httpMethod || 'GET', action.body || '', headers, controller.signal);
+                return result;
+            }
+            catch (error) {
+                if (controller.signal.aborted) {
+                    const reason = controller.signal.reason;
+                    if (reason.category !== 'timeout')
+                        this.stats.aborted++;
+                    throw reason;
+                }
+                throw error instanceof ActionError ? error : new ActionError('network');
+            }
+            finally {
+                clearTimeout(timer);
+                signal.removeEventListener('abort', abort);
+            }
+        }, deadline).catch(error => {
+            if (error instanceof ActionError && error.category === 'timeout')
+                this.stats.timeouts++;
+            throw error;
+        });
+        const method = (action.httpMethod || 'GET').toUpperCase();
+        if ([301, 302, 303, 307, 308].includes(result.status) && result.location && ['GET', 'HEAD'].includes(method)) {
+            let next;
+            try {
+                next = new URL(result.location, url);
+            }
+            catch {
+                throw new ActionError('http');
+            }
+            const headers = { ...action.headers };
+            let nextConfig = config;
+            if (next.origin !== url.origin) {
+                for (const key of Object.keys(headers))
+                    if (['authorization', 'cookie', 'host'].includes(key.toLowerCase()))
+                        delete headers[key];
+                nextConfig = { ...config, username: '', password: '' };
+            }
+            return this.request({ ...action, url: next.href, headers }, nextConfig, owner, priority, depth + 1, deadline);
+        }
+        if (result.status < 200 || result.status >= 300) {
+            this.stats.httpErrors++;
+            // an explicit retry signal is an outage, never a device value or a successful write
+            if ([429, 503].includes(result.status) && result.retryAfter !== undefined) {
+                const seconds = Number(result.retryAfter);
+                const delay = result.retryAfter.trim() && Number.isFinite(seconds) ? seconds * 1000 : Date.parse(result.retryAfter) - Date.now();
+                throw new ActionError('unavailable', Number.isFinite(delay) ? Math.max(0, Math.min(300000, delay)) : undefined);
+            }
+            if (action.strictHTTP)
+                throw new ActionError([408, 429, 500, 502, 503, 504].includes(result.status) ? 'unavailable' : 'http');
+        }
+        if (action.responsePattern !== undefined) {
+            let pattern;
+            try {
+                pattern = new RegExp(action.responsePattern);
+            }
+            catch {
+                throw new ActionError('config');
+            }
+            // fixed legacy protocols can identify valid replies without changing their server
+            if (!pattern.test(result.body))
+                throw new ActionError('inconclusive');
+        }
+        return result;
+    }
+    async follow(url, method, body, headers, signal) {
+        const result = await new Promise((resolve, reject) => {
+            const client = url.protocol === 'https:' ? https : http;
+            const requestHeaders = { ...headers };
+            if (body && !Object.keys(headers).some(k => k.toLowerCase() === 'content-length'))
+                requestHeaders['Content-Length'] = String(Buffer.byteLength(body));
+            const request = client.request(url, { method, headers: requestHeaders, signal, agent: url.protocol === 'https:' ? this.httpsAgent : this.httpAgent }, response => {
+                const chunks = [];
+                let size = 0;
+                response.on('data', (chunk) => {
+                    size += chunk.length;
+                    if (size > 8 * 1024 * 1024) {
+                        request.destroy(new ActionError('http'));
+                        return;
+                    }
+                    chunks.push(chunk);
+                });
+                response.on('error', reject);
+                response.on('end', () => {
+                    this.stats.bytes += size;
+                    resolve({ body: Buffer.concat(chunks).toString('utf8'), status: response.statusCode ?? 0, location: response.headers.location, retryAfter: response.headers['retry-after'] });
+                });
+            });
+            request.on('error', reject);
+            request.end(body);
+        });
+        return result;
+    }
+    shutdown() { this.coordinator.shutdown(); this.httpAgent.destroy(); this.httpsAgent.destroy(); }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAwC,MAAM,YAAY,CAAC;AAK/E,MAAM,OAAO,SAAS;IAIC;IAAmC;IAHvC,SAAS,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC,CAAC;IAClF,UAAU,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC,CAAC;IAC5F,KAAK,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACtE,YAAqB,WAAwB,EAAW,WAA2B,EAAE;QAAhE,gBAAW,GAAX,WAAW,CAAa;QAAW,aAAQ,GAAR,QAAQ,CAAqB;IAAG,CAAC;IAEzF,KAAK,CAAC,OAAO,CAAC,MAAoB,EAAE,MAAoB,EAAE,KAAa,EAAE,QAAQ,GAAG,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,WAA+B,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;QAChO,IAAI,KAAK,GAAG,EAAE;YAAE,MAAM,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,GAAQ,CAAC;QACb,IAAI,CAAC;YAAC,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAC,CAAC;QAC9F,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;QAClG,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,aAAa,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAC,MAAM,EAAC,EAAE;YACjJ,wFAAwF;YACxF,QAAQ,KAAK,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,IAAI,KAAK,CAAC,CAAC;YACpF,MAAM,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACxC,IAAI,SAAS,IAAI,CAAC;gBAAE,MAAM,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC;YACrD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC;YACjE,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,IAAI,MAAM,CAAC,OAAO;gBAAE,KAAK,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;YACxF,MAAM,OAAO,GAAG,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YACtC,kFAAkF;YAClF,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,eAAe,CAAC,EAAE,CAAC;gBACjH,OAAO,CAAC,aAAa,GAAG,SAAS,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,IAAI,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzH,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,IAAI,KAAK,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;gBACjH,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,MAAqB,CAAC;oBACvD,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;wBAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;oBACxD,MAAM,MAAM,CAAC;gBACf,CAAC;gBACD,MAAM,KAAK,YAAY,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC;YAC1E,CAAC;oBAAS,CAAC;gBACT,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;YACzB,IAAI,KAAK,YAAY,WAAW,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;gBAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACxF,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,UAAU,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1D,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7G,IAAI,IAAS,CAAC;YACd,IAAI,CAAC;gBAAC,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,MAAM,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;YAAC,CAAC;YACtF,MAAM,OAAO,GAAG,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YACtC,IAAI,UAAU,GAAG,MAAM,CAAC;YACxB,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC;gBAC/B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;oBAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;wBAAE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;gBACjI,UAAU,GAAG,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;YACzD,CAAC;YACD,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;QAChH,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;YAChD,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;YACxB,oFAAoF;YACpF,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC1E,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACjI,MAAM,IAAI,WAAW,CAAC,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YAClH,CAAC;YACD,IAAI,MAAM,CAAC,UAAU;gBAAE,MAAM,IAAI,WAAW,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAChI,CAAC;QACD,IAAI,MAAM,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YACzC,IAAI,OAAe,CAAC;YACpB,IAAI,CAAC;gBAAC,OAAO,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,MAAM,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;YAAC,CAAC;YAChG,kFAAkF;YAClF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBAAE,MAAM,IAAI,WAAW,CAAC,cAAc,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,GAAQ,EAAE,MAAc,EAAE,IAAY,EAAE,OAA+B,EAAE,MAAmB;QAC/G,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAqC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACvF,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;YACxD,MAAM,cAAc,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;YACtC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,gBAAgB,CAAC;gBAAE,cAAc,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;YACtJ,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,QAAQ,CAAC,EAAE;gBAC/J,MAAM,MAAM,GAAa,EAAE,CAAC;gBAC5B,IAAI,IAAI,GAAG,CAAC,CAAC;gBACb,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;oBACpC,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC;oBACrB,IAAI,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;wBAAC,OAAO,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;wBAAC,OAAO;oBAAC,CAAC;oBACjF,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACrB,CAAC,CAAC,CAAC;gBACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC7B,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;oBACtB,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC;oBACzB,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,UAAU,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;gBAChL,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,QAAQ,KAAW,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;CACvG"}

package/dist/types.d.ts

@@ -0,0 +1,106 @@
+import type { CharacteristicProps, CharacteristicValue } from 'homebridge';
+export type Value = string | number | boolean;
+export type State = Record<string, unknown>;
+export type MapperConfig = {
+    type: 'static';
+    parameters: {
+        mapping: Record<string, unknown>;
+    };
+} | {
+    type: 'regex';
+    parameters: {
+        regexp: string;
+        capture?: number | string;
+    };
+} | {
+    type: 'xpath';
+    parameters: {
+        xpath: string;
+        index?: number;
+    };
+} | {
+    type: 'jpath';
+    parameters: {
+        jpath: string;
+        index?: number;
+    };
+} | {
+    type: 'eval';
+    parameters: {
+        expression: string;
+    };
+};
+export interface ActionConfig {
+    url: string;
+    httpMethod?: string;
+    body?: string;
+    headers?: Record<string, string>;
+    mappers?: MapperConfig[];
+    resultOnError?: Value;
+    inconclusive?: ActionConfig;
+    timeout?: number;
+    strictHTTP?: boolean;
+    responsePattern?: string;
+    requireResponseMatch?: boolean;
+}
+export interface RefreshConfig {
+    activeInterval?: number;
+    idleInterval?: number;
+    idleAfter?: number;
+}
+export interface DeviceConfig {
+    accessory?: string;
+    id?: string;
+    name: string;
+    service: string;
+    manufacturer?: string;
+    model?: string;
+    username?: string;
+    password?: string;
+    immediately?: boolean;
+    debug?: boolean;
+    optionCharacteristic?: string[];
+    props?: Record<string, Partial<CharacteristicProps>>;
+    forceRefreshDelay?: number;
+    setterDelay?: number;
+    writeConfirmationTimeout?: number;
+    uriCallsDelay?: number;
+    refresh?: RefreshConfig;
+    urls?: Record<string, ActionConfig>;
+}
+export interface CoordinatorConfig {
+    concurrency?: number;
+    perOrigin?: number;
+    maxQueue?: number;
+}
+export type ErrorCategory = 'config' | 'network' | 'timeout' | 'aborted' | 'deferred' | 'http' | 'unavailable' | 'mapper' | 'inconclusive' | 'queue';
+export declare class ActionError extends Error {
+    readonly category: ErrorCategory;
+    readonly retryAfter?: number | undefined;
+    constructor(category: ErrorCategory, retryAfter?: number | undefined);
+}
+export interface CacheEntry {
+    key: string;
+    actionName: string;
+    config: DeviceConfig;
+    state: State;
+    value?: CharacteristicValue;
+    stateValue?: unknown;
+    known: boolean;
+    lastSuccess: number;
+    lastAttempt: number;
+    lastChange: number;
+    lastDemand: number;
+    inFlight: boolean;
+    failures: number;
+    lastError?: ErrorCategory;
+    nextEligible: number;
+    generation: number;
+    pendingWrite?: PendingWrite;
+    convert: (value: unknown) => CharacteristicValue;
+    update: (value: CharacteristicValue | Error) => void;
+}
+export interface PendingWrite {
+    value: CharacteristicValue;
+    expires?: number;
+}

package/dist/types.js

@@ -0,0 +1,10 @@
+export class ActionError extends Error {
+    category;
+    retryAfter;
+    constructor(category, retryAfter) {
+        super(`HTTP Advanced ${category} failure`);
+        this.category = category;
+        this.retryAfter = retryAfter;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAsDA,MAAM,OAAO,WAAY,SAAQ,KAAK;IACR;IAAyC;IAArE,YAA4B,QAAuB,EAAkB,UAAmB;QACtF,KAAK,CAAC,iBAAiB,QAAQ,UAAU,CAAC,CAAC;QADjB,aAAQ,GAAR,QAAQ,CAAe;QAAkB,eAAU,GAAV,UAAU,CAAS;IAExF,CAAC;CACF"}

package/dist/ui-config.d.ts

@@ -0,0 +1,27 @@
+import { type GlobalSettings } from './settings.js';
+type Block = Record<string, unknown>;
+export interface PluginSettings {
+    accessories: Block[];
+    platforms: Block[];
+    settings: GlobalSettings;
+}
+export declare class SettingsError extends Error {
+}
+export declare function selectSettings(config: unknown): PluginSettings;
+export declare function validatePluginSettings(value: unknown): asserts value is PluginSettings;
+export declare function mergeSettings(config: unknown, draft: PluginSettings): Block;
+export declare class ConfigEditor {
+    private readonly configPath;
+    constructor(configPath: string);
+    private read;
+    load(): {
+        draft: PluginSettings;
+        revision: string;
+    };
+    save(input: unknown): {
+        draft: PluginSettings;
+        revision: string;
+        changed: boolean;
+    };
+}
+export {};

package/dist/ui-config.js

@@ -0,0 +1,208 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { closeSync, fchmodSync, fchownSync, fstatSync, fsyncSync, openSync, readFileSync, realpathSync, renameSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
+import { isDeepStrictEqual } from 'node:util';
+import { validateDevice } from './config.js';
+import { validateSettings, SettingsValidationError } from './settings.js';
+import { pluginName, accessoryName, platformName } from './metadata.js';
+const isObject = (value) => !!value && typeof value === 'object' && !Array.isArray(value);
+const owns = (block, type) => {
+    const alias = type === 'accessory' ? accessoryName : platformName;
+    return isObject(block) && (block[type] === alias || block[type] === `${pluginName}.${alias}`);
+};
+export class SettingsError extends Error {
+}
+function configObject(value) {
+    if (!isObject(value) || ['accessories', 'platforms'].some(key => value[key] !== undefined && !Array.isArray(value[key]))) {
+        throw new SettingsError('Homebridge configuration is invalid; no changes saved');
+    }
+}
+export function selectSettings(config) {
+    configObject(config);
+    const settings = config.httpAdvanced ?? {};
+    validateSettings(settings);
+    return { accessories: (config.accessories ?? []).filter(b => owns(b, 'accessory')),
+        platforms: (config.platforms ?? []).filter(b => owns(b, 'platform')), settings };
+}
+export function validatePluginSettings(value) {
+    if (!isObject(value) || !Array.isArray(value.accessories) || !Array.isArray(value.platforms))
+        throw new SettingsError('Accessory and platform configuration must be arrays');
+    let location = 'Shared settings';
+    try {
+        validateSettings(value.settings);
+        const legacyNames = new Set();
+        for (const [index, block] of value.accessories.entries()) {
+            location = `Legacy accessory ${index + 1} in JSON Config`;
+            if (!owns(block, 'accessory'))
+                throw new Error();
+            validateDevice(block);
+            if (legacyNames.has(block.name))
+                throw new Error();
+            legacyNames.add(block.name);
+        }
+        const platformNames = new Set();
+        for (const [index, block] of value.platforms.entries()) {
+            location = `Platform ${index + 1}`;
+            if (!owns(block, 'platform') || typeof block.name !== 'string' || !block.name.trim() || !Array.isArray(block.devices)
+                || (block.enabled !== undefined && typeof block.enabled !== 'boolean'))
+                throw new Error();
+            if (platformNames.has(block.name))
+                throw new Error();
+            platformNames.add(block.name);
+            if (block.coordinator !== undefined)
+                validateSettings({ coordinator: block.coordinator });
+            const ids = new Set();
+            for (const [deviceIndex, device] of block.devices.entries()) {
+                location = `Platform ${index + 1}, device ${deviceIndex + 1}`;
+                validateDevice(device);
+                const id = device.id ?? device.name;
+                if (typeof id !== 'string' || !id.trim() || ids.has(id))
+                    throw new Error();
+                ids.add(id);
+            }
+        }
+    }
+    catch (error) {
+        const detail = error instanceof SettingsValidationError ? error.message.replace(/^Shared settings: /, '') : 'check names, aliases, device actions and timing values';
+        throw new SettingsError(`${location}: ${detail}; no changes saved`);
+    }
+}
+function replaceBlocks(current, type, replacements) {
+    let index = 0;
+    const result = current.flatMap(block => !owns(block, type) ? [block] : index < replacements.length ? [replacements[index++]] : []);
+    return result.concat(replacements.slice(index));
+}
+export function mergeSettings(config, draft) {
+    configObject(config);
+    validatePluginSettings(draft);
+    const result = { ...config };
+    if (config.accessories !== undefined || draft.accessories.length)
+        result.accessories = replaceBlocks((config.accessories ?? []), 'accessory', draft.accessories);
+    if (config.platforms !== undefined || draft.platforms.length)
+        result.platforms = replaceBlocks((config.platforms ?? []), 'platform', draft.platforms);
+    if (config.httpAdvanced !== undefined || Object.keys(draft.settings).length)
+        result.httpAdvanced = draft.settings;
+    return result;
+}
+const revision = (value) => createHash('sha256').update(JSON.stringify(value)).digest('hex');
+function acquireLock(path) {
+    for (let attempt = 0; attempt < 2; attempt++) {
+        try {
+            const descriptor = openSync(path, 'wx', 0o600);
+            try {
+                writeFileSync(descriptor, JSON.stringify({ pid: process.pid }));
+            }
+            catch (error) {
+                closeSync(descriptor);
+                unlinkSync(path);
+                throw error;
+            }
+            return descriptor;
+        }
+        catch {
+            // reclaim only a lock whose recorded process no longer exists
+            try {
+                const before = statSync(path);
+                const { pid } = JSON.parse(readFileSync(path, 'utf8'));
+                if (!Number.isSafeInteger(pid) || pid <= 0)
+                    break;
+                try {
+                    process.kill(pid, 0);
+                    break;
+                }
+                catch (error) {
+                    if (error.code !== 'ESRCH')
+                        break;
+                }
+                if (statSync(path).ino !== before.ino)
+                    break;
+                unlinkSync(path);
+            }
+            catch {
+                break;
+            }
+        }
+    }
+    throw new SettingsError('Another settings save is in progress or its lock could not be acquired; try again after it completes');
+}
+export class ConfigEditor {
+    configPath;
+    constructor(configPath) {
+        this.configPath = configPath;
+    }
+    read() {
+        try {
+            const path = realpathSync(this.configPath);
+            const raw = readFileSync(path, 'utf8');
+            const config = JSON.parse(raw);
+            configObject(config);
+            return { path, raw, config, draft: selectSettings(config) };
+        }
+        catch (error) {
+            if (error instanceof SettingsValidationError)
+                throw new SettingsError(`${error.message}; correct httpAdvanced in Homebridge's full configuration editor, then reopen Plugin Config`);
+            throw new SettingsError('Could not read Homebridge configuration; no changes saved');
+        }
+    }
+    load() {
+        const { draft } = this.read();
+        return { draft, revision: revision(draft) };
+    }
+    save(input) {
+        if (!isObject(input) || typeof input.revision !== 'string')
+            throw new SettingsError('Reload settings before saving');
+        validatePluginSettings(input.draft);
+        const initial = this.read();
+        const lockPath = initial.path + '.http-advanced.lock';
+        const lock = acquireLock(lockPath);
+        const temporary = initial.path + `.http-advanced-${randomUUID()}.tmp`;
+        try {
+            const current = this.read();
+            if (current.path !== initial.path || revision(current.draft) !== input.revision)
+                throw new SettingsError('HTTP Advanced settings changed in another editor; reload before saving');
+            const merged = mergeSettings(current.config, input.draft);
+            if (isDeepStrictEqual(merged, current.config))
+                return { ...this.load(), changed: false };
+            const descriptor = openSync(temporary, 'wx', 0o600);
+            try {
+                writeFileSync(descriptor, JSON.stringify(merged, null, 4) + '\n');
+                // preserve ownership as well as mode, including when the UI runs as root
+                const original = statSync(current.path), replacement = fstatSync(descriptor);
+                if (replacement.uid !== original.uid || replacement.gid !== original.gid)
+                    fchownSync(descriptor, original.uid, original.gid);
+                fchmodSync(descriptor, original.mode & 0o777);
+                fsyncSync(descriptor);
+            }
+            finally {
+                closeSync(descriptor);
+            }
+            // preserve an exact private backup; recheck for writes from other Homebridge editors
+            const backup = current.path + `.http-advanced-backup-${Date.now()}-${randomUUID()}`;
+            const backupDescriptor = openSync(backup, 'wx', 0o600);
+            try {
+                writeFileSync(backupDescriptor, current.raw);
+                fsyncSync(backupDescriptor);
+            }
+            finally {
+                closeSync(backupDescriptor);
+            }
+            if (readFileSync(current.path, 'utf8') !== current.raw)
+                throw new SettingsError('Homebridge configuration changed during save; reload before saving');
+            renameSync(temporary, current.path);
+            return { ...this.load(), changed: true };
+        }
+        catch (error) {
+            if (error instanceof SettingsError)
+                throw error;
+            throw new SettingsError('Could not save Homebridge configuration; check file permissions');
+        }
+        finally {
+            try {
+                unlinkSync(temporary);
+            }
+            catch { /* no temporary file after a successful rename */ }
+            closeSync(lock);
+            unlinkSync(lockPath);
+        }
+    }
+}
+//# sourceMappingURL=ui-config.js.map

package/dist/ui-config.js.map

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

package/docs/alpha-release-notes.md

@@ -0,0 +1,19 @@
+# Homebridge HTTP Advanced Platform 2.0.0-alpha.6
+
+Opt-in Alpha based on preserved `2.0.0-alpha.5`. Confirm availability in the
+matching [GitHub prerelease](https://github.com/shanemcw/homebridge-http-advanced-platform/releases)
+and [npm version list](https://www.npmjs.com/package/homebridge-http-advanced-platform?activeTab=versions).
+
+This is a platform conversion of [staromeste/homebridge-http-advanced-accessory](https://github.com/staromeste/homebridge-http-advanced-accessory). It retains the original Apache-2.0 license, contributor credit and Git history.
+
+The release changes the public package to `homebridge-http-advanced-platform`, updates branding and search metadata, and retains Alpha.5 device behavior: shared cached reads, bounded background HTTP requests, recovery, write confirmation, legacy accessories and optional platform devices. No parent issue/PR fixes or dependency updates are included in this packaging milestone.
+
+Configuration aliases remain `HttpAdvancedAccessory` and `HttpAdvanced`. The platform UUID namespace remains the Alpha.5 namespace. Package-qualified configuration and plugin lists must use the new package name; do not load both old and new packages. Follow the [replacement and rollback guide](migration.md), preserving configuration, storage and bridge identity.
+
+Moving a legacy accessory into a platform remains an explicit manual conversion with a new HomeKit identity. No automatic conversion tool is included.
+
+Requirements remain Node `^22.13.0 || ^24.0.0` and Homebridge `^1.11.4 || ^2.4.0`. Source checks and installed loader/adapters/custom UI IPC passed across Node 22/24 and Homebridge 1/2. Rendered Homebridge UI 5.29.0, native editing, managed child bridges and backed-up replacement/rollback passed in an isolated Node 24/Homebridge 2 fixture. HAP was disabled in that fixture; paired Apple Home, physical controls, rooms/scenes/automations and live soak remain separate acceptance.
+
+The publication channel is the explicit `alpha` npm tag with a matching GitHub prerelease; this package has no stable release or `latest` tag. Once published, select **alpha / v2.0.0-alpha.6** in Homebridge UI 5.29.0's install version chooser, or install `homebridge-http-advanced-platform@alpha` (exact version: `@2.0.0-alpha.6`). The Alpha-only chooser and metadata matching were rehearsed using isolated registry responses and actual UI logic; public indexing and registry installation still require launch checks. Its tags do not modify the original accessory package's tags. Homebridge verification will be pursued separately after publication; this Alpha is not verified.
+
+Report versions and sanitized diagnostics. Do not include credentials, pairing PINs or unredacted configuration.