@ttt-productions/chat-react 0.13.2 → 0.13.4

package/README.md

@@ -1,21 +1,21 @@
 # @ttt-productions/chat-react
 
 Chat **React UI** for TTT Productions apps: chat shell, composer, message list,
-the generic mention autocomplete UI, the name-resolver context, and the
-realtime-newest-window + infinite-older hooks. Chat is TEXT-only — a
-conversation's files live in the consuming app's Conversation Files surface,
-never in the message timeline.
+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
+carries no token grammar (no mentions, no autocomplete, no chips).
 
 Built on the pure [`@ttt-productions/chat-core`](../chat-core) package
-(contracts, mention parser/serializer, grouping). A non-React consumer (a Cloud
-Function, a script, a future native/TV client) installs `chat-core` and pulls
-in none of this frontend tree.
+(contracts, grouping). A non-React consumer (a Cloud Function, a script, a
+future native/TV client) installs `chat-core` and pulls in none of this frontend
+tree.
 
 ## Entry points
 
 - `.` — React components, hooks, the Firebase-client adapter config types
-  (`ChatCoreConfig`, `ChatMentionConfig`), and the React render types
-  (`MessageRenderer`, `RenderableMentionProvider`, `MentionResultRenderer`).
+  (`ChatCoreConfig`), and the React render types (`MessageRenderer`,
+  `MessageRendererRegistry`).
 - `./styles` — chat CSS. Import once in your app layout:
   `import "@ttt-productions/chat-react/styles";`
 
@@ -27,5 +27,7 @@ are optional peers — provided by the consuming app.
 ## Boundary
 
 `chat-react` does not import `ttt-core`, does not hardcode TTT origins, and does
-not build TTT storage paths — it runs no upload path at all. TTT mention kinds,
-permissions, provider lists, routing, and search live in TTT code.
+not build TTT storage paths — it runs no upload path at all. It owns no mention
+machinery either: mentions belong to the app's Square-posts surface, not to chat.
+And it owns no reply-to machinery: every send path takes text alone, because the
+product has no affordance for replying to a specific message.

package/dist/context/ChatNameResolverContext.d.ts

