@linktr.ee/messaging-react 1.7.2 → 1.8.0

package/dist/providers/MessagingProvider.d.ts

@@ -0,0 +1,27 @@
+import { StreamChatService } from '@linktr.ee/messaging-core';
+import React from 'react';
+import type { StreamChat } from 'stream-chat';
+import type { MessagingProviderProps, MessagingCapabilities, MessagingCustomization } from '../types';
+/**
+ * Context value for messaging state and service
+ */
+export interface MessagingContextValue {
+    service: StreamChatService | null;
+    client: StreamChat | null;
+    isConnected: boolean;
+    isLoading: boolean;
+    error: string | null;
+    capabilities: MessagingCapabilities;
+    customization: MessagingCustomization;
+    refreshConnection: () => Promise<void>;
+    debug: boolean;
+}
+/**
+ * Hook to access messaging context
+ */
+export declare const useMessagingContext: () => MessagingContextValue;
+/**
+ * Provider component that wraps messaging-core with React state management
+ */
+export declare const MessagingProvider: React.FC<MessagingProviderProps>;
+//# sourceMappingURL=MessagingProvider.d.ts.map

package/dist/providers/MessagingProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MessagingProvider.d.ts","sourceRoot":"","sources":["../../src/providers/MessagingProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,KAON,MAAM,OAAO,CAAA;AACd,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,UAAU,CAAA;AAEjB;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAA;IACjC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAA;IACzB,WAAW,EAAE,OAAO,CAAA;IACpB,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,YAAY,EAAE,qBAAqB,CAAA;IACnC,aAAa,EAAE,sBAAsB,CAAA;IACrC,iBAAiB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC,KAAK,EAAE,OAAO,CAAA;CACf;AAcD;;GAEG;AACH,eAAO,MAAM,mBAAmB,6BAAqC,CAAA;AAErE;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAkT9D,CAAA"}

package/dist/stories/mocks.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+export declare const MockChatProvider: React.FC<{
+    children: React.ReactNode;
+}>;
+export declare const MockChatProviderWithChannels: React.FC<{
+    children: React.ReactNode;
+    channelCount?: number;
+}>;
+export declare const mockParticipants: {
+    id: string;
+    name: string;
+    email: string;
+    image: string;
+}[];
+export declare const mockParticipantSource: {
+    loadParticipants: (options?: {
+        search?: string;
+        limit?: number;
+    }) => Promise<{
+        participants: {
+            id: string;
+            name: string;
+            email: string;
+            image: string;
+        }[];
+        hasMore: boolean;
+    }>;
+};
+//# sourceMappingURL=mocks.d.ts.map

package/dist/stories/mocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mocks.d.ts","sourceRoot":"","sources":["../../src/stories/mocks.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AA+BzB,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,CAYpE,CAAA;AAGD,eAAO,MAAM,4BAA4B,EAAE,KAAK,CAAC,EAAE,CAAC;IAClD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAwDA,CAAA;AAGD,eAAO,MAAM,gBAAgB;;;;;GA+B5B,CAAA;AAGD,eAAO,MAAM,qBAAqB;iCACG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;;CAYvE,CAAA"}

package/dist/test/setup.d.ts

@@ -0,0 +1,2 @@
+import '@testing-library/jest-dom/vitest';
+//# sourceMappingURL=setup.d.ts.map

package/dist/test/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/test/setup.ts"],"names":[],"mappings":"AAAA,OAAO,kCAAkC,CAAA"}

package/dist/test/utils.d.ts

@@ -0,0 +1,12 @@
+import { RenderOptions, RenderResult } from '@testing-library/react';
+import { ReactElement } from 'react';
+/**
+ * Custom render function that wraps components with common providers
+ */
+export declare function renderWithProviders(ui: ReactElement, options?: Omit<RenderOptions, 'wrapper'>): RenderResult;
+/**
+ * Re-export everything from React Testing Library
+ */
+export * from '@testing-library/react';
+export { default as userEvent } from '@testing-library/user-event';
+//# sourceMappingURL=utils.d.ts.map

