@ttt-productions/chat-react 0.6.1 → 0.6.3

package/dist/realtime/inbox-client.js

@@ -0,0 +1,173 @@
+// The Inbox realtime client: a SEPARATE WebSocket (scope `inbox`) to the user's
+// inbox DO. It maintains the channel/invite registry + unread projection that
+// drives the Chats view — DOTS ONLY, no counts (Contract C / "Unread + inbox").
+//
+// The inbox DO pushes a full `snapshot` ({ registry, hasUnread }) on connect, on
+// `resume`, and on every live delta (a projection apply). This client just
+// mirrors the latest snapshot into an observable store + a per-channel unread set.
+// Same connection lifecycle as the channel client (subprotocol auth, reconnect,
+// 4401 re-grant once, 4403 stop, auth-switch teardown).
+import { createReconnectController } from '@ttt-productions/realtime-core';
+import { CLIENT_FRAME, CHAT_CLOSE_CODES, buildFrame, parseFrame, isInboxSnapshot, } from './wire.js';
+import { defaultTimers } from './shared.js';
+const INITIAL = { status: 'idle', registry: [], hasUnread: false, unreadChannelRefs: [] };
+export class InboxClient {
+    config;
+    timers;
+    controller;
+    socket = null;
+    state = INITIAL;
+    listeners = new Set();
+    reauthAttempted = false;
+    reconnectTimer = null;
+    closedByUs = false;
+    constructor(config) {
+        this.config = config;
+        this.timers = config.timers ?? defaultTimers;
+        this.controller = createReconnectController(config.reconnect ?? {});
+    }
+    getState() {
+        return this.state;
+    }
+    subscribe(fn) {
+        this.listeners.add(fn);
+        return () => this.listeners.delete(fn);
+    }
+    setState(patch) {
+        this.state = { ...this.state, ...patch };
+        for (const fn of this.listeners)
+            fn(this.state);
+    }
+    async connect() {
+        this.closedByUs = false;
+        this.controller.start();
+        this.setState({ status: 'connecting' });
+        await this.openSocket();
+    }
+    async openSocket() {
+        let grantToken;
+        try {
+            grantToken = await this.config.grantProvider();
+        }
+        catch {
+            return this.scheduleReconnect();
+        }
+        if (this.closedByUs)
+            return;
+        const url = `${this.config.endpoint.replace(/\/$/, '')}/inbox`;
+        this.socket = this.config.socketFactory({
+            url,
+            grantToken,
+            handlers: {
+                onOpen: () => this.onOpen(),
+                onMessage: (data) => this.onMessage(data),
+                onClose: (code, reason) => this.onClose(code, reason),
+                onError: () => undefined,
+            },
+        });
+    }
+    onOpen() {
+        this.controller.onOpen();
+        this.reauthAttempted = false;
+        this.setState({ status: 'open' });
+        // The DO sends a snapshot on accept; a `resume` re-requests it after a reconnect gap.
+        this.sendFrame(CLIENT_FRAME.RESUME, {});
+    }
+    onClose(code, _reason) {
+        this.socket = null;
+        if (this.closedByUs) {
+            this.setState({ status: 'closed' });
+            return;
+        }
+        if (code === CHAT_CLOSE_CODES.AUTH_EXPIRED && !this.reauthAttempted) {
+            this.reauthAttempted = true;
+            this.setState({ status: 'reconnecting' });
+            void this.openSocket();
+            return;
+        }
+        if (code === CHAT_CLOSE_CODES.REVOKED) {
+            this.closedByUs = true;
+            this.controller.close();
+            this.setState({ status: 'closed' });
+            return;
+        }
+        this.scheduleReconnect();
+    }
+    scheduleReconnect() {
+        const delay = this.controller.onClose();
+        if (delay == null) {
+            this.setState({ status: 'closed' });
+            return;
+        }
+        this.setState({ status: 'reconnecting' });
+        this.reconnectTimer = this.timers.setTimeout(() => {
+            this.reconnectTimer = null;
+            if (this.closedByUs)
+                return;
+            void this.openSocket();
+        }, delay);
+    }
+    onMessage(data) {
+        const frame = parseFrame(data);
+        if (!frame || frame.type !== 'snapshot' || !frame.payload)
+            return;
+        const payload = frame.payload;
+        if (!isInboxSnapshot(payload))
+            return; // ignore a stray channel snapshot
+        this.applySnapshot(payload);
+    }
+    applySnapshot(snap) {
+        const registry = snap.registry.filter((e) => e.state === 'active');
+        // The DO's `hasUnread` is the authoritative dock dot. Per-row dots are derived
+        // from the same projection: the DO only keeps unread for ACTIVE entries, and a
+        // future snapshot field can carry per-channel unread; until then the dock dot
+        // is authoritative and per-row unread is surfaced via the projected set below.
+        this.setState({
+            registry,
+            hasUnread: Boolean(snap.hasUnread),
+            unreadChannelRefs: deriveUnreadRefs(snap),
+        });
+    }
+    sendFrame(type, payload) {
+        if (!this.socket || !this.socket.isOpen)
+            return false;
+        this.socket.send(buildFrame(type, payload));
+        return true;
+    }
+    /** True if a specific channel/invite currently carries an unread dot. */
+    channelHasUnread(channelRef) {
+        return this.state.unreadChannelRefs.includes(channelRef);
+    }
+    /** Permanently close (auth-user switch / unmount). Idempotent. */
+    close() {
+        this.closedByUs = true;
+        this.controller.close();
+        if (this.reconnectTimer != null) {
+            this.timers.clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.socket) {
+            this.socket.close(1000, 'client teardown');
+            this.socket = null;
+        }
+        this.setState({ status: 'closed' });
+    }
+}
+/**
+ * Derive the per-channel unread set from a snapshot. The current inbox DO snapshot
+ * exposes a single `hasUnread` boolean (dock dot) + the active registry; it does
+ * NOT yet enumerate which entries are unread. We surface a per-entry `unread`
+ * field when the DO provides it (forward-compatible), else fall back to empty
+ * per-row dots (the dock dot still lights). See the ASSUMPTIONS note in the docs.
+ */
+function deriveUnreadRefs(snap) {
+    const refs = [];
+    for (const e of snap.registry) {
+        if (e.state !== 'active')
+            continue;
+        if (e.unread === true)
+            refs.push(e.channelRef);
+    }
+    return refs;
+}
+//# sourceMappingURL=inbox-client.js.map

