@ttt-productions/chat-react 0.6.0 → 0.6.2

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export type { ChatCoreConfig, ChatAttachmentConfig, ChatUploadAdapter, ChatMentionConfig, MessageRenderer, MessageRendererRegistry, RenderableMentionProvider, MentionResultRenderer, } from "./types.js";
+export type { ChatCoreConfig, ChatTransportMode, ChatRealtimeTransportConfig, ChatAttachmentConfig, ChatUploadAdapter, ChatMentionConfig, MessageRenderer, MessageRendererRegistry, RenderableMentionProvider, MentionResultRenderer, } from "./types.js";
 export type { ChatAttachmentUrlResolver, ChatAttachmentUrlProviderProps, } from "./context/ChatAttachmentUrlContext.js";
 export { ChatAttachmentUrlProvider, useChatAttachmentUrlResolver, } from "./context/ChatAttachmentUrlContext.js";
 export type { ChatNameResolverProviderProps } from "./context/ChatNameResolverContext.js";
@@ -6,6 +6,8 @@ export { ChatNameResolverProvider, useChatNameResolver, useOptionalChatNameResol
 export type { UseChatMessagesResult } from "./hooks/useChatMessages.js";
 export { useChatMessages } from "./hooks/useChatMessages.js";
 export { canAccessThread } from "./hooks/useChatThreadAccess.js";
+export { createRealtimeChatClient, createInboxClient, ChannelClient, InboxClient, useRealtimeChatMessages, browserSocketFactory, CHAT_SUBPROTOCOL, CHAT_CLOSE_CODES, CLIENT_FRAME, SERVER_FRAME, buildFrame, parseFrame, } from "./realtime/index.js";
+export type { RealtimeChatClient, RealtimeTransportConfig, ChannelClientState, ChannelClientConfig, InboxClientState, InboxClientConfig, UseRealtimeChatMessagesResult, GrantProvider, TransportTimers, RealtimeStatus, RealtimeSocket, SocketFactory, SocketHandlers, ChannelRefTuple, WireMessageRow, WireInboxSnapshot, WireRegistryEntry, ServerFrame, } from "./realtime/index.js";
 export type { ChatShellProps } from "./ui/ChatShell.js";
 export { ChatShell } from "./ui/ChatShell.js";
 export { MessageList } from "./ui/MessageList.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC;AAG/C,YAAY,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AAC1F,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,sCAAsC,CAAC;AAE9C,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,YAAY,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EACL,mBAAmB,EACnB,KAAK,wBAAwB,GAC9B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,sBAAsB,EACtB,KAAK,0BAA0B,EAC/B,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,wCAAwC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,2BAA2B,EAC3B,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC;AAG/C,YAAY,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AAC1F,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,sCAAsC,CAAC;AAE9C,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAKjE,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,UAAU,GACX,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,6BAA6B,EAC7B,aAAa,EACb,eAAe,EACf,cAAc,EACd,cAAc,EACd,aAAa,EACb,cAAc,EACd,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,YAAY,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EACL,mBAAmB,EACnB,KAAK,wBAAwB,GAC9B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,sBAAsB,EACtB,KAAK,0BAA0B,EAC/B,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,wCAAwC,CAAC"}

package/dist/index.js

@@ -3,6 +3,10 @@ export { ChatAttachmentUrlProvider, useChatAttachmentUrlResolver, } from "./cont
 export { ChatNameResolverProvider, useChatNameResolver, useOptionalChatNameResolver, useResolvedSenderName, } from "./context/ChatNameResolverContext.js";
 export { useChatMessages } from "./hooks/useChatMessages.js";
 export { canAccessThread } from "./hooks/useChatThreadAccess.js";
+// Realtime (Cloudflare Durable Object) transport — the client half of the chat
+// worker wire protocol. Opt-in via `ChatCoreConfig.transport === 'realtime'`; the
+// firestore transport stays the unchanged default. See docs/packages/chat-react.md.
+export { createRealtimeChatClient, createInboxClient, ChannelClient, InboxClient, useRealtimeChatMessages, browserSocketFactory, CHAT_SUBPROTOCOL, CHAT_CLOSE_CODES, CLIENT_FRAME, SERVER_FRAME, buildFrame, parseFrame, } from "./realtime/index.js";
 export { ChatShell } from "./ui/ChatShell.js";
 export { MessageList } from "./ui/MessageList.js";
 export { Composer } from "./ui/Composer.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAyBb,OAAO,EACL,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC;AAI/C,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGjE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAyB,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EACL,mBAAmB,GAEpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,sBAAsB,GAKvB,MAAM,wCAAwC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AA2Bb,OAAO,EACL,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,uCAAuC,CAAC;AAI/C,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,+EAA+E;AAC/E,kFAAkF;AAClF,oFAAoF;AACpF,OAAO,EACL,wBAAwB,EACxB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,UAAU,GACX,MAAM,qBAAqB,CAAC;AAuB7B,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAyB,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EACL,mBAAmB,GAEpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,sBAAsB,GAKvB,MAAM,wCAAwC,CAAC"}

