@botonic/react 0.56.0-alpha.0 → 0.57.0-rslib-esm.1

package/lib/debug-system-messages.js

@@ -0,0 +1,234 @@
+import { EventAction } from "@botonic/core";
+
+
+/**
+ * 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)
+ */ 
+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.'
+            }
+        ]
+    }
+];
+const DEBUG_SYSTEM_MESSAGES = {
+    keyword: {
+        action: EventAction.Keyword,
+        flow_id: 'flow-mock-001',
+        flow_node_id: 'node-mock-001',
+        nlu_keyword_is_regex: false,
+        nlu_keyword_name: 'hello'
+    },
+    smartIntent: {
+        action: EventAction.IntentSmart,
+        nlu_intent_smart_title: 'Greeting smart intent'
+    },
+    fallback: {
+        action: EventAction.Fallback,
+        user_input: "I don't understand this bot",
+        fallback_out: 1,
+        fallback_message_id: 'msg-mock-002'
+    },
+    handoffSuccess: {
+        action: EventAction.HandoffSuccess,
+        handoff_queue_name: 'Support Team',
+        handoff_is_queue_open: true,
+        handoff_has_auto_assign: true,
+        handoff_note_id: ''
+    },
+    botAction: {
+        action: EventAction.BotAction,
+        payload: 'custom-action-result'
+    },
+    conditionalChannel: {
+        action: EventAction.ConditionalChannel,
+        channel: 'whatsapp'
+    },
+    conditionalCountry: {
+        action: EventAction.ConditionalCountry,
+        country: 'ES'
+    },
+    conditionalCustom: {
+        action: EventAction.ConditionalCustom,
+        conditional_variable: 'user_plan',
+        variable_format: 'string',
+        operator: 'is_equal'
+    },
+    conditionalQueueStatus: {
+        action: EventAction.ConditionalQueueStatus,
+        queue_id: 'queue-mock-001',
+        queue_name: 'Support Team',
+        is_queue_open: true,
+        is_available_agent: true
+    },
+    redirectFlow: {
+        action: EventAction.RedirectFlow,
+        flow_id: 'flow-mock-001',
+        flow_name: 'Main Flow',
+        flow_target_id: 'flow-mock-002',
+        flow_target_name: 'Billing Flow'
+    },
+    webviewActionTriggered: {
+        action: EventAction.WebviewActionTriggered,
+        webview_target_id: 'webview-mock-001',
+        webview_name: 'Payment Form'
+    },
+    aiAgent: {
+        action: 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: 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: EventAction.AiAgent,
+        flow_node_content_id: 'content-mock-003',
+        user_input: 'Hello',
+        tools_executed: [],
+        input_guardrails_triggered: [],
+        output_guardrails_triggered: [],
+        exit: false,
+        error: true
+    },
+    aiAgentRouter: {
+        noTransfer: {
+            action: EventAction.AiAgentRouter,
+            flow_node_content_id: 'customer_support_router',
+            tools_executed: [],
+            memory_length: 2,
+            input_guardrails_triggered: [],
+            output_guardrails_triggered: [],
+            exit: false,
+            starting_agent_name: 'customer_support_router',
+            last_agent_name: 'customer_support_router',
+            available_specialists: [
+                {
+                    name: 'billing_specialist',
+                    description: 'Handles billing and invoice queries'
+                },
+                {
+                    name: 'technical_support_specialist',
+                    description: 'Handles technical issues'
+                }
+            ],
+            is_transferred_to_specialist: false
+        },
+        inputGuardrail: {
+            action: EventAction.AiAgentRouter,
+            flow_node_content_id: 'customer_support_router',
+            tools_executed: [],
+            memory_length: 0,
+            input_guardrails_triggered: [
+                'is_competence'
+            ],
+            output_guardrails_triggered: [],
+            exit: false,
+            starting_agent_name: 'customer_support_router',
+            last_agent_name: 'customer_support_router',
+            available_specialists: [
+                {
+                    name: 'billing_specialist',
+                    description: 'Handles billing and invoice queries'
+                },
+                {
+                    name: 'technical_support_specialist',
+                    description: 'Handles technical issues'
+                }
+            ],
+            is_transferred_to_specialist: false
+        },
+        transfer: {
+            action: EventAction.AiAgentRouter,
+            flow_node_content_id: 'customer_support_router',
+            tools_executed: [],
+            memory_length: 3,
+            input_guardrails_triggered: [],
+            output_guardrails_triggered: [],
+            exit: true,
+            starting_agent_name: 'customer_support_router',
+            last_agent_name: 'billing_specialist',
+            available_specialists: [
+                {
+                    name: 'billing_specialist',
+                    description: 'Handles billing and invoice queries'
+                },
+                {
+                    name: 'technical_support_specialist',
+                    description: 'Handles technical issues'
+                },
+                {
+                    name: 'sales_specialist',
+                    description: 'Handles sales and pricing queries'
+                }
+            ],
+            is_transferred_to_specialist: true,
+            knowledge_base_chunks_with_sources: []
+        }
+    }
+};
+
+export { DEBUG_SYSTEM_MESSAGES };
+
+//# sourceMappingURL=debug-system-messages.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"debug-system-messages.js","sources":["../src/debug-system-messages.ts"],"sourcesContent":["/**\n * Dev-only mock payloads for every SystemDebugTrace event type.\n *\n * Usage from dev-entry.ts:\n *   import { DEBUG_SYSTEM_MESSAGES } from '@botonic/react/src/debug-system-messages'\n *   app.addDebugSystemMessage(DEBUG_SYSTEM_MESSAGES.keyword)\n *\n * Usage from the browser console (window.Botonic is the DevApp instance):\n *   Botonic.addDebugSystemMessage({ action: 'nlu_keyword', nlu_keyword_name: 'hello', ... })\n *   // or use the pre-built fixtures exposed on the DevApp:\n *   Botonic.addDebugSystemMessage(Botonic.debugSystemMessages.aiAgent)\n */\n\nimport { EventAction } from '@botonic/core'\n\nimport type {\n  AiAgentDebugEvent,\n  AiAgentRouterDebugEvent,\n  BotActionDebugEvent,\n  ConditionalChannelDebugEvent,\n  ConditionalCountryDebugEvent,\n  ConditionalCustomDebugEvent,\n  ConditionalQueueStatusDebugEvent,\n  FallbackDebugEvent,\n  HandoffSuccessDebugEvent,\n  KeywordDebugEvent,\n  RedirectFlowDebugEvent,\n  SmartIntentDebugEvent,\n  WebviewActionTriggeredDebugEvent,\n} from './components/system-debug-trace/events'\nimport type { ChunkIdsGroupedBySourceData } from './components/system-debug-trace/events/knowledge-bases-types'\n\nconst mockChunksWithSources: ChunkIdsGroupedBySourceData[] = [\n  {\n    source: {\n      id: 'src-mock-001',\n      name: 'Help Center',\n      type: 'url',\n      scrapingCountryCode: null,\n      createdAt: '2026-01-01T00:00:00Z',\n      createdBy: 'mock',\n      lastUpdatedAt: '2026-01-01T00:00:00Z',\n      lastUpdatedBy: 'mock',\n      activeExtractionJob: null as any,\n      lastExtractionJob: null as any,\n    },\n    chunks: [\n      {\n        id: 'chunk-mock-001',\n        text: 'To reset your password, go to Settings > Security > Reset Password.',\n      },\n    ],\n  },\n]\n\nexport const DEBUG_SYSTEM_MESSAGES = {\n  keyword: {\n    action: EventAction.Keyword,\n    flow_id: 'flow-mock-001',\n    flow_node_id: 'node-mock-001',\n    nlu_keyword_is_regex: false,\n    nlu_keyword_name: 'hello',\n  } satisfies KeywordDebugEvent,\n\n  smartIntent: {\n    action: EventAction.IntentSmart,\n    nlu_intent_smart_title: 'Greeting smart intent',\n  } satisfies SmartIntentDebugEvent,\n\n  fallback: {\n    action: EventAction.Fallback,\n    user_input: \"I don't understand this bot\",\n    fallback_out: 1,\n    fallback_message_id: 'msg-mock-002',\n  } satisfies FallbackDebugEvent,\n\n  handoffSuccess: {\n    action: EventAction.HandoffSuccess,\n    handoff_queue_name: 'Support Team',\n    handoff_is_queue_open: true,\n    handoff_has_auto_assign: true,\n    handoff_note_id: '',\n  } satisfies HandoffSuccessDebugEvent,\n\n  botAction: {\n    action: EventAction.BotAction,\n    payload: 'custom-action-result',\n  } satisfies BotActionDebugEvent,\n\n  conditionalChannel: {\n    action: EventAction.ConditionalChannel,\n    channel: 'whatsapp',\n  } satisfies ConditionalChannelDebugEvent,\n\n  conditionalCountry: {\n    action: EventAction.ConditionalCountry,\n    country: 'ES',\n  } satisfies ConditionalCountryDebugEvent,\n\n  conditionalCustom: {\n    action: EventAction.ConditionalCustom,\n    conditional_variable: 'user_plan',\n    variable_format: 'string',\n    operator: 'is_equal',\n  } satisfies ConditionalCustomDebugEvent,\n\n  conditionalQueueStatus: {\n    action: EventAction.ConditionalQueueStatus,\n    queue_id: 'queue-mock-001',\n    queue_name: 'Support Team',\n    is_queue_open: true,\n    is_available_agent: true,\n  } satisfies ConditionalQueueStatusDebugEvent,\n\n  redirectFlow: {\n    action: EventAction.RedirectFlow,\n    flow_id: 'flow-mock-001',\n    flow_name: 'Main Flow',\n    flow_target_id: 'flow-mock-002',\n    flow_target_name: 'Billing Flow',\n  } satisfies RedirectFlowDebugEvent,\n\n  webviewActionTriggered: {\n    action: EventAction.WebviewActionTriggered,\n    webview_target_id: 'webview-mock-001',\n    webview_name: 'Payment Form',\n  } satisfies WebviewActionTriggeredDebugEvent,\n\n  aiAgent: {\n    action: EventAction.AiAgent,\n    flow_node_content_id: 'content-mock-001',\n    user_input: 'Can you help me with my subscription?',\n    tools_executed: [\n      {\n        tool_name: 'retrieve_knowledge',\n        tool_arguments: { query: 'subscription management' },\n        tool_results:\n          'Found 3 relevant articles about subscription management.',\n        knowledgebase_sources_ids: ['src-mock-001'],\n        knowledgebase_chunks_ids: ['chunk-mock-001'],\n      },\n      {\n        tool_name: 'get_user_subscription',\n        tool_arguments: { user_id: 'user-mock-001' },\n        tool_results: '{\"plan\": \"pro\", \"renewal_date\": \"2026-06-01\"}',\n      },\n    ],\n    input_guardrails_triggered: [],\n    output_guardrails_triggered: [],\n    exit: false,\n    error: false,\n    knowledge_base_chunks_with_sources: mockChunksWithSources,\n  } satisfies AiAgentDebugEvent,\n\n  aiAgentWithGuardrails: {\n    action: EventAction.AiAgent,\n    flow_node_content_id: 'content-mock-002',\n    user_input: 'Tell me something inappropriate',\n    tools_executed: [],\n    input_guardrails_triggered: ['content_safety', 'topic_restriction'],\n    output_guardrails_triggered: [],\n    exit: false,\n    error: false,\n  } satisfies AiAgentDebugEvent,\n\n  aiAgentError: {\n    action: EventAction.AiAgent,\n    flow_node_content_id: 'content-mock-003',\n    user_input: 'Hello',\n    tools_executed: [],\n    input_guardrails_triggered: [],\n    output_guardrails_triggered: [],\n    exit: false,\n    error: true,\n  } satisfies AiAgentDebugEvent,\n\n  aiAgentRouter: {\n    noTransfer: {\n      action: EventAction.AiAgentRouter,\n      flow_node_content_id: 'customer_support_router',\n      tools_executed: [],\n      memory_length: 2,\n      input_guardrails_triggered: [],\n      output_guardrails_triggered: [],\n      exit: false,\n      starting_agent_name: 'customer_support_router',\n      last_agent_name: 'customer_support_router',\n      available_specialists: [\n        {\n          name: 'billing_specialist',\n          description: 'Handles billing and invoice queries',\n        },\n        {\n          name: 'technical_support_specialist',\n          description: 'Handles technical issues',\n        },\n      ],\n      is_transferred_to_specialist: false,\n    } satisfies AiAgentRouterDebugEvent,\n\n    inputGuardrail: {\n      action: EventAction.AiAgentRouter,\n      flow_node_content_id: 'customer_support_router',\n      tools_executed: [],\n      memory_length: 0,\n      input_guardrails_triggered: ['is_competence'],\n      output_guardrails_triggered: [],\n      exit: false,\n      starting_agent_name: 'customer_support_router',\n      last_agent_name: 'customer_support_router',\n      available_specialists: [\n        {\n          name: 'billing_specialist',\n          description: 'Handles billing and invoice queries',\n        },\n        {\n          name: 'technical_support_specialist',\n          description: 'Handles technical issues',\n        },\n      ],\n      is_transferred_to_specialist: false,\n    } satisfies AiAgentRouterDebugEvent,\n\n    transfer: {\n      action: EventAction.AiAgentRouter,\n      flow_node_content_id: 'customer_support_router',\n      tools_executed: [],\n      memory_length: 3,\n      input_guardrails_triggered: [],\n      output_guardrails_triggered: [],\n      exit: true,\n      starting_agent_name: 'customer_support_router',\n      last_agent_name: 'billing_specialist',\n      available_specialists: [\n        {\n          name: 'billing_specialist',\n          description: 'Handles billing and invoice queries',\n        },\n        {\n          name: 'technical_support_specialist',\n          description: 'Handles technical issues',\n        },\n        {\n          name: 'sales_specialist',\n          description: 'Handles sales and pricing queries',\n        },\n      ],\n      is_transferred_to_specialist: true,\n      knowledge_base_chunks_with_sources: [],\n    } satisfies AiAgentRouterDebugEvent,\n  },\n}\n"],"names":["EventAction","mockChunksWithSources","DEBUG_SYSTEM_MESSAGES"],"mappings":"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"}

