@memberjunction/realtime-runtime 6.2.0-edge.4 → 6.2.0-edge.6

package/dist/session/RecordingShardStore.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @fileoverview Durable queue for realtime-call recording shards, backed by IndexedDB.
+ *
+ * A shard is written here BEFORE its upload starts and deleted only once the server acknowledges
+ * it, so a crash, a closed tab or a dead network never loses audio that was already captured: the
+ * next page load drains whatever is left. Persistence is best-effort by design — every failure is
+ * logged with the session and shard index and then swallowed into a resolved promise, because a
+ * broken disk must never interrupt a live call.
+ *
+ * @module @memberjunction/realtime-runtime
+ */
+/** A shard waiting in the store for the server to acknowledge it. */
+export interface PendingRecordingShard {
+    SessionID: string;
+    /**
+     * The MJ user whose call this is, or null when the page had no signed-in user. A page only lists
+     * (and so re-sends) its own user's shards, and logout deletes them: on a shared browser one user's
+     * audio is never sent with, or left behind for, another user's session.
+     */
+    UserID: string | null;
+    Index: number;
+    Bytes: Uint8Array;
+    /** Epoch ms at which the shard was stored; drives oldest-first draining and retention. */
+    SavedAt: number;
+}
+/**
+ * Durable shard queue. No method throws: a storage failure is logged and the call resolves (empty
+ * for {@link IRecordingShardStore.ListOldest}).
+ */
+export interface IRecordingShardStore {
+    /** Persists a shard (idempotent per session+index). */
+    Put(shard: PendingRecordingShard): Promise<void>;
+    /** Removes a shard once the server has acknowledged it. */
+    Delete(sessionID: string, index: number): Promise<void>;
+    /** Purges entries past retention (every user's), then returns up to `limit` of `userID`'s shards, oldest first. */
+    ListOldest(limit: number, userID: string | null): Promise<PendingRecordingShard[]>;
+    /** Removes every shard of `userID` (logout). */
+    DeleteForUser(userID: string | null): Promise<void>;
+}
+/** How long an unacknowledged shard is kept; the server stops accepting late shards well before this. */
+export declare const RECORDING_SHARD_RETENTION_MS: number;
+/** Store used when the host has no IndexedDB (server-side render, some React Native runtimes). */
+export declare class NullRecordingShardStore implements IRecordingShardStore {
+    Put(_shard: PendingRecordingShard): Promise<void>;
+    Delete(_sessionID: string, _index: number): Promise<void>;
+    ListOldest(_limit: number, _userID: string | null): Promise<PendingRecordingShard[]>;
+    DeleteForUser(_userID: string | null): Promise<void>;
+}
+/**
+ * Creates the shard store for a host. A host without IndexedDB passes `null`/`undefined` and gets a
+ * no-op store, so callers never branch on availability.
+ *
+ * @param factory The host's `indexedDB`, or null/undefined when it has none.
+ * @param now Injectable clock for the retention purge; defaults to `Date.now`.
+ */
+export declare function CreateRecordingShardStore(factory: IDBFactory | null | undefined, now?: () => number): IRecordingShardStore;
+//# sourceMappingURL=RecordingShardStore.d.ts.map

package/dist/session/RecordingShardStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecordingShardStore.d.ts","sourceRoot":"","sources":["../../src/session/RecordingShardStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,CAAC;IAClB,0FAA0F;IAC1F,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACjC,uDAAuD;IACvD,GAAG,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,2DAA2D;IAC3D,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,mHAAmH;IACnH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;IACnF,gDAAgD;IAChD,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD;AAED,yGAAyG;AACzG,eAAO,MAAM,4BAA4B,QAAoB,CAAC;AAmB9D,kGAAkG;AAClG,qBAAa,uBAAwB,YAAW,oBAAoB;IACnD,GAAG,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAGjD,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAGzD,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAGpF,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAGpE;AAsJD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACrC,OAAO,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EACtC,GAAG,GAAE,MAAM,MAAiB,GAC7B,oBAAoB,CAEtB"}

package/dist/session/RecordingShardStore.js