@@ -16,9 +16,9 @@ export type ChatNameResolverProviderProps = {
  */
 export declare function ChatNameResolverProvider(props: ChatNameResolverProviderProps): React.JSX.Element;
 /**
- * Strict hook — throws if no provider is wrapped. Used inside chat-core's
- * own renderers (MessageItemDefault, ReplyQuote) so a missing setup surfaces
- * immediately on first render rather than silently rendering "User".
+ * Strict hook — throws if no provider is wrapped. Used inside this package's
+ * own renderers (MessageItemDefault) so a missing setup surfaces immediately on
+ * first render rather than silently rendering "User".
  */
 export declare function useChatNameResolver(): ChatNameResolverContextValue;
 /**

package/dist/context/ChatNameResolverContext.js

@@ -13,9 +13,9 @@ export function ChatNameResolverProvider(props) {
     return (_jsx(ChatNameResolverContext.Provider, { value: value, children: children }));
 }
 /**
- * Strict hook — throws if no provider is wrapped. Used inside chat-core's
- * own renderers (MessageItemDefault, ReplyQuote) so a missing setup surfaces
- * immediately on first render rather than silently rendering "User".
+ * Strict hook — throws if no provider is wrapped. Used inside this package's
+ * own renderers (MessageItemDefault) so a missing setup surfaces immediately on
+ * first render rather than silently rendering "User".
  */
 export function useChatNameResolver() {
     const ctx = React.useContext(ChatNameResolverContext);

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;AAQ/B,MAAM,uBAAuB,GAAG,KAAK,CAAC,aAAa,CAAsC,IAAI,CAAC,CAAC;AAQ/F;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAoC;IAC3E,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IACjD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IACtF,OAAO,CACL,KAAC,uBAAuB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAC3C,QAAQ,GACwB,CACpC,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,6GAA6G,CAC9G,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;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,MAAM,EAAE,WAAW,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAC9C,OAAO,WAAW,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC;AACzC,CAAC","sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\nimport type { ChatNameResolver, ChatPrewarmSenders } from \"@ttt-productions/chat-core\";\n\ntype ChatNameResolverContextValue = {\n  resolveName: ChatNameResolver;\n  prewarm?: ChatPrewarmSenders;\n};\n\nconst ChatNameResolverContext = React.createContext<ChatNameResolverContextValue | null>(null);\n\nexport type ChatNameResolverProviderProps = {\n  resolveName: ChatNameResolver;\n  prewarm?: ChatPrewarmSenders;\n  children: React.ReactNode;\n};\n\n/**\n * Wraps any chat-core consumer (typically the whole app shell) and provides\n * a name resolver. Required for any tree that renders <ChatShell>, <MessageList>,\n * or <MessageItemDefault>.\n */\nexport function ChatNameResolverProvider(props: ChatNameResolverProviderProps) {\n  const { resolveName, prewarm, children } = props;\n  const value = React.useMemo(() => ({ resolveName, prewarm }), [resolveName, prewarm]);\n  return (\n    <ChatNameResolverContext.Provider value={value}>\n      {children}\n    </ChatNameResolverContext.Provider>\n  );\n}\n\n/**\n * Strict hook — throws if no provider is wrapped. Used inside chat-core's\n * own renderers (MessageItemDefault, ReplyQuote) so a missing setup surfaces\n * immediately on first render rather than silently rendering \"User\".\n */\nexport function useChatNameResolver(): ChatNameResolverContextValue {\n  const ctx = React.useContext(ChatNameResolverContext);\n  if (!ctx) {\n    throw new Error(\n      \"[chat-core] 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\n * wrapped. Used internally by useChatMessages so headless callers (tests,\n * data-only consumers that don't render UI) can still use the hook.\n */\nexport function useOptionalChatNameResolver(): ChatNameResolverContextValue | null {\n  return React.useContext(ChatNameResolverContext);\n}\n\n/**\n * Convenience hook for renderers. Returns a resolved string — never null —\n * by falling back to \"User\" when the cache hasn't filled yet. Re-renders\n * automatically once the upstream cache settles.\n */\nexport function useResolvedSenderName(senderId: string): string {\n  const { resolveName } = useChatNameResolver();\n  return resolveName(senderId) ?? \"User\";\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;AAQ/B,MAAM,uBAAuB,GAAG,KAAK,CAAC,aAAa,CAAsC,IAAI,CAAC,CAAC;AAQ/F;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAoC;IAC3E,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IACjD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IACtF,OAAO,CACL,KAAC,uBAAuB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAC3C,QAAQ,GACwB,CACpC,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,6GAA6G,CAC9G,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;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,MAAM,EAAE,WAAW,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAC9C,OAAO,WAAW,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC;AACzC,CAAC","sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\nimport type { ChatNameResolver, ChatPrewarmSenders } from \"@ttt-productions/chat-core\";\n\ntype ChatNameResolverContextValue = {\n  resolveName: ChatNameResolver;\n  prewarm?: ChatPrewarmSenders;\n};\n\nconst ChatNameResolverContext = React.createContext<ChatNameResolverContextValue | null>(null);\n\nexport type ChatNameResolverProviderProps = {\n  resolveName: ChatNameResolver;\n  prewarm?: ChatPrewarmSenders;\n  children: React.ReactNode;\n};\n\n/**\n * Wraps any chat-core consumer (typically the whole app shell) and provides\n * a name resolver. Required for any tree that renders <ChatShell>, <MessageList>,\n * or <MessageItemDefault>.\n */\nexport function ChatNameResolverProvider(props: ChatNameResolverProviderProps) {\n  const { resolveName, prewarm, children } = props;\n  const value = React.useMemo(() => ({ resolveName, prewarm }), [resolveName, prewarm]);\n  return (\n    <ChatNameResolverContext.Provider value={value}>\n      {children}\n    </ChatNameResolverContext.Provider>\n  );\n}\n\n/**\n * Strict hook — throws if no provider is wrapped. Used inside this package's\n * own renderers (MessageItemDefault) so a missing setup surfaces immediately on\n * first render rather than silently rendering \"User\".\n */\nexport function useChatNameResolver(): ChatNameResolverContextValue {\n  const ctx = React.useContext(ChatNameResolverContext);\n  if (!ctx) {\n    throw new Error(\n      \"[chat-core] 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\n * wrapped. Used internally by useChatMessages so headless callers (tests,\n * data-only consumers that don't render UI) can still use the hook.\n */\nexport function useOptionalChatNameResolver(): ChatNameResolverContextValue | null {\n  return React.useContext(ChatNameResolverContext);\n}\n\n/**\n * Convenience hook for renderers. Returns a resolved string — never null —\n * by falling back to \"User\" when the cache hasn't filled yet. Re-renders\n * automatically once the upstream cache settles.\n */\nexport function useResolvedSenderName(senderId: string): string {\n  const { resolveName } = useChatNameResolver();\n  return resolveName(senderId) ?? \"User\";\n}\n"]}

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,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQlD,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;CAC1B,CAAC;AAwCF,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,qBAAqB,CAuF7E"}
+{"version":3,"file":"useChatMessages.d.ts","sourceRoot":"","sources":["../../src/hooks/useChatMessages.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQlD,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;CAC1B,CAAC;AAgCF,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,qBAAqB,CAsF7E"}

package/dist/hooks/useChatMessages.js

@@ -13,15 +13,9 @@ function mapMsg(data, threadId) {
     if (!createdAt) {
         console.error('[useChatMessages] Message missing valid createdAt:', data.id, d.createdAt);
     }
-    // replyTo: the new shape uses senderId, not senderUsername. Tolerate older
-    // docs that still have senderUsername — drop the name and keep what we can.
-    const replyTo = d.replyTo
-        ? {
-            messageId: d.replyTo.messageId,
-            senderId: d.replyTo.senderId ?? "",
-            messagePreview: d.replyTo.messagePreview,
-        }
-        : undefined;
+    // 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 (DJ ruling 2026-07-29).
     return {
         messageId: data.id,
         threadId,
@@ -29,7 +23,6 @@ function mapMsg(data, threadId) {
         senderId: d.senderId,
         text: d.text ?? "",
         type: d.type,
-        replyTo,
         isSystemMessage: d.isSystemMessage ?? undefined,
         // Moderation tombstone flag (backend-written) — carried through so renderers
         // can tombstone the content.
@@ -64,15 +57,13 @@ export function useChatMessages(config) {
         getSortValue: (data) => toMillis(data.createdAt) ?? 0,
     });
     const messages = React.useMemo(() => (allowed ? items : []), [allowed, items]);
-    // Pre-warm name cache for all visible senders (and reply-to senders).
+    // 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();
         for (const m of messages) {
             set.add(m.senderId);
-            if (m.replyTo?.senderId)
-                set.add(m.replyTo.senderId);
         }
         return Array.from(set);
     }, [messages]);

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 { ChatMessageV1 } from \"@ttt-productions/chat-core\";\nimport type { ChatCoreConfig } from \"../types.js\";\nimport { canAccessThread } from \"./useChatThreadAccess.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};\n\nfunction mapMsg(\n  data: DocumentData & { id: string },\n  threadId: string\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  // replyTo: the new shape uses senderId, not senderUsername. Tolerate older\n  // docs that still have senderUsername — drop the name and keep what we can.\n  const replyTo = d.replyTo\n    ? {\n        messageId: d.replyTo.messageId,\n        senderId: d.replyTo.senderId ?? \"\",\n        messagePreview: d.replyTo.messagePreview,\n      }\n    : undefined;\n\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    replyTo,\n    isSystemMessage: d.isSystemMessage ?? undefined,\n    // Moderation tombstone flag (backend-written) — carried through so renderers\n    // can tombstone the content.\n    hidden: d.hidden ?? undefined,\n    meta: 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    isAdmin,\n    accessMode,\n    threadAllowedUserIds,\n    createdAtField = \"createdAt\",\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 allowed = React.useMemo(\n    () =>\n      canAccessThread({\n        accessMode,\n        isAdmin,\n        currentUserId,\n        allowedUserIds: threadAllowedUserIds,\n      }),\n    [accessMode, isAdmin, currentUserId, threadAllowedUserIds]\n  );\n\n  // Stable key segment for the message collection path (string | string[]).\n  const pathKey = React.useMemo(\n    () =>\n      JSON.stringify(\n        Array.isArray(chatCollectionPath) ? chatCollectionPath : [chatCollectionPath]\n      ),\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 { items, isInitialLoading, fetchOlder, hasOlder, isFetchingOlder } =\n    useFirestoreLiveInfinite<ChatMessageV1>({\n      collectionPath,\n      queryKey: [\"chat-core\", \"messages\", pathKey, threadId, messagesSubcollection, pageSize],\n      orderByField: createdAtField,\n      pageSize,\n      enabled: allowed,\n      sort: \"asc\",\n      select: (data) => mapMsg(data, threadId),\n      getSortValue: (data) => toMillis(data.createdAt) ?? 0,\n    });\n\n  const messages = React.useMemo(() => (allowed ? items : []), [allowed, items]);\n\n  // Pre-warm name cache for all visible senders (and reply-to 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      if (m.replyTo?.senderId) set.add(m.replyTo.senderId);\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  };\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 { ChatMessageV1 } from \"@ttt-productions/chat-core\";\nimport type { ChatCoreConfig } from \"../types.js\";\nimport { canAccessThread } from \"./useChatThreadAccess.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};\n\nfunction mapMsg(\n  data: DocumentData & { id: string },\n  threadId: string\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 (DJ ruling 2026-07-29).\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    // Moderation tombstone flag (backend-written) — carried through so renderers\n    // can tombstone the content.\n    hidden: d.hidden ?? undefined,\n    meta: 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    isAdmin,\n    accessMode,\n    threadAllowedUserIds,\n    createdAtField = \"createdAt\",\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 allowed = React.useMemo(\n    () =>\n      canAccessThread({\n        accessMode,\n        isAdmin,\n        currentUserId,\n        allowedUserIds: threadAllowedUserIds,\n      }),\n    [accessMode, isAdmin, currentUserId, threadAllowedUserIds]\n  );\n\n  // Stable key segment for the message collection path (string | string[]).\n  const pathKey = React.useMemo(\n    () =>\n      JSON.stringify(\n        Array.isArray(chatCollectionPath) ? chatCollectionPath : [chatCollectionPath]\n      ),\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 { items, isInitialLoading, fetchOlder, hasOlder, isFetchingOlder } =\n    useFirestoreLiveInfinite<ChatMessageV1>({\n      collectionPath,\n      queryKey: [\"chat-core\", \"messages\", pathKey, threadId, messagesSubcollection, pageSize],\n      orderByField: createdAtField,\n      pageSize,\n      enabled: allowed,\n      sort: \"asc\",\n      select: (data) => mapMsg(data, threadId),\n      getSortValue: (data) => toMillis(data.createdAt) ?? 0,\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    }\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  };\n}"]}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export type { ChatCoreConfig, ChatTransportMode, ChatRealtimeTransportConfig, ChatMentionConfig, MessageRenderer, MessageRendererRegistry, RenderableMentionProvider, MentionResultRenderer, } from "./types.js";
+export type { ChatCoreConfig, ChatTransportMode, ChatRealtimeTransportConfig, MessageRenderer, MessageRendererRegistry, } from "./types.js";
 export type { ChatNameResolverProviderProps } from "./context/ChatNameResolverContext.js";
 export { ChatNameResolverProvider, useChatNameResolver, useOptionalChatNameResolver, useResolvedSenderName, } from "./context/ChatNameResolverContext.js";
 export type { UseChatMessagesResult } from "./hooks/useChatMessages.js";
