@linktr.ee/messaging-react 3.18.0 → 3.19.0-rc-1785393579

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-BQ4mQDo2.cjs");exports.ActionButton=e.ActionButton;exports.Avatar=e.Avatar;exports.ChannelEmptyState=e.ChannelEmptyState;exports.ChannelList=e.ChannelList;exports.ChannelView=e.ChannelView;exports.CustomMessageProvider=e.CustomMessageProvider;exports.FaqList=e.FaqList;exports.FaqListItem=e.FaqListItem;exports.LinkAttachment=e.LinkAttachment;exports.LockedAttachment=e.LockedAttachment;exports.MediaMessage=e.MediaMessage;exports.MessageAttachment=e.MessageAttachment;exports.MessageBubble=e.MessageBubble;exports.MessageVoteButtons=e.MessageVoteButtons;exports.MessagingProvider=e.MessagingProvider;exports.MessagingShell=e.MessagingShell;exports.buildCompactMetaLabel=e.buildCompactMetaLabel;exports.formatFileSize=e.formatFileSize;exports.formatRelativeTime=e.formatRelativeTime;exports.getFileExtensionLabel=e.getFileExtensionLabel;exports.getMessageDisplayText=e.getMessageDisplayText;exports.isLinkAttachment=e.isLinkAttachment;exports.isUuidLike=e.isUuidLike;exports.messageAttachmentGroupPositionFromStream=e.bubbleGroupPositionFromStream;exports.normalizeLanguageCode=e.normalizeLanguageCode;exports.optimizeMessagingAttachmentUrl=e.optimizeMessagingAttachmentUrl;exports.resolveConversationParticipant=e.resolveConversationParticipant;exports.resolveLinkAttachment=e.resolveLinkAttachment;exports.resolveMediaFromMessage=e.resolveMediaFromMessage;exports.resolveParticipantDisplayName=e.resolveParticipantDisplayName;exports.useComposerLocked=e.useComposerLocked;exports.useCustomMessage=e.useCustomMessage;exports.useMessageVote=e.useMessageVote;exports.useMessaging=e.useMessaging;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-CcUtwsNq.cjs");exports.ActionButton=e.ActionButton;exports.Avatar=e.Avatar;exports.ChannelEmptyState=e.ChannelEmptyState;exports.ChannelList=e.ChannelList;exports.ChannelView=e.ChannelView;exports.CustomMessageProvider=e.CustomMessageProvider;exports.FaqList=e.FaqList;exports.FaqListItem=e.FaqListItem;exports.LinkAttachment=e.LinkAttachment;exports.LockedAttachment=e.LockedAttachment;exports.MediaMessage=e.MediaMessage;exports.MessageAttachment=e.MessageAttachment;exports.MessageBubble=e.MessageBubble;exports.MessageVoteButtons=e.MessageVoteButtons;exports.MessagingProvider=e.MessagingProvider;exports.MessagingShell=e.MessagingShell;exports.buildCompactMetaLabel=e.buildCompactMetaLabel;exports.formatFileSize=e.formatFileSize;exports.formatRelativeTime=e.formatRelativeTime;exports.getFileExtensionLabel=e.getFileExtensionLabel;exports.getMessageDisplayText=e.getMessageDisplayText;exports.isLinkAttachment=e.isLinkAttachment;exports.isUuidLike=e.isUuidLike;exports.messageAttachmentGroupPositionFromStream=e.bubbleGroupPositionFromStream;exports.normalizeLanguageCode=e.normalizeLanguageCode;exports.optimizeMessagingAttachmentUrl=e.optimizeMessagingAttachmentUrl;exports.resolveConversationParticipant=e.resolveConversationParticipant;exports.resolveLinkAttachment=e.resolveLinkAttachment;exports.resolveMediaFromMessage=e.resolveMediaFromMessage;exports.resolveParticipantDisplayName=e.resolveParticipantDisplayName;exports.useComposerLocked=e.useComposerLocked;exports.useCustomMessage=e.useCustomMessage;exports.useMessageVote=e.useMessageVote;exports.useMessaging=e.useMessaging;
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.ts

@@ -13,6 +13,7 @@ import { FC } from 'react';
 import { InfiniteScrollProps } from 'stream-chat-react';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
 import { LocalMessage } from 'stream-chat';
+import { MessageCustomType } from '@linktr.ee/messaging-taxonomy';
 import { MessagingUser } from '@linktr.ee/messaging-core';
 import { Provider } from 'react';
 import { SendMessageAPIResponse } from 'stream-chat';
@@ -27,8 +28,6 @@ export declare interface ActionButtonProps extends default_2.ButtonHTMLAttribute
     variant?: "default" | "danger";
 }
 
