@robylon/web-react-sdk 1.1.41-staging.2 → 1.1.41-staging.21

package/dist/esm/types/components/ChatbotFloatingButton.d.ts

@@ -10,6 +10,9 @@ interface ChatbotFloatingButtonProps {
     position?: "Left" | "Right";
     sideSpacing?: number;
     bottomSpacing?: number;
+    launcher_type?: "TEXT" | "IMAGE" | "TEXTUAL_IMAGE";
+    launcher_properties_text?: string;
+    shouldFadeIn?: boolean;
 }
 declare const _default: React.NamedExoticComponent<ChatbotFloatingButtonProps>;
 export default _default;

package/dist/esm/types/components/ChatbotIframe.d.ts

@@ -1,12 +1,16 @@
 import React from "react";
 import { ChatbotConfig } from "../types";
 import { ChatbotEventHandler, AllEventTypes } from "../types/events";
+import { Overrides } from "src/components/RobylonChatbot";
 interface ChatbotIframeProps {
     config: ChatbotConfig;
     isVisible: boolean;
     onClose: () => void;
     onEvent?: ChatbotEventHandler;
     onInternalEvent: (eventType: AllEventTypes, additionalData?: Record<string, any>) => void;
+    position?: "Left" | "Right";
+    bottomSpacing?: number;
+    overrides?: Overrides;
 }
 declare const _default: React.NamedExoticComponent<ChatbotIframeProps>;
 export default _default;

package/dist/esm/types/components/RobylonChatbot.d.ts

@@ -1,5 +1,14 @@
 import React from "react";
