@botonic/core 2.26.0 → 2.28.0

package/src/lib/server/botonic-context/botonic-context-session.js

@@ -0,0 +1,297 @@
+import { MessagingChannel } from '@botonic/shared';
+import { DEFAULT_WEBCHAT_CLIENT_SETTINGS, } from '@botonic/shared';
+import { BotonicAction } from './botonic-action';
+/**
+ * Maps camelCase session updates to snake_case PATCH body (v2 only).
+ */
+export function sessionUpdateToPatchBody(update) {
+    const body = {};
+    if (update.isFirstInteraction !== undefined) {
+        body.is_first_interaction = update.isFirstInteraction;
+    }
+    if (update.shadowing !== undefined)
+        body.shadowing = update.shadowing;
+    if (update.flowThreadId !== undefined) {
+        body.flow_thread_id = update.flowThreadId;
+    }
+    if (update.custom !== undefined)
+        body.custom = update.custom;
+    if (update.webviewsCustom !== undefined) {
+        body.webviews_custom = update.webviewsCustom;
+    }
+    if (update.webchatClientSettings !== undefined) {
+        body.webchat_client_settings = update.webchatClientSettings;
+    }
+    if (update.captureUserInputNodeId !== undefined) {
+        const id = update.captureUserInputNodeId;
+        if (id === null || id === '') {
+            body.capture_user_input_node_id = null;
+        }
+        else {
+            body.capture_user_input_node_id = id;
+        }
+    }
+    return body;
+}
+/**
+ * Mutates `session.raw` immediately so the rest of the turn sees updates.
+ * Handles `capture_user_input_node_id` (mirror of {@link sessionUpdateToPatchBody}) and
+ * `_botonic_action` (not sent on session PATCH).
+ * For `isFirstInteraction`, also updates in-memory `is_first_interaction`; the same
+ * value is emitted by {@link sessionUpdateToPatchBody} for `PATCH …/session/`.
+ */
+export function applyNonPatchSessionUpdateFields(session, updates) {
+    if (updates.captureUserInputNodeId !== undefined) {
+        const id = updates.captureUserInputNodeId;
+        if (id === null || id === '') {
+            delete session.capture_user_input_node_id;
+        }
+        else {
+            session.capture_user_input_node_id = id;
+        }
+    }
+    if (updates.isFirstInteraction !== undefined) {
+        session.is_first_interaction = updates.isFirstInteraction;
+    }
+    if (updates.botonicAction !== undefined) {
+        const w = session;
+        if (updates.botonicAction === null || updates.botonicAction === '') {
+            delete w._botonic_action;
+        }
+        else {
+            w._botonic_action = updates.botonicAction;
+        }
+    }
+}
+/**
+ * Maps `BotonicSessionUpdate.user` to `PATCH …/users/<user_id>/` body (ChatUserPatchSerializer keys, snake_case).
+ * Unknown keys are omitted — only serializer fields are sent.
+ */
+export function userUpdateToChatUserPatchBody(user) {
+    if (user === undefined)
+        return {};
+    const body = {};
+    if (user.overrideName !== undefined) {
+        body.override_name = user.overrideName;
+    }
+    if (user.locale !== undefined) {
+        body.locale = user.locale;
+    }
+    if (user.country !== undefined) {
+        body.country = user.country;
+    }
+    if (user.systemLocale !== undefined) {
+        body.system_locale = user.systemLocale;
+    }
+    if (user.extraData !== undefined) {
+        body.extra_data = user.extraData;
+    }
+    return body;
+}
+export class BotonicContextSessionUser {
+    constructor(rawUser, onUserUpdate) {
+        this.rawUser = rawUser;
+        this.onUserUpdate = onUserUpdate;
+    }
+    get raw() {
+        return this.rawUser;
+    }
+    get id() {
+        return this.rawUser.id;
+    }
+    get username() {
+        var _a;
+        return (_a = this.rawUser.username) !== null && _a !== void 0 ? _a : undefined;
+    }
+    get name() {
+        var _a;
+        return (_a = this.rawUser.name) !== null && _a !== void 0 ? _a : undefined;
+    }
+    get overrideName() {
+        var _a;
+        return (_a = this.rawUser.override_name) !== null && _a !== void 0 ? _a : undefined;
+    }
+    get providerId() {
+        return this.rawUser.provider_id;
+    }
+    get locale() {
+        return this.rawUser.locale;
+    }
+    set locale(v) {
+        this.rawUser.locale = v;
+    }
+    get country() {
+        return this.rawUser.country;
+    }
+    set country(v) {
+        this.rawUser.country = v;
+    }
+    get systemLocale() {
+        return this.rawUser.system_locale;
+    }
+    set systemLocale(v) {
+        this.rawUser.system_locale = v;
+    }
+    get extraData() {
+        return this.rawUser.extra_data;
+    }
+    set extraData(v) {
+        var _a;
+        this.rawUser.extra_data = v;
+        void ((_a = this.onUserUpdate) === null || _a === void 0 ? void 0 : _a.call(this, { extraData: v }));
+    }
+    get contactInfo() {
+        return this.rawUser.contact_info;
+    }
+}
+export class BotonicContextSession {
+    constructor(sessionData) {
+        this.sessionData = sessionData;
+    }
+    setOnUpdate(cb) {
+        this.onUpdate = cb;
+    }
+    /** Replace underlying session object (e.g. after GET session from Hubtype). */
+    replaceSession(next) {
+        this.sessionData = next;
+    }
+    get raw() {
+        return this.sessionData;
+    }
+    get bot() {
+        return this.sessionData.bot;
+    }
+    get user() {
+        const notify = this.onUpdate;
+        return new BotonicContextSessionUser(this.sessionData.user, notify !== undefined
+            ? updates => {
+                notify({ user: updates });
+            }
+            : undefined);
+    }
+    get organizationId() {
+        return this.sessionData.organization.id;
+    }
+    get organizationName() {
+        return this.sessionData.organization.name;
+    }
+    get isFirstInteraction() {
+        return this.sessionData.is_first_interaction;
+    }
+    set isFirstInteraction(v) {
+        this.sessionData.is_first_interaction = v;
+    }
+    get botonicAction() {
+        const w = this.sessionData;
+        const v = w._botonic_action;
+        return typeof v === 'string' ? v : undefined;
+    }
+    set botonicAction(v) {
+        const w = this.sessionData;
+        if (v === undefined || v === '') {
+            delete w._botonic_action;
+        }
+        else {
+            w._botonic_action = v;
+        }
+    }
+    isBotonicActionRedirect() {
+        const a = this.botonicAction;
+        const prefix = `${BotonicAction.Redirect}:`;
+        return typeof a === 'string' && a.startsWith(prefix);
+    }
+    getBotonicActionPayload(action) {
+        const prefix = `${action}:`;
+        const a = this.botonicAction;
+        if (typeof a !== 'string' || !a.startsWith(prefix))
+            return undefined;
+        return a.slice(prefix.length);
+    }
+    get isTestIntegration() {
+        return this.sessionData.is_test_integration;
+    }
+    get flowThreadId() {
+        return this.sessionData.flow_thread_id;
+    }
+    get shadowing() {
+        return this.sessionData.shadowing;
+    }
+    set shadowing(v) {
+        this.sessionData.shadowing = v;
+    }
+    get hadHubtypeHandoff() {
+        return this.sessionData.had_hubtype_handoff;
+    }
+    get hubtypeCase() {
+        return this.sessionData.hubtype_case;
+    }
+    /** Convenience for legacy code paths; prefer {@link hubtypeCase}. */
+    get hubtypeCaseId() {
+        var _a;
+        return (_a = this.sessionData.hubtype_case) === null || _a === void 0 ? void 0 : _a.id;
+    }
+    get custom() {
+        return this.sessionData.custom;
+    }
+    get external() {
+        return this.sessionData.external;
+    }
+    get webviewsCustom() {
+        return this.sessionData.webviews_custom;
+    }
+    set webviewsCustom(v) {
+        this.sessionData.webviews_custom = v;
+    }
+    get webchatClientSettings() {
+        var _a;
+        return ((_a = this.sessionData.webchat_client_settings) !== null && _a !== void 0 ? _a : DEFAULT_WEBCHAT_CLIENT_SETTINGS);
+    }
+    set webchatClientSettings(v) {
+        this.sessionData.webchat_client_settings = v;
+    }
+    /** Flow Builder: node id capturing user input (`capture_user_input_node_id` in JSON). */
+    get captureUserInputNodeId() {
+        const id = this.sessionData.capture_user_input_node_id;
+        if (id == null || id === '') {
+            return undefined;
+        }
+        return id;
+    }
+    /** Channel provider (e.g. webchat, whatsapp). */
+    get provider() {
+        return this.sessionData.channel.provider;
+    }
+    get impId() {
+        return this.sessionData.channel.imp_id;
+    }
+    get unformattedPhoneNumber() {
+        var _a;
+        return (_a = this.sessionData.channel.unformatted_phone_number) !== null && _a !== void 0 ? _a : undefined;
+    }
+    isDev() {
+        return this.provider === MessagingChannel.Webchat;
+    }
+    isWebchat() {
+        return this.provider === MessagingChannel.Webchat;
+    }
+    isTelegram() {
+        return this.provider === MessagingChannel.Telegram;
+    }
+    isFacebook() {
+        return this.provider === MessagingChannel.Facebook;
+    }
+    isInstagram() {
+        return this.provider === MessagingChannel.Instagram;
+    }
+    isTwitter() {
+        return this.provider === MessagingChannel.Twitter;
+    }
+    isWhatsapp() {
+        return this.provider === MessagingChannel.Whatsapp;
+    }
+    hasFlowThreadId() {
+        const ft = this.flowThreadId;
+        return ft != null && ft !== '';
+    }
+}
+//# sourceMappingURL=botonic-context-session.js.map

