@koredev/kore-web-sdk 11.18.0-rc.f92a18a → 11.19.0-rc.57e454c

package/dist/plugins/proactiveWebCampaign/proactiveWebCampaign.d.ts

@@ -24,16 +24,18 @@ declare class ProactiveWebCampaignPlugin {
     static readonly MAX_FLATTEN_DEPTH = 10;
     private static readonly ACTIVE_CAMPAIGN_SELECTOR;
     private static readonly CHAT_CONTAINER_SELECTOR;
+    private static readonly MAX_API_RETRIES;
+    private static readonly RETRY_DELAY_MS;
+    private static readonly TEMPLATE_PERSIST_DURATION;
     isPendingSendAPIEvent: boolean;
+    private currentPersistedTemplate;
+    private isTemplateRestored;
     coolDownTime: number;
     cooldownState: {
         isActive: boolean;
         startTime: number;
         expiryTime: number;
     };
-    isVisitorAlreadyChatting: boolean;
-    private chatSessionInfo;
-    private static readonly CHAT_SESSION_STORAGE_KEY;
     constructor(config: any);
     /**
      * Generates a unique browser session ID for the campaign trigger session
@@ -42,6 +44,11 @@ declare class ProactiveWebCampaignPlugin {
     generateBrowserSessionId(): string;
     onHostCreate(): void;
     onInit(): void;
+    /**
+     * Called when view is initialized (DOM ready)
+     * Attempts template restoration for chat templates that need DOM access
+     */
+    onViewInit(): void;
     onUrlChange(callback: () => void): void;
     onTitleChange(callback: (newTitle: string) => void): void;
     /**
@@ -132,7 +139,6 @@ declare class ProactiveWebCampaignPlugin {
      * @param campaigns - Array of campaign data
      */
     extractCustomColumns(campaigns: any[]): void;
-    sendPWCStartEvent(): void;
     installPWCTemplates(): void;
     /**
      * Creates targeted timers for timeSpent conditions instead of polling every second
@@ -237,7 +243,12 @@ declare class ProactiveWebCampaignPlugin {
      * @returns true if the recent journey matches the required sequence, false otherwise
      */
     isJourneyValid(pageVisitArray: any, websiteArray: any): boolean;
-    checkEngagementHours(engHours: any): boolean;
+    /**
+     * Checks if the current time is within the engagement hours specified in engStrategy
+     * @param engStrategy - Engagement strategy object with engagement hours settings
+     * @returns {boolean} - Returns true if current time is within engagement hours, false otherwise
+     */
+    checkEngagementHours(engStrategy: any): boolean;
     createTimeSpentObjs(): void;
     getLocationDetails(): void;
     /**
@@ -281,11 +292,74 @@ declare class ProactiveWebCampaignPlugin {
      * @returns Location name or null if not found
      */
     findLocationByType(response: any[], targetType: string): string | null;
-    sendApiEvent(payload: string, route: string, campInstanceId?: string): Promise<void>;
+    /**
+     * Sends API event with retry logic
+     * @param payload - Event payload
+     * @param route - API route
+     * @param retryCount - Number of retries remaining (default: MAX_API_RETRIES)
+     * @returns Promise with API response
+     */
+    sendApiEvent(payload: any, route: string, retryCount?: number): Promise<any>;
+    /**
+     * Determines if an HTTP status code should trigger a retry
+     * Retries: 429 (Rate Limit), 5xx (Server Errors)
+     * Does NOT retry: 4xx (Client Errors, except 429)
+     * @param statusCode - HTTP status code
+     * @returns Boolean indicating if retry should happen
+     */
+    private shouldRetryStatusCode;
+    /**
+     * Initializes PWC campaigns by calling the pwe_verify API
+     */
+    initializePWCCampaigns(): Promise<void>;
+    /**
+     * Restores PWC state from sessionStorage for multi-page apps
+     * Called when pwe_data exists but in-memory state is lost (page navigation)
+     * Reconstructs campInfo from stored data to avoid redundant API calls
+     * @returns Boolean indicating if restoration was successful
+     */
+    restorePWCStateFromStorage(): boolean;
+    /**
+     * Handles the pwe_verify API response
+     * Processes campaign configuration and initializes PWC system
+     * @param responseData - API response data
+     */
+    handlePweVerifyResponse(responseData: any): Promise<void>;
+    /**
+     * Handles the pwe_event API response and renders campaign templates
+     * @param responseData - API response data
+     */
+    handlePweEventResponse(responseData: any): void;
+    /**
+     * Persists template data to sessionStorage for multi-page persistence
+     * @param templateData - Template data to persist
+     */
+    private persistTemplate;
+    /**
+     * Public method for templates to call when closing
+     * Clears persisted template from both memory and sessionStorage
+     */
+    clearPersistedTemplateFromStorage(): void;
+    /**
+     * Checks if a persisted template has expired
+     * @param template - Persisted template to check
+     * @returns Boolean indicating if template has expired
+     */
+    private isTemplateExpired;
+    /**
+     * Restores persisted template from sessionStorage if valid
+     * Called during onInit after PWC state restoration
+     */
+    private restorePersistedTemplate;
+    /**
+     * Re-renders a persisted template in the DOM
+     * @param template - Persisted template to render
+     */
+    private renderPersistedTemplate;
     /**
      * Constructs the pwe_data object based on the new campaign structure
      * Extracts custom column configurations and initializes custom data
-     * @param campaignData - Campaign data received from socket
+     * @param campaignData - Campaign data received from API
      * @returns Constructed pwe_data object
      */
     constructPweData(campaignData: any): any;
@@ -331,7 +405,7 @@ declare class ProactiveWebCampaignPlugin {
     setupHoverListenerForCondition(condition: any, campInstanceId: string, group: any, groupIndex: number, conditionIndex: number, type: string): void;
     /**
      * Constructs rules/exclusions structure with proper grouping and condition tracking
-     * Reads 'globalType' from socket message but stores as 'groupType' internally
+     * Reads 'globalType' from API response but stores as 'groupType' internally
      * @param rulesConfig - Rules or exclusions configuration
      * @returns Structured rules object
      */
@@ -342,6 +416,12 @@ declare class ProactiveWebCampaignPlugin {
      * @returns Object with conditions grouped by column
      */
     groupConditionsByColumn(conditions: any[]): any;
+    /**
+     * Reconstructs RAW rules format from PROCESSED format stored in pwe_data
+     * @param processedRules - Processed rules structure from pwe_data.expected
+     * @returns RAW rules structure matching original API format
+     */
+    reconstructRawRulesFromProcessed(processedRules: any): any;
     /**
      * Checks if a campaign has a specific condition type configured in RULES
      * @param campaign - Campaign object
@@ -580,11 +660,11 @@ declare class ProactiveWebCampaignPlugin {
      */
     updateSatisfactionFlags(campInstanceId: string): void;
     /**
-     * Triggers campaign event using existing API logic
+     * Triggers campaign event using API and handles response
      * @param campInstanceId - Campaign instance ID
      * @param campId - Campaign ID
      */
-    triggerCampaignEvent(campInstanceId: string, campId: string): void;
+    triggerCampaignEvent(campInstanceId: string, campId: string, campaignData: any): Promise<void>;
     /**
      * Checks if any campaign template is active
      * @returns Boolean indicating if any campaign template is active
@@ -621,22 +701,11 @@ declare class ProactiveWebCampaignPlugin {
      * Only called during page load/refresh - has error handling fallback
      */
     restoreCooldownState(): void;
-    /**
-     * Initialize chat session state from sessionStorage
-     */
-    initializeChatSessionState(): void;
     /**
      * Check if chat window is currently open
      * Note: When minimize class is present, chat window is actually OPEN
      * @returns true if chat window is open, false if closed/minimized
      */
     isChatWindowOpen(): boolean;
-    /**
-     * Update chat session state based on received events
-     * Handles Session_Start, Session_End, and Bot_Active events
-     * @param eventType - Type of event received
-     * @param data - Event data
-     */
-    updateChatSessionState(eventType: 'Session_Start' | 'Session_End' | 'Bot_Active', data: any): void;
 }
 export default ProactiveWebCampaignPlugin;

package/dist/templatemanager/templates/clockPicker/clockPicker.d.ts

@@ -1,6 +1,7 @@
 import BaseChatTemplate from '../baseChatTemplate';
 import './clockPicker.scss';
 import { h } from 'preact';
+export declare function ClockPickerInline(props: any): h.JSX.Element;
 export declare function ClockPicker(props: any): h.JSX.Element | undefined;
 declare class TemplateClockPicker extends BaseChatTemplate {
     hostInstance: any;

package/dist/templatemanager/templates/datePicker/datePicker.d.ts

@@ -2,6 +2,7 @@ import BaseChatTemplate from '../baseChatTemplate';
 import './datePicker.scss';
 import { h } from 'preact';
 export declare function DatePickerExt(props: any): h.JSX.Element;
+export declare function DatePickerInline(props: any): h.JSX.Element;
 export declare function DatePicker(props: any): h.JSX.Element | undefined;
 declare class TemplateDatePicker extends BaseChatTemplate {
     hostInstance: any;

package/dist/templatemanager/templates/dateRange/dateRange.d.ts

@@ -2,6 +2,7 @@ import BaseChatTemplate from '../baseChatTemplate';
 import './dateRange.scss';
 import { h } from 'preact';
 export declare function DateRangeExt(props: any): h.JSX.Element;
+export declare function DateRangeInline(props: any): h.JSX.Element;
 export declare function DateRange(props: any): h.JSX.Element | undefined;
 declare class TemplateDatePicker extends BaseChatTemplate {
     hostInstance: any;