@@ -0,0 +1,184 @@
+/**
+ * @fileoverview Durable queue for realtime-call recording shards, backed by IndexedDB.
+ *
+ * A shard is written here BEFORE its upload starts and deleted only once the server acknowledges
+ * it, so a crash, a closed tab or a dead network never loses audio that was already captured: the
+ * next page load drains whatever is left. Persistence is best-effort by design — every failure is
+ * logged with the session and shard index and then swallowed into a resolved promise, because a
+ * broken disk must never interrupt a live call.
+ *
+ * @module @memberjunction/realtime-runtime
+ */
+/** How long an unacknowledged shard is kept; the server stops accepting late shards well before this. */
+export const RECORDING_SHARD_RETENTION_MS = 7 * 24 * 3600_000;
+const DB_NAME = 'mj-realtime-recording';
+const DB_VERSION = 1;
+const STORE_NAME = 'pending-shards';
+const SAVED_AT_INDEX = 'by-saved-at';
+/** Initial open plus one retry; a persistently failing open then degrades to no-ops. */
+const MAX_OPEN_ATTEMPTS = 2;
+/** Store used when the host has no IndexedDB (server-side render, some React Native runtimes). */
+export class NullRecordingShardStore {
+    async Put(_shard) {
+        // Intentionally empty: without IndexedDB the in-memory retry queue is the only buffer.
+    }
+    async Delete(_sessionID, _index) {
+        // Intentionally empty.
+    }
+    async ListOldest(_limit, _userID) {
+        return [];
+    }
+    async DeleteForUser(_userID) {
+        // Intentionally empty.
+    }
+}
+function describeFailure(failure) {
+    return failure instanceof Error ? failure.message : String(failure);
+}
+function toTransactionPromise(tx) {
+    return new Promise((resolve, reject) => {
+        tx.oncomplete = () => resolve();
+        tx.onerror = () => reject(tx.error ?? new Error('IndexedDB transaction failed'));
+        tx.onabort = () => reject(tx.error ?? new Error('IndexedDB transaction aborted'));
+    });
+}
+class IndexedDBRecordingShardStore {
+    constructor(factory, now) {
+        this.factory = factory;
+        this.now = now;
+        this.db = null;
+        this.opening = null;
+        this.openAttempts = 0;
+        this.disabled = false;
+    }
+    async Put(shard) {
+        const context = `shard ${shard.SessionID}/${shard.Index}`;
+        const row = {
+            SessionID: shard.SessionID,
+            UserID: shard.UserID,
+            Index: shard.Index,
+            Buffer: shard.Bytes.slice().buffer,
+            SavedAt: shard.SavedAt,
+        };
+        await this.run(context, 'readwrite', (store) => {
+            store.put(row);
+        });
+    }
+    async Delete(sessionID, index) {
+        await this.run(`shard ${sessionID}/${index}`, 'readwrite', (store) => {
+            store.delete([sessionID, index]);
+        });
+    }
+    async ListOldest(limit, userID) {
+        const rows = [];
+        const cutoff = this.now() - RECORDING_SHARD_RETENTION_MS;
+        await this.run('listing pending shards', 'readwrite', (store) => {
+            // One ascending walk does both jobs: rows are ordered by age, so every expired row
+            // precedes every live one. Purge and read share a transaction so a shard cannot expire
+            // between the two steps. (Avoids IDBKeyRange, which is not a global in every host.)
+            store.index(SAVED_AT_INDEX).openCursor().onsuccess = (event) => {
+                const cursor = event.target.result;
+                if (!cursor)
+                    return;
+                const row = cursor.value;
+                if (row.SavedAt < cutoff) {
+                    cursor.delete();
+                }
+                else if ((row.UserID ?? null) !== userID) {
+                    // another user's shard: neither listed nor counted against this page's limit
+                }
+                else if (rows.length < limit) {
+                    rows.push(row);
+                }
+                else {
+                    return;
+                }
+                cursor.continue();
+            };
+        });
+        return rows.map((r) => ({
+            SessionID: r.SessionID,
+            UserID: r.UserID ?? null,
+            Index: r.Index,
+            Bytes: new Uint8Array(r.Buffer),
+            SavedAt: r.SavedAt,
+        }));
+    }
+    async DeleteForUser(userID) {
+        await this.run(`deleting the stored shards of user ${userID ?? '(none)'}`, 'readwrite', (store) => {
+            store.openCursor().onsuccess = (event) => {
+                const cursor = event.target.result;
+                if (!cursor)
+                    return;
+                if ((cursor.value.UserID ?? null) === userID) {
+                    cursor.delete();
+                }
+                cursor.continue();
+            };
+        });
+    }
+    /** Runs one transaction; any failure is logged with `context` and swallowed. */
+    async run(context, mode, work) {
+        const db = await this.getDatabase(context);
+        if (!db)
+            return;
+        try {
+            const tx = db.transaction(STORE_NAME, mode);
+            const done = toTransactionPromise(tx);
+            work(tx.objectStore(STORE_NAME));
+            await done;
+        }
+        catch (failure) {
+            console.warn(`[RealtimeSession] Recording shard store failed (${context}): ${describeFailure(failure)}`, failure);
+        }
+    }
+    async getDatabase(context) {
+        if (this.db)
+            return this.db;
+        if (this.disabled)
+            return null;
+        // Concurrent callers share the in-flight open instead of each counting as an attempt.
+        this.opening ??= this.open(context).finally(() => {
+            this.opening = null;
+        });
+        return this.opening;
+    }
+    async open(context) {
+        this.openAttempts++;
+        try {
+            this.db = await this.openDatabase();
+            return this.db;
+        }
+        catch (failure) {
+            console.warn(`[RealtimeSession] Recording shard store could not open IndexedDB (${context}, attempt ${this.openAttempts}/${MAX_OPEN_ATTEMPTS}): ${describeFailure(failure)}`, failure);
+            if (this.openAttempts >= MAX_OPEN_ATTEMPTS) {
+                this.disabled = true;
+                console.warn('[RealtimeSession] Recording shard persistence disabled for this page; shards stay in memory only.');
+            }
+            return null;
+        }
+    }
+    openDatabase() {
+        return new Promise((resolve, reject) => {
+            const request = this.factory.open(DB_NAME, DB_VERSION);
+            request.onupgradeneeded = () => {
+                const store = request.result.createObjectStore(STORE_NAME, { keyPath: ['SessionID', 'Index'] });
+                store.createIndex(SAVED_AT_INDEX, 'SavedAt');
+            };
+            request.onsuccess = () => resolve(request.result);
+            request.onerror = () => reject(request.error ?? new Error('IndexedDB open failed'));
+            request.onblocked = () => reject(new Error('IndexedDB open blocked'));
+        });
+    }
+}
+/**
+ * Creates the shard store for a host. A host without IndexedDB passes `null`/`undefined` and gets a
+ * no-op store, so callers never branch on availability.
+ *
+ * @param factory The host's `indexedDB`, or null/undefined when it has none.
+ * @param now Injectable clock for the retention purge; defaults to `Date.now`.
+ */
+export function CreateRecordingShardStore(factory, now = Date.now) {
+    return factory ? new IndexedDBRecordingShardStore(factory, now) : new NullRecordingShardStore();
+}
+//# sourceMappingURL=RecordingShardStore.js.map

