@trillboards/edge-sdk 0.2.4 → 0.2.7

package/dist/MosaicSource.d.ts

@@ -0,0 +1,108 @@
+import type { CameraProvider } from '@trillboards/edge-core';
+import type { MosaicTile } from './config';
+/**
+ * Wraps the FULL-mosaic frame provider so its single RTSP pull is shared by all
+ * tiles. The tiles' capture timers fire together (they start on the same
+ * cadence), so a tile asking within `maxAgeMs` of the last pull reuses that
+ * frame; concurrent callers coalesce onto one inflight pull. The cached frame is
+ * a co-temporal capture handed to sibling tiles — NOT a stored/replayed frame
+ * (it is always younger than the capture cadence).
+ */
+export declare class SharedFrameSource {
+    private readonly source;
+    private readonly maxAgeMs;
+    private readonly nowFn;
+    private refs;
+    private last;
+    private inflight;
+    /** Coalesces concurrent ensureOpen() re-opens onto a single source.open(). */
+    private reopening;
+    constructor(source: CameraProvider, opts?: {
+        maxAgeMs?: number;
+        now?: () => number;
+    });
+    /** A tile attaches — open the underlying source on the first attach. */
+    acquire(): Promise<void>;
+    /** A tile detaches — close the underlying source when the last one leaves. */
+    release(): Promise<void>;
+    isOpen(): boolean;
+    /**
+     * Re-open the underlying source if it has dropped (e.g. the RTSP grabber gave
+     * up its per-attempt retries and closed itself), WITHOUT touching the
+     * refcount — this is recovery of an existing attachment, not a new tile
+     * joining. Concurrent re-opens (sibling tiles reconnecting on the same tick)
+     * coalesce onto one `source.open()`. The stale frame cache is cleared so the
+     * next getFrame() pulls fresh from the recovered source. No-op when already
+     * open. This is what lets mosaic feeds self-recover from an RTSP drop instead
+     * of staying down until the process restarts.
+     */
+    ensureOpen(): Promise<void>;
+    /** Source (mosaic) native resolution the tile crop coordinates are relative to. */
+    getResolution(): {
+        width: number;
+        height: number;
+    };
+    /** Full mosaic frame as a JPEG Buffer — cached/coalesced single pull. */
+    getFrame(): Promise<Buffer>;
+}
+export interface CropViewProviderOptions {
+    /** Sub-rectangle of the source frame for this tile (source pixels). Omit = full frame. */
+    crop?: MosaicTile;
+    /** Tile output width (px) — the sensing input size. */
+    width: number;
+    /** Tile output height (px). */
+    height: number;
+    /** Source (mosaic) native width/height — used to skip a re-encode for a full-frame view. */
+    sourceWidth?: number;
+    sourceHeight?: number;
+    /** Advisory fps reported to the cadence loop (default 8). */
+    fps?: number;
+    /** ffmpeg binary path (default 'ffmpeg'). */
+    ffmpegPath?: string;
+    /** JPEG quality 1-100 for the carved tile (default 70). */
+    jpegQuality?: number;
+    /** Carve timeout (ms) before the ffmpeg child is killed (default 8000). */
+    carveTimeoutMs?: number;
+    /**
+     * Carve output pixel format. 'jpeg' (default) — the VLM/cloud path that POSTs a
+     * JPEG. 'rgb24' — raw RGB24 (HWC) for the on-device ONNX zoo (AudienceSensingService
+     * → FaceDetector consumes raw RGB pixels, not JPEG). Both carve from the SAME
+     * cached mosaic pull; only the ffmpeg output encoding differs.
+     */
+    outputFormat?: 'jpeg' | 'rgb24';
+}
+/**
+ * A CameraProvider that yields one TILE of a shared mosaic frame. getFrame()
+ * pulls the (cached) full frame from the SharedFrameSource, then carves this
+ * tile in a single ffmpeg pass (`-i pipe:0 -vf crop=…,scale=… -f mjpeg`). A
+ * full-frame view at the source's own resolution skips the re-encode and returns
+ * the cached frame as-is.
+ */
+export declare class CropViewProvider implements CameraProvider {
+    private readonly shared;
+    private readonly crop?;
+    private readonly width;
+    private readonly height;
+    private readonly sourceWidth?;
+    private readonly sourceHeight?;
+    private readonly fps;
+    private readonly ffmpegPath;
+    private readonly jpegQuality;
+    private readonly carveTimeoutMs;
+    private readonly outputFormat;
+    private opened;
+    constructor(shared: SharedFrameSource, opts: CropViewProviderOptions);
+    open(_deviceId?: string): Promise<void>;
+    close(): Promise<void>;
+    isOpen(): boolean;
+    getResolution(): {
+        width: number;
+        height: number;
+    };
+    getFps(): number;
+    getFrame(): Promise<Buffer>;
+    /** Carve this tile out of the cached full JPEG with a single ffmpeg pass.
+     *  Output is JPEG (VLM/cloud) or raw RGB24 (on-device ONNX zoo) per outputFormat. */
+    private carve;
+}
+//# sourceMappingURL=MosaicSource.d.ts.map

