@pulseboard/react-native 0.2.1 → 0.2.3

package/dist/index.mjs

@@ -1,4 +1,5 @@
 import { TurboModuleRegistry, Dimensions, Platform, I18nManager } from 'react-native';
+import AsyncStorage from '@react-native-async-storage/async-storage';
 
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __commonJS = (cb, mod) => function __require() {
@@ -376,6 +377,60 @@ var PulseBoardClient = class {
       return false;
     }
   }
+  // ─── Log Entry ─────────────────────────────────────────────
+  async sendLog(entry) {
+    try {
+      const response = await fetch(`${this.host}/logs`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(entry)
+      });
+      if (!response.ok) {
+        this.log(`Failed to send log: ${response.status}`);
+        return false;
+      }
+      return true;
+    } catch (err) {
+      this.log(`Network error sending log: ${err}`);
+      return false;
+    }
+  }
+  async sendLogBatch(apiKey, logs) {
+    try {
+      const response = await fetch(`${this.host}/logs/batch`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ apiKey, logs })
+      });
+      if (!response.ok) {
+        this.log(`Failed to send log batch: ${response.status}`);
+        return false;
+      }
+      return true;
+    } catch (err) {
+      this.log(`Network error sending log batch: ${err}`);
+      return false;
+    }
+  }
+  // ─── Feedback ─────────────────────────────────────────────────────
+  async sendFeedback(payload) {
+    try {
+      const response = await fetch(`${this.host}/feedback`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(payload)
+      });
+      if (!response.ok) {
+        this.log(`Failed to send feedback: ${response.status}`);
+        return false;
+      }
+      this.log("Feedback sent");
+      return true;
+    } catch (err) {
+      this.log(`Network error sending feedback: ${err}`);
+      return false;
+    }
+  }
   // ─── Private ──────────────────────────────────────────────────────
   chunk(arr, size) {
     return Array.from(
@@ -491,30 +546,63 @@ var ContextCollector = class {
     };
   }
 };
