@pollen-robotics/reachy-mini-sdk 1.10.0-dev.0.main.b50d97e → 1.10.0-dev.0.main.c8367cd

package/dist/lib/pending-replies.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Pending-reply bookkeeping for the ReachyMini SDK.
+ *
+ * The data channel multiplexes four request/response disciplines, each
+ * with its own correlation rule:
+ *
+ *   1. Reply slots — legacy `{type: ...}` commands whose replies carry
+ *      no request id, correlated by message TYPE. At most one call per
+ *      slot is in flight; a newer call supersedes the older waiter.
+ *   2. JSON-RPC — app-control calls correlated by an `id` we generate.
+ *   3. Motion completions — `wake_up` / `goto_sleep` acks, correlated
+ *      by command name, FIFO per command.
+ *   4. Broadcast waiters — daemon broadcasts (move / audio playback
+ *      lifecycle) matched by caller-supplied predicate.
+ *
+ * This class owns the WAITERS only: sending stays with `ReachyMini`
+ * (it owns the data channel), which passes send actions in as
+ * callbacks. Every session-teardown path settles the whole ledger at
+ * once via `settleAll`, so no caller is ever left hanging on a dead
+ * channel — and no future mechanism can be forgotten on a teardown
+ * path, because there is only one.
+ */
+import type { FaceTarget, ImuData } from './types.js';
+/**
+ * Fail-open ceiling for a single reply-slot request/response.
+ * Every slot command has a strict "one reply per request" contract, so
+ * a missing reply means the daemon either never got it or - crucially -
+ * predates that command entirely: an older daemon silently drops an
+ * unknown `type` and sends nothing back, which would otherwise leave the
+ * caller's promise pending forever (e.g. a newer SDK calling a command a
+ * 1.8.x daemon doesn't implement). Resolving `null` on timeout maps
+ * cleanly onto the "unsupported / failed" value every slot caller already
+ * handles. 4 s is comfortably above a WebRTC data-channel round trip on a
+ * congested phone link while still failing fast enough that a gated UI
+ * doesn't feel hung.
+ */
+export declare const SLOT_ROUNDTRIP_TIMEOUT_MS = 4000;
+/**
+ * Value type carried by each single-slot reply waiter. These daemon
+ * replies are correlated by message TYPE — the legacy command set
+ * carries no request ids — so at most one call per slot is in flight.
+ */
+export interface ReplySlotValues {
+    version: string | null;
+    hardware_id: string | null;
+    volume: number | null;
+    mic_volume: number | null;
+    first_wake_up: boolean | null;
+    tracked_face: FaceTarget | null;
+    robot_name: string | null;
+    delete_hf_token: boolean | null;
+    apply_audio_config: boolean | null;
+    read_audio_parameter: number[] | null;
+    imu: ImuData | null;
+}
+export type ReplySlotKey = keyof ReplySlotValues;
+export type MotionCommand = 'wake_up' | 'goto_sleep';
+/**
+ * Sentinel for a broadcast waiter that ran out its own timeout (as
+ * opposed to being rejected by a session teardown via `settleAll`).
+ * Callers that fail-open on timeout — `request()` — detect it by type
+ * instead of coupling to the message string.
+ */
+export declare class BroadcastTimeoutError extends Error {
+}
+export declare class PendingReplies {
+    private readonly _replySlots;
+    private _rpcCounter;
+    private readonly _pendingRpc;
+    private readonly _pendingMotion;
+    private _broadcastWaiters;
+    /**
+     * Register a slot waiter, run `send`, and await the matching daemon
+     * response. If a previous request on the same slot is still pending
+     * when a new one comes in, the older promise is resolved to `null`
+     * so its caller doesn't hang forever.
+     */
+    slotRoundtrip<K extends ReplySlotKey>(slot: K, send: () => void): Promise<ReplySlotValues[K] | null>;
+    /**
+     * Deliver a daemon reply to the pending waiter for `slot`, if any.
+     * Returns `true` when a waiter consumed the value — some message-handler
+     * branches use that to decide whether the message was theirs to swallow.
+     */
+    settleReplySlot<K extends ReplySlotKey>(slot: K, value: ReplySlotValues[K]): boolean;
+    /**
+     * One JSON-RPC round-trip: mint the correlation id, hand it to
+     * `send` (which reports `false` when the channel isn't open — the
+     * promise then rejects immediately), and await the matching
+     * response; rejects on timeout. Same shape as `slotRoundtrip`.
+     */
+    rpcRoundtrip(method: string, timeoutMs: number, send: (id: string) => boolean): Promise<unknown>;
+    /**
+     * Route a JSON-RPC RESPONSE (id + result/error) to its waiter.
+     * Returns `true` when the message was response-shaped — even if the
+     * waiter already timed out — so the caller can stop processing it;
+     * `false` for notifications and anything else.
+     */
+    settleRpcResponse(data: Record<string, unknown>): boolean;
+    /** FIFO waiter for one `wake_up` / `goto_sleep` ack; rejects on timeout. */
+    awaitMotion(command: MotionCommand, timeoutMs: number): Promise<void>;
+    /**
+     * Deliver a `wake_up` / `goto_sleep` reply to the oldest waiter.
+     * Returns `true` when a waiter consumed it; `false` when nothing was
+     * pending or the reply is neither a completion nor an error (the
+     * message then falls through to the caller's other branches).
+     */
+    settleMotion(command: MotionCommand, data: Record<string, unknown>): boolean;
+    /** Await the first broadcast matching `predicate`; rejects on timeout. */
+    awaitBroadcast(predicate: (m: Record<string, unknown>) => boolean, { timeoutMs, debugLabel }?: {
+        timeoutMs?: number;
+        debugLabel?: string;
+    }): Promise<Record<string, unknown>>;
+    /**
+     * Offer a broadcast to the waiters; the first (most recent) matching
+     * waiter consumes it. Returns `true` when one did.
+     */
+    matchBroadcast(data: Record<string, unknown>): boolean;
+    /**
+     * Settle the whole ledger against a dead channel: reply slots
+     * resolve `null` (the "no answer" value all slot callers handle;
+     * public wrappers coerce where needed, e.g. `applyAudioConfig` maps
+     * it to `false`), everything else rejects with `err`. Called from
+     * every session-teardown path.
+     */
+    settleAll(err: Error): void;
+}
+//# sourceMappingURL=pending-replies.d.ts.map

