@trillboards/edge-sdk 0.2.4 → 0.2.6

package/dist/OnvifClient.js

@@ -0,0 +1,209 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OnvifClient = exports.OnvifError = void 0;
+exports.buildUsernameToken = buildUsernameToken;
+exports.escapeXml = escapeXml;
+exports.decodeXmlEntities = decodeXmlEntities;
+exports.xmlTag = xmlTag;
+exports.xmlTags = xmlTags;
+const crypto_1 = require("crypto");
+const AudienceAnalyzeClient_1 = require("./AudienceAnalyzeClient");
+class OnvifError extends Error {
+    constructor(kind, message) {
+        super(message);
+        this.kind = kind;
+    }
+}
+exports.OnvifError = OnvifError;
+/** Build the WS-Security UsernameToken header (PasswordDigest per ONVIF core). */
+function buildUsernameToken(username, password, nonceRaw = (0, crypto_1.randomBytes)(16), created = new Date().toISOString()) {
+    const digest = (0, crypto_1.createHash)('sha1')
+        .update(Buffer.concat([nonceRaw, Buffer.from(created, 'utf8'), Buffer.from(password, 'utf8')]))
+        .digest('base64');
+    const nonceB64 = nonceRaw.toString('base64');
+    return ('<s:Header><wsse:Security s:mustUnderstand="1" ' +
+        'xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" ' +
+        'xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">' +
+        `<wsse:UsernameToken><wsse:Username>${escapeXml(username)}</wsse:Username>` +
+        '<wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordDigest">' +
+        `${digest}</wsse:Password>` +
+        `<wsse:Nonce EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary">${nonceB64}</wsse:Nonce>` +
+        `<wsu:Created>${created}</wsu:Created></wsse:UsernameToken></wsse:Security></s:Header>`);
+}
+function escapeXml(s) {
+    return String(s)
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+function envelope(header, body) {
+    return ('<?xml version="1.0" encoding="UTF-8"?>' +
+        '<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope">' +
+        header +
+        `<s:Body>${body}</s:Body></s:Envelope>`);
+}
+/** Decode the XML entities recorders emit inside tag text (Dahua returns
+ * `...?channel=1&amp;subtype=0` — feeding the raw text into new URL/ffmpeg
+ * probes the wrong stream and persists an unusable pathTemplate). */
+function decodeXmlEntities(s) {
+    return s
+        .replace(/&#x([0-9a-fA-F]+);/g, (_, h) => String.fromCodePoint(parseInt(h, 16)))
+        .replace(/&#(\d+);/g, (_, d) => String.fromCodePoint(parseInt(d, 10)))
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&apos;/g, "'")
+        .replace(/&amp;/g, '&'); // LAST so &amp;lt; decodes correctly
+}
+/** First match group of a namespace-agnostic tag (entity-decoded), or null. */
+function xmlTag(xml, localName) {
+    const m = xml.match(new RegExp(`<(?:[A-Za-z0-9_]+:)?${localName}[^>]*>([\\s\\S]*?)</(?:[A-Za-z0-9_]+:)?${localName}>`));
+    return m ? decodeXmlEntities(m[1].trim()) : null;
+}
+/** All matches (full element text) of a namespace-agnostic tag. */
+function xmlTags(xml, localName) {
+    const out = [];
+    const re = new RegExp(`<(?:[A-Za-z0-9_]+:)?${localName}(\\s[^>]*)?>([\\s\\S]*?)</(?:[A-Za-z0-9_]+:)?${localName}>`, 'g');
+    let m;
+    while ((m = re.exec(xml)) !== null)
+        out.push(m[0]);
+    return out;
+}
+function attrOf(elementXml, attr) {
+    const m = elementXml.match(new RegExp(`${attr}="([^"]*)"`));
+    return m ? m[1] : null;
+}
+class OnvifClient {
+    constructor(options, poster) {
+        /** Media service endpoint discovered via GetServices (falls back to device). */
+        this.mediaXAddr = null;
+        this.host = options.host;
+        this.port = options.port ?? 80;
+        this.username = options.username;
+        this.password = options.password;
+        this.timeoutMs = options.timeoutMs ?? 5000;
+        this.poster = poster ?? AudienceAnalyzeClient_1.defaultHttpPoster;
+    }
+    deviceEndpoint() {
+        return `http://${this.host}:${this.port}/onvif/device_service`;
+    }
+    async soap(endpoint, body) {
+        let res;
+        try {
+            res = await this.poster(endpoint, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/soap+xml; charset=utf-8' },
+                timeoutMs: this.timeoutMs,
+            }, envelope(buildUsernameToken(this.username, this.password), body));
+        }
+        catch (err) {
+            throw new OnvifError('unreachable', `ONVIF ${endpoint} unreachable: ${err.message}`);
+        }
+        // 401/403 → bad creds. Many recorders return 400 + a NotAuthorized SOAP
+        // fault instead — treat both as the auth circuit-breaker signal.
+        if (res.statusCode === 401 || res.statusCode === 403) {
+            throw new OnvifError('auth', `ONVIF auth rejected (HTTP ${res.statusCode})`);
+        }
+        if (/NotAuthorized|not\s+authorized|sender not authorized/i.test(res.body)) {
+            throw new OnvifError('auth', 'ONVIF auth rejected (SOAP NotAuthorized fault)');
+        }
+        if (res.statusCode < 200 || res.statusCode >= 300) {
+            throw new OnvifError('not_onvif', `ONVIF endpoint answered HTTP ${res.statusCode}`);
+        }
+        if (/<(?:[A-Za-z0-9_]+:)?Fault[\s>]/.test(res.body)) {
+            throw new OnvifError('fault', `ONVIF SOAP fault: ${xmlTag(res.body, 'Text') || 'unknown'}`);
+        }
+        return res.body;
+    }
+    /** Stable physical identity (the channelKey backbone). */
+    async getDeviceInformation() {
+        const xml = await this.soap(this.deviceEndpoint(), '<GetDeviceInformation xmlns="http://www.onvif.org/ver10/device/wsdl"/>');
+        return {
+            manufacturer: xmlTag(xml, 'Manufacturer'),
+            model: xmlTag(xml, 'Model'),
+            serialNumber: xmlTag(xml, 'SerialNumber'),
+            firmwareVersion: xmlTag(xml, 'FirmwareVersion'),
+        };
+    }
+    /** Resolve the media service endpoint (GetServices; fall back to device path). */
+    async resolveMediaXAddr() {
+        if (this.mediaXAddr)
+            return this.mediaXAddr;
+        try {
+            const xml = await this.soap(this.deviceEndpoint(), '<GetServices xmlns="http://www.onvif.org/ver10/device/wsdl"><IncludeCapability>false</IncludeCapability></GetServices>');
+            for (const svc of xmlTags(xml, 'Service')) {
+                const ns = xmlTag(svc, 'Namespace') || '';
+                if (ns.includes('/media/')) {
+                    const xaddr = xmlTag(svc, 'XAddr');
+                    if (xaddr) {
+                        // Rewrite the advertised host with the one WE reached — recorders
+                        // behind NAT/port-forwards advertise internal addresses.
+                        this.mediaXAddr = this.rewriteHost(xaddr);
+                        return this.mediaXAddr;
+                    }
+                }
+            }
+        }
+        catch (err) {
+            if (err.kind === 'auth')
+                throw err; // never mask auth
+            /* fall through to the conventional path */
+        }
+        this.mediaXAddr = `http://${this.host}:${this.port}/onvif/media_service`;
+        return this.mediaXAddr;
+    }
+    rewriteHost(xaddr) {
+        try {
+            const u = new URL(xaddr);
+            u.hostname = this.host;
+            if (!u.port)
+                u.port = String(this.port);
+            return u.toString();
+        }
+        catch {
+            return `http://${this.host}:${this.port}/onvif/media_service`;
+        }
+    }
+    /** The recorder's REAL channel/profile list. */
+    async getProfiles() {
+        const media = await this.resolveMediaXAddr();
+        const xml = await this.soap(media, '<GetProfiles xmlns="http://www.onvif.org/ver10/media/wsdl"/>');
+        const out = [];
+        for (const el of xmlTags(xml, 'Profiles')) {
+            const token = attrOf(el, 'token');
+            if (!token)
+                continue;
+            const srcEl = xmlTags(el, 'VideoSourceConfiguration')[0] || '';
+            out.push({
+                token,
+                name: xmlTag(el, 'Name'),
+                videoSourceToken: srcEl ? xmlTag(srcEl, 'SourceToken') : null,
+            });
+        }
+        return out;
+    }
+    /** The ACTUAL RTSP URI for one profile (no guessed brand paths). */
+    async getStreamUri(profileToken) {
+        const media = await this.resolveMediaXAddr();
+        const xml = await this.soap(media, '<GetStreamUri xmlns="http://www.onvif.org/ver10/media/wsdl">' +
+            '<StreamSetup><Stream xmlns="http://www.onvif.org/ver10/schema">RTP-Unicast</Stream>' +
+            '<Transport xmlns="http://www.onvif.org/ver10/schema"><Protocol>RTSP</Protocol></Transport></StreamSetup>' +
+            `<ProfileToken>${escapeXml(profileToken)}</ProfileToken></GetStreamUri>`);
+        const uri = xmlTag(xml, 'Uri');
+        if (!uri)
+            return null;
+        // Rewrite the advertised host (NAT-advertised internals) but keep path/port.
+        try {
+            const u = new URL(uri);
+            u.hostname = this.host;
+            return u.toString();
+        }
+        catch {
+            return uri;
+        }
+    }
+}
+exports.OnvifClient = OnvifClient;
+//# sourceMappingURL=OnvifClient.js.map

package/dist/OnvifClient.js.map

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

package/dist/PairClient.d.ts

@@ -0,0 +1,106 @@
+import { type HttpPoster } from './AudienceAnalyzeClient';
+import type { EdgeAgentConfig, MosaicTile } from './config';
+/**
+ * PairClient — exchanges a short-TTL claim code for the connector's full
+ * config via `POST {apiBaseUrl}/v2/earner/cameras/pair`.
+ *
+ * This is the security conduit for the one-click installer: the device token
+ * is NEVER baked into the downloadable binary. Instead the operator generates
+ * a claim code in the portal (bound to the camera screens they just
+ * provisioned), the installer asks for that code once on first run, and this
+ * client trades it for `{ apiBaseUrl, cloudSensing, cameras: [{ screenId,
+ * deviceToken, rtspUrl? }] }` — which is written verbatim to
+ * trillboards.config.json.
+ *
+ * The claim code IS the credential, so the request carries NO device-token
+ * headers (mirrors the unauthenticated, rate-limited
+ * `POST /v2/mdm/enrollment/device` enrollment endpoint). Uses the same
+ * built-in-http poster as AudienceAnalyzeClient (no extra dep → survives
+ * bundling into a self-contained binary; trivially mockable in tests).
+ */
+export interface PairClientOptions {
+    /** Base URL, e.g. https://api.trillboards.com (no trailing slash needed). */
+    apiBaseUrl: string;
+    /** Request timeout in ms. Default: 30000. */
+    timeoutMs?: number;
+}
+export interface PairRequest {
+    /** The claim code from the portal (with or without the XXXX-XXXX dash). */
+    claimCode: string;
+    /** Stable per-host fingerprint, sent for correlation/audit. Optional. */
+    deviceFingerprint?: string;
+    /** Connector version string, for server-side compat checks. Optional. */
+    connectorVersion?: string;
+}
+/**
+ * The config the server returns for a valid claim code — exactly the shape the
+ * connector persists to trillboards.config.json and then runs `cloud-sense`
+ * against. `rtspUrl` is OPTIONAL per camera: the portal MAY deliver it
+ * (stored encrypted) or the operator enters it locally so credentials never
+ * leave the venue.
+ */
+export interface PairedConfig {
+    apiBaseUrl: string;
+    cloudSensing: {
+        enabled: true;
+        periodicIntervalMs?: number;
+        faceTriggeredIntervalMs?: number;
+        jpegQuality?: number;
+        feedStaggerMs?: number;
+        maxFeedStaggerMs?: number;
+        cameraHealthFailureGraceCount?: number;
+    };
+    cameras: Array<{
+        name: string;
+        screenId: string;
+        deviceToken: string;
+        rtspUrl?: string;
+        /**
+         * Mosaic tiling (carve one composite/quad RTSP into per-screen tiles).
+         * `id` marks a SOURCE feed (carries the rtspUrl); `sourceFeedId` points a
+         * tile at that source so it shares the single RTSP pull; `tile` is the crop
+         * rect (source pixels). All optional — absent for whole-frame feeds. These
+         * MUST survive pairing or a DVR-mosaic feed can't be split into N screens.
+         */
+        id?: string;
+        sourceFeedId?: string;
+        tile?: MosaicTile;
+        width?: number;
+        height?: number;
+        fps?: number;
+        transport?: 'tcp' | 'udp';
+    }>;
+}
+export interface PairResponse {
+    /** HTTP status code. */
+    statusCode: number;
+    /** Whether pairing succeeded (2xx with a usable config). */
+    ok: boolean;
+    /** The connector config to persist, when ok. */
+    config: PairedConfig | null;
+    /** Server error code/message when not ok (e.g. INVALID_CODE, EXPIRED_CODE). */
+    error?: string;
+    /** Raw response text. */
+    rawBody: string;
+}
+/** Normalize a user-entered claim code: strip spaces/dashes, upper-case. */
+export declare function normalizeClaimCode(code: string): string;
+export declare class PairClient {
+    private readonly endpoint;
+    private readonly timeoutMs;
+    private readonly poster;
+    constructor(options: PairClientOptions, poster?: HttpPoster);
+    /** The resolved POST URL (exposed for assertions / logging). */
+    getEndpoint(): string;
+    /** Exchange a claim code for the connector config. */
+    pair(request: PairRequest): Promise<PairResponse>;
+}
+/**
+ * Validate + shape the server payload into a PairedConfig. Accepts either the
+ * config at the top level or nested under `config`. Requires at least one
+ * camera with a screenId + deviceToken (rtspUrl optional — creds-local mode).
+ */
+export declare function extractPairedConfig(body: Record<string, unknown> | null): PairedConfig | null;
+/** Build the EdgeAgentConfig-compatible object written to disk after pairing. */
+export declare function pairedConfigToFile(config: PairedConfig): Partial<EdgeAgentConfig>;
+//# sourceMappingURL=PairClient.d.ts.map

package/dist/PairClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PairClient.d.ts","sourceRoot":"","sources":["../src/PairClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE5D;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,iBAAiB;IAChC,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE;QACZ,OAAO,EAAE,IAAI,CAAC;QACd,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,uBAAuB,CAAC,EAAE,MAAM,CAAC;QACjC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,6BAA6B,CAAC,EAAE,MAAM,CAAC;KACxC,CAAC;IACF,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB;;;;;;WAMG;QACH,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,UAAU,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;KAC3B,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,EAAE,EAAE,OAAO,CAAC;IACZ,gDAAgD;IAChD,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;gBAExB,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,UAAU;IAU3D,gEAAgE;IAChE,WAAW,IAAI,MAAM;IAIrB,sDAAsD;IAChD,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;CAwDxD;AAoBD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GACnC,YAAY,GAAG,IAAI,CA8DrB;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAqBjF"}

package/dist/PairClient.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PairClient = void 0;
+exports.normalizeClaimCode = normalizeClaimCode;
+exports.extractPairedConfig = extractPairedConfig;
+exports.pairedConfigToFile = pairedConfigToFile;
+const AudienceAnalyzeClient_1 = require("./AudienceAnalyzeClient");
+/** Normalize a user-entered claim code: strip spaces/dashes, upper-case. */
+function normalizeClaimCode(code) {
+    return String(code || '')
+        .replace(/[\s-]+/g, '')
+        .toUpperCase();
+}
+class PairClient {
+    constructor(options, poster) {
+        if (!options.apiBaseUrl) {
+            throw new Error('apiBaseUrl is required for PairClient');
+        }
+        const base = options.apiBaseUrl.replace(/\/+$/, '');
+        this.endpoint = `${base}/v2/earner/cameras/pair`;
+        this.timeoutMs = options.timeoutMs ?? 30000;
+        this.poster = poster ?? AudienceAnalyzeClient_1.defaultHttpPoster;
+    }
+    /** The resolved POST URL (exposed for assertions / logging). */
+    getEndpoint() {
+        return this.endpoint;
+    }
+    /** Exchange a claim code for the connector config. */
+    async pair(request) {
+        const claimCode = normalizeClaimCode(request?.claimCode);
+        if (!claimCode) {
+            throw new Error('pair() requires a non-empty claimCode');
+        }
+        const payload = {
+            claimCode,
+            ...(request.deviceFingerprint ? { deviceFingerprint: request.deviceFingerprint } : {}),
+            ...(request.connectorVersion ? { connectorVersion: request.connectorVersion } : {}),
+        };
+        const result = await this.poster(this.endpoint, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
+            timeoutMs: this.timeoutMs,
+        }, JSON.stringify(payload));
+        let parsed = null;
+        try {
+            parsed = result.body ? JSON.parse(result.body) : null;
+        }
+        catch {
+            parsed = null;
+        }
+        const ok = result.statusCode >= 200 && result.statusCode < 300;
+        if (!ok) {
+            return {
+                statusCode: result.statusCode,
+                ok: false,
+                config: null,
+                error: (parsed && parsed.error) ||
+                    (parsed && parsed.message) ||
+                    `pair failed (HTTP ${result.statusCode})`,
+                rawBody: result.body,
+            };
+        }
+        const config = extractPairedConfig(parsed);
+        if (!config) {
+            return {
+                statusCode: result.statusCode,
+                ok: false,
+                config: null,
+                error: 'pair response did not contain a usable camera config',
+                rawBody: result.body,
+            };
+        }
+        return { statusCode: result.statusCode, ok: true, config, rawBody: result.body };
+    }
+}
+exports.PairClient = PairClient;
+/**
+ * Sanitize a mosaic tile rectangle (source pixels) → { x, y, w, h } with
+ * non-negative integer offsets + positive integer dimensions, or null when the
+ * shape is absent/invalid. Mirrors the server-side cameraClaimCodeService
+ * sanitizeTile so a malformed rect never reaches the connector's ffmpeg crop.
+ */
+function sanitizeTile(tile) {
+    if (!tile || typeof tile !== 'object')
+        return null;
+    const t = tile;
+    const x = Math.trunc(Number(t.x));
+    const y = Math.trunc(Number(t.y));
+    const w = Math.trunc(Number(t.w));
+    const h = Math.trunc(Number(t.h));
+    if (![x, y, w, h].every(Number.isFinite))
+        return null;
+    if (x < 0 || y < 0 || w <= 0 || h <= 0)
+        return null;
+    return { x, y, w, h };
+}
+/**
+ * Validate + shape the server payload into a PairedConfig. Accepts either the
+ * config at the top level or nested under `config`. Requires at least one
+ * camera with a screenId + deviceToken (rtspUrl optional — creds-local mode).
+ */
+function extractPairedConfig(body) {
+    if (!body)
+        return null;
+    const src = (body.config && typeof body.config === 'object'
+        ? body.config
+        : body);
+    const rawCameras = Array.isArray(src.cameras) ? src.cameras : [];
+    const cameras = rawCameras
+        .map((c) => (c && typeof c === 'object' ? c : null))
+        .filter((c) => !!c && !!c.screenId && !!c.deviceToken)
+        .map((c) => {
+        // Re-sanitize the tile defensively: the connector feeds these coords
+        // straight into the ffmpeg crop filter, so a malformed rect from any
+        // source must never reach it (mirrors the server-side sanitizeTile).
+        const tile = sanitizeTile(c.tile);
+        return {
+            name: String(c.name || c.screenId),
+            screenId: String(c.screenId),
+            deviceToken: String(c.deviceToken),
+            ...(c.rtspUrl ? { rtspUrl: String(c.rtspUrl) } : {}),
+            // Mosaic tiling: carry the source link + crop so a composite/quad feed
+            // can be carved into per-tile screens (config.ts resolveConfig groups
+            // tiles by sourceFeedId and inherits the source's single RTSP pull).
+            ...(c.id ? { id: String(c.id) } : {}),
+            ...(c.sourceFeedId ? { sourceFeedId: String(c.sourceFeedId) } : {}),
+            ...(tile ? { tile } : {}),
+            ...(typeof c.width === 'number' ? { width: c.width } : {}),
+            ...(typeof c.height === 'number' ? { height: c.height } : {}),
+            ...(typeof c.fps === 'number' ? { fps: c.fps } : {}),
+            ...(c.transport === 'udp' || c.transport === 'tcp'
+                ? { transport: c.transport }
+                : {}),
+        };
+    });
+    if (cameras.length === 0)
+        return null;
+    const cs = (src.cloudSensing && typeof src.cloudSensing === 'object'
+        ? src.cloudSensing
+        : {});
+    return {
+        apiBaseUrl: String(src.apiBaseUrl || 'https://api.trillboards.com'),
+        cloudSensing: {
+            enabled: true,
+            ...(typeof cs.periodicIntervalMs === 'number'
+                ? { periodicIntervalMs: cs.periodicIntervalMs }
+                : {}),
+            ...(typeof cs.faceTriggeredIntervalMs === 'number'
+                ? { faceTriggeredIntervalMs: cs.faceTriggeredIntervalMs }
+                : {}),
+            ...(typeof cs.jpegQuality === 'number' ? { jpegQuality: cs.jpegQuality } : {}),
+            ...(typeof cs.feedStaggerMs === 'number' ? { feedStaggerMs: cs.feedStaggerMs } : {}),
+            ...(typeof cs.maxFeedStaggerMs === 'number'
+                ? { maxFeedStaggerMs: cs.maxFeedStaggerMs }
+                : {}),
+            ...(typeof cs.cameraHealthFailureGraceCount === 'number'
+                ? { cameraHealthFailureGraceCount: cs.cameraHealthFailureGraceCount }
+                : {}),
+        },
+        cameras,
+    };
+}
+/** Build the EdgeAgentConfig-compatible object written to disk after pairing. */
+function pairedConfigToFile(config) {
+    return {
+        apiBaseUrl: config.apiBaseUrl,
+        cloudSensing: config.cloudSensing,
+        cameras: config.cameras.map((c) => ({
+            name: c.name,
+            screenId: c.screenId,
+            deviceToken: c.deviceToken,
+            rtspUrl: c.rtspUrl || '',
+            // Mosaic tiling — persist the source link + crop so loadConfig/resolveConfig
+            // can reconstitute the tile feeds (a tile inherits its source's rtspUrl via
+            // the id→rtspUrl map). A tile's own rtspUrl stays '' (inherited on load).
+            ...(c.id ? { id: c.id } : {}),
+            ...(c.sourceFeedId ? { sourceFeedId: c.sourceFeedId } : {}),
+            ...(c.tile ? { tile: c.tile } : {}),
+            ...(c.width ? { width: c.width } : {}),
+            ...(c.height ? { height: c.height } : {}),
+            ...(c.fps ? { fps: c.fps } : {}),
+            ...(c.transport ? { transport: c.transport } : {}),
+        })),
+    };
+}
+//# sourceMappingURL=PairClient.js.map