-
-// src/queue.ts
+var QUEUE_KEY = "@pulseboard/event_queue";
+var MAX_QUEUE_SIZE = 100;
 var EventQueue = class {
-  constructor(maxSize = 100) {
-    this.queue = [];
+  constructor(maxSize = MAX_QUEUE_SIZE) {
+    this.memoryQueue = [];
+    this._hydrated = false;
     this.maxSize = maxSize;
+    this.hydrate();
+  }
+  // ─── Hydrate from storage on init ─────────────────────────────────
+  async hydrate() {
+    try {
+      const raw = await AsyncStorage.getItem(QUEUE_KEY);
+      if (raw) {
+        const stored = JSON.parse(raw);
+        this.memoryQueue = stored.slice(0, this.maxSize);
+      }
+    } catch {
+    } finally {
+      this._hydrated = true;
+    }
+  }
+  // ─── Persist to storage ────────────────────────────────────────────
+  async persist() {
+    try {
+      await AsyncStorage.setItem(QUEUE_KEY, JSON.stringify(this.memoryQueue));
+    } catch {
+    }
   }
+  // ─── Public API ────────────────────────────────────────────────────
   enqueue(event) {
-    if (this.queue.length >= this.maxSize) {
-      this.queue.shift();
+    if (this.memoryQueue.length >= this.maxSize) {
+      this.memoryQueue.shift();
     }
-    this.queue.push(event);
+    this.memoryQueue.push(event);
+    this.persist();
   }
   dequeue(count) {
-    return this.queue.splice(0, count);
+    const batch = this.memoryQueue.splice(0, count);
+    this.persist();
+    return batch;
   }
   get size() {
-    return this.queue.length;
+    return this.memoryQueue.length;
   }
   get isEmpty() {
-    return this.queue.length === 0;
+    return this.memoryQueue.length === 0;
+  }
+  get hydrated() {
+    return this._hydrated;
   }
-  clear() {
-    this.queue = [];
+  async clear() {
+    this.memoryQueue = [];
+    try {
+      await AsyncStorage.removeItem(QUEUE_KEY);
+    } catch {
+    }
   }
 };
 
@@ -529,25 +617,70 @@ var PulseBoardSDK = class {
     this.flushTimer = null;
     this.initialized = false;
     this.PULSEBOARD_API = "https://pulseboard-production.up.railway.app/";
+    // ─── Log queue ────────────────────────────────────────────────────
+    this.logQueue = [];
+    this.logFlushTimer = null;
+    this.originalConsole = {};
+    this.consoleCapturing = false;
+  }
+  get apiKey() {
+    return this.config?.apiKey ?? "";
   }
   // ─── Public API ───────────────────────────────────────────────────
   init(config) {
     if (this.initialized) {
-      this.log("SDK already initialized \u2014 skipping");
+      this.debugLog("SDK already initialized \u2014 skipping");
       return;
     }
+    const hasDirectKey = !!config.apiKey;
+    const hasIdentifiers = !!(config.organisation && config.product && config.project);
+    if (!hasDirectKey && !hasIdentifiers) {
+      throw new Error(
+        "[PulseBoard] init() requires either apiKey or (organisation + product + project)"
+      );
+    }
     this.config = {
       autoCapture: true,
       debug: false,
       flushInterval: 5e3,
       maxQueueSize: 100,
-      ...config
+      ...config,
+      apiKey: config.apiKey ?? ""
+      // resolved below if using identifiers
     };
     this.client = new PulseBoardClient(this.PULSEBOARD_API, this.config.debug);
     this.queue = new EventQueue(this.config.maxQueueSize);
     this.contextCollector = new ContextCollector({
       environment: config.environment
     });
+    if (!hasDirectKey && hasIdentifiers) {
+      this.resolveApiKey(
+        config.organisation,
+        config.product,
+        config.project
+      );
+    } else {
+      this.completeInit();
+    }
+  }
+  async resolveApiKey(organisation, product, project) {
+    try {
+      const response = await fetch(
+        `${this.PULSEBOARD_API}sdk/resolve?organisation=${encodeURIComponent(organisation)}&product=${encodeURIComponent(product)}&project=${encodeURIComponent(project)}`
+      );
+      if (!response.ok) {
+        throw new Error(
+          `[PulseBoard] Could not resolve project. Check your organisation, product and project values.`
+        );
+      }
+      const data = await response.json();
+      this.config.apiKey = data.data.apiKey;
+      this.completeInit();
+    } catch (err) {
+      console.error("[PulseBoard] Failed to resolve API key:", err);
+    }
+  }
+  completeInit() {
     this.flushTimer = setInterval(
       () => this.flush(),
       this.config.flushInterval
@@ -559,7 +692,7 @@ var PulseBoardSDK = class {
       this.autoCapture.attach();
     }
     this.initialized = true;
-    this.log(`Initialized \u2014 host: ${this.PULSEBOARD_API}`);
+    this.debugLog(`Initialized \u2014 host: ${this.PULSEBOARD_API}`);
   }
   async getContext() {
     this.assertInitialized("getContext");
@@ -568,7 +701,7 @@ var PulseBoardSDK = class {
   identify(user) {
     this.assertInitialized("identify");
     this.contextCollector.identify(user);
-    this.log(`User identified: ${JSON.stringify(user)}`);
+    this.debugLog(`User identified: ${JSON.stringify(user)}`);
   }
   clearUser() {
     this.assertInitialized("clearUser");
@@ -600,26 +733,87 @@ var PulseBoardSDK = class {
       ...options.payload
     });
   }
+  // ─── Logging API ──────────────────────────────────────────────────
+  log(level, message, options = {}) {
+    this.assertInitialized("log");
+    this.contextCollector.collect().then((context) => {
+      this.logQueue.push({
+        level,
+        message,
+        meta: options.meta,
+        sessionId: context.session.sessionId,
+        appVersion: context.device.appVersion,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      });
+      if (level === "error") this.flushLogs();
+    }).catch(() => {
+    });
+  }
+  captureConsole() {
+    this.assertInitialized("captureConsole");
+    if (this.consoleCapturing) return;
+    this.originalConsole = {
+      log: console.log,
+      warn: console.warn,
+      error: console.error,
+      debug: console.debug
+    };
+    console.log = (...args) => {
+      this.originalConsole.log?.(...args);
+      this.log("info", args.map(String).join(" "));
+    };
+    console.warn = (...args) => {
+      this.originalConsole.warn?.(...args);
+      this.log("warn", args.map(String).join(" "));
+    };
+    console.error = (...args) => {
+      this.originalConsole.error?.(...args);
+      this.log("error", args.map(String).join(" "));
+    };
+    console.debug = (...args) => {
+      this.originalConsole.debug?.(...args);
+      this.log("debug", args.map(String).join(" "));
+    };
+    this.logFlushTimer = setInterval(() => this.flushLogs(), 1e4);
+    this.consoleCapturing = true;
+    this.debugLog("Console capture enabled");
+  }
+  releaseConsole() {
+    if (!this.consoleCapturing) return;
+    if (this.originalConsole.log) console.log = this.originalConsole.log;
+    if (this.originalConsole.warn) console.warn = this.originalConsole.warn;
+    if (this.originalConsole.error) console.error = this.originalConsole.error;
+    if (this.originalConsole.debug) console.debug = this.originalConsole.debug;
+    if (this.logFlushTimer) {
+      clearInterval(this.logFlushTimer);
+      this.logFlushTimer = null;
+    }
+    this.originalConsole = {};
+    this.consoleCapturing = false;
+  }
+  async flushLogs() {
+    if (!this.client || !this.config || this.logQueue.length === 0) return;
+    const batch = this.logQueue.splice(0, this.logQueue.length);
+    await this.client.sendLogBatch(this.apiKey, batch);
+  }
   // ─── Analytics API ────────────────────────────────────────────────
   startSession() {
     this.assertInitialized("startSession");
     this.contextCollector.collect().then((context) => {
       this.client.sendAnalytics("session", {
-        apiKey: this.config.apiKey,
+        apiKey: this.apiKey,
         sessionId: context.session.sessionId,
         startedAt: context.session.startedAt,
         context
       });
-      this.log(`Session started: ${context.session.sessionId}`);
-    }).catch((err) => {
-      this.log(`Failed to start session: ${err}`);
-    });
+      this.debugLog(`Session started: ${context.session.sessionId}`);
+    }).catch((err) => this.debugLog(`Failed to start session: ${err}`));
   }
   endSession(duration) {
     this.assertInitialized("endSession");
     this.contextCollector.collect().then((context) => {
       this.client.sendAnalytics("session", {
-        apiKey: this.config.apiKey,
+        apiKey: this.apiKey,
         sessionId: context.session.sessionId,
         startedAt: context.session.startedAt,
         endedAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -627,31 +821,27 @@ var PulseBoardSDK = class {
         context
       });
       this.flush();
-      this.log(`Session ended: ${context.session.sessionId}`);
-    }).catch((err) => {
-      this.log(`Failed to end session: ${err}`);
-    });
+      this.debugLog(`Session ended: ${context.session.sessionId}`);
+    }).catch((err) => this.debugLog(`Failed to end session: ${err}`));
   }
   trackScreen(screenName, loadTime) {
     this.assertInitialized("trackScreen");
     this.contextCollector.collect().then((context) => {
       this.client.sendAnalytics("screen-view", {
-        apiKey: this.config.apiKey,
+        apiKey: this.apiKey,
         screenName,
         loadTime,
         sessionId: context.session.sessionId,
         context
       });
-      this.log(`Screen tracked: ${screenName}`);
-    }).catch((err) => {
-      this.log(`Failed to track screen: ${err}`);
-    });
+      this.debugLog(`Screen tracked: ${screenName}`);
+    }).catch((err) => this.debugLog(`Failed to track screen: ${err}`));
   }
   trackApiCall(endpoint, httpMethod, statusCode, duration, payloadSize) {
     this.assertInitialized("trackApiCall");
     this.contextCollector.collect().then((context) => {
       this.client.sendAnalytics("api-call", {
-        apiKey: this.config.apiKey,
+        apiKey: this.apiKey,
         endpoint,
         httpMethod,
         statusCode,
@@ -660,16 +850,16 @@ var PulseBoardSDK = class {
         sessionId: context.session.sessionId,
         context
       });
-      this.log(`API call tracked: ${httpMethod} ${endpoint} ${statusCode}`);
-    }).catch((err) => {
-      this.log(`Failed to track API call: ${err}`);
-    });
+      this.debugLog(
+        `API call tracked: ${httpMethod} ${endpoint} ${statusCode}`
+      );
+    }).catch((err) => this.debugLog(`Failed to track API call: ${err}`));
   }
   trackCrash(error, isFatal = false) {
     this.assertInitialized("trackCrash");
     this.contextCollector.collect().then((context) => {
       this.client.sendAnalytics("crash", {
-        apiKey: this.config.apiKey,
+        apiKey: this.apiKey,
         errorName: error.name,
         errorMessage: error.message,
         stackTrace: error.stack ?? "",
@@ -677,17 +867,46 @@ var PulseBoardSDK = class {
         sessionId: context.session.sessionId,
         context
       });
-      this.log(`Crash tracked: ${error.name} \u2014 fatal: ${isFatal}`);
-    }).catch((err) => {
-      this.log(`Failed to track crash: ${err}`);
-    });
+      this.debugLog(`Crash tracked: ${error.name} \u2014 fatal: ${isFatal}`);
+    }).catch((err) => this.debugLog(`Failed to track crash: ${err}`));
   }
