krisspy-sdk 0.9.0 → 0.9.2

package/dist/index.d.mts

@@ -758,28 +758,37 @@ declare class KrisspyRealtime {
  *
  * Tracks page views, sessions, custom events. Sends batched events
  * to the analytics ingest endpoint. Works with SPAs (intercepts pushState).
- * Browser-only module - safely no-ops in React Native / Node.js.
+ * Works on Web (browser), React Native / Expo, and Node.js.
  *
  * Supports two backends:
  * - Krisspy internal analytics (default, via /api/v1/analytics/events)
- * - OpenPanel (when openpanelClientId is provided, uses @openpanel/web SDK)
+ * - OpenPanel (when openpanelClientId is provided)
+ *   - Web: uses @openpanel/web SDK
+ *   - React Native / Expo: uses @openpanel/react-native SDK
  *
  * @example
  * const krisspy = createClient({ backendId: '...', apiKey: '...' })
  * krisspy.analytics.init({ autoTrackPageViews: true })
  * krisspy.analytics.track('button_click', { label: 'signup' })
  *
- * // With OpenPanel:
+ * // With OpenPanel (web):
  * krisspy.analytics.init({
  *   openpanelClientId: '049c50ff-...',
  *   openpanelApiUrl: 'https://api-openpanel.krisspy.ai',
  * })
+ *
+ * // With OpenPanel (React Native / Expo):
+ * krisspy.analytics.init({
+ *   openpanelClientId: '049c50ff-...',
+ *   openpanelApiUrl: 'https://api-openpanel.krisspy.ai',
+ *   storage: AsyncStorage, // optional — persists session across app restarts
+ * })
  */
 
 interface AnalyticsInitOptions {
     /** Auto-track page views on init + navigation (default: true) */
     autoTrackPageViews?: boolean;
-    /** Auto-track SPA navigation via pushState/popstate (default: true) */
+    /** Auto-track SPA navigation via pushState/popstate (default: true, web only) */
     autoTrackNavigation?: boolean;
     /** Flush interval in ms (default: 5000) */
     flushInterval?: number;
@@ -789,11 +798,11 @@ interface AnalyticsInitOptions {
     openpanelClientId?: string;
     /** OpenPanel API URL for self-hosted instances (default: https://api-openpanel.krisspy.ai) */
     openpanelApiUrl?: string;
-    /** Track outgoing links (OpenPanel, default: true) */
+    /** Track outgoing links (OpenPanel web, default: true) */
     trackOutgoingLinks?: boolean;
-    /** Track elements with data-track attributes (OpenPanel, default: true) */
+    /** Track elements with data-track attributes (OpenPanel web, default: true) */
     trackAttributes?: boolean;
-    /** Track hash changes in URL (OpenPanel, default: false) */
+    /** Track hash changes in URL (OpenPanel web, default: false) */
     trackHashChanges?: boolean;
     /** Disable tracking entirely (OpenPanel, default: false) */
     disabled?: boolean;
@@ -802,6 +811,16 @@ interface AnalyticsInitOptions {
         name: string;
         properties?: Record<string, any>;
     }) => boolean;
+    /**
+     * Custom storage adapter for session ID persistence on React Native.
+     * Pass AsyncStorage or MMKV here so the session survives app restarts.
+     * On web, localStorage is used automatically.
+     *
+     * @example
+     * import AsyncStorage from '@react-native-async-storage/async-storage'
+     * krisspy.analytics.init({ openpanelClientId: '...', storage: AsyncStorage })
+     */
+    storage?: StorageAdapter;
 }
 interface AnalyticsEvent {
     eventName: string;
@@ -828,8 +847,9 @@ declare class KrisspyAnalytics {
     private useOpenPanel;
     constructor(http: HttpClient, backendId: string);
     /**
-     * Initialize analytics tracking
-     * No-ops in non-browser environments (React Native, Node.js)
+     * Initialize analytics tracking.
+     * Works on web (browser), React Native / Expo, and Node.js.
+     * In Node.js without openpanelClientId, auto-tracking is skipped (manual track() still works).
      */
     init(options?: AnalyticsInitOptions): void;
     /**
@@ -902,10 +922,14 @@ declare class KrisspyAnalytics {
     private setupNavigationTracking;
     /**
      * Initialize OpenPanel SDK dynamically.
-     * Loads @openpanel/web at runtime (must be installed by the user).
-     * Falls back gracefully if not available.
+     * - React Native / Expo: loads @openpanel/react-native
+     * - Browser: loads @openpanel/web
+     * Falls back gracefully to internal analytics if package not installed.
      */
     private initOpenPanel;
+    private initOpenPanelReactNative;
+    private initOpenPanelWeb;
+    private fallbackToInternal;
 }
 
 /**

package/dist/index.d.ts

@@ -758,28 +758,37 @@ declare class KrisspyRealtime {
  *
  * Tracks page views, sessions, custom events. Sends batched events
  * to the analytics ingest endpoint. Works with SPAs (intercepts pushState).
- * Browser-only module - safely no-ops in React Native / Node.js.
+ * Works on Web (browser), React Native / Expo, and Node.js.
  *
  * Supports two backends:
  * - Krisspy internal analytics (default, via /api/v1/analytics/events)
- * - OpenPanel (when openpanelClientId is provided, uses @openpanel/web SDK)
+ * - OpenPanel (when openpanelClientId is provided)
+ *   - Web: uses @openpanel/web SDK
+ *   - React Native / Expo: uses @openpanel/react-native SDK
  *
  * @example
  * const krisspy = createClient({ backendId: '...', apiKey: '...' })
  * krisspy.analytics.init({ autoTrackPageViews: true })
  * krisspy.analytics.track('button_click', { label: 'signup' })
  *
- * // With OpenPanel:
+ * // With OpenPanel (web):
  * krisspy.analytics.init({
  *   openpanelClientId: '049c50ff-...',
  *   openpanelApiUrl: 'https://api-openpanel.krisspy.ai',
  * })
+ *
+ * // With OpenPanel (React Native / Expo):
+ * krisspy.analytics.init({
+ *   openpanelClientId: '049c50ff-...',
+ *   openpanelApiUrl: 'https://api-openpanel.krisspy.ai',
+ *   storage: AsyncStorage, // optional — persists session across app restarts
+ * })
  */
 
 interface AnalyticsInitOptions {
     /** Auto-track page views on init + navigation (default: true) */
     autoTrackPageViews?: boolean;
-    /** Auto-track SPA navigation via pushState/popstate (default: true) */
+    /** Auto-track SPA navigation via pushState/popstate (default: true, web only) */
     autoTrackNavigation?: boolean;
     /** Flush interval in ms (default: 5000) */
     flushInterval?: number;
@@ -789,11 +798,11 @@ interface AnalyticsInitOptions {
     openpanelClientId?: string;
     /** OpenPanel API URL for self-hosted instances (default: https://api-openpanel.krisspy.ai) */
     openpanelApiUrl?: string;
-    /** Track outgoing links (OpenPanel, default: true) */
+    /** Track outgoing links (OpenPanel web, default: true) */
     trackOutgoingLinks?: boolean;
-    /** Track elements with data-track attributes (OpenPanel, default: true) */
+    /** Track elements with data-track attributes (OpenPanel web, default: true) */
     trackAttributes?: boolean;
-    /** Track hash changes in URL (OpenPanel, default: false) */
+    /** Track hash changes in URL (OpenPanel web, default: false) */
     trackHashChanges?: boolean;
     /** Disable tracking entirely (OpenPanel, default: false) */
     disabled?: boolean;
@@ -802,6 +811,16 @@ interface AnalyticsInitOptions {
         name: string;
         properties?: Record<string, any>;
     }) => boolean;
+    /**
+     * Custom storage adapter for session ID persistence on React Native.
+     * Pass AsyncStorage or MMKV here so the session survives app restarts.
+     * On web, localStorage is used automatically.
+     *
+     * @example
+     * import AsyncStorage from '@react-native-async-storage/async-storage'
+     * krisspy.analytics.init({ openpanelClientId: '...', storage: AsyncStorage })
+     */
+    storage?: StorageAdapter;
 }
 interface AnalyticsEvent {
     eventName: string;
@@ -828,8 +847,9 @@ declare class KrisspyAnalytics {
     private useOpenPanel;
     constructor(http: HttpClient, backendId: string);
     /**
-     * Initialize analytics tracking
-     * No-ops in non-browser environments (React Native, Node.js)
+     * Initialize analytics tracking.
+     * Works on web (browser), React Native / Expo, and Node.js.
+     * In Node.js without openpanelClientId, auto-tracking is skipped (manual track() still works).
      */
     init(options?: AnalyticsInitOptions): void;
     /**
@@ -902,10 +922,14 @@ declare class KrisspyAnalytics {
     private setupNavigationTracking;
     /**
      * Initialize OpenPanel SDK dynamically.
-     * Loads @openpanel/web at runtime (must be installed by the user).
-     * Falls back gracefully if not available.
+     * - React Native / Expo: loads @openpanel/react-native
+     * - Browser: loads @openpanel/web
+     * Falls back gracefully to internal analytics if package not installed.
      */
     private initOpenPanel;
+    private initOpenPanelReactNative;
+    private initOpenPanelWeb;
+    private fallbackToInternal;
 }
 
 /**

package/dist/index.js

@@ -1324,12 +1324,12 @@ var KrisspyAnalytics = class {
     this.backendId = backendId;
   }
   /**
-   * Initialize analytics tracking
-   * No-ops in non-browser environments (React Native, Node.js)
+   * Initialize analytics tracking.
+   * Works on web (browser), React Native / Expo, and Node.js.
+   * In Node.js without openpanelClientId, auto-tracking is skipped (manual track() still works).
    */
   init(options) {
     if (this.initialized) return;
-    if (!isBrowser()) return;
     this.options = __spreadValues({
       autoTrackPageViews: true,
       autoTrackNavigation: true,
@@ -1342,6 +1342,11 @@ var KrisspyAnalytics = class {
       this.initOpenPanel();
       return;
     }
+    if (!isBrowser()) {
+      this.sessionId = this.getOrCreateSessionId();
+      this.initialized = true;
+      return;
+    }
     this.sessionId = this.getOrCreateSessionId();
     this.initialized = true;
     if (this.options.autoTrackPageViews) {
@@ -1588,12 +1593,39 @@ var KrisspyAnalytics = class {
   }
   /**
    * Initialize OpenPanel SDK dynamically.
-   * Loads @openpanel/web at runtime (must be installed by the user).
-   * Falls back gracefully if not available.
+   * - React Native / Expo: loads @openpanel/react-native
+   * - Browser: loads @openpanel/web
+   * Falls back gracefully to internal analytics if package not installed.
    */
   async initOpenPanel() {
     const clientId = this.options.openpanelClientId;
     const apiUrl = this.options.openpanelApiUrl || "https://api-openpanel.krisspy.ai";
+    if (isReactNative()) {
+      await this.initOpenPanelReactNative(clientId, apiUrl);
+    } else {
+      await this.initOpenPanelWeb(clientId, apiUrl);
+    }
+  }
+  async initOpenPanelReactNative(clientId, apiUrl) {
+    try {
+      const { OpenPanel } = await import("@openpanel/react-native");
+      this.openpanel = new OpenPanel({
+        clientId,
+        apiUrl,
+        disabled: this.options.disabled,
+        filter: this.options.filter
+      });
+      if (this.options.debug) {
+        console.log("[Krisspy Analytics \u2192 OpenPanel RN] Initialized", { clientId, apiUrl });
+      }
+    } catch (e) {
+      console.warn(
+        "[Krisspy Analytics] @openpanel/react-native not found. Install it with: npx expo install @openpanel/react-native\nFalling back to internal analytics."
+      );
+      this.fallbackToInternal();
+    }
+  }
+  async initOpenPanelWeb(clientId, apiUrl) {
     try {
       const { OpenPanel } = await import("@openpanel/web");
       this.openpanel = new OpenPanel({
@@ -1609,13 +1641,18 @@ var KrisspyAnalytics = class {
       if (this.options.debug) {
         console.log("[Krisspy Analytics \u2192 OpenPanel] Initialized", { clientId, apiUrl });
       }
-    } catch (err) {
+    } catch (e) {
       console.warn(
         "[Krisspy Analytics] @openpanel/web not found. Install it with: npm install @openpanel/web\nFalling back to internal analytics."
       );
-      this.useOpenPanel = false;
-      this.openpanel = null;
-      this.sessionId = this.getOrCreateSessionId();
+      this.fallbackToInternal();
+    }
+  }
+  fallbackToInternal() {
+    this.useOpenPanel = false;
+    this.openpanel = null;
+    this.sessionId = this.getOrCreateSessionId();
+    if (isBrowser()) {
       if (this.options.autoTrackPageViews) {
         this.track("session_start", {});
         this.track("page_view", { url: window.location.href, referrer: document.referrer });
@@ -1623,8 +1660,8 @@ var KrisspyAnalytics = class {
       if (this.options.autoTrackNavigation) {
         this.setupNavigationTracking();
       }
-      this.flushTimer = setInterval(() => this.flush(), this.options.flushInterval);
     }
+    this.flushTimer = setInterval(() => this.flush(), this.options.flushInterval);
   }
 };
 

package/dist/index.mjs

@@ -1279,12 +1279,12 @@ var KrisspyAnalytics = class {
     this.backendId = backendId;
   }
   /**
-   * Initialize analytics tracking
-   * No-ops in non-browser environments (React Native, Node.js)
+   * Initialize analytics tracking.
+   * Works on web (browser), React Native / Expo, and Node.js.
+   * In Node.js without openpanelClientId, auto-tracking is skipped (manual track() still works).
    */
   init(options) {
     if (this.initialized) return;
-    if (!isBrowser()) return;
     this.options = __spreadValues({
       autoTrackPageViews: true,
       autoTrackNavigation: true,
@@ -1297,6 +1297,11 @@ var KrisspyAnalytics = class {
       this.initOpenPanel();
       return;
     }
+    if (!isBrowser()) {
+      this.sessionId = this.getOrCreateSessionId();
+      this.initialized = true;
+      return;
+    }
     this.sessionId = this.getOrCreateSessionId();
     this.initialized = true;
     if (this.options.autoTrackPageViews) {
@@ -1543,12 +1548,39 @@ var KrisspyAnalytics = class {
   }
   /**
    * Initialize OpenPanel SDK dynamically.
-   * Loads @openpanel/web at runtime (must be installed by the user).
-   * Falls back gracefully if not available.
+   * - React Native / Expo: loads @openpanel/react-native
+   * - Browser: loads @openpanel/web
+   * Falls back gracefully to internal analytics if package not installed.
    */
   async initOpenPanel() {
     const clientId = this.options.openpanelClientId;
     const apiUrl = this.options.openpanelApiUrl || "https://api-openpanel.krisspy.ai";
+    if (isReactNative()) {
+      await this.initOpenPanelReactNative(clientId, apiUrl);
+    } else {
+      await this.initOpenPanelWeb(clientId, apiUrl);
+    }
+  }
+  async initOpenPanelReactNative(clientId, apiUrl) {
+    try {
+      const { OpenPanel } = await import("@openpanel/react-native");
+      this.openpanel = new OpenPanel({
+        clientId,
+        apiUrl,
+        disabled: this.options.disabled,
+        filter: this.options.filter
+      });
+      if (this.options.debug) {
+        console.log("[Krisspy Analytics \u2192 OpenPanel RN] Initialized", { clientId, apiUrl });
+      }
+    } catch (e) {
+      console.warn(
+        "[Krisspy Analytics] @openpanel/react-native not found. Install it with: npx expo install @openpanel/react-native\nFalling back to internal analytics."
+      );
+      this.fallbackToInternal();
+    }
+  }
+  async initOpenPanelWeb(clientId, apiUrl) {
     try {
       const { OpenPanel } = await import("@openpanel/web");
       this.openpanel = new OpenPanel({
@@ -1564,13 +1596,18 @@ var KrisspyAnalytics = class {
       if (this.options.debug) {
         console.log("[Krisspy Analytics \u2192 OpenPanel] Initialized", { clientId, apiUrl });
       }
-    } catch (err) {
+    } catch (e) {
       console.warn(
         "[Krisspy Analytics] @openpanel/web not found. Install it with: npm install @openpanel/web\nFalling back to internal analytics."
       );
-      this.useOpenPanel = false;
-      this.openpanel = null;
-      this.sessionId = this.getOrCreateSessionId();
+      this.fallbackToInternal();
+    }
+  }
+  fallbackToInternal() {
+    this.useOpenPanel = false;
+    this.openpanel = null;
+    this.sessionId = this.getOrCreateSessionId();
+    if (isBrowser()) {
       if (this.options.autoTrackPageViews) {
         this.track("session_start", {});
         this.track("page_view", { url: window.location.href, referrer: document.referrer });
@@ -1578,8 +1615,8 @@ var KrisspyAnalytics = class {
       if (this.options.autoTrackNavigation) {
         this.setupNavigationTracking();
       }
-      this.flushTimer = setInterval(() => this.flush(), this.options.flushInterval);
     }
+    this.flushTimer = setInterval(() => this.flush(), this.options.flushInterval);
   }
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "krisspy-sdk",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "Krisspy Cloud SDK - Database, Auth, Storage, and Functions for your apps",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -44,6 +44,14 @@
   "dependencies": {
     "@openpanel/web": "^1.0.0"
   },
+  "peerDependencies": {
+    "@openpanel/react-native": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@openpanel/react-native": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/node": "^20.0.0",
     "tsup": "^8.0.0",