@harkenapp/sdk-react-native 0.0.1-alpha.1

package/dist/services/uploadQueueStorage.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * Persistent storage for the upload queue.
+ *
+ * Uses AsyncStorage to persist queue state across app restarts.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UploadQueueStorage = void 0;
+const async_storage_1 = __importDefault(require("@react-native-async-storage/async-storage"));
+const STORAGE_KEY = '@harkenapp/upload-queue';
+const CURRENT_VERSION = 1;
+/**
+ * Manages persistent storage of the upload queue.
+ */
+class UploadQueueStorage {
+    /**
+     * Load queue items from persistent storage.
+     * Returns empty array if no queue exists or on error.
+     */
+    async loadQueue() {
+        try {
+            const raw = await async_storage_1.default.getItem(STORAGE_KEY);
+            if (!raw) {
+                return [];
+            }
+            const parsed = JSON.parse(raw);
+            // Handle version migrations
+            if (parsed.version !== CURRENT_VERSION) {
+                return this.migrateQueue(parsed);
+            }
+            return parsed.items;
+        }
+        catch (error) {
+            console.error('[UploadQueueStorage] Failed to load queue:', error);
+            return [];
+        }
+    }
+    /**
+     * Save queue items to persistent storage.
+     */
+    async saveQueue(items) {
+        try {
+            const data = {
+                version: CURRENT_VERSION,
+                items,
+            };
+            await async_storage_1.default.setItem(STORAGE_KEY, JSON.stringify(data));
+        }
+        catch (error) {
+            console.error('[UploadQueueStorage] Failed to save queue:', error);
+        }
+    }
+    /**
+     * Clear all persisted queue data.
+     */
+    async clearQueue() {
+        try {
+            await async_storage_1.default.removeItem(STORAGE_KEY);
+        }
+        catch (error) {
+            console.error('[UploadQueueStorage] Failed to clear queue:', error);
+        }
+    }
+    /**
+     * Migrate queue data from older versions.
+     * For now, unknown versions are reset to empty.
+     */
+    migrateQueue(data) {
+        console.warn(`[UploadQueueStorage] Unknown queue version ${data.version}, resetting`);
+        return [];
+    }
+}
+exports.UploadQueueStorage = UploadQueueStorage;
+//# sourceMappingURL=uploadQueueStorage.js.map

package/dist/services/uploadQueueStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploadQueueStorage.js","sourceRoot":"","sources":["../../src/services/uploadQueueStorage.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;AAEH,8FAAqE;AAGrE,MAAM,WAAW,GAAG,yBAAyB,CAAC;AAC9C,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B;;GAEG;AACH,MAAa,kBAAkB;IAC7B;;;OAGG;IACH,KAAK,CAAC,SAAS;QACb,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,uBAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YACpD,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC;YAEjD,4BAA4B;YAC5B,IAAI,MAAM,CAAC,OAAO,KAAK,eAAe,EAAE,CAAC;gBACvC,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC;YAED,OAAO,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,KAAK,CAAC,CAAC;YACnE,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,KAAkB;QAChC,IAAI,CAAC;YACH,MAAM,IAAI,GAAmB;gBAC3B,OAAO,EAAE,eAAe;gBACxB,KAAK;aACN,CAAC;YACF,MAAM,uBAAY,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,KAAK,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,CAAC;YACH,MAAM,uBAAY,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,6CAA6C,EAAE,KAAK,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,YAAY,CAAC,IAAoB;QACvC,OAAO,CAAC,IAAI,CACV,8CAA8C,IAAI,CAAC,OAAO,aAAa,CACxE,CAAC;QACF,OAAO,EAAE,CAAC;IACZ,CAAC;CACF;AA9DD,gDA8DC"}

package/dist/storage/IdentityStore.d.ts

