@product-intelligence-hub/sdk-react-native 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Product Intelligence Hub
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,198 @@
+# @product-intelligence-hub/sdk-react-native
+
+React Native SDK for Product Intelligence Hub.
+
+## Installation
+
+```bash
+npm install @product-intelligence-hub/sdk-react-native
+# or
+yarn add @product-intelligence-hub/sdk-react-native
+# or
+pnpm add @product-intelligence-hub/sdk-react-native
+```
+
+### Peer Dependencies
+
+```bash
+npm install @react-native-async-storage/async-storage
+```
+
+Optional for screen tracking:
+```bash
+npm install @react-navigation/native
+```
+
+## Quick Start
+
+```typescript
+import PIH from "@product-intelligence-hub/sdk-react-native";
+
+// Initialize the SDK
+const pih = PIH.init({
+  apiUrl: "https://your-ingest-api.com",
+  apiKey: "your-api-key",
+  projectId: "proj_xxx",
+  environment: "production",
+});
+
+// Track an event
+pih.track("button_pressed", {
+  button_id: "checkout",
+  screen: "Cart",
+});
+
+// Identify a user
+pih.identify("user_123", {
+  email: "user@example.com",
+  subscription: "premium",
+});
+```
+
+## Configuration Options
+
+```typescript
+PIH.init({
+  // Required
+  apiUrl: string;           // Ingestion API URL
+  apiKey: string;           // Environment API key
+  projectId: string;        // Project ID (proj_xxx)
+  environment: string;      // Environment name
+
+  // Optional
+  tenantId?: string;        // Tenant ID for multi-tenant apps
+  debug?: boolean;          // Enable debug logging (default: false)
+  flushInterval?: number;   // Batch flush interval in ms (default: 10000)
+  flushAt?: number;         // Flush when queue reaches this size (default: 20)
+  maxQueueSize?: number;    // Max events to queue (default: 1000)
+  sessionTimeout?: number;  // Session timeout in ms (default: 1800000)
+  trackLifecycle?: boolean; // Track app lifecycle events (default: true)
+
+  // Callbacks
+  onError?: (error: PIHError) => void;
+});
+```
+
+## API
+
+### `PIH.init(config)`
+
+Initialize the SDK. Returns the client instance.
+
+### `pih.track(eventName, properties?, options?)`
+
+Track an event.
+
+```typescript
+pih.track("item_added_to_cart", {
+  product_id: "prod_123",
+  quantity: 2,
+  price: 29.99,
+});
+```
+
+### `pih.identify(userId, traits?)`
+
+Identify the current user.
+
+```typescript
+pih.identify("user_123", {
+  email: "user@example.com",
+  name: "Jane Doe",
+});
+```
+
+### `pih.trackScreen(screenName, params?)`
+
+Manually track a screen view.
+
+```typescript
+pih.trackScreen("ProductDetail", { product_id: "prod_123" });
+```
+
+### `pih.flush()`
+
+Force flush the event queue.
+
+```typescript
+await pih.flush();
+```
+
+### `pih.reset()`
+
+Reset identity (for logout).
+
+```typescript
+await pih.reset();
+```
+
+## Screen Tracking with React Navigation
+
+```typescript
+import { NavigationContainer } from "@react-navigation/native";
+import PIH from "@product-intelligence-hub/sdk-react-native";
+
+function App() {
+  const navigationRef = useNavigationContainerRef();
+  const pih = PIH.getInstance();
+
+  useEffect(() => {
+    if (pih) {
+      const cleanup = pih.setupScreenTracking(navigationRef, {
+        // Optional: transform screen names
+        getScreenName: (route) => route.name,
+        // Optional: include route params
+        includeParams: true,
+      });
+      return cleanup;
+    }
+  }, []);
+
+  return (
+    <NavigationContainer ref={navigationRef}>
+      {/* ... */}
+    </NavigationContainer>
+  );
+}
+```
+
+## Lifecycle Tracking
+
+By default, the SDK tracks app lifecycle events:
+
+- `app_opened` - App comes to foreground
+- `app_backgrounded` - App goes to background
+
+Disable with:
+
+```typescript
+PIH.init({
+  // ...
+  trackLifecycle: false,
+});
+
+// Or at runtime
+pih.disableLifecycleTracking();
+pih.enableLifecycleTracking();
+```
+
+## Platform Detection
+
+The SDK automatically detects the platform (`ios` or `android`) from React Native.
+
+## TypeScript Support
+
+Full TypeScript support included:
+
+```typescript
+import type {
+  RNPIHConfig,
+  TrackEvent,
+  ScreenTrackerOptions,
+} from "@product-intelligence-hub/sdk-react-native";
+```
+
+## Related
+
+- [SDK Core](../sdk-core/README.md) - Core SDK internals
+- [SDK Spec](/docs/06_SDK_SPEC.md) - Full SDK specification