package/dist/lib/pending-replies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-replies.d.ts","sourceRoot":"","sources":["../../lib/pending-replies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,kBAAkB,EAAE,OAAO,GAAG,IAAI,CAAC;IACnC,oBAAoB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACtC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;CACvB;AACD,MAAM,MAAM,YAAY,GAAG,MAAM,eAAe,CAAC;AAEjD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;AAErD;;;;;GAKG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;CAAG;AAqBnD,qBAAa,cAAc;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiD;IAC7E,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiC;IAC7D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAG7B;IACF,OAAO,CAAC,iBAAiB,CAAyB;IAIlD;;;;;OAKG;IACH,aAAa,CAAC,CAAC,SAAS,YAAY,EAChC,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,MAAM,IAAI,GACjB,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IA4BrC;;;;OAIG;IACH,eAAe,CAAC,CAAC,SAAS,YAAY,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO;IASpF;;;;;OAKG;IACH,YAAY,CACR,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,GAC9B,OAAO,CAAC,OAAO,CAAC;IAcnB;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAqBzD,4EAA4E;IAC5E,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBrE;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAmB5E,0EAA0E;IAC1E,cAAc,CACV,SAAS,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,EAClD,EAAE,SAAgB,EAAE,UAAe,EAAE,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO,GACxF,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAgBnC;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAetD;;;;;;OAMG;IACH,SAAS,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI;CA2B9B"}

package/dist/lib/pending-replies.js

