@linktr.ee/messaging-react 3.7.0-rc-1783333034 → 3.7.0-rc-1783333932

package/dist/testing.cjs

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

package/dist/testing.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"testing.cjs","sources":["../src/testing/createMockMessagingClient.ts"],"sourcesContent":["import type {\n  Channel,\n  MessageResponse,\n  QueryChannelAPIResponse,\n  SendMessageAPIResponse,\n} from 'stream-chat'\nimport { StreamChat } from 'stream-chat'\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  const client = new StreamChat('mock-api-key', {\n    allowServerSideConnect: true,\n  })\n\n  // Mark connected without opening a WebSocket. `MessagingProvider` renders\n  // `<Chat client={client}>` directly for an injected client, so it never\n  // calls connectUser itself.\n  client.connectUser = async () => ({ me: currentUser }) as never\n  client.disconnectUser = async () => undefined\n  client.userID = currentUser.id\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  client.user = currentUser as any\n  // Handling a `message.new` event (dispatched on send + echo below) runs\n  // Channel._countMessageAsUnread → client.userMuteStatus, which throws\n  // \"Make sure to await connectUser() first.\" without a live WebSocket. Stub\n  // the mute lookups so offline event dispatch doesn't throw.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  client.userMuteStatus = (() => false) as any\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 = (() => ({ muted: false, createdAt: null, expiresAt: null })) 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  /* 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  channel.sendMessage = async (message) => {\n    const text =\n      typeof message === 'string'\n        ? message\n        : ((message as { text?: string })?.text ?? '')\n    const sent = {\n      ...toStreamMessage({ text, from: 'me', id: `mock-sent-${sentCount++}` }, seededMessages.length),\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      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: `mock-reply-${sentCount}`,\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":["REPLY_DELAY_MS","createMockMessagingClient","currentUser","participant","messages","channelId","onSend","client","StreamChat","cid","toStreamMessage","message","index","author","createdAt","seededMessages","memberState","channel","hasSeeded","appendMessage","sentCount","text","sent","reply","replyText","replyAttachments"],"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  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  channel.muteStatus = (() => ({ muted: false, createdAt: null, expiresAt: null })) 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  /* 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  channel.sendMessage = async (message) => {\n    const text =\n      typeof message === 'string'\n        ? message\n        : ((message as { text?: string })?.text ?? '')\n    const sent = {\n      ...toStreamMessage({ text, from: 'me', id: `mock-sent-${sentCount++}` }, seededMessages.length),\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      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: `mock-reply-${sentCount}`,\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","text","sent","reply","replyText","replyAttachments"],"mappings":"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"}

package/dist/testing.js

@@ -1,25 +1,29 @@
 import { StreamChat as x } from "stream-chat";