package/dist/index.d.ts

@@ -0,0 +1,80 @@
+import type { NavigationContainerRef, ParamListBase } from "@react-navigation/native";
+import { PIHClient, type PIHConfig, type StorageAdapter } from "@product-intelligence-hub/sdk-core";
+import { createScreenTracker, type ScreenTrackerOptions, type ScreenTracker } from "./screen-tracker.js";
+/**
+ * React Native specific PIH configuration
+ */
+export interface RNPIHConfig extends Omit<PIHConfig, "platform"> {
+    /** Platform will be auto-detected from React Native */
+    platform?: "ios" | "android" | "react-native";
+    /** Enable lifecycle tracking (default: true) */
+    trackLifecycle?: boolean;
+}
+/**
+ * React Native PIH Client
+ * Extends the base client with React Native-specific features
+ */
+export declare class RNPIHClient extends PIHClient {
+    private lifecycle;
+    private screenTracker;
+    private trackLifecycle;
+    constructor(config: RNPIHConfig, storage?: StorageAdapter);
+    /**
+     * Initialize the React Native client
+     */
+    initialize(): Promise<void>;
+    /**
+     * Setup screen tracking with React Navigation
+     */
+    setupScreenTracking(navigationRef: NavigationContainerRef<ParamListBase>, options?: ScreenTrackerOptions): () => void;
+    /**
+     * Get the screen tracker instance
+     */
+    getScreenTracker(): ScreenTracker | null;
+    /**
+     * Manually track a screen view
+     */
+    trackScreen(screenName: string, params?: Record<string, unknown>): void;
+    /**
+     * Handle app state change
+     * Can be called manually if automatic lifecycle tracking is disabled
+     */
+    onAppStateChange(state: "active" | "background" | "inactive"): void;
+    /**
+     * Enable lifecycle tracking
+     */
+    enableLifecycleTracking(): void;
+    /**
+     * Disable lifecycle tracking
+     */
+    disableLifecycleTracking(): void;
+    /**
+     * Destroy the client
+     */
+    destroy(): void;
+    protected log(...args: unknown[]): void;
+}
+/**
+ * Initialize the PIH React Native SDK
+ */
+declare function init(config: RNPIHConfig): RNPIHClient;
+/**
+ * Get the current instance
+ */
+declare function getInstance(): RNPIHClient | null;
+/**
+ * Reset the singleton (for testing)
+ */
+declare function resetInstance(): void;
+declare const PIH: {
+    init: typeof init;
+    getInstance: typeof getInstance;
+    resetInstance: typeof resetInstance;
+    RNPIHClient: typeof RNPIHClient;
+    createScreenTracker: typeof createScreenTracker;
+};
+export default PIH;
+export { init, getInstance, resetInstance, createScreenTracker };
+export type { ScreenTrackerOptions, ScreenTracker };
+export type { PIHConfig, TrackEvent, TrackOptions, TransportOptions, PIHError, PIHErrorCode, } from "@product-intelligence-hub/sdk-core";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACtF,OAAO,EACL,SAAS,EACT,KAAK,SAAS,EACd,KAAK,cAAc,EACpB,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EACL,mBAAmB,EACnB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IAC9D,uDAAuD;IACvD,QAAQ,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,cAAc,CAAC;IAC9C,gDAAgD;IAChD,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,SAAS;IACxC,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,cAAc,CAAU;gBAEpB,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,cAAc;IAgBzD;;OAEG;IACY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAY1C;;OAEG;IACH,mBAAmB,CACjB,aAAa,EAAE,sBAAsB,CAAC,aAAa,CAAC,EACpD,OAAO,CAAC,EAAE,oBAAoB,GAC7B,MAAM,IAAI;IAKb;;OAEG;IACH,gBAAgB,IAAI,aAAa,GAAG,IAAI;IAIxC;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAYvE;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,IAAI;IAWnE;;OAEG;IACH,uBAAuB,IAAI,IAAI;IAO/B;;OAEG;IACH,wBAAwB,IAAI,IAAI;IAOhC;;OAEG;IACM,OAAO,IAAI,IAAI;cAOL,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAKjD;AAOD;;GAEG;AACH,iBAAS,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAc9C;AAED;;GAEG;AACH,iBAAS,WAAW,IAAI,WAAW,GAAG,IAAI,CAEzC;AAED;;GAEG;AACH,iBAAS,aAAa,IAAI,IAAI,CAK7B;AAGD,QAAA,MAAM,GAAG;;;;;;CAMR,CAAC;AAEF,eAAe,GAAG,CAAC;AACnB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,mBAAmB,EAAE,CAAC;AACjE,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,CAAC;AAGpD,YAAY,EACV,SAAS,EACT,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,QAAQ,EACR,YAAY,GACb,MAAM,oCAAoC,CAAC"}