@@ -0,0 +1,38 @@
+import type { SecureStorage } from './types';
+/**
+ * Manages anonymous identity persistence.
+ *
+ * The identity store generates and persists a stable anonymous ID
+ * that uniquely identifies the app installation without collecting PII.
+ */
+export declare class IdentityStore {
+    private storage;
+    private cachedAnonId;
+    private initPromise;
+    constructor(storage: SecureStorage);
+    /**
+     * Get the anonymous ID, creating one if it doesn't exist.
+     *
+     * This method is safe to call multiple times concurrently.
+     * The ID is cached after first retrieval/creation.
+     *
+     * @returns The stable anonymous ID for this installation
+     */
+    getAnonymousId(): Promise<string>;
+    /**
+     * Initialize the anonymous ID by loading from storage or generating a new one.
+     */
+    private initializeAnonymousId;
+    /**
+     * Clear the stored anonymous ID.
+     *
+     * After calling this, the next call to getAnonymousId will generate a new ID.
+     * Use this for "reset" functionality or testing.
+     */
+    clearAnonymousId(): Promise<void>;
+    /**
+     * Validate that a string is a valid UUID v4 format.
+     */
+    private isValidUUID;
+}
+//# sourceMappingURL=IdentityStore.d.ts.map

package/dist/storage/IdentityStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IdentityStore.d.ts","sourceRoot":"","sources":["../../src/storage/IdentityStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,WAAW,CAAgC;gBAEvC,OAAO,EAAE,aAAa;IAIlC;;;;;;;OAOG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAcvC;;OAEG;YACW,qBAAqB;IAwBnC;;;;;OAKG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAMvC;;OAEG;IACH,OAAO,CAAC,WAAW;CAKpB"}

package/dist/storage/IdentityStore.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IdentityStore = void 0;
+const types_1 = require("./types");
+const utils_1 = require("../utils");
+/**
+ * Manages anonymous identity persistence.
+ *
+ * The identity store generates and persists a stable anonymous ID
+ * that uniquely identifies the app installation without collecting PII.
+ */
+class IdentityStore {
+    storage;
+    cachedAnonId = null;
+    initPromise = null;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * Get the anonymous ID, creating one if it doesn't exist.
+     *
+     * This method is safe to call multiple times concurrently.
+     * The ID is cached after first retrieval/creation.
+     *
+     * @returns The stable anonymous ID for this installation
+     */
+    async getAnonymousId() {
+        // Return cached value if available
+        if (this.cachedAnonId) {
+            return this.cachedAnonId;
+        }
+        // Ensure only one initialization happens
+        if (!this.initPromise) {
+            this.initPromise = this.initializeAnonymousId();
+        }
+        return this.initPromise;
+    }
+    /**
+     * Initialize the anonymous ID by loading from storage or generating a new one.
+     */
+    async initializeAnonymousId() {
+        try {
+            // Try to load existing ID
+            const existingId = await this.storage.getItem(types_1.STORAGE_KEYS.ANON_ID);
+            if (existingId && this.isValidUUID(existingId)) {
+                this.cachedAnonId = existingId;
+                return existingId;
+            }
+            // Generate and persist a new ID
+            const newId = (0, utils_1.generateUUID)();
+            await this.storage.setItem(types_1.STORAGE_KEYS.ANON_ID, newId);
+            this.cachedAnonId = newId;
+            return newId;
+        }
+        catch {
+            // If storage fails, generate a transient ID
+            // This ensures the SDK still works even if storage is unavailable
+            const fallbackId = (0, utils_1.generateUUID)();
+            this.cachedAnonId = fallbackId;
+            return fallbackId;
+        }
+    }
+    /**
+     * Clear the stored anonymous ID.
+     *
+     * After calling this, the next call to getAnonymousId will generate a new ID.
+     * Use this for "reset" functionality or testing.
+     */
+    async clearAnonymousId() {
+        this.cachedAnonId = null;
+        this.initPromise = null;
+        await this.storage.deleteItem(types_1.STORAGE_KEYS.ANON_ID);
+    }
+    /**
+     * Validate that a string is a valid UUID v4 format.
+     */
+    isValidUUID(value) {
+        const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+        return uuidRegex.test(value);
+    }
+}
+exports.IdentityStore = IdentityStore;
+//# sourceMappingURL=IdentityStore.js.map

