@cdevhub/ngx-chat 1.0.6

package/fesm2022/cdevhub-ngx-chat-testing.mjs

@@ -0,0 +1,950 @@
+import { ComponentHarness, HarnessPredicate } from '@angular/cdk/testing';
+
+/**
+ * @fileoverview Test harness for ChatComponent.
+ * Provides ergonomic methods for testing chat interactions.
+ * @module ngx-chat/testing
+ */
+/**
+ * Test harness for ChatComponent.
+ *
+ * Provides methods for:
+ * - Sending messages
+ * - Typing in the input
+ * - Querying message state
+ * - Checking component state
+ *
+ * @example
+ * ```typescript
+ * const harness = await loader.getHarness(ChatHarness);
+ * await harness.typeMessage('Hello');
+ * await harness.sendMessage('Hello');
+ * const count = await harness.getMessageCount();
+ * ```
+ */
+class ChatHarness extends ComponentHarness {
+    static hostSelector = 'ngx-chat';
+    // ===========================================================================
+    // Element Locators
+    // ===========================================================================
+    _textarea = this.locatorFor('.ngx-chat-sender__textarea');
+    _sendButton = this.locatorFor('.ngx-chat-sender__send-btn');
+    _messagesList = this.locatorForOptional('.ngx-chat__messages-list');
+    _messages = this.locatorForAll('.ngx-chat__message-placeholder');
+    _messageTexts = this.locatorForAll('.ngx-chat__message-text');
+    _typingIndicator = this.locatorForOptional('.ngx-chat__typing');
+    _loadingIndicator = this.locatorForOptional('.ngx-chat__loading');
+    _emptyState = this.locatorForOptional('.ngx-chat__empty');
+    // ===========================================================================
+    // Static Methods
+    // ===========================================================================
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a chat harness
+     * that meets certain criteria.
+     * @param options Options for filtering which chat instances are considered a match.
+     * @returns A predicate for finding matching chat harnesses.
+     */
+    static with(options = {}) {
+        return new HarnessPredicate(ChatHarness, options)
+            .addOption('disabled', options.disabled, async (harness, disabled) => {
+            return (await harness.isDisabled()) === disabled;
+        });
+    }
+    // ===========================================================================
+    // Action Methods
+    // ===========================================================================
+    /**
+     * Types a message and sends it.
+     * Combines typeMessage and clicking send button.
+     * @param content The message content to send.
+     */
+    async sendMessage(content) {
+        await this.typeMessage(content);
+        const sendButton = await this._sendButton();
+        await sendButton.click();
+    }
+    /**
+     * Types content into the message input.
+     * Clears existing content first.
+     * @param content The content to type.
+     */
+    async typeMessage(content) {
+        const textarea = await this._textarea();
+        await textarea.clear();
+        await textarea.sendKeys(content);
+    }
+    /**
+     * Clears the message input.
+     */
+    async clearInput() {
+        const textarea = await this._textarea();
+        await textarea.clear();
+    }
+    /**
+     * Focuses the message input.
+     */
+    async focusInput() {
+        const textarea = await this._textarea();
+        await textarea.focus();
+    }
+    /**
+     * Blurs the message input.
+     */
+    async blurInput() {
+        const textarea = await this._textarea();
+        await textarea.blur();
+    }
+    // ===========================================================================
+    // Query Methods
+    // ===========================================================================
+    /**
+     * Gets the number of messages displayed.
+     * @returns The message count.
+     */
+    async getMessageCount() {
+        const messages = await this._messages();
+        return messages.length;
+    }
+    /**
+     * Gets all messages with their content and sender info.
+     * @returns Array of message data.
+     */
+    async getMessages() {
+        const messages = await this._messages();
+        const messageTexts = await this._messageTexts();
+        const result = [];
+        for (let i = 0; i < messages.length; i++) {
+            const message = messages[i];
+            const classes = await message.getAttribute('class');
+            let sender = 'other';
+            if (classes?.includes('--self')) {
+                sender = 'self';
+            }
+            else if (classes?.includes('--system')) {
+                sender = 'system';
+            }
+            // Get content from corresponding text element
+            const content = i < messageTexts.length ? await messageTexts[i].text() : '';
+            // Get sender name from full text if present (appears before message content for 'other')
+            // The sender name element is separate, so we extract from full message text
+            const fullText = await message.text();
+            let senderName;
+            if (sender === 'other' && fullText !== content && fullText.includes(content)) {
+                // Extract sender name (text before content)
+                const idx = fullText.indexOf(content);
+                if (idx > 0) {
+                    senderName = fullText.substring(0, idx).trim();
+                }
+            }
+            result.push({ content, sender, senderName });
+        }
+        return result;
+    }
+    /**
+     * Gets the content of the last message.
+     * @returns The last message content, or null if no messages.
+     */
+    async getLastMessageContent() {
+        const messageTexts = await this._messageTexts();
+        if (messageTexts.length === 0) {
+            return null;
+        }
+        const lastText = messageTexts[messageTexts.length - 1];
+        return await lastText.text();
+    }
+    /**
+     * Gets the current value of the message input.
+     * @returns The input value.
+     */
+    async getInputValue() {
+        const textarea = await this._textarea();
+        return await textarea.getProperty('value');
+    }
+    /**
+     * Checks if the chat is disabled.
+     * @returns True if disabled.
+     */
+    async isDisabled() {
+        const host = await this.host();
+        return (await host.hasClass('ngx-chat--disabled'));
+    }
+    /**
+     * Checks if the send button is enabled (can send a message).
+     * @returns True if can send.
+     */
+    async canSend() {
+        const sendButton = await this._sendButton();
+        const disabled = await sendButton.getProperty('disabled');
+        return !disabled;
+    }
+    /**
+     * Checks if the typing indicator is visible.
+     * @returns True if typing indicator is shown.
+     */
+    async isTypingIndicatorVisible() {
+        const typing = await this._typingIndicator();
+        return typing !== null;
+    }
+    /**
+     * Checks if the loading indicator is visible.
+     * @returns True if loading.
+     */
+    async isLoading() {
+        const loading = await this._loadingIndicator();
+        return loading !== null;
+    }
+    /**
+     * Checks if the empty state is visible.
+     * @returns True if showing empty state.
+     */
+    async isEmpty() {
+        const empty = await this._emptyState();
+        return empty !== null;
+    }
+    /**
+     * Checks if any messages are displayed.
+     * @returns True if messages are visible.
+     */
+    async hasMessages() {
+        const list = await this._messagesList();
+        return list !== null;
+    }
+    /**
+     * Gets the placeholder text of the input.
+     * @returns The placeholder text.
+     */
+    async getPlaceholder() {
+        const textarea = await this._textarea();
+        return await textarea.getProperty('placeholder');
+    }
+    /**
+     * Checks if the input has focus.
+     * @returns True if input is focused.
+     */
+    async isInputFocused() {
+        const textarea = await this._textarea();
+        return await textarea.isFocused();
+    }
+}
+
+/**
+ * @fileoverview Mock data and test scenarios for ngx-chat testing.
+ * Provides pre-built scenarios and generator functions for comprehensive testing.
+ * @module ngx-chat/testing
+ */
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Creates a unique ID with optional prefix.
+ */
+function createId(prefix = 'msg') {
+    return `${prefix}-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+}
+/**
+ * Creates a timestamp offset from now by the given milliseconds.
+ */
+function createTimestamp(offsetMs = 0) {
+    return new Date(Date.now() - offsetMs);
+}
+// ============================================================================
+// Sample Actions
+// ============================================================================
+/**
+ * Sample confirm action for testing.
+ */
+const SAMPLE_CONFIRM_ACTION = {
+    type: 'confirm',
+    id: 'confirm-1',
+    confirmText: 'Yes',
+    cancelText: 'No',
+    confirmVariant: 'primary',
+    cancelVariant: 'ghost',
+};
+/**
+ * Sample select action for testing.
+ */
+const SAMPLE_SELECT_ACTION = {
+    type: 'select',
+    id: 'select-1',
+    label: 'Choose an option:',
+    placeholder: 'Select...',
+    options: [
+        { id: 'opt-1', label: 'Option One' },
+        { id: 'opt-2', label: 'Option Two' },
+        { id: 'opt-3', label: 'Option Three' },
+    ],
+    searchable: true,
+};
+/**
+ * Sample multi-select action for testing.
+ */
+const SAMPLE_MULTI_SELECT_ACTION = {
+    type: 'multi-select',
+    id: 'multi-select-1',
+    label: 'Select multiple:',
+    options: [
+        { id: 'feature-1', label: 'Feature A' },
+        { id: 'feature-2', label: 'Feature B' },
+        { id: 'feature-3', label: 'Feature C' },
+        { id: 'feature-4', label: 'Feature D' },
+    ],
+    minSelect: 1,
+    maxSelect: 3,
+    submitText: 'Apply',
+};
+/**
+ * Sample buttons action for testing.
+ */
+const SAMPLE_BUTTONS_ACTION = {
+    type: 'buttons',
+    id: 'buttons-1',
+    layout: 'horizontal',
+    buttons: [
+        { id: 'btn-yes', label: 'Yes', variant: 'primary' },
+        { id: 'btn-no', label: 'No', variant: 'secondary' },
+        { id: 'btn-maybe', label: 'Maybe', variant: 'ghost' },
+    ],
+};
+// ============================================================================
+// Sample Attachments
+// ============================================================================
+/**
+ * Sample image attachment.
+ */
+const SAMPLE_IMAGE_ATTACHMENT = {
+    id: 'att-img-1',
+    type: 'image',
+    url: 'https://example.com/image.jpg',
+    name: 'photo.jpg',
+    size: 102400,
+    mimeType: 'image/jpeg',
+    thumbnail: 'https://example.com/thumb.jpg',
+    dimensions: { width: 1920, height: 1080 },
+};
+/**
+ * Sample file attachment.
+ */
+const SAMPLE_FILE_ATTACHMENT = {
+    id: 'att-file-1',
+    type: 'file',
+    url: 'https://example.com/document.pdf',
+    name: 'document.pdf',
+    size: 2048000,
+    mimeType: 'application/pdf',
+};
+/**
+ * Sample video attachment.
+ */
+const SAMPLE_VIDEO_ATTACHMENT = {
+    id: 'att-video-1',
+    type: 'video',
+    url: 'https://example.com/video.mp4',
+    name: 'recording.mp4',
+    size: 10485760,
+    mimeType: 'video/mp4',
+    thumbnail: 'https://example.com/video-thumb.jpg',
+    dimensions: { width: 1280, height: 720 },
+    duration: 120,
+};
+/**
+ * Sample audio attachment.
+ */
+const SAMPLE_AUDIO_ATTACHMENT = {
+    id: 'att-audio-1',
+    type: 'audio',
+    url: 'https://example.com/audio.mp3',
+    name: 'voice-note.mp3',
+    size: 1024000,
+    mimeType: 'audio/mpeg',
+    duration: 45,
+};
+// ============================================================================
+// Sample Errors
+// ============================================================================
+/**
+ * Sample network error.
+ */
+const SAMPLE_NETWORK_ERROR = {
+    code: 'NETWORK_ERROR',
+    message: 'Network connection failed',
+    retryable: true,
+    retryCount: 0,
+};
+/**
+ * Sample timeout error.
+ */
+const SAMPLE_TIMEOUT_ERROR = {
+    code: 'TIMEOUT',
+    message: 'Request timed out',
+    retryable: true,
+    retryCount: 1,
+    lastRetryAt: new Date(),
+};
+/**
+ * Sample rate limit error.
+ */
+const SAMPLE_RATE_LIMIT_ERROR = {
+    code: 'RATE_LIMITED',
+    message: 'Too many requests. Please wait.',
+    retryable: true,
+    retryCount: 0,
+};
+// ============================================================================
+// Mock Scenarios
+// ============================================================================
+/**
+ * Pre-built test scenarios for common testing needs.
+ * Each scenario provides a complete, valid ChatMessage[] array.
+ *
+ * @example
+ * ```typescript
+ * // In a test
+ * const messages = MOCK_SCENARIOS.simpleConversation;
+ * fixture.componentRef.setInput('messages', messages);
+ * ```
+ */
+const MOCK_SCENARIOS = {
+    /**
+     * Empty message list for testing empty states.
+     */
+    empty: [],
+    /**
+     * Single message from self.
+     */
+    singleMessage: [
+        {
+            id: 'msg-single-1',
+            sender: 'self',
+            content: 'Hello, world!',
+            timestamp: createTimestamp(0),
+            status: 'sent',
+        },
+    ],
+    /**
+     * Simple back-and-forth conversation.
+     */
+    simpleConversation: [
+        {
+            id: 'msg-conv-1',
+            sender: 'self',
+            content: 'Hi there!',
+            timestamp: createTimestamp(300000),
+            status: 'read',
+        },
+        {
+            id: 'msg-conv-2',
+            sender: 'other',
+            content: 'Hello! How can I help you today?',
+            timestamp: createTimestamp(240000),
+            senderName: 'Assistant',
+            avatar: 'https://example.com/bot-avatar.png',
+        },
+        {
+            id: 'msg-conv-3',
+            sender: 'self',
+            content: 'I have a question about my order.',
+            timestamp: createTimestamp(180000),
+            status: 'read',
+        },
+        {
+            id: 'msg-conv-4',
+            sender: 'other',
+            content: 'Of course! Please provide your order number and I\'ll look it up for you.',
+            timestamp: createTimestamp(120000),
+            senderName: 'Assistant',
+        },
+        {
+            id: 'msg-conv-5',
+            sender: 'self',
+            content: 'It\'s #12345',
+            timestamp: createTimestamp(60000),
+            status: 'delivered',
+        },
+    ],
+    /**
+     * Messages with various actions attached.
+     */
+    withActions: [
+        {
+            id: 'msg-action-1',
+            sender: 'other',
+            content: 'Would you like to proceed with the order?',
+            timestamp: createTimestamp(180000),
+            senderName: 'Assistant',
+            actions: [SAMPLE_CONFIRM_ACTION],
+        },
+        {
+            id: 'msg-action-2',
+            sender: 'other',
+            content: 'Please select your preferred shipping method:',
+            timestamp: createTimestamp(120000),
+            senderName: 'Assistant',
+            actions: [SAMPLE_SELECT_ACTION],
+        },
+    ],
+    /**
+     * Message with multi-select action.
+     */
+    withMultiSelect: [
+        {
+            id: 'msg-multi-1',
+            sender: 'other',
+            content: 'Which features would you like to enable?',
+            timestamp: createTimestamp(60000),
+            senderName: 'Assistant',
+            actions: [SAMPLE_MULTI_SELECT_ACTION],
+        },
+    ],
+    /**
+     * Message with buttons action.
+     */
+    withButtons: [
+        {
+            id: 'msg-btn-1',
+            sender: 'other',
+            content: 'How would you rate your experience?',
+            timestamp: createTimestamp(60000),
+            senderName: 'Assistant',
+            actions: [SAMPLE_BUTTONS_ACTION],
+        },
+    ],
+    /**
+     * Messages with error states.
+     */
+    withErrors: [
+        {
+            id: 'msg-err-1',
+            sender: 'self',
+            content: 'This message failed to send',
+            timestamp: createTimestamp(120000),
+            status: 'error',
+            error: SAMPLE_NETWORK_ERROR,
+        },
+        {
+            id: 'msg-err-2',
+            sender: 'self',
+            content: 'This one timed out',
+            timestamp: createTimestamp(60000),
+            status: 'error',
+            error: SAMPLE_TIMEOUT_ERROR,
+        },
+        {
+            id: 'msg-err-3',
+            sender: 'self',
+            content: 'Rate limited',
+            timestamp: createTimestamp(0),
+            status: 'error',
+            error: SAMPLE_RATE_LIMIT_ERROR,
+        },
+    ],
+    /**
+     * Messages with file attachments.
+     */
+    withAttachments: [
+        {
+            id: 'msg-att-1',
+            sender: 'self',
+            content: 'Here is the photo you requested',
+            timestamp: createTimestamp(180000),
+            status: 'sent',
+            attachments: [SAMPLE_IMAGE_ATTACHMENT],
+        },
+        {
+            id: 'msg-att-2',
+            sender: 'other',
+            content: 'Thanks! Here is the document.',
+            timestamp: createTimestamp(120000),
+            senderName: 'Assistant',
+            attachments: [SAMPLE_FILE_ATTACHMENT],
+        },
+        {
+            id: 'msg-att-3',
+            sender: 'self',
+            content: 'Check out this video and audio',
+            timestamp: createTimestamp(60000),
+            status: 'delivered',
+            attachments: [SAMPLE_VIDEO_ATTACHMENT, SAMPLE_AUDIO_ATTACHMENT],
+        },
+    ],
+    /**
+     * Long conversation with 100 messages for scroll testing.
+     */
+    longConversation: generateConversation(100),
+    /**
+     * Large dataset with 1000 messages for performance testing.
+     */
+    performanceTest: generateConversation(1000),
+    /**
+     * RTL content for internationalization testing.
+     */
+    rtlContent: [
+        {
+            id: 'msg-rtl-1',
+            sender: 'self',
+            content: 'مرحبا، كيف حالك؟',
+            timestamp: createTimestamp(120000),
+            status: 'sent',
+        },
+        {
+            id: 'msg-rtl-2',
+            sender: 'other',
+            content: 'أنا بخير، شكرا لك! كيف يمكنني مساعدتك اليوم؟',
+            timestamp: createTimestamp(60000),
+            senderName: 'المساعد',
+        },
+        {
+            id: 'msg-rtl-3',
+            sender: 'self',
+            content: 'שלום! מה נשמע?',
+            timestamp: createTimestamp(0),
+            status: 'delivered',
+        },
+    ],
+    /**
+     * Mixed content with markdown, code, and special characters.
+     */
+    mixedContent: [
+        {
+            id: 'msg-mix-1',
+            sender: 'self',
+            content: 'Can you show me a code example?',
+            timestamp: createTimestamp(180000),
+            status: 'read',
+        },
+        {
+            id: 'msg-mix-2',
+            sender: 'other',
+            content: `Here's a TypeScript example:
+
+\`\`\`typescript
+function greet(name: string): string {
+  return \`Hello, \${name}!\`;
+}
+\`\`\`
+
+You can also use **bold** and *italic* text.`,
+            timestamp: createTimestamp(120000),
+            senderName: 'Assistant',
+        },
+        {
+            id: 'msg-mix-3',
+            sender: 'other',
+            content: 'Special characters: <>&"\' and emoji: 😀🎉',
+            timestamp: createTimestamp(60000),
+            senderName: 'Assistant',
+        },
+    ],
+    /**
+     * System messages for notifications and status updates.
+     */
+    systemMessages: [
+        {
+            id: 'msg-sys-1',
+            sender: 'system',
+            content: 'Chat session started',
+            timestamp: createTimestamp(300000),
+        },
+        {
+            id: 'msg-sys-2',
+            sender: 'self',
+            content: 'Hello!',
+            timestamp: createTimestamp(240000),
+            status: 'sent',
+        },
+        {
+            id: 'msg-sys-3',
+            sender: 'system',
+            content: 'Assistant joined the conversation',
+            timestamp: createTimestamp(180000),
+        },
+        {
+            id: 'msg-sys-4',
+            sender: 'other',
+            content: 'Hi there! How can I help?',
+            timestamp: createTimestamp(120000),
+            senderName: 'Assistant',
+        },
+        {
+            id: 'msg-sys-5',
+            sender: 'system',
+            content: 'This conversation will end in 5 minutes',
+            timestamp: createTimestamp(60000),
+        },
+    ],
+};
+// ============================================================================
+// Generator Functions
+// ============================================================================
+/**
+ * Generates a conversation with alternating self/other messages.
+ *
+ * @param count - Number of messages to generate
+ * @returns Array of ChatMessage objects
+ *
+ * @example
+ * ```typescript
+ * const messages = generateConversation(50);
+ * expect(messages.length).toBe(50);
+ * ```
+ */
+function generateConversation(count) {
+    if (count < 0) {
+        throw new Error('Count must be non-negative');
+    }
+    const messages = [];
+    const baseTime = Date.now();
+    for (let i = 0; i < count; i++) {
+        const isUser = i % 2 === 0;
+        const message = {
+            id: `msg-gen-${i}`,
+            sender: isUser ? 'self' : 'other',
+            content: isUser
+                ? `User message ${Math.floor(i / 2) + 1}`
+                : `Assistant response ${Math.floor(i / 2) + 1}`,
+            timestamp: new Date(baseTime - (count - i) * 60000),
+            ...(isUser
+                ? { status: 'read' }
+                : { senderName: 'Assistant' }),
+        };
+        messages.push(message);
+    }
+    return messages;
+}
+/**
+ * Generates messages with various action types attached.
+ *
+ * @param count - Number of messages to generate (each will have an action)
+ * @returns Array of ChatMessage objects with actions
+ *
+ * @example
+ * ```typescript
+ * const messages = generateWithActions(10);
+ * expect(messages.every(m => m.actions?.length)).toBe(true);
+ * ```
+ */
+function generateWithActions(count) {
+    if (count < 0) {
+        throw new Error('Count must be non-negative');
+    }
+    const actions = [
+        SAMPLE_CONFIRM_ACTION,
+        SAMPLE_SELECT_ACTION,
+        SAMPLE_MULTI_SELECT_ACTION,
+        SAMPLE_BUTTONS_ACTION,
+    ];
+    const messages = [];
+    const baseTime = Date.now();
+    for (let i = 0; i < count; i++) {
+        const action = actions[i % actions.length];
+        const message = {
+            id: `msg-action-gen-${i}`,
+            sender: 'other',
+            content: `Message with ${action.type} action (#${i + 1})`,
+            timestamp: new Date(baseTime - (count - i) * 60000),
+            senderName: 'Assistant',
+            actions: [{ ...action, id: `${action.id}-${i}` }],
+        };
+        messages.push(message);
+    }
+    return messages;
+}
+/**
+ * Generates messages with various attachment types.
+ *
+ * @param count - Number of messages to generate
+ * @returns Array of ChatMessage objects with attachments
+ */
+function generateWithAttachments(count) {
+    if (count < 0) {
+        throw new Error('Count must be non-negative');
+    }
+    const attachments = [
+        SAMPLE_IMAGE_ATTACHMENT,
+        SAMPLE_FILE_ATTACHMENT,
+        SAMPLE_VIDEO_ATTACHMENT,
+        SAMPLE_AUDIO_ATTACHMENT,
+    ];
+    const messages = [];
+    const baseTime = Date.now();
+    for (let i = 0; i < count; i++) {
+        const attachment = attachments[i % attachments.length];
+        const isUser = i % 2 === 0;
+        const message = {
+            id: `msg-att-gen-${i}`,
+            sender: isUser ? 'self' : 'other',
+            content: `Message with ${attachment.type} attachment`,
+            timestamp: new Date(baseTime - (count - i) * 60000),
+            ...(isUser
+                ? { status: 'sent' }
+                : { senderName: 'Assistant' }),
+            attachments: [{ ...attachment, id: `${attachment.id}-${i}` }],
+        };
+        messages.push(message);
+    }
+    return messages;
+}
+// ============================================================================
+// Wait Utilities
+// ============================================================================
+/**
+ * Default timeout for wait operations in milliseconds.
+ */
+const DEFAULT_WAIT_TIMEOUT = 5000;
+/**
+ * Default polling interval for wait operations in milliseconds.
+ */
+const DEFAULT_POLL_INTERVAL = 50;
+/**
+ * Waits for the chat harness to display a specific number of messages.
+ *
+ * @param harness - The ChatHarness instance
+ * @param count - Expected number of messages
+ * @param timeout - Maximum wait time in milliseconds (default: 5000)
+ * @returns Promise that resolves when count is reached or rejects on timeout
+ *
+ * @example
+ * ```typescript
+ * const harness = await loader.getHarness(ChatHarness);
+ * fixture.componentRef.setInput('messages', generateConversation(5));
+ * await waitForMessages(harness, 5);
+ * ```
+ */
+async function waitForMessages(harness, count, timeout = DEFAULT_WAIT_TIMEOUT) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeout) {
+        const currentCount = await harness.getMessageCount();
+        if (currentCount >= count) {
+            return;
+        }
+        await sleep(DEFAULT_POLL_INTERVAL);
+    }
+    const finalCount = await harness.getMessageCount();
+    throw new Error(`Timeout waiting for ${count} messages. Current count: ${finalCount}`);
+}
+/**
+ * Waits for the typing indicator to reach a specific visibility state.
+ *
+ * @param harness - The ChatHarness instance
+ * @param visible - Expected visibility state (true = visible, false = hidden)
+ * @param timeout - Maximum wait time in milliseconds (default: 5000)
+ * @returns Promise that resolves when state is reached or rejects on timeout
+ *
+ * @example
+ * ```typescript
+ * const harness = await loader.getHarness(ChatHarness);
+ * fixture.componentRef.setInput('isTyping', true);
+ * await waitForTypingIndicator(harness, true);
+ * ```
+ */
+async function waitForTypingIndicator(harness, visible, timeout = DEFAULT_WAIT_TIMEOUT) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeout) {
+        const isVisible = await harness.isTypingIndicatorVisible();
+        if (isVisible === visible) {
+            return;
+        }
+        await sleep(DEFAULT_POLL_INTERVAL);
+    }
+    const finalState = await harness.isTypingIndicatorVisible();
+    throw new Error(`Timeout waiting for typing indicator to be ${visible ? 'visible' : 'hidden'}. Current: ${finalState ? 'visible' : 'hidden'}`);
+}
+/**
+ * Waits for the loading indicator to reach a specific visibility state.
+ *
+ * @param harness - The ChatHarness instance
+ * @param visible - Expected visibility state
+ * @param timeout - Maximum wait time in milliseconds (default: 5000)
+ */
+async function waitForLoading(harness, visible, timeout = DEFAULT_WAIT_TIMEOUT) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeout) {
+        const isLoading = await harness.isLoading();
+        if (isLoading === visible) {
+            return;
+        }
+        await sleep(DEFAULT_POLL_INTERVAL);
+    }
+    const finalState = await harness.isLoading();
+    throw new Error(`Timeout waiting for loading to be ${visible ? 'visible' : 'hidden'}. Current: ${finalState ? 'visible' : 'hidden'}`);
+}
+/**
+ * Waits for the empty state to reach a specific visibility state.
+ *
+ * @param harness - The ChatHarness instance
+ * @param visible - Expected visibility state
+ * @param timeout - Maximum wait time in milliseconds (default: 5000)
+ */
+async function waitForEmpty(harness, visible, timeout = DEFAULT_WAIT_TIMEOUT) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeout) {
+        const isEmpty = await harness.isEmpty();
+        if (isEmpty === visible) {
+            return;
+        }
+        await sleep(DEFAULT_POLL_INTERVAL);
+    }
+    const finalState = await harness.isEmpty();
+    throw new Error(`Timeout waiting for empty state to be ${visible ? 'visible' : 'hidden'}. Current: ${finalState ? 'visible' : 'hidden'}`);
+}
+/**
+ * Waits for the send button to become enabled or disabled.
+ *
+ * @param harness - The ChatHarness instance
+ * @param enabled - Expected enabled state
+ * @param timeout - Maximum wait time in milliseconds (default: 5000)
+ */
+async function waitForSendEnabled(harness, enabled, timeout = DEFAULT_WAIT_TIMEOUT) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeout) {
+        const canSend = await harness.canSend();
+        if (canSend === enabled) {
+            return;
+        }
+        await sleep(DEFAULT_POLL_INTERVAL);
+    }
+    const finalState = await harness.canSend();
+    throw new Error(`Timeout waiting for send button to be ${enabled ? 'enabled' : 'disabled'}. Current: ${finalState ? 'enabled' : 'disabled'}`);
+}
+// ============================================================================
+// Internal Utilities
+// ============================================================================
+/**
+ * Simple sleep utility for polling.
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+/**
+ * @fileoverview Internal testing module exports.
+ * @module ngx-chat/testing
+ */
+// Harnesses
+
+/**
+ * @fileoverview Public API for ngx-chat/testing secondary entry point.
+ *
+ * This entry point provides testing utilities for consumers of the ngx-chat library.
+ * Import from 'ngx-chat/testing' to access harnesses, mock data, and test utilities.
+ *
+ * @example
+ * ```typescript
+ * import { ChatHarness, MOCK_SCENARIOS, waitForMessages } from 'ngx-chat/testing';
+ *
+ * // In your tests
+ * const harness = await loader.getHarness(ChatHarness);
+ * fixture.componentRef.setInput('messages', MOCK_SCENARIOS.simpleConversation);
+ * await waitForMessages(harness, 5);
+ * ```
+ *
+ * @module ngx-chat/testing
+ */
+// Re-export all testing utilities
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { ChatHarness, DEFAULT_POLL_INTERVAL, DEFAULT_WAIT_TIMEOUT, MOCK_SCENARIOS, SAMPLE_AUDIO_ATTACHMENT, SAMPLE_BUTTONS_ACTION, SAMPLE_CONFIRM_ACTION, SAMPLE_FILE_ATTACHMENT, SAMPLE_IMAGE_ATTACHMENT, SAMPLE_MULTI_SELECT_ACTION, SAMPLE_NETWORK_ERROR, SAMPLE_RATE_LIMIT_ERROR, SAMPLE_SELECT_ACTION, SAMPLE_TIMEOUT_ERROR, SAMPLE_VIDEO_ATTACHMENT, generateConversation, generateWithActions, generateWithAttachments, waitForEmpty, waitForLoading, waitForMessages, waitForSendEnabled, waitForTypingIndicator };
+//# sourceMappingURL=cdevhub-ngx-chat-testing.mjs.map