@botonic/shared 2.26.0 → 2.28.0

package/CHANGELOG.md

@@ -1,3 +1,26 @@
+## 2.28.0 (2026-05-06)
+
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+
+## 2.27.0 (2026-04-29)
+
+### 🚀 Features
+
+- typing to work again and improve it with few modes when sending messages ([#831](https://github.com/metis-ai/hubtype-product/pull/831))
+- receiving db_id, bot_interaction_id and working capture_user_input_id and first_interaction updatable ([#822](https://github.com/metis-ai/hubtype-product/pull/822))
+- **BLT-2291:** wire file attachment through domain model and XState machines ([#816](https://github.com/metis-ai/hubtype-product/pull/816))
+- supporting isFirstInteraction editable by bot, with snapshot logic ([#815](https://github.com/metis-ai/hubtype-product/pull/815))
+- adapting botonic webviews ([#799](https://github.com/metis-ai/hubtype-product/pull/799))
+- **botonic:** session and Hubtype API adaptations (non-webviews) ([#810](https://github.com/metis-ai/hubtype-product/pull/810))
+- **BLT-2293:** send audio messages ([#804](https://github.com/metis-ai/hubtype-product/pull/804))
+- introduce new domain models ([#807](https://github.com/metis-ai/hubtype-product/pull/807))
+- set basis for webchat client settings ([#791](https://github.com/metis-ai/hubtype-product/pull/791))
+
+### ❤️ Thank You
+
+- David Hidalgo @Davidhidalgo
+- Marc Rabat @vanbasten17
+
 ## 2.26.0 (2026-03-31)
 
 This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
@@ -57,7 +80,7 @@ This was a version bump only for @botonic/shared to align it with other projects
 ### 🚀 Features
 
 - add legacy input to v2 input adapter and missing defs ([#680](https://github.com/metis-ai/hubtype-product/pull/680))
-- add BotonicContext (will substitute BotContext) ([#677](https://github.com/metis-ai/hubtype-product/pull/677))
+- add BotonicContext (will substitute BotonicContext) ([#677](https://github.com/metis-ai/hubtype-product/pull/677))
 
 ### ❤️ Thank You
 
@@ -253,4 +276,4 @@ This was a version bump only for @botonic/shared to align it with other projects
 
 ## 2.0.1-alpha.0 (2025-11-27)
 
-This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.
+This was a version bump only for @botonic/shared to align it with other projects, there were no code changes.

package/README.md

@@ -11,6 +11,15 @@ Shared types, helpers, and building blocks used by `@botonic/core`, plugins, and
 
 Match the **major version** of `@botonic/shared` to `@botonic/core` and other `@botonic/*` packages in your project.
 
+## Package boundaries (2.x)
+
+- **`@botonic/shared`** — Protocol types, enums, request API types, and shared utilities. Not the home for server/webchat/webview **runtime** classes.
+- **`@botonic/core`** — Server runtime: `BotonicContext`, plugins, `BotServerMessage` factories, routing helpers (`CoreBot`, routes, session helpers — same package entry).
+- **`@botonic/webchat-core`** — Webchat message runtime (`WebchatMessage`, factories, realtime wrappers).
+- **`@botonic/webviews`** — Webview session context (`BotonicContextWebviews`, factory).
+
+Import server runtime (`BotonicContext`, `BotServerMessageFactory`, plugins) from **`@botonic/core`**, webchat message classes from **`@botonic/webchat-core`**, and webview context from **`@botonic/webviews`** — not from `@botonic/shared`.
+
 ## Installation
 
 ```bash

package/package.json

@@ -1,12 +1,11 @@
 {
   "name": "@botonic/shared",
-  "version": "2.26.0",
+  "version": "2.28.0",
   "type": "module",
   "module": "./src/index.js",
   "types": "./src/index.d.ts",
   "dependencies": {
     "tslib": "^2.3.0",
-    "uuid": "^11.1.0",
     "vite": "7.1.9"
   },
   "publishConfig": {

package/src/lib/domain/botonic/index.d.ts

@@ -1,9 +1,10 @@
-export * from '../server/botonic-context';
-export * from '../server/botonic-context/botonic-context-input';
-export * from '../server/botonic-context/botonic-context-session';
+export * from './exceptions';
 export * from './inputs';
-export * from './legacy';
 export * from './metadata';
 export * from './outputs';
+export * from './session';
+export * from './settings';
 export * from './types';
+export * from './webchat-client-settings';
+export * from './webviews-session';
 export * from './whatsapp-outputs';

package/src/lib/domain/botonic/index.js

@@ -1,10 +1,11 @@
-export * from '../server/botonic-context';
-export * from '../server/botonic-context/botonic-context-input';
-export * from '../server/botonic-context/botonic-context-session';
+export * from './exceptions';
 export * from './inputs';
-export * from './legacy';
 export * from './metadata';
 export * from './outputs';
+export * from './session';
+export * from './settings';
 export * from './types';
+export * from './webchat-client-settings';
+export * from './webviews-session';
 export * from './whatsapp-outputs';
 //# sourceMappingURL=index.js.map

package/src/lib/domain/botonic/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../libs/botonic/shared/src/lib/domain/botonic/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAA;AACzC,cAAc,iDAAiD,CAAA;AAC/D,cAAc,mDAAmD,CAAA;AACjE,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../libs/botonic/shared/src/lib/domain/botonic/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,2BAA2B,CAAA;AACzC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA"}

package/src/lib/domain/botonic/outputs.d.ts

@@ -1,6 +1,9 @@
-import { BotonicAttachmentData, BotonicButtonMessageData, BotonicCarouselData, BotonicCustomData, BotonicLocationData, BotonicTextData, BotonicTypingEventData, MessageType } from './types';
-import { BotonicWhatsappButtonListData, BotonicWhatsappCatalogData, BotonicWhatsappCTAUrlButtonData, BotonicWhatsappMediaCarouselData, BotonicWhatsappProductCarouselData, BotonicWhatsappProductData, BotonicWhatsappProductListData, BotonicWhatsappTemplateData } from './whatsapp-outputs';
-export type OutputMessageType = MessageType.Text | MessageType.Audio | MessageType.Image | MessageType.Video | MessageType.Document | MessageType.Location | MessageType.ButtonMessage | MessageType.Carousel | MessageType.Custom | MessageType.TypingEvent | MessageType.WhatsappTemplate | MessageType.WhatsappButtonList | MessageType.WhatsappCTAUrlButton | MessageType.WhatsappCatalog | MessageType.WhatsappProduct | MessageType.WhatsappProductList | MessageType.WhatsappProductCarousel | MessageType.WhatsappMediaCarousel;
+import type { BotonicButtonMessageData, BotonicCarouselData, BotonicCustomData, BotonicLocationData, BotonicTextData, BotonicTypingEventData } from './types';
+import { BotonicAttachmentData } from './types';
+import { MessageType } from './types';
+import type { WebchatClientSettings } from './webchat-client-settings';
+import type { BotonicWhatsappButtonListData, BotonicWhatsappCatalogData, BotonicWhatsappCTAUrlButtonData, BotonicWhatsappMediaCarouselData, BotonicWhatsappProductCarouselData, BotonicWhatsappProductData, BotonicWhatsappProductListData, BotonicWhatsappTemplateData } from './whatsapp-outputs';
+export type OutputMessageType = MessageType.Text | MessageType.Audio | MessageType.Image | MessageType.Video | MessageType.Document | MessageType.Location | MessageType.ButtonMessage | MessageType.Carousel | MessageType.Custom | MessageType.TypingEvent | MessageType.WhatsappTemplate | MessageType.WhatsappButtonList | MessageType.WhatsappCTAUrlButton | MessageType.WhatsappCatalog | MessageType.WhatsappProduct | MessageType.WhatsappProductList | MessageType.WhatsappProductCarousel | MessageType.WhatsappMediaCarousel | MessageType.WebchatClientSettings;
 export type BotonicOutputAttachmentExtraFields = {
     file_info?: Record<string, unknown>;
     caption?: string;
@@ -38,6 +41,7 @@ export type OutputMessageTypeMap = {
     [MessageType.WhatsappProductList]: BotonicWhatsappProductListData;
     [MessageType.WhatsappProductCarousel]: BotonicWhatsappProductCarouselData;
     [MessageType.WhatsappMediaCarousel]: BotonicWhatsappMediaCarouselData;
+    [MessageType.WebchatClientSettings]: WebchatClientSettings;
 };
 export declare abstract class BotonicOutput<T extends keyof OutputMessageTypeMap = keyof OutputMessageTypeMap> {
     readonly type: T;
@@ -98,4 +102,7 @@ export declare class BotonicOutputWhatsappProductCarousel extends BotonicOutput<
 export declare class BotonicOutputWhatsappMediaCarousel extends BotonicOutput<MessageType.WhatsappMediaCarousel> {
     constructor(data: BotonicWhatsappMediaCarouselData);
 }
-export type BotonicOutputType = BotonicOutputText | BotonicOutputAudio | BotonicOutputImage | BotonicOutputVideo | BotonicOutputDocument | BotonicOutputLocation | BotonicOutputButtonMessage | BotonicOutputCarousel | BotonicOutputCustom | BotonicOutputTypingEvent | BotonicOutputWhatsappTemplate | BotonicOutputWhatsappButtonList | BotonicOutputWhatsappCTAUrlButton | BotonicOutputWhatsappCatalog | BotonicOutputWhatsappProduct | BotonicOutputWhatsappProductList | BotonicOutputWhatsappProductCarousel | BotonicOutputWhatsappMediaCarousel;
+export declare class BotonicOutputWebchatClientSettings extends BotonicOutput<MessageType.WebchatClientSettings> {
+    constructor(data: WebchatClientSettings);
+}
+export type BotonicOutputType = BotonicOutputText | BotonicOutputAudio | BotonicOutputImage | BotonicOutputVideo | BotonicOutputDocument | BotonicOutputLocation | BotonicOutputButtonMessage | BotonicOutputCarousel | BotonicOutputCustom | BotonicOutputTypingEvent | BotonicOutputWhatsappTemplate | BotonicOutputWhatsappButtonList | BotonicOutputWhatsappCTAUrlButton | BotonicOutputWhatsappCatalog | BotonicOutputWhatsappProduct | BotonicOutputWhatsappProductList | BotonicOutputWhatsappProductCarousel | BotonicOutputWhatsappMediaCarousel | BotonicOutputWebchatClientSettings;

package/src/lib/domain/botonic/outputs.js

@@ -1,4 +1,5 @@
-import { BotonicAttachmentData, MessageType, } from './types';
+import { BotonicAttachmentData } from './types';
+import { MessageType } from './types';
 export class BotonicOutputAttachmentData extends BotonicAttachmentData {
     constructor(data) {
         super(data.attachment_url, data.attachment_content);
@@ -116,4 +117,9 @@ export class BotonicOutputWhatsappMediaCarousel extends BotonicOutput {
         super(MessageType.WhatsappMediaCarousel, data);
     }
 }
+export class BotonicOutputWebchatClientSettings extends BotonicOutput {
+    constructor(data) {
+        super(MessageType.WebchatClientSettings, data);
+    }
+}
 //# sourceMappingURL=outputs.js.map

package/src/lib/domain/botonic/outputs.js.map

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

package/src/lib/domain/botonic/session.d.ts

@@ -0,0 +1,63 @@
+import type { MessagingChannel } from '../../shared-types';
+import type { WebchatClientSettings } from './webchat-client-settings';
+export type UserExtraData = Record<string, any>;
+interface BotonicSessionBasicEntity {
+    id: string;
+    name: string;
+}
+export type BotonicSessionOrganization = BotonicSessionBasicEntity;
+export type BotonicSessionBot = BotonicSessionBasicEntity;
+export interface BotonicSessionChannel {
+    provider: MessagingChannel;
+    imp_id: string;
+    unformatted_phone_number: string;
+}
+export interface BotonicSessionHubtypeCaseContactReason {
+    id: string;
+    name: string;
+    category?: string;
+    project_id?: string;
+}
+export interface BotonicSessionUserContactInfoItem {
+    name: string;
+    type: string;
+    value: string;
+    description?: string;
+}
+export interface BotonicSessionHubtypeCase {
+    id: string;
+    after_hubtype_handoff_payload?: string;
+    case_resolution?: string;
+    contact_reasons?: BotonicSessionHubtypeCaseContactReason[];
+}
+export interface BotonicSessionUser<TExtraData extends UserExtraData = UserExtraData> {
+    id: string;
+    provider_id: string;
+    username?: string;
+    name?: string;
+    override_name?: string;
+    extra_data?: TExtraData;
+    contact_info?: BotonicSessionUserContactInfoItem[];
+    locale: string;
+    country: string;
+    system_locale: string;
+}
+export interface BotonicSession<TExtraData extends UserExtraData = UserExtraData> {
+    organization: BotonicSessionOrganization;
+    bot: BotonicSessionBot;
+    channel: BotonicSessionChannel;
+    user: BotonicSessionUser<TExtraData>;
+    is_test_integration: boolean;
+    is_first_interaction: boolean;
+    shadowing?: boolean;
+    flow_thread_id?: string;
+    had_hubtype_handoff?: boolean;
+    hubtype_case?: BotonicSessionHubtypeCase;
+    custom?: Record<string, any>;
+    external?: Record<string, any>;
+    webviews_custom?: Record<string, any>;
+    webchat_client_settings?: WebchatClientSettings;
+    /** Flow Builder: node id capturing user input (snake_case in API JSON). `null` clears. */
+    capture_user_input_node_id?: string | null;
+}
+export {};

package/src/lib/domain/botonic/session.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session.js.map

package/src/lib/domain/botonic/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../../../../../../libs/botonic/shared/src/lib/domain/botonic/session.ts"],"names":[],"mappings":""}

package/src/lib/domain/botonic/settings.d.ts

@@ -0,0 +1,18 @@
+/** Lambda `settings` object shape (subset), aligned with backend `BotonicSettings.model_dump`. */
+export interface BotonicSettings {
+    HUBTYPE_API_URL: string;
+    FLOW_BUILDER_API_URL?: string;
+    STATIC_URL?: string;
+    LITELLM_API_URL?: string;
+    AZURE_OPENAI_API_BASE?: string;
+    AZURE_OPENAI_API_VERSION?: string;
+    CUSTOM_SHORT_URL_HOST?: string;
+    custom?: Record<string, any>;
+}
+/** Lambda `secrets` object shape (subset), aligned with backend `BotonicSecrets.model_dump`. */
+export interface BotonicSecrets {
+    HUBTYPE_ACCESS_TOKEN: string;
+    LITELLM_API_KEY?: string;
+    AZURE_OPENAI_API_KEY?: string;
+    custom?: Record<string, any>;
+}

package/src/lib/domain/botonic/settings.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=settings.js.map

package/src/lib/domain/botonic/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../../../../../../../libs/botonic/shared/src/lib/domain/botonic/settings.ts"],"names":[],"mappings":""}

package/src/lib/domain/botonic/types.d.ts

@@ -1,3 +1,4 @@
+import { WebchatClientSettings } from './webchat-client-settings';
 import { BotonicWhatsappButtonListData, BotonicWhatsappCatalogData, BotonicWhatsappCTAUrlButtonData, BotonicWhatsappMediaCarouselData, BotonicWhatsappProductCarouselData, BotonicWhatsappProductData, BotonicWhatsappProductListData, BotonicWhatsappTemplateData } from './whatsapp-outputs';
 export declare enum MessageType {
     Text = "text",
@@ -19,7 +20,8 @@ export declare enum MessageType {
     WhatsappProduct = "whatsapp_product",
     WhatsappProductList = "whatsapp_product_list",
     WhatsappProductCarousel = "whatsapp_product_carousel",
-    WhatsappMediaCarousel = "whatsapp_media_carousel"
+    WhatsappMediaCarousel = "whatsapp_media_carousel",
+    WebchatClientSettings = "webchat_client_settings"
 }
 export declare class BotonicTextData {
     text: string;
@@ -35,7 +37,10 @@ export declare abstract class BotonicAttachmentData {
     attachment_url?: string | undefined;
     attachment_content?: string | undefined;
     caption?: string | undefined;
-    constructor(attachment_url?: string | undefined, attachment_content?: string | undefined, caption?: string | undefined);
+    mime_type?: string | undefined;
+    filename?: string | undefined;
+    constructor(attachment_url?: string | undefined, attachment_content?: string | undefined, caption?: string | undefined, mime_type?: string | undefined, filename?: string | undefined);
+    getMediaSrc(): string;
 }
 export declare class BotonicAudioData extends BotonicAttachmentData {
 }
@@ -106,4 +111,4 @@ export declare class BotonicContactData {
     vcard?: string | undefined;
     constructor(first_name: string, last_name?: string | undefined, phone_number?: string | undefined, vcard?: string | undefined);
 }
-export type BotonicData = BotonicTextData | BotonicPostbackData | BotonicAudioData | BotonicImageData | BotonicVideoData | BotonicDocumentData | BotonicLocationData | BotonicContactData | BotonicTypingEventData | BotonicButtonMessageData | BotonicCarouselData | BotonicCustomData | BotonicContactData | BotonicWhatsappButtonListData | BotonicWhatsappCatalogData | BotonicWhatsappCTAUrlButtonData | BotonicWhatsappMediaCarouselData | BotonicWhatsappProductCarouselData | BotonicWhatsappProductData | BotonicWhatsappProductListData | BotonicWhatsappTemplateData;
+export type BotonicData = BotonicTextData | BotonicPostbackData | BotonicAudioData | BotonicImageData | BotonicVideoData | BotonicDocumentData | BotonicLocationData | BotonicContactData | BotonicTypingEventData | BotonicButtonMessageData | BotonicCarouselData | BotonicCustomData | BotonicContactData | BotonicWhatsappButtonListData | BotonicWhatsappCatalogData | BotonicWhatsappCTAUrlButtonData | BotonicWhatsappMediaCarouselData | BotonicWhatsappProductCarouselData | BotonicWhatsappProductData | BotonicWhatsappProductListData | BotonicWhatsappTemplateData | WebchatClientSettings;

package/src/lib/domain/botonic/types.js

@@ -25,6 +25,7 @@ export var MessageType;
     MessageType["WhatsappProductList"] = "whatsapp_product_list";
     MessageType["WhatsappProductCarousel"] = "whatsapp_product_carousel";
     MessageType["WhatsappMediaCarousel"] = "whatsapp_media_carousel";
+    MessageType["WebchatClientSettings"] = "webchat_client_settings";
 })(MessageType || (MessageType = {}));
 // ============================================================================
 // BOTONIC DATA UNITS
@@ -42,14 +43,20 @@ export class BotonicPostbackData {
     }
 }
 export class BotonicAttachmentData {
-    constructor(attachment_url, attachment_content, caption) {
+    constructor(attachment_url, attachment_content, caption, mime_type, filename) {
         this.attachment_url = attachment_url;
         this.attachment_content = attachment_content;
         this.caption = caption;
+        this.mime_type = mime_type;
+        this.filename = filename;
         if (!attachment_url && !attachment_content) {
             throw new BotonicMissingAttachmentUrlOrContentException();
         }
     }
+    getMediaSrc() {
+        var _a, _b;
+        return (_b = (_a = this.attachment_url) !== null && _a !== void 0 ? _a : this.attachment_content) !== null && _b !== void 0 ? _b : '';
+    }
 }
 export class BotonicAudioData extends BotonicAttachmentData {
 }

package/src/lib/domain/botonic/types.js.map

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

package/src/lib/domain/botonic/webchat-client-settings.d.ts

@@ -0,0 +1,22 @@
+export interface WebchatClientSettingsBlockInput {
+    message?: string;
+    regex?: string;
+}
+export declare class WebchatClientSettings {
+    readonly block_inputs: WebchatClientSettingsBlockInput[];
+    readonly user_input_enabled: boolean;
+    readonly attachments_enabled: boolean;
+    readonly emoji_picker_enabled: boolean;
+    readonly custom: Record<string, unknown>;
+    constructor(data?: Partial<WebchatClientSettings>);
+}
+export declare const DEFAULT_WEBCHAT_CLIENT_SETTINGS: WebchatClientSettings;
+export declare const UPDATE_WEBCHAT_CLIENT_SETTINGS_PAYLOAD = "update-webchat-client-settings";
+export interface UpdateWebchatClientSettingsPayload {
+    settings: Partial<WebchatClientSettings>;
+}
+export declare function isUpdateWebchatClientSettingsPayload(payload?: string): boolean;
+export declare function createUpdateWebchatClientSettingsPayload(settings: Partial<WebchatClientSettings>): string;
+export declare function parseUpdateWebchatClientSettingsPayload(payload: string): UpdateWebchatClientSettingsPayload;
+/** Merges two settings into a new instance; `custom` keys are deep-merged. */
+export declare function mergeWebchatClientSettings(current: WebchatClientSettings, incoming: WebchatClientSettings): WebchatClientSettings;

package/src/lib/domain/botonic/webchat-client-settings.js

@@ -0,0 +1,29 @@
+export class WebchatClientSettings {
+    constructor(data = {}) {
+        var _a, _b, _c, _d, _e;
+        this.block_inputs = (_a = data.block_inputs) !== null && _a !== void 0 ? _a : [];
+        this.user_input_enabled = (_b = data.user_input_enabled) !== null && _b !== void 0 ? _b : true;
+        this.attachments_enabled = (_c = data.attachments_enabled) !== null && _c !== void 0 ? _c : true;
+        this.emoji_picker_enabled = (_d = data.emoji_picker_enabled) !== null && _d !== void 0 ? _d : true;
+        this.custom = (_e = data.custom) !== null && _e !== void 0 ? _e : {};
+    }
+}
+export const DEFAULT_WEBCHAT_CLIENT_SETTINGS = new WebchatClientSettings();
+export const UPDATE_WEBCHAT_CLIENT_SETTINGS_PAYLOAD = 'update-webchat-client-settings';
+const PAYLOAD_PARAMS_SEPARATOR = '|';
+export function isUpdateWebchatClientSettingsPayload(payload) {
+    return Boolean(payload === null || payload === void 0 ? void 0 : payload.startsWith(`${UPDATE_WEBCHAT_CLIENT_SETTINGS_PAYLOAD}${PAYLOAD_PARAMS_SEPARATOR}`));
+}
+export function createUpdateWebchatClientSettingsPayload(settings) {
+    const payloadParams = { settings };
+    return `${UPDATE_WEBCHAT_CLIENT_SETTINGS_PAYLOAD}${PAYLOAD_PARAMS_SEPARATOR}${JSON.stringify(payloadParams)}`;
+}
+export function parseUpdateWebchatClientSettingsPayload(payload) {
+    const rawPayloadParams = payload.split(PAYLOAD_PARAMS_SEPARATOR)[1] || '{}';
+    return JSON.parse(rawPayloadParams);
+}
+/** Merges two settings into a new instance; `custom` keys are deep-merged. */
+export function mergeWebchatClientSettings(current, incoming) {
+    return new WebchatClientSettings(Object.assign(Object.assign(Object.assign({}, current), incoming), { custom: Object.assign(Object.assign({}, current.custom), incoming.custom) }));
+}
+//# sourceMappingURL=webchat-client-settings.js.map

package/src/lib/domain/botonic/webchat-client-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webchat-client-settings.js","sourceRoot":"","sources":["../../../../../../../../libs/botonic/shared/src/lib/domain/botonic/webchat-client-settings.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,qBAAqB;IAOhC,YAAY,OAAuC,EAAE;;QACnD,IAAI,CAAC,YAAY,GAAG,MAAA,IAAI,CAAC,YAAY,mCAAI,EAAE,CAAA;QAC3C,IAAI,CAAC,kBAAkB,GAAG,MAAA,IAAI,CAAC,kBAAkB,mCAAI,IAAI,CAAA;QACzD,IAAI,CAAC,mBAAmB,GAAG,MAAA,IAAI,CAAC,mBAAmB,mCAAI,IAAI,CAAA;QAC3D,IAAI,CAAC,oBAAoB,GAAG,MAAA,IAAI,CAAC,oBAAoB,mCAAI,IAAI,CAAA;QAC7D,IAAI,CAAC,MAAM,GAAG,MAAA,IAAI,CAAC,MAAM,mCAAI,EAAE,CAAA;IACjC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,+BAA+B,GAAG,IAAI,qBAAqB,EAAE,CAAA;AAE1E,MAAM,CAAC,MAAM,sCAAsC,GACjD,gCAAgC,CAAA;AAElC,MAAM,wBAAwB,GAAG,GAAG,CAAA;AAMpC,MAAM,UAAU,oCAAoC,CAClD,OAAgB;IAEhB,OAAO,OAAO,CACZ,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,UAAU,CACjB,GAAG,sCAAsC,GAAG,wBAAwB,EAAE,CACvE,CACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,wCAAwC,CACtD,QAAwC;IAExC,MAAM,aAAa,GAAuC,EAAE,QAAQ,EAAE,CAAA;IACtE,OAAO,GAAG,sCAAsC,GAAG,wBAAwB,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,CAAA;AAC/G,CAAC;AAED,MAAM,UAAU,uCAAuC,CACrD,OAAe;IAEf,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;IAC3E,OAAO,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAuC,CAAA;AAC3E,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,0BAA0B,CACxC,OAA8B,EAC9B,QAA+B;IAE/B,OAAO,IAAI,qBAAqB,+CAC3B,OAAO,GACP,QAAQ,KACX,MAAM,kCACD,OAAO,CAAC,MAAM,GACd,QAAQ,CAAC,MAAM,KAEpB,CAAA;AACJ,CAAC"}

package/src/lib/domain/botonic/webviews-session.d.ts

@@ -0,0 +1,20 @@
+import type { BotonicSessionBot, BotonicSessionChannel } from './session';
+/**
+ * GET …/session/webviews/ JSON from the backend.
+ * Channel and user are top-level fields (not nested under `session`).
+ * Use `BotonicContextWebviewsFactory.from` to normalize into a context with a nested `session`.
+ */
+export type BotonicWebviewsSessionChannel = BotonicSessionChannel;
+export type BotonicWebviewsSessionBot = BotonicSessionBot;
+export interface BotonicWebviewsSessionUser {
+    id: string;
+    locale: string;
+    country: string;
+    system_locale: string;
+}
+export interface BotonicWebviewsSession {
+    custom: Record<string, any>;
+    channel: BotonicWebviewsSessionChannel;
+    bot: BotonicWebviewsSessionBot;
+    user: BotonicWebviewsSessionUser;
+}

package/src/lib/domain/botonic/webviews-session.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=webviews-session.js.map

package/src/lib/domain/botonic/webviews-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webviews-session.js","sourceRoot":"","sources":["../../../../../../../../libs/botonic/shared/src/lib/domain/botonic/webviews-session.ts"],"names":[],"mappings":""}

package/src/lib/domain/botonic/whatsapp-outputs/whatsapp-button-list/index.d.ts

@@ -14,4 +14,4 @@ export declare class BotonicWhatsappButtonListData {
     sections: WhatsappButtonListSection[];
     constructor(args: BotonicWhatsappButtonListDataArgs);
 }
-export { WhatsappButtonListRow, WhatsappButtonListSection };
+export type { WhatsappButtonListRow, WhatsappButtonListSection };

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

@@ -1,3 +1,2 @@
 export * from './botonic';
-export * from './server';
-export * from './webchat';
+export * from './utils';

package/src/lib/domain/index.js

@@ -1,7 +1,4 @@
 // Botonic protocol exports (base types, inputs, outputs)
 export * from './botonic';
-// Server exports (bot server messages)
-export * from './server';
-// Webchat exports (user inputs, realtime response messages, webchat messages)
-export * from './webchat';
+export * from './utils';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/botonic/shared/src/lib/domain/index.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,cAAc,WAAW,CAAA;AAEzB,uCAAuC;AACvC,cAAc,UAAU,CAAA;AAExB,8EAA8E;AAC9E,cAAc,WAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/botonic/shared/src/lib/domain/index.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA"}

package/src/lib/hubtype-analytics-types.d.ts

@@ -119,7 +119,7 @@ export interface EventHandoffOption extends HtBaseEventProps {
 }
 export interface EventKeyword extends HtBaseEventProps {
     action: EventAction.Keyword;
-    flowThreadId: string;
+    flowThreadId?: string;
     flowId: string;
     flowName: string;
     flowNodeId: string;
@@ -131,7 +131,7 @@ export interface EventKeyword extends HtBaseEventProps {
 }
 export interface EventIntentSmart extends HtBaseEventProps {
     action: EventAction.IntentSmart;
-    flowThreadId: string;
+    flowThreadId?: string;
     flowId: string;
     flowName: string;
     flowNodeId: string;

package/src/lib/index.d.ts

@@ -1,6 +1,6 @@
-export { MessagingChannel } from './shared-types';
-export * from './services/webchat-api';
+export { HelpdeskEvent, InputType, MessagingChannel } from './shared-types';
+export * from './domain';
+export * from './services';
 export * from './ai-agents-types';
 export * from './hubtype-analytics-types';
-export * from './domain';
 export * from './utils';

package/src/lib/index.js

@@ -1,13 +1,13 @@
-// Export base types first
-export { MessagingChannel } from './shared-types'; // InputType, HelpdeskEvent already exported in domain
-// Export services
-export * from './services/webchat-api';
+// Channel / input / helpdesk enums shared across protocol and plugins
+export { HelpdeskEvent, InputType, MessagingChannel } from './shared-types';
+// Domain (protocol types only — no re-exports of `@botonic/core` / webchat / webviews runtime)
+export * from './domain';
+// Export services (depend on domain + optional `@botonic/core`)
+export * from './services';
 // Export AI agents types
 export * from './ai-agents-types';
 // Export Hubtype analytics types
 export * from './hubtype-analytics-types';
-// Export domain types
-export * from './domain';
 // Export utils
 export * from './utils';
 //# sourceMappingURL=index.js.map

package/src/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/botonic/shared/src/lib/index.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA,CAAC,sDAAsD;AAExG,kBAAkB;AAClB,cAAc,wBAAwB,CAAA;AAEtC,yBAAyB;AACzB,cAAc,mBAAmB,CAAA;AAEjC,iCAAiC;AACjC,cAAc,2BAA2B,CAAA;AAEzC,sBAAsB;AACtB,cAAc,UAAU,CAAA;AAExB,eAAe;AACf,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/botonic/shared/src/lib/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAE3E,+FAA+F;AAC/F,cAAc,UAAU,CAAA;AAExB,gEAAgE;AAChE,cAAc,YAAY,CAAA;AAE1B,yBAAyB;AACzB,cAAc,mBAAmB,CAAA;AAEjC,iCAAiC;AACjC,cAAc,2BAA2B,CAAA;AAEzC,eAAe;AACf,cAAc,SAAS,CAAA"}

package/src/lib/services/handoff.d.ts

@@ -0,0 +1,18 @@
+/** Narrow context shape for this helper (avoids `@botonic/shared` → `@botonic/core` package cycle). */
+export interface StoreCaseRatingContext {
+    session: {
+        isTestIntegration: boolean;
+        user: {
+            id: string;
+        };
+    };
+    settings: {
+        hubtypeApiUrl: string;
+    };
+    secrets: {
+        hubtypeAccessToken: string;
+    };
+}
+export declare function storeCaseRating(botonicContext: StoreCaseRatingContext, rating: number, _context?: Record<string, unknown>): Promise<{
+    status: string;
+}>;

package/src/lib/services/handoff.js

@@ -0,0 +1,23 @@
+import { __awaiter } from "tslib";
+// TODO: Create endpoint in backend into external and move this into hubtype-external-api-client.ts
+export function storeCaseRating(botonicContext_1, rating_1) {
+    return __awaiter(this, arguments, void 0, function* (botonicContext, rating, _context = {}) {
+        if (botonicContext.session.isTestIntegration) {
+            return Promise.resolve({ status: 'ok' });
+        }
+        const chatId = botonicContext.session.user.id;
+        const response = yield fetch(`${botonicContext.settings.hubtypeApiUrl}/v1/chats/${chatId}/store_case_rating/`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${botonicContext.secrets.hubtypeAccessToken}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ chat_id: chatId, rating }),
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP error! status: ${response.status}`);
+        }
+        return yield response.json();
+    });
+}
+//# sourceMappingURL=handoff.js.map

package/src/lib/services/handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.js","sourceRoot":"","sources":["../../../../../../../libs/botonic/shared/src/lib/services/handoff.ts"],"names":[],"mappings":";AAUA,mGAAmG;AACnG,MAAM,UAAgB,eAAe;yDACnC,cAAsC,EACtC,MAAc,EACd,WAAoC,EAAE;QAEtC,IAAI,cAAc,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAC7C,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;QAC1C,CAAC;QAED,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAA;QAC7C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,GAAG,cAAc,CAAC,QAAQ,CAAC,aAAa,aAAa,MAAM,qBAAqB,EAChF;YACE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,cAAc,CAAC,OAAO,CAAC,kBAAkB,EAAE;gBACpE,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;SAClD,CACF,CAAA;QAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;QAC3D,CAAC;QAED,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAC9B,CAAC;CAAA"}

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

@@ -0,0 +1,2 @@
+export * from './handoff';
+export * from './webchat-api';

package/src/lib/services/index.js

@@ -0,0 +1,3 @@
+export * from './handoff';
+export * from './webchat-api';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/botonic/shared/src/lib/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA"}

package/src/lib/services/webchat-api.d.ts

@@ -1,8 +1,7 @@
-import { UserInputMessage } from '../domain/webchat';
 export type HubtypeUserLocale = {
-    locale?: string;
-    country?: string;
-    system_locale?: string;
+    locale: string;
+    country: string;
+    system_locale: string;
 };
 export type HubtypeUser = {
     id: string;
@@ -10,7 +9,11 @@ export type HubtypeUser = {
     name?: string;
     extra_data?: Record<string, any>;
 } & HubtypeUserLocale;
+/**
+ * Webchat message payload at the Hubtype API boundary.
+ * Runtime class lives in `@botonic/webchat-core`; keep `unknown` here so `@botonic/shared` stays dependency-free.
+ */
 export interface HubtypeMessage {
     sender: HubtypeUser;
-    message: UserInputMessage;
+    message: unknown;
 }