@botonic/core 2.26.0 → 2.28.0

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

@@ -0,0 +1,31 @@
+import { BotonicContext } from './botonic-context';
+import { BotonicContextInput } from './botonic-context-input';
+import { BotonicContextSession } from './botonic-context-session';
+import { BotonicContextSecrets, BotonicContextSettings, } from './botonic-context-settings';
+/**
+ * Factory that creates BotonicContext from raw lambda request.
+ * Injects hubtypeService so the context has working sendMessages, doHandoff, etc.
+ */
+export class BotonicContextFactory {
+    constructor(hubtypeService, plugins, defaultTyping, defaultDelay, defaultTypingMode = 'inBetweenTyping') {
+        this.hubtypeService = hubtypeService;
+        this.plugins = plugins;
+        this.defaultTyping = defaultTyping;
+        this.defaultDelay = defaultDelay;
+        this.defaultTypingMode = defaultTypingMode;
+    }
+    /** Creates input, session, settings, and secrets from a {@link BotonicRequest}. */
+    static from(raw) {
+        return {
+            input: new BotonicContextInput(raw.input),
+            session: new BotonicContextSession(raw.session),
+            settings: new BotonicContextSettings(raw.settings),
+            secrets: new BotonicContextSecrets(raw.secrets),
+        };
+    }
+    create(raw) {
+        const base = BotonicContextFactory.from(raw);
+        return new BotonicContext(this.hubtypeService, base, this.plugins, this.defaultTyping, this.defaultDelay, this.defaultTypingMode);
+    }
+}
+//# sourceMappingURL=factory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../../../../../libs/botonic/core/src/lib/server/botonic-context/factory.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAElD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AACjE,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,4BAA4B,CAAA;AAanC;;;GAGG;AACH,MAAM,OAAO,qBAAqB;IAGhC,YACmB,cAAiC,EACjC,OAAiB,EACjB,aAAqB,EACrB,YAAoB,EACpB,oBAAgC,iBAAiB;QAJjD,mBAAc,GAAd,cAAc,CAAmB;QACjC,YAAO,GAAP,OAAO,CAAU;QACjB,kBAAa,GAAb,aAAa,CAAQ;QACrB,iBAAY,GAAZ,YAAY,CAAQ;QACpB,sBAAiB,GAAjB,iBAAiB,CAAgC;IACjE,CAAC;IAEJ,mFAAmF;IACnF,MAAM,CAAC,IAAI,CACT,GAA+B;QAE/B,OAAO;YACL,KAAK,EAAE,IAAI,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC;YACzC,OAAO,EAAE,IAAI,qBAAqB,CAAa,GAAG,CAAC,OAAO,CAAC;YAC3D,QAAQ,EAAE,IAAI,sBAAsB,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClD,OAAO,EAAE,IAAI,qBAAqB,CAAC,GAAG,CAAC,OAAO,CAAC;SAChD,CAAA;IACH,CAAC;IAED,MAAM,CACJ,GAA+B;QAE/B,MAAM,IAAI,GAAG,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC5C,OAAO,IAAI,cAAc,CACvB,IAAI,CAAC,cAAc,EACnB,IAAI,EACJ,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,iBAAiB,CACvB,CAAA;IACH,CAAC;CACF"}

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

@@ -0,0 +1,9 @@
+export * from './botonic-action';
+export * from './botonic-context';
+export * from './botonic-context-input';
+export * from './botonic-context-session';
+export * from './botonic-context-settings';
+export * from './botonic-session-patch-slice';
+export * from './factory';
+export * from './send-messages-utils';
+export * from './types';

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

@@ -0,0 +1,10 @@
+export * from './botonic-action';
+export * from './botonic-context';
+export * from './botonic-context-input';
+export * from './botonic-context-session';
+export * from './botonic-context-settings';
+export * from './botonic-session-patch-slice';
+export * from './factory';
+export * from './send-messages-utils';
+export * from './types';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../libs/botonic/core/src/lib/server/botonic-context/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,2BAA2B,CAAA;AACzC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,WAAW,CAAA;AACzB,cAAc,uBAAuB,CAAA;AACrC,cAAc,SAAS,CAAA"}

package/src/lib/server/botonic-context/send-messages-utils.d.ts

@@ -0,0 +1,3 @@
+import type { BotServerMessage } from '../bot-server-message';
+import type { TypingMode } from './types';
+export declare function injectTypingEvents(messages: BotServerMessage[], mode: TypingMode | false | undefined): BotServerMessage[];