package/dist/storage/IdentityStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IdentityStore.js","sourceRoot":"","sources":["../../src/storage/IdentityStore.ts"],"names":[],"mappings":";;;AACA,mCAAuC;AACvC,oCAAwC;AAExC;;;;;GAKG;AACH,MAAa,aAAa;IAChB,OAAO,CAAgB;IACvB,YAAY,GAAkB,IAAI,CAAC;IACnC,WAAW,GAA2B,IAAI,CAAC;IAEnD,YAAY,OAAsB;QAChC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,cAAc;QAClB,mCAAmC;QACnC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,YAAY,CAAC;QAC3B,CAAC;QAED,yCAAyC;QACzC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAClD,CAAC;QAED,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,qBAAqB;QACjC,IAAI,CAAC;YACH,0BAA0B;YAC1B,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,oBAAY,CAAC,OAAO,CAAC,CAAC;YAEpE,IAAI,UAAU,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC/C,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC;gBAC/B,OAAO,UAAU,CAAC;YACpB,CAAC;YAED,gCAAgC;YAChC,MAAM,KAAK,GAAG,IAAA,oBAAY,GAAE,CAAC;YAC7B,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,oBAAY,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACxD,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;YAC1B,OAAO,KAAK,CAAC;QACf,CAAC;QAAC,MAAM,CAAC;YACP,4CAA4C;YAC5C,kEAAkE;YAClE,MAAM,UAAU,GAAG,IAAA,oBAAY,GAAE,CAAC;YAClC,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC;YAC/B,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,gBAAgB;QACpB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,oBAAY,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,KAAa;QAC/B,MAAM,SAAS,GACb,wEAAwE,CAAC;QAC3E,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;CACF;AA9ED,sCA8EC"}

package/dist/storage/SecureStoreAdapter.d.ts

@@ -0,0 +1,28 @@
+import type { SecureStorage } from './types';
+/**
+ * Adapter for expo-secure-store.
+ *
+ * This adapter wraps expo-secure-store to implement the SecureStorage interface.
+ * It dynamically imports expo-secure-store to avoid bundling issues when not used.
+ *
+ * @example
+ * ```tsx
+ * import { createSecureStoreAdapter } from '@harkenapp/sdk-react-native';
+ * import * as SecureStore from 'expo-secure-store';
+ *
+ * const storage = createSecureStoreAdapter(SecureStore);
+ * ```
+ */
+export declare function createSecureStoreAdapter(secureStore: {
+    getItemAsync: (key: string) => Promise<string | null>;
+    setItemAsync: (key: string, value: string) => Promise<void>;
+    deleteItemAsync: (key: string) => Promise<void>;
+}): SecureStorage;
+/**
+ * In-memory storage for testing or when secure storage is unavailable.
+ * Values are not persisted across app restarts.
+ *
+ * @internal
+ */
+export declare function createMemoryStorage(): SecureStorage;
+//# sourceMappingURL=SecureStoreAdapter.d.ts.map

package/dist/storage/SecureStoreAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SecureStoreAdapter.d.ts","sourceRoot":"","sources":["../../src/storage/SecureStoreAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE;IACpD,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtD,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD,GAAG,aAAa,CAchB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAgBnD"}

package/dist/storage/SecureStoreAdapter.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSecureStoreAdapter = createSecureStoreAdapter;
+exports.createMemoryStorage = createMemoryStorage;
+/**
+ * Adapter for expo-secure-store.
+ *
+ * This adapter wraps expo-secure-store to implement the SecureStorage interface.
+ * It dynamically imports expo-secure-store to avoid bundling issues when not used.
+ *
+ * @example
+ * ```tsx
+ * import { createSecureStoreAdapter } from '@harkenapp/sdk-react-native';
+ * import * as SecureStore from 'expo-secure-store';
+ *
+ * const storage = createSecureStoreAdapter(SecureStore);
+ * ```
+ */
+function createSecureStoreAdapter(secureStore) {
+    return {
+        async getItem(key) {
+            return secureStore.getItemAsync(key);
+        },
+        async setItem(key, value) {
+            await secureStore.setItemAsync(key, value);
+        },
+        async deleteItem(key) {
+            await secureStore.deleteItemAsync(key);
+        },
+    };
+}
+/**
+ * In-memory storage for testing or when secure storage is unavailable.
+ * Values are not persisted across app restarts.
+ *
+ * @internal
+ */
+function createMemoryStorage() {
+    const storage = new Map();
+    return {
+        async getItem(key) {
+            return storage.get(key) ?? null;
+        },
+        async setItem(key, value) {
+            storage.set(key, value);
+        },
+        async deleteItem(key) {
+            storage.delete(key);
+        },
+    };
+}
+//# sourceMappingURL=SecureStoreAdapter.js.map

