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

package/dist/actions.js

@@ -0,0 +1,47 @@
+import { mapResponse, mapValue } from './mappers.js';
+import { interpolateLegacy } from './compatibility.js';
+import { ActionError } from './types.js';
+export class Actions {
+    transport;
+    constructor(transport) {
+        this.transport = transport;
+    }
+    async get(action, config, owner, state, seen = new Set(), onFailure) {
+        if (seen.has(action) || seen.size >= 32)
+            throw new ActionError('inconclusive');
+        seen.add(action);
+        let body;
+        try {
+            body = (await this.transport.request(action, config, owner)).body;
+        }
+        catch (error) {
+            if (error instanceof ActionError && !['aborted', 'deferred'].includes(error.category) && action.resultOnError != null) {
+                onFailure?.(error.category, error.retryAfter);
+                return action.resultOnError;
+            }
+            throw error;
+        }
+        const value = mapResponse(action.mappers, body, state, action.requireResponseMatch);
+        if (value === 'inconclusive') {
+            if (action.inconclusive)
+                return this.get(action.inconclusive, config, owner, state, seen, onFailure);
+            // published 1.3.0 returned this sentinel; callers validate it for the HAP format
+            return value;
+        }
+        return value;
+    }
+    async set(action, config, owner, state, value) {
+        const mapped = mapValue(action.mappers, value, state);
+        let url;
+        let body;
+        try {
+            url = interpolateLegacy(action.url, value, mapped, state);
+            body = action.body ? interpolateLegacy(action.body, value, mapped, state) : '';
+        }
+        catch {
+            throw new ActionError('mapper');
+        }
+        await this.transport.request({ ...action, url, body }, config, owner, true);
+    }
+}
+//# sourceMappingURL=actions.js.map

package/dist/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAwE,MAAM,YAAY,CAAC;AAG/G,MAAM,OAAO,OAAO;IACG;IAArB,YAAqB,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;IAAG,CAAC;IAC7C,KAAK,CAAC,GAAG,CAAC,MAAoB,EAAE,MAAoB,EAAE,KAAa,EAAE,KAAY,EAAE,OAAO,IAAI,GAAG,EAAgB,EAAE,SAAkE;QACnL,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE;YAAE,MAAM,IAAI,WAAW,CAAC,cAAc,CAAC,CAAC;QAC/E,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjB,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YAAC,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAAC,CAAC;QAC1E,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,KAAK,YAAY,WAAW,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,aAAa,IAAI,IAAI,EAAE,CAAC;gBACtH,SAAS,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC9C,OAAO,MAAM,CAAC,aAAa,CAAC;YAC9B,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACpF,IAAI,KAAK,KAAK,cAAc,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,YAAY;gBAAE,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;YACrG,iFAAiF;YACjF,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,MAAoB,EAAE,MAAoB,EAAE,KAAa,EAAE,KAAY,EAAE,KAAc;QAC/F,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QACtD,IAAI,GAAW,CAAC;QAAC,IAAI,IAAY,CAAC;QAClC,IAAI,CAAC;YACH,GAAG,GAAG,iBAAiB,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YAC1D,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,CAAC;QAAC,MAAM,CAAC;YAAC,MAAM,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;QAAC,CAAC;QAC5C,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAC9E,CAAC;CACF"}

package/dist/compatibility.d.ts

@@ -0,0 +1,3 @@
+import type { State } from './types.js';
+export declare function evaluateLegacy(expression: string, value: unknown, state: State): unknown;
+export declare function interpolateLegacy(template: string, value: unknown, mappedValue: unknown, state: State): string;

package/dist/compatibility.js