-declare type AgeSafetySystemType = 'SYSTEM_AGE_SAFETY_BLOCKED';
-
 export declare type AttachmentSourceType = 'image' | 'audio' | 'video' | 'document';
 
 declare interface AudioAttachmentSharedProps extends MessageAttachmentBaseProps {
@@ -447,8 +446,6 @@ export declare interface CustomMessageRegistry {
     LockedAttachment: LockedAttachmentContextValue;
 }
 
-declare type DmAgentSystemType = 'SYSTEM_DM_AGENT_PAUSED' | 'SYSTEM_DM_AGENT_RESUMED';
-
 declare type DraftProps = MediaCardDraftProps & {
     /** Drafting is always the sender — doesn't apply here. */
     isMine?: never;
@@ -462,8 +459,6 @@ declare type DraftProps = MediaCardDraftProps & {
     renderedText?: default_2.ReactNode;
 };
 
-declare type EscalationSystemType = 'SYSTEM_ESCALATION';
-
 export declare interface Faq {
     id: string;
     question: string;
@@ -1349,8 +1344,6 @@ export declare interface MessageBubbleBaseProps {
  */
 export declare type MessageBubbleVariant = 'sent' | 'received';
 
-declare type MessageCustomType = 'MESSAGE_TIP' | 'MESSAGE_PAID' | 'MESSAGE_CHATBOT' | 'MESSAGE_ATTACHMENT' | AgeSafetySystemType | EscalationSystemType | DmAgentSystemType;
-
 /**
  * Callback invoked when a user clicks a link inside the channel view.
  * Receives the clicked URL and, when resolvable, the message the link

package/dist/index.js

@@ -1,4 +1,4 @@
-import { a as e, b as t, C as i, c as o, d as n, e as m, F as r, f as g, L as l, h as M, M as c, i as u, j as L, k as h, l as p, m as d, n as v, p as C, q as A, s as k, t as F, u as b, v as P, w as f, x, o as y, y as z, z as B, B as S, D as q, E as D, G as E, H as V, I as w } from "./index-CsPg1TYf.js";
+import { a as e, b as t, C as i, c as o, d as n, e as m, F as r, f as g, L as l, h as M, M as c, i as u, j as L, k as h, l as p, m as d, n as v, p as C, q as A, s as k, t as F, u as b, v as P, w as f, x, o as y, y as z, z as B, B as S, D as q, E as D, G as E, H as V, I as w } from "./index-DtD5bLEl.js";
 export {
   e as ActionButton,
   t as Avatar,

package/dist/testing.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"testing.cjs","sources":["../src/testing/createMockStreamChatClient.ts","../src/testing/createMockMessagingClient.ts"],"sourcesContent":["import { StreamChat } from 'stream-chat'\n\nimport type { MockMessagingUser } from './createMockMessagingClient'\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\nexport interface CreateMockStreamChatClientOptions {\n  /**\n   * Also replace the connection-dependent client methods (`connectUser`,\n   * `disconnectUser`, `userMuteStatus`) with offline no-ops. Needed when the\n   * client drives a flow that would otherwise open a WebSocket or throw\n   * \"Make sure to await connectUser() first.\" offline. Direct `<Chat client>`\n   * rendering (e.g. component stories) does not need this.\n   */\n  stubConnection?: boolean\n}\n\n/**\n * Builds an offline `StreamChat` for mocks and stories: a real client on a\n * throwaway api key with `userID`/`user` set so `<Chat>` treats it as\n * connected without a backend. The single place that knows how to construct a\n * connectionless Stream client, so a stream-chat version bump only needs\n * updating here rather than in each mock surface.\n */\nexport function createMockStreamChatClient(\n  user: MockMessagingUser,\n  { stubConnection = false }: CreateMockStreamChatClientOptions = {}\n): StreamChat {\n  const client = new StreamChat('mock-api-key', {\n    allowServerSideConnect: true,\n  })\n  client.userID = user.id\n  client.user = user as any\n\n  if (stubConnection) {\n    client.connectUser = async () => ({ me: user }) as any\n    client.disconnectUser = async () => undefined\n    client.userMuteStatus = (() => false) as any\n  }\n\n  return client\n}\n\n/* eslint-enable @typescript-eslint/no-explicit-any */\n","import type {\n  Channel,\n  MessageResponse,\n  QueryChannelAPIResponse,\n  SendMessageAPIResponse,\n} from 'stream-chat'\nimport { StreamChat } from 'stream-chat'\n\nimport { createMockStreamChatClient } from './createMockStreamChatClient'\n\n/** A participant in the mock conversation. */\nexport interface MockMessagingUser {\n  id: string\n  name?: string\n  image?: string\n}\n\n/**\n * A seed message, authored from the viewer's perspective. `from: 'me'` is the\n * connected user (the viewer); `from: 'them'` is the other participant.\n */\nexport interface MockMessage {\n  id?: string\n  text?: string\n  from: 'me' | 'them'\n  /** Stream attachment payloads, rendered by the toolkit's attachment gate. */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  attachments?: any[]\n  /** e.g. `{ custom_type: 'MESSAGE_WELCOME' }`. */\n  metadata?: Record<string, unknown>\n}\n\nexport interface CreateMockMessagingClientOptions {\n  /** The connected/viewing user. */\n  currentUser: MockMessagingUser\n  /** The other party in the direct conversation (e.g. the creator/linker). */\n  participant: MockMessagingUser\n  /** Seed conversation, oldest-first. */\n  messages?: MockMessage[]\n  /** Channel id; defaults to `mock-dm`. */\n  channelId?: string\n  /**\n   * Optional canned reply. Called after the viewer sends a message; return the\n   * reply text (or a partial message) to have `participant` echo a response, or\n   * a falsy value for no reply. Drives the \"send echo\" in `dev:mock-messaging`.\n   */\n  onSend?: (\n    text: string\n  ) => string | { text?: string; attachments?: unknown[] } | null | undefined\n}\n\nexport interface MockMessagingClient {\n  /** Pass to `<MessagingProvider client={...}>`. */\n  client: StreamChat\n  /** The seeded direct-conversation channel. */\n  channel: Channel\n  /** Pass to `<MessagingShell initialParticipantFilter={...}>`. */\n  participantFilterId: string\n}\n\nconst REPLY_DELAY_MS = 600\n\n/**\n * Builds an offline Stream client seeded with a single direct conversation, so\n * consumers can render the **real** messaging UI (MessagingProvider →\n * MessagingShell → ChannelView) without a Stream backend — for `dev:mock-*`\n * surfaces and Storybook. It is a real `StreamChat` whose network calls\n * (`connectUser`, `queryChannels`, `channel.watch`, `channel.sendMessage`) are\n * replaced with in-memory behaviour driven by Stream's own channel-state\n * machinery, so rendering fidelity matches production.\n *\n * Ships from `@linktr.ee/messaging-react/testing` and must never be imported by\n * production code.\n */\nexport function createMockMessagingClient({\n  currentUser,\n  participant,\n  messages = [],\n  channelId = 'mock-dm',\n  onSend,\n}: CreateMockMessagingClientOptions): MockMessagingClient {\n  // Offline client marked connected without a WebSocket. `stubConnection` also\n  // no-ops connectUser/disconnectUser/userMuteStatus: `MessagingProvider`\n  // renders `<Chat client={client}>` directly so it never calls connectUser,\n  // and handling the `message.new` events dispatched on send + echo below runs\n  // Channel._countMessageAsUnread → client.userMuteStatus, which throws offline.\n  const client = createMockStreamChatClient(currentUser, {\n    stubConnection: true,\n  })\n\n  const cid = `messaging:${channelId}`\n\n  const toStreamMessage = (\n    message: MockMessage,\n    index: number\n  ): MessageResponse => {\n    const author = message.from === 'me' ? currentUser : participant\n    // Stagger timestamps oldest-first so the list orders naturally. Must be a\n    // Date, not an ISO string: we seed `channel.state.messages` directly\n    // (bypassing Stream's wire→Date parsing), and stream-chat-react calls\n    // `.getTime()` on `created_at` (e.g. useCooldownTimer / addToMessageList).\n    const createdAt = new Date(Date.now() - (messages.length - index) * 60_000)\n    return {\n      id: message.id ?? `mock-msg-${index}`,\n      text: message.text ?? '',\n      type: 'regular',\n      html: message.text ? `<p>${message.text}</p>` : '',\n      user: author,\n      attachments: message.attachments ?? [],\n      latest_reactions: [],\n      own_reactions: [],\n      reaction_counts: {},\n      reaction_scores: {},\n      reply_count: 0,\n      status: 'received',\n      cid,\n      created_at: createdAt,\n      updated_at: createdAt,\n      mentioned_users: [],\n      ...(message.metadata ? { metadata: message.metadata } : {}),\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    } as any\n  }\n\n  const seededMessages = messages.map(toStreamMessage)\n\n  const memberState = {\n    [currentUser.id]: {\n      user: { ...currentUser, is_account: false },\n      user_id: currentUser.id,\n      role: 'owner',\n      is_account: false,\n    },\n    [participant.id]: {\n      user: { ...participant, is_account: true },\n      user_id: participant.id,\n      role: 'member',\n      is_account: true,\n    },\n  }\n\n  const channel = client.channel('messaging', channelId, {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    members: [currentUser.id, participant.id] as any,\n  })\n  // Read/unread bookkeeping consults channel mute status; without a live\n  // connection the real method throws, so report \"not muted\".\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  channel.muteStatus = (() => ({\n    muted: false,\n    createdAt: null,\n    expiresAt: null,\n  })) as any\n\n  // Neutralise the rest of the connection-dependent channel API that\n  // stream-chat-react calls during the chat lifecycle. Each of these POSTs to\n  // Stream or checks for a live WebSocket and would otherwise throw\n  // \"Make sure to await connectUser() first.\" offline. They are fire-and-forget\n  // (read receipts, typing) or read-only (pagination, unread) so no-ops are safe.\n  /* eslint-disable @typescript-eslint/no-explicit-any */\n  channel.markRead = (async () => ({}) as any) as any\n  channel.keystroke = (async () => undefined) as any\n  channel.stopTyping = (async () => undefined) as any\n  channel.sendReaction = (async () => ({}) as any) as any\n  channel.deleteReaction = (async () => ({}) as any) as any\n  channel.countUnread = (() => 0) as any\n  // Pagination: report no older pages so \"load more\" resolves to a no-op.\n  channel.query = (async () => ({ messages: [] }) as any) as any\n  // Leave/Delete Conversation calls channel.hide(); the real method POSTs to\n  // Stream, so no-op it to keep the action working offline.\n  channel.hide = (async () => ({}) as any) as any\n  /* eslint-enable @typescript-eslint/no-explicit-any */\n\n  // Seed state locally instead of fetching. Mirrors the proven ChannelView\n  // story mock: override `watch` to populate `state` and return a canned\n  // QueryChannelAPIResponse. `stream-chat-react` may call `watch()` again on\n  // remount/navigation, so seed only once — otherwise a re-watch would wipe\n  // messages added via `sendMessage` + the send-echo reply, resetting the chat.\n  let hasSeeded = false\n  channel.watch = async () => {\n    if (!hasSeeded) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      channel.state.messages = seededMessages as unknown as any[]\n      hasSeeded = true\n    }\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    channel.state.members = memberState as unknown as any\n    return {\n      channel: { members: [currentUser.id, participant.id] },\n      members: [],\n      messages: channel.state.messages,\n      watchers: [],\n      pinned_messages: [],\n      duration: '0ms',\n    } as unknown as QueryChannelAPIResponse\n  }\n\n  const appendMessage = (message: MessageResponse) => {\n    // addMessageSorted is Stream's own state mutation (dedupes by id), so the\n    // toolkit re-renders through the real channel-state path.\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    channel.state.addMessageSorted(message as any)\n    client.dispatchEvent({\n      type: 'message.new',\n      cid,\n      message,\n      user: message.user ?? undefined,\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    } as any)\n  }\n\n  let sentCount = 0\n  let replyCount = 0\n  channel.sendMessage = async (message) => {\n    const text =\n      typeof message === 'string'\n        ? message\n        : ((message as { text?: string })?.text ?? '')\n    const sent = {\n      ...toStreamMessage(\n        { text, from: 'me', id: `mock-sent-${sentCount++}` },\n        seededMessages.length\n      ),\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      ...(typeof message === 'object' ? (message as any) : {}),\n      user: currentUser,\n      cid,\n    } as MessageResponse\n\n    // stream-chat-react adds the outgoing message optimistically; addMessageSorted\n    // dedupes by id, so confirming here is safe and idempotent.\n    appendMessage(sent)\n\n    const reply = onSend?.(text)\n    if (reply) {\n      const replyText = typeof reply === 'string' ? reply : reply.text\n      const replyAttachments =\n        typeof reply === 'string' ? undefined : reply.attachments\n      // Capture a unique id before scheduling: two sends within REPLY_DELAY_MS\n      // would otherwise both read the same later `sentCount` at fire time and\n      // emit colliding reply ids, so Stream's id-based dedupe drops one echo.\n      const replyId = `mock-reply-${replyCount++}`\n      setTimeout(() => {\n        appendMessage(\n          toStreamMessage(\n            {\n              text: replyText,\n              from: 'them',\n              // eslint-disable-next-line @typescript-eslint/no-explicit-any\n              attachments: replyAttachments as any,\n              id: replyId,\n            },\n            seededMessages.length\n          )\n        )\n      }, REPLY_DELAY_MS)\n    }\n\n    return { message: sent } as unknown as SendMessageAPIResponse\n  }\n\n  // MessagingShell finds the direct conversation via queryChannels; always\n  // return the one seeded channel regardless of the filter.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  client.queryChannels = async () => [channel] as any\n\n  // Initialise state up-front so first render already has the conversation.\n  void channel.watch()\n\n  return { client, channel, participantFilterId: participant.id }\n}\n"],"names":["createMockStreamChatClient","user","stubConnection","client","StreamChat","REPLY_DELAY_MS","createMockMessagingClient","currentUser","participant","messages","channelId","onSend","cid","toStreamMessage","message","index","author","createdAt","seededMessages","memberState","channel","hasSeeded","appendMessage","sentCount","replyCount","text","sent","reply","replyText","replyAttachments","replyId"],"mappings":"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"}
+{"version":3,"file":"testing.cjs","sources":["../src/testing/createMockStreamChatClient.ts","../src/testing/createMockMessagingClient.ts"],"sourcesContent":["import { StreamChat } from 'stream-chat'\n\nimport type { MockMessagingUser } from './createMockMessagingClient'\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\nexport interface CreateMockStreamChatClientOptions {\n  /**\n   * Also replace the connection-dependent client methods (`connectUser`,\n   * `disconnectUser`, `userMuteStatus`) with offline no-ops. Needed when the\n   * client drives a flow that would otherwise open a WebSocket or throw\n   * \"Make sure to await connectUser() first.\" offline. Direct `<Chat client>`\n   * rendering (e.g. component stories) does not need this.\n   */\n  stubConnection?: boolean\n}\n\n/**\n * Builds an offline `StreamChat` for mocks and stories: a real client on a\n * throwaway api key with `userID`/`user` set so `<Chat>` treats it as\n * connected without a backend. The single place that knows how to construct a\n * connectionless Stream client, so a stream-chat version bump only needs\n * updating here rather than in each mock surface.\n */\nexport function createMockStreamChatClient(\n  user: MockMessagingUser,\n  { stubConnection = false }: CreateMockStreamChatClientOptions = {}\n): StreamChat {\n  const client = new StreamChat('mock-api-key', {\n    allowServerSideConnect: true,\n  })\n  client.userID = user.id\n  client.user = user as any\n\n  if (stubConnection) {\n    client.connectUser = async () => ({ me: user }) as any\n    client.disconnectUser = async () => undefined\n    client.userMuteStatus = (() => false) as any\n  }\n\n  return client\n}\n\n/* eslint-enable @typescript-eslint/no-explicit-any */\n","import type {\n  Channel,\n  MessageResponse,\n  QueryChannelAPIResponse,\n  SendMessageAPIResponse,\n} from 'stream-chat'\nimport { StreamChat } from 'stream-chat'\n\nimport { createMockStreamChatClient } from './createMockStreamChatClient'\n\n/** A participant in the mock conversation. */\nexport interface MockMessagingUser {\n  id: string\n  name?: string\n  image?: string\n}\n\n/**\n * A seed message, authored from the viewer's perspective. `from: 'me'` is the\n * connected user (the viewer); `from: 'them'` is the other participant.\n */\nexport interface MockMessage {\n  id?: string\n  text?: string\n  from: 'me' | 'them'\n  /** Stream attachment payloads, rendered by the toolkit's attachment gate. */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  attachments?: any[]\n  /** e.g. `{ custom_type: 'MESSAGE_WELCOME' }`. */\n  metadata?: Record<string, unknown>\n}\n\nexport interface CreateMockMessagingClientOptions {\n  /** The connected/viewing user. */\n  currentUser: MockMessagingUser\n  /** The other party in the direct conversation (e.g. the creator/linker). */\n  participant: MockMessagingUser\n  /** Seed conversation, oldest-first. */\n  messages?: MockMessage[]\n  /** Channel id; defaults to `mock-dm`. */\n  channelId?: string\n  /**\n   * Optional canned reply. Called after the viewer sends a message; return the\n   * reply text (or a partial message) to have `participant` echo a response, or\n   * a falsy value for no reply. Drives the \"send echo\" in `dev:mock-messaging`.\n   */\n  onSend?: (\n    text: string\n  ) => string | { text?: string; attachments?: unknown[] } | null | undefined\n}\n\nexport interface MockMessagingClient {\n  /** Pass to `<MessagingProvider client={...}>`. */\n  client: StreamChat\n  /** The seeded direct-conversation channel. */\n  channel: Channel\n  /** Pass to `<MessagingShell initialParticipantFilter={...}>`. */\n  participantFilterId: string\n}\n\nconst REPLY_DELAY_MS = 600\n\n/**\n * Builds an offline Stream client seeded with a single direct conversation, so\n * consumers can render the **real** messaging UI (MessagingProvider →\n * MessagingShell → ChannelView) without a Stream backend — for `dev:mock-*`\n * surfaces and Storybook. It is a real `StreamChat` whose network calls\n * (`connectUser`, `queryChannels`, `channel.watch`, `channel.sendMessage`) are\n * replaced with in-memory behaviour driven by Stream's own channel-state\n * machinery, so rendering fidelity matches production.\n *\n * Ships from `@linktr.ee/messaging-react/testing` and must never be imported by\n * production code.\n */\nexport function createMockMessagingClient({\n  currentUser,\n  participant,\n  messages = [],\n  channelId = 'mock-dm',\n  onSend,\n}: CreateMockMessagingClientOptions): MockMessagingClient {\n  // Offline client marked connected without a WebSocket. `stubConnection` also\n  // no-ops connectUser/disconnectUser/userMuteStatus: `MessagingProvider`\n  // renders `<Chat client={client}>` directly so it never calls connectUser,\n  // and handling the `message.new` events dispatched on send + echo below runs\n  // Channel._countMessageAsUnread → client.userMuteStatus, which throws offline.\n  const client = createMockStreamChatClient(currentUser, {\n    stubConnection: true,\n  })\n\n  const cid = `messaging:${channelId}`\n\n  const toStreamMessage = (\n    message: MockMessage,\n    index: number\n  ): MessageResponse => {\n    const author = message.from === 'me' ? currentUser : participant\n    // Stagger timestamps oldest-first so the list orders naturally. Must be a\n    // Date, not an ISO string: we seed `channel.state.messages` directly\n    // (bypassing Stream's wire→Date parsing), and stream-chat-react calls\n    // `.getTime()` on `created_at` (e.g. useCooldownTimer / addToMessageList).\n    const createdAt = new Date(Date.now() - (messages.length - index) * 60_000)\n    return {\n      id: message.id ?? `mock-msg-${index}`,\n      text: message.text ?? '',\n      type: 'regular',\n      html: message.text ? `<p>${message.text}</p>` : '',\n      user: author,\n      attachments: message.attachments ?? [],\n      latest_reactions: [],\n      own_reactions: [],\n      reaction_counts: {},\n      reaction_scores: {},\n      reply_count: 0,\n      status: 'received',\n      cid,\n      created_at: createdAt,\n      updated_at: createdAt,\n      mentioned_users: [],\n      ...(message.metadata ? { metadata: message.metadata } : {}),\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    } as any\n  }\n\n  const seededMessages = messages.map(toStreamMessage)\n\n  const memberState = {\n    [currentUser.id]: {\n      user: { ...currentUser, is_account: false },\n      user_id: currentUser.id,\n      role: 'owner',\n      is_account: false,\n    },\n    [participant.id]: {\n      user: { ...participant, is_account: true },\n      user_id: participant.id,\n      role: 'member',\n      is_account: true,\n    },\n  }\n\n  const channel = client.channel('messaging', channelId, {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    members: [currentUser.id, participant.id] as any,\n  })\n  // Read/unread bookkeeping consults channel mute status; without a live\n  // connection the real method throws, so report \"not muted\".\n  channel.muteStatus = (() => ({\n    muted: false,\n    createdAt: null,\n    expiresAt: null,\n  })) as any\n\n  // Neutralise the rest of the connection-dependent channel API that\n  // stream-chat-react calls during the chat lifecycle. Each of these POSTs to\n  // Stream or checks for a live WebSocket and would otherwise throw\n  // \"Make sure to await connectUser() first.\" offline. They are fire-and-forget\n  // (read receipts, typing) or read-only (pagination, unread) so no-ops are safe.\n  /* eslint-disable @typescript-eslint/no-explicit-any */\n  channel.markRead = (async () => ({}) as any) as any\n  channel.keystroke = (async () => undefined) as any\n  channel.stopTyping = (async () => undefined) as any\n  channel.sendReaction = (async () => ({}) as any) as any\n  channel.deleteReaction = (async () => ({}) as any) as any\n  channel.countUnread = (() => 0) as any\n  // Pagination: report no older pages so \"load more\" resolves to a no-op.\n  channel.query = (async () => ({ messages: [] }) as any) as any\n  // Leave/Delete Conversation calls channel.hide(); the real method POSTs to\n  // Stream, so no-op it to keep the action working offline.\n  channel.hide = (async () => ({}) as any) as any\n  /* eslint-enable @typescript-eslint/no-explicit-any */\n\n  // Seed state locally instead of fetching. Mirrors the proven ChannelView\n  // story mock: override `watch` to populate `state` and return a canned\n  // QueryChannelAPIResponse. `stream-chat-react` may call `watch()` again on\n  // remount/navigation, so seed only once — otherwise a re-watch would wipe\n  // messages added via `sendMessage` + the send-echo reply, resetting the chat.\n  let hasSeeded = false\n  channel.watch = async () => {\n    if (!hasSeeded) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      channel.state.messages = seededMessages as unknown as any[]\n      hasSeeded = true\n    }\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    channel.state.members = memberState as unknown as any\n    return {\n      channel: { members: [currentUser.id, participant.id] },\n      members: [],\n      messages: channel.state.messages,\n      watchers: [],\n      pinned_messages: [],\n      duration: '0ms',\n    } as unknown as QueryChannelAPIResponse\n  }\n\n  const appendMessage = (message: MessageResponse) => {\n    // addMessageSorted is Stream's own state mutation (dedupes by id), so the\n    // toolkit re-renders through the real channel-state path.\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    channel.state.addMessageSorted(message as any)\n    client.dispatchEvent({\n      type: 'message.new',\n      cid,\n      message,\n      user: message.user ?? undefined,\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    } as any)\n  }\n\n  let sentCount = 0\n  let replyCount = 0\n  channel.sendMessage = async (message) => {\n    const text =\n      typeof message === 'string'\n        ? message\n        : ((message as { text?: string })?.text ?? '')\n    const sent = {\n      ...toStreamMessage(\n        { text, from: 'me', id: `mock-sent-${sentCount++}` },\n        seededMessages.length\n      ),\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      ...(typeof message === 'object' ? (message as any) : {}),\n      user: currentUser,\n      cid,\n    } as MessageResponse\n\n    // stream-chat-react adds the outgoing message optimistically; addMessageSorted\n    // dedupes by id, so confirming here is safe and idempotent.\n    appendMessage(sent)\n\n    const reply = onSend?.(text)\n    if (reply) {\n      const replyText = typeof reply === 'string' ? reply : reply.text\n      const replyAttachments =\n        typeof reply === 'string' ? undefined : reply.attachments\n      // Capture a unique id before scheduling: two sends within REPLY_DELAY_MS\n      // would otherwise both read the same later `sentCount` at fire time and\n      // emit colliding reply ids, so Stream's id-based dedupe drops one echo.\n      const replyId = `mock-reply-${replyCount++}`\n      setTimeout(() => {\n        appendMessage(\n          toStreamMessage(\n            {\n              text: replyText,\n              from: 'them',\n              // eslint-disable-next-line @typescript-eslint/no-explicit-any\n              attachments: replyAttachments as any,\n              id: replyId,\n            },\n            seededMessages.length\n          )\n        )\n      }, REPLY_DELAY_MS)\n    }\n\n    return { message: sent } as unknown as SendMessageAPIResponse\n  }\n\n  // MessagingShell finds the direct conversation via queryChannels; always\n  // return the one seeded channel regardless of the filter.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  client.queryChannels = async () => [channel] as any\n\n  // Initialise state up-front so first render already has the conversation.\n  void channel.watch()\n\n  return { client, channel, participantFilterId: participant.id }\n}\n"],"names":["createMockStreamChatClient","user","stubConnection","client","StreamChat","REPLY_DELAY_MS","createMockMessagingClient","currentUser","participant","messages","channelId","onSend","cid","toStreamMessage","message","index","author","createdAt","seededMessages","memberState","channel","hasSeeded","appendMessage","sentCount","replyCount","text","sent","reply","replyText","replyAttachments","replyId"],"mappings":"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"}

package/dist/testing.d.ts

@@ -1,8 +1,7 @@
 import { Channel } from 'stream-chat';
+import { MessageCustomType } from '@linktr.ee/messaging-taxonomy';
 import { StreamChat } from 'stream-chat';
 
-declare type AgeSafetySystemType = 'SYSTEM_AGE_SAFETY_BLOCKED';
-
 /**
  * Builds an offline Stream client seeded with a single direct conversation, so
  * consumers can render the **real** messaging UI (MessagingProvider →
@@ -37,12 +36,6 @@ export declare interface CreateMockMessagingClientOptions {
     } | null | undefined;
 }
 
-declare type DmAgentSystemType = 'SYSTEM_DM_AGENT_PAUSED' | 'SYSTEM_DM_AGENT_RESUMED';
-
-declare type EscalationSystemType = 'SYSTEM_ESCALATION';
-
-declare type MessageCustomType = 'MESSAGE_TIP' | 'MESSAGE_PAID' | 'MESSAGE_CHATBOT' | 'MESSAGE_ATTACHMENT' | AgeSafetySystemType | EscalationSystemType | DmAgentSystemType;
-
 export declare interface MessageMetadata {
     custom_type?: MessageCustomType;
     listing_id?: string;

package/dist/testing.js.map

@@ -1 +1 @@
-{"version":3,"file":"testing.js","sources":["../src/testing/createMockStreamChatClient.ts","../src/testing/createMockMessagingClient.ts"],"sourcesContent":["import { StreamChat } from 'stream-chat'\n\nimport type { MockMessagingUser } from './createMockMessagingClient'\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\nexport interface CreateMockStreamChatClientOptions {\n  /**\n   * Also replace the connection-dependent client methods (`connectUser`,\n   * `disconnectUser`, `userMuteStatus`) with offline no-ops. Needed when the\n   * client drives a flow that would otherwise open a WebSocket or throw\n   * \"Make sure to await connectUser() first.\" offline. Direct `<Chat client>`\n   * rendering (e.g. component stories) does not need this.\n   */\n  stubConnection?: boolean\n}\n\n/**\n * Builds an offline `StreamChat` for mocks and stories: a real client on a\n * throwaway api key with `userID`/`user` set so `<Chat>` treats it as\n * connected without a backend. The single place that knows how to construct a\n * connectionless Stream client, so a stream-chat version bump only needs\n * updating here rather than in each mock surface.\n */\nexport function createMockStreamChatClient(\n  user: MockMessagingUser,\n  { stubConnection = false }: CreateMockStreamChatClientOptions = {}\n): StreamChat {\n  const client = new StreamChat('mock-api-key', {\n    allowServerSideConnect: true,\n  })\n  client.userID = user.id\n  client.user = user as any\n\n  if (stubConnection) {\n    client.connectUser = async () => ({ me: user }) as any\n    client.disconnectUser = async () => undefined\n    client.userMuteStatus = (() => false) as any\n  }\n\n  return client\n}\n\n/* eslint-enable @typescript-eslint/no-explicit-any */\n","import type {\n  Channel,\n  MessageResponse,\n  QueryChannelAPIResponse,\n  SendMessageAPIResponse,\n} from 'stream-chat'\nimport { StreamChat } from 'stream-chat'\n\nimport { createMockStreamChatClient } from './createMockStreamChatClient'\n\n/** A participant in the mock conversation. */\nexport interface MockMessagingUser {\n  id: string\n  name?: string\n  image?: string\n}\n\n/**\n * A seed message, authored from the viewer's perspective. `from: 'me'` is the\n * connected user (the viewer); `from: 'them'` is the other participant.\n */\nexport interface MockMessage {\n  id?: string\n  text?: string\n  from: 'me' | 'them'\n  /** Stream attachment payloads, rendered by the toolkit's attachment gate. */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  attachments?: any[]\n  /** e.g. `{ custom_type: 'MESSAGE_WELCOME' }`. */\n  metadata?: Record<string, unknown>\n}\n\nexport interface CreateMockMessagingClientOptions {\n  /** The connected/viewing user. */\n  currentUser: MockMessagingUser\n  /** The other party in the direct conversation (e.g. the creator/linker). */\n  participant: MockMessagingUser\n  /** Seed conversation, oldest-first. */\n  messages?: MockMessage[]\n  /** Channel id; defaults to `mock-dm`. */\n  channelId?: string\n  /**\n   * Optional canned reply. Called after the viewer sends a message; return the\n   * reply text (or a partial message) to have `participant` echo a response, or\n   * a falsy value for no reply. Drives the \"send echo\" in `dev:mock-messaging`.\n   */\n  onSend?: (\n    text: string\n  ) => string | { text?: string; attachments?: unknown[] } | null | undefined\n}\n\nexport interface MockMessagingClient {\n  /** Pass to `<MessagingProvider client={...}>`. */\n  client: StreamChat\n  /** The seeded direct-conversation channel. */\n  channel: Channel\n  /** Pass to `<MessagingShell initialParticipantFilter={...}>`. */\n  participantFilterId: string\n}\n\nconst REPLY_DELAY_MS = 600\n\n/**\n * Builds an offline Stream client seeded with a single direct conversation, so\n * consumers can render the **real** messaging UI (MessagingProvider →\n * MessagingShell → ChannelView) without a Stream backend — for `dev:mock-*`\n * surfaces and Storybook. It is a real `StreamChat` whose network calls\n * (`connectUser`, `queryChannels`, `channel.watch`, `channel.sendMessage`) are\n * replaced with in-memory behaviour driven by Stream's own channel-state\n * machinery, so rendering fidelity matches production.\n *\n * Ships from `@linktr.ee/messaging-react/testing` and must never be imported by\n * production code.\n */\nexport function createMockMessagingClient({\n  currentUser,\n  participant,\n  messages = [],\n  channelId = 'mock-dm',\n  onSend,\n}: CreateMockMessagingClientOptions): MockMessagingClient {\n  // Offline client marked connected without a WebSocket. `stubConnection` also\n  // no-ops connectUser/disconnectUser/userMuteStatus: `MessagingProvider`\n  // renders `<Chat client={client}>` directly so it never calls connectUser,\n  // and handling the `message.new` events dispatched on send + echo below runs\n  // Channel._countMessageAsUnread → client.userMuteStatus, which throws offline.\n  const client = createMockStreamChatClient(currentUser, {\n    stubConnection: true,\n  })\n\n  const cid = `messaging:${channelId}`\n\n  const toStreamMessage = (\n    message: MockMessage,\n    index: number\n  ): MessageResponse => {\n    const author = message.from === 'me' ? currentUser : participant\n    // Stagger timestamps oldest-first so the list orders naturally. Must be a\n    // Date, not an ISO string: we seed `channel.state.messages` directly\n    // (bypassing Stream's wire→Date parsing), and stream-chat-react calls\n    // `.getTime()` on `created_at` (e.g. useCooldownTimer / addToMessageList).\n    const createdAt = new Date(Date.now() - (messages.length - index) * 60_000)\n    return {\n      id: message.id ?? `mock-msg-${index}`,\n      text: message.text ?? '',\n      type: 'regular',\n      html: message.text ? `<p>${message.text}</p>` : '',\n      user: author,\n      attachments: message.attachments ?? [],\n      latest_reactions: [],\n      own_reactions: [],\n      reaction_counts: {},\n      reaction_scores: {},\n      reply_count: 0,\n      status: 'received',\n      cid,\n      created_at: createdAt,\n      updated_at: createdAt,\n      mentioned_users: [],\n      ...(message.metadata ? { metadata: message.metadata } : {}),\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    } as any\n  }\n\n  const seededMessages = messages.map(toStreamMessage)\n\n  const memberState = {\n    [currentUser.id]: {\n      user: { ...currentUser, is_account: false },\n      user_id: currentUser.id,\n      role: 'owner',\n      is_account: false,\n    },\n    [participant.id]: {\n      user: { ...participant, is_account: true },\n      user_id: participant.id,\n      role: 'member',\n      is_account: true,\n    },\n  }\n\n  const channel = client.channel('messaging', channelId, {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    members: [currentUser.id, participant.id] as any,\n  })\n  // Read/unread bookkeeping consults channel mute status; without a live\n  // connection the real method throws, so report \"not muted\".\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  channel.muteStatus = (() => ({\n    muted: false,\n    createdAt: null,\n    expiresAt: null,\n  })) as any\n\n  // Neutralise the rest of the connection-dependent channel API that\n  // stream-chat-react calls during the chat lifecycle. Each of these POSTs to\n  // Stream or checks for a live WebSocket and would otherwise throw\n  // \"Make sure to await connectUser() first.\" offline. They are fire-and-forget\n  // (read receipts, typing) or read-only (pagination, unread) so no-ops are safe.\n  /* eslint-disable @typescript-eslint/no-explicit-any */\n  channel.markRead = (async () => ({}) as any) as any\n  channel.keystroke = (async () => undefined) as any\n  channel.stopTyping = (async () => undefined) as any\n  channel.sendReaction = (async () => ({}) as any) as any\n  channel.deleteReaction = (async () => ({}) as any) as any\n  channel.countUnread = (() => 0) as any\n  // Pagination: report no older pages so \"load more\" resolves to a no-op.\n  channel.query = (async () => ({ messages: [] }) as any) as any\n  // Leave/Delete Conversation calls channel.hide(); the real method POSTs to\n  // Stream, so no-op it to keep the action working offline.\n  channel.hide = (async () => ({}) as any) as any\n  /* eslint-enable @typescript-eslint/no-explicit-any */\n\n  // Seed state locally instead of fetching. Mirrors the proven ChannelView\n  // story mock: override `watch` to populate `state` and return a canned\n  // QueryChannelAPIResponse. `stream-chat-react` may call `watch()` again on\n  // remount/navigation, so seed only once — otherwise a re-watch would wipe\n  // messages added via `sendMessage` + the send-echo reply, resetting the chat.\n  let hasSeeded = false\n  channel.watch = async () => {\n    if (!hasSeeded) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      channel.state.messages = seededMessages as unknown as any[]\n      hasSeeded = true\n    }\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    channel.state.members = memberState as unknown as any\n    return {\n      channel: { members: [currentUser.id, participant.id] },\n      members: [],\n      messages: channel.state.messages,\n      watchers: [],\n      pinned_messages: [],\n      duration: '0ms',\n    } as unknown as QueryChannelAPIResponse\n  }\n\n  const appendMessage = (message: MessageResponse) => {\n    // addMessageSorted is Stream's own state mutation (dedupes by id), so the\n    // toolkit re-renders through the real channel-state path.\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    channel.state.addMessageSorted(message as any)\n    client.dispatchEvent({\n      type: 'message.new',\n      cid,\n      message,\n      user: message.user ?? undefined,\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    } as any)\n  }\n\n  let sentCount = 0\n  let replyCount = 0\n  channel.sendMessage = async (message) => {\n    const text =\n      typeof message === 'string'\n        ? message\n        : ((message as { text?: string })?.text ?? '')\n    const sent = {\n      ...toStreamMessage(\n        { text, from: 'me', id: `mock-sent-${sentCount++}` },\n        seededMessages.length\n      ),\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      ...(typeof message === 'object' ? (message as any) : {}),\n      user: currentUser,\n      cid,\n    } as MessageResponse\n\n    // stream-chat-react adds the outgoing message optimistically; addMessageSorted\n    // dedupes by id, so confirming here is safe and idempotent.\n    appendMessage(sent)\n\n    const reply = onSend?.(text)\n    if (reply) {\n      const replyText = typeof reply === 'string' ? reply : reply.text\n      const replyAttachments =\n        typeof reply === 'string' ? undefined : reply.attachments\n      // Capture a unique id before scheduling: two sends within REPLY_DELAY_MS\n      // would otherwise both read the same later `sentCount` at fire time and\n      // emit colliding reply ids, so Stream's id-based dedupe drops one echo.\n      const replyId = `mock-reply-${replyCount++}`\n      setTimeout(() => {\n        appendMessage(\n          toStreamMessage(\n            {\n              text: replyText,\n              from: 'them',\n              // eslint-disable-next-line @typescript-eslint/no-explicit-any\n              attachments: replyAttachments as any,\n              id: replyId,\n            },\n            seededMessages.length\n          )\n        )\n      }, REPLY_DELAY_MS)\n    }\n\n    return { message: sent } as unknown as SendMessageAPIResponse\n  }\n\n  // MessagingShell finds the direct conversation via queryChannels; always\n  // return the one seeded channel regardless of the filter.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  client.queryChannels = async () => [channel] as any\n\n  // Initialise state up-front so first render already has the conversation.\n  void channel.watch()\n\n  return { client, channel, participantFilterId: participant.id }\n}\n"],"names":["createMockStreamChatClient","user","stubConnection","client","StreamChat","REPLY_DELAY_MS","createMockMessagingClient","currentUser","participant","messages","channelId","onSend","cid","toStreamMessage","message","index","author","createdAt","seededMessages","memberState","channel","hasSeeded","appendMessage","sentCount","replyCount","text","sent","reply","replyText","replyAttachments","replyId"],"mappings":"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"}
+{"version":3,"file":"testing.js","sources":["../src/testing/createMockStreamChatClient.ts","../src/testing/createMockMessagingClient.ts"],"sourcesContent":["import { StreamChat } from 'stream-chat'\n\nimport type { MockMessagingUser } from './createMockMessagingClient'\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\nexport interface CreateMockStreamChatClientOptions {\n  /**\n   * Also replace the connection-dependent client methods (`connectUser`,\n   * `disconnectUser`, `userMuteStatus`) with offline no-ops. Needed when the\n   * client drives a flow that would otherwise open a WebSocket or throw\n   * \"Make sure to await connectUser() first.\" offline. Direct `<Chat client>`\n   * rendering (e.g. component stories) does not need this.\n   */\n  stubConnection?: boolean\n}\n\n/**\n * Builds an offline `StreamChat` for mocks and stories: a real client on a\n * throwaway api key with `userID`/`user` set so `<Chat>` treats it as\n * connected without a backend. The single place that knows how to construct a\n * connectionless Stream client, so a stream-chat version bump only needs\n * updating here rather than in each mock surface.\n */\nexport function createMockStreamChatClient(\n  user: MockMessagingUser,\n  { stubConnection = false }: CreateMockStreamChatClientOptions = {}\n): StreamChat {\n  const client = new StreamChat('mock-api-key', {\n    allowServerSideConnect: true,\n  })\n  client.userID = user.id\n  client.user = user as any\n\n  if (stubConnection) {\n    client.connectUser = async () => ({ me: user }) as any\n    client.disconnectUser = async () => undefined\n    client.userMuteStatus = (() => false) as any\n  }\n\n  return client\n}\n\n/* eslint-enable @typescript-eslint/no-explicit-any */\n","import type {\n  Channel,\n  MessageResponse,\n  QueryChannelAPIResponse,\n  SendMessageAPIResponse,\n} from 'stream-chat'\nimport { StreamChat } from 'stream-chat'\n\nimport { createMockStreamChatClient } from './createMockStreamChatClient'\n\n/** A participant in the mock conversation. */\nexport interface MockMessagingUser {\n  id: string\n  name?: string\n  image?: string\n}\n\n/**\n * A seed message, authored from the viewer's perspective. `from: 'me'` is the\n * connected user (the viewer); `from: 'them'` is the other participant.\n */\nexport interface MockMessage {\n  id?: string\n  text?: string\n  from: 'me' | 'them'\n  /** Stream attachment payloads, rendered by the toolkit's attachment gate. */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  attachments?: any[]\n  /** e.g. `{ custom_type: 'MESSAGE_WELCOME' }`. */\n  metadata?: Record<string, unknown>\n}\n\nexport interface CreateMockMessagingClientOptions {\n  /** The connected/viewing user. */\n  currentUser: MockMessagingUser\n  /** The other party in the direct conversation (e.g. the creator/linker). */\n  participant: MockMessagingUser\n  /** Seed conversation, oldest-first. */\n  messages?: MockMessage[]\n  /** Channel id; defaults to `mock-dm`. */\n  channelId?: string\n  /**\n   * Optional canned reply. Called after the viewer sends a message; return the\n   * reply text (or a partial message) to have `participant` echo a response, or\n   * a falsy value for no reply. Drives the \"send echo\" in `dev:mock-messaging`.\n   */\n  onSend?: (\n    text: string\n  ) => string | { text?: string; attachments?: unknown[] } | null | undefined\n}\n\nexport interface MockMessagingClient {\n  /** Pass to `<MessagingProvider client={...}>`. */\n  client: StreamChat\n  /** The seeded direct-conversation channel. */\n  channel: Channel\n  /** Pass to `<MessagingShell initialParticipantFilter={...}>`. */\n  participantFilterId: string\n}\n\nconst REPLY_DELAY_MS = 600\n\n/**\n * Builds an offline Stream client seeded with a single direct conversation, so\n * consumers can render the **real** messaging UI (MessagingProvider →\n * MessagingShell → ChannelView) without a Stream backend — for `dev:mock-*`\n * surfaces and Storybook. It is a real `StreamChat` whose network calls\n * (`connectUser`, `queryChannels`, `channel.watch`, `channel.sendMessage`) are\n * replaced with in-memory behaviour driven by Stream's own channel-state\n * machinery, so rendering fidelity matches production.\n *\n * Ships from `@linktr.ee/messaging-react/testing` and must never be imported by\n * production code.\n */\nexport function createMockMessagingClient({\n  currentUser,\n  participant,\n  messages = [],\n  channelId = 'mock-dm',\n  onSend,\n}: CreateMockMessagingClientOptions): MockMessagingClient {\n  // Offline client marked connected without a WebSocket. `stubConnection` also\n  // no-ops connectUser/disconnectUser/userMuteStatus: `MessagingProvider`\n  // renders `<Chat client={client}>` directly so it never calls connectUser,\n  // and handling the `message.new` events dispatched on send + echo below runs\n  // Channel._countMessageAsUnread → client.userMuteStatus, which throws offline.\n  const client = createMockStreamChatClient(currentUser, {\n    stubConnection: true,\n  })\n\n  const cid = `messaging:${channelId}`\n\n  const toStreamMessage = (\n    message: MockMessage,\n    index: number\n  ): MessageResponse => {\n    const author = message.from === 'me' ? currentUser : participant\n    // Stagger timestamps oldest-first so the list orders naturally. Must be a\n    // Date, not an ISO string: we seed `channel.state.messages` directly\n    // (bypassing Stream's wire→Date parsing), and stream-chat-react calls\n    // `.getTime()` on `created_at` (e.g. useCooldownTimer / addToMessageList).\n    const createdAt = new Date(Date.now() - (messages.length - index) * 60_000)\n    return {\n      id: message.id ?? `mock-msg-${index}`,\n      text: message.text ?? '',\n      type: 'regular',\n      html: message.text ? `<p>${message.text}</p>` : '',\n      user: author,\n      attachments: message.attachments ?? [],\n      latest_reactions: [],\n      own_reactions: [],\n      reaction_counts: {},\n      reaction_scores: {},\n      reply_count: 0,\n      status: 'received',\n      cid,\n      created_at: createdAt,\n      updated_at: createdAt,\n      mentioned_users: [],\n      ...(message.metadata ? { metadata: message.metadata } : {}),\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    } as any\n  }\n\n  const seededMessages = messages.map(toStreamMessage)\n\n  const memberState = {\n    [currentUser.id]: {\n      user: { ...currentUser, is_account: false },\n      user_id: currentUser.id,\n      role: 'owner',\n      is_account: false,\n    },\n    [participant.id]: {\n      user: { ...participant, is_account: true },\n      user_id: participant.id,\n      role: 'member',\n      is_account: true,\n    },\n  }\n\n  const channel = client.channel('messaging', channelId, {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    members: [currentUser.id, participant.id] as any,\n  })\n  // Read/unread bookkeeping consults channel mute status; without a live\n  // connection the real method throws, so report \"not muted\".\n  channel.muteStatus = (() => ({\n    muted: false,\n    createdAt: null,\n    expiresAt: null,\n  })) as any\n\n  // Neutralise the rest of the connection-dependent channel API that\n  // stream-chat-react calls during the chat lifecycle. Each of these POSTs to\n  // Stream or checks for a live WebSocket and would otherwise throw\n  // \"Make sure to await connectUser() first.\" offline. They are fire-and-forget\n  // (read receipts, typing) or read-only (pagination, unread) so no-ops are safe.\n  /* eslint-disable @typescript-eslint/no-explicit-any */\n  channel.markRead = (async () => ({}) as any) as any\n  channel.keystroke = (async () => undefined) as any\n  channel.stopTyping = (async () => undefined) as any\n  channel.sendReaction = (async () => ({}) as any) as any\n  channel.deleteReaction = (async () => ({}) as any) as any\n  channel.countUnread = (() => 0) as any\n  // Pagination: report no older pages so \"load more\" resolves to a no-op.\n  channel.query = (async () => ({ messages: [] }) as any) as any\n  // Leave/Delete Conversation calls channel.hide(); the real method POSTs to\n  // Stream, so no-op it to keep the action working offline.\n  channel.hide = (async () => ({}) as any) as any\n  /* eslint-enable @typescript-eslint/no-explicit-any */\n\n  // Seed state locally instead of fetching. Mirrors the proven ChannelView\n  // story mock: override `watch` to populate `state` and return a canned\n  // QueryChannelAPIResponse. `stream-chat-react` may call `watch()` again on\n  // remount/navigation, so seed only once — otherwise a re-watch would wipe\n  // messages added via `sendMessage` + the send-echo reply, resetting the chat.\n  let hasSeeded = false\n  channel.watch = async () => {\n    if (!hasSeeded) {\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      channel.state.messages = seededMessages as unknown as any[]\n      hasSeeded = true\n    }\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    channel.state.members = memberState as unknown as any\n    return {\n      channel: { members: [currentUser.id, participant.id] },\n      members: [],\n      messages: channel.state.messages,\n      watchers: [],\n      pinned_messages: [],\n      duration: '0ms',\n    } as unknown as QueryChannelAPIResponse\n  }\n\n  const appendMessage = (message: MessageResponse) => {\n    // addMessageSorted is Stream's own state mutation (dedupes by id), so the\n    // toolkit re-renders through the real channel-state path.\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    channel.state.addMessageSorted(message as any)\n    client.dispatchEvent({\n      type: 'message.new',\n      cid,\n      message,\n      user: message.user ?? undefined,\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    } as any)\n  }\n\n  let sentCount = 0\n  let replyCount = 0\n  channel.sendMessage = async (message) => {\n    const text =\n      typeof message === 'string'\n        ? message\n        : ((message as { text?: string })?.text ?? '')\n    const sent = {\n      ...toStreamMessage(\n        { text, from: 'me', id: `mock-sent-${sentCount++}` },\n        seededMessages.length\n      ),\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      ...(typeof message === 'object' ? (message as any) : {}),\n      user: currentUser,\n      cid,\n    } as MessageResponse\n\n    // stream-chat-react adds the outgoing message optimistically; addMessageSorted\n    // dedupes by id, so confirming here is safe and idempotent.\n    appendMessage(sent)\n\n    const reply = onSend?.(text)\n    if (reply) {\n      const replyText = typeof reply === 'string' ? reply : reply.text\n      const replyAttachments =\n        typeof reply === 'string' ? undefined : reply.attachments\n      // Capture a unique id before scheduling: two sends within REPLY_DELAY_MS\n      // would otherwise both read the same later `sentCount` at fire time and\n      // emit colliding reply ids, so Stream's id-based dedupe drops one echo.\n      const replyId = `mock-reply-${replyCount++}`\n      setTimeout(() => {\n        appendMessage(\n          toStreamMessage(\n            {\n              text: replyText,\n              from: 'them',\n              // eslint-disable-next-line @typescript-eslint/no-explicit-any\n              attachments: replyAttachments as any,\n              id: replyId,\n            },\n            seededMessages.length\n          )\n        )\n      }, REPLY_DELAY_MS)\n    }\n\n    return { message: sent } as unknown as SendMessageAPIResponse\n  }\n\n  // MessagingShell finds the direct conversation via queryChannels; always\n  // return the one seeded channel regardless of the filter.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  client.queryChannels = async () => [channel] as any\n\n  // Initialise state up-front so first render already has the conversation.\n  void channel.watch()\n\n  return { client, channel, participantFilterId: participant.id }\n}\n"],"names":["createMockStreamChatClient","user","stubConnection","client","StreamChat","REPLY_DELAY_MS","createMockMessagingClient","currentUser","participant","messages","channelId","onSend","cid","toStreamMessage","message","index","author","createdAt","seededMessages","memberState","channel","hasSeeded","appendMessage","sentCount","replyCount","text","sent","reply","replyText","replyAttachments","replyId"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linktr.ee/messaging-react",
-  "version": "3.18.0",
+  "version": "3.19.0-rc-1785393579",
   "description": "React messaging components built on messaging-core for web applications",
   "type": "module",
   "main": "dist/index.cjs",
@@ -40,8 +40,8 @@
     "test:ci": "vitest run",
     "test:ui": "vitest --ui",
     "test:coverage": "vitest --coverage",
-    "lint": "npx --no-install eslint . --ext .ts,.tsx",
-    "lint:fix": "npx --no-install eslint . --ext .ts,.tsx --fix",
+    "lint": "npx --no-install eslint .",
+    "lint:fix": "npx --no-install eslint . --fix",
     "verify": "yarn type-check && yarn lint && yarn test:ci && yarn build",
     "storybook": "storybook dev -p 6006",
     "storybook:build": "storybook build --stats-json",
@@ -50,7 +50,8 @@
   },
   "dependencies": {
     "@linktr.ee/component-library": "11.8.6",
-    "@linktr.ee/messaging-core": "^2.2.0",
+    "@linktr.ee/messaging-core": "2.3.0-rc-1785393579",
+    "@linktr.ee/messaging-taxonomy": "^0.1.0",
     "@phosphor-icons/react": "^2.1.10"
   },
   "devDependencies": {

package/src/components/ChannelList/CustomChannelPreview.tsx

@@ -1,3 +1,4 @@
+import { MESSAGE_CUSTOM_TYPE } from '@linktr.ee/messaging-taxonomy'
 import classNames from 'classnames'
 import React from 'react'
 import {
@@ -91,13 +92,13 @@ const CustomChannelPreview = React.memo<ChannelPreviewUIComponentProps>(
       const { custom_type, attachment_content_type } =
         lastMessage?.metadata || {}
 
-      if (custom_type === 'MESSAGE_TIP') {
+      if (custom_type === MESSAGE_CUSTOM_TYPE.TIP) {
         return displayText ? displayText : 'Sent a tip'
       }
-      if (custom_type === 'MESSAGE_PAID') {
+      if (custom_type === MESSAGE_CUSTOM_TYPE.PAID) {
         return displayText ? displayText : 'Sent a message'
       }
-      if (custom_type === 'MESSAGE_ATTACHMENT') {
+      if (custom_type === MESSAGE_CUSTOM_TYPE.ATTACHMENT) {
         if (attachment_content_type === 'text') {
           return '🔒 Sent a locked message'
         }

package/src/components/ChannelView.stories.tsx

@@ -201,7 +201,7 @@ const createMockChannel = async (
   // Initialize the channel
   try {
     await channel.watch()
-  } catch (e) {
+  } catch {
     // Ignore errors - we're in mock mode
   }
 
@@ -358,7 +358,6 @@ ParticipantIdentityTrigger.args = {
   channelCustomerTag: 'CUSTOMER_PAID',
   hasScrollableMessages: true,
   onParticipantNameClick: () =>
-    // eslint-disable-next-line no-alert
     window.alert('Participant details clicked — open Thread content'),
 }
 ParticipantIdentityTrigger.parameters = {

package/src/components/CustomMessage/CustomMessageActions.tsx

@@ -1,3 +1,4 @@
+import { MESSAGE_CUSTOM_TYPE } from '@linktr.ee/messaging-taxonomy'
 import { FlagIcon, TrashSimpleIcon } from '@phosphor-icons/react'
 import React from 'react'
 import { useMessageContext } from 'stream-chat-react'
@@ -37,7 +38,8 @@ const ReportAction = () => {
 
 export const CustomMessageActions = () => {
   const { message } = useMessageContext('CustomMessageActions')
-  if (message.metadata?.custom_type !== 'MESSAGE_ATTACHMENT') return null
+  if (message.metadata?.custom_type !== MESSAGE_CUSTOM_TYPE.ATTACHMENT)
+    return null
   return (
     <MessageActions
       messageActionSet={[

package/src/components/CustomMessage/LockedAttachment/components/_shared/useReceivedSource.ts

@@ -1,3 +1,6 @@
+/* eslint-disable react-hooks/refs -- pre-existing pattern flagged by the React
+   Compiler rules added in eslint-plugin-react-hooks v7; refactoring it is
+   out of scope for the lint toolchain upgrade. */
 import { useCallback, useEffect, useRef, useState } from 'react'
 
 import type {

package/src/components/CustomMessage/MessageTag.tsx

@@ -1,3 +1,4 @@
+import { MESSAGE_CUSTOM_TYPE } from '@linktr.ee/messaging-taxonomy'
 import { GiftIcon } from '@phosphor-icons/react'
 import { LocalMessage } from 'stream-chat'
 
@@ -29,22 +30,22 @@ const SparkleIcon = ({ size = 15 }: { size?: number }) => (
 
 /** Check if a message is a tip based on metadata */
 export const isTipMessage = (message: LocalMessage): boolean => {
-  return message.metadata?.custom_type === 'MESSAGE_TIP'
+  return message.metadata?.custom_type === MESSAGE_CUSTOM_TYPE.TIP
 }
 
 /** Check if a message is a paid message based on metadata */
 export const isPaidMessage = (message: LocalMessage): boolean => {
-  return message.metadata?.custom_type === 'MESSAGE_PAID'
+  return message.metadata?.custom_type === MESSAGE_CUSTOM_TYPE.PAID
 }
 
 /** Check if a message is a chatbot message based on metadata */
 export const isChatbotMessage = (message: LocalMessage): boolean => {
-  return message.metadata?.custom_type === 'MESSAGE_CHATBOT'
+  return message.metadata?.custom_type === MESSAGE_CUSTOM_TYPE.CHATBOT
 }
 
 /** Check if a message is a locked attachment */
 export const isAttachmentMessage = (message: LocalMessage): boolean => {
-  return message.metadata?.custom_type === 'MESSAGE_ATTACHMENT'
+  return message.metadata?.custom_type === MESSAGE_CUSTOM_TYPE.ATTACHMENT
 }
 
 export const isTextAttachmentMessage = (message: LocalMessage): boolean => {

package/src/components/CustomMessage/index.tsx

@@ -278,7 +278,6 @@ const CustomMessageWithContext = (props: CustomMessageWithContextProps) => {
             dmAgentEnabled={isChatbot}
           />
         )}
-        {/* eslint-disable-next-line jsx-a11y/no-static-element-interactions */}
         <div
           className={classNames('str-chat__message-inner', {
             'str-chat__simple-message--error-failed': allowRetry || isBounced,

package/src/components/FaqList/index.tsx

@@ -1,3 +1,4 @@
+import { selectEnabledFaqs } from '@linktr.ee/messaging-taxonomy'
 import React from 'react'
 
 import { Avatar } from '../Avatar'
@@ -31,9 +32,7 @@ export const FaqList: React.FC<FaqListProps> = ({
   avatarImage,
   avatarName,
 }) => {
-  const enabledFaqs = faqs
-    .filter((faq) => faq.enabled)
-    .sort((a, b) => (a.order ?? 0) - (b.order ?? 0))
+  const enabledFaqs = selectEnabledFaqs(faqs)
 
   if (enabledFaqs.length === 0) {
     return null

package/src/components/LinkAttachment/components/_shared/useChinPalette.ts

@@ -1,3 +1,6 @@
+/* eslint-disable react-hooks/set-state-in-effect -- pre-existing pattern flagged by the React
+   Compiler rules added in eslint-plugin-react-hooks v7; refactoring it is
+   out of scope for the lint toolchain upgrade. */
 import React from 'react'
 
 import type { LinkAttachmentLayout, LinkAttachmentStatus } from '../../types'

package/src/components/MessageAttachment/Audio/AudioAttachment.stories.tsx

@@ -39,7 +39,6 @@ const meta: Meta = {
 export default meta
 
 const handleDismiss = () => {
-  // eslint-disable-next-line no-console
   console.log('Dismissed audio attachment')
 }
 

package/src/components/MessageAttachment/File/FileAttachment.stories.tsx

@@ -49,7 +49,6 @@ const meta: Meta = {
 export default meta
 
 const handleDismiss = () => {
-  // eslint-disable-next-line no-console
   console.log('Dismissed file attachment')
 }
 

package/src/components/MessageAttachment/Image/ImageAttachment.stories.tsx

@@ -74,7 +74,6 @@ const meta: Meta = {
 export default meta
 
 const handleDismiss = () => {
-  // eslint-disable-next-line no-console
   console.log('Dismissed image attachment')
 }
 

package/src/components/MessageAttachment/Pdf/PdfAttachment.stories.tsx

@@ -27,7 +27,6 @@ const meta: Meta = {
 export default meta
 
 const handleDismiss = () => {
-  // eslint-disable-next-line no-console
   console.log('Dismissed PDF attachment')
 }
 

package/src/components/MessageAttachment/Video/VideoAttachment.stories.tsx

@@ -46,7 +46,6 @@ const meta: Meta = {
 export default meta
 
 const handleDismiss = () => {
-  // eslint-disable-next-line no-console
   console.log('Dismissed video attachment')
 }
 

package/src/components/MessageAttachment/_shared/VideoViewer.tsx

@@ -74,7 +74,6 @@ const VideoViewer: React.FC<VideoViewerProps> = ({
           for chat attachments, and an empty `<track kind="captions" />`
           emits a runtime warning. Re-add a real track (with `src`,
           `srcLang`, and `default`) once caption support ships. */}
-      {/* eslint-disable-next-line jsx-a11y/media-has-caption */}
       <video
         // Forcing a key swap on item change ensures the new source
         // mounts a fresh element instead of reusing the previous

package/src/components/MessageAttachment/_shared/useCarousel.ts

@@ -1,3 +1,6 @@
+/* eslint-disable react-hooks/set-state-in-effect -- pre-existing pattern flagged by the React
+   Compiler rules added in eslint-plugin-react-hooks v7; refactoring it is
+   out of scope for the lint toolchain upgrade. */
 import { useCallback, useEffect, useState } from 'react'
 
 const clamp = (value: number, min: number, max: number) =>

package/src/components/MessagingShell/index.tsx

@@ -1,3 +1,6 @@
+/* eslint-disable react-hooks/refs -- pre-existing pattern flagged by the React
+   Compiler rules added in eslint-plugin-react-hooks v7; refactoring it is
+   out of scope for the lint toolchain upgrade. */
 import React, { useCallback, useEffect, useRef, useState } from 'react'
 import type { Channel } from 'stream-chat'
 

package/src/hooks/useChannelModerationActions.ts

@@ -1,3 +1,6 @@
+/* eslint-disable react-hooks/set-state-in-effect -- pre-existing pattern flagged by the React
+   Compiler rules added in eslint-plugin-react-hooks v7; refactoring it is
+   out of scope for the lint toolchain upgrade. */
 import { useEffect, useState } from 'react'
 import type { Channel as ChannelType, ChannelMemberResponse } from 'stream-chat'
 

package/src/hooks/useChannelStar.ts

@@ -1,3 +1,6 @@
+/* eslint-disable react-hooks/set-state-in-effect -- pre-existing pattern flagged by the React
+   Compiler rules added in eslint-plugin-react-hooks v7; refactoring it is
+   out of scope for the lint toolchain upgrade. */
 import { useEffect, useState } from 'react'
 import { Channel, Event } from 'stream-chat'
 

package/src/providers/MessagingProvider.tsx

@@ -1,3 +1,6 @@
+/* eslint-disable react-hooks/refs, react-hooks/set-state-in-effect -- pre-existing pattern flagged by the React
+   Compiler rules added in eslint-plugin-react-hooks v7; refactoring it is
+   out of scope for the lint toolchain upgrade. */
 import { StreamChatService } from '@linktr.ee/messaging-core'
 import React, {
   createContext,

package/src/stream-custom-data.ts

@@ -12,25 +12,28 @@
  * to be included in the distributed types.
  */
 
-import type { Attachment } from 'stream-chat'
+import {
+  MESSAGE_CUSTOM_TYPE,
+  type ClassifiableMessage,
+  type MessageCustomType,
+} from '@linktr.ee/messaging-taxonomy'
+import type { Attachment, LocalMessage } from 'stream-chat'
 import 'stream-chat'
 
+/**
+ * System `custom_type` sub-unions consumed by {@link CustomSystemMessage}. The
+ * taxonomy owns the full {@link MessageCustomType} union but does not export
+ * these semantic groupings, so they are derived here from the shared catalog
+ * (never re-typed as bare literals) to stay in lockstep with it.
+ */
 export type DmAgentSystemType =
-  | 'SYSTEM_DM_AGENT_PAUSED'
-  | 'SYSTEM_DM_AGENT_RESUMED'
-
-export type AgeSafetySystemType = 'SYSTEM_AGE_SAFETY_BLOCKED'
+  | typeof MESSAGE_CUSTOM_TYPE.SYSTEM_DM_AGENT_PAUSED
+  | typeof MESSAGE_CUSTOM_TYPE.SYSTEM_DM_AGENT_RESUMED
 
-export type EscalationSystemType = 'SYSTEM_ESCALATION'
+export type AgeSafetySystemType =
+  typeof MESSAGE_CUSTOM_TYPE.SYSTEM_AGE_SAFETY_BLOCKED
 
-export type MessageCustomType =
-  | 'MESSAGE_TIP'
-  | 'MESSAGE_PAID'
-  | 'MESSAGE_CHATBOT'
-  | 'MESSAGE_ATTACHMENT'
-  | AgeSafetySystemType
-  | EscalationSystemType
-  | DmAgentSystemType
+export type EscalationSystemType = typeof MESSAGE_CUSTOM_TYPE.SYSTEM_ESCALATION
 
 /**
  * Message metadata for paid messaging and chatbot flows.
@@ -142,3 +145,15 @@ declare module 'stream-chat' {
     dm_agent_system_type?: DmAgentSystemType
   }
 }
+
+/**
+ * Build-only guarantee that stream-chat's augmented `LocalMessage` stays
+ * structurally assignable to the taxonomy's {@link ClassifiableMessage}, so the
+ * shared classification predicates accept a message from this package unchanged.
+ * If a future augmentation narrows `metadata`/`custom_type` incompatibly, this
+ * fails to compile. Type-only — emits no runtime code.
+ */
+type Expect<T extends true> = T
+type _AssertLocalMessageIsClassifiable = Expect<
+  LocalMessage extends ClassifiableMessage ? true : false
+>

package/src/testing/createMockMessagingClient.ts

@@ -145,7 +145,6 @@ export function createMockMessagingClient({
   })
   // Read/unread bookkeeping consults channel mute status; without a live
   // connection the real method throws, so report "not muted".
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
   channel.muteStatus = (() => ({
     muted: false,
     createdAt: null,

package/src/utils/resolveConversationParticipant.ts

@@ -1,9 +1,6 @@
+import { isOfficialChannel } from '@linktr.ee/messaging-taxonomy'
 import type { Channel } from 'stream-chat'
 
-// Stream channel type for the Linktree-authored "official" thread that lives
-// next to every linker's inbox.
-const OFFICIAL_CHANNEL_TYPE = 'linktree-official'
-
 // Stream user id of the sender that authors official welcome messages. It is
 // the non-linker member of every `linktree-official` channel.
 const OFFICIAL_SENDER_USER_ID = 'linktree-official-sender'
@@ -28,7 +25,7 @@ export function resolveConversationParticipant(
 ): ChannelMember | undefined {
   const memberList = Object.values(members || {})
 
-  if (channelType === OFFICIAL_CHANNEL_TYPE) {
+  if (isOfficialChannel(channelType)) {
     const officialSender = memberList.find(
       (member) => member.user?.id === OFFICIAL_SENDER_USER_ID
     )