package/dist/test/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/test/utils.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAU,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAC5E,OAAO,EAAE,YAAY,EAAa,MAAM,OAAO,CAAA;AAE/C;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,YAAY,EAChB,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,GACvC,YAAY,CAMd;AAED;;GAEG;AACH,cAAc,wBAAwB,CAAA;AACtC,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,6BAA6B,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,138 @@
+import type { MessagingUser, StreamChatServiceConfig } from '@linktr.ee/messaging-core';
+import type { Channel, ChannelFilters } from 'stream-chat';
+/**
+ * Generic participant interface for different host environments
+ */
+export interface Participant {
+    id: string;
+    name: string;
+    email?: string;
+    image?: string;
+    username?: string;
+    phone?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Source for loading participants (followers, team members, etc.)
+ */
+export interface ParticipantSource {
+    loadParticipants: (options?: {
+        search?: string;
+        limit?: number;
+        cursor?: string;
+    }) => Promise<{
+        participants: Participant[];
+        hasMore: boolean;
+        nextCursor?: string;
+    }>;
+    totalCount?: number;
+    loading?: boolean;
+}
+/**
+ * Messaging capabilities configuration
+ */
+export interface MessagingCapabilities {
+    showStartConversation?: boolean;
+    participantSource?: ParticipantSource;
+    participantLabel?: string;
+}
+/**
+ * Customization options
+ */
+export interface MessagingCustomization {
+    theme?: 'light' | 'dark' | 'auto';
+    accentColor?: string;
+}
+/**
+ * Main MessagingShell component props
+ */
+export interface MessagingShellProps {
+    capabilities?: MessagingCapabilities;
+    customization?: MessagingCustomization;
+    className?: string;
+    renderMessageInputActions?: (channel: Channel) => React.ReactNode;
+    onChannelSelect?: (channel: Channel) => void;
+    onParticipantSelect?: (participant: Participant) => void;
+    /**
+     * Auto-select a conversation with this participant on mount.
+     * Useful for deep-linking to a specific conversation (e.g., /messages/[accountUuid])
+     *
+     * If a channel with this participant exists, it will be auto-selected.
+     * If no channel exists, you can provide initialParticipantData to automatically
+     * create the channel using the existing ChannelCreator.
+     */
+    initialParticipantFilter?: string;
+    /**
+     * Participant data for auto-creating a channel when initialParticipantFilter
+     * is provided but no channel exists. If this is provided, MessagingShell will
+     * automatically call service.startChannelWithParticipant() to create the channel.
+     *
+     * This reuses the existing ChannelCreator from StreamChatServiceConfig.
+     */
+    initialParticipantData?: Participant;
+    /**
+     * Custom empty state component to render when a channel has no messages.
+     * Useful for showing FAQs or other contextual information in empty channels.
+     */
+    CustomChannelEmptyState?: React.ComponentType;
+    /**
+     * Controls whether the channel list is shown. When false, the channel list
+     * is immediately hidden. Useful for direct conversation mode where you want
+     * to show only the channel view without the list.
+     */
+    showChannelList?: boolean;
+    /**
+     * Filters for channel list. Passed through to StreamChat ChannelList.
+     */
+    filters?: ChannelFilters;
+}
+/**
+ * ChannelList component props
+ */
+export interface ChannelListProps {
+    onChannelSelect: (channel: Channel) => void;
+    selectedChannel?: Channel;
+    showStartConversation?: boolean;
+    onStartConversation?: () => void;
+    participantLabel?: string;
+    className?: string;
+    filters: ChannelFilters;
+}
+/**
+ * ChannelView component props
+ */
+export interface ChannelViewProps {
+    channel: Channel;
+    onBack?: () => void;
+    showBackButton?: boolean;
+    renderMessageInputActions?: (channel: Channel) => React.ReactNode;
+    onLeaveConversation?: (channel: Channel) => void;
+    onBlockParticipant?: (participantId?: string) => void;
+    className?: string;
+    CustomChannelEmptyState?: React.ComponentType;
+}
+/**
+ * ParticipantPicker component props
+ */
+export interface ParticipantPickerProps {
+    participantSource: ParticipantSource;
+    onSelectParticipant: (participant: Participant) => void;
+    onClose: () => void;
+    existingParticipantIds?: Set<string>;
+    participantLabel?: string;
+    searchPlaceholder?: string;
+    className?: string;
+}
+/**
+ * MessagingProvider component props
+ */
+export interface MessagingProviderProps {
+    children: React.ReactNode;
+    user: MessagingUser | null;
+    serviceConfig: Omit<StreamChatServiceConfig, 'apiKey'>;
+    apiKey: string;
+    capabilities?: MessagingCapabilities;
+    customization?: MessagingCustomization;
+    debug?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,uBAAuB,EACxB,MAAM,2BAA2B,CAAA;AAClC,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE1D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,EAAE,CAAC,OAAO,CAAC,EAAE;QAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,KAAK,OAAO,CAAC;QACZ,YAAY,EAAE,WAAW,EAAE,CAAA;QAC3B,OAAO,EAAE,OAAO,CAAA;QAChB,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB,CAAC,CAAA;IACF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC,aAAa,CAAC,EAAE,sBAAsB,CAAA;IACtC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,yBAAyB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,KAAK,CAAC,SAAS,CAAA;IACjE,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IAC5C,mBAAmB,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,CAAA;IAExD;;;;;;;OAOG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAA;IAEjC;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,WAAW,CAAA;IAEpC;;;OAGG;IACH,uBAAuB,CAAC,EAAE,KAAK,CAAC,aAAa,CAAA;IAE7C;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IAEzB;;OAEG;IACH,OAAO,CAAC,EAAE,cAAc,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IAC3C,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAA;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,cAAc,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,yBAAyB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,KAAK,CAAC,SAAS,CAAA;IACjE,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IAChD,kBAAkB,CAAC,EAAE,CAAC,aAAa,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IACrD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uBAAuB,CAAC,EAAE,KAAK,CAAC,aAAa,CAAA;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,iBAAiB,EAAE,iBAAiB,CAAA;IACpC,mBAAmB,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,CAAA;IACvD,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,sBAAsB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,IAAI,EAAE,aAAa,GAAG,IAAI,CAAA;IAC1B,aAAa,EAAE,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC,CAAA;IACtD,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC,aAAa,CAAC,EAAE,sBAAsB,CAAA;IACtC,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB"}

package/package.json

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

package/src/components/ChannelList/index.tsx

@@ -1,33 +1,19 @@
-import SelectPill from '@linktr.ee/component-library/InputSelectPill'
-import SelectPillGroup from '@linktr.ee/component-library/InputSelectPillGroup'
-import { NotePencilIcon } from '@phosphor-icons/react'
 import classNames from 'classnames'
-import React, { useState } from 'react'
-import {
-  ChannelList as StreamChannelList,
-  useChatContext,
-} from 'stream-chat-react'
+import React from 'react'
+import { ChannelList as StreamChannelList } from 'stream-chat-react'
 
 import { useMessagingContext } from '../../providers/MessagingProvider'
 import type { ChannelListProps } from '../../types'
-import { IconButton } from '../IconButton'
 
 import CustomChannelPreview from './CustomChannelPreview'
 
-enum ChannelFilter {
-  All,
-  Unread,
-}
-
 /**
  * Channel list component with customizable header and actions
  */
 export const ChannelList: React.FC<ChannelListProps> = ({
   onChannelSelect,
   selectedChannel,
-  showStartConversation = false,
-  onStartConversation,
-  participantLabel = 'participants',
+  filters,
   className,
 }) => {
   // Track renders
@@ -41,55 +27,10 @@ export const ChannelList: React.FC<ChannelListProps> = ({
     console.log('📺 [ChannelList] 🔄 RENDER START', {
       renderCount: renderCountRef.current,
       selectedChannelId: selectedChannel?.id,
-      showStartConversation,
-      participantLabel,
+      filters,
     })
   }
 
-  const { client } = useChatContext()
-
-  if (debug) {
-    console.log('📺 [ChannelList] 📡 CHAT CONTEXT', {
-      renderCount: renderCountRef.current,
-      hasClient: !!client,
-      clientUserId: client?.userID,
-      clientConnected: client?.wsConnection?.isHealthy,
-    })
-  }
-
-  const [staticFilters, setStaticFilters] = useState<{
-    type: string
-    last_message_at: { $exists: boolean }
-    has_unread: boolean | undefined
-  }>({
-    type: 'messaging',
-    last_message_at: { $exists: true },
-    has_unread: undefined,
-  })
-
-  // Filter for messaging channels
-  const filters = React.useMemo(() => {
-    const userId = client.userID
-
-    const newFilters = {
-      ...staticFilters,
-      ...(userId && {
-        members: { $in: [userId] },
-        hidden: false,
-      }),
-    }
-
-    if (debug) {
-      console.log('📺 [ChannelList] 🔍 FILTERS MEMOIZED', {
-        renderCount: renderCountRef.current,
-        userId,
-        filters: newFilters,
-      })
-    }
-
-    return newFilters
-  }, [client.userID, debug, staticFilters])
-
   return (
     <div
       className={classNames(
@@ -97,49 +38,6 @@ export const ChannelList: React.FC<ChannelListProps> = ({
         className
       )}
     >
-      {/* Header */}
-      <div className="px-4 py-4 border-b border-sand bg-chalk">
-        <div className="flex items-center justify-between gap-3 min-h-10 min-w-0">
-          <div>
-            <h2 className="text-lg font-semibold text-charcoal">
-              Conversations
-            </h2>
-            <SelectPillGroup>
-              <SelectPill
-                checked={!filters.has_unread}
-                name="All"
-                onChange={() =>
-                  setStaticFilters((state) => ({
-                    ...state,
-                    has_unread: undefined,
-                  }))
-                }
-                value={ChannelFilter.All}
-              />
-              <SelectPill
-                checked={filters.has_unread}
-                name="Unread"
-                onChange={() =>
-                  setStaticFilters((state) => ({ ...state, has_unread: true }))
-                }
-                value={ChannelFilter.Unread}
-              />
-            </SelectPillGroup>
-          </div>
-          <div className="flex items-center gap-2">
-            {showStartConversation && onStartConversation && (
-              <IconButton
-                label="Start a new conversation"
-                onClick={onStartConversation}
-                className="inline-flex size-10 items-center justify-center"
-              >
-                <NotePencilIcon className="h-5 w-5" />
-              </IconButton>
-            )}
-          </div>
-        </div>
-      </div>
-
       {/* Channel List */}
       <div className="flex-1 overflow-hidden min-w-0">
         {(() => {
@@ -147,13 +45,12 @@ export const ChannelList: React.FC<ChannelListProps> = ({
             console.log('📺 [ChannelList] 🎬 RENDERING STREAM CHANNEL LIST', {
               renderCount: renderCountRef.current,
               filters,
-              hasClient: !!client,
-              clientUserId: client?.userID,
             })
           }
 
           return (
             <StreamChannelList
+              key={JSON.stringify(filters)}
               filters={filters}
               sort={{ last_message_at: -1 }}
               options={{ limit: 30 }}

package/src/components/FaqList/FaqListItem.tsx

@@ -1,6 +1,5 @@
 import classNames from 'classnames'
 import React from 'react'
-
 export interface FaqListItemProps {
   question: string
   onClick: () => void

package/src/components/MessagingShell/index.tsx

@@ -25,6 +25,7 @@ export const MessagingShell: React.FC<MessagingShellProps> = ({
   initialParticipantData,
   CustomChannelEmptyState,
   showChannelList = true,
+  filters,
 }) => {
   const {
     service,
@@ -56,6 +57,28 @@ export const MessagingShell: React.FC<MessagingShellProps> = ({
     participantLabel = 'participants',
   } = capabilities
 
+  // Create default filters and merge with provided filters
+  const channelFilters = React.useMemo(() => {
+    const userId = client?.userID
+
+    // Base filters that should always be present
+    const baseFilters = {
+      type: 'messaging',
+      last_message_at: { $exists: true },
+      ...(userId && {
+        members: { $in: [userId] },
+        hidden: false,
+      }),
+    }
+
+    // Merge provided filters with base filters
+    // Provided filters can override base filters if needed
+    return {
+      ...baseFilters,
+      ...filters,
+    }
+  }, [filters, client?.userID])
+
   // Track if we've already synced channels to prevent repeated API calls
   const syncedRef = useRef<string | null>(null)
 
@@ -405,11 +428,7 @@ export const MessagingShell: React.FC<MessagingShellProps> = ({
           <ChannelList
             onChannelSelect={handleChannelSelect}
             selectedChannel={selectedChannel || undefined}
-            showStartConversation={
-              showStartConversation && Boolean(participantSource)
-            }
-            onStartConversation={handleStartConversation}
-            participantLabel={participantLabel}
+            filters={channelFilters}
           />
         </div>
 

package/src/types.ts

@@ -2,7 +2,7 @@ import type {
   MessagingUser,
   StreamChatServiceConfig,
 } from '@linktr.ee/messaging-core'
-import type { Channel } from 'stream-chat'
+import type { Channel, ChannelFilters } from 'stream-chat'
 
 /**
  * Generic participant interface for different host environments
@@ -49,7 +49,6 @@ export interface MessagingCapabilities {
 export interface MessagingCustomization {
   theme?: 'light' | 'dark' | 'auto'
   accentColor?: string
-  showParticipantStatus?: boolean
 }
 
 /**
@@ -94,6 +93,11 @@ export interface MessagingShellProps {
    * to show only the channel view without the list.
    */
   showChannelList?: boolean
+
+  /**
+   * Filters for channel list. Passed through to StreamChat ChannelList.
+   */
+  filters?: ChannelFilters
 }
 
 /**
@@ -106,6 +110,7 @@ export interface ChannelListProps {
   onStartConversation?: () => void
   participantLabel?: string
   className?: string
+  filters: ChannelFilters
 }
 
 /**