@magicfeedback/popup-sdk 1.0.11 → 1.0.12

package/dist/index.d.mts

@@ -31,12 +31,14 @@ interface DeepdotsConfig {
  * Options for configuring survey triggers
  */
 interface TriggerConfig {
-    /** Trigger type: 'time' (delay), 'scroll' (scroll percentage), 'exit' (exit intent), 'click' (element id) */
-    type: 'time' | 'scroll' | 'exit' | 'click';
-    /** Value for the trigger (milliseconds for time, percentage for scroll, element id for click) */
+    /** Trigger type: 'time' (delay), 'scroll' (scroll percentage), 'exit' (route exit), 'click' (element id), 'event' (host event) */
+    type: 'time' | 'scroll' | 'exit' | 'click' | 'event';
+    /** Value for the trigger (milliseconds for time, percentage for scroll, seconds for exit, element id for click, event name for event) */
     value?: number | string;
     /** Survey ID to show when triggered */
     surveyId: string;
+    /** Optional popup definition id (used to disambiguate repeated survey ids) */
+    popupId?: string;
 }
 /**
  * Options for showing a popup
@@ -67,17 +69,18 @@ interface DeepdotsEvent {
  */
 type EventListener = (event: DeepdotsEvent) => void;
 /** Tipo de trigger específico para definiciones de popup remotas */
-type PopupTriggerType = 'time_on_page' | 'scroll' | 'exit' | 'click';
+type PopupTriggerType = 'time_on_page' | 'scroll' | 'exit' | 'click' | 'event';
+type PopupTriggerConditionStatus = 'SHOWED' | 'PARTIAL' | 'COMPLETED';
+declare const POPUP_TRIGGER_CONDITION_STATUSES: PopupTriggerConditionStatus[];
 /** Condición adicional para la activación del popup */
 interface PopupTriggerCondition {
-    answered: boolean;
+    answered: PopupTriggerConditionStatus;
     cooldownDays: number;
 }
 /** Trigger asociado a la definición del popup */
 interface PopupTrigger {
     type: PopupTriggerType;
     value: number | string;
-    condition?: PopupTriggerCondition[];
 }
 /** Acción de aceptar (abrir encuesta) */
 interface PopupActionAccept {
@@ -125,7 +128,8 @@ interface PopupDefinition {
     id: string;
     title: string;
     message: string;
-    triggers: PopupTrigger;
+    triggers: PopupTrigger[];
+    cooldown?: PopupTriggerCondition[];
     actions?: PopupActions;
     surveyId: string;
     productId: string;
@@ -156,8 +160,10 @@ declare class DeepdotsPopups {
     private popupsLoaded;
     private pendingAutoLaunch;
     private answeredSurveys;
+    private surveyProgress;
     private lastShown;
     private surveyToPopupId;
+    private deferredExitTimers;
     private baseUrl;
     private env;
     /** Initialize the SDK with configuration */
@@ -179,12 +185,26 @@ declare class DeepdotsPopups {
     /** Deriva triggers desde las definiciones de popup */
     private configureTriggersFromDefinitions;
     /** Lógica para evaluar condiciones antes de mostrar una encuesta */
-    triggerSurvey(surveyId: string): void;
+    triggerSurvey(surveyId: string, popupId?: string): void;
+    /** Trigger popups configured with trigger.type = 'event' and matching trigger.value */
+    triggerEvent(eventName: string): void;
+    private showDefinition;
     private shouldShow;
     private matchesSegmentsPath;
-    private evaluateCondition;
+    private evaluateCooldown;
+    private evaluateLegacyCondition;
+    private hasCooldownElapsed;
     /** Marcar encuesta como contestada externamente */
     markSurveyAnswered(surveyId: string): void;
+    /** Queue an exit popup so it can render after navigation */
+    queueExitPopup(surveyId: string, delaySeconds: number, sourceUrl?: string, popupId?: string): void;
+    private processDeferredExitQueue;
+    private scheduleDeferredExitPopup;
+    private tryShowDeferredExitPopup;
+    private findPopupDefinition;
+    private removeDeferredExitPopup;
+    private getDeferredExitQueue;
+    private setDeferredExitQueue;
     /** Fetch al servidor para obtener popups */
     private fetchPopupsFromServer;
     /** Notifica eventos de popup a la API */
@@ -207,9 +227,20 @@ declare class DeepdotsPopups {
     debug(...args: unknown[]): void;
     /** Set a custom renderer */
     setRenderer(renderer: PopupRenderer): void;
+    private normalizeUrl;
+    private safeParseUrl;
+    private mapPopupTriggerType;
+    private markSurveyProgress;
     private isPopupDefinition;
+    private isPopupTrigger;
+    private isPopupTriggerType;
+    private isPopupTriggerCondition;
+    private isLegacyPopupTriggerCondition;
+    private normalizeTriggers;
+    private normalizeCooldown;
+    private normalizeLegacyConditions;
     private normalizePopupDefinition;
     private validatePopupDefinitions;
 }
 
-export { type DeepdotsConfig, type DeepdotsEvent, type DeepdotsEventType, DeepdotsPopups, type EventListener, type ShowOptions, type TriggerConfig };
+export { type DeepdotsConfig, type DeepdotsEvent, type DeepdotsEventType, DeepdotsPopups, type EventListener, POPUP_TRIGGER_CONDITION_STATUSES, type PopupDefinition, type PopupTrigger, type PopupTriggerCondition, type PopupTriggerConditionStatus, type ShowOptions, type TriggerConfig };

package/dist/index.d.ts

@@ -31,12 +31,14 @@ interface DeepdotsConfig {
  * Options for configuring survey triggers
  */
 interface TriggerConfig {
-    /** Trigger type: 'time' (delay), 'scroll' (scroll percentage), 'exit' (exit intent), 'click' (element id) */
-    type: 'time' | 'scroll' | 'exit' | 'click';
-    /** Value for the trigger (milliseconds for time, percentage for scroll, element id for click) */
+    /** Trigger type: 'time' (delay), 'scroll' (scroll percentage), 'exit' (route exit), 'click' (element id), 'event' (host event) */
+    type: 'time' | 'scroll' | 'exit' | 'click' | 'event';
+    /** Value for the trigger (milliseconds for time, percentage for scroll, seconds for exit, element id for click, event name for event) */
     value?: number | string;
     /** Survey ID to show when triggered */
     surveyId: string;
+    /** Optional popup definition id (used to disambiguate repeated survey ids) */
+    popupId?: string;
 }
 /**
  * Options for showing a popup
@@ -67,17 +69,18 @@ interface DeepdotsEvent {
  */
 type EventListener = (event: DeepdotsEvent) => void;
 /** Tipo de trigger específico para definiciones de popup remotas */
-type PopupTriggerType = 'time_on_page' | 'scroll' | 'exit' | 'click';
+type PopupTriggerType = 'time_on_page' | 'scroll' | 'exit' | 'click' | 'event';
+type PopupTriggerConditionStatus = 'SHOWED' | 'PARTIAL' | 'COMPLETED';
+declare const POPUP_TRIGGER_CONDITION_STATUSES: PopupTriggerConditionStatus[];
 /** Condición adicional para la activación del popup */
 interface PopupTriggerCondition {
-    answered: boolean;
+    answered: PopupTriggerConditionStatus;
     cooldownDays: number;
 }
 /** Trigger asociado a la definición del popup */
 interface PopupTrigger {
     type: PopupTriggerType;
     value: number | string;
-    condition?: PopupTriggerCondition[];
 }
 /** Acción de aceptar (abrir encuesta) */
 interface PopupActionAccept {
@@ -125,7 +128,8 @@ interface PopupDefinition {
     id: string;
     title: string;
     message: string;
-    triggers: PopupTrigger;
+    triggers: PopupTrigger[];
+    cooldown?: PopupTriggerCondition[];
     actions?: PopupActions;
     surveyId: string;
     productId: string;
@@ -156,8 +160,10 @@ declare class DeepdotsPopups {
     private popupsLoaded;
     private pendingAutoLaunch;
     private answeredSurveys;
+    private surveyProgress;
     private lastShown;
     private surveyToPopupId;
+    private deferredExitTimers;
     private baseUrl;
     private env;
     /** Initialize the SDK with configuration */
@@ -179,12 +185,26 @@ declare class DeepdotsPopups {
     /** Deriva triggers desde las definiciones de popup */
     private configureTriggersFromDefinitions;
     /** Lógica para evaluar condiciones antes de mostrar una encuesta */
-    triggerSurvey(surveyId: string): void;
+    triggerSurvey(surveyId: string, popupId?: string): void;
+    /** Trigger popups configured with trigger.type = 'event' and matching trigger.value */
+    triggerEvent(eventName: string): void;
+    private showDefinition;
     private shouldShow;
     private matchesSegmentsPath;
-    private evaluateCondition;
+    private evaluateCooldown;
+    private evaluateLegacyCondition;
+    private hasCooldownElapsed;
     /** Marcar encuesta como contestada externamente */
     markSurveyAnswered(surveyId: string): void;
+    /** Queue an exit popup so it can render after navigation */
+    queueExitPopup(surveyId: string, delaySeconds: number, sourceUrl?: string, popupId?: string): void;
+    private processDeferredExitQueue;
+    private scheduleDeferredExitPopup;
+    private tryShowDeferredExitPopup;
+    private findPopupDefinition;
+    private removeDeferredExitPopup;
+    private getDeferredExitQueue;
+    private setDeferredExitQueue;
     /** Fetch al servidor para obtener popups */
     private fetchPopupsFromServer;
     /** Notifica eventos de popup a la API */
@@ -207,9 +227,20 @@ declare class DeepdotsPopups {
     debug(...args: unknown[]): void;
     /** Set a custom renderer */
     setRenderer(renderer: PopupRenderer): void;
+    private normalizeUrl;
+    private safeParseUrl;
+    private mapPopupTriggerType;
+    private markSurveyProgress;
     private isPopupDefinition;
+    private isPopupTrigger;
+    private isPopupTriggerType;
+    private isPopupTriggerCondition;
+    private isLegacyPopupTriggerCondition;
+    private normalizeTriggers;
+    private normalizeCooldown;
+    private normalizeLegacyConditions;
     private normalizePopupDefinition;
     private validatePopupDefinitions;
 }
 
-export { type DeepdotsConfig, type DeepdotsEvent, type DeepdotsEventType, DeepdotsPopups, type EventListener, type ShowOptions, type TriggerConfig };
+export { type DeepdotsConfig, type DeepdotsEvent, type DeepdotsEventType, DeepdotsPopups, type EventListener, POPUP_TRIGGER_CONDITION_STATUSES, type PopupDefinition, type PopupTrigger, type PopupTriggerCondition, type PopupTriggerConditionStatus, type ShowOptions, type TriggerConfig };