package/dist/index.js

@@ -0,0 +1,155 @@
+import { Platform } from "react-native";
+import { PIHClient, } from "@product-intelligence-hub/sdk-core";
+import { createRNStorage } from "./storage.js";
+import { LifecycleManager } from "./lifecycle.js";
+import { createScreenTracker, } from "./screen-tracker.js";
+/**
+ * React Native PIH Client
+ * Extends the base client with React Native-specific features
+ */
+export class RNPIHClient extends PIHClient {
+    lifecycle = null;
+    screenTracker = null;
+    trackLifecycle;
+    constructor(config, storage) {
+        // Auto-detect platform from React Native
+        const platform = config.platform ?? (Platform.OS === "ios" ? "ios" : "android");
+        const rnConfig = {
+            ...config,
+            platform,
+        };
+        // Use provided storage or create RN storage
+        super(rnConfig, storage ?? createRNStorage());
+        this.trackLifecycle = config.trackLifecycle !== false;
+    }
+    /**
+     * Initialize the React Native client
+     */
+    async initialize() {
+        await super.initialize();
+        // Start lifecycle manager
+        if (this.trackLifecycle) {
+            this.lifecycle = new LifecycleManager(this, this.config.debug);
+            this.lifecycle.start();
+        }
+        this.log("React Native client initialized");
+    }
+    /**
+     * Setup screen tracking with React Navigation
+     */
+    setupScreenTracking(navigationRef, options) {
+        this.screenTracker = createScreenTracker(this, options);
+        return this.screenTracker.setup(navigationRef);
+    }
+    /**
+     * Get the screen tracker instance
+     */
+    getScreenTracker() {
+        return this.screenTracker;
+    }
+    /**
+     * Manually track a screen view
+     */
+    trackScreen(screenName, params) {
+        if (this.screenTracker) {
+            this.screenTracker.trackScreen(screenName, params);
+        }
+        else {
+            // Track without screen tracker
+            this.track("screen_viewed", {
+                screen_name: screenName,
+                params,
+            });
+        }
+    }
+    /**
+     * Handle app state change
+     * Can be called manually if automatic lifecycle tracking is disabled
+     */
+    onAppStateChange(state) {
+        this.log("App state change:", state);
+        if (state === "background" || state === "inactive") {
+            // Flush events when app goes to background
+            this.flush().catch((error) => {
+                this.log("Flush error on app state change:", error);
+            });
+        }
+    }
+    /**
+     * Enable lifecycle tracking
+     */
+    enableLifecycleTracking() {
+        if (!this.lifecycle) {
+            this.lifecycle = new LifecycleManager(this, this.config.debug);
+            this.lifecycle.start();
+        }
+    }
+    /**
+     * Disable lifecycle tracking
+     */
+    disableLifecycleTracking() {
+        if (this.lifecycle) {
+            this.lifecycle.stop();
+            this.lifecycle = null;
+        }
+    }
+    /**
+     * Destroy the client
+     */
+    destroy() {
+        if (this.lifecycle) {
+            this.lifecycle.stop();
+        }
+        super.destroy();
+    }
+    log(...args) {
+        if (this.config.debug) {
+            console.log("[PIH RN]", ...args);
+        }
+    }
+}
+/**
+ * Singleton instance
+ */
+let instance = null;
+/**
+ * Initialize the PIH React Native SDK
+ */
+function init(config) {
+    if (instance) {
+        console.warn("[PIH] SDK already initialized. Returning existing instance.");
+        return instance;
+    }
+    instance = new RNPIHClient(config);
+    // Auto-initialize
+    instance.initialize().catch((error) => {
+        console.error("[PIH] Failed to initialize:", error);
+    });
+    return instance;
+}
+/**
+ * Get the current instance
+ */
+function getInstance() {
+    return instance;
+}
+/**
+ * Reset the singleton (for testing)
+ */
+function resetInstance() {
+    if (instance) {
+        instance.destroy();
+        instance = null;
+    }
+}
+// Default export
+const PIH = {
+    init,
+    getInstance,
+    resetInstance,
+    RNPIHClient,
+    createScreenTracker,
+};
+export default PIH;
+export { init, getInstance, resetInstance, createScreenTracker };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,EACL,SAAS,GAGV,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EACL,mBAAmB,GAGpB,MAAM,qBAAqB,CAAC;AAY7B;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,SAAS;IAChC,SAAS,GAA4B,IAAI,CAAC;IAC1C,aAAa,GAAyB,IAAI,CAAC;IAC3C,cAAc,CAAU;IAEhC,YAAY,MAAmB,EAAE,OAAwB;QACvD,yCAAyC;QACzC,MAAM,QAAQ,GACZ,MAAM,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAEjE,MAAM,QAAQ,GAAc;YAC1B,GAAG,MAAM;YACT,QAAQ;SACT,CAAC;QAEF,4CAA4C;QAC5C,KAAK,CAAC,QAAQ,EAAE,OAAO,IAAI,eAAe,EAAE,CAAC,CAAC;QAE9C,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,KAAK,KAAK,CAAC;IACxD,CAAC;IAED;;OAEG;IACM,KAAK,CAAC,UAAU;QACvB,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;QAEzB,0BAA0B;QAC1B,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,IAAI,CAAC,SAAS,GAAG,IAAI,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/D,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,mBAAmB,CACjB,aAAoD,EACpD,OAA8B;QAE9B,IAAI,CAAC,aAAa,GAAG,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,UAAkB,EAAE,MAAgC;QAC9D,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACrD,CAAC;aAAM,CAAC;YACN,+BAA+B;YAC/B,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE;gBAC1B,WAAW,EAAE,UAAU;gBACvB,MAAM;aACP,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,gBAAgB,CAAC,KAA2C;QAC1D,IAAI,CAAC,GAAG,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;QAErC,IAAI,KAAK,KAAK,YAAY,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;YACnD,2CAA2C;YAC3C,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC3B,IAAI,CAAC,GAAG,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;YACtD,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,uBAAuB;QACrB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,SAAS,GAAG,IAAI,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/D,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,wBAAwB;QACtB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACtB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,CAAC;IACH,CAAC;IAED;;OAEG;IACM,OAAO;QACd,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACxB,CAAC;QACD,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;IAEkB,GAAG,CAAC,GAAG,IAAe;QACvC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,IAAI,QAAQ,GAAuB,IAAI,CAAC;AAExC;;GAEG;AACH,SAAS,IAAI,CAAC,MAAmB;IAC/B,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;QAC5E,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,QAAQ,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IAEnC,kBAAkB;IAClB,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACpC,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,WAAW;IAClB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,aAAa;IACpB,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,OAAO,EAAE,CAAC;QACnB,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;AACH,CAAC;AAED,iBAAiB;AACjB,MAAM,GAAG,GAAG;IACV,IAAI;IACJ,WAAW;IACX,aAAa;IACb,WAAW;IACX,mBAAmB;CACpB,CAAC;AAEF,eAAe,GAAG,CAAC;AACnB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/lifecycle.d.ts

