@botonic/core 2.27.0 → 2.29.0

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 { BotonicSession, UserExtraData } from '@botonic/shared';
+import type { BotonicSecrets, BotonicSettings } from '@botonic/shared';
+import type { HubtypeApiService } from '../../services/hubtype-api-service';
+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>;
+}

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":"AAKA,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;AAGjD,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,182 @@
+import type { WebchatOutputRatingButton, WebchatOutputRatingRatingType } from '@botonic/shared';
+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;
+    /**
+     * Built-in webchat rating custom message (see {@link WEBCHAT_OUTPUT_RATING}).
+     * Callers must supply `payloads` — one postback per option, low → high (aligned with star/smiley order).
+     */
+    static createRating({ messageText, buttonText, ratingType, payloads, metadata, }: {
+        messageText: string;
+        buttonText: string;
+        ratingType: WebchatOutputRatingRatingType;
+        /** One entry per rating option; order does not matter — the client looks up by `value`. */
+        payloads?: WebchatOutputRatingButton[];
+        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 {};