@ttt-productions/chat-react 0.13.15 → 0.13.17

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

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

package/dist/realtime/wire.js

@@ -1,28 +1,7 @@
-// Chat realtime WIRE PROTOCOL (Contract C) — the client side of the Channel +
-// Inbox Durable Object protocol. The canonical protocol declarations (subprotocol,
-// frame-kind maps, close codes, the neutral conversation reference, grant scope,
-// the send and mark-read contracts, client-agreed limits) are owned by `@ttt-productions/chat-schemas`; this file consumes them
-// and adds the client-side raw row/frame shapes the transport maps into the UI
-// message shape. The client and the worker runtime agree on the wire by both
-// importing that one contract; neither imports the other.
-//
-// Frame shape on the socket is `{ v, type, payload }` (NOT realtime-core's
-// `{ v, kind, payload }`): the worker runtime `send`/`broadcast` emit
-// `JSON.stringify({ v: 1, type, payload })` and read `env.type` + `env.payload`.
-// We keep that field name here to match; realtime-core's envelope schema is the
-// generic transport primitive, the chat protocol chose `type` for its frames.
-// Re-export the canonical wire contract so this package's public surface is
-// unchanged. `CLIENT_FRAME`/`SERVER_FRAME` are this package's historical names
-// for the frame-kind maps (`CLIENT_KINDS`/`SERVER_KINDS` in the contract).
-export { CHAT_SUBPROTOCOL, CHAT_WIRE_VERSION, CHAT_CLOSE_CODES, CLIENT_KINDS as CLIENT_FRAME, SERVER_KINDS as SERVER_FRAME, 
-// Correlated send-rejection contract (SERVER_FRAME.SEND_REJECTED payload).
-ChatSendRejectedPayloadSchema, CHAT_SEND_REJECTION_CODES, CHAT_SEND_REJECTION_RETRYABLE, } from '@ttt-productions/chat-schemas';
 import { CHAT_WIRE_VERSION } from '@ttt-productions/chat-schemas';
-/** Build an outbound `{ v, type, payload }` frame (the wire format the DO reads). */
 export function buildFrame(type, payload) {
     return JSON.stringify({ v: CHAT_WIRE_VERSION, type, payload });
 }
