@botonic/react 0.48.1 → 0.48.3

package/lib/cjs/constants.d.ts

@@ -158,3 +158,6 @@ export namespace ROLES {
     let RAW_MESSAGE: string;
     let SYSTEM_DEBUG_TRACE_MESSAGE: string;
 }
+export namespace WEBCHAT_DEFAULT_CONTENTS {
+    let INPUT_PLACEHOLDER: string;
+}

package/lib/cjs/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ROLES = exports.MAX_ALLOWED_SIZE_MB = exports.MIME_WHITELIST = exports.WEBCHAT = exports.COLORS = void 0;
+exports.WEBCHAT_DEFAULT_CONTENTS = exports.ROLES = exports.MAX_ALLOWED_SIZE_MB = exports.MIME_WHITELIST = exports.WEBCHAT = exports.COLORS = void 0;
 const tslib_1 = require("tslib");
 const botonic_react_logo100x100_png_1 = tslib_1.__importDefault(require("./assets/botonic_react_logo100x100.png"));
 const url_icon_png_1 = tslib_1.__importDefault(require("./assets/url-icon.png"));
@@ -183,4 +183,7 @@ exports.ROLES = {
     RAW_MESSAGE: 'raw-message',
     SYSTEM_DEBUG_TRACE_MESSAGE: 'system-debug-trace-message',
 };
+exports.WEBCHAT_DEFAULT_CONTENTS = {
+    INPUT_PLACEHOLDER: 'Ask me something...',
+};
 //# sourceMappingURL=constants.js.map

package/lib/cjs/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.js"],"names":[],"mappings":"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"}

package/lib/cjs/debug-system-messages.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Dev-only mock payloads for every SystemDebugTrace event type.
+ *
+ * Usage from dev-entry.ts:
+ *   import { DEBUG_SYSTEM_MESSAGES } from '@botonic/react/src/debug-system-messages'
+ *   app.addDebugSystemMessage(DEBUG_SYSTEM_MESSAGES.keyword)
+ *
+ * Usage from the browser console (window.Botonic is the DevApp instance):
+ *   Botonic.addDebugSystemMessage({ action: 'nlu_keyword', nlu_keyword_name: 'hello', ... })
+ *   // or use the pre-built fixtures exposed on the DevApp:
+ *   Botonic.addDebugSystemMessage(Botonic.debugSystemMessages.aiAgent)
+ */
+import { EventAction } from '@botonic/core';
+import type { ChunkIdsGroupedBySourceData } from './components/system-debug-trace/events/knowledge-bases-types';
+export declare const DEBUG_SYSTEM_MESSAGES: {
+    keyword: {
+        action: EventAction.Keyword;
+        flow_id: string;
+        flow_node_id: string;
+        nlu_keyword_is_regex: false;
+        nlu_keyword_name: string;
+    };
+    smartIntent: {
+        action: EventAction.IntentSmart;
+        nlu_intent_smart_title: string;
+    };
+    fallback: {
+        action: EventAction.Fallback;
+        user_input: string;
+        fallback_out: number;
+        fallback_message_id: string;
+    };
+    handoffSuccess: {
+        action: EventAction.HandoffSuccess;
+        handoff_queue_name: string;
+        handoff_is_queue_open: true;
+        handoff_has_auto_assign: true;
+        handoff_note_id: string;
+    };
+    botAction: {
+        action: EventAction.BotAction;
+        payload: string;
+    };
+    knowledgeBase: {
+        action: EventAction.Knowledgebase;
+        flow_id: string;
+        flow_node_id: string;
+        knowledgebase_inference_id: string;
+        knowledgebase_fail_reason: string;
+        knowledgebase_sources_ids: string[];
+        knowledgebase_chunks_ids: string[];
+        user_input: string;
+        knowledge_base_chunks_with_sources: ChunkIdsGroupedBySourceData[];
+    };
+    knowledgeBaseFailed: {
+        action: EventAction.Knowledgebase;
+        flow_id: string;
+        flow_node_id: string;
+        knowledgebase_inference_id: string;
+        knowledgebase_fail_reason: string;
+        knowledgebase_sources_ids: never[];
+        knowledgebase_chunks_ids: never[];
+        user_input: string;
+        knowledge_base_chunks_with_sources: never[];
+    };
+    conditionalChannel: {
+        action: EventAction.ConditionalChannel;
+        channel: string;
+    };
+    conditionalCountry: {
+        action: EventAction.ConditionalCountry;
+        country: string;
+    };
+    conditionalCustom: {
+        action: EventAction.ConditionalCustom;
+        conditional_variable: string;
+        variable_format: string;
+    };
+    conditionalQueueStatus: {
+        action: EventAction.ConditionalQueueStatus;
+        queue_id: string;
+        queue_name: string;
+        is_queue_open: true;
+        is_available_agent: true;
+    };
+    redirectFlow: {
+        action: EventAction.RedirectFlow;
+        flow_id: string;
+        flow_name: string;
+        flow_target_id: string;
+        flow_target_name: string;
+    };
+    webviewActionTriggered: {
+        action: EventAction.WebviewActionTriggered;
+        webview_target_id: string;
+        webview_name: string;
+    };
+    aiAgent: {
+        action: EventAction.AiAgent;
+        flow_node_content_id: string;
+        user_input: string;
+        tools_executed: ({
+            tool_name: string;
+            tool_arguments: {
+                query: string;
+                user_id?: undefined;
+            };
+            tool_results: string;
+            knowledgebase_sources_ids: string[];
+            knowledgebase_chunks_ids: string[];
+        } | {
+            tool_name: string;
+            tool_arguments: {
+                user_id: string;
+                query?: undefined;
+            };
+            tool_results: string;
+            knowledgebase_sources_ids?: undefined;
+            knowledgebase_chunks_ids?: undefined;
+        })[];
+        input_guardrails_triggered: never[];
+        output_guardrails_triggered: never[];
+        exit: false;
+        error: false;
+        knowledge_base_chunks_with_sources: ChunkIdsGroupedBySourceData[];
+    };
+    aiAgentWithGuardrails: {
+        action: EventAction.AiAgent;
+        flow_node_content_id: string;
+        user_input: string;
+        tools_executed: never[];
+        input_guardrails_triggered: string[];
+        output_guardrails_triggered: never[];
+        exit: false;
+        error: false;
+    };
+    aiAgentError: {
+        action: EventAction.AiAgent;
+        flow_node_content_id: string;
+        user_input: string;
+        tools_executed: never[];
+        input_guardrails_triggered: never[];
+        output_guardrails_triggered: never[];
+        exit: false;
+        error: true;
+    };
+};