package/dist/storage/SecureStoreAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SecureStoreAdapter.js","sourceRoot":"","sources":["../../src/storage/SecureStoreAdapter.ts"],"names":[],"mappings":";;AAgBA,4DAkBC;AAQD,kDAgBC;AAxDD;;;;;;;;;;;;;GAaG;AACH,SAAgB,wBAAwB,CAAC,WAIxC;IACC,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,GAAW;YACvB,OAAO,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,KAAa;YACtC,MAAM,WAAW,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7C,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,GAAW;YAC1B,MAAM,WAAW,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB;IACjC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE1C,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,GAAW;YACvB,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;QAClC,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,KAAa;YACtC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC1B,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,GAAW;YAC1B,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/storage/defaultStorage.d.ts

@@ -0,0 +1,20 @@
+import type { SecureStorage } from './types';
+/**
+ * Creates or returns the default storage implementation.
+ *
+ * Attempts to use expo-secure-store if available, falling back to
+ * in-memory storage if not installed or if loading fails.
+ *
+ * @internal
+ */
+export declare function getDefaultStorage(): Promise<SecureStorage>;
+/**
+ * Synchronously creates a storage implementation.
+ *
+ * Returns a lazy wrapper that will resolve to expo-secure-store if available,
+ * or memory storage if not. The actual storage is initialized on first use.
+ *
+ * @internal
+ */
+export declare function createDefaultStorage(): SecureStorage;
+//# sourceMappingURL=defaultStorage.d.ts.map

package/dist/storage/defaultStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultStorage.d.ts","sourceRoot":"","sources":["../../src/storage/defaultStorage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAe7C;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,CAAC,CAyChE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,IAAI,aAAa,CAkCpD"}

package/dist/storage/defaultStorage.js

@@ -0,0 +1,131 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultStorage = getDefaultStorage;
+exports.createDefaultStorage = createDefaultStorage;
+const SecureStoreAdapter_1 = require("./SecureStoreAdapter");
+/**
+ * Cached default storage instance.
+ * @internal
+ */
+let defaultStorageInstance = null;
+/**
+ * Whether we've already attempted to load expo-secure-store.
+ * @internal
+ */
+let hasAttemptedLoad = false;
+/**
+ * Creates or returns the default storage implementation.
+ *
+ * Attempts to use expo-secure-store if available, falling back to
+ * in-memory storage if not installed or if loading fails.
+ *
+ * @internal
+ */
+async function getDefaultStorage() {
+    if (defaultStorageInstance) {
+        return defaultStorageInstance;
+    }
+    if (!hasAttemptedLoad) {
+        hasAttemptedLoad = true;
+        try {
+            // Dynamically import expo-secure-store
+            const SecureStore = await Promise.resolve().then(() => __importStar(require('expo-secure-store')));
+            defaultStorageInstance = {
+                async getItem(key) {
+                    return SecureStore.getItemAsync(key);
+                },
+                async setItem(key, value) {
+                    await SecureStore.setItemAsync(key, value);
+                },
+                async deleteItem(key) {
+                    await SecureStore.deleteItemAsync(key);
+                },
+            };
+            return defaultStorageInstance;
+        }
+        catch {
+            // expo-secure-store not available, fall back to memory storage
+            console.warn('[Harken] expo-secure-store not available. Using in-memory storage. ' +
+                'Anonymous IDs will not persist across app restarts. ' +
+                'Install expo-secure-store for persistent storage.');
+        }
+    }
+    // Fall back to memory storage
+    if (!defaultStorageInstance) {
+        defaultStorageInstance = (0, SecureStoreAdapter_1.createMemoryStorage)();
+    }
+    return defaultStorageInstance;
+}
+/**
+ * Synchronously creates a storage implementation.
+ *
+ * Returns a lazy wrapper that will resolve to expo-secure-store if available,
+ * or memory storage if not. The actual storage is initialized on first use.
+ *
+ * @internal
+ */
+function createDefaultStorage() {
+    // Return a lazy wrapper that initializes on first use
+    let resolvedStorage = null;
+    let initPromise = null;
+    const ensureInitialized = async () => {
+        if (resolvedStorage) {
+            return resolvedStorage;
+        }
+        if (!initPromise) {
+            initPromise = getDefaultStorage().then((storage) => {
+                resolvedStorage = storage;
+                return storage;
+            });
+        }
+        return initPromise;
+    };
+    return {
+        async getItem(key) {
+            const storage = await ensureInitialized();
+            return storage.getItem(key);
+        },
+        async setItem(key, value) {
+            const storage = await ensureInitialized();
+            await storage.setItem(key, value);
+        },
+        async deleteItem(key) {
+            const storage = await ensureInitialized();
+            await storage.deleteItem(key);
+        },
+    };
+}
+//# sourceMappingURL=defaultStorage.js.map