package/lib/dev-app.d.ts

@@ -0,0 +1,213 @@
+export class DevApp extends WebchatApp {
+    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;
+        coverComponent: any;
+        blockInputs: any;
+        enableEmojiPicker: any;
+        enableAttachments: any;
+        enableUserInput: any;
+        enableAnimations: any;
+        shadowDOM: any;
+        hostId: any;
+        storage: any;
+        storageKey: any;
+        onInit: any;
+        onOpen: any;
+        onClose: any;
+        onMessage: any;
+        onTrackEvent: any;
+        contentsByLocale: any;
+        webviews: any;
+    });
+    webviews: any;
+    bot: ReactBot;
+    getComponent(host: any, optionsAtRuntime?: {}): import("react").JSX.Element;
+    render(dest: any, optionsAtRuntime?: {}): Promise<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;
+        };
+        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;
+            operator: 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.js").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;
+        };
+        aiAgentRouter: {
+            noTransfer: {
+                action: import("@botonic/core").EventAction.AiAgentRouter;
+                flow_node_content_id: string;
+                tools_executed: never[];
+                memory_length: number;
+                input_guardrails_triggered: never[];
+                output_guardrails_triggered: never[];
+                exit: false;
+                starting_agent_name: string;
+                last_agent_name: string;
+                available_specialists: {
+                    name: string;
+                    description: string;
+                }[];
+                is_transferred_to_specialist: false;
+            };
+            inputGuardrail: {
+                action: import("@botonic/core").EventAction.AiAgentRouter;
+                flow_node_content_id: string;
+                tools_executed: never[];
+                memory_length: number;
+                input_guardrails_triggered: string[];
+                output_guardrails_triggered: never[];
+                exit: false;
+                starting_agent_name: string;
+                last_agent_name: string;
+                available_specialists: {
+                    name: string;
+                    description: string;
+                }[];
+                is_transferred_to_specialist: false;
+            };
+            transfer: {
+                action: import("@botonic/core").EventAction.AiAgentRouter;
+                flow_node_content_id: string;
+                tools_executed: never[];
+                memory_length: number;
+                input_guardrails_triggered: never[];
+                output_guardrails_triggered: never[];
+                exit: true;
+                starting_agent_name: string;
+                last_agent_name: string;
+                available_specialists: {
+                    name: string;
+                    description: string;
+                }[];
+                is_transferred_to_specialist: true;
+                knowledge_base_chunks_with_sources: never[];
+            };
+        };
+    };
+    /**
+     * 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;
+        lastRoutePath: any;
+    }): Promise<void>;
+}
+import { WebchatApp } from './webchat-app.js';
+import { ReactBot } from './react-bot.js';

package/lib/dev-app.js

@@ -0,0 +1,135 @@
+import { jsx } from "react/jsx-runtime";
+import { INPUT } from "@botonic/core";
+import { createRoot } from "react-dom/client";
+import { DEBUG_SYSTEM_MESSAGES } from "./debug-system-messages.js";
+import { SENDERS } from "./index-types.js";
+import { ReactBot } from "./react-bot.js";
+import { onDOMLoaded } from "./util/dom.js";
+import { WebchatDev } from "./webchat/webchat-dev.js";
+import { WebchatApp } from "./webchat-app.js";
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+class DevApp extends WebchatApp {
+    getComponent(host, 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;
+        this.onInit = onInit || this.onInit;
+        this.onOpen = onOpen || this.onOpen;
+        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 /*#__PURE__*/ jsx(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
+        });
+    }
+    async render(dest, optionsAtRuntime = {}) {
+        onDOMLoaded(()=>{
+            const devAppComponent = this.getComponent(dest, optionsAtRuntime);
+            const container = this.getReactMountNode(dest);
+            const reactRoot = createRoot(container);
+            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;
+    }
+    /**
+   * 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: INPUT.SYSTEM_DEBUG_TRACE,
+            data: eventData
+        });
+    }
+    async onUserInput({ input, session, lastRoutePath }) {
+        this.onMessage?.(this, {
+            sentBy: SENDERS.user,
+            message: input
+        });
+        const resp = await this.bot.input({
+            input,
+            session,
+            lastRoutePath
+        });
+        this.onMessage && resp.response.map((r)=>this.onMessage(this, {
+                sentBy: SENDERS.bot,
+                message: r
+            }));
+        this.webchatRef.current.addBotResponse(resp);
+    }
+    constructor({ theme = {}, persistentMenu, coverComponent, blockInputs, enableEmojiPicker, enableAttachments, enableUserInput, enableAnimations, shadowDOM, hostId, storage, storageKey, onInit, onOpen, onClose, onMessage, onTrackEvent, contentsByLocale, webviews, ...botOptions }){
+        super({
+            theme,
+            persistentMenu,
+            coverComponent,
+            blockInputs,
+            enableEmojiPicker,
+            enableAttachments,
+            enableUserInput,
+            enableAnimations,
+            shadowDOM,
+            hostId,
+            storage,
+            storageKey,
+            onInit,
+            onOpen,
+            onClose,
+            onMessage,
+            onTrackEvent,
+            contentsByLocale
+        });
+        this.webviews = webviews;
+        this.bot = new ReactBot({
+            ...botOptions
+        });
+    }
+}
+
+export { DevApp };
+
+//# sourceMappingURL=dev-app.js.map

package/lib/dev-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-app.js","sources":["../src/dev-app.jsx"],"sourcesContent":["import { INPUT } from '@botonic/core'\nimport { createRoot } from 'react-dom/client'\n\nimport { DEBUG_SYSTEM_MESSAGES } from './debug-system-messages'\nimport { SENDERS } from './index-types'\nimport { ReactBot } from './react-bot'\nimport { onDOMLoaded } from './util/dom'\nimport { WebchatDev } from './webchat/webchat-dev'\nimport { WebchatApp } from './webchat-app'\n\nexport class DevApp extends WebchatApp {\n  constructor({\n    theme = {},\n    persistentMenu,\n    coverComponent,\n    blockInputs,\n    enableEmojiPicker,\n    enableAttachments,\n    enableUserInput,\n    enableAnimations,\n    shadowDOM,\n    hostId,\n    storage,\n    storageKey,\n    onInit,\n    onOpen,\n    onClose,\n    onMessage,\n    onTrackEvent,\n    contentsByLocale,\n    webviews,\n    ...botOptions\n  }) {\n    super({\n      theme,\n      persistentMenu,\n      coverComponent,\n      blockInputs,\n      enableEmojiPicker,\n      enableAttachments,\n      enableUserInput,\n      enableAnimations,\n      shadowDOM,\n      hostId,\n      storage,\n      storageKey,\n      onInit,\n      onOpen,\n      onClose,\n      onMessage,\n      onTrackEvent,\n      contentsByLocale,\n    })\n    this.webviews = webviews\n    this.bot = new ReactBot({\n      ...botOptions,\n    })\n  }\n\n  getComponent(host, optionsAtRuntime = {}) {\n    let {\n      theme = {},\n      storage,\n      storageKey,\n      onInit,\n      onOpen,\n      onClose,\n      onMessage,\n      onTrackEvent,\n      contentsByLocale,\n      hostId,\n      ...webchatOptions\n    } = optionsAtRuntime\n    theme = super.createInitialTheme(optionsAtRuntime)\n    storage = storage || this.storage\n    storageKey = storageKey || this.storageKey\n    this.onInit = onInit || this.onInit\n    this.onOpen = onOpen || this.onOpen\n    this.onClose = onClose || this.onClose\n    this.onMessage = onMessage || this.onMessage\n    this.onTrackEvent = onTrackEvent || this.onTrackEvent\n    this.contentsByLocale = contentsByLocale || this.contentsByLocale\n    this.hostId = hostId || this.hostId\n    this.createRootElement(host)\n    return (\n      <WebchatDev\n        {...webchatOptions}\n        ref={this.webchatRef}\n        host={this.host}\n        shadowDOM={this.shadowDOM}\n        theme={theme}\n        storage={storage}\n        storageKey={storageKey}\n        contentsByLocale={this.contentsByLocale}\n        onInit={(...args) => this.onInitWebchat(...args)}\n        onOpen={(...args) => this.onOpenWebchat(...args)}\n        onClose={(...args) => this.onCloseWebchat(...args)}\n        onUserInput={(...args) => this.onUserInput(...args)}\n        onTrackEvent={(...args) => this.onTrackEvent(...args)}\n        webviews={this.webviews}\n      />\n    )\n  }\n\n  async render(dest, optionsAtRuntime = {}) {\n    onDOMLoaded(() => {\n      const devAppComponent = this.getComponent(dest, optionsAtRuntime)\n      const container = this.getReactMountNode(dest)\n      const reactRoot = createRoot(container)\n      reactRoot.render(devAppComponent)\n    })\n  }\n\n  /** Pre-built mock payloads for every debug event type. Handy from the console:\n   *  Botonic.addDebugSystemMessage(Botonic.debugSystemMessages.aiAgent) */\n  get debugSystemMessages() {\n    return DEBUG_SYSTEM_MESSAGES\n  }\n\n  /**\n   * Inject a mock SystemDebugTrace event into the preview webchat.\n   * Accepts any DebugEvent payload (plain object with an `action` field).\n   *\n   * From code:\n   *   import { DEBUG_SYSTEM_MESSAGES } from '@botonic/react/src/debug-system-messages'\n   *   app.addDebugSystemMessage(DEBUG_SYSTEM_MESSAGES.aiAgent)\n   *\n   * From the browser console:\n   *   Botonic.addDebugSystemMessage(Botonic.debugSystemMessages.conditionalQueueStatus)\n   *   Botonic.addDebugSystemMessage({ action: 'nlu_keyword', nlu_keyword_name: 'hi', nlu_keyword_is_regex: false, flow_id: 'f1', flow_node_id: 'n1' })\n   */\n  addDebugSystemMessage(eventData) {\n    this.addSystemMessage({ type: INPUT.SYSTEM_DEBUG_TRACE, data: eventData })\n  }\n\n  async onUserInput({ input, session, lastRoutePath }) {\n    this.onMessage?.(this, {\n      sentBy: SENDERS.user,\n      message: input,\n    })\n    const resp = await this.bot.input({ input, session, lastRoutePath })\n    this.onMessage &&\n      resp.response.map(r =>\n        this.onMessage(this, {\n          sentBy: SENDERS.bot,\n          message: r,\n        })\n      )\n    this.webchatRef.current.addBotResponse(resp)\n  }\n}\n"],"names":["INPUT","createRoot","DEBUG_SYSTEM_MESSAGES","SENDERS","ReactBot","onDOMLoaded","WebchatDev","WebchatApp","DevApp","host","optionsAtRuntime","theme","storage","storageKey","onInit","onOpen","onClose","onMessage","onTrackEvent","contentsByLocale","hostId","webchatOptions","args","dest","devAppComponent","container","reactRoot","eventData","input","session","lastRoutePath","resp","r","persistentMenu","coverComponent","blockInputs","enableEmojiPicker","enableAttachments","enableUserInput","enableAnimations","shadowDOM","webviews","botOptions"],"mappings":"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"}