@elementor/angie-sdk 1.4.8 → 1.4.9-beta.12

package/dist/load-sidebar-v2/boot-sidebar.d.ts

@@ -0,0 +1,2 @@
+import { type LoadSidebarV2Options } from './config';
+export declare const bootSidebar: (options: LoadSidebarV2Options) => Promise<void>;

package/dist/load-sidebar-v2/chat-toggle/chat-shell.d.ts

@@ -0,0 +1,15 @@
+type InitChatShellArgs = {
+    containerId: string;
+    iframeOrigin: string;
+    toggleButtonSelector: string;
+    onClose?: () => void;
+};
+type SetChatWidgetOpenArgs = {
+    containerId: string;
+    toggleButtonSelector: string;
+    isOpen: boolean;
+};
+export declare const setChatWidgetOpen: (args: SetChatWidgetOpenArgs) => void;
+export declare const initChatShell: (args: InitChatShellArgs) => void;
+export declare const resetChatShellForTests: () => void;
+export {};

package/dist/load-sidebar-v2/chat-toggle/constants.d.ts

@@ -0,0 +1,7 @@
+export declare const CHAT_TOGGLE_BUTTON_CLASS = "angie-widget-toggle";
+export declare const DEFAULT_CHAT_TOGGLE_BUTTON_SELECTOR = "#angie-widget-toggle";
+export declare const CHAT_WIDGET_HIDDEN_CLASS = "angie-widget-hidden";
+export declare const CHAT_WIDGET_FULLSCREEN_CLASS = "angie-widget-fullscreen";
+export declare const CHAT_WIDGET_CONTAINER_CLASS = "angie-widget-container";
+export declare const CHAT_WIDGET_STYLES_ID = "angie-chat-widget-styles";
+export declare const CHAT_TOGGLE_STYLES_ID = "angie-chat-toggle-styles";

package/dist/load-sidebar-v2/chat-toggle/init-floating-chat-layout.d.ts

@@ -0,0 +1,9 @@
+type InitFloatingChatLayoutArgs = {
+    containerId: string;
+    iframeOrigin: string;
+    toggleButtonSelector: string;
+    injectToggleButton: boolean;
+    onClose?: () => void;
+};
+export declare const initFloatingChatLayout: (args: InitFloatingChatLayoutArgs) => void;
+export {};

package/dist/load-sidebar-v2/chat-toggle/toggle-button-element.d.ts

@@ -0,0 +1,2 @@
+export declare const findToggleButton: (selector: string) => HTMLElement | null;
+export declare const applySelectorToToggleButton: (element: HTMLElement, selector: string) => void;

package/dist/load-sidebar-v2/chat-toggle/widget-ui.d.ts

@@ -0,0 +1,4 @@
+export declare const injectChatToggleButtonStyles: () => void;
+export declare const injectChatWidgetStyles: (containerId: string) => void;
+export declare const prepareChatWidgetContainer: (containerId: string) => void;
+export declare const injectChatToggleButton: (toggleButtonSelector: string) => void;

package/dist/load-sidebar-v2/config.d.ts