package/src/lib/server/botonic-context/send-messages-utils.js

@@ -0,0 +1,33 @@
+import { TypingEventName } from '@botonic/shared';
+import { BotServerMessageFactory } from '../factory';
+const DEFAULT_TYPING_DELAY = 1;
+function typingEvent() {
+    return BotServerMessageFactory.createTypingEvent({
+        eventName: TypingEventName.TypingOn,
+    });
+}
+function withDefaultDelay(msg) {
+    if (msg.delay !== undefined)
+        return msg;
+    const clone = Object.create(Object.getPrototypeOf(msg));
+    return Object.assign(clone, msg, { delay: DEFAULT_TYPING_DELAY });
+}
+export function injectTypingEvents(messages, mode) {
+    if (!mode || messages.length === 0)
+        return messages;
+    if (mode === 'onlyFirst') {
+        const [first, ...rest] = messages;
+        return [typingEvent(), withDefaultDelay(first), ...rest];
+    }
+    return messages.reduce((acc, msg, index) => {
+        if (index > 0) {
+            acc.push(typingEvent());
+            acc.push(withDefaultDelay(msg));
+        }
+        else {
+            acc.push(msg);
+        }
+        return acc;
+    }, []);
+}
+//# sourceMappingURL=send-messages-utils.js.map

package/src/lib/server/botonic-context/send-messages-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-messages-utils.js","sourceRoot":"","sources":["../../../../../../../../libs/botonic/core/src/lib/server/botonic-context/send-messages-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAGpD,MAAM,oBAAoB,GAAG,CAAC,CAAA;AAE9B,SAAS,WAAW;IAClB,OAAO,uBAAuB,CAAC,iBAAiB,CAAC;QAC/C,SAAS,EAAE,eAAe,CAAC,QAAQ;KACpC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,gBAAgB,CAA6B,GAAM;IAC1D,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,GAAG,CAAA;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAM,CAAA;IAC5D,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAA;AACnE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,QAA4B,EAC5B,IAAoC;IAEpC,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAA;IAEnD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,QAAQ,CAAA;QACjC,OAAO,CAAC,WAAW,EAAE,EAAE,gBAAgB,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAA;IAC1D,CAAC;IAED,OAAO,QAAQ,CAAC,MAAM,CAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QAC7D,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;YACvB,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAA;QACjC,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACf,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC,EAAE,EAAE,CAAC,CAAA;AACR,CAAC"}

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

@@ -0,0 +1,24 @@
+import { BotonicContext } from './botonic-context';
+export type TypingMode = 'onlyFirst' | 'inBetweenTyping';
+export interface SendMessagesOptions {
+    typingMode?: TypingMode | false;
+}
+export interface ActionResponse {
+    status: number;
+    response: string;
+}
+export type Action = (botonicContext: BotonicContext) => Promise<ActionResponse>;
+export interface Plugin {
+    pre?(request: BotonicContext): void | Promise<void>;
+    post?(request: BotonicContext): void | Promise<void>;
+}
+export type ResolvedPlugins = Record<string, Plugin>;
+export interface RunPluginArgs {
+    botonicContext: BotonicContext;
+    mode: PluginMode;
+    response?: ActionResponse;
+}
+export declare enum PluginMode {
+    PRE = "pre",
+    POST = "post"
+}

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

@@ -0,0 +1,6 @@
+export var PluginMode;
+(function (PluginMode) {
+    PluginMode["PRE"] = "pre";
+    PluginMode["POST"] = "post";
+})(PluginMode || (PluginMode = {}));
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../../libs/botonic/core/src/lib/server/botonic-context/types.ts"],"names":[],"mappings":"AA4BA,MAAM,CAAN,IAAY,UAGX;AAHD,WAAY,UAAU;IACpB,yBAAW,CAAA;IACX,2BAAa,CAAA;AACf,CAAC,EAHW,UAAU,KAAV,UAAU,QAGrB"}

package/src/lib/server/factory.d.ts

