@botonic/nx-plugin 2.30.0 → 2.31.0

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/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/api-service.js

@@ -39,7 +39,6 @@ var import_path = require("path");
 var import_qs = require("qs");
 var import_constants = require("./constants");
 var import_credentials_handler = require("./credentials-handler");
-var import_file_system = require("./util/file-system");
 const FormData = require("form-data");
 const BOTONIC_CLIENT_ID = process.env["VITE_HUBTYPE_CLIENT_ID"] || "";
 const BOTONIC_URL = process.env["VITE_HUBTYPE_API_URL"] || "";
@@ -51,7 +50,6 @@ const resolveEnvironment = (environmentVariables) => {
 };
 class BotonicAPIService {
   constructor(config = {
-    isLocalRuntimeDeployment: false,
     projectRoot: void 0,
     environmentVariables: {},
     targetEnvironment: "local"
@@ -60,7 +58,6 @@ class BotonicAPIService {
     this.baseUrl = BOTONIC_URL;
     this.loginUrl = BOTONIC_URL + "/o/token/";
     this.bot = null;
-    this.localRuntimeBot = null;
     this.headers = new import_axios.AxiosHeaders();
     const { hubtypeClientId, hubtypeApiUrl } = resolveEnvironment(
       config.environmentVariables || {}
@@ -71,25 +68,12 @@ class BotonicAPIService {
     this.globalCredentialsHandler = config.workspaceRoot != null ? new import_credentials_handler.GlobalCredentialsHandler(
       (0, import_path.join)(config.workspaceRoot, import_constants.BOTONIC_HOME_DIRNAME)
     ) : new import_credentials_handler.GlobalCredentialsHandler();
-    this.botCredentialsHandler = new import_credentials_handler.BotCredentialsHandler(config.projectRoot);
-    this.isLocalRuntimeDeployment = config.isLocalRuntimeDeployment;
+    this.botsRegistryHandler = new import_credentials_handler.BotsRegistryHandler();
     this.projectRoot = config.projectRoot;
     this.targetEnvironment = config.targetEnvironment;
     this.loadGlobalCredentials();
-    this.loadBotCredentials();
+    this.loadBotFromRegistry();
     this.setHeaders(this.oauth?.access_token);
-    if (this.isLocalRuntimeDeployment && this.projectRoot) {
-      try {
-        const appBotPath = (0, import_path.join)(this.projectRoot, import_constants.BOT_CREDENTIALS_FILENAME);
-        if ((0, import_fs.existsSync)(appBotPath)) {
-          const appCreds = (0, import_file_system.readJSON)(appBotPath);
-          if (appCreds?.bot) {
-            this.localRuntimeBot = appCreds.bot;
-          }
-        }
-      } catch {
-      }
-    }
     this.apiClient = import_axios.default.create({
       baseURL: this.baseUrl
       // Remove headers from here - we'll pass them explicitly in each request
@@ -128,22 +112,13 @@ class BotonicAPIService {
   }
   saveAllCredentials() {
     this.saveGlobalCredentials();
-    if (!this.isLocalRuntimeDeployment) {
-      this.saveBotCredentials();
-    }
+    this.saveToBotsRegistry();
   }
   botInfo() {
-    if (this.isLocalRuntimeDeployment) {
-      if (!this.localRuntimeBot) {
-        throw new Error("Not local runtime bot info available");
-      }
-      return this.localRuntimeBot;
-    } else {
-      if (!this.bot) {
-        throw new Error("Not bot info available");
-      }
-      return this.bot;
+    if (!this.bot) {
+      throw new Error("No bot selected");
     }
+    return this.bot;
   }
   getOauth() {
     if (!this.oauth) {
@@ -154,10 +129,6 @@ class BotonicAPIService {
   isAuthenticated() {
     return !!this.oauth?.access_token;
   }
-  /** True when in local runtime mode and a bot was loaded (e.g. from app .botonic.json). */
-  hasLocalRuntimeBot() {
-    return Boolean(this.isLocalRuntimeDeployment && this.localRuntimeBot);
-  }
   async ensureAuthenticated() {
     if (!this.isAuthenticated()) {
       throw new Error("Not authenticated. Please login first.");
@@ -173,9 +144,16 @@ class BotonicAPIService {
   }
   setCurrentBot(bot) {
     this.bot = bot;
+    this.saveToBotsRegistry();
   }
-  setLocalRuntimeBot(bot) {
-    this.localRuntimeBot = bot;
+  async selectBot(bot) {
+    this.bot = bot;
+    try {
+      const providers = await this.fetchProviders(bot.id);
+      this.bot = { ...bot, providers };
+    } catch {
+    }
+    this.saveToBotsRegistry();
   }
   loadGlobalCredentials() {
     const store = this.normalizeCredentialsStore(
@@ -202,10 +180,53 @@ class BotonicAPIService {
     }
     return store;
   }
-  loadBotCredentials() {
-    const credentials = this.botCredentialsHandler.load();
-    if (credentials?.bot) {
-      this.bot = credentials.bot;
+  loadBotFromRegistry() {
+    try {
+      const entry = this.botsRegistryHandler.findLatestForEnv(
+        this.targetEnvironment ?? "local"
+      );
+      if (!entry) return;
+      this.bot = entry;
+    } catch {
+    }
+  }
+  saveToBotsRegistry() {
+    try {
+      if (!this.bot) return;
+      this.botsRegistryHandler.upsert(
+        this.targetEnvironment ?? "local",
+        this.bot
+      );
+    } catch (e) {
+      console.warn("bots.json could not be saved:", e);
+    }
+  }
+  saveProviders(providers) {
+    try {
+      if (!this.bot) return;
+      this.bot = { ...this.bot, providers };
+      this.botsRegistryHandler.upsert(
+        this.targetEnvironment ?? "local",
+        this.bot
+      );
+    } catch (e) {
+      console.warn("bots.json providers could not be saved:", e);
+    }
+  }
+  async fetchProviders(botId) {
+    const resp = await this.getProviders(botId);
+    return (resp.data.results ?? []).map((p) => ({
+      id: p.id,
+      provider: p.provider ?? "",
+      is_test: p.is_test ?? false,
+      is_active: p.is_active ?? false
+    }));
+  }
+  saveBotEntry(bot) {
+    try {
+      this.botsRegistryHandler.upsert(this.targetEnvironment ?? "local", bot);
+    } catch (e) {
+      console.warn("bots.json could not be saved:", e);
     }
   }
   setHeaders(accessToken) {
@@ -227,11 +248,6 @@ class BotonicAPIService {
     };
     this.globalCredentialsHandler.dump(store);
   }
-  saveBotCredentials() {
-    this.botCredentialsHandler.dump({
-      bot: this.bot
-    });
-  }
   async refreshToken() {
     if (!this.oauth?.refresh_token) {
       throw new Error("No refresh token available");
@@ -257,6 +273,7 @@ class BotonicAPIService {
         throw new Error("Invalid token refresh response: missing access_token");
       }
       this.oauth = oauthResponse.data;
+      this._tokenExpiresAt = Date.now() + oauthResponse.data.expires_in * 1e3;
       const accessToken = this.getOauth().access_token;
       this.setHeaders(accessToken);
       this.saveGlobalCredentials();
@@ -279,6 +296,7 @@ class BotonicAPIService {
       }
     });
     this.oauth = loginResponse.data;
+    this._tokenExpiresAt = Date.now() + loginResponse.data.expires_in * 1e3;
     const accessToken = this.getOauth().access_token;
     this.setHeaders(accessToken);
     try {
@@ -296,11 +314,11 @@ class BotonicAPIService {
       console.log("Already logged out...\n");
     }
     this.oauth = void 0;
+    this._tokenExpiresAt = void 0;
     this.me = void 0;
     this.loggedUserName = void 0;
     this.loggedEnvironmentUrl = void 0;
     this.bot = null;
-    this.localRuntimeBot = null;
     this.headers.delete("Authorization");
   }
   /**
@@ -334,17 +352,13 @@ class BotonicAPIService {
     const signupData = { email, password, org_name: orgName, campaign };
     return this.apiPost({ path: "sign-up/", body: signupData });
   }
-  async createBot(botName) {
+  async createBot(botName, isTest = false) {
     const resp = await this.apiPost({
       apiVersion: "v2",
       path: "bots/",
-      body: { name: botName }
+      body: { name: botName, is_test: isTest }
     });
-    if (this.isLocalRuntimeDeployment) {
-      this.setLocalRuntimeBot(resp.data);
-    } else {
-      this.setCurrentBot(resp.data);
-    }
+    this.setCurrentBot(resp.data);
     return resp;
   }
   async getBots() {
@@ -396,31 +410,6 @@ class BotonicAPIService {
       params: { deploy_id: deployId }
     });
   }
-  async deployLocalRuntime({
-    botConfigJson,
-    lambdaFunctionName,
-    lambdaEndpoint
-  }) {
-    try {
-      await this.getMe();
-    } catch (e) {
-      console.log(`Error authenticating: ${String(e)}`);
-    }
-    const form = new FormData();
-    form.append("bot_config", JSON.stringify(botConfigJson));
-    form.append("lambda_function_name", lambdaFunctionName);
-    form.append("lambda_endpoint", lambdaEndpoint);
-    const headers = await this.getHeaders(form);
-    return await this.apiPost({
-      apiVersion: "v2",
-      path: `bots/${this.botInfo().id}/deploy_local_runtime/`,
-      body: form,
-      headers: {
-        ...this.headers,
-        ...headers
-      }
-    });
-  }
   async build({
     projectRoot,
     projectName
@@ -474,7 +463,7 @@ class BotonicAPIService {
   async prepareLambda(projectRoot) {
     try {
       (0, import_child_process.execSync)(
-        `mkdir -p ${projectRoot}/dist/lambda && cp -r ${projectRoot}/src/server/lambda/* ${projectRoot}/dist/lambda/ && cd ${projectRoot}/dist/lambda && npm install`
+        `mkdir -p ${projectRoot}/dist/lambda && rsync -a --exclude=node_modules/ ${projectRoot}/src/server/lambda/ ${projectRoot}/dist/lambda/`
       );
       return true;
     } catch (error) {
@@ -532,6 +521,7 @@ class BotonicAPIService {
   async apiDelete({
     apiVersion = "v1",
     path,
+    body,
     headers,
     params
   }) {
@@ -547,9 +537,84 @@ class BotonicAPIService {
     }
     return this.apiClient.delete(`${this.baseUrl}/${apiVersion}/${path}`, {
       headers: headers || this.headers,
-      params
+      params,
+      ...body !== void 0 && { data: body }
     });
   }
+  async apiPut({
+    apiVersion = "v1",
+    path,
+    body,
+    headers,
+    params
+  }) {
+    if (this.oauth?.access_token && this.isTokenExpired()) {
+      try {
+        await this.refreshToken();
+      } catch (error) {
+        console.warn(
+          "Proactive token refresh failed, proceeding with request:",
+          error
+        );
+      }
+    }
+    return this.apiClient.put(
+      `${this.baseUrl}/${apiVersion}/${path}`,
+      body,
+      {
+        headers: headers || this.headers,
+        params
+      }
+    );
+  }
+  async registerDevSessionWhatsapp(botId, chatProviderId, devSessionUrl, lambdaFunctionName, botConfig) {
+    return this.apiPost({
+      apiVersion: "v2",
+      path: `bots/${botId}/dev_session/`,
+      body: {
+        channel: "whatsapp",
+        chat_provider_id: chatProviderId,
+        lambda_endpoint: devSessionUrl,
+        lambda_function_name: lambdaFunctionName,
+        ...botConfig && { bot_config: botConfig }
+      }
+    });
+  }
+  async registerDevSessionWebchat(botId, chatProviderId, devSessionUrl, lambdaFunctionName, botConfig) {
+    return this.apiPost({
+      apiVersion: "v2",
+      path: `bots/${botId}/dev_session/`,
+      body: {
+        channel: "webchat",
+        chat_provider_id: chatProviderId,
+        lambda_endpoint: devSessionUrl,
+        lambda_function_name: lambdaFunctionName,
+        ...botConfig && { bot_config: botConfig }
+      }
+    });
+  }
+  async unregisterDevSessionWhatsapp(botId, chatProviderId) {
+    return this.apiDelete({
+      apiVersion: "v2",
+      path: `bots/${botId}/dev_session/`,
+      body: { channel: "whatsapp", chat_provider_id: chatProviderId }
+    });
+  }
+  async unregisterDevSessionWebchat(botId, chatProviderId) {
+    return this.apiDelete({
+      apiVersion: "v2",
+      path: `bots/${botId}/dev_session/`,
+      body: { channel: "webchat", chat_provider_id: chatProviderId }
+    });
+  }
+  async refreshTokenIfNeeded() {
+    if (this.oauth?.access_token) {
+      try {
+        await this.refreshToken();
+      } catch {
+      }
+    }
+  }
   async getMe() {
     return this.apiClient.get("/v3/users/me/");
   }
@@ -568,7 +633,10 @@ class BotonicAPIService {
     if (!this.oauth?.access_token) {
       return true;
     }
-    return false;
+    if (!this._tokenExpiresAt) {
+      return false;
+    }
+    return Date.now() >= this._tokenExpiresAt - 6e4;
   }
   async getHeaders(form) {
     return new Promise((resolve, reject) => {

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";

package/src/lib/constants.js

@@ -23,10 +23,9 @@ __export(constants_exports, {
   BOTONIC_HOME_DIRNAME: () => BOTONIC_HOME_DIRNAME,
   BOTONIC_NPM_NAMESPACE: () => BOTONIC_NPM_NAMESPACE,
   BOTONIC_PROJECT_PATH: () => BOTONIC_PROJECT_PATH,
-  BOT_CREDENTIALS_FILENAME: () => BOT_CREDENTIALS_FILENAME,
+  BOTS_REGISTRY_FILENAME: () => BOTS_REGISTRY_FILENAME,
   CLOUD_PROVIDERS: () => CLOUD_PROVIDERS,
-  GLOBAL_CREDS_FILENAME: () => GLOBAL_CREDS_FILENAME,
-  LOCAL_RUNTIME_BOT_CREDENTIALS_FILENAME: () => LOCAL_RUNTIME_BOT_CREDENTIALS_FILENAME,
+  ENV_CREDENTIALS_FILENAME: () => ENV_CREDENTIALS_FILENAME,
   PATH_TO_AWS_CONFIG: () => PATH_TO_AWS_CONFIG
 });
 module.exports = __toCommonJS(constants_exports);
@@ -34,10 +33,9 @@ var import_path = require("path");
 var import_process = require("process");
 const BOTONIC_NPM_NAMESPACE = "@botonic";
 const BOTONIC_HOME_DIRNAME = ".botonic";
-const GLOBAL_CREDS_FILENAME = "credentials.json";
+const ENV_CREDENTIALS_FILENAME = "env-credentials.json";
+const BOTS_REGISTRY_FILENAME = "bots.json";
 const BOTONIC_PROJECT_PATH = process.cwd();
-const BOT_CREDENTIALS_FILENAME = ".botonic.json";
-const LOCAL_RUNTIME_BOT_CREDENTIALS_FILENAME = ".local-runtime-botonic.json";
 const ANALYTICS_WRITE_KEY = "YD0jpJHNGW12uhLNbgB4wbdTRQ4Cy1Zu";
 const CLOUD_PROVIDERS = Object.freeze({
   AWS: "aws",
@@ -52,9 +50,8 @@ const PATH_TO_AWS_CONFIG = (0, import_path.join)((0, import_process.cwd)(), AWS_
   BOTONIC_HOME_DIRNAME,
   BOTONIC_NPM_NAMESPACE,
   BOTONIC_PROJECT_PATH,
-  BOT_CREDENTIALS_FILENAME,
+  BOTS_REGISTRY_FILENAME,
   CLOUD_PROVIDERS,
-  GLOBAL_CREDS_FILENAME,
-  LOCAL_RUNTIME_BOT_CREDENTIALS_FILENAME,
+  ENV_CREDENTIALS_FILENAME,
   PATH_TO_AWS_CONFIG
 });

package/src/lib/credentials-handler.d.ts

@@ -1,4 +1,4 @@
-import type { BotCredentials, GlobalCredentialsStore, JSONObject } from './interfaces';
+import type { BotRegistryEntry, BotsRegistry, GlobalCredentialsStore, JSONObject } from './interfaces';
 export declare class CredentialsHandler {
     homeDir: string;
     pathToCredentials: string;
@@ -9,12 +9,12 @@ export declare class CredentialsHandler {
     initialize(): void;
     createDirIfNotExists(): void;
     loadJSON(): JSONObject | undefined;
-    dumpJSON(obj: JSONObject): void;
+    dumpJSON(obj: JSONObject | JSONObject[]): void;
 }
 export declare class GlobalCredentialsHandler extends CredentialsHandler {
     /**
      * @param baseDir - Optional directory for credentials (e.g. monorepo_root/.botonic).
-     * When provided, credentials are stored at baseDir/credentials.json (source of truth in monorepo).
+     * When provided, credentials are stored at baseDir/env-credentials.json.
      * When omitted, uses ~/.botonic (user home).
      */
     constructor(baseDir?: string);
@@ -22,19 +22,10 @@ export declare class GlobalCredentialsHandler extends CredentialsHandler {
     load(): GlobalCredentialsStore | undefined;
     dump(obj: GlobalCredentialsStore): void;
 }
-declare class BaseBotCredentialsHandler<T> extends CredentialsHandler {
-    constructor(args: {
-        homeDir: string;
-        filename: string;
-    });
-    load(): T | undefined;
-    dump(obj: T): void;
-}
-export declare class BotCredentialsHandler extends BaseBotCredentialsHandler<BotCredentials> {
-    /**
-     * @param projectRoot - Directory for app/project .botonic.json (e.g. apps/my-bot).
-     * When omitted, uses process.cwd() (may write to repo root when Nx cwd is workspace root).
-     */
-    constructor(projectRoot?: string);
+export declare class BotsRegistryHandler extends CredentialsHandler {
+    constructor();
+    load(): BotsRegistry;
+    dump(registry: BotsRegistry): void;
+    upsert(env: string, entry: BotRegistryEntry): void;
+    findLatestForEnv(env: string): BotRegistryEntry | undefined;
 }
-export {};