-import { ChatbotEventHandler } from "../types/events";
+import { ChatbotEventHandler, ChatbotRef } from "../types/events";
+export interface Overrides {
+    header_avatar?: string | null;
+    agent_avatar?: string | null;
+    header_title?: string | null;
+    header_subtitle?: string | null;
+    header_title_text_color?: string | null;
+    header_subtitle_text_color?: string | null;
+    header_bg?: string | null;
+}
 interface ChatbotProps {
     api_key: string;
     user_id?: string | null | number;
@@ -9,6 +18,10 @@ interface ChatbotProps {
     position?: "Left" | "Right";
     sideSpacing?: number;
     bottomSpacing?: number;
+    show_launcher?: boolean | null;
+    launcher_type?: "TEXT" | "IMAGE" | "TEXTUAL_IMAGE";
+    launcher_properties_text?: string;
+    overrides?: Overrides;
 }
-declare const RobylonChatbot: React.FC<ChatbotProps>;
-export { RobylonChatbot as Chatbot };
+declare const MemoizedRobylonChatbot: React.MemoExoticComponent<React.ForwardRefExoticComponent<ChatbotProps & React.RefAttributes<ChatbotRef>>>;
+export { MemoizedRobylonChatbot as Chatbot };

package/dist/esm/types/core/config.d.ts

@@ -1,4 +1,5 @@
 import { ChatbotConfig } from "../types";
+import { ProactiveMessage } from "src/types";
 /**
  * Normalizes the configuration properties
  * @param props The configuration properties
@@ -32,3 +33,9 @@ export declare const initializeChatbotConfig: (props: {
     user_token?: string;
     user_profile?: Record<string, any>;
 }) => Promise<ChatbotConfig>;
+/**
+ * Normalizes proactive messages from backend to an array form, preserving order.
+ * - Accepts undefined, single object, or array of objects
+ * - Migrates legacy `content` to `content_multiple`
+ */
+export declare const normalizeProactiveMessages: (input: any) => ProactiveMessage[] | undefined;

package/dist/esm/types/index.d.ts

@@ -1,5 +1,6 @@
 export { Chatbot } from "./components/RobylonChatbot";
 export * from "./types";
 export * from "./hooks/useChatbot";
+export { ChatbotRef } from "./types/events";
 import RobylonChatbot from "./vanilla";
 export { RobylonChatbot };

package/dist/esm/types/types/events.d.ts

@@ -7,7 +7,8 @@ export declare enum ChatbotEventType {
     CHATBOT_LOADED = "CHATBOT_LOADED",// From Robylon Chatbot
     CHAT_INITIALIZED = "CHAT_INITIALIZED",// From Robylon Chatbot
     SESSION_REFRESHED = "SESSION_REFRESHED",// From Robylon Chatbot
-    CHAT_INITIALIZATION_FAILED = "CHAT_INITIALIZATION_FAILED"
+    CHAT_INITIALIZATION_FAILED = "CHAT_INITIALIZATION_FAILED",// From Robylon Chatbot
+    CHATBOT_READY = "CHATBOT_READY"
 }
 export declare enum InternalEventType {
     CHAT_MOVED = "CHAT_MOVED",// Internal only event
@@ -20,3 +21,9 @@ export interface ChatbotEvent {
     data?: any;
 }
 export type ChatbotEventHandler = (event: ChatbotEvent) => void;
+export interface ChatbotRef {
+    show: () => void;
+    hide: () => void;
+    toggle: () => void;
+    isReady: boolean;
+}

package/dist/esm/types/types.d.ts

@@ -23,6 +23,7 @@ export interface ChatbotConfig {
     token?: string;
     userProfile?: Record<string, any>;
     domain: string;
+    show_launcher: boolean;
     brand_colour: string;
     image_url?: string;
     chat_interface_config?: {
@@ -43,6 +44,11 @@ export interface ChatbotConfig {
             url: string;
         };
     };
+    proactive_message_obj?: ProactiveMessage[] | undefined;
+    launcher_delay: {
+        enabled: boolean;
+        delay: number;
+    };
 }
 interface RobylonSdkConfig {
     chatbot_id: string;
@@ -68,4 +74,48 @@ declare global {
         initializeRobylonSdk: (config: RobylonSdkConfig) => void;
     }
 }
+export declare enum ProactiveSendTimeType {
+    WORKING_HOURS = "WORKING_HOURS",
+    ALWAYS = "ALWAYS"
+}
+export declare enum DisplayAttributesType {
+    "URL" = "URL"
+}
+export declare enum LogicalConditionType {
+    AND = "AND",
+    OR = "OR"
+}
+export declare enum ConditionType {
+    IS = "IS",
+    IS_NOT = "IS_NOT",
+    CONTAINS = "CONTAINS",
+    DOES_NOT_CONTAIN = "DOES_NOT_CONTAIN",
+    STARTS_WITH = "STARTS_WITH",
+    ENDS_WITH = "ENDS_WITH"
+}
+export interface ContentDisplayAttribute {
+    type: DisplayAttributesType;
+    value: string;
+    condition: ConditionType;
+}
+export interface LogicalConditionAttribute {
+    logical_condition: LogicalConditionType;
+}
+export interface ProactiveMessage {
+    message_id: string;
+    org_id: string;
+    name?: string;
+    content?: string;
+    send_time_type?: ProactiveSendTimeType | string;
+    created_by_name?: string;
+    updated_by_name?: string;
+    updated_at?: string;
+    created_at?: string;
+    delay?: number;
+    content_multiple?: {
+        message: string;
+        content_id?: string;
+        message_display_attributes: (ContentDisplayAttribute | LogicalConditionAttribute)[];
+    }[];
+}
 export {};

package/dist/esm/types/utils/fetchData.d.ts

@@ -1,4 +1,4 @@
-import { ChatbotInterfaceType, LauncherType, WidgetPositionEnums } from "../types";
+import { ChatbotInterfaceType, LauncherType, WidgetPositionEnums, ProactiveMessage } from "../types";
 interface ChatbotResponse {
     user: {
         token: string;
@@ -38,7 +38,13 @@ interface ChatbotResponse {
                         url: string;
                     };
                 };
+                proactive_message_obj?: ProactiveMessage | ProactiveMessage[];
+                launcher_delay: {
+                    enabled: boolean;
+                    delay: number;
+                };
             };
+            show_launcher: boolean;
         };
     };
 }

package/dist/esm/types/utils/launcherInfo.d.ts

@@ -0,0 +1,9 @@
+interface LauncherInfo {
+    current_page_url: string;
+    browser_language: string;
+    browser_version: string;
+    os: string;
+    referral_url: string;
+}
+export declare const getLauncherInfo: () => LauncherInfo;
+export {};

package/dist/esm/types/utils/mockProactive.d.ts

@@ -0,0 +1,2 @@
+import { ProactiveMessage } from "src/types";
+export declare const buildMockProactives: (orgId: string) => ProactiveMessage[];

package/dist/esm/types/utils/proactive.d.ts

@@ -0,0 +1,19 @@
+import { ProactiveMessage } from "src/types";
+export declare const hideProactiveForThisPage: () => void;
+export declare const isProactiveHiddenThisPage: () => boolean;
+export declare const setLastClickedProactive: (params: {
+    content_string: string | null;
+    message_id: string | null;
+}) => void;
+export declare const getAndClearLastClickedProactive: () => {
+    input_id: null;
+    content_string: string | null;
+    message_id: string | null;
+} | null;
+export interface VisibleContent {
+    messageId: string;
+    contentIndex: number;
+    html: string;
+    delayMs: number;
+}
+export declare const evaluateProactiveMessages: (messages?: ProactiveMessage[]) => VisibleContent[];

package/dist/esm/types/utils/sanitize.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Sanitizes HTML while preserving emojis and basic inline formatting.
+ */
+export declare const sanitizeHtml: (html?: string) => string;