package/dist/realtime/channel-client.d.ts

@@ -0,0 +1,104 @@
+import type { ChatMessageV1 } from '@ttt-productions/chat-core';
+import type { SocketFactory } from './socket.js';
+import type { GrantProvider, TransportTimers, RealtimeStatus } from './shared.js';
+export interface ChannelClientState {
+    status: RealtimeStatus;
+    /** Ordered ascending by seq; optimistic messages (no seq yet) sort to the tail. */
+    messages: ChatMessageV1[];
+    /** uids currently typing (cleared after ~TYPING_COALESCE_MS of silence). */
+    typing: string[];
+    /** uids the DO reports online (presence). Empty until presence-subscribe. */
+    presence: string[];
+    /** True while an older-history page request is in flight. */
+    isFetchingOlder: boolean;
+    /** False once a history page returns fewer than the requested limit (reached the head). */
+    hasOlder: boolean;
+    /** The last structured error code the DO sent (e.g. 'blocked-word', 'too-long', flood reason). */
+    lastErrorCode: string | null;
+}
+export interface ChannelClientConfig {
+    /** WebSocket endpoint base, e.g. `wss://chat.ttt.productions`. The client appends `/channel`. */
+    endpoint: string;
+    /** The logical thread id the UI keys on (used as ChatMessageV1.threadId). */
+    threadId: string;
+    /** The authenticated uid (sender identity for optimistic echoes + auth-switch guard). */
+    currentUserId: string;
+    /** Mints/refreshes a channel grant. Called on connect and once on a 4401 re-grant. */
+    grantProvider: GrantProvider;
+    socketFactory: SocketFactory;
+    timers?: TransportTimers;
+    /** Reconnect backoff tuning (forwarded to realtime-core). */
+    reconnect?: {
+        baseDelayMs?: number;
+        maxDelayMs?: number;
+        maxAttempts?: number | null;
+        random?: () => number;
+    };
+}
+export declare class ChannelClient {
+    private readonly config;
+    private readonly timers;
+    private readonly controller;
+    private socket;
+    private state;
+    private readonly listeners;
+    /** Resume cursor: highest seq we've durably applied. Sent on resume after reconnect. */
+    private resumeSeq;
+    /** True after a `4401` re-grant has been attempted for the CURRENT connect cycle (once-only). */
+    private reauthAttempted;
+    private presenceSubscribed;
+    private heartbeatTimer;
+    private typingTimers;
+    private lastTypingSentAt;
+    private reconnectTimer;
+    private closedByUs;
+    constructor(config: ChannelClientConfig);
+    getState(): ChannelClientState;
+    subscribe(fn: (s: ChannelClientState) => void): () => void;
+    private setState;
+    connect(): Promise<void>;
+    private openSocket;
+    private onOpen;
+    private onError;
+    private onClose;
+    private scheduleReconnect;
+    private onMessage;
+    private applyChannelSnapshot;
+    private applyMessage;
+    /**
+     * Merge a server message: reconcile an optimistic echo by clientMessageId (swap
+     * the `optimistic:` row for the canonical seq row), or insert/replace by seq.
+     * Keeps the list sorted ascending by seq with optimistic rows at the tail.
+     */
+    private mergeMessage;
+    private applyAck;
+    private applyHistoryPage;
+    private applyTyping;
+    private sendFrame;
+    /**
+     * Optimistic send: render the echo immediately keyed by clientMessageId, then
+     * emit the `send` frame. The server `ack`/`message` reconciles on the seq.
+     */
+    send(args: {
+        clientMessageId: string;
+        text: string;
+        replyTo?: {
+            messageSeq: number;
+            preview: string;
+        } | null;
+    }): void;
+    /** Explicit read ack (delivery != read). `focused` => the channel is open + at latest. */
+    readAck(readSeq: number, focused: boolean): void;
+    /** Coalesced typing signal: at most one frame per TYPING_COALESCE_MS. */
+    typing(): void;
+    presenceSubscribe(): void;
+    presenceUnsubscribe(): void;
+    /** Fetch the page of history older than the oldest loaded message (epoch-aware by seq). */
+    fetchOlder(): void;
+    private requestHistory;
+    private startHeartbeat;
+    private stopHeartbeat;
+    /** Permanently close this client (auth-user switch / unmount). Idempotent. */
+    close(): void;
+}
+//# sourceMappingURL=channel-client.d.ts.map

