@ttt-productions/chat-react 0.12.15 → 0.13.1

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

@@ -1 +1 @@
-{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/realtime/map.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAI9D,OAAO,EAAE,wBAAwB,EAAE,CAAC;AAEpC,sFAAsF;AACtF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,YAAY,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,GAAG,aAAa,CAc/G;AAED,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,iBAAiB,GAAG,IAAI,CAG5E;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AA0BD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAuDrF;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACjE,GAAG,aAAa,CAYhB"}
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/realtime/map.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAI9D,OAAO,EAAE,wBAAwB,EAAE,CAAC;AAEpC,sFAAsF;AACtF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,YAAY,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,GAAG,aAAa,CAc/G;AAED,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,iBAAiB,GAAG,IAAI,CAG5E;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAgBD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAkBrF;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACjE,GAAG,aAAa,CAYhB"}

package/dist/realtime/map.js

@@ -60,54 +60,19 @@ function parseJson(raw) {
  * thread id (the UI's thread key); the DO row carries no threadId of its own.
  * - `messageId` = the server seq (string) — stable + dedup key.
  * - `replyTo` JSON `{ messageSeq, preview }` → UI `{ messageId, senderId:'', messagePreview }`.
- * - The DO row carries only the attachment LIFECYCLE (`attachmentState` +
- *   `attachmentMeta` with `mediaAssetId`/`attachmentKind`/`failureReason`), never a
- *   full stored `ChatAttachment` — the projection below rebuilds the renderable
- *   `attachment` from that lifecycle, and the render-time URL comes from
- *   `mediaAssetId` via the attachment-URL resolver context (identity/media
- *   invariant: no URLs are ever stored). The raw lifecycle also stays on
- *   `meta.attachment*` for consumers that key on it.
+ *
+ * A DO row carries TEXT only. Files are not part of the message timeline — they
+ * live in the conversation's Conversation Files list, published through the
+ * canonical media pipeline and read from Firestore, never mapped from a chat row.
  */
 export function wireRowToMessage(row, threadId) {
     const reply = parseJson(row.replyTo);
-    const meta = parseJson(row.attachmentMeta);
-    // Project the DO's attachment LIFECYCLE into the renderable `attachment` object —
-    // the renderer keys on `m.attachment` (AttachmentView: pending spinner / failed
-    // bubble / ready media via the attachment-URL resolver + `mediaAssetId`). Before
-    // this projection existed, a wire-delivered attachment message (live broadcast,
-    // resume snapshot, history page) mapped to a message with NO `attachment` and
-    // rendered as an empty bubble — the recipient never saw the media at all (found
-    // live 2026-07-20, hosted path 11.3). `name`/`size`/`storagePath` are wire-absent
-    // and render-irrelevant (labels are kind-scrubbed; storagePath is never a serving
-    // contract) — placeholders keep the ChatAttachment shape without inventing data.
-    const state = row.attachmentState === 'pending' || row.attachmentState === 'ready' || row.attachmentState === 'failed'
-        ? row.attachmentState
-        : null;
-    const kind = meta?.attachmentKind === 'image' || meta?.attachmentKind === 'video' || meta?.attachmentKind === 'audio'
-        ? meta.attachmentKind
-        : // Rows written before the DO stored `attachmentKind` carry none — 'image' keeps
-            // them rendering through the media path (the resolver serves whatever the asset
-            // is); new rows always carry the real kind.
-            'image';
-    const attachment = state
-        ? {
-            id: row.clientMessageId,
-            name: '',
-            type: kind,
-            size: 0,
-            storagePath: '',
-            ...(meta?.mediaAssetId ? { mediaAssetId: meta.mediaAssetId } : {}),
-            status: state,
-            ...(meta?.failureReason ? { failureReason: meta.failureReason } : {}),
-        }
-        : null;
     return {
         messageId: seqToMessageId(row.seq),
         threadId,
         createdAt: row.createdAt,
         senderId: row.senderUid,
         text: row.text,
-        ...(attachment ? { attachment } : {}),
         replyTo: reply
             ? { messageId: seqToMessageId(reply.messageSeq), senderId: '', messagePreview: reply.preview }
             : undefined,
@@ -115,8 +80,6 @@ export function wireRowToMessage(row, threadId) {
         meta: {
             seq: row.seq,
             epoch: row.epoch,
-            ...(row.attachmentState ? { attachmentState: row.attachmentState } : {}),
-            ...(meta ? { attachmentMeta: meta } : {}),
         },
     };
 }

package/dist/realtime/map.js.map

@@ -1 +1 @@
-{"version":3,"file":"map.js","sourceRoot":"","sources":["../../src/realtime/map.ts"],"names":[],"mappings":"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","sourcesContent":["// Map the DO wire row (`WireMessageRow`) into the UI `ChatMessageV1` shape so the\n// UI stays transport-agnostic — the MessageList renders the same shape whether\n// the bytes came from Firestore or the DO socket.\n//\n// Identity invariant: the DO stores uid references only (`senderUid`), never a\n// display name — names resolve at render time through the ChatNameResolver\n// context, identical to the Firestore path.\n\nimport type { ChatAttachment, ChatMessageV1 } from '@ttt-productions/chat-core';\nimport { MODERATION_REDACTED_TEXT } from '@ttt-productions/chat-schemas';\nimport type { RevisionKind, WireMessageRow } from './wire.js';\n\n// The redacted-text constant lives in the wire contract; re-export to keep this\n// module's public surface stable.\nexport { MODERATION_REDACTED_TEXT };\n\n/** The effective moderation overlay for a message: the max-`messageRevision` kind. */\nexport interface ModerationOverlay {\n  kind: RevisionKind;\n  messageRevision: number;\n}\n\n/**\n * Apply a moderation overlay to a mapped message so the ORIGINAL content never\n * renders for a hidden/deleted message. Pure — returns a new message; the input\n * is not mutated. The overlay state rides on `meta` (`meta` is opaque to\n * chat-core), so the renderer can branch on `meta.moderated` / `meta.moderationKind`.\n * - `delete` / `moderate` → blank/replace the text + mark moderated.\n * - `edit` → the row already carries the overlaid text (the DO rewrites `text`),\n *   so only the marker is stamped.\n * - `restore` → original content (the DO row is the original); no redaction.\n */\nexport function applyModerationOverlay(message: ChatMessageV1, overlay: ModerationOverlay | null): ChatMessageV1 {\n  if (!overlay) return message;\n  const redacted = overlay.kind === 'delete' || overlay.kind === 'moderate';\n  return {\n    ...message,\n    ...(redacted ? { text: MODERATION_REDACTED_TEXT } : {}),\n    meta: {\n      ...message.meta,\n      moderationKind: overlay.kind,\n      messageRevision: overlay.messageRevision,\n      // `restore` is the absence of active moderation — it reverts to the original.\n      moderated: overlay.kind !== 'restore',\n    },\n  };\n}\n\n/** The overlay carried inline on a DO row (the getHistory/getDeltaSince merge), or null. */\nexport function overlayFromRow(row: WireMessageRow): ModerationOverlay | null {\n  if (row.moderationKind == null) return null;\n  return { kind: row.moderationKind, messageRevision: row.messageRevision ?? 0 };\n}\n\n/** The DO `seq` is the stable per-channel message id (monotonic, epoch-spanning). */\nexport function seqToMessageId(seq: number): string {\n  return String(seq);\n}\n\ninterface WireReplyTo {\n  messageSeq: number;\n  preview: string;\n}\n\ninterface WireAttachmentMeta {\n  senderOnly?: boolean;\n  mediaAssetId?: string;\n  failureReason?: string;\n  /** 'image' | 'video' | 'audio' — stored by the Channel DO from the placeholder\n   *  command's validated contentType kind; inherited by the ready flip. */\n  attachmentKind?: string;\n  [k: string]: unknown;\n}\n\nfunction parseJson<T>(raw: string | null): T | null {\n  if (raw == null) return null;\n  try {\n    return JSON.parse(raw) as T;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Convert a DO message row to the UI message. `threadId` is the caller's logical\n * thread id (the UI's thread key); the DO row carries no threadId of its own.\n * - `messageId` = the server seq (string) — stable + dedup key.\n * - `replyTo` JSON `{ messageSeq, preview }` → UI `{ messageId, senderId:'', messagePreview }`.\n * - The DO row carries only the attachment LIFECYCLE (`attachmentState` +\n *   `attachmentMeta` with `mediaAssetId`/`attachmentKind`/`failureReason`), never a\n *   full stored `ChatAttachment` — the projection below rebuilds the renderable\n *   `attachment` from that lifecycle, and the render-time URL comes from\n *   `mediaAssetId` via the attachment-URL resolver context (identity/media\n *   invariant: no URLs are ever stored). The raw lifecycle also stays on\n *   `meta.attachment*` for consumers that key on it.\n */\nexport function wireRowToMessage(row: WireMessageRow, threadId: string): ChatMessageV1 {\n  const reply = parseJson<WireReplyTo>(row.replyTo);\n  const meta = parseJson<WireAttachmentMeta>(row.attachmentMeta);\n\n  // Project the DO's attachment LIFECYCLE into the renderable `attachment` object —\n  // the renderer keys on `m.attachment` (AttachmentView: pending spinner / failed\n  // bubble / ready media via the attachment-URL resolver + `mediaAssetId`). Before\n  // this projection existed, a wire-delivered attachment message (live broadcast,\n  // resume snapshot, history page) mapped to a message with NO `attachment` and\n  // rendered as an empty bubble — the recipient never saw the media at all (found\n  // live 2026-07-20, hosted path 11.3). `name`/`size`/`storagePath` are wire-absent\n  // and render-irrelevant (labels are kind-scrubbed; storagePath is never a serving\n  // contract) — placeholders keep the ChatAttachment shape without inventing data.\n  const state =\n    row.attachmentState === 'pending' || row.attachmentState === 'ready' || row.attachmentState === 'failed'\n      ? row.attachmentState\n      : null;\n  const kind =\n    meta?.attachmentKind === 'image' || meta?.attachmentKind === 'video' || meta?.attachmentKind === 'audio'\n      ? meta.attachmentKind\n      : // Rows written before the DO stored `attachmentKind` carry none — 'image' keeps\n        // them rendering through the media path (the resolver serves whatever the asset\n        // is); new rows always carry the real kind.\n        'image';\n  const attachment: ChatAttachment | null = state\n    ? {\n        id: row.clientMessageId,\n        name: '',\n        type: kind,\n        size: 0,\n        storagePath: '',\n        ...(meta?.mediaAssetId ? { mediaAssetId: meta.mediaAssetId } : {}),\n        status: state,\n        ...(meta?.failureReason ? { failureReason: meta.failureReason } : {}),\n      }\n    : null;\n\n  return {\n    messageId: seqToMessageId(row.seq),\n    threadId,\n    createdAt: row.createdAt,\n    senderId: row.senderUid,\n    text: row.text,\n    ...(attachment ? { attachment } : {}),\n    replyTo: reply\n      ? { messageId: seqToMessageId(reply.messageSeq), senderId: '', messagePreview: reply.preview }\n      : undefined,\n    isSystemMessage: row.senderUid === 'system' || undefined,\n    meta: {\n      seq: row.seq,\n      epoch: row.epoch,\n      ...(row.attachmentState ? { attachmentState: row.attachmentState } : {}),\n      ...(meta ? { attachmentMeta: meta } : {}),\n    },\n  };\n}\n\n/** The optimistic local echo a `send` produces before the server `ack` reconciles the seq. */\nexport function optimisticMessage(args: {\n  clientMessageId: string;\n  threadId: string;\n  senderId: string;\n  text: string;\n  createdAt: number;\n  replyTo?: { messageId: string; messagePreview?: string } | null;\n}): ChatMessageV1 {\n  return {\n    messageId: `optimistic:${args.clientMessageId}`,\n    threadId: args.threadId,\n    createdAt: args.createdAt,\n    senderId: args.senderId,\n    text: args.text,\n    replyTo: args.replyTo\n      ? { messageId: args.replyTo.messageId, senderId: '', messagePreview: args.replyTo.messagePreview ?? '' }\n      : undefined,\n    meta: { clientMessageId: args.clientMessageId, optimistic: true },\n  };\n}\n"]}
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../src/realtime/map.ts"],"names":[],"mappings":"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","sourcesContent":["// Map the DO wire row (`WireMessageRow`) into the UI `ChatMessageV1` shape so the\n// UI stays transport-agnostic — the MessageList renders the same shape whether\n// the bytes came from Firestore or the DO socket.\n//\n// Identity invariant: the DO stores uid references only (`senderUid`), never a\n// display name — names resolve at render time through the ChatNameResolver\n// context, identical to the Firestore path.\n\nimport type { ChatMessageV1 } from '@ttt-productions/chat-core';\nimport { MODERATION_REDACTED_TEXT } from '@ttt-productions/chat-schemas';\nimport type { RevisionKind, WireMessageRow } from './wire.js';\n\n// The redacted-text constant lives in the wire contract; re-export to keep this\n// module's public surface stable.\nexport { MODERATION_REDACTED_TEXT };\n\n/** The effective moderation overlay for a message: the max-`messageRevision` kind. */\nexport interface ModerationOverlay {\n  kind: RevisionKind;\n  messageRevision: number;\n}\n\n/**\n * Apply a moderation overlay to a mapped message so the ORIGINAL content never\n * renders for a hidden/deleted message. Pure — returns a new message; the input\n * is not mutated. The overlay state rides on `meta` (`meta` is opaque to\n * chat-core), so the renderer can branch on `meta.moderated` / `meta.moderationKind`.\n * - `delete` / `moderate` → blank/replace the text + mark moderated.\n * - `edit` → the row already carries the overlaid text (the DO rewrites `text`),\n *   so only the marker is stamped.\n * - `restore` → original content (the DO row is the original); no redaction.\n */\nexport function applyModerationOverlay(message: ChatMessageV1, overlay: ModerationOverlay | null): ChatMessageV1 {\n  if (!overlay) return message;\n  const redacted = overlay.kind === 'delete' || overlay.kind === 'moderate';\n  return {\n    ...message,\n    ...(redacted ? { text: MODERATION_REDACTED_TEXT } : {}),\n    meta: {\n      ...message.meta,\n      moderationKind: overlay.kind,\n      messageRevision: overlay.messageRevision,\n      // `restore` is the absence of active moderation — it reverts to the original.\n      moderated: overlay.kind !== 'restore',\n    },\n  };\n}\n\n/** The overlay carried inline on a DO row (the getHistory/getDeltaSince merge), or null. */\nexport function overlayFromRow(row: WireMessageRow): ModerationOverlay | null {\n  if (row.moderationKind == null) return null;\n  return { kind: row.moderationKind, messageRevision: row.messageRevision ?? 0 };\n}\n\n/** The DO `seq` is the stable per-channel message id (monotonic, epoch-spanning). */\nexport function seqToMessageId(seq: number): string {\n  return String(seq);\n}\n\ninterface WireReplyTo {\n  messageSeq: number;\n  preview: string;\n}\n\nfunction parseJson<T>(raw: string | null): T | null {\n  if (raw == null) return null;\n  try {\n    return JSON.parse(raw) as T;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Convert a DO message row to the UI message. `threadId` is the caller's logical\n * thread id (the UI's thread key); the DO row carries no threadId of its own.\n * - `messageId` = the server seq (string) — stable + dedup key.\n * - `replyTo` JSON `{ messageSeq, preview }` → UI `{ messageId, senderId:'', messagePreview }`.\n *\n * A DO row carries TEXT only. Files are not part of the message timeline — they\n * live in the conversation's Conversation Files list, published through the\n * canonical media pipeline and read from Firestore, never mapped from a chat row.\n */\nexport function wireRowToMessage(row: WireMessageRow, threadId: string): ChatMessageV1 {\n  const reply = parseJson<WireReplyTo>(row.replyTo);\n\n  return {\n    messageId: seqToMessageId(row.seq),\n    threadId,\n    createdAt: row.createdAt,\n    senderId: row.senderUid,\n    text: row.text,\n    replyTo: reply\n      ? { messageId: seqToMessageId(reply.messageSeq), senderId: '', messagePreview: reply.preview }\n      : undefined,\n    isSystemMessage: row.senderUid === 'system' || undefined,\n    meta: {\n      seq: row.seq,\n      epoch: row.epoch,\n    },\n  };\n}\n\n/** The optimistic local echo a `send` produces before the server `ack` reconciles the seq. */\nexport function optimisticMessage(args: {\n  clientMessageId: string;\n  threadId: string;\n  senderId: string;\n  text: string;\n  createdAt: number;\n  replyTo?: { messageId: string; messagePreview?: string } | null;\n}): ChatMessageV1 {\n  return {\n    messageId: `optimistic:${args.clientMessageId}`,\n    threadId: args.threadId,\n    createdAt: args.createdAt,\n    senderId: args.senderId,\n    text: args.text,\n    replyTo: args.replyTo\n      ? { messageId: args.replyTo.messageId, senderId: '', messagePreview: args.replyTo.messagePreview ?? '' }\n      : undefined,\n    meta: { clientMessageId: args.clientMessageId, optimistic: true },\n  };\n}\n"]}

package/dist/realtime/wire.d.ts

@@ -11,9 +11,11 @@ import type { ChannelRefTuple, ChatSendRejectedPayload } from '@ttt-productions/
 export type RevisionKind = 'delete' | 'moderate' | 'edit' | 'restore';
 /**
  * A message row as the Channel DO stores + broadcasts it (the worker runtime's
- * message row). `replyTo`/`attachmentMeta` arrive as JSON STRINGS (or null) —
- * the DO stores them stringified and does not re-parse before broadcast. The
- * adapter mapping in `map.ts` parses them into the UI `ChatMessageV1` shape.
+ * message row). `replyTo` arrives as a JSON STRING (or null) — the DO stores it
+ * stringified and does not re-parse before broadcast. The adapter mapping in
+ * `map.ts` parses it into the UI `ChatMessageV1` shape.
+ *
+ * The row is TEXT-only: there is no attachment lifecycle on a chat message.
  */
 export interface WireMessageRow {
     seq: number;
@@ -21,8 +23,6 @@ export interface WireMessageRow {
     clientMessageId: string;
     text: string;
     replyTo: string | null;
-    attachmentState: string | null;
-    attachmentMeta: string | null;
     createdAt: number;
     epoch: number;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../src/realtime/wire.ts"],"names":[],"mappings":"AAiBA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,IAAI,YAAY,EAC5B,YAAY,IAAI,YAAY,EAE5B,6BAA6B,EAC7B,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,aAAa,EACb,eAAe,EACf,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAI9F;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,cAAc,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IACrC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED,oFAAoF;AACpF,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,GAAG,YAAY,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,GAAG,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;CACpB;AAID,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE;QAAE,OAAO,EAAE,cAAc,CAAA;KAAE,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACtF;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,cAAc,EAAE,CAAA;KAAE,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,mBAAmB,GAAG,iBAAiB,CAAA;CAAE,GAItE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,iBAAiB,GAAG;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAInE;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,uBAAuB,CAAA;CAAE,GAM3D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,YAAY,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEvG,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAEjF;AAED,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,IAAI,CAQ/G;AAED,wGAAwG;AACxG,wBAAgB,eAAe,CAAC,CAAC,EAAE,mBAAmB,GAAG,iBAAiB,GAAG,CAAC,IAAI,iBAAiB,CAElG"}
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../src/realtime/wire.ts"],"names":[],"mappings":"AAiBA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,IAAI,YAAY,EAC5B,YAAY,IAAI,YAAY,EAE5B,6BAA6B,EAC7B,yBAAyB,EACzB,6BAA6B,GAC9B,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,aAAa,EACb,eAAe,EACf,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAI9F;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;AAEtE;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,cAAc,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IACrC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED,oFAAoF;AACpF,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,GAAG,YAAY,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,GAAG,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAC7B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;CACpB;AAID,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE;QAAE,OAAO,EAAE,cAAc,CAAA;KAAE,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACtF;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,cAAc,EAAE,CAAA;KAAE,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,mBAAmB,GAAG,iBAAiB,CAAA;CAAE,GAItE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,iBAAiB,GAAG;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAInE;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,uBAAuB,CAAA;CAAE,GAM3D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,YAAY,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEvG,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAEjF;AAED,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,IAAI,CAQ/G;AAED,wGAAwG;AACxG,wBAAgB,eAAe,CAAC,CAAC,EAAE,mBAAmB,GAAG,iBAAiB,GAAG,CAAC,IAAI,iBAAiB,CAElG"}

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,8EAA8E;AAC9E,gFAAgF;AAChF,+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;AAQvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AA0HlE,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, channel-ref tuple, grant scope, client-agreed\n// 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  ChannelRefTuple,\n  ChatSendRejectedPayload,\n  ChatSendRejectionCode,\n} from '@ttt-productions/chat-schemas';\n\nimport { CHAT_WIRE_VERSION } from '@ttt-productions/chat-schemas';\nimport type { ChannelRefTuple, ChatSendRejectedPayload } from '@ttt-productions/chat-schemas';\n\n// ---- raw wire row shapes (what the DO serializes; opaque-but-typed here) ----\n\n/**\n * The moderation revision `kind` (the worker runtime's revision input + the\n * `revisions.kind` column). The EFFECTIVE state of a message is its\n * MAX-`messageRevision` row's kind, so a `restore` (a later revision) supersedes\n * an earlier `moderate`/`delete`. `moderate`/`delete` blank the original text;\n * `edit` overlays new text; `restore` reverts to the original.\n */\nexport type RevisionKind = 'delete' | 'moderate' | 'edit' | 'restore';\n\n/**\n * A message row as the Channel DO stores + broadcasts it (the worker runtime's\n * message row). `replyTo`/`attachmentMeta` arrive as JSON STRINGS (or null) —\n * the DO stores them stringified and does not re-parse before broadcast. The\n * adapter mapping in `map.ts` parses them into the UI `ChatMessageV1` shape.\n */\nexport interface WireMessageRow {\n  seq: number;\n  senderUid: string;\n  clientMessageId: string;\n  text: string;\n  replyTo: string | null;\n  attachmentState: string | null;\n  attachmentMeta: string | null;\n  createdAt: number;\n  epoch: number;\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 typed channel-ref tuple — the OPENABLE identity for the inbox view (the\n   * `channelRef` is an opaque DO-id dedup key). Null/absent on legacy or pre-tuple\n   * rows; the consumer falls back to hiding the open action for those entries.\n   */\n  ref?: ChannelRefTuple | 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  // 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,8EAA8E;AAC9E,mFAAmF;AACnF,8EAA8E;AAC9E,gFAAgF;AAChF,+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;AAQvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AA0HlE,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, channel-ref tuple, grant scope, client-agreed\n// 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  ChannelRefTuple,\n  ChatSendRejectedPayload,\n  ChatSendRejectionCode,\n} from '@ttt-productions/chat-schemas';\n\nimport { CHAT_WIRE_VERSION } from '@ttt-productions/chat-schemas';\nimport type { ChannelRefTuple, ChatSendRejectedPayload } from '@ttt-productions/chat-schemas';\n\n// ---- raw wire row shapes (what the DO serializes; opaque-but-typed here) ----\n\n/**\n * The moderation revision `kind` (the worker runtime's revision input + the\n * `revisions.kind` column). The EFFECTIVE state of a message is its\n * MAX-`messageRevision` row's kind, so a `restore` (a later revision) supersedes\n * an earlier `moderate`/`delete`. `moderate`/`delete` blank the original text;\n * `edit` overlays new text; `restore` reverts to the original.\n */\nexport type RevisionKind = 'delete' | 'moderate' | 'edit' | 'restore';\n\n/**\n * A message row as the Channel DO stores + broadcasts it (the worker runtime's\n * message row). `replyTo` arrives as a JSON STRING (or null) — the DO stores it\n * stringified and does not re-parse before broadcast. The adapter mapping in\n * `map.ts` parses it into the UI `ChatMessageV1` shape.\n *\n * The row is TEXT-only: there is no attachment lifecycle on a chat message.\n */\nexport interface WireMessageRow {\n  seq: number;\n  senderUid: string;\n  clientMessageId: string;\n  text: string;\n  replyTo: string | null;\n  createdAt: number;\n  epoch: number;\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 typed channel-ref tuple — the OPENABLE identity for the inbox view (the\n   * `channelRef` is an opaque DO-id dedup key). Null/absent on legacy or pre-tuple\n   * rows; the consumer falls back to hiding the open action for those entries.\n   */\n  ref?: ChannelRefTuple | 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  // 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"]}

package/dist/types.d.ts

@@ -1,6 +1,4 @@
-import type { FirebaseStorage } from "firebase/storage";
 import type { ReactNode } from "react";
-import type { MediaOriginSpec } from "@ttt-productions/media-schemas";
 import type { ChatAccessMode, ChatMessageV1, MentionProvider, MentionRef, RecentMentionsAdapter } from "@ttt-productions/chat-core";
 /** Custom renderer for a single autocomplete row / mention result. */
 export type MentionResultRenderer<TKind extends string = string> = (ref: MentionRef<TKind>) => ReactNode;
@@ -16,45 +14,6 @@ export type RenderableMentionProvider<TKind extends string = string, TContext =
      */
     renderResult?: MentionResultRenderer<TKind>;
 };
-/**
- * Pluggable upload-path strategy for chat attachments.
- *
- * Consumers supply this to tell the composer (a) what opaque origin identifier
- * to record for the upload, (b) how to build the Firebase Storage path for the
- * temporary upload, and (c) optional extra metadata to attach to the Storage
- * object.
- *
- * `buildUploadPath` and `buildUploadMetadata` receive the userId and
- * attachmentId so consumers can interpolate them per their own conventions.
- * The composer does not interpret `originId` — it forwards it via callbacks
- * and uses it for adapter identity only.
- */
-export type ChatUploadAdapter = {
-    /** Opaque origin identifier (e.g. "chat-attachment"). Not interpreted here. */
-    originId: string;
-    /** Build the Firebase Storage path for the upload. Called once per attachment. */
-    buildUploadPath: (args: {
-        userId: string;
-        attachmentId: string;
-    }) => string;
-    /** Optional extra metadata merged onto the Storage object metadata (e.g. customMetadata). */
-    buildUploadMetadata?: (args: {
-        userId: string;
-        attachmentId: string;
-    }) => Record<string, unknown>;
-};
-export type ChatAttachmentConfig = {
-    attachmentSpec: MediaOriginSpec;
-    storage: FirebaseStorage;
-    /** The current user's auth uid. Forwarded to `uploadAdapter` callbacks. */
-    userId: string;
-    /**
-     * Pluggable upload-path strategy. Consumers wire this to their app's
-     * conventions (for example: originId "chat-attachment", path
-     * `uploads/chat-attachment/{userId}/{attachmentId}`).
-     */
-    uploadAdapter: ChatUploadAdapter;
-};
 /**
  * Pluggable mention system config. When attached to ChatCoreConfig, the
  * composer enables `@`-trigger autocomplete and the message renderer parses

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,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,eAAe,EACf,UAAU,EACV,qBAAqB,EACtB,MAAM,4BAA4B,CAAC;AAMpC,sEAAsE;AACtE,MAAM,MAAM,qBAAqB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,IAAI,CACjE,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,KACnB,SAAS,CAAC;AAEf;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,CACnC,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,QAAQ,GAAG,OAAO,IAChB,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG;IACrC;;;OAGG;IACH,YAAY,CAAC,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAC;CAC7C,CAAC;AAMF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,eAAe,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;IAC5E,6FAA6F;IAC7F,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnG,CAAC;AAMF,MAAM,MAAM,oBAAoB,GAAG;IACjC,cAAc,EAAE,eAAe,CAAC;IAChC,OAAO,EAAE,eAAe,CAAC;IACzB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,aAAa,EAAE,iBAAiB,CAAC;CAClC,CAAC;AAMF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,kCAAkC;IAClC,SAAS,EAAE,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACxD,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,MAAM,CAAC,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACvC,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,SAAS,CAAC;CAChD,CAAC;AAMF;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,UAAU,CAAC;AAEzD;;;;;;;;GAQG;AACH,MAAM,WAAW,2BAA2B;IAC1C,wFAAwF;IACxF,UAAU,EAAE,OAAO,CAAC;IACpB;;;;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;;;;OAIG;IACH,UAAU,EAAE,cAAc,CAAC;IAC3B;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,aAAa,CAAC,EAAE,iBAAiB,CAAC;CACnC,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":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,eAAe,EACf,UAAU,EACV,qBAAqB,EACtB,MAAM,4BAA4B,CAAC;AAMpC,sEAAsE;AACtE,MAAM,MAAM,qBAAqB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,IAAI,CACjE,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,KACnB,SAAS,CAAC;AAEf;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,CACnC,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,QAAQ,GAAG,OAAO,IAChB,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG;IACrC;;;OAGG;IACH,YAAY,CAAC,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAC;CAC7C,CAAC;AAUF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,kCAAkC;IAClC,SAAS,EAAE,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACxD,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,MAAM,CAAC,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAC;IACvC,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,SAAS,CAAC;CAChD,CAAC;AAMF;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,UAAU,CAAC;AAEzD;;;;;;;;GAQG;AACH,MAAM,WAAW,2BAA2B;IAC1C,wFAAwF;IACxF,UAAU,EAAE,OAAO,CAAC;IACpB;;;;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;;;;OAIG;IACH,UAAU,EAAE,cAAc,CAAC;IAC3B;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,aAAa,CAAC,EAAE,iBAAiB,CAAC;CACnC,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"}

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 { FirebaseStorage } from \"firebase/storage\";\nimport type { ReactNode } from \"react\";\nimport type { MediaOriginSpec } from \"@ttt-productions/media-schemas\";\nimport type {\n  ChatAccessMode,\n  ChatMessageV1,\n  MentionProvider,\n  MentionRef,\n  RecentMentionsAdapter,\n} from \"@ttt-productions/chat-core\";\n\n// ============================================\n// MENTION RENDER TYPES (React-coupled)\n// ============================================\n\n/** Custom renderer for a single autocomplete row / mention result. */\nexport type MentionResultRenderer<TKind extends string = string> = (\n  ref: MentionRef<TKind>,\n) => ReactNode;\n\n/**\n * A pure {@link MentionProvider} augmented with optional React row rendering.\n * The autocomplete UI consumes this; the pure provider contract (search) lives\n * in @ttt-productions/chat-core.\n */\nexport type RenderableMentionProvider<\n  TKind extends string = string,\n  TContext = unknown,\n> = MentionProvider<TKind, TContext> & {\n  /**\n   * Optional custom row UI. When omitted, the autocomplete renders the\n   * `displayText` plain.\n   */\n  renderResult?: MentionResultRenderer<TKind>;\n};\n\n// ============================================\n// CHAT UPLOAD ADAPTER (injected into ChatAttachmentConfig)\n// ============================================\n\n/**\n * Pluggable upload-path strategy for chat attachments.\n *\n * Consumers supply this to tell the composer (a) what opaque origin identifier\n * to record for the upload, (b) how to build the Firebase Storage path for the\n * temporary upload, and (c) optional extra metadata to attach to the Storage\n * object.\n *\n * `buildUploadPath` and `buildUploadMetadata` receive the userId and\n * attachmentId so consumers can interpolate them per their own conventions.\n * The composer does not interpret `originId` — it forwards it via callbacks\n * and uses it for adapter identity only.\n */\nexport type ChatUploadAdapter = {\n  /** Opaque origin identifier (e.g. \"chat-attachment\"). Not interpreted here. */\n  originId: string;\n  /** Build the Firebase Storage path for the upload. Called once per attachment. */\n  buildUploadPath: (args: { userId: string; attachmentId: string }) => string;\n  /** Optional extra metadata merged onto the Storage object metadata (e.g. customMetadata). */\n  buildUploadMetadata?: (args: { userId: string; attachmentId: string }) => Record<string, unknown>;\n};\n\n// ============================================\n// ATTACHMENT CONFIG (passed through ChatShell → Composer)\n// ============================================\n\nexport type ChatAttachmentConfig = {\n  attachmentSpec: MediaOriginSpec;\n  storage: FirebaseStorage;\n  /** The current user's auth uid. Forwarded to `uploadAdapter` callbacks. */\n  userId: string;\n  /**\n   * Pluggable upload-path strategy. Consumers wire this to their app's\n   * conventions (for example: originId \"chat-attachment\", path\n   * `uploads/chat-attachment/{userId}/{attachmentId}`).\n   */\n  uploadAdapter: ChatUploadAdapter;\n};\n\n// ============================================\n// MENTION SYSTEM CONFIG (passed through ChatShell → Composer)\n// ============================================\n\n/**\n * Pluggable mention system config. When attached to ChatCoreConfig, the\n * composer enables `@`-trigger autocomplete and the message renderer parses\n * mention tokens out of `text`.\n *\n * Generic over `TKind` and `TContext` is intentionally NOT exposed here at the\n * type level — `ChatCoreConfig` would have to become generic too, which\n * cascades. Instead this type accepts permissive `string`-keyed providers;\n * consumers binding stricter kind unions narrow at the call site via their\n * provider definitions.\n */\nexport type ChatMentionConfig = {\n  /** Providers in display order. */\n  providers: RenderableMentionProvider<string, unknown>[];\n  /** Context object forwarded to every provider's `search`. */\n  context: unknown;\n  /** Optional recent-mentions adapter. */\n  recent?: RecentMentionsAdapter<string>;\n  /** Trigger character. Defaults to `'@'`. */\n  trigger?: string;\n  /** Minimum query length before search fires. Default: 0. */\n  minQueryLength?: number;\n  /** Search debounce window in ms. Default: 200. */\n  searchDebounceMs?: number;\n  /**\n   * Optional custom renderer for mentions inside rendered message text.\n   * When omitted, the default chip (`<span class=\"chat-mention-chip\">`) is\n   * used. Receives the resolved MentionRef.\n   */\n  renderMention?: (ref: MentionRef) => ReactNode;\n};\n\n// ============================================\n// CONFIG\n// ============================================\n\n/**\n * Which transport backs a chat thread.\n * - `firestore` — the current Firestore newest-window + cursor path (default).\n * - `realtime` — the Cloudflare Durable Object socket (chat-edge-rebuild). On\n *   this transport DATA ACCESS is enforced by the DO grant, so `accessMode`\n *   becomes PRESENTATION-ONLY (UI affordances like read-only), never a\n *   data-access gate.\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. `channelRef`/`client` stay structurally typed (`unknown` at the\n * config seam) so `ChatCoreConfig` does not pull the realtime module's types into\n * every firestore consumer — the realtime hook narrows them at the call site.\n */\nexport interface ChatRealtimeTransportConfig {\n  /** Opaque channel reference the socket is scoped to (guild channel / invite thread). */\n  channelRef: unknown;\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   * The Firestore data-access gate (see ChatAccessMode docs in\n   * @ttt-productions/chat-core). REQUIRED. On the `realtime` transport this is\n   * PRESENTATION-ONLY — the DO grant is the real data-access authority.\n   */\n  accessMode: ChatAccessMode;\n  /**\n   * Required iff accessMode === \"explicit-allowlist\". Ignored otherwise.\n   */\n  threadAllowedUserIds?: string[];\n  createdAtField?: string;         // default: \"createdAt\"\n  pageSize?: number;\n  /**\n   * Optional mention system configuration. When present, the composer enables\n   * `@`-trigger autocomplete using the supplied providers and renders mention\n   * chips in messages. Each provider corresponds to one mention kind.\n   */\n  mentionConfig?: ChatMentionConfig;\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":"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 {\n  ChatAccessMode,\n  ChatMessageV1,\n  MentionProvider,\n  MentionRef,\n  RecentMentionsAdapter,\n} from \"@ttt-productions/chat-core\";\n\n// ============================================\n// MENTION RENDER TYPES (React-coupled)\n// ============================================\n\n/** Custom renderer for a single autocomplete row / mention result. */\nexport type MentionResultRenderer<TKind extends string = string> = (\n  ref: MentionRef<TKind>,\n) => ReactNode;\n\n/**\n * A pure {@link MentionProvider} augmented with optional React row rendering.\n * The autocomplete UI consumes this; the pure provider contract (search) lives\n * in @ttt-productions/chat-core.\n */\nexport type RenderableMentionProvider<\n  TKind extends string = string,\n  TContext = unknown,\n> = MentionProvider<TKind, TContext> & {\n  /**\n   * Optional custom row UI. When omitted, the autocomplete renders the\n   * `displayText` plain.\n   */\n  renderResult?: MentionResultRenderer<TKind>;\n};\n\n// ============================================\n// MENTION SYSTEM CONFIG (passed through ChatShell → Composer)\n// ============================================\n//\n// Chat carries TEXT only. There is no upload adapter or attachment config here:\n// a conversation's files are owned by the consuming app's Conversation Files\n// surface, which runs the canonical upload pipeline outside the chat timeline.\n\n/**\n * Pluggable mention system config. When attached to ChatCoreConfig, the\n * composer enables `@`-trigger autocomplete and the message renderer parses\n * mention tokens out of `text`.\n *\n * Generic over `TKind` and `TContext` is intentionally NOT exposed here at the\n * type level — `ChatCoreConfig` would have to become generic too, which\n * cascades. Instead this type accepts permissive `string`-keyed providers;\n * consumers binding stricter kind unions narrow at the call site via their\n * provider definitions.\n */\nexport type ChatMentionConfig = {\n  /** Providers in display order. */\n  providers: RenderableMentionProvider<string, unknown>[];\n  /** Context object forwarded to every provider's `search`. */\n  context: unknown;\n  /** Optional recent-mentions adapter. */\n  recent?: RecentMentionsAdapter<string>;\n  /** Trigger character. Defaults to `'@'`. */\n  trigger?: string;\n  /** Minimum query length before search fires. Default: 0. */\n  minQueryLength?: number;\n  /** Search debounce window in ms. Default: 200. */\n  searchDebounceMs?: number;\n  /**\n   * Optional custom renderer for mentions inside rendered message text.\n   * When omitted, the default chip (`<span class=\"chat-mention-chip\">`) is\n   * used. Receives the resolved MentionRef.\n   */\n  renderMention?: (ref: MentionRef) => ReactNode;\n};\n\n// ============================================\n// CONFIG\n// ============================================\n\n/**\n * Which transport backs a chat thread.\n * - `firestore` — the current Firestore newest-window + cursor path (default).\n * - `realtime` — the Cloudflare Durable Object socket (chat-edge-rebuild). On\n *   this transport DATA ACCESS is enforced by the DO grant, so `accessMode`\n *   becomes PRESENTATION-ONLY (UI affordances like read-only), never a\n *   data-access gate.\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. `channelRef`/`client` stay structurally typed (`unknown` at the\n * config seam) so `ChatCoreConfig` does not pull the realtime module's types into\n * every firestore consumer — the realtime hook narrows them at the call site.\n */\nexport interface ChatRealtimeTransportConfig {\n  /** Opaque channel reference the socket is scoped to (guild channel / invite thread). */\n  channelRef: unknown;\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   * The Firestore data-access gate (see ChatAccessMode docs in\n   * @ttt-productions/chat-core). REQUIRED. On the `realtime` transport this is\n   * PRESENTATION-ONLY — the DO grant is the real data-access authority.\n   */\n  accessMode: ChatAccessMode;\n  /**\n   * Required iff accessMode === \"explicit-allowlist\". Ignored otherwise.\n   */\n  threadAllowedUserIds?: string[];\n  createdAtField?: string;         // default: \"createdAt\"\n  pageSize?: number;\n  /**\n   * Optional mention system configuration. When present, the composer enables\n   * `@`-trigger autocomplete using the supplied providers and renders mention\n   * chips in messages. Each provider corresponds to one mention kind.\n   */\n  mentionConfig?: ChatMentionConfig;\n};\n\n// ============================================\n// RENDERING\n// ============================================\n\nexport type MessageRenderer = (m: ChatMessageV1) => ReactNode;\n\nexport type MessageRendererRegistry = Record<string, MessageRenderer>;\n"]}

package/dist/ui/ChatShell.d.ts

@@ -1,6 +1,6 @@
 import * as React from "react";
-import type { ChatMessageV1, SendAttachmentFn, ModerationHandlers } from "@ttt-productions/chat-core";
-import type { ChatCoreConfig, ChatAttachmentConfig, MessageRendererRegistry } from "../types.js";
+import type { ChatMessageV1, ModerationHandlers } from "@ttt-productions/chat-core";
+import type { ChatCoreConfig, MessageRendererRegistry } from "../types.js";
 export type ChatShellProps = {
     config: ChatCoreConfig;
     header?: React.ReactNode;
@@ -8,8 +8,6 @@ export type ChatShellProps = {
     renderMessage?: (m: any) => React.ReactNode;
     messageRenderers?: MessageRendererRegistry;
     handlers?: ModerationHandlers;
-    attachmentConfig?: ChatAttachmentConfig;
-    sendAttachment?: SendAttachmentFn;
     composerPlaceholder?: string;
     autoFocus?: boolean;
     renderAboveMessages?: () => React.ReactNode;

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,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACtG,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,uBAAuB,EACxB,MAAM,aAAa,CAAC;AAYrB,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,cAAc,CAAC;IAGvB,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAKzB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAG7E,aAAa,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,KAAK,CAAC,SAAS,CAAC;IAC5C,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAG9B,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAClC,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,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAGhE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;6FAGyF;IACzF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;qDACiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AA0BF;;;;;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,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,KAAK,EACV,cAAc,EACd,uBAAuB,EACxB,MAAM,aAAa,CAAC;AAWrB,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,cAAc,CAAC;IAGvB,MAAM,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAKzB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAG7E,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,EAAE,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAGhE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;6FAGyF;IACzF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;qDACiD;IACjD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AA0BF;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,qBAK9C"}

package/dist/ui/ChatShell.js

@@ -66,24 +66,13 @@ function RealtimeChatShell(props) {
         } }));
 }
 function ChatShellView(props) {
-    const { config, header, renderMessage, messageRenderers, handlers, attachmentConfig, sendAttachment, composerPlaceholder, autoFocus = false, renderAboveMessages, renderBelowMessages, renderFooter, onSenderClick, composerDisabled, fillHeight = false, scrollClassName, resolved, } = props;
+    const { config, header, renderMessage, messageRenderers, handlers, composerPlaceholder, autoFocus = false, renderAboveMessages, renderBelowMessages, renderFooter, onSenderClick, composerDisabled, fillHeight = false, scrollClassName, resolved, } = props;
     const { allowed, isInitialLoading, messages, fetchOlder, hasOlder, isFetchingOlder, send, retrySend, readAck, status, typing, signalTyping } = resolved;
     const [showScrollToBottom, setShowScrollToBottom] = React.useState(false);
     const [atBottom, setAtBottom] = React.useState(true);
     const [focused, setFocused] = React.useState(true);
     const lastAckedRef = React.useRef(0);
     const leaseHeldRef = React.useRef(false);
-    // A terminally-failed attachment bubble re-opens the canonical picker through the
-    // Composer's imperative handle. The action is offered only when attachment support
-    // is actually configured AND the default Composer is rendered (a custom renderFooter
-    // replaces it, so the picker would not exist). The new file then rides the ordinary
-    // Composer → guarded-upload flow with a fresh id — never reusing a storage path or
-    // mutating the terminal row.
-    const composerRef = React.useRef(null);
-    const attachmentSupported = Boolean(attachmentConfig && sendAttachment && !renderFooter);
-    const handleRetryAttachment = React.useCallback(() => {
-        composerRef.current?.openAttachmentSelector();
-    }, []);
     // The latest authoritative seq currently rendered (optimistic rows have no seq).
     const latestSeq = React.useMemo(() => {
         let max = 0;
@@ -146,9 +135,15 @@ function ChatShellView(props) {
         // footer all still render, because a consumer that hangs critical controls off those
         // slots (e.g. the guild-invite binding-agreement Agree/Decline/stake-share controls)
         // must work whether or not realtime chat has connected yet (F4.1).
-        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 }) })] })), renderAboveMessages && (_jsx("div", { className: "border-b", children: renderAboveMessages() })), _jsx(CardContent, { className: contentClassName, children: _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(Loader2, { className: "h-5 w-5 animate-spin", "aria-hidden": "true" }), _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 }) })] })), (() => {
+                    // 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: _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(Loader2, { className: "h-5 w-5 animate-spin", "aria-hidden": "true" }), _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() })), _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, handlers: handlers, onSenderClick: onSenderClick, onRetrySend: retrySend, onRetryAttachment: attachmentSupported ? handleRetryAttachment : undefined }) }), 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, { ref: composerRef, onSend: send, onTyping: signalTyping, attachmentConfig: attachmentConfig, sendAttachment: sendAttachment, disabled: composerDisabled, autoFocus: autoFocus, placeholder: composerPlaceholder, mentionConfig: config.mentionConfig }) })] }))] }));
+    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() })), _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, handlers: handlers, onSenderClick: onSenderClick, onRetrySend: retrySend }) }), 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, mentionConfig: config.mentionConfig }) })] }))] }));
 }
 /**
  * R13 — connection-state banner. The realtime path sets `status`; once the first

package/dist/ui/ChatShell.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChatShell.js","sourceRoot":"","sources":["../../src/ui/ChatShell.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\nimport type { ChatMessageV1, SendAttachmentFn, ModerationHandlers } from \"@ttt-productions/chat-core\";\nimport type {\n  ChatCoreConfig,\n  ChatAttachmentConfig,\n  MessageRendererRegistry,\n} from \"../types.js\";\nimport { Card, CardHeader, CardContent, CardFooter, Skeleton } from \"@ttt-productions/ui-core/react\";\nimport { KeyboardAvoidingView } from \"@ttt-productions/mobile-core/react\";\nimport { Loader2 } from \"lucide-react\";\nimport { useChatMessages } from \"../hooks/useChatMessages.js\";\nimport { useRealtimeChatMessages } from \"../realtime/useRealtimeChatMessages.js\";\nimport type { RealtimeChatClient } from \"../realtime/transport.js\";\nimport { MessageList } from \"./MessageList.js\";\nimport { Composer } from \"./Composer.js\";\nimport type { ComposerHandle } from \"./Composer.js\";\nimport { ThreadActions } from \"./menus.js\";\n\nexport type ChatShellProps = {\n  config: ChatCoreConfig;\n\n  // Header\n  header?: React.ReactNode;\n\n  // Send handler — text-only. On the realtime transport this is OPTIONAL: the\n  // shell sends through the DO socket. If provided, it is still called (so a\n  // consumer can mirror to analytics), but the socket send is authoritative.\n  onSend?: (text: string, replyTo?: ChatMessageV1[\"replyTo\"]) => Promise<void>;\n\n  // Message rendering\n  renderMessage?: (m: any) => React.ReactNode;\n  messageRenderers?: MessageRendererRegistry;\n  handlers?: ModerationHandlers;\n\n  // Composer attachment config\n  attachmentConfig?: ChatAttachmentConfig;\n  sendAttachment?: SendAttachmentFn;\n  composerPlaceholder?: string;\n  autoFocus?: boolean;\n\n  // Three render slots\n  renderAboveMessages?: () => React.ReactNode;\n  renderBelowMessages?: () => React.ReactNode;\n  /** If provided, replaces the Composer entirely */\n  renderFooter?: () => React.ReactNode;\n\n  // Sender interaction\n  onSenderClick?: (senderId: string, displayName: string) => void;\n\n  // Disable\n  composerDisabled?: boolean;\n\n  /** Fill the parent's height instead of the default fixed-height card. Lays the Card out\n   *  as `flex flex-col h-full` with the message list flexing to fill (scrolls inside), so a\n   *  full-height page panel doesn't grow unbounded or waste space on a fixed 400px box.\n   *  The consumer must give ChatShell a bounded-height parent (e.g. an `h-full` panel). */\n  fillHeight?: boolean;\n  /** Advanced override for the scrollable region's class (forwarded to MessageList).\n   *  Usually unnecessary — prefer `fillHeight`. */\n  scrollClassName?: string;\n};\n\n/** The resolved data a transport hook hands the presentational view. */\ntype ResolvedChat = {\n  allowed: boolean;\n  isInitialLoading: boolean;\n  messages: ChatMessageV1[];\n  fetchOlder: () => Promise<void>;\n  hasOlder: boolean;\n  isFetchingOlder: boolean;\n  /** The send handler the Composer calls (socket send on realtime, prop on firestore). */\n  send: (text: string, replyTo?: ChatMessageV1[\"replyTo\"]) => Promise<void>;\n  /** Retry a failed realtime send by its original clientMessageId (realtime only;\n   *  absent on firestore). Wired to MessageItemDefault's failed-bubble retry. */\n  retrySend?: (clientMessageId: string) => void;\n  /** Advance the authoritative read cursor (realtime only; absent on the firestore path).\n   *  Returns whether the ack was actually sent so the caller advances its local cursor only on success (M2). */\n  readAck?: (latestSeq: number, focused: boolean) => boolean;\n  /** Realtime connection status — drives the disconnected banner (R13). Absent on firestore. */\n  status?: string;\n  /** uids currently typing (realtime only) — drives the typing indicator (R14). */\n  typing?: string[];\n  /** Signal the local user is typing (coalesced by the transport). Wired to the Composer (R14). */\n  signalTyping?: () => void;\n};\n\n/**\n * ChatShell dispatches on `config.transport`. Hooks must be unconditional, so the\n * two transports live in separate inner components (each calls exactly ONE data\n * hook) and both render the shared presentational `ChatShellView`. The default\n * (undefined / 'firestore') transport is byte-for-byte the previous behavior.\n */\nexport function ChatShell(props: ChatShellProps) {\n  if (props.config.transport === \"realtime\") {\n    return <RealtimeChatShell {...props} />;\n  }\n  return <FirestoreChatShell {...props} />;\n}\n\nfunction FirestoreChatShell(props: ChatShellProps) {\n  const { config, onSend } = props;\n  const r = useChatMessages(config);\n  const send = React.useCallback(\n    async (text: string, replyTo?: ChatMessageV1[\"replyTo\"]) => {\n      if (onSend) await onSend(text, replyTo);\n    },\n    [onSend],\n  );\n  return <ChatShellView {...props} resolved={{ ...r, send }} />;\n}\n\nfunction RealtimeChatShell(props: ChatShellProps) {\n  const { config, onSend } = props;\n  const client = config.realtime?.client as RealtimeChatClient | undefined;\n  if (!client) {\n    throw new Error(\n      \"[ChatShell] transport 'realtime' requires config.realtime.client (createRealtimeChatClient(...))\",\n    );\n  }\n  const r = useRealtimeChatMessages(client);\n  const send = React.useCallback(\n    async (text: string, replyTo?: ChatMessageV1[\"replyTo\"]) => {\n      // Map the UI replyTo (messageId-based) to the wire replyTo (seq + preview).\n      const wireReply =\n        replyTo && replyTo.messageId\n          ? { messageSeq: Number(replyTo.messageId), preview: replyTo.messagePreview ?? \"\" }\n          : null;\n      const ok = r.send(text, Number.isFinite(wireReply?.messageSeq) ? wireReply : null);\n      // C-B8: surface a closed-socket failure so the Composer keeps the user's text\n      // instead of clearing it on a no-op send.\n      if (!ok) throw new Error(\"chat-send-failed\");\n      if (onSend) await onSend(text, replyTo); // optional mirror\n    },\n    [r, onSend],\n  );\n  return (\n    <ChatShellView\n      {...props}\n      resolved={{\n        allowed: r.allowed,\n        isInitialLoading: r.isInitialLoading,\n        messages: r.messages,\n        fetchOlder: r.fetchOlder,\n        hasOlder: r.hasOlder,\n        isFetchingOlder: r.isFetchingOlder,\n        send,\n        retrySend: r.retrySend,\n        readAck: r.readAck,\n        status: r.status,\n        typing: r.typing,\n        signalTyping: r.signalTyping,\n      }}\n    />\n  );\n}\n\nfunction ChatShellView(props: ChatShellProps & { resolved: ResolvedChat }) {\n  const {\n    config,\n    header,\n    renderMessage,\n    messageRenderers,\n    handlers,\n    attachmentConfig,\n    sendAttachment,\n    composerPlaceholder,\n    autoFocus = false,\n    renderAboveMessages,\n    renderBelowMessages,\n    renderFooter,\n    onSenderClick,\n    composerDisabled,\n    fillHeight = false,\n    scrollClassName,\n    resolved,\n  } = props;\n\n  const { allowed, isInitialLoading, messages, fetchOlder, hasOlder, isFetchingOlder, send, retrySend, readAck, status, typing, signalTyping } = resolved;\n\n  const [showScrollToBottom, setShowScrollToBottom] = React.useState(false);\n  const [atBottom, setAtBottom] = React.useState(true);\n  const [focused, setFocused] = React.useState(true);\n  const lastAckedRef = React.useRef(0);\n  const leaseHeldRef = React.useRef(false);\n\n  // A terminally-failed attachment bubble re-opens the canonical picker through the\n  // Composer's imperative handle. The action is offered only when attachment support\n  // is actually configured AND the default Composer is rendered (a custom renderFooter\n  // replaces it, so the picker would not exist). The new file then rides the ordinary\n  // Composer → guarded-upload flow with a fresh id — never reusing a storage path or\n  // mutating the terminal row.\n  const composerRef = React.useRef<ComposerHandle>(null);\n  const attachmentSupported = Boolean(attachmentConfig && sendAttachment && !renderFooter);\n  const handleRetryAttachment = React.useCallback(() => {\n    composerRef.current?.openAttachmentSelector();\n  }, []);\n\n  // The latest authoritative seq currently rendered (optimistic rows have no seq).\n  const latestSeq = React.useMemo(() => {\n    let max = 0;\n    for (const m of messages) {\n      const seq = typeof m.meta?.seq === \"number\" ? (m.meta?.seq as number) : 0;\n      if (seq > max) max = seq;\n    }\n    return max;\n  }, [messages]);\n\n  // Track tab focus/visibility so the read-ack \"focused\" lease releases on blur/hide.\n  React.useEffect(() => {\n    const compute = () =>\n      typeof document === \"undefined\" ||\n      (document.visibilityState !== \"hidden\" && (typeof document.hasFocus !== \"function\" || document.hasFocus()));\n    setFocused(compute());\n    const onChange = () => setFocused(compute());\n    window.addEventListener(\"focus\", onChange);\n    window.addEventListener(\"blur\", onChange);\n    document.addEventListener(\"visibilitychange\", onChange);\n    return () => {\n      window.removeEventListener(\"focus\", onChange);\n      window.removeEventListener(\"blur\", onChange);\n      document.removeEventListener(\"visibilitychange\", onChange);\n    };\n  }, []);\n\n  // C-B6: advance the authoritative read cursor when the reader is actually at the\n  // latest message (channel mounted + tab focused + scrolled to bottom); release the\n  // focus lease exactly once when they stop. No-op on the firestore path (no readAck).\n  React.useEffect(() => {\n    if (!readAck || latestSeq <= 0) return;\n    if (focused && atBottom) {\n      leaseHeldRef.current = true;\n      if (latestSeq > lastAckedRef.current) {\n        // Advance the local marker ONLY if the frame was actually sent — a drop during a\n        // disconnect window must stay un-acked so it retries (the client also re-sends the\n        // cursor on reconnect). (M2)\n        if (readAck(latestSeq, true)) lastAckedRef.current = latestSeq;\n      }\n    } else if (leaseHeldRef.current) {\n      leaseHeldRef.current = false;\n      readAck(latestSeq, false);\n    }\n  }, [readAck, latestSeq, atBottom, focused]);\n\n  // In fill mode the Card flexes to its parent's height and the message list fills the\n  // space between header and composer; otherwise it's the default natural-height card.\n  const cardClassName = fillHeight ? \"w-full flex flex-col h-full min-h-0\" : \"w-full\";\n  const contentClassName = fillHeight ? \"p-0 flex-1 min-h-0 flex flex-col\" : \"p-0\";\n\n  if (!allowed) {\n    return <div className=\"p-4 text-sm opacity-70\">You don&apos;t have access to this thread.</div>;\n  }\n\n  if (isInitialLoading) {\n    // Before the first authoritative snapshot/history result, show an HONEST working\n    // state — a visible \"Opening chat…\" spinner in a polite live region — NOT a blank\n    // parchment/skeleton box (which read as an empty chat) and NOT the reconnect banner\n    // (which must not compete with the initial-opening message). Only the MessageList\n    // region is replaced: the consumer's header + actions + the three render-slots +\n    // footer all still render, because a consumer that hangs critical controls off those\n    // slots (e.g. the guild-invite binding-agreement Agree/Decline/stake-share controls)\n    // must work whether or not realtime chat has connected yet (F4.1).\n    return (\n      <Card className={cardClassName}>\n        {(header || handlers) && (\n          <CardHeader className=\"flex flex-row items-start justify-between gap-4 space-y-0\">\n            <div>{header}</div>\n            <div className=\"flex flex-col items-end gap-2\">\n              <ThreadActions threadId={config.threadId} isAdmin={config.isAdmin} handlers={handlers} />\n            </div>\n          </CardHeader>\n        )}\n        {renderAboveMessages && (\n          <div className=\"border-b\">{renderAboveMessages()}</div>\n        )}\n        <CardContent className={contentClassName}>\n          <div\n            className=\"flex flex-col items-center justify-center gap-2 py-12 text-sm text-muted-foreground\"\n            role=\"status\"\n            aria-live=\"polite\"\n          >\n            <Loader2 className=\"h-5 w-5 animate-spin\" aria-hidden=\"true\" />\n            <span>Opening chat…</span>\n          </div>\n        </CardContent>\n        {renderBelowMessages && (\n          <div className=\"border-t\">{renderBelowMessages()}</div>\n        )}\n        {renderFooter ? (\n          <CardFooter className=\"border-t\">{renderFooter()}</CardFooter>\n        ) : (\n          <CardFooter className=\"border-t\">\n            <Skeleton className=\"h-10 w-full\" />\n          </CardFooter>\n        )}\n      </Card>\n    );\n  }\n\n  return (\n    <Card className={cardClassName}>\n      {(header || handlers) && (\n        <CardHeader className=\"flex flex-row items-start justify-between gap-4 space-y-0\">\n          <div>{header}</div>\n          <div className=\"flex flex-col items-end gap-2\">\n            <ThreadActions threadId={config.threadId} isAdmin={config.isAdmin} handlers={handlers} />\n          </div>\n        </CardHeader>\n      )}\n\n      {/* R13: a disconnected/reconnecting banner so a configured-but-unreachable Worker\n          never presents a healthy-looking empty thread. Only the realtime path sets `status`. */}\n      <ChatConnectionBanner status={status} />\n\n      {renderAboveMessages && (\n        <div className=\"border-b\">{renderAboveMessages()}</div>\n      )}\n\n      <CardContent className={contentClassName}>\n        <MessageList\n          messages={messages}\n          currentUserId={config.currentUserId}\n          isAdmin={config.isAdmin}\n          isFetchingOlder={isFetchingOlder}\n          hasOlder={hasOlder}\n          onLoadOlder={() => fetchOlder()}\n          renderMessage={renderMessage}\n          messageRenderers={messageRenderers}\n          showScrollToBottom={showScrollToBottom}\n          onScrollToBottom={() => setShowScrollToBottom(false)}\n          onAtBottomChange={setAtBottom}\n          fillHeight={fillHeight}\n          scrollClassName={scrollClassName}\n          handlers={handlers}\n          onSenderClick={onSenderClick}\n          onRetrySend={retrySend}\n          onRetryAttachment={attachmentSupported ? handleRetryAttachment : undefined}\n        />\n      </CardContent>\n\n      {renderBelowMessages && (\n        <div className=\"border-t\">{renderBelowMessages()}</div>\n      )}\n\n      {renderFooter ? (\n        <CardFooter className=\"border-t\">\n          {renderFooter()}\n        </CardFooter>\n      ) : (\n        <CardFooter className=\"border-t flex-col items-stretch gap-1\">\n          {/* R14: typing dots above the composer (realtime only — `typing` is undefined on firestore). */}\n          <TypingIndicator typing={typing} />\n          <KeyboardAvoidingView padding offset={8} className=\"w-full\">\n            <Composer\n              ref={composerRef}\n              onSend={send}\n              onTyping={signalTyping}\n              attachmentConfig={attachmentConfig}\n              sendAttachment={sendAttachment}\n              disabled={composerDisabled}\n              autoFocus={autoFocus}\n              placeholder={composerPlaceholder}\n              mentionConfig={config.mentionConfig}\n            />\n          </KeyboardAvoidingView>\n        </CardFooter>\n      )}\n    </Card>\n  );\n}\n\n/**\n * R13 — connection-state banner. The realtime path sets `status`; once the first\n * snapshot has loaded (ChatShellView is past `isInitialLoading`), a dropped/unreachable\n * socket surfaces here instead of a silently-empty thread. Renders nothing on the\n * firestore path (`status` undefined) or while live (`open`).\n */\nfunction ChatConnectionBanner({ status }: { status?: string }) {\n  if (status !== \"reconnecting\" && status !== \"closed\") return null;\n  return (\n    <div\n      className=\"px-3 py-1.5 text-xs text-center bg-muted text-muted-foreground border-b\"\n      role=\"status\"\n      aria-live=\"polite\"\n    >\n      {status === \"reconnecting\"\n        ? \"Reconnecting… messages may be delayed.\"\n        : \"Disconnected — messages may be out of date.\"}\n    </div>\n  );\n}\n\n/** R14 — typing indicator. `typing` is the set of OTHER users typing (the transport\n *  excludes the local user). Generic copy (no name resolution) for v1. */\nfunction TypingIndicator({ typing }: { typing?: string[] }) {\n  if (!typing || typing.length === 0) return null;\n  return (\n    <div className=\"text-xs italic text-muted-foreground\" aria-live=\"polite\">\n      {typing.length === 1 ? \"Someone is typing…\" : \"Several people are typing…\"}\n    </div>\n  );\n}\n"]}
+{"version":3,"file":"ChatShell.js","sourceRoot":"","sources":["../../src/ui/ChatShell.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\nimport type { ChatMessageV1, ModerationHandlers } from \"@ttt-productions/chat-core\";\nimport type {\n  ChatCoreConfig,\n  MessageRendererRegistry,\n} from \"../types.js\";\nimport { Card, CardHeader, CardContent, CardFooter, Skeleton } from \"@ttt-productions/ui-core/react\";\nimport { KeyboardAvoidingView } from \"@ttt-productions/mobile-core/react\";\nimport { Loader2 } from \"lucide-react\";\nimport { useChatMessages } from \"../hooks/useChatMessages.js\";\nimport { useRealtimeChatMessages } from \"../realtime/useRealtimeChatMessages.js\";\nimport type { RealtimeChatClient } from \"../realtime/transport.js\";\nimport { MessageList } from \"./MessageList.js\";\nimport { Composer } from \"./Composer.js\";\nimport { ThreadActions } from \"./menus.js\";\n\nexport type ChatShellProps = {\n  config: ChatCoreConfig;\n\n  // Header\n  header?: React.ReactNode;\n\n  // Send handler — text-only. On the realtime transport this is OPTIONAL: the\n  // shell sends through the DO socket. If provided, it is still called (so a\n  // consumer can mirror to analytics), but the socket send is authoritative.\n  onSend?: (text: string, replyTo?: ChatMessageV1[\"replyTo\"]) => Promise<void>;\n\n  // Message rendering\n  renderMessage?: (m: any) => React.ReactNode;\n  messageRenderers?: MessageRendererRegistry;\n  handlers?: ModerationHandlers;\n\n  composerPlaceholder?: string;\n  autoFocus?: boolean;\n\n  // Three render slots\n  renderAboveMessages?: () => React.ReactNode;\n  renderBelowMessages?: () => React.ReactNode;\n  /** If provided, replaces the Composer entirely */\n  renderFooter?: () => React.ReactNode;\n\n  // Sender interaction\n  onSenderClick?: (senderId: string, displayName: string) => void;\n\n  // Disable\n  composerDisabled?: boolean;\n\n  /** Fill the parent's height instead of the default fixed-height card. Lays the Card out\n   *  as `flex flex-col h-full` with the message list flexing to fill (scrolls inside), so a\n   *  full-height page panel doesn't grow unbounded or waste space on a fixed 400px box.\n   *  The consumer must give ChatShell a bounded-height parent (e.g. an `h-full` panel). */\n  fillHeight?: boolean;\n  /** Advanced override for the scrollable region's class (forwarded to MessageList).\n   *  Usually unnecessary — prefer `fillHeight`. */\n  scrollClassName?: string;\n};\n\n/** The resolved data a transport hook hands the presentational view. */\ntype ResolvedChat = {\n  allowed: boolean;\n  isInitialLoading: boolean;\n  messages: ChatMessageV1[];\n  fetchOlder: () => Promise<void>;\n  hasOlder: boolean;\n  isFetchingOlder: boolean;\n  /** The send handler the Composer calls (socket send on realtime, prop on firestore). */\n  send: (text: string, replyTo?: ChatMessageV1[\"replyTo\"]) => Promise<void>;\n  /** Retry a failed realtime send by its original clientMessageId (realtime only;\n   *  absent on firestore). Wired to MessageItemDefault's failed-bubble retry. */\n  retrySend?: (clientMessageId: string) => void;\n  /** Advance the authoritative read cursor (realtime only; absent on the firestore path).\n   *  Returns whether the ack was actually sent so the caller advances its local cursor only on success (M2). */\n  readAck?: (latestSeq: number, focused: boolean) => boolean;\n  /** Realtime connection status — drives the disconnected banner (R13). Absent on firestore. */\n  status?: string;\n  /** uids currently typing (realtime only) — drives the typing indicator (R14). */\n  typing?: string[];\n  /** Signal the local user is typing (coalesced by the transport). Wired to the Composer (R14). */\n  signalTyping?: () => void;\n};\n\n/**\n * ChatShell dispatches on `config.transport`. Hooks must be unconditional, so the\n * two transports live in separate inner components (each calls exactly ONE data\n * hook) and both render the shared presentational `ChatShellView`. The default\n * (undefined / 'firestore') transport is byte-for-byte the previous behavior.\n */\nexport function ChatShell(props: ChatShellProps) {\n  if (props.config.transport === \"realtime\") {\n    return <RealtimeChatShell {...props} />;\n  }\n  return <FirestoreChatShell {...props} />;\n}\n\nfunction FirestoreChatShell(props: ChatShellProps) {\n  const { config, onSend } = props;\n  const r = useChatMessages(config);\n  const send = React.useCallback(\n    async (text: string, replyTo?: ChatMessageV1[\"replyTo\"]) => {\n      if (onSend) await onSend(text, replyTo);\n    },\n    [onSend],\n  );\n  return <ChatShellView {...props} resolved={{ ...r, send }} />;\n}\n\nfunction RealtimeChatShell(props: ChatShellProps) {\n  const { config, onSend } = props;\n  const client = config.realtime?.client as RealtimeChatClient | undefined;\n  if (!client) {\n    throw new Error(\n      \"[ChatShell] transport 'realtime' requires config.realtime.client (createRealtimeChatClient(...))\",\n    );\n  }\n  const r = useRealtimeChatMessages(client);\n  const send = React.useCallback(\n    async (text: string, replyTo?: ChatMessageV1[\"replyTo\"]) => {\n      // Map the UI replyTo (messageId-based) to the wire replyTo (seq + preview).\n      const wireReply =\n        replyTo && replyTo.messageId\n          ? { messageSeq: Number(replyTo.messageId), preview: replyTo.messagePreview ?? \"\" }\n          : null;\n      const ok = r.send(text, Number.isFinite(wireReply?.messageSeq) ? wireReply : null);\n      // C-B8: surface a closed-socket failure so the Composer keeps the user's text\n      // instead of clearing it on a no-op send.\n      if (!ok) throw new Error(\"chat-send-failed\");\n      if (onSend) await onSend(text, replyTo); // optional mirror\n    },\n    [r, onSend],\n  );\n  return (\n    <ChatShellView\n      {...props}\n      resolved={{\n        allowed: r.allowed,\n        isInitialLoading: r.isInitialLoading,\n        messages: r.messages,\n        fetchOlder: r.fetchOlder,\n        hasOlder: r.hasOlder,\n        isFetchingOlder: r.isFetchingOlder,\n        send,\n        retrySend: r.retrySend,\n        readAck: r.readAck,\n        status: r.status,\n        typing: r.typing,\n        signalTyping: r.signalTyping,\n      }}\n    />\n  );\n}\n\nfunction ChatShellView(props: ChatShellProps & { resolved: ResolvedChat }) {\n  const {\n    config,\n    header,\n    renderMessage,\n    messageRenderers,\n    handlers,\n    composerPlaceholder,\n    autoFocus = false,\n    renderAboveMessages,\n    renderBelowMessages,\n    renderFooter,\n    onSenderClick,\n    composerDisabled,\n    fillHeight = false,\n    scrollClassName,\n    resolved,\n  } = props;\n\n  const { allowed, isInitialLoading, messages, fetchOlder, hasOlder, isFetchingOlder, send, retrySend, readAck, status, typing, signalTyping } = resolved;\n\n  const [showScrollToBottom, setShowScrollToBottom] = React.useState(false);\n  const [atBottom, setAtBottom] = React.useState(true);\n  const [focused, setFocused] = React.useState(true);\n  const lastAckedRef = React.useRef(0);\n  const leaseHeldRef = React.useRef(false);\n\n  // The latest authoritative seq currently rendered (optimistic rows have no seq).\n  const latestSeq = React.useMemo(() => {\n    let max = 0;\n    for (const m of messages) {\n      const seq = typeof m.meta?.seq === \"number\" ? (m.meta?.seq as number) : 0;\n      if (seq > max) max = seq;\n    }\n    return max;\n  }, [messages]);\n\n  // Track tab focus/visibility so the read-ack \"focused\" lease releases on blur/hide.\n  React.useEffect(() => {\n    const compute = () =>\n      typeof document === \"undefined\" ||\n      (document.visibilityState !== \"hidden\" && (typeof document.hasFocus !== \"function\" || document.hasFocus()));\n    setFocused(compute());\n    const onChange = () => setFocused(compute());\n    window.addEventListener(\"focus\", onChange);\n    window.addEventListener(\"blur\", onChange);\n    document.addEventListener(\"visibilitychange\", onChange);\n    return () => {\n      window.removeEventListener(\"focus\", onChange);\n      window.removeEventListener(\"blur\", onChange);\n      document.removeEventListener(\"visibilitychange\", onChange);\n    };\n  }, []);\n\n  // C-B6: advance the authoritative read cursor when the reader is actually at the\n  // latest message (channel mounted + tab focused + scrolled to bottom); release the\n  // focus lease exactly once when they stop. No-op on the firestore path (no readAck).\n  React.useEffect(() => {\n    if (!readAck || latestSeq <= 0) return;\n    if (focused && atBottom) {\n      leaseHeldRef.current = true;\n      if (latestSeq > lastAckedRef.current) {\n        // Advance the local marker ONLY if the frame was actually sent — a drop during a\n        // disconnect window must stay un-acked so it retries (the client also re-sends the\n        // cursor on reconnect). (M2)\n        if (readAck(latestSeq, true)) lastAckedRef.current = latestSeq;\n      }\n    } else if (leaseHeldRef.current) {\n      leaseHeldRef.current = false;\n      readAck(latestSeq, false);\n    }\n  }, [readAck, latestSeq, atBottom, focused]);\n\n  // In fill mode the Card flexes to its parent's height and the message list fills the\n  // space between header and composer; otherwise it's the default natural-height card.\n  const cardClassName = fillHeight ? \"w-full flex flex-col h-full min-h-0\" : \"w-full\";\n  const contentClassName = fillHeight ? \"p-0 flex-1 min-h-0 flex flex-col\" : \"p-0\";\n\n  if (!allowed) {\n    return <div className=\"p-4 text-sm opacity-70\">You don&apos;t have access to this thread.</div>;\n  }\n\n  if (isInitialLoading) {\n    // Before the first authoritative snapshot/history result, show an HONEST working\n    // state — a visible \"Opening chat…\" spinner in a polite live region — NOT a blank\n    // parchment/skeleton box (which read as an empty chat) and NOT the reconnect banner\n    // (which must not compete with the initial-opening message). Only the MessageList\n    // region is replaced: the consumer's header + actions + the three render-slots +\n    // footer all still render, because a consumer that hangs critical controls off those\n    // slots (e.g. the guild-invite binding-agreement Agree/Decline/stake-share controls)\n    // must work whether or not realtime chat has connected yet (F4.1).\n    return (\n      <Card className={cardClassName}>\n        {(header || handlers) && (\n          <CardHeader className=\"flex flex-row items-start justify-between gap-4 space-y-0\">\n            <div>{header}</div>\n            <div className=\"flex flex-col items-end gap-2\">\n              <ThreadActions threadId={config.threadId} isAdmin={config.isAdmin} handlers={handlers} />\n            </div>\n          </CardHeader>\n        )}\n        {(() => {\n          // The wrapper (and its border) renders only when the slot actually\n          // produced content — a slot returning null (e.g. a collapsed\n          // conversation-files section) must not paint an empty bordered strip.\n          const aboveMessages = renderAboveMessages?.() ?? null;\n          return aboveMessages != null && aboveMessages !== false ? (\n            <div className=\"border-b\">{aboveMessages}</div>\n          ) : null;\n        })()}\n        <CardContent className={contentClassName}>\n          <div\n            className=\"flex flex-col items-center justify-center gap-2 py-12 text-sm text-muted-foreground\"\n            role=\"status\"\n            aria-live=\"polite\"\n          >\n            <Loader2 className=\"h-5 w-5 animate-spin\" aria-hidden=\"true\" />\n            <span>Opening chat…</span>\n          </div>\n        </CardContent>\n        {renderBelowMessages && (\n          <div className=\"border-t\">{renderBelowMessages()}</div>\n        )}\n        {renderFooter ? (\n          <CardFooter className=\"border-t\">{renderFooter()}</CardFooter>\n        ) : (\n          <CardFooter className=\"border-t\">\n            <Skeleton className=\"h-10 w-full\" />\n          </CardFooter>\n        )}\n      </Card>\n    );\n  }\n\n  return (\n    <Card className={cardClassName}>\n      {(header || handlers) && (\n        <CardHeader className=\"flex flex-row items-start justify-between gap-4 space-y-0\">\n          <div>{header}</div>\n          <div className=\"flex flex-col items-end gap-2\">\n            <ThreadActions threadId={config.threadId} isAdmin={config.isAdmin} handlers={handlers} />\n          </div>\n        </CardHeader>\n      )}\n\n      {/* R13: a disconnected/reconnecting banner so a configured-but-unreachable Worker\n          never presents a healthy-looking empty thread. Only the realtime path sets `status`. */}\n      <ChatConnectionBanner status={status} />\n\n      {renderAboveMessages && (\n        <div className=\"border-b\">{renderAboveMessages()}</div>\n      )}\n\n      <CardContent className={contentClassName}>\n        <MessageList\n          messages={messages}\n          currentUserId={config.currentUserId}\n          isAdmin={config.isAdmin}\n          isFetchingOlder={isFetchingOlder}\n          hasOlder={hasOlder}\n          onLoadOlder={() => fetchOlder()}\n          renderMessage={renderMessage}\n          messageRenderers={messageRenderers}\n          showScrollToBottom={showScrollToBottom}\n          onScrollToBottom={() => setShowScrollToBottom(false)}\n          onAtBottomChange={setAtBottom}\n          fillHeight={fillHeight}\n          scrollClassName={scrollClassName}\n          handlers={handlers}\n          onSenderClick={onSenderClick}\n          onRetrySend={retrySend}\n        />\n      </CardContent>\n\n      {renderBelowMessages && (\n        <div className=\"border-t\">{renderBelowMessages()}</div>\n      )}\n\n      {renderFooter ? (\n        <CardFooter className=\"border-t\">\n          {renderFooter()}\n        </CardFooter>\n      ) : (\n        <CardFooter className=\"border-t flex-col items-stretch gap-1\">\n          {/* R14: typing dots above the composer (realtime only — `typing` is undefined on firestore). */}\n          <TypingIndicator typing={typing} />\n          <KeyboardAvoidingView padding offset={8} className=\"w-full\">\n            <Composer\n              onSend={send}\n              onTyping={signalTyping}\n              disabled={composerDisabled}\n              autoFocus={autoFocus}\n              placeholder={composerPlaceholder}\n              mentionConfig={config.mentionConfig}\n            />\n          </KeyboardAvoidingView>\n        </CardFooter>\n      )}\n    </Card>\n  );\n}\n\n/**\n * R13 — connection-state banner. The realtime path sets `status`; once the first\n * snapshot has loaded (ChatShellView is past `isInitialLoading`), a dropped/unreachable\n * socket surfaces here instead of a silently-empty thread. Renders nothing on the\n * firestore path (`status` undefined) or while live (`open`).\n */\nfunction ChatConnectionBanner({ status }: { status?: string }) {\n  if (status !== \"reconnecting\" && status !== \"closed\") return null;\n  return (\n    <div\n      className=\"px-3 py-1.5 text-xs text-center bg-muted text-muted-foreground border-b\"\n      role=\"status\"\n      aria-live=\"polite\"\n    >\n      {status === \"reconnecting\"\n        ? \"Reconnecting… messages may be delayed.\"\n        : \"Disconnected — messages may be out of date.\"}\n    </div>\n  );\n}\n\n/** R14 — typing indicator. `typing` is the set of OTHER users typing (the transport\n *  excludes the local user). Generic copy (no name resolution) for v1. */\nfunction TypingIndicator({ typing }: { typing?: string[] }) {\n  if (!typing || typing.length === 0) return null;\n  return (\n    <div className=\"text-xs italic text-muted-foreground\" aria-live=\"polite\">\n      {typing.length === 1 ? \"Someone is typing…\" : \"Several people are typing…\"}\n    </div>\n  );\n}\n"]}

