@trillboards/edge-core 0.2.1 → 0.2.3

package/dist/ModelManager.js

@@ -0,0 +1,580 @@
+"use strict";
+/**
+ * ModelManager — Model lifecycle management with OTA (over-the-air) updates.
+ * Port of CTV agent's ModelManager.kt (387 lines), adapted for Node.js/ONNX.
+ *
+ * Manages registration, version-checking, and atomic download of ML model files.
+ * Downloads use a .tmp + rename pattern to prevent corrupted model loads.
+ * The version check timer is unref()'d so it does not keep the process alive.
+ *
+ * Events emitted:
+ *   'modelUpdated'      — { name, oldVersion, newVersion, path }
+ *   'updateAvailable'   — { name, currentVersion, availableVersion }
+ *   'downloadProgress'  — { name, bytesDownloaded, totalBytes, percent }
+ *   'downloadError'     — { name, error }
+ *   'checkComplete'     — { checkedCount, updatesAvailable }
+ */
+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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelManager = void 0;
+const events_1 = require("events");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const https = __importStar(require("https"));
+const http = __importStar(require("http"));
+const crypto = __importStar(require("crypto"));
+// ─── Implementation ─────────────────────────────────────────────────────────
+class ModelManager extends events_1.EventEmitter {
+    constructor(options) {
+        super();
+        this.models = new Map();
+        this.checkTimer = null;
+        this.downloading = new Set();
+        this.options = {
+            modelsDir: options.modelsDir,
+            apiBaseUrl: options.apiBaseUrl.replace(/\/+$/, ''),
+            deviceFingerprint: options.deviceFingerprint,
+            checkIntervalMs: options.checkIntervalMs ?? 3600000,
+            maxConcurrentDownloads: options.maxConcurrentDownloads ?? 1,
+            autoUpdate: options.autoUpdate ?? true,
+            requestTimeoutMs: options.requestTimeoutMs ?? 30000,
+            downloadTimeoutMs: options.downloadTimeoutMs ?? 300000,
+            maxRedirects: options.maxRedirects ?? 5,
+        };
+        this.manifestPath = path.join(this.options.modelsDir, 'models_manifest.json');
+    }
+    // ─── Lifecycle ──────────────────────────────────────────────────────────────
+    /**
+     * Initialize — ensure models directory exists, load manifest, compute
+     * hashes for any registered model files already on disk.
+     */
+    async initialize() {
+        fs.mkdirSync(this.options.modelsDir, { recursive: true });
+        this.loadManifest();
+        // For every model that was loaded from the manifest, verify the file
+        // is still on disk and recompute its hash if needed.
+        const verifyPromises = [];
+        for (const [name, info] of this.models) {
+            verifyPromises.push(this.verifyModelOnDisk(name, info));
+        }
+        await Promise.all(verifyPromises);
+    }
+    /**
+     * Start periodic version checking.  The timer is unref()'d so it does not
+     * prevent the Node.js process from exiting naturally.
+     */
+    start() {
+        if (this.checkTimer)
+            return;
+        this.checkTimer = setInterval(() => {
+            this.checkForUpdates().catch((err) => {
+                this.emit('downloadError', {
+                    name: '*',
+                    error: `Periodic check failed: ${String(err)}`,
+                });
+            });
+        }, this.options.checkIntervalMs);
+        // unref() so this timer alone does not keep the process alive
+        this.checkTimer.unref();
+    }
+    /**
+     * Stop periodic checking and cancel any in-flight state tracking.
+     */
+    stop() {
+        if (this.checkTimer) {
+            clearInterval(this.checkTimer);
+            this.checkTimer = null;
+        }
+    }
+    // ─── Registration ───────────────────────────────────────────────────────────
+    /**
+     * Register a model to track.  Called during EdgeAgent init for each model type.
+     * If the file exists on disk, its SHA-256 is computed immediately.
+     * If the manifest already has version info for this name, it is merged.
+     */
+    registerModel(name, filePath) {
+        const absPath = path.resolve(filePath);
+        const existing = this.models.get(name);
+        const info = {
+            name,
+            version: existing?.version ?? '0.0.0',
+            filePath: absPath,
+            sha256: existing?.sha256 ?? '',
+            sizeBytes: existing?.sizeBytes ?? 0,
+            lastChecked: existing?.lastChecked ?? 0,
+            lastUpdated: existing?.lastUpdated ?? 0,
+        };
+        // If the file exists, populate size synchronously (hash is async, done in initialize)
+        if (fs.existsSync(absPath)) {
+            const stat = fs.statSync(absPath);
+            info.sizeBytes = stat.size;
+        }
+        this.models.set(name, info);
+    }
+    // ─── Update Checking ───────────────────────────────────────────────────────
+    /**
+     * Check for updates for all registered models by calling the backend API.
+     * Endpoint: GET /v1/federated/models?deviceFingerprint=X&modelType=Y
+     *
+     * Returns the list of ModelVersionResponse objects for which a newer
+     * version is available.  If autoUpdate is enabled, downloads are
+     * initiated automatically (respecting maxConcurrentDownloads).
+     */
+    async checkForUpdates() {
+        const updates = [];
+        for (const [name, info] of this.models) {
+            try {
+                const encoded = encodeURIComponent(this.options.deviceFingerprint);
+                const apiPath = `/v1/federated/models?deviceFingerprint=${encoded}&modelType=${encodeURIComponent(name)}`;
+                const raw = await this.apiGet(apiPath);
+                if (!raw || typeof raw !== 'object')
+                    continue;
+                // The API may return a single object or an array; normalize to single.
+                const response = Array.isArray(raw) ? raw[0] : raw;
+                if (!response || !response.version)
+                    continue;
+                info.lastChecked = Date.now();
+                if (this.isNewerVersion(response.version, info.version)) {
+                    updates.push(response);
+                    this.emit('updateAvailable', {
+                        name,
+                        currentVersion: info.version,
+                        availableVersion: response.version,
+                    });
+                }
+            }
+            catch (err) {
+                // A failed check for one model must not abort the others
+                this.emit('downloadError', {
+                    name,
+                    error: `Version check failed: ${String(err)}`,
+                });
+            }
+        }
+        this.emit('checkComplete', {
+            checkedCount: this.models.size,
+            updatesAvailable: updates.length,
+        });
+        // Persist lastChecked timestamps
+        this.saveManifest();
+        // Auto-download if enabled
+        if (this.options.autoUpdate) {
+            for (const update of updates) {
+                if (this.downloading.size >= this.options.maxConcurrentDownloads)
+                    break;
+                // Fire-and-forget — errors are emitted as events
+                this.downloadUpdate(update).catch(() => {
+                    // Error already emitted inside downloadUpdate
+                });
+            }
+        }
+        return updates;
+    }
+    /**
+     * Download a specific model update.
+     *
+     * 1. Download to a .tmp file alongside the target path
+     * 2. Verify SHA-256 checksum matches the expected value
+     * 3. Atomic swap: rename .tmp -> target .onnx path
+     * 4. Update manifest with new version info
+     * 5. Emit 'modelUpdated' event
+     *
+     * Returns true if the model was successfully downloaded and verified.
+     */
+    async downloadUpdate(update) {
+        const modelName = update.name;
+        const info = this.models.get(modelName);
+        if (!info) {
+            this.emit('downloadError', {
+                name: modelName,
+                error: `Model '${modelName}' is not registered`,
+            });
+            return false;
+        }
+        if (this.downloading.has(modelName)) {
+            this.emit('downloadError', {
+                name: modelName,
+                error: `Download already in progress for '${modelName}'`,
+            });
+            return false;
+        }
+        this.downloading.add(modelName);
+        const tmpPath = info.filePath + '.tmp';
+        const oldVersion = info.version;
+        try {
+            // Ensure parent directory exists
+            const dir = path.dirname(info.filePath);
+            fs.mkdirSync(dir, { recursive: true });
+            // Step 1: Download to .tmp file
+            await this.downloadFile(update.downloadUrl, tmpPath, update.sizeBytes, modelName);
+            // Step 2: Verify SHA-256
+            const actualHash = await this.computeFileHash(tmpPath);
+            if (actualHash !== update.sha256) {
+                // Hash mismatch — clean up and report
+                this.cleanupTmpFile(tmpPath);
+                const msg = `SHA-256 mismatch for '${modelName}': expected ${update.sha256}, got ${actualHash}`;
+                this.emit('downloadError', { name: modelName, error: msg });
+                return false;
+            }
+            // Step 3: Atomic swap — rename .tmp to the target path
+            fs.renameSync(tmpPath, info.filePath);
+            // Step 4: Update model info and manifest
+            const stat = fs.statSync(info.filePath);
+            info.version = update.version;
+            info.sha256 = update.sha256;
+            info.sizeBytes = stat.size;
+            info.lastUpdated = Date.now();
+            info.lastChecked = Date.now();
+            this.saveManifest();
+            // Step 5: Emit success event
+            this.emit('modelUpdated', {
+                name: modelName,
+                oldVersion,
+                newVersion: update.version,
+                path: info.filePath,
+            });
+            return true;
+        }
+        catch (err) {
+            this.cleanupTmpFile(tmpPath);
+            this.emit('downloadError', {
+                name: modelName,
+                error: `Download failed for '${modelName}': ${String(err)}`,
+            });
+            return false;
+        }
+        finally {
+            this.downloading.delete(modelName);
+        }
+    }
+    // ─── Query Methods ──────────────────────────────────────────────────────────
+    /**
+     * Get info about a registered model.  Returns null if not registered.
+     */
+    getModel(name) {
+        return this.models.get(name) ?? null;
+    }
+    /**
+     * Get all registered models.
+     */
+    getModels() {
+        return Array.from(this.models.values());
+    }
+    /**
+     * Check if a model's file exists on disk.
+     */
+    hasModel(name) {
+        const info = this.models.get(name);
+        if (!info)
+            return false;
+        return fs.existsSync(info.filePath);
+    }
+    /**
+     * Check if a download is currently in progress for a model.
+     */
+    isDownloading(name) {
+        return this.downloading.has(name);
+    }
+    // ─── Private: File Hashing ──────────────────────────────────────────────────
+    /**
+     * Compute the SHA-256 hex digest of a file using a streaming reader.
+     */
+    computeFileHash(filePath) {
+        return new Promise((resolve, reject) => {
+            const hash = crypto.createHash('sha256');
+            const stream = fs.createReadStream(filePath);
+            stream.on('data', (chunk) => hash.update(chunk));
+            stream.on('end', () => resolve(hash.digest('hex')));
+            stream.on('error', reject);
+        });
+    }
+    // ─── Private: File Download ─────────────────────────────────────────────────
+    /**
+     * Download a file from a URL to a local destination path.
+     * Follows HTTP redirects (up to maxRedirects), emits progress events,
+     * and enforces a download timeout.
+     */
+    downloadFile(url, dest, expectedSize, modelName) {
+        return this.downloadFileWithRedirects(url, dest, expectedSize, modelName, 0);
+    }
+    downloadFileWithRedirects(url, dest, expectedSize, modelName, redirectCount) {
+        return new Promise((resolve, reject) => {
+            if (redirectCount > this.options.maxRedirects) {
+                reject(new Error(`Too many redirects (>${this.options.maxRedirects}) downloading ${modelName}`));
+                return;
+            }
+            const isHttps = url.startsWith('https://');
+            const transport = isHttps ? https : http;
+            const parsedUrl = new URL(url);
+            const requestOptions = {
+                hostname: parsedUrl.hostname,
+                port: parsedUrl.port || (isHttps ? 443 : 80),
+                path: parsedUrl.pathname + parsedUrl.search,
+                method: 'GET',
+                timeout: this.options.downloadTimeoutMs,
+                headers: {
+                    'User-Agent': `TrillboardsEdgeSDK/1.0 (${this.options.deviceFingerprint})`,
+                },
+            };
+            const req = transport.request(requestOptions, (res) => {
+                // Handle redirects
+                if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+                    // Drain the response to free the socket
+                    res.resume();
+                    const redirectUrl = res.headers.location.startsWith('http')
+                        ? res.headers.location
+                        : new URL(res.headers.location, url).toString();
+                    this.downloadFileWithRedirects(redirectUrl, dest, expectedSize, modelName, redirectCount + 1)
+                        .then(resolve)
+                        .catch(reject);
+                    return;
+                }
+                if (!res.statusCode || res.statusCode < 200 || res.statusCode >= 300) {
+                    // Drain and reject
+                    res.resume();
+                    reject(new Error(`HTTP ${res.statusCode} downloading '${modelName}' from ${url}`));
+                    return;
+                }
+                const totalBytes = expectedSize
+                    ?? (res.headers['content-length'] ? parseInt(res.headers['content-length'], 10) : 0);
+                let bytesDownloaded = 0;
+                const fileStream = fs.createWriteStream(dest);
+                res.on('data', (chunk) => {
+                    bytesDownloaded += chunk.length;
+                    const percent = totalBytes > 0
+                        ? Math.min(100, Math.round((bytesDownloaded / totalBytes) * 100))
+                        : 0;
+                    this.emit('downloadProgress', {
+                        name: modelName,
+                        bytesDownloaded,
+                        totalBytes,
+                        percent,
+                    });
+                });
+                res.pipe(fileStream);
+                fileStream.on('finish', () => {
+                    fileStream.close(() => resolve());
+                });
+                fileStream.on('error', (err) => {
+                    fileStream.close(() => {
+                        this.cleanupTmpFile(dest);
+                        reject(err);
+                    });
+                });
+                res.on('error', (err) => {
+                    fileStream.close(() => {
+                        this.cleanupTmpFile(dest);
+                        reject(err);
+                    });
+                });
+            });
+            req.on('timeout', () => {
+                req.destroy();
+                this.cleanupTmpFile(dest);
+                reject(new Error(`Download timeout (${this.options.downloadTimeoutMs}ms) for '${modelName}'`));
+            });
+            req.on('error', (err) => {
+                this.cleanupTmpFile(dest);
+                reject(err);
+            });
+            req.end();
+        });
+    }
+    // ─── Private: Manifest Persistence ──────────────────────────────────────────
+    /**
+     * Load model manifest from disk.  If the file does not exist or is corrupt,
+     * start with an empty manifest — never crash.
+     */
+    loadManifest() {
+        try {
+            if (!fs.existsSync(this.manifestPath))
+                return;
+            const raw = fs.readFileSync(this.manifestPath, 'utf-8');
+            const data = JSON.parse(raw);
+            if (!data || typeof data !== 'object' || !data.models)
+                return;
+            for (const [name, entry] of Object.entries(data.models)) {
+                if (!entry || typeof entry !== 'object')
+                    continue;
+                // If the model is already registered (via registerModel before initialize),
+                // merge manifest info into it.  Otherwise create a placeholder entry.
+                const existing = this.models.get(name);
+                if (existing) {
+                    existing.version = entry.version || existing.version;
+                    existing.sha256 = entry.sha256 || existing.sha256;
+                    existing.lastUpdated = entry.lastUpdated || existing.lastUpdated;
+                }
+                else {
+                    // Model not yet registered — store manifest data; filePath will be
+                    // set when registerModel is called later.
+                    this.models.set(name, {
+                        name,
+                        version: entry.version || '0.0.0',
+                        filePath: '',
+                        sha256: entry.sha256 || '',
+                        sizeBytes: 0,
+                        lastChecked: data.lastChecked || 0,
+                        lastUpdated: entry.lastUpdated || 0,
+                    });
+                }
+            }
+        }
+        catch {
+            // Corrupt manifest — start fresh, never crash
+            console.warn(`[ModelManager] Corrupt manifest at ${this.manifestPath}, starting fresh`);
+        }
+    }
+    /**
+     * Save the current model state to the manifest file on disk.
+     * Uses atomic write: write to .tmp, then rename.
+     */
+    saveManifest() {
+        const models = {};
+        let lastChecked = 0;
+        for (const [name, info] of this.models) {
+            models[name] = {
+                version: info.version,
+                sha256: info.sha256,
+                lastUpdated: info.lastUpdated,
+            };
+            if (info.lastChecked > lastChecked) {
+                lastChecked = info.lastChecked;
+            }
+        }
+        const data = { models, lastChecked };
+        const tmpPath = this.manifestPath + '.tmp';
+        try {
+            fs.writeFileSync(tmpPath, JSON.stringify(data, null, 2), 'utf-8');
+            fs.renameSync(tmpPath, this.manifestPath);
+        }
+        catch (err) {
+            console.warn(`[ModelManager] Failed to save manifest: ${String(err)}`);
+            this.cleanupTmpFile(tmpPath);
+        }
+    }
+    // ─── Private: API Requests ──────────────────────────────────────────────────
+    /**
+     * Make an HTTPS GET request to the backend API and return parsed JSON.
+     */
+    apiGet(apiPath) {
+        return new Promise((resolve, reject) => {
+            const fullUrl = this.options.apiBaseUrl + apiPath;
+            const isHttps = fullUrl.startsWith('https://');
+            const transport = isHttps ? https : http;
+            const parsedUrl = new URL(fullUrl);
+            const requestOptions = {
+                hostname: parsedUrl.hostname,
+                port: parsedUrl.port || (isHttps ? 443 : 80),
+                path: parsedUrl.pathname + parsedUrl.search,
+                method: 'GET',
+                timeout: this.options.requestTimeoutMs,
+                headers: {
+                    'Accept': 'application/json',
+                    'User-Agent': `TrillboardsEdgeSDK/1.0 (${this.options.deviceFingerprint})`,
+                },
+            };
+            const req = transport.request(requestOptions, (res) => {
+                if (!res.statusCode || res.statusCode < 200 || res.statusCode >= 300) {
+                    res.resume();
+                    reject(new Error(`API request failed: HTTP ${res.statusCode} for ${apiPath}`));
+                    return;
+                }
+                const chunks = [];
+                res.on('data', (chunk) => chunks.push(chunk));
+                res.on('end', () => {
+                    try {
+                        const body = Buffer.concat(chunks).toString('utf-8');
+                        resolve(JSON.parse(body));
+                    }
+                    catch (err) {
+                        reject(new Error(`Failed to parse API response for ${apiPath}: ${String(err)}`));
+                    }
+                });
+                res.on('error', reject);
+            });
+            req.on('timeout', () => {
+                req.destroy();
+                reject(new Error(`API request timeout (${this.options.requestTimeoutMs}ms) for ${apiPath}`));
+            });
+            req.on('error', reject);
+            req.end();
+        });
+    }
+    // ─── Private: Helpers ───────────────────────────────────────────────────────
+    /**
+     * Verify that a model file exists on disk, recompute its hash if present,
+     * or clear stale info if the file has been deleted.
+     */
+    async verifyModelOnDisk(name, info) {
+        if (!info.filePath || !fs.existsSync(info.filePath)) {
+            // File missing — clear hash/size but keep version metadata
+            info.sha256 = '';
+            info.sizeBytes = 0;
+            return;
+        }
+        try {
+            const stat = fs.statSync(info.filePath);
+            info.sizeBytes = stat.size;
+            info.sha256 = await this.computeFileHash(info.filePath);
+        }
+        catch {
+            // If we cannot read the file, clear cached info
+            info.sha256 = '';
+            info.sizeBytes = 0;
+        }
+    }
+    /**
+     * Semver comparison: returns true if `available` is strictly newer than `current`.
+     * Handles non-semver gracefully by falling back to string comparison.
+     */
+    isNewerVersion(available, current) {
+        const parse = (v) => {
+            const parts = v.replace(/^v/, '').split('.').map(Number);
+            return [parts[0] || 0, parts[1] || 0, parts[2] || 0];
+        };
+        const [aMajor, aMinor, aPatch] = parse(available);
+        const [cMajor, cMinor, cPatch] = parse(current);
+        if (aMajor !== cMajor)
+            return aMajor > cMajor;
+        if (aMinor !== cMinor)
+            return aMinor > cMinor;
+        return aPatch > cPatch;
+    }
+    /**
+     * Safely remove a .tmp file if it exists.  Never throws.
+     */
+    cleanupTmpFile(tmpPath) {
+        try {
+            if (fs.existsSync(tmpPath)) {
+                fs.unlinkSync(tmpPath);
+            }
+        }
+        catch {
+            // Best-effort cleanup; do not propagate
+        }
+    }
+}
+exports.ModelManager = ModelManager;
+//# sourceMappingURL=ModelManager.js.map