@@ -0,0 +1,169 @@
+import { BotMessageMetadata } from '@botonic/shared';
+import { BotonicButtonContent, BotonicCarouselElement, TypingEventName } from '@botonic/shared';
+import { WebchatClientSettings } from '@botonic/shared';
+import { WhatsappButtonListSection, WhatsappHeaderType, WhatsappMediaCarouselCard, WhatsappProductCarouselCard, WhatsappProductListSection, WhatsappTemplateComponent } from '@botonic/shared';
+import { BotServerMessageAudio, BotServerMessageButtonMessage, BotServerMessageCarousel, BotServerMessageCustom, BotServerMessageDocument, BotServerMessageImage, BotServerMessageLocation, BotServerMessageText, BotServerMessageTypingEvent, BotServerMessageVideo, BotServerMessageWebchatClientSettings, BotServerMessageWhatsappButtonList, BotServerMessageWhatsappCatalog, BotServerMessageWhatsappCTAUrlButton, BotServerMessageWhatsappMediaCarousel, BotServerMessageWhatsappProduct, BotServerMessageWhatsappProductCarousel, BotServerMessageWhatsappProductList, BotServerMessageWhatsappTemplate } from './bot-server-message';
+import { BotonicContext } from './botonic-context';
+interface WebviewButtonParams {
+    title: string;
+    webview: string;
+    params?: Record<string, string>;
+}
+export declare class BotServerMessageFactory {
+    static createText({ text, payload, metadata, }: {
+        text: string;
+        payload?: string;
+        metadata?: BotMessageMetadata;
+    }): BotServerMessageText;
+    static createAudio({ attachmentUrl, attachmentContent, caption, fileInfo, metadata, }: {
+        attachmentUrl: string;
+        attachmentContent?: string;
+        caption?: string;
+        fileInfo?: Record<string, unknown>;
+        metadata?: BotMessageMetadata;
+    }): BotServerMessageAudio;
+    static createImage({ attachmentUrl, attachmentContent, caption, fileInfo, metadata, }: {
+        attachmentUrl: string;
+        attachmentContent?: string;
+        caption?: string;
+        fileInfo?: Record<string, unknown>;
+        metadata?: BotMessageMetadata;
+    }): BotServerMessageImage;
+    static createVideo({ attachmentUrl, attachmentContent, caption, fileInfo, metadata, }: {
+        attachmentUrl: string;
+        attachmentContent?: string;
+        caption?: string;
+        fileInfo?: Record<string, unknown>;
+        metadata?: BotMessageMetadata;
+    }): BotServerMessageVideo;
+    static createDocument({ attachmentUrl, attachmentContent, caption, fileInfo, metadata, }: {
+        attachmentUrl: string;
+        attachmentContent?: string;
+        caption?: string;
+        fileInfo?: Record<string, unknown>;
+        metadata?: BotMessageMetadata;
+    }): BotServerMessageDocument;
+    static createLocation({ latitude, longitude, title, address, metadata, }: {
+        latitude: number;
+        longitude: number;
+        title?: string;
+        address?: string;
+        metadata?: BotMessageMetadata;
+    }): BotServerMessageLocation;
+    static createButtonMessage({ text, buttons, metadata, }: {
+        text: string;
+        buttons: BotonicButtonContent[];
+        metadata?: BotMessageMetadata;
+    }): BotServerMessageButtonMessage;
+    static createCarousel({ elements, text, metadata, }: {
+        elements: BotonicCarouselElement[];
+        text?: string;
+        metadata?: BotMessageMetadata;
+    }): BotServerMessageCarousel;
+    static createCustom({ name, props, metadata, }: {
+        name: string;
+        props: Record<string, unknown>;
+        metadata?: BotMessageMetadata;
+    }): BotServerMessageCustom;
+    static createTypingEvent({ eventName, metadata, }: {
+        eventName: TypingEventName;
+        metadata?: BotMessageMetadata;
+    }): BotServerMessageTypingEvent;
+    /** Payload type `webchat_client_settings` for Hubtype `send_messages` (v2 bots). */
+    static createWebchatClientSettings({ settings, metadata, }: {
+        settings: Partial<WebchatClientSettings> | WebchatClientSettings;
+        metadata?: BotMessageMetadata;
+    }): BotServerMessageWebchatClientSettings;
+    /**
+     * Creates a postback button that sends a payload when clicked
+     */
+    static createPostbackButton({ title, payload, }: {
+        title: string;
+        payload: string;
+    }): BotonicButtonContent;
+    /**
+     * Creates a URL button that opens a link in the browser
+     */
+    static createUrlButton({ title, url, }: {
+        title: string;
+        url: string;
+    }): BotonicButtonContent;
+    /**
+     * Creates a webview button that opens a URL in a webview.
+     * Uses `settings.STATIC_URL` (Lambda settings), not `process.env`.
+     */
+    static createWebviewButton(webviewButtonParams: WebviewButtonParams, botonicContext: BotonicContext): BotonicButtonContent;
+    /**
+     * Helper method to create a carousel element
+     * This simplifies carousel element creation
+     */
+    static createCarouselElement({ title, subtitle, image, buttons, }: {
+        title: string;
+        subtitle: string;
+        image: string;
+        buttons: BotonicButtonContent[];
+    }): BotonicCarouselElement;
+    static createWhatsappButtonList({ header, body, footer, button, sections, metadata, }: {
+        header?: string;
+        body: string;
+        footer?: string;
+        button: string;
+        sections: WhatsappButtonListSection[];
+        metadata?: BotMessageMetadata;
+    }): BotServerMessageWhatsappButtonList;
+    static createWhatsappCTAUrlButton({ headerType, header, headerImage, headerDocument, headerVideo, body, url, displayText, footer, metadata, }: {
+        headerType?: WhatsappHeaderType;
+        header?: string;
+        headerImage?: string;
+        headerDocument?: string;
+        headerVideo?: string;
+        body: string;
+        url: string;
+        displayText: string;
+        footer?: string;
+        metadata?: BotMessageMetadata;
+    }): BotServerMessageWhatsappCTAUrlButton;
+    static createWhatsappCatalog({ body, footer, thumbnailProductId, metadata, }: {
+        body: string;
+        footer?: string;
+        thumbnailProductId?: string;
+        metadata?: BotMessageMetadata;
+    }): BotServerMessageWhatsappCatalog;
+    static createWhatsappProduct({ body, catalogId, productId, footer, metadata, }: {
+        body: string;
+        catalogId: string;
+        productId: string;
+        footer?: string;
+        metadata?: BotMessageMetadata;
+    }): BotServerMessageWhatsappProduct;
+    static createWhatsappProductList({ header, body, footer, catalogId, sections, metadata, }: {
+        body: string;
+        catalogId: string;
+        header: string;
+        sections: WhatsappProductListSection[];
+        footer?: string;
+        metadata?: BotMessageMetadata;
+    }): BotServerMessageWhatsappProductList;
+    static createWhatsappProductCarousel({ templateName, templateLanguage, cards, bodyParameters, metadata, }: {
+        templateName: string;
+        templateLanguage: string;
+        cards: WhatsappProductCarouselCard[];
+        bodyParameters?: Record<string, any>[];
+        metadata?: BotMessageMetadata;
+    }): BotServerMessageWhatsappProductCarousel;
+    static createWhatsappMediaCarousel({ templateName, templateLanguage, cards, bodyParameters, metadata, }: {
+        templateName: string;
+        templateLanguage: string;
+        cards: WhatsappMediaCarouselCard[];
+        bodyParameters?: Record<string, any>[];
+        metadata?: BotMessageMetadata;
+    }): BotServerMessageWhatsappMediaCarousel;
+    static createWhatsappTemplate({ name, namespace, languageCode, components, metadata, }: {
+        name: string;
+        namespace: string;
+        languageCode: string;
+        components: WhatsappTemplateComponent[];
+        metadata?: BotMessageMetadata;
+    }): BotServerMessageWhatsappTemplate;
+}
+export {};

