@botonic/core 0.47.0 → 0.48.1

package/lib/esm/testing/index.d.ts

@@ -0,0 +1,91 @@
+import { type BotContext, type BotRequest, type BotSecrets, type BotSettings, type ContactInfo, type Input, type ProviderType, type ResolvedPlugins, type Session, type SessionUser } from '../models';
+export declare const TEST_DEFAULTS: {
+    HUBTYPE_API_URL: string;
+    STATIC_URL: string;
+    LITELLM_API_URL: string;
+    AZURE_OPENAI_API_BASE: string;
+    AZURE_OPENAI_API_VERSION: string;
+    LANGUAGE_DETECTION_ENABLED: boolean;
+    HUBTYPE_ACCESS_TOKEN: string;
+    LITELLM_API_KEY: string;
+    AZURE_OPENAI_API_KEY: string;
+    ACCESS_TOKEN: string;
+    HUBTYPE_API_HOST: string;
+    FLOW_THREAD_ID: string;
+    BOT_ID: string;
+    USER_ID: string;
+    ORG_ID: string;
+    ORG_NAME: string;
+    PROVIDER: ProviderType;
+    LOCALE: string;
+    COUNTRY: string;
+    BOT_INTERACTION_ID: string;
+    MESSAGE_ID: string;
+    LAST_ROUTE_PATH: string;
+};
+export declare function createTestSettings(overrides?: Partial<BotSettings>): BotSettings;
+export declare function createTestSecrets(overrides?: Partial<BotSecrets>): BotSecrets;
+export interface TestUserOptions {
+    id?: string;
+    provider?: ProviderType;
+    locale?: string;
+    country?: string;
+    systemLocale?: string;
+    contactInfo?: ContactInfo[];
+    extraData?: Record<string, any>;
+}
+export declare function createTestSessionUser(options?: TestUserOptions): SessionUser<Record<string, any>>;
+export interface TestSessionOptions {
+    user?: TestUserOptions;
+    botId?: string;
+    organization?: string;
+    organizationId?: string;
+    isFirstInteraction?: boolean;
+    isTestIntegration?: boolean;
+    accessToken?: string;
+    hubtypeApi?: string;
+    flowThreadId?: string;
+    retries?: number;
+    shadowing?: boolean;
+    hubtypeCaseId?: string;
+    captureUserInputNodeId?: string;
+}
+export declare function createTestSession(options?: TestSessionOptions): Session<Record<string, any>>;
+export interface TestInputOptions {
+    type?: Input['type'];
+    data?: string;
+    text?: string;
+    payload?: string;
+    src?: string;
+    botInteractionId?: string;
+    messageId?: string;
+    context?: Input['context'];
+    transcript?: string;
+}
+export declare function createTestInput(options?: TestInputOptions): Input;
+export interface TestBotRequestOptions {
+    input?: TestInputOptions | Input;
+    session?: TestSessionOptions | Session;
+    lastRoutePath?: string;
+    settings?: Partial<BotSettings> | BotSettings;
+    secrets?: Partial<BotSecrets> | BotSecrets;
+}
+export declare function createTestBotRequest(options?: TestBotRequestOptions): BotRequest;
+export interface TestBotContextOptions<TPlugins extends ResolvedPlugins = ResolvedPlugins> extends TestBotRequestOptions {
+    plugins?: TPlugins;
+    params?: Record<string, string>;
+    defaultDelay?: number;
+    defaultTyping?: number;
+}
+export declare function createTestBotContext<TPlugins extends ResolvedPlugins = ResolvedPlugins>(options?: TestBotContextOptions<TPlugins>): BotContext<TPlugins>;
+/**
+ * Alias for `createTestBotContext` typed as `PluginPreRequest`.
+ * PluginPreRequest === BotContext in @botonic/core.
+ */
+export declare const createTestPluginPreRequest: typeof createTestBotContext;
+export interface TestPluginPostRequestOptions<TPlugins extends ResolvedPlugins = ResolvedPlugins> extends TestBotContextOptions<TPlugins> {
+    response?: string | null;
+}
+export declare function createTestPluginPostRequest<TPlugins extends ResolvedPlugins = ResolvedPlugins>(options?: TestPluginPostRequestOptions<TPlugins>): BotContext<TPlugins> & {
+    response: string | null;
+};

