@ttt-productions/chat-react 0.13.16 → 0.13.18

package/README.md

@@ -1,9 +1,9 @@
 # @ttt-productions/chat-react
 
-Chat **React UI** for TTT Productions apps: chat shell, composer, message list,
+Chat **React UI** for consuming apps: chat shell, composer, message list,
 the name-resolver context, and the realtime-newest-window + infinite-older
-hooks. Chat is PLAIN-TEXT-only — a conversation's files live in the consuming
-app's Conversation Files surface, never in the message timeline, and message text
+hooks. Chat is PLAIN-TEXT-only — files an app attaches to a conversation are the
+app's own surface, never in the message timeline, and message text
 carries no token grammar (no mentions, no autocomplete, no chips).
 
 Built on the pure [`@ttt-productions/chat-core`](../chat-core) package

package/dist/context/ChatNameResolverContext.d.ts

@@ -1,6 +1,5 @@
 import * as React from 'react';
 import type { ChatNameResolution, ChatNameResolver, ChatPrewarmSenders } from '@ttt-productions/chat-core';
-/** A sender name the app could not resolve: pending, unavailable, or failed. */
 export type UnresolvedChatName = Exclude<ChatNameResolution, {
     status: 'resolved';
 }>;
@@ -12,34 +11,12 @@ type ChatNameResolverContextValue = {
 export type ChatNameResolverProviderProps = {
     resolveName: ChatNameResolver;
     prewarm?: ChatPrewarmSenders;
-    /**
-     * Renders a sender whose name is not resolved — the app's own placeholder while the
-     * read is pending, its unavailable state when there is no person to name, and its
-     * load-error state (with `retry`) when the read failed. The chat UI never writes a
-     * stand-in name of its own; without this slot an unresolved sender renders nothing.
-     */
     renderUnresolvedName?: (resolution: UnresolvedChatName) => React.ReactNode;
     children: React.ReactNode;
 };
-/**
- * Wraps any chat-react consumer (typically the whole app shell) and provides the name
- * resolver. Required for any tree that renders <ChatShell>, <MessageList>, or
- * <MessageItemDefault>.
- */
 export declare function ChatNameResolverProvider(props: ChatNameResolverProviderProps): React.JSX.Element;
-/**
- * Strict hook — throws if no provider is wrapped. Used inside this package's own
- * renderers so a missing setup surfaces on first render instead of rendering a sender
- * with no name.
- */
 export declare function useChatNameResolver(): ChatNameResolverContextValue;
-/**
- * Optional variant — returns null instead of throwing when no provider is wrapped.
- * Used internally by the message hooks so headless callers (tests, data-only consumers
- * that render no UI) can still use them.
- */
 export declare function useOptionalChatNameResolver(): ChatNameResolverContextValue | null;
-/** What the app knows about a sender's name right now. Re-renders as the app's cache settles. */
 export declare function useSenderNameResolution(senderId: string): ChatNameResolution;
 export {};
 //# sourceMappingURL=ChatNameResolverContext.d.ts.map

package/dist/context/ChatNameResolverContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatNameResolverContext.d.ts","sourceRoot":"","sources":["../../src/context/ChatNameResolverContext.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,4BAA4B,CAAC;AAEpC,gFAAgF;AAChF,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,EAAE;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC,CAAC;AAErF,KAAK,4BAA4B,GAAG;IAClC,WAAW,EAAE,gBAAgB,CAAC;IAC9B,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,oBAAoB,CAAC,EAAE,CAAC,UAAU,EAAE,kBAAkB,KAAK,KAAK,CAAC,SAAS,CAAC;CAC5E,CAAC;AAIF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,WAAW,EAAE,gBAAgB,CAAC;IAC9B,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,CAAC,UAAU,EAAE,kBAAkB,KAAK,KAAK,CAAC,SAAS,CAAC;IAC3E,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,6BAA6B,qBAS5E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,4BAA4B,CAQlE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,4BAA4B,GAAG,IAAI,CAEjF;AAED,iGAAiG;AACjG,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAG5E"}
+{"version":3,"file":"ChatNameResolverContext.d.ts","sourceRoot":"","sources":["../../src/context/ChatNameResolverContext.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,EAAE;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC,CAAC;AAErF,KAAK,4BAA4B,GAAG;IAClC,WAAW,EAAE,gBAAgB,CAAC;IAC9B,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,oBAAoB,CAAC,EAAE,CAAC,UAAU,EAAE,kBAAkB,KAAK,KAAK,CAAC,SAAS,CAAC;CAC5E,CAAC;AAIF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,WAAW,EAAE,gBAAgB,CAAC;IAC9B,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,oBAAoB,CAAC,EAAE,CAAC,UAAU,EAAE,kBAAkB,KAAK,KAAK,CAAC,SAAS,CAAC;IAC3E,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,6BAA6B,qBAS5E;AAED,wBAAgB,mBAAmB,IAAI,4BAA4B,CAQlE;AAED,wBAAgB,2BAA2B,IAAI,4BAA4B,GAAG,IAAI,CAEjF;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAG5E"}

package/dist/context/ChatNameResolverContext.js

@@ -2,21 +2,11 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import * as React from 'react';
 const ChatNameResolverContext = React.createContext(null);
-/**
- * Wraps any chat-react consumer (typically the whole app shell) and provides the name
- * resolver. Required for any tree that renders <ChatShell>, <MessageList>, or
- * <MessageItemDefault>.
- */
 export function ChatNameResolverProvider(props) {
     const { resolveName, prewarm, renderUnresolvedName, children } = props;
     const value = React.useMemo(() => ({ resolveName, prewarm, renderUnresolvedName }), [resolveName, prewarm, renderUnresolvedName]);
     return (_jsx(ChatNameResolverContext.Provider, { value: value, children: children }));
 }
-/**
- * Strict hook — throws if no provider is wrapped. Used inside this package's own
- * renderers so a missing setup surfaces on first render instead of rendering a sender
- * with no name.
- */
 export function useChatNameResolver() {
     const ctx = React.useContext(ChatNameResolverContext);
     if (!ctx) {
@@ -24,15 +14,9 @@ export function useChatNameResolver() {
     }
     return ctx;
 }
-/**
- * Optional variant — returns null instead of throwing when no provider is wrapped.
- * Used internally by the message hooks so headless callers (tests, data-only consumers
- * that render no UI) can still use them.
- */
 export function useOptionalChatNameResolver() {
     return React.useContext(ChatNameResolverContext);
 }
-/** What the app knows about a sender's name right now. Re-renders as the app's cache settles. */
 export function useSenderNameResolution(senderId) {
     const { resolveName } = useChatNameResolver();
     return resolveName(senderId);

package/dist/context/ChatNameResolverContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChatNameResolverContext.js","sourceRoot":"","sources":["../../src/context/ChatNameResolverContext.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAgB/B,MAAM,uBAAuB,GAAG,KAAK,CAAC,aAAa,CAAsC,IAAI,CAAC,CAAC;AAe/F;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAoC;IAC3E,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IACvE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CACzB,GAAG,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,EACtD,CAAC,WAAW,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAC7C,CAAC;IACF,OAAO,CACL,KAAC,uBAAuB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAoC,CAC9F,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;IACtD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,8GAA8G,CAC/G,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO,KAAK,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;AACnD,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IACtD,MAAM,EAAE,WAAW,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAC9C,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC;AAC/B,CAAC","sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport type {\n  ChatNameResolution,\n  ChatNameResolver,\n  ChatPrewarmSenders,\n} from '@ttt-productions/chat-core';\n\n/** A sender name the app could not resolve: pending, unavailable, or failed. */\nexport type UnresolvedChatName = Exclude<ChatNameResolution, { status: 'resolved' }>;\n\ntype ChatNameResolverContextValue = {\n  resolveName: ChatNameResolver;\n  prewarm?: ChatPrewarmSenders;\n  renderUnresolvedName?: (resolution: UnresolvedChatName) => React.ReactNode;\n};\n\nconst ChatNameResolverContext = React.createContext<ChatNameResolverContextValue | null>(null);\n\nexport type ChatNameResolverProviderProps = {\n  resolveName: ChatNameResolver;\n  prewarm?: ChatPrewarmSenders;\n  /**\n   * Renders a sender whose name is not resolved — the app's own placeholder while the\n   * read is pending, its unavailable state when there is no person to name, and its\n   * load-error state (with `retry`) when the read failed. The chat UI never writes a\n   * stand-in name of its own; without this slot an unresolved sender renders nothing.\n   */\n  renderUnresolvedName?: (resolution: UnresolvedChatName) => React.ReactNode;\n  children: React.ReactNode;\n};\n\n/**\n * Wraps any chat-react consumer (typically the whole app shell) and provides the name\n * resolver. Required for any tree that renders <ChatShell>, <MessageList>, or\n * <MessageItemDefault>.\n */\nexport function ChatNameResolverProvider(props: ChatNameResolverProviderProps) {\n  const { resolveName, prewarm, renderUnresolvedName, children } = props;\n  const value = React.useMemo(\n    () => ({ resolveName, prewarm, renderUnresolvedName }),\n    [resolveName, prewarm, renderUnresolvedName],\n  );\n  return (\n    <ChatNameResolverContext.Provider value={value}>{children}</ChatNameResolverContext.Provider>\n  );\n}\n\n/**\n * Strict hook — throws if no provider is wrapped. Used inside this package's own\n * renderers so a missing setup surfaces on first render instead of rendering a sender\n * with no name.\n */\nexport function useChatNameResolver(): ChatNameResolverContextValue {\n  const ctx = React.useContext(ChatNameResolverContext);\n  if (!ctx) {\n    throw new Error(\n      '[chat-react] ChatNameResolverProvider is required. Wrap your ChatShell tree with <ChatNameResolverProvider>.',\n    );\n  }\n  return ctx;\n}\n\n/**\n * Optional variant — returns null instead of throwing when no provider is wrapped.\n * Used internally by the message hooks so headless callers (tests, data-only consumers\n * that render no UI) can still use them.\n */\nexport function useOptionalChatNameResolver(): ChatNameResolverContextValue | null {\n  return React.useContext(ChatNameResolverContext);\n}\n\n/** What the app knows about a sender's name right now. Re-renders as the app's cache settles. */\nexport function useSenderNameResolution(senderId: string): ChatNameResolution {\n  const { resolveName } = useChatNameResolver();\n  return resolveName(senderId);\n}\n"]}
+{"version":3,"file":"ChatNameResolverContext.js","sourceRoot":"","sources":["../../src/context/ChatNameResolverContext.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAe/B,MAAM,uBAAuB,GAAG,KAAK,CAAC,aAAa,CAAsC,IAAI,CAAC,CAAC;AAS/F,MAAM,UAAU,wBAAwB,CAAC,KAAoC;IAC3E,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IACvE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CACzB,GAAG,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,EACtD,CAAC,WAAW,EAAE,OAAO,EAAE,oBAAoB,CAAC,CAC7C,CAAC;IACF,OAAO,CACL,KAAC,uBAAuB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAoC,CAC9F,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;IACtD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,8GAA8G,CAC/G,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,2BAA2B;IACzC,OAAO,KAAK,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IACtD,MAAM,EAAE,WAAW,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAC9C,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC;AAC/B,CAAC","sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport type {\n  ChatNameResolution,\n  ChatNameResolver,\n  ChatPrewarmSenders,\n} from '@ttt-productions/chat-core';\n\nexport type UnresolvedChatName = Exclude<ChatNameResolution, { status: 'resolved' }>;\n\ntype ChatNameResolverContextValue = {\n  resolveName: ChatNameResolver;\n  prewarm?: ChatPrewarmSenders;\n  renderUnresolvedName?: (resolution: UnresolvedChatName) => React.ReactNode;\n};\n\nconst ChatNameResolverContext = React.createContext<ChatNameResolverContextValue | null>(null);\n\nexport type ChatNameResolverProviderProps = {\n  resolveName: ChatNameResolver;\n  prewarm?: ChatPrewarmSenders;\n  renderUnresolvedName?: (resolution: UnresolvedChatName) => React.ReactNode;\n  children: React.ReactNode;\n};\n\nexport function ChatNameResolverProvider(props: ChatNameResolverProviderProps) {\n  const { resolveName, prewarm, renderUnresolvedName, children } = props;\n  const value = React.useMemo(\n    () => ({ resolveName, prewarm, renderUnresolvedName }),\n    [resolveName, prewarm, renderUnresolvedName],\n  );\n  return (\n    <ChatNameResolverContext.Provider value={value}>{children}</ChatNameResolverContext.Provider>\n  );\n}\n\nexport function useChatNameResolver(): ChatNameResolverContextValue {\n  const ctx = React.useContext(ChatNameResolverContext);\n  if (!ctx) {\n    throw new Error(\n      '[chat-react] ChatNameResolverProvider is required. Wrap your ChatShell tree with <ChatNameResolverProvider>.',\n    );\n  }\n  return ctx;\n}\n\nexport function useOptionalChatNameResolver(): ChatNameResolverContextValue | null {\n  return React.useContext(ChatNameResolverContext);\n}\n\nexport function useSenderNameResolution(senderId: string): ChatNameResolution {\n  const { resolveName } = useChatNameResolver();\n  return resolveName(senderId);\n}\n"]}

package/dist/hooks/useChatMessages.d.ts

@@ -8,13 +8,9 @@ export type UseChatMessagesResult = {
     fetchOlder: () => Promise<void>;
     hasOlder: boolean;
     isFetchingOlder: boolean;
-    /** The live listener's state: `connecting` while it (re)subscribes, `error` once it failed. */
     sourceState: FirestoreSourceState;
-    /** The live listener's failure; the messages already shown stay in `messages`. */
     error: Error | null;
-    /** The last older-page read failed; the list stops asking for older pages until `retry`. */
     olderError: Error | null;
-    /** Re-run what failed: resubscribe a failed listener, re-read a failed older page. */
     retry: () => void;
 };
 export declare function useChatMessages(config: ChatCoreConfig): UseChatMessagesResult;

package/dist/hooks/useChatMessages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useChatMessages.d.ts","sourceRoot":"","sources":["../../src/hooks/useChatMessages.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAOlD,MAAM,MAAM,qBAAqB,GAAG;IAClC,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,+FAA+F;IAC/F,WAAW,EAAE,oBAAoB,CAAC;IAClC,kFAAkF;IAClF,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,4FAA4F;IAC5F,UAAU,EAAE,KAAK,GAAG,IAAI,CAAC;IACzB,sFAAsF;IACtF,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAmCF,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,qBAAqB,CA6F7E"}
+{"version":3,"file":"useChatMessages.d.ts","sourceRoot":"","sources":["../../src/hooks/useChatMessages.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMlD,MAAM,MAAM,qBAAqB,GAAG;IAClC,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,WAAW,EAAE,oBAAoB,CAAC;IAClC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,KAAK,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AA8BF,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,qBAAqB,CAyF7E"}

package/dist/hooks/useChatMessages.js

@@ -4,7 +4,6 @@ import { toMillis } from '@ttt-productions/firebase-helpers';
 import { useFirestoreLiveInfinite } from '@ttt-productions/query-core/react';
 import { messagesColPath } from '../firestore/queries.js';
 import { useOptionalChatNameResolver } from '../context/ChatNameResolverContext.js';
-// Safety limit to prevent memory exhaustion
 const MAX_PAGE_SIZE = 100;
 function mapMsg(data, threadId, messageMeta) {
     const d = data;
@@ -12,9 +11,6 @@ function mapMsg(data, threadId, messageMeta) {
     if (!createdAt) {
         console.error('[useChatMessages] Message missing valid createdAt:', data.id, d.createdAt);
     }
-    // A stored `replyTo` (if any legacy doc still carries one) is deliberately NOT
-    // mapped: chat has no reply-authoring affordance, so the UI has no reply
-    // renderer to feed.
     const appMeta = messageMeta?.(data);
     return {
         messageId: data.id,
@@ -25,8 +21,6 @@ function mapMsg(data, threadId, messageMeta) {
         type: d.type,
         isSystemMessage: d.isSystemMessage ?? undefined,
         referencedUids: Array.isArray(d.referencedUids) ? d.referencedUids : undefined,
-        // Moderation tombstone flag (backend-written) — carried through so renderers
-        // can tombstone the content.
         hidden: d.hidden ?? undefined,
         meta: appMeta ? { ...d.meta, ...appMeta } : d.meta,
     };
@@ -37,9 +31,7 @@ export function useChatMessages(config) {
     if (requestedPageSize > MAX_PAGE_SIZE) {
         console.warn(`[useChatMessages] Requested pageSize ${requestedPageSize} exceeds maximum ${MAX_PAGE_SIZE}. Using ${MAX_PAGE_SIZE}.`);
     }
-    // Stable key segment for the message collection path (string | string[]).
     const pathKey = React.useMemo(() => JSON.stringify(Array.isArray(chatCollectionPath) ? chatCollectionPath : [chatCollectionPath]), [chatCollectionPath]);
-    // Slash-joined collection path for the generic hook (handles nested paths).
     const collectionPath = React.useMemo(() => messagesColPath(chatCollectionPath, threadId, messagesSubcollection).join('/'), [chatCollectionPath, threadId, messagesSubcollection]);
     const { items, isInitialLoading, fetchOlder, hasOlder, isFetchingOlder, sourceState, error, olderError, retry, } = useFirestoreLiveInfinite({
         collectionPath,
@@ -59,8 +51,6 @@ export function useChatMessages(config) {
         select: (data) => mapMsg(data, threadId, messageMeta),
     });
     const messages = React.useMemo(() => (allowed ? items : []), [allowed, items]);
-    // Pre-warm name cache for all visible senders.
-    // Optional resolver: silent no-op if no provider is wrapped.
     const resolverCtx = useOptionalChatNameResolver();
     const senderIds = React.useMemo(() => {
         const set = new Set();

package/dist/hooks/useChatMessages.js.map

@@ -1 +1 @@
-{"version":3,"file":"useChatMessages.js","sourceRoot":"","sources":["../../src/hooks/useChatMessages.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport type { DocumentData } from 'firebase/firestore';\nimport { toMillis } from '@ttt-productions/firebase-helpers';\nimport { useFirestoreLiveInfinite } from '@ttt-productions/query-core/react';\nimport type { FirestoreSourceState } from '@ttt-productions/query-core/types';\nimport type { ChatMessageV1 } from '@ttt-productions/chat-core';\nimport type { ChatCoreConfig } from '../types.js';\nimport { messagesColPath } from '../firestore/queries.js';\nimport { useOptionalChatNameResolver } from '../context/ChatNameResolverContext.js';\n\n// Safety limit to prevent memory exhaustion\nconst MAX_PAGE_SIZE = 100;\n\nexport type UseChatMessagesResult = {\n  allowed: boolean;\n  isInitialLoading: boolean;\n  messages: ChatMessageV1[];\n  fetchOlder: () => Promise<void>;\n  hasOlder: boolean;\n  isFetchingOlder: boolean;\n  /** The live listener's state: `connecting` while it (re)subscribes, `error` once it failed. */\n  sourceState: FirestoreSourceState;\n  /** The live listener's failure; the messages already shown stay in `messages`. */\n  error: Error | null;\n  /** The last older-page read failed; the list stops asking for older pages until `retry`. */\n  olderError: Error | null;\n  /** Re-run what failed: resubscribe a failed listener, re-read a failed older page. */\n  retry: () => void;\n};\n\nfunction mapMsg(\n  data: DocumentData & { id: string },\n  threadId: string,\n  messageMeta: ChatCoreConfig['messageMeta'],\n): ChatMessageV1 {\n  const d = data as any;\n\n  const createdAt = toMillis(d.createdAt);\n\n  if (!createdAt) {\n    console.error('[useChatMessages] Message missing valid createdAt:', data.id, d.createdAt);\n  }\n\n  // A stored `replyTo` (if any legacy doc still carries one) is deliberately NOT\n  // mapped: chat has no reply-authoring affordance, so the UI has no reply\n  // renderer to feed.\n  const appMeta = messageMeta?.(data);\n  return {\n    messageId: data.id,\n    threadId,\n    createdAt: createdAt || 0,\n    senderId: d.senderId,\n    text: d.text ?? '',\n    type: d.type,\n    isSystemMessage: d.isSystemMessage ?? undefined,\n    referencedUids: Array.isArray(d.referencedUids) ? d.referencedUids : undefined,\n    // Moderation tombstone flag (backend-written) — carried through so renderers\n    // can tombstone the content.\n    hidden: d.hidden ?? undefined,\n    meta: appMeta ? { ...d.meta, ...appMeta } : d.meta,\n  };\n}\n\nexport function useChatMessages(config: ChatCoreConfig): UseChatMessagesResult {\n  const {\n    chatCollectionPath,\n    messagesSubcollection = 'messages',\n    threadId,\n    pageSize: requestedPageSize = 20,\n    currentUserId,\n    allowed,\n    createdAtField = 'createdAt',\n    messageMeta,\n  } = config;\n\n  const pageSize = Math.min(requestedPageSize, MAX_PAGE_SIZE);\n\n  if (requestedPageSize > MAX_PAGE_SIZE) {\n    console.warn(\n      `[useChatMessages] Requested pageSize ${requestedPageSize} exceeds maximum ${MAX_PAGE_SIZE}. Using ${MAX_PAGE_SIZE}.`,\n    );\n  }\n\n  // Stable key segment for the message collection path (string | string[]).\n  const pathKey = React.useMemo(\n    () =>\n      JSON.stringify(Array.isArray(chatCollectionPath) ? chatCollectionPath : [chatCollectionPath]),\n    [chatCollectionPath],\n  );\n\n  // Slash-joined collection path for the generic hook (handles nested paths).\n  const collectionPath = React.useMemo(\n    () => messagesColPath(chatCollectionPath, threadId, messagesSubcollection).join('/'),\n    [chatCollectionPath, threadId, messagesSubcollection],\n  );\n\n  const {\n    items,\n    isInitialLoading,\n    fetchOlder,\n    hasOlder,\n    isFetchingOlder,\n    sourceState,\n    error,\n    olderError,\n    retry,\n  } = useFirestoreLiveInfinite<ChatMessageV1>({\n    collectionPath,\n    queryKey: [\n      'chat-core',\n      'messages',\n      pathKey,\n      threadId,\n      messagesSubcollection,\n      pageSize,\n      currentUserId,\n    ],\n    orderByField: createdAtField,\n    pageSize,\n    enabled: allowed,\n    sort: 'asc',\n    select: (data) => mapMsg(data, threadId, messageMeta),\n  });\n\n  const messages = React.useMemo(() => (allowed ? items : []), [allowed, items]);\n\n  // Pre-warm name cache for all visible senders.\n  // Optional resolver: silent no-op if no provider is wrapped.\n  const resolverCtx = useOptionalChatNameResolver();\n  const senderIds = React.useMemo(() => {\n    const set = new Set<string>();\n    for (const m of messages) {\n      set.add(m.senderId);\n      for (const uid of m.referencedUids ?? []) set.add(uid);\n    }\n    return Array.from(set);\n  }, [messages]);\n\n  React.useEffect(() => {\n    if (resolverCtx?.prewarm && senderIds.length > 0) {\n      resolverCtx.prewarm(senderIds);\n    }\n  }, [resolverCtx, senderIds]);\n\n  return {\n    allowed,\n    isInitialLoading: allowed ? isInitialLoading : false,\n    messages,\n    fetchOlder,\n    hasOlder,\n    isFetchingOlder,\n    sourceState,\n    error: allowed ? error : null,\n    olderError: allowed ? olderError : null,\n    retry,\n  };\n}\n"]}
+{"version":3,"file":"useChatMessages.js","sourceRoot":"","sources":["../../src/hooks/useChatMessages.ts"],"names":[],"mappings":"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","sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport type { DocumentData } from 'firebase/firestore';\nimport { toMillis } from '@ttt-productions/firebase-helpers';\nimport { useFirestoreLiveInfinite } from '@ttt-productions/query-core/react';\nimport type { FirestoreSourceState } from '@ttt-productions/query-core/types';\nimport type { ChatMessageV1 } from '@ttt-productions/chat-core';\nimport type { ChatCoreConfig } from '../types.js';\nimport { messagesColPath } from '../firestore/queries.js';\nimport { useOptionalChatNameResolver } from '../context/ChatNameResolverContext.js';\n\nconst MAX_PAGE_SIZE = 100;\n\nexport type UseChatMessagesResult = {\n  allowed: boolean;\n  isInitialLoading: boolean;\n  messages: ChatMessageV1[];\n  fetchOlder: () => Promise<void>;\n  hasOlder: boolean;\n  isFetchingOlder: boolean;\n  sourceState: FirestoreSourceState;\n  error: Error | null;\n  olderError: Error | null;\n  retry: () => void;\n};\n\nfunction mapMsg(\n  data: DocumentData & { id: string },\n  threadId: string,\n  messageMeta: ChatCoreConfig['messageMeta'],\n): ChatMessageV1 {\n  const d = data as any;\n\n  const createdAt = toMillis(d.createdAt);\n\n  if (!createdAt) {\n    console.error('[useChatMessages] Message missing valid createdAt:', data.id, d.createdAt);\n  }\n\n  const appMeta = messageMeta?.(data);\n  return {\n    messageId: data.id,\n    threadId,\n    createdAt: createdAt || 0,\n    senderId: d.senderId,\n    text: d.text ?? '',\n    type: d.type,\n    isSystemMessage: d.isSystemMessage ?? undefined,\n    referencedUids: Array.isArray(d.referencedUids) ? d.referencedUids : undefined,\n    hidden: d.hidden ?? undefined,\n    meta: appMeta ? { ...d.meta, ...appMeta } : d.meta,\n  };\n}\n\nexport function useChatMessages(config: ChatCoreConfig): UseChatMessagesResult {\n  const {\n    chatCollectionPath,\n    messagesSubcollection = 'messages',\n    threadId,\n    pageSize: requestedPageSize = 20,\n    currentUserId,\n    allowed,\n    createdAtField = 'createdAt',\n    messageMeta,\n  } = config;\n\n  const pageSize = Math.min(requestedPageSize, MAX_PAGE_SIZE);\n\n  if (requestedPageSize > MAX_PAGE_SIZE) {\n    console.warn(\n      `[useChatMessages] Requested pageSize ${requestedPageSize} exceeds maximum ${MAX_PAGE_SIZE}. Using ${MAX_PAGE_SIZE}.`,\n    );\n  }\n\n  const pathKey = React.useMemo(\n    () =>\n      JSON.stringify(Array.isArray(chatCollectionPath) ? chatCollectionPath : [chatCollectionPath]),\n    [chatCollectionPath],\n  );\n\n  const collectionPath = React.useMemo(\n    () => messagesColPath(chatCollectionPath, threadId, messagesSubcollection).join('/'),\n    [chatCollectionPath, threadId, messagesSubcollection],\n  );\n\n  const {\n    items,\n    isInitialLoading,\n    fetchOlder,\n    hasOlder,\n    isFetchingOlder,\n    sourceState,\n    error,\n    olderError,\n    retry,\n  } = useFirestoreLiveInfinite<ChatMessageV1>({\n    collectionPath,\n    queryKey: [\n      'chat-core',\n      'messages',\n      pathKey,\n      threadId,\n      messagesSubcollection,\n      pageSize,\n      currentUserId,\n    ],\n    orderByField: createdAtField,\n    pageSize,\n    enabled: allowed,\n    sort: 'asc',\n    select: (data) => mapMsg(data, threadId, messageMeta),\n  });\n\n  const messages = React.useMemo(() => (allowed ? items : []), [allowed, items]);\n\n  const resolverCtx = useOptionalChatNameResolver();\n  const senderIds = React.useMemo(() => {\n    const set = new Set<string>();\n    for (const m of messages) {\n      set.add(m.senderId);\n      for (const uid of m.referencedUids ?? []) set.add(uid);\n    }\n    return Array.from(set);\n  }, [messages]);\n\n  React.useEffect(() => {\n    if (resolverCtx?.prewarm && senderIds.length > 0) {\n      resolverCtx.prewarm(senderIds);\n    }\n  }, [resolverCtx, senderIds]);\n\n  return {\n    allowed,\n    isInitialLoading: allowed ? isInitialLoading : false,\n    messages,\n    fetchOlder,\n    hasOlder,\n    isFetchingOlder,\n    sourceState,\n    error: allowed ? error : null,\n    olderError: allowed ? olderError : null,\n    retry,\n  };\n}\n"]}

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,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,EACf,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,6BAA6B,EAC7B,kBAAkB,GACnB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAK7D,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,mCAAmC,GACpC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAC1E,YAAY,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAC3F,YAAY,EACV,2BAA2B,EAC3B,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAC5F,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AAC3F,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3F,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC1F,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAU5B,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACpE,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,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,EACf,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,6BAA6B,EAC7B,kBAAkB,GACnB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,mCAAmC,GACpC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAC1E,YAAY,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAC3F,YAAY,EACV,2BAA2B,EAC3B,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAC5F,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AAC3F,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3F,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC1F,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACpE,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,qBAAqB,CAAC"}

package/dist/index.js

@@ -2,9 +2,6 @@
 export { ChatNameResolverProvider, useChatNameResolver, useOptionalChatNameResolver, useSenderNameResolution, } from './context/ChatNameResolverContext.js';
 export { SenderName } from './ui/SenderName.js';
 export { useChatMessages } from './hooks/useChatMessages.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 } from './realtime/transport.js';
 export { ChannelClient } from './realtime/channel-client.js';
 export { InboxClient } from './realtime/inbox-client.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAsBb,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,+EAA+E;AAC/E,kFAAkF;AAClF,oFAAoF;AACpF,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,mCAAmC,GACpC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAgC1E,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlD,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,qBAAqB,CAAC","sourcesContent":["'use client';\n\n// @ttt-productions/chat-react — chat React UI, hooks, the Firebase-client\n// adapter config types, and React render types. Depends on the pure\n// @ttt-productions/chat-core for contracts, parser, and grouping.\n//\n// Apps import chat CSS via \"@ttt-productions/chat-react/styles\".\n\n// React-coupled config + render types (previously on chat-core root).\nexport type {\n  ChatCoreConfig,\n  ChatTransportMode,\n  ChatRealtimeTransportConfig,\n  MessageRenderer,\n  MessageRendererRegistry,\n} from './types.js';\n\n// Name-resolver context.\nexport type {\n  ChatNameResolverProviderProps,\n  UnresolvedChatName,\n} from './context/ChatNameResolverContext.js';\nexport {\n  ChatNameResolverProvider,\n  useChatNameResolver,\n  useOptionalChatNameResolver,\n  useSenderNameResolution,\n} from './context/ChatNameResolverContext.js';\nexport { SenderName } from './ui/SenderName.js';\n\nexport type { UseChatMessagesResult } from './hooks/useChatMessages.js';\nexport { useChatMessages } from './hooks/useChatMessages.js';\n\n// Realtime (Cloudflare Durable Object) transport — the client half of the chat\n// worker wire protocol. Opt-in via `ChatCoreConfig.transport === 'realtime'`; the\n// firestore transport stays the unchanged default. See docs/packages/chat-react.md.\nexport { createRealtimeChatClient, createInboxClient } from './realtime/transport.js';\nexport { ChannelClient } from './realtime/channel-client.js';\nexport { InboxClient } from './realtime/inbox-client.js';\nexport { useRealtimeChatMessages } from './realtime/useRealtimeChatMessages.js';\nexport { browserSocketFactory } from './realtime/socket.js';\nexport {\n  ChatAccessDeniedError,\n  isChatAccessDeniedError,\n  CHAT_INITIAL_LOAD_FAILURE_BUDGET_MS,\n} from './realtime/shared.js';\nexport { buildFrame, parseFrame } from './realtime/wire.js';\nexport { CHAT_CLIENT_DIAGNOSTIC_EVENTS } from './realtime/diagnostics.js';\nexport type { RealtimeChatClient, RealtimeTransportConfig } from './realtime/transport.js';\nexport type {\n  ChatClientDiagnosticsOption,\n  ChatClientDiagnosticsSink,\n  ChatClientDiagnosticEventName,\n} from './realtime/diagnostics.js';\nexport type { ChannelClientState, ChannelClientConfig } from './realtime/channel-client.js';\nexport type {\n  InboxClientState,\n  InboxClientConfig,\n  ChatMarkReadOutcome,\n} from './realtime/inbox-client.js';\nexport type { UseRealtimeChatMessagesResult } from './realtime/useRealtimeChatMessages.js';\nexport type { GrantProvider, TransportTimers, RealtimeStatus } from './realtime/shared.js';\nexport type { RealtimeSocket, SocketFactory, SocketHandlers } from './realtime/socket.js';\nexport type {\n  WireMessageRow,\n  WireInboxSnapshot,\n  WireRegistryEntry,\n  ServerFrame,\n} from './realtime/wire.js';\n\n// TODO (re-export when a consumer needs them): the moderation-overlay helpers\n// `RevisionKind`, `ModerationOverlay`, `applyModerationOverlay`, `overlayFromRow`,\n// and `MODERATION_REDACTED_TEXT` live in `./realtime` but are intentionally NOT\n// re-exported from this package root yet — the consuming app's renderer reads moderation\n// state off `message.meta` (the realtime client applies the overlay internally), so\n// nothing imports them from here today. Add them to the block above when a consumer\n// genuinely needs to apply the overlay directly. (Comment-only; rides the next publish.)\n\nexport type { ChatShellProps, ChatLoadFailure } from './ui/ChatShell.js';\nexport { ChatShell } from './ui/ChatShell.js';\nexport { MessageList } from './ui/MessageList.js';\nexport type { ChatScrollContainerProps } from './ui/MessageList.js';\nexport type { ComposerProps } from './ui/Composer.js';\nexport { Composer } from './ui/Composer.js';\nexport type { MessageItemDefaultProps } from './ui/MessageItemDefault.js';\nexport { MessageItemDefault } from './ui/MessageItemDefault.js';\nexport { MessageActions, ThreadActions } from './ui/menus.js';\nexport { MessageText, type MessageTextProps } from './ui/MessageText.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAcb,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,mCAAmC,GACpC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAwB1E,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlD,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,qBAAqB,CAAC","sourcesContent":["'use client';\n\nexport type {\n  ChatCoreConfig,\n  ChatTransportMode,\n  ChatRealtimeTransportConfig,\n  MessageRenderer,\n  MessageRendererRegistry,\n} from './types.js';\n\nexport type {\n  ChatNameResolverProviderProps,\n  UnresolvedChatName,\n} from './context/ChatNameResolverContext.js';\nexport {\n  ChatNameResolverProvider,\n  useChatNameResolver,\n  useOptionalChatNameResolver,\n  useSenderNameResolution,\n} from './context/ChatNameResolverContext.js';\nexport { SenderName } from './ui/SenderName.js';\n\nexport type { UseChatMessagesResult } from './hooks/useChatMessages.js';\nexport { useChatMessages } from './hooks/useChatMessages.js';\n\nexport { createRealtimeChatClient, createInboxClient } from './realtime/transport.js';\nexport { ChannelClient } from './realtime/channel-client.js';\nexport { InboxClient } from './realtime/inbox-client.js';\nexport { useRealtimeChatMessages } from './realtime/useRealtimeChatMessages.js';\nexport { browserSocketFactory } from './realtime/socket.js';\nexport {\n  ChatAccessDeniedError,\n  isChatAccessDeniedError,\n  CHAT_INITIAL_LOAD_FAILURE_BUDGET_MS,\n} from './realtime/shared.js';\nexport { buildFrame, parseFrame } from './realtime/wire.js';\nexport { CHAT_CLIENT_DIAGNOSTIC_EVENTS } from './realtime/diagnostics.js';\nexport type { RealtimeChatClient, RealtimeTransportConfig } from './realtime/transport.js';\nexport type {\n  ChatClientDiagnosticsOption,\n  ChatClientDiagnosticsSink,\n  ChatClientDiagnosticEventName,\n} from './realtime/diagnostics.js';\nexport type { ChannelClientState, ChannelClientConfig } from './realtime/channel-client.js';\nexport type {\n  InboxClientState,\n  InboxClientConfig,\n  ChatMarkReadOutcome,\n} from './realtime/inbox-client.js';\nexport type { UseRealtimeChatMessagesResult } from './realtime/useRealtimeChatMessages.js';\nexport type { GrantProvider, TransportTimers, RealtimeStatus } from './realtime/shared.js';\nexport type { RealtimeSocket, SocketFactory, SocketHandlers } from './realtime/socket.js';\nexport type {\n  WireMessageRow,\n  WireInboxSnapshot,\n  WireRegistryEntry,\n  ServerFrame,\n} from './realtime/wire.js';\n\nexport type { ChatShellProps, ChatLoadFailure } from './ui/ChatShell.js';\nexport { ChatShell } from './ui/ChatShell.js';\nexport { MessageList } from './ui/MessageList.js';\nexport type { ChatScrollContainerProps } from './ui/MessageList.js';\nexport type { ComposerProps } from './ui/Composer.js';\nexport { Composer } from './ui/Composer.js';\nexport type { MessageItemDefaultProps } from './ui/MessageItemDefault.js';\nexport { MessageItemDefault } from './ui/MessageItemDefault.js';\nexport { MessageActions, ThreadActions } from './ui/menus.js';\nexport { MessageText, type MessageTextProps } from './ui/MessageText.js';\n"]}

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

@@ -4,75 +4,29 @@ import type { GrantProvider, TransportTimers, RealtimeStatus } from './shared.js
 import { type ChatClientDiagnosticsOption } from './diagnostics.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;
-    /**
-     * True once the FIRST authoritative chat data has been applied — a non-resync
-     * resume snapshot, OR the first history page (INCLUDING an empty one). Drives the
-     * hook's `isInitialLoading` so the shell shows an honest "Opening chat…" state
-     * while the first data is loading, and a real empty-chat surface only after an
-     * authoritative empty result. NEVER inferred from `messages.length === 0` (an
-     * empty first history page IS a successful load). Once true it stays true — a
-     * later disconnect/reconnect keeps loaded messages mounted, not a re-loader.
-     * A grant retry / socket open before any snapshot leaves it false.
-     */
     hasLoadedInitialData: boolean;
-    /**
-     * True once the first open has failed for good enough to say so: attempts have kept
-     * failing for {@link CHAT_INITIAL_LOAD_FAILURE_BUDGET_MS} without any initial data, or
-     * reconnecting stopped (gave up, or the socket was revoked) before any. The client keeps
-     * retrying in the background; the first authoritative data, or a manual `retryNow()`,
-     * clears it. Never true once initial data has loaded — a later outage keeps the loaded
-     * messages under the reconnect banner instead.
-     */
     initialLoadFailed: boolean;
-    /**
-     * True while the channel is CURRENT: the socket is open, initial data has loaded, and the
-     * authoritative state has been re-applied since this socket opened — a non-resync resume
-     * snapshot, or the history page answering a resync. Cleared the moment the socket closes,
-     * reconnects, or is denied, and false again on every new socket until its resume lands, so a
-     * consumer that must act on the conversation's current terms (an agreement, an offer) waits for
-     * it. Unlike `hasLoadedInitialData` it is never sticky.
-     */
     isSynced: boolean;
 }
 export interface ChannelClientConfig {
-    /** WebSocket endpoint base, e.g. `wss://chat.example.com`. 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;
     };
-    /**
-     * OPT-IN structured client diagnostics (default OFF — absent/`false` changes
-     * nothing and costs one nullish check per decision point). `true` emits one
-     * `console.debug` line per decision with a stable `chat_client_*` event name
-     * and a compact, content-free JSON payload; a function routes those entries
-     * into the app's own logger instead. Never logs message text, captions,
-     * filenames, URLs, tokens, or previews — ids, seqs, states, counts, and codes
-     * only. See `./diagnostics.ts`.
-     */
     diagnostics?: ChatClientDiagnosticsOption;
 }
 export declare class ChannelClient {
@@ -82,280 +36,78 @@ export declare class ChannelClient {
     private socket;
     private state;
     private readonly listeners;
-    /** Resume cursor: highest seq we've durably applied. Sent on resume after reconnect. */
     private resumeSeq;
-    /** Last read-ack the UI requested; re-sent on reconnect so a drop during a closed
-     *  socket window is recovered (M2). */
     private lastReadAck;
-    /** True after a `4401` re-grant has been attempted for the CURRENT connect cycle (once-only). */
     private reauthAttempted;
     private presenceSubscribed;
     private heartbeatTimer;
-    /**
-     * When the CURRENT socket last proved it was alive: set on open, refreshed by
-     * every successfully parsed inbound frame (`heartbeat-ack` included — that IS
-     * the DO's liveness answer). Null whenever no socket is live, so the watchdog
-     * can never judge a socket that does not exist. See {@link INBOUND_SILENCE_LIMIT_MS}.
-     */
     private lastInboundAt;
     private historyRequests;
     private typingTimers;
     private lastTypingSentAt;
     private reconnectTimer;
-    /** Single scheduled re-send for the membership-pending window (never stacks). */
     private membershipRetryTimer;
     private closedByUs;
-    /**
-     * The current lifecycle's number, advanced by every `connect()` and `close()`. A grant
-     * that resolves, or a timer that fires, for an older lifecycle is dropped — so a
-     * close → connect while an earlier grant is still minting can never open a second
-     * socket or touch the new lifecycle's state (FRONTEND-108).
-     */
     private lifecycle;
-    /** Reports the first open as failed once its attempts have failed for the budget. */
     private readonly initialLoad;
-    /**
-     * Per-seq moderation overlay (the max-revision wins). A `revision` frame writes
-     * here keyed by `messageSeq` so it applies whether it arrives BEFORE its base
-     * row (re-applied when the row later renders) or AFTER (re-renders the present
-     * row in place). Merged with the row's own inline `moderationKind` so a row that
-     * arrives already-moderated from the DO AND one covered by a live frame both
-     * render the moderated state. */
     private overlays;
-    /**
-     * The ORIGINAL (un-overlaid) mapped message per seq. A `restore` revision must
-     * revert a previously-redacted message to its original text, so re-renders start
-     * from this cache rather than the (possibly already-blanked) message in state. */
     private originalRows;
-    /**
-     * Un-acked sends keyed by clientMessageId. A send is added here when its frame is
-     * written and removed when its `ack` (or the canonical `message` echo carrying the
-     * same clientMessageId) arrives. On every reconnect resume they are RE-SENT with
-     * the SAME clientMessageId — the DO dedups (re-acks without re-broadcast), so a
-     * send that lost its socket before the ack is delivered exactly once. A pending
-     * send that exceeds the attempt/age cap is flipped to a visible failed state
-     * (retry affordance) instead of staying a ghost. */
     private pendingSends;
-    /**
-     * The structured diagnostics emitter, or null when diagnostics are off (the
-     * default). Every call site uses `this.diag?.(...)` so the off path constructs
-     * no payload at all.
-     */
     private readonly diag;
-    /** Monotonic socket-open attempt counter (diagnostics correlation only). */
     private connectAttempt;
-    /** Why the CURRENT connect attempt is happening (diagnostics only). */
     private reconnectCause;
-    /** The last close code observed, carried into the next attempt's cause line. */
     private lastCloseCode;
     constructor(config: ChannelClientConfig);
     getState(): ChannelClientState;
     subscribe(fn: (s: ChannelClientState) => void): () => void;
     private setState;
     connect(): Promise<void>;
-    /**
-     * Retry now (the first-open failure's Retry). While a reconnect is waiting out its
-     * backoff, the wait is cancelled and a socket opens at once; a lifecycle that stopped
-     * (reconnect gave up, or the socket was revoked) starts again; an attempt already in
-     * flight is left to finish. Either way the first-open failure clears, so the opening state
-     * shows while the retry runs. The spent budget stays spent: a retry that fails is reported
-     * again at once, and one that hangs a full budget later.
-     */
     retryNow(): void;
     private startLifecycle;
-    /** The first open has failed for long enough to say so (see `initialLoadFailed`). */
     private reportInitialLoadFailed;
-    /** The first authoritative data is applied; it ends any first-open failure. */
     private initialDataLoaded;
     private openSocket;
     private onOpen;
-    /**
-     * On reconnect, re-send each un-acked pending send with the SAME clientMessageId
-     * (the DO dedups). A send that has exceeded the attempt or age cap is flipped to a
-     * visible failed state instead of being resent forever — the ghost becomes a
-     * retryable failure the UI can surface.
-     */
     private resendPendingSends;
-    /**
-     * Flip an un-acked optimistic row to a visible failed state. The pending entry is
-     * RETAINED (marked `failed`) so retrySend() can re-queue it with the SAME
-     * clientMessageId; the row is marked `meta.sendFailed` (plus the correlated
-     * `sendFailureCode`/`sendRetryable` when a `send-rejected` frame supplied them) so
-     * the default renderer shows the right reason + retry affordance rather than an
-     * indistinguishable "sent" bubble. A late ack/echo still reconciles + clears it.
-     *
-     * `code`/`retryable` are present for a correlated rejection (terminal) or a
-     * budget-exhausted server-retryable send; absent for a blind reconnect give-up
-     * (which keeps the neutral `send-failed` code).
-     */
     private failPendingSend;
-    /** Clear a pending send's per-send retry timer (idempotent). */
     private clearSendRetryTimer;
-    /**
-     * Stop tracking a send (acked / reconciled by an echo / history row): cancel its
-     * per-send retry timer first so a late reconcile never leaves a stray timer that
-     * would resend after the send already landed, then drop it from the map.
-     */
     private clearPendingSend;
-    /** One timer for the membership-pending re-send window; a newer frame resets it. */
     private scheduleMembershipPendingRetry;
-    /**
-     * Handle a CORRELATED `send-rejected` frame (the target protocol): parse the
-     * untrusted payload with the shared schema, correlate to EXACTLY ONE pending send
-     * by clientMessageId, and either fail just that bubble (terminal) or schedule a
-     * single per-send resend (retryable).
-     *
-     * A frame that fails validation is NOT simply dropped when it still names one of
-     * OUR pending sends: unlike an unknown frame type, an id-correlated rejection is
-     * the server explicitly telling us this send did not land — swallowing it would
-     * strand the bubble on "Sending…" forever (no further frame, no reconnect, no
-     * budget check ever runs). A future/unknown rejection code (version skew during a
-     * rollout) therefore fails that send CLOSED with the neutral copy + Retry. A
-     * malformed frame with no recognizable pending id is dropped (forward-compat
-     * noise), never surfaced as an error.
-     */
     private applySendRejected;
-    /**
-     * Schedule EXACTLY ONE per-send resend of a correlated retryable rejection (never
-     * stacks — a newer rejection clears the prior timer first). When it fires it
-     * re-sends the SAME clientMessageId (the DO dedups) unless the wall-clock budget
-     * has elapsed, in which case the send fails with its recorded reason.
-     */
     private scheduleSendRetry;
-    /** Clamp a server `retryAfterMs` hint into a sane resend delay (defaulting when absent). */
     private clampRetryDelay;
-    /**
-     * Flip EVERY un-acked pending send to the visible failed state. Called on the
-     * terminal close paths (4403 REVOKED, reconnect give-up) — without this, a send
-     * in flight when the socket dies for good shows "Sending…" until unmount.
-     */
     private failAllPendingSends;
-    /**
-     * Retry a FAILED (or still-pending) send, RE-USING its original clientMessageId
-     * so the DO's send-idempotency dedups against any copy that actually landed.
-     * Resets the attempt/age budget, clears the row's `sendFailed` marker (back to
-     * the normal pending/optimistic look), and re-sends immediately when the socket
-     * is open — otherwise the entry rides the next reconnect's automatic resend.
-     * Returns false when the clientMessageId is not a tracked pending send (already
-     * acked/reconciled, or never sent from this client).
-     */
     retrySend(clientMessageId: string): boolean;
     private onError;
     private onClose;
     private scheduleReconnect;
-    /**
-     * Terminal access denial surfaced by the grant provider (ChatAccessDeniedError).
-     * A reconnect would just re-deny at the next mint, so stop for good — the same
-     * terminal posture as a 4403 REVOKED close: mark closed-by-us, close the reconnect
-     * controller, and flip every un-acked pending send to the visible failed state.
-     * `access-denied` is set AFTER failAllPendingSends so its 'send-failed' code does
-     * not win as the surfaced error; the React hook maps 'access-denied' to
-     * `allowed: false` so the shell renders its existing no-access surface.
-     */
     private denyAccessTerminally;
     private onMessage;
-    /**
-     * Apply a live moderation `revision` frame: record the overlay keyed by seq
-     * (max-`messageRevision` wins — a stale/older frame is ignored) and re-render the
-     * matching message in place if it is already loaded. If the base row hasn't
-     * arrived yet the overlay is retained and re-applied when the row renders, so a
-     * frame that races ahead of its message never lets the original content show.
-     */
     private applyRevisionFrame;
-    /**
-     * The effective overlay for a seq = the max-`messageRevision` between the row's
-     * own inline overlay (from the DO history/delta merge) and any received `revision`
-     * frame stored in `this.overlays`. Either source may be ahead of the other.
-     */
     private effectiveOverlay;
-    /** Map a DO row to a UI message with its effective moderation overlay applied. */
     private renderRow;
-    /**
-     * Apply the Contract C resume snapshot. The DO always returns the authoritative
-     * tail + read cursor and, per the pinned contract, EITHER a contiguous delta
-     * (`resync:false`) OR a resync directive (`resync:true`).
-     *
-     * - `resync === false`: apply the contiguous `delta` (the ≤500-message backlog
-     *   after our cursor, oldest-first) through the same render/merge path as a live
-     *   `message`, then advance `resumeSeq` to `lastMessageSeq`. This heals ANY gap
-     *   within the backlog — including moderation `revision`s the DO baked into the
-     *   delta rows — with no history fetch, so a >50-message reconnect gap is no
-     *   longer a permanent hole.
-     * - `resync === true`: the gap is beyond the backlog (or we sent no cursor). Drop
-     *   the local tail (messages + overlays + original-row cache) and re-page history
-     *   from the top via a cursorless `requestHistory(null)`.
-     *
-     * A pre-contract DO (no `resync`/`delta`) is treated as `resync:true` ⇒ the safe
-     * re-page path, so a stale worker never strands the client. An empty delta with
-     * `resync:false` (already caught up) is a no-op beyond advancing the cursor.
-     */
     private applyChannelSnapshot;
-    /**
-     * Apply one server row (a live `message` frame or a resume-delta row) and record
-     * the decision the client made about it.
-     *
-     * Diagnostics bounding: a LIVE frame always emits one `chat_client_frame_applied`
-     * line; a DELTA row emits one only when it is materially interesting (carries a
-     * moderation kind, or reconciles one of our optimistic sends) — a 500-row backlog
-     * is otherwise summarized by `chat_client_resume_result` rather than spamming 500
-     * lines.
-     */
     private applyMessage;
-    /**
-     * The pre-merge view of a row's seq: whether we already hold that seq, and whether
-     * this row reconciles a live optimistic send.
-     * Diagnostics-only — never called when diagnostics are off.
-     */
     private priorRowFacts;
-    /**
-     * 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;
     }): boolean;
-    /**
-     * Explicit read ack (delivery != read). `focused` => the channel is open + at latest.
-     * Remembers the cursor (re-sent on reconnect) and returns whether the frame was
-     * actually sent over an open socket, so the caller only advances its local
-     * already-acked marker on a real send (M2).
-     */
     readAck(readSeq: number, focused: boolean): boolean;
-    /** 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;
-    /** True when the live socket has produced no parseable frame for too long. */
     private isInboundSilent;
-    /**
-     * The channel DO auto-acks every heartbeat, so silence past
-     * {@link INBOUND_SILENCE_LIMIT_MS} means this socket is dead even though no
-     * `onclose` ever fired (the half-open-connection case that otherwise strands
-     * the UI on a socket that will never deliver another message).
-     *
-     * Close it LOCALLY and deliberately WITHOUT setting `closedByUs`, so the close
-     * lands on `onClose`'s ordinary transient path — which already owns the
-     * reconnect scheduling, the backoff, and the resume-cursor recovery. Nothing
-     * about reconnect policy is duplicated here.
-     */
     private closeDeadSocket;
-    /** Permanently close this client (auth-user switch / unmount). Idempotent. */
     close(): void;
 }
 //# sourceMappingURL=channel-client.d.ts.map