package/dist/session/RecordingShardStore.js.map

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

package/dist/session/RecordingShardWindow.d.ts

@@ -0,0 +1,42 @@
+/** One sealed, encoded shard ready to store and upload. */
+export interface RecordingShard {
+    /** Zero-based, contiguous position in the call's shard sequence. */
+    Index: number;
+    /** 48 kHz sample offset of the shard's first frame. */
+    StartSample: number;
+    /** Audio samples the shard covers. */
+    SampleCount: number;
+    /** The encoded `MJOPUS1` bytes. */
+    Bytes: Uint8Array;
+}
+/**
+ * Accumulates Opus packets and seals them into shards. Pure: no timers, no I/O.
+ *
+ * A window seals when it reaches {@link RECORDING_SHARD_MAX_PACKETS} packets (two 5 s windows), or
+ * just BEFORE a packet that would push the encoded shard past {@link RECORDING_TERMINAL_MAX_BYTES}.
+ * The runtime's 5 s tick seals whatever is pending, so a live call still cuts one ~5 s shard per tick;
+ * the packet cap only splits a backlog (a throttled tab's batch). The byte cap guarantees that
+ * whatever tail is pending always fits the terminal request body, even after a VBR spike.
+ */
+export declare class RecordingShardWindow {
+    private pending;
+    private pendingBytes;
+    private nextIndex;
+    private sealedSamples;
+    /** Index of the last sealed shard; -1 before any seal. */
+    get LastSealedIndex(): number;
+    /** End sample of the last sealed shard. */
+    get SealedSamples(): number;
+    /** End sample of everything appended so far, sealed or pending. */
+    get PendingSamples(): number;
+    /** Adds packets in capture order and returns every shard that sealed as a result. */
+    Append(packets: Uint8Array[]): RecordingShard[];
+    /**
+     * Seals the partial window now. `sampleCount` (default packets*960) is clamped to
+     * [0, packets*960]; the caller passes less when the encoder's last frame was padded. Returns null
+     * when no packets are pending, so a second call is a no-op.
+     */
+    SealTail(sampleCount?: number): RecordingShard | null;
+    private seal;
+}
+//# sourceMappingURL=RecordingShardWindow.d.ts.map

