riuve-rn 1.0.4 → 1.0.6

package/README.md

@@ -55,14 +55,24 @@ or
 yarn add riuve-rn
 ```
 
-### 2. Install Required Dependencies
+### 2. Install a Storage Backend
 
-**AsyncStorage** is required for the SDK to function:
+The SDK needs a storage backend for persisting events and user data. Choose **one** of the following:
+
+**Option A: AsyncStorage (default)**
 
 ```bash
 npm install @react-native-async-storage/async-storage
 ```
 
+**Option B: MMKV (recommended for performance)**
+
+```bash
+npm install react-native-mmkv
+```
+
+> MMKV is a high-performance synchronous storage library. If your project already uses MMKV, you can use it with the SDK — no need to install AsyncStorage. See [MMKV Storage](#6-mmkv-storage) for setup.
+
 ### 3. (Optional) Expo Modules
 
 If you're using Expo, install these for device info and network monitoring:
@@ -263,7 +273,27 @@ const token = await Notifications.getExpoPushTokenAsync();
 await Riuve.setFcmToken(token.data);
 ```
 
-### 5. Locale / Language Override
+### 5. MMKV Storage
+
+By default the SDK uses AsyncStorage. If your project uses `react-native-mmkv`, you can pass it as a custom storage adapter for better performance:
+
+```typescript
+import { MMKV } from 'react-native-mmkv';
+import Riuve, { MMKVStorageAdapter } from 'riuve-rn';
+
+const mmkv = new MMKV({ id: 'riuve-storage' });
+
+await Riuve.initialize('api_key', {
+  storage: new MMKVStorageAdapter(mmkv),
+});
+```
+
+**Why MMKV?**
+- Synchronous reads/writes (no async overhead)
+- ~30x faster than AsyncStorage
+- No need to install AsyncStorage if you already use MMKV
+
+### 6. Locale / Language Override
 
 Override the device locale so the backend session uses your chosen language (e.g. for localized push notifications):
 
@@ -427,6 +457,10 @@ await Riuve.initialize('api_key', {
   maxQueueSize: 1000,         // Maximum queue size (default: 1000)
   eventRetentionDays: 7,      // Days to keep failed events (default: 7)
 
+  // Storage
+  storage: undefined,           // Custom storage adapter (default: AsyncStorageAdapter)
+                                // Use new MMKVStorageAdapter(mmkv) for MMKV
+
   // Automatic Operations
   autoFlushOnBackground: true, // Auto-flush on background (default: true)
 });
@@ -883,5 +917,5 @@ MIT
 
 ---
 
-**Last Updated:** 2026-02-07
-**SDK Version:** 1.0.2
+**Last Updated:** 2026-02-25
+**SDK Version:** 1.0.5