package/dist/storage/defaultStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultStorage.js","sourceRoot":"","sources":["../../src/storage/defaultStorage.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuBA,8CAyCC;AAUD,oDAkCC;AA3GD,6DAA2D;AAE3D;;;GAGG;AACH,IAAI,sBAAsB,GAAyB,IAAI,CAAC;AAExD;;;GAGG;AACH,IAAI,gBAAgB,GAAG,KAAK,CAAC;AAE7B;;;;;;;GAOG;AACI,KAAK,UAAU,iBAAiB;IACrC,IAAI,sBAAsB,EAAE,CAAC;QAC3B,OAAO,sBAAsB,CAAC;IAChC,CAAC;IAED,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,gBAAgB,GAAG,IAAI,CAAC;QAExB,IAAI,CAAC;YACH,uCAAuC;YACvC,MAAM,WAAW,GAAG,wDAAa,mBAAmB,GAAC,CAAC;YAEtD,sBAAsB,GAAG;gBACvB,KAAK,CAAC,OAAO,CAAC,GAAW;oBACvB,OAAO,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;gBACvC,CAAC;gBACD,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,KAAa;oBACtC,MAAM,WAAW,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBAC7C,CAAC;gBACD,KAAK,CAAC,UAAU,CAAC,GAAW;oBAC1B,MAAM,WAAW,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;gBACzC,CAAC;aACF,CAAC;YAEF,OAAO,sBAAsB,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,+DAA+D;YAC/D,OAAO,CAAC,IAAI,CACV,qEAAqE;gBACnE,sDAAsD;gBACtD,mDAAmD,CACtD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC5B,sBAAsB,GAAG,IAAA,wCAAmB,GAAE,CAAC;IACjD,CAAC;IAED,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,oBAAoB;IAClC,sDAAsD;IACtD,IAAI,eAAe,GAAyB,IAAI,CAAC;IACjD,IAAI,WAAW,GAAkC,IAAI,CAAC;IAEtD,MAAM,iBAAiB,GAAG,KAAK,IAA4B,EAAE;QAC3D,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,eAAe,CAAC;QACzB,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,WAAW,GAAG,iBAAiB,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;gBACjD,eAAe,GAAG,OAAO,CAAC;gBAC1B,OAAO,OAAO,CAAC;YACjB,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC;IAEF,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,GAAW;YACvB,MAAM,OAAO,GAAG,MAAM,iBAAiB,EAAE,CAAC;YAC1C,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,KAAa;YACtC,MAAM,OAAO,GAAG,MAAM,iBAAiB,EAAE,CAAC;YAC1C,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACpC,CAAC;QACD,KAAK,CAAC,UAAU,CAAC,GAAW;YAC1B,MAAM,OAAO,GAAG,MAAM,iBAAiB,EAAE,CAAC;YAC1C,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/storage/index.d.ts