package/dist/esm/types/utils/url.d.ts

@@ -0,0 +1,8 @@
+import { ConditionType, DisplayAttributesType } from "src/types";
+type UrlChangeListener = (href: string) => void;
+export declare const getCurrentHref: () => string;
+export declare const buildLocationKey: () => string;
+export declare const subscribeToUrlChanges: (cb: UrlChangeListener) => (() => void);
+export declare const initUrlObserver: () => void;
+export declare const matchCondition: (type: DisplayAttributesType, value: string, condition: ConditionType, href: string) => boolean;
+export {};

package/dist/esm/types/vanilla/components/ChatbotContainer.d.ts

@@ -12,7 +12,7 @@ export declare class ChatbotContainer {
     /**
      * Creates a new ChatbotContainer
      */
-    constructor(config: ChatbotConfig);
+    constructor(config: ChatbotConfig, position?: "Left" | "Right", sideSpacing?: number, bottomSpacing?: number);
     /**
      * Renders the container element
      */

package/dist/esm/types/vanilla/components/ChatbotFloatingButton.d.ts

@@ -25,6 +25,9 @@ export declare class ChatbotFloatingButton {
     private config;
     private resizeObserver;
     private handleResizeFunction;
+    private proactiveElement;
+    private urlUnsubscribe;
+    private delayTimers;
     /**
      * Creates a new ChatbotFloatingButton
      * @param config The button configuration
@@ -68,5 +71,12 @@ export declare class ChatbotFloatingButton {
      * Unmounts and destroys the button
      */
     destroy(): void;
+    private clearProactiveDelays;
+    /**
+     * Hides proactive messages with animation
+     */
+    private hideProactiveMessages;
+    private injectAnimationStyles;
+    private renderProactiveIfNeeded;
 }
 export {};

package/dist/esm/types/vanilla/components/ChatbotIframe.d.ts

@@ -1,5 +1,14 @@
 import { ChatbotConfig } from "../../types";
 import { ChatbotEventType, AllEventTypes } from "../../types/events";
+interface Overrides {
+    header_avatar?: string | null;
+    agent_avatar?: string | null;
+    header_title?: string | null;
+    header_subtitle?: string | null;
+    header_title_text_color?: string | null;
+    header_subtitle_text_color?: string | null;
+    header_bg?: string | null;
+}
 /**
  * Interface for the ChatbotIframe configuration
  */
@@ -13,6 +22,9 @@ interface ChatbotIframeConfig {
         data?: any;
     }) => void;
     onInternalEvent: (eventType: AllEventTypes, additionalData?: Record<string, any>) => void;