package/src/lib/server/factory.js

@@ -0,0 +1,192 @@
+import { BotonicOutputAudioData, BotonicOutputDocumentData, BotonicOutputImageData, BotonicOutputVideoData, } from '@botonic/shared';
+import { BotonicButtonMessageData, BotonicButtonType, BotonicCarouselData, BotonicCustomData, BotonicLocationData, BotonicTextData, BotonicTypingEventData, } from '@botonic/shared';
+import { WebchatClientSettings } from '@botonic/shared';
+import { BotonicWhatsappButtonListData, BotonicWhatsappCatalogData, BotonicWhatsappCTAUrlButtonData, BotonicWhatsappMediaCarouselData, BotonicWhatsappProductCarouselData, BotonicWhatsappProductData, BotonicWhatsappProductListData, BotonicWhatsappTemplateData, } from '@botonic/shared';
+import { BotServerMessageAudio, BotServerMessageButtonMessage, BotServerMessageCarousel, BotServerMessageCustom, BotServerMessageDocument, BotServerMessageImage, BotServerMessageLocation, BotServerMessageText, BotServerMessageTypingEvent, BotServerMessageVideo, BotServerMessageWebchatClientSettings, BotServerMessageWhatsappButtonList, BotServerMessageWhatsappCatalog, BotServerMessageWhatsappCTAUrlButton, BotServerMessageWhatsappMediaCarousel, BotServerMessageWhatsappProduct, BotServerMessageWhatsappProductCarousel, BotServerMessageWhatsappProductList, BotServerMessageWhatsappTemplate, } from './bot-server-message';
+export class BotServerMessageFactory {
+    static createText({ text, payload, metadata, }) {
+        return new BotServerMessageText(new BotonicTextData(text, payload), metadata);
+    }
+    static createAudio({ attachmentUrl, attachmentContent, caption, fileInfo, metadata, }) {
+        return new BotServerMessageAudio(new BotonicOutputAudioData({
+            attachment_url: attachmentUrl,
+            attachment_content: attachmentContent,
+            caption: caption,
+            file_info: fileInfo,
+        }), metadata);
+    }
+    static createImage({ attachmentUrl, attachmentContent, caption, fileInfo, metadata, }) {
+        return new BotServerMessageImage(new BotonicOutputImageData({
+            attachment_url: attachmentUrl,
+            attachment_content: attachmentContent,
+            caption: caption,
+            file_info: fileInfo,
+        }), metadata);
+    }
+    static createVideo({ attachmentUrl, attachmentContent, caption, fileInfo, metadata, }) {
+        return new BotServerMessageVideo(new BotonicOutputVideoData({
+            attachment_url: attachmentUrl,
+            attachment_content: attachmentContent,
+            caption: caption,
+            file_info: fileInfo,
+        }), metadata);
+    }
+    static createDocument({ attachmentUrl, attachmentContent, caption, fileInfo, metadata, }) {
+        return new BotServerMessageDocument(new BotonicOutputDocumentData({
+            attachment_url: attachmentUrl,
+            attachment_content: attachmentContent,
+            caption: caption,
+            file_info: fileInfo,
+        }), metadata);
+    }
+    static createLocation({ latitude, longitude, title, address, metadata, }) {
+        return new BotServerMessageLocation(new BotonicLocationData(latitude, longitude, title, address), metadata);
+    }
+    static createButtonMessage({ text, buttons, metadata, }) {
+        return new BotServerMessageButtonMessage(new BotonicButtonMessageData(text, buttons), metadata);
+    }
+    static createCarousel({ elements, text, metadata, }) {
+        return new BotServerMessageCarousel(new BotonicCarouselData(elements, text), metadata);
+    }
+    static createCustom({ name, props, metadata, }) {
+        return new BotServerMessageCustom(new BotonicCustomData(name, props), metadata);
+    }
+    static createTypingEvent({ eventName, metadata, }) {
+        return new BotServerMessageTypingEvent(new BotonicTypingEventData(eventName), metadata);
+    }
+    /** Payload type `webchat_client_settings` for Hubtype `send_messages` (v2 bots). */
+    static createWebchatClientSettings({ settings, metadata, }) {
+        const data = settings instanceof WebchatClientSettings
+            ? settings
+            : new WebchatClientSettings(settings);
+        return new BotServerMessageWebchatClientSettings(data, metadata);
+    }
+    /**
+     * Creates a postback button that sends a payload when clicked
+     */
+    static createPostbackButton({ title, payload, }) {
+        return { type: BotonicButtonType.Postback, title, payload };
+    }
+    /**
+     * Creates a URL button that opens a link in the browser
+     */
+    static createUrlButton({ title, url, }) {
+        return { type: BotonicButtonType.WebUrl, title, url };
+    }
+    /**
+     * Creates a webview button that opens a URL in a webview.
+     * Uses `settings.STATIC_URL` (Lambda settings), not `process.env`.
+     */
+    static createWebviewButton(webviewButtonParams, botonicContext) {
+        const { title, webview, params } = webviewButtonParams;
+        const staticUrl = resolveStaticUrl(botonicContext.settings);
+        if (!staticUrl) {
+            throw new Error('STATIC_URL is missing from bot context settings (required for webview buttons)');
+        }
+        const base = staticUrl.replace(/\/+$/, '');
+        const url = new URL(`${base}/webviews/${webview}`);
+        url.searchParams.set('user_id', botonicContext.session.user.id);
+        url.searchParams.set('bot_id', botonicContext.session.bot.id);
+        url.searchParams.set('hubtype_api_url', botonicContext.settings.hubtypeApiUrl);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                url.searchParams.set(key, String(value));
+            }
+        }
+        return {
+            type: BotonicButtonType.WebUrl,
+            title,
+            url: url.toString(),
+        };
+    }
+    /**
+     * Helper method to create a carousel element
+     * This simplifies carousel element creation
+     */
+    static createCarouselElement({ title, subtitle, image, buttons, }) {
+        return {
+            title,
+            subtitle,
+            image,
+            buttons,
+        };
+    }
+    static createWhatsappButtonList({ header, body, footer, button, sections, metadata, }) {
+        return new BotServerMessageWhatsappButtonList(new BotonicWhatsappButtonListData({
+            header,
+            body,
+            footer,
+            button,
+            sections,
+        }), metadata);
+    }
+    static createWhatsappCTAUrlButton({ headerType, header, headerImage, headerDocument, headerVideo, body, url, displayText, footer, metadata, }) {
+        return new BotServerMessageWhatsappCTAUrlButton(new BotonicWhatsappCTAUrlButtonData({
+            header_type: headerType,
+            header,
+            header_image: headerImage,
+            header_document: headerDocument,
+            header_video: headerVideo,
+            body,
+            url,
+            display_text: displayText,
+            footer,
+        }), metadata);
+    }
+    static createWhatsappCatalog({ body, footer, thumbnailProductId, metadata, }) {
+        return new BotServerMessageWhatsappCatalog(new BotonicWhatsappCatalogData({
+            body,
+            footer,
+            thumbnail_product_id: thumbnailProductId,
+        }), metadata);
+    }
+    static createWhatsappProduct({ body, catalogId, productId, footer, metadata, }) {
+        return new BotServerMessageWhatsappProduct(new BotonicWhatsappProductData({
+            body,
+            catalog_id: catalogId,
+            product_id: productId,
+            footer,
+        }), metadata);
+    }
+    static createWhatsappProductList({ header, body, footer, catalogId, sections, metadata, }) {
+        return new BotServerMessageWhatsappProductList(new BotonicWhatsappProductListData({
+            body,
+            catalog_id: catalogId,
+            header,
+            sections,
+            footer,
+        }), metadata);
+    }
+    static createWhatsappProductCarousel({ templateName, templateLanguage, cards, bodyParameters, metadata, }) {
+        return new BotServerMessageWhatsappProductCarousel(new BotonicWhatsappProductCarouselData({
+            template_name: templateName,
+            template_language: templateLanguage,
+            cards,
+            body_parameters: bodyParameters,
+        }), metadata);
+    }
+    static createWhatsappMediaCarousel({ templateName, templateLanguage, cards, bodyParameters, metadata, }) {
+        return new BotServerMessageWhatsappMediaCarousel(new BotonicWhatsappMediaCarouselData({
+            template_name: templateName,
+            template_language: templateLanguage,
+            cards,
+            body_parameters: bodyParameters,
+        }), metadata);
+    }
+    static createWhatsappTemplate({ name, namespace, languageCode, components, metadata, }) {
+        return new BotServerMessageWhatsappTemplate(new BotonicWhatsappTemplateData({
+            name,
+            namespace,
+            language_code: languageCode,
+            components,
+        }), metadata);
+    }
+}
+const resolveStaticUrl = (settings) => {
+    // This has to be defined in developers template.yaml (Local Development)
+    if (process.env.AWS_SAM_LOCAL === 'true') {
+        return process.env.STATIC_URL;
+    }
+    return settings.staticUrl;
+};
+//# sourceMappingURL=factory.js.map