package/dist/ui/Composer.d.ts

@@ -1,10 +1,10 @@
 import * as React from "react";
-import type { ChatMessageV1, SendAttachmentFn } from "@ttt-productions/chat-core";
-import type { ChatAttachmentConfig } from "../types.js";
+import type { ChatMessageV1 } from "@ttt-productions/chat-core";
 export type ComposerProps = {
     /**
-     * Text-only send. Composer calls this when there is no pending attachment.
-     * Consumer creates the message doc. Return value is ignored.
+     * Text send. The composer is TEXT-ONLY — files are shared through the
+     * conversation's Conversation Files surface, never through the message
+     * timeline, so there is no attachment path here.
      */
     onSend: (text: string, replyTo?: ChatMessageV1["replyTo"]) => Promise<void>;
     /**
@@ -13,33 +13,10 @@ export type ComposerProps = {
      * Optional — absent on the firestore transport (no typing broadcast).
      */
     onTyping?: () => void;
-    attachmentConfig?: ChatAttachmentConfig;
-    /**
-     * Attachment send. Composer uploads the file to Storage first, then calls
-     * this with the resulting metadata. Consumer wires it to a backend callable
-     * (`startUpload`) that writes the pendingMedia doc. The processor creates
-     * the message doc after moderation succeeds.
-     * Required for attachment functionality.
-     */
-    sendAttachment?: SendAttachmentFn;
     disabled?: boolean;
     autoFocus?: boolean;
     placeholder?: string;
     mentionConfig?: import('../types.js').ChatMentionConfig;
 };