@@ -0,0 +1,64 @@
+import type { WidgetConfig } from '../angie-mcp-sdk';
+export declare const LOAD_SIDEBAR_V2_CONFIG_VERSION: 2;
+export declare const LAYOUT_SIDEBAR: "sidebar";
+export declare const LAYOUT_FLOATING_CHAT: "floatingChat";
+export type LoadSidebarV2Layout = typeof LAYOUT_SIDEBAR | typeof LAYOUT_FLOATING_CHAT;
+export type LoadSidebarV2ContainerStyleTheme = 'wordpress' | '';
+export type HostConfig = {
+    appId: string;
+    aiContext?: Record<string, unknown>;
+    website?: Record<string, unknown>;
+    analytics?: Record<string, unknown>;
+};
+export type BootConfig = {
+    allowInIframe: boolean;
+};
+export type BootOptions = Partial<BootConfig>;
+export type ContainerConfig = {
+    id: string;
+    layout: LoadSidebarV2Layout;
+    styleTheme: LoadSidebarV2ContainerStyleTheme;
+    persistOpenState: boolean;
+    resizable: boolean;
+    chatToggleButton: {
+        enabled: boolean;
+        selector: string;
+    };
+};
+export type ContainerOptions = Partial<ContainerConfig>;
+export type IframeConfig = {
+    origin: string;
+    path: string;
+    uiTheme: string;
+    isRTL: boolean;
+};
+export type IframeOptions = Partial<IframeConfig>;
+export type ExternalHeadersCallback = () => Record<string, string | undefined> | Promise<Record<string, string | undefined>>;
+export type CallbacksConfig = {
+    onClose?: () => void;
+    getExternalHeaders?: ExternalHeadersCallback;
+};
+export type LoadSidebarV2Options = {
+    host: HostConfig;
+    boot?: BootOptions;
+    container?: ContainerOptions;
+    iframe?: IframeOptions;
+    callbacks?: CallbacksConfig;
+    widgetConfig?: WidgetConfig;
+};
+export type ResolvedConfigV2 = {
+    host: HostConfig;
+    boot: BootConfig;
+    container: ContainerConfig;
+    iframe: IframeConfig;
+    callbacks: CallbacksConfig;
+    widgetConfig?: WidgetConfig;
+};
+export type HostEmbeddedConfigPayload = {
+    aiContext?: Record<string, unknown>;
+    appId?: string;
+    configVersion: typeof LOAD_SIDEBAR_V2_CONFIG_VERSION;
+    telemetry?: Record<string, unknown>;
+    website?: Record<string, unknown>;
+};
+export declare const buildHostEmbeddedConfigPayload: (host: ResolvedConfigV2["host"]) => HostEmbeddedConfigPayload;

package/dist/load-sidebar-v2/container.d.ts

@@ -0,0 +1 @@
+export declare const ensureSidebarContainer: (containerId: string, isRTL: boolean) => void;

package/dist/load-sidebar-v2/defaults.d.ts

@@ -0,0 +1,24 @@
+import { DEFAULT_CONTAINER_ID } from '../config';
+import { SIDEBAR_PRESET_DEFAULTS } from './presets/sidebar';
+export { SIDEBAR_PRESET_DEFAULTS };
+export { DEFAULT_CONTAINER_ID };
+export declare const DEFAULT_CHAT_TOGGLE_BUTTON_SELECTOR = "#angie-widget-toggle";
+export declare const DEFAULTS: {
+    readonly boot: {
+        readonly allowInIframe: false;
+    };
+    readonly container: {
+        readonly layout: "sidebar";
+        readonly styleTheme: "";
+        readonly persistOpenState: true;
+        readonly resizable: true;
+        readonly chatToggleButtonSelector: "#angie-widget-toggle";
+    };
+    readonly iframe: {
+        readonly origin: "https://angie.elementor.com";
+        readonly path: "angie/embedded";
+        readonly uiTheme: "light";
+    };
+};
+export declare const SIDEBAR_LOADING_ID = "angie-sidebar-loading";
+export declare const EMBEDDED_CONFIG_MESSAGE_TYPE = "sdk-embedded-config";

package/dist/load-sidebar-v2/embedded-handshake.d.ts

@@ -0,0 +1,3 @@
+import type { HostEmbeddedConfigPayload, ResolvedConfigV2 } from './config';
+export declare const sendEmbeddedConfig: (payload: HostEmbeddedConfigPayload) => void;
+export declare const sendWidgetConfig: (widgetConfig: NonNullable<ResolvedConfigV2["widgetConfig"]>) => void;

package/dist/load-sidebar-v2/env.d.ts

@@ -0,0 +1,6 @@
+export type Env = {
+    browserUiTheme: 'dark' | 'light';
+    isInIframe: boolean;
+    isRTL: boolean;
+};
+export declare const readEnv: () => Env;