package/src/lib/server/factory.js.map

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

package/src/lib/server/index.d.ts

@@ -0,0 +1,3 @@
+export * from './bot-server-message';
+export * from './botonic-context';
+export * from './factory';

package/src/lib/server/index.js

@@ -0,0 +1,4 @@
+export * from './bot-server-message';
+export * from './botonic-context';
+export * from './factory';
+//# sourceMappingURL=index.js.map

package/src/lib/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/botonic/core/src/lib/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA"}

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

@@ -0,0 +1,13 @@
+import type { BotonicSession, BotonicWebviewsSession, UserExtraData } from '@botonic/shared';
+import { type BotonicContext, type BotonicSessionPatchSlice, type BotonicSessionUpdate, type BotServerMessage, type ChatUserPatchResponse, type HandoffOptions, type ResolvedPlugins } from '../server';
+import { type GetBotonicWebviewsSessionParams } from './hubtype-external-api-client';
+export declare class HubtypeApiService {
+    updateBotSession<TExtraData extends UserExtraData = UserExtraData>(botonicContext: BotonicContext<ResolvedPlugins, TExtraData>, updates: BotonicSessionUpdate<TExtraData>): Promise<void>;
+    getBotonicSession(botonicContext: BotonicContext<ResolvedPlugins, UserExtraData>): Promise<BotonicSession<UserExtraData> | null>;
+    getBotSession(botonicContext: BotonicContext<ResolvedPlugins, UserExtraData>): Promise<BotonicSession<UserExtraData>>;
+    patchBotonicSession(botonicContext: BotonicContext<ResolvedPlugins, UserExtraData>, body: Record<string, unknown>): Promise<BotonicSessionPatchSlice>;
+    patchChatUser(botonicContext: BotonicContext<ResolvedPlugins, UserExtraData>, body: Record<string, unknown>): Promise<ChatUserPatchResponse>;
+    doHandoff(botonicContext: BotonicContext<ResolvedPlugins, UserExtraData>, handoffOptions?: HandoffOptions): Promise<unknown>;
+    sendMessages(botonicContext: BotonicContext<ResolvedPlugins, UserExtraData>, messages: BotServerMessage[]): Promise<unknown>;
+    getBotonicWebviewsSession(params: GetBotonicWebviewsSessionParams): Promise<BotonicWebviewsSession | null>;
+}

