@linktr.ee/messaging-react 4.2.0-rc-1787255254 → 4.2.0-rc-1787325521

package/dist/testing.cjs

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("stream-chat");function t(t,{stubConnection:n=!1}={}){let r=new e.StreamChat(`mock-api-key`,{allowServerSideConnect:!0});return r.userID=t.id,r.user=t,n&&(r.connectUser=async()=>({me:t}),r.disconnectUser=async()=>void 0,r.userMuteStatus=(()=>!1)),r}var n=600;function r({currentUser:e,participant:r,messages:i=[],channelId:a=`mock-dm`,onSend:o}){let s=t(e,{stubConnection:!0}),c=`messaging:${a}`,l=(t,n)=>{let a=t.from===`me`?e:r,o=new Date(Date.now()-(i.length-n)*6e4);return{id:t.id??`mock-msg-${n}`,text:t.text??``,type:`regular`,html:t.text?`<p>${t.text}</p>`:``,user:a,attachments:t.attachments??[],latest_reactions:[],own_reactions:[],reaction_counts:{},reaction_scores:{},reply_count:0,status:`received`,cid:c,created_at:o,updated_at:o,mentioned_users:[],...t.metadata?{metadata:t.metadata}:{}}},u=i.map(l),d={[e.id]:{user:{...e,is_account:!1},user_id:e.id,role:`owner`,is_account:!1},[r.id]:{user:{...r,is_account:!0},user_id:r.id,role:`member`,is_account:!0}},f=s.channel(`messaging`,a,{members:[e.id,r.id]});f.muteStatus=()=>({muted:!1,createdAt:null,expiresAt:null}),f.markRead=(async()=>({})),f.keystroke=(async()=>void 0),f.stopTyping=(async()=>void 0),f.sendReaction=(async()=>({})),f.deleteReaction=(async()=>({})),f.countUnread=(()=>0),f.query=(async()=>({messages:[]})),f.hide=(async()=>({}));let p=!1;f.watch=async()=>(p||=(f.state.messages=u,!0),f.state.members=d,{channel:{members:[e.id,r.id]},members:[],messages:f.state.messages,watchers:[],pinned_messages:[],duration:`0ms`});let m=e=>{f.state.addMessageSorted(e),s.dispatchEvent({type:`message.new`,cid:c,message:e,user:e.user??void 0})},h=0,g=0;return f.sendMessage=async t=>{let r=typeof t==`string`?t:t?.text??``,i={...l({text:r,from:`me`,id:`mock-sent-${h++}`},u.length),...typeof t==`object`?t:{},user:e,cid:c};m(i);let a=o?.(r);if(a){let e=typeof a==`string`?a:a.text,t=typeof a==`string`?void 0:a.attachments,r=`mock-reply-${g++}`;setTimeout(()=>{m(l({text:e,from:`them`,attachments:t,id:r},u.length))},n)}return{message:i}},s.queryChannels=async()=>[f],f.watch(),{client:s,channel:f,participantFilterId:r.id}}exports.createMockMessagingClient=r;
-//# sourceMappingURL=testing.cjs.map
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("stream-chat");function v(s,{stubConnection:n=!1}={}){const a=new b.StreamChat("mock-api-key",{allowServerSideConnect:!0});return a.userID=s.id,a.user=s,n&&(a.connectUser=async()=>({me:s}),a.disconnectUser=async()=>{},a.userMuteStatus=(()=>!1)),a}const w=600;function x({currentUser:s,participant:n,messages:a=[],channelId:y="mock-dm",onSend:d}){const r=v(s,{stubConnection:!0}),u=`messaging:${y}`,l=(t,c)=>{const i=t.from==="me"?s:n,o=new Date(Date.now()-(a.length-c)*6e4);return{id:t.id??`mock-msg-${c}`,text:t.text??"",type:"regular",html:t.text?`<p>${t.text}</p>`:"",user:i,attachments:t.attachments??[],latest_reactions:[],own_reactions:[],reaction_counts:{},reaction_scores:{},reply_count:0,status:"received",cid:u,created_at:o,updated_at:o,mentioned_users:[],...t.metadata?{metadata:t.metadata}:{}}},m=a.map(l),_={[s.id]:{user:{...s,is_account:!1},user_id:s.id,role:"owner",is_account:!1},[n.id]:{user:{...n,is_account:!0},user_id:n.id,role:"member",is_account:!0}},e=r.channel("messaging",y,{members:[s.id,n.id]});e.muteStatus=()=>({muted:!1,createdAt:null,expiresAt:null}),e.markRead=(async()=>({})),e.keystroke=(async()=>{}),e.stopTyping=(async()=>{}),e.sendReaction=(async()=>({})),e.deleteReaction=(async()=>({})),e.countUnread=(()=>0),e.query=(async()=>({messages:[]})),e.hide=(async()=>({}));let h=!1;e.watch=async()=>(h||(e.state.messages=m,h=!0),e.state.members=_,{channel:{members:[s.id,n.id]},members:[],messages:e.state.messages,watchers:[],pinned_messages:[],duration:"0ms"});const f=t=>{e.state.addMessageSorted(t),r.dispatchEvent({type:"message.new",cid:u,message:t,user:t.user??void 0})};let p=0,g=0;return e.sendMessage=async t=>{const c=typeof t=="string"?t:(t==null?void 0:t.text)??"",i={...l({text:c,from:"me",id:`mock-sent-${p++}`},m.length),...typeof t=="object"?t:{},user:s,cid:u};f(i);const o=d==null?void 0:d(c);if(o){const M=typeof o=="string"?o:o.text,k=typeof o=="string"?void 0:o.attachments,C=`mock-reply-${g++}`;setTimeout(()=>{f(l({text:M,from:"them",attachments:k,id:C},m.length))},w)}return{message:i}},r.queryChannels=async()=>[e],e.watch(),{client:r,channel:e,participantFilterId:n.id}}exports.createMockMessagingClient=x;
+//# sourceMappingURL=testing.cjs.map

