@linktr.ee/messaging-react 1.24.3 → 1.24.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linktr.ee/messaging-react",
-  "version": "1.24.3",
+  "version": "1.24.4",
   "description": "React messaging components built on messaging-core for web applications",
   "type": "module",
   "main": "dist/index.js",

package/src/components/ChannelList/index.test.tsx

@@ -0,0 +1,79 @@
+import React from 'react'
+import { describe, expect, it, vi, beforeEach } from 'vitest'
+
+import { renderWithProviders } from '../../test/utils'
+
+import { ChannelList } from '.'
+
+const streamChannelListMock = vi.fn()
+
+vi.mock('stream-chat-react', () => ({
+  ChannelList: (props: unknown) => {
+    streamChannelListMock(props)
+    return <div data-testid="stream-channel-list" />
+  },
+}))
+
+vi.mock('../../providers/MessagingProvider', () => ({
+  useMessagingContext: () => ({ debug: false }),
+}))
+
+vi.mock('./CustomChannelPreview', () => ({
+  default: () => null,
+}))
+
+describe('ChannelList', () => {
+  const defaultProps = {
+    filters: { type: 'messaging' },
+    onChannelSelect: vi.fn(),
+  }
+
+  beforeEach(() => {
+    streamChannelListMock.mockClear()
+  })
+
+  it('defaults unseen-channel promotion to false', () => {
+    renderWithProviders(<ChannelList {...defaultProps} />)
+
+    expect(streamChannelListMock).toHaveBeenCalledOnce()
+    expect(streamChannelListMock.mock.calls[0][0]).toMatchObject({
+      allowNewMessagesFromUnfilteredChannels: false,
+    })
+  })
+
+  it('passes allowNewMessagesFromUnfilteredChannels through to Stream ChannelList', () => {
+    const props: React.ComponentProps<typeof ChannelList> = {
+      ...defaultProps,
+      allowNewMessagesFromUnfilteredChannels: true,
+    }
+
+    renderWithProviders(React.createElement(ChannelList, props))
+
+    expect(streamChannelListMock).toHaveBeenCalledOnce()
+    expect(streamChannelListMock.mock.calls[0][0]).toMatchObject({
+      allowNewMessagesFromUnfilteredChannels: true,
+    })
+  })
+
+  it('passes new-channel event handlers through to Stream ChannelList', () => {
+    const onMessageNew = vi.fn()
+    const onAddedToChannel = vi.fn()
+
+    renderWithProviders(
+      React.createElement(ChannelList, {
+        ...defaultProps,
+        onMessageNew,
+        onAddedToChannel,
+      })
+    )
+
+    expect(streamChannelListMock).toHaveBeenCalledOnce()
+    const streamProps = streamChannelListMock.mock.calls[0][0] as {
+      onMessageNew?: unknown
+      onAddedToChannel?: unknown
+    }
+
+    expect(streamProps.onMessageNew).toBe(onMessageNew)
+    expect(streamProps.onAddedToChannel).toBe(onAddedToChannel)
+  })
+})

package/src/components/ChannelList/index.tsx

@@ -18,6 +18,9 @@ export const ChannelList = React.memo<ChannelListProps>(
     onChannelSelect,
     selectedChannel,
     filters,
+    allowNewMessagesFromUnfilteredChannels = false,
+    onMessageNew,
+    onAddedToChannel,
     sort = DEFAULT_SORT,
     className,
     customEmptyStateIndicator,
@@ -63,7 +66,11 @@ export const ChannelList = React.memo<ChannelListProps>(
               filters={filters}
               sort={sort}
               options={{ limit: 30 }}
-              allowNewMessagesFromUnfilteredChannels={false}
+              allowNewMessagesFromUnfilteredChannels={
+                allowNewMessagesFromUnfilteredChannels
+              }
+              onMessageNew={onMessageNew}
+              onAddedToChannel={onAddedToChannel}
               Preview={CustomChannelPreview}
               EmptyStateIndicator={customEmptyStateIndicator}
             />

package/src/types.ts

@@ -9,7 +9,10 @@ import type {
   LocalMessage,
   SendMessageAPIResponse,
 } from 'stream-chat'
-import { EmptyStateIndicatorProps } from 'stream-chat-react'
+import type {
+  ChannelListProps as StreamChannelListProps,
+  EmptyStateIndicatorProps,
+} from 'stream-chat-react'
 
 import type { MessageMetadata } from './stream-custom-data'
 
@@ -68,6 +71,26 @@ export interface ChannelListProps {
   participantLabel?: string
   className?: string
   filters: ChannelFilters
+  /**
+   * Controls whether new-message events can promote channels that are not
+   * already present in the current list.
+   *
+   * Defaults to `false` for backward compatibility with existing filtered
+   * ChannelList consumers.
+   */
+  allowNewMessagesFromUnfilteredChannels?: boolean
+  /**
+   * Advanced override for handling `notification.message_new` events.
+   * Use for filtered/product-defined views that need to verify whether a
+   * channel belongs in the current list before inserting it.
+   */
+  onMessageNew?: StreamChannelListProps['onMessageNew']
+  /**
+   * Advanced override for handling `notification.added_to_channel` events.
+   * Use for filtered/product-defined views that need to verify whether a
+   * channel belongs in the current list before inserting it.
+   */
+  onAddedToChannel?: StreamChannelListProps['onAddedToChannel']
   /**
    * Sort order for the channel list query.
    * Defaults to `{ last_message_at: -1 }` (most recent first).