@ttt-productions/chat-core 0.11.4 → 0.11.5

package/dist/grouping.d.ts

@@ -1,21 +1,3 @@
 import type { ChatMessageGroupKey, ChatMessageV1 } from './types.js';
-/**
- * Determine if `msg` is a "continuation" of `prev` for the purpose of
- * visually grouping consecutive messages from the same sender in the
- * message list.
- *
- * A message is a continuation when ALL of the following hold:
- *   - `prev` exists.
- *   - Neither `prev` nor `msg` is a system message.
- *   - `prev` and `msg` have the same `senderId`.
- *   - `msg.createdAt - prev.createdAt` is in the inclusive range
- *     `[0, GROUP_GAP_SEC * 1000]` milliseconds. Negative gaps
- *     (out-of-order messages) are treated as not-a-continuation.
- *   - When the app supplies `groupKey`, both messages have the same key — a
- *     continuation hides the sender line, so a per-message fact the app shows
- *     there must break the group when it changes.
- *
- * Pure function. No side effects. Safe to call from server and client.
- */
 export declare function isContinuation(prev: ChatMessageV1 | undefined, msg: ChatMessageV1, groupKey?: ChatMessageGroupKey): boolean;
 //# sourceMappingURL=grouping.d.ts.map

package/dist/grouping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grouping.d.ts","sourceRoot":"","sources":["../src/grouping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGrE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,aAAa,GAAG,SAAS,EAC/B,GAAG,EAAE,aAAa,EAClB,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,OAAO,CAOT"}
+{"version":3,"file":"grouping.d.ts","sourceRoot":"","sources":["../src/grouping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGrE,wBAAgB,cAAc,CAC5B,IAAI,EAAE,aAAa,GAAG,SAAS,EAC/B,GAAG,EAAE,aAAa,EAClB,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,OAAO,CAOT"}

package/dist/grouping.js

@@ -1,22 +1,4 @@
 import { GROUP_GAP_SEC } from './types.js';
-/**
- * Determine if `msg` is a "continuation" of `prev` for the purpose of
- * visually grouping consecutive messages from the same sender in the
- * message list.
- *
- * A message is a continuation when ALL of the following hold:
- *   - `prev` exists.
- *   - Neither `prev` nor `msg` is a system message.
- *   - `prev` and `msg` have the same `senderId`.
- *   - `msg.createdAt - prev.createdAt` is in the inclusive range
- *     `[0, GROUP_GAP_SEC * 1000]` milliseconds. Negative gaps
- *     (out-of-order messages) are treated as not-a-continuation.
- *   - When the app supplies `groupKey`, both messages have the same key — a
- *     continuation hides the sender line, so a per-message fact the app shows
- *     there must break the group when it changes.
- *
- * Pure function. No side effects. Safe to call from server and client.
- */
 export function isContinuation(prev, msg, groupKey) {
     if (!prev)
         return false;

package/dist/grouping.js.map

@@ -1 +1 @@
-{"version":3,"file":"grouping.js","sourceRoot":"","sources":["../src/grouping.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,cAAc,CAC5B,IAA+B,EAC/B,GAAkB,EAClB,QAA8B;IAE9B,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,eAAe;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IACjD,IAAI,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/D,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAC7C,OAAO,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,aAAa,GAAG,IAAI,CAAC;AACrD,CAAC","sourcesContent":["import type { ChatMessageGroupKey, ChatMessageV1 } from './types.js';\nimport { GROUP_GAP_SEC } from './types.js';\n\n/**\n * Determine if `msg` is a \"continuation\" of `prev` for the purpose of\n * visually grouping consecutive messages from the same sender in the\n * message list.\n *\n * A message is a continuation when ALL of the following hold:\n *   - `prev` exists.\n *   - Neither `prev` nor `msg` is a system message.\n *   - `prev` and `msg` have the same `senderId`.\n *   - `msg.createdAt - prev.createdAt` is in the inclusive range\n *     `[0, GROUP_GAP_SEC * 1000]` milliseconds. Negative gaps\n *     (out-of-order messages) are treated as not-a-continuation.\n *   - When the app supplies `groupKey`, both messages have the same key — a\n *     continuation hides the sender line, so a per-message fact the app shows\n *     there must break the group when it changes.\n *\n * Pure function. No side effects. Safe to call from server and client.\n */\nexport function isContinuation(\n  prev: ChatMessageV1 | undefined,\n  msg: ChatMessageV1,\n  groupKey?: ChatMessageGroupKey,\n): boolean {\n  if (!prev) return false;\n  if (msg.isSystemMessage || prev.isSystemMessage) return false;\n  if (msg.senderId !== prev.senderId) return false;\n  if (groupKey && groupKey(msg) !== groupKey(prev)) return false;\n  const gapMs = msg.createdAt - prev.createdAt;\n  return gapMs >= 0 && gapMs <= GROUP_GAP_SEC * 1000;\n}\n"]}
+{"version":3,"file":"grouping.js","sourceRoot":"","sources":["../src/grouping.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,UAAU,cAAc,CAC5B,IAA+B,EAC/B,GAAkB,EAClB,QAA8B;IAE9B,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,eAAe;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IACjD,IAAI,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/D,MAAM,KAAK,GAAG,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAC7C,OAAO,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,aAAa,GAAG,IAAI,CAAC;AACrD,CAAC","sourcesContent":["import type { ChatMessageGroupKey, ChatMessageV1 } from './types.js';\nimport { GROUP_GAP_SEC } from './types.js';\n\nexport function isContinuation(\n  prev: ChatMessageV1 | undefined,\n  msg: ChatMessageV1,\n  groupKey?: ChatMessageGroupKey,\n): boolean {\n  if (!prev) return false;\n  if (msg.isSystemMessage || prev.isSystemMessage) return false;\n  if (msg.senderId !== prev.senderId) return false;\n  if (groupKey && groupKey(msg) !== groupKey(prev)) return false;\n  const gapMs = msg.createdAt - prev.createdAt;\n  return gapMs >= 0 && gapMs <= GROUP_GAP_SEC * 1000;\n}\n"]}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EACV,MAAM,EACN,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EACV,MAAM,EACN,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,10 +1,3 @@
-// Pure chat-core barrel. No React, no Firebase (client or admin) reachable from
-// here — safe for Cloud Functions, scripts, and future native/TV clients that
-// only need the contracts and grouping logic. Zero @ttt-productions/* deps.
-//
-// The chat React UI, hooks, Firestore-client adapter config, and render types
-// live in @ttt-productions/chat-react. The realtime wire contract and the pure
-// chat Zod schemas live in @ttt-productions/chat-schemas.
 export { GROUP_GAP_SEC } from './types.js';
 export { isContinuation } from './grouping.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,8EAA8E;AAC9E,4EAA4E;AAC5E,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,0DAA0D;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC","sourcesContent":["// Pure chat-core barrel. No React, no Firebase (client or admin) reachable from\n// here — safe for Cloud Functions, scripts, and future native/TV clients that\n// only need the contracts and grouping logic. Zero @ttt-productions/* deps.\n//\n// The chat React UI, hooks, Firestore-client adapter config, and render types\n// live in @ttt-productions/chat-react. The realtime wire contract and the pure\n// chat Zod schemas live in @ttt-productions/chat-schemas.\n\nexport { GROUP_GAP_SEC } from './types.js';\nexport { isContinuation } from './grouping.js';\nexport type {\n  ChatId,\n  ChatThreadV1,\n  ChatMessageV1,\n  ChatMessageGroupKey,\n  ModerationHandlers,\n  ChatNameResolver,\n  ChatNameResolution,\n  ChatPrewarmSenders,\n} from './types.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC","sourcesContent":["export { GROUP_GAP_SEC } from './types.js';\nexport { isContinuation } from './grouping.js';\nexport type {\n  ChatId,\n  ChatThreadV1,\n  ChatMessageV1,\n  ChatMessageGroupKey,\n  ModerationHandlers,\n  ChatNameResolver,\n  ChatNameResolution,\n  ChatPrewarmSenders,\n} from './types.js';\n"]}

package/dist/types.d.ts

@@ -14,13 +14,7 @@ export type ChatMessageV1 = {
     text?: string;
     type?: string;
     isSystemMessage?: boolean;
-    /**
-     * Account ids a server-written message's text refers to, stored beside the text (never inside
-     * it). The UI prewarms and resolves them like senders; an account's anonymization rewrites them.
-     */
     referencedUids?: string[];
-    /** Moderation tombstone flag on the stored message (backend-written); consumers
-     * render a tombstone instead of the content when true. */
     hidden?: boolean;
     meta?: Record<string, unknown>;
 };
@@ -30,20 +24,8 @@ export type ModerationHandlers = {
     onDeleteMessage?: (messageId: string) => void | Promise<void>;
     onDeleteThread?: (threadId: string) => void | Promise<void>;
 };
-/** Max seconds between messages to be grouped as continuation */
 export declare const GROUP_GAP_SEC = 120;
-/**
- * The app's own per-message grouping fact: two consecutive messages from one sender group only
- * when their keys are equal. `undefined` is an ordinary key value like any other.
- */
 export type ChatMessageGroupKey = (m: ChatMessageV1) => string | undefined;
-/**
- * What the app knows about a sender's display name right now. `pending` — the read has
- * not answered; `unavailable` — the read answered and there is no person to name;
- * `failed` — the read failed, and `retry` asks again. Only `resolved` carries a name:
- * the chat UI never invents one for the other three, it hands them to the app's
- * renderer (chat-react's `renderUnresolvedName`).
- */
 export type ChatNameResolution = {
     status: 'resolved';
     name: string;
@@ -55,17 +37,6 @@ export type ChatNameResolution = {
     status: 'failed';
     retry: () => void;
 };
-/**
- * Resolves a senderId synchronously from the app's own cache. Called during render,
- * so it reads what the app already holds and never starts a fetch itself — the app
- * fetches through {@link ChatPrewarmSenders}.
- */
 export type ChatNameResolver = (senderId: string) => ChatNameResolution;
-/**
- * Optional pre-warm callback. The chat UI calls this with the deduped list of
- * senderIds visible in the current message page so the consuming app can
- * batch-fetch names into its cache. Implementations should be idempotent —
- * the same id list will be passed across re-renders.
- */
 export type ChatPrewarmSenders = (senderIds: string[]) => void;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAE5B,MAAM,MAAM,YAAY,GAAG;IACzB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;8DAC0D;IAC1D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAMF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D,CAAC;AAMF,iEAAiE;AACjE,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,EAAE,aAAa,KAAK,MAAM,GAAG,SAAS,CAAC;AAM3E;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,GACzB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC;AAE5C;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,kBAAkB,CAAC;AAExE;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAE5B,MAAM,MAAM,YAAY,GAAG;IACzB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D,CAAC;AAEF,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,EAAE,aAAa,KAAK,MAAM,GAAG,SAAS,CAAC;AAE3E,MAAM,MAAM,kBAAkB,GAC1B;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,GACzB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC;AAE5C,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,kBAAkB,CAAC;AAExE,MAAM,MAAM,kBAAkB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC"}

package/dist/types.js

@@ -1,17 +1,2 @@
-// ============================================
-// THREAD & MESSAGE
-// ============================================
-//
-// Chat is TEXT-ONLY. A message never carries a file: files belong to the
-// CONVERSATION (the Conversation Files list owned by the consuming app), not to
-// a message in its timeline. There is no attachment contract in this package.
-//
-// A message also carries NO reply pointer: no chat surface has an authoring
-// affordance for replying to a specific message, so a `replyTo` contract here
-// would be unreachable machinery.
-// ============================================
-// MESSAGE GROUPING (internal, exported for tests)
-// ============================================
-/** Max seconds between messages to be grouped as continuation */
 export const GROUP_GAP_SEC = 120;
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,mBAAmB;AACnB,+CAA+C;AAC/C,EAAE;AACF,yEAAyE;AACzE,gFAAgF;AAChF,8EAA8E;AAC9E,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,kCAAkC;AA0ClC,+CAA+C;AAC/C,kDAAkD;AAClD,+CAA+C;AAE/C,iEAAiE;AACjE,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC","sourcesContent":["// ============================================\n// THREAD & MESSAGE\n// ============================================\n//\n// Chat is TEXT-ONLY. A message never carries a file: files belong to the\n// CONVERSATION (the Conversation Files list owned by the consuming app), not to\n// a message in its timeline. There is no attachment contract in this package.\n//\n// A message also carries NO reply pointer: no chat surface has an authoring\n// affordance for replying to a specific message, so a `replyTo` contract here\n// would be unreachable machinery.\n\nexport type ChatId = string;\n\nexport type ChatThreadV1 = {\n  participantUserIds?: string[];\n  createdAt: number; // millis\n  lastMessageAt: number; // millis\n  status?: string; // opaque to chat-core\n  meta?: Record<string, unknown>; // opaque\n};\n\nexport type ChatMessageV1 = {\n  messageId: string;\n  threadId: string;\n  createdAt: number; // millis\n  senderId: string;\n  text?: string;\n  type?: string; // optional for renderer registry\n  isSystemMessage?: boolean;\n  /**\n   * Account ids a server-written message's text refers to, stored beside the text (never inside\n   * it). The UI prewarms and resolves them like senders; an account's anonymization rewrites them.\n   */\n  referencedUids?: string[];\n  /** Moderation tombstone flag on the stored message (backend-written); consumers\n   * render a tombstone instead of the content when true. */\n  hidden?: boolean;\n  meta?: Record<string, unknown>;\n};\n\n// ============================================\n// MODERATION\n// ============================================\n\nexport type ModerationHandlers = {\n  onReportMessage?: (messageId: string, reason?: string) => void | Promise<void>;\n  onReportThread?: (threadId: string, reason?: string) => void | Promise<void>;\n  onDeleteMessage?: (messageId: string) => void | Promise<void>; // admin only (gated)\n  onDeleteThread?: (threadId: string) => void | Promise<void>; // admin only (gated)\n};\n\n// ============================================\n// MESSAGE GROUPING (internal, exported for tests)\n// ============================================\n\n/** Max seconds between messages to be grouped as continuation */\nexport const GROUP_GAP_SEC = 120;\n\n/**\n * The app's own per-message grouping fact: two consecutive messages from one sender group only\n * when their keys are equal. `undefined` is an ordinary key value like any other.\n */\nexport type ChatMessageGroupKey = (m: ChatMessageV1) => string | undefined;\n\n// ============================================\n// NAME RESOLUTION\n// ============================================\n\n/**\n * What the app knows about a sender's display name right now. `pending` — the read has\n * not answered; `unavailable` — the read answered and there is no person to name;\n * `failed` — the read failed, and `retry` asks again. Only `resolved` carries a name:\n * the chat UI never invents one for the other three, it hands them to the app's\n * renderer (chat-react's `renderUnresolvedName`).\n */\nexport type ChatNameResolution =\n  | { status: 'resolved'; name: string }\n  | { status: 'pending' }\n  | { status: 'unavailable' }\n  | { status: 'failed'; retry: () => void };\n\n/**\n * Resolves a senderId synchronously from the app's own cache. Called during render,\n * so it reads what the app already holds and never starts a fetch itself — the app\n * fetches through {@link ChatPrewarmSenders}.\n */\nexport type ChatNameResolver = (senderId: string) => ChatNameResolution;\n\n/**\n * Optional pre-warm callback. The chat UI calls this with the deduped list of\n * senderIds visible in the current message page so the consuming app can\n * batch-fetch names into its cache. Implementations should be idempotent —\n * the same id list will be passed across re-renders.\n */\nexport type ChatPrewarmSenders = (senderIds: string[]) => void;\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA8BA,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC","sourcesContent":["export type ChatId = string;\n\nexport type ChatThreadV1 = {\n  participantUserIds?: string[];\n  createdAt: number;\n  lastMessageAt: number;\n  status?: string;\n  meta?: Record<string, unknown>;\n};\n\nexport type ChatMessageV1 = {\n  messageId: string;\n  threadId: string;\n  createdAt: number;\n  senderId: string;\n  text?: string;\n  type?: string;\n  isSystemMessage?: boolean;\n  referencedUids?: string[];\n  hidden?: boolean;\n  meta?: Record<string, unknown>;\n};\n\nexport type ModerationHandlers = {\n  onReportMessage?: (messageId: string, reason?: string) => void | Promise<void>;\n  onReportThread?: (threadId: string, reason?: string) => void | Promise<void>;\n  onDeleteMessage?: (messageId: string) => void | Promise<void>;\n  onDeleteThread?: (threadId: string) => void | Promise<void>;\n};\n\nexport const GROUP_GAP_SEC = 120;\n\nexport type ChatMessageGroupKey = (m: ChatMessageV1) => string | undefined;\n\nexport type ChatNameResolution =\n  | { status: 'resolved'; name: string }\n  | { status: 'pending' }\n  | { status: 'unavailable' }\n  | { status: 'failed'; retry: () => void };\n\nexport type ChatNameResolver = (senderId: string) => ChatNameResolution;\n\nexport type ChatPrewarmSenders = (senderIds: string[]) => void;\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttt-productions/chat-core",
-  "version": "0.11.4",
+  "version": "0.11.5",
   "description": "Pure chat contracts and grouping helpers for TTT Productions apps (no React, no Firebase)",
   "repository": {
     "type": "git",