@@ -0,0 +1,255 @@
+/**
+ * Pending-reply bookkeeping for the ReachyMini SDK.
+ *
+ * The data channel multiplexes four request/response disciplines, each
+ * with its own correlation rule:
+ *
+ *   1. Reply slots — legacy `{type: ...}` commands whose replies carry
+ *      no request id, correlated by message TYPE. At most one call per
+ *      slot is in flight; a newer call supersedes the older waiter.
+ *   2. JSON-RPC — app-control calls correlated by an `id` we generate.
+ *   3. Motion completions — `wake_up` / `goto_sleep` acks, correlated
+ *      by command name, FIFO per command.
+ *   4. Broadcast waiters — daemon broadcasts (move / audio playback
+ *      lifecycle) matched by caller-supplied predicate.
+ *
+ * This class owns the WAITERS only: sending stays with `ReachyMini`
+ * (it owns the data channel), which passes send actions in as
+ * callbacks. Every session-teardown path settles the whole ledger at
+ * once via `settleAll`, so no caller is ever left hanging on a dead
+ * channel — and no future mechanism can be forgotten on a teardown
+ * path, because there is only one.
+ */
+/**
+ * Fail-open ceiling for a single reply-slot request/response.
+ * Every slot command has a strict "one reply per request" contract, so
+ * a missing reply means the daemon either never got it or - crucially -
+ * predates that command entirely: an older daemon silently drops an
+ * unknown `type` and sends nothing back, which would otherwise leave the
+ * caller's promise pending forever (e.g. a newer SDK calling a command a
+ * 1.8.x daemon doesn't implement). Resolving `null` on timeout maps
+ * cleanly onto the "unsupported / failed" value every slot caller already
+ * handles. 4 s is comfortably above a WebRTC data-channel round trip on a
+ * congested phone link while still failing fast enough that a gated UI
+ * doesn't feel hung.
+ */
+export const SLOT_ROUNDTRIP_TIMEOUT_MS = 4000;
+/**
+ * Sentinel for a broadcast waiter that ran out its own timeout (as
+ * opposed to being rejected by a session teardown via `settleAll`).
+ * Callers that fail-open on timeout — `request()` — detect it by type
+ * instead of coupling to the message string.
+ */
+export class BroadcastTimeoutError extends Error {
+}
+export class PendingReplies {
+    _replySlots = new Map();
+    _rpcCounter = 0;
+    _pendingRpc = new Map();
+    _pendingMotion = {
+        wake_up: [],
+        goto_sleep: [],
+    };
+    _broadcastWaiters = [];
+    /* ─── Reply slots ────────────────────────────────────────────────── */
+    /**
+     * Register a slot waiter, run `send`, and await the matching daemon
+     * response. If a previous request on the same slot is still pending
+     * when a new one comes in, the older promise is resolved to `null`
+     * so its caller doesn't hang forever.
+     */
+    slotRoundtrip(slot, send) {
+        return new Promise((resolve) => {
+            const prev = this._replySlots.get(slot);
+            if (prev)
+                prev(null);
+            let timer;
+            // Single settle path shared by the daemon response, supersession
+            // by a newer call, and the fail-open timeout below. It clears the
+            // timer once and detaches itself from the slot only if it's still
+            // the current occupant, so a stale settle (timed-out or superseded)
+            // can't clear a newer call's slot registration.
+            // Note: slots are keyed by command type, not request id, so this
+            // does not prevent a genuinely late daemon reply from being routed
+            // to a newer same-command caller — that cross-talk is inherent to
+            // the single-flight slot design.
+            const settle = (v) => {
+                if (timer !== undefined) {
+                    clearTimeout(timer);
+                    timer = undefined;
+                }
+                if (this._replySlots.get(slot) === settle)
+                    this._replySlots.delete(slot);
+                resolve(v);
+            };
+            this._replySlots.set(slot, settle);
+            timer = setTimeout(() => settle(null), SLOT_ROUNDTRIP_TIMEOUT_MS);
+            send();
+        });
+    }
+    /**
+     * Deliver a daemon reply to the pending waiter for `slot`, if any.
+     * Returns `true` when a waiter consumed the value — some message-handler
+     * branches use that to decide whether the message was theirs to swallow.
+     */
+    settleReplySlot(slot, value) {
+        const waiter = this._replySlots.get(slot);
+        if (!waiter)
+            return false;
+        waiter(value);
+        return true;
+    }
+    /* ─── JSON-RPC ───────────────────────────────────────────────────── */
+    /**
+     * One JSON-RPC round-trip: mint the correlation id, hand it to
+     * `send` (which reports `false` when the channel isn't open — the
+     * promise then rejects immediately), and await the matching
+     * response; rejects on timeout. Same shape as `slotRoundtrip`.
+     */
+    rpcRoundtrip(method, timeoutMs, send) {
+        const id = `rpc-${++this._rpcCounter}`;
+        if (!send(id)) {
+            return Promise.reject(new Error(`rpcCall(${method}): data channel not open`));
+        }
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this._pendingRpc.delete(id);
+                reject(new Error(`rpcCall(${method}) timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this._pendingRpc.set(id, { resolve, reject, timer });
+        });
+    }
+    /**
+     * Route a JSON-RPC RESPONSE (id + result/error) to its waiter.
+     * Returns `true` when the message was response-shaped — even if the
+     * waiter already timed out — so the caller can stop processing it;
+     * `false` for notifications and anything else.
+     */
+    settleRpcResponse(data) {
+        if (!('id' in data) || data.id == null || !('result' in data || 'error' in data)) {
+            return false;
+        }
+        const pending = this._pendingRpc.get(data.id);
+        if (!pending)
+            return true; // late reply to a timed-out call
+        this._pendingRpc.delete(data.id);
+        clearTimeout(pending.timer);
+        if ('error' in data && data.error) {
+            const err = data.error;
+            const e = new Error(err.message ?? 'rpc error');
+            e.reason = err.data?.reason;
+            pending.reject(e);
+        }
+        else {
+            pending.resolve(data.result);
+        }
+        return true;
+    }
+    /* ─── Motion completions (wake_up / goto_sleep) ──────────────────── */
+    /** FIFO waiter for one `wake_up` / `goto_sleep` ack; rejects on timeout. */
+    awaitMotion(command, timeoutMs) {
+        return new Promise((resolve, reject) => {
+            const entry = {
+                resolve,
+                reject,
+                timer: setTimeout(() => {
+                    const queue = this._pendingMotion[command];
+                    const idx = queue.indexOf(entry);
+                    if (idx !== -1)
+                        queue.splice(idx, 1);
+                    reject(new Error(`${command} timed out after ${timeoutMs}ms`));
+                }, timeoutMs),
+            };
+            this._pendingMotion[command].push(entry);
+        });
+    }
+    /**
+     * Deliver a `wake_up` / `goto_sleep` reply to the oldest waiter.
+     * Returns `true` when a waiter consumed it; `false` when nothing was
+     * pending or the reply is neither a completion nor an error (the
+     * message then falls through to the caller's other branches).
+     */
+    settleMotion(command, data) {
+        const queue = this._pendingMotion[command];
+        if (data.completed === true && queue.length > 0) {
+            const entry = queue.shift();
+            clearTimeout(entry.timer);
+            entry.resolve();
+            return true;
+        }
+        if (data.error && queue.length > 0) {
+            const entry = queue.shift();
+            clearTimeout(entry.timer);
+            entry.reject(new Error(`${command}: ${data.error}`));
+            return true;
+        }
+        return false;
+    }
+    /* ─── Broadcast waiters ──────────────────────────────────────────── */
+    /** Await the first broadcast matching `predicate`; rejects on timeout. */
+    awaitBroadcast(predicate, { timeoutMs = 5000, debugLabel = '' } = {}) {
+        return new Promise((resolve, reject) => {
+            const slot = {
+                predicate,
+                resolve,
+                reject,
+                timer: setTimeout(() => {
+                    const i = this._broadcastWaiters.indexOf(slot);
+                    if (i !== -1)
+                        this._broadcastWaiters.splice(i, 1);
+                    reject(new BroadcastTimeoutError(`broadcast timeout (${timeoutMs} ms): ${debugLabel}`));
+                }, timeoutMs),
+            };
+            this._broadcastWaiters.push(slot);
+        });
+    }
+    /**
+     * Offer a broadcast to the waiters; the first (most recent) matching
+     * waiter consumes it. Returns `true` when one did.
+     */
+    matchBroadcast(data) {
+        for (let i = this._broadcastWaiters.length - 1; i >= 0; i--) {
+            const slot = this._broadcastWaiters[i];
+            if (slot.predicate(data)) {
+                this._broadcastWaiters.splice(i, 1);
+                clearTimeout(slot.timer);
+                slot.resolve(data);
+                return true;
+            }
+        }
+        return false;
+    }
+    /* ─── Teardown ───────────────────────────────────────────────────── */
+    /**
+     * Settle the whole ledger against a dead channel: reply slots
+     * resolve `null` (the "no answer" value all slot callers handle;
+     * public wrappers coerce where needed, e.g. `applyAudioConfig` maps
+     * it to `false`), everything else rejects with `err`. Called from
+     * every session-teardown path.
+     */
+    settleAll(err) {
+        for (const waiter of [...this._replySlots.values()]) {
+            waiter(null);
+        }
+        this._replySlots.clear();
+        for (const pending of this._pendingRpc.values()) {
+            clearTimeout(pending.timer);
+            pending.reject(err);
+        }
+        this._pendingRpc.clear();
+        for (const command of Object.keys(this._pendingMotion)) {
+            const queue = this._pendingMotion[command];
+            while (queue.length) {
+                const entry = queue.shift();
+                clearTimeout(entry.timer);
+                entry.reject(err);
+            }
+        }
+        for (const slot of this._broadcastWaiters) {
+            clearTimeout(slot.timer);
+            slot.reject(err);
+        }
+        this._broadcastWaiters = [];
+    }
+}
+//# sourceMappingURL=pending-replies.js.map

package/dist/lib/pending-replies.js.map

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

package/dist/lib/pending-replies.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pending-replies.test.d.ts.map

package/dist/lib/pending-replies.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-replies.test.d.ts","sourceRoot":"","sources":["../../lib/pending-replies.test.ts"],"names":[],"mappings":""}

package/dist/lib/pending-replies.test.js

@@ -0,0 +1,217 @@
+/**
+ * PendingReplies ledger tests.
+ *
+ * The properties that must hold, per discipline:
+ *   - reply slots: single-flight per slot — a newer call supersedes the
+ *     older waiter with `null`; a missing daemon reply fails open to
+ *     `null` after the roundtrip timeout; a stale settle can't clobber
+ *     a newer call's registration;
+ *   - JSON-RPC: responses are routed by id; error responses carry the
+ *     message and machine-readable `reason`; a late reply to a
+ *     timed-out call is swallowed (still counts as response-shaped);
+ *   - motion completions: FIFO per command; replies that are neither a
+ *     completion nor an error fall through to the caller;
+ *   - broadcast waiters: predicate match consumes the most recent
+ *     waiter; timeout carries the debug label;
+ *   - settleAll(): one call settles all four ledgers — slots resolve
+ *     `null`, everything else rejects — so no caller can be left
+ *     hanging on a dead channel.
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { PendingReplies } from './pending-replies.js';
+let pending;
+beforeEach(() => {
+    vi.useFakeTimers();
+    pending = new PendingReplies();
+});
+afterEach(() => {
+    vi.useRealTimers();
+});
+describe('reply slots', () => {
+    it('resolves the waiter when the daemon reply lands', async () => {
+        const send = vi.fn();
+        const p = pending.slotRoundtrip('version', send);
+        expect(send).toHaveBeenCalledTimes(1);
+        expect(pending.settleReplySlot('version', '1.2.3')).toBe(true);
+        await expect(p).resolves.toBe('1.2.3');
+    });
+    it('reports an unclaimed reply so the handler can fall through', () => {
+        expect(pending.settleReplySlot('version', '1.2.3')).toBe(false);
+    });
+    it('supersedes a pending call on the same slot with null', async () => {
+        const first = pending.slotRoundtrip('volume', vi.fn());
+        const second = pending.slotRoundtrip('volume', vi.fn());
+        await expect(first).resolves.toBeNull();
+        pending.settleReplySlot('volume', 42);
+        await expect(second).resolves.toBe(42);
+    });
+    it('keeps unrelated slots independent', async () => {
+        const version = pending.slotRoundtrip('version', vi.fn());
+        const volume = pending.slotRoundtrip('volume', vi.fn());
+        pending.settleReplySlot('volume', 10);
+        pending.settleReplySlot('version', 'v');
+        await expect(volume).resolves.toBe(10);
+        await expect(version).resolves.toBe('v');
+    });
+    it('fails open to null when the daemon never answers (old daemon)', async () => {
+        const p = pending.slotRoundtrip('hardware_id', vi.fn());
+        await vi.advanceTimersByTimeAsync(4000);
+        await expect(p).resolves.toBeNull();
+        // The slot is free again: a late daemon reply finds no waiter.
+        expect(pending.settleReplySlot('hardware_id', 'late')).toBe(false);
+    });
+    it('a timed-out call does not clear a newer call on the same slot', async () => {
+        const first = pending.slotRoundtrip('robot_name', vi.fn());
+        // Just before the first call's timeout, a second call supersedes it…
+        await vi.advanceTimersByTimeAsync(3999);
+        const second = pending.slotRoundtrip('robot_name', vi.fn());
+        await expect(first).resolves.toBeNull();
+        // …and the second call's registration survives the first's timer.
+        await vi.advanceTimersByTimeAsync(1);
+        expect(pending.settleReplySlot('robot_name', 'Reachy')).toBe(true);
+        await expect(second).resolves.toBe('Reachy');
+    });
+});
+describe('JSON-RPC', () => {
+    /** Capture the id `rpcRoundtrip` mints for the send callback. */
+    function roundtrip(method, timeoutMs) {
+        let id = '';
+        const p = pending.rpcRoundtrip(method, timeoutMs, (mintedId) => {
+            id = mintedId;
+            return true;
+        });
+        return { id, p };
+    }
+    it('routes a result response to its waiter by id', async () => {
+        const { id, p } = roundtrip('apps.start', 1000);
+        expect(pending.settleRpcResponse({ id, result: { ok: true } })).toBe(true);
+        await expect(p).resolves.toEqual({ ok: true });
+    });
+    it('rejects immediately when the send reports a closed channel', async () => {
+        await expect(pending.rpcRoundtrip('apps.start', 1000, () => false)).rejects.toThrow('rpcCall(apps.start): data channel not open');
+    });
+    it('rejects with message and machine-readable reason on an error response', async () => {
+        const { id, p } = roundtrip('apps.start', 1000);
+        expect(pending.settleRpcResponse({
+            id,
+            error: { message: 'nope', data: { reason: 'app_not_found' } },
+        })).toBe(true);
+        await expect(p).rejects.toMatchObject({
+            message: 'nope',
+            reason: 'app_not_found',
+        });
+    });
+    it('swallows a late reply to a timed-out call (still response-shaped)', async () => {
+        const { id, p } = roundtrip('conversation.say', 1000);
+        void p.catch(() => { });
+        await vi.advanceTimersByTimeAsync(1000);
+        await expect(p).rejects.toThrow(/timed out after 1000ms/);
+        // The late reply must not fall through to the notification path.
+        expect(pending.settleRpcResponse({ id, result: 'late' })).toBe(true);
+    });
+    it('leaves notifications (no id) to the caller', () => {
+        expect(pending.settleRpcResponse({ method: 'conversation.turn', params: {} })).toBe(false);
+        // id present but neither result nor error: not a response either.
+        expect(pending.settleRpcResponse({ id: 'rpc-1', method: 'x' })).toBe(false);
+    });
+    it('mints unique correlation ids', () => {
+        const first = roundtrip('a', 1000);
+        const second = roundtrip('b', 1000);
+        expect(first.id).not.toBe(second.id);
+        void first.p.catch(() => { });
+        void second.p.catch(() => { });
+    });
+});
+describe('motion completions', () => {
+    it('resolves waiters in FIFO order per command', async () => {
+        const first = pending.awaitMotion('wake_up', 1000);
+        const second = pending.awaitMotion('wake_up', 1000);
+        const order = [];
+        void first.then(() => order.push('first'));
+        void second.then(() => order.push('second'));
+        expect(pending.settleMotion('wake_up', { completed: true })).toBe(true);
+        expect(pending.settleMotion('wake_up', { completed: true })).toBe(true);
+        await vi.runAllTimersAsync();
+        expect(order).toEqual(['first', 'second']);
+    });
+    it('rejects the oldest waiter on an error reply', async () => {
+        const p = pending.awaitMotion('goto_sleep', 1000);
+        expect(pending.settleMotion('goto_sleep', { error: 'motors off' })).toBe(true);
+        await expect(p).rejects.toThrow('goto_sleep: motors off');
+    });
+    it('falls through when the reply is neither completion nor error', () => {
+        void pending.awaitMotion('wake_up', 1000).catch(() => { });
+        // An intermediate ack without `completed` must not consume the waiter.
+        expect(pending.settleMotion('wake_up', { status: 'started' })).toBe(false);
+    });
+    it('falls through when nothing is pending', () => {
+        expect(pending.settleMotion('wake_up', { completed: true })).toBe(false);
+    });
+    it('rejects on timeout and forgets the waiter', async () => {
+        const p = pending.awaitMotion('wake_up', 1000);
+        void p.catch(() => { });
+        await vi.advanceTimersByTimeAsync(1000);
+        await expect(p).rejects.toThrow(/wake_up timed out/);
+        expect(pending.settleMotion('wake_up', { completed: true })).toBe(false);
+    });
+});
+describe('broadcast waiters', () => {
+    it('the first matching broadcast resolves the waiter', async () => {
+        const p = pending.awaitBroadcast((m) => m.type === 'move_done');
+        expect(pending.matchBroadcast({ type: 'other' })).toBe(false);
+        expect(pending.matchBroadcast({ type: 'move_done', id: 7 })).toBe(true);
+        await expect(p).resolves.toEqual({ type: 'move_done', id: 7 });
+    });
+    it('the most recent matching waiter wins', async () => {
+        const older = pending.awaitBroadcast((m) => m.type === 'x', { debugLabel: 'older' });
+        const newer = pending.awaitBroadcast((m) => m.type === 'x', { debugLabel: 'newer' });
+        expect(pending.matchBroadcast({ type: 'x', n: 1 })).toBe(true);
+        await expect(newer).resolves.toEqual({ type: 'x', n: 1 });
+        expect(pending.matchBroadcast({ type: 'x', n: 2 })).toBe(true);
+        await expect(older).resolves.toEqual({ type: 'x', n: 2 });
+    });
+    it('rejects on timeout with the debug label', async () => {
+        const p = pending.awaitBroadcast(() => false, { timeoutMs: 2000, debugLabel: 'move ack' });
+        void p.catch(() => { });
+        await vi.advanceTimersByTimeAsync(2000);
+        await expect(p).rejects.toThrow('broadcast timeout (2000 ms): move ack');
+    });
+});
+describe('settleAll (session teardown)', () => {
+    it('settles all four ledgers in one call', async () => {
+        const slot = pending.slotRoundtrip('version', vi.fn());
+        const rpc = pending.rpcRoundtrip('apps.start', 60_000, () => true);
+        const motion = pending.awaitMotion('wake_up', 60_000);
+        const broadcast = pending.awaitBroadcast(() => true, { timeoutMs: 60_000 });
+        // Pre-attach handlers so the synchronous rejections below don't
+        // trip Node's late-handling warning before the assertions run.
+        for (const p of [rpc, motion, broadcast])
+            void p.catch(() => { });
+        pending.settleAll(new Error('Session stopped'));
+        // Slots fail open (all slot callers handle null)…
+        await expect(slot).resolves.toBeNull();
+        // …everything else rejects with the teardown error.
+        await expect(rpc).rejects.toThrow('Session stopped');
+        await expect(motion).rejects.toThrow('Session stopped');
+        await expect(broadcast).rejects.toThrow('Session stopped');
+    });
+    it('leaves the ledger empty afterwards', () => {
+        void pending.slotRoundtrip('version', vi.fn());
+        void pending.awaitMotion('wake_up', 1000).catch(() => { });
+        void pending.awaitBroadcast(() => true).catch(() => { });
+        pending.settleAll(new Error('gone'));
+        expect(pending.settleReplySlot('version', 'v')).toBe(false);
+        expect(pending.settleMotion('wake_up', { completed: true })).toBe(false);
+        expect(pending.matchBroadcast({ type: 'any' })).toBe(false);
+    });
+    it('cancels the pending timers (no late rejection fires)', async () => {
+        // A rejection firing after settleAll would be an unhandled one —
+        // runAllTimersAsync below would surface it.
+        const motion = pending.awaitMotion('wake_up', 1000);
+        void motion.catch(() => { });
+        pending.settleAll(new Error('gone'));
+        await expect(motion).rejects.toThrow('gone');
+        await vi.runAllTimersAsync();
+    });
+});
+//# sourceMappingURL=pending-replies.test.js.map

package/dist/lib/pending-replies.test.js.map

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