@magicfeedback/popup-sdk 1.1.6 → 1.1.7

package/dist/index.d.mts

@@ -86,6 +86,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[];
 }
@@ -103,7 +105,8 @@ type AnalyticsSink = (payload: AnalyticsEnvelope) => void;
  *  - 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
  */
 
@@ -119,6 +122,7 @@ interface AnalyticsFeedbackBody {
     feedback: {
         text: string;
         answers: FeedbackKV[];
+        metrics: FeedbackKV[];
         metadata: FeedbackKV[];
         profile: FeedbackKV[];
         finished: boolean;
@@ -185,6 +189,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;
     /**
@@ -529,6 +539,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/index.d.ts

@@ -86,6 +86,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[];
 }
@@ -103,7 +105,8 @@ type AnalyticsSink = (payload: AnalyticsEnvelope) => void;
  *  - 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
  */
 
@@ -119,6 +122,7 @@ interface AnalyticsFeedbackBody {
     feedback: {
         text: string;
         answers: FeedbackKV[];
+        metrics: FeedbackKV[];
         metadata: FeedbackKV[];
         profile: FeedbackKV[];
         finished: boolean;
@@ -185,6 +189,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;
     /**
@@ -529,6 +539,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/index.js

@@ -146,8 +146,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) {
@@ -3957,6 +3957,8 @@ 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;
@@ -3979,6 +3981,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.
@@ -4042,7 +4052,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]
     };
@@ -4098,10 +4109,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
@@ -4282,20 +4298,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 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("https://ipapi.co/json/");
+    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
@@ -4606,7 +4697,11 @@ var DeepdotsPopups = class {
     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,
@@ -4623,8 +4718,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();
@@ -4681,6 +4781,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;