-  // ─── Flush & Destroy ─────────────────────────────────────────────
+  feedback(message, options = {}) {
+    this.assertInitialized("feedback");
+    this.contextCollector.collect().then((context) => {
+      this.client.sendFeedback({
+        apiKey: this.apiKey,
+        type: options.type ?? "general",
+        message,
+        meta: options.meta,
+        userEmail: options.userEmail,
+        userName: options.userName,
+        screenshot: options.screenshot,
+        sessionId: context.session.sessionId,
+        appVersion: context.device.appVersion
+      });
+      this.debugLog(`Feedback sent: ${options.type ?? "general"}`);
+    }).catch((err) => this.debugLog(`Failed to send feedback: ${err}`));
+  }
+  // ─── Flush & Destroy ──────────────────────────────────────────────
   async flush() {
-    if (!this.queue || this.queue.isEmpty) return;
-    if (!this.client) return;
+    if (!this.queue || !this.client) return;
+    if (!this.queue.hydrated) {
+      await new Promise((resolve) => {
+        const interval = setInterval(() => {
+          if (this.queue?.hydrated) {
+            clearInterval(interval);
+            resolve();
+          }
+        }, 50);
+        setTimeout(() => {
+          clearInterval(interval);
+          resolve();
+        }, 500);
+      });
+    }
+    if (this.queue.isEmpty) return;
     const events = this.queue.dequeue(10);
-    this.log(`Flushing ${events.length} event(s)`);
+    this.debugLog(`Flushing ${events.length} event(s)`);
     await this.client.sendBatch(events);
   }
   destroy() {
@@ -695,20 +914,22 @@ var PulseBoardSDK = class {
       clearInterval(this.flushTimer);
       this.flushTimer = null;
     }
+    this.releaseConsole();
     this.autoCapture?.detach();
     this.queue?.clear();
+    this.logQueue = [];
     this.initialized = false;
     this.config = null;
     this.client = null;
     this.queue = null;
     this.contextCollector = null;
-    this.log("SDK destroyed");
+    this.debugLog("SDK destroyed");
   }
-  // ─── Private ─────────────────────────────────────────────────────
+  // ─── Private ──────────────────────────────────────────────────────
   buildAndEnqueue(type, name, payload, timestamp) {
     this.contextCollector.collect().then((context) => {
       const event = {
-        apiKey: this.config.apiKey,
+        apiKey: this.apiKey,
         type,
         name,
         payload,
@@ -716,20 +937,16 @@ var PulseBoardSDK = class {
         context
       };
       this.queue.enqueue(event);
-      this.log(`Queued: ${type} \u2014 ${name}`);
-      if (type === "error") {
-        this.flush();
-      }
-    }).catch((err) => {
-      this.log(`Failed to collect context: ${err}`);
-    });
+      this.debugLog(`Queued: ${type} \u2014 ${name}`);
+      if (type === "error") this.flush();
+    }).catch((err) => this.debugLog(`Failed to collect context: ${err}`));
   }
   assertInitialized(method) {
     if (!this.initialized) {
       throw new Error(`PulseBoard.${method}() called before PulseBoard.init()`);
     }
   }
-  log(message) {
+  debugLog(message) {
     if (this.config?.debug) {
       console.log(`[PulseBoard] ${message}`);
     }