@@ -0,0 +1,6 @@
+export type { SecureStorage } from './types';
+export { STORAGE_KEYS } from './types';
+export { createSecureStoreAdapter, createMemoryStorage } from './SecureStoreAdapter';
+export { createDefaultStorage } from './defaultStorage';
+export { IdentityStore } from './IdentityStore';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IdentityStore = exports.createDefaultStorage = exports.createMemoryStorage = exports.createSecureStoreAdapter = exports.STORAGE_KEYS = void 0;
+var types_1 = require("./types");
+Object.defineProperty(exports, "STORAGE_KEYS", { enumerable: true, get: function () { return types_1.STORAGE_KEYS; } });
+var SecureStoreAdapter_1 = require("./SecureStoreAdapter");
+Object.defineProperty(exports, "createSecureStoreAdapter", { enumerable: true, get: function () { return SecureStoreAdapter_1.createSecureStoreAdapter; } });
+Object.defineProperty(exports, "createMemoryStorage", { enumerable: true, get: function () { return SecureStoreAdapter_1.createMemoryStorage; } });
+var defaultStorage_1 = require("./defaultStorage");
+Object.defineProperty(exports, "createDefaultStorage", { enumerable: true, get: function () { return defaultStorage_1.createDefaultStorage; } });
+var IdentityStore_1 = require("./IdentityStore");
+Object.defineProperty(exports, "IdentityStore", { enumerable: true, get: function () { return IdentityStore_1.IdentityStore; } });
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":";;;AACA,iCAAuC;AAA9B,qGAAA,YAAY,OAAA;AACrB,2DAAqF;AAA5E,8HAAA,wBAAwB,OAAA;AAAE,yHAAA,mBAAmB,OAAA;AACtD,mDAAwD;AAA/C,sHAAA,oBAAoB,OAAA;AAC7B,iDAAgD;AAAvC,8GAAA,aAAa,OAAA"}

package/dist/storage/types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Interface for secure key-value storage.
+ * Default implementation uses expo-secure-store.
+ * Can be replaced with custom implementations.
+ */
+export interface SecureStorage {
+    /**
+     * Retrieve a value from secure storage.
+     * @param key - The key to retrieve
+     * @returns The stored value, or null if not found
+     */
+    getItem(key: string): Promise<string | null>;
+    /**
+     * Store a value in secure storage.
+     * @param key - The key to store under
+     * @param value - The value to store
+     */
+    setItem(key: string, value: string): Promise<void>;
+    /**
+     * Remove a value from secure storage.
+     * @param key - The key to remove
+     */
+    deleteItem(key: string): Promise<void>;
+}
+/**
+ * Storage keys used by the Harken SDK.
+ * @internal
+ */
+export declare const STORAGE_KEYS: {
+    readonly ANON_ID: "harken_anon_id";
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE7C;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;;OAGG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;;CAEf,CAAC"}

package/dist/storage/types.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STORAGE_KEYS = void 0;
+/**
+ * Storage keys used by the Harken SDK.
+ * @internal
+ */
+exports.STORAGE_KEYS = {
+    ANON_ID: 'harken_anon_id',
+};
+//# sourceMappingURL=types.js.map

package/dist/storage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":";;;AA2BA;;;GAGG;AACU,QAAA,YAAY,GAAG;IAC1B,OAAO,EAAE,gBAAgB;CACjB,CAAC"}

package/dist/theme/defaults.d.ts

@@ -0,0 +1,43 @@
+import type { HarkenColors, HarkenTypography, HarkenSpacing, HarkenRadii, HarkenTheme } from './types';
+/**
+ * Default light mode colors.
+ * Neutral, accessible palette with no hard-coded branding.
+ */
+export declare const lightColors: HarkenColors;
+/**
+ * Default dark mode colors.
+ * Inverted palette optimized for dark backgrounds.
+ */
+export declare const darkColors: HarkenColors;
+/**
+ * Default typography settings.
+ * Uses system font for maximum compatibility.
+ */
+export declare const defaultTypography: HarkenTypography;
+/**
+ * Default spacing scale.
+ * Based on a 4px grid system.
+ */
+export declare const defaultSpacing: HarkenSpacing;
+/**
+ * Default border radius values.
+ */
+export declare const defaultRadii: HarkenRadii;
+/**
+ * Complete default light theme.
+ */
+export declare const lightTheme: HarkenTheme;
+/**
+ * Complete default dark theme.
+ */
+export declare const darkTheme: HarkenTheme;
+/**
+ * Creates a theme by merging overrides with a base theme.
+ */
+export declare function createTheme(baseTheme: HarkenTheme, overrides?: {
+    colors?: Partial<HarkenColors>;
+    typography?: Partial<HarkenTypography>;
+    spacing?: Partial<HarkenSpacing>;
+    radii?: Partial<HarkenRadii>;
+}): HarkenTheme;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/theme/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/theme/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,WAAW,EACZ,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,YAoBzB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,YAoBxB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,gBAiB/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,aAO5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,WAO1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,WAKxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,WAKvB,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,WAAW,EACtB,SAAS,CAAC,EAAE;IACV,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CAC9B,GACA,WAAW,CAWb"}