package/dist/realtime/channel-client.d.ts.map

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

package/dist/realtime/channel-client.js

@@ -0,0 +1,356 @@
+// The Channel realtime client: ONE WebSocket to a single channel DO, driving the
+// Contract C wire protocol. Framework-neutral (a plain observable store the React
+// hook subscribes to) so it is unit-testable with a mock socket and no React.
+//
+// Responsibilities (Contract C):
+//   - connect via subprotocol auth (grant offered by the injected grantProvider)
+//   - receive versioned `message` frames; server owns `seq`
+//   - optimistic send keyed by clientMessageId, reconciled on the server `ack` seq
+//   - explicit read acks (delivery != read; focus signals "read")
+//   - typing (>= 2s coalesced per the V1 limit)
+//   - presence-subscribe/-unsubscribe + a 20s client heartbeat
+//   - reconnect (realtime-core controller) with a resume cursor -> snapshot then deltas
+//   - history pagination over the socket (page <= 50, epoch-aware via seq)
+//   - error codes incl. 4401 AUTH_EXPIRED -> re-mint a grant ONCE via grantProvider
+//
+// Timers are injected (setTimeout/clearTimeout/now) so tests run deterministically.
+import { createReconnectController } from '@ttt-productions/realtime-core';
+import { CLIENT_FRAME, CHAT_CLOSE_CODES, buildFrame, parseFrame, isInboxSnapshot, } from './wire.js';
+import { wireRowToMessage, optimisticMessage, seqToMessageId } from './map.js';
+import { defaultTimers, HEARTBEAT_MS, TYPING_COALESCE_MS, HISTORY_PAGE_MAX } from './shared.js';
+const INITIAL = {
+    status: 'idle',
+    messages: [],
+    typing: [],
+    presence: [],
+    isFetchingOlder: false,
+    hasOlder: true,
+    lastErrorCode: null,
+};
+export class ChannelClient {
+    config;
+    timers;
+    controller;
+    socket = null;
+    state = INITIAL;
+    listeners = new Set();
+    /** Resume cursor: highest seq we've durably applied. Sent on resume after reconnect. */
+    resumeSeq = 0;
+    /** True after a `4401` re-grant has been attempted for the CURRENT connect cycle (once-only). */
+    reauthAttempted = false;
+    presenceSubscribed = false;
+    heartbeatTimer = null;
+    typingTimers = new Map();
+    lastTypingSentAt = Number.NEGATIVE_INFINITY;
+    reconnectTimer = null;
+    closedByUs = false;
+    constructor(config) {
+        this.config = config;
+        this.timers = config.timers ?? defaultTimers;
+        this.controller = createReconnectController(config.reconnect ?? {});
+    }
+    // ---- observable store ----
+    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);
+    }
+    // ---- connection lifecycle ----
+    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 {
+            // Grant mint failed — treat as a closed attempt and back off.
+            return this.scheduleReconnect();
+        }
+        if (this.closedByUs)
+            return;
+        const url = `${this.config.endpoint.replace(/\/$/, '')}/channel`;
+        this.socket = this.config.socketFactory({
+            url,
+            grantToken,
+            handlers: {
+                onOpen: () => this.onOpen(),
+                onMessage: (data) => this.onMessage(data),
+                onClose: (code, reason) => this.onClose(code, reason),
+                onError: () => this.onError(),
+            },
+        });
+    }
+    onOpen() {
+        this.controller.onOpen();
+        this.reauthAttempted = false;
+        this.setState({ status: 'open' });
+        // Resume: ask the DO for the authoritative snapshot, then live deltas flow.
+        this.sendFrame(CLIENT_FRAME.RESUME, { ackSeq: this.resumeSeq });
+        // If the UI had presence open, re-subscribe after a reconnect.
+        if (this.presenceSubscribed)
+            this.sendFrame(CLIENT_FRAME.PRESENCE_SUBSCRIBE, {});
+        this.startHeartbeat();
+    }
+    onError() {
+        // The close handler does the backoff; onerror is advisory in browsers.
+    }
+    onClose(code, _reason) {
+        this.stopHeartbeat();
+        this.socket = null;
+        if (this.closedByUs) {
+            this.setState({ status: 'closed' });
+            return;
+        }
+        // 4401 AUTH_EXPIRED: re-mint a grant ONCE and reconnect immediately, no backoff.
+        if (code === CHAT_CLOSE_CODES.AUTH_EXPIRED && !this.reauthAttempted) {
+            this.reauthAttempted = true;
+            this.setState({ status: 'reconnecting' });
+            void this.openSocket();
+            return;
+        }
+        // 4403 REVOKED: access pulled. Stop — a reconnect would just re-deny at mint.
+        if (code === CHAT_CLOSE_CODES.REVOKED) {
+            this.closedByUs = true;
+            this.controller.close();
+            this.setState({ status: 'closed', lastErrorCode: 'revoked' });
+            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);
+    }
+    // ---- inbound frames ----
+    onMessage(data) {
+        const frame = parseFrame(data);
+        if (!frame || !frame.type)
+            return;
+        const payload = frame.payload ?? {};
+        switch (frame.type) {
+            case 'message':
+                return this.applyMessage(payload.message);
+            case 'ack':
+                return this.applyAck(payload);
+            case 'history-page':
+                return this.applyHistoryPage(payload.messages ?? []);
+            case 'presence':
+                return this.setState({ presence: payload.online ?? [] });
+            case 'typing':
+                return this.applyTyping(payload.uid);
+            case 'snapshot':
+                return this.applyChannelSnapshot(payload);
+            case 'error':
+                return this.setState({ lastErrorCode: String(payload.code ?? 'error') });
+            default:
+                return; // unknown/optional types tolerated (forward compat)
+        }
+    }
+    applyChannelSnapshot(snap) {
+        // Guard: an inbox snapshot must never reach a channel client.
+        if (isInboxSnapshot(snap))
+            return;
+        // The snapshot tells us the authoritative tail + our read cursor. If the DO's
+        // tail is ahead of what we have, a missed delta is repaired by a history fetch.
+        if (typeof snap.lastMessageSeq === 'number' && snap.lastMessageSeq > this.resumeSeq) {
+            // We've reconnected and may have gaps below the tail — pull the latest page.
+            this.requestHistory(null);
+        }
+    }
+    applyMessage(row) {
+        if (!row || typeof row.seq !== 'number')
+            return;
+        const mapped = wireRowToMessage(row, this.config.threadId);
+        this.mergeMessage(mapped, row);
+        if (row.seq > this.resumeSeq)
+            this.resumeSeq = row.seq;
+    }
+    /**
+     * Merge a server message: reconcile an optimistic echo by clientMessageId (swap
+     * the `optimistic:` row for the canonical seq row), or insert/replace by seq.
+     * Keeps the list sorted ascending by seq with optimistic rows at the tail.
+     */
+    mergeMessage(mapped, row) {
+        const next = this.state.messages.filter((m) => m.messageId !== mapped.messageId &&
+            // drop the optimistic placeholder this server row reconciles
+            (m.meta?.clientMessageId !== row.clientMessageId || !m.meta?.optimistic));
+        next.push(mapped);
+        next.sort(sortBySeq);
+        this.setState({ messages: next });
+    }
+    applyAck(payload) {
+        // A read-ack echo carries readSeq only — nothing to reconcile locally.
+        if (payload.clientMessageId == null || typeof payload.seq !== 'number')
+            return;
+        // Reconcile the optimistic echo: stamp the server seq onto it. The canonical
+        // `message` broadcast (which the sender also receives) replaces it fully; this
+        // ack guarantees the seq even if the broadcast is dropped/reordered.
+        const seq = payload.seq;
+        const cmid = payload.clientMessageId;
+        const next = this.state.messages.map((m) => m.meta?.optimistic && m.meta?.clientMessageId === cmid
+            ? { ...m, messageId: seqToMessageId(seq), meta: { ...m.meta, optimistic: false, seq } }
+            : m);
+        next.sort(sortBySeq);
+        if (seq > this.resumeSeq)
+            this.resumeSeq = seq;
+        this.setState({ messages: next });
+    }
+    applyHistoryPage(rows) {
+        const mapped = rows.map((r) => wireRowToMessage(r, this.config.threadId));
+        const bySeq = new Map();
+        for (const m of this.state.messages)
+            bySeq.set(m.messageId, m);
+        for (const m of mapped)
+            bySeq.set(m.messageId, m);
+        const merged = [...bySeq.values()].sort(sortBySeq);
+        for (const r of rows)
+            if (r.seq > this.resumeSeq)
+                this.resumeSeq = r.seq;
+        this.setState({
+            messages: merged,
+            isFetchingOlder: false,
+            hasOlder: rows.length >= HISTORY_PAGE_MAX,
+        });
+    }
+    applyTyping(uid) {
+        if (!uid || uid === this.config.currentUserId)
+            return;
+        if (!this.state.typing.includes(uid))
+            this.setState({ typing: [...this.state.typing, uid] });
+        const prev = this.typingTimers.get(uid);
+        if (prev)
+            this.timers.clearTimeout(prev);
+        this.typingTimers.set(uid, this.timers.setTimeout(() => {
+            this.typingTimers.delete(uid);
+            this.setState({ typing: this.state.typing.filter((u) => u !== uid) });
+        }, TYPING_COALESCE_MS * 2));
+    }
+    // ---- outbound actions ----
+    sendFrame(type, payload) {
+        if (!this.socket || !this.socket.isOpen)
+            return false;
+        this.socket.send(buildFrame(type, payload));
+        return true;
+    }
+    /**
+     * Optimistic send: render the echo immediately keyed by clientMessageId, then
+     * emit the `send` frame. The server `ack`/`message` reconciles on the seq.
+     */
+    send(args) {
+        const now = this.timers.now();
+        const echo = optimisticMessage({
+            clientMessageId: args.clientMessageId,
+            threadId: this.config.threadId,
+            senderId: this.config.currentUserId,
+            text: args.text,
+            createdAt: now,
+            replyTo: args.replyTo ? { messageId: seqToMessageId(args.replyTo.messageSeq), messagePreview: args.replyTo.preview } : null,
+        });
+        const next = [...this.state.messages, echo].sort(sortBySeq);
+        this.setState({ messages: next, lastErrorCode: null });
+        this.sendFrame(CLIENT_FRAME.SEND, {
+            clientMessageId: args.clientMessageId,
+            text: args.text,
+            replyTo: args.replyTo ?? null,
+        });
+    }
+    /** Explicit read ack (delivery != read). `focused` => the channel is open + at latest. */
+    readAck(readSeq, focused) {
+        this.sendFrame(CLIENT_FRAME.READ_ACK, { readSeq, focused });
+    }
+    /** Coalesced typing signal: at most one frame per TYPING_COALESCE_MS. */
+    typing() {
+        const now = this.timers.now();
+        if (now - this.lastTypingSentAt < TYPING_COALESCE_MS)
+            return;
+        this.lastTypingSentAt = now;
+        this.sendFrame(CLIENT_FRAME.TYPING, {});
+    }
+    presenceSubscribe() {
+        this.presenceSubscribed = true;
+        this.sendFrame(CLIENT_FRAME.PRESENCE_SUBSCRIBE, {});
+    }
+    presenceUnsubscribe() {
+        this.presenceSubscribed = false;
+        this.sendFrame(CLIENT_FRAME.PRESENCE_UNSUBSCRIBE, {});
+        this.setState({ presence: [] });
+    }
+    /** Fetch the page of history older than the oldest loaded message (epoch-aware by seq). */
+    fetchOlder() {
+        if (this.state.isFetchingOlder || !this.state.hasOlder)
+            return;
+        const oldest = this.state.messages.find((m) => typeof m.meta?.seq === 'number');
+        const beforeSeq = oldest && typeof oldest.meta?.seq === 'number' ? oldest.meta.seq : null;
+        this.setState({ isFetchingOlder: true });
+        this.requestHistory(beforeSeq);
+    }
+    requestHistory(beforeSeq) {
+        this.sendFrame(CLIENT_FRAME.HISTORY, { beforeSeq, limit: HISTORY_PAGE_MAX });
+    }
+    // ---- heartbeat (20s) ----
+    startHeartbeat() {
+        this.stopHeartbeat();
+        const tick = () => {
+            if (!this.socket || !this.socket.isOpen)
+                return;
+            this.sendFrame(CLIENT_FRAME.HEARTBEAT, {});
+            this.heartbeatTimer = this.timers.setTimeout(tick, HEARTBEAT_MS);
+        };
+        this.heartbeatTimer = this.timers.setTimeout(tick, HEARTBEAT_MS);
+    }
+    stopHeartbeat() {
+        if (this.heartbeatTimer != null) {
+            this.timers.clearTimeout(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+    }
+    // ---- teardown ----
+    /** Permanently close this client (auth-user switch / unmount). Idempotent. */
+    close() {
+        this.closedByUs = true;
+        this.controller.close();
+        this.stopHeartbeat();
+        for (const t of this.typingTimers.values())
+            this.timers.clearTimeout(t);
+        this.typingTimers.clear();
+        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', typing: [], presence: [] });
+    }
+}
+function sortBySeq(a, b) {
+    const sa = typeof a.meta?.seq === 'number' ? a.meta.seq : Number.POSITIVE_INFINITY;
+    const sb = typeof b.meta?.seq === 'number' ? b.meta.seq : Number.POSITIVE_INFINITY;
+    if (sa !== sb)
+        return sa - sb;
+    return a.createdAt - b.createdAt;
+}
+//# sourceMappingURL=channel-client.js.map

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

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

package/dist/realtime/inbox-client.d.ts

@@ -0,0 +1,55 @@
+import { type WireRegistryEntry } from './wire.js';
+import type { SocketFactory } from './socket.js';
+import type { GrantProvider, TransportTimers, RealtimeStatus } from './shared.js';
+export interface InboxClientState {
+    status: RealtimeStatus;
+    /** Active (non-tombstoned) channel/invite registry entries — Chats-view visibility. */
+    registry: WireRegistryEntry[];
+    /** True if ANY active channel/invite has unread (drives the dock dot). */
+    hasUnread: boolean;
+    /** The set of channelRefs that currently carry an unread dot (per-row dots). */
+    unreadChannelRefs: string[];
+}
+export interface InboxClientConfig {
+    endpoint: string;
+    /** The authenticated uid (the inbox owner; the DO serves no one else's data). */
+    currentUserId: string;
+    /** Mints/refreshes an INBOX-scope grant (scope `{ kind:'inbox', uid }`). */
+    grantProvider: GrantProvider;
+    socketFactory: SocketFactory;
+    timers?: TransportTimers;
+    reconnect?: {
+        baseDelayMs?: number;
+        maxDelayMs?: number;
+        maxAttempts?: number | null;
+        random?: () => number;
+    };
+}
+export declare class InboxClient {
+    private readonly config;
+    private readonly timers;
+    private readonly controller;
+    private socket;
+    private state;
+    private readonly listeners;
+    private reauthAttempted;
+    private reconnectTimer;
+    private closedByUs;
+    constructor(config: InboxClientConfig);
+    getState(): InboxClientState;
+    subscribe(fn: (s: InboxClientState) => void): () => void;
+    private setState;
+    connect(): Promise<void>;
+    private openSocket;
+    private onOpen;
+    private onClose;
+    private scheduleReconnect;
+    private onMessage;
+    private applySnapshot;
+    private sendFrame;
+    /** True if a specific channel/invite currently carries an unread dot. */
+    channelHasUnread(channelRef: string): boolean;
+    /** Permanently close (auth-user switch / unmount). Idempotent. */
+    close(): void;
+}
+//# sourceMappingURL=inbox-client.d.ts.map

package/dist/realtime/inbox-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox-client.d.ts","sourceRoot":"","sources":["../../src/realtime/inbox-client.ts"],"names":[],"mappings":"AAWA,OAAO,EAOL,KAAK,iBAAiB,EACvB,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,uFAAuF;IACvF,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,0EAA0E;IAC1E,SAAS,EAAE,OAAO,CAAC;IACnB,gFAAgF;IAChF,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,aAAa,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,SAAS,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,MAAM,CAAA;KAAE,CAAC;CAC/G;AAID,qBAAa,WAAW;IAUV,OAAO,CAAC,QAAQ,CAAC,MAAM;IATnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4C;IACtE,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,cAAc,CAA0D;IAChF,OAAO,CAAC,UAAU,CAAS;gBAEE,MAAM,EAAE,iBAAiB;IAKtD,QAAQ,IAAI,gBAAgB;IAI5B,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI;IAKxD,OAAO,CAAC,QAAQ;IAKV,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAOhB,UAAU;IAqBxB,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,OAAO;IAqBf,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,SAAS;IAMjB,yEAAyE;IACzE,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI7C,kEAAkE;IAClE,KAAK,IAAI,IAAI;CAad"}