@sonordev/site-kit 1.2.7

package/dist/types-BnCwwUX3.d.mts

@@ -0,0 +1,250 @@
+import React__default, { CSSProperties } from 'react';
+
+/**
+ * @sonordev/site-kit/engage - Design Renderer
+ *
+ * Renders design_json from Engage Studio as React components.
+ * This is the runtime renderer that converts the visual builder's
+ * JSON structure into actual React elements.
+ */
+
+interface DesignNode {
+    id: string;
+    type: string;
+    name: string;
+    children?: DesignNode[];
+    props?: Record<string, any>;
+    style?: CSSProperties;
+}
+interface DesignDocument {
+    id: string;
+    type: string;
+    name: string;
+    children: DesignNode[];
+    style?: CSSProperties;
+    props?: Record<string, any>;
+}
+interface DesignRendererProps {
+    design: DesignDocument;
+    onClose?: () => void;
+    onAction?: (action: ActionConfig, node: DesignNode) => void;
+    context?: EngageContext;
+}
+interface ActionConfig {
+    action: string;
+    url?: string;
+    newTab?: boolean;
+    target?: string;
+    text?: string;
+    productId?: string;
+    formId?: string;
+}
+interface EngageContext {
+    user?: {
+        name?: string;
+        email?: string;
+        isLoggedIn?: boolean;
+    };
+    cart?: {
+        itemCount?: number;
+        total?: number;
+    };
+    page?: {
+        url?: string;
+        title?: string;
+    };
+    [key: string]: any;
+}
+declare function DesignRenderer({ design, onClose, onAction, context, }: DesignRendererProps): React__default.ReactElement;
+
+/**
+ * @sonordev/site-kit/engage - Type definitions
+ */
+
+type WidgetType = 'popup' | 'nudge' | 'bar' | 'chat' | 'slide-in';
+interface EngageElement {
+    id: string;
+    project_id: string;
+    name: string;
+    type: WidgetType;
+    config: WidgetConfig;
+    targeting: TargetingRules;
+    trigger: TriggerConfig;
+    is_active: boolean;
+    priority: number;
+    created_at: string;
+    updated_at: string;
+    design_json?: DesignDocument;
+    compiled_bundle_url?: string;
+    status?: 'draft' | 'published' | 'archived' | 'paused';
+}
+interface WidgetConfig {
+    /** Visual style */
+    theme?: 'light' | 'dark' | 'custom';
+    position?: 'center' | 'top' | 'bottom' | 'left' | 'right' | 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right';
+    /** Content */
+    title?: string;
+    message?: string;
+    imageUrl?: string;
+    /** CTA */
+    ctaText?: string;
+    ctaUrl?: string;
+    ctaAction?: 'link' | 'close' | 'form' | 'chat';
+    /** Form (if ctaAction is 'form') */
+    formId?: string;
+    /** Styling */
+    backgroundColor?: string;
+    textColor?: string;
+    ctaBackgroundColor?: string;
+    ctaTextColor?: string;
+    borderRadius?: number;
+    /** Behavior */
+    closable?: boolean;
+    showOverlay?: boolean;
+    overlayOpacity?: number;
+}
+interface TargetingRules {
+    /** Page targeting */
+    pages?: {
+        include?: string[];
+        exclude?: string[];
+    };
+    /** Device targeting */
+    devices?: ('desktop' | 'mobile' | 'tablet')[];
+    /** Visitor targeting */
+    visitor?: {
+        type?: 'new' | 'returning' | 'all';
+        minSessions?: number;
+        maxSessions?: number;
+    };
+    /** Source targeting */
+    source?: {
+        utm_source?: string[];
+        utm_medium?: string[];
+        utm_campaign?: string[];
+        referrer?: string[];
+    };
+    /** Time targeting */
+    schedule?: {
+        startDate?: string;
+        endDate?: string;
+        daysOfWeek?: number[];
+        startTime?: string;
+        endTime?: string;
+        timezone?: string;
+    };
+}
+interface TriggerConfig {
+    type: 'immediate' | 'delay' | 'scroll' | 'exit-intent' | 'click' | 'custom';
+    /** Delay in seconds (for 'delay' type) */
+    delay?: number;
+    /** Scroll percentage (for 'scroll' type) */
+    scrollPercentage?: number;
+    /** CSS selector (for 'click' type) */
+    clickSelector?: string;
+    /** Custom event name (for 'custom' type) */
+    customEvent?: string;
+    /** Frequency capping */
+    frequency?: {
+        type: 'always' | 'once' | 'once-per-session' | 'every-n-days';
+        days?: number;
+    };
+}
+interface ChatConfig {
+    /** Widget position */
+    position: 'bottom-right' | 'bottom-left';
+    /** Widget appearance */
+    buttonIcon?: 'chat' | 'help' | 'custom';
+    buttonColor?: string;
+    buttonText?: string;
+    /** Brand primary color */
+    brandPrimary?: string;
+    /** Welcome message */
+    welcomeMessage?: string;
+    /** Operating hours */
+    operatingHours?: {
+        enabled: boolean;
+        timezone: string;
+        hours: {
+            [day: number]: {
+                start: string;
+                end: string;
+            } | null;
+        };
+    };
+    /** AI vs Live Chat */
+    mode: 'ai' | 'live' | 'hybrid';
+    /** AI settings (if mode is 'ai' or 'hybrid') */
+    aiSettings?: {
+        skillId?: string;
+        handoffToLive?: boolean;
+        handoffKeywords?: string[];
+        /** When AI should suggest handoff based on sentiment or keywords */
+        handoffTriggers?: {
+            negativesentiment?: boolean;
+            keywords?: string[];
+            afterMessages?: number;
+        };
+    };
+    /** Offline mode settings (when no agents available) */
+    offlineMode?: 'form' | 'ai' | 'message';
+    /** Form slug to show when offline (defaults to 'contact') */
+    offlineFormSlug?: string;
+    /** AI fallback when no agents online (hybrid mode) */
+    aiFallbackEnabled?: boolean;
+    /** Custom offline message */
+    offlineMessage?: string;
+}
+interface ChatMessage {
+    id: string;
+    conversation_id: string;
+    role: 'user' | 'assistant' | 'agent' | 'system';
+    content: string;
+    metadata?: Record<string, unknown>;
+    created_at: string;
+    /** Name of the agent (for agent messages) */
+    sender_name?: string;
+    /** Avatar URL of the agent */
+    sender_avatar?: string;
+}
+interface ChatConversation {
+    id: string;
+    project_id: string;
+    visitor_id: string;
+    status: 'active' | 'ai' | 'pending_handoff' | 'human' | 'closed';
+    assigned_to?: string;
+    last_message_at: string;
+    created_at: string;
+    /** AI summary of the conversation */
+    ai_summary?: string;
+    /** Visitor info */
+    visitor_name?: string;
+    visitor_email?: string;
+}
+/** Availability status returned by the widget API */
+interface ChatAvailability {
+    available: boolean;
+    mode: 'live' | 'ai' | 'offline';
+    agentsOnline: number;
+    operatingHoursActive: boolean;
+}
+interface EngageConfig {
+    projectId: string;
+    /** Widget position */
+    position?: 'bottom-right' | 'bottom-left';
+    /** Z-index for widgets */
+    zIndex?: number;
+    /** Enable chat */
+    chatEnabled?: boolean;
+    /** Debug mode */
+    debug?: boolean;
+}
+interface EngageAnalytics {
+    element_id: string;
+    event_type: 'impression' | 'click' | 'close' | 'submit' | 'dismiss';
+    session_id: string;
+    metadata?: Record<string, unknown>;
+    created_at: string;
+}
+
+export { type ActionConfig as A, type ChatConfig as C, DesignRenderer as D, type EngageContext as E, type TargetingRules as T, type WidgetType as W, type DesignDocument as a, type DesignNode as b, type EngageElement as c, type WidgetConfig as d, type TriggerConfig as e, type ChatMessage as f, type ChatConversation as g, type ChatAvailability as h, type EngageConfig as i, type EngageAnalytics as j };