@@ -14,7 +14,5 @@ export { Composer } from "./ui/Composer.js";
 export type { MessageItemDefaultProps } from "./ui/MessageItemDefault.js";
 export { MessageItemDefault } from "./ui/MessageItemDefault.js";
 export { MessageActions, ThreadActions } from "./ui/menus.js";
-export { MessageText, type MessageTextProps } from "./mentions/MessageText.js";
-export { MentionAutocomplete, type MentionAutocompleteProps, } from "./mentions/MentionAutocomplete.js";
-export { useMentionAutocomplete, type UseMentionAutocompleteArgs, type UseMentionAutocompleteResult, type AutocompleteState, type AutocompleteResultGroup, } from "./mentions/use-mention-autocomplete.js";
+export { MessageText, type MessageTextProps } from "./ui/MessageText.js";
 //# sourceMappingURL=index.d.ts.map

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,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAGpB,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,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,UAAU,EACV,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,2BAA2B,EAC3B,yBAAyB,EACzB,6BAA6B,EAC7B,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;AAU7B,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,eAAe,EACf,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAGpB,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,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,UAAU,EACV,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,2BAA2B,EAC3B,yBAAyB,EACzB,6BAA6B,EAC7B,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;AAU7B,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,qBAAqB,CAAC"}

package/dist/index.js