@@ -0,0 +1,26 @@
+import { createRequire } from 'node:module';
+// trusted legacy configuration is executable JavaScript, not a security sandbox
+const require = createRequire(new URL('../package.json', import.meta.url));
+export function evaluateLegacy(expression, value, state) {
+    const self = { exp: expression, state };
+    // direct eval deliberately retains value, self.state, this.state and CommonJS require
+    return function () {
+        void value;
+        void state;
+        void require;
+        return eval(self.exp);
+    }.call(self);
+}
+export function interpolateLegacy(template, value, mappedValue, state) {
+    // ordinary placeholders do not need JavaScript evaluation
+    let result = template;
+    if (template.includes('${') || template.includes('`') || template.includes('\\')) {
+        void state;
+        void value;
+        void require;
+        result = eval('`' + template + '`');
+    }
+    // string replacement preserves legacy replacement-token semantics as well
+    return result.replace(/{value}/gi, String(mappedValue));
+}
+//# sourceMappingURL=compatibility.js.map

package/dist/compatibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.js","sourceRoot":"","sources":["../src/compatibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,gFAAgF;AAChF,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3E,MAAM,UAAU,cAAc,CAAC,UAAkB,EAAE,KAAc,EAAE,KAAY;IAC7E,MAAM,IAAI,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IACxC,sFAAsF;IACtF,OAAO;QACL,KAAK,KAAK,CAAC;QAAC,KAAK,KAAK,CAAC;QAAC,KAAK,OAAO,CAAC;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,KAAc,EAAE,WAAoB,EAAE,KAAY;IACpG,0DAA0D;IAC1D,IAAI,MAAM,GAAG,QAAQ,CAAC;IACtB,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACjF,KAAK,KAAK,CAAC;QAAC,KAAK,KAAK,CAAC;QAAC,KAAK,OAAO,CAAC;QACrC,MAAM,GAAG,IAAI,CAAC,GAAG,GAAG,QAAQ,GAAG,GAAG,CAAW,CAAC;IAChD,CAAC;IACD,0EAA0E;IAC1E,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,2 @@
+import { type DeviceConfig } from './types.js';
+export declare function validateDevice(config: DeviceConfig): void;

package/dist/config.js

