@linktr.ee/messaging-react 1.12.0 → 1.12.1

package/dist/index.d.ts

@@ -1,18 +1,315 @@
-import './styles.css';
-export { MessagingShell } from './components/MessagingShell';
-export { ChannelList } from './components/ChannelList';
-export { ChannelView } from './components/ChannelView';
-export { ParticipantPicker } from './components/ParticipantPicker';
-export { Avatar } from './components/Avatar';
-export { FaqList } from './components/FaqList';
-export { FaqListItem } from './components/FaqList/FaqListItem';
-export { ChannelEmptyState } from './components/MessagingShell/ChannelEmptyState';
-export { MessagingProvider } from './providers/MessagingProvider';
-export { useMessaging } from './hooks/useMessaging';
-export { useParticipants } from './hooks/useParticipants';
-export { formatRelativeTime } from './utils/formatRelativeTime';
-export type { MessagingShellProps, ChannelListProps, ChannelViewProps, ParticipantPickerProps, MessagingProviderProps, MessagingCapabilities, ParticipantSource, Participant, } from './types';
-export type { AvatarProps } from './components/Avatar';
-export type { Faq, FaqListProps } from './components/FaqList';
-export type { FaqListItemProps } from './components/FaqList/FaqListItem';
-//# sourceMappingURL=index.d.ts.map
+import { Channel } from 'stream-chat';
+import { ChannelFilters } from 'stream-chat';
+import { default as default_2 } from 'react';
+import { EmptyStateIndicatorProps } from 'stream-chat-react';
+import { MessagingUser } from '@linktr.ee/messaging-core';
+import { StreamChat } from 'stream-chat';
+import { StreamChatService } from '@linktr.ee/messaging-core';
+import { StreamChatServiceConfig } from '@linktr.ee/messaging-core';
+
+/**
+ * Avatar component that displays a user image or colored initial fallback
+ */
+export declare const Avatar: default_2.FC<AvatarProps>;
+
+export declare interface AvatarProps {
+    id: string;
+    name: string;
+    image?: string;
+    size?: number;
+    className?: string;
+    shape?: 'squircle' | 'circle';
+}
+
+/**
+ * Empty state component shown when a channel has no messages
+ */
+export declare const ChannelEmptyState: default_2.FC;
+
+/**
+ * Channel list component with customizable header and actions
+ */
+export declare const ChannelList: default_2.NamedExoticComponent<ChannelListProps>;
+
+/**
+ * ChannelList component props
+ */
+export declare interface ChannelListProps {
+    onChannelSelect: (channel: Channel) => void;
+    selectedChannel?: Channel;
+    showStartConversation?: boolean;
+    onStartConversation?: () => void;
+    participantLabel?: string;
+    className?: string;
+    filters: ChannelFilters;
+    customEmptyStateIndicator?: React.ComponentType<EmptyStateIndicatorProps>;
+}
+
+/**
+ * Channel view component with message list and input
+ */
+export declare const ChannelView: default_2.NamedExoticComponent<ChannelViewProps>;
+
+/**
+ * ChannelView component props
+ */
+export declare 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;
+    /**
+     * Show the "Delete Conversation" button in channel info dialog.
+     * Defaults to true for backward compatibility.
+     */
+    showDeleteConversation?: boolean;
+    /**
+     * Analytics callback fired when "Delete Conversation" is clicked.
+     */
+    onDeleteConversationClick?: () => void;
+    /**
+     * Analytics callback fired when "Block" or "Unblock" is clicked.
+     */
+    onBlockParticipantClick?: () => void;
+    /**
+     * Analytics callback fired when "Report" is clicked.
+     */
+    onReportParticipantClick?: () => void;
+}
+
+export declare interface Faq {
+    id: string;
+    question: string;
+    answer: string;
+    enabled: boolean;
+    order?: number | null;
+}
+
+export declare const FaqList: default_2.FC<FaqListProps>;
+
+export declare const FaqListItem: default_2.FC<FaqListItemProps>;
+
+export declare interface FaqListItemProps {
+    question: string;
+    onClick: () => void;
+    loading?: boolean;
+    className?: string;
+}
+
+export declare interface FaqListProps {
+    faqs: Faq[];
+    onFaqClick: (faqId: string) => void;
+    loadingFaqId?: string | null;
+    headerText?: string;
+    className?: string;
+    avatarImage?: string;
+    avatarName?: string;
+}
+
+/**
+ * Format a date - shows time for today, relative time for older messages
+ * (e.g., "Just now", "2:08 PM" for today, "Yesterday" for yesterday, "2d" for 2 days ago)
+ */
+export declare const formatRelativeTime: (date: Date) => string;
+
+/**
+ * Messaging capabilities configuration
+ */
+export declare interface MessagingCapabilities {
+    showStartConversation?: boolean;
+    participantSource?: ParticipantSource;
+    participantLabel?: string;
+    /**
+     * Show the "Delete Conversation" button in channel info dialog.
+     * Defaults to true for backward compatibility.
+     */
+    showDeleteConversation?: boolean;
+}
+
+/**
+ * Context value for messaging state and service
+ */
+declare interface MessagingContextValue {
+    service: StreamChatService | null;
+    client: StreamChat | null;
+    isConnected: boolean;
+    isLoading: boolean;
+    error: string | null;
+    capabilities: MessagingCapabilities;
+    refreshConnection: () => Promise<void>;
+    debug: boolean;
+}
+
+/**
+ * Provider component that wraps messaging-core with React state management
+ */
+export declare const MessagingProvider: default_2.FC<MessagingProviderProps>;
+
+/**
+ * MessagingProvider component props
+ */
+export declare interface MessagingProviderProps {
+    children: React.ReactNode;
+    user: MessagingUser | null;
+    serviceConfig: Omit<StreamChatServiceConfig, 'apiKey'>;
+    apiKey: string;
+    capabilities?: MessagingCapabilities;
+    debug?: boolean;
+}
+
+/**
+ * Main messaging interface component that combines channel list and channel view
+ */
+export declare const MessagingShell: default_2.FC<MessagingShellProps>;
+
+/**
+ * Main MessagingShell component props
+ */
+export declare interface MessagingShellProps {
+    capabilities?: MessagingCapabilities;
+    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;
+    /**
+     * Custom empty state indicator component to render when the channel list is empty.
+     * Useful for showing a custom empty state indicator when the channel list is empty.
+     */
+    channelListCustomEmptyStateIndicator?: React.ComponentType<EmptyStateIndicatorProps>;
+    /**
+     * Analytics callback fired when "Delete Conversation" is clicked.
+     * Called before the action is performed.
+     */
+    onDeleteConversationClick?: () => void;
+    /**
+     * Analytics callback fired when "Block" or "Unblock" is clicked.
+     * Called before the action is performed.
+     */
+    onBlockParticipantClick?: () => void;
+    /**
+     * Analytics callback fired when "Report" is clicked.
+     * Called before the action is performed.
+     */
+    onReportParticipantClick?: () => void;
+}
+
+/**
+ * Generic participant interface for different host environments
+ */
+export declare interface Participant {
+    id: string;
+    name: string;
+    email?: string;
+    image?: string;
+    username?: string;
+    phone?: string;
+    metadata?: Record<string, unknown>;
+}
+
+/**
+ * Generic participant picker component for starting conversations
+ */
+export declare const ParticipantPicker: default_2.FC<ParticipantPickerProps>;
+
+/**
+ * ParticipantPicker component props
+ */
+export declare interface ParticipantPickerProps {
+    participantSource: ParticipantSource;
+    onSelectParticipant: (participant: Participant) => void;
+    onClose: () => void;
+    existingParticipantIds?: Set<string>;
+    participantLabel?: string;
+    searchPlaceholder?: string;
+    className?: string;
+}
+
+/**
+ * Source for loading participants (followers, team members, etc.)
+ */
+export declare interface ParticipantSource {
+    loadParticipants: (options?: {
+        search?: string;
+        limit?: number;
+        cursor?: string;
+    }) => Promise<{
+        participants: Participant[];
+        hasMore: boolean;
+        nextCursor?: string;
+    }>;
+    totalCount?: number;
+    loading?: boolean;
+}
+
+/**
+ * Hook to access messaging service and state
+ */
+export declare const useMessaging: () => MessagingContextValue;
+
+/**
+ * Hook for managing participant loading with search and pagination
+ */
+export declare const useParticipants: (participantSource: ParticipantSource, options?: {
+    initialSearch?: string;
+    pageSize?: number;
+}) => {
+    participants: Participant[];
+    loading: boolean;
+    error: string | null;
+    searchQuery: string;
+    hasMore: boolean;
+    totalCount: number | undefined;
+    loadMore: () => void;
+    search: (query: string) => void;
+    refresh: () => void;
+};
+
+export { }
+
+
+declare module 'stream-chat' {
+    interface CustomMessageData {
+        /**
+         * When true, hides the date timestamp in system messages.
+         * Used by CustomSystemMessage component.
+         */
+        hide_date?: boolean;
+    }
+}
+

package/package.json

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