package/dist/realtime/inbox-client.js.map

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

package/dist/realtime/index.d.ts

@@ -0,0 +1,16 @@
+export { CHAT_SUBPROTOCOL, CHAT_WIRE_VERSION, CHAT_CLOSE_CODES, CLIENT_FRAME, SERVER_FRAME, buildFrame, parseFrame, isInboxSnapshot, } from './wire.js';
+export type { ChannelRefTuple, ChatCloseCode, WireMessageRow, WireChannelSnapshot, WireInboxSnapshot, WireRegistryEntry, ServerFrame, } from './wire.js';
+export type { RealtimeSocket, SocketFactory, SocketHandlers } from './socket.js';
+export { browserSocketFactory } from './socket.js';
+export type { GrantProvider, TransportTimers, RealtimeStatus } from './shared.js';
+export { defaultTimers, HEARTBEAT_MS, TYPING_COALESCE_MS, HISTORY_PAGE_MAX } from './shared.js';
+export { wireRowToMessage, optimisticMessage, seqToMessageId } from './map.js';
+export { ChannelClient } from './channel-client.js';
+export type { ChannelClientState, ChannelClientConfig } from './channel-client.js';
+export { InboxClient } from './inbox-client.js';
+export type { InboxClientState, InboxClientConfig } from './inbox-client.js';
+export { createRealtimeChatClient, createInboxClient, } from './transport.js';
+export type { RealtimeChatClient, RealtimeTransportConfig } from './transport.js';
+export { useRealtimeChatMessages } from './useRealtimeChatMessages.js';
+export type { UseRealtimeChatMessagesResult } from './useRealtimeChatMessages.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/realtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/realtime/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,UAAU,EACV,eAAe,GAChB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,eAAe,EACf,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,GACZ,MAAM,WAAW,CAAC;AAEnB,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEhG,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE7E,OAAO,EACL,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAElF,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,YAAY,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/realtime/index.js