package/src/lib/server/botonic-context/botonic-context-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"botonic-context-session.js","sourceRoot":"","sources":["../../../../../../../../libs/botonic/core/src/lib/server/botonic-context/botonic-context-session.ts"],"names":[],"mappings":"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"}

package/src/lib/server/botonic-context/botonic-context-settings.d.ts

@@ -0,0 +1,16 @@
+import type { BotonicSecrets, BotonicSettings } from '@botonic/shared';
+export declare class BotonicContextSettings {
+    private readonly rawSettings;
+    constructor(rawSettings: BotonicSettings);
+    get raw(): BotonicSettings;
+    get hubtypeApiUrl(): string;
+    get staticUrl(): string | undefined;
+    get allSettings(): BotonicSettings;
+}
+export declare class BotonicContextSecrets {
+    private readonly rawSecrets;
+    constructor(rawSecrets: BotonicSecrets);
+    get raw(): BotonicSecrets;
+    get hubtypeAccessToken(): string;
+    get allSecrets(): BotonicSecrets;
+}

package/src/lib/server/botonic-context/botonic-context-settings.js

@@ -0,0 +1,48 @@
+export class BotonicContextSettings {
+    constructor(rawSettings) {
+        this.rawSettings = rawSettings;
+    }
+    get raw() {
+        return this.rawSettings;
+    }
+    get hubtypeApiUrl() {
+        return this.rawSettings.HUBTYPE_API_URL;
+    }
+    get staticUrl() {
+        return this.rawSettings.STATIC_URL;
+    }
+    // TODO: Implement the rest getters when needed
+    get allSettings() {
+        return {
+            HUBTYPE_API_URL: this.rawSettings.HUBTYPE_API_URL,
+            FLOW_BUILDER_API_URL: this.rawSettings.FLOW_BUILDER_API_URL,
+            STATIC_URL: this.rawSettings.STATIC_URL,
+            LITELLM_API_URL: this.rawSettings.LITELLM_API_URL,
+            AZURE_OPENAI_API_BASE: this.rawSettings.AZURE_OPENAI_API_BASE,
+            AZURE_OPENAI_API_VERSION: this.rawSettings.AZURE_OPENAI_API_VERSION,
+            CUSTOM_SHORT_URL_HOST: this.rawSettings.CUSTOM_SHORT_URL_HOST,
+            custom: this.rawSettings.custom,
+        };
+    }
+}
+export class BotonicContextSecrets {
+    constructor(rawSecrets) {
+        this.rawSecrets = rawSecrets;
+    }
+    get raw() {
+        return this.rawSecrets;
+    }
+    get hubtypeAccessToken() {
+        return this.rawSecrets.HUBTYPE_ACCESS_TOKEN;
+    }
+    // TODO: Implement the rest getters when needed
+    get allSecrets() {
+        return {
+            HUBTYPE_ACCESS_TOKEN: this.rawSecrets.HUBTYPE_ACCESS_TOKEN,
+            LITELLM_API_KEY: this.rawSecrets.LITELLM_API_KEY,
+            AZURE_OPENAI_API_KEY: this.rawSecrets.AZURE_OPENAI_API_KEY,
+            custom: this.rawSecrets.custom,
+        };
+    }
+}
+//# sourceMappingURL=botonic-context-settings.js.map