package/dist/types-BnCwwUX3.d.ts

@@ -0,0 +1,250 @@
+import React__default, { CSSProperties } from 'react';
+
+/**
+ * @sonordev/site-kit/engage - Design Renderer
+ *
+ * Renders design_json from Engage Studio as React components.
+ * This is the runtime renderer that converts the visual builder's
+ * JSON structure into actual React elements.
+ */
+
+interface DesignNode {
+    id: string;
+    type: string;
+    name: string;
+    children?: DesignNode[];
+    props?: Record<string, any>;
+    style?: CSSProperties;
+}
+interface DesignDocument {
+    id: string;
+    type: string;
+    name: string;
+    children: DesignNode[];
+    style?: CSSProperties;
+    props?: Record<string, any>;
+}
+interface DesignRendererProps {
+    design: DesignDocument;
+    onClose?: () => void;
+    onAction?: (action: ActionConfig, node: DesignNode) => void;
+    context?: EngageContext;
+}
+interface ActionConfig {
+    action: string;
+    url?: string;
+    newTab?: boolean;
+    target?: string;
+    text?: string;
+    productId?: string;
+    formId?: string;
+}
+interface EngageContext {
+    user?: {
+        name?: string;
+        email?: string;
+        isLoggedIn?: boolean;
+    };
+    cart?: {
+        itemCount?: number;
+        total?: number;
+    };
+    page?: {
+        url?: string;
+        title?: string;
+    };
+    [key: string]: any;
+}
+declare function DesignRenderer({ design, onClose, onAction, context, }: DesignRendererProps): React__default.ReactElement;
+
+/**
+ * @sonordev/site-kit/engage - Type definitions
+ */
+
+type WidgetType = 'popup' | 'nudge' | 'bar' | 'chat' | 'slide-in';
+interface EngageElement {
+    id: string;
+    project_id: string;
+    name: string;
+    type: WidgetType;
+    config: WidgetConfig;
+    targeting: TargetingRules;
+    trigger: TriggerConfig;
+    is_active: boolean;
+    priority: number;
+    created_at: string;
+    updated_at: string;
+    design_json?: DesignDocument;
+    compiled_bundle_url?: string;
+    status?: 'draft' | 'published' | 'archived' | 'paused';
+}
+interface WidgetConfig {
+    /** Visual style */
+    theme?: 'light' | 'dark' | 'custom';
+    position?: 'center' | 'top' | 'bottom' | 'left' | 'right' | 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right';
+    /** Content */
+    title?: string;
+    message?: string;
+    imageUrl?: string;
+    /** CTA */
+    ctaText?: string;
+    ctaUrl?: string;
+    ctaAction?: 'link' | 'close' | 'form' | 'chat';
+    /** Form (if ctaAction is 'form') */
+    formId?: string;
+    /** Styling */
+    backgroundColor?: string;
+    textColor?: string;
+    ctaBackgroundColor?: string;
+    ctaTextColor?: string;
+    borderRadius?: number;
+    /** Behavior */
+    closable?: boolean;
+    showOverlay?: boolean;
+    overlayOpacity?: number;
+}
+interface TargetingRules {
+    /** Page targeting */
+    pages?: {
+        include?: string[];
+        exclude?: string[];
+    };
+    /** Device targeting */
+    devices?: ('desktop' | 'mobile' | 'tablet')[];
+    /** Visitor targeting */
+    visitor?: {
+        type?: 'new' | 'returning' | 'all';
+        minSessions?: number;
+        maxSessions?: number;
+    };
+    /** Source targeting */
+    source?: {
+        utm_source?: string[];
+        utm_medium?: string[];
+        utm_campaign?: string[];
+        referrer?: string[];
+    };
+    /** Time targeting */
+    schedule?: {
+        startDate?: string;
+        endDate?: string;
+        daysOfWeek?: number[];
+        startTime?: string;
+        endTime?: string;
+        timezone?: string;
+    };
+}
+interface TriggerConfig {
+    type: 'immediate' | 'delay' | 'scroll' | 'exit-intent' | 'click' | 'custom';
+    /** Delay in seconds (for 'delay' type) */
+    delay?: number;
+    /** Scroll percentage (for 'scroll' type) */
+    scrollPercentage?: number;
+    /** CSS selector (for 'click' type) */
+    clickSelector?: string;
+    /** Custom event name (for 'custom' type) */
+    customEvent?: string;
+    /** Frequency capping */
+    frequency?: {
+        type: 'always' | 'once' | 'once-per-session' | 'every-n-days';
+        days?: number;
+    };
+}
+interface ChatConfig {
+    /** Widget position */
+    position: 'bottom-right' | 'bottom-left';
+    /** Widget appearance */
+    buttonIcon?: 'chat' | 'help' | 'custom';
+    buttonColor?: string;
+    buttonText?: string;
+    /** Brand primary color */
+    brandPrimary?: string;
+    /** Welcome message */
+    welcomeMessage?: string;
+    /** Operating hours */
+    operatingHours?: {
+        enabled: boolean;
+        timezone: string;
+        hours: {
+            [day: number]: {
+                start: string;
+                end: string;
+            } | null;
+        };
+    };
+    /** AI vs Live Chat */
+    mode: 'ai' | 'live' | 'hybrid';
+    /** AI settings (if mode is 'ai' or 'hybrid') */
+    aiSettings?: {
+        skillId?: string;
+        handoffToLive?: boolean;
+        handoffKeywords?: string[];
+        /** When AI should suggest handoff based on sentiment or keywords */
+        handoffTriggers?: {
+            negativesentiment?: boolean;
+            keywords?: string[];
+            afterMessages?: number;
+        };
+    };
+    /** Offline mode settings (when no agents available) */
+    offlineMode?: 'form' | 'ai' | 'message';
+    /** Form slug to show when offline (defaults to 'contact') */
+    offlineFormSlug?: string;
+    /** AI fallback when no agents online (hybrid mode) */
+    aiFallbackEnabled?: boolean;
+    /** Custom offline message */
+    offlineMessage?: string;
+}
+interface ChatMessage {
+    id: string;
+    conversation_id: string;
+    role: 'user' | 'assistant' | 'agent' | 'system';
+    content: string;
+    metadata?: Record<string, unknown>;
+    created_at: string;
+    /** Name of the agent (for agent messages) */
+    sender_name?: string;
+    /** Avatar URL of the agent */
+    sender_avatar?: string;
+}
+interface ChatConversation {
+    id: string;
+    project_id: string;
+    visitor_id: string;
+    status: 'active' | 'ai' | 'pending_handoff' | 'human' | 'closed';
+    assigned_to?: string;
+    last_message_at: string;
+    created_at: string;
+    /** AI summary of the conversation */
+    ai_summary?: string;
+    /** Visitor info */
+    visitor_name?: string;
+    visitor_email?: string;
+}
+/** Availability status returned by the widget API */
+interface ChatAvailability {
+    available: boolean;
+    mode: 'live' | 'ai' | 'offline';
+    agentsOnline: number;
+    operatingHoursActive: boolean;
+}
+interface EngageConfig {
+    projectId: string;
+    /** Widget position */
+    position?: 'bottom-right' | 'bottom-left';
+    /** Z-index for widgets */
+    zIndex?: number;
+    /** Enable chat */
+    chatEnabled?: boolean;
+    /** Debug mode */
+    debug?: boolean;
+}
+interface EngageAnalytics {
+    element_id: string;
+    event_type: 'impression' | 'click' | 'close' | 'submit' | 'dismiss';
+    session_id: string;
+    metadata?: Record<string, unknown>;
+    created_at: string;
+}
+
+export { type ActionConfig as A, type ChatConfig as C, DesignRenderer as D, type EngageContext as E, type TargetingRules as T, type WidgetType as W, type DesignDocument as a, type DesignNode as b, type EngageElement as c, type WidgetConfig as d, type TriggerConfig as e, type ChatMessage as f, type ChatConversation as g, type ChatAvailability as h, type EngageConfig as i, type EngageAnalytics as j };