package/dist/session/RecordingShardWindow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecordingShardWindow.d.ts","sourceRoot":"","sources":["../../src/session/RecordingShardWindow.ts"],"names":[],"mappings":"AAkBA,2DAA2D;AAC3D,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,KAAK,EAAE,UAAU,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,aAAa,CAAK;IAE1B,0DAA0D;IAC1D,IAAW,eAAe,IAAI,MAAM,CAEnC;IAED,2CAA2C;IAC3C,IAAW,aAAa,IAAI,MAAM,CAEjC;IAED,mEAAmE;IACnE,IAAW,cAAc,IAAI,MAAM,CAElC;IAED,qFAAqF;IAC9E,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,cAAc,EAAE;IAgBtD;;;;OAIG;IACI,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAS5D,OAAO,CAAC,IAAI;CAmBb"}

package/dist/session/RecordingShardWindow.js

@@ -0,0 +1,88 @@
+/**
+ * @fileoverview Cuts a call's continuous Opus packet stream into indexed `MJOPUS1` shards.
+ *
+ * Shard boundaries are decided here, once, and never revisited: an index is only ever sent with
+ * one set of bytes (the server treats a differing resend as a conflict). That is why a tail that is
+ * sent early (page hidden) is *sealed* — later packets start a new shard at the next index.
+ *
+ * @module @memberjunction/realtime-runtime
+ */
+import { EncodeRecordingShard, RECORDING_FRAME_SAMPLES, RECORDING_PACKET_LENGTH_PREFIX_BYTES, RECORDING_SHARD_HEADER_BYTES, RECORDING_SHARD_MAX_PACKETS, RECORDING_TERMINAL_MAX_BYTES, } from '@memberjunction/ai-core-plus';
+/**
+ * Accumulates Opus packets and seals them into shards. Pure: no timers, no I/O.
+ *
+ * A window seals when it reaches {@link RECORDING_SHARD_MAX_PACKETS} packets (two 5 s windows), or
+ * just BEFORE a packet that would push the encoded shard past {@link RECORDING_TERMINAL_MAX_BYTES}.
+ * The runtime's 5 s tick seals whatever is pending, so a live call still cuts one ~5 s shard per tick;
+ * the packet cap only splits a backlog (a throttled tab's batch). The byte cap guarantees that
+ * whatever tail is pending always fits the terminal request body, even after a VBR spike.
+ */
+export class RecordingShardWindow {
+    constructor() {
+        this.pending = [];
+        this.pendingBytes = RECORDING_SHARD_HEADER_BYTES;
+        this.nextIndex = 0;
+        this.sealedSamples = 0;
+    }
+    /** Index of the last sealed shard; -1 before any seal. */
+    get LastSealedIndex() {
+        return this.nextIndex - 1;
+    }
+    /** End sample of the last sealed shard. */
+    get SealedSamples() {
+        return this.sealedSamples;
+    }
+    /** End sample of everything appended so far, sealed or pending. */
+    get PendingSamples() {
+        return this.sealedSamples + this.pending.length * RECORDING_FRAME_SAMPLES;
+    }
+    /** Adds packets in capture order and returns every shard that sealed as a result. */
+    Append(packets) {
+        const sealed = [];
+        for (const packet of packets) {
+            const cost = RECORDING_PACKET_LENGTH_PREFIX_BYTES + packet.length;
+            if (this.pending.length > 0 && this.pendingBytes + cost > RECORDING_TERMINAL_MAX_BYTES) {
+                sealed.push(this.seal(this.pending.length * RECORDING_FRAME_SAMPLES));
+            }
+            this.pending.push(packet);
+            this.pendingBytes += cost;
+            if (this.pending.length >= RECORDING_SHARD_MAX_PACKETS) {
+                sealed.push(this.seal(this.pending.length * RECORDING_FRAME_SAMPLES));
+            }
+        }
+        return sealed;
+    }
+    /**
+     * Seals the partial window now. `sampleCount` (default packets*960) is clamped to
+     * [0, packets*960]; the caller passes less when the encoder's last frame was padded. Returns null
+     * when no packets are pending, so a second call is a no-op.
+     */
+    SealTail(sampleCount) {
+        if (this.pending.length === 0) {
+            return null;
+        }
+        const max = this.pending.length * RECORDING_FRAME_SAMPLES;
+        const wanted = sampleCount ?? max;
+        return this.seal(Math.min(Math.max(Math.floor(wanted), 0), max));
+    }
+    seal(sampleCount) {
+        const shard = {
+            Index: this.nextIndex,
+            StartSample: this.sealedSamples,
+            SampleCount: sampleCount,
+            Bytes: EncodeRecordingShard({
+                ShardIndex: this.nextIndex,
+                StartSample: this.sealedSamples,
+                SampleCount: sampleCount,
+                PacketCount: this.pending.length,
+                Packets: this.pending,
+            }),
+        };
+        this.nextIndex++;
+        this.sealedSamples += sampleCount;
+        this.pending = [];
+        this.pendingBytes = RECORDING_SHARD_HEADER_BYTES;
+        return shard;
+    }
+}
+//# sourceMappingURL=RecordingShardWindow.js.map