-/** Parse an inbound frame, tolerating malformed JSON. Returns null on garbage. */
 export function parseFrame(raw) {
     try {
         const parsed = JSON.parse(raw);
@@ -34,7 +13,6 @@ export function parseFrame(raw) {
         return null;
     }
 }
-/** A snapshot with `registry` is an inbox snapshot; one with `lastMessageSeq` is a channel snapshot. */
 export function isInboxSnapshot(p) {
     return Array.isArray(p.registry);
 }

package/dist/realtime/wire.js.map

@@ -1 +1 @@
-{"version":3,"file":"wire.js","sourceRoot":"","sources":["../../src/realtime/wire.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,mFAAmF;AACnF,iFAAiF;AACjF,gIAAgI;AAChI,+EAA+E;AAC/E,6EAA6E;AAC7E,0DAA0D;AAC1D,EAAE;AACF,2EAA2E;AAC3E,sEAAsE;AACtE,iFAAiF;AACjF,gFAAgF;AAChF,8EAA8E;AAE9E,4EAA4E;AAC5E,+EAA+E;AAC/E,2EAA2E;AAC3E,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,IAAI,YAAY,EAC5B,YAAY,IAAI,YAAY;AAC5B,2EAA2E;AAC3E,6BAA6B,EAC7B,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,+BAA+B,CAAC;AAOvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AA8HlE,qFAAqF;AACrF,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,OAAgC;IACvE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QAC1C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACvD,OAAO,MAA0E,CAAC;IACpF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,eAAe,CAAC,CAA0C;IACxE,OAAO,KAAK,CAAC,OAAO,CAAE,CAAuB,CAAC,QAAQ,CAAC,CAAC;AAC1D,CAAC","sourcesContent":["// Chat realtime WIRE PROTOCOL (Contract C) — the client side of the Channel +\n// Inbox Durable Object protocol. The canonical protocol declarations (subprotocol,\n// frame-kind maps, close codes, the neutral conversation reference, grant scope,\n// the send and mark-read contracts, client-agreed limits) are owned by `@ttt-productions/chat-schemas`; this file consumes them\n// and adds the client-side raw row/frame shapes the transport maps into the UI\n// message shape. The client and the worker runtime agree on the wire by both\n// importing that one contract; neither imports the other.\n//\n// Frame shape on the socket is `{ v, type, payload }` (NOT realtime-core's\n// `{ v, kind, payload }`): the worker runtime `send`/`broadcast` emit\n// `JSON.stringify({ v: 1, type, payload })` and read `env.type` + `env.payload`.\n// We keep that field name here to match; realtime-core's envelope schema is the\n// generic transport primitive, the chat protocol chose `type` for its frames.\n\n// Re-export the canonical wire contract so this package's public surface is\n// unchanged. `CLIENT_FRAME`/`SERVER_FRAME` are this package's historical names\n// for the frame-kind maps (`CLIENT_KINDS`/`SERVER_KINDS` in the contract).\nexport {\n  CHAT_SUBPROTOCOL,\n  CHAT_WIRE_VERSION,\n  CHAT_CLOSE_CODES,\n  CLIENT_KINDS as CLIENT_FRAME,\n  SERVER_KINDS as SERVER_FRAME,\n  // Correlated send-rejection contract (SERVER_FRAME.SEND_REJECTED payload).\n  ChatSendRejectedPayloadSchema,\n  CHAT_SEND_REJECTION_CODES,\n  CHAT_SEND_REJECTION_RETRYABLE,\n} from '@ttt-productions/chat-schemas';\nexport type {\n  ChatCloseCode,\n  ChatSendRejectedPayload,\n  ChatSendRejectionCode,\n} from '@ttt-productions/chat-schemas';\n\nimport { CHAT_WIRE_VERSION } from '@ttt-productions/chat-schemas';\nimport type {\n  ChatConversationRef,\n  ChatMarkReadResultPayload,\n  ChatMessageRevisionKind,\n  ChatSendRejectedPayload,\n} from '@ttt-productions/chat-schemas';\n\n// ---- raw wire row shapes (what the DO serializes; opaque-but-typed here) ----\n\n/** A revision's kind (chat-schemas `ChatMessageRevisionKind`), under this package's historical name. */\nexport type RevisionKind = ChatMessageRevisionKind;\n\n/**\n * A message row as the Channel DO stores + broadcasts it (the worker runtime's\n * message row), declared as the fields the client actually CONSUMES. The adapter\n * mapping in `map.ts` turns it into the UI `ChatMessageV1` shape.\n *\n * The row is TEXT-only: there is no attachment lifecycle on a chat message, and\n * no reply pointer — chat has no reply-authoring affordance, so the client\n * neither sends nor reads one (DJ ruling 2026-07-29). A DO that still broadcasts\n * a legacy stringified `replyTo` key is simply ignored here.\n */\nexport interface WireMessageRow {\n  seq: number;\n  senderUid: string;\n  clientMessageId: string;\n  text: string;\n  createdAt: number;\n  epoch: number;\n  /** Account ids a server-written row's text refers to (absent on a member's own message). */\n  referencedUids?: string[];\n  /**\n   * The effective (max-`messageRevision`) moderation kind for this row, or null\n   * when never moderated. Populated by the DO's getHistory/getDeltaSince overlay\n   * merge so a hidden/deleted/edited row arrives already-moderated and its\n   * ORIGINAL text never reaches the renderer. Optional/absent on pre-overlay rows.\n   */\n  moderationKind?: RevisionKind | null;\n  /**\n   * The effective `messageRevision` that `moderationKind` reflects (the DO's\n   * max-revision). Used to break ties against a live `revision` frame: a higher\n   * `messageRevision` wins; a stale/older one is ignored. Optional/absent on\n   * pre-overlay rows (treated as revision 0).\n   */\n  messageRevision?: number;\n}\n\n/**\n * The channel resume snapshot the DO returns for a `resume` frame (Contract C).\n * `resync` / `delta` are the durable gap-repair half of the contract:\n *  - `resync: false` + `delta` = the contiguous ≤500-message backlog after the\n *    client's cursor (oldest-first); the client APPLIES the delta and advances its\n *    cursor to `lastMessageSeq` — a missed broadcast is never permanent.\n *  - `resync: true` = the gap exceeds the backlog (or the client sent no cursor);\n *    the client DROPS its local tail and re-pages history from the top.\n * Both are OPTIONAL/absent on a pre-contract DO (treated as `resync: true`, empty\n * delta — the safe re-page path) so a stale worker can't leave a client stuck.\n */\nexport interface WireChannelSnapshot {\n  lastMessageSeq: number;\n  readSeq: number;\n  resync?: boolean;\n  delta?: WireMessageRow[];\n}\n\n/** A registry entry in the inbox snapshot (the worker runtime's registry entry). */\nexport interface WireRegistryEntry {\n  channelRef: string;\n  kind: string;\n  state: 'active' | 'tombstoned';\n  registryVersion: number;\n  /**\n   * The conversation this entry is — the OPENABLE identity for the inbox view (the\n   * `channelRef` is an opaque registry key). The app maps it back to its own\n   * conversation; absent, the entry offers no open action.\n   */\n  ref?: ChatConversationRef | null;\n  /**\n   * Per-entry unread flag (drives the per-row dot). Optional/absent until the inbox\n   * DO populates it; `deriveUnreadRefs` reads it as a typed field (no cast).\n   */\n  unread?: boolean;\n  /**\n   * Archived state — DISTINCT from `tombstoned`. An archived row is still an ACTIVE\n   * membership (`state: 'active'`, history readable) but is grouped under the inbox\n   * view's Archived toggle instead of the active list. The client must NOT count\n   * archived rows in the unread roll-up (archive = done; the DO clears unread on\n   * archive). Optional/absent on a pre-archive DO (treated as not-archived).\n   */\n  archived?: boolean;\n}\n\n/** The inbox snapshot payload pushed on connect / `resume` / live delta. */\nexport interface WireInboxSnapshot {\n  registry: WireRegistryEntry[];\n  hasUnread: boolean;\n}\n\n// ---- server → client frame payloads (discriminated on `type`) ----\n\nexport type ServerFrame =\n  | { type: 'message'; payload: { message: WireMessageRow } }\n  | { type: 'ack'; payload: { clientMessageId?: string; seq?: number; readSeq?: number } }\n  | { type: 'history-page'; payload: { messages: WireMessageRow[] } }\n  | { type: 'presence'; payload: { online: string[] } }\n  | { type: 'typing'; payload: { uid: string; at: number } }\n  | { type: 'snapshot'; payload: WireChannelSnapshot | WireInboxSnapshot }\n  // A standalone unread push (inbox scope): either a full inbox snapshot or a\n  // lightweight dock-dot patch. Represented in the union so the inbox client routes\n  // it instead of silently dropping it (forward-compatible with a future DO push).\n  | { type: 'unread'; payload: WireInboxSnapshot | { hasUnread: boolean } }\n  | { type: 'error'; payload: { code: string; retryAfterMs?: number } }\n  // The inbox runtime's correlated answer to one `mark-read`.\n  | { type: 'mark-read-result'; payload: ChatMarkReadResultPayload }\n  // A CORRELATED send rejection (SERVER_FRAME.SEND_REJECTED): names the SAME\n  // clientMessageId as the rejected send + the canonical retry classification, so\n  // exactly one optimistic bubble is failed/retried. See ChatSendRejectedPayload.\n  | { type: 'send-rejected'; payload: ChatSendRejectedPayload }\n  // A moderation revision was applied to one message. The Channel DO broadcasts\n  // this on a NEWLY-applied revision (the worker runtime's moderation apply) so live\n  // viewers hide/blank/edit/restore the message immediately with no extra fetch.\n  // `messageSeq` is the target message id; `kind` is the applied revision kind;\n  // `messageRevision` is its per-message revision number (max-revision wins).\n  | { type: 'revision'; payload: { messageSeq: number; kind: RevisionKind; messageRevision: number } };\n\n/** Build an outbound `{ v, type, payload }` frame (the wire format the DO reads). */\nexport function buildFrame(type: string, payload: Record<string, unknown>): string {\n  return JSON.stringify({ v: CHAT_WIRE_VERSION, type, payload });\n}\n\n/** Parse an inbound frame, tolerating malformed JSON. Returns null on garbage. */\nexport function parseFrame(raw: string): { v?: number; type?: string; payload?: Record<string, unknown> } | null {\n  try {\n    const parsed = JSON.parse(raw) as unknown;\n    if (!parsed || typeof parsed !== 'object') return null;\n    return parsed as { v?: number; type?: string; payload?: Record<string, unknown> };\n  } catch {\n    return null;\n  }\n}\n\n/** A snapshot with `registry` is an inbox snapshot; one with `lastMessageSeq` is a channel snapshot. */\nexport function isInboxSnapshot(p: WireChannelSnapshot | WireInboxSnapshot): p is WireInboxSnapshot {\n  return Array.isArray((p as WireInboxSnapshot).registry);\n}\n"]}
+{"version":3,"file":"wire.js","sourceRoot":"","sources":["../../src/realtime/wire.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AA6DlE,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,OAAgC;IACvE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,GAAW;IAEX,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QAC1C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACvD,OAAO,MAA0E,CAAC;IACpF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,CAA0C;IAE1C,OAAO,KAAK,CAAC,OAAO,CAAE,CAAuB,CAAC,QAAQ,CAAC,CAAC;AAC1D,CAAC","sourcesContent":["import { CHAT_WIRE_VERSION } from '@ttt-productions/chat-schemas';\nimport type {\n  ChatConversationRef,\n  ChatMarkReadResultPayload,\n  ChatMessageRevisionKind,\n  ChatSendRejectedPayload,\n} from '@ttt-productions/chat-schemas';\n\nexport type RevisionKind = ChatMessageRevisionKind;\n\nexport interface WireMessageRow {\n  seq: number;\n  senderUid: string;\n  clientMessageId: string;\n  text: string;\n  createdAt: number;\n  epoch: number;\n  referencedUids?: string[];\n  moderationKind?: RevisionKind | null;\n  messageRevision?: number;\n}\n\nexport interface WireChannelSnapshot {\n  lastMessageSeq: number;\n  readSeq: number;\n  resync?: boolean;\n  delta?: WireMessageRow[];\n}\n\nexport interface WireRegistryEntry {\n  channelRef: string;\n  kind: string;\n  state: 'active' | 'tombstoned';\n  registryVersion: number;\n  ref?: ChatConversationRef | null;\n  unread?: boolean;\n  archived?: boolean;\n}\n\nexport interface WireInboxSnapshot {\n  registry: WireRegistryEntry[];\n  hasUnread: boolean;\n}\n\n// Chat frames carry `type`, not realtime-core's `kind`: the deployed Worker emits and reads `type`.\nexport type ServerFrame =\n  | { type: 'message'; payload: { message: WireMessageRow } }\n  | { type: 'ack'; payload: { clientMessageId?: string; seq?: number; readSeq?: number } }\n  | { type: 'history-page'; payload: { messages: WireMessageRow[] } }\n  | { type: 'presence'; payload: { online: string[] } }\n  | { type: 'typing'; payload: { uid: string; at: number } }\n  | { type: 'snapshot'; payload: WireChannelSnapshot | WireInboxSnapshot }\n  | { type: 'unread'; payload: WireInboxSnapshot | { hasUnread: boolean } }\n  | { type: 'error'; payload: { code: string; retryAfterMs?: number } }\n  | { type: 'mark-read-result'; payload: ChatMarkReadResultPayload }\n  | { type: 'send-rejected'; payload: ChatSendRejectedPayload }\n  | {\n      type: 'revision';\n      payload: { messageSeq: number; kind: RevisionKind; messageRevision: number };\n    };\n\nexport function buildFrame(type: string, payload: Record<string, unknown>): string {\n  return JSON.stringify({ v: CHAT_WIRE_VERSION, type, payload });\n}\n\nexport function parseFrame(\n  raw: string,\n): { v?: number; type?: string; payload?: Record<string, unknown> } | null {\n  try {\n    const parsed = JSON.parse(raw) as unknown;\n    if (!parsed || typeof parsed !== 'object') return null;\n    return parsed as { v?: number; type?: string; payload?: Record<string, unknown> };\n  } catch {\n    return null;\n  }\n}\n\nexport function isInboxSnapshot(\n  p: WireChannelSnapshot | WireInboxSnapshot,\n): p is WireInboxSnapshot {\n  return Array.isArray((p as WireInboxSnapshot).registry);\n}\n"]}

package/dist/types.d.ts

@@ -1,30 +1,9 @@
-import type { ReactNode } from "react";
-import type { ChatMessageV1 } from "@ttt-productions/chat-core";
-import type { ChatConversationRef } from "@ttt-productions/chat-schemas";
-/**
- * Which transport backs a chat thread.
- * - `firestore` — the Firestore newest-window + cursor path (default).
- * - `realtime` — the Cloudflare Durable Object socket; the grant is the data-access
- *   authority there.
- */
+import type { ReactNode } from 'react';
+import type { ChatMessageV1 } from '@ttt-productions/chat-core';
+import type { ChatConversationRef } from '@ttt-productions/chat-schemas';
 export type ChatTransportMode = 'firestore' | 'realtime';
-/**
- * Realtime (Durable Object) transport handle. The concrete socket client is built
- * in this package (`realtime/transport.ts`); chat-react consumes it through this
- * config so the UI stays transport-agnostic. The app builds the `client` via
- * `createRealtimeChatClient({ endpoint, channelRef, grantProvider, ... })` and
- * passes it here. `client` stays structurally typed (`unknown` at the config seam)
- * so `ChatCoreConfig` does not pull the realtime module's types into every firestore
- * consumer — the realtime hook narrows it at the call site.
- */
 export interface ChatRealtimeTransportConfig {
-    /** The conversation the socket is scoped to, as the app maps it onto the neutral reference. */
     channelRef: ChatConversationRef;
-    /**
-     * The realtime client handle from `createRealtimeChatClient(...)`. Drives the
-     * channel socket (subscribe / send / ack / typing / presence / history). The UI
-     * never reaches into the socket directly — it goes through `useRealtimeChatMessages`.
-     */
     client: unknown;
 }
 export type ChatCoreConfig = {
@@ -34,28 +13,11 @@ export type ChatCoreConfig = {
     currentUserId: string;
     currentUserDisplayName?: string;
     isAdmin: boolean;
-    /**
-     * Which transport backs this thread. Defaults to `'firestore'` (the current
-     * path) so existing call sites are unchanged. See {@link ChatTransportMode}.
-     */
     transport?: ChatTransportMode;
-    /** Required iff `transport === 'realtime'`; ignored on the firestore transport. */
     realtime?: ChatRealtimeTransportConfig;
-    /**
-     * Whether the current user may read this conversation — the app's ONE access fact,
-     * decided by the app's own rule for the conversation's kind (the package never decides
-     * access). False renders the no-access state and reads nothing. On the `realtime`
-     * transport the grant is the data authority, and a terminal denial from the grant
-     * closes the conversation even when this is true.
-     */
     allowed: boolean;
     createdAtField?: string;
     pageSize?: number;
-    /**
-     * Firestore transport only: the app's own per-message facts, read from the stored message
-     * document and merged onto the mapped message's `meta`. The package never reads an app field
-     * itself; the app parses its own stored shape here and reads the result back from `meta`.
-     */
     messageMeta?: (doc: Record<string, unknown>) => Record<string, unknown> | undefined;
 };
 export type MessageRenderer = (m: ChatMessageV1) => ReactNode;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAWzE;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,UAAU,CAAC;AAEzD;;;;;;;;GAQG;AACH,MAAM,WAAW,2BAA2B;IAC1C,+FAA+F;IAC/F,UAAU,EAAE,mBAAmB,CAAC;IAChC;;;;OAIG;IACH,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,kBAAkB,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,EAAE,2BAA2B,CAAC;IACvC;;;;;;OAMG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CACrF,CAAC;AAMF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,EAAE,aAAa,KAAK,SAAS,CAAC;AAE9D,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,UAAU,CAAC;AAEzD,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,mBAAmB,CAAC;IAChC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,kBAAkB,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,QAAQ,CAAC,EAAE,2BAA2B,CAAC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CACrF,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,EAAE,aAAa,KAAK,SAAS,CAAC;AAE9D,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC"}

package/dist/types.js

@@ -1,5 +1,2 @@
-// React- and Firebase-client-coupled chat types. These were previously on the
-// chat-core root; they live here so the pure chat-core package stays free of
-// react / firebase/firestore / firebase/storage references.
 export {};
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6EAA6E;AAC7E,4DAA4D","sourcesContent":["// React- and Firebase-client-coupled chat types. These were previously on the\n// chat-core root; they live here so the pure chat-core package stays free of\n// react / firebase/firestore / firebase/storage references.\n\nimport type { ReactNode } from \"react\";\nimport type { ChatMessageV1 } from \"@ttt-productions/chat-core\";\nimport type { ChatConversationRef } from \"@ttt-productions/chat-schemas\";\n\n// ============================================\n// CONFIG\n// ============================================\n//\n// Chat carries PLAIN TEXT only. There is no upload adapter, attachment config,\n// or mention/token config here: a conversation's files are owned by the\n// consuming app's Conversation Files surface, which runs the canonical upload\n// pipeline outside the chat timeline.\n\n/**\n * Which transport backs a chat thread.\n * - `firestore` — the Firestore newest-window + cursor path (default).\n * - `realtime` — the Cloudflare Durable Object socket; the grant is the data-access\n *   authority there.\n */\nexport type ChatTransportMode = 'firestore' | 'realtime';\n\n/**\n * Realtime (Durable Object) transport handle. The concrete socket client is built\n * in this package (`realtime/transport.ts`); chat-react consumes it through this\n * config so the UI stays transport-agnostic. The app builds the `client` via\n * `createRealtimeChatClient({ endpoint, channelRef, grantProvider, ... })` and\n * passes it here. `client` stays structurally typed (`unknown` at the config seam)\n * so `ChatCoreConfig` does not pull the realtime module's types into every firestore\n * consumer — the realtime hook narrows it at the call site.\n */\nexport interface ChatRealtimeTransportConfig {\n  /** The conversation the socket is scoped to, as the app maps it onto the neutral reference. */\n  channelRef: ChatConversationRef;\n  /**\n   * The realtime client handle from `createRealtimeChatClient(...)`. Drives the\n   * channel socket (subscribe / send / ack / typing / presence / history). The UI\n   * never reaches into the socket directly — it goes through `useRealtimeChatMessages`.\n   */\n  client: unknown;\n}\n\nexport type ChatCoreConfig = {\n  chatCollectionPath: string | string[];\n  messagesSubcollection?: string;  // default: \"messages\"\n  threadId: string;\n  currentUserId: string;\n  currentUserDisplayName?: string;\n  isAdmin: boolean;\n  /**\n   * Which transport backs this thread. Defaults to `'firestore'` (the current\n   * path) so existing call sites are unchanged. See {@link ChatTransportMode}.\n   */\n  transport?: ChatTransportMode;\n  /** Required iff `transport === 'realtime'`; ignored on the firestore transport. */\n  realtime?: ChatRealtimeTransportConfig;\n  /**\n   * Whether the current user may read this conversation — the app's ONE access fact,\n   * decided by the app's own rule for the conversation's kind (the package never decides\n   * access). False renders the no-access state and reads nothing. On the `realtime`\n   * transport the grant is the data authority, and a terminal denial from the grant\n   * closes the conversation even when this is true.\n   */\n  allowed: boolean;\n  createdAtField?: string;         // default: \"createdAt\"\n  pageSize?: number;\n  /**\n   * Firestore transport only: the app's own per-message facts, read from the stored message\n   * document and merged onto the mapped message's `meta`. The package never reads an app field\n   * itself; the app parses its own stored shape here and reads the result back from `meta`.\n   */\n  messageMeta?: (doc: Record<string, unknown>) => Record<string, unknown> | undefined;\n};\n\n// ============================================\n// RENDERING\n// ============================================\n\nexport type MessageRenderer = (m: ChatMessageV1) => ReactNode;\n\nexport type MessageRendererRegistry = Record<string, MessageRenderer>;\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ReactNode } from 'react';\nimport type { ChatMessageV1 } from '@ttt-productions/chat-core';\nimport type { ChatConversationRef } from '@ttt-productions/chat-schemas';\n\nexport type ChatTransportMode = 'firestore' | 'realtime';\n\nexport interface ChatRealtimeTransportConfig {\n  channelRef: ChatConversationRef;\n  client: unknown;\n}\n\nexport type ChatCoreConfig = {\n  chatCollectionPath: string | string[];\n  messagesSubcollection?: string;\n  threadId: string;\n  currentUserId: string;\n  currentUserDisplayName?: string;\n  isAdmin: boolean;\n  transport?: ChatTransportMode;\n  realtime?: ChatRealtimeTransportConfig;\n  allowed: boolean;\n  createdAtField?: string;\n  pageSize?: number;\n  messageMeta?: (doc: Record<string, unknown>) => Record<string, unknown> | undefined;\n};\n\nexport type MessageRenderer = (m: ChatMessageV1) => ReactNode;\n\nexport type MessageRendererRegistry = Record<string, MessageRenderer>;\n"]}

package/dist/ui/ChatShell.d.ts

@@ -1,34 +1,15 @@
-import * as React from "react";
-import type { ChatMessageGroupKey, ChatMessageV1, ModerationHandlers } from "@ttt-productions/chat-core";
-import type { ChatCoreConfig, MessageRendererRegistry } from "../types.js";
-import { type ChatScrollContainerProps } from "./MessageList.js";
-/**
- * A read the chat could not complete, handed to the app's `renderLoadError`:
- * - `initial` — nothing loaded: the first open failed (the realtime client's attempts
- *   failed for its budget, or the Firestore listener failed before any message). It
- *   takes the place of the message list.
- * - `live` — the Firestore listener failed after messages loaded. The messages stay,
- *   with this band above them.
- * - `older` — an older page failed to load. It renders at the top of the list, which
- *   stops asking for older pages until `retry`.
- * `error` is the read's own error (null on the realtime transport); `retry` re-runs what
- * failed — the realtime transport also keeps retrying in the background. `retrying` is true
- * while a retry of this failure is running and the failure is still shown (an older page being
- * read again), so the app's Retry shows its pending state. A retried initial or live failure
- * gives way to the opening state instead.
- */
+import * as React from 'react';
+import type { ChatMessageGroupKey, ChatMessageV1, ModerationHandlers } from '@ttt-productions/chat-core';
+import type { ChatCoreConfig, MessageRendererRegistry } from '../types.js';
+import { type ChatScrollContainerProps } from './MessageList.js';
 export type ChatLoadFailure = {
-    scope: "initial" | "live" | "older";
+    scope: 'initial' | 'live' | 'older';
     error: Error | null;
     retry: () => void;
     retrying: boolean;
 };
 export type ChatShellProps = {
     config: ChatCoreConfig;
-    /**
-     * Renders every failed read (see {@link ChatLoadFailure}) — the app's own error state and
-     * copy. Required: a chat that cannot load must say so, and the words are the app's.
-     */
     renderLoadError: (failure: ChatLoadFailure) => React.ReactNode;
     header?: React.ReactNode;
     onSend?: (text: string) => Promise<void>;
@@ -39,38 +20,15 @@ export type ChatShellProps = {
     autoFocus?: boolean;
     renderAboveMessages?: () => React.ReactNode;
     renderBelowMessages?: () => React.ReactNode;
-    /** If provided, replaces the Composer entirely */
     renderFooter?: () => React.ReactNode;
     onSenderClick?: (senderId: string) => void;
-    /** The app's per-message grouping fact and its sender-line adornment (forwarded to MessageList). */
     messageGroupKey?: ChatMessageGroupKey;
     renderSenderAdornment?: (m: ChatMessageV1) => React.ReactNode;
     composerDisabled?: boolean;
-    /** Fill the parent's height instead of the default fixed-height card. Lays the Card out
-     *  as `flex flex-col h-full` with the message list flexing to fill (scrolls inside), so a
-     *  full-height page panel doesn't grow unbounded or waste space on a fixed 400px box.
-     *  The consumer must give ChatShell a bounded-height parent (e.g. an `h-full` panel). */
     fillHeight?: boolean;
-    /**
-     * Called with whether the conversation is READY — its access allowed, its initial data loaded
-     * with no failure, and (realtime) the channel current since its socket last opened — each time
-     * that changes, and with `false` when the shell unmounts. A consumer that lets someone act on
-     * what the conversation says (an agreement, an offer) offers and accepts that action only while
-     * it is true; reading the conversation needs no readiness.
-     */
     onReadinessChange?: (ready: boolean) => void;
-    /** Advanced override for the scrollable region's class (forwarded to MessageList).
-     *  Usually unnecessary — prefer `fillHeight`. */
     scrollClassName?: string;
-    /** Renders the scrollable message region (forwarded to MessageList) in place of the default div,
-     *  so the consumer can give it its own surface component. */
     scrollContainer?: React.ComponentType<ChatScrollContainerProps>;
 };
-/**
- * ChatShell dispatches on `config.transport`. Hooks must be unconditional, so the
- * two transports live in separate inner components (each calls exactly ONE data
- * hook) and both render the shared presentational `ChatShellView`. The default
- * (undefined / 'firestore') transport is byte-for-byte the previous behavior.
- */
 export declare function ChatShell(props: ChatShellProps): React.JSX.Element;
 //# sourceMappingURL=ChatShell.d.ts.map

package/dist/ui/ChatShell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatShell.d.ts","sourceRoot":"","sources":["../../src/ui/ChatShell.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACzG,OAAO,KAAK,EACV,cAAc,EACd,uBAAuB,EACxB,MAAM,aAAa,CAAC;AAMrB,OAAO,EAAe,KAAK,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAI9E;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,cAAc,CAAC;IAEvB;;;OAGG;IACH,eAAe,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,KAAK,CAAC,SAAS,CAAC;IAG/D,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAKzB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAGzC,aAAa,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,KAAK,CAAC,SAAS,CAAC;IAC5C,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAE9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IAGpB,mBAAmB,CAAC,EAAE,MAAM,KAAK,CAAC,SAAS,CAAC;IAC5C,mBAAmB,CAAC,EAAE,MAAM,KAAK,CAAC,SAAS,CAAC;IAC5C,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,KAAK,CAAC,SAAS,CAAC;IAGrC,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,oGAAoG;IACpG,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,qBAAqB,CAAC,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,KAAK,CAAC,SAAS,CAAC;IAG9D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;6FAGyF;IACzF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C;qDACiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;iEAC6D;IAC7D,eAAe,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,wBAAwB,CAAC,CAAC;CACjE,CAAC;AAgCF;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,qBAK9C"}
+{"version":3,"file":"ChatShell.d.ts","sourceRoot":"","sources":["../../src/ui/ChatShell.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAa3E,OAAO,EAAe,KAAK,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAI9E,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,cAAc,CAAC;IAEvB,eAAe,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,KAAK,CAAC,SAAS,CAAC;IAE/D,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAEzB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC,aAAa,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,KAAK,CAAC,SAAS,CAAC;IAC5C,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAE9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,mBAAmB,CAAC,EAAE,MAAM,KAAK,CAAC,SAAS,CAAC;IAC5C,mBAAmB,CAAC,EAAE,MAAM,KAAK,CAAC,SAAS,CAAC;IAC5C,YAAY,CAAC,EAAE,MAAM,KAAK,CAAC,SAAS,CAAC;IAErC,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,qBAAqB,CAAC,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,KAAK,CAAC,SAAS,CAAC;IAE9D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,wBAAwB,CAAC,CAAC;CACjE,CAAC;AAqBF,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,qBAK9C"}

package/dist/ui/ChatShell.js

@@ -1,21 +1,16 @@
-"use client";
+'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import * as React from "react";
-import { Card, CardHeader, CardContent, CardFooter, Skeleton, Spinner } from "@ttt-productions/ui-core/react";
-import { KeyboardAvoidingView } from "@ttt-productions/mobile-core/react";
-import { useChatMessages } from "../hooks/useChatMessages.js";
-import { useRealtimeChatMessages } from "../realtime/useRealtimeChatMessages.js";
-import { MessageList } from "./MessageList.js";
-import { Composer } from "./Composer.js";
-import { ThreadActions } from "./menus.js";
-/**
- * ChatShell dispatches on `config.transport`. Hooks must be unconditional, so the
- * two transports live in separate inner components (each calls exactly ONE data
- * hook) and both render the shared presentational `ChatShellView`. The default
- * (undefined / 'firestore') transport is byte-for-byte the previous behavior.
- */
+import * as React from 'react';
+import { Card, CardHeader, CardContent, CardFooter, Skeleton, Spinner, } from '@ttt-productions/ui-core/react';
+import { KeyboardAvoidingView } from '@ttt-productions/mobile-core/react';
+import { useChatMessages } from '../hooks/useChatMessages.js';
+import { useRealtimeChatMessages } from '../realtime/useRealtimeChatMessages.js';
+import { MessageList } from './MessageList.js';
+import { Composer } from './Composer.js';
+import { ThreadActions } from './menus.js';
+// Hooks must be unconditional, so each transport is a separate component with one data hook.
 export function ChatShell(props) {
-    if (props.config.transport === "realtime") {
+    if (props.config.transport === 'realtime') {
         return _jsx(RealtimeChatShell, { ...props });
     }
     return _jsx(FirestoreChatShell, { ...props });
@@ -28,8 +23,10 @@ function FirestoreChatShell(props) {
             await onSend(text);
     }, [onSend]);
     const { error, olderError, retry, messages, isFetchingOlder } = r;
-    const loadFailure = React.useMemo(() => (error ? { scope: messages.length > 0 ? "live" : "initial", error, retry, retrying: false } : null), [error, messages.length, retry]);
-    const olderFailure = React.useMemo(() => (olderError ? { scope: "older", error: olderError, retry, retrying: isFetchingOlder } : null), [olderError, retry, isFetchingOlder]);
+    const loadFailure = React.useMemo(() => error
+        ? { scope: messages.length > 0 ? 'live' : 'initial', error, retry, retrying: false }
+        : null, [error, messages.length, retry]);
+    const olderFailure = React.useMemo(() => olderError ? { scope: 'older', error: olderError, retry, retrying: isFetchingOlder } : null, [olderError, retry, isFetchingOlder]);
     return (_jsx(ChatShellView, { ...props, resolved: {
             allowed: r.allowed,
             isInitialLoading: r.isInitialLoading,
@@ -51,18 +48,15 @@ function RealtimeChatShell(props) {
     }
     const r = useRealtimeChatMessages(client);
     const { initialLoadFailed, retry } = r;
-    const loadFailure = React.useMemo(() => (initialLoadFailed ? { scope: "initial", error: null, retry, retrying: false } : null), [initialLoadFailed, retry]);
+    const loadFailure = React.useMemo(() => (initialLoadFailed ? { scope: 'initial', error: null, retry, retrying: false } : null), [initialLoadFailed, retry]);
     const send = React.useCallback(async (text) => {
         const ok = r.send(text);
-        // C-B8: surface a closed-socket failure so the Composer keeps the user's text
-        // instead of clearing it on a no-op send.
         if (!ok)
-            throw new Error("chat-send-failed");
+            throw new Error('chat-send-failed');
         if (onSend)
-            await onSend(text); // optional mirror
+            await onSend(text);
     }, [r, onSend]);
     return (_jsx(ChatShellView, { ...props, resolved: {
-            // The app's access fact AND the grant's: a terminal denial closes it either way.
             allowed: config.allowed && r.allowed,
             isInitialLoading: r.isInitialLoading,
             transportCurrent: r.isSynced,
@@ -82,9 +76,8 @@ function RealtimeChatShell(props) {
 }
 function ChatShellView(props) {
     const { config, header, renderMessage, messageRenderers, handlers, composerPlaceholder, autoFocus = false, renderAboveMessages, renderBelowMessages, renderFooter, onSenderClick, messageGroupKey, renderSenderAdornment, composerDisabled, fillHeight = false, scrollClassName, scrollContainer, renderLoadError, onReadinessChange, resolved, } = props;
-    const { allowed, isInitialLoading, messages, fetchOlder, hasOlder, isFetchingOlder, loadFailure, olderFailure, send, retrySend, readAck, status, typing, signalTyping } = resolved;
-    // Nothing loaded and the read failed: the failure takes the list's place.
-    const initialFailure = loadFailure?.scope === "initial" ? loadFailure : null;
+    const { allowed, isInitialLoading, messages, fetchOlder, hasOlder, isFetchingOlder, loadFailure, olderFailure, send, retrySend, readAck, status, typing, signalTyping, } = resolved;
+    const initialFailure = loadFailure?.scope === 'initial' ? loadFailure : null;
     const ready = allowed && !isInitialLoading && loadFailure === null && resolved.transportCurrent;
     const readinessListener = React.useRef(onReadinessChange);
     React.useEffect(() => {
@@ -99,43 +92,36 @@ function ChatShellView(props) {
     const [focused, setFocused] = React.useState(true);
     const lastAckedRef = React.useRef(0);
     const leaseHeldRef = React.useRef(false);
-    // The latest authoritative seq currently rendered (optimistic rows have no seq).
     const latestSeq = React.useMemo(() => {
         let max = 0;
         for (const m of messages) {
-            const seq = typeof m.meta?.seq === "number" ? m.meta?.seq : 0;
+            const seq = typeof m.meta?.seq === 'number' ? m.meta?.seq : 0;
             if (seq > max)
                 max = seq;
         }
         return max;
     }, [messages]);
-    // Track tab focus/visibility so the read-ack "focused" lease releases on blur/hide.
     React.useEffect(() => {
-        const compute = () => typeof document === "undefined" ||
-            (document.visibilityState !== "hidden" && (typeof document.hasFocus !== "function" || document.hasFocus()));
+        const compute = () => typeof document === 'undefined' ||
+            (document.visibilityState !== 'hidden' &&
+                (typeof document.hasFocus !== 'function' || document.hasFocus()));
         setFocused(compute());
         const onChange = () => setFocused(compute());
-        window.addEventListener("focus", onChange);
-        window.addEventListener("blur", onChange);
-        document.addEventListener("visibilitychange", onChange);
+        window.addEventListener('focus', onChange);
+        window.addEventListener('blur', onChange);
+        document.addEventListener('visibilitychange', onChange);
         return () => {
-            window.removeEventListener("focus", onChange);
-            window.removeEventListener("blur", onChange);
-            document.removeEventListener("visibilitychange", onChange);
+            window.removeEventListener('focus', onChange);
+            window.removeEventListener('blur', onChange);
+            document.removeEventListener('visibilitychange', onChange);
         };
     }, []);
-    // C-B6: advance the authoritative read cursor when the reader is actually at the
-    // latest message (channel mounted + tab focused + scrolled to bottom); release the
-    // focus lease exactly once when they stop. No-op on the firestore path (no readAck).
     React.useEffect(() => {
         if (!readAck || latestSeq <= 0)
             return;
         if (focused && atBottom) {
             leaseHeldRef.current = true;
             if (latestSeq > lastAckedRef.current) {
-                // Advance the local marker ONLY if the frame was actually sent — a drop during a
-                // disconnect window must stay un-acked so it retries (the client also re-sends the
-                // cursor on reconnect). (M2)
                 if (readAck(latestSeq, true))
                     lastAckedRef.current = latestSeq;
             }
@@ -145,49 +131,29 @@ function ChatShellView(props) {
             readAck(latestSeq, false);
         }
     }, [readAck, latestSeq, atBottom, focused]);
-    // In fill mode the Card flexes to its parent's height and the message list fills the
-    // space between header and composer; otherwise it's the default natural-height card.
-    const cardClassName = fillHeight ? "w-full flex flex-col h-full min-h-0" : "w-full";
-    const contentClassName = fillHeight ? "p-0 flex-1 min-h-0 flex flex-col" : "p-0";
+    const cardClassName = fillHeight ? 'w-full flex flex-col h-full min-h-0' : 'w-full';
+    const contentClassName = fillHeight ? 'p-0 flex-1 min-h-0 flex flex-col' : 'p-0';
     if (!allowed) {
         return _jsx("div", { className: "p-4 text-sm opacity-70", children: "You don't have access to this thread." });
     }
     if (isInitialLoading || initialFailure) {
-        // Before the first authoritative snapshot/history result, show an HONEST working
-        // state — a visible "Opening chat…" spinner in a polite live region — NOT a blank
-        // parchment/skeleton box (which read as an empty chat) and NOT the reconnect banner
-        // (which must not compete with the initial-opening message). Only the MessageList
-        // region is replaced: the consumer's header + actions + the three render-slots +
-        // footer still render, and `onReadinessChange` tells a consumer whose slots carry
-        // actions that the conversation is not ready to act on.
         return (_jsxs(Card, { className: cardClassName, children: [(header || handlers) && (_jsxs(CardHeader, { className: "flex flex-row items-start justify-between gap-4 space-y-0", children: [_jsx("div", { children: header }), _jsx("div", { className: "flex flex-col items-end gap-2", children: _jsx(ThreadActions, { threadId: config.threadId, isAdmin: config.isAdmin, handlers: handlers }) })] })), (() => {
-                    // The wrapper (and its border) renders only when the slot actually
-                    // produced content — a slot returning null (e.g. a collapsed
-                    // conversation-files section) must not paint an empty bordered strip.
                     const aboveMessages = renderAboveMessages?.() ?? null;
                     return aboveMessages != null && aboveMessages !== false ? (_jsx("div", { className: "border-b", children: aboveMessages })) : null;
-                })(), _jsx(CardContent, { className: contentClassName, children: initialFailure ? (renderLoadError(initialFailure)) : (_jsxs("div", { className: "flex flex-col items-center justify-center gap-2 py-12 text-sm text-muted-foreground", role: "status", "aria-live": "polite", children: [_jsx(Spinner, { size: "sm" }), _jsx("span", { children: "Opening chat\u2026" })] })) }), renderBelowMessages && (_jsx("div", { className: "border-t", children: renderBelowMessages() })), renderFooter ? (_jsx(CardFooter, { className: "border-t", children: renderFooter() })) : (_jsx(CardFooter, { className: "border-t", children: _jsx(Skeleton, { className: "h-10 w-full" }) }))] }));
+                })(), _jsx(CardContent, { className: contentClassName, children: initialFailure ? (renderLoadError(initialFailure)) : (_jsxs("div", { className: "flex flex-col items-center justify-center gap-2 py-12 text-sm text-muted-foreground", role: "status", "aria-live": "polite", children: [_jsx(Spinner, { size: "sm" }), _jsx("span", { children: "Opening chat\u2026" })] })) }), renderBelowMessages && _jsx("div", { className: "border-t", children: renderBelowMessages() }), renderFooter ? (_jsx(CardFooter, { className: "border-t", children: renderFooter() })) : (_jsx(CardFooter, { className: "border-t", children: _jsx(Skeleton, { className: "h-10 w-full" }) }))] }));
     }
-    return (_jsxs(Card, { className: cardClassName, children: [(header || handlers) && (_jsxs(CardHeader, { className: "flex flex-row items-start justify-between gap-4 space-y-0", children: [_jsx("div", { children: header }), _jsx("div", { className: "flex flex-col items-end gap-2", children: _jsx(ThreadActions, { threadId: config.threadId, isAdmin: config.isAdmin, handlers: handlers }) })] })), _jsx(ChatConnectionBanner, { status: status }), renderAboveMessages && (_jsx("div", { className: "border-b", children: renderAboveMessages() })), loadFailure?.scope === "live" && _jsx("div", { className: "border-b", children: renderLoadError(loadFailure) }), _jsx(CardContent, { className: contentClassName, children: _jsx(MessageList, { messages: messages, currentUserId: config.currentUserId, isAdmin: config.isAdmin, isFetchingOlder: isFetchingOlder, hasOlder: hasOlder, onLoadOlder: () => fetchOlder(), renderMessage: renderMessage, messageRenderers: messageRenderers, showScrollToBottom: showScrollToBottom, onScrollToBottom: () => setShowScrollToBottom(false), onAtBottomChange: setAtBottom, fillHeight: fillHeight, scrollClassName: scrollClassName, scrollContainer: scrollContainer, handlers: handlers, onSenderClick: onSenderClick, messageGroupKey: messageGroupKey, renderSenderAdornment: renderSenderAdornment, onRetrySend: retrySend, olderLoadErrorRow: olderFailure ? renderLoadError(olderFailure) : null }) }), renderBelowMessages && (_jsx("div", { className: "border-t", children: renderBelowMessages() })), renderFooter ? (_jsx(CardFooter, { className: "border-t", children: renderFooter() })) : (_jsxs(CardFooter, { className: "border-t flex-col items-stretch gap-1", children: [_jsx(TypingIndicator, { typing: typing }), _jsx(KeyboardAvoidingView, { padding: true, offset: 8, className: "w-full", children: _jsx(Composer, { onSend: send, onTyping: signalTyping, disabled: composerDisabled, autoFocus: autoFocus, placeholder: composerPlaceholder }) })] }))] }));
+    return (_jsxs(Card, { className: cardClassName, children: [(header || handlers) && (_jsxs(CardHeader, { className: "flex flex-row items-start justify-between gap-4 space-y-0", children: [_jsx("div", { children: header }), _jsx("div", { className: "flex flex-col items-end gap-2", children: _jsx(ThreadActions, { threadId: config.threadId, isAdmin: config.isAdmin, handlers: handlers }) })] })), _jsx(ChatConnectionBanner, { status: status }), renderAboveMessages && _jsx("div", { className: "border-b", children: renderAboveMessages() }), loadFailure?.scope === 'live' && (_jsx("div", { className: "border-b", children: renderLoadError(loadFailure) })), _jsx(CardContent, { className: contentClassName, children: _jsx(MessageList, { messages: messages, currentUserId: config.currentUserId, isAdmin: config.isAdmin, isFetchingOlder: isFetchingOlder, hasOlder: hasOlder, onLoadOlder: () => fetchOlder(), renderMessage: renderMessage, messageRenderers: messageRenderers, showScrollToBottom: showScrollToBottom, onScrollToBottom: () => setShowScrollToBottom(false), onAtBottomChange: setAtBottom, fillHeight: fillHeight, scrollClassName: scrollClassName, scrollContainer: scrollContainer, handlers: handlers, onSenderClick: onSenderClick, messageGroupKey: messageGroupKey, renderSenderAdornment: renderSenderAdornment, onRetrySend: retrySend, olderLoadErrorRow: olderFailure ? renderLoadError(olderFailure) : null }) }), renderBelowMessages && _jsx("div", { className: "border-t", children: renderBelowMessages() }), renderFooter ? (_jsx(CardFooter, { className: "border-t", children: renderFooter() })) : (_jsxs(CardFooter, { className: "border-t flex-col items-stretch gap-1", children: [_jsx(TypingIndicator, { typing: typing }), _jsx(KeyboardAvoidingView, { padding: true, offset: 8, className: "w-full", children: _jsx(Composer, { onSend: send, onTyping: signalTyping, disabled: composerDisabled, autoFocus: autoFocus, placeholder: composerPlaceholder }) })] }))] }));
 }
-/**
- * R13 — connection-state banner. The realtime path sets `status`; once the first
- * snapshot has loaded (ChatShellView is past `isInitialLoading`), a dropped/unreachable
- * socket surfaces here instead of a silently-empty thread. Renders nothing on the
- * firestore path (`status` undefined) or while live (`open`).
- */
 function ChatConnectionBanner({ status }) {
-    if (status !== "reconnecting" && status !== "closed")
+    if (status !== 'reconnecting' && status !== 'closed')
         return null;
-    return (_jsx("div", { className: "px-3 py-1.5 text-xs text-center bg-muted text-muted-foreground border-b", role: "status", "aria-live": "polite", children: status === "reconnecting"
-            ? "Reconnecting… messages may be delayed."
-            : "Disconnected — messages may be out of date." }));
+    return (_jsx("div", { className: "px-3 py-1.5 text-xs text-center bg-muted text-muted-foreground border-b", role: "status", "aria-live": "polite", children: status === 'reconnecting'
+            ? 'Reconnecting… messages may be delayed.'
+            : 'Disconnected — messages may be out of date.' }));
 }
-/** R14 — typing indicator. `typing` is the set of OTHER users typing (the transport
- *  excludes the local user). Generic copy (no name resolution) for v1. */
 function TypingIndicator({ typing }) {
     if (!typing || typing.length === 0)
         return null;
-    return (_jsx("div", { className: "text-xs italic text-muted-foreground", "aria-live": "polite", children: typing.length === 1 ? "Someone is typing…" : "Several people are typing…" }));
+    return (_jsx("div", { className: "text-xs italic text-muted-foreground", "aria-live": "polite", children: typing.length === 1 ? 'Someone is typing…' : 'Several people are typing…' }));
 }
 //# sourceMappingURL=ChatShell.js.map