+function M(s, { stubConnection: n = !1 } = {}) {
+  const a = new x("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 g = 600;
-function M({
+function b({
   currentUser: s,
-  participant: o,
-  messages: l = [],
+  participant: n,
+  messages: a = [],
   channelId: y = "mock-dm",
-  onSend: i
+  onSend: d
 }) {
-  const n = new x("mock-api-key", {
-    allowServerSideConnect: !0
-  });
-  n.connectUser = async () => ({ me: s }), n.disconnectUser = async () => {
-  }, n.userID = s.id, n.user = s, n.userMuteStatus = (() => !1);
-  const r = `messaging:${y}`, m = (t, c) => {
-    const d = t.from === "me" ? s : o, a = new Date(Date.now() - (l.length - c) * 6e4);
+  const r = M(s, {
+    stubConnection: !0
+  }), u = `messaging:${y}`, m = (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: d,
+      user: i,
       attachments: t.attachments ?? [],
       latest_reactions: [],
       own_reactions: [],
@@ -27,83 +31,83 @@ function M({
       reaction_scores: {},
       reply_count: 0,
       status: "received",
-      cid: r,
-      created_at: a,
-      updated_at: a,
+      cid: u,
+      created_at: o,
+      updated_at: o,
       mentioned_users: [],
       ...t.metadata ? { metadata: t.metadata } : {}
       // eslint-disable-next-line @typescript-eslint/no-explicit-any
     };
-  }, u = l.map(m), p = {
+  }, l = a.map(m), p = {
     [s.id]: {
       user: { ...s, is_account: !1 },
       user_id: s.id,
       role: "owner",
       is_account: !1
     },
-    [o.id]: {
-      user: { ...o, is_account: !0 },
-      user_id: o.id,
+    [n.id]: {
+      user: { ...n, is_account: !0 },
+      user_id: n.id,
       role: "member",
       is_account: !0
     }
-  }, e = n.channel("messaging", y, {
+  }, e = r.channel("messaging", y, {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    members: [s.id, o.id]
+    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: [] }));
   let h = !1;
-  e.watch = async () => (h || (e.state.messages = u, h = !0), e.state.members = p, {
-    channel: { members: [s.id, o.id] },
+  e.watch = async () => (h || (e.state.messages = l, h = !0), e.state.members = p, {
+    channel: { members: [s.id, n.id] },
     members: [],
     messages: e.state.messages,
     watchers: [],
     pinned_messages: [],
     duration: "0ms"
   });
-  const _ = (t) => {
-    e.state.addMessageSorted(t), n.dispatchEvent({
+  const f = (t) => {
+    e.state.addMessageSorted(t), r.dispatchEvent({
       type: "message.new",
-      cid: r,
+      cid: u,
       message: t,
       user: t.user ?? void 0
       // eslint-disable-next-line @typescript-eslint/no-explicit-any
     });
   };
-  let f = 0;
+  let _ = 0;
   return e.sendMessage = async (t) => {
-    const c = typeof t == "string" ? t : (t == null ? void 0 : t.text) ?? "", d = {
-      ...m({ text: c, from: "me", id: `mock-sent-${f++}` }, u.length),
+    const c = typeof t == "string" ? t : (t == null ? void 0 : t.text) ?? "", i = {
+      ...m({ text: c, from: "me", id: `mock-sent-${_++}` }, l.length),
       // eslint-disable-next-line @typescript-eslint/no-explicit-any
       ...typeof t == "object" ? t : {},
       user: s,
-      cid: r
+      cid: u
     };
-    _(d);
-    const a = i == null ? void 0 : i(c);
-    if (a) {
-      const k = typeof a == "string" ? a : a.text, w = typeof a == "string" ? void 0 : a.attachments;
+    f(i);
+    const o = d == null ? void 0 : d(c);
+    if (o) {
+      const k = typeof o == "string" ? o : o.text, w = typeof o == "string" ? void 0 : o.attachments;
       setTimeout(() => {
-        _(
+        f(
           m(
             {
               text: k,
               from: "them",
               // eslint-disable-next-line @typescript-eslint/no-explicit-any
               attachments: w,
-              id: `mock-reply-${f}`
+              id: `mock-reply-${_}`
             },
-            u.length
+            l.length
           )
         );
       }, g);
     }
-    return { message: d };
-  }, n.queryChannels = async () => [e], e.watch(), { client: n, channel: e, participantFilterId: o.id };
+    return { message: i };
+  }, r.queryChannels = async () => [e], e.watch(), { client: r, channel: e, participantFilterId: n.id };
 }
 export {
-  M as createMockMessagingClient
+  b as createMockMessagingClient
 };
 //# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -1 +1 @@
-{"version":3,"file":"testing.js","sources":["../src/testing/createMockMessagingClient.ts"],"sourcesContent":["import type {\n  Channel,\n  MessageResponse,\n  QueryChannelAPIResponse,\n  SendMessageAPIResponse,\n} from 'stream-chat'\nimport { StreamChat } from 'stream-chat'\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  const client = new StreamChat('mock-api-key', {\n    allowServerSideConnect: true,\n  })\n\n  // Mark connected without opening a WebSocket. `MessagingProvider` renders\n  // `<Chat client={client}>` directly for an injected client, so it never\n  // calls connectUser itself.\n  client.connectUser = async () => ({ me: currentUser }) as never\n  client.disconnectUser = async () => undefined\n  client.userID = currentUser.id\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  client.user = currentUser as any\n  // Handling a `message.new` event (dispatched on send + echo below) runs\n  // Channel._countMessageAsUnread → client.userMuteStatus, which throws\n  // \"Make sure to await connectUser() first.\" without a live WebSocket. Stub\n  // the mute lookups so offline event dispatch doesn't throw.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  client.userMuteStatus = (() => false) as any\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 = (() => ({ muted: false, createdAt: null, expiresAt: null })) 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  /* 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  channel.sendMessage = async (message) => {\n    const text =\n      typeof message === 'string'\n        ? message\n        : ((message as { text?: string })?.text ?? '')\n    const sent = {\n      ...toStreamMessage({ text, from: 'me', id: `mock-sent-${sentCount++}` }, seededMessages.length),\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      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: `mock-reply-${sentCount}`,\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":["REPLY_DELAY_MS","createMockMessagingClient","currentUser","participant","messages","channelId","onSend","client","StreamChat","cid","toStreamMessage","message","index","author","createdAt","seededMessages","memberState","channel","hasSeeded","appendMessage","sentCount","text","sent","reply","replyText","replyAttachments"],"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  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  channel.muteStatus = (() => ({ muted: false, createdAt: null, expiresAt: null })) 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  /* 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  channel.sendMessage = async (message) => {\n    const text =\n      typeof message === 'string'\n        ? message\n        : ((message as { text?: string })?.text ?? '')\n    const sent = {\n      ...toStreamMessage({ text, from: 'me', id: `mock-sent-${sentCount++}` }, seededMessages.length),\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      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: `mock-reply-${sentCount}`,\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","text","sent","reply","replyText","replyAttachments"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linktr.ee/messaging-react",
-  "version": "3.7.0-rc-1783333034",
+  "version": "3.7.0-rc-1783333932",
   "description": "React messaging components built on messaging-core for web applications",
   "type": "module",
   "main": "dist/index.cjs",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@linktr.ee/component-library": "11.8.6",
-    "@linktr.ee/messaging-core": "2.3.0-rc-1783333034",
+    "@linktr.ee/messaging-core": "2.3.0-rc-1783333932",
     "@phosphor-icons/react": "^2.1.10"
   },
   "devDependencies": {

package/src/components/ChannelView.stories.tsx

@@ -11,6 +11,7 @@ import { Chat } from 'stream-chat-react'
 
 import { hoursAgo, minutesAgo, now } from '../stories/decorators/storyTime'
 import { mockParticipants } from '../stories/mocks'
+import { createMockStreamChatClient } from '../testing/createMockStreamChatClient'
 
 import { ChannelView } from './ChannelView'
 import { ChannelEmptyState } from './MessagingShell/ChannelEmptyState'
@@ -227,14 +228,7 @@ const Template: StoryFn<TemplateProps> = (args) => {
     typingUser,
     ...channelViewProps
   } = args
-  const [client] = React.useState(() => {
-    const client = new StreamChat('mock-api-key', {
-      allowServerSideConnect: true,
-    })
-    client.userID = mockUser.id
-    client.user = mockUser
-    return client
-  })
+  const [client] = React.useState(() => createMockStreamChatClient(mockUser))
 
   const [channel, setChannel] = React.useState<ChannelType | null>(null)
 
@@ -509,14 +503,7 @@ WithMessageDecoration.parameters = {
 }
 
 const WithStarButtonTemplate: StoryFn<ComponentProps> = (args) => {
-  const [client] = React.useState(() => {
-    const client = new StreamChat('mock-api-key', {
-      allowServerSideConnect: true,
-    })
-    client.userID = mockUser.id
-    client.user = mockUser
-    return client
-  })
+  const [client] = React.useState(() => createMockStreamChatClient(mockUser))
 
   const [channel, setChannel] = React.useState<ChannelType | null>(null)
 
@@ -591,14 +578,7 @@ WithStarButton.parameters = {
 }
 
 const EmptyTemplate: StoryFn<ComponentProps> = (args) => {
-  const [client] = React.useState(() => {
-    const client = new StreamChat('mock-api-key', {
-      allowServerSideConnect: true,
-    })
-    client.userID = mockUser.id
-    client.user = mockUser
-    return client
-  })
+  const [client] = React.useState(() => createMockStreamChatClient(mockUser))
 
   const [channel, setChannel] = React.useState<ChannelType | null>(null)
 

package/src/components/CustomMessage/CustomMessage.stories.tsx

@@ -22,6 +22,7 @@ import {
   StoryUser,
   storyUsers,
 } from '../../stories/decorators/storyUser'
+import { createMockStreamChatClient } from '../../testing/createMockStreamChatClient'
 import CustomTypingIndicator from '../CustomTypingIndicator'
 
 import { CustomMessageActions } from './CustomMessageActions'
@@ -134,12 +135,7 @@ const TemplateInner: React.FC<{
   typingUser?: StoryUser
   messages: TemplateProps['messages']
 }> = ({ currentUser, typingUser, messages }) => {
-  const [client] = React.useState(() => {
-    const c = new StreamChat('mock-api-key', { allowServerSideConnect: true })
-    c.userID = currentUser.id
-    c.user = currentUser
-    return c
-  })
+  const [client] = React.useState(() => createMockStreamChatClient(currentUser))
 
   const [channel, setChannel] = React.useState<ChannelType | null>(null)
 
@@ -464,12 +460,7 @@ const WithActionsTemplateInner: React.FC<{
   currentUser: StoryUser
   messages: TemplateProps['messages']
 }> = ({ currentUser, messages }) => {
-  const [client] = React.useState(() => {
-    const c = new StreamChat('mock-api-key', { allowServerSideConnect: true })
-    c.userID = currentUser.id
-    c.user = currentUser
-    return c
-  })
+  const [client] = React.useState(() => createMockStreamChatClient(currentUser))
 
   const [channel, setChannel] = React.useState<ChannelType | null>(null)
 

package/src/components/CustomMessageInput/CustomMessageInput.stories.tsx

@@ -4,6 +4,7 @@ import React, { useEffect } from 'react'
 import { QueryChannelAPIResponse, StreamChat } from 'stream-chat'
 import { Channel, Chat, type SendButtonProps } from 'stream-chat-react'
 
+import { createMockStreamChatClient } from '../../testing/createMockStreamChatClient'
 import LockedAttachment from '../LockedAttachment'
 
 import { CustomMessageInput } from '.'
@@ -79,12 +80,7 @@ type WrapperProps = {
 const Wrapper: React.FC<WrapperProps> = (props) => {
   const { frozen, renderActions, sendButton, attachmentPreviewList, renderFooter } = props
 
-  const [client] = React.useState(() => {
-    const c = new StreamChat('mock-api-key', { allowServerSideConnect: true })
-    c.userID = mockUser.id
-    c.user = mockUser
-    return c
-  })
+  const [client] = React.useState(() => createMockStreamChatClient(mockUser))
 
   const [channel, setChannel] = React.useState<ReturnType<StreamChat['channel']> | null>(null)
 

package/src/stories/mocks.tsx

@@ -1,7 +1,8 @@
 import React from 'react'
-import { ConnectionOpen, StreamChat } from 'stream-chat'
 import { Chat } from 'stream-chat-react'
 
+import { createMockStreamChatClient } from '../testing/createMockStreamChatClient'
+
 // Mock Stream Chat client for Storybook
 const mockUser = {
   id: 'storybook-user',
@@ -9,25 +10,8 @@ const mockUser = {
   image: 'https://i.pravatar.cc/150?img=1',
 }
 
-const createMockClient = () => {
-  const client = new StreamChat('mock-api-key', {
-    allowServerSideConnect: true,
-  })
-
-  // Mock the client methods
-  client.connectUser = async () => {
-    return { me: mockUser } as unknown as ConnectionOpen
-  }
-
-  client.disconnectUser = async () => {
-    return Promise.resolve()
-  }
-
-  client.userID = mockUser.id
-  client.user = mockUser
-
-  return client
-}
+const createMockClient = () =>
+  createMockStreamChatClient(mockUser, { stubConnection: true })
 
 export const MockChatProvider: React.FC<{ children: React.ReactNode }> = ({
   children,

package/src/testing/createMockMessagingClient.ts

@@ -6,6 +6,8 @@ import type {
 } from 'stream-chat'
 import { StreamChat } from 'stream-chat'
 
+import { createMockStreamChatClient } from './createMockStreamChatClient'
+
 /** A participant in the mock conversation. */
 export interface MockMessagingUser {
   id: string
@@ -77,25 +79,15 @@ export function createMockMessagingClient({
   channelId = 'mock-dm',
   onSend,
 }: CreateMockMessagingClientOptions): MockMessagingClient {
-  const client = new StreamChat('mock-api-key', {
-    allowServerSideConnect: true,
+  // Offline client marked connected without a WebSocket. `stubConnection` also
+  // no-ops connectUser/disconnectUser/userMuteStatus: `MessagingProvider`
+  // renders `<Chat client={client}>` directly so it never calls connectUser,
+  // and handling the `message.new` events dispatched on send + echo below runs
+  // Channel._countMessageAsUnread → client.userMuteStatus, which throws offline.
+  const client = createMockStreamChatClient(currentUser, {
+    stubConnection: true,
   })
 
-  // Mark connected without opening a WebSocket. `MessagingProvider` renders
-  // `<Chat client={client}>` directly for an injected client, so it never
-  // calls connectUser itself.
-  client.connectUser = async () => ({ me: currentUser }) as never
-  client.disconnectUser = async () => undefined
-  client.userID = currentUser.id
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  client.user = currentUser as any
-  // Handling a `message.new` event (dispatched on send + echo below) runs
-  // Channel._countMessageAsUnread → client.userMuteStatus, which throws
-  // "Make sure to await connectUser() first." without a live WebSocket. Stub
-  // the mute lookups so offline event dispatch doesn't throw.
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  client.userMuteStatus = (() => false) as any
-
   const cid = `messaging:${channelId}`
 
   const toStreamMessage = (

package/src/testing/createMockStreamChatClient.ts

@@ -0,0 +1,44 @@
+import { StreamChat } from 'stream-chat'
+
+import type { MockMessagingUser } from './createMockMessagingClient'
+
+/* eslint-disable @typescript-eslint/no-explicit-any */
+
+export interface CreateMockStreamChatClientOptions {
+  /**
+   * Also replace the connection-dependent client methods (`connectUser`,
+   * `disconnectUser`, `userMuteStatus`) with offline no-ops. Needed when the
+   * client drives a flow that would otherwise open a WebSocket or throw
+   * "Make sure to await connectUser() first." offline. Direct `<Chat client>`
+   * rendering (e.g. component stories) does not need this.
+   */
+  stubConnection?: boolean
+}
+
+/**
+ * Builds an offline `StreamChat` for mocks and stories: a real client on a
+ * throwaway api key with `userID`/`user` set so `<Chat>` treats it as
+ * connected without a backend. The single place that knows how to construct a
+ * connectionless Stream client, so a stream-chat version bump only needs
+ * updating here rather than in each mock surface.
+ */
+export function createMockStreamChatClient(
+  user: MockMessagingUser,
+  { stubConnection = false }: CreateMockStreamChatClientOptions = {}
+): StreamChat {
+  const client = new StreamChat('mock-api-key', {
+    allowServerSideConnect: true,
+  })
+  client.userID = user.id
+  client.user = user as any
+
+  if (stubConnection) {
+    client.connectUser = async () => ({ me: user }) as any
+    client.disconnectUser = async () => undefined
+    client.userMuteStatus = (() => false) as any
+  }
+
+  return client
+}
+
+/* eslint-enable @typescript-eslint/no-explicit-any */