@trillboards/edge-core 0.2.0 → 0.2.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Trillboards, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/JsonFileStore.d.ts

@@ -0,0 +1,33 @@
+/**
+ * JsonFileStore — Zero-dependency signal store using Node.js fs.
+ *
+ * Storage: configurable path (default: ~/.trillboards/signal_buffer.json)
+ * Persistence: debounced writes (every 5s max) + sync write on close()
+ * Crash safety: write to .tmp then fs.renameSync (atomic on all platforms)
+ * Priority: FACE_BACKED > PERSON_BACKED > SPEECH_ONLY > PROXY_ONLY > EMPTY
+ */
+import type { SignalStore, StoredSignal, SignalStoreStats } from './SignalStore';
+export declare class JsonFileStore implements SignalStore {
+    private signals;
+    private nextId;
+    private readonly filePath;
+    private dirty;
+    private flushTimer;
+    private static readonly FLUSH_INTERVAL_MS;
+    constructor(filePath?: string);
+    private loadFromDisk;
+    private schedulePersist;
+    private persistSync;
+    private extractEvidenceGrade;
+    insert(payload: string, timestamp: number): void;
+    getOldest(limit: number): StoredSignal[];
+    deleteById(id: number): void;
+    deleteOlderThan(cutoffMs: number): number;
+    deleteOldestN(n: number): void;
+    deleteExceedingRetries(maxRetries: number): void;
+    incrementRetry(id: number): void;
+    count(): number;
+    stats(): SignalStoreStats;
+    close(): void;
+}
+//# sourceMappingURL=JsonFileStore.d.ts.map

package/dist/JsonFileStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonFileStore.d.ts","sourceRoot":"","sources":["../src/JsonFileStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAejF,qBAAa,aAAc,YAAW,WAAW;IAC/C,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;gBAErC,QAAQ,CAAC,EAAE,MAAM;IAiB7B,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,oBAAoB;IAW5B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAYhD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE;IAWxC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQ5B,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQzC,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ9B,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAMhD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQhC,KAAK,IAAI,MAAM;IAIf,KAAK,IAAI,gBAAgB;IAmBzB,KAAK,IAAI,IAAI;CASd"}

package/dist/JsonFileStore.js

