@botonic/nx-plugin 2.30.0 → 2.31.1-alpha.0

package/{src → libs/botonic/nx-plugin/src}/plugin.js

@@ -140,34 +140,29 @@ async function createBotonicTargets(projectRoot, options, context) {
   targets[options.serveTargetName] = {
     executor: "@botonic/nx-plugin:serve-bot",
     options: {},
-    configurations,
-    continuous: true
+    configurations
   };
   targets["serve:webchat"] = {
     executor: "@botonic/nx-plugin:serve-bot",
     options: {
       skipWebviews: true
     },
-    configurations,
-    continuous: true
+    configurations
   };
   targets["serve:webview"] = {
     executor: "@botonic/nx-plugin:serve-bot",
     options: {},
-    configurations,
-    continuous: true
+    configurations
   };
   targets["serve-dev"] = {
     executor: "@botonic/nx-plugin:serve-bot",
     options: {},
-    configurations,
-    continuous: true
+    configurations
   };
   targets["serve-dev-tunnel"] = {
     executor: "@botonic/nx-plugin:serve-bot",
     options: {},
-    configurations,
-    continuous: true
+    configurations
   };
   targets["build-node-app"] = {
     executor: "nx:run-commands",
@@ -213,10 +208,6 @@ async function createBotonicTargets(projectRoot, options, context) {
     executor: "@botonic/nx-plugin:deploy-to-hubtype",
     configurations
   };
-  targets["deploy-local-runtime"] = {
-    executor: "@botonic/nx-plugin:deploy-local-runtime",
-    configurations
-  };
   targets["integrate-provider"] = {
     executor: "@botonic/nx-plugin:integrate-provider",
     configurations

package/migrations.json

@@ -1,10 +1,3 @@
 {
-  "generators": {
-    "install-claude-update-skills": {
-      "version": "2.29.0",
-      "description": "Replace .cursor/.claude command stubs with .claude/skills/botonic-update and .claude/skills/botonic-bot-update",
-      "cli": "nx",
-      "implementation": "./src/migrations/install-claude-update-skills/install-claude-update-skills.migration"
-    }
-  }
+  "generators": {}
 }

package/package.json

@@ -1,18 +1,21 @@
 {
   "name": "@botonic/nx-plugin",
-  "version": "2.30.0",
+  "version": "2.31.1-alpha.0",
   "description": "Nx plugin for creating Botonic bot applications",
-  "main": "./src/index.js",
+  "main": "./dist/index.js",
   "types": "./src/index.d.ts",
   "exports": {
     ".": {
       "types": "./src/index.d.ts",
-      "require": "./src/index.js"
+      "require": "./dist/index.js",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     },
     "./generators.json": "./generators.json",
     "./executors.json": "./executors.json",
     "./migrations.json": "./migrations.json",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./serve-mode/serve-mode.js": "./serve-mode/serve-mode.js"
   },
   "generators": "./generators.json",
   "executors": "./executors.json",

package/src/executors/build-node-app/executor-impl.d.ts

@@ -0,0 +1,5 @@
+import type { ExecutorContext } from '@nx/devkit';
+import type { BuildNodeAppExecutorSchema } from './schema';
+export default function buildNodeAppExecutor(options: BuildNodeAppExecutorSchema, context: ExecutorContext): Promise<{
+    success: boolean;
+}>;

package/src/executors/build-node-app/executor.d.ts

@@ -1,5 +1,7 @@
 import type { ExecutorContext } from '@nx/devkit';
 import type { BuildNodeAppExecutorSchema } from './schema';
-export default function buildNodeAppExecutor(options: BuildNodeAppExecutorSchema, context: ExecutorContext): Promise<{
+export default function buildNodeAppExecutor(options: BuildNodeAppExecutorSchema, ctx: ExecutorContext): Promise<{
     success: boolean;
-}>;
+} | AsyncIterableIterator<{
+    success: boolean;
+}>>;

package/src/executors/delete-bot/executor-impl.d.ts

@@ -0,0 +1,5 @@
+import type { ExecutorContext } from '@nx/devkit';
+import type { DeleteBotExecutorSchema } from './schema';
+export default function deleteBotExecutor(options: DeleteBotExecutorSchema, context: ExecutorContext): Promise<{
+    success: boolean;
+}>;

package/src/executors/delete-bot/executor.d.ts

@@ -1,5 +1,7 @@
 import type { ExecutorContext } from '@nx/devkit';
 import type { DeleteBotExecutorSchema } from './schema';
-export default function deleteBotExecutor(options: DeleteBotExecutorSchema, context: ExecutorContext): Promise<{
+export default function deleteBotExecutor(options: DeleteBotExecutorSchema, ctx: ExecutorContext): Promise<{
     success: boolean;
-}>;
+} | AsyncIterableIterator<{
+    success: boolean;
+}>>;

package/src/executors/deploy-netlify-snapshot/executor-impl.d.ts

@@ -0,0 +1,8 @@
+import type { ExecutorContext } from '@nx/devkit';
+import type { DeployNetlifySnapshotExecutorSchema } from './schema';
+export interface DeployNetlifySnapshotResult {
+    success: boolean;
+    deployUrl?: string;
+    claimUrl?: string;
+}
+export default function deployNetlifySnapshotExecutor(options: DeployNetlifySnapshotExecutorSchema, context: ExecutorContext): Promise<DeployNetlifySnapshotResult>;

package/src/executors/deploy-netlify-snapshot/executor.d.ts

@@ -1,8 +1,7 @@
 import type { ExecutorContext } from '@nx/devkit';
 import type { DeployNetlifySnapshotExecutorSchema } from './schema';
-export interface DeployNetlifySnapshotResult {
+export default function deployNetlifySnapshotExecutor(options: DeployNetlifySnapshotExecutorSchema, ctx: ExecutorContext): Promise<{
     success: boolean;
-    deployUrl?: string;
-    claimUrl?: string;
-}
-export default function deployNetlifySnapshotExecutor(options: DeployNetlifySnapshotExecutorSchema, context: ExecutorContext): Promise<DeployNetlifySnapshotResult>;
+} | AsyncIterableIterator<{
+    success: boolean;
+}>>;

package/src/executors/deploy-to-hubtype/executor-impl.d.ts

@@ -0,0 +1,5 @@
+import type { ExecutorContext } from '@nx/devkit';
+import type { DeployToHubtypeExecutorSchema } from './schema';
+export default function deployToHubtypeExecutor(options: DeployToHubtypeExecutorSchema, context: ExecutorContext): Promise<{
+    success: boolean;
+}>;

package/src/executors/deploy-to-hubtype/executor.d.ts

@@ -1,5 +1,7 @@
 import type { ExecutorContext } from '@nx/devkit';
 import type { DeployToHubtypeExecutorSchema } from './schema';
-export default function deployToHubtypeExecutor(options: DeployToHubtypeExecutorSchema, context: ExecutorContext): Promise<{
+export default function deployToHubtypeExecutor(options: DeployToHubtypeExecutorSchema, ctx: ExecutorContext): Promise<{
     success: boolean;
-}>;
+} | AsyncIterableIterator<{
+    success: boolean;
+}>>;

package/src/executors/e2e-webchat/botonic-package-publish.spec.ts

@@ -14,13 +14,13 @@ test.describe('Botonic Publish E2E', () => {
 
     await page.goto('/')
     await page.waitForLoadState('networkidle')
-    await page.waitForSelector('button[class*="webchat-trigger"]', {
+    await page.waitForSelector('[data-testid="webchat-trigger"]', {
       timeout: 3000,
     })
   })
 
   async function ensureWebchatOpen(page: any) {
-    const trigger = page.locator('button[class*="webchat-trigger"]').first()
+    const trigger = page.getByTestId('webchat-trigger')
     await expect(trigger).toBeVisible({ timeout: 10000 })
 
     const ariaExpanded = await trigger.getAttribute('aria-expanded')
@@ -29,16 +29,14 @@ test.describe('Botonic Publish E2E', () => {
       await page.waitForTimeout(300)
     }
 
-    const container = page
-      .locator('[class*="webchat-container-module"]')
-      .first()
+    const container = page.getByTestId('webchat-container')
     await expect(container).toBeVisible({ timeout: 5000 })
 
     return { trigger, container }
   }
 
   test('webchat trigger renders and opens webchat', async ({ page }) => {
-    const trigger = page.locator('button[class*="webchat-trigger"]').first()
+    const trigger = page.getByTestId('webchat-trigger')
     await expect(trigger).toBeVisible({ timeout: 10000 })
 
     const ariaExpanded = await trigger.getAttribute('aria-expanded')
@@ -47,9 +45,7 @@ test.describe('Botonic Publish E2E', () => {
       await page.waitForTimeout(300)
     }
 
-    const container = page
-      .locator('[class*="webchat-container-module"]')
-      .first()
+    const container = page.getByTestId('webchat-container')
     await expect(container).toBeVisible({ timeout: 5000 })
   })
 
@@ -62,7 +58,7 @@ test.describe('Botonic Publish E2E', () => {
     await input.fill('hello')
     await input.press('Enter')
 
-    const messages = page.locator('[class*="message-module"]')
+    const messages = page.locator('[data-testid^="webchat-message-"]')
     await expect(messages.first()).toBeVisible({ timeout: 15000 })
   })
 
@@ -78,7 +74,7 @@ test.describe('Botonic Publish E2E', () => {
     await expect(sendButton).toBeVisible()
     await sendButton.click()
 
-    const messages = page.locator('[class*="message-module"]')
+    const messages = page.locator('[data-testid^="webchat-message-"]')
     await expect(messages.first()).toBeVisible({ timeout: 15000 })
   })
 })

package/src/executors/e2e-webchat/executor-impl.d.ts

@@ -0,0 +1,5 @@
+import type { ExecutorContext } from '@nx/devkit';
+import type { E2EExecutorSchema } from './schema';
+export default function e2eExecutor(options: E2EExecutorSchema, context: ExecutorContext): Promise<{
+    success: boolean;
+}>;

package/src/executors/e2e-webchat/executor.d.ts

@@ -1,5 +1,7 @@
 import type { ExecutorContext } from '@nx/devkit';
 import type { E2EExecutorSchema } from './schema';
-export default function e2eExecutor(options: E2EExecutorSchema, context: ExecutorContext): Promise<{
+export default function e2eWebchatExecutor(options: E2EExecutorSchema, ctx: ExecutorContext): Promise<{
     success: boolean;
-}>;
+} | AsyncIterableIterator<{
+    success: boolean;
+}>>;

package/src/executors/integrate-provider/executor-impl.d.ts

@@ -0,0 +1,5 @@
+import type { ExecutorContext } from '@nx/devkit';
+import type { IntegrateProviderExecutorSchema } from './schema';
+export default function integrateProviderExecutor(options: IntegrateProviderExecutorSchema, context: ExecutorContext): Promise<{
+    success: boolean;
+}>;

package/src/executors/integrate-provider/executor.d.ts

@@ -1,5 +1,7 @@
 import type { ExecutorContext } from '@nx/devkit';
 import type { IntegrateProviderExecutorSchema } from './schema';
-export default function integrateProviderExecutor(options: IntegrateProviderExecutorSchema, context: ExecutorContext): Promise<{
+export default function integrateProviderExecutor(options: IntegrateProviderExecutorSchema, ctx: ExecutorContext): Promise<{
     success: boolean;
-}>;
+} | AsyncIterableIterator<{
+    success: boolean;
+}>>;

package/src/executors/login-to-hubtype/executor-impl.d.ts

@@ -0,0 +1,5 @@
+import type { ExecutorContext } from '@nx/devkit';
+import type { LoginToHubtypeExecutorSchema } from './schema';
+export default function loginToHubtypeExecutor(options: LoginToHubtypeExecutorSchema, context: ExecutorContext): Promise<{
+    success: boolean;
+}>;

package/src/executors/login-to-hubtype/executor.d.ts

@@ -1,5 +1,7 @@
 import type { ExecutorContext } from '@nx/devkit';
 import type { LoginToHubtypeExecutorSchema } from './schema';
-export default function loginToHubtypeExecutor(options: LoginToHubtypeExecutorSchema, context: ExecutorContext): Promise<{
+export default function loginToHubtypeExecutor(options: LoginToHubtypeExecutorSchema, ctx: ExecutorContext): Promise<{
     success: boolean;
-}>;
+} | AsyncIterableIterator<{
+    success: boolean;
+}>>;

package/src/executors/logout-from-hubtype/executor-impl.d.ts

@@ -0,0 +1,3 @@
+import type { ExecutorContext } from '@nx/devkit';
+import type { LogoutFromHubtypeExecutorSchema } from './schema';
+export default function logoutFromHubtypeExecutor(options: LogoutFromHubtypeExecutorSchema, context: ExecutorContext): Promise<void>;

package/src/executors/logout-from-hubtype/executor.d.ts

@@ -1,3 +1,7 @@
 import type { ExecutorContext } from '@nx/devkit';
 import type { LogoutFromHubtypeExecutorSchema } from './schema';
-export default function logoutFromHubtypeExecutor(options: LogoutFromHubtypeExecutorSchema, context: ExecutorContext): Promise<void>;
+export default function logoutFromHubtypeExecutor(options: LogoutFromHubtypeExecutorSchema, ctx: ExecutorContext): Promise<{
+    success: boolean;
+} | AsyncIterableIterator<{
+    success: boolean;
+}>>;

package/src/executors/run-lambda/executor-impl.d.ts

@@ -0,0 +1,5 @@
+import type { ExecutorContext } from '@nx/devkit';
+import type { RunLambdaExecutorSchema } from './schema';
+export default function runLambdaExecutor(options: RunLambdaExecutorSchema, context: ExecutorContext): Promise<{
+    success: boolean;
+}>;

package/src/executors/run-lambda/executor.d.ts

@@ -1,5 +1,7 @@
 import type { ExecutorContext } from '@nx/devkit';
 import type { RunLambdaExecutorSchema } from './schema';
-export default function runLambdaExecutor(options: RunLambdaExecutorSchema, context: ExecutorContext): Promise<{
+export default function runLambdaExecutor(options: RunLambdaExecutorSchema, ctx: ExecutorContext): Promise<{
     success: boolean;
-}>;
+} | AsyncIterableIterator<{
+    success: boolean;
+}>>;

package/src/executors/serve-bot/executor-impl.d.ts

@@ -0,0 +1,5 @@
+import type { ExecutorContext } from '@nx/devkit';
+import type { ServeBotExecutorSchema } from './schema';
+export default function serveBotExecutor(options: ServeBotExecutorSchema, context: ExecutorContext): Promise<{
+    success: boolean;
+}>;

package/src/executors/serve-bot/executor.d.ts

@@ -1,5 +1,7 @@
 import type { ExecutorContext } from '@nx/devkit';
 import type { ServeBotExecutorSchema } from './schema';
-export default function serveBotExecutor(options: ServeBotExecutorSchema, context: ExecutorContext): Promise<{
+export default function serveBotExecutor(options: ServeBotExecutorSchema, ctx: ExecutorContext): Promise<{
     success: boolean;
-}>;
+} | AsyncIterableIterator<{
+    success: boolean;
+}>>;

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/action/generator-impl.d.ts

@@ -0,0 +1,4 @@
+import { Tree } from '@nx/devkit';
+import type { ActionGeneratorSchema } from './schema';
+export default function (tree: Tree, options: ActionGeneratorSchema): Promise<void>;
+export { ActionGeneratorSchema };

package/src/generators/action/generator.d.ts

@@ -1,4 +1,3 @@
-import { Tree } from '@nx/devkit';
+import type { Tree } from '@nx/devkit';
 import type { ActionGeneratorSchema } from './schema';
-export default function (tree: Tree, options: ActionGeneratorSchema): Promise<void>;
-export { ActionGeneratorSchema };
+export default function (tree: Tree, options: ActionGeneratorSchema): Promise<void | import("@nx/devkit").GeneratorCallback>;

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

@@ -1,7 +1,6 @@
 import { resolve } from 'path'
 import type { UserConfig } from 'vite'
 
-import { getBotonicThirdPartyDeps } from './botonic-ssr-deps'
 import { BUILD_CONFIG } from './build.config'
 
 const projectRoot = resolve(__dirname, '..')
@@ -13,13 +12,9 @@ export function getNodeConfig(): UserConfig {
     root: projectRoot,
     cacheDir: resolve(projectRoot, BUILD_CONFIG.CACHE_DIR.node),
 
-    // Bundle all @botonic/* packages and their third-party deps into the Lambda
-    // artifact. By default Vite SSR externalizes node_modules, but Lambda has no
-    // node_modules at runtime so everything must be self-contained.
-    // Third-party deps are derived programmatically from the @botonic/* package.json
-    // files so this list stays correct as plugins add new dependencies.
+    // Bundle all dependencies into the Lambda artifact — no node_modules at runtime.
     ssr: {
-      noExternal: [/@botonic\/.*/, ...getBotonicThirdPartyDeps(projectRoot)],
+      noExternal: true,
     },
 
     build: {

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

@@ -1,8 +1,12 @@
 import { resolve } from 'path'
 import type { UserConfig } from 'vite'
+import {
+  createLogViewerPlugin,
+  createWebchatPanelPlugin,
+  createWhatsappPanelPlugin,
+} from '@botonic/nx-plugin'
 
 import { BUILD_CONFIG } from './build.config'
-import { devLogViewerIndexHtmlPlugin } from './plugins/dev-log-viewer-html.plugin'
 import { moveHtmlToRootPlugin } from './plugins/move-html.plugin'
 
 const projectRoot = resolve(__dirname, '..')
@@ -83,7 +87,11 @@ export function getWebchatConfig(command: 'serve' | 'build'): UserConfig {
     },
 
     plugins: [
-      devLogViewerIndexHtmlPlugin(),
+      createLogViewerPlugin(),
+      createWhatsappPanelPlugin({
+        registeredPhone: process.env.WHATSAPP_PANEL_PHONE,
+      }),
+      createWebchatPanelPlugin(),
       moveHtmlToRootPlugin(projectRoot, BUILD_CONFIG.TARGET_APPS.WEBCHAT),
     ],
   }

package/src/generators/bot-app/generator-impl.d.ts

@@ -0,0 +1,4 @@
+import { GeneratorCallback, Tree } from '@nx/devkit';
+import type { BotAppGeneratorSchema } from './schema';
+export default function (tree: Tree, options: BotAppGeneratorSchema): Promise<GeneratorCallback>;
+export { BotAppGeneratorSchema };

package/src/generators/bot-app/generator.d.ts

@@ -1,4 +1,2 @@
-import { GeneratorCallback, Tree } from '@nx/devkit';
-import type { BotAppGeneratorSchema } from './schema';
-export default function (tree: Tree, options: BotAppGeneratorSchema): Promise<GeneratorCallback>;
-export { BotAppGeneratorSchema };
+export { default } from './generator-impl';
+export type { BotAppGeneratorSchema } from './schema';

package/src/generators/custom-message/generator-impl.d.ts

@@ -0,0 +1,4 @@
+import { Tree } from '@nx/devkit';
+import type { CustomMessageGeneratorSchema } from './schema';
+export default function (tree: Tree, options: CustomMessageGeneratorSchema): Promise<void>;
+export { CustomMessageGeneratorSchema };

package/src/generators/custom-message/generator.d.ts

@@ -1,4 +1,3 @@
-import { Tree } from '@nx/devkit';
+import type { Tree } from '@nx/devkit';
 import type { CustomMessageGeneratorSchema } from './schema';
-export default function (tree: Tree, options: CustomMessageGeneratorSchema): Promise<void>;
-export { CustomMessageGeneratorSchema };
+export default function (tree: Tree, options: CustomMessageGeneratorSchema): Promise<void | import("@nx/devkit").GeneratorCallback>;

package/src/generators/preset/generator-impl.d.ts

@@ -0,0 +1,4 @@
+import { GeneratorCallback, Tree } from '@nx/devkit';
+import type { PresetGeneratorSchema } from './schema';
+export default function (tree: Tree, options: PresetGeneratorSchema): Promise<GeneratorCallback>;
+export { PresetGeneratorSchema };

package/src/generators/preset/generator.d.ts

@@ -1,4 +1,2 @@
-import { GeneratorCallback, Tree } from '@nx/devkit';
-import type { PresetGeneratorSchema } from './schema';
-export default function (tree: Tree, options: PresetGeneratorSchema): Promise<GeneratorCallback>;
-export { PresetGeneratorSchema };
+export { default } from './generator-impl';
+export type { PresetGeneratorSchema } from './schema';

package/src/generators/remove-custom-message/generator-impl.d.ts

@@ -0,0 +1,4 @@
+import { Tree } from '@nx/devkit';
+import type { RemoveCustomMessageGeneratorSchema } from './schema';
+export default function (tree: Tree, options: RemoveCustomMessageGeneratorSchema): Promise<void>;
+export { RemoveCustomMessageGeneratorSchema };

package/src/generators/remove-custom-message/generator.d.ts

@@ -1,4 +1,3 @@
-import { Tree } from '@nx/devkit';
+import type { Tree } from '@nx/devkit';
 import type { RemoveCustomMessageGeneratorSchema } from './schema';
-export default function (tree: Tree, options: RemoveCustomMessageGeneratorSchema): Promise<void>;
-export { RemoveCustomMessageGeneratorSchema };
+export default function (tree: Tree, options: RemoveCustomMessageGeneratorSchema): Promise<void | import("@nx/devkit").GeneratorCallback>;

package/src/generators/webview/generator-impl.d.ts

@@ -0,0 +1,4 @@
+import { Tree } from '@nx/devkit';
+import type { WebviewGeneratorSchema } from './schema';
+export default function (tree: Tree, options: WebviewGeneratorSchema): Promise<void>;
+export { WebviewGeneratorSchema };

package/src/generators/webview/generator.d.ts

@@ -1,4 +1,3 @@
-import { Tree } from '@nx/devkit';
+import type { Tree } from '@nx/devkit';
 import type { WebviewGeneratorSchema } from './schema';
-export default function (tree: Tree, options: WebviewGeneratorSchema): Promise<void>;
-export { WebviewGeneratorSchema };
+export default function (tree: Tree, options: WebviewGeneratorSchema): Promise<void | import("@nx/devkit").GeneratorCallback>;

package/src/index.d.ts

@@ -4,4 +4,5 @@ export { default as buildNodeAppExecutor } from './executors/build-node-app/exec
 export { default as runLambdaExecutor } from './executors/run-lambda/executor';
 export { default as serveBotExecutor } from './executors/serve-bot/executor';
 export * from './lib';
+export * from './lib/serve-mode';
 export { BotonicPlugin, createNodesV2 } from './plugin';

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;

package/src/lib/constants.d.ts

@@ -1,9 +1,8 @@
 export declare const BOTONIC_NPM_NAMESPACE = "@botonic";
 export declare const BOTONIC_HOME_DIRNAME = ".botonic";
-export declare const GLOBAL_CREDS_FILENAME = "credentials.json";
+export declare const ENV_CREDENTIALS_FILENAME = "env-credentials.json";
+export declare const BOTS_REGISTRY_FILENAME = "bots.json";
 export declare const BOTONIC_PROJECT_PATH: string;
-export declare const BOT_CREDENTIALS_FILENAME = ".botonic.json";
-export declare const LOCAL_RUNTIME_BOT_CREDENTIALS_FILENAME = ".local-runtime-botonic.json";
 export declare const ANALYTICS_WRITE_KEY = "YD0jpJHNGW12uhLNbgB4wbdTRQ4Cy1Zu";
 export declare const CLOUD_PROVIDERS: Readonly<{
     AWS: "aws";