@@ -11,7 +11,5 @@ export { MessageList } from "./ui/MessageList.js";
 export { Composer } from "./ui/Composer.js";
 export { MessageItemDefault } from "./ui/MessageItemDefault.js";
 export { MessageActions, ThreadActions } from "./ui/menus.js";
-export { MessageText } from "./mentions/MessageText.js";
-export { MentionAutocomplete, } from "./mentions/MentionAutocomplete.js";
-export { useMentionAutocomplete, } from "./mentions/use-mention-autocomplete.js";
+export { MessageText } from "./ui/MessageText.js";
 //# sourceMappingURL=index.js.map

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,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,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,UAAU,EACV,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAkC7B,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","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  ChatMentionConfig,\n  MessageRenderer,\n  MessageRendererRegistry,\n  RenderableMentionProvider,\n  MentionResultRenderer,\n} from \"./types.js\";\n\n// Name-resolver context.\nexport type { ChatNameResolverProviderProps } from \"./context/ChatNameResolverContext.js\";\nexport {\n  ChatNameResolverProvider,\n  useChatNameResolver,\n  useOptionalChatNameResolver,\n  useResolvedSenderName,\n} from \"./context/ChatNameResolverContext.js\";\n\nexport type { UseChatMessagesResult } from \"./hooks/useChatMessages.js\";\nexport { useChatMessages } from \"./hooks/useChatMessages.js\";\nexport { canAccessThread } from \"./hooks/useChatThreadAccess.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 {\n  createRealtimeChatClient,\n  createInboxClient,\n  ChannelClient,\n  InboxClient,\n  useRealtimeChatMessages,\n  browserSocketFactory,\n  ChatAccessDeniedError,\n  isChatAccessDeniedError,\n  CHAT_SUBPROTOCOL,\n  CHAT_CLOSE_CODES,\n  CLIENT_FRAME,\n  SERVER_FRAME,\n  buildFrame,\n  parseFrame,\n  CHAT_CLIENT_DIAGNOSTIC_EVENTS,\n} from \"./realtime/index.js\";\nexport type {\n  RealtimeChatClient,\n  RealtimeTransportConfig,\n  ChatClientDiagnosticsOption,\n  ChatClientDiagnosticsSink,\n  ChatClientDiagnosticEventName,\n  ChannelClientState,\n  ChannelClientConfig,\n  InboxClientState,\n  InboxClientConfig,\n  UseRealtimeChatMessagesResult,\n  GrantProvider,\n  TransportTimers,\n  RealtimeStatus,\n  RealtimeSocket,\n  SocketFactory,\n  SocketHandlers,\n  ChannelRefTuple,\n  WireMessageRow,\n  WireInboxSnapshot,\n  WireRegistryEntry,\n  ServerFrame,\n} from \"./realtime/index.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 } from \"./ui/ChatShell.js\";\nexport { ChatShell } from \"./ui/ChatShell.js\";\nexport { MessageList } 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 \"./mentions/MessageText.js\";\nexport {\n  MentionAutocomplete,\n  type MentionAutocompleteProps,\n} from \"./mentions/MentionAutocomplete.js\";\nexport {\n  useMentionAutocomplete,\n  type UseMentionAutocompleteArgs,\n  type UseMentionAutocompleteResult,\n  type AutocompleteState,\n  type AutocompleteResultGroup,\n} from \"./mentions/use-mention-autocomplete.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAmBb,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,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,UAAU,EACV,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAkC7B,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,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 { ChatNameResolverProviderProps } from \"./context/ChatNameResolverContext.js\";\nexport {\n  ChatNameResolverProvider,\n  useChatNameResolver,\n  useOptionalChatNameResolver,\n  useResolvedSenderName,\n} from \"./context/ChatNameResolverContext.js\";\n\nexport type { UseChatMessagesResult } from \"./hooks/useChatMessages.js\";\nexport { useChatMessages } from \"./hooks/useChatMessages.js\";\nexport { canAccessThread } from \"./hooks/useChatThreadAccess.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 {\n  createRealtimeChatClient,\n  createInboxClient,\n  ChannelClient,\n  InboxClient,\n  useRealtimeChatMessages,\n  browserSocketFactory,\n  ChatAccessDeniedError,\n  isChatAccessDeniedError,\n  CHAT_SUBPROTOCOL,\n  CHAT_CLOSE_CODES,\n  CLIENT_FRAME,\n  SERVER_FRAME,\n  buildFrame,\n  parseFrame,\n  CHAT_CLIENT_DIAGNOSTIC_EVENTS,\n} from \"./realtime/index.js\";\nexport type {\n  RealtimeChatClient,\n  RealtimeTransportConfig,\n  ChatClientDiagnosticsOption,\n  ChatClientDiagnosticsSink,\n  ChatClientDiagnosticEventName,\n  ChannelClientState,\n  ChannelClientConfig,\n  InboxClientState,\n  InboxClientConfig,\n  UseRealtimeChatMessagesResult,\n  GrantProvider,\n  TransportTimers,\n  RealtimeStatus,\n  RealtimeSocket,\n  SocketFactory,\n  SocketHandlers,\n  ChannelRefTuple,\n  WireMessageRow,\n  WireInboxSnapshot,\n  WireRegistryEntry,\n  ServerFrame,\n} from \"./realtime/index.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 } from \"./ui/ChatShell.js\";\nexport { ChatShell } from \"./ui/ChatShell.js\";\nexport { MessageList } 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