package/dist/load-sidebar-v2/host-api-bridge.d.ts

@@ -0,0 +1,29 @@
+import type { ExternalHeadersCallback, HostConfig } from './config';
+export declare const GET_EXTERNAL_HEADERS_MESSAGE_TYPE = "GET_EXTERNAL_HEADERS";
+export declare const GET_WEBSITE_CONTEXT_MESSAGE_TYPE = "angie/context/get-website-context";
+export declare const GET_ANALYTICS_CONTEXT_MESSAGE_TYPE = "angie/context/get-analytics-context";
+type InitHostApiBridgeArgs = {
+    iframeOrigin: string;
+    host?: HostConfig;
+    getExternalHeaders?: ExternalHeadersCallback;
+};
+export declare const buildWebsiteContextResponse: (host?: HostConfig) => {
+    payload: {
+        timezone: string;
+        today: string;
+        name: string;
+        tagline: string;
+        homeUrl: string;
+        siteLang: string;
+        docTitle: string;
+        platform: string;
+    };
+};
+export declare const buildAnalyticsContextResponse: (host?: HostConfig) => {
+    payload: {
+        screenPath: string;
+    };
+};
+export declare const initHostApiBridge: (args: InitHostApiBridgeArgs) => void;
+export declare const resetHostApiBridgeForTests: () => void;
+export {};

package/dist/load-sidebar-v2/host-message-router.d.ts

@@ -0,0 +1,4 @@
+type HostMessageHandler = (event: MessageEvent) => void;
+export declare const addHostMessageHandler: (handler: HostMessageHandler) => (() => void);
+export declare const resetHostMessageRouterForTests: () => void;
+export {};

package/dist/load-sidebar-v2/inject-style-theme.d.ts

@@ -0,0 +1,2 @@
+import type { LoadSidebarV2ContainerStyleTheme } from './config';
+export declare const injectStyleThemeCss: (styleTheme: LoadSidebarV2ContainerStyleTheme) => void;

package/dist/load-sidebar-v2/layouts/index.d.ts

@@ -0,0 +1,15 @@
+import { type ResolvedConfigV2 } from '../config';
+import type { Env } from '../env';
+export type LayoutBootContext = {
+    config: ResolvedConfigV2;
+    env: Env;
+};
+export type LayoutStrategy = {
+    initShell: (ctx: LayoutBootContext) => void;
+    beforeOpenIframe?: (ctx: LayoutBootContext) => void;
+    afterOpenIframe?: (ctx: LayoutBootContext) => void;
+};
+export declare const LAYOUT_STRATEGIES: {
+    sidebar: LayoutStrategy;
+    floatingChat: LayoutStrategy;
+};

package/dist/load-sidebar-v2/open-embedded-iframe.d.ts

@@ -0,0 +1,8 @@
+import { type HostEmbeddedConfigPayload, type ResolvedConfigV2 } from './config';
+type OpenEmbeddedIframeArgs = {
+    container: ResolvedConfigV2['container'];
+    iframe: ResolvedConfigV2['iframe'];
+    embeddedConfig?: HostEmbeddedConfigPayload;
+};
+export declare const openEmbeddedIframe: (args: OpenEmbeddedIframeArgs) => Promise<void>;
+export {};

package/dist/load-sidebar-v2/presets/floating-chat.d.ts

@@ -0,0 +1,7 @@
+export declare const FLOATING_CHAT_PRESET_DEFAULTS: {
+    readonly layout: "floatingChat";
+    readonly styleTheme: "";
+    readonly persistOpenState: false;
+    readonly resizable: false;
+    readonly chatToggleButtonEnabled: true;
+};

package/dist/load-sidebar-v2/presets/sidebar.d.ts

@@ -0,0 +1,7 @@
+export declare const SIDEBAR_PRESET_DEFAULTS: {
+    readonly layout: "sidebar";
+    readonly styleTheme: "";
+    readonly persistOpenState: true;
+    readonly resizable: true;
+    readonly chatToggleButtonEnabled: false;
+};

