@trillboards/edge-core 0.1.0

package/dist/RecoveryLadder.js

@@ -0,0 +1,199 @@
+"use strict";
+/**
+ * RecoveryLadder — 6-level autonomous recovery system.
+ * Port of RecoveryLadder.kt. Platform-specific recovery actions via callbacks.
+ *
+ * Levels:
+ * 1. Network Drop → Socket.io handles (infinite reconnect with exp backoff)
+ * 2. Player Stuck → Reload (3x) → Recreate (3x)
+ * 3. Camera/Mic Failure → Unbind/rebind hardware
+ * 4. Memory Pressure → Attenuate (shed models, restore)
+ * 5. Full Service Restart → Stop + restart service (3x per 24h)
+ * 6. OTA Rollback → Server-initiated install of previous version
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecoveryLadder = void 0;
+const types_1 = require("./types");
+const MAX_RELOAD_ATTEMPTS = 3;
+const MAX_RECREATE_ATTEMPTS = 3;
+const MAX_REBIND_ATTEMPTS = 3;
+const MAX_SERVICE_RESTARTS_PER_DAY = 3;
+const RECOVERY_COOLDOWN_MS = 30000;
+class RecoveryLadder {
+    constructor(healthRegistry, callbacks, maxRecoveryLevel = 6) {
+        this.recoveryHistory = [];
+        this.checkInterval = null;
+        this.healthRegistry = healthRegistry;
+        this.callbacks = callbacks;
+        this.maxRecoveryLevel = maxRecoveryLevel;
+        this.state = {
+            reloadAttempts: 0,
+            recreateAttempts: 0,
+            rebindAttempts: 0,
+            serviceRestarts: 0,
+            serviceRestartDay: this.getDayOfYear(),
+            lastRecoveryTimestamp: 0,
+        };
+    }
+    /**
+     * Start periodic recovery checks (every 30s, matching Kotlin).
+     */
+    start() {
+        if (this.checkInterval)
+            return;
+        this.checkInterval = setInterval(() => this.checkAndRecover(), 30000);
+    }
+    /**
+     * Stop periodic checks.
+     */
+    stop() {
+        if (this.checkInterval) {
+            clearInterval(this.checkInterval);
+            this.checkInterval = null;
+        }
+    }
+    /**
+     * Check subsystem health and trigger recovery if needed.
+     * Called every 30s by the interval, or manually.
+     */
+    async checkAndRecover() {
+        const now = Date.now();
+        if (now - this.state.lastRecoveryTimestamp < RECOVERY_COOLDOWN_MS) {
+            return; // Cooldown active
+        }
+        const failed = this.healthRegistry.getFailedSubsystems();
+        if (failed.length === 0) {
+            this.resetAttempts();
+            return;
+        }
+        for (const subsystem of failed) {
+            await this.handleFailure(subsystem);
+        }
+    }
+    /**
+     * Handle a specific subsystem failure with escalating recovery.
+     */
+    async handleFailure(subsystem) {
+        const now = Date.now();
+        this.state.lastRecoveryTimestamp = now;
+        try {
+            switch (subsystem) {
+                case types_1.Subsystem.SOCKET:
+                    // Level 1: Socket.io handles reconnection internally
+                    this.recordAction(types_1.RecoveryLevel.RECONNECT, subsystem, 'auto_reconnect', true);
+                    break;
+                case types_1.Subsystem.PLAYER:
+                    await this.recoverPlayer();
+                    break;
+                case types_1.Subsystem.CAMERA:
+                    await this.recoverHardware(subsystem, () => this.callbacks.onRebindCamera());
+                    break;
+                case types_1.Subsystem.MICROPHONE:
+                    await this.recoverHardware(subsystem, () => this.callbacks.onRebindMicrophone());
+                    break;
+                case types_1.Subsystem.ML_PIPELINE:
+                    // Level 4: Memory attenuation handles ML pipeline issues
+                    if (this.maxRecoveryLevel >= types_1.RecoveryLevel.ATTENUATE_MEMORY) {
+                        this.recordAction(types_1.RecoveryLevel.ATTENUATE_MEMORY, subsystem, 'attenuate', true);
+                        this.callbacks.onEmitRecoveryEvent('ml_pipeline_attenuation', { subsystem });
+                    }
+                    break;
+                case types_1.Subsystem.MEMORY:
+                    if (this.maxRecoveryLevel >= types_1.RecoveryLevel.ATTENUATE_MEMORY) {
+                        this.recordAction(types_1.RecoveryLevel.ATTENUATE_MEMORY, subsystem, 'memory_attenuate', true);
+                        this.callbacks.onEmitRecoveryEvent('memory_attenuation', { subsystem });
+                    }
+                    break;
+            }
+        }
+        catch (error) {
+            this.callbacks.onEmitRecoveryEvent('recovery_error', {
+                subsystem,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    async recoverPlayer() {
+        // Level 2: Reload → Recreate
+        if (this.state.reloadAttempts < MAX_RELOAD_ATTEMPTS && this.maxRecoveryLevel >= types_1.RecoveryLevel.RELOAD_PLAYER) {
+            this.state.reloadAttempts++;
+            await this.callbacks.onReloadPlayer();
+            this.recordAction(types_1.RecoveryLevel.RELOAD_PLAYER, types_1.Subsystem.PLAYER, 'reload', true);
+            return;
+        }
+        if (this.state.recreateAttempts < MAX_RECREATE_ATTEMPTS && this.maxRecoveryLevel >= types_1.RecoveryLevel.RELOAD_PLAYER) {
+            this.state.recreateAttempts++;
+            await this.callbacks.onRecreatePlayer();
+            this.recordAction(types_1.RecoveryLevel.RELOAD_PLAYER, types_1.Subsystem.PLAYER, 'recreate', true);
+            return;
+        }
+        // Level 5: Service restart
+        await this.attemptServiceRestart(types_1.Subsystem.PLAYER);
+    }
+    async recoverHardware(subsystem, rebindFn) {
+        // Level 3: Rebind hardware
+        if (this.state.rebindAttempts < MAX_REBIND_ATTEMPTS && this.maxRecoveryLevel >= types_1.RecoveryLevel.REBIND_HARDWARE) {
+            this.state.rebindAttempts++;
+            await rebindFn();
+            this.recordAction(types_1.RecoveryLevel.REBIND_HARDWARE, subsystem, 'rebind', true);
+            return;
+        }
+        // Escalate to sensing service restart
+        if (this.maxRecoveryLevel >= types_1.RecoveryLevel.RESTART_SERVICE) {
+            await this.callbacks.onRestartSensingService();
+            this.recordAction(types_1.RecoveryLevel.RESTART_SERVICE, subsystem, 'restart_sensing', true);
+        }
+    }
+    async attemptServiceRestart(subsystem) {
+        if (this.maxRecoveryLevel < types_1.RecoveryLevel.RESTART_SERVICE)
+            return;
+        // Reset daily counter if day changed
+        const today = this.getDayOfYear();
+        if (this.state.serviceRestartDay !== today) {
+            this.state.serviceRestarts = 0;
+            this.state.serviceRestartDay = today;
+        }
+        if (this.state.serviceRestarts < MAX_SERVICE_RESTARTS_PER_DAY) {
+            this.state.serviceRestarts++;
+            await this.callbacks.onRestartDeviceService();
+            this.recordAction(types_1.RecoveryLevel.RESTART_SERVICE, subsystem, 'service_restart', true);
+        }
+        else {
+            this.callbacks.onEmitRecoveryEvent('max_restarts_exceeded', {
+                subsystem,
+                restarts: this.state.serviceRestarts,
+            });
+        }
+    }
+    recordAction(level, subsystem, action, success) {
+        const record = {
+            level,
+            subsystem,
+            action,
+            timestamp: Date.now(),
+            success,
+        };
+        this.recoveryHistory.push(record);
+        // Keep last 100 actions
+        if (this.recoveryHistory.length > 100) {
+            this.recoveryHistory = this.recoveryHistory.slice(-100);
+        }
+        this.callbacks.onEmitRecoveryEvent('recovery_action', record);
+    }
+    resetAttempts() {
+        this.state.reloadAttempts = 0;
+        this.state.recreateAttempts = 0;
+        this.state.rebindAttempts = 0;
+    }
+    getDayOfYear() {
+        const now = new Date();
+        const start = new Date(now.getFullYear(), 0, 0);
+        const diff = now.getTime() - start.getTime();
+        return Math.floor(diff / (1000 * 60 * 60 * 24));
+    }
+    getRecoveryHistory() {
+        return [...this.recoveryHistory];
+    }
+}
+exports.RecoveryLadder = RecoveryLadder;
+//# sourceMappingURL=RecoveryLadder.js.map

package/dist/RecoveryLadder.js.map

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

package/dist/SensingConfig.d.ts

@@ -0,0 +1,33 @@
+/**
+ * SensingConfig — All 70+ server-tunable sensing parameters.
+ * Port of SensingConfig.kt. Thread-safe singleton with server-push merging.
+ *
+ * Default values match the Kotlin hardcoded behavior.
+ * Server can update ANY parameter via config.push event without recompile.
+ */
+import type { AudioConfig, AttentionConfig, EngagementConfig, GazeConfig, BodyConfig, EmotionConfig, DetectionConfig, ShadowConfig, ViewabilityConfig, InsightConfig, CaptureConfig, SensingConfigData } from './types';
+export declare class SensingConfig {
+    private config;
+    private hasServerConfig_;
+    constructor();
+    /**
+     * Merge server-pushed config update. Only overwrites fields present in the update.
+     * Called when a config.push event of type "sensing_config_update" arrives.
+     */
+    mergeWithServerUpdate(json: Record<string, unknown>): void;
+    get audio(): Readonly<AudioConfig>;
+    get attention(): Readonly<AttentionConfig>;
+    get engagement(): Readonly<EngagementConfig>;
+    get gaze(): Readonly<GazeConfig>;
+    get body(): Readonly<BodyConfig>;
+    get emotion(): Readonly<EmotionConfig>;
+    get detection(): Readonly<DetectionConfig>;
+    get shadow(): Readonly<ShadowConfig>;
+    get viewability(): Readonly<ViewabilityConfig>;
+    get insight(): Readonly<InsightConfig>;
+    get capture(): Readonly<CaptureConfig>;
+    hasServerConfig(): boolean;
+    /** Snapshot of all config for serialization. */
+    toJSON(): SensingConfigData;
+}
+//# sourceMappingURL=SensingConfig.d.ts.map

package/dist/SensingConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SensingConfig.d.ts","sourceRoot":"","sources":["../src/SensingConfig.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,aAAa,EACb,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAqGjB,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,gBAAgB,CAAS;;IAkBjC;;;OAGG;IACH,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAoB1D,IAAI,KAAK,IAAI,QAAQ,CAAC,WAAW,CAAC,CAEjC;IACD,IAAI,SAAS,IAAI,QAAQ,CAAC,eAAe,CAAC,CAEzC;IACD,IAAI,UAAU,IAAI,QAAQ,CAAC,gBAAgB,CAAC,CAE3C;IACD,IAAI,IAAI,IAAI,QAAQ,CAAC,UAAU,CAAC,CAE/B;IACD,IAAI,IAAI,IAAI,QAAQ,CAAC,UAAU,CAAC,CAE/B;IACD,IAAI,OAAO,IAAI,QAAQ,CAAC,aAAa,CAAC,CAErC;IACD,IAAI,SAAS,IAAI,QAAQ,CAAC,eAAe,CAAC,CAEzC;IACD,IAAI,MAAM,IAAI,QAAQ,CAAC,YAAY,CAAC,CAEnC;IACD,IAAI,WAAW,IAAI,QAAQ,CAAC,iBAAiB,CAAC,CAE7C;IACD,IAAI,OAAO,IAAI,QAAQ,CAAC,aAAa,CAAC,CAErC;IACD,IAAI,OAAO,IAAI,QAAQ,CAAC,aAAa,CAAC,CAErC;IAED,eAAe,IAAI,OAAO;IAI1B,gDAAgD;IAChD,MAAM,IAAI,iBAAiB;CAG5B"}

package/dist/SensingConfig.js

@@ -0,0 +1,179 @@
+"use strict";
+/**
+ * SensingConfig — All 70+ server-tunable sensing parameters.
+ * Port of SensingConfig.kt. Thread-safe singleton with server-push merging.
+ *
+ * Default values match the Kotlin hardcoded behavior.
+ * Server can update ANY parameter via config.push event without recompile.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SensingConfig = void 0;
+const DEFAULT_AUDIO = {
+    minClassificationConfidence: 0.3,
+    speechAudienceSizeFactor: 1.5,
+    musicAudienceSizeFactor: 1.2,
+    crowdAudienceSizeFactor: 2.0,
+    speechAttentionFactor: 0.6,
+    musicAttentionFactor: 0.4,
+    highSpeechReceptivity: 0.8,
+    lowSpeechReceptivity: 0.3,
+    musicReceptivity: 0.5,
+};
+const DEFAULT_ATTENTION = {
+    yawDivisor: 45.0,
+    pitchDivisor: 30.0,
+    eyeWeight: 0.3,
+    yawWeight: 0.4,
+    pitchWeight: 0.3,
+};
+const DEFAULT_ENGAGEMENT = {
+    poseWeight: 0.3,
+    emotionWeight: 0.4,
+    gazeWeight: 0.3,
+    highEngagementThreshold: 0.7,
+};
+const DEFAULT_GAZE = {
+    yawDirect: 15.0,
+    yawPartial: 35.0,
+    yawAway: 60.0,
+    pitchDirect: 10.0,
+    pitchPartial: 25.0,
+    pitchAway: 45.0,
+    stabilityWindow: 5,
+    directScore: 1.0,
+    partialScore: 0.5,
+    awayScore: 0.1,
+    focusDirectScore: 1.0,
+    focusPartialScore: 0.6,
+    focusAwayScore: 0.2,
+    minStabilityFrames: 3,
+};
+const DEFAULT_BODY = {
+    facingAngleThreshold: 30.0,
+    leanMagnitudeThreshold: 0.15,
+    movementSpeedThreshold: 50.0,
+    facingScore: 0.4,
+    leanScore: 0.3,
+    movementScore: 0.3,
+};
+const DEFAULT_EMOTION = {
+    confidenceThreshold: 0.5,
+    reactionThreshold: 0.6,
+    positiveSentimentFactor: 1.2,
+    negativeSentimentFactor: 0.8,
+    neutralSentimentFactor: 1.0,
+};
+const DEFAULT_DETECTION = {
+    personConfidenceThreshold: 0.5,
+};
+const DEFAULT_SHADOW = {
+    luxRatioHigh: 3.0,
+    luxRatioLow: 0.3,
+    cooldownMs: 30000,
+    baselineUpdateAlpha: 0.05,
+    tamperingThreshold: 10.0,
+};
+const DEFAULT_VIEWABILITY = {
+    darkLux: 10,
+    dimLux: 50,
+    goodLux: 200,
+    brightLux: 1000,
+    darkViewability: 0.2,
+    dimViewability: 0.5,
+    goodViewability: 1.0,
+    brightViewability: 0.8,
+    overbrightViewability: 0.4,
+};
+const DEFAULT_INSIGHT = {
+    baselineConfidence: 0.5,
+    brandBoost: 0.15,
+    productBoost: 0.1,
+    interestBoost: 0.2,
+    purchaseIntentBoost: 0.25,
+};
+const DEFAULT_CAPTURE = {
+    periodicIntervalMs: 300000, // 5 minutes (idle / no faces)
+    faceTriggeredIntervalMs: 30000, // 30 seconds (when faces detected)
+    jpegQuality: 70,
+};
+class SensingConfig {
+    constructor() {
+        this.hasServerConfig_ = false;
+        this.config = {
+            audio: { ...DEFAULT_AUDIO },
+            attention: { ...DEFAULT_ATTENTION },
+            engagement: { ...DEFAULT_ENGAGEMENT },
+            gaze: { ...DEFAULT_GAZE },
+            body: { ...DEFAULT_BODY },
+            emotion: { ...DEFAULT_EMOTION },
+            detection: { ...DEFAULT_DETECTION },
+            shadow: { ...DEFAULT_SHADOW },
+            viewability: { ...DEFAULT_VIEWABILITY },
+            insight: { ...DEFAULT_INSIGHT },
+            capture: { ...DEFAULT_CAPTURE },
+        };
+    }
+    /**
+     * Merge server-pushed config update. Only overwrites fields present in the update.
+     * Called when a config.push event of type "sensing_config_update" arrives.
+     */
+    mergeWithServerUpdate(json) {
+        for (const section of Object.keys(json)) {
+            const sectionData = json[section];
+            if (typeof sectionData === 'object' &&
+                sectionData !== null &&
+                section in this.config) {
+                const target = this.config[section];
+                const source = sectionData;
+                for (const key of Object.keys(source)) {
+                    if (key in target) {
+                        target[key] = source[key];
+                    }
+                }
+            }
+        }
+        this.hasServerConfig_ = true;
+    }
+    get audio() {
+        return this.config.audio;
+    }
+    get attention() {
+        return this.config.attention;
+    }
+    get engagement() {
+        return this.config.engagement;
+    }
+    get gaze() {
+        return this.config.gaze;
+    }
+    get body() {
+        return this.config.body;
+    }
+    get emotion() {
+        return this.config.emotion;
+    }
+    get detection() {
+        return this.config.detection;
+    }
+    get shadow() {
+        return this.config.shadow;
+    }
+    get viewability() {
+        return this.config.viewability;
+    }
+    get insight() {
+        return this.config.insight;
+    }
+    get capture() {
+        return this.config.capture;
+    }
+    hasServerConfig() {
+        return this.hasServerConfig_;
+    }
+    /** Snapshot of all config for serialization. */
+    toJSON() {
+        return JSON.parse(JSON.stringify(this.config));
+    }
+}
+exports.SensingConfig = SensingConfig;
+//# sourceMappingURL=SensingConfig.js.map

package/dist/SensingConfig.js.map

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

package/dist/SignalBuffer.d.ts

@@ -0,0 +1,56 @@
+/**
+ * SignalBuffer — Offline signal buffering using better-sqlite3.
+ * Port of SignalBuffer.kt (Room database) to cross-platform SQLite.
+ *
+ * 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
+ */
+import { SocketManager } from './SocketManager';
+export interface BufferedSignal {
+    id: number;
+    payload: string;
+    timestamp: number;
+    retryCount: number;
+}
+export declare class SignalBuffer {
+    static readonly MAX_CAPACITY = 8640;
+    static readonly FLUSH_BATCH_SIZE = 50;
+    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;
+    constructor(dbPath: string);
+    /**
+     * Buffer a signal for later sending.
+     * If at capacity, evicts oldest 10% first.
+     */
+    bufferSignal(payload: Record<string, unknown>): void;
+    /**
+     * Flush buffered signals via socket.
+     * Returns number of successfully sent signals.
+     */
+    flushBuffer(socketManager: SocketManager, limit?: number): number;
+    /**
+     * Prune signals older than 24 hours.
+     */
+    pruneOldSignals(): number;
+    /**
+     * Current number of buffered signals.
+     */
+    count(): number;
+    /**
+     * Close the database connection.
+     */
+    shutdown(): void;
+}
+//# sourceMappingURL=SignalBuffer.d.ts.map

package/dist/SignalBuffer.d.ts.map

@@ -0,0 +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"}

package/dist/SignalBuffer.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * SignalBuffer — Offline signal buffering using better-sqlite3.
+ * Port of SignalBuffer.kt (Room database) to cross-platform SQLite.
+ *
+ * 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
+ */
+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"));
+class SignalBuffer {
+    constructor(dbPath) {
+        const dir = path.dirname(dbPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        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 >= ?');
+    }
+    /**
+     * Buffer a signal for later sending.
+     * If at capacity, evicts oldest 10% first.
+     */
+    bufferSignal(payload) {
+        const count = this.count();
+        if (count >= SignalBuffer.MAX_CAPACITY) {
+            const evictCount = Math.ceil(SignalBuffer.MAX_CAPACITY * SignalBuffer.EVICT_RATIO);
+            this.deleteOldestNStmt.run(evictCount);
+        }
+        this.insertStmt.run(JSON.stringify(payload), Date.now());
+    }
+    /**
+     * Flush buffered signals via socket.
+     * Returns number of successfully sent signals.
+     */
+    flushBuffer(socketManager, limit = SignalBuffer.FLUSH_BATCH_SIZE) {
+        const signals = this.getOldestStmt.all(limit);
+        let sent = 0;
+        for (const signal of signals) {
+            try {
+                const payload = JSON.parse(signal.payload);
+                // Mark as buffered signal with metadata
+                payload._buffered = true;
+                payload._bufferedAt = signal.timestamp;
+                const success = socketManager.emitAudienceSignal(payload);
+                if (success) {
+                    this.deleteByIdStmt.run(signal.id);
+                    sent++;
+                }
+                else {
+                    this.incrementRetryStmt.run(signal.id);
+                }
+            }
+            catch {
+                // Corrupted payload — remove it
+                this.deleteByIdStmt.run(signal.id);
+            }
+        }
+        // Clean up signals that have exceeded max retries
+        this.deleteMaxRetriesStmt.run(SignalBuffer.MAX_RETRIES);
+        return sent;
+    }
+    /**
+     * Prune signals older than 24 hours.
+     */
+    pruneOldSignals() {
+        const cutoff = Date.now() - SignalBuffer.MAX_AGE_MS;
+        const result = this.pruneStmt.run(cutoff);
+        return result.changes;
+    }
+    /**
+     * Current number of buffered signals.
+     */
+    count() {
+        const row = this.countStmt.get();
+        return row.count;
+    }
+    /**
+     * Close the database connection.
+     */
+    shutdown() {
+        this.db.close();
+    }
+}
+exports.SignalBuffer = SignalBuffer;
+SignalBuffer.MAX_CAPACITY = 8640;
+SignalBuffer.FLUSH_BATCH_SIZE = 50;
+SignalBuffer.MAX_AGE_MS = 24 * 60 * 60 * 1000;
+SignalBuffer.MAX_RETRIES = 5;
+SignalBuffer.EVICT_RATIO = 0.1;
+//# sourceMappingURL=SignalBuffer.js.map

package/dist/SignalBuffer.js.map

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