@@ -73,6 +73,13 @@ export declare class ChannelClient {
     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 typingTimers;
     private lastTypingSentAt;
     private reconnectTimer;
@@ -275,10 +282,6 @@ export declare class ChannelClient {
     send(args: {
         clientMessageId: string;
         text: string;
-        replyTo?: {
-            messageSeq: number;
-            preview: string;
-        } | null;
     }): boolean;
     /**
      * Explicit read ack (delivery != read). `focused` => the channel is open + at latest.
@@ -296,6 +299,20 @@ export declare class ChannelClient {
     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;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"channel-client.d.ts","sourceRoot":"","sources":["../../src/realtime/channel-client.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAahE,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,aAAa,CAAC;AASjE,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAKL,KAAK,2BAA2B,EACjC,MAAM,kBAAkB,CAAC;AA6C1B,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,cAAc,CAAC;IACvB,mFAAmF;IACnF,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,4EAA4E;IAC5E,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,6DAA6D;IAC7D,eAAe,EAAE,OAAO,CAAC;IACzB,2FAA2F;IAC3F,QAAQ,EAAE,OAAO,CAAC;IAClB,kGAAkG;IAClG,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;;;;;;;;OASG;IACH,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,iGAAiG;IACjG,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,aAAa,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,6DAA6D;IAC7D,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;IAC9G;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,2BAA2B,CAAC;CAC3C;AAwBD,qBAAa,aAAa;IAyDZ,OAAO,CAAC,QAAQ,CAAC,MAAM;IAxDnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8C;IAExE,wFAAwF;IACxF,OAAO,CAAC,SAAS,CAAK;IACtB;2CACuC;IACvC,OAAO,CAAC,WAAW,CAAsD;IACzE,iGAAiG;IACjG,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,cAAc,CAA0D;IAChF,OAAO,CAAC,YAAY,CAAgE;IACpF,OAAO,CAAC,gBAAgB,CAA4B;IACpD,OAAO,CAAC,cAAc,CAA0D;IAChF,iFAAiF;IACjF,OAAO,CAAC,oBAAoB,CAA0D;IACtF,OAAO,CAAC,UAAU,CAAS;IAC3B;;;;;;qCAMiC;IACjC,OAAO,CAAC,QAAQ,CAAwC;IACxD;;;sFAGkF;IAClF,OAAO,CAAC,YAAY,CAAoC;IACxD;;;;;;;wDAOoD;IACpD,OAAO,CAAC,YAAY,CAAkC;IACtD;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;IACpD,4EAA4E;IAC5E,OAAO,CAAC,cAAc,CAAK;IAC3B,uEAAuE;IACvE,OAAO,CAAC,cAAc,CAA6E;IACnG,gFAAgF;IAChF,OAAO,CAAC,aAAa,CAAuB;gBAEf,MAAM,EAAE,mBAAmB;IAQxD,QAAQ,IAAI,kBAAkB;IAI9B,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI;IAK1D,OAAO,CAAC,QAAQ;IAOV,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAehB,UAAU;IAuCxB,OAAO,CAAC,MAAM;IA6Bd;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IA+C1B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,eAAe;IAkCvB,gEAAgE;IAChE,OAAO,CAAC,mBAAmB;IAO3B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAMxB,oFAAoF;IACpF,OAAO,CAAC,8BAA8B;IAStC;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,iBAAiB;IAqDzB;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IA+CzB,4FAA4F;IAC5F,OAAO,CAAC,eAAe;IAQvB;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;;;;;;;OAQG;IACH,SAAS,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO;IAyC3C,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,OAAO;IAmCf,OAAO,CAAC,iBAAiB;IAuBzB;;;;;;;;OAQG;IACH,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,SAAS;IAsEjB;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAwC1B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAOxB,kFAAkF;IAClF,OAAO,CAAC,SAAS;IAOjB;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,oBAAoB;IAgE5B;;;;;;;;;OASG;IACH,OAAO,CAAC,YAAY;IA2BpB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAerB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,QAAQ;IAoChB,OAAO,CAAC,gBAAgB;IAgDxB,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,SAAS;IAMjB;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAA;KAAE,GAAG,OAAO;IAqDxH;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO;IAKnD,yEAAyE;IACzE,MAAM,IAAI,IAAI;IAOd,iBAAiB,IAAI,IAAI;IAKzB,mBAAmB,IAAI,IAAI;IAM3B,2FAA2F;IAC3F,UAAU,IAAI,IAAI;IAQlB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,aAAa;IASrB,8EAA8E;IAC9E,KAAK,IAAI,IAAI;CAyBd"}
+{"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

@@ -18,7 +18,7 @@ import { createReconnectController } from '@ttt-productions/realtime-core';
 import { CLIENT_FRAME, CHAT_CLOSE_CODES, buildFrame, parseFrame, isInboxSnapshot, ChatSendRejectedPayloadSchema, } from './wire.js';
 import { wireRowToMessage, optimisticMessage, seqToMessageId, applyModerationOverlay, overlayFromRow, } from './map.js';
 import { createDiagnosticsEmitter, safeDiagnosticLabel, CHAT_CLIENT_DIAGNOSTIC_EVENTS as DIAG, } from './diagnostics.js';
-import { defaultTimers, isChatAccessDeniedError, HEARTBEAT_MS, TYPING_COALESCE_MS, HISTORY_PAGE_MAX, MAX_PENDING_SEND_ATTEMPTS, PENDING_SEND_MAX_AGE_MS, SERVER_RETRYABLE_MAX_AGE_MS, SEND_RETRY_MIN_DELAY_MS, SEND_RETRY_MAX_DELAY_MS, } from './shared.js';
+import { defaultTimers, isChatAccessDeniedError, isTerminalErrorCode, TERMINAL_ERROR_CODE, HEARTBEAT_MS, TYPING_COALESCE_MS, HISTORY_PAGE_MAX, MAX_PENDING_SEND_ATTEMPTS, PENDING_SEND_MAX_AGE_MS, SERVER_RETRYABLE_MAX_AGE_MS, SEND_RETRY_MIN_DELAY_MS, SEND_RETRY_MAX_DELAY_MS, } from './shared.js';
 const INITIAL = {
     status: 'idle',
     messages: [],
@@ -39,6 +39,37 @@ const INITIAL = {
 const MEMBERSHIP_PENDING_CODE = 'membership-pending';
 /** Fallback retry delay when the frame omits/breaks `retryAfterMs`. */
 const MEMBERSHIP_PENDING_DEFAULT_RETRY_MS = 2000;
+/**
+ * Dead-socket watchdog: how long inbound silence may last before this client
+ * treats the socket as dead and closes it locally.
+ *
+ * CHANNEL-ONLY, and this is why it is sound here: the channel DO answers every
+ * 20 s client `heartbeat` through the hibernation AUTO-RESPONSE API, so a healthy
+ * channel socket is NEVER silent for a full heartbeat window. Inbound silence past
+ * this threshold is therefore provable death (a half-open TCP connection whose
+ * `onclose` never fires), not idleness. The INBOX socket has no such auto-response
+ * and a healthy idle inbox is legitimately silent for hours — applying this rule
+ * there would endlessly reconnect healthy sockets, so it is deliberately absent
+ * from `inbox-client.ts`.
+ *
+ * PRIVATE CLIENT POLICY, not a wire constant: nothing on the worker side agrees to
+ * it, so it does not belong in `@ttt-productions/chat-schemas` or in this package's
+ * exported surface. The check rides the existing 20 s heartbeat tick (no second
+ * timer), so detection lands on the NEXT tick after the deadline rather than at
+ * exactly 50 s — intended: 2.5 missed windows is unambiguous, and it costs no
+ * extra timer.
+ */
+const INBOUND_SILENCE_LIMIT_MS = 50_000;
+/**
+ * Close code used for the watchdog's LOCAL close. A browser `WebSocket.close()`
+ * accepts only 1000 or 3000–4999, and the private 4xxx range is the chat wire's
+ * (`CHAT_CLOSE_CODES`) — a client-invented code there could collide with a future
+ * server code. 1000 keeps the close frame valid and, being neither 4401 nor 4403,
+ * routes through `onClose`'s ordinary transient path, which owns reconnect,
+ * backoff, and resume. The reason string + the liveness diagnostic are what
+ * identify it.
+ */
+const WATCHDOG_CLOSE_CODE = 1000;
 export class ChannelClient {
     config;
     timers;
@@ -55,6 +86,13 @@ export class ChannelClient {
     reauthAttempted = false;
     presenceSubscribed = false;
     heartbeatTimer = null;
+    /**
+     * 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}.
+     */
+    lastInboundAt = null;
     typingTimers = new Map();
     lastTypingSentAt = Number.NEGATIVE_INFINITY;
     reconnectTimer = null;
@@ -124,6 +162,23 @@ export class ChannelClient {
         // legitimate reconnect.
         if (this.state.status !== 'idle' && this.state.status !== 'closed')
             return;
+        // REVIVE the controller. `controller.close()` is PERMANENT: while it is in
+        // state `closed`, `start()` and `onOpen()` no-op and every later `onClose()`
+        // returns null. So without this reset a close() → connect() client opens a
+        // socket and works normally until its FIRST transient close, at which point
+        // `scheduleReconnect()` gets null and parks it terminally in `closed` with
+        // reconnect disabled and no surfaced error code. The idempotency guard above
+        // is what keeps this from disturbing a live lifecycle: only an `idle` or
+        // fully torn-down (`closed`) client ever reaches here.
+        this.controller.reset();
+        // A terminal verdict (4403 REVOKED / ChatAccessDeniedError) is terminal WITHIN
+        // its lifecycle; an explicit connect() is a fresh attempt the authority may
+        // legitimately re-deny, so the previous lifecycle's code must not persist into
+        // this one (the hook maps `access-denied` to `allowed: false`). Loaded
+        // messages and the initial-load flag are deliberately KEPT — a lifecycle
+        // restart must not churn the UI back to an empty opening state.
+        if (isTerminalErrorCode(this.state.lastErrorCode))
+            this.setState({ lastErrorCode: null });
         this.closedByUs = false;
         this.reconnectCause = 'initial';
         this.controller.start();
@@ -159,6 +214,9 @@ export class ChannelClient {
         }
         if (this.closedByUs)
             return;
+        // Socket REPLACEMENT: the previous socket's liveness record dies with it, so
+        // the watchdog never judges a new socket against an old deadline.
+        this.lastInboundAt = null;
         const url = `${this.config.endpoint.replace(/\/$/, '')}/channel`;
         this.socket = this.config.socketFactory({
             url,
@@ -174,6 +232,9 @@ export class ChannelClient {
     onOpen() {
         this.controller.onOpen();
         this.reauthAttempted = false;
+        // Start the liveness clock at open — the first heartbeat window is measured
+        // from here, not from a stale previous socket.
+        this.lastInboundAt = this.timers.now();
         this.setState({ status: 'open' });
         this.diag?.(DIAG.SOCKET_OPEN, {
             attempt: this.connectAttempt,
@@ -243,7 +304,6 @@ export class ChannelClient {
             const sent = this.sendFrame(CLIENT_FRAME.SEND, {
                 clientMessageId: pending.clientMessageId,
                 text: pending.text,
-                replyTo: pending.replyTo,
             });
             if (sent)
                 pending.attempts += 1;
@@ -418,7 +478,6 @@ export class ChannelClient {
             const sent = this.sendFrame(CLIENT_FRAME.SEND, {
                 clientMessageId: current.clientMessageId,
                 text: current.text,
-                replyTo: current.replyTo,
             });
             this.diag?.(DIAG.SEND_RETRY, {
                 clientMessageId: current.clientMessageId,
@@ -487,7 +546,6 @@ export class ChannelClient {
         const sent = this.sendFrame(CLIENT_FRAME.SEND, {
             clientMessageId: pending.clientMessageId,
             text: pending.text,
-            replyTo: pending.replyTo,
         });
         pending.attempts = sent ? 1 : 0;
         this.diag?.(DIAG.SEND_RETRY, {
@@ -515,6 +573,7 @@ export class ChannelClient {
     onClose(code, _reason) {
         this.stopHeartbeat();
         this.socket = null;
+        this.lastInboundAt = null;
         this.lastCloseCode = code;
         if (this.closedByUs) {
             this.diag?.(DIAG.SOCKET_CLOSE, { code, closedByUs: true, outcome: 'closed', resumeSeq: this.resumeSeq });
@@ -539,7 +598,7 @@ export class ChannelClient {
             this.controller.close();
             this.diag?.(DIAG.SOCKET_CLOSE, { code, closedByUs: false, outcome: 'revoked', resumeSeq: this.resumeSeq });
             this.failAllPendingSends();
-            this.setState({ status: 'closed', lastErrorCode: 'revoked' });
+            this.setState({ status: 'closed', lastErrorCode: TERMINAL_ERROR_CODE.REVOKED });
             return;
         }
         this.reconnectCause = 'transient-close';
@@ -582,15 +641,21 @@ export class ChannelClient {
         this.closedByUs = true;
         this.controller.close();
         this.failAllPendingSends();
-        this.setState({ status: 'closed', lastErrorCode: 'access-denied' });
+        this.setState({ status: 'closed', lastErrorCode: TERMINAL_ERROR_CODE.ACCESS_DENIED });
     }
     // ---- inbound frames ----
     onMessage(data) {
         const frame = parseFrame(data);
         if (!frame || !frame.type) {
+            // Unparseable: bytes arrived, but nothing proves they came from a DO
+            // speaking this protocol, so this must NOT refresh the liveness deadline.
             this.diag?.(DIAG.FRAME_DROPPED, { kind: 'unparseable', reason: 'bad-envelope' });
             return;
         }
+        // A well-formed envelope IS the liveness proof — including the `heartbeat-ack`
+        // the DO auto-responds with, and a forward-compat type this build does not
+        // handle yet (a newer DO's frames must never be read as a dead socket).
+        this.lastInboundAt = this.timers.now();
         const payload = frame.payload ?? {};
         switch (frame.type) {
             case 'message':
@@ -988,7 +1053,6 @@ export class ChannelClient {
         const sent = this.sendFrame(CLIENT_FRAME.SEND, {
             clientMessageId: args.clientMessageId,
             text: args.text,
-            replyTo: args.replyTo ?? null,
         });
         if (!sent) {
             this.diag?.(DIAG.SEND_FAILED, {
@@ -1007,7 +1071,6 @@ export class ChannelClient {
         this.pendingSends.set(args.clientMessageId, {
             clientMessageId: args.clientMessageId,
             text: args.text,
-            replyTo: args.replyTo ?? null,
             sentAt: now,
             attempts: 1,
             failed: false,
@@ -1020,14 +1083,11 @@ export class ChannelClient {
             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.diag?.(DIAG.SEND_OPTIMISTIC, {
             clientMessageId: args.clientMessageId,
-            hasReplyTo: Boolean(args.replyTo),
-            replyToSeq: args.replyTo?.messageSeq ?? null,
             pendingSends: this.pendingSends.size,
         });
         return true;
@@ -1072,12 +1132,17 @@ export class ChannelClient {
         const sent = this.sendFrame(CLIENT_FRAME.HISTORY, { beforeSeq, limit: HISTORY_PAGE_MAX });
         this.diag?.(DIAG.HISTORY_REQUEST, { beforeSeq, limit: HISTORY_PAGE_MAX, sent });
     }
-    // ---- heartbeat (20s) ----
+    // ---- heartbeat (20s) + dead-socket watchdog ----
     startHeartbeat() {
         this.stopHeartbeat();
         const tick = () => {
             if (!this.socket || !this.socket.isOpen)
                 return;
+            // Liveness is checked BEFORE the write: a socket already proven dead must
+            // not be handed another frame. Closing here does not reschedule — onClose
+            // stops the heartbeat and owns what happens next.
+            if (this.isInboundSilent())
+                return this.closeDeadSocket();
             this.sendFrame(CLIENT_FRAME.HEARTBEAT, {});
             this.heartbeatTimer = this.timers.setTimeout(tick, HEARTBEAT_MS);
         };
@@ -1089,12 +1154,44 @@ export class ChannelClient {
             this.heartbeatTimer = null;
         }
     }
+    /** True when the live socket has produced no parseable frame for too long. */
+    isInboundSilent() {
+        if (this.lastInboundAt == null)
+            return false;
+        return this.timers.now() - this.lastInboundAt >= INBOUND_SILENCE_LIMIT_MS;
+    }
+    /**
+     * 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.
+     */
+    closeDeadSocket() {
+        const socket = this.socket;
+        this.diag?.(DIAG.SOCKET_LIVENESS_TIMEOUT, {
+            silentMs: this.lastInboundAt == null ? null : this.timers.now() - this.lastInboundAt,
+            thresholdMs: INBOUND_SILENCE_LIMIT_MS,
+            attempt: this.connectAttempt,
+            resumeSeq: this.resumeSeq,
+            pendingSends: this.pendingSends.size,
+        });
+        this.lastInboundAt = null;
+        socket?.close(WATCHDOG_CLOSE_CODE, 'client liveness timeout');
+    }
     // ---- teardown ----
     /** Permanently close this client (auth-user switch / unmount). Idempotent. */
     close() {
         this.closedByUs = true;
         this.controller.close();
         this.stopHeartbeat();
+        // The heartbeat timer IS the watchdog's timer — stopping it above ends both.
+        // Clearing the record too means a later connect() starts from a clean deadline.
+        this.lastInboundAt = null;
         for (const t of this.typingTimers.values())
             this.timers.clearTimeout(t);
         this.typingTimers.clear();