@magicfeedback/popup-sdk 1.1.5 → 1.1.6

package/dist/react-native.d.mts

@@ -105,6 +105,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 +123,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. */
@@ -280,6 +293,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;

package/dist/react-native.d.ts

@@ -105,6 +105,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 +123,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. */
@@ -280,6 +293,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;

package/dist/react-native.js

@@ -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,12 +2008,13 @@ 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 = [];
@@ -2506,7 +2530,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 +2554,9 @@ var CrashReporter = class {
   }
 };
 
+// src/core/deepdots-popups.ts
+init_logger();
+
 // src/analytics/messaging.ts
 function buildMessageParams(stage, o) {
   const p = {
@@ -2558,6 +2585,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 +2622,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,7 +2663,7 @@ 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,
@@ -3341,7 +3372,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 +3381,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 */