package/lib/esm/testing/index.js

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTestPluginPreRequest = exports.TEST_DEFAULTS = void 0;
+exports.createTestSettings = createTestSettings;
+exports.createTestSecrets = createTestSecrets;
+exports.createTestSessionUser = createTestSessionUser;
+exports.createTestSession = createTestSession;
+exports.createTestInput = createTestInput;
+exports.createTestBotRequest = createTestBotRequest;
+exports.createTestBotContext = createTestBotContext;
+exports.createTestPluginPostRequest = createTestPluginPostRequest;
+const models_1 = require("../models");
+// ---------------------------------------------------------------------------
+// Default values
+// ---------------------------------------------------------------------------
+exports.TEST_DEFAULTS = {
+    HUBTYPE_API_URL: 'https://api.hubtype.com',
+    STATIC_URL: 'https://static.hubtype.com',
+    LITELLM_API_URL: 'https://api.litellm.com',
+    AZURE_OPENAI_API_BASE: 'https://api.openai.com',
+    AZURE_OPENAI_API_VERSION: '2026-02-01',
+    LANGUAGE_DETECTION_ENABLED: true,
+    HUBTYPE_ACCESS_TOKEN: 'testAccessToken', // pragma: allowlist secret
+    LITELLM_API_KEY: 'testLiteLLMAPIKey', // pragma: allowlist secret
+    AZURE_OPENAI_API_KEY: 'testAzureOpenAIAPIKey', // pragma: allowlist secret
+    ACCESS_TOKEN: 'fake_access_token',
+    HUBTYPE_API_HOST: 'https://api.hubtype.com',
+    FLOW_THREAD_ID: 'testFlowThreadId',
+    BOT_ID: 'testBotId',
+    USER_ID: 'testUserId',
+    ORG_ID: 'testOrgId',
+    ORG_NAME: 'testOrg',
+    PROVIDER: models_1.PROVIDER.WEBCHAT,
+    LOCALE: 'en',
+    COUNTRY: 'US',
+    BOT_INTERACTION_ID: 'testInteractionId',
+    MESSAGE_ID: 'testMessageId',
+    LAST_ROUTE_PATH: '',
+};
+// ---------------------------------------------------------------------------
+// Leaf factories
+// ---------------------------------------------------------------------------
+function createTestSettings(overrides) {
+    return {
+        HUBTYPE_API_URL: exports.TEST_DEFAULTS.HUBTYPE_API_URL,
+        STATIC_URL: exports.TEST_DEFAULTS.STATIC_URL,
+        LITELLM_API_URL: exports.TEST_DEFAULTS.LITELLM_API_URL,
+        AZURE_OPENAI_API_BASE: exports.TEST_DEFAULTS.AZURE_OPENAI_API_BASE,
+        AZURE_OPENAI_API_VERSION: exports.TEST_DEFAULTS.AZURE_OPENAI_API_VERSION,
+        LANGUAGE_DETECTION_ENABLED: exports.TEST_DEFAULTS.LANGUAGE_DETECTION_ENABLED,
+        CUSTOM_SHORT_URL_HOST: null,
+        custom: {},
+        ...overrides,
+    };
+}
+function createTestSecrets(overrides) {
+    return {
+        HUBTYPE_ACCESS_TOKEN: exports.TEST_DEFAULTS.HUBTYPE_ACCESS_TOKEN,
+        LITELLM_API_KEY: exports.TEST_DEFAULTS.LITELLM_API_KEY,
+        AZURE_OPENAI_API_KEY: exports.TEST_DEFAULTS.AZURE_OPENAI_API_KEY,
+        custom: {},
+        ...overrides,
+    };
+}
+function createTestSessionUser(options) {
+    const locale = options?.locale ?? exports.TEST_DEFAULTS.LOCALE;
+    const country = options?.country ?? exports.TEST_DEFAULTS.COUNTRY;
+    return {
+        id: options?.id ?? exports.TEST_DEFAULTS.USER_ID,
+        provider: options?.provider ?? exports.TEST_DEFAULTS.PROVIDER,
+        locale,
+        country,
+        system_locale: options?.systemLocale ?? locale,
+        contact_info: options?.contactInfo ?? [],
+        extra_data: options?.extraData ?? {},
+    };
+}
+function createTestSession(options) {
+    return {
+        bot: { id: options?.botId ?? exports.TEST_DEFAULTS.BOT_ID },
+        user: createTestSessionUser(options?.user),
+        organization: options?.organization ?? exports.TEST_DEFAULTS.ORG_NAME,
+        organization_id: options?.organizationId ?? exports.TEST_DEFAULTS.ORG_ID,
+        is_first_interaction: options?.isFirstInteraction ?? false,
+        is_test_integration: options?.isTestIntegration ?? false,
+        _access_token: options?.accessToken ?? exports.TEST_DEFAULTS.ACCESS_TOKEN,
+        _hubtype_api: options?.hubtypeApi ?? exports.TEST_DEFAULTS.HUBTYPE_API_HOST,
+        flow_thread_id: options?.flowThreadId ?? exports.TEST_DEFAULTS.FLOW_THREAD_ID,
+        __retries: options?.retries ?? 0,
+        _shadowing: options?.shadowing,
+        _hubtype_case_id: options?.hubtypeCaseId,
+        capture_user_input: options?.captureUserInputNodeId
+            ? { node_id: options.captureUserInputNodeId }
+            : undefined,
+    };
+}
+function createTestInput(options) {
+    return {
+        type: options?.type ?? models_1.INPUT.TEXT,
+        data: options?.data,
+        text: options?.text,
+        payload: options?.payload,
+        src: options?.src,
+        transcript: options?.transcript,
+        context: options?.context,
+        bot_interaction_id: options?.botInteractionId ?? exports.TEST_DEFAULTS.BOT_INTERACTION_ID,
+        message_id: options?.messageId ?? exports.TEST_DEFAULTS.MESSAGE_ID,
+    };
+}
+function isFullInput(v) {
+    return 'bot_interaction_id' in v && 'message_id' in v;
+}
+function isFullSession(v) {
+    return 'bot' in v && '__retries' in v;
+}
+function isFullSettings(v) {
+    return ('HUBTYPE_API_URL' in v &&
+        'STATIC_URL' in v &&
+        'LITELLM_API_URL' in v &&
+        'AZURE_OPENAI_API_BASE' in v &&
+        'AZURE_OPENAI_API_VERSION' in v &&
+        'LANGUAGE_DETECTION_ENABLED' in v &&
+        'CUSTOM_SHORT_URL_HOST' in v &&
+        'custom' in v);
+}
+function isFullSecrets(v) {
+    return ('HUBTYPE_ACCESS_TOKEN' in v &&
+        'LITELLM_API_KEY' in v &&
+        'AZURE_OPENAI_API_KEY' in v &&
+        'custom' in v);
+}
+function createTestBotRequest(options) {
+    const input = options?.input == null
+        ? createTestInput()
+        : isFullInput(options.input)
+            ? options.input
+            : createTestInput(options.input);
+    const session = options?.session == null
+        ? createTestSession()
+        : isFullSession(options.session)
+            ? options.session
+            : createTestSession(options.session);
+    const settings = options?.settings == null
+        ? createTestSettings()
+        : isFullSettings(options.settings)
+            ? options.settings
+            : createTestSettings(options.settings);
+    const secrets = options?.secrets == null
+        ? createTestSecrets()
+        : isFullSecrets(options.secrets)
+            ? options.secrets
+            : createTestSecrets(options.secrets);
+    return {
+        input,
+        session,
+        lastRoutePath: options?.lastRoutePath ?? exports.TEST_DEFAULTS.LAST_ROUTE_PATH,
+        settings,
+        secrets,
+    };
+}
+function createTestBotContext(options) {
+    const request = createTestBotRequest(options);
+    const sessionForLocale = options?.session == null
+        ? createTestSession()
+        : isFullSession(options.session)
+            ? options.session
+            : createTestSession(options.session);
+    const locale = sessionForLocale.user.locale;
+    const country = sessionForLocale.user.country;
+    const systemLocale = sessionForLocale.user.system_locale;
+    return {
+        ...request,
+        plugins: options?.plugins ?? {},
+        params: options?.params ?? {},
+        defaultDelay: options?.defaultDelay ?? 0,
+        defaultTyping: options?.defaultTyping ?? 0,
+        getUserLocale: () => locale,
+        getUserCountry: () => country,
+        getSystemLocale: () => systemLocale,
+        setUserLocale: () => undefined,
+        setUserCountry: () => undefined,
+        setSystemLocale: () => undefined,
+    };
+}
+/**
+ * Alias for `createTestBotContext` typed as `PluginPreRequest`.
+ * PluginPreRequest === BotContext in @botonic/core.
+ */
+exports.createTestPluginPreRequest = createTestBotContext;
+function createTestPluginPostRequest(options) {
+    return {
+        ...createTestBotContext(options),
+        response: options?.response ?? null,
+    };
+}
+//# sourceMappingURL=index.js.map