@@ -0,0 +1,81 @@
+import { ActionError } from './types.js';
+export function validateDevice(config) {
+    if (!config || typeof config.name !== 'string' || !config.name.trim() || typeof config.service !== 'string') {
+        throw new ActionError('config');
+    }
+    for (const value of [config.forceRefreshDelay, config.setterDelay, config.uriCallsDelay, config.writeConfirmationTimeout]) {
+        if (value !== undefined && (typeof value !== 'number' || !Number.isFinite(value) || value < 0))
+            throw new ActionError('config');
+    }
+    for (const value of Object.values(config.refresh ?? {})) {
+        if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0)
+            throw new ActionError('config');
+    }
+    if (config.optionCharacteristic && (!Array.isArray(config.optionCharacteristic) || config.optionCharacteristic.some(v => typeof v !== 'string'))) {
+        throw new ActionError('config');
+    }
+    if (config.urls && (typeof config.urls !== 'object' || Array.isArray(config.urls)))
+        throw new ActionError('config');
+    for (const action of Object.values(config.urls ?? {}))
+        validateAction(action, new Set());
+}
+function validateAction(action, seen) {
+    if (!action || seen.has(action) || seen.size >= 32 || typeof action.url !== 'string' || !/^https?:\/\//i.test(action.url)) {
+        throw new ActionError('config');
+    }
+    seen.add(action);
+    if (!/^[A-Za-z]+$/.test(action.httpMethod || 'GET'))
+        throw new ActionError('config');
+    if (action.body !== undefined && typeof action.body !== 'string')
+        throw new ActionError('config');
+    if (action.timeout !== undefined && (!Number.isFinite(action.timeout) || action.timeout <= 0))
+        throw new ActionError('config');
+    if (action.requireResponseMatch !== undefined && typeof action.requireResponseMatch !== 'boolean')
+        throw new ActionError('config');
+    if (action.responsePattern !== undefined) {
+        if (typeof action.responsePattern !== 'string')
+            throw new ActionError('config');
+        try {
+            new RegExp(action.responsePattern);
+        }
+        catch {
+            throw new ActionError('config');
+        }
+    }
+    if (action.mappers !== undefined && !Array.isArray(action.mappers))
+        throw new ActionError('config');
+    for (const mapper of action.mappers ?? []) {
+        if (!mapper || !mapper.parameters)
+            throw new ActionError('config');
+        switch (mapper.type) {
+            case 'regex':
+                try {
+                    new RegExp(mapper.parameters.regexp);
+                }
+                catch {
+                    throw new ActionError('config');
+                }
+                break;
+            case 'static':
+                if (!mapper.parameters.mapping || typeof mapper.parameters.mapping !== 'object')
+                    throw new ActionError('config');
+                break;
+            case 'eval':
+                if (typeof mapper.parameters.expression !== 'string')
+                    throw new ActionError('config');
+                break;
+            case 'xpath':
+                if (typeof mapper.parameters.xpath !== 'string')
+                    throw new ActionError('config');
+                break;
+            case 'jpath':
+                if (typeof mapper.parameters.jpath !== 'string')
+                    throw new ActionError('config');
+                break;
+            default: throw new ActionError('config');
+        }
+    }
+    if (action.inconclusive)
+        validateAction(action.inconclusive, seen);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/coordinator.d.ts

@@ -0,0 +1,51 @@
+import { type CoordinatorConfig } from './types.js';
+interface Job {
+    origin: string;
+    owner: string;
+    spacing: number;
+    priority: boolean;
+    run: (signal: AbortSignal) => Promise<unknown>;
+    resolve: (value: unknown) => void;
+    reject: (error: unknown) => void;
+    deadline?: number;
+    timer?: NodeJS.Timeout;
+}
+export declare class Coordinator {
+    limits: {
+        concurrency: number;
+        perOrigin: number;
+        maxQueue: number;
+    };
+    readonly queue: Job[];
+    readonly active: Set<AbortController>;
+    readonly origins: Map<string, number>;
+    readonly originStats: Map<string, {
+        started: number;
+        completed: number;
+        failed: number;
+        maxInFlight: number;
+    }>;
+    private readonly nextStart;
+    private readonly recovering;
+    private timer?;
+    private lastOrigin;
+    private stopped;
+    readonly stats: {
+        completed: number;
+        failed: number;
+        highWater: number;
+        maxInFlight: number;
+        durations: number[];
+        started: number;
+    };
+    constructor(config?: CoordinatorConfig);
+    configure(config: CoordinatorConfig): void;
+    get available(): boolean;
+    pauseOrigin(origin: string, until: number): void;
+    backgroundReady(origin: string, now?: number): boolean;
+    resumeOrigin(origin: string): void;
+    submit<T>(origin: string, owner: string, spacing: number, priority: boolean, run: (signal: AbortSignal) => Promise<T>, deadline?: number): Promise<T>;
+    private pump;
+    shutdown(): void;
+}
+export {};

package/dist/coordinator.js

@@ -0,0 +1,145 @@
+import { ActionError } from './types.js';
+export class Coordinator {
+    limits = { concurrency: 4, perOrigin: 2, maxQueue: 256 };
+    queue = [];
+    active = new Set();
+    origins = new Map();
+    originStats = new Map();
+    nextStart = new Map();
+    recovering = new Map();
+    timer;
+    lastOrigin = '';
+    stopped = false;
+    stats = { completed: 0, failed: 0, highWater: 0, maxInFlight: 0, durations: [], started: 0 };
+    constructor(config = {}) { this.configure(config); }
+    configure(config) {
+        for (const [key, value] of Object.entries(config)) {
+            if (!Object.hasOwn(this.limits, key) || !Number.isInteger(value) || value < 1)
+                throw new ActionError('config');
+        }
+        Object.assign(this.limits, config);
+    }
+    get available() { return !this.stopped && this.queue.length < this.limits.maxQueue; }
+    pauseOrigin(origin, until) {
+        this.recovering.set(origin, until);
+        // parked reads belong in the cache scheduler, not in slots needed by healthy endpoints
+        for (const job of this.queue.slice()) {
+            if (job.origin !== origin || job.priority)
+                continue;
+            this.queue.splice(this.queue.indexOf(job), 1);
+            clearTimeout(job.timer);
+            job.reject(new ActionError('deferred', Math.max(0, until - Date.now())));
+        }
+    }
+    backgroundReady(origin, now = Date.now()) {
+        const probeAt = this.recovering.get(origin);
+        return probeAt === undefined || (now >= probeAt && (this.origins.get(origin) ?? 0) === 0);
+    }
+    resumeOrigin(origin) {
+        this.recovering.delete(origin);
+    }
+    submit(origin, owner, spacing, priority, run, deadline) {
+        if (this.stopped)
+            return Promise.reject(new ActionError('aborted'));
+        if (!priority && !this.backgroundReady(origin))
+            return Promise.reject(new ActionError('deferred', Math.max(0, (this.recovering.get(origin) ?? 0) - Date.now())));
+        if (!this.available)
+            return Promise.reject(new ActionError('queue'));
+        return new Promise((resolve, reject) => {
+            const job = { origin, owner, spacing, priority, run, resolve: value => resolve(value), reject, deadline };
+            this.queue.push(job);
+            if (deadline !== undefined) {
+                const expire = () => {
+                    if (!this.queue.includes(job))
+                        return;
+                    const remaining = deadline - Date.now();
+                    if (remaining > 0) {
+                        job.timer = setTimeout(expire, Math.min(remaining, 2147483647));
+                        return;
+                    }
+                    this.queue.splice(this.queue.indexOf(job), 1);
+                    job.reject(new ActionError('timeout'));
+                    this.pump();
+                };
+                job.timer = setTimeout(expire, Math.max(0, Math.min(deadline - Date.now(), 2147483647)));
+            }
+            this.stats.highWater = Math.max(this.stats.highWater, this.queue.length);
+            this.pump();
+        });
+    }
+    pump() {
+        if (this.stopped)
+            return;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = undefined;
+        }
+        while (this.active.size < this.limits.concurrency) {
+            const now = Date.now();
+            // expired commands must never run later, even if admission beats their timer callback
+            for (const job of this.queue.slice()) {
+                if (job.deadline !== undefined && now >= job.deadline) {
+                    this.queue.splice(this.queue.indexOf(job), 1);
+                    clearTimeout(job.timer);
+                    job.reject(new ActionError('timeout'));
+                }
+            }
+            const eligible = this.queue.filter(job => {
+                const active = this.origins.get(job.origin) ?? 0;
+                // writes retain priority; a recovering origin gets only one background probe at a time
+                return active < this.limits.perOrigin && (this.nextStart.get(job.owner) ?? 0) <= now
+                    && (job.priority || this.backgroundReady(job.origin, now));
+            });
+            // prefer control writes, then rotate eligible origins to prevent a slow fleet starving others
+            const candidates = eligible.some(job => job.priority) ? eligible.filter(job => job.priority) : eligible;
+            const job = candidates.find(job => job.origin !== this.lastOrigin) ?? candidates[0];
+            if (!job)
+                break;
+            this.queue.splice(this.queue.indexOf(job), 1);
+            clearTimeout(job.timer);
+            this.lastOrigin = job.origin;
+            this.nextStart.set(job.owner, now + job.spacing);
+            this.origins.set(job.origin, (this.origins.get(job.origin) ?? 0) + 1);
+            const originStats = this.originStats.get(job.origin) ?? { started: 0, completed: 0, failed: 0, maxInFlight: 0 };
+            this.originStats.set(job.origin, originStats);
+            originStats.started++;
+            originStats.maxInFlight = Math.max(originStats.maxInFlight, this.origins.get(job.origin));
+            const controller = new AbortController();
+            this.active.add(controller);
+            this.stats.started++;
+            this.stats.maxInFlight = Math.max(this.stats.maxInFlight, this.active.size);
+            Promise.resolve().then(() => {
+                // admission can precede execution during event-loop load; pace from actual execution
+                this.nextStart.set(job.owner, Date.now() + job.spacing);
+                return job.run(controller.signal);
+            }).then(value => {
+                this.stats.completed++;
+                originStats.completed++;
+                job.resolve(value);
+            }, error => { this.stats.failed++; originStats.failed++; job.reject(error); }).finally(() => {
+                this.active.delete(controller);
+                this.origins.set(job.origin, (this.origins.get(job.origin) ?? 1) - 1);
+                this.stats.durations.push(Date.now() - now);
+                if (this.stats.durations.length > 2048)
+                    this.stats.durations.shift();
+                // allow response mapping and recovery feedback to settle before admitting the next job
+                setImmediate(() => this.pump());
+            });
+        }
+        if (this.queue.length && this.active.size < this.limits.concurrency) {
+            this.timer = setTimeout(() => this.pump(), 20);
+            this.timer.unref();
+        }
+    }
+    shutdown() {
+        this.stopped = true;
+        clearTimeout(this.timer);
+        for (const job of this.queue.splice(0)) {
+            clearTimeout(job.timer);
+            job.reject(new ActionError('aborted'));
+        }
+        for (const controller of this.active)
+            controller.abort();
+    }
+}
+//# sourceMappingURL=coordinator.js.map