+    position?: "Left" | "Right";
+    bottomSpacing?: number;
+    overrides?: Overrides;
 }
 /**
  * Class representing the ChatbotIframe component
@@ -23,6 +35,7 @@ export declare class ChatbotIframe {
     private isInitialized;
     private hasRegistered;
     private resizeHandler;
+    private overridesPayloadCache;
     /**
      * Creates a new ChatbotIframe
      * @param config The iframe configuration

package/dist/esm/types/vanilla/index.d.ts

@@ -8,6 +8,15 @@ export interface RobylonChatbotConfig {
     user_token?: string;
     user_profile?: Record<string, any>;
     onEvent?: (event: ChatbotEvent) => void;
+    position?: "Left" | "Right" | string;
+    sideSpacing?: number | string;
+    bottomSpacing?: number | string;
+    show_launcher?: boolean | null;
+    overrides?: {
+        header_avatar?: string | null;
+        agent_avatar?: string | null;
+        header_title?: string | null;
+    };
 }
 /**
  * RobylonChatbot instance interface

package/dist/index.d.ts

@@ -9,7 +9,8 @@ declare enum ChatbotEventType {
     CHATBOT_LOADED = "CHATBOT_LOADED",// From Robylon Chatbot
     CHAT_INITIALIZED = "CHAT_INITIALIZED",// From Robylon Chatbot
     SESSION_REFRESHED = "SESSION_REFRESHED",// From Robylon Chatbot
-    CHAT_INITIALIZATION_FAILED = "CHAT_INITIALIZATION_FAILED"
+    CHAT_INITIALIZATION_FAILED = "CHAT_INITIALIZATION_FAILED",// From Robylon Chatbot
+    CHATBOT_READY = "CHATBOT_READY"
 }
 interface ChatbotEvent {
     type: ChatbotEventType;
@@ -17,7 +18,22 @@ interface ChatbotEvent {
     data?: any;
 }
 type ChatbotEventHandler = (event: ChatbotEvent) => void;
+interface ChatbotRef {
+    show: () => void;
+    hide: () => void;
+    toggle: () => void;
+    isReady: boolean;
+}
 
+interface Overrides {
+    header_avatar?: string | null;
+    agent_avatar?: string | null;
+    header_title?: string | null;
+    header_subtitle?: string | null;
+    header_title_text_color?: string | null;
+    header_subtitle_text_color?: string | null;
+    header_bg?: string | null;
+}
 interface ChatbotProps {
     api_key: string;
     user_id?: string | null | number;
@@ -27,8 +43,12 @@ interface ChatbotProps {
     position?: "Left" | "Right";
     sideSpacing?: number;
     bottomSpacing?: number;
+    show_launcher?: boolean | null;
+    launcher_type?: "TEXT" | "IMAGE" | "TEXTUAL_IMAGE";
+    launcher_properties_text?: string;
+    overrides?: Overrides;
 }
-declare const RobylonChatbot: React.FC<ChatbotProps>;
+declare const MemoizedRobylonChatbot: React.MemoExoticComponent<React.ForwardRefExoticComponent<ChatbotProps & React.RefAttributes<ChatbotRef>>>;
 
 declare enum ChatbotInterfaceType {
     WIDGET = "WIDGET",
@@ -55,6 +75,7 @@ interface ChatbotConfig {
     token?: string;
     userProfile?: Record<string, any>;
     domain: string;
+    show_launcher: boolean;
     brand_colour: string;
     image_url?: string;
     chat_interface_config?: {
@@ -75,6 +96,11 @@ interface ChatbotConfig {
             url: string;
         };
     };
+    proactive_message_obj?: ProactiveMessage[] | undefined;
+    launcher_delay: {
+        enabled: boolean;
+        delay: number;
+    };
 }
 interface RobylonSdkConfig {
     chatbot_id: string;
@@ -100,6 +126,50 @@ declare global {
         initializeRobylonSdk: (config: RobylonSdkConfig) => void;
     }
 }
+declare enum ProactiveSendTimeType {
+    WORKING_HOURS = "WORKING_HOURS",
+    ALWAYS = "ALWAYS"
+}
+declare enum DisplayAttributesType {
+    "URL" = "URL"
+}
+declare enum LogicalConditionType {
+    AND = "AND",
+    OR = "OR"
+}
+declare enum ConditionType {
+    IS = "IS",
+    IS_NOT = "IS_NOT",
+    CONTAINS = "CONTAINS",
+    DOES_NOT_CONTAIN = "DOES_NOT_CONTAIN",
+    STARTS_WITH = "STARTS_WITH",
+    ENDS_WITH = "ENDS_WITH"
+}
+interface ContentDisplayAttribute {
+    type: DisplayAttributesType;
+    value: string;
+    condition: ConditionType;
+}
+interface LogicalConditionAttribute {
+    logical_condition: LogicalConditionType;
+}
+interface ProactiveMessage {
+    message_id: string;
+    org_id: string;
+    name?: string;
+    content?: string;
+    send_time_type?: ProactiveSendTimeType | string;
+    created_by_name?: string;
+    updated_by_name?: string;
+    updated_at?: string;
+    created_at?: string;
+    delay?: number;
+    content_multiple?: {
+        message: string;
+        content_id?: string;
+        message_display_attributes: (ContentDisplayAttribute | LogicalConditionAttribute)[];
+    }[];
+}
 
 declare const useChatbot: (config: ChatbotConfig) => ChatbotState;
 
@@ -112,6 +182,15 @@ interface RobylonChatbotConfig {
     user_token?: string;
     user_profile?: Record<string, any>;
     onEvent?: (event: ChatbotEvent) => void;
+    position?: "Left" | "Right" | string;
+    sideSpacing?: number | string;
+    bottomSpacing?: number | string;
+    show_launcher?: boolean | null;
+    overrides?: {
+        header_avatar?: string | null;
+        agent_avatar?: string | null;
+        header_title?: string | null;
+    };
 }
 /**
  * RobylonChatbot instance interface
@@ -134,4 +213,4 @@ declare const _default: {
     getState: () => string;
 };
 
-export { RobylonChatbot as Chatbot, type ChatbotConfig, ChatbotInterfaceType, type ChatbotState, LauncherType, _default as RobylonChatbot, type WidgetInterfaceProperties, WidgetPositionEnums, useChatbot };
+export { MemoizedRobylonChatbot as Chatbot, type ChatbotConfig, ChatbotInterfaceType, type ChatbotRef, type ChatbotState, ConditionType, type ContentDisplayAttribute, DisplayAttributesType, LauncherType, type LogicalConditionAttribute, LogicalConditionType, type ProactiveMessage, ProactiveSendTimeType, _default as RobylonChatbot, type WidgetInterfaceProperties, WidgetPositionEnums, useChatbot };