@@ -0,0 +1,14 @@
+// The realtime (Cloudflare Durable Object) chat transport — the client half of
+// the chat-worker wire protocol (Contract A connection + Contract C wire). The
+// FIRESTORE transport stays the unchanged default; this is opt-in via
+// `ChatCoreConfig.transport === 'realtime'` + a `realtime.client` from
+// `createRealtimeChatClient(...)`.
+export { CHAT_SUBPROTOCOL, CHAT_WIRE_VERSION, CHAT_CLOSE_CODES, CLIENT_FRAME, SERVER_FRAME, buildFrame, parseFrame, isInboxSnapshot, } from './wire.js';
+export { browserSocketFactory } from './socket.js';
+export { defaultTimers, HEARTBEAT_MS, TYPING_COALESCE_MS, HISTORY_PAGE_MAX } from './shared.js';
+export { wireRowToMessage, optimisticMessage, seqToMessageId } from './map.js';
+export { ChannelClient } from './channel-client.js';
+export { InboxClient } from './inbox-client.js';
+export { createRealtimeChatClient, createInboxClient, } from './transport.js';
+export { useRealtimeChatMessages } from './useRealtimeChatMessages.js';
+//# sourceMappingURL=index.js.map

package/dist/realtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/realtime/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,+EAA+E;AAC/E,sEAAsE;AACtE,uEAAuE;AACvE,mCAAmC;AAEnC,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,UAAU,EACV,eAAe,GAChB,MAAM,WAAW,CAAC;AAYnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGnD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEhG,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EACL,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/realtime/map.d.ts

@@ -0,0 +1,31 @@
+import type { ChatMessageV1 } from '@ttt-productions/chat-core';
+import type { WireMessageRow } from './wire.js';
+/** The DO `seq` is the stable per-channel message id (monotonic, epoch-spanning). */
+export declare function seqToMessageId(seq: number): string;
+/**
+ * Convert a DO message row to the UI message. `threadId` is the caller's logical
+ * thread id (the UI's thread key); the DO row carries no threadId of its own.
+ * - `messageId` = the server seq (string) — stable + dedup key.
+ * - `replyTo` JSON `{ messageSeq, preview }` → UI `{ messageId, senderId:'', messagePreview }`.
+ * - The DO row carries only the attachment LIFECYCLE (`attachmentState` +
+ *   `attachmentMeta.mediaAssetId`), not the full `ChatAttachment` (id/name/size/
+ *   storagePath). The full attachment-saga projection is the next chain's work
+ *   (P5/P6); until then the placeholder lifecycle rides in `meta.attachment*` so
+ *   the renderer can show the pending/ready/failed bubble without a stored URL —
+ *   the render-time URL comes from `mediaAssetId` via the attachment-URL resolver
+ *   context (identity/media invariant: no URLs are ever stored).
+ */
+export declare function wireRowToMessage(row: WireMessageRow, threadId: string): ChatMessageV1;
+/** The optimistic local echo a `send` produces before the server `ack` reconciles the seq. */
+export declare function optimisticMessage(args: {
+    clientMessageId: string;
+    threadId: string;
+    senderId: string;
+    text: string;
+    createdAt: number;
+    replyTo?: {
+        messageId: string;
+        messagePreview?: string;
+    } | null;
+}): ChatMessageV1;
+//# sourceMappingURL=map.d.ts.map

package/dist/realtime/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/realtime/map.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAuBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAqBrF;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACjE,GAAG,aAAa,CAYhB"}

package/dist/realtime/map.js