package/dist/session/RecordingShardWindow.js.map

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

package/dist/session/RecordingTransport.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @fileoverview `fetch` transport for recording shards and the terminal request.
+ *
+ * Shards travel as raw bytes (no base64, no GraphQL envelope) to MJAPI's REST recording routes. The
+ * terminal request sets `keepalive: true` so the browser completes it even while the page is
+ * unloading; that flag caps the body at 64 KiB, which is why the window seals tails under 48 KiB.
+ *
+ * @module @memberjunction/realtime-runtime
+ */
+import type { RecordingShard } from './RecordingShardWindow.js';
+import type { PendingRecordingShard } from './RecordingShardStore.js';
+export interface RecordingTerminalInput {
+    /** The final partial shard's bytes, or null when every shard was already sent. */
+    Tail: Uint8Array | null;
+    LastShardIndex: number;
+    CapturedSamples: number;
+    /**
+     * False when the call may go on (the tab was only hidden): the server stamps the counts but assembles
+     * after its grace period instead of now. Absent or true: the call ended.
+     */
+    Final?: boolean;
+}
+/** Per-upload options for {@link IRecordingTransport.UploadShard}. */
+export interface RecordingUploadOptions {
+    /**
+     * Send with `keepalive` so the request survives page unload. Only for shards sealed inside a
+     * `pagehide`/`visibilitychange` handler: the browser caps in-flight keepalive bodies (64 KiB per
+     * page), and the browser rejects a request over that budget before sending it — which resolves
+     * `Retry` like any network failure (not `Refused`: the server never saw it).
+     */
+    Keepalive?: boolean;
+}
+/**
+ * What became of one shard upload. `Acked`: the server has it. `Refused`: the server answered that it
+ * will never take this shard (bad shard, not this caller's session, conflicting bytes, too late, too
+ * big), so re-sending it is pointless. `Retry`: anything that may succeed later (no network, an expired
+ * token, a busy or failing server).
+ */
+export type RecordingUploadOutcome = 'Acked' | 'Refused' | 'Retry';
+/** Sends recording bytes to the server. */
+export interface IRecordingTransport {
+    UploadShard(sessionID: string, shard: RecordingShard | PendingRecordingShard, options?: RecordingUploadOptions): Promise<RecordingUploadOutcome>;
+    /** Sent with `keepalive` so it survives page unload. Resolves true only on a server ack. */
+    SendTerminal(sessionID: string, input: RecordingTerminalInput): Promise<boolean>;
+}
+export interface FetchRecordingTransportConfig {
+    /** MJAPI base URL without a trailing slash (see {@link RecordingBaseURLFromGraphQLURL}). */
+    BaseURL: string;
+    /** Called per request so a refreshed token is picked up. */
+    Headers: () => Record<string, string>;
+    /** Defaults to `globalThis.fetch`, resolved at call time so tests can inject one. */
+    Fetch?: typeof fetch;
+}
+/**
+ * Derives the REST base from the GraphQL endpoint URL by dropping trailing slashes and `/graphql`.
+ * A scan, not a regex: `/\/+$/` backtracks quadratically on a long run of slashes that does not end
+ * the string, and the URL comes from host configuration.
+ */
+export declare function RecordingBaseURLFromGraphQLURL(url: string): string;
+export declare class FetchRecordingTransport implements IRecordingTransport {
+    private readonly config;
+    constructor(config: FetchRecordingTransportConfig);
+    UploadShard(sessionID: string, shard: RecordingShard | PendingRecordingShard, options?: RecordingUploadOptions): Promise<RecordingUploadOutcome>;
+    SendTerminal(sessionID: string, input: RecordingTerminalInput): Promise<boolean>;
+    private post;
+}
+//# sourceMappingURL=RecordingTransport.d.ts.map