package/src/lib/server/botonic-context/botonic-context-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"botonic-context-settings.js","sourceRoot":"","sources":["../../../../../../../../libs/botonic/core/src/lib/server/botonic-context/botonic-context-settings.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,sBAAsB;IACjC,YAA6B,WAA4B;QAA5B,gBAAW,GAAX,WAAW,CAAiB;IAAG,CAAC;IAE7D,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,WAAW,CAAA;IACzB,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,WAAW,CAAC,eAAe,CAAA;IACzC,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,CAAA;IACpC,CAAC;IAED,+CAA+C;IAE/C,IAAI,WAAW;QACb,OAAO;YACL,eAAe,EAAE,IAAI,CAAC,WAAW,CAAC,eAAe;YACjD,oBAAoB,EAAE,IAAI,CAAC,WAAW,CAAC,oBAAoB;YAC3D,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU;YACvC,eAAe,EAAE,IAAI,CAAC,WAAW,CAAC,eAAe;YACjD,qBAAqB,EAAE,IAAI,CAAC,WAAW,CAAC,qBAAqB;YAC7D,wBAAwB,EAAE,IAAI,CAAC,WAAW,CAAC,wBAAwB;YACnE,qBAAqB,EAAE,IAAI,CAAC,WAAW,CAAC,qBAAqB;YAC7D,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM;SAChC,CAAA;IACH,CAAC;CACF;AAED,MAAM,OAAO,qBAAqB;IAChC,YAA6B,UAA0B;QAA1B,eAAU,GAAV,UAAU,CAAgB;IAAG,CAAC;IAE3D,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,UAAU,CAAA;IACxB,CAAC;IAED,IAAI,kBAAkB;QACpB,OAAO,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAA;IAC7C,CAAC;IAED,+CAA+C;IAE/C,IAAI,UAAU;QACZ,OAAO;YACL,oBAAoB,EAAE,IAAI,CAAC,UAAU,CAAC,oBAAoB;YAC1D,eAAe,EAAE,IAAI,CAAC,UAAU,CAAC,eAAe;YAChD,oBAAoB,EAAE,IAAI,CAAC,UAAU,CAAC,oBAAoB;YAC1D,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM;SAC/B,CAAA;IACH,CAAC;CACF"}

