@mentra/engine 3.2.0-dev.200 → 3.2.0-dev.208

package/build/services/StreamLifecycleController.js

@@ -1,173 +0,0 @@
-/**
- * Drives stream liveliness checks via a keep-alive heartbeat:
- * `setActive(true)` starts the timer; each tick sends a keep-alive with a
- * fresh ackId; `maxMissedAcks` consecutive timeouts fire `onTimeout`.
- *
- * Phone-owned successor to the retired cloud stream lifecycle controller.
- * It uses the local `LifecycleLogger` interface because pino is not a phone
- * dependency.
- *
- * Timers MUST go through BgTimer. React Native pauses plain `setInterval`
- * while MentraOS is backgrounded; glasses WHIP then auto-stops after 60s
- * without `keep_stream_alive`, and Mentra Call recovers by restarting ingest.
- */
-function productionTimers() {
-    // Lazy so unit tests that inject timers never parse react-native.
-    const { BgTimer } = require("../utils/timers");
-    return BgTimer;
-}
-/**
- * Keep-alive heartbeat. Activate to start ticks; each tick sends keep-alive
- * with a fresh ackId and arms a timeout. `maxMissedAcks` consecutive misses
- * fire `onTimeout`, and the caller is expected to tear the stream down.
- */
-export class StreamLifecycleController {
-    callbacks;
-    keepAliveTimer;
-    pendingAcks = new Map();
-    missedAcks = 0;
-    lastActivityMs;
-    active = false;
-    disposed = false;
-    logger;
-    streamId;
-    keepAliveIntervalMs;
-    ackTimeoutMs;
-    maxMissedAcks;
-    shouldSendKeepAlive;
-    now;
-    timers;
-    constructor(options, callbacks) {
-        this.callbacks = callbacks;
-        this.logger = options.logger.child({ component: "StreamLifecycle" });
-        this.streamId = options.streamId;
-        this.keepAliveIntervalMs = options.keepAliveIntervalMs;
-        this.ackTimeoutMs = options.ackTimeoutMs;
-        this.maxMissedAcks = options.maxMissedAcks;
-        this.shouldSendKeepAlive = options.shouldSendKeepAlive;
-        this.now = options.now ?? (() => Date.now());
-        this.timers = options.timers ?? productionTimers();
-        this.lastActivityMs = this.now();
-    }
-    setActive(active) {
-        if (this.disposed || this.active === active)
-            return;
-        this.logger.debug({ streamId: this.streamId, active }, "Updating lifecycle active state");
-        this.active = active;
-        if (active) {
-            this.startTimer();
-        }
-        else {
-            this.stopTimer();
-            this.clearPendingAcks();
-            this.missedAcks = 0;
-        }
-    }
-    recordActivity() {
-        this.lastActivityMs = this.now();
-        this.missedAcks = 0;
-    }
-    /**
-     * Send one keep-alive immediately instead of waiting for the next interval.
-     * Used when the BLE link comes back after a suspension: the glasses
-     * publisher's 60s watchdog has been running the whole time, so the first
-     * heartbeat after resume must not wait up to another full interval.
-     */
-    tickNow() {
-        if (this.disposed || !this.active)
-            return;
-        void this.tick();
-    }
-    handleAck(ackId) {
-        if (this.disposed)
-            return;
-        const ackInfo = this.pendingAcks.get(ackId);
-        if (!ackInfo) {
-            this.logger.warn({ streamId: this.streamId, ackId }, "Received unknown keep-alive ACK");
-            return;
-        }
-        this.timers.clearTimeout(ackInfo.timeout);
-        this.pendingAcks.delete(ackId);
-        this.recordActivity();
-        this.callbacks.onKeepAliveAcked?.(ackId, this.now() - ackInfo.sentAt);
-    }
-    dispose() {
-        if (this.disposed)
-            return;
-        this.disposed = true;
-        this.stopTimer();
-        this.clearPendingAcks();
-        this.logger.debug({ streamId: this.streamId }, "Lifecycle disposed");
-    }
-    getLastActivityMs() {
-        return this.lastActivityMs;
-    }
-    startTimer() {
-        if (this.keepAliveTimer)
-            return;
-        this.keepAliveTimer = this.timers.setInterval(() => {
-            void this.tick();
-        }, this.keepAliveIntervalMs);
-        this.logger.debug({ streamId: this.streamId }, "Keep-alive timer started");
-    }
-    stopTimer() {
-        if (this.keepAliveTimer) {
-            this.timers.clearInterval(this.keepAliveTimer);
-            this.keepAliveTimer = undefined;
-            this.logger.debug({ streamId: this.streamId }, "Keep-alive timer stopped");
-        }
-    }
-    async tick() {
-        if (this.disposed || !this.active)
-            return;
-        if (this.shouldSendKeepAlive && !this.shouldSendKeepAlive()) {
-            this.logger.warn({ streamId: this.streamId }, "Skipping keep-alive send because transport is unavailable");
-            return;
-        }
-        const ackId = this.createAckId();
-        const sentAt = this.now();
-        const timeout = this.timers.setTimeout(() => {
-            this.onAckTimeout(ackId, sentAt);
-        }, this.ackTimeoutMs);
-        this.pendingAcks.set(ackId, { sentAt, timeout });
-        this.callbacks.onKeepAliveSent?.(ackId);
-        try {
-            await this.callbacks.sendKeepAlive(ackId);
-        }
-        catch (error) {
-            this.logger.error({ streamId: this.streamId, ackId, error }, "Error sending keep-alive");
-        }
-    }
-    onAckTimeout(ackId, sentAt) {
-        if (this.disposed)
-            return;
-        // Race guard: handleAck may have processed the ACK between the timeout
-        // being scheduled and this callback running. In that case the ackId is
-        // no longer pending — counting it as missed would falsely escalate.
-        if (!this.pendingAcks.has(ackId))
-            return;
-        this.pendingAcks.delete(ackId);
-        this.missedAcks += 1;
-        const ageMs = this.now() - sentAt;
-        this.logger.warn({ streamId: this.streamId, ackId, missedAcks: this.missedAcks, ageMs }, "Keep-alive ACK timeout");
-        this.callbacks.onKeepAliveMissed?.(ackId, ageMs, this.missedAcks);
-        if (this.missedAcks >= this.maxMissedAcks) {
-            this.logger.error({
-                streamId: this.streamId,
-                missedAcks: this.missedAcks,
-                maxMissedAcks: this.maxMissedAcks,
-            }, "Maximum missed ACKs reached; triggering timeout");
-            void this.callbacks.onTimeout();
-        }
-    }
-    clearPendingAcks() {
-        for (const { timeout } of this.pendingAcks.values()) {
-            this.timers.clearTimeout(timeout);
-        }
-        this.pendingAcks.clear();
-    }
-    createAckId() {
-        return `a${this.now().toString(36).slice(-5)}`;
-    }
-}
-//# sourceMappingURL=StreamLifecycleController.js.map

