@magicfeedback/popup-sdk 1.1.5 → 1.1.7

package/dist/react-native.d.mts

@@ -76,6 +76,8 @@ interface AnalyticsEnvelope {
         device?: DeviceInfo;
         /** User attributes del cliente, usados para breakdowns (registration_status, pass_type, …). */
         attributes: Record<string, string>;
+        /** Métricas del host: valores medibles persistentes → van en `feedback.metrics` del body. */
+        metrics?: Record<string, string>;
     };
     events: AnalyticsEvent[];
 }
@@ -92,7 +94,8 @@ interface AnalyticsEnvelope {
  *  - cada entrada usa `value: string[]` (array de un elemento)
  *  - eventos: {key: nombre_evento, value: [JSON(timestamp + params)]}
  *  - identidad (user_id) → `profile` como `external-user-id`
- *  - `answers` vacío, `metrics` no se usa
+ *  - métricas del host (setMetric) → `feedback.metrics` (mismo shape que metadata, sin prefijo)
+ *  - `answers` vacío
  *  - `text` vacío
  */
 
@@ -105,6 +108,17 @@ interface AnalyticsKeys {
  * Configuration options for initializing the DeepdotsPopups SDK
  */
 
+/**
+ * Custom logger to receive the SDK's debug output instead of the console.
+ * Only `log` is required; `warn`/`error`/`info` fall back to `log` when omitted.
+ * Lets the host pipe debug output to a file, Firebase, etc. `console` satisfies this shape.
+ */
+interface DeepdotsLogger {
+    log: (...args: unknown[]) => void;
+    warn?: (...args: unknown[]) => void;
+    error?: (...args: unknown[]) => void;
+    info?: (...args: unknown[]) => void;
+}
 interface DeepdotsInitParams {
     /** API key for authentication */
     apiKey?: string;
@@ -112,6 +126,8 @@ interface DeepdotsInitParams {
     nodeEnv?: 'development' | 'production';
     /** Enable debug logging */
     debug?: boolean;
+    /** Custom logger for debug output. When set (and `debug` is true), the SDK routes its logs here instead of `console`. Default: `console`. */
+    logger?: DeepdotsLogger;
     /** Optional user id to send with popup events */
     userId?: string;
     /** Starts tracking enabled (default) or disabled (e.g. until consent is granted). Equivalent to calling `setTrackingEnabled` after init. */
@@ -122,6 +138,12 @@ interface DeepdotsInitParams {
     storage?: KeyValueStorage;
     /** Platform used in the analytics envelope. Default is 'web'; in RN pass 'android'/'ios'. */
     platform?: 'web' | 'android' | 'ios';
+    /**
+     * BCP-47 language tag for the analytics context (e.g. 'es-ES'). If omitted, the SDK
+     * auto-detects: `navigator.language` on web, or the `Intl` locale as a fallback (works in
+     * React Native with Hermes, where `navigator.language` is absent).
+     */
+    language?: string;
     /** Injectable device info (RN: from react-native-device-info). If missing, it is derived from the browser. */
     device?: DeviceInfo;
     /**
@@ -280,6 +302,8 @@ declare class DeepdotsPopups {
     private triggers;
     private initialized;
     private renderer;
+    /** Logger para el output de debug. Default `console`; el host puede inyectar el suyo en init(). */
+    private logger;
     private popupContainer;
     private popupDefinitions;
     private popupsLoaded;
@@ -321,6 +345,11 @@ declare class DeepdotsPopups {
     track(name: string, params?: Record<string, unknown>): void;
     /** User attributes para breakdowns (registration_status, pass_type, sector, pass_status…). */
     setUserAttributes(attributes: Record<string, string | number | boolean>): void;
+    /**
+     * Registra/actualiza una métrica (valor medible) → `feedback.metrics` del body.
+     * Persistente y sobrescribe por key. No-op si tracking off.
+     */
+    setMetric(key: string, value: string | number | boolean): void;
     /** Reporta un error del host (manejado o no) → evento `deepdots_app_crash`. No-op si tracking off. */
     reportError(error: unknown, options?: ReportErrorOptions): void;
     /** Engancha `global.ErrorUtils` de RN para capturar errores JS no manejados. No-op si tracking off. */

package/dist/react-native.d.ts

@@ -76,6 +76,8 @@ interface AnalyticsEnvelope {
         device?: DeviceInfo;
         /** User attributes del cliente, usados para breakdowns (registration_status, pass_type, …). */
         attributes: Record<string, string>;
+        /** Métricas del host: valores medibles persistentes → van en `feedback.metrics` del body. */
+        metrics?: Record<string, string>;
     };
     events: AnalyticsEvent[];
 }
@@ -92,7 +94,8 @@ interface AnalyticsEnvelope {
  *  - cada entrada usa `value: string[]` (array de un elemento)
  *  - eventos: {key: nombre_evento, value: [JSON(timestamp + params)]}
  *  - identidad (user_id) → `profile` como `external-user-id`
- *  - `answers` vacío, `metrics` no se usa
+ *  - métricas del host (setMetric) → `feedback.metrics` (mismo shape que metadata, sin prefijo)
+ *  - `answers` vacío
  *  - `text` vacío
  */
 
@@ -105,6 +108,17 @@ interface AnalyticsKeys {
  * Configuration options for initializing the DeepdotsPopups SDK
  */
 
+/**
+ * Custom logger to receive the SDK's debug output instead of the console.
+ * Only `log` is required; `warn`/`error`/`info` fall back to `log` when omitted.
+ * Lets the host pipe debug output to a file, Firebase, etc. `console` satisfies this shape.
+ */
+interface DeepdotsLogger {
+    log: (...args: unknown[]) => void;
+    warn?: (...args: unknown[]) => void;
+    error?: (...args: unknown[]) => void;
+    info?: (...args: unknown[]) => void;
+}
 interface DeepdotsInitParams {
     /** API key for authentication */
     apiKey?: string;
@@ -112,6 +126,8 @@ interface DeepdotsInitParams {
     nodeEnv?: 'development' | 'production';
     /** Enable debug logging */
     debug?: boolean;
+    /** Custom logger for debug output. When set (and `debug` is true), the SDK routes its logs here instead of `console`. Default: `console`. */
+    logger?: DeepdotsLogger;
     /** Optional user id to send with popup events */
     userId?: string;
     /** Starts tracking enabled (default) or disabled (e.g. until consent is granted). Equivalent to calling `setTrackingEnabled` after init. */
@@ -122,6 +138,12 @@ interface DeepdotsInitParams {
     storage?: KeyValueStorage;
     /** Platform used in the analytics envelope. Default is 'web'; in RN pass 'android'/'ios'. */
     platform?: 'web' | 'android' | 'ios';
+    /**
+     * BCP-47 language tag for the analytics context (e.g. 'es-ES'). If omitted, the SDK
+     * auto-detects: `navigator.language` on web, or the `Intl` locale as a fallback (works in
+     * React Native with Hermes, where `navigator.language` is absent).
+     */
+    language?: string;
     /** Injectable device info (RN: from react-native-device-info). If missing, it is derived from the browser. */
     device?: DeviceInfo;
     /**
@@ -280,6 +302,8 @@ declare class DeepdotsPopups {
     private triggers;
     private initialized;
     private renderer;
+    /** Logger para el output de debug. Default `console`; el host puede inyectar el suyo en init(). */
+    private logger;
     private popupContainer;
     private popupDefinitions;
     private popupsLoaded;
@@ -321,6 +345,11 @@ declare class DeepdotsPopups {
     track(name: string, params?: Record<string, unknown>): void;
     /** User attributes para breakdowns (registration_status, pass_type, sector, pass_status…). */
     setUserAttributes(attributes: Record<string, string | number | boolean>): void;
+    /**
+     * Registra/actualiza una métrica (valor medible) → `feedback.metrics` del body.
+     * Persistente y sobrescribe por key. No-op si tracking off.
+     */
+    setMetric(key: string, value: string | number | boolean): void;
     /** Reporta un error del host (manejado o no) → evento `deepdots_app_crash`. No-op si tracking off. */
     reportError(error: unknown, options?: ReportErrorOptions): void;
     /** Engancha `global.ErrorUtils` de RN para capturar errores JS no manejados. No-op si tracking off. */

package/dist/react-native.js

@@ -143,8 +143,8 @@ var init_tracking_manager = __esm({
 
 // src/ui/font.ts
 function fontFormatFromUrl(url) {
-  const clean = url.split("?")[0].split("#")[0];
-  const ext = clean.slice(clean.lastIndexOf(".") + 1).toLowerCase();
+  const clean2 = url.split("?")[0].split("#")[0];
+  const ext = clean2.slice(clean2.lastIndexOf(".") + 1).toLowerCase();
   return FORMAT_BY_EXT[ext];
 }
 function sanitizeFamily(family) {
@@ -178,6 +178,27 @@ var init_font = __esm({
   }
 });
 
+// src/util/logger.ts
+function setLogger(logger) {
+  active = logger ?? console;
+}
+function sdkLog(...args) {
+  active.log(...args);
+}
+function sdkWarn(...args) {
+  (active.warn ?? active.log)(...args);
+}
+function sdkError(...args) {
+  (active.error ?? active.log)(...args);
+}
+var active;
+var init_logger = __esm({
+  "src/util/logger.ts"() {
+    "use strict";
+    active = console;
+  }
+});
+
 // src/assets/style.css
 var style_default;
 var init_style = __esm({
@@ -1431,7 +1452,7 @@ async function renderPopup(container, surveyId, productId, actions, emit, onClos
   let formInstance = null;
   try {
     if (!import_native.default || typeof import_native.default.form !== "function") {
-      console.warn("[MagicFeedback] form() no disponible. Fallback manual.");
+      sdkWarn("[MagicFeedback] form() no disponible. Fallback manual.");
       setLoading(false);
       return;
     }
@@ -1518,7 +1539,7 @@ async function renderPopup(container, surveyId, productId, actions, emit, onClos
           }
         }
         if (s.startMessage && s.startMessage !== "") {
-          console.log(s.startMessage);
+          sdkLog(s.startMessage);
           updateButtons("start");
         } else {
           updateButtons("in_progress_first");
@@ -1573,11 +1594,11 @@ async function renderPopup(container, surveyId, productId, actions, emit, onClos
       }
     };
     formInstance.generate(formDivId, generateOptions).catch((err) => {
-      console.error("[MagicFeedback] Error generating form:", err);
+      sdkError("[MagicFeedback] Error generating form:", err);
       setLoading(false);
     });
   } catch (e) {
-    console.error("[MagicFeedback] Exception initializing form:", e);
+    sdkError("[MagicFeedback] Exception initializing form:", e);
     setLoading(false);
   }
 }
@@ -1587,6 +1608,7 @@ var init_renderPopup = __esm({
     "use strict";
     init_tracking_manager();
     init_font();
+    init_logger();
     import_native = __toESM(require("@magicfeedback/native"));
     init_style();
   }
@@ -1848,6 +1870,7 @@ function buildSurveyHtml(opts) {
 }
 
 // src/platform/react-native-renderer.ts
+init_logger();
 var ReactNativePopupRenderer = class {
   constructor(options = {}) {
     this.options = options;
@@ -1868,7 +1891,7 @@ var ReactNativePopupRenderer = class {
     if (this.options.onShow) {
       this.options.onShow({ surveyId, productId, html });
     } else {
-      console.warn(
+      sdkWarn(
         "[Deepdots] ReactNativePopupRenderer sin onShow: pasa { onShow } a new ReactNativePopupRenderer({...}) para montar el WebView del survey."
       );
     }
@@ -1985,16 +2008,19 @@ function createDefaultRenderer() {
 init_tracking_manager();
 
 // src/analytics/analytics-manager.ts
-var dryRunSink = (payload) => {
-  console.log(
+function createDryRunSink(log = console.log) {
+  return (payload) => log(
     "[DeepdotsAnalytics] (dry-run \xB7 NO enviado \xB7 sin init.analytics) POST /sdk/feedback \u2192",
     JSON.stringify(payload, null, 2)
   );
-};
+}
+var dryRunSink = createDryRunSink();
 var AnalyticsManager = class {
   constructor(options = {}) {
     this.events = [];
     this.attributes = {};
+    /** Métricas del host (valores medibles persistentes). Sobrescriben por key; se reenvían en cada flush. */
+    this.metrics = {};
     /** Mini-services activos: nombre → timestamp de entrada. El orden de inserción marca el "más reciente". */
     this.activeMiniServices = /* @__PURE__ */ new Map();
     this.sink = options.sink ?? dryRunSink;
@@ -2017,6 +2043,14 @@ var AnalyticsManager = class {
       this.attributes[k] = String(v);
     }
   }
+  /**
+   * Registra/actualiza una métrica (valor medible). Persistente: se reenvía en cada flush.
+   * Repetir la misma key SOBRESCRIBE; el valor se coerciona a string; ignora key vacía.
+   */
+  setMetric(key, value) {
+    if (!key) return;
+    this.metrics[key] = String(value);
+  }
   /**
    * Marca el inicio de un mini-service; etiqueta los eventos siguientes con `mini_service`.
    * Admite varios activos a la vez (concurrencia); el "actual" para etiquetar es el más reciente.
@@ -2080,7 +2114,8 @@ var AnalyticsManager = class {
         platform: this.platform,
         language: this.language,
         device: this.device,
-        attributes: { ...this.attributes }
+        attributes: { ...this.attributes },
+        metrics: { ...this.metrics }
       },
       events: [...this.events]
     };
@@ -2136,10 +2171,15 @@ function buildAnalyticsFeedbackBody(envelope, keys, feedbackSessionId) {
       value: [JSON.stringify({ timestamp: e.timestamp, ...e.params ?? {} })]
     });
   }
+  const metrics = [];
+  for (const [k, v] of Object.entries(context.metrics ?? {})) {
+    pushKV(metrics, k, v);
+  }
   return {
     feedback: {
       text: "",
       answers: [],
+      metrics,
       metadata,
       profile,
       finished: false
@@ -2320,20 +2360,95 @@ function collectDeviceInfo(appVersion) {
 }
 
 // src/analytics/geo-info.ts
-async function collectGeoInfo(fetchImpl) {
-  const f = fetchImpl ?? (typeof fetch !== "undefined" ? fetch : void 0);
-  if (!f) return null;
+var GEO_STORAGE_KEY = "deepdots.geo";
+var GEO_TTL_MS = 30 * 24 * 60 * 60 * 1e3;
+var GEO_TIMEOUT_MS = 3e3;
+function readCachedGeo(storage, now) {
   try {
-    const res = await f("https://ipapi.co/json/");
+    const raw = storage.getItem(GEO_STORAGE_KEY);
+    if (!raw) return null;
+    const cached = JSON.parse(raw);
+    if (typeof cached.ts !== "number" || now - cached.ts > GEO_TTL_MS) return null;
+    const geo = {};
+    if (cached.country) geo.country = cached.country;
+    if (cached.city) geo.city = cached.city;
+    return geo.country || geo.city ? geo : null;
+  } catch {
+    return null;
+  }
+}
+function writeCachedGeo(storage, geo, now) {
+  try {
+    const payload = { ...geo, ts: now };
+    storage.setItem(GEO_STORAGE_KEY, JSON.stringify(payload));
+  } catch {
+  }
+}
+var DEFAULT_GEO_PROVIDERS = [
+  {
+    // https://ipapi.co/json/
+    url: "https://ipapi.co/json/",
+    parse: (d) => geoFrom(d.country_code, d.city)
+  },
+  {
+    // https://ipwho.is/ (devuelve success:false con 200 en errores)
+    url: "https://ipwho.is/",
+    parse: (d) => d.success === false ? null : geoFrom(d.country_code, d.city)
+  },
+  {
+    // https://ipinfo.io/json (country = código ISO)
+    url: "https://ipinfo.io/json",
+    parse: (d) => geoFrom(d.country, d.city)
+  }
+];
+function geoFrom(country, city) {
+  const c = typeof country === "string" && country ? country : void 0;
+  const t = typeof city === "string" && city ? city : void 0;
+  if (!c && !t) return null;
+  return { country: c, city: t };
+}
+async function fetchOne(provider, f, timeoutMs) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const res = await f(provider.url, { signal: controller.signal });
     if (!res.ok) return null;
     const data = await res.json();
-    const country = data.country_code || void 0;
-    const city = data.city || void 0;
-    if (!country && !city) return null;
-    return { country, city };
+    return provider.parse(data);
   } catch {
     return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function fetchGeo(options = {}) {
+  const f = options.fetchImpl ?? (typeof fetch !== "undefined" ? fetch : void 0);
+  if (!f) return null;
+  const providers = options.providers ?? DEFAULT_GEO_PROVIDERS;
+  const timeoutMs = options.timeoutMs ?? GEO_TIMEOUT_MS;
+  for (const provider of providers) {
+    const geo = await fetchOne(provider, f, timeoutMs);
+    if (geo) return geo;
+  }
+  return null;
+}
+
+// src/analytics/language.ts
+function clean(value) {
+  const trimmed = value?.trim();
+  return trimmed ? trimmed : void 0;
+}
+function resolveLanguage(sources) {
+  const explicit = clean(sources.explicit);
+  if (explicit) return explicit;
+  const navLang = clean(sources.navigator?.language);
+  if (navLang) return navLang;
+  try {
+    const locale = clean(sources.intl?.DateTimeFormat().resolvedOptions().locale);
+    if (locale) return locale;
+  } catch {
   }
+  return void 0;
 }
 
 // src/analytics/engagement-tracker.ts
@@ -2506,7 +2621,7 @@ var CrashReporter = class {
   }
   /** Instala los handlers globales de errores no capturados (no-op sin `window`). */
   install() {
-    if (typeof window === "undefined") return;
+    if (typeof window === "undefined" || typeof window.addEventListener !== "function") return;
     window.addEventListener("error", (e) => {
       if (!this.isEnabled()) return;
       this.captureUnhandled(e.error ?? e.message ?? "error");
@@ -2530,6 +2645,9 @@ var CrashReporter = class {
   }
 };
 
+// src/core/deepdots-popups.ts
+init_logger();
+
 // src/analytics/messaging.ts
 function buildMessageParams(stage, o) {
   const p = {
@@ -2558,6 +2676,8 @@ var DeepdotsPopups = class {
     this.triggers = [];
     this.initialized = false;
     this.renderer = createDefaultRenderer();
+    /** Logger para el output de debug. Default `console`; el host puede inyectar el suyo en init(). */
+    this.logger = console;
     this.popupContainer = null;
     // deprecated: mantenido para compatibilidad interna
     this.popupDefinitions = [];
@@ -2593,6 +2713,8 @@ var DeepdotsPopups = class {
   }
   /** Initialize the SDK with configuration */
   init(config) {
+    this.logger = config.logger ?? console;
+    setLogger(this.logger);
     if (this.initialized) {
       this.log("SDK already initialized");
       return;
@@ -2632,12 +2754,16 @@ var DeepdotsPopups = class {
       onSessionId: (id) => {
         this.analyticsFeedbackSessionId = id;
       }
-    }) : void 0;
+    }) : createDryRunSink((...a) => this.logger.log(...a));
     const device = config.device ?? collectDeviceInfo(config.appVersion);
     this.analytics = new AnalyticsManager({
       sink: analyticsSink,
       publicKey: config.analytics?.publicKey ?? this.config.apiKey,
-      language: typeof navigator !== "undefined" ? navigator.language : void 0,
+      language: resolveLanguage({
+        explicit: config.language,
+        navigator: typeof navigator !== "undefined" ? navigator : void 0,
+        intl: typeof Intl !== "undefined" ? Intl : void 0
+      }),
       platform: config.platform ?? "web",
       device,
       maxBatchSize: ANALYTICS_MAX_BATCH_SIZE,
@@ -2654,8 +2780,13 @@ var DeepdotsPopups = class {
     if (this.tracking?.isTrackingEnabled()) {
       this.crashReporter.install();
     }
-    collectGeoInfo().then((geo) => {
-      if (geo) this.analytics?.updateDevice(geo);
+    const cachedGeo = readCachedGeo(storage, Date.now());
+    if (cachedGeo) this.analytics.updateDevice(cachedGeo);
+    fetchGeo().then((geo) => {
+      if (geo) {
+        this.analytics?.updateDevice(geo);
+        writeCachedGeo(storage, geo, Date.now());
+      }
     }).catch(() => {
     });
     this.navObserver = new NavigationObserver();
@@ -2712,6 +2843,15 @@ var DeepdotsPopups = class {
     if (!this.tracking?.isTrackingEnabled()) return;
     this.analytics?.setUserAttributes(attributes);
   }
+  /**
+   * Registra/actualiza una métrica (valor medible) → `feedback.metrics` del body.
+   * Persistente y sobrescribe por key. No-op si tracking off.
+   */
+  setMetric(key, value) {
+    if (!this.tracking?.isTrackingEnabled()) return;
+    this.analytics?.setMetric(key, value);
+    this.log("analytics \xB7 setMetric:", key, value);
+  }
   /** Reporta un error del host (manejado o no) → evento `deepdots_app_crash`. No-op si tracking off. */
   reportError(error, options) {
     if (!this.tracking?.isTrackingEnabled()) return;
@@ -3341,7 +3481,8 @@ var DeepdotsPopups = class {
         try {
           listener(event);
         } catch (error) {
-          console.error("Error in event listener:", error);
+          if (this.logger.error) this.logger.error("Error in event listener:", error);
+          else this.logger.log("Error in event listener:", error);
         }
       });
     }
@@ -3349,7 +3490,7 @@ var DeepdotsPopups = class {
   /** Log debug messages */
   log(...args) {
     if (this.config?.debug) {
-      console.log("[DeepdotsPopups]", ...args);
+      this.logger.log("[DeepdotsPopups]", ...args);
     }
   }
   /** External debug method for triggers */