package/lib/cjs/debug-system-messages.js

@@ -0,0 +1,167 @@
+"use strict";
+/**
+ * Dev-only mock payloads for every SystemDebugTrace event type.
+ *
+ * Usage from dev-entry.ts:
+ *   import { DEBUG_SYSTEM_MESSAGES } from '@botonic/react/src/debug-system-messages'
+ *   app.addDebugSystemMessage(DEBUG_SYSTEM_MESSAGES.keyword)
+ *
+ * Usage from the browser console (window.Botonic is the DevApp instance):
+ *   Botonic.addDebugSystemMessage({ action: 'nlu_keyword', nlu_keyword_name: 'hello', ... })
+ *   // or use the pre-built fixtures exposed on the DevApp:
+ *   Botonic.addDebugSystemMessage(Botonic.debugSystemMessages.aiAgent)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEBUG_SYSTEM_MESSAGES = void 0;
+const core_1 = require("@botonic/core");
+const mockChunksWithSources = [
+    {
+        source: {
+            id: 'src-mock-001',
+            name: 'Help Center',
+            type: 'url',
+            scrapingCountryCode: null,
+            createdAt: '2026-01-01T00:00:00Z',
+            createdBy: 'mock',
+            lastUpdatedAt: '2026-01-01T00:00:00Z',
+            lastUpdatedBy: 'mock',
+            activeExtractionJob: null,
+            lastExtractionJob: null,
+        },
+        chunks: [
+            {
+                id: 'chunk-mock-001',
+                text: 'To reset your password, go to Settings > Security > Reset Password.',
+            },
+        ],
+    },
+];
+exports.DEBUG_SYSTEM_MESSAGES = {
+    keyword: {
+        action: core_1.EventAction.Keyword,
+        flow_id: 'flow-mock-001',
+        flow_node_id: 'node-mock-001',
+        nlu_keyword_is_regex: false,
+        nlu_keyword_name: 'hello',
+    },
+    smartIntent: {
+        action: core_1.EventAction.IntentSmart,
+        nlu_intent_smart_title: 'Greeting smart intent',
+    },
+    fallback: {
+        action: core_1.EventAction.Fallback,
+        user_input: "I don't understand this bot",
+        fallback_out: 1,
+        fallback_message_id: 'msg-mock-002',
+    },
+    handoffSuccess: {
+        action: core_1.EventAction.HandoffSuccess,
+        handoff_queue_name: 'Support Team',
+        handoff_is_queue_open: true,
+        handoff_has_auto_assign: true,
+        handoff_note_id: '',
+    },
+    botAction: {
+        action: core_1.EventAction.BotAction,
+        payload: 'custom-action-result',
+    },
+    knowledgeBase: {
+        action: core_1.EventAction.Knowledgebase,
+        flow_id: 'flow-mock-001',
+        flow_node_id: 'node-mock-004',
+        knowledgebase_inference_id: 'inf-mock-001',
+        knowledgebase_fail_reason: '',
+        knowledgebase_sources_ids: ['src-mock-001'],
+        knowledgebase_chunks_ids: ['chunk-mock-001'],
+        user_input: 'How do I reset my password?',
+        knowledge_base_chunks_with_sources: mockChunksWithSources,
+    },
+    knowledgeBaseFailed: {
+        action: core_1.EventAction.Knowledgebase,
+        flow_id: 'flow-mock-001',
+        flow_node_id: 'node-mock-004',
+        knowledgebase_inference_id: 'inf-mock-002',
+        knowledgebase_fail_reason: 'no_relevant_content',
+        knowledgebase_sources_ids: [],
+        knowledgebase_chunks_ids: [],
+        user_input: 'What is the meaning of life?',
+        knowledge_base_chunks_with_sources: [],
+    },
+    conditionalChannel: {
+        action: core_1.EventAction.ConditionalChannel,
+        channel: 'whatsapp',
+    },
+    conditionalCountry: {
+        action: core_1.EventAction.ConditionalCountry,
+        country: 'ES',
+    },
+    conditionalCustom: {
+        action: core_1.EventAction.ConditionalCustom,
+        conditional_variable: 'user_plan',
+        variable_format: 'string',
+    },
+    conditionalQueueStatus: {
+        action: core_1.EventAction.ConditionalQueueStatus,
+        queue_id: 'queue-mock-001',
+        queue_name: 'Support Team',
+        is_queue_open: true,
+        is_available_agent: true,
+    },
+    redirectFlow: {
+        action: core_1.EventAction.RedirectFlow,
+        flow_id: 'flow-mock-001',
+        flow_name: 'Main Flow',
+        flow_target_id: 'flow-mock-002',
+        flow_target_name: 'Billing Flow',
+    },
+    webviewActionTriggered: {
+        action: core_1.EventAction.WebviewActionTriggered,
+        webview_target_id: 'webview-mock-001',
+        webview_name: 'Payment Form',
+    },
+    aiAgent: {
+        action: core_1.EventAction.AiAgent,
+        flow_node_content_id: 'content-mock-001',
+        user_input: 'Can you help me with my subscription?',
+        tools_executed: [
+            {
+                tool_name: 'retrieve_knowledge',
+                tool_arguments: { query: 'subscription management' },
+                tool_results: 'Found 3 relevant articles about subscription management.',
+                knowledgebase_sources_ids: ['src-mock-001'],
+                knowledgebase_chunks_ids: ['chunk-mock-001'],
+            },
+            {
+                tool_name: 'get_user_subscription',
+                tool_arguments: { user_id: 'user-mock-001' },
+                tool_results: '{"plan": "pro", "renewal_date": "2026-06-01"}',
+            },
+        ],
+        input_guardrails_triggered: [],
+        output_guardrails_triggered: [],
+        exit: false,
+        error: false,
+        knowledge_base_chunks_with_sources: mockChunksWithSources,
+    },
+    aiAgentWithGuardrails: {
+        action: core_1.EventAction.AiAgent,
+        flow_node_content_id: 'content-mock-002',
+        user_input: 'Tell me something inappropriate',
+        tools_executed: [],
+        input_guardrails_triggered: ['content_safety', 'topic_restriction'],
+        output_guardrails_triggered: [],
+        exit: false,
+        error: false,
+    },
+    aiAgentError: {
+        action: core_1.EventAction.AiAgent,
+        flow_node_content_id: 'content-mock-003',
+        user_input: 'Hello',
+        tools_executed: [],
+        input_guardrails_triggered: [],
+        output_guardrails_triggered: [],
+        exit: false,
+        error: true,
+    },
+};
+//# sourceMappingURL=debug-system-messages.js.map

package/lib/cjs/debug-system-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-system-messages.js","sourceRoot":"","sources":["../../src/debug-system-messages.ts"],"names":[],"mappings":"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"}

package/lib/cjs/dev-app.d.ts

@@ -1,5 +1,5 @@
 export class DevApp extends WebchatApp {
-    constructor({ theme, persistentMenu, coverComponent, blockInputs, enableEmojiPicker, enableAttachments, enableUserInput, enableAnimations, shadowDOM, hostId, storage, storageKey, onInit, onOpen, onClose, onMessage, onTrackEvent, webviews, ...botOptions }: {
+    constructor({ theme, persistentMenu, coverComponent, blockInputs, enableEmojiPicker, enableAttachments, enableUserInput, enableAnimations, shadowDOM, hostId, storage, storageKey, onInit, onOpen, onClose, onMessage, onTrackEvent, contentsByLocale, webviews, ...botOptions }: {
         [x: string]: any;
         theme?: {} | undefined;
         persistentMenu: any;
@@ -18,12 +18,161 @@ export class DevApp extends WebchatApp {
         onClose: any;
         onMessage: any;
         onTrackEvent: any;
+        contentsByLocale: any;
         webviews: any;
     });
     webviews: any;
     bot: ReactBot;
     getComponent(host: any, optionsAtRuntime?: {}): import("react/jsx-runtime").JSX.Element;
     render(dest: any, optionsAtRuntime?: {}): void;
+    /** Pre-built mock payloads for every debug event type. Handy from the console:
+     *  Botonic.addDebugSystemMessage(Botonic.debugSystemMessages.aiAgent) */
+    get debugSystemMessages(): {
+        keyword: {
+            action: import("@botonic/core").EventAction.Keyword;
+            flow_id: string;
+            flow_node_id: string;
+            nlu_keyword_is_regex: false;
+            nlu_keyword_name: string;
+        };
+        smartIntent: {
+            action: import("@botonic/core").EventAction.IntentSmart;
+            nlu_intent_smart_title: string;
+        };
+        fallback: {
+            action: import("@botonic/core").EventAction.Fallback;
+            user_input: string;
+            fallback_out: number;
+            fallback_message_id: string;
+        };
+        handoffSuccess: {
+            action: import("@botonic/core").EventAction.HandoffSuccess;
+            handoff_queue_name: string;
+            handoff_is_queue_open: true;
+            handoff_has_auto_assign: true;
+            handoff_note_id: string;
+        };
+        botAction: {
+            action: import("@botonic/core").EventAction.BotAction;
+            payload: string;
+        };
+        knowledgeBase: {
+            action: import("@botonic/core").EventAction.Knowledgebase;
+            flow_id: string;
+            flow_node_id: string;
+            knowledgebase_inference_id: string;
+            knowledgebase_fail_reason: string;
+            knowledgebase_sources_ids: string[];
+            knowledgebase_chunks_ids: string[];
+            user_input: string;
+            knowledge_base_chunks_with_sources: import("./index-types").ChunkIdsGroupedBySourceData[];
+        };
+        knowledgeBaseFailed: {
+            action: import("@botonic/core").EventAction.Knowledgebase;
+            flow_id: string;
+            flow_node_id: string;
+            knowledgebase_inference_id: string;
+            knowledgebase_fail_reason: string;
+            knowledgebase_sources_ids: never[];
+            knowledgebase_chunks_ids: never[];
+            user_input: string;
+            knowledge_base_chunks_with_sources: never[];
+        };
+        conditionalChannel: {
+            action: import("@botonic/core").EventAction.ConditionalChannel;
+            channel: string;
+        };
+        conditionalCountry: {
+            action: import("@botonic/core").EventAction.ConditionalCountry;
+            country: string;
+        };
+        conditionalCustom: {
+            action: import("@botonic/core").EventAction.ConditionalCustom;
+            conditional_variable: string;
+            variable_format: string;
+        };
+        conditionalQueueStatus: {
+            action: import("@botonic/core").EventAction.ConditionalQueueStatus;
+            queue_id: string;
+            queue_name: string;
+            is_queue_open: true;
+            is_available_agent: true;
+        };
+        redirectFlow: {
+            action: import("@botonic/core").EventAction.RedirectFlow;
+            flow_id: string;
+            flow_name: string;
+            flow_target_id: string;
+            flow_target_name: string;
+        };
+        webviewActionTriggered: {
+            action: import("@botonic/core").EventAction.WebviewActionTriggered;
+            webview_target_id: string;
+            webview_name: string;
+        };
+        aiAgent: {
+            action: import("@botonic/core").EventAction.AiAgent;
+            flow_node_content_id: string;
+            user_input: string;
+            tools_executed: ({
+                tool_name: string;
+                tool_arguments: {
+                    query: string;
+                    user_id?: undefined;
+                };
+                tool_results: string;
+                knowledgebase_sources_ids: string[];
+                knowledgebase_chunks_ids: string[];
+            } | {
+                tool_name: string;
+                tool_arguments: {
+                    user_id: string;
+                    query?: undefined;
+                };
+                tool_results: string;
+                knowledgebase_sources_ids?: undefined;
+                knowledgebase_chunks_ids?: undefined;
+            })[];
+            input_guardrails_triggered: never[];
+            output_guardrails_triggered: never[];
+            exit: false;
+            error: false;
+            knowledge_base_chunks_with_sources: import("./index-types").ChunkIdsGroupedBySourceData[];
+        };
+        aiAgentWithGuardrails: {
+            action: import("@botonic/core").EventAction.AiAgent;
+            flow_node_content_id: string;
+            user_input: string;
+            tools_executed: never[];
+            input_guardrails_triggered: string[];
+            output_guardrails_triggered: never[];
+            exit: false;
+            error: false;
+        };
+        aiAgentError: {
+            action: import("@botonic/core").EventAction.AiAgent;
+            flow_node_content_id: string;
+            user_input: string;
+            tools_executed: never[];
+            input_guardrails_triggered: never[];
+            output_guardrails_triggered: never[];
+            exit: false;
+            error: true;
+        };
+    };
+    /**
+     * Inject a mock SystemDebugTrace event into the preview webchat.
+     * Accepts any DebugEvent payload (plain object with an `action` field).
+     *
+     * From code:
+     *   import { DEBUG_SYSTEM_MESSAGES } from '@botonic/react/src/debug-system-messages'
+     *   app.addDebugSystemMessage(DEBUG_SYSTEM_MESSAGES.aiAgent)
+     *
+     * From the browser console:
+     *   Botonic.addDebugSystemMessage(Botonic.debugSystemMessages.conditionalQueueStatus)
+     *   Botonic.addDebugSystemMessage({ action: 'nlu_keyword', nlu_keyword_name: 'hi', nlu_keyword_is_regex: false, flow_id: 'f1', flow_node_id: 'n1' })
+     */
+    addDebugSystemMessage(eventData: any): void;
     onUserInput({ input, session, lastRoutePath }: {
         input: any;
         session: any;

package/lib/cjs/dev-app.js

@@ -2,14 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DevApp = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
+const core_1 = require("@botonic/core");
 const client_1 = require("react-dom/client");
+const debug_system_messages_1 = require("./debug-system-messages");
 const index_types_1 = require("./index-types");
 const react_bot_1 = require("./react-bot");
 const dom_1 = require("./util/dom");
 const webchat_dev_1 = require("./webchat/webchat-dev");
 const webchat_app_1 = require("./webchat-app");
 class DevApp extends webchat_app_1.WebchatApp {
-    constructor({ theme = {}, persistentMenu, coverComponent, blockInputs, enableEmojiPicker, enableAttachments, enableUserInput, enableAnimations, shadowDOM, hostId, storage, storageKey, onInit, onOpen, onClose, onMessage, onTrackEvent, webviews, ...botOptions }) {
+    constructor({ theme = {}, persistentMenu, coverComponent, blockInputs, enableEmojiPicker, enableAttachments, enableUserInput, enableAnimations, shadowDOM, hostId, storage, storageKey, onInit, onOpen, onClose, onMessage, onTrackEvent, contentsByLocale, webviews, ...botOptions }) {
         super({
             theme,
             persistentMenu,
@@ -28,6 +30,7 @@ class DevApp extends webchat_app_1.WebchatApp {
             onClose,
             onMessage,
             onTrackEvent,
+            contentsByLocale,
         });
         this.webviews = webviews;
         this.bot = new react_bot_1.ReactBot({
@@ -35,7 +38,7 @@ class DevApp extends webchat_app_1.WebchatApp {
         });
     }
     getComponent(host, optionsAtRuntime = {}) {
-        let { theme = {}, storage, storageKey, onInit, onOpen, onClose, onMessage, onTrackEvent, hostId, ...webchatOptions } = optionsAtRuntime;
+        let { theme = {}, storage, storageKey, onInit, onOpen, onClose, onMessage, onTrackEvent, contentsByLocale, hostId, ...webchatOptions } = optionsAtRuntime;
         theme = super.createInitialTheme(optionsAtRuntime);
         storage = storage || this.storage;
         storageKey = storageKey || this.storageKey;
@@ -44,9 +47,10 @@ class DevApp extends webchat_app_1.WebchatApp {
         this.onClose = onClose || this.onClose;
         this.onMessage = onMessage || this.onMessage;
         this.onTrackEvent = onTrackEvent || this.onTrackEvent;
+        this.contentsByLocale = contentsByLocale || this.contentsByLocale;
         this.hostId = hostId || this.hostId;
         this.createRootElement(host);
-        return ((0, jsx_runtime_1.jsx)(webchat_dev_1.WebchatDev, { ...webchatOptions, ref: this.webchatRef, host: this.host, shadowDOM: this.shadowDOM, theme: theme, storage: storage, storageKey: storageKey, onInit: (...args) => this.onInitWebchat(...args), onOpen: (...args) => this.onOpenWebchat(...args), onClose: (...args) => this.onCloseWebchat(...args), onUserInput: (...args) => this.onUserInput(...args), onTrackEvent: (...args) => this.onTrackEvent(...args), webviews: this.webviews }));
+        return ((0, jsx_runtime_1.jsx)(webchat_dev_1.WebchatDev, { ...webchatOptions, ref: this.webchatRef, host: this.host, shadowDOM: this.shadowDOM, theme: theme, storage: storage, storageKey: storageKey, contentsByLocale: this.contentsByLocale, onInit: (...args) => this.onInitWebchat(...args), onOpen: (...args) => this.onOpenWebchat(...args), onClose: (...args) => this.onCloseWebchat(...args), onUserInput: (...args) => this.onUserInput(...args), onTrackEvent: (...args) => this.onTrackEvent(...args), webviews: this.webviews }));
     }
     render(dest, optionsAtRuntime = {}) {
         (0, dom_1.onDOMLoaded)(() => {
@@ -56,6 +60,26 @@ class DevApp extends webchat_app_1.WebchatApp {
             reactRoot.render(devAppComponent);
         });
     }
+    /** Pre-built mock payloads for every debug event type. Handy from the console:
+     *  Botonic.addDebugSystemMessage(Botonic.debugSystemMessages.aiAgent) */
+    get debugSystemMessages() {
+        return debug_system_messages_1.DEBUG_SYSTEM_MESSAGES;
+    }
+    /**
+     * Inject a mock SystemDebugTrace event into the preview webchat.
+     * Accepts any DebugEvent payload (plain object with an `action` field).
+     *
+     * From code:
+     *   import { DEBUG_SYSTEM_MESSAGES } from '@botonic/react/src/debug-system-messages'
+     *   app.addDebugSystemMessage(DEBUG_SYSTEM_MESSAGES.aiAgent)
+     *
+     * From the browser console:
+     *   Botonic.addDebugSystemMessage(Botonic.debugSystemMessages.conditionalQueueStatus)
+     *   Botonic.addDebugSystemMessage({ action: 'nlu_keyword', nlu_keyword_name: 'hi', nlu_keyword_is_regex: false, flow_id: 'f1', flow_node_id: 'n1' })
+     */
+    addDebugSystemMessage(eventData) {
+        this.addSystemMessage({ type: core_1.INPUT.SYSTEM_DEBUG_TRACE, data: eventData });
+    }
     async onUserInput({ input, session, lastRoutePath }) {
         this.onMessage?.(this, {
             sentBy: index_types_1.SENDERS.user,

package/lib/cjs/dev-app.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev-app.js","sourceRoot":"","sources":["../../src/dev-app.jsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"dev-app.js","sourceRoot":"","sources":["../../src/dev-app.jsx"],"names":[],"mappings":"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"}

package/lib/cjs/index-types.d.ts

@@ -58,6 +58,9 @@ export interface MinimalHubtypeMessage {
     action: string;
     text: string;
 }
+export interface WebchatLocaleContents {
+    inputPlaceholder: string;
+}
 export interface PreviewUtils {
     getChunkIdsGroupedBySource: (chunkIds: string[]) => Promise<ChunkIdsGroupedBySourceData[]>;
     onClickOpenChunks: (chunkIdsGroupedBySource: ChunkIdsGroupedBySourceData[]) => void;
@@ -86,6 +89,7 @@ export interface WebchatArgs {
     onMessage?: (app: WebchatApp, message: WebchatMessage) => void;
     onTrackEvent?: TrackEventFunction;
     onConnectionChange?: (app: WebchatApp, isOnline: boolean) => void;
+    contentsByLocale?: Record<string, WebchatLocaleContents>;
     appId?: string;
     visibility?: boolean | (() => boolean) | 'dynamic';
     server?: ServerConfig;
@@ -111,6 +115,7 @@ export interface WebchatProps {
     server?: ServerConfig;
     localWebviews?: React.ComponentType[];
     previewUtils?: PreviewUtils;
+    contentsByLocale?: Record<string, WebchatLocaleContents>;
 }
 export type EventArgs = {
     [key: string]: any;

package/lib/cjs/index-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"index-types.js","sourceRoot":"","sources":["../../src/index-types.ts"],"names":[],"mappings":";;;AAgKA,IAAY,OAKX;AALD,WAAY,OAAO;IACjB,sBAAW,CAAA;IACX,wBAAa,CAAA;IACb,0BAAe,CAAA;IACf,4BAAiB,CAAA;AACnB,CAAC,EALW,OAAO,uBAAP,OAAO,QAKlB;AAED,IAAY,MAGX;AAHD,WAAY,MAAM;IAChB,0BAAgB,CAAA;IAChB,4BAAkB,CAAA;AACpB,CAAC,EAHW,MAAM,sBAAN,MAAM,QAGjB"}
+{"version":3,"file":"index-types.js","sourceRoot":"","sources":["../../src/index-types.ts"],"names":[],"mappings":";;;AAsKA,IAAY,OAKX;AALD,WAAY,OAAO;IACjB,sBAAW,CAAA;IACX,wBAAa,CAAA;IACb,0BAAe,CAAA;IACf,4BAAiB,CAAA;AACnB,CAAC,EALW,OAAO,uBAAP,OAAO,QAKlB;AAED,IAAY,MAGX;AAHD,WAAY,MAAM;IAChB,0BAAgB,CAAA;IAChB,4BAAkB,CAAA;AACpB,CAAC,EAHW,MAAM,sBAAN,MAAM,QAGjB"}

package/lib/cjs/index.d.ts

@@ -1,6 +1,7 @@
 export { BotonicInputTester, BotonicOutputTester } from './botonic-tester';
 export * from './components';
 export * from './contexts';
+export { DEBUG_SYSTEM_MESSAGES } from './debug-system-messages';
 export { DevApp } from './dev-app';
 export * from './index-types';
 export { msgsToBotonic, msgToBotonic } from './msg-to-botonic';