@marketrix.ai/widget 3.8.329 → 3.8.335

package/README.md

@@ -80,7 +80,7 @@ These apply to every mode (script attribute → config key):
 | `show_widget`     | —                     | boolean       | When `false`, the widget initializes fully but its UI stays hidden. Default `true`.                                                                   |
 | `use_screenshare` | `mtx-use-screenshare` | boolean       | When `false`, screen-share requests are auto-denied and the Share Screen button is hidden. Default `true`. Disable via `mtx-use-screenshare="false"`. |
 
-Widget **appearance and behavior** (position, colors, sizing, border radius, animation, enabled Tell/Show/Do/Human features, device visibility, header/body/greeting text, and quick-action chips) are configured in the Marketrix dashboard and fetched from the API at init. You don't set them in the embed — except in preview mode, where you pass them inline as `settings`.
+Widget **appearance and behavior** (position, colors, sizing, border radius, animation, enabled Tell/Show/Do/Human features, device visibility, visibility, greeting toast, optional session recording, header/body/greeting text, and quick-action chips) are configured in the Marketrix dashboard and fetched from the API at init. A hidden widget stays visible in the dashboard preview.
 
 ### Full script-tag example
 
@@ -170,6 +170,10 @@ Merges `partial` into the current config and re-initializes (unmount + `initWidg
 
 Returns the active configuration, or `null` if the widget isn't initialized.
 
+### Settings
+
+Widget settings are managed in the dashboard. `widget_appearance: 'hidden'` keeps the widget initialized but suppresses its visible UI on the host page; previews remain visible. `widget_greeting_toast` controls the welcome toast, and `widget_recording` enables rrweb session recording. Recording is off by default.
+
 ### `MarketrixWidget` — React component (preview)
 
 For previewing appearance inside a React app (e.g. a settings/configuration screen). Renders into its own Shadow DOM and makes no network calls.

package/dist/src/context/WidgetProviders.d.ts

@@ -1,7 +1,9 @@
 import React from 'react';
+export declare const usePortalContainer: () => HTMLElement | ShadowRoot;
 interface WidgetProvidersProps {
     children: React.ReactNode;
     previewMode?: boolean;
+    portalContainer?: HTMLElement | ShadowRoot;
 }
 export declare const WidgetProviders: React.FC<WidgetProvidersProps>;
 export {};

package/dist/src/design-system/semantic-tokens.d.ts

@@ -33,4 +33,5 @@ export type SemanticTokens = {
 export type WidgetStyleSettingsDefaults = Pick<WidgetSettingsData, 'widget_background_color' | 'widget_text_color' | 'widget_border_color' | 'widget_accent_color' | 'widget_secondary_color' | 'widget_border_radius' | 'widget_font_size' | 'widget_width' | 'widget_height' | 'widget_shadow' | 'widget_animation_duration' | 'widget_fade_duration'>;
 export declare const WIDGET_STYLE_SETTINGS_DEFAULTS: WidgetStyleSettingsDefaults;
 export declare function mapWidgetSettingsToSemanticTokens(settings: WidgetStyleSettingsDefaults): SemanticTokens;
+export declare function createSemanticTokens(settings?: Partial<WidgetSettingsData>): SemanticTokens;
 export declare function semanticTokensToCssCustomProperties(tokens: SemanticTokens): Record<string, string>;

package/dist/src/sdk/contract.d.ts

@@ -134,6 +134,7 @@ export declare const widgetContract: {
                     default: "default";
                     compact: "compact";
                     full: "full";
+                    hidden: "hidden";
                 }>;
                 widget_position: import("zod").ZodEnum<{
                     bottom_left: "bottom_left";
@@ -149,6 +150,8 @@ export declare const widgetContract: {
                 widget_header: import("zod").ZodString;
                 widget_body: import("zod").ZodString;
                 widget_greeting: import("zod").ZodString;
+                widget_greeting_toast: import("zod").ZodBoolean;
+                widget_recording: import("zod").ZodBoolean;
                 widget_feature_tell: import("zod").ZodBoolean;
                 widget_feature_show: import("zod").ZodBoolean;
                 widget_feature_do: import("zod").ZodBoolean;
@@ -197,6 +200,7 @@ export declare const widgetContract: {
             default: "default";
             compact: "compact";
             full: "full";
+            hidden: "hidden";
         }>;
         widget_position: import("zod").ZodEnum<{
             bottom_left: "bottom_left";
@@ -212,6 +216,8 @@ export declare const widgetContract: {
         widget_header: import("zod").ZodString;
         widget_body: import("zod").ZodString;
         widget_greeting: import("zod").ZodString;
+        widget_greeting_toast: import("zod").ZodBoolean;
+        widget_recording: import("zod").ZodBoolean;
         widget_feature_tell: import("zod").ZodBoolean;
         widget_feature_show: import("zod").ZodBoolean;
         widget_feature_do: import("zod").ZodBoolean;
@@ -262,6 +268,7 @@ export declare const widgetContract: {
                     default: "default";
                     compact: "compact";
                     full: "full";
+                    hidden: "hidden";
                 }>;
                 widget_position: import("zod").ZodEnum<{
                     bottom_left: "bottom_left";
@@ -277,6 +284,8 @@ export declare const widgetContract: {
                 widget_header: import("zod").ZodString;
                 widget_body: import("zod").ZodString;
                 widget_greeting: import("zod").ZodString;
+                widget_greeting_toast: import("zod").ZodBoolean;
+                widget_recording: import("zod").ZodBoolean;
                 widget_feature_tell: import("zod").ZodBoolean;
                 widget_feature_show: import("zod").ZodBoolean;
                 widget_feature_do: import("zod").ZodBoolean;
@@ -341,6 +350,22 @@ export declare const widgetContract: {
             success: import("zod").ZodBoolean;
             data: import("zod").ZodOptional<import("zod").ZodString>;
             error: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            type: import("zod").ZodLiteral<"rrweb/metadata">;
+            rrweb_session_id: import("zod").ZodString;
+            chat_id: import("zod").ZodString;
+            application_id: import("zod").ZodNumber;
+            url: import("zod").ZodOptional<import("zod").ZodString>;
+            user_agent: import("zod").ZodOptional<import("zod").ZodString>;
+            timestamp: import("zod").ZodOptional<import("zod").ZodNumber>;
+            viewport: import("zod").ZodOptional<import("zod").ZodObject<{
+                width: import("zod").ZodNumber;
+                height: import("zod").ZodNumber;
+            }, import("zod/v4/core").$strip>>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            type: import("zod").ZodLiteral<"rrweb/events">;
+            rrweb_session_id: import("zod").ZodString;
+            events: import("zod").ZodArray<import("zod").ZodUnknown>;
         }, import("zod/v4/core").$strip>], "type">;
     }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
         ok: import("zod").ZodBoolean;

package/dist/src/sdk/contracts/application.d.ts

@@ -101,6 +101,7 @@ export declare const applicationSearch: import("@orpc/contract").ContractProcedu
                     default: "default";
                     compact: "compact";
                     full: "full";
+                    hidden: "hidden";
                 }>;
                 widget_position: z.ZodEnum<{
                     bottom_left: "bottom_left";
@@ -116,6 +117,8 @@ export declare const applicationSearch: import("@orpc/contract").ContractProcedu
                 widget_header: z.ZodString;
                 widget_body: z.ZodString;
                 widget_greeting: z.ZodString;
+                widget_greeting_toast: z.ZodBoolean;
+                widget_recording: z.ZodBoolean;
                 widget_feature_tell: z.ZodBoolean;
                 widget_feature_show: z.ZodBoolean;
                 widget_feature_do: z.ZodBoolean;
@@ -187,6 +190,7 @@ export declare const applicationGet: import("@orpc/contract").ContractProcedureB
                 default: "default";
                 compact: "compact";
                 full: "full";
+                hidden: "hidden";
             }>;
             widget_position: z.ZodEnum<{
                 bottom_left: "bottom_left";
@@ -202,6 +206,8 @@ export declare const applicationGet: import("@orpc/contract").ContractProcedureB
             widget_header: z.ZodString;
             widget_body: z.ZodString;
             widget_greeting: z.ZodString;
+            widget_greeting_toast: z.ZodBoolean;
+            widget_recording: z.ZodBoolean;
             widget_feature_tell: z.ZodBoolean;
             widget_feature_show: z.ZodBoolean;
             widget_feature_do: z.ZodBoolean;
@@ -371,6 +377,7 @@ export declare const applicationRoutes: {
                         default: "default";
                         compact: "compact";
                         full: "full";
+                        hidden: "hidden";
                     }>;
                     widget_position: z.ZodEnum<{
                         bottom_left: "bottom_left";
@@ -386,6 +393,8 @@ export declare const applicationRoutes: {
                     widget_header: z.ZodString;
                     widget_body: z.ZodString;
                     widget_greeting: z.ZodString;
+                    widget_greeting_toast: z.ZodBoolean;
+                    widget_recording: z.ZodBoolean;
                     widget_feature_tell: z.ZodBoolean;
                     widget_feature_show: z.ZodBoolean;
                     widget_feature_do: z.ZodBoolean;
@@ -457,6 +466,7 @@ export declare const applicationRoutes: {
                     default: "default";
                     compact: "compact";
                     full: "full";
+                    hidden: "hidden";
                 }>;
                 widget_position: z.ZodEnum<{
                     bottom_left: "bottom_left";
@@ -472,6 +482,8 @@ export declare const applicationRoutes: {
                 widget_header: z.ZodString;
                 widget_body: z.ZodString;
                 widget_greeting: z.ZodString;
+                widget_greeting_toast: z.ZodBoolean;
+                widget_recording: z.ZodBoolean;
                 widget_feature_tell: z.ZodBoolean;
                 widget_feature_show: z.ZodBoolean;
                 widget_feature_do: z.ZodBoolean;

package/dist/src/sdk/contracts/entities.d.ts

@@ -341,6 +341,7 @@ export declare const WidgetSettingsDataSchema: z.ZodObject<{
         default: "default";
         compact: "compact";
         full: "full";
+        hidden: "hidden";
     }>;
     widget_position: z.ZodEnum<{
         bottom_left: "bottom_left";
@@ -356,6 +357,8 @@ export declare const WidgetSettingsDataSchema: z.ZodObject<{
     widget_header: z.ZodString;
     widget_body: z.ZodString;
     widget_greeting: z.ZodString;
+    widget_greeting_toast: z.ZodBoolean;
+    widget_recording: z.ZodBoolean;
     widget_feature_tell: z.ZodBoolean;
     widget_feature_show: z.ZodBoolean;
     widget_feature_do: z.ZodBoolean;
@@ -397,6 +400,7 @@ export declare const WidgetEntitySchema: z.ZodObject<{
             default: "default";
             compact: "compact";
             full: "full";
+            hidden: "hidden";
         }>;
         widget_position: z.ZodEnum<{
             bottom_left: "bottom_left";
@@ -412,6 +416,8 @@ export declare const WidgetEntitySchema: z.ZodObject<{
         widget_header: z.ZodString;
         widget_body: z.ZodString;
         widget_greeting: z.ZodString;
+        widget_greeting_toast: z.ZodBoolean;
+        widget_recording: z.ZodBoolean;
         widget_feature_tell: z.ZodBoolean;
         widget_feature_show: z.ZodBoolean;
         widget_feature_do: z.ZodBoolean;

package/dist/src/sdk/contracts/widget.d.ts

@@ -28,6 +28,7 @@ export declare const ApplicationWithWidgetsSchema: z.ZodObject<{
                 default: "default";
                 compact: "compact";
                 full: "full";
+                hidden: "hidden";
             }>;
             widget_position: z.ZodEnum<{
                 bottom_left: "bottom_left";
@@ -43,6 +44,8 @@ export declare const ApplicationWithWidgetsSchema: z.ZodObject<{
             widget_header: z.ZodString;
             widget_body: z.ZodString;
             widget_greeting: z.ZodString;
+            widget_greeting_toast: z.ZodBoolean;
+            widget_recording: z.ZodBoolean;
             widget_feature_tell: z.ZodBoolean;
             widget_feature_show: z.ZodBoolean;
             widget_feature_do: z.ZodBoolean;
@@ -104,6 +107,7 @@ export declare const WidgetCreateSchema: z.ZodObject<{
             default: "default";
             compact: "compact";
             full: "full";
+            hidden: "hidden";
         }>;
         widget_position: z.ZodEnum<{
             bottom_left: "bottom_left";
@@ -119,6 +123,8 @@ export declare const WidgetCreateSchema: z.ZodObject<{
         widget_header: z.ZodString;
         widget_body: z.ZodString;
         widget_greeting: z.ZodString;
+        widget_greeting_toast: z.ZodBoolean;
+        widget_recording: z.ZodBoolean;
         widget_feature_tell: z.ZodBoolean;
         widget_feature_show: z.ZodBoolean;
         widget_feature_do: z.ZodBoolean;
@@ -161,6 +167,7 @@ export declare const WidgetUpdateSchema: z.ZodObject<{
             default: "default";
             compact: "compact";
             full: "full";
+            hidden: "hidden";
         }>;
         widget_position: z.ZodEnum<{
             bottom_left: "bottom_left";
@@ -176,6 +183,8 @@ export declare const WidgetUpdateSchema: z.ZodObject<{
         widget_header: z.ZodString;
         widget_body: z.ZodString;
         widget_greeting: z.ZodString;
+        widget_greeting_toast: z.ZodBoolean;
+        widget_recording: z.ZodBoolean;
         widget_feature_tell: z.ZodBoolean;
         widget_feature_show: z.ZodBoolean;
         widget_feature_do: z.ZodBoolean;
@@ -279,6 +288,22 @@ export declare const WidgetCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     success: z.ZodBoolean;
     data: z.ZodOptional<z.ZodString>;
     error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"rrweb/metadata">;
+    rrweb_session_id: z.ZodString;
+    chat_id: z.ZodString;
+    application_id: z.ZodNumber;
+    url: z.ZodOptional<z.ZodString>;
+    user_agent: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodOptional<z.ZodNumber>;
+    viewport: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"rrweb/events">;
+    rrweb_session_id: z.ZodString;
+    events: z.ZodArray<z.ZodUnknown>;
 }, z.core.$strip>], "type">;
 export type WidgetCommand = z.infer<typeof WidgetCommandSchema>;
 export declare const widgetCreate: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
@@ -304,6 +329,7 @@ export declare const widgetCreate: import("@orpc/contract").ContractProcedureBui
             default: "default";
             compact: "compact";
             full: "full";
+            hidden: "hidden";
         }>;
         widget_position: z.ZodEnum<{
             bottom_left: "bottom_left";
@@ -319,6 +345,8 @@ export declare const widgetCreate: import("@orpc/contract").ContractProcedureBui
         widget_header: z.ZodString;
         widget_body: z.ZodString;
         widget_greeting: z.ZodString;
+        widget_greeting_toast: z.ZodBoolean;
+        widget_recording: z.ZodBoolean;
         widget_feature_tell: z.ZodBoolean;
         widget_feature_show: z.ZodBoolean;
         widget_feature_do: z.ZodBoolean;
@@ -359,6 +387,7 @@ export declare const widgetCreate: import("@orpc/contract").ContractProcedureBui
             default: "default";
             compact: "compact";
             full: "full";
+            hidden: "hidden";
         }>;
         widget_position: z.ZodEnum<{
             bottom_left: "bottom_left";
@@ -374,6 +403,8 @@ export declare const widgetCreate: import("@orpc/contract").ContractProcedureBui
         widget_header: z.ZodString;
         widget_body: z.ZodString;
         widget_greeting: z.ZodString;
+        widget_greeting_toast: z.ZodBoolean;
+        widget_recording: z.ZodBoolean;
         widget_feature_tell: z.ZodBoolean;
         widget_feature_show: z.ZodBoolean;
         widget_feature_do: z.ZodBoolean;
@@ -434,6 +465,7 @@ export declare const widgetSearch: import("@orpc/contract").ContractProcedureBui
                 default: "default";
                 compact: "compact";
                 full: "full";
+                hidden: "hidden";
             }>;
             widget_position: z.ZodEnum<{
                 bottom_left: "bottom_left";
@@ -449,6 +481,8 @@ export declare const widgetSearch: import("@orpc/contract").ContractProcedureBui
             widget_header: z.ZodString;
             widget_body: z.ZodString;
             widget_greeting: z.ZodString;
+            widget_greeting_toast: z.ZodBoolean;
+            widget_recording: z.ZodBoolean;
             widget_feature_tell: z.ZodBoolean;
             widget_feature_show: z.ZodBoolean;
             widget_feature_do: z.ZodBoolean;
@@ -499,6 +533,7 @@ export declare const widgetDefaultGet: import("@orpc/contract").ContractProcedur
         default: "default";
         compact: "compact";
         full: "full";
+        hidden: "hidden";
     }>;
     widget_position: z.ZodEnum<{
         bottom_left: "bottom_left";
@@ -514,6 +549,8 @@ export declare const widgetDefaultGet: import("@orpc/contract").ContractProcedur
     widget_header: z.ZodString;
     widget_body: z.ZodString;
     widget_greeting: z.ZodString;
+    widget_greeting_toast: z.ZodBoolean;
+    widget_recording: z.ZodBoolean;
     widget_feature_tell: z.ZodBoolean;
     widget_feature_show: z.ZodBoolean;
     widget_feature_do: z.ZodBoolean;
@@ -554,6 +591,7 @@ export declare const widgetUpdate: import("@orpc/contract").ContractProcedureBui
             default: "default";
             compact: "compact";
             full: "full";
+            hidden: "hidden";
         }>;
         widget_position: z.ZodEnum<{
             bottom_left: "bottom_left";
@@ -569,6 +607,8 @@ export declare const widgetUpdate: import("@orpc/contract").ContractProcedureBui
         widget_header: z.ZodString;
         widget_body: z.ZodString;
         widget_greeting: z.ZodString;
+        widget_greeting_toast: z.ZodBoolean;
+        widget_recording: z.ZodBoolean;
         widget_feature_tell: z.ZodBoolean;
         widget_feature_show: z.ZodBoolean;
         widget_feature_do: z.ZodBoolean;
@@ -619,6 +659,7 @@ export declare const widgetUpdate: import("@orpc/contract").ContractProcedureBui
             default: "default";
             compact: "compact";
             full: "full";
+            hidden: "hidden";
         }>;
         widget_position: z.ZodEnum<{
             bottom_left: "bottom_left";
@@ -634,6 +675,8 @@ export declare const widgetUpdate: import("@orpc/contract").ContractProcedureBui
         widget_header: z.ZodString;
         widget_body: z.ZodString;
         widget_greeting: z.ZodString;
+        widget_greeting_toast: z.ZodBoolean;
+        widget_recording: z.ZodBoolean;
         widget_feature_tell: z.ZodBoolean;
         widget_feature_show: z.ZodBoolean;
         widget_feature_do: z.ZodBoolean;
@@ -768,6 +811,22 @@ export declare const widgetMessage: import("@orpc/contract").ContractProcedureBu
         success: z.ZodBoolean;
         data: z.ZodOptional<z.ZodString>;
         error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"rrweb/metadata">;
+        rrweb_session_id: z.ZodString;
+        chat_id: z.ZodString;
+        application_id: z.ZodNumber;
+        url: z.ZodOptional<z.ZodString>;
+        user_agent: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodOptional<z.ZodNumber>;
+        viewport: z.ZodOptional<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"rrweb/events">;
+        rrweb_session_id: z.ZodString;
+        events: z.ZodArray<z.ZodUnknown>;
     }, z.core.$strip>], "type">;
 }, z.core.$strip>, z.ZodObject<{
     ok: z.ZodBoolean;
@@ -796,6 +855,7 @@ export declare const widgetRoutes: {
                 default: "default";
                 compact: "compact";
                 full: "full";
+                hidden: "hidden";
             }>;
             widget_position: z.ZodEnum<{
                 bottom_left: "bottom_left";
@@ -811,6 +871,8 @@ export declare const widgetRoutes: {
             widget_header: z.ZodString;
             widget_body: z.ZodString;
             widget_greeting: z.ZodString;
+            widget_greeting_toast: z.ZodBoolean;
+            widget_recording: z.ZodBoolean;
             widget_feature_tell: z.ZodBoolean;
             widget_feature_show: z.ZodBoolean;
             widget_feature_do: z.ZodBoolean;
@@ -851,6 +913,7 @@ export declare const widgetRoutes: {
                 default: "default";
                 compact: "compact";
                 full: "full";
+                hidden: "hidden";
             }>;
             widget_position: z.ZodEnum<{
                 bottom_left: "bottom_left";
@@ -866,6 +929,8 @@ export declare const widgetRoutes: {
             widget_header: z.ZodString;
             widget_body: z.ZodString;
             widget_greeting: z.ZodString;
+            widget_greeting_toast: z.ZodBoolean;
+            widget_recording: z.ZodBoolean;
             widget_feature_tell: z.ZodBoolean;
             widget_feature_show: z.ZodBoolean;
             widget_feature_do: z.ZodBoolean;
@@ -926,6 +991,7 @@ export declare const widgetRoutes: {
                     default: "default";
                     compact: "compact";
                     full: "full";
+                    hidden: "hidden";
                 }>;
                 widget_position: z.ZodEnum<{
                     bottom_left: "bottom_left";
@@ -941,6 +1007,8 @@ export declare const widgetRoutes: {
                 widget_header: z.ZodString;
                 widget_body: z.ZodString;
                 widget_greeting: z.ZodString;
+                widget_greeting_toast: z.ZodBoolean;
+                widget_recording: z.ZodBoolean;
                 widget_feature_tell: z.ZodBoolean;
                 widget_feature_show: z.ZodBoolean;
                 widget_feature_do: z.ZodBoolean;
@@ -991,6 +1059,7 @@ export declare const widgetRoutes: {
             default: "default";
             compact: "compact";
             full: "full";
+            hidden: "hidden";
         }>;
         widget_position: z.ZodEnum<{
             bottom_left: "bottom_left";
@@ -1006,6 +1075,8 @@ export declare const widgetRoutes: {
         widget_header: z.ZodString;
         widget_body: z.ZodString;
         widget_greeting: z.ZodString;
+        widget_greeting_toast: z.ZodBoolean;
+        widget_recording: z.ZodBoolean;
         widget_feature_tell: z.ZodBoolean;
         widget_feature_show: z.ZodBoolean;
         widget_feature_do: z.ZodBoolean;
@@ -1046,6 +1117,7 @@ export declare const widgetRoutes: {
                 default: "default";
                 compact: "compact";
                 full: "full";
+                hidden: "hidden";
             }>;
             widget_position: z.ZodEnum<{
                 bottom_left: "bottom_left";
@@ -1061,6 +1133,8 @@ export declare const widgetRoutes: {
             widget_header: z.ZodString;
             widget_body: z.ZodString;
             widget_greeting: z.ZodString;
+            widget_greeting_toast: z.ZodBoolean;
+            widget_recording: z.ZodBoolean;
             widget_feature_tell: z.ZodBoolean;
             widget_feature_show: z.ZodBoolean;
             widget_feature_do: z.ZodBoolean;
@@ -1111,6 +1185,7 @@ export declare const widgetRoutes: {
                 default: "default";
                 compact: "compact";
                 full: "full";
+                hidden: "hidden";
             }>;
             widget_position: z.ZodEnum<{
                 bottom_left: "bottom_left";
@@ -1126,6 +1201,8 @@ export declare const widgetRoutes: {
             widget_header: z.ZodString;
             widget_body: z.ZodString;
             widget_greeting: z.ZodString;
+            widget_greeting_toast: z.ZodBoolean;
+            widget_recording: z.ZodBoolean;
             widget_feature_tell: z.ZodBoolean;
             widget_feature_show: z.ZodBoolean;
             widget_feature_do: z.ZodBoolean;
@@ -1260,6 +1337,22 @@ export declare const widgetRoutes: {
             success: z.ZodBoolean;
             data: z.ZodOptional<z.ZodString>;
             error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"rrweb/metadata">;
+            rrweb_session_id: z.ZodString;
+            chat_id: z.ZodString;
+            application_id: z.ZodNumber;
+            url: z.ZodOptional<z.ZodString>;
+            user_agent: z.ZodOptional<z.ZodString>;
+            timestamp: z.ZodOptional<z.ZodNumber>;
+            viewport: z.ZodOptional<z.ZodObject<{
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"rrweb/events">;
+            rrweb_session_id: z.ZodString;
+            events: z.ZodArray<z.ZodUnknown>;
         }, z.core.$strip>], "type">;
     }, z.core.$strip>, z.ZodObject<{
         ok: z.ZodBoolean;

package/dist/src/sdk/index.d.ts

@@ -139,6 +139,7 @@ export declare const sdk: {
                     default: "default";
                     compact: "compact";
                     full: "full";
+                    hidden: "hidden";
                 }>;
                 widget_position: import("zod").ZodEnum<{
                     bottom_left: "bottom_left";
@@ -154,6 +155,8 @@ export declare const sdk: {
                 widget_header: import("zod").ZodString;
                 widget_body: import("zod").ZodString;
                 widget_greeting: import("zod").ZodString;
+                widget_greeting_toast: import("zod").ZodBoolean;
+                widget_recording: import("zod").ZodBoolean;
                 widget_feature_tell: import("zod").ZodBoolean;
                 widget_feature_show: import("zod").ZodBoolean;
                 widget_feature_do: import("zod").ZodBoolean;
@@ -202,6 +205,7 @@ export declare const sdk: {
             default: "default";
             compact: "compact";
             full: "full";
+            hidden: "hidden";
         }>;
         widget_position: import("zod").ZodEnum<{
             bottom_left: "bottom_left";
@@ -217,6 +221,8 @@ export declare const sdk: {
         widget_header: import("zod").ZodString;
         widget_body: import("zod").ZodString;
         widget_greeting: import("zod").ZodString;
+        widget_greeting_toast: import("zod").ZodBoolean;
+        widget_recording: import("zod").ZodBoolean;
         widget_feature_tell: import("zod").ZodBoolean;
         widget_feature_show: import("zod").ZodBoolean;
         widget_feature_do: import("zod").ZodBoolean;
@@ -267,6 +273,7 @@ export declare const sdk: {
                     default: "default";
                     compact: "compact";
                     full: "full";
+                    hidden: "hidden";
                 }>;
                 widget_position: import("zod").ZodEnum<{
                     bottom_left: "bottom_left";
@@ -282,6 +289,8 @@ export declare const sdk: {
                 widget_header: import("zod").ZodString;
                 widget_body: import("zod").ZodString;
                 widget_greeting: import("zod").ZodString;
+                widget_greeting_toast: import("zod").ZodBoolean;
+                widget_recording: import("zod").ZodBoolean;
                 widget_feature_tell: import("zod").ZodBoolean;
                 widget_feature_show: import("zod").ZodBoolean;
                 widget_feature_do: import("zod").ZodBoolean;
@@ -346,6 +355,22 @@ export declare const sdk: {
             success: import("zod").ZodBoolean;
             data: import("zod").ZodOptional<import("zod").ZodString>;
             error: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            type: import("zod").ZodLiteral<"rrweb/metadata">;
+            rrweb_session_id: import("zod").ZodString;
+            chat_id: import("zod").ZodString;
+            application_id: import("zod").ZodNumber;
+            url: import("zod").ZodOptional<import("zod").ZodString>;
+            user_agent: import("zod").ZodOptional<import("zod").ZodString>;
+            timestamp: import("zod").ZodOptional<import("zod").ZodNumber>;
+            viewport: import("zod").ZodOptional<import("zod").ZodObject<{
+                width: import("zod").ZodNumber;
+                height: import("zod").ZodNumber;
+            }, import("zod/v4/core").$strip>>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            type: import("zod").ZodLiteral<"rrweb/events">;
+            rrweb_session_id: import("zod").ZodString;
+            events: import("zod").ZodArray<import("zod").ZodUnknown>;
         }, import("zod/v4/core").$strip>], "type">;
     }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
         ok: import("zod").ZodBoolean;

package/dist/src/services/ApiService.d.ts

@@ -1,12 +1,4 @@
 import type { MarketrixConfig, MessageDispatchRequest } from '../types';
-export declare class ApiService {
-    private config;
-    constructor(config: MarketrixConfig);
-    getChatId(): string | null;
-    /** Resolves user_id from config, then localStorage, then sessionStorage. */
-    private getUserId;
-    logWidgetQuestion(question: string, mode: string): Promise<void>;
-    /** Fire-and-forget send over the typed stream; the reply arrives asynchronously as a chat/response event. */
-    messageDispatch(request: MessageDispatchRequest): Promise<void>;
-    updateConfig(newConfig: Partial<MarketrixConfig>): void;
-}
+export declare function getChatId(): string | null;
+/** Fire-and-forget send over the typed stream; the reply arrives asynchronously as a chat/response event. */
+export declare function messageDispatch(config: MarketrixConfig, request: MessageDispatchRequest): Promise<void>;

package/dist/src/services/RrwebSessionRecorder.d.ts

@@ -0,0 +1,14 @@
+export declare class RrwebSessionRecorder {
+    private readonly chatId;
+    private readonly applicationId;
+    private events;
+    private readonly sessionId;
+    private stopRecording;
+    private flushTimer;
+    private flushPromise;
+    constructor(chatId: string, applicationId: number);
+    start(): Promise<void>;
+    stop(): void;
+    private buffer;
+    private flush;
+}

package/dist/src/services/StreamClient.d.ts

@@ -21,12 +21,14 @@ export declare class StreamClient {
     private config?;
     private connectionId;
     private readonly tabId;
+    private registrationWaiters;
     private constructor();
     static getInstance(): StreamClient;
     addCallbacks(callbacks: StreamClientCallbacks): void;
     removeCallbacks(callbacks: StreamClientCallbacks): void;
     getStatus(): StreamStatus;
     isConnected(): boolean;
+    waitUntilRegistered(): Promise<void>;
     connect(chatId: string, config?: {
         mtxId?: string;
         mtxKey?: string;

package/dist/src/services/ValidationService.d.ts

@@ -10,10 +10,5 @@ export interface WidgetValidationResult {
  * Validates widget config: either the widget (marketrix_id + marketrix_key) and its application exist,
  * or the application id exists.
  */
-export declare class ValidationService {
-    private config?;
-    /** Handles both the mtxId+mtxKey and mtxApp cases. */
-    validateConfig(config: MarketrixConfig): Promise<WidgetValidationResult>;
-    private validateByMarketrixId;
-    private validateByApplication;
-}
+/** Handles both the mtxId+mtxKey and mtxApp cases. */
+export declare function validateConfig(config: MarketrixConfig): Promise<WidgetValidationResult>;