package/src/lib/server/botonic-context/botonic-context.d.ts

@@ -0,0 +1,59 @@
+import type { HubtypeApiService } from '../../services/hubtype-api-service';
+import type { UserExtraData } from '@botonic/shared';
+import { BotServerMessage } from '../bot-server-message';
+import { BotonicContextInput } from './botonic-context-input';
+import type { BotonicContextSession, BotonicSessionUpdate } from './botonic-context-session';
+import type { BotonicContextSecrets, BotonicContextSettings } from './botonic-context-settings';
+import type { ActionResponse, ResolvedPlugins, SendMessagesOptions, TypingMode } from './types';
+/** Result of creating input/session from raw lambda request (used by BotonicContextFactory). */
+export interface BotonicContextType<TExtraData extends UserExtraData = UserExtraData> {
+    input: BotonicContextInput;
+    session: BotonicContextSession<TExtraData>;
+    settings: BotonicContextSettings;
+    secrets: BotonicContextSecrets;
+}
+/** Options for handoff to human agent. */
+export interface HandoffOptions {
+    queue?: string;
+    on_finish?: string;
+    agent_email?: string;
+    agent_id?: string;
+    case_info?: string;
+    note?: string;
+    shadowing?: boolean;
+    auto_idle_message?: string;
+    force_assign_if_not_available?: boolean;
+    auto_assign_on_waiting?: boolean;
+    case_extra_data?: Record<string, unknown>;
+    bot_event?: {
+        flow_id: string;
+        flow_name: string;
+        flow_node_id: string;
+        flow_node_content_id: string;
+    };
+    subscribe_helpdesk_events?: string[];
+}
+/** Full execution context with input, session, and hubtype service methods. */
+export declare class BotonicContext<TPlugins extends ResolvedPlugins = ResolvedPlugins, TExtraData extends UserExtraData = UserExtraData> implements BotonicContextType<TExtraData> {
+    private readonly hubtypeService;
+    input: BotonicContextInput;
+    session: BotonicContextSession<TExtraData>;
+    readonly settings: BotonicContextSettings;
+    readonly secrets: BotonicContextSecrets;
+    defaultDelay: number;
+    defaultTyping: number;
+    defaultTypingMode: TypingMode;
+    params: Record<string, string>;
+    plugins: TPlugins;
+    response?: ActionResponse;
+    constructor(hubtypeService: HubtypeApiService, base: BotonicContextType<TExtraData>, plugins: TPlugins, defaultTyping: number, defaultDelay: number, defaultTypingMode: TypingMode, response?: ActionResponse);
+    /**
+     * Session user setters notify via sync callback; `updateBotSession` is async.
+     * Attach `.catch` so fetch/network failures are logged instead of unhandled rejections.
+     */
+    private bindSessionUpdateCallback;
+    sendMessages: (messages: BotServerMessage[], options?: SendMessagesOptions) => Promise<unknown>;
+    doHandoff: (handoffOptions?: HandoffOptions) => Promise<unknown>;
+    getBotSession: () => Promise<import("@botonic/shared").BotonicSession<UserExtraData>>;
+    updateBotSession: (updates: BotonicSessionUpdate<TExtraData>) => Promise<void>;
+}