package/dist/Riuve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Riuve.d.ts","sourceRoot":"","sources":["../src/Riuve.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,OAAO,KAAK,EAAE,WAAW,EAAS,MAAM,SAAS,CAAC;AAWlD,cAAM,QAAQ;IACZ,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAyB;IAChD,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,aAAa,CAAkB;IAEvC,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,YAAY,CAA6B;IAEjD,OAAO,CAAC,oBAAoB,CAAa;IACzC,OAAO,CAAC,aAAa,CAA4F;IAEjH;;OAEG;IACH,OAAO;IAEP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,QAAQ;IAO9B;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgI9F;;OAEG;IACG,QAAQ,CACZ,cAAc,EAAE,MAAM,EACtB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACnC,OAAO,CAAC,IAAI,CAAC;IAuChB;;OAEG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAuDpF;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsC/C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB5B;;OAEG;IACH,cAAc,IAAI,MAAM,GAAG,IAAI;IAO/B;;OAEG;IACH,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAOlC;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB9C;;OAEG;IACH,SAAS,IAAI,WAAW,GAAG,IAAI;IAI/B;;OAEG;IACH,YAAY,IAAI,MAAM;IAOtB;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAO5C;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CA4B/B;AAGD,QAAA,MAAM,KAAK,UAAyB,CAAC;AAErC,eAAe,KAAK,CAAC"}
+{"version":3,"file":"Riuve.d.ts","sourceRoot":"","sources":["../src/Riuve.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,OAAO,KAAK,EAAE,WAAW,EAAS,MAAM,SAAS,CAAC;AAWlD,cAAM,QAAQ;IACZ,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAyB;IAChD,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,aAAa,CAAkB;IAEvC,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,YAAY,CAA6B;IAEjD,OAAO,CAAC,oBAAoB,CAAa;IACzC,OAAO,CAAC,aAAa,CAA4F;IAEjH;;OAEG;IACH,OAAO;IAEP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,QAAQ;IAO9B;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA4J9F;;OAEG;IACG,QAAQ,CACZ,cAAc,EAAE,MAAM,EACtB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACnC,OAAO,CAAC,IAAI,CAAC;IAuChB;;OAEG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAuDpF;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsC/C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB5B;;OAEG;IACH,cAAc,IAAI,MAAM,GAAG,IAAI;IAO/B;;OAEG;IACH,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAOlC;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB9C;;OAEG;IACH,SAAS,IAAI,WAAW,GAAG,IAAI;IAI/B;;OAEG;IACH,YAAY,IAAI,MAAM;IAOtB;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAO5C;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CA4B/B;AAGD,QAAA,MAAM,KAAK,UAAyB,CAAC;AAErC,eAAe,KAAK,CAAC"}

package/dist/Riuve.js

@@ -51,6 +51,8 @@ class RiuveSDK {
             ...config,
             apiKey,
         };
+        // Initialize storage adapter (must happen before any storage operations)
+        Storage_1.storage.initialize(this.config.storage);
         // Restore persisted locale override if not passed in config
         if (this.config.localeOverride === undefined) {
             const storedLocale = await Storage_1.storage.get('LOCALE_OVERRIDE');
@@ -101,6 +103,29 @@ class RiuveSDK {
             if (this.config.autoFlushOnBackground) {
                 this.setupAppStateListener();
             }
+            // Process immediate events FIRST (e.g. app_opened) — before any pending events
+            const immediateEvents = this.config.immediateEvents;
+            if (immediateEvents && immediateEvents.length > 0) {
+                const anonymousId = this.identityManager.getAnonymousId();
+                const externalUserId = this.identityManager.getExternalUserId();
+                for (const ie of immediateEvents) {
+                    try {
+                        const event = {
+                            id: (0, uuid_1.generateUUID)(),
+                            name: ie.name,
+                            properties: ie.properties,
+                            timestamp: Date.now(),
+                            anonymousId,
+                            externalUserId: externalUserId || undefined,
+                        };
+                        await this.eventQueue.enqueue(event);
+                        logger_1.logger.info(`Immediate event enqueued: ${ie.name}`);
+                    }
+                    catch (error) {
+                        logger_1.logger.error(`Failed to enqueue immediate event '${ie.name}':`, error);
+                    }
+                }
+            }
             // Process pending events (events that were tracked before initialization)
             if (this.pendingEvents.length > 0) {
                 logger_1.logger.info(`Processing ${this.pendingEvents.length} pending events...`);

package/dist/adapters/storage/AsyncStorageAdapter.d.ts

@@ -0,0 +1,14 @@
+/**
+ * AsyncStorage Adapter
+ *
+ * Default storage adapter using @react-native-async-storage/async-storage.
+ */
+import type { StorageAdapter } from './types';
+export declare class AsyncStorageAdapter implements StorageAdapter {
+    constructor();
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    multiRemove(keys: string[]): Promise<void>;
+}
+//# sourceMappingURL=AsyncStorageAdapter.d.ts.map

package/dist/adapters/storage/AsyncStorageAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsyncStorageAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/storage/AsyncStorageAdapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAU9C,qBAAa,mBAAoB,YAAW,cAAc;;IAUlD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI5C,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAGjD"}

package/dist/adapters/storage/AsyncStorageAdapter.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * AsyncStorage Adapter
+ *
+ * Default storage adapter using @react-native-async-storage/async-storage.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AsyncStorageAdapter = void 0;
+// Dynamic require to avoid Metro bundling error when module is not installed
+let AsyncStorage;
+try {
+    AsyncStorage = require('@react-native-async-storage/async-storage').default;
+}
+catch {
+    AsyncStorage = null;
+}
+class AsyncStorageAdapter {
+    constructor() {
+        if (!AsyncStorage) {
+            throw new Error('AsyncStorage is not available. Install @react-native-async-storage/async-storage ' +
+                'or provide a custom storage adapter (e.g., MMKVStorageAdapter).');
+        }
+    }
+    async getItem(key) {
+        return AsyncStorage.getItem(key);
+    }
+    async setItem(key, value) {
+        await AsyncStorage.setItem(key, value);
+    }
+    async removeItem(key) {
+        await AsyncStorage.removeItem(key);
+    }
+    async multiRemove(keys) {
+        await AsyncStorage.multiRemove(keys);
+    }
+}
+exports.AsyncStorageAdapter = AsyncStorageAdapter;

package/dist/adapters/storage/MMKVStorageAdapter.d.ts

@@ -0,0 +1,34 @@
+/**
+ * MMKV Storage Adapter
+ *
+ * Storage adapter using react-native-mmkv for high-performance synchronous storage.
+ * The user must create their own MMKV instance and pass it to this adapter.
+ *
+ * Usage:
+ *   import { MMKV } from 'react-native-mmkv';
+ *   import { MMKVStorageAdapter } from 'riuve-rn';
+ *
+ *   const mmkv = new MMKV({ id: 'riuve-storage' });
+ *   const storageAdapter = new MMKVStorageAdapter(mmkv);
+ *
+ *   await Riuve.initialize('api_key', { storage: storageAdapter });
+ */
+import type { StorageAdapter } from './types';
+/**
+ * Minimal MMKV interface that the adapter depends on.
+ * This avoids importing react-native-mmkv as a dependency.
+ */
+export interface MMKVInterface {
+    getString(key: string): string | undefined;
+    set(key: string, value: string): void;
+    delete(key: string): void;
+}
+export declare class MMKVStorageAdapter implements StorageAdapter {
+    private mmkv;
+    constructor(mmkv: MMKVInterface);
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    multiRemove(keys: string[]): Promise<void>;
+}
+//# sourceMappingURL=MMKVStorageAdapter.d.ts.map

package/dist/adapters/storage/MMKVStorageAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MMKVStorageAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/storage/MMKVStorageAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC3C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,qBAAa,kBAAmB,YAAW,cAAc;IACvD,OAAO,CAAC,IAAI,CAAgB;gBAEhB,IAAI,EAAE,aAAa;IASzB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI5C,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAKjD"}

package/dist/adapters/storage/MMKVStorageAdapter.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * MMKV Storage Adapter
+ *
+ * Storage adapter using react-native-mmkv for high-performance synchronous storage.
+ * The user must create their own MMKV instance and pass it to this adapter.
+ *
+ * Usage:
+ *   import { MMKV } from 'react-native-mmkv';
+ *   import { MMKVStorageAdapter } from 'riuve-rn';
+ *
+ *   const mmkv = new MMKV({ id: 'riuve-storage' });
+ *   const storageAdapter = new MMKVStorageAdapter(mmkv);
+ *
+ *   await Riuve.initialize('api_key', { storage: storageAdapter });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MMKVStorageAdapter = void 0;
+class MMKVStorageAdapter {
+    constructor(mmkv) {
+        if (!mmkv) {
+            throw new Error('MMKV instance is required. Create one with: new MMKV({ id: "riuve-storage" })');
+        }
+        this.mmkv = mmkv;
+    }
+    async getItem(key) {
+        return this.mmkv.getString(key) ?? null;
+    }
+    async setItem(key, value) {
+        this.mmkv.set(key, value);
+    }
+    async removeItem(key) {
+        this.mmkv.delete(key);
+    }
+    async multiRemove(keys) {
+        for (const key of keys) {
+            this.mmkv.delete(key);
+        }
+    }
+}
+exports.MMKVStorageAdapter = MMKVStorageAdapter;

package/dist/adapters/storage/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Storage Adapter Exports
+ *
+ * Unlike network and deviceInfo adapters, the storage adapter is user-configured
+ * rather than auto-detected. The default is AsyncStorageAdapter.
+ */
+export type { StorageAdapter } from './types';
+export { AsyncStorageAdapter } from './AsyncStorageAdapter';
+export { MMKVStorageAdapter } from './MMKVStorageAdapter';
+export type { MMKVInterface } from './MMKVStorageAdapter';
+import type { StorageAdapter } from './types';
+/**
+ * Creates the default storage adapter (AsyncStorage).
+ */
+export declare function createDefaultStorageAdapter(): StorageAdapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,cAAc,CAE5D"}

package/dist/adapters/storage/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Storage Adapter Exports
+ *
+ * Unlike network and deviceInfo adapters, the storage adapter is user-configured
+ * rather than auto-detected. The default is AsyncStorageAdapter.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MMKVStorageAdapter = exports.AsyncStorageAdapter = void 0;
+exports.createDefaultStorageAdapter = createDefaultStorageAdapter;
+var AsyncStorageAdapter_1 = require("./AsyncStorageAdapter");
+Object.defineProperty(exports, "AsyncStorageAdapter", { enumerable: true, get: function () { return AsyncStorageAdapter_1.AsyncStorageAdapter; } });
+var MMKVStorageAdapter_1 = require("./MMKVStorageAdapter");
+Object.defineProperty(exports, "MMKVStorageAdapter", { enumerable: true, get: function () { return MMKVStorageAdapter_1.MMKVStorageAdapter; } });
+const AsyncStorageAdapter_2 = require("./AsyncStorageAdapter");
+/**
+ * Creates the default storage adapter (AsyncStorage).
+ */
+function createDefaultStorageAdapter() {
+    return new AsyncStorageAdapter_2.AsyncStorageAdapter();
+}

package/dist/adapters/storage/types.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Storage Adapter Types
+ *
+ * Defines the interface that all storage adapters must implement.
+ * All methods are async since AsyncStorage requires it.
+ * Synchronous adapters (like MMKV) wrap their results in resolved promises.
+ */
+export interface StorageAdapter {
+    /** Gets a string value by key. Returns null if the key does not exist. */
+    getItem(key: string): Promise<string | null>;
+    /** Sets a string value for a key. */
+    setItem(key: string, value: string): Promise<void>;
+    /** Removes a key from storage. */
+    removeItem(key: string): Promise<void>;
+    /** Removes multiple keys from storage. */
+    multiRemove(keys: string[]): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/storage/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/adapters/storage/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE7C,qCAAqC;IACrC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD,kCAAkC;IAClC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC,0CAA0C;IAC1C,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C"}

package/dist/adapters/storage/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Storage Adapter Types
+ *
+ * Defines the interface that all storage adapters must implement.
+ * All methods are async since AsyncStorage requires it.
+ * Synchronous adapters (like MMKV) wrap their results in resolved promises.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/Storage.d.ts

@@ -1,8 +1,19 @@
 /**
- * Storage Layer - AsyncStorage Wrapper
+ * Storage Layer - Adapter-based Storage Wrapper
  */
+import type { StorageAdapter } from '../adapters/storage/types';
 import type { StorageKey, StorageValue } from '../types/storage';
 declare class Storage {
+    private adapter;
+    /**
+     * Initializes storage with the given adapter.
+     * If no adapter is provided, uses AsyncStorageAdapter as default.
+     */
+    initialize(adapter?: StorageAdapter): void;
+    /**
+     * Gets the active adapter, initializing with default if needed.
+     */
+    private getAdapter;
     /**
      * Sets a value in storage
      */

package/dist/core/Storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Storage.d.ts","sourceRoot":"","sources":["../../src/core/Storage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGjE,cAAM,OAAO;IACX;;OAEG;IACG,GAAG,CAAC,CAAC,SAAS,UAAU,EAC5B,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GACrB,OAAO,CAAC,IAAI,CAAC;IAYhB;;OAEG;IACG,GAAG,CAAC,CAAC,SAAS,UAAU,EAC5B,GAAG,EAAE,CAAC,GACL,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAiBlC;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAW5C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;CAQ7C;AAED,eAAO,MAAM,OAAO,SAAgB,CAAC"}
+{"version":3,"file":"Storage.d.ts","sourceRoot":"","sources":["../../src/core/Storage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAGhE,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGjE,cAAM,OAAO;IACX,OAAO,CAAC,OAAO,CAA+B;IAE9C;;;OAGG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI;IAI1C;;OAEG;IACH,OAAO,CAAC,UAAU;IAOlB;;OAEG;IACG,GAAG,CAAC,CAAC,SAAS,UAAU,EAC5B,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GACrB,OAAO,CAAC,IAAI,CAAC;IAWhB;;OAEG;IACG,GAAG,CAAC,CAAC,SAAS,UAAU,EAC5B,GAAG,EAAE,CAAC,GACL,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAiBlC;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;CAQ7C;AAED,eAAO,MAAM,OAAO,SAAgB,CAAC"}

package/dist/core/Storage.js

@@ -1,16 +1,32 @@
 "use strict";
 /**
- * Storage Layer - AsyncStorage Wrapper
+ * Storage Layer - Adapter-based Storage Wrapper
  */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.storage = void 0;
-const async_storage_1 = __importDefault(require("@react-native-async-storage/async-storage"));
+const storage_1 = require("../adapters/storage");
 const constants_1 = require("../constants");
 const logger_1 = require("../utils/logger");
 class Storage {
+    constructor() {
+        this.adapter = null;
+    }
+    /**
+     * Initializes storage with the given adapter.
+     * If no adapter is provided, uses AsyncStorageAdapter as default.
+     */
+    initialize(adapter) {
+        this.adapter = adapter ?? (0, storage_1.createDefaultStorageAdapter)();
+    }
+    /**
+     * Gets the active adapter, initializing with default if needed.
+     */
+    getAdapter() {
+        if (!this.adapter) {
+            this.adapter = (0, storage_1.createDefaultStorageAdapter)();
+        }
+        return this.adapter;
+    }
     /**
      * Sets a value in storage
      */
@@ -18,8 +34,7 @@ class Storage {
         try {
             const storageKey = constants_1.STORAGE_KEYS[key];
             const serialized = JSON.stringify(value);
-            await async_storage_1.default.setItem(storageKey, serialized);
-            // Removed verbose debug logging for production
+            await this.getAdapter().setItem(storageKey, serialized);
         }
         catch (error) {
             logger_1.logger.error(`Storage set failed for ${key}:`, error);
@@ -32,7 +47,7 @@ class Storage {
     async get(key) {
         try {
             const storageKey = constants_1.STORAGE_KEYS[key];
-            const serialized = await async_storage_1.default.getItem(storageKey);
+            const serialized = await this.getAdapter().getItem(storageKey);
             if (serialized === null) {
                 return null;
             }
@@ -50,8 +65,7 @@ class Storage {
     async remove(key) {
         try {
             const storageKey = constants_1.STORAGE_KEYS[key];
-            await async_storage_1.default.removeItem(storageKey);
-            // Removed verbose debug logging for production
+            await this.getAdapter().removeItem(storageKey);
         }
         catch (error) {
             logger_1.logger.error(`Storage remove failed for ${key}:`, error);
@@ -64,8 +78,7 @@ class Storage {
     async clear() {
         try {
             const keys = Object.values(constants_1.STORAGE_KEYS);
-            await async_storage_1.default.multiRemove(keys);
-            // Removed verbose info logging for production
+            await this.getAdapter().multiRemove(keys);
         }
         catch (error) {
             logger_1.logger.error('Storage clear failed:', error);

package/dist/index.d.ts

@@ -5,5 +5,7 @@
 import Riuve from './Riuve';
 export default Riuve;
 export type { RiuveConfig, RiuveConfigInput, Event, DeviceInfo, EventBatch, FailedBatch, InitializeRequest, InitializeResponse, IdentifyRequest, IdentifyResponse, TrackRequest, TrackResponse, SetFcmTokenRequest, SetFcmTokenResponse, ApiError, ErrorType, } from './types';
+export { AsyncStorageAdapter, MMKVStorageAdapter } from './adapters/storage';
+export type { StorageAdapter, MMKVInterface } from './adapters/storage';
 export { DEFAULT_CONFIG, ERROR_MESSAGES } from './constants';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,SAAS,CAAC;AAG5B,eAAe,KAAK,CAAC;AAGrB,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,KAAK,EACL,UAAU,EACV,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,QAAQ,EACR,SAAS,GACV,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,SAAS,CAAC;AAG5B,eAAe,KAAK,CAAC;AAGrB,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,KAAK,EACL,UAAU,EACV,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,QAAQ,EACR,SAAS,GACV,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -7,10 +7,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ERROR_MESSAGES = exports.DEFAULT_CONFIG = void 0;
+exports.ERROR_MESSAGES = exports.DEFAULT_CONFIG = exports.MMKVStorageAdapter = exports.AsyncStorageAdapter = void 0;
 const Riuve_1 = __importDefault(require("./Riuve"));
 // Export the SDK instance as default
 exports.default = Riuve_1.default;
+// Export storage adapters for custom storage configuration
+var storage_1 = require("./adapters/storage");
+Object.defineProperty(exports, "AsyncStorageAdapter", { enumerable: true, get: function () { return storage_1.AsyncStorageAdapter; } });
+Object.defineProperty(exports, "MMKVStorageAdapter", { enumerable: true, get: function () { return storage_1.MMKVStorageAdapter; } });
 // Export constants for advanced users
 var constants_1 = require("./constants");
 Object.defineProperty(exports, "DEFAULT_CONFIG", { enumerable: true, get: function () { return constants_1.DEFAULT_CONFIG; } });

package/dist/types/config.d.ts

@@ -1,6 +1,7 @@
 /**
  * Configuration Types
  */
+import type { StorageAdapter } from '../adapters/storage/types';
 export interface RiuveConfig {
     /** API key for authenticating with the backend */
     apiKey: string;
@@ -26,6 +27,17 @@ export interface RiuveConfig {
     debugMode: boolean;
     /** Override device locale for session (e.g. 'tr', 'en', 'ar'). Persisted and sent to backend. */
     localeOverride?: string;
+    /** Custom storage adapter (default: AsyncStorageAdapter). Use MMKVStorageAdapter for MMKV. */
+    storage?: StorageAdapter;
+    /**
+     * Events to enqueue immediately during initialization, BEFORE any pending events.
+     * Use this for events like 'app_opened' that must appear first in the timeline,
+     * even when child components queue screen_viewed events before initialize() runs.
+     */
+    immediateEvents?: Array<{
+        name: string;
+        properties?: Record<string, any>;
+    }>;
 }
 /** Partial configuration that can be passed during initialization */
 export type RiuveConfigInput = Partial<Omit<RiuveConfig, 'apiKey'>> & {

package/dist/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IAEf,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAElB,mFAAmF;IACnF,YAAY,EAAE,MAAM,CAAC;IAErB,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;IAEnB,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IAEnB,oEAAoE;IACpE,aAAa,EAAE,OAAO,CAAC;IAEvB,6EAA6E;IAC7E,qBAAqB,EAAE,OAAO,CAAC;IAE/B,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;IAErB,0DAA0D;IAC1D,kBAAkB,EAAE,MAAM,CAAC;IAE3B,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IAEvB,+DAA+D;IAC/D,SAAS,EAAE,OAAO,CAAC;IAEnB,iGAAiG;IACjG,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,GAAG;IACpE,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IAEf,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAElB,mFAAmF;IACnF,YAAY,EAAE,MAAM,CAAC;IAErB,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;IAEnB,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IAEnB,oEAAoE;IACpE,aAAa,EAAE,OAAO,CAAC;IAEvB,6EAA6E;IAC7E,qBAAqB,EAAE,OAAO,CAAC;IAE/B,iEAAiE;IACjE,YAAY,EAAE,MAAM,CAAC;IAErB,0DAA0D;IAC1D,kBAAkB,EAAE,MAAM,CAAC;IAE3B,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IAEvB,+DAA+D;IAC/D,SAAS,EAAE,OAAO,CAAC;IAEnB,iGAAiG;IACjG,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,8FAA8F;IAC9F,OAAO,CAAC,EAAE,cAAc,CAAC;IAEzB;;;;OAIG;IACH,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAC,CAAC;CAC7E;AAED,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,GAAG;IACpE,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "riuve-rn",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Behavioral event tracking SDK for React Native with offline support and intelligent batching",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -31,6 +31,12 @@
     "react-native": ">=0.70.0"
   },
   "peerDependenciesMeta": {
+    "@react-native-async-storage/async-storage": {
+      "optional": true
+    },
+    "react-native-mmkv": {
+      "optional": true
+    },
     "react-native-device-info": {
       "optional": true
     },