package/dist/coordinator.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import type { API } from 'homebridge';
+export default function initialize(api: API): void;

package/dist/index.js

@@ -0,0 +1,8 @@
+import { LegacyAccessory } from './accessory.js';
+import { HTTPPlatform } from './platform.js';
+import { accessoryName, platformName, pluginName } from './metadata.js';
+export default function initialize(api) {
+    api.registerAccessory(pluginName, accessoryName, LegacyAccessory);
+    api.registerPlatform(pluginName, platformName, HTTPPlatform);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAExE,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,GAAQ;IACzC,GAAG,CAAC,iBAAiB,CAAC,UAAU,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;IAClE,GAAG,CAAC,gBAAgB,CAAC,UAAU,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;AAC/D,CAAC"}

package/dist/mappers.d.ts

@@ -0,0 +1,3 @@
+import { type MapperConfig, type State } from './types.js';
+export declare function mapValue(mappers: MapperConfig[] | undefined, input: unknown, state?: State): unknown;
+export declare function mapResponse(mappers: MapperConfig[] | undefined, input: unknown, state?: State, requireMatch?: boolean): unknown;

package/dist/mappers.js

@@ -0,0 +1,116 @@
+import { DOMParser } from '@xmldom/xmldom';
+import xpath from 'xpath';
+import { JSONPath } from 'jsonpath-plus';
+import { evaluateLegacy } from './compatibility.js';
+import { ActionError } from './types.js';
+export function mapValue(mappers = [], input, state = {}) {
+    return mapPipeline(mappers, input, state, false);
+}
+export function mapResponse(mappers = [], input, state = {}, requireMatch = false) {
+    return mapPipeline(mappers, input, state, true, requireMatch);
+}
+function mapPipeline(mappers, input, state, response, requireMatch = false) {
+    let unmatched = false;
+    let invalidDocument = false;
+    try {
+        const result = mappers.reduce((value, mapper) => {
+            const p = mapper.parameters;
+            switch (mapper.type) {
+                case 'static': {
+                    const mapping = mapper.parameters.mapping;
+                    // preserve 1.3.0 falsey mapping pass-through; changing it requires an opt-in
+                    if (Object.hasOwn(mapping, String(value))) {
+                        unmatched = false;
+                        invalidDocument = false;
+                        return mapping[String(value)] || value;
+                    }
+                    return value;
+                }
+                case 'regex': {
+                    const { regexp, capture } = mapper.parameters;
+                    const matches = new RegExp(regexp).exec(String(value));
+                    const index = String(capture || '1');
+                    if (matches && index in matches) {
+                        unmatched = false;
+                        invalidDocument = false;
+                        return matches[Number(index)];
+                    }
+                    unmatched = true;
+                    return value;
+                }
+                case 'xpath': {
+                    const { xpath: expression, index = 0 } = mapper.parameters;
+                    let document;
+                    try {
+                        document = new DOMParser({ onError: () => { throw new ActionError('mapper'); } })
+                            .parseFromString(String(value), 'text/xml');
+                    }
+                    catch (error) {
+                        if (!response)
+                            throw error;
+                        invalidDocument = true;
+                        unmatched = true;
+                        return value;
+                    }
+                    const result = xpath.select(expression, document);
+                    if (typeof result === 'string') {
+                        unmatched = false;
+                        invalidDocument = false;
+                        return result;
+                    }
+                    if (Array.isArray(result) && result.length > index) {
+                        unmatched = false;
+                        invalidDocument = false;
+                        return result[index].data;
+                    }
+                    unmatched = true;
+                    return value;
+                }
+                case 'jpath': {
+                    let json;
+                    try {
+                        json = JSON.parse(String(value));
+                    }
+                    catch {
+                        unmatched = true;
+                        return 'inconclusive';
+                    }
+                    if (typeof json !== 'object') {
+                        unmatched = true;
+                        return 'inconclusive';
+                    }
+                    const { jpath, index = 0 } = mapper.parameters;
+                    // safe filter evaluation retains JSONPath filters without native eval
+                    let result = JSONPath({ path: jpath, json: json, eval: 'safe' });
+                    if (Array.isArray(result) && result.length > index) {
+                        unmatched = false;
+                        invalidDocument = false;
+                        result = result[index];
+                    }
+                    else
+                        unmatched = true;
+                    return result instanceof Object ? JSON.stringify(result) : result;
+                }
+                case 'eval': {
+                    const result = evaluateLegacy(mapper.parameters.expression, value, state);
+                    // explicit user code may deliberately handle an earlier extraction miss
+                    unmatched = false;
+                    invalidDocument = false;
+                    return result;
+                }
+                default:
+                    void p;
+                    throw new ActionError('config');
+            }
+        }, input);
+        // preserve intermediate legacy values so a later mapper can explicitly handle a miss
+        return response && unmatched && (requireMatch || invalidDocument) ? 'inconclusive' : result;
+    }
+    catch (error) {
+        if (error instanceof ActionError)
+            throw error;
+        // remote content or expressions may contain credentials; never expose the original error
+        throw new ActionError('mapper');
+    }
+}
+//# sourceMappingURL=mappers.js.map

package/dist/mappers.js.map

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

package/dist/metadata.d.ts

@@ -0,0 +1,5 @@
+export declare const pluginVersion: string;
+export declare const pluginName = "homebridge-http-advanced-platform";
+export declare const platformUUIDNamespace = "homebridge-http-advanced-accessory";
+export declare const accessoryName = "HttpAdvancedAccessory";
+export declare const platformName = "HttpAdvanced";

package/dist/metadata.js

@@ -0,0 +1,8 @@
+import { createRequire } from 'node:module';
+export const pluginVersion = createRequire(import.meta.url)('../package.json').version;
+export const pluginName = 'homebridge-http-advanced-platform';
+// retain the Alpha.5 UUID namespace independently of the public package name
+export const platformUUIDNamespace = 'homebridge-http-advanced-accessory';
+export const accessoryName = 'HttpAdvancedAccessory';
+export const platformName = 'HttpAdvanced';
+//# sourceMappingURL=metadata.js.map

package/dist/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,aAAa,GAAW,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC;AAE/F,MAAM,CAAC,MAAM,UAAU,GAAG,mCAAmC,CAAC;AAC9D,6EAA6E;AAC7E,MAAM,CAAC,MAAM,qBAAqB,GAAG,oCAAoC,CAAC;AAC1E,MAAM,CAAC,MAAM,aAAa,GAAG,uBAAuB,CAAC;AACrD,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC"}

package/dist/platform.d.ts

@@ -0,0 +1,18 @@
+import type { API, DynamicPlatformPlugin, Logging, PlatformAccessory, PlatformConfig } from 'homebridge';
+import type { CoordinatorConfig, DeviceConfig } from './types.js';
+export { pluginName, platformName } from './metadata.js';
+export interface HTTPPlatformConfig extends PlatformConfig {
+    enabled?: boolean;
+    devices?: DeviceConfig[];
+    coordinator?: CoordinatorConfig;
+}
+export declare class HTTPPlatform implements DynamicPlatformPlugin {
+    readonly log: Logging;
+    readonly config: HTTPPlatformConfig;
+    readonly api: API;
+    private readonly cached;
+    constructor(log: Logging, config: HTTPPlatformConfig, api: API);
+    configureAccessory(accessory: PlatformAccessory): void;
+    private unavailable;
+    discover(): void;
+}