@trillboards/edge-sdk 0.2.4 → 0.2.7

package/dist/pairVerify.js

@@ -0,0 +1,296 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isNetworkError = isNetworkError;
+exports.classifyPairFailure = classifyPairFailure;
+exports.readVerifiableConfig = readVerifiableConfig;
+exports.verifyApiConnection = verifyApiConnection;
+exports.defaultLogDir = defaultLogDir;
+exports.appendPairLog = appendPairLog;
+exports.runVerifyConnection = runVerifyConnection;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const crypto_1 = require("crypto");
+const AudienceAnalyzeClient_1 = require("./AudienceAnalyzeClient");
+const NETWORK_ERRNO = new Set([
+    'ENOTFOUND',
+    'EAI_AGAIN',
+    'ECONNREFUSED',
+    'ECONNRESET',
+    'ETIMEDOUT',
+    'EHOSTUNREACH',
+    'ENETUNREACH',
+    'ENETDOWN',
+    'EPIPE',
+]);
+/** True when an error thrown by the HTTP transport is a connectivity failure. */
+function isNetworkError(err) {
+    const e = err;
+    if (!e)
+        return false;
+    if (e.code && NETWORK_ERRNO.has(e.code))
+        return true;
+    return /timed out|network|getaddrinfo|socket hang up/i.test(String(e.message ?? ''));
+}
+/**
+ * Classify a pairing failure. `thrown` is an error from the transport (the
+ * request never completed); `statusCode`/`error` come from a completed non-2xx
+ * response. The copy rules:
+ *   - Only a SERVER code rejection (400/404/410) may mention the code.
+ *   - Connectivity problems say the code is still valid (it was never spent).
+ */
+function classifyPairFailure(input) {
+    if (input.thrown !== undefined) {
+        if (isNetworkError(input.thrown)) {
+            const code = input.thrown?.code;
+            return {
+                kind: 'network',
+                message: `This computer can't reach Trillboards right now` +
+                    (code ? ` (${code})` : '') +
+                    `.\nCheck this machine's internet connection (Wi-Fi/ethernet, firewall, captive portal),\n` +
+                    `then run pairing again. Your code was NOT used — it stays valid until it expires.`,
+            };
+        }
+        const msg = input.thrown instanceof Error ? input.thrown.message : String(input.thrown);
+        return {
+            kind: 'server',
+            message: `Pairing hit an unexpected error: ${msg}\n` +
+                `Try again in a minute. Your code was NOT used.`,
+        };
+    }
+    const status = input.statusCode ?? 0;
+    if (status === 429) {
+        return {
+            kind: 'rate_limited',
+            message: `Too many pairing attempts from this network — wait a minute, then try again.\n` +
+                `Your code stays valid until it expires.`,
+        };
+    }
+    if (status === 400 || status === 404 || status === 410) {
+        return {
+            kind: 'bad_code',
+            message: `That code wasn't recognized — it may have expired (codes last about 30 minutes)\n` +
+                `or have a typo. Get a fresh code from the portal and try again.` +
+                (input.error ? `\n(Server said: ${input.error})` : ''),
+        };
+    }
+    return {
+        kind: 'server',
+        message: `Trillboards had a hiccup (HTTP ${status || '?'}). This is not a code problem —\n` +
+            `wait a minute and try again. Your code stays valid until it expires.` +
+            (input.error ? `\n(Server said: ${input.error})` : ''),
+    };
+}
+/**
+ * Extract the API base + one device token from a written config file. Accepts
+ * both shapes (multi-feed `cameras: []` and the single-camera back-compat
+ * top-level `deviceToken`), mirroring pair.command's count_feeds_missing_rtsp.
+ * Returns null when the file is missing/unreadable or holds no token.
+ */
+function readVerifiableConfig(configPath) {
+    let raw;
+    try {
+        raw = fs.readFileSync(configPath, 'utf8');
+    }
+    catch {
+        return null;
+    }
+    try {
+        const cfg = JSON.parse(raw);
+        const apiBaseUrl = String(cfg.apiBaseUrl || 'https://api.trillboards.com');
+        const cameras = Array.isArray(cfg.cameras) ? cfg.cameras : [];
+        const withToken = cameras.find((c) => c && typeof c.deviceToken === 'string' && c.deviceToken);
+        if (withToken) {
+            return {
+                apiBaseUrl,
+                deviceToken: String(withToken.deviceToken),
+                feedName: String(withToken.name || withToken.screenId || 'camera'),
+            };
+        }
+        if (typeof cfg.deviceToken === 'string' && cfg.deviceToken) {
+            return { apiBaseUrl, deviceToken: cfg.deviceToken, feedName: 'camera' };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Prove the pairing works end-to-end: an authenticated GET of this feed's
+ * sensing profile. Same endpoint + device-auth headers as
+ * SensingProfileClient.fetchProfile (deviceRequestAuth validates the token +
+ * nonce + timestamp) — but unlike that best-effort fetch, this one DISTINGUISHES
+ * failure classes, because the whole point is telling the operator the truth.
+ */
+async function verifyApiConnection(config, poster = AudienceAnalyzeClient_1.defaultHttpPoster) {
+    const base = config.apiBaseUrl.replace(/\/+$/, '');
+    const endpoint = `${base}/v2/earner/cameras/sensing-profile`;
+    const headers = {
+        Accept: 'application/json',
+        'X-Device-Token': config.deviceToken,
+        'X-Trillboard-Device-Token': config.deviceToken,
+        'X-Device-Timestamp': String(Date.now()),
+        'X-Device-Nonce': (0, crypto_1.randomUUID)(),
+    };
+    let result;
+    try {
+        result = await poster(endpoint, { method: 'GET', headers, timeoutMs: 15000 }, '');
+    }
+    catch (err) {
+        const code = err?.code;
+        return {
+            ok: false,
+            kind: 'network',
+            message: `Paired and saved, but this computer can't reach Trillboards right now` +
+                (code ? ` (${code})` : '') +
+                `.\nYour pairing is SAVED — fix this machine's internet connection and run the\n` +
+                `pairing helper again. You will NOT need a new code.`,
+        };
+    }
+    if (result.statusCode >= 200 && result.statusCode < 300) {
+        return { ok: true, kind: 'verified', message: '', statusCode: result.statusCode };
+    }
+    if (result.statusCode === 401 || result.statusCode === 403) {
+        return {
+            ok: false,
+            kind: 'auth',
+            statusCode: result.statusCode,
+            message: `Trillboards rejected this machine's saved pairing (HTTP ${result.statusCode}).\n` +
+                `The pairing may have been revoked. Generate a fresh code in the portal and pair again.`,
+        };
+    }
+    return {
+        ok: false,
+        kind: 'server',
+        statusCode: result.statusCode,
+        message: `Paired and saved, but the connection check got HTTP ${result.statusCode} from Trillboards.\n` +
+            `Your pairing is SAVED — wait a minute and run the pairing helper again.`,
+    };
+}
+// ─── 3. Rolling pairing log ──────────────────────────────────────────────────
+/** Rotate at 512 KB, keep one previous generation — enough for diagnostics. */
+const LOG_MAX_BYTES = 512 * 1024;
+const LOG_FILE = 'pairing.log';
+/**
+ * Platform log dir, matching where the installers already put logs:
+ *   macOS   ~/Library/Logs/Trillboards            (postinstall creates it)
+ *   Windows %LOCALAPPDATA%\Trillboards\logs
+ *   other   ~/.trillboards/logs                   (Docker/systemd installs)
+ * Injectable platform/env for tests.
+ */
+function defaultLogDir(platform = process.platform, env = process.env, homedir = os.homedir()) {
+    if (platform === 'darwin')
+        return path.join(homedir, 'Library', 'Logs', 'Trillboards');
+    if (platform === 'win32') {
+        const localAppData = env.LOCALAPPDATA || path.join(homedir, 'AppData', 'Local');
+        return path.join(localAppData, 'Trillboards', 'logs');
+    }
+    return path.join(homedir, '.trillboards', 'logs');
+}
+/**
+ * Append timestamped lines to the rolling pairing log. Fully best-effort: a
+ * logging failure must never fail pairing. Returns the log file path (for the
+ * "details saved to …" hint) or null when the write failed.
+ * NEVER pass claim codes or device tokens in `lines`.
+ */
+function appendPairLog(logDir, lines) {
+    try {
+        fs.mkdirSync(logDir, { recursive: true });
+        const file = path.join(logDir, LOG_FILE);
+        try {
+            const st = fs.statSync(file);
+            if (st.size > LOG_MAX_BYTES)
+                fs.renameSync(file, `${file}.1`);
+        }
+        catch {
+            /* first write */
+        }
+        const stamp = new Date().toISOString();
+        const text = (Array.isArray(lines) ? lines : [lines])
+            .map((l) => `[${stamp}] ${l}`)
+            .join('\n');
+        fs.appendFileSync(file, text + '\n');
+        return file;
+    }
+    catch {
+        return null;
+    }
+}
+// ─── CLI entry: `trillboards-edge verify-connection` ─────────────────────────
+/**
+ * Exit-code contract (the install wrappers branch on these — keep stable):
+ *   0  verified — config present, API reachable, token accepted
+ *   2  network  — config present but Trillboards is unreachable from here
+ *   3  auth     — API reachable but the saved pairing was rejected
+ *   4  no usable config (missing file / no device token)
+ *   5  server   — API responded with an unexpected status
+ */
+async function runVerifyConnection(args) {
+    const cfgIdx = args.indexOf('--config');
+    const configPath = cfgIdx >= 0 && args[cfgIdx + 1] ? args[cfgIdx + 1] : 'trillboards.config.json';
+    const asJson = args.includes('--json');
+    const resolved = path.resolve(configPath);
+    const cfg = readVerifiableConfig(resolved);
+    if (!cfg) {
+        if (asJson)
+            console.log(JSON.stringify({ ok: false, kind: 'no_config' }));
+        else
+            console.error(`No paired config with a device token at: ${resolved}`);
+        process.exit(4);
+        return;
+    }
+    const res = await verifyApiConnection(cfg);
+    appendPairLog(defaultLogDir(), `verify-connection: ${res.kind}${res.statusCode ? ` (HTTP ${res.statusCode})` : ''}`);
+    if (asJson) {
+        console.log(JSON.stringify({ ok: res.ok, kind: res.kind, statusCode: res.statusCode ?? null }));
+    }
+    else if (res.ok) {
+        console.log(`Connected to Trillboards — pairing for "${cfg.feedName}" is valid.`);
+    }
+    else {
+        console.error(res.message);
+    }
+    const exitByKind = {
+        verified: 0,
+        network: 2,
+        auth: 3,
+        server: 5,
+        no_config: 4,
+    };
+    process.exit(exitByKind[res.kind]);
+}
+//# sourceMappingURL=pairVerify.js.map

package/dist/pairVerify.js.map

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

package/dist/qrScanner.d.ts

@@ -0,0 +1,33 @@
+/**
+ * qrScanner — decode a Trillboards claim code from a QR image so the connector's
+ * `pair` flow can be driven by SCANNING the portal's Install-step QR instead of
+ * hand-typing the code. The portal renders that QR via `<QrCodeDisplay
+ * value={claimCode} />`, so the QR payload IS the raw claim code — we return it
+ * verbatim and let PairClient.normalizeClaimCode canonicalize it.
+ *
+ * Pure-JS and only reached via cli.ts's lazy `require('./qrScanner')` inside the
+ * `pair --qr` branch, so the common `pair --code` entrypoint (the macOS/edge
+ * "cloud-sense" installer surface) never pulls in the image-decode deps. Supports
+ * PNG (a screenshot / "save image" of the portal QR) and JPEG (a phone photo).
+ */
+export interface DecodedImage {
+    /** RGBA pixels, 4 bytes per pixel. */
+    data: Uint8ClampedArray;
+    width: number;
+    height: number;
+}
+/**
+ * Decode a PNG or JPEG buffer to RGBA pixels, or null for an unsupported format
+ * (sniffed by magic bytes, not file extension, so a mislabeled file still works).
+ */
+export declare function decodeImageToRgba(buf: Buffer): DecodedImage | null;
+/** Decode the QR payload from an image buffer, or null if unsupported / no QR found. */
+export declare function decodeQrFromImageBuffer(buf: Buffer): string | null;
+/**
+ * Read an image file (a PNG/JPEG screenshot or photo of the portal's claim-code
+ * QR) and return the embedded claim code. Throws a clear, owner-facing error for
+ * a missing file, an unsupported format, or an image with no QR — so the CLI can
+ * print actionable guidance instead of a stack trace.
+ */
+export declare function decodeClaimCodeFromImageFile(filePath: string): Promise<string>;
+//# sourceMappingURL=qrScanner.d.ts.map

package/dist/qrScanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qrScanner.d.ts","sourceRoot":"","sources":["../src/qrScanner.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAaD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAUlE;AAED,wFAAwF;AACxF,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKlE;AAED;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAepF"}

package/dist/qrScanner.js

@@ -0,0 +1,103 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeImageToRgba = decodeImageToRgba;
+exports.decodeQrFromImageBuffer = decodeQrFromImageBuffer;
+exports.decodeClaimCodeFromImageFile = decodeClaimCodeFromImageFile;
+const fs = __importStar(require("fs"));
+const jsqr_1 = __importDefault(require("jsqr"));
+const pngjs_1 = require("pngjs");
+const jpeg = __importStar(require("jpeg-js"));
+const PNG_MAGIC = [0x89, 0x50, 0x4e, 0x47]; // "\x89PNG"
+const JPEG_MAGIC = [0xff, 0xd8, 0xff];
+function startsWith(buf, sig) {
+    if (buf.length < sig.length)
+        return false;
+    for (let i = 0; i < sig.length; i += 1) {
+        if (buf[i] !== sig[i])
+            return false;
+    }
+    return true;
+}
+/**
+ * Decode a PNG or JPEG buffer to RGBA pixels, or null for an unsupported format
+ * (sniffed by magic bytes, not file extension, so a mislabeled file still works).
+ */
+function decodeImageToRgba(buf) {
+    if (startsWith(buf, PNG_MAGIC)) {
+        const png = pngjs_1.PNG.sync.read(buf); // always RGBA
+        return { data: new Uint8ClampedArray(png.data), width: png.width, height: png.height };
+    }
+    if (startsWith(buf, JPEG_MAGIC)) {
+        const img = jpeg.decode(buf, { useTArray: true, formatAsRGBA: true, maxMemoryUsageInMB: 512 });
+        return { data: new Uint8ClampedArray(img.data), width: img.width, height: img.height };
+    }
+    return null;
+}
+/** Decode the QR payload from an image buffer, or null if unsupported / no QR found. */
+function decodeQrFromImageBuffer(buf) {
+    const img = decodeImageToRgba(buf);
+    if (!img)
+        return null;
+    const result = (0, jsqr_1.default)(img.data, img.width, img.height);
+    return result && typeof result.data === 'string' ? result.data : null;
+}
+/**
+ * Read an image file (a PNG/JPEG screenshot or photo of the portal's claim-code
+ * QR) and return the embedded claim code. Throws a clear, owner-facing error for
+ * a missing file, an unsupported format, or an image with no QR — so the CLI can
+ * print actionable guidance instead of a stack trace.
+ */
+async function decodeClaimCodeFromImageFile(filePath) {
+    let buf;
+    try {
+        buf = await fs.promises.readFile(filePath);
+    }
+    catch {
+        throw new Error(`could not read image file: ${filePath}`);
+    }
+    if (!decodeImageToRgba(buf)) {
+        throw new Error(`unsupported image format (save the QR as a PNG or JPEG): ${filePath}`);
+    }
+    const code = decodeQrFromImageBuffer(buf);
+    if (!code || !code.trim()) {
+        throw new Error(`no QR code found in image: ${filePath}`);
+    }
+    return code.trim();
+}
+//# sourceMappingURL=qrScanner.js.map

package/dist/qrScanner.js.map

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

package/dist/runtimePaths.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Resolve the FFmpeg binary for connector run modes.
+ *
+ * macOS LaunchAgents and Windows scheduled tasks can start with a minimal PATH,
+ * so the packaged connector should prefer the FFmpeg shipped beside its bundled
+ * Node runtime. Operators can still override with an explicit config/CLI path
+ * or TRILLBOARDS_FFMPEG.
+ */
+export declare function resolveFfmpegBinaryPath(...configuredPaths: Array<string | null | undefined>): string;
+//# sourceMappingURL=runtimePaths.d.ts.map

package/dist/runtimePaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimePaths.d.ts","sourceRoot":"","sources":["../src/runtimePaths.ts"],"names":[],"mappings":"AAgBA;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,eAAe,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GACnD,MAAM,CAmBR"}

package/dist/runtimePaths.js

@@ -0,0 +1,79 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveFfmpegBinaryPath = resolveFfmpegBinaryPath;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const FFMPEG_BINARY = process.platform === 'win32' ? 'ffmpeg.exe' : 'ffmpeg';
+function firstExistingFile(paths) {
+    for (const candidate of new Set(paths)) {
+        try {
+            if (fs.statSync(candidate).isFile())
+                return candidate;
+        }
+        catch {
+            // keep looking
+        }
+    }
+    return undefined;
+}
+/**
+ * Resolve the FFmpeg binary for connector run modes.
+ *
+ * macOS LaunchAgents and Windows scheduled tasks can start with a minimal PATH,
+ * so the packaged connector should prefer the FFmpeg shipped beside its bundled
+ * Node runtime. Operators can still override with an explicit config/CLI path
+ * or TRILLBOARDS_FFMPEG.
+ */
+function resolveFfmpegBinaryPath(...configuredPaths) {
+    for (const configuredPath of configuredPaths) {
+        const trimmed = configuredPath?.trim();
+        if (trimmed)
+            return trimmed;
+    }
+    const envPath = process.env.TRILLBOARDS_FFMPEG?.trim();
+    if (envPath)
+        return envPath;
+    const bundled = firstExistingFile([
+        // Installed connector: edge/bin/node and edge/bin/ffmpeg are siblings.
+        path.join(path.dirname(process.execPath), FFMPEG_BINARY),
+        // dist/runtimePaths.js in the packaged connector: edge/lib/edge-sdk/dist.
+        path.resolve(__dirname, '../../../bin', FFMPEG_BINARY),
+        // In-package fallback for future layouts: edge-sdk/dist next to edge-sdk/bin.
+        path.resolve(__dirname, '../bin', FFMPEG_BINARY),
+    ]);
+    return bundled || FFMPEG_BINARY;
+}
+//# sourceMappingURL=runtimePaths.js.map

package/dist/runtimePaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimePaths.js","sourceRoot":"","sources":["../src/runtimePaths.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,0DAqBC;AA7CD,uCAAyB;AACzB,2CAA6B;AAE7B,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC;AAE7E,SAAS,iBAAiB,CAAC,KAAe;IACxC,KAAK,MAAM,SAAS,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE;gBAAE,OAAO,SAAS,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,uBAAuB,CACrC,GAAG,eAAiD;IAEpD,KAAK,MAAM,cAAc,IAAI,eAAe,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,cAAc,EAAE,IAAI,EAAE,CAAC;QACvC,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;IAC9B,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAC;IACvD,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAE5B,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,uEAAuE;QACvE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;QACxD,0EAA0E;QAC1E,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,EAAE,aAAa,CAAC;QACtD,8EAA8E;QAC9E,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,aAAa,CAAC;KACjD,CAAC,CAAC;IAEH,OAAO,OAAO,IAAI,aAAa,CAAC;AAClC,CAAC"}

package/dist/sensingRunMode.d.ts

@@ -0,0 +1,86 @@
+import { CloudSensingManager, type ResolvedFeed } from './CloudSensingManager';
+import type { SharedFrameSource } from './MosaicSource';
+import type { EdgeAgentConfig } from './config';
+/**
+ * Optional cross-rail mosaic-pull sharing: the combined `sense` entrypoint passes
+ * a `sharedSources` registry so the VLM rail attaches to the SAME SharedFrameSource
+ * the on-device ONNX zoo rail uses — one RTSP pull per mosaic source feeds both.
+ */
+export interface SensingManagerOpts {
+    sharedSources?: Map<string, SharedFrameSource>;
+    /** Persist DHCP-recovered recorder addresses back to this local config. */
+    configPath?: string;
+    /** Reuse a caller-owned recovery coordinator across shared sensing rails. */
+    streamUrlResolver?: (feed: ResolvedFeed, currentUrl: string, error: Error) => Promise<string | null>;
+}
+/**
+ * The lifecycle surface the auto-sense supervisor drives. `CloudSensingManager`
+ * already satisfies it: `start()` opens cameras + runs the capture loops;
+ * `stop()` clears the loop timers + closes cameras (a clean teardown that a
+ * later `start()` resumes from). Narrowed to just these two so the supervisor
+ * can hold either a real manager or a test fake.
+ */
+export interface SensingManager {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * How many frames the ON-DEVICE runtime has produced a result for so far this
+     * run (`start()` resets the count). NOT the total analysis count: a frame the
+     * local provider threw on and the cloud answered — `cloudFallbackOnError`, or
+     * an escalation — is an analysis but proves nothing about the local runtime.
+     *
+     * OPTIONAL, and structurally satisfied by `CloudSensingManager` already — no
+     * manager code changes to supply it. The auto-sense supervisor reads it for
+     * one reason: `litert-lm serve` is `http.server.HTTPServer`, the SERIAL one,
+     * so while WE are generating it cannot answer its own readiness endpoint
+     * either. A probe that goes unanswered in that window says nothing about the
+     * model — but an on-device inference that COMPLETED proves it is alive, which
+     * is the evidence the supervisor actually needs. See
+     * `AutoSenseSupervisor.recheck`.
+     */
+    getSensingHealth?(): {
+        localInferences: number;
+    };
+}
+/** A console-shaped sink so callers can capture/redirect the build-time logs. */
+export interface SensingIo {
+    log: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+}
+/** Default sink: the real console (what the CLI entrypoints use). */
+export declare const consoleIo: SensingIo;
+/**
+ * The error logged (and `null` returned) when a build is attempted with no
+ * camera feeds configured. Exported so the supervisor + CLI surface the SAME
+ * message and so tests can assert on it.
+ */
+export declare const NO_FEEDS_MESSAGE: string;
+/**
+ * How often the connector prints the one line that answers "why is my
+ * 16-camera store only sampling every N seconds?". Long enough not to spam a
+ * 24/7 log, short enough that an operator watching an install sees it.
+ */
+export declare const SENSING_HEALTH_LOG_INTERVAL_MS: number;
+/**
+ * The operator-facing degradation line. A machine that cannot analyze 16
+ * cameras every 30 s is not a bug to hide — it is a capacity fact to state, in
+ * the terms an operator can act on: how often each camera is actually looked
+ * at, how many analyses/minute this machine sustains, and where the rest went.
+ */
+export declare function formatSensingHealth(health: ReturnType<CloudSensingManager['getSensingHealth']>): string;
+/**
+ * Build (but do NOT start) the thin cloud-sensing manager: RTSP frame → POST
+ * /v2/earner/audience-analyze (cloud VLM does the inference). Returns `null`
+ * after logging NO_FEEDS_MESSAGE when no feeds are configured — the caller
+ * decides how to surface that (the CLI + the supervisor both exit 1).
+ */
+export declare function buildCloudSensingManager(config: EdgeAgentConfig, io?: SensingIo, opts?: SensingManagerOpts): CloudSensingManager | null;
+/**
+ * Build (but do NOT start) the on-device LOCAL-sensing manager: RTSP frame →
+ * LOCAL VLM (LiteRT-LM serving Gemma) → POST the STRUCTURED result as
+ * `preAnalyzed` (skips the cloud VLM → no Vertex cost). Returns `null` after
+ * logging NO_FEEDS_MESSAGE when no feeds are configured.
+ */
+export declare function buildLocalSensingManager(config: EdgeAgentConfig, io?: SensingIo, opts?: SensingManagerOpts): CloudSensingManager | null;
+//# sourceMappingURL=sensingRunMode.d.ts.map

package/dist/sensingRunMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensingRunMode.d.ts","sourceRoot":"","sources":["../src/sensingRunMode.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EAInB,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAMhD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC/C,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,CAClB,IAAI,EAAE,YAAY,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,KAAK,KACT,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC7B;AA2CD;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB;;;;;;;;;;;;;;OAcG;IACH,gBAAgB,CAAC,IAAI;QAAE,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;CAClD;AAED,iFAAiF;AACjF,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,qEAAqE;AACrE,eAAO,MAAM,SAAS,EAAE,SAIvB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,QAEgD,CAAC;AAE9E;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,QAAgB,CAAC;AA4C5D;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,CAAC,GAC1D,MAAM,CAqBR;AAoDD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,eAAe,EACvB,EAAE,GAAE,SAAqB,EACzB,IAAI,CAAC,EAAE,kBAAkB,GACxB,mBAAmB,GAAG,IAAI,CA6D5B;AAqCD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,eAAe,EACvB,EAAE,GAAE,SAAqB,EACzB,IAAI,CAAC,EAAE,kBAAkB,GACxB,mBAAmB,GAAG,IAAI,CAmF5B"}