@magicfeedback/popup-sdk 1.1.3 → 1.1.4

package/dist/react-native.d.mts

@@ -240,6 +240,28 @@ interface ReactNativeErrorUtils {
     setGlobalHandler(handler: (error: unknown, isFatal?: boolean) => void): void;
 }
 
+/**
+ * Messaging (#18–22): tracking de notificaciones del host (push / in-app).
+ * Un único evento reservado `deepdots_message` con un campo `stage` discriminador;
+ * el funnel se correlaciona por `message_id` y se agrupa por `message_title`.
+ */
+type MessageStage = 'delivered' | 'clicked' | 'converted';
+interface TrackMessageOptions {
+    /** Identificador del mensaje/notificación — correlaciona el funnel delivered→clicked→converted. */
+    id: string;
+    /** Título del mensaje — dimensión de agrupación de #18–22. */
+    title: string;
+    /** Canal de entrega. */
+    channel: 'push' | 'in_app';
+    /** Nombre de la campaña (opcional). */
+    campaign?: string;
+    /** Valor de conversión (opcional, típico en `stage: 'converted'`). */
+    value?: number;
+    currency?: string;
+    /** Parámetros libres adicionales. */
+    params?: Record<string, unknown>;
+}
+
 /**
  * Main class for managing survey popups
  */
@@ -311,6 +333,8 @@ declare class DeepdotsPopups {
     trackFindabilityFriction(frictionTopic: string, params?: Record<string, unknown>): void;
     /** Funnel: un paso del embudo, correlacionado por `taskId`. El backend reconstruye conversión/drop-off/tiempo. */
     trackFunnelStep(funnel: string, step: string, taskId: string, params?: Record<string, unknown>): void;
+    /** Messaging (#18–22): registra una etapa del funnel de una notificación (push/in-app). No-op si tracking off. */
+    trackMessage(stage: MessageStage, options: TrackMessageOptions): void;
     /**
      * Navegación MANUAL (entornos sin History API, p. ej. React Native con React Navigation).
      * El host la llama en cada cambio de pantalla; emite `page_view` al salir de la anterior.

package/dist/react-native.d.ts

@@ -240,6 +240,28 @@ interface ReactNativeErrorUtils {
     setGlobalHandler(handler: (error: unknown, isFatal?: boolean) => void): void;
 }
 
+/**
+ * Messaging (#18–22): tracking de notificaciones del host (push / in-app).
+ * Un único evento reservado `deepdots_message` con un campo `stage` discriminador;
+ * el funnel se correlaciona por `message_id` y se agrupa por `message_title`.
+ */
+type MessageStage = 'delivered' | 'clicked' | 'converted';
+interface TrackMessageOptions {
+    /** Identificador del mensaje/notificación — correlaciona el funnel delivered→clicked→converted. */
+    id: string;
+    /** Título del mensaje — dimensión de agrupación de #18–22. */
+    title: string;
+    /** Canal de entrega. */
+    channel: 'push' | 'in_app';
+    /** Nombre de la campaña (opcional). */
+    campaign?: string;
+    /** Valor de conversión (opcional, típico en `stage: 'converted'`). */
+    value?: number;
+    currency?: string;
+    /** Parámetros libres adicionales. */
+    params?: Record<string, unknown>;
+}
+
 /**
  * Main class for managing survey popups
  */
@@ -311,6 +333,8 @@ declare class DeepdotsPopups {
     trackFindabilityFriction(frictionTopic: string, params?: Record<string, unknown>): void;
     /** Funnel: un paso del embudo, correlacionado por `taskId`. El backend reconstruye conversión/drop-off/tiempo. */
     trackFunnelStep(funnel: string, step: string, taskId: string, params?: Record<string, unknown>): void;
+    /** Messaging (#18–22): registra una etapa del funnel de una notificación (push/in-app). No-op si tracking off. */
+    trackMessage(stage: MessageStage, options: TrackMessageOptions): void;
     /**
      * Navegación MANUAL (entornos sin History API, p. ej. React Native con React Navigation).
      * El host la llama en cada cambio de pantalla; emite `page_view` al salir de la anterior.

package/dist/react-native.js

@@ -2460,11 +2460,27 @@ var CrashReporter = class {
   }
 };
 
+// src/analytics/messaging.ts
+function buildMessageParams(stage, o) {
+  const p = {
+    stage,
+    message_id: o.id,
+    message_title: o.title,
+    channel: o.channel
+  };
+  if (o.campaign) p.campaign = o.campaign;
+  if (o.value !== void 0) p.value = o.value;
+  if (o.currency) p.currency = o.currency;
+  return { ...p, ...o.params ?? {} };
+}
+
 // src/core/deepdots-popups.ts
 var EXIT_QUEUE_STORAGE_KEY = "__deepdots_exit_popup_queue__";
 var DAY_IN_MS = 24 * 60 * 60 * 1e3;
 var ANALYTICS_MAX_BATCH_SIZE = 20;
 var ANALYTICS_FLUSH_INTERVAL_MS = 3e4;
+var RESERVED_EVENT_PREFIX = "deepdots_";
+var CUSTOM_EVENT_PREFIX = "deepdots_event_";
 var DeepdotsPopups = class {
   constructor() {
     this.config = null;
@@ -2617,8 +2633,9 @@ var DeepdotsPopups = class {
   /** Registra un evento de analítica (modelo GA: nombre + params). No-op si tracking off. */
   track(name, params) {
     if (!this.tracking?.isTrackingEnabled()) return;
-    this.analytics?.track(name, params);
-    this.log("analytics \xB7 track:", name, params ?? {});
+    const eventName = name.startsWith(RESERVED_EVENT_PREFIX) ? name : `${CUSTOM_EVENT_PREFIX}${name}`;
+    this.analytics?.track(eventName, params);
+    this.log("analytics \xB7 track:", eventName, params ?? {});
   }
   /** User attributes para breakdowns (registration_status, pass_type, sector, pass_status…). */
   setUserAttributes(attributes) {
@@ -2670,6 +2687,10 @@ var DeepdotsPopups = class {
   trackFunnelStep(funnel, step, taskId, params) {
     this.track("deepdots_funnel_step", { funnel, step, task_id: taskId, ...params ?? {} });
   }
+  /** Messaging (#18–22): registra una etapa del funnel de una notificación (push/in-app). No-op si tracking off. */
+  trackMessage(stage, options) {
+    this.track("deepdots_message", buildMessageParams(stage, options));
+  }
   /**
    * Navegación MANUAL (entornos sin History API, p. ej. React Native con React Navigation).
    * El host la llama en cada cambio de pantalla; emite `page_view` al salir de la anterior.