package/dist/PairClient.js.map

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

package/dist/RecorderAddressRecovery.d.ts

@@ -0,0 +1,53 @@
+import type { EdgeAgentConfig, CameraFeedConfig } from './config';
+import type { ResolvedFeed } from './CloudSensingManager';
+import { discoverOnvifHosts, sweepLanForRecorders, type OnvifHost } from './discovery';
+export interface RecorderAddressRecoveryOptions {
+    configPath?: string;
+    log?: (message: string) => void;
+    cooldownMs?: number;
+    now?: () => number;
+    discover?: typeof discoverOnvifHosts;
+    sweep?: typeof sweepLanForRecorders;
+    validateStream?: (url: string, feed: CameraFeedConfig) => Promise<boolean>;
+    matchSerial?: (candidate: OnvifHost, expectedSerial: string, credentials: {
+        username: string;
+        password: string;
+    }) => Promise<boolean>;
+    lookupMac?: (host: string) => Promise<string | null>;
+}
+export declare function normalizeMacAddress(value: string): string | null;
+/** Read one already-contacted LAN host from the operating system's neighbor table. */
+export declare function lookupMacAddress(host: string): Promise<string | null>;
+/** Replace only the host, preserving credentials, port, path, query, and RTSPS. */
+export declare function rewriteStreamHost(streamUrl: string, host: string): string;
+export declare function shouldAttemptRecorderAddressRecovery(error: unknown): boolean;
+/**
+ * Finds a recorder again after DHCP changes its address.
+ *
+ * Recovery is deliberately conservative: the MAC address must match before
+ * credentials are used. An ONVIF serial is then verified when setup captured
+ * one; otherwise an existing channel recipe validates the matched recorder.
+ * Credentials are never tried against an unmatched LAN device.
+ */
+export declare class RecorderAddressRecovery {
+    private readonly groups;
+    private readonly currentHost;
+    private readonly inFlight;
+    private readonly lastFailedAt;
+    private readonly configPath?;
+    private readonly log;
+    private readonly cooldownMs;
+    private readonly now;
+    private readonly discover;
+    private readonly sweep;
+    private readonly validateStream;
+    private readonly matchSerial;
+    private readonly lookupMac;
+    constructor(config: EdgeAgentConfig, options?: RecorderAddressRecoveryOptions);
+    canRecover(feed: ResolvedFeed): boolean;
+    recover(feed: ResolvedFeed, currentUrl: string, error: unknown): Promise<string | null>;
+    private findCurrentHost;
+    private updateGroupUrls;
+    private persistGroupUrls;
+}
+//# sourceMappingURL=RecorderAddressRecovery.d.ts.map

package/dist/RecorderAddressRecovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecorderAddressRecovery.d.ts","sourceRoot":"","sources":["../src/RecorderAddressRecovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAoB,MAAM,UAAU,CAAC;AACpF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAavF,MAAM,WAAW,8BAA8B;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,kBAAkB,CAAC;IACrC,KAAK,CAAC,EAAE,OAAO,oBAAoB,CAAC;IACpC,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3E,WAAW,CAAC,EAAE,CACZ,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAChD,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACtD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAShE;AAaD,sFAAsF;AACtF,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoB3E;AA4BD,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIzE;AAED,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG5E;AAuCD;;;;;;;GAOG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6C;IACtE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA4B;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IACpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4D;IAC3F,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6D;IACzF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2D;gBAEzE,MAAM,EAAE,eAAe,EAAE,OAAO,GAAE,8BAAmC;IA4BjF,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO;IAMjC,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;YAwC/E,eAAe;IAmD7B,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,gBAAgB;CAuCzB"}