@tai42/studio-sdk 16.0.0 → 17.0.0

package/dist/element-slot.d.ts

@@ -1,3 +1,14 @@
+/**
+ * The runtime half of the `asChild` slot contract.
+ *
+ * Radix clones its own props onto the node an `asChild` slot is given, so the
+ * slot takes exactly one ELEMENT. `ReactElement` states half of that: it rejects
+ * a string, which would throw inside Radix anyway. It does NOT reject a
+ * FRAGMENT — `<></>` is a `ReactElement` whose `type` is the fragment symbol —
+ * and a fragment is the worse of the two, because React drops every prop cloned
+ * onto it: the opener renders, carries no `aria-haspopup`/`aria-expanded`/
+ * `aria-controls` and no handler, and fails nothing.
+ */
 import type { ReactElement } from 'react';
 /** Raises when an `asChild` slot is handed a fragment. `slot` names the prop. */
 export declare function assertSlotElement(element: ReactElement, slot: string): void;

package/dist/element-slot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"element-slot.d.ts","sourceRoot":"","sources":["../src/element-slot.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAM3E"}
+{"version":3,"file":"element-slot.d.ts","sourceRoot":"","sources":["../src/element-slot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAM3E"}

package/dist/element-slot.js

@@ -1,14 +1,3 @@
-/**
- * The runtime half of the `asChild` slot contract.
- *
- * Radix clones its own props onto the node an `asChild` slot is given, so the
- * slot takes exactly one ELEMENT. `ReactElement` states half of that: it rejects
- * a string, which would throw inside Radix anyway. It does NOT reject a
- * FRAGMENT — `<></>` is a `ReactElement` whose `type` is the fragment symbol —
- * and a fragment is the worse of the two, because React drops every prop cloned
- * onto it: the opener renders, carries no `aria-haspopup`/`aria-expanded`/
- * `aria-controls` and no handler, and fails nothing.
- */
 import { Fragment } from 'react';
 /** Raises when an `asChild` slot is handed a fragment. `slot` names the prop. */
 export function assertSlotElement(element, slot) {

package/dist/element-slot.js.map

@@ -1 +1 @@
-{"version":3,"file":"element-slot.js","sourceRoot":"","sources":["../src/element-slot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGjC,iFAAiF;AACjF,MAAM,UAAU,iBAAiB,CAAC,OAAqB,EAAE,IAAY;IACnE,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO;IACtC,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,qEAAqE;QAC1E,mEAAmE,CACtE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"element-slot.js","sourceRoot":"","sources":["../src/element-slot.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjC,iFAAiF;AACjF,MAAM,UAAU,iBAAiB,CAAC,OAAqB,EAAE,IAAY;IACnE,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO;IACtC,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,qEAAqE;QAC1E,mEAAmE,CACtE,CAAC;AACJ,CAAC"}

package/dist/guards.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Shared runtime type guards. Internal to studio-sdk — never re-exported from
+ * `index.ts` or any subpath, so it stays off the public plugin surface.
+ */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=guards.d.ts.map

package/dist/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../src/guards.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE"}

package/dist/guards.js

@@ -0,0 +1,8 @@
+/**
+ * Shared runtime type guards. Internal to studio-sdk — never re-exported from
+ * `index.ts` or any subpath, so it stays off the public plugin surface.
+ */
+export function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=guards.js.map

package/dist/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../src/guards.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/hooks/interactions-connection.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The SSE reconnect driver behind `useInteractionsStream`: it owns the fetch +
+ * ReadableStream tail (via the api-client's `streamInteractions`, never
+ * EventSource), the capped-exponential-with-jitter reconnect backoff, the
+ * on-(re)connect resync, and the wiring that folds each frame through the pure
+ * overlay reducer and republishes the merged list. React state flows in as the
+ * dispatchers the hook passes; this file holds no React.
+ */
+import type { ApiClient, Interaction } from '@tai42/api-client';
+import type { Dispatch, RefObject, SetStateAction } from 'react';
+import { type LiveOverlay, type StreamInteraction } from './interactions-stream';
+/** The live connection status the hook renders from. */
+export interface ConnectionState {
+    readonly connected: boolean;
+    readonly error: Error | null;
+    /**
+     * The interactions store is not configured on this deployment: the stream
+     * answered with a terminal 501 `interactions-not-configured`. Reconnection is
+     * abandoned (retrying would replay the same refusal forever) and the consumer
+     * renders the muted OFF state instead of a red error or a floating badge.
+     */
+    readonly disabled: boolean;
+}
+/** Everything the driver reads or writes, supplied by the hook's render. */
+export interface InteractionsStreamDeps {
+    readonly api: ApiClient;
+    readonly overlayRef: RefObject<LiveOverlay>;
+    readonly epochRef: RefObject<number>;
+    readonly seedRef: RefObject<readonly Interaction[]>;
+    readonly onResyncRef: RefObject<() => boolean | Promise<boolean>>;
+    readonly onUnauthorized: () => void;
+    readonly setConnectionState: Dispatch<SetStateAction<ConnectionState>>;
+    readonly setInteractions: Dispatch<SetStateAction<StreamInteraction[]>>;
+    readonly setCountEpoch: Dispatch<SetStateAction<number>>;
+}
+/**
+ * Start the tail-only interactions stream and return the effect cleanup. The
+ * abort signal is the single cancellation source of truth: cleanup aborts it, every
+ * loop guard reads it fresh, and a fresh mount starts from an empty overlay at epoch
+ * 0 so a re-run never inherits the prior run's tail or its epoch stamps.
+ */
+export declare function startInteractionsStream(deps: InteractionsStreamDeps): () => void;
+//# sourceMappingURL=interactions-connection.d.ts.map

package/dist/hooks/interactions-connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactions-connection.d.ts","sourceRoot":"","sources":["../../src/hooks/interactions-connection.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAGjE,OAAO,EAEL,KAAK,WAAW,EAOhB,KAAK,iBAAiB,EAEvB,MAAM,uBAAuB,CAAC;AAW/B,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,4EAA4E;AAC5E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;IACpD,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAClE,QAAQ,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC;IACpC,QAAQ,CAAC,kBAAkB,EAAE,QAAQ,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC;IACvE,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,cAAc,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC;IACxE,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;CAC1D;AAwJD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,sBAAsB,GAAG,MAAM,IAAI,CAUhF"}

package/dist/hooks/interactions-connection.js

@@ -0,0 +1,171 @@
+import { isFeatureDisabled } from '../feature-disabled';
+import { emptyOverlay, merge, overlayApplyAdd, overlayApplyAnswered, overlayApplyRemoved, parseAddFrame, parseId, sweepAnswered, } from './interactions-stream';
+// Reconnect backoff: capped exponential with full jitter. The delay for attempt
+// n is a random value in [0, min(CAP, BASE * 2**n)); the attempt counter resets
+// only when a connection PROVES HEALTHY — it stayed open at least
+// `HEALTHY_CONNECTION_MS` — not merely when it opens, so a server that accepts the
+// request then drops the body still backs off instead of tight-looping.
+const RECONNECT_BASE_MS = 1500;
+const RECONNECT_CAP_MS = 30000;
+const HEALTHY_CONNECTION_MS = RECONNECT_BASE_MS;
+function aborted(ctx) {
+    return ctx.controller.signal.aborted;
+}
+function surfaceMalformed(ctx, event) {
+    ctx.setConnectionState((prev) => ({
+        ...prev,
+        error: new Error(`malformed interaction frame: ${event}`),
+    }));
+}
+/**
+ * A successful data frame sweeps aged answered cards, republishes the merged list,
+ * and clears any transient frame-parse error — one bad frame on a healthy stream
+ * must not stick. It does NOT refetch: the overlay already updated the list and the
+ * derived count, and the resync fires on (re)connect only.
+ */
+function commit(ctx) {
+    if (aborted(ctx))
+        return;
+    sweepAnswered(ctx.overlay);
+    ctx.setConnectionState((prev) => (prev.error === null ? prev : { ...prev, error: null }));
+    ctx.setInteractions(merge(ctx.seedRef.current, ctx.overlay));
+}
+function applyFrame(ctx, event, data) {
+    if (event === 'interaction.removed') {
+        const id = parseId(data);
+        if (id === null) {
+            surfaceMalformed(ctx, event);
+            return;
+        }
+        overlayApplyRemoved(ctx.overlay, id, ctx.epochRef.current);
+        commit(ctx);
+        return;
+    }
+    if (event === 'interaction.answered') {
+        const id = parseId(data);
+        if (id === null) {
+            surfaceMalformed(ctx, event);
+            return;
+        }
+        overlayApplyAnswered(ctx.overlay, id, ctx.epochRef.current, ctx.seedRef.current);
+        commit(ctx);
+        return;
+    }
+    // interaction.add — the full question.
+    const interaction = parseAddFrame(data);
+    if (interaction === null) {
+        surfaceMalformed(ctx, event);
+        return;
+    }
+    overlayApplyAdd(ctx.overlay, interaction, ctx.epochRef.current);
+    commit(ctx);
+}
+/**
+ * Open one connection and consume its frames until the tail ends. Refetches the
+ * paged base on connect under a fresh epoch (tail-only carries no backlog) and
+ * records that epoch as `countEpoch` only once the refetch LANDED, so the count
+ * applies only deltas not yet folded into the fresh `total`.
+ */
+async function connectAndConsume(ctx, cursor) {
+    const frames = await ctx.api.streamInteractions(ctx.controller.signal, cursor.lastEventId);
+    if (aborted(ctx))
+        return;
+    ctx.setConnectionState((prev) => ({ ...prev, connected: true, error: null, disabled: false }));
+    const epoch = (ctx.epochRef.current += 1);
+    const landed = await ctx.onResyncRef.current();
+    if (aborted(ctx))
+        return;
+    if (landed)
+        ctx.setCountEpoch(epoch);
+    for await (const frame of frames) {
+        if (aborted(ctx))
+            return;
+        applyFrame(ctx, frame.event, frame.data);
+        // Advance the resume cursor to every id-bearing frame (even a malformed one)
+        // so a reconnect never re-requests a frame already delivered.
+        if (frame.id !== undefined)
+            cursor.lastEventId = frame.id;
+    }
+}
+/** Classify a connection error into whether the driver should stop or reconnect. */
+function handleConnectionError(ctx, err) {
+    const error = err instanceof Error ? err : new Error(String(err));
+    ctx.setConnectionState((prev) => ({ ...prev, connected: false, error }));
+    if (error.name === 'ApiUnauthorizedError') {
+        // A dead credential — reconnecting would replay the same bad key forever. Hand
+        // off to the app's 401→login handler, the same path every other call takes.
+        ctx.onUnauthorized();
+        return 'stop';
+    }
+    if (isFeatureDisabled(error)) {
+        // A terminal 501 `interactions-not-configured`: reconnecting would replay the
+        // same refusal on every backoff forever. Flag the OFF state and stop.
+        ctx.setConnectionState((prev) => ({ ...prev, connected: false, disabled: true }));
+        return 'stop';
+    }
+    return 'retry';
+}
+/** Wait out the backoff for `attempt`, resolving early if the signal aborts. */
+function waitBackoff(signal, attempt) {
+    const ceiling = Math.min(RECONNECT_CAP_MS, RECONNECT_BASE_MS * 2 ** attempt);
+    const delay = Math.random() * ceiling;
+    return new Promise((resolve) => {
+        const onAbort = () => {
+            clearTimeout(timer);
+            resolve();
+        };
+        const timer = setTimeout(() => {
+            // Normal wake: drop the abort listener so it does not accumulate across
+            // reconnects ({ once: true } only self-removes on firing).
+            signal.removeEventListener('abort', onAbort);
+            resolve();
+        }, delay);
+        signal.addEventListener('abort', onAbort, { once: true });
+    });
+}
+/** The reconnect loop: connect, consume, back off, repeat until aborted or terminal. */
+async function runConnectionLoop(ctx) {
+    const cursor = { lastEventId: undefined };
+    let reconnectAttempt = 0;
+    while (!aborted(ctx)) {
+        const openedAt = Date.now();
+        try {
+            await connectAndConsume(ctx, cursor);
+            if (aborted(ctx))
+                return;
+        }
+        catch (err) {
+            if (aborted(ctx))
+                return;
+            if (handleConnectionError(ctx, err) === 'stop')
+                return;
+        }
+        // A connection open at least HEALTHY_CONNECTION_MS proved healthy — clear the
+        // backoff so the next drop reconnects promptly; an accept-then-drop flap does not.
+        if (Date.now() - openedAt >= HEALTHY_CONNECTION_MS)
+            reconnectAttempt = 0;
+        if (aborted(ctx))
+            return;
+        ctx.setConnectionState((prev) => ({ ...prev, connected: false }));
+        await waitBackoff(ctx.controller.signal, reconnectAttempt);
+        reconnectAttempt += 1;
+    }
+}
+/**
+ * Start the tail-only interactions stream and return the effect cleanup. The
+ * abort signal is the single cancellation source of truth: cleanup aborts it, every
+ * loop guard reads it fresh, and a fresh mount starts from an empty overlay at epoch
+ * 0 so a re-run never inherits the prior run's tail or its epoch stamps.
+ */
+export function startInteractionsStream(deps) {
+    const controller = new AbortController();
+    const ctx = { ...deps, controller, overlay: deps.overlayRef.current };
+    void runConnectionLoop(ctx);
+    return () => {
+        controller.abort();
+        deps.overlayRef.current = emptyOverlay();
+        deps.epochRef.current = 0;
+        deps.setCountEpoch(0);
+    };
+}
+//# sourceMappingURL=interactions-connection.js.map

package/dist/hooks/interactions-connection.js.map

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

package/dist/hooks/interactions-stream.d.ts

@@ -0,0 +1,80 @@
+/**
+ * The pure reducer behind the live interactions inbox: frame parsing, the live
+ * overlay accumulated over the paged base, and the two derived projections
+ * (`merge` → the published list, `pendingCount` → the live badge tally). No React,
+ * no I/O — the connection driver owns the SSE loop and feeds frames through here.
+ */
+import type { Interaction } from '@tai42/api-client';
+/** A live interaction plus the client-maintained `answered` flag. */
+export type StreamInteraction = Interaction & {
+    readonly answered: boolean;
+};
+/**
+ * Validate an `interaction.add` frame into an `Interaction`, or null when it is
+ * malformed. This mirrors the api-client `interaction` zod schema exactly — it
+ * accepts what that schema accepts, no more, no less — so the caller surfaces a
+ * malformed frame as an error rather than rendering a blank card, and never
+ * silently coerces one.
+ */
+export declare function parseAddFrame(data: string): Interaction | null;
+/** The interaction id from an `answered` / `removed` frame, or null. */
+export declare function parseId(data: string): string | null;
+/**
+ * The live overlay a connection accumulates over the paged base: the tail's own
+ * adds (kept whether or not the base already lists them, so a fresher add wins),
+ * the answered stamps (wall-clock ms, for the aging sweep), and the tombstones for
+ * ids removed on the tail OR aged out of the answered window (a tombstone stops a
+ * still-stale seed from re-showing a gone card; ids are never reused). `addEpoch`
+ * and `goneEpoch` carry the resync epoch current when an add / a first terminal frame
+ * arrived, so the count applies an add (or subtracts a terminal) only while it is not
+ * yet folded into the refetched `total`; the merge and the aging sweep ignore them.
+ */
+export interface LiveOverlay {
+    readonly adds: Map<string, Interaction>;
+    readonly addEpoch: Map<string, number>;
+    readonly answeredAt: Map<string, number>;
+    readonly removed: Set<string>;
+    readonly goneEpoch: Map<string, number>;
+}
+export declare function emptyOverlay(): LiveOverlay;
+/** Record an `interaction.add`: a live add overwrites any prior copy in place. */
+export declare function overlayApplyAdd(overlay: LiveOverlay, interaction: Interaction, epoch: number): void;
+/**
+ * Record an `interaction.answered`. The answered time and terminal epoch are
+ * stamped on the FIRST answered frame only (a redelivery keeps the original stamp,
+ * so the retention window is not extended and a later terminal never re-dates it
+ * into a fresher resync). A seed-origin card is promoted into the overlay so it
+ * lingers uniformly with a live-add card, since the paged base never carries
+ * answered items and a refetch would otherwise drop it before its window elapses.
+ */
+export declare function overlayApplyAnswered(overlay: LiveOverlay, id: string, epoch: number, seed: readonly Interaction[]): void;
+/** Record an `interaction.removed`: tombstone the id and stamp its first terminal epoch. */
+export declare function overlayApplyRemoved(overlay: LiveOverlay, id: string, epoch: number): void;
+/**
+ * Age answered cards out (the server sends no removal for them): tombstone any past
+ * the retention window, then — as a flood backstop — the oldest beyond the count
+ * cap. A tombstone (not a bare delete) so a still-stale seed cannot resurrect a card
+ * the client has retired; the id keeps its original `goneEpoch` so moving
+ * answered→removed never re-dates it into a fresher resync.
+ */
+export declare function sweepAnswered(overlay: LiveOverlay): void;
+/** Fold the paged base and the live overlay into the published, ordered list. */
+export declare function merge(seed: readonly Interaction[], live: LiveOverlay): StreamInteraction[];
+/**
+ * The live pending tally: the door's `total` for the seed, plus live adds whose id
+ * is absent from the seed AND stamped at or after `countEpoch` (a new question not
+ * yet folded into `total`), minus one for every terminal id — answered OR removed —
+ * stamped at or after `countEpoch`, deduped per id so an id counts once however many
+ * terminal frames it drew. `countEpoch` is the epoch of the last resync whose refetch
+ * LANDED (a failed refetch never advances it): a delta stamped before it is already
+ * reflected in the fresh `total`, so it is NOT applied again — this is what stops a
+ * resync from re-subtracting a terminal it already dropped from `total`, while a
+ * failed refetch keeps the prior-epoch deltas applying against the prior total. One
+ * residual race remains: a frame arriving while a refetch is in flight may already be
+ * reflected in that refetch's `total`, so the raw tally can transiently dip below zero
+ * until the next resync reconciles. A pending tally below zero is meaningless, so the
+ * published count clamps at 0; the clamp covers only the negative symptom (a transient
+ * positive under-count reconciles on the next resync, not here).
+ */
+export declare function pendingCount(seed: readonly Interaction[], total: number, live: LiveOverlay, countEpoch: number): number;
+//# sourceMappingURL=interactions-stream.d.ts.map

package/dist/hooks/interactions-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactions-stream.d.ts","sourceRoot":"","sources":["../../src/hooks/interactions-stream.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,qEAAqE;AACrE,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAoG7E;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAK9D;AAED,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGnD;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,wBAAgB,YAAY,IAAI,WAAW,CAQ1C;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAC7B,OAAO,EAAE,WAAW,EACpB,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,MAAM,GACZ,IAAI,CAGN;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,WAAW,EACpB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,WAAW,EAAE,GAC3B,IAAI,CAUN;AAED,4FAA4F;AAC5F,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAMzF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAexD;AAED,iFAAiF;AACjF,wBAAgB,KAAK,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,EAAE,IAAI,EAAE,WAAW,GAAG,iBAAiB,EAAE,CAW1F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,WAAW,EAAE,EAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,WAAW,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,CAWR"}

package/dist/hooks/interactions-stream.js

@@ -0,0 +1,233 @@
+import { isRecord } from '../guards';
+// The server emits no removal for an answered card — only `interaction.answered`,
+// never `interaction.removed` for it — and the paged base never carries answered
+// items, so answered cards would otherwise pile up unbounded in the always-mounted
+// badge/inbox. The client ages them out: drop an answered card
+// ANSWERED_RETENTION_MS after its answered frame, keeping at most ANSWERED_CAP as a
+// hard flood backstop. Swept lazily on frame/reconnect ticks (the stream carries no
+// idle heartbeat frame), never a per-item timer.
+const ANSWERED_RETENTION_MS = 10 * 60 * 1000;
+const ANSWERED_CAP = 200;
+// The wire `answer_format` values. Duplicated from the api-client enum by design:
+// the SDK is the leaf and must not import api-client at runtime. The `satisfies`
+// pin against `Interaction['answer_format']` fails to compile if a listed value
+// leaves the union, so this runtime guard cannot silently drift from the type.
+const ANSWER_FORMATS = new Set([
+    'text',
+    'confirm',
+    'select',
+    'form',
+    'external',
+]);
+/** Parse a frame's JSON to a plain object, or null when it is not one. */
+function parseJson(data) {
+    if (!data)
+        return null;
+    try {
+        const obj = JSON.parse(data);
+        return isRecord(obj) ? obj : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The strict-required fields: `interaction_id`, `group_id`, `created_at`,
+ * `timeout_at` must each be a string and `answer_format` a known enum value.
+ * `question` is `z.string().default('')` — a missing question is valid (normalized
+ * to `''` on assembly) but a present non-string is malformed; `format_payload` is
+ * nullish — absent/null is valid but a present non-object is malformed.
+ */
+function requiredFieldsValid(obj) {
+    if (typeof obj.interaction_id !== 'string')
+        return false;
+    if (typeof obj.group_id !== 'string')
+        return false;
+    if (obj.question !== undefined && typeof obj.question !== 'string')
+        return false;
+    if (typeof obj.created_at !== 'string')
+        return false;
+    if (typeof obj.timeout_at !== 'string')
+        return false;
+    if (typeof obj.answer_format !== 'string' || !ANSWER_FORMATS.has(obj.answer_format))
+        return false;
+    if (obj.format_payload != null && !isRecord(obj.format_payload))
+        return false;
+    return true;
+}
+/**
+ * The optional fields, each rejected only when PRESENT with the wrong type: an
+ * absent value stays absent (or takes its schema default on assembly). `media`
+ * items stay unknown by design — each is validated per item by the renderer.
+ */
+function optionalFieldsValid(obj) {
+    if (obj.sensitive !== undefined && typeof obj.sensitive !== 'boolean')
+        return false;
+    if (obj.server_verified !== undefined && typeof obj.server_verified !== 'boolean')
+        return false;
+    if (obj.channel !== undefined && typeof obj.channel !== 'string')
+        return false;
+    if (obj.recipient !== undefined && typeof obj.recipient !== 'string')
+        return false;
+    if (obj.origin !== undefined && typeof obj.origin !== 'string')
+        return false;
+    if (obj.audience !== undefined && typeof obj.audience !== 'string')
+        return false;
+    if (obj.media !== undefined && !Array.isArray(obj.media))
+        return false;
+    return true;
+}
+/** Assemble the validated frame into an `Interaction`, applying the schema defaults. */
+function buildInteraction(obj) {
+    return {
+        interaction_id: obj.interaction_id,
+        group_id: obj.group_id,
+        question: typeof obj.question === 'string' ? obj.question : '',
+        answer_format: obj.answer_format,
+        format_payload: isRecord(obj.format_payload) ? obj.format_payload : {},
+        created_at: obj.created_at,
+        timeout_at: obj.timeout_at,
+        sensitive: typeof obj.sensitive === 'boolean' ? obj.sensitive : false,
+        ...(typeof obj.server_verified === 'boolean' ? { server_verified: obj.server_verified } : {}),
+        ...(typeof obj.channel === 'string' ? { channel: obj.channel } : {}),
+        ...(typeof obj.recipient === 'string' ? { recipient: obj.recipient } : {}),
+        ...(typeof obj.origin === 'string' ? { origin: obj.origin } : {}),
+        ...(typeof obj.audience === 'string' ? { audience: obj.audience } : {}),
+        ...(Array.isArray(obj.media) ? { media: obj.media } : {}),
+    };
+}
+/**
+ * Validate an `interaction.add` frame into an `Interaction`, or null when it is
+ * malformed. This mirrors the api-client `interaction` zod schema exactly — it
+ * accepts what that schema accepts, no more, no less — so the caller surfaces a
+ * malformed frame as an error rather than rendering a blank card, and never
+ * silently coerces one.
+ */
+export function parseAddFrame(data) {
+    const obj = parseJson(data);
+    if (obj === null)
+        return null;
+    if (!requiredFieldsValid(obj) || !optionalFieldsValid(obj))
+        return null;
+    return buildInteraction(obj);
+}
+/** The interaction id from an `answered` / `removed` frame, or null. */
+export function parseId(data) {
+    const id = parseJson(data)?.interaction_id;
+    return typeof id === 'string' ? id : null;
+}
+export function emptyOverlay() {
+    return {
+        adds: new Map(),
+        addEpoch: new Map(),
+        answeredAt: new Map(),
+        removed: new Set(),
+        goneEpoch: new Map(),
+    };
+}
+/** Record an `interaction.add`: a live add overwrites any prior copy in place. */
+export function overlayApplyAdd(overlay, interaction, epoch) {
+    overlay.adds.set(interaction.interaction_id, interaction);
+    overlay.addEpoch.set(interaction.interaction_id, epoch);
+}
+/**
+ * Record an `interaction.answered`. The answered time and terminal epoch are
+ * stamped on the FIRST answered frame only (a redelivery keeps the original stamp,
+ * so the retention window is not extended and a later terminal never re-dates it
+ * into a fresher resync). A seed-origin card is promoted into the overlay so it
+ * lingers uniformly with a live-add card, since the paged base never carries
+ * answered items and a refetch would otherwise drop it before its window elapses.
+ */
+export function overlayApplyAnswered(overlay, id, epoch, seed) {
+    if (!overlay.answeredAt.has(id))
+        overlay.answeredAt.set(id, Date.now());
+    if (!overlay.goneEpoch.has(id))
+        overlay.goneEpoch.set(id, epoch);
+    if (!overlay.adds.has(id)) {
+        const seeded = seed.find((item) => item.interaction_id === id);
+        if (seeded !== undefined) {
+            overlay.adds.set(id, seeded);
+            overlay.addEpoch.set(id, epoch);
+        }
+    }
+}
+/** Record an `interaction.removed`: tombstone the id and stamp its first terminal epoch. */
+export function overlayApplyRemoved(overlay, id, epoch) {
+    overlay.adds.delete(id);
+    overlay.addEpoch.delete(id);
+    overlay.answeredAt.delete(id);
+    overlay.removed.add(id);
+    if (!overlay.goneEpoch.has(id))
+        overlay.goneEpoch.set(id, epoch);
+}
+/**
+ * Age answered cards out (the server sends no removal for them): tombstone any past
+ * the retention window, then — as a flood backstop — the oldest beyond the count
+ * cap. A tombstone (not a bare delete) so a still-stale seed cannot resurrect a card
+ * the client has retired; the id keeps its original `goneEpoch` so moving
+ * answered→removed never re-dates it into a fresher resync.
+ */
+export function sweepAnswered(overlay) {
+    const now = Date.now();
+    const retire = (id) => {
+        overlay.answeredAt.delete(id);
+        overlay.adds.delete(id);
+        overlay.addEpoch.delete(id);
+        overlay.removed.add(id);
+    };
+    for (const [id, at] of overlay.answeredAt) {
+        if (now - at >= ANSWERED_RETENTION_MS)
+            retire(id);
+    }
+    if (overlay.answeredAt.size > ANSWERED_CAP) {
+        const oldest = [...overlay.answeredAt.entries()].sort((a, b) => a[1] - b[1]);
+        for (const [id] of oldest.slice(0, oldest.length - ANSWERED_CAP))
+            retire(id);
+    }
+}
+/** Fold the paged base and the live overlay into the published, ordered list. */
+export function merge(seed, live) {
+    const out = new Map();
+    for (const item of seed) {
+        if (live.removed.has(item.interaction_id))
+            continue;
+        out.set(item.interaction_id, { ...item, answered: live.answeredAt.has(item.interaction_id) });
+    }
+    for (const [id, item] of live.adds) {
+        if (live.removed.has(id))
+            continue;
+        out.set(id, { ...item, answered: live.answeredAt.has(id) });
+    }
+    return Array.from(out.values());
+}
+/**
+ * The live pending tally: the door's `total` for the seed, plus live adds whose id
+ * is absent from the seed AND stamped at or after `countEpoch` (a new question not
+ * yet folded into `total`), minus one for every terminal id — answered OR removed —
+ * stamped at or after `countEpoch`, deduped per id so an id counts once however many
+ * terminal frames it drew. `countEpoch` is the epoch of the last resync whose refetch
+ * LANDED (a failed refetch never advances it): a delta stamped before it is already
+ * reflected in the fresh `total`, so it is NOT applied again — this is what stops a
+ * resync from re-subtracting a terminal it already dropped from `total`, while a
+ * failed refetch keeps the prior-epoch deltas applying against the prior total. One
+ * residual race remains: a frame arriving while a refetch is in flight may already be
+ * reflected in that refetch's `total`, so the raw tally can transiently dip below zero
+ * until the next resync reconciles. A pending tally below zero is meaningless, so the
+ * published count clamps at 0; the clamp covers only the negative symptom (a transient
+ * positive under-count reconciles on the next resync, not here).
+ */
+export function pendingCount(seed, total, live, countEpoch) {
+    const seedIds = new Set(seed.map((item) => item.interaction_id));
+    let count = total;
+    for (const id of live.adds.keys()) {
+        if (!seedIds.has(id) && (live.addEpoch.get(id) ?? 0) >= countEpoch)
+            count += 1;
+    }
+    const gone = new Set([...live.answeredAt.keys(), ...live.removed]);
+    for (const id of gone) {
+        if ((live.goneEpoch.get(id) ?? 0) >= countEpoch)
+            count -= 1;
+    }
+    return Math.max(count, 0);
+}
+//# sourceMappingURL=interactions-stream.js.map

package/dist/hooks/interactions-stream.js.map

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