@botonic/nx-plugin 2.29.0 → 2.31.0

package/src/executors/serve-bot/schema.json

@@ -34,15 +34,23 @@
       "description": "Local port the Lambda listens on (used for cloudflared --url). Default 3001.",
       "default": 3001
     },
-    "logViewer": {
-      "type": "boolean",
-      "description": "When true, start a web-based log viewer (frontail) and open webchat with an embedded logs panel.",
-      "default": false
-    },
     "logViewerPort": {
       "type": "number",
       "description": "Port for the log viewer web interface",
       "default": 9001
+    },
+    "provider": {
+      "type": "string",
+      "description": "Channel provider to enable local routing for. Currently only 'whatsapp' is supported.",
+      "enum": ["whatsapp"]
+    },
+    "phone": {
+      "type": "string",
+      "description": "Your phone number in E.164 format (e.g. +34612345678). Required when provider=whatsapp. Messages from this number will route to your local Lambda."
+    },
+    "botName": {
+      "type": "string",
+      "description": "Name of the Hubtype bot to use for local development. Skips the interactive bot-selection prompt."
     }
   },
   "required": []

package/src/generators/bot-app/files/src/client/webchat/index.tsx.template

@@ -66,8 +66,10 @@ function App({
     <WebchatTrigger
       appId={webchatConfig.appId}
       position='bottom-right'
+      loader={() => import('./webchat')}
       onReady={handleReady}
       webchatConfig={{
+        ...webchatConfig,
         avatarConfig,
         customMessages,
         title: options.title || '<%= className %>',

package/src/generators/bot-app/files/src/client/webchat/webchat.tsx.template

@@ -0,0 +1,111 @@
+import type { WebchatController } from '@botonic/webchat-core'
+import type {
+  WebchatCompositionExtras,
+  WebchatCompositionProps,
+} from '@botonic/webchat-react'
+import {
+  useWebchatContext,
+  WebchatContainer,
+  WebchatHeader,
+  WebchatInput,
+  WebchatMessages,
+  WebchatProvider,
+} from '@botonic/webchat-react'
+import { useEffect, useRef } from 'react'
+
+function WebchatContent({
+  isOpen,
+  onClose,
+  onControllerReady,
+  title,
+  placeholder,
+  showBranding,
+}: {
+  isOpen: boolean
+  onClose: () => void
+  onControllerReady: (controller: WebchatController) => void
+  title?: string
+  placeholder?: string
+  showBranding?: boolean
+}) {
+  const { controller } = useWebchatContext()
+  const hasNotifiedRef = useRef(false)
+
+  useEffect(() => {
+    if (controller && !hasNotifiedRef.current) {
+      hasNotifiedRef.current = true
+      onControllerReady(controller)
+    }
+  }, [controller, onControllerReady])
+
+  useEffect(() => {
+    if (!controller) return
+    const snapshot = controller.machine.getSnapshot()
+    const currentIsOpen = snapshot.context.isOpen ?? false
+    if (isOpen && !currentIsOpen) {
+      controller.open()
+    } else if (!isOpen && currentIsOpen) {
+      controller.close()
+    }
+  }, [isOpen, controller])
+
+  const handleClose = () => {
+    controller?.close()
+    onClose()
+  }
+
+  return (
+    <WebchatContainer layout='default'>
+      <WebchatHeader title={title} onClose={handleClose} />
+      <WebchatMessages variant='default' />
+      <WebchatInput
+        placeholder={placeholder}
+        showBranding={showBranding ?? true}
+        variant='default'
+      />
+    </WebchatContainer>
+  )
+}
+
+export default function Webchat({
+  appId,
+  isOpen,
+  onClose,
+  onControllerReady,
+  ...extras
+}: WebchatCompositionProps) {
+  // `WebchatCompositionProps` exposes extras via a `[key: string]: unknown`
+  // index signature, so assert the concrete shape once instead of per field.
+  const {
+    title,
+    placeholder,
+    showBranding,
+    customMessages = {},
+    avatarConfig,
+    webchatClientSettings,
+    enableResponsiveHeroHeader,
+    storage,
+    previewUtils,
+  } = extras as WebchatCompositionExtras
+
+  return (
+    <WebchatProvider
+      appId={appId}
+      customMessages={customMessages}
+      avatarConfig={avatarConfig}
+      webchatClientSettings={webchatClientSettings}
+      enableResponsiveHeroHeader={enableResponsiveHeroHeader}
+      storage={storage}
+      previewUtils={previewUtils}
+    >
+      <WebchatContent
+        isOpen={isOpen}
+        onClose={onClose}
+        onControllerReady={onControllerReady}
+        title={title}
+        placeholder={placeholder}
+        showBranding={showBranding}
+      />
+    </WebchatProvider>
+  )
+}

package/src/generators/bot-app/files/src/server/bot/plugins/flow-builder/index.ts.template

@@ -1,12 +1,13 @@
+import { BotonicContext } from '@botonic/core'
 import { AiAgentArgs } from '@botonic/plugin-ai-agents'
+import { BotonicPluginHubtypeAnalytics } from '@botonic/plugin-hubtype-analytics'
 import {
   BotonicPluginFlowBuilder,
   BotonicPluginFlowBuilderOptions,
   FlowBuilderJSONVersion,
 } from '@botonic/plugin-flow-builder'
-import { BotonicContext } from '@botonic/core'
+import { EventAction, HtEventProps } from '@botonic/shared'
 
-import { trackEventToHubtypeAnalytics } from '../../tracking'
 import { isLambdaLocal } from '../../utils'
 import { getAiAgentResponse } from '../ai-agents'
 
@@ -14,8 +15,16 @@ export const flowBuilderConfig: BotonicPluginFlowBuilderOptions = {
   flowVersion: isLambdaLocal()
     ? FlowBuilderJSONVersion.DRAFT
     : FlowBuilderJSONVersion.LATEST,
-  trackEvent: async (botonicContext: BotonicContext, eventAction, args) => {
-    await trackEventToHubtypeAnalytics(botonicContext, eventAction, args)
+  trackEvent: async (
+    context: BotonicContext,
+    eventAction: EventAction,
+    args: Omit<HtEventProps, 'action'>
+  ): Promise<void> => {
+    const analyticsPlugin = new BotonicPluginHubtypeAnalytics()
+    await analyticsPlugin.trackEvent(context, {
+      action: eventAction,
+      ...args,
+    } as HtEventProps)
   },
   getAiAgentResponse: async (
     botonicContext: BotonicContext,

package/src/generators/bot-app/files/src/server/bot/plugins/index.ts.template

@@ -1,5 +1,3 @@
-import { BotonicPluginHubtypeAnalytics } from '@botonic/plugin-hubtype-analytics'
-
 import { aiAgentsPlugin } from './ai-agents'
 import { flowBuilderPlugin } from './flow-builder'
 
@@ -7,5 +5,4 @@ export const plugins = {
   flowBuilder: flowBuilderPlugin,
   // AI Agents plugin is only loaded if AZURE_OPENAI_API_KEY or OPENAI_API_KEY is set
   ...(aiAgentsPlugin && { aiAgents: aiAgentsPlugin }),
-  hubtypeAnalytics: new BotonicPluginHubtypeAnalytics(),
 }

package/src/generators/bot-app/files/src/server/lambda/handler.js.template

@@ -3,7 +3,7 @@
 /*
 	In lambda functions, it only have access to all files the first time it's invoked,
 	and placed into memory, after that it only calls the function that have the information
-	loadded in memory. For this reason, we initialize the bot the first time, and then we
+	loaded in memory. For this reason, we initialize the bot the first time, and then we
 	only execute the input function
 
 	https://docs.aws.amazon.com/lambda/latest/dg/nodejs-prog-model-handler.html

package/src/generators/bot-app/files/src/server/lambda/package.json

@@ -12,9 +12,9 @@
   "description": "",
   "dependencies": {
     "uuid": "^11.1.0",
-    "@openai/agents": "^0.1.11",
-    "openai": "^5.23.2",
+    "@openai/agents": "^0.10.1",
+    "openai": "^6.0.0",
     "tslib": "^2.3.0",
-    "zod": "^3.25.76"
+    "zod": "^4.4.3"
   }
 }

package/src/generators/bot-app/files/vite/node.config.ts.template

@@ -12,11 +12,9 @@ export function getNodeConfig(): UserConfig {
     root: projectRoot,
     cacheDir: resolve(projectRoot, BUILD_CONFIG.CACHE_DIR.node),
 
-    // SSR configuration - bundle @botonic/* packages into the lambda
-    // By default, Vite externalizes node_modules in SSR mode, but we need
-    // @botonic packages bundled since they won't be available at runtime in Lambda
+    // Bundle all dependencies into the Lambda artifact — no node_modules at runtime.
     ssr: {
-      noExternal: [/@botonic\/.*/],
+      noExternal: true,
     },
 
     build: {

package/src/generators/bot-app/files/vite/webchat.config.ts.template

@@ -9,6 +9,25 @@ const projectRoot = resolve(__dirname, '..')
 const output = BUILD_CONFIG.OUTPUT.webchat
 const server = BUILD_CONFIG.SERVER.webchat
 
+/**
+ * Returns the Vite `base` for the webchat bundle.
+ *
+ * Why this matters: the dashboard's flow-builder preview panel
+ * (`PreviewWebchatAppV2`) loads this bundle cross-origin from the bot's Netlify
+ * deploy while running on a different origin (localhost:4200 in dev, the
+ * dashboard domain in prod). With an absolute base ('/'), Vite resolves the
+ * bundle's dynamically-imported chunks as `/chunk.js` against the *host page's*
+ * origin — so the preview requests them from the dashboard origin and they 404.
+ *
+ * A relative base ('') makes those chunks resolve against the entry module's own
+ * origin (import.meta.url = Netlify) instead, so the preview loads the whole
+ * bundle from Netlify with no chunk 404s and no service-worker proxy. The dev
+ * server keeps '/' so its own HMR/asset paths keep working.
+ */
+function getCrossOriginSafeBase(command: 'serve' | 'build'): string {
+  return command === 'build' ? '' : '/'
+}
+
 export function getWebchatConfig(command: 'serve' | 'build'): UserConfig {
   const openPath =
     command === 'serve' && process.env.LOG_VIEWER_PORT
@@ -26,7 +45,7 @@ export function getWebchatConfig(command: 'serve' | 'build'): UserConfig {
     cacheDir: resolve(projectRoot, BUILD_CONFIG.CACHE_DIR.webchat),
     publicDir: resolve(projectRoot, BUILD_CONFIG.PUBLIC_DIR),
     appType: 'spa',
-    base: '/',
+    base: getCrossOriginSafeBase(command),
 
     server: {
       port: server.port,

package/src/generators/bot-app/generator.js

@@ -158,10 +158,11 @@ function createPackageJson(tree, options, botonicVersion, lilaraVersion) {
       "@lilara/ui-web": lilaraVersion,
       "@lilara/ui-web-react": lilaraVersion,
       react: "18.3.1",
-      "react-dom": "18.3.1"
+      "react-dom": "18.3.1",
+      zod: "^4.4.3"
     },
     devDependencies: {
-      "@nx/vite": "21.6.3",
+      "@nx/vite": "21.6.11",
       "@types/node": "22.13.0",
       "@types/react": "18.3.1",
       "@types/react-dom": "18.3.0",
@@ -169,7 +170,7 @@ function createPackageJson(tree, options, botonicVersion, lilaraVersion) {
       "@vitejs/plugin-react-swc": "^3.5.0",
       typescript: "5.7.3",
       vite: "7.1.9",
-      vitest: "^4.0.15"
+      vitest: "4.1.1"
     }
   };
   (0, import_devkit.writeJson)(tree, `${options.projectRoot}/package.json`, packageJson);
@@ -257,7 +258,7 @@ function addBotonicDependencies(tree, botonicVersion) {
     },
     // devDependencies
     {
-      "@nx/vite": "21.6.3",
+      "@nx/vite": "21.6.11",
       "@types/node": "22.13.0",
       "@types/react": "18.3.1",
       "@types/react-dom": "18.3.0",
@@ -265,7 +266,7 @@ function addBotonicDependencies(tree, botonicVersion) {
       "@vitejs/plugin-react-swc": "3.5.0",
       typescript: "5.7.3",
       vite: "7.1.9",
-      vitest: "^4.0.15"
+      vitest: "4.1.1"
     }
   );
 }

package/src/generators/bot-app/lilara-version.json

@@ -1,3 +1,3 @@
 {
-  "version": "0.8.0"
+  "version": "0.9.0"
 }

package/src/lib/api-service.d.ts

@@ -1,7 +1,6 @@
 import { AxiosHeaders, AxiosInstance, AxiosResponse } from 'axios';
-import { BotConfigJSON } from './bot-config';
-import { BotCredentialsHandler, GlobalCredentialsHandler } from './credentials-handler';
-import type { BotDetail, Me, OAuth } from './interfaces';
+import { GlobalCredentialsHandler } from './credentials-handler';
+import type { BotDetail, Me, OAuth, ProviderAccountEntry } from './interfaces';
 interface IntegrationResponse {
     detail: string;
     provider_account: {
@@ -26,9 +25,8 @@ interface IntegrationResponse {
     netlify_url: string | null;
 }
 interface BotonicAPIServiceConfig {
-    isLocalRuntimeDeployment?: boolean;
     projectRoot?: string;
-    /** Monorepo/workspace root. When set, global credentials are stored at workspaceRoot/.botonic/credentials.json (source of truth). */
+    /** Monorepo/workspace root. When set, global credentials are stored at workspaceRoot/.botonic/env-credentials.json (source of truth). */
     workspaceRoot?: string;
     environmentVariables?: Record<string, string>;
     targetEnvironment?: string;
@@ -37,18 +35,17 @@ export declare class BotonicAPIService {
     clientId: string;
     baseUrl: string;
     loginUrl: string;
-    botCredentialsHandler: InstanceType<typeof BotCredentialsHandler>;
+    private botsRegistryHandler;
     globalCredentialsHandler: InstanceType<typeof GlobalCredentialsHandler>;
     oauth?: OAuth;
+    private _tokenExpiresAt?;
     me?: Me;
     /** Cached from credentials for display when me is not loaded yet. */
     loggedUserName?: string;
     loggedEnvironmentUrl?: string;
     bot: BotDetail | null;
-    localRuntimeBot: BotDetail | null;
     headers: AxiosHeaders;
     apiClient: AxiosInstance;
-    isLocalRuntimeDeployment?: boolean;
     projectRoot?: string;
     targetEnvironment?: string;
     constructor(config?: BotonicAPIServiceConfig);
@@ -56,20 +53,21 @@ export declare class BotonicAPIService {
     botInfo(): BotDetail;
     getOauth(): OAuth;
     isAuthenticated(): boolean;
-    /** True when in local runtime mode and a bot was loaded (e.g. from app .botonic.json). */
-    hasLocalRuntimeBot(): boolean;
     ensureAuthenticated(): Promise<void>;
-    setCurrentBot(bot: any): void;
-    setLocalRuntimeBot(bot: any): void;
+    setCurrentBot(bot: BotDetail | null): void;
+    selectBot(bot: BotDetail): Promise<void>;
     private loadGlobalCredentials;
     /**
      * Returns store as env -> credentials. Migrates old single-credential format to { local: creds }.
      */
     private normalizeCredentialsStore;
-    private loadBotCredentials;
+    private loadBotFromRegistry;
+    private saveToBotsRegistry;
+    saveProviders(providers: ProviderAccountEntry[]): void;
+    fetchProviders(botId: string): Promise<ProviderAccountEntry[]>;
+    saveBotEntry(bot: BotDetail): void;
     private setHeaders;
     private saveGlobalCredentials;
-    private saveBotCredentials;
     private refreshToken;
     login(email: string, password: string): Promise<void>;
     logout(): Promise<void>;
@@ -83,17 +81,12 @@ export declare class BotonicAPIService {
     getDisplayName(): string;
     createWebchatIntegration(botId: string, integrationName: string): Promise<AxiosResponse<IntegrationResponse>>;
     signup(email: string, password: string, orgName: string, campaign: any): Promise<any>;
-    createBot(botName: string): Promise<AxiosResponse>;
+    createBot(botName: string, isTest?: boolean): Promise<AxiosResponse>;
     getBots(): Promise<AxiosResponse>;
     deleteBot(botId: string): Promise<AxiosResponse>;
     getProviders(botId?: string): Promise<AxiosResponse>;
     deployBot(bundlePath: string, botConfigJson: any): Promise<any>;
     deployStatus(deployId: string): Promise<AxiosResponse>;
-    deployLocalRuntime({ botConfigJson, lambdaFunctionName, lambdaEndpoint, }: {
-        botConfigJson: BotConfigJSON;
-        lambdaFunctionName: string;
-        lambdaEndpoint: string;
-    }): Promise<AxiosResponse<unknown, any, {}>>;
     build({ projectRoot, projectName, }: {
         projectRoot: string;
         projectName: string;
@@ -102,6 +95,12 @@ export declare class BotonicAPIService {
     private apiPost;
     private apiGet;
     private apiDelete;
+    private apiPut;
+    registerDevSessionWhatsapp(botId: string, chatProviderId: string, devSessionUrl: string, lambdaFunctionName: string, botConfig?: object): Promise<AxiosResponse>;
+    registerDevSessionWebchat(botId: string, chatProviderId: string, devSessionUrl: string, lambdaFunctionName: string, botConfig?: object): Promise<AxiosResponse>;
+    unregisterDevSessionWhatsapp(botId: string, chatProviderId: string): Promise<AxiosResponse>;
+    unregisterDevSessionWebchat(botId: string, chatProviderId: string): Promise<AxiosResponse>;
+    refreshTokenIfNeeded(): Promise<void>;
     private getMe;
     private validateToken;
     private isTokenExpired;