package/build/services/StreamLifecycleController.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"StreamLifecycleController.js","sourceRoot":"","sources":["../../src/services/StreamLifecycleController.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAwCH,SAAS,gBAAgB;IACvB,kEAAkE;IAClE,MAAM,EAAC,OAAO,EAAC,GAAG,OAAO,CAAC,iBAAiB,CAAuC,CAAA;IAClF,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,yBAAyB;IAmBjB;IAlBX,cAAc,CAAS;IACvB,WAAW,GAAgC,IAAI,GAAG,EAAE,CAAA;IACpD,UAAU,GAAG,CAAC,CAAA;IACd,cAAc,CAAQ;IACtB,MAAM,GAAG,KAAK,CAAA;IACd,QAAQ,GAAG,KAAK,CAAA;IAEP,MAAM,CAAiB;IACvB,QAAQ,CAAQ;IAChB,mBAAmB,CAAQ;IAC3B,YAAY,CAAQ;IACpB,aAAa,CAAQ;IACrB,mBAAmB,CAAgB;IACnC,GAAG,CAAc;IACjB,MAAM,CAAyB;IAEhD,YACE,OAA+B,EACd,SAAmC;QAAnC,cAAS,GAAT,SAAS,CAA0B;QAEpD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAC,SAAS,EAAE,iBAAiB,EAAC,CAAC,CAAA;QAClE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;QAChC,IAAI,CAAC,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAA;QACtD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAA;QACxC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAA;QAC1C,IAAI,CAAC,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAA;QACtD,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;QAC5C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,gBAAgB,EAAE,CAAA;QAClD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAClC,CAAC;IAED,SAAS,CAAC,MAAe;QACvB,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM;YAAE,OAAM;QAEnD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAC,EAAE,iCAAiC,CAAC,CAAA;QAEvF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,UAAU,EAAE,CAAA;QACnB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,EAAE,CAAA;YAChB,IAAI,CAAC,gBAAgB,EAAE,CAAA;YACvB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAA;QACrB,CAAC;IACH,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAChC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAA;IACrB,CAAC;IAED;;;;;OAKG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAM;QACzC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAA;IAClB,CAAC;IAED,SAAS,CAAC,KAAa;QACrB,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAM;QAEzB,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAC,EAAE,iCAAiC,CAAC,CAAA;YACrF,OAAM;QACR,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACzC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC9B,IAAI,CAAC,cAAc,EAAE,CAAA;QAErB,IAAI,CAAC,SAAS,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACvE,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAM;QAEzB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;QACpB,IAAI,CAAC,SAAS,EAAE,CAAA;QAChB,IAAI,CAAC,gBAAgB,EAAE,CAAA;QACvB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAC,EAAE,oBAAoB,CAAC,CAAA;IACpE,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,cAAc,CAAA;IAC5B,CAAC;IAEO,UAAU;QAChB,IAAI,IAAI,CAAC,cAAc;YAAE,OAAM;QAC/B,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE;YACjD,KAAK,IAAI,CAAC,IAAI,EAAE,CAAA;QAClB,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAA;QAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAC,EAAE,0BAA0B,CAAC,CAAA;IAC1E,CAAC;IAEO,SAAS;QACf,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;YAC9C,IAAI,CAAC,cAAc,GAAG,SAAS,CAAA;YAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAC,EAAE,0BAA0B,CAAC,CAAA;QAC1E,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAI;QAChB,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAM;QAEzC,IAAI,IAAI,CAAC,mBAAmB,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;YAC5D,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,EAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAC,EACzB,2DAA2D,CAC5D,CAAA;YACD,OAAM;QACR,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAEzB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;YAC1C,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QAClC,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;QAErB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,EAAC,MAAM,EAAE,OAAO,EAAC,CAAC,CAAA;QAC9C,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC,KAAK,CAAC,CAAA;QAEvC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAC,EAAE,0BAA0B,CAAC,CAAA;QACxF,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,KAAa,EAAE,MAAc;QAChD,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAM;QAEzB,uEAAuE;QACvE,uEAAuE;QACvE,oEAAoE;QACpE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAM;QAExC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC9B,IAAI,CAAC,UAAU,IAAI,CAAC,CAAA;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAA;QAEjC,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,EAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,EAAC,EACpE,wBAAwB,CACzB,CAAA;QAED,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;QAEjE,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YAC1C,IAAI,CAAC,MAAM,CAAC,KAAK,CACf;gBACE,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,aAAa,EAAE,IAAI,CAAC,aAAa;aAClC,EACD,iDAAiD,CAClD,CAAA;YAED,KAAK,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAA;QACjC,CAAC;IACH,CAAC;IAEO,gBAAgB;QACtB,KAAK,MAAM,EAAC,OAAO,EAAC,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;YAClD,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;QACnC,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAA;IAC1B,CAAC;IAEO,WAAW;QACjB,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAChD,CAAC;CACF","sourcesContent":["/**\n * Drives stream liveliness checks via a keep-alive heartbeat:\n * `setActive(true)` starts the timer; each tick sends a keep-alive with a\n * fresh ackId; `maxMissedAcks` consecutive timeouts fire `onTimeout`.\n *\n * Phone-owned successor to the retired cloud stream lifecycle controller.\n * It uses the local `LifecycleLogger` interface because pino is not a phone\n * dependency.\n *\n * Timers MUST go through BgTimer. React Native pauses plain `setInterval`\n * while MentraOS is backgrounded; glasses WHIP then auto-stops after 60s\n * without `keep_stream_alive`, and Mentra Call recovers by restarting ingest.\n */\n\nexport interface LifecycleLogger {\n  child(bindings: Record<string, unknown>): LifecycleLogger\n  debug(...args: unknown[]): void\n  warn(...args: unknown[]): void\n  error(...args: unknown[]): void\n}\n\ninterface StreamLifecycleCallbacks {\n  sendKeepAlive: (ackId: string) => Promise<void> | void\n  onTimeout: () => Promise<void> | void\n  onKeepAliveSent?: (ackId: string) => void\n  onKeepAliveAcked?: (ackId: string, ageMs: number) => void\n  onKeepAliveMissed?: (ackId: string, ageMs: number, missedCount: number) => void\n}\n\nexport interface StreamLifecycleTimerApi {\n  setInterval: (callback: () => void, delay: number) => number\n  clearInterval: (intervalId: number) => void\n  setTimeout: (callback: () => void, delay: number) => number\n  clearTimeout: (timeoutId: number) => void\n}\n\nexport interface StreamLifecycleOptions {\n  logger: LifecycleLogger\n  streamId: string\n  keepAliveIntervalMs: number\n  ackTimeoutMs: number\n  maxMissedAcks: number\n  shouldSendKeepAlive?: () => boolean\n  now?: () => number\n  timers?: StreamLifecycleTimerApi\n}\n\ninterface PendingAckInfo {\n  sentAt: number\n  timeout: number\n}\n\nfunction productionTimers(): StreamLifecycleTimerApi {\n  // Lazy so unit tests that inject timers never parse react-native.\n  const {BgTimer} = require(\"../utils/timers\") as {BgTimer: StreamLifecycleTimerApi}\n  return BgTimer\n}\n\n/**\n * Keep-alive heartbeat. Activate to start ticks; each tick sends keep-alive\n * with a fresh ackId and arms a timeout. `maxMissedAcks` consecutive misses\n * fire `onTimeout`, and the caller is expected to tear the stream down.\n */\nexport class StreamLifecycleController {\n  private keepAliveTimer?: number\n  private pendingAcks: Map<string, PendingAckInfo> = new Map()\n  private missedAcks = 0\n  private lastActivityMs: number\n  private active = false\n  private disposed = false\n\n  private readonly logger: LifecycleLogger\n  private readonly streamId: string\n  private readonly keepAliveIntervalMs: number\n  private readonly ackTimeoutMs: number\n  private readonly maxMissedAcks: number\n  private readonly shouldSendKeepAlive?: () => boolean\n  private readonly now: () => number\n  private readonly timers: StreamLifecycleTimerApi\n\n  constructor(\n    options: StreamLifecycleOptions,\n    private readonly callbacks: StreamLifecycleCallbacks,\n  ) {\n    this.logger = options.logger.child({component: \"StreamLifecycle\"})\n    this.streamId = options.streamId\n    this.keepAliveIntervalMs = options.keepAliveIntervalMs\n    this.ackTimeoutMs = options.ackTimeoutMs\n    this.maxMissedAcks = options.maxMissedAcks\n    this.shouldSendKeepAlive = options.shouldSendKeepAlive\n    this.now = options.now ?? (() => Date.now())\n    this.timers = options.timers ?? productionTimers()\n    this.lastActivityMs = this.now()\n  }\n\n  setActive(active: boolean): void {\n    if (this.disposed || this.active === active) return\n\n    this.logger.debug({streamId: this.streamId, active}, \"Updating lifecycle active state\")\n\n    this.active = active\n    if (active) {\n      this.startTimer()\n    } else {\n      this.stopTimer()\n      this.clearPendingAcks()\n      this.missedAcks = 0\n    }\n  }\n\n  recordActivity(): void {\n    this.lastActivityMs = this.now()\n    this.missedAcks = 0\n  }\n\n  /**\n   * Send one keep-alive immediately instead of waiting for the next interval.\n   * Used when the BLE link comes back after a suspension: the glasses\n   * publisher's 60s watchdog has been running the whole time, so the first\n   * heartbeat after resume must not wait up to another full interval.\n   */\n  tickNow(): void {\n    if (this.disposed || !this.active) return\n    void this.tick()\n  }\n\n  handleAck(ackId: string): void {\n    if (this.disposed) return\n\n    const ackInfo = this.pendingAcks.get(ackId)\n    if (!ackInfo) {\n      this.logger.warn({streamId: this.streamId, ackId}, \"Received unknown keep-alive ACK\")\n      return\n    }\n\n    this.timers.clearTimeout(ackInfo.timeout)\n    this.pendingAcks.delete(ackId)\n    this.recordActivity()\n\n    this.callbacks.onKeepAliveAcked?.(ackId, this.now() - ackInfo.sentAt)\n  }\n\n  dispose(): void {\n    if (this.disposed) return\n\n    this.disposed = true\n    this.stopTimer()\n    this.clearPendingAcks()\n    this.logger.debug({streamId: this.streamId}, \"Lifecycle disposed\")\n  }\n\n  getLastActivityMs(): number {\n    return this.lastActivityMs\n  }\n\n  private startTimer(): void {\n    if (this.keepAliveTimer) return\n    this.keepAliveTimer = this.timers.setInterval(() => {\n      void this.tick()\n    }, this.keepAliveIntervalMs)\n    this.logger.debug({streamId: this.streamId}, \"Keep-alive timer started\")\n  }\n\n  private stopTimer(): void {\n    if (this.keepAliveTimer) {\n      this.timers.clearInterval(this.keepAliveTimer)\n      this.keepAliveTimer = undefined\n      this.logger.debug({streamId: this.streamId}, \"Keep-alive timer stopped\")\n    }\n  }\n\n  private async tick(): Promise<void> {\n    if (this.disposed || !this.active) return\n\n    if (this.shouldSendKeepAlive && !this.shouldSendKeepAlive()) {\n      this.logger.warn(\n        {streamId: this.streamId},\n        \"Skipping keep-alive send because transport is unavailable\",\n      )\n      return\n    }\n\n    const ackId = this.createAckId()\n    const sentAt = this.now()\n\n    const timeout = this.timers.setTimeout(() => {\n      this.onAckTimeout(ackId, sentAt)\n    }, this.ackTimeoutMs)\n\n    this.pendingAcks.set(ackId, {sentAt, timeout})\n    this.callbacks.onKeepAliveSent?.(ackId)\n\n    try {\n      await this.callbacks.sendKeepAlive(ackId)\n    } catch (error) {\n      this.logger.error({streamId: this.streamId, ackId, error}, \"Error sending keep-alive\")\n    }\n  }\n\n  private onAckTimeout(ackId: string, sentAt: number): void {\n    if (this.disposed) return\n\n    // Race guard: handleAck may have processed the ACK between the timeout\n    // being scheduled and this callback running. In that case the ackId is\n    // no longer pending — counting it as missed would falsely escalate.\n    if (!this.pendingAcks.has(ackId)) return\n\n    this.pendingAcks.delete(ackId)\n    this.missedAcks += 1\n    const ageMs = this.now() - sentAt\n\n    this.logger.warn(\n      {streamId: this.streamId, ackId, missedAcks: this.missedAcks, ageMs},\n      \"Keep-alive ACK timeout\",\n    )\n\n    this.callbacks.onKeepAliveMissed?.(ackId, ageMs, this.missedAcks)\n\n    if (this.missedAcks >= this.maxMissedAcks) {\n      this.logger.error(\n        {\n          streamId: this.streamId,\n          missedAcks: this.missedAcks,\n          maxMissedAcks: this.maxMissedAcks,\n        },\n        \"Maximum missed ACKs reached; triggering timeout\",\n      )\n\n      void this.callbacks.onTimeout()\n    }\n  }\n\n  private clearPendingAcks(): void {\n    for (const {timeout} of this.pendingAcks.values()) {\n      this.timers.clearTimeout(timeout)\n    }\n    this.pendingAcks.clear()\n  }\n\n  private createAckId(): string {\n    return `a${this.now().toString(36).slice(-5)}`\n  }\n}\n"]}