package/dist/session/RecordingTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecordingTransport.d.ts","sourceRoot":"","sources":["../../src/session/RecordingTransport.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,MAAM,WAAW,sBAAsB;IACnC,kFAAkF;IAClF,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,sEAAsE;AACtE,MAAM,WAAW,sBAAsB;IACnC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AASnE,2CAA2C;AAC3C,MAAM,WAAW,mBAAmB;IAChC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,qBAAqB,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACjJ,4FAA4F;IAC5F,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpF;AAED,MAAM,WAAW,6BAA6B;IAC1C,4FAA4F;IAC5F,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,qFAAqF;IACrF,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAQD;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOlE;AAED,qBAAa,uBAAwB,YAAW,mBAAmB;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,6BAA6B;IAE3D,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,qBAAqB,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAK1I,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC;YAO/E,IAAI;CAqBrB"}

package/dist/session/RecordingTransport.js

@@ -0,0 +1,61 @@
+/**
+ * Statuses that mean the server will never accept this shard, whoever sends it and however often.
+ * 401 is not here (a refreshed token can still send it), nor 404: an MJAPI older than the recording
+ * routes answers 404 to every shard, and a browser upgraded first must keep its audio for the server.
+ */
+const PERMANENT_REFUSAL_STATUSES = new Set([400, 403, 409, 410, 413]);
+function describeFailure(failure) {
+    return failure instanceof Error ? failure.message : String(failure);
+}
+const GRAPHQL_SUFFIX = '/graphql';
+/**
+ * Derives the REST base from the GraphQL endpoint URL by dropping trailing slashes and `/graphql`.
+ * A scan, not a regex: `/\/+$/` backtracks quadratically on a long run of slashes that does not end
+ * the string, and the URL comes from host configuration.
+ */
+export function RecordingBaseURLFromGraphQLURL(url) {
+    let end = url.length;
+    while (end > 0 && url.charCodeAt(end - 1) === 47 /* '/' */) {
+        end--;
+    }
+    const trimmed = url.slice(0, end);
+    return trimmed.endsWith(GRAPHQL_SUFFIX) ? trimmed.slice(0, -GRAPHQL_SUFFIX.length) : trimmed;
+}
+export class FetchRecordingTransport {
+    constructor(config) {
+        this.config = config;
+    }
+    UploadShard(sessionID, shard, options) {
+        const url = `${this.config.BaseURL}/realtime/recording/${encodeURIComponent(sessionID)}/shard/${shard.Index}`;
+        return this.post(url, shard.Bytes, options?.Keepalive === true, `shard ${sessionID}/${shard.Index}`);
+    }
+    async SendTerminal(sessionID, input) {
+        const final = input.Final === false ? '&final=false' : '';
+        const query = `lastShardIndex=${input.LastShardIndex}&capturedSamples=${input.CapturedSamples}${final}`;
+        const url = `${this.config.BaseURL}/realtime/recording/${encodeURIComponent(sessionID)}/end?${query}`;
+        return (await this.post(url, input.Tail ?? new Uint8Array(0), true, `terminal ${sessionID}/${input.LastShardIndex}`)) === 'Acked';
+    }
+    async post(url, body, keepalive, context) {
+        const doFetch = this.config.Fetch ?? globalThis.fetch;
+        try {
+            const response = await doFetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/octet-stream', ...this.config.Headers() },
+                // TS types a bare Uint8Array as possibly SharedArrayBuffer-backed; shard bytes never are.
+                body: body,
+                ...(keepalive ? { keepalive: true } : {}),
+            });
+            if (!response.ok) {
+                const outcome = PERMANENT_REFUSAL_STATUSES.has(response.status) ? 'Refused' : 'Retry';
+                console.warn(`[RealtimeSession] Recording ${context} rejected by server with status ${response.status} (${outcome === 'Refused' ? 'will not be re-sent' : 'will be retried'})`);
+                return outcome;
+            }
+            return 'Acked';
+        }
+        catch (failure) {
+            console.warn(`[RealtimeSession] Recording ${context} request failed: ${describeFailure(failure)}`, failure);
+            return 'Retry';
+        }
+    }
+}
+//# sourceMappingURL=RecordingTransport.js.map