package/dist/load-sidebar-v2/resolve-config.d.ts

@@ -0,0 +1,4 @@
+import type { Env } from './env';
+import { type LoadSidebarV2Options, type ResolvedConfigV2 } from './config';
+export declare const shouldBoot: (config: ResolvedConfigV2, env: Env) => boolean;
+export declare const resolveConfig: (options: LoadSidebarV2Options, env: Env) => ResolvedConfigV2;

package/dist/load-sidebar-v2/shell.d.ts

@@ -0,0 +1,4 @@
+import type { ContainerConfig, ResolvedConfigV2 } from './config';
+export declare const initSidebarShell: (container: ContainerConfig, callbacks: ResolvedConfigV2["callbacks"]) => void;
+export declare const applyInitialSidebarShellState: (container: ContainerConfig) => void;
+export declare const finalizeSidebarShellState: (container: ContainerConfig) => void;

package/dist/load-sidebar-v2/sidebar-toggle.d.ts

@@ -0,0 +1,6 @@
+type WireSidebarToggleButtonArgs = {
+    toggleButtonSelector: string;
+};
+export declare const syncSidebarToggleButton: (toggleButtonSelector: string, isOpen: boolean) => void;
+export declare const wireSidebarToggleButton: (args: WireSidebarToggleButtonArgs) => void;
+export {};

package/dist/load-sidebar-v2/toggle-button.d.ts

@@ -0,0 +1,8 @@
+export declare const TOGGLE_BUTTON_WIRED_ATTR = "data-angie-toggle-wired";
+export declare const syncToggleButton: (toggleButtonSelector: string, isOpen: boolean) => void;
+type WireToggleButtonArgs = {
+    toggleButtonSelector: string;
+    onClick: (event: Event) => void;
+};
+export declare const wireToggleButton: (args: WireToggleButtonArgs) => void;
+export {};

package/dist/load-sidebar-v2/widget-config.d.ts

@@ -0,0 +1,3 @@
+import type { WidgetConfig } from '../angie-mcp-sdk';
+import { type LoadSidebarV2Layout } from './config';
+export declare const resolveWidgetConfig: (layout: LoadSidebarV2Layout, widgetConfig?: WidgetConfig) => WidgetConfig | undefined;

package/dist/openSaaSPage.d.ts

@@ -1,8 +1,10 @@
+import type { HostEmbeddedConfigPayload } from "./load-sidebar-v2/config";
 type OpenSaaSPageInput = {
     origin: string;
     path: string;
     parent?: Document;
     insertCallback?: (iframe: HTMLIFrameElement) => void;
+    embeddedConfig?: HostEmbeddedConfigPayload;
     css: {
         [key: string]: string | number;
     };

package/dist/sidebar.d.ts

@@ -13,7 +13,7 @@ export declare function saveState(state: string): void;
 export declare function saveWidth(width: number): void;
 export declare function applyWidth(width: number): void;
 export declare function forceSidebarClosedDuringOAuth(): void;
-export declare function loadState(): void;
+export declare function loadState(defaultState?: AngieSidebarState): void;
 export declare function applyState(state: AngieSidebarState): void;
 export declare function initializeResize(): void;
 export declare function createToggleSidebarFunction(onToggle?: (isOpen: boolean, sidebar: HTMLElement, skipTransition?: boolean) => void): (force?: boolean, skipTransition?: boolean) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elementor/angie-sdk",
-  "version": "1.4.8",
+  "version": "1.4.9-beta.12",
   "description": "TypeScript SDK for Angie AI assistant",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -21,7 +21,8 @@
     "dev": "tsc --watch",
     "test": "jest",
     "lint": "eslint src/**/*.ts",
-    "lint:fix": "eslint src/**/*.ts --fix"
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "demo": "npm run build && npx --yes serve . -l 8080"
   },
   "keywords": [
     "mcp",