package/src/lib/services/hubtype-api-service.js

@@ -0,0 +1,67 @@
+import { __awaiter } from "tslib";
+import { applyNonPatchSessionUpdateFields, mergeBotonicSessionPatchSlice, mergeChatUserPatchResponseIntoSessionUser, sessionUpdateToPatchBody, userUpdateToChatUserPatchBody, } from '../server';
+import { HubtypeExternalApiClient, } from './hubtype-external-api-client';
+export class HubtypeApiService {
+    updateBotSession(botonicContext, updates) {
+        return __awaiter(this, void 0, void 0, function* () {
+            applyNonPatchSessionUpdateFields(botonicContext.session.raw, updates);
+            const client = new HubtypeExternalApiClient();
+            const sessionPatchBody = sessionUpdateToPatchBody(updates);
+            if (Object.keys(sessionPatchBody).length > 0) {
+                const slice = yield client.patchBotonicSession(botonicContext, sessionPatchBody);
+                mergeBotonicSessionPatchSlice(botonicContext.session.raw, slice);
+            }
+            const chatUserBody = userUpdateToChatUserPatchBody(updates.user);
+            if (Object.keys(chatUserBody).length > 0) {
+                const userSlice = yield client.patchChatUser(botonicContext, chatUserBody);
+                mergeChatUserPatchResponseIntoSessionUser(botonicContext.session.raw.user, userSlice);
+            }
+        });
+    }
+    getBotonicSession(botonicContext) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const client = new HubtypeExternalApiClient();
+            return client.getBotonicSession(botonicContext);
+        });
+    }
+    getBotSession(botonicContext) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const session = yield this.getBotonicSession(botonicContext);
+            if (session === null) {
+                throw new Error('Failed to get bot session');
+            }
+            return session;
+        });
+    }
+    patchBotonicSession(botonicContext, body) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const client = new HubtypeExternalApiClient();
+            return client.patchBotonicSession(botonicContext, body);
+        });
+    }
+    patchChatUser(botonicContext, body) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const client = new HubtypeExternalApiClient();
+            return client.patchChatUser(botonicContext, body);
+        });
+    }
+    doHandoff(botonicContext, handoffOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const client = new HubtypeExternalApiClient();
+            return client.doHandoff(botonicContext, handoffOptions);
+        });
+    }
+    sendMessages(botonicContext, messages) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const client = new HubtypeExternalApiClient();
+            return client.sendMessages(botonicContext, messages);
+        });
+    }
+    getBotonicWebviewsSession(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const client = new HubtypeExternalApiClient();
+            return client.getBotonicWebviewsSession(params);
+        });
+    }
+}
+//# sourceMappingURL=hubtype-api-service.js.map