package/src/lib/server/botonic-context/botonic-context.js

@@ -0,0 +1,42 @@
+import { __awaiter } from "tslib";
+import { injectTypingEvents } from './send-messages-utils';
+/** Full execution context with input, session, and hubtype service methods. */
+export class BotonicContext {
+    constructor(hubtypeService, base, plugins, defaultTyping, defaultDelay, defaultTypingMode, response) {
+        this.hubtypeService = hubtypeService;
+        this.sendMessages = (messages, options) => __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const typingMode = (_a = options === null || options === void 0 ? void 0 : options.typingMode) !== null && _a !== void 0 ? _a : this.defaultTypingMode;
+            return this.hubtypeService.sendMessages(this, injectTypingEvents(messages, typingMode));
+        });
+        this.doHandoff = (handoffOptions) => __awaiter(this, void 0, void 0, function* () { return this.hubtypeService.doHandoff(this, handoffOptions); });
+        this.getBotSession = () => __awaiter(this, void 0, void 0, function* () { return this.hubtypeService.getBotSession(this); });
+        this.updateBotSession = (updates) => __awaiter(this, void 0, void 0, function* () {
+            yield this.hubtypeService.updateBotSession(this, updates);
+            this.bindSessionUpdateCallback();
+        });
+        this.input = base.input;
+        this.session = base.session;
+        this.settings = base.settings;
+        this.secrets = base.secrets;
+        this.params = {};
+        this.plugins = plugins;
+        this.defaultTyping = defaultTyping;
+        this.defaultDelay = defaultDelay;
+        this.defaultTypingMode = defaultTypingMode;
+        this.response = response;
+        this.bindSessionUpdateCallback();
+    }
+    /**
+     * Session user setters notify via sync callback; `updateBotSession` is async.
+     * Attach `.catch` so fetch/network failures are logged instead of unhandled rejections.
+     */
+    bindSessionUpdateCallback() {
+        this.session.setOnUpdate(u => {
+            void this.updateBotSession(u).catch((err) => {
+                console.error('[BotonicContext] updateBotSession failed (session sync)', err);
+            });
+        });
+    }
+}
+//# sourceMappingURL=botonic-context.js.map