package/lib/esm/testing/index.js.map

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

package/package.json

@@ -1,10 +1,20 @@
 {
   "name": "@botonic/core",
-  "version": "0.47.0",
+  "version": "0.48.1",
   "license": "MIT",
   "description": "Build Chatbots using React",
   "main": "./lib/cjs/index.js",
   "module": "./lib/esm/index.js",
+  "exports": {
+    ".": {
+      "require": "./lib/cjs/index.js",
+      "import": "./lib/esm/index.js"
+    },
+    "./testing": {
+      "require": "./lib/cjs/testing/index.js",
+      "import": "./lib/esm/testing/index.js"
+    }
+  },
   "scripts": {
     "test": "../../node_modules/.bin/jest --coverage",
     "prepublishOnly": "rm -rf lib && npm i && npm run build",
@@ -29,9 +39,16 @@
     "index.d.ts",
     "README.md"
   ],
+  "typesVersions": {
+    "*": {
+      "testing": [
+        "./lib/cjs/testing/index.d.ts"
+      ]
+    }
+  },
   "dependencies": {
     "@babel/plugin-transform-runtime": "^7.25.9",
-    "axios": "^1.13.6",
+    "axios": "^1.15.2",
     "pako": "^2.1.0",
     "process": "^0.11.10",
     "pusher-js": "^5.1.1"

package/src/core-bot.ts

@@ -4,6 +4,8 @@ import {
   BotonicAction,
   type BotRequest,
   type BotResponse,
+  type BotSecrets,
+  type BotSettings,
   INPUT,
   type Input,
   type ProcessInputResult,
@@ -98,6 +100,9 @@ export class CoreBot {
 
   private getBotContext(request: BotRequest): BotContext {
     const { input, session, lastRoutePath } = request
+    const settings = this.getSettings(request)
+    const secrets = this.getSecrets(request)
+
     return {
       input,
       session,
@@ -114,7 +119,41 @@ export class CoreBot {
       setUserLocale: (locale: string) => this.setUserLocale(locale, session),
       setSystemLocale: (locale: string) =>
         this.setSystemLocale(locale, session),
+      settings,
+      secrets,
+    }
+  }
+
+  private getSettings(request: BotRequest): BotSettings {
+    if (!request.settings) {
+      // This only happens in local development
+      return {
+        HUBTYPE_API_URL: '',
+        STATIC_URL: '',
+        LITELLM_API_URL: '',
+        AZURE_OPENAI_API_BASE: '',
+        AZURE_OPENAI_API_VERSION: '',
+        CUSTOM_SHORT_URL_HOST: '',
+        LANGUAGE_DETECTION_ENABLED: false,
+        custom: {},
+      }
     }
+
+    return request.settings
+  }
+
+  private getSecrets(request: BotRequest): BotSecrets {
+    if (!request.secrets) {
+      // This only happens in local development
+      return {
+        HUBTYPE_ACCESS_TOKEN: '',
+        LITELLM_API_KEY: '',
+        AZURE_OPENAI_API_KEY: '',
+        custom: {},
+      }
+    }
+
+    return request.secrets
   }
 
   private async runInput(botContext: BotContext): Promise<BotResponse> {
@@ -126,6 +165,8 @@ export class CoreBot {
         input: botContext.input,
         session: botContext.session,
         lastRoutePath: botContext.lastRoutePath,
+        settings: botContext.settings,
+        secrets: botContext.secrets,
         response: [],
       }
     }
@@ -145,9 +186,11 @@ export class CoreBot {
 
     return {
       input: botContext.input,
-      response,
       session: botContext.session,
       lastRoutePath: botContext.lastRoutePath,
+      settings: botContext.settings,
+      secrets: botContext.secrets,
+      response,
     }
   }
 
@@ -247,11 +290,13 @@ export class CoreBot {
 
     const followUp = await this.runInput(botContext)
 
-    const response = {
+    const response: BotResponse = {
       input: followUp.input,
       response: previousResponse.response.concat(followUp.response),
       session: botContext.session,
       lastRoutePath: followUp.lastRoutePath,
+      settings: followUp.settings,
+      secrets: followUp.secrets,
     }
 
     // Recursive call to handle multiple bot actions in a row

package/src/models/legacy-types.ts

@@ -241,6 +241,7 @@ export interface SessionUser<TExtraData = any> {
   locale: string
   country: string
   system_locale: string
+  system_locale_updated?: boolean
 }
 
 export interface HubtypeCaseContactReason {
@@ -334,6 +335,26 @@ export interface BotRequest<TExtraData = any> {
   input: Input
   lastRoutePath: RoutePath
   session: Session<TExtraData>
+  settings: BotSettings
+  secrets: BotSecrets
+}
+
+export interface BotSettings {
+  HUBTYPE_API_URL: string
+  STATIC_URL: string
+  LITELLM_API_URL: string
+  AZURE_OPENAI_API_BASE: string
+  AZURE_OPENAI_API_VERSION: string
+  LANGUAGE_DETECTION_ENABLED?: boolean
+  CUSTOM_SHORT_URL_HOST: string | null
+  custom: Record<string, any>
+}
+
+export interface BotSecrets {
+  HUBTYPE_ACCESS_TOKEN: string
+  LITELLM_API_KEY: string
+  AZURE_OPENAI_API_KEY: string
+  custom: Record<string, any>
 }
 
 export interface BotContext<