package/dist/MosaicSource.d.ts.map

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

package/dist/MosaicSource.js

@@ -0,0 +1,274 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CropViewProvider = exports.SharedFrameSource = void 0;
+const child_process_1 = require("child_process");
+// edge-platform-rtsp is consumed by runtime require() (never a typed top-level
+// import) throughout edge-sdk — see RTSPCameraProvider usage in CloudSensingManager
+// / EdgeAgent / localSensing. We reuse its ffmpeg-arg helpers the same way so the
+// tile carve math is the SAME function the RTSP pull uses (one source of truth).
+// require() is memoized, so this resolves once.
+function rtspHelpers() {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    return require('@trillboards/edge-platform-rtsp');
+}
+/**
+ * Mosaic tiling — one RTSP pull shared by N tiles.
+ *
+ * A composite ("mosaic"/quad) CCTV feed is a SINGLE RTSP stream that shows
+ * several cameras in a grid. Each grid cell becomes its own Trillboards screen +
+ * sensing profile. Pulling the stream once per tile would be N RTSP sessions for
+ * one stream (N× the bandwidth — and many DVRs cap concurrent sessions), so
+ * instead the source is pulled ONCE here and every tile gets a cropped VIEW of
+ * the same captured frame, carved in ffmpeg (NOT a JS buffer copy) so the carve
+ * math is identical to the in-pass RTSP crop (buildVideoFilter is shared).
+ *
+ * @module MosaicSource
+ */
+const DEFAULT_SHARED_FRAME_MAX_AGE_MS = 5000;
+const DEFAULT_CARVE_TIMEOUT_MS = 8000;
+const DEFAULT_JPEG_QUALITY = 70;
+const DEFAULT_FPS = 8;
+function toBuffer(frame) {
+    return Buffer.isBuffer(frame) ? frame : Buffer.from(frame.data.buffer);
+}
+/**
+ * Wraps the FULL-mosaic frame provider so its single RTSP pull is shared by all
+ * tiles. The tiles' capture timers fire together (they start on the same
+ * cadence), so a tile asking within `maxAgeMs` of the last pull reuses that
+ * frame; concurrent callers coalesce onto one inflight pull. The cached frame is
+ * a co-temporal capture handed to sibling tiles — NOT a stored/replayed frame
+ * (it is always younger than the capture cadence).
+ */
+class SharedFrameSource {
+    constructor(source, opts) {
+        this.refs = 0;
+        this.last = null;
+        this.inflight = null;
+        /** Coalesces concurrent ensureOpen() re-opens onto a single source.open(). */
+        this.reopening = null;
+        this.source = source;
+        this.maxAgeMs = opts?.maxAgeMs ?? DEFAULT_SHARED_FRAME_MAX_AGE_MS;
+        this.nowFn = opts?.now ?? Date.now;
+    }
+    /** A tile attaches — open the underlying source on the first attach. */
+    async acquire() {
+        this.refs++;
+        if (!this.source.isOpen()) {
+            await this.source.open();
+        }
+    }
+    /** A tile detaches — close the underlying source when the last one leaves. */
+    async release() {
+        this.refs = Math.max(0, this.refs - 1);
+        if (this.refs === 0) {
+            this.last = null;
+            if (this.source.isOpen()) {
+                await this.source.close();
+            }
+        }
+    }
+    isOpen() {
+        return this.source.isOpen();
+    }
+    /**
+     * Re-open the underlying source if it has dropped (e.g. the RTSP grabber gave
+     * up its per-attempt retries and closed itself), WITHOUT touching the
+     * refcount — this is recovery of an existing attachment, not a new tile
+     * joining. Concurrent re-opens (sibling tiles reconnecting on the same tick)
+     * coalesce onto one `source.open()`. The stale frame cache is cleared so the
+     * next getFrame() pulls fresh from the recovered source. No-op when already
+     * open. This is what lets mosaic feeds self-recover from an RTSP drop instead
+     * of staying down until the process restarts.
+     */
+    async ensureOpen() {
+        if (this.source.isOpen())
+            return;
+        if (this.reopening)
+            return this.reopening;
+        this.reopening = (async () => {
+            try {
+                if (!this.source.isOpen()) {
+                    await this.source.open();
+                    this.last = null; // drop stale cache from before the outage
+                }
+            }
+            finally {
+                this.reopening = null;
+            }
+        })();
+        return this.reopening;
+    }
+    /** Source (mosaic) native resolution the tile crop coordinates are relative to. */
+    getResolution() {
+        return this.source.getResolution();
+    }
+    /** Full mosaic frame as a JPEG Buffer — cached/coalesced single pull. */
+    async getFrame() {
+        if (this.last && this.nowFn() - this.last.at < this.maxAgeMs) {
+            return this.last.frame;
+        }
+        if (this.inflight) {
+            return this.inflight;
+        }
+        this.inflight = (async () => {
+            try {
+                const frame = toBuffer(await this.source.getFrame());
+                this.last = { frame, at: this.nowFn() };
+                return frame;
+            }
+            finally {
+                this.inflight = null;
+            }
+        })();
+        return this.inflight;
+    }
+}
+exports.SharedFrameSource = SharedFrameSource;
+/**
+ * A CameraProvider that yields one TILE of a shared mosaic frame. getFrame()
+ * pulls the (cached) full frame from the SharedFrameSource, then carves this
+ * tile in a single ffmpeg pass (`-i pipe:0 -vf crop=…,scale=… -f mjpeg`). A
+ * full-frame view at the source's own resolution skips the re-encode and returns
+ * the cached frame as-is.
+ */
+class CropViewProvider {
+    constructor(shared, opts) {
+        this.opened = false;
+        this.shared = shared;
+        this.crop = opts.crop;
+        this.width = opts.width;
+        this.height = opts.height;
+        this.sourceWidth = opts.sourceWidth;
+        this.sourceHeight = opts.sourceHeight;
+        this.fps = opts.fps ?? DEFAULT_FPS;
+        this.ffmpegPath = opts.ffmpegPath ?? 'ffmpeg';
+        this.jpegQuality = opts.jpegQuality ?? DEFAULT_JPEG_QUALITY;
+        this.carveTimeoutMs = opts.carveTimeoutMs ?? DEFAULT_CARVE_TIMEOUT_MS;
+        this.outputFormat = opts.outputFormat ?? 'jpeg';
+    }
+    async open(_deviceId) {
+        if (this.opened) {
+            // Already attached (refcount held) but the shared source dropped — recover
+            // it WITHOUT acquiring another ref. This is the reconnect path the manager
+            // drives after a mosaic RTSP drop; a plain acquire() here would leak refs
+            // so the source would never close on shutdown.
+            await this.shared.ensureOpen();
+            return;
+        }
+        await this.shared.acquire();
+        this.opened = true;
+    }
+    async close() {
+        if (!this.opened)
+            return;
+        this.opened = false;
+        await this.shared.release();
+    }
+    isOpen() {
+        // Reflect the underlying shared source's health, not just our own attach
+        // flag: when the mosaic RTSP grabber drops itself, this tile must report NOT
+        // open so the cadence loop's reconnect path fires (it never would if we only
+        // returned `this.opened`). See CloudSensingManager.runScheduledTick.
+        return this.opened && this.shared.isOpen();
+    }
+    getResolution() {
+        return { width: this.width, height: this.height };
+    }
+    getFps() {
+        return this.fps;
+    }
+    async getFrame() {
+        if (!this.opened) {
+            throw new Error('CropViewProvider not opened. Call open() first.');
+        }
+        const full = await this.shared.getFrame();
+        // Full-frame JPEG view at the source's own resolution → no crop, no rescale,
+        // so ship the shared (JPEG) frame untouched (the source feed-as-screen path).
+        // The rgb24 zoo path can never take this fast-path: the shared pull is JPEG
+        // and the zoo needs decoded raw RGB24, so it always carves (decodes) below.
+        if (this.outputFormat === 'jpeg' &&
+            !this.crop &&
+            this.sourceWidth === this.width &&
+            this.sourceHeight === this.height) {
+            return full;
+        }
+        return this.carve(full);
+    }
+    /** Carve this tile out of the cached full JPEG with a single ffmpeg pass.
+     *  Output is JPEG (VLM/cloud) or raw RGB24 (on-device ONNX zoo) per outputFormat. */
+    carve(fullJpeg) {
+        const { buildVideoFilter, mjpegQv } = rtspHelpers();
+        const rgb24 = this.outputFormat === 'rgb24';
+        return new Promise((resolve, reject) => {
+            const args = [
+                '-i', 'pipe:0',
+                '-frames:v', '1',
+                '-vf', buildVideoFilter(this.width, this.height, this.crop),
+                // rgb24: raw HWC RGB pixels the ONNX FaceDetector consumes directly.
+                // jpeg:  re-encoded tile for the cloud/VLM POST.
+                ...(rgb24
+                    ? ['-f', 'rawvideo', '-pix_fmt', 'rgb24']
+                    : ['-f', 'mjpeg', '-q:v', String(mjpegQv(this.jpegQuality))]),
+                'pipe:1',
+            ];
+            const proc = (0, child_process_1.spawn)(this.ffmpegPath, args, {
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            const chunks = [];
+            let stderr = '';
+            let settled = false;
+            const killTimer = setTimeout(() => {
+                proc.kill('SIGKILL');
+                if (!settled) {
+                    settled = true;
+                    reject(new Error('Mosaic tile carve timed out'));
+                }
+            }, this.carveTimeoutMs);
+            proc.stdout.on('data', (c) => chunks.push(c));
+            proc.stderr.on('data', (c) => {
+                stderr += c.toString('utf-8');
+            });
+            proc.on('error', (err) => {
+                clearTimeout(killTimer);
+                if (settled)
+                    return;
+                settled = true;
+                reject(new Error(`Failed to spawn ffmpeg for tile carve: ${err.message}`));
+            });
+            proc.on('close', (code) => {
+                clearTimeout(killTimer);
+                if (settled)
+                    return;
+                settled = true;
+                if (code !== 0) {
+                    reject(new Error(`ffmpeg tile carve exited with code ${code}: ${stderr.slice(0, 500)}`));
+                    return;
+                }
+                const out = Buffer.concat(chunks);
+                if (rgb24) {
+                    // Raw RGB24 = exactly width*height*3 bytes (HWC, 8-bit, 3 channels).
+                    const expected = this.width * this.height * 3;
+                    if (out.length !== expected) {
+                        reject(new Error(`ffmpeg tile carve produced ${out.length} bytes, expected ${expected} ` +
+                            `for ${this.width}x${this.height} rgb24`));
+                        return;
+                    }
+                }
+                else if (out.length < 3 || out[0] !== 0xff || out[1] !== 0xd8) {
+                    reject(new Error(`ffmpeg tile carve produced an invalid JPEG (${out.length} bytes)`));
+                    return;
+                }
+                resolve(out);
+            });
+            // Feed the cached full JPEG to ffmpeg's stdin. Ignore EPIPE — if ffmpeg
+            // exits early the 'close' handler already reports the real error.
+            proc.stdin.on('error', () => {
+                /* ignore broken-pipe on early ffmpeg exit */
+            });
+            proc.stdin.write(fullJpeg);
+            proc.stdin.end();
+        });
+    }
+}
+exports.CropViewProvider = CropViewProvider;
+//# sourceMappingURL=MosaicSource.js.map

package/dist/MosaicSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MosaicSource.js","sourceRoot":"","sources":["../src/MosaicSource.ts"],"names":[],"mappings":";;;AAAA,iDAAoD;AAIpD,+EAA+E;AAC/E,oFAAoF;AACpF,kFAAkF;AAClF,iFAAiF;AACjF,gDAAgD;AAChD,SAAS,WAAW;IAIlB,8DAA8D;IAC9D,OAAO,OAAO,CAAC,iCAAiC,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;;;;;;;GAYG;AAEH,MAAM,+BAA+B,GAAG,IAAI,CAAC;AAC7C,MAAM,wBAAwB,GAAG,IAAI,CAAC;AACtC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAChC,MAAM,WAAW,GAAG,CAAC,CAAC;AAEtB,SAAS,QAAQ,CAAC,KAA6B;IAC7C,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACzE,CAAC;AAED;;;;;;;GAOG;AACH,MAAa,iBAAiB;IAU5B,YAAY,MAAsB,EAAE,IAAgD;QAN5E,SAAI,GAAG,CAAC,CAAC;QACT,SAAI,GAAyC,IAAI,CAAC;QAClD,aAAQ,GAA2B,IAAI,CAAC;QAChD,8EAA8E;QACtE,cAAS,GAAyB,IAAI,CAAC;QAG7C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,+BAA+B,CAAC;QAClE,IAAI,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACrC,CAAC;IAED,wEAAwE;IACxE,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1B,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;QACvC,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;gBACzB,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IAC9B,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;YAAE,OAAO;QACjC,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC;QAC1C,IAAI,CAAC,SAAS,GAAG,CAAC,KAAK,IAAI,EAAE;YAC3B,IAAI,CAAC;gBACH,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;oBAC1B,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;oBACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,0CAA0C;gBAC9D,CAAC;YACH,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACxB,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,mFAAmF;IACnF,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;IACrC,CAAC;IAED,yEAAyE;IACzE,KAAK,CAAC,QAAQ;QACZ,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;QACzB,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,QAAQ,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,CAAC,KAAK,IAAI,EAAE;YAC1B,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACrD,IAAI,CAAC,IAAI,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;gBACxC,OAAO,KAAK,CAAC;YACf,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACvB,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF;AAzFD,8CAyFC;AA6BD;;;;;;GAMG;AACH,MAAa,gBAAgB;IAc3B,YAAY,MAAyB,EAAE,IAA6B;QAF5D,WAAM,GAAG,KAAK,CAAC;QAGrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QACtC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,WAAW,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,QAAQ,CAAC;QAC9C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,oBAAoB,CAAC;QAC5D,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,wBAAwB,CAAC;QACtE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,MAAM,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAkB;QAC3B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,2EAA2E;YAC3E,2EAA2E;YAC3E,0EAA0E;YAC1E,+CAA+C;YAC/C,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YAC/B,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC;IAED,MAAM;QACJ,yEAAyE;QACzE,6EAA6E;QAC7E,6EAA6E;QAC7E,qEAAqE;QACrE,OAAO,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IAC7C,CAAC;IAED,aAAa;QACX,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IACpD,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC1C,6EAA6E;QAC7E,8EAA8E;QAC9E,4EAA4E;QAC5E,4EAA4E;QAC5E,IACE,IAAI,CAAC,YAAY,KAAK,MAAM;YAC5B,CAAC,IAAI,CAAC,IAAI;YACV,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC,KAAK;YAC/B,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,MAAM,EACjC,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;yFACqF;IAC7E,KAAK,CAAC,QAAgB;QAC5B,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,GAAG,WAAW,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,KAAK,OAAO,CAAC;QAC5C,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC7C,MAAM,IAAI,GAAG;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,GAAG;gBAChB,KAAK,EAAE,gBAAgB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC;gBAC3D,qEAAqE;gBACrE,iDAAiD;gBACjD,GAAG,CAAC,KAAK;oBACP,CAAC,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC;oBACzC,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;gBAC/D,QAAQ;aACT,CAAC;YACF,MAAM,IAAI,GAAiB,IAAA,qBAAK,EAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE;gBACtD,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;aAChC,CAAC,CAAC;YAEH,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,OAAO,GAAG,KAAK,CAAC;YAEpB,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;gBAChC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACrB,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,GAAG,IAAI,CAAC;oBACf,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;YAExB,IAAI,CAAC,MAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACvD,IAAI,CAAC,MAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;gBACpC,MAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAChC,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACvB,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM,CAAC,IAAI,KAAK,CAAC,0CAA0C,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC7E,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACxB,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,MAAM,CAAC,IAAI,KAAK,CAAC,sCAAsC,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;oBACzF,OAAO;gBACT,CAAC;gBACD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAClC,IAAI,KAAK,EAAE,CAAC;oBACV,qEAAqE;oBACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;oBAC9C,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;wBAC5B,MAAM,CACJ,IAAI,KAAK,CACP,8BAA8B,GAAG,CAAC,MAAM,oBAAoB,QAAQ,GAAG;4BACrE,OAAO,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,QAAQ,CAC3C,CACF,CAAC;wBACF,OAAO;oBACT,CAAC;gBACH,CAAC;qBAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;oBAChE,MAAM,CAAC,IAAI,KAAK,CAAC,+CAA+C,GAAG,CAAC,MAAM,SAAS,CAAC,CAAC,CAAC;oBACtF,OAAO;gBACT,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,CAAC;YACf,CAAC,CAAC,CAAC;YAEH,wEAAwE;YACxE,kEAAkE;YAClE,IAAI,CAAC,KAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBAC3B,6CAA6C;YAC/C,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,KAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC5B,IAAI,CAAC,KAAM,CAAC,GAAG,EAAE,CAAC;QACpB,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAnKD,4CAmKC"}

package/dist/OnvifClient.d.ts

@@ -0,0 +1,83 @@
+import { type HttpPoster } from './AudienceAnalyzeClient';
+/**
+ * OnvifClient — minimal AUTHENTICATED ONVIF SOAP client for the BYO-CCTV setup
+ * probe. Three calls, which together give the setup flow everything the
+ * adversarial review demanded:
+ *
+ *   GetDeviceInformation → manufacturer/model/SERIAL (the stable physical
+ *     identity behind channelKey — survives DHCP lease changes, unlike host IPs)
+ *   GetProfiles          → the recorder's REAL channel/profile list (no more
+ *     "assume 16 channels" — the Hiten failure)
+ *   GetStreamUri         → the actual per-profile RTSP URL (no more guessed
+ *     /Streaming/Channels/101 paths)
+ *
+ * Deliberately dependency-free: WS-UsernameToken digest auth + regex XML
+ * extraction, following the discovery.ts precedent (parseProbeMatches) — a
+ * full SOAP/XML stack is overkill for three fixed calls and would bloat the
+ * self-contained installer. Transport is the same injectable poster the other
+ * clients use (unit tests never touch the network).
+ *
+ * AUTH-SAFETY: callers (ChannelProber) MUST treat an auth failure here as a
+ * circuit-breaker signal for the whole host — recorders lock accounts after a
+ * handful of bad logins (Hikvision ~5), and locking the owner's own NVR is a
+ * self-inflicted support incident.
+ */
+export interface OnvifDeviceInfo {
+    manufacturer: string | null;
+    model: string | null;
+    serialNumber: string | null;
+    firmwareVersion: string | null;
+}
+export interface OnvifProfile {
+    token: string;
+    name: string | null;
+    /** Video source token — distinct physical channels have distinct sources. */
+    videoSourceToken: string | null;
+}
+export type OnvifFailure = 'auth' | 'unreachable' | 'not_onvif' | 'fault';
+export declare class OnvifError extends Error {
+    kind: OnvifFailure;
+    constructor(kind: OnvifFailure, message: string);
+}
+export interface OnvifClientOptions {
+    host: string;
+    /** ONVIF HTTP port. Default 80 (cheap DVRs often use 8899 — callers try both). */
+    port?: number;
+    username: string;
+    password: string;
+    timeoutMs?: number;
+}
+/** Build the WS-Security UsernameToken header (PasswordDigest per ONVIF core). */
+export declare function buildUsernameToken(username: string, password: string, nonceRaw?: Buffer, created?: string): string;
+export declare function escapeXml(s: string): string;
+/** Decode the XML entities recorders emit inside tag text (Dahua returns
+ * `...?channel=1&subtype=0` — feeding the raw text into new URL/ffmpeg
+ * probes the wrong stream and persists an unusable pathTemplate). */
+export declare function decodeXmlEntities(s: string): string;
+/** First match group of a namespace-agnostic tag (entity-decoded), or null. */
+export declare function xmlTag(xml: string, localName: string): string | null;
+/** All matches (full element text) of a namespace-agnostic tag. */
+export declare function xmlTags(xml: string, localName: string): string[];
+export declare class OnvifClient {
+    private readonly host;
+    private readonly port;
+    private readonly username;
+    private readonly password;
+    private readonly timeoutMs;
+    private readonly poster;
+    /** Media service endpoint discovered via GetServices (falls back to device). */
+    private mediaXAddr;
+    constructor(options: OnvifClientOptions, poster?: HttpPoster);
+    deviceEndpoint(): string;
+    private soap;
+    /** Stable physical identity (the channelKey backbone). */
+    getDeviceInformation(): Promise<OnvifDeviceInfo>;
+    /** Resolve the media service endpoint (GetServices; fall back to device path). */
+    private resolveMediaXAddr;
+    private rewriteHost;
+    /** The recorder's REAL channel/profile list. */
+    getProfiles(): Promise<OnvifProfile[]>;
+    /** The ACTUAL RTSP URI for one profile (no guessed brand paths). */
+    getStreamUri(profileToken: string): Promise<string | null>;
+}
+//# sourceMappingURL=OnvifClient.d.ts.map

package/dist/OnvifClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OnvifClient.d.ts","sourceRoot":"","sources":["../src/OnvifClient.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,6EAA6E;IAC7E,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,aAAa,GAAG,WAAW,GAAG,OAAO,CAAC;AAE1E,qBAAa,UAAW,SAAQ,KAAK;IACnC,IAAI,EAAE,YAAY,CAAC;gBACP,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM;CAIhD;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,kFAAkF;AAClF,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAwB,EAClC,OAAO,GAAE,MAAiC,GACzC,MAAM,CAeR;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAO3C;AAWD;;qEAEqE;AACrE,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CASnD;AAED,+EAA+E;AAC/E,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGpE;AAED,mEAAmE;AACnE,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAShE;AAOD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,gFAAgF;IAChF,OAAO,CAAC,UAAU,CAAuB;gBAE7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,CAAC,EAAE,UAAU;IAS5D,cAAc,IAAI,MAAM;YAIV,IAAI;IAgClB,0DAA0D;IACpD,oBAAoB,IAAI,OAAO,CAAC,eAAe,CAAC;IAatD,kFAAkF;YACpE,iBAAiB;IA2B/B,OAAO,CAAC,WAAW;IAWnB,gDAAgD;IAC1C,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAiB5C,oEAAoE;IAC9D,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAoBjE"}