package/src/lib/server/botonic-context/botonic-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"botonic-context.js","sourceRoot":"","sources":["../../../../../../../../libs/botonic/core/src/lib/server/botonic-context/botonic-context.ts"],"names":[],"mappings":";AAYA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAwC1D,+EAA+E;AAC/E,MAAM,OAAO,cAAc;IAezB,YACmB,cAAiC,EAClD,IAAoC,EACpC,OAAiB,EACjB,aAAqB,EACrB,YAAoB,EACpB,iBAA6B,EAC7B,QAAyB;QANR,mBAAc,GAAd,cAAc,CAAmB;QAoCpD,iBAAY,GAAG,CACb,QAA4B,EAC5B,OAA6B,EAC7B,EAAE;;YACF,MAAM,UAAU,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,UAAU,mCAAI,IAAI,CAAC,iBAAiB,CAAA;YAChE,OAAO,IAAI,CAAC,cAAc,CAAC,YAAY,CACrC,IAAI,EACJ,kBAAkB,CAAC,QAAQ,EAAE,UAAU,CAAC,CACzC,CAAA;QACH,CAAC,CAAA,CAAA;QACD,cAAS,GAAG,CAAO,cAA+B,EAAE,EAAE,gDACpD,OAAA,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,IAAI,EAAE,cAAc,CAAC,CAAA,GAAA,CAAA;QACrD,kBAAa,GAAG,GAAS,EAAE,gDAAC,OAAA,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA,GAAA,CAAA;QACnE,qBAAgB,GAAG,CAAO,OAAyC,EAAE,EAAE;YACrE,MAAM,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YACzD,IAAI,CAAC,yBAAyB,EAAE,CAAA;QAClC,CAAC,CAAA,CAAA;QA5CC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QACvB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAC3B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;QAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAC3B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAA;QAChB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAA;QAClC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAChC,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAA;QAC1C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,yBAAyB,EAAE,CAAA;IAClC,CAAC;IAED;;;OAGG;IACK,yBAAyB;QAC/B,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE;YAC3B,KAAK,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;gBACnD,OAAO,CAAC,KAAK,CACX,yDAAyD,EACzD,GAAG,CACJ,CAAA;YACH,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC;CAmBF"}

package/src/lib/server/botonic-context/botonic-session-patch-slice.d.ts

@@ -0,0 +1,30 @@
+/**
+ * v2 `PATCH …/session/` success body: stored slice only (not full BotonicSessionBuilder JSON).
+ * @see openspec/specs/BE-botonic-v2-botonic-session-endpoints/spec.md
+ */
+import type { BotonicSession, BotonicSessionUser, UserExtraData } from '@botonic/shared';
+import { WebchatClientSettings } from '@botonic/shared';
+export interface BotonicSessionPatchSlice {
+    shadowing?: boolean;
+    flow_thread_id?: string;
+    is_first_interaction?: boolean;
+    custom?: Record<string, any>;
+    webviews_custom?: Record<string, any>;
+    webchat_client_settings?: WebchatClientSettings;
+    /** Flow Builder capture node id (`null` clears). */
+    capture_user_input_node_id?: string | null;
+}
+/**
+ * Mutates `session` with fields from the PATCH session response (slice), deep-merging object fields
+ * to mirror server `deep_merge` behavior for nested dicts.
+ */
+export declare function mergeBotonicSessionPatchSlice<TExtraData extends UserExtraData = UserExtraData>(session: BotonicSession<TExtraData>, slice: BotonicSessionPatchSlice): void;
+/** `PATCH …/users/<user_id>/` 200 body (echo slice). */
+export interface ChatUserPatchResponse {
+    override_name?: string;
+    locale?: string;
+    country?: string;
+    system_locale?: string;
+    extra_data?: UserExtraData;
+}
+export declare function mergeChatUserPatchResponseIntoSessionUser<TExtraData extends UserExtraData = UserExtraData>(user: BotonicSessionUser<TExtraData>, response: ChatUserPatchResponse): void;

package/src/lib/server/botonic-context/botonic-session-patch-slice.js