@@ -0,0 +1,70 @@
+// Map the DO wire row (`WireMessageRow`) into the UI `ChatMessageV1` shape so the
+// UI stays transport-agnostic — the MessageList renders the same shape whether
+// the bytes came from Firestore or the DO socket.
+//
+// Identity invariant: the DO stores uid references only (`senderUid`), never a
+// display name — names resolve at render time through the ChatNameResolver
+// context, identical to the Firestore path.
+/** The DO `seq` is the stable per-channel message id (monotonic, epoch-spanning). */
+export function seqToMessageId(seq) {
+    return String(seq);
+}
+function parseJson(raw) {
+    if (raw == null)
+        return null;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Convert a DO message row to the UI message. `threadId` is the caller's logical
+ * thread id (the UI's thread key); the DO row carries no threadId of its own.
+ * - `messageId` = the server seq (string) — stable + dedup key.
+ * - `replyTo` JSON `{ messageSeq, preview }` → UI `{ messageId, senderId:'', messagePreview }`.
+ * - The DO row carries only the attachment LIFECYCLE (`attachmentState` +
+ *   `attachmentMeta.mediaAssetId`), not the full `ChatAttachment` (id/name/size/
+ *   storagePath). The full attachment-saga projection is the next chain's work
+ *   (P5/P6); until then the placeholder lifecycle rides in `meta.attachment*` so
+ *   the renderer can show the pending/ready/failed bubble without a stored URL —
+ *   the render-time URL comes from `mediaAssetId` via the attachment-URL resolver
+ *   context (identity/media invariant: no URLs are ever stored).
+ */
+export function wireRowToMessage(row, threadId) {
+    const reply = parseJson(row.replyTo);
+    const meta = parseJson(row.attachmentMeta);
+    return {
+        messageId: seqToMessageId(row.seq),
+        threadId,
+        createdAt: row.createdAt,
+        senderId: row.senderUid,
+        text: row.text,
+        replyTo: reply
+            ? { messageId: seqToMessageId(reply.messageSeq), senderId: '', messagePreview: reply.preview }
+            : undefined,
+        isSystemMessage: row.senderUid === 'system' || undefined,
+        meta: {
+            seq: row.seq,
+            epoch: row.epoch,
+            ...(row.attachmentState ? { attachmentState: row.attachmentState } : {}),
+            ...(meta ? { attachmentMeta: meta } : {}),
+        },
+    };
+}
+/** The optimistic local echo a `send` produces before the server `ack` reconciles the seq. */
+export function optimisticMessage(args) {
+    return {
+        messageId: `optimistic:${args.clientMessageId}`,
+        threadId: args.threadId,
+        createdAt: args.createdAt,
+        senderId: args.senderId,
+        text: args.text,
+        replyTo: args.replyTo
+            ? { messageId: args.replyTo.messageId, senderId: '', messagePreview: args.replyTo.messagePreview ?? '' }
+            : undefined,
+        meta: { clientMessageId: args.clientMessageId, optimistic: true },
+    };
+}
+//# sourceMappingURL=map.js.map

package/dist/realtime/map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../src/realtime/map.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,+EAA+E;AAC/E,kDAAkD;AAClD,EAAE;AACF,+EAA+E;AAC/E,2EAA2E;AAC3E,4CAA4C;AAK5C,qFAAqF;AACrF,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAcD,SAAS,SAAS,CAAI,GAAkB;IACtC,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAmB,EAAE,QAAgB;IACpE,MAAM,KAAK,GAAG,SAAS,CAAc,GAAG,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,SAAS,CAAqB,GAAG,CAAC,cAAc,CAAC,CAAC;IAE/D,OAAO;QACL,SAAS,EAAE,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC;QAClC,QAAQ;QACR,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,QAAQ,EAAE,GAAG,CAAC,SAAS;QACvB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,KAAK;YACZ,CAAC,CAAC,EAAE,SAAS,EAAE,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,cAAc,EAAE,KAAK,CAAC,OAAO,EAAE;YAC9F,CAAC,CAAC,SAAS;QACb,eAAe,EAAE,GAAG,CAAC,SAAS,KAAK,QAAQ,IAAI,SAAS;QACxD,IAAI,EAAE;YACJ,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C;KACF,CAAC;AACJ,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,iBAAiB,CAAC,IAOjC;IACC,OAAO;QACL,SAAS,EAAE,cAAc,IAAI,CAAC,eAAe,EAAE;QAC/C,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACnB,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc,IAAI,EAAE,EAAE;YACxG,CAAC,CAAC,SAAS;QACb,IAAI,EAAE,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,EAAE,IAAI,EAAE;KAClE,CAAC;AACJ,CAAC"}

package/dist/realtime/shared.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Mints a short-lived chat grant token for the socket's scope. The app wires this
+ * to its `mintChatGrant` callable (channel grant for a ChannelClient, inbox grant
+ * for an InboxClient). Called on every connect AND once on a 4401 re-grant. The
+ * app owns the Firestore permission check, the scope shape, caching to a React
+ * Query staleTime < grant exp, and returning a FRESH token when re-invoked.
+ */
+export type GrantProvider = () => Promise<string>;
+/** Injectable timers so the transport runs deterministically under fake timers in tests. */
+export interface TransportTimers {
+    setTimeout: (fn: () => void, ms: number) => ReturnType<typeof setTimeout>;
+    clearTimeout: (h: ReturnType<typeof setTimeout>) => void;
+    now: () => number;
+}
+export declare const defaultTimers: TransportTimers;
+/** Connection status surfaced to the UI. */
+export type RealtimeStatus = 'idle' | 'connecting' | 'open' | 'reconnecting' | 'closed';
+/** Client heartbeat cadence (worker `CLIENT_HEARTBEAT_MS`). */
+export declare const HEARTBEAT_MS = 20000;
+/** Typing coalescing minimum interval (worker `TYPING_COALESCE_MS`). */
+export declare const TYPING_COALESCE_MS = 2000;
+/** History page cap (worker `HISTORY_PAGE_MAX`). */
+export declare const HISTORY_PAGE_MAX = 50;
+//# sourceMappingURL=shared.d.ts.map

package/dist/realtime/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/realtime/shared.ts"],"names":[],"mappings":"AAQA;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;AAElD,4FAA4F;AAC5F,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IAC1E,YAAY,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,KAAK,IAAI,CAAC;IACzD,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,aAAa,EAAE,eAI3B,CAAC;AAEF,4CAA4C;AAC5C,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,GAAG,cAAc,GAAG,QAAQ,CAAC;AAExF,+DAA+D;AAC/D,eAAO,MAAM,YAAY,QAAS,CAAC;AACnC,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,OAAQ,CAAC;AACxC,oDAAoD;AACpD,eAAO,MAAM,gBAAgB,KAAK,CAAC"}

package/dist/realtime/shared.js

@@ -0,0 +1,19 @@
+// Shared injected contracts + tunable constants for the realtime transport.
+//
+// The constants mirror the worker's V1 limits (`ttt-master-app/chat-worker/src/
+// limits.ts`) for the values the CLIENT must agree on. They are duplicated (not
+// imported) on purpose — this package is generic and never imports the worker;
+// the worker is the authority and rejects anything out of bounds, so a drift is
+// caught server-side, but the client uses these to coalesce/paginate politely.
+export const defaultTimers = {
+    setTimeout: (fn, ms) => setTimeout(fn, ms),
+    clearTimeout: (h) => clearTimeout(h),
+    now: () => Date.now(),
+};
+/** Client heartbeat cadence (worker `CLIENT_HEARTBEAT_MS`). */
+export const HEARTBEAT_MS = 20_000;
+/** Typing coalescing minimum interval (worker `TYPING_COALESCE_MS`). */
+export const TYPING_COALESCE_MS = 2_000;
+/** History page cap (worker `HISTORY_PAGE_MAX`). */
+export const HISTORY_PAGE_MAX = 50;
+//# sourceMappingURL=shared.js.map

package/dist/realtime/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/realtime/shared.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,EAAE;AACF,gFAAgF;AAChF,gFAAgF;AAChF,+EAA+E;AAC/E,gFAAgF;AAChF,+EAA+E;AAkB/E,MAAM,CAAC,MAAM,aAAa,GAAoB;IAC5C,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC;IAC1C,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IACpC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;CACtB,CAAC;AAKF,+DAA+D;AAC/D,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC;AACnC,wEAAwE;AACxE,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC;AACxC,oDAAoD;AACpD,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC"}

package/dist/realtime/socket.d.ts

@@ -0,0 +1,33 @@
+/** Lifecycle events a socket surfaces to its owning client. */
+export interface SocketHandlers {
+    onOpen: () => void;
+    onMessage: (data: string) => void;
+    /** code/reason from the close frame (4401/4403/4408/4413/4429/1013 or transport codes). */
+    onClose: (code: number, reason: string) => void;
+    onError: () => void;
+}
+/** The transport-neutral socket the clients use. A mock implements the same shape in tests. */
+export interface RealtimeSocket {
+    /** Queue/send a text frame. No-op if not open. */
+    send(data: string): void;
+    /** Close the socket with an optional app code + reason. Idempotent. */
+    close(code?: number, reason?: string): void;
+    /** True once the underlying transport is OPEN (ready to send). */
+    readonly isOpen: boolean;
+}
+/**
+ * A factory that opens a socket to `url`, offering the chat subprotocol + the
+ * grant token, and wires the handlers. Injected into the transport so tests
+ * substitute a mock. The default factory uses the global `WebSocket`.
+ */
+export type SocketFactory = (args: {
+    url: string;
+    grantToken: string;
+    handlers: SocketHandlers;
+}) => RealtimeSocket;
+/**
+ * The default browser socket factory. Offers `['ttt.chat.v1', grantToken]` as the
+ * subprotocol list so the grant rides in `Sec-WebSocket-Protocol`, never the URL.
+ */
+export declare const browserSocketFactory: SocketFactory;
+//# sourceMappingURL=socket.d.ts.map

package/dist/realtime/socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../src/realtime/socket.ts"],"names":[],"mappings":"AAYA,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,2FAA2F;IAC3F,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,+FAA+F;AAC/F,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,uEAAuE;IACvE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,cAAc,CAAC;CAC1B,KAAK,cAAc,CAAC;AAiBrB;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAuBlC,CAAC"}

package/dist/realtime/socket.js

@@ -0,0 +1,43 @@
+// The minimal socket abstraction the realtime clients drive, plus the default
+// browser-WebSocket factory. Injectable so unit tests pass a MOCK socket and no
+// real network is touched.
+//
+// Contract A transport: the grant token is offered as the SECOND WebSocket
+// subprotocol — `Sec-WebSocket-Protocol: ttt.chat.v1, <grant-token>` — never in
+// the URL (tokens never appear in URLs; Contract A). The browser sets that header
+// from `new WebSocket(url, ['ttt.chat.v1', grantToken])`. The worker validates
+// cookie + grant + Origin BEFORE accept and echoes back only `ttt.chat.v1`.
+import { CHAT_SUBPROTOCOL } from './wire.js';
+const WS_OPEN = 1;
+/**
+ * The default browser socket factory. Offers `['ttt.chat.v1', grantToken]` as the
+ * subprotocol list so the grant rides in `Sec-WebSocket-Protocol`, never the URL.
+ */
+export const browserSocketFactory = ({ url, grantToken, handlers }) => {
+    const Ctor = globalThis.WebSocket;
+    if (!Ctor)
+        throw new Error('[chat-realtime] no global WebSocket available; inject a SocketFactory');
+    const ws = new Ctor(url, [CHAT_SUBPROTOCOL, grantToken]);
+    ws.onopen = () => handlers.onOpen();
+    ws.onmessage = (ev) => handlers.onMessage(typeof ev.data === 'string' ? ev.data : String(ev.data));
+    ws.onclose = (ev) => handlers.onClose(ev.code, ev.reason);
+    ws.onerror = () => handlers.onError();
+    return {
+        send(data) {
+            if (ws.readyState === WS_OPEN)
+                ws.send(data);
+        },
+        close(code, reason) {
+            try {
+                ws.close(code, reason);
+            }
+            catch {
+                /* already closing/closed */
+            }
+        },
+        get isOpen() {
+            return ws.readyState === WS_OPEN;
+        },
+    };
+};
+//# sourceMappingURL=socket.js.map

package/dist/realtime/socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.js","sourceRoot":"","sources":["../../src/realtime/socket.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,gFAAgF;AAChF,2BAA2B;AAC3B,EAAE;AACF,2EAA2E;AAC3E,gFAAgF;AAChF,kFAAkF;AAClF,+EAA+E;AAC/E,4EAA4E;AAE5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AA6C7C,MAAM,OAAO,GAAG,CAAC,CAAC;AAElB;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAkB,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE;IACnF,MAAM,IAAI,GAAI,UAA4C,CAAC,SAAS,CAAC;IACrE,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IACpG,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC,CAAC;IACzD,EAAE,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;IACpC,EAAE,CAAC,SAAS,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACnG,EAAE,CAAC,OAAO,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;IAC1D,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IACtC,OAAO;QACL,IAAI,CAAC,IAAY;YACf,IAAI,EAAE,CAAC,UAAU,KAAK,OAAO;gBAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC;QACD,KAAK,CAAC,IAAa,EAAE,MAAe;YAClC,IAAI,CAAC;gBACH,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACzB,CAAC;YAAC,MAAM,CAAC;gBACP,4BAA4B;YAC9B,CAAC;QACH,CAAC;QACD,IAAI,MAAM;YACR,OAAO,EAAE,CAAC,UAAU,KAAK,OAAO,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/realtime/transport.d.ts

@@ -0,0 +1,48 @@
+import { ChannelClient, type ChannelClientConfig, type ChannelClientState } from './channel-client.js';
+import { InboxClient, type InboxClientConfig, type InboxClientState } from './inbox-client.js';
+import { type SocketFactory } from './socket.js';
+import type { GrantProvider, TransportTimers } from './shared.js';
+import type { ChannelRefTuple } from './wire.js';
+/**
+ * Everything the channel transport needs. The app supplies `grantProvider`
+ * (its `mintChatGrant` callable, channel scope) + `endpoint`; `socketFactory`
+ * defaults to the real browser WebSocket and is overridden in tests.
+ */
+export interface RealtimeTransportConfig {
+    endpoint: string;
+    channelRef: ChannelRefTuple;
+    threadId: string;
+    currentUserId: string;
+    grantProvider: GrantProvider;
+    socketFactory?: SocketFactory;
+    timers?: TransportTimers;
+    reconnect?: ChannelClientConfig['reconnect'];
+}
+/**
+ * The opaque realtime client handle stored on `ChatRealtimeTransportConfig.client`.
+ * The UI hook (`useRealtimeChatMessages`) drives it; the UI never reaches into the
+ * socket directly.
+ */
+export interface RealtimeChatClient {
+    readonly channel: ChannelClient;
+    readonly channelRef: ChannelRefTuple;
+    readonly currentUserId: string;
+    connect(): Promise<void>;
+    /** Tear down every socket (auth-user switch / unmount). Idempotent. */
+    close(): void;
+    getState(): ChannelClientState;
+    subscribe(fn: (s: ChannelClientState) => void): () => void;
+}
+/** Create the per-thread realtime client (the value placed on `config.realtime.client`). */
+export declare function createRealtimeChatClient(config: RealtimeTransportConfig): RealtimeChatClient;
+/** Create the per-USER inbox client (mount once at the dock; not per-thread). */
+export declare function createInboxClient(config: {
+    endpoint: string;
+    currentUserId: string;
+    grantProvider: GrantProvider;
+    socketFactory?: SocketFactory;
+    timers?: TransportTimers;
+    reconnect?: InboxClientConfig['reconnect'];
+}): InboxClient;
+export type { ChannelClientState, InboxClientState };
+//# sourceMappingURL=transport.d.ts.map

package/dist/realtime/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/realtime/transport.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACvG,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC/F,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,eAAe,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,SAAS,CAAC,EAAE,mBAAmB,CAAC,WAAW,CAAC,CAAC;CAC9C;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,uEAAuE;IACvE,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,IAAI,kBAAkB,CAAC;IAC/B,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC5D;AAED,4FAA4F;AAC5F,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,uBAAuB,GAAG,kBAAkB,CAoB5F;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,SAAS,CAAC,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAC;CAC5C,GAAG,WAAW,CASd;AAED,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/realtime/transport.js

@@ -0,0 +1,47 @@
+// The realtime transport HANDLE the chat-react config carries on the `realtime`
+// transport (`ChatRealtimeTransportConfig.client`). It owns:
+//   - a ChannelClient for the active thread (send/read/typing/presence/history)
+//   - the grant-mint wiring (channel scope) via the injected grantProvider
+//   - auth-user-switch teardown (close every socket before connecting as a new uid)
+//
+// The INBOX socket is created SEPARATELY (one per user, app-wide) via
+// `createInboxClient` — it is not tied to a single thread, so the app owns its
+// lifetime (mount it once at the dock, not per ChatShell). This keeps the channel
+// transport (per-thread) and the inbox transport (per-user) cleanly split, exactly
+// as the worker splits Channel DOs from the Inbox DO.
+import { ChannelClient } from './channel-client.js';
+import { InboxClient } from './inbox-client.js';
+import { browserSocketFactory } from './socket.js';
+/** Create the per-thread realtime client (the value placed on `config.realtime.client`). */
+export function createRealtimeChatClient(config) {
+    const channel = new ChannelClient({
+        endpoint: config.endpoint,
+        threadId: config.threadId,
+        currentUserId: config.currentUserId,
+        grantProvider: config.grantProvider,
+        socketFactory: config.socketFactory ?? browserSocketFactory,
+        timers: config.timers,
+        reconnect: config.reconnect,
+    });
+    return {
+        channel,
+        channelRef: config.channelRef,
+        currentUserId: config.currentUserId,
+        connect: () => channel.connect(),
+        close: () => channel.close(),
+        getState: () => channel.getState(),
+        subscribe: (fn) => channel.subscribe(fn),
+    };
+}
+/** Create the per-USER inbox client (mount once at the dock; not per-thread). */
+export function createInboxClient(config) {
+    return new InboxClient({
+        endpoint: config.endpoint,
+        currentUserId: config.currentUserId,
+        grantProvider: config.grantProvider,
+        socketFactory: config.socketFactory ?? browserSocketFactory,
+        timers: config.timers,
+        reconnect: config.reconnect,
+    });
+}
+//# sourceMappingURL=transport.js.map

package/dist/realtime/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/realtime/transport.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,6DAA6D;AAC7D,gFAAgF;AAChF,2EAA2E;AAC3E,oFAAoF;AACpF,EAAE;AACF,sEAAsE;AACtE,+EAA+E;AAC/E,kFAAkF;AAClF,mFAAmF;AACnF,sDAAsD;AAEtD,OAAO,EAAE,aAAa,EAAqD,MAAM,qBAAqB,CAAC;AACvG,OAAO,EAAE,WAAW,EAAiD,MAAM,mBAAmB,CAAC;AAC/F,OAAO,EAAE,oBAAoB,EAAsB,MAAM,aAAa,CAAC;AAoCvE,4FAA4F;AAC5F,MAAM,UAAU,wBAAwB,CAAC,MAA+B;IACtE,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC;QAChC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,oBAAoB;QAC3D,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC,CAAC;IAEH,OAAO;QACL,OAAO;QACP,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;QAChC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE;QAC5B,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE;QAClC,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;KACzC,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,iBAAiB,CAAC,MAOjC;IACC,OAAO,IAAI,WAAW,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,oBAAoB;QAC3D,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC,CAAC;AACL,CAAC"}

package/dist/realtime/useRealtimeChatMessages.d.ts

@@ -0,0 +1,23 @@
+import type { ChatMessageV1 } from "@ttt-productions/chat-core";
+import type { RealtimeChatClient } from "./transport.js";
+import type { ChannelClientState } from "./channel-client.js";
+export type UseRealtimeChatMessagesResult = {
+    allowed: boolean;
+    isInitialLoading: boolean;
+    messages: ChatMessageV1[];
+    fetchOlder: () => Promise<void>;
+    hasOlder: boolean;
+    isFetchingOlder: boolean;
+    /** Realtime extras (not present on the firestore result) — optional for the UI. */
+    status: ChannelClientState["status"];
+    typing: string[];
+    presence: string[];
+    send: (text: string, replyTo?: {
+        messageSeq: number;
+        preview: string;
+    } | null) => void;
+    readAck: (readSeq: number, focused: boolean) => void;
+    signalTyping: () => void;
+};
+export declare function useRealtimeChatMessages(client: RealtimeChatClient): UseRealtimeChatMessagesResult;
+//# sourceMappingURL=useRealtimeChatMessages.d.ts.map

package/dist/realtime/useRealtimeChatMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRealtimeChatMessages.d.ts","sourceRoot":"","sources":["../../src/realtime/useRealtimeChatMessages.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9D,MAAM,MAAM,6BAA6B,GAAG;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,mFAAmF;IACnF,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,KAAK,IAAI,CAAC;IACvF,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACrD,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,GAAG,6BAA6B,CAgEjG"}