package/dist/ModelManager.js.map

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

package/dist/SignalBuffer.d.ts

@@ -1,12 +1,22 @@
 /**
- * SignalBuffer — Offline signal buffering using better-sqlite3.
- * Port of SignalBuffer.kt (Room database) to cross-platform SQLite.
+ * SignalBuffer — Offline signal buffering with auto-detecting backend.
+ * Port of SignalBuffer.kt (Room database) to cross-platform storage.
+ *
+ * Backends:
+ *   - SqliteStore   (better-sqlite3 installed → WAL mode, prepared stmts)
+ *   - JsonFileStore (fallback → zero deps, fs.renameSync atomic writes)
+ *
+ * Auto-detection: tries require('better-sqlite3') at construction time.
+ * If unavailable (native compilation failed, not installed), falls back
+ * to JsonFileStore — guaranteed to work on any Node.js >=18 platform.
  *
  * Capacity: 8,640 signals (24h at 6 signals/min)
  * Eviction: oldest 10% when at capacity
  * Flush: batch of 50, marks with _buffered and _bufferedAt
  * Pruning: signals older than 24h auto-deleted
+ * Priority: FACE_BACKED > PERSON_BACKED > SPEECH_ONLY > PROXY_ONLY > EMPTY
  */
+import type { SignalStoreStats } from './SignalStore';
 import { SocketManager } from './SocketManager';
 export interface BufferedSignal {
     id: number;
@@ -20,15 +30,8 @@ export declare class SignalBuffer {
     static readonly MAX_AGE_MS: number;
     static readonly MAX_RETRIES = 5;
     static readonly EVICT_RATIO = 0.1;
-    private db;
-    private insertStmt;
-    private getOldestStmt;
-    private deleteByIdStmt;
-    private countStmt;
-    private pruneStmt;
-    private deleteOldestNStmt;
-    private incrementRetryStmt;
-    private deleteMaxRetriesStmt;
+    private store;
+    readonly backend: 'sqlite' | 'json';
     constructor(dbPath: string);
     /**
      * Buffer a signal for later sending.
@@ -38,6 +41,7 @@ export declare class SignalBuffer {
     /**
      * Flush buffered signals via socket.
      * Returns number of successfully sent signals.
+     * Signals are flushed in priority order — highest evidence grade first.
      */
     flushBuffer(socketManager: SocketManager, limit?: number): number;
     /**
@@ -49,7 +53,11 @@ export declare class SignalBuffer {
      */
     count(): number;
     /**
-     * Close the database connection.
+     * Signal buffer statistics — count by evidence grade, oldest timestamp.
+     */
+    stats(): SignalStoreStats;
+    /**
+     * Close the store connection.
      */
     shutdown(): void;
 }