@@ -0,0 +1,80 @@
+/**
+ * v2 `PATCH …/session/` success body: stored slice only (not full BotonicSessionBuilder JSON).
+ * @see openspec/specs/BE-botonic-v2-botonic-session-endpoints/spec.md
+ */
+import { mergeWebchatClientSettings, WebchatClientSettings, } from '@botonic/shared';
+function isPlainObject(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+function deepMergeRecords(target, patch) {
+    const merged = Object.assign({}, target);
+    for (const [key, patchValue] of Object.entries(patch)) {
+        const targetValue = merged[key];
+        if (isPlainObject(patchValue) && isPlainObject(targetValue)) {
+            merged[key] = deepMergeRecords(targetValue, patchValue);
+        }
+        else {
+            merged[key] = patchValue;
+        }
+    }
+    return merged;
+}
+/**
+ * Mutates `session` with fields from the PATCH session response (slice), deep-merging object fields
+ * to mirror server `deep_merge` behavior for nested dicts.
+ */
+export function mergeBotonicSessionPatchSlice(session, slice) {
+    var _a, _b, _c;
+    if (slice.shadowing !== undefined)
+        session.shadowing = slice.shadowing;
+    if (slice.flow_thread_id !== undefined)
+        session.flow_thread_id = slice.flow_thread_id;
+    if (slice.is_first_interaction !== undefined) {
+        session.is_first_interaction = slice.is_first_interaction;
+    }
+    if (slice.custom !== undefined) {
+        session.custom = deepMergeRecords(((_a = session.custom) !== null && _a !== void 0 ? _a : {}), slice.custom);
+    }
+    if (slice.webviews_custom !== undefined) {
+        session.webviews_custom = deepMergeRecords(((_b = session.webviews_custom) !== null && _b !== void 0 ? _b : {}), slice.webviews_custom);
+    }
+    if (slice.webchat_client_settings !== undefined) {
+        const current = (_c = session.webchat_client_settings) !== null && _c !== void 0 ? _c : new WebchatClientSettings();
+        const incoming = slice.webchat_client_settings instanceof WebchatClientSettings
+            ? slice.webchat_client_settings
+            : new WebchatClientSettings(slice.webchat_client_settings);
+        session.webchat_client_settings = mergeWebchatClientSettings(current, incoming);
+    }
+    if (slice.capture_user_input_node_id !== undefined) {
+        const id = slice.capture_user_input_node_id;
+        if (id === null || id === '') {
+            delete session.capture_user_input_node_id;
+        }
+        else {
+            session.capture_user_input_node_id = id;
+        }
+    }
+}
+export function mergeChatUserPatchResponseIntoSessionUser(user, response) {
+    if (response.override_name !== undefined) {
+        user.override_name = response.override_name;
+    }
+    if (response.locale !== undefined) {
+        user.locale = response.locale;
+    }
+    if (response.country !== undefined) {
+        user.country = response.country;
+    }
+    if (response.system_locale !== undefined) {
+        user.system_locale = response.system_locale;
+    }
+    if (response.extra_data !== undefined) {
+        if (response.extra_data === null) {
+            user.extra_data = undefined;
+        }
+        else {
+            user.extra_data = response.extra_data;
+        }
+    }
+}
+//# sourceMappingURL=botonic-session-patch-slice.js.map

package/src/lib/server/botonic-context/botonic-session-patch-slice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"botonic-session-patch-slice.js","sourceRoot":"","sources":["../../../../../../../../libs/botonic/core/src/lib/server/botonic-context/botonic-session-patch-slice.ts"],"names":[],"mappings":"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"}

package/src/lib/server/botonic-context/factory.d.ts

@@ -0,0 +1,29 @@
+import type { HubtypeApiService } from '../../services/hubtype-api-service';
+import type { BotonicSession, UserExtraData } from '@botonic/shared';
+import type { BotonicSecrets, BotonicSettings } from '@botonic/shared';
+import type { BotonicContextType } from './botonic-context';
+import { BotonicContext } from './botonic-context';
+import type { BotonicRequestInput } from './botonic-context-input';
+import type { ResolvedPlugins, TypingMode } from './types';
+/** Bot request after parsing the Hubtype v2 Lambda event (typed input + session + settings + secrets). */
+export interface BotonicRequest<TExtraData extends UserExtraData = UserExtraData> {
+    input: BotonicRequestInput;
+    session: BotonicSession<TExtraData>;
+    settings: BotonicSettings;
+    secrets: BotonicSecrets;
+}
+/**
+ * Factory that creates BotonicContext from raw lambda request.
+ * Injects hubtypeService so the context has working sendMessages, doHandoff, etc.
+ */
+export declare class BotonicContextFactory<TPlugins extends ResolvedPlugins = ResolvedPlugins> {
+    private readonly hubtypeService;
+    private readonly plugins;
+    private readonly defaultTyping;
+    private readonly defaultDelay;
+    private readonly defaultTypingMode;
+    constructor(hubtypeService: HubtypeApiService, plugins: TPlugins, defaultTyping: number, defaultDelay: number, defaultTypingMode?: TypingMode);
+    /** Creates input, session, settings, and secrets from a {@link BotonicRequest}. */
+    static from<TExtraData extends UserExtraData = UserExtraData>(raw: BotonicRequest<TExtraData>): BotonicContextType<TExtraData>;
+    create<TExtraData extends UserExtraData = UserExtraData>(raw: BotonicRequest<TExtraData>): BotonicContext<TPlugins, TExtraData>;
+}