@@ -0,0 +1,210 @@
+"use strict";
+/**
+ * JsonFileStore — Zero-dependency signal store using Node.js fs.
+ *
+ * Storage: configurable path (default: ~/.trillboards/signal_buffer.json)
+ * Persistence: debounced writes (every 5s max) + sync write on close()
+ * Crash safety: write to .tmp then fs.renameSync (atomic on all platforms)
+ * Priority: FACE_BACKED > PERSON_BACKED > SPEECH_ONLY > PROXY_ONLY > EMPTY
+ */
+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.JsonFileStore = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const EVIDENCE_GRADE_PRIORITY = {
+    FACE_BACKED: 1,
+    PERSON_BACKED: 2,
+    SPEECH_ONLY: 3,
+    PROXY_ONLY: 4,
+    EMPTY: 5,
+};
+class JsonFileStore {
+    constructor(filePath) {
+        this.signals = [];
+        this.nextId = 1;
+        this.dirty = false;
+        this.flushTimer = null;
+        this.filePath =
+            filePath ||
+                path.join(process.env.HOME || process.env.USERPROFILE || '/tmp', '.trillboards', 'signal_buffer.json');
+        const dir = path.dirname(this.filePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        this.loadFromDisk();
+    }
+    loadFromDisk() {
+        try {
+            if (fs.existsSync(this.filePath)) {
+                const raw = fs.readFileSync(this.filePath, 'utf-8');
+                const data = JSON.parse(raw);
+                if (Array.isArray(data.signals)) {
+                    this.signals = data.signals;
+                    this.nextId = typeof data.nextId === 'number' ? data.nextId : 1;
+                    // Ensure nextId is higher than any existing signal id
+                    for (const s of this.signals) {
+                        if (s.id >= this.nextId) {
+                            this.nextId = s.id + 1;
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            // Corrupt file — start fresh, log warning
+            console.warn(`[JsonFileStore] Corrupt signal buffer at ${this.filePath}, starting fresh`);
+            this.signals = [];
+            this.nextId = 1;
+        }
+    }
+    schedulePersist() {
+        this.dirty = true;
+        if (this.flushTimer)
+            return;
+        this.flushTimer = setTimeout(() => {
+            this.flushTimer = null;
+            if (this.dirty) {
+                this.persistSync();
+            }
+        }, JsonFileStore.FLUSH_INTERVAL_MS);
+    }
+    persistSync() {
+        this.dirty = false;
+        const data = {
+            nextId: this.nextId,
+            signals: this.signals,
+        };
+        const json = JSON.stringify(data);
+        const tmpPath = this.filePath + '.tmp';
+        try {
+            fs.writeFileSync(tmpPath, json, 'utf-8');
+            fs.renameSync(tmpPath, this.filePath);
+        }
+        catch (err) {
+            console.error(`[JsonFileStore] Failed to persist signal buffer:`, err);
+        }
+    }
+    extractEvidenceGrade(payload) {
+        try {
+            const parsed = JSON.parse(payload);
+            return typeof parsed.evidenceGrade === 'string'
+                ? parsed.evidenceGrade
+                : 'EMPTY';
+        }
+        catch {
+            return 'EMPTY';
+        }
+    }
+    insert(payload, timestamp) {
+        const signal = {
+            id: this.nextId++,
+            payload,
+            timestamp,
+            retryCount: 0,
+            evidenceGrade: this.extractEvidenceGrade(payload),
+        };
+        this.signals.push(signal);
+        this.schedulePersist();
+    }
+    getOldest(limit) {
+        // Sort by priority (evidence grade), then by timestamp (oldest first)
+        const sorted = [...this.signals].sort((a, b) => {
+            const prioA = EVIDENCE_GRADE_PRIORITY[a.evidenceGrade || 'EMPTY'] || 5;
+            const prioB = EVIDENCE_GRADE_PRIORITY[b.evidenceGrade || 'EMPTY'] || 5;
+            if (prioA !== prioB)
+                return prioA - prioB;
+            return a.timestamp - b.timestamp;
+        });
+        return sorted.slice(0, limit);
+    }
+    deleteById(id) {
+        const idx = this.signals.findIndex((s) => s.id === id);
+        if (idx !== -1) {
+            this.signals.splice(idx, 1);
+            this.schedulePersist();
+        }
+    }
+    deleteOlderThan(cutoffMs) {
+        const before = this.signals.length;
+        this.signals = this.signals.filter((s) => s.timestamp >= cutoffMs);
+        const deleted = before - this.signals.length;
+        if (deleted > 0)
+            this.schedulePersist();
+        return deleted;
+    }
+    deleteOldestN(n) {
+        if (n <= 0 || this.signals.length === 0)
+            return;
+        // Sort by timestamp ascending, remove the oldest N
+        this.signals.sort((a, b) => a.timestamp - b.timestamp);
+        this.signals.splice(0, n);
+        this.schedulePersist();
+    }
+    deleteExceedingRetries(maxRetries) {
+        const before = this.signals.length;
+        this.signals = this.signals.filter((s) => s.retryCount < maxRetries);
+        if (this.signals.length < before)
+            this.schedulePersist();
+    }
+    incrementRetry(id) {
+        const signal = this.signals.find((s) => s.id === id);
+        if (signal) {
+            signal.retryCount++;
+            this.schedulePersist();
+        }
+    }
+    count() {
+        return this.signals.length;
+    }
+    stats() {
+        const byGrade = {};
+        let oldest = null;
+        for (const s of this.signals) {
+            const grade = s.evidenceGrade || 'EMPTY';
+            byGrade[grade] = (byGrade[grade] || 0) + 1;
+            if (oldest === null || s.timestamp < oldest) {
+                oldest = s.timestamp;
+            }
+        }
+        return {
+            total: this.signals.length,
+            byEvidenceGrade: byGrade,
+            oldestTimestampMs: oldest,
+        };
+    }
+    close() {
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
+        if (this.dirty) {
+            this.persistSync();
+        }
+    }
+}
+exports.JsonFileStore = JsonFileStore;
+JsonFileStore.FLUSH_INTERVAL_MS = 5000;
+//# sourceMappingURL=JsonFileStore.js.map

package/dist/JsonFileStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonFileStore.js","sourceRoot":"","sources":["../src/JsonFileStore.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;
 }

package/dist/SignalBuffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SignalBuffer.d.ts","sourceRoot":"","sources":["../src/SignalBuffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,YAAY;IACvB,MAAM,CAAC,QAAQ,CAAC,YAAY,QAAQ;IACpC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,MAAM;IACtC,MAAM,CAAC,QAAQ,CAAC,UAAU,SAAuB;IACjD,MAAM,CAAC,QAAQ,CAAC,WAAW,KAAK;IAChC,MAAM,CAAC,QAAQ,CAAC,WAAW,OAAO;IAElC,OAAO,CAAC,EAAE,CAAe;IACzB,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,iBAAiB,CAAsC;IAC/D,OAAO,CAAC,kBAAkB,CAAsC;IAChE,OAAO,CAAC,oBAAoB,CAAsC;gBAEtD,MAAM,EAAE,MAAM;IAkD1B;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAYpD;;;OAGG;IACH,WAAW,CACT,aAAa,EAAE,aAAa,EAC5B,KAAK,GAAE,MAAsC,GAC5C,MAAM;IA8BT;;OAEG;IACH,eAAe,IAAI,MAAM;IAMzB;;OAEG;IACH,KAAK,IAAI,MAAM;IAKf;;OAEG;IACH,QAAQ,IAAI,IAAI;CAGjB"}
+{"version":3,"file":"SignalBuffer.d.ts","sourceRoot":"","sources":["../src/SignalBuffer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAe,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,YAAY;IACvB,MAAM,CAAC,QAAQ,CAAC,YAAY,QAAQ;IACpC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,MAAM;IACtC,MAAM,CAAC,QAAQ,CAAC,UAAU,SAAuB;IACjD,MAAM,CAAC,QAAQ,CAAC,WAAW,KAAK;IAChC,MAAM,CAAC,QAAQ,CAAC,WAAW,OAAO;IAElC,OAAO,CAAC,KAAK,CAAc;IAC3B,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC;gBAExB,MAAM,EAAE,MAAM;IAiC1B;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAYpD;;;;OAIG;IACH,WAAW,CACT,aAAa,EAAE,aAAa,EAC5B,KAAK,GAAE,MAAsC,GAC5C,MAAM;IA8BT;;OAEG;IACH,eAAe,IAAI,MAAM;IAKzB;;OAEG;IACH,KAAK,IAAI,MAAM;IAIf;;OAEG;IACH,KAAK,IAAI,gBAAgB;IAIzB;;OAEG;IACH,QAAQ,IAAI,IAAI;CAGjB"}

package/dist/SignalBuffer.js

@@ -1,92 +1,73 @@
 "use strict";
 /**
- * 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
  */
-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;
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SignalBuffer = void 0;
-const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
-const path = __importStar(require("path"));
-const fs = __importStar(require("fs"));
+const JsonFileStore_1 = require("./JsonFileStore");
 class SignalBuffer {
     constructor(dbPath) {
-        const dir = path.dirname(dbPath);
-        if (!fs.existsSync(dir)) {
-            fs.mkdirSync(dir, { recursive: true });
+        let store = null;
+        let backend = 'json';
+        // Try SQLite first (high-performance, optional)
+        try {
+            // Dynamic require — only resolves if better-sqlite3 is installed + compiled
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const Database = require('better-sqlite3');
+            const { SqliteStore } = require('./SqliteStore');
+            store = new SqliteStore(dbPath, Database);
+            backend = 'sqlite';
+        }
+        catch {
+            // better-sqlite3 not available — fall back to JSON file store
         }
-        this.db = new better_sqlite3_1.default(dbPath);
-        this.db.pragma('journal_mode = WAL');
-        this.db.pragma('synchronous = NORMAL');
-        this.db.exec(`
-      CREATE TABLE IF NOT EXISTS buffered_signals (
-        id INTEGER PRIMARY KEY AUTOINCREMENT,
-        payload TEXT NOT NULL,
-        timestamp INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000),
-        retry_count INTEGER NOT NULL DEFAULT 0
-      )
-    `);
-        this.db.exec(`
-      CREATE INDEX IF NOT EXISTS idx_signals_timestamp ON buffered_signals(timestamp)
-    `);
-        // Prepared statements for performance
-        this.insertStmt = this.db.prepare('INSERT INTO buffered_signals (payload, timestamp, retry_count) VALUES (?, ?, 0)');
-        this.getOldestStmt = this.db.prepare('SELECT id, payload, timestamp, retry_count FROM buffered_signals ORDER BY timestamp ASC LIMIT ?');
-        this.deleteByIdStmt = this.db.prepare('DELETE FROM buffered_signals WHERE id = ?');
-        this.countStmt = this.db.prepare('SELECT COUNT(*) as count FROM buffered_signals');
-        this.pruneStmt = this.db.prepare('DELETE FROM buffered_signals WHERE timestamp < ?');
-        this.deleteOldestNStmt = this.db.prepare('DELETE FROM buffered_signals WHERE id IN (SELECT id FROM buffered_signals ORDER BY timestamp ASC LIMIT ?)');
-        this.incrementRetryStmt = this.db.prepare('UPDATE buffered_signals SET retry_count = retry_count + 1 WHERE id = ?');
-        this.deleteMaxRetriesStmt = this.db.prepare('DELETE FROM buffered_signals WHERE retry_count >= ?');
+        if (!store) {
+            // Use JSON file store — zero dependencies, universal
+            const jsonPath = dbPath.replace(/\.db$/, '.json');
+            store = new JsonFileStore_1.JsonFileStore(jsonPath);
+            backend = 'json';
+        }
+        this.store = store;
+        this.backend = backend;
+        const label = backend === 'sqlite'
+            ? 'SQLite (disk-persistent, WAL mode)'
+            : 'JSON file (disk-persistent, atomic writes)';
+        console.log(`[SignalBuffer] Initialized: ${label}`);
     }
     /**
      * Buffer a signal for later sending.
      * If at capacity, evicts oldest 10% first.
      */
     bufferSignal(payload) {
-        const count = this.count();
+        const count = this.store.count();
         if (count >= SignalBuffer.MAX_CAPACITY) {
             const evictCount = Math.ceil(SignalBuffer.MAX_CAPACITY * SignalBuffer.EVICT_RATIO);
-            this.deleteOldestNStmt.run(evictCount);
+            this.store.deleteOldestN(evictCount);
         }
-        this.insertStmt.run(JSON.stringify(payload), Date.now());
+        this.store.insert(JSON.stringify(payload), Date.now());
     }
     /**
      * Flush buffered signals via socket.
      * Returns number of successfully sent signals.
+     * Signals are flushed in priority order — highest evidence grade first.
      */
     flushBuffer(socketManager, limit = SignalBuffer.FLUSH_BATCH_SIZE) {
-        const signals = this.getOldestStmt.all(limit);
+        const signals = this.store.getOldest(limit);
         let sent = 0;
         for (const signal of signals) {
             try {
@@ -96,20 +77,20 @@ class SignalBuffer {
                 payload._bufferedAt = signal.timestamp;
                 const success = socketManager.emitAudienceSignal(payload);
                 if (success) {
-                    this.deleteByIdStmt.run(signal.id);
+                    this.store.deleteById(signal.id);
                     sent++;
                 }
                 else {
-                    this.incrementRetryStmt.run(signal.id);
+                    this.store.incrementRetry(signal.id);
                 }
             }
             catch {
                 // Corrupted payload — remove it
-                this.deleteByIdStmt.run(signal.id);
+                this.store.deleteById(signal.id);
             }
         }
         // Clean up signals that have exceeded max retries
-        this.deleteMaxRetriesStmt.run(SignalBuffer.MAX_RETRIES);
+        this.store.deleteExceedingRetries(SignalBuffer.MAX_RETRIES);
         return sent;
     }
     /**
@@ -117,21 +98,25 @@ class SignalBuffer {
      */
     pruneOldSignals() {
         const cutoff = Date.now() - SignalBuffer.MAX_AGE_MS;
-        const result = this.pruneStmt.run(cutoff);
-        return result.changes;
+        return this.store.deleteOlderThan(cutoff);
     }
     /**
      * Current number of buffered signals.
      */
     count() {
-        const row = this.countStmt.get();
-        return row.count;
+        return this.store.count();
+    }
+    /**
+     * Signal buffer statistics — count by evidence grade, oldest timestamp.
+     */
+    stats() {
+        return this.store.stats();
     }
     /**
-     * Close the database connection.
+     * Close the store connection.
      */
     shutdown() {
-        this.db.close();
+        this.store.close();
     }
 }
 exports.SignalBuffer = SignalBuffer;

package/dist/SignalBuffer.js.map

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

package/dist/SignalStore.d.ts

@@ -0,0 +1,35 @@
+/**
+ * SignalStore — Internal interface for signal-aware persistence backends.
+ *
+ * The SignalBuffer delegates all storage operations to a SignalStore implementation.
+ * Two built-in implementations:
+ *   - JsonFileStore  (zero dependencies, universal default)
+ *   - SqliteStore    (optional, high-throughput upgrade via better-sqlite3)
+ *
+ * Advanced users can implement this interface for custom backends (Redis, IndexedDB, etc.)
+ */
+export interface StoredSignal {
+    id: number;
+    payload: string;
+    timestamp: number;
+    retryCount: number;
+    evidenceGrade?: string;
+}
+export interface SignalStoreStats {
+    total: number;
+    byEvidenceGrade: Record<string, number>;
+    oldestTimestampMs: number | null;
+}
+export interface SignalStore {
+    insert(payload: string, timestamp: number): void;
+    getOldest(limit: number): StoredSignal[];
+    deleteById(id: number): void;
+    deleteOlderThan(cutoffMs: number): number;
+    deleteOldestN(n: number): void;
+    deleteExceedingRetries(maxRetries: number): void;
+    incrementRetry(id: number): void;
+    count(): number;
+    stats(): SignalStoreStats;
+    close(): void;
+}
+//# sourceMappingURL=SignalStore.d.ts.map

package/dist/SignalStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignalStore.d.ts","sourceRoot":"","sources":["../src/SignalStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;IACzC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1C,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,KAAK,IAAI,MAAM,CAAC;IAChB,KAAK,IAAI,gBAAgB,CAAC;IAC1B,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/SignalStore.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * SignalStore — Internal interface for signal-aware persistence backends.
+ *
+ * The SignalBuffer delegates all storage operations to a SignalStore implementation.
+ * Two built-in implementations:
+ *   - JsonFileStore  (zero dependencies, universal default)
+ *   - SqliteStore    (optional, high-throughput upgrade via better-sqlite3)
+ *
+ * Advanced users can implement this interface for custom backends (Redis, IndexedDB, etc.)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=SignalStore.js.map

package/dist/SignalStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignalStore.js","sourceRoot":"","sources":["../src/SignalStore.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG"}

package/dist/SqliteStore.d.ts

@@ -0,0 +1,41 @@
+/**
+ * SqliteStore — High-performance signal store using better-sqlite3.
+ * Extracted from the original SignalBuffer implementation.
+ *
+ * WAL journal mode, prepared statements, evidence_grade column + index
+ * for priority-aware flushing (FACE_BACKED sent first).
+ *
+ * Only loaded when better-sqlite3 is available (optional dependency).
+ */
+import type { SignalStore, StoredSignal, SignalStoreStats } from './SignalStore';
+import type { Database as DatabaseType } from 'better-sqlite3';
+export declare class SqliteStore implements SignalStore {
+    private db;
+    private insertStmt;
+    private getOldestStmt;
+    private deleteByIdStmt;
+    private countStmt;
+    private pruneStmt;
+    private deleteOldestNStmt;
+    private incrementRetryStmt;
+    private deleteMaxRetriesStmt;
+    private statsStmt;
+    private oldestStmt;
+    /**
+     * @param dbPath - Path to the SQLite database file
+     * @param DatabaseConstructor - The better-sqlite3 Database constructor (injected to avoid top-level require)
+     */
+    constructor(dbPath: string, DatabaseConstructor: new (filename: string) => DatabaseType);
+    private extractEvidenceGrade;
+    insert(payload: string, timestamp: number): void;
+    getOldest(limit: number): StoredSignal[];
+    deleteById(id: number): void;
+    deleteOlderThan(cutoffMs: number): number;
+    deleteOldestN(n: number): void;
+    deleteExceedingRetries(maxRetries: number): void;
+    incrementRetry(id: number): void;
+    count(): number;
+    stats(): SignalStoreStats;
+    close(): void;
+}
+//# sourceMappingURL=SqliteStore.d.ts.map

package/dist/SqliteStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteStore.d.ts","sourceRoot":"","sources":["../src/SqliteStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGjF,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE/D,qBAAa,WAAY,YAAW,WAAW;IAC7C,OAAO,CAAC,EAAE,CAAe;IACzB,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,iBAAiB,CAAsC;IAC/D,OAAO,CAAC,kBAAkB,CAAsC;IAChE,OAAO,CAAC,oBAAoB,CAAsC;IAClE,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,UAAU,CAAsC;IAExD;;;OAGG;gBAED,MAAM,EAAE,MAAM,EACd,mBAAmB,EAAE,KAAK,QAAQ,EAAE,MAAM,KAAK,YAAY;IA4F7D,OAAO,CAAC,oBAAoB;IAW5B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKhD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE;IAIxC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI5B,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAKzC,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAI9B,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIhD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIhC,KAAK,IAAI,MAAM;IAKf,KAAK,IAAI,gBAAgB;IAoBzB,KAAK,IAAI,IAAI;CAGd"}

package/dist/SqliteStore.js

@@ -0,0 +1,162 @@
+"use strict";
+/**
+ * SqliteStore — High-performance signal store using better-sqlite3.
+ * Extracted from the original SignalBuffer implementation.
+ *
+ * WAL journal mode, prepared statements, evidence_grade column + index
+ * for priority-aware flushing (FACE_BACKED sent first).
+ *
+ * Only loaded when better-sqlite3 is available (optional dependency).
+ */
+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.SqliteStore = void 0;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+class SqliteStore {
+    /**
+     * @param dbPath - Path to the SQLite database file
+     * @param DatabaseConstructor - The better-sqlite3 Database constructor (injected to avoid top-level require)
+     */
+    constructor(dbPath, DatabaseConstructor) {
+        const dir = path.dirname(dbPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        this.db = new DatabaseConstructor(dbPath);
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('synchronous = NORMAL');
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS buffered_signals (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        payload TEXT NOT NULL,
+        timestamp INTEGER NOT NULL DEFAULT (strftime('%s','now') * 1000),
+        retry_count INTEGER NOT NULL DEFAULT 0,
+        evidence_grade TEXT NOT NULL DEFAULT 'EMPTY'
+      )
+    `);
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_signals_timestamp ON buffered_signals(timestamp)
+    `);
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_signals_evidence_grade ON buffered_signals(evidence_grade)
+    `);
+        // Migrate existing rows that lack evidence_grade (from pre-0.2.2 databases)
+        try {
+            // Check if evidence_grade column exists by querying pragma
+            const columns = this.db
+                .prepare("PRAGMA table_info('buffered_signals')")
+                .all();
+            const hasGradeCol = columns.some((c) => c.name === 'evidence_grade');
+            if (!hasGradeCol) {
+                this.db.exec("ALTER TABLE buffered_signals ADD COLUMN evidence_grade TEXT NOT NULL DEFAULT 'EMPTY'");
+                this.db.exec("CREATE INDEX IF NOT EXISTS idx_signals_evidence_grade ON buffered_signals(evidence_grade)");
+            }
+        }
+        catch {
+            // Column already exists or migration not needed
+        }
+        // Prepared statements
+        this.insertStmt = this.db.prepare('INSERT INTO buffered_signals (payload, timestamp, retry_count, evidence_grade) VALUES (?, ?, 0, ?)');
+        this.getOldestStmt = this.db.prepare(`
+      SELECT id, payload, timestamp, retry_count as retryCount, evidence_grade as evidenceGrade
+      FROM buffered_signals
+      ORDER BY
+        CASE evidence_grade
+          WHEN 'FACE_BACKED' THEN 1
+          WHEN 'PERSON_BACKED' THEN 2
+          WHEN 'SPEECH_ONLY' THEN 3
+          WHEN 'PROXY_ONLY' THEN 4
+          ELSE 5
+        END,
+        timestamp ASC
+      LIMIT ?
+    `);
+        this.deleteByIdStmt = this.db.prepare('DELETE FROM buffered_signals WHERE id = ?');
+        this.countStmt = this.db.prepare('SELECT COUNT(*) as count FROM buffered_signals');
+        this.pruneStmt = this.db.prepare('DELETE FROM buffered_signals WHERE timestamp < ?');
+        this.deleteOldestNStmt = this.db.prepare('DELETE FROM buffered_signals WHERE id IN (SELECT id FROM buffered_signals ORDER BY timestamp ASC LIMIT ?)');
+        this.incrementRetryStmt = this.db.prepare('UPDATE buffered_signals SET retry_count = retry_count + 1 WHERE id = ?');
+        this.deleteMaxRetriesStmt = this.db.prepare('DELETE FROM buffered_signals WHERE retry_count >= ?');
+        this.statsStmt = this.db.prepare('SELECT evidence_grade as grade, COUNT(*) as cnt FROM buffered_signals GROUP BY evidence_grade');
+        this.oldestStmt = this.db.prepare('SELECT MIN(timestamp) as oldest FROM buffered_signals');
+    }
+    extractEvidenceGrade(payload) {
+        try {
+            const parsed = JSON.parse(payload);
+            return typeof parsed.evidenceGrade === 'string'
+                ? parsed.evidenceGrade
+                : 'EMPTY';
+        }
+        catch {
+            return 'EMPTY';
+        }
+    }
+    insert(payload, timestamp) {
+        const grade = this.extractEvidenceGrade(payload);
+        this.insertStmt.run(payload, timestamp, grade);
+    }
+    getOldest(limit) {
+        return this.getOldestStmt.all(limit);
+    }
+    deleteById(id) {
+        this.deleteByIdStmt.run(id);
+    }
+    deleteOlderThan(cutoffMs) {
+        const result = this.pruneStmt.run(cutoffMs);
+        return result.changes;
+    }
+    deleteOldestN(n) {
+        this.deleteOldestNStmt.run(n);
+    }
+    deleteExceedingRetries(maxRetries) {
+        this.deleteMaxRetriesStmt.run(maxRetries);
+    }
+    incrementRetry(id) {
+        this.incrementRetryStmt.run(id);
+    }
+    count() {
+        const row = this.countStmt.get();
+        return row.count;
+    }
+    stats() {
+        const rows = this.statsStmt.all();
+        const byGrade = {};
+        for (const row of rows) {
+            byGrade[row.grade] = row.cnt;
+        }
+        const oldestRow = this.oldestStmt.get();
+        return {
+            total: this.count(),
+            byEvidenceGrade: byGrade,
+            oldestTimestampMs: oldestRow.oldest,
+        };
+    }
+    close() {
+        this.db.close();
+    }
+}
+exports.SqliteStore = SqliteStore;
+//# sourceMappingURL=SqliteStore.js.map

package/dist/SqliteStore.js.map

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

package/dist/index.d.ts

@@ -5,6 +5,9 @@ export { SocketManager } from './SocketManager';
 export type { SocketManagerOptions } from './SocketManager';
 export { VASWeightConfig } from './VASWeightConfig';
 export { SignalBuffer } from './SignalBuffer';
+export type { SignalStore, StoredSignal, SignalStoreStats } from './SignalStore';
+export { JsonFileStore } from './JsonFileStore';
+export { SqliteStore } from './SqliteStore';
 export { SubsystemHealthRegistry } from './SubsystemHealthRegistry';
 export { RecoveryLadder } from './RecoveryLadder';
 export type { RecoveryCallbacks } from './RecoveryLadder';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EACL,yBAAyB,EACzB,KAAK,mBAAmB,GACzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EACL,yBAAyB,EACzB,KAAK,mBAAmB,GACzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -15,7 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAttenuationTier = exports.getShedOrder = exports.isModelActive = exports.getCapabilityMatrix = exports.computeTier = exports.classifyObservationSignal = exports.TelemetryScheduler = exports.RecoveryLadder = exports.SubsystemHealthRegistry = exports.SignalBuffer = exports.VASWeightConfig = exports.SocketManager = exports.SensingConfig = exports.DeviceIdentity = void 0;
+exports.getAttenuationTier = exports.getShedOrder = exports.isModelActive = exports.getCapabilityMatrix = exports.computeTier = exports.classifyObservationSignal = exports.TelemetryScheduler = exports.RecoveryLadder = exports.SubsystemHealthRegistry = exports.SqliteStore = exports.JsonFileStore = exports.SignalBuffer = exports.VASWeightConfig = exports.SocketManager = exports.SensingConfig = exports.DeviceIdentity = void 0;
 __exportStar(require("./types"), exports);
 var DeviceIdentity_1 = require("./DeviceIdentity");
 Object.defineProperty(exports, "DeviceIdentity", { enumerable: true, get: function () { return DeviceIdentity_1.DeviceIdentity; } });
@@ -27,6 +27,10 @@ var VASWeightConfig_1 = require("./VASWeightConfig");
 Object.defineProperty(exports, "VASWeightConfig", { enumerable: true, get: function () { return VASWeightConfig_1.VASWeightConfig; } });
 var SignalBuffer_1 = require("./SignalBuffer");
 Object.defineProperty(exports, "SignalBuffer", { enumerable: true, get: function () { return SignalBuffer_1.SignalBuffer; } });
+var JsonFileStore_1 = require("./JsonFileStore");
+Object.defineProperty(exports, "JsonFileStore", { enumerable: true, get: function () { return JsonFileStore_1.JsonFileStore; } });
+var SqliteStore_1 = require("./SqliteStore");
+Object.defineProperty(exports, "SqliteStore", { enumerable: true, get: function () { return SqliteStore_1.SqliteStore; } });
 var SubsystemHealthRegistry_1 = require("./SubsystemHealthRegistry");
 Object.defineProperty(exports, "SubsystemHealthRegistry", { enumerable: true, get: function () { return SubsystemHealthRegistry_1.SubsystemHealthRegistry; } });
 var RecoveryLadder_1 = require("./RecoveryLadder");

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;;;;;;;;;;;;;AAEtF,0CAAwB;AACxB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AAEtB,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,qEAAoE;AAA3D,kIAAA,uBAAuB,OAAA;AAChC,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AAEvB,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAE3B,6EAGuC;AAFrC,wIAAA,yBAAyB,OAAA;AAG3B,iDAMyB;AALvB,4GAAA,WAAW,OAAA;AACX,oHAAA,mBAAmB,OAAA;AACnB,8GAAA,aAAa,OAAA;AACb,6GAAA,YAAY,OAAA;AACZ,mHAAA,kBAAkB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;;;;;;;;;;;;;AAEtF,0CAAwB;AACxB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AAEtB,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AAErB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,qEAAoE;AAA3D,kIAAA,uBAAuB,OAAA;AAChC,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AAEvB,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAE3B,6EAGuC;AAFrC,wIAAA,yBAAyB,OAAA;AAG3B,iDAMyB;AALvB,4GAAA,WAAW,OAAA;AACX,oHAAA,mBAAmB,OAAA;AACnB,8GAAA,aAAa,OAAA;AACb,6GAAA,YAAY,OAAA;AACZ,mHAAA,kBAAkB,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trillboards/edge-core",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Core identity, heartbeat, Socket.io, config, and signal buffer for Trillboards Edge AI SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,10 +11,12 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "better-sqlite3": "^11.0.0",
     "socket.io-client": "^4.7.0",
     "uuid": "^9.0.0"
   },
+  "optionalDependencies": {
+    "better-sqlite3": "^11.0.0"
+  },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.0",
     "@types/jest": "^29.5.0",
@@ -24,8 +26,9 @@
     "ts-jest": "^29.1.0",
     "typescript": "~5.3.0"
   },
-  "files": ["dist"],
-  "license": "UNLICENSED",
+  "files": ["dist", "LICENSE", "README.md"],
+  "author": "Trillboards <engineering@trillboards.com>",
+  "license": "MIT",
   "publishConfig": {
     "access": "public"
   },