package/src/services/StreamLifecycleController.ts

@@ -1,243 +0,0 @@
-/**
- * Drives stream liveliness checks via a keep-alive heartbeat:
- * `setActive(true)` starts the timer; each tick sends a keep-alive with a
- * fresh ackId; `maxMissedAcks` consecutive timeouts fire `onTimeout`.
- *
- * Phone-owned successor to the retired cloud stream lifecycle controller.
- * It uses the local `LifecycleLogger` interface because pino is not a phone
- * dependency.
- *
- * Timers MUST go through BgTimer. React Native pauses plain `setInterval`
- * while MentraOS is backgrounded; glasses WHIP then auto-stops after 60s
- * without `keep_stream_alive`, and Mentra Call recovers by restarting ingest.
- */
-
-export interface LifecycleLogger {
-  child(bindings: Record<string, unknown>): LifecycleLogger
-  debug(...args: unknown[]): void
-  warn(...args: unknown[]): void
-  error(...args: unknown[]): void
-}
-
-interface StreamLifecycleCallbacks {
-  sendKeepAlive: (ackId: string) => Promise<void> | void
-  onTimeout: () => Promise<void> | void
-  onKeepAliveSent?: (ackId: string) => void
-  onKeepAliveAcked?: (ackId: string, ageMs: number) => void
-  onKeepAliveMissed?: (ackId: string, ageMs: number, missedCount: number) => void
-}
-
-export interface StreamLifecycleTimerApi {
-  setInterval: (callback: () => void, delay: number) => number
-  clearInterval: (intervalId: number) => void
-  setTimeout: (callback: () => void, delay: number) => number
-  clearTimeout: (timeoutId: number) => void
-}
-
-export interface StreamLifecycleOptions {
-  logger: LifecycleLogger
-  streamId: string
-  keepAliveIntervalMs: number
-  ackTimeoutMs: number
-  maxMissedAcks: number
-  shouldSendKeepAlive?: () => boolean
-  now?: () => number
-  timers?: StreamLifecycleTimerApi
-}
-
-interface PendingAckInfo {
-  sentAt: number
-  timeout: number
-}
-
-function productionTimers(): StreamLifecycleTimerApi {
-  // Lazy so unit tests that inject timers never parse react-native.
-  const {BgTimer} = require("../utils/timers") as {BgTimer: StreamLifecycleTimerApi}
-  return BgTimer
-}
-
-/**
- * Keep-alive heartbeat. Activate to start ticks; each tick sends keep-alive
- * with a fresh ackId and arms a timeout. `maxMissedAcks` consecutive misses
- * fire `onTimeout`, and the caller is expected to tear the stream down.
- */
-export class StreamLifecycleController {
-  private keepAliveTimer?: number
-  private pendingAcks: Map<string, PendingAckInfo> = new Map()
-  private missedAcks = 0
-  private lastActivityMs: number
-  private active = false
-  private disposed = false
-
-  private readonly logger: LifecycleLogger
-  private readonly streamId: string
-  private readonly keepAliveIntervalMs: number
-  private readonly ackTimeoutMs: number
-  private readonly maxMissedAcks: number
-  private readonly shouldSendKeepAlive?: () => boolean
-  private readonly now: () => number
-  private readonly timers: StreamLifecycleTimerApi
-
-  constructor(
-    options: StreamLifecycleOptions,
-    private readonly callbacks: StreamLifecycleCallbacks,
-  ) {
-    this.logger = options.logger.child({component: "StreamLifecycle"})
-    this.streamId = options.streamId
-    this.keepAliveIntervalMs = options.keepAliveIntervalMs
-    this.ackTimeoutMs = options.ackTimeoutMs
-    this.maxMissedAcks = options.maxMissedAcks
-    this.shouldSendKeepAlive = options.shouldSendKeepAlive
-    this.now = options.now ?? (() => Date.now())
-    this.timers = options.timers ?? productionTimers()
-    this.lastActivityMs = this.now()
-  }
-
-  setActive(active: boolean): void {
-    if (this.disposed || this.active === active) return
-
-    this.logger.debug({streamId: this.streamId, active}, "Updating lifecycle active state")
-
-    this.active = active
-    if (active) {
-      this.startTimer()
-    } else {
-      this.stopTimer()
-      this.clearPendingAcks()
-      this.missedAcks = 0
-    }
-  }
-
-  recordActivity(): void {
-    this.lastActivityMs = this.now()
-    this.missedAcks = 0
-  }
-
-  /**
-   * Send one keep-alive immediately instead of waiting for the next interval.
-   * Used when the BLE link comes back after a suspension: the glasses
-   * publisher's 60s watchdog has been running the whole time, so the first
-   * heartbeat after resume must not wait up to another full interval.
-   */
-  tickNow(): void {
-    if (this.disposed || !this.active) return
-    void this.tick()
-  }
-
-  handleAck(ackId: string): void {
-    if (this.disposed) return
-
-    const ackInfo = this.pendingAcks.get(ackId)
-    if (!ackInfo) {
-      this.logger.warn({streamId: this.streamId, ackId}, "Received unknown keep-alive ACK")
-      return
-    }
-
-    this.timers.clearTimeout(ackInfo.timeout)
-    this.pendingAcks.delete(ackId)
-    this.recordActivity()
-
-    this.callbacks.onKeepAliveAcked?.(ackId, this.now() - ackInfo.sentAt)
-  }
-
-  dispose(): void {
-    if (this.disposed) return
-
-    this.disposed = true
-    this.stopTimer()
-    this.clearPendingAcks()
-    this.logger.debug({streamId: this.streamId}, "Lifecycle disposed")
-  }
-
-  getLastActivityMs(): number {
-    return this.lastActivityMs
-  }
-
-  private startTimer(): void {
-    if (this.keepAliveTimer) return
-    this.keepAliveTimer = this.timers.setInterval(() => {
-      void this.tick()
-    }, this.keepAliveIntervalMs)
-    this.logger.debug({streamId: this.streamId}, "Keep-alive timer started")
-  }
-
-  private stopTimer(): void {
-    if (this.keepAliveTimer) {
-      this.timers.clearInterval(this.keepAliveTimer)
-      this.keepAliveTimer = undefined
-      this.logger.debug({streamId: this.streamId}, "Keep-alive timer stopped")
-    }
-  }
-
-  private async tick(): Promise<void> {
-    if (this.disposed || !this.active) return
-
-    if (this.shouldSendKeepAlive && !this.shouldSendKeepAlive()) {
-      this.logger.warn(
-        {streamId: this.streamId},
-        "Skipping keep-alive send because transport is unavailable",
-      )
-      return
-    }
-
-    const ackId = this.createAckId()
-    const sentAt = this.now()
-
-    const timeout = this.timers.setTimeout(() => {
-      this.onAckTimeout(ackId, sentAt)
-    }, this.ackTimeoutMs)
-
-    this.pendingAcks.set(ackId, {sentAt, timeout})
-    this.callbacks.onKeepAliveSent?.(ackId)
-
-    try {
-      await this.callbacks.sendKeepAlive(ackId)
-    } catch (error) {
-      this.logger.error({streamId: this.streamId, ackId, error}, "Error sending keep-alive")
-    }
-  }
-
-  private onAckTimeout(ackId: string, sentAt: number): void {
-    if (this.disposed) return
-
-    // Race guard: handleAck may have processed the ACK between the timeout
-    // being scheduled and this callback running. In that case the ackId is
-    // no longer pending — counting it as missed would falsely escalate.
-    if (!this.pendingAcks.has(ackId)) return
-
-    this.pendingAcks.delete(ackId)
-    this.missedAcks += 1
-    const ageMs = this.now() - sentAt
-
-    this.logger.warn(
-      {streamId: this.streamId, ackId, missedAcks: this.missedAcks, ageMs},
-      "Keep-alive ACK timeout",
-    )
-
-    this.callbacks.onKeepAliveMissed?.(ackId, ageMs, this.missedAcks)
-
-    if (this.missedAcks >= this.maxMissedAcks) {
-      this.logger.error(
-        {
-          streamId: this.streamId,
-          missedAcks: this.missedAcks,
-          maxMissedAcks: this.maxMissedAcks,
-        },
-        "Maximum missed ACKs reached; triggering timeout",
-      )
-
-      void this.callbacks.onTimeout()
-    }
-  }
-
-  private clearPendingAcks(): void {
-    for (const {timeout} of this.pendingAcks.values()) {
-      this.timers.clearTimeout(timeout)
-    }
-    this.pendingAcks.clear()
-  }
-
-  private createAckId(): string {
-    return `a${this.now().toString(36).slice(-5)}`
-  }
-}