@@ -0,0 +1,42 @@
+import { type AppStateStatus } from "react-native";
+import type { PIHClient } from "@product-intelligence-hub/sdk-core";
+/**
+ * Lifecycle manager for React Native app state changes
+ */
+export declare class LifecycleManager {
+    private client;
+    private appState;
+    private subscription;
+    private debug;
+    constructor(client: PIHClient, debug?: boolean);
+    /**
+     * Start listening to app state changes
+     */
+    start(): void;
+    /**
+     * Stop listening to app state changes
+     */
+    stop(): void;
+    /**
+     * Handle app state change
+     */
+    private handleAppStateChange;
+    /**
+     * Handle app going to background
+     */
+    private handleAppBackground;
+    /**
+     * Handle app coming to foreground
+     */
+    private handleAppForeground;
+    /**
+     * Get current app state
+     */
+    getCurrentState(): AppStateStatus;
+    /**
+     * Set debug mode
+     */
+    setDebug(enabled: boolean): void;
+    private log;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAEpE;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,YAAY,CAAuC;IAC3D,OAAO,CAAC,KAAK,CAAU;gBAEX,MAAM,EAAE,SAAS,EAAE,KAAK,UAAQ;IAM5C;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;OAEG;IACH,IAAI,IAAI,IAAI;IAQZ;;OAEG;IACH,OAAO,CAAC,oBAAoB,CAe1B;IAEF;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,eAAe,IAAI,cAAc;IAIjC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIhC,OAAO,CAAC,GAAG;CAKZ"}

package/dist/lifecycle.js

@@ -0,0 +1,91 @@
+import { AppState } from "react-native";
+/**
+ * Lifecycle manager for React Native app state changes
+ */
+export class LifecycleManager {
+    client;
+    appState;
+    subscription = null;
+    debug;
+    constructor(client, debug = false) {
+        this.client = client;
+        this.appState = AppState.currentState;
+        this.debug = debug;
+    }
+    /**
+     * Start listening to app state changes
+     */
+    start() {
+        // AppState.addEventListener returns a subscription in React Native 0.65+
+        this.subscription = AppState.addEventListener("change", this.handleAppStateChange);
+        this.log("Lifecycle manager started, initial state:", this.appState);
+    }
+    /**
+     * Stop listening to app state changes
+     */
+    stop() {
+        if (this.subscription) {
+            this.subscription.remove();
+            this.subscription = null;
+        }
+        this.log("Lifecycle manager stopped");
+    }
+    /**
+     * Handle app state change
+     */
+    handleAppStateChange = (nextState) => {
+        const previousState = this.appState;
+        this.log("App state change:", previousState, "->", nextState);
+        // App going to background
+        if (previousState === "active" && nextState.match(/inactive|background/)) {
+            this.handleAppBackground();
+        }
+        // App coming to foreground
+        if (previousState.match(/inactive|background/) && nextState === "active") {
+            this.handleAppForeground();
+        }
+        this.appState = nextState;
+    };
+    /**
+     * Handle app going to background
+     */
+    handleAppBackground() {
+        this.log("App going to background, flushing events");
+        // Flush any pending events
+        this.client.flush().catch((error) => {
+            this.log("Flush error on background:", error);
+        });
+        // Track app backgrounded event
+        this.client.track("app_backgrounded", {
+            timestamp: new Date().toISOString(),
+        });
+    }
+    /**
+     * Handle app coming to foreground
+     */
+    handleAppForeground() {
+        this.log("App coming to foreground");
+        // Track app foregrounded event
+        this.client.track("app_foregrounded", {
+            timestamp: new Date().toISOString(),
+        });
+    }
+    /**
+     * Get current app state
+     */
+    getCurrentState() {
+        return this.appState;
+    }
+    /**
+     * Set debug mode
+     */
+    setDebug(enabled) {
+        this.debug = enabled;
+    }
+    log(...args) {
+        if (this.debug) {
+            console.log("[PIH Lifecycle]", ...args);
+        }
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"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"}

package/dist/screen-tracker.d.ts

@@ -0,0 +1,59 @@
+import type { NavigationContainerRef, ParamListBase } from "@react-navigation/native";
+import type { PIHClient } from "@product-intelligence-hub/sdk-core";
+/**
+ * Screen tracking options
+ */
+export interface ScreenTrackerOptions {
+    /** Whether to track screen params (default: false for privacy) */
+    trackParams?: boolean;
+    /** Custom event name (default: "screen_viewed") */
+    eventName?: string;
+    /** Screens to ignore */
+    ignoreScreens?: string[];
+}
+/**
+ * Create a screen tracker for React Navigation
+ *
+ * @example
+ * ```tsx
+ * import { NavigationContainer } from '@react-navigation/native';
+ * import { useRef } from 'react';
+ * import { analytics, createScreenTracker } from '@product-intelligence-hub/sdk-react-native';
+ *
+ * function App() {
+ *   const navigationRef = useRef(null);
+ *   const routeNameRef = useRef<string>();
+ *
+ *   return (
+ *     <NavigationContainer
+ *       ref={navigationRef}
+ *       onReady={() => {
+ *         routeNameRef.current = navigationRef.current?.getCurrentRoute()?.name;
+ *       }}
+ *       onStateChange={async () => {
+ *         const previousRouteName = routeNameRef.current;
+ *         const currentRouteName = navigationRef.current?.getCurrentRoute()?.name;
+ *
+ *         if (currentRouteName && previousRouteName !== currentRouteName) {
+ *           analytics.track('screen_viewed', { screen_name: currentRouteName });
+ *         }
+ *
+ *         routeNameRef.current = currentRouteName;
+ *       }}
+ *     >
+ *       {children}
+ *     </NavigationContainer>
+ *   );
+ * }
+ * ```
+ */
+export declare function createScreenTracker(client: PIHClient, options?: ScreenTrackerOptions): {
+    setup: (navigationRef: NavigationContainerRef<ParamListBase>) => () => void;
+    getCurrentRouteName: () => string | undefined;
+    trackScreen: (screenName: string, params?: Record<string, unknown>) => void;
+};
+/**
+ * Type for the screen tracker
+ */
+export type ScreenTracker = ReturnType<typeof createScreenTracker>;
+//# sourceMappingURL=screen-tracker.d.ts.map

package/dist/screen-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-tracker.d.ts","sourceRoot":"","sources":["../src/screen-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,aAAa,EACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,oBAAyB;2BAcjB,sBAAsB,CAAC,aAAa,CAAC,KACnD,MAAM,IAAI;+BAsCmB,MAAM,GAAG,SAAS;8BAQpC,MAAM,WACT,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC/B,IAAI;EAuBR;AAoCD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/screen-tracker.js

@@ -0,0 +1,122 @@
+/**
+ * Create a screen tracker for React Navigation
+ *
+ * @example
+ * ```tsx
+ * import { NavigationContainer } from '@react-navigation/native';
+ * import { useRef } from 'react';
+ * import { analytics, createScreenTracker } from '@product-intelligence-hub/sdk-react-native';
+ *
+ * function App() {
+ *   const navigationRef = useRef(null);
+ *   const routeNameRef = useRef<string>();
+ *
+ *   return (
+ *     <NavigationContainer
+ *       ref={navigationRef}
+ *       onReady={() => {
+ *         routeNameRef.current = navigationRef.current?.getCurrentRoute()?.name;
+ *       }}
+ *       onStateChange={async () => {
+ *         const previousRouteName = routeNameRef.current;
+ *         const currentRouteName = navigationRef.current?.getCurrentRoute()?.name;
+ *
+ *         if (currentRouteName && previousRouteName !== currentRouteName) {
+ *           analytics.track('screen_viewed', { screen_name: currentRouteName });
+ *         }
+ *
+ *         routeNameRef.current = currentRouteName;
+ *       }}
+ *     >
+ *       {children}
+ *     </NavigationContainer>
+ *   );
+ * }
+ * ```
+ */
+export function createScreenTracker(client, options = {}) {
+    const { trackParams = false, eventName = "screen_viewed", ignoreScreens = [], } = options;
+    let currentRouteName;
+    /**
+     * Setup screen tracking on a navigation container
+     */
+    function setup(navigationRef) {
+        const unsubscribe = navigationRef.addListener("state", () => {
+            const previousRouteName = currentRouteName;
+            const currentRoute = navigationRef.getCurrentRoute();
+            currentRouteName = currentRoute?.name;
+            // Skip if no route name or same as previous
+            if (!currentRouteName || currentRouteName === previousRouteName) {
+                return;
+            }
+            // Skip ignored screens
+            if (ignoreScreens.includes(currentRouteName)) {
+                return;
+            }
+            // Track screen view
+            const properties = {
+                screen_name: currentRouteName,
+                previous_screen: previousRouteName ?? null,
+            };
+            // Optionally include params
+            if (trackParams && currentRoute?.params) {
+                properties["params"] = sanitizeParams(currentRoute.params);
+            }
+            client.track(eventName, properties);
+        });
+        return unsubscribe;
+    }
+    /**
+     * Get the current route name
+     */
+    function getCurrentRouteName() {
+        return currentRouteName;
+    }
+    /**
+     * Manually track a screen view
+     */
+    function trackScreen(screenName, params) {
+        if (ignoreScreens.includes(screenName)) {
+            return;
+        }
+        const properties = {
+            screen_name: screenName,
+            previous_screen: currentRouteName ?? null,
+        };
+        if (trackParams && params) {
+            properties["params"] = sanitizeParams(params);
+        }
+        currentRouteName = screenName;
+        client.track(eventName, properties);
+    }
+    return {
+        setup,
+        getCurrentRouteName,
+        trackScreen,
+    };
+}
+/**
+ * Sanitize params to remove potentially sensitive data
+ */
+function sanitizeParams(params) {
+    const sanitized = {};
+    for (const [key, value] of Object.entries(params)) {
+        // Skip potentially sensitive keys
+        const lowerKey = key.toLowerCase();
+        if (lowerKey.includes("password") ||
+            lowerKey.includes("token") ||
+            lowerKey.includes("secret") ||
+            lowerKey.includes("key") ||
+            lowerKey.includes("auth")) {
+            continue;
+        }
+        // Only include primitive values
+        if (typeof value === "string" ||
+            typeof value === "number" ||
+            typeof value === "boolean") {
+            sanitized[key] = value;
+        }
+    }
+    return sanitized;
+}
+//# sourceMappingURL=screen-tracker.js.map

package/dist/screen-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-tracker.js","sourceRoot":"","sources":["../src/screen-tracker.ts"],"names":[],"mappings":"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"}

package/dist/storage.d.ts

@@ -0,0 +1,16 @@
+import type { StorageAdapter } from "@product-intelligence-hub/sdk-core";
+/** Shape of an AsyncStorage-compatible module */
+export type AsyncStorageCompat = {
+    getItem: (key: string) => Promise<string | null>;
+    setItem: (key: string, value: string) => Promise<void>;
+    removeItem: (key: string) => Promise<void>;
+};
+/**
+ * Create the React Native storage adapter
+ */
+export declare function createRNStorage(asyncStorage?: AsyncStorageCompat): StorageAdapter;
+/**
+ * Export the storage adapter singleton
+ */
+export declare const rnStorage: StorageAdapter;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,iDAAiD;AACjD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACjD,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C,CAAC;AAmEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,YAAY,CAAC,EAAE,kBAAkB,GAAG,cAAc,CAYjF;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,gBAAoB,CAAC"}

package/dist/storage.js

@@ -0,0 +1,76 @@
+// AsyncStorage is imported dynamically to handle cases where it's not installed
+let AsyncStorageModule = null;
+try {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    AsyncStorageModule = require("@react-native-async-storage/async-storage").default;
+}
+catch {
+    // AsyncStorage not available
+}
+/**
+ * AsyncStorage adapter for React Native
+ */
+class AsyncStorageAdapter {
+    asyncStorage;
+    constructor(asyncStorage) {
+        this.asyncStorage = asyncStorage;
+    }
+    async get(key) {
+        try {
+            return await this.asyncStorage.getItem(key);
+        }
+        catch (error) {
+            console.warn("[PIH] AsyncStorage.getItem error:", error);
+            return null;
+        }
+    }
+    async set(key, value) {
+        try {
+            await this.asyncStorage.setItem(key, value);
+        }
+        catch (error) {
+            console.warn("[PIH] AsyncStorage.setItem error:", error);
+        }
+    }
+    async remove(key) {
+        try {
+            await this.asyncStorage.removeItem(key);
+        }
+        catch (error) {
+            console.warn("[PIH] AsyncStorage.removeItem error:", error);
+        }
+    }
+}
+/**
+ * In-memory storage fallback
+ */
+class MemoryStorage {
+    data = new Map();
+    async get(key) {
+        return this.data.get(key) ?? null;
+    }
+    async set(key, value) {
+        this.data.set(key, value);
+    }
+    async remove(key) {
+        this.data.delete(key);
+    }
+}
+/**
+ * Create the React Native storage adapter
+ */
+export function createRNStorage(asyncStorage) {
+    // Use provided storage or the auto-detected module
+    const storageModule = asyncStorage ?? AsyncStorageModule;
+    if (storageModule) {
+        return new AsyncStorageAdapter(storageModule);
+    }
+    console.warn("[PIH] AsyncStorage not available, using in-memory storage. " +
+        "Make sure @react-native-async-storage/async-storage is installed.");
+    return new MemoryStorage();
+}
+/**
+ * Export the storage adapter singleton
+ */
+export const rnStorage = createRNStorage();
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AASA,gFAAgF;AAChF,IAAI,kBAAkB,GAA8B,IAAI,CAAC;AAEzD,IAAI,CAAC;IACH,8DAA8D;IAC9D,kBAAkB,GAAG,OAAO,CAAC,2CAA2C,CAAC,CAAC,OAAO,CAAC;AACpF,CAAC;AAAC,MAAM,CAAC;IACP,6BAA6B;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,mBAAmB;IACf,YAAY,CAAqB;IAEzC,YAAY,YAAgC;QAC1C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;YACzD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAa;QAClC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,aAAa;IACT,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEzC,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAa;QAClC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,YAAiC;IAC/D,mDAAmD;IACnD,MAAM,aAAa,GAAG,YAAY,IAAI,kBAAkB,CAAC;IACzD,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,IAAI,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,CAAC,IAAI,CACV,6DAA6D;QAC3D,mEAAmE,CACtE,CAAC;IACF,OAAO,IAAI,aAAa,EAAE,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@product-intelligence-hub/sdk-react-native",
+  "version": "0.1.0",
+  "description": "React Native SDK for Product Intelligence Hub",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/product-intelligence-hub/product-intelligence-hub",
+    "directory": "packages/sdk-react-native"
+  },
+  "keywords": [
+    "analytics",
+    "product-intelligence",
+    "sdk",
+    "tracking",
+    "events",
+    "react-native",
+    "mobile"
+  ],
+  "dependencies": {
+    "@product-intelligence-hub/sdk-core": "0.1.0"
+  },
+  "peerDependencies": {
+    "@react-native-async-storage/async-storage": ">=1.0.0",
+    "@react-navigation/native": ">=6.0.0",
+    "react-native": ">=0.60.0"
+  },
+  "peerDependenciesMeta": {
+    "@react-navigation/native": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@react-native-async-storage/async-storage": "^1.23.0",
+    "@react-navigation/native": "^6.1.0",
+    "@types/node": "^20.12.0",
+    "@types/react-native": "^0.73.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}