package/src/lib/services/hubtype-api-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hubtype-api-service.js","sourceRoot":"","sources":["../../../../../../../libs/botonic/core/src/lib/services/hubtype-api-service.ts"],"names":[],"mappings":";AAKA,OAAO,EACL,gCAAgC,EAChC,6BAA6B,EAC7B,yCAAyC,EACzC,wBAAwB,EACxB,6BAA6B,GAQ9B,MAAM,WAAW,CAAA;AAClB,OAAO,EAEL,wBAAwB,GACzB,MAAM,+BAA+B,CAAA;AAEtC,MAAM,OAAO,iBAAiB;IACtB,gBAAgB,CACpB,cAA2D,EAC3D,OAAyC;;YAEzC,gCAAgC,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;YAErE,MAAM,MAAM,GAAG,IAAI,wBAAwB,EAAE,CAAA;YAC7C,MAAM,gBAAgB,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAA;YAC1D,IAAI,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7C,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAC5C,cAAgE,EAChE,gBAAgB,CACjB,CAAA;gBACD,6BAA6B,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YAClE,CAAC;YAED,MAAM,YAAY,GAAG,6BAA6B,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;YAChE,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzC,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,aAAa,CAC1C,cAAgE,EAChE,YAAY,CACb,CAAA;gBACD,yCAAyC,CACvC,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAC/B,SAAS,CACV,CAAA;YACH,CAAC;QACH,CAAC;KAAA;IAEK,iBAAiB,CACrB,cAA8D;;YAE9D,MAAM,MAAM,GAAG,IAAI,wBAAwB,EAAE,CAAA;YAC7C,OAAO,MAAM,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAA;QACjD,CAAC;KAAA;IAEK,aAAa,CACjB,cAA8D;;YAE9D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAA;YAC5D,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;YAC9C,CAAC;YACD,OAAO,OAAO,CAAA;QAChB,CAAC;KAAA;IAEK,mBAAmB,CACvB,cAA8D,EAC9D,IAA6B;;YAE7B,MAAM,MAAM,GAAG,IAAI,wBAAwB,EAAE,CAAA;YAC7C,OAAO,MAAM,CAAC,mBAAmB,CAAC,cAAc,EAAE,IAAI,CAAC,CAAA;QACzD,CAAC;KAAA;IAEK,aAAa,CACjB,cAA8D,EAC9D,IAA6B;;YAE7B,MAAM,MAAM,GAAG,IAAI,wBAAwB,EAAE,CAAA;YAC7C,OAAO,MAAM,CAAC,aAAa,CAAC,cAAc,EAAE,IAAI,CAAC,CAAA;QACnD,CAAC;KAAA;IAEK,SAAS,CACb,cAA8D,EAC9D,cAA+B;;YAE/B,MAAM,MAAM,GAAG,IAAI,wBAAwB,EAAE,CAAA;YAC7C,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,EAAE,cAAc,CAAC,CAAA;QACzD,CAAC;KAAA;IAEK,YAAY,CAChB,cAA8D,EAC9D,QAA4B;;YAE5B,MAAM,MAAM,GAAG,IAAI,wBAAwB,EAAE,CAAA;YAC7C,OAAO,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAA;QACtD,CAAC;KAAA;IAEK,yBAAyB,CAC7B,MAAuC;;YAEvC,MAAM,MAAM,GAAG,IAAI,wBAAwB,EAAE,CAAA;YAC7C,OAAO,MAAM,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAA;QACjD,CAAC;KAAA;CACF"}