package/dist/session/RecordingTransport.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memberjunction/realtime-runtime",
   "type": "module",
-  "version": "6.2.0-edge.4",
+  "version": "6.2.0-edge.6",
   "description": "MemberJunction: Framework-agnostic Realtime Session Runtime — client-direct realtime co-agent session orchestration (mint, driver resolution, transcripts, tool relay, delegation narration, channel lifecycle, usage relay). Pure TypeScript, zero UX dependencies. Consumable from browser (Angular/React/Vue), React Native, or Node test harnesses.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,18 +11,19 @@
   "author": "MemberJunction.com",
   "license": "BUSL-1.1",
   "dependencies": {
-    "@memberjunction/ai": "6.2.0-edge.4",
-    "@memberjunction/ai-core-plus": "6.2.0-edge.4",
-    "@memberjunction/ai-engine-base": "6.2.0-edge.4",
-    "@memberjunction/ai-realtime-client": "6.2.0-edge.4",
-    "@memberjunction/core": "6.2.0-edge.4",
-    "@memberjunction/core-entities": "6.2.0-edge.4",
-    "@memberjunction/global": "6.2.0-edge.4",
-    "@memberjunction/graphql-dataprovider": "6.2.0-edge.4",
+    "@memberjunction/ai": "6.2.0-edge.6",
+    "@memberjunction/ai-core-plus": "6.2.0-edge.6",
+    "@memberjunction/ai-engine-base": "6.2.0-edge.6",
+    "@memberjunction/ai-realtime-client": "6.2.0-edge.6",
+    "@memberjunction/core": "6.2.0-edge.6",
+    "@memberjunction/core-entities": "6.2.0-edge.6",
+    "@memberjunction/global": "6.2.0-edge.6",
+    "@memberjunction/graphql-dataprovider": "6.2.0-edge.6",
     "rxjs": "^7.8.2"
   },
   "devDependencies": {
     "@types/node": "24.10.11",
+    "fake-indexeddb": "^6.2.5",
     "typescript": "^5.9.3"
   },
   "repository": {