package/dist/testing.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"testing.cjs","names":[],"sources":["../src/testing/createMockStreamChatClient.ts","../src/testing/createMockMessagingClient.ts"],"sourcesContent":["import { StreamChat } from 'stream-chat'\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/** A participant in the mock conversation. */\nexport interface MockMessagingUser {\n  id: string\n  name?: string\n  image?: string\n}\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 {\n  createMockStreamChatClient,\n  type MockMessagingUser,\n} from './createMockStreamChatClient'\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  })\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"],"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\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/** A participant in the mock conversation. */\nexport interface MockMessagingUser {\n  id: string\n  name?: string\n  image?: string\n}\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 {\n  createMockStreamChatClient,\n  type MockMessagingUser,\n} from './createMockStreamChatClient'\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  })\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.js

@@ -1,108 +1,120 @@
-import { StreamChat as e } from "stream-chat";
-//#region src/testing/createMockStreamChatClient.ts
-function t(t, { stubConnection: n = !1 } = {}) {
-	let r = new e("mock-api-key", { allowServerSideConnect: !0 });
-	return r.userID = t.id, r.user = t, n && (r.connectUser = async () => ({ me: t }), r.disconnectUser = async () => void 0, r.userMuteStatus = (() => !1)), r;
+import { StreamChat as g } from "stream-chat";
+function v(s, { stubConnection: n = !1 } = {}) {
+  const a = new g("mock-api-key", {
+    allowServerSideConnect: !0
+  });
+  return a.userID = s.id, a.user = s, n && (a.connectUser = async () => ({ me: s }), a.disconnectUser = async () => {
+  }, a.userMuteStatus = (() => !1)), a;
 }
-//#endregion
-//#region src/testing/createMockMessagingClient.ts
-var n = 600;
-function r({ currentUser: e, participant: r, messages: i = [], channelId: a = "mock-dm", onSend: o }) {
-	let s = t(e, { stubConnection: !0 }), c = `messaging:${a}`, l = (t, n) => {
-		let a = t.from === "me" ? e : r, o = /* @__PURE__ */ new Date(Date.now() - (i.length - n) * 6e4);
-		return {
-			id: t.id ?? `mock-msg-${n}`,
-			text: t.text ?? "",
-			type: "regular",
-			html: t.text ? `<p>${t.text}</p>` : "",
-			user: a,
-			attachments: t.attachments ?? [],
-			latest_reactions: [],
-			own_reactions: [],
-			reaction_counts: {},
-			reaction_scores: {},
-			reply_count: 0,
-			status: "received",
-			cid: c,
-			created_at: o,
-			updated_at: o,
-			mentioned_users: [],
-			...t.metadata ? { metadata: t.metadata } : {}
-		};
-	}, u = i.map(l), d = {
-		[e.id]: {
-			user: {
-				...e,
-				is_account: !1
-			},
-			user_id: e.id,
-			role: "owner",
-			is_account: !1
-		},
-		[r.id]: {
-			user: {
-				...r,
-				is_account: !0
-			},
-			user_id: r.id,
-			role: "member",
-			is_account: !0
-		}
-	}, f = s.channel("messaging", a, { members: [e.id, r.id] });
-	f.muteStatus = () => ({
-		muted: !1,
-		createdAt: null,
-		expiresAt: null
-	}), f.markRead = (async () => ({})), f.keystroke = (async () => void 0), f.stopTyping = (async () => void 0), f.sendReaction = (async () => ({})), f.deleteReaction = (async () => ({})), f.countUnread = (() => 0), f.query = (async () => ({ messages: [] })), f.hide = (async () => ({}));
-	let p = !1;
-	f.watch = async () => (p ||= (f.state.messages = u, !0), f.state.members = d, {
-		channel: { members: [e.id, r.id] },
-		members: [],
-		messages: f.state.messages,
-		watchers: [],
-		pinned_messages: [],
-		duration: "0ms"
-	});
-	let m = (e) => {
-		f.state.addMessageSorted(e), s.dispatchEvent({
-			type: "message.new",
-			cid: c,
-			message: e,
-			user: e.user ?? void 0
-		});
-	}, h = 0, g = 0;
-	return f.sendMessage = async (t) => {
-		let r = typeof t == "string" ? t : t?.text ?? "", i = {
-			...l({
-				text: r,
-				from: "me",
-				id: `mock-sent-${h++}`
-			}, u.length),
-			...typeof t == "object" ? t : {},
-			user: e,
-			cid: c
-		};
-		m(i);
-		let a = o?.(r);
-		if (a) {
-			let e = typeof a == "string" ? a : a.text, t = typeof a == "string" ? void 0 : a.attachments, r = `mock-reply-${g++}`;
-			setTimeout(() => {
-				m(l({
-					text: e,
-					from: "them",
-					attachments: t,
-					id: r
-				}, u.length));
-			}, n);
-		}
-		return { message: i };
-	}, s.queryChannels = async () => [f], f.watch(), {
-		client: s,
-		channel: f,
-		participantFilterId: r.id
-	};
+const C = 600;
+function S({
+  currentUser: s,
+  participant: n,
+  messages: a = [],
+  channelId: y = "mock-dm",
+  onSend: d
+}) {
+  const r = v(s, {
+    stubConnection: !0
+  }), u = `messaging:${y}`, l = (t, c) => {
+    const i = t.from === "me" ? s : n, o = new Date(Date.now() - (a.length - c) * 6e4);
+    return {
+      id: t.id ?? `mock-msg-${c}`,
+      text: t.text ?? "",
+      type: "regular",
+      html: t.text ? `<p>${t.text}</p>` : "",
+      user: i,
+      attachments: t.attachments ?? [],
+      latest_reactions: [],
+      own_reactions: [],
+      reaction_counts: {},
+      reaction_scores: {},
+      reply_count: 0,
+      status: "received",
+      cid: u,
+      created_at: o,
+      updated_at: o,
+      mentioned_users: [],
+      ...t.metadata ? { metadata: t.metadata } : {}
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    };
+  }, m = a.map(l), p = {
+    [s.id]: {
+      user: { ...s, is_account: !1 },
+      user_id: s.id,
+      role: "owner",
+      is_account: !1
+    },
+    [n.id]: {
+      user: { ...n, is_account: !0 },
+      user_id: n.id,
+      role: "member",
+      is_account: !0
+    }
+  }, e = r.channel("messaging", y, {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    members: [s.id, n.id]
+  });
+  e.muteStatus = () => ({
+    muted: !1,
+    createdAt: null,
+    expiresAt: null
+  }), e.markRead = (async () => ({})), e.keystroke = (async () => {
+  }), e.stopTyping = (async () => {
+  }), e.sendReaction = (async () => ({})), e.deleteReaction = (async () => ({})), e.countUnread = (() => 0), e.query = (async () => ({ messages: [] })), e.hide = (async () => ({}));
+  let h = !1;
+  e.watch = async () => (h || (e.state.messages = m, h = !0), e.state.members = p, {
+    channel: { members: [s.id, n.id] },
+    members: [],
+    messages: e.state.messages,
+    watchers: [],
+    pinned_messages: [],
+    duration: "0ms"
+  });
+  const f = (t) => {
+    e.state.addMessageSorted(t), r.dispatchEvent({
+      type: "message.new",
+      cid: u,
+      message: t,
+      user: t.user ?? void 0
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    });
+  };
+  let _ = 0, k = 0;
+  return e.sendMessage = async (t) => {
+    const c = typeof t == "string" ? t : (t == null ? void 0 : t.text) ?? "", i = {
+      ...l(
+        { text: c, from: "me", id: `mock-sent-${_++}` },
+        m.length
+      ),
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      ...typeof t == "object" ? t : {},
+      user: s,
+      cid: u
+    };
+    f(i);
+    const o = d == null ? void 0 : d(c);
+    if (o) {
+      const w = typeof o == "string" ? o : o.text, x = typeof o == "string" ? void 0 : o.attachments, M = `mock-reply-${k++}`;
+      setTimeout(() => {
+        f(
+          l(
+            {
+              text: w,
+              from: "them",
+              // eslint-disable-next-line @typescript-eslint/no-explicit-any
+              attachments: x,
+              id: M
+            },
+            m.length
+          )
+        );
+      }, C);
+    }
+    return { message: i };
+  }, r.queryChannels = async () => [e], e.watch(), { client: r, channel: e, participantFilterId: n.id };
 }
-//#endregion
-export { r as createMockMessagingClient };
-
-//# sourceMappingURL=testing.js.map
+export {
+  S as createMockMessagingClient
+};
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -1 +1 @@
-{"version":3,"file":"testing.js","names":[],"sources":["../src/testing/createMockStreamChatClient.ts","../src/testing/createMockMessagingClient.ts"],"sourcesContent":["import { StreamChat } from 'stream-chat'\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/** A participant in the mock conversation. */\nexport interface MockMessagingUser {\n  id: string\n  name?: string\n  image?: string\n}\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 {\n  createMockStreamChatClient,\n  type MockMessagingUser,\n} from './createMockStreamChatClient'\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  })\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"],"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\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/** A participant in the mock conversation. */\nexport interface MockMessagingUser {\n  id: string\n  name?: string\n  image?: string\n}\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 {\n  createMockStreamChatClient,\n  type MockMessagingUser,\n} from './createMockStreamChatClient'\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  })\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": "4.2.0-rc-1787255254",
+  "version": "4.2.0-rc-1787325521",
   "description": "React messaging components built on messaging-core for web applications",
   "type": "module",
   "main": "dist/index.cjs",
@@ -50,8 +50,8 @@
     "chromatic:local": "yarn storybook:build && chromatic"
   },
   "dependencies": {
-    "@linktr.ee/messaging-core": "2.6.0-rc-1787255254",
-    "@linktr.ee/messaging-taxonomy": "^0.11.0",
+    "@linktr.ee/messaging-core": "2.5.0-rc-1787325521",
+    "@linktr.ee/messaging-taxonomy": "^0.10.0",
     "@phosphor-icons/react": "^2.1.10"
   },
   "devDependencies": {
@@ -68,7 +68,7 @@
     "@testing-library/user-event": "^14.5.1",
     "@types/react": "^18.3.24",
     "@types/react-dom": "^18.3.7",
-    "@vitejs/plugin-react": "^5.2.0",
+    "@vitejs/plugin-react": "^4.2.1",
     "@vitest/ui": "^4.1.10",
     "autoprefixer": "^10.4.20",
     "chromatic": "^17.4.0",
@@ -83,7 +83,7 @@
     "tailwindcss": "^3.4.17",
     "tailwindcss-animate": "^1.0.7",
     "typescript": "5.9.2",
-    "vite": "^8.2.1",
+    "vite": "^6.0.7",
     "vite-plugin-dts": "^3.7.0",
     "vitest": "^4.1.10"
   },

package/src/components/ChannelView.stories.tsx

@@ -682,6 +682,10 @@ WithTypingIndicator.args = {
   },
 }
 WithTypingIndicator.parameters = {
+  // The typing indicator is animation-dominant, so a snapshot mostly captures
+  // whichever frame the animation happened to pause at — a false-positive
+  // source. Skip it in Chromatic; the story stays browsable in Storybook.
+  chromatic: { disableSnapshot: true },
   docs: {
     description: {
       story:

package/src/components/CustomMessageInput/index.tsx

@@ -496,7 +496,7 @@ export const CustomMessageInput: React.FC<CustomMessageInputProps> = ({
 
       <div className="relative z-10 flex min-h-0 flex-col">
         {renderHeader?.()}
-        <div className="flex min-h-0 flex-col gap-4 p-4">
+        <div className="flex min-h-0 flex-col gap-4 p-3 pb-5 md:p-5">
           <div
             // @ts-expect-error Only React 19 onwards has `inert` in its types.
             inert={isFrozen ? '' : undefined}

package/src/index.ts

@@ -29,11 +29,13 @@ export type {
 
 // Providers
 export { MessagingProvider } from './providers/MessagingProvider'
+export { MessagingLoggerProvider } from './logging'
 export { CustomMessageProvider } from './components/CustomMessage/context'
 
 // Hooks
 export { useComposerLocked } from './components/CustomMessageInput'
 export { useMessaging } from './hooks/useMessaging'
+export { useMessagingLogger } from './logging'
 export { useCustomMessage } from './components/CustomMessage/context'
 
 // Utils
@@ -136,3 +138,4 @@ export type { CustomMessageRegistry } from './components/CustomMessage/context'
 export type { AttachmentSourceType } from './components/AttachmentCard/utils/mimeType'
 export type { Faq, FaqListProps } from './components/FaqList'
 export type { FaqListItemProps } from './components/FaqList/FaqListItem'
+export type { Logger } from '@linktr.ee/messaging-core'

package/src/logging/index.test.tsx

@@ -0,0 +1,136 @@
+import type { Logger } from '@linktr.ee/messaging-core'
+import { render } from '@testing-library/react'
+import React from 'react'
+import { describe, it, expect, vi, afterEach } from 'vitest'
+
+import {
+  MessagingLoggerProvider,
+  consoleLogger,
+  resolveLogger,
+  useMessagingLogger,
+} from './index'
+
+const ERROR_MESSAGE = '[MessagingShell] Failed to load channels:'
+
+/** Logs one error through the seam the way a call site would. */
+const ErrorEmitter: React.FC<{ error: Error }> = ({ error }) => {
+  const logger = useMessagingLogger()
+  logger.error(ERROR_MESSAGE, error)
+  return null
+}
+
+/** Emits one line at every level so partial-sink fallback is observable. */
+const AllLevelsEmitter: React.FC = () => {
+  const logger = useMessagingLogger()
+  logger.debug('debug line', 1)
+  logger.info('info line', 2)
+  logger.warn('warn line', 3)
+  logger.error('error line', 4)
+  return null
+}
+
+afterEach(() => {
+  vi.restoreAllMocks()
+})
+
+describe('logger seam', () => {
+  it('routes error to an injected sink with the exact message and raw error object', () => {
+    const error = new Error('boom')
+    const sink = { error: vi.fn() }
+
+    render(
+      <MessagingLoggerProvider logger={sink}>
+        <ErrorEmitter error={error} />
+      </MessagingLoggerProvider>
+    )
+
+    expect(sink.error).toHaveBeenCalledTimes(1)
+    expect(sink.error).toHaveBeenCalledWith(ERROR_MESSAGE, error)
+    // The raw Error instance, not a serialized copy.
+    expect(sink.error.mock.calls[0][1]).toBe(error)
+  })
+
+  it('passes identical arguments to console.error when no sink is injected', () => {
+    const error = new Error('boom')
+    const consoleError = vi.spyOn(console, 'error').mockImplementation(() => {})
+    const sink = { error: vi.fn() }
+
+    render(
+      <MessagingLoggerProvider logger={sink}>
+        <ErrorEmitter error={error} />
+      </MessagingLoggerProvider>
+    )
+    const injectedArgs = sink.error.mock.calls[0]
+
+    // No provider at all, and a provider with no logger prop: both must produce
+    // byte-identical console output to what the injected sink received.
+    render(<ErrorEmitter error={error} />)
+    render(
+      <MessagingLoggerProvider>
+        <ErrorEmitter error={error} />
+      </MessagingLoggerProvider>
+    )
+
+    expect(consoleError).toHaveBeenCalledTimes(2)
+    expect(consoleError.mock.calls[0]).toEqual(injectedArgs)
+    expect(consoleError.mock.calls[1]).toEqual(injectedArgs)
+    expect(consoleError.mock.calls[0][1]).toBe(error)
+  })
+
+  it('falls back to console for the levels a partial sink omits', () => {
+    const consoleLog = vi.spyOn(console, 'log').mockImplementation(() => {})
+    const consoleWarn = vi.spyOn(console, 'warn').mockImplementation(() => {})
+    const consoleError = vi.spyOn(console, 'error').mockImplementation(() => {})
+    const sink: Logger = { warn: vi.fn(), error: vi.fn() }
+
+    render(
+      <MessagingLoggerProvider logger={sink}>
+        <AllLevelsEmitter />
+      </MessagingLoggerProvider>
+    )
+
+    expect(sink.warn).toHaveBeenCalledWith('warn line', 3)
+    expect(sink.error).toHaveBeenCalledWith('error line', 4)
+    expect(consoleWarn).not.toHaveBeenCalled()
+    expect(consoleError).not.toHaveBeenCalled()
+    // debug and info are unset on the sink, so both land on console.log.
+    expect(consoleLog.mock.calls).toEqual([
+      ['debug line', 1],
+      ['info line', 2],
+    ])
+  })
+
+  it('defaults every level to console when the hook is used with no provider', () => {
+    const consoleLog = vi.spyOn(console, 'log').mockImplementation(() => {})
+    const consoleWarn = vi.spyOn(console, 'warn').mockImplementation(() => {})
+    const consoleError = vi.spyOn(console, 'error').mockImplementation(() => {})
+
+    render(<AllLevelsEmitter />)
+
+    expect(consoleLog.mock.calls).toEqual([
+      ['debug line', 1],
+      ['info line', 2],
+    ])
+    expect(consoleWarn).toHaveBeenCalledWith('warn line', 3)
+    expect(consoleError).toHaveBeenCalledWith('error line', 4)
+  })
+
+  it('resolveLogger keeps provided levels and fills the rest from console', () => {
+    const warn = vi.fn()
+    const resolved = resolveLogger({ warn })
+
+    expect(resolved.warn).toBe(warn)
+    expect(resolved.debug).toBe(consoleLogger.debug)
+    expect(resolved.info).toBe(consoleLogger.info)
+    expect(resolved.error).toBe(consoleLogger.error)
+    expect(resolveLogger()).toEqual(consoleLogger)
+  })
+
+  it('consoleLogger dispatches through console at call time, not bind time', () => {
+    const consoleError = vi.spyOn(console, 'error').mockImplementation(() => {})
+
+    consoleLogger.error('late spy', 'arg')
+
+    expect(consoleError).toHaveBeenCalledWith('late spy', 'arg')
+  })
+})