package/src/lib/services/hubtype-external-api-client.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Hubtype external v2 conversational HTTP client (session, webviews, chat user, handoff, send message).
+ * Do not use legacy `…/context/` for v2 bots — see BE spec.
+ *
+ * @see openspec/specs/BE-botonic-v2-botonic-session-endpoints/spec.md
+ */
+import type { BotonicSession, BotonicWebviewsSession, UserExtraData } from '@botonic/shared';
+import type { BotonicContext, BotonicSessionPatchSlice, BotServerMessage, ChatUserPatchResponse, HandoffOptions, ResolvedPlugins } from '../server';
+/** Target for GET …/session/webviews/ (no auth on this endpoint). */
+export interface GetBotonicWebviewsSessionParams {
+    hubtypeApiUrl: string;
+    botId: string;
+    userId: string;
+}
+export declare class HubtypeExternalApiClient {
+    getBotonicSession<TSessionExtra extends UserExtraData = UserExtraData>(botonicContext: BotonicContext<ResolvedPlugins, UserExtraData>): Promise<BotonicSession<TSessionExtra> | null>;
+    patchBotonicSession(botonicContext: BotonicContext<ResolvedPlugins, UserExtraData>, body: Record<string, unknown>): Promise<BotonicSessionPatchSlice>;
+    getBotonicWebviewsSession(params: GetBotonicWebviewsSessionParams): Promise<BotonicWebviewsSession | null>;
+    patchChatUser(botonicContext: BotonicContext<ResolvedPlugins, UserExtraData>, body: Record<string, unknown>): Promise<ChatUserPatchResponse>;
+    doHandoff(botonicContext: BotonicContext<ResolvedPlugins, UserExtraData>, handoffOptions?: HandoffOptions): Promise<unknown>;
+    sendMessages(botonicContext: BotonicContext<ResolvedPlugins, UserExtraData>, messages: BotServerMessage[]): Promise<unknown>;
+}