-/**
- * Imperative handle exposed by {@link Composer} via `ref`. Additive — ref-less
- * usage is unaffected. ChatShell holds this ref so a failed-attachment bubble's
- * "Attach again" action can re-open the canonical picker.
- */
-export type ComposerHandle = {
-    /**
-     * Open the attachment picker, delegating to the underlying MediaInput's
-     * `openSelection()`. Must be called synchronously from a user gesture. No-op
-     * when attachments are not configured (the MediaInput is not mounted) or the
-     * composer is disabled/sending (MediaInput's own gate no-ops it).
-     */
-    openAttachmentSelector: () => void;
-};
-export declare const Composer: React.ForwardRefExoticComponent<ComposerProps & React.RefAttributes<ComposerHandle>>;
+export declare function Composer(props: ComposerProps): React.JSX.Element;
 //# sourceMappingURL=Composer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Composer.d.ts","sourceRoot":"","sources":["../../src/ui/Composer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAU/B,OAAO,KAAK,EAAkB,aAAa,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAClG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAiCxD,MAAM,MAAM,aAAa,GAAG;IAC1B;;;OAGG;IACH,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAGtB,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAElC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,aAAa,EAAE,iBAAiB,CAAC;CACzD,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;;OAKG;IACH,sBAAsB,EAAE,MAAM,IAAI,CAAC;CACpC,CAAC;AAEF,eAAO,MAAM,QAAQ,sFAyOnB,CAAC"}
+{"version":3,"file":"Composer.d.ts","sourceRoot":"","sources":["../../src/ui/Composer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAQhE,MAAM,MAAM,aAAa,GAAG;IAC1B;;;;OAIG;IACH,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAEtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,aAAa,EAAE,iBAAiB,CAAC;CACzD,CAAC;AAEF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,qBAuH5C"}