@formo/analytics-react-native 0.1.0

package/lib/commonjs/lib/session/index.js

@@ -0,0 +1,109 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.FormoAnalyticsSession = void 0;
+Object.defineProperty(exports, "SESSION_WALLET_DETECTED_KEY", {
+  enumerable: true,
+  get: function () {
+    return _constants.SESSION_WALLET_DETECTED_KEY;
+  }
+});
+Object.defineProperty(exports, "SESSION_WALLET_IDENTIFIED_KEY", {
+  enumerable: true,
+  get: function () {
+    return _constants.SESSION_WALLET_IDENTIFIED_KEY;
+  }
+});
+var _constants = require("../../constants");
+var _storage = require("../storage");
+var _logger = require("../logger");
+/**
+ * Session manager for tracking wallet detection and identification
+ * Persists to session storage to avoid duplicate detection/identification events
+ * within the same session
+ */
+class FormoAnalyticsSession {
+  detectedWallets = new Set();
+  identifiedWallets = new Set();
+  constructor() {
+    this.loadFromStorage();
+  }
+
+  /**
+   * Load session state from storage
+   */
+  loadFromStorage() {
+    try {
+      const detected = (0, _storage.storage)().get(_constants.SESSION_WALLET_DETECTED_KEY);
+      if (detected) {
+        const parsed = JSON.parse(detected);
+        this.detectedWallets = new Set(parsed);
+      }
+      const identified = (0, _storage.storage)().get(_constants.SESSION_WALLET_IDENTIFIED_KEY);
+      if (identified) {
+        const parsed = JSON.parse(identified);
+        this.identifiedWallets = new Set(parsed);
+      }
+    } catch (error) {
+      _logger.logger.debug("Session: Failed to load from storage", error);
+    }
+  }
+
+  /**
+   * Save session state to storage
+   */
+  saveToStorage() {
+    try {
+      (0, _storage.storage)().set(_constants.SESSION_WALLET_DETECTED_KEY, JSON.stringify(Array.from(this.detectedWallets)));
+      (0, _storage.storage)().set(_constants.SESSION_WALLET_IDENTIFIED_KEY, JSON.stringify(Array.from(this.identifiedWallets)));
+    } catch (error) {
+      _logger.logger.debug("Session: Failed to save to storage", error);
+    }
+  }
+
+  /**
+   * Check if a wallet has been detected in this session
+   */
+  isWalletDetected(rdns) {
+    return this.detectedWallets.has(rdns);
+  }
+
+  /**
+   * Mark a wallet as detected
+   */
+  markWalletDetected(rdns) {
+    this.detectedWallets.add(rdns);
+    this.saveToStorage();
+  }
+
+  /**
+   * Check if a wallet + address combination has been identified
+   */
+  isWalletIdentified(address, rdns) {
+    const key = `${address.toLowerCase()}:${rdns}`;
+    return this.identifiedWallets.has(key);
+  }
+
+  /**
+   * Mark a wallet + address combination as identified
+   */
+  markWalletIdentified(address, rdns) {
+    const key = `${address.toLowerCase()}:${rdns}`;
+    this.identifiedWallets.add(key);
+    this.saveToStorage();
+  }
+
+  /**
+   * Clear all session data
+   */
+  clear() {
+    this.detectedWallets.clear();
+    this.identifiedWallets.clear();
+    (0, _storage.storage)().remove(_constants.SESSION_WALLET_DETECTED_KEY);
+    (0, _storage.storage)().remove(_constants.SESSION_WALLET_IDENTIFIED_KEY);
+  }
+}
+exports.FormoAnalyticsSession = FormoAnalyticsSession;
+//# sourceMappingURL=index.js.map

package/lib/commonjs/lib/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_constants","require","_storage","_logger","FormoAnalyticsSession","detectedWallets","Set","identifiedWallets","constructor","loadFromStorage","detected","storage","get","SESSION_WALLET_DETECTED_KEY","parsed","JSON","parse","identified","SESSION_WALLET_IDENTIFIED_KEY","error","logger","debug","saveToStorage","set","stringify","Array","from","isWalletDetected","rdns","has","markWalletDetected","add","isWalletIdentified","address","key","toLowerCase","markWalletIdentified","clear","remove","exports"],"sourceRoot":"../../../../src","sources":["lib/session/index.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/lib/storage/AsyncStorageAdapter.js

@@ -0,0 +1,164 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _StorageBlueprint = _interopRequireDefault(require("./StorageBlueprint"));
+var _logger = require("../logger");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * AsyncStorage adapter for React Native
+ * Provides persistent storage across app restarts
+ */
+class AsyncStorageAdapter extends _StorageBlueprint.default {
+  asyncStorage = null;
+  cache = new Map();
+  constructor(writeKey, asyncStorage) {
+    super(writeKey);
+    if (asyncStorage) {
+      this.asyncStorage = asyncStorage;
+    }
+  }
+
+  /**
+   * Initialize with AsyncStorage instance and preload all Formo keys
+   * This ensures consent flags and other critical data are available synchronously
+   */
+  async initialize(asyncStorage) {
+    this.asyncStorage = asyncStorage;
+
+    // Preload all Formo keys into cache for synchronous access
+    // This is critical for consent checks on cold start (GDPR compliance)
+    try {
+      const allKeys = await asyncStorage.getAllKeys();
+      // getKey("") returns "formo_rn_{writeKey}_" - use this exact prefix
+      // to avoid matching keys from other instances (e.g., "abc" matching "abc123")
+      const formoPrefix = this.getKey("");
+
+      // Filter to only our keys (exact prefix match including trailing underscore)
+      const formoKeys = allKeys.filter(key => key.startsWith(formoPrefix));
+      if (formoKeys.length > 0) {
+        const pairs = await asyncStorage.multiGet(formoKeys);
+        for (const [key, value] of pairs) {
+          if (value !== null) {
+            this.cache.set(key, value);
+          }
+        }
+        _logger.logger.debug(`AsyncStorageAdapter: Preloaded ${formoKeys.length} keys into cache`);
+      }
+    } catch (error) {
+      _logger.logger.error("AsyncStorageAdapter: Failed to preload keys", error);
+    }
+    _logger.logger.debug("AsyncStorageAdapter: Initialized");
+  }
+  isAvailable() {
+    return this.asyncStorage !== null;
+  }
+
+  /**
+   * Synchronous get from cache (may return stale data)
+   * Use getAsync for guaranteed fresh data
+   */
+  get(key) {
+    const cachedValue = this.cache.get(this.getKey(key));
+    if (cachedValue !== undefined) {
+      return cachedValue;
+    }
+
+    // Trigger async fetch to populate cache
+    this.getAsync(key).catch(() => {
+      // Ignore errors in background fetch
+    });
+    return null;
+  }
+
+  /**
+   * Async get from storage
+   */
+  async getAsync(key) {
+    if (!this.asyncStorage) {
+      return this.cache.get(this.getKey(key)) ?? null;
+    }
+    try {
+      const fullKey = this.getKey(key);
+      const value = await this.asyncStorage.getItem(fullKey);
+      if (value !== null) {
+        this.cache.set(fullKey, value);
+      }
+      return value;
+    } catch (error) {
+      _logger.logger.error("AsyncStorageAdapter: Failed to get item", error);
+      return this.cache.get(this.getKey(key)) ?? null;
+    }
+  }
+
+  /**
+   * Synchronous set (writes to cache immediately, persists async)
+   */
+  set(key, value) {
+    const fullKey = this.getKey(key);
+    this.cache.set(fullKey, value);
+
+    // Persist asynchronously
+    this.setAsync(key, value).catch(error => {
+      _logger.logger.error("AsyncStorageAdapter: Failed to persist item", error);
+    });
+  }
+
+  /**
+   * Async set to storage
+   */
+  async setAsync(key, value) {
+    const fullKey = this.getKey(key);
+    this.cache.set(fullKey, value);
+    if (!this.asyncStorage) {
+      return;
+    }
+    try {
+      await this.asyncStorage.setItem(fullKey, value);
+    } catch (error) {
+      _logger.logger.error("AsyncStorageAdapter: Failed to set item", error);
+      throw error;
+    }
+  }
+
+  /**
+   * Synchronous remove (removes from cache immediately, persists async)
+   */
+  remove(key) {
+    const fullKey = this.getKey(key);
+    this.cache.delete(fullKey);
+
+    // Persist asynchronously
+    this.removeAsync(key).catch(error => {
+      _logger.logger.error("AsyncStorageAdapter: Failed to remove item", error);
+    });
+  }
+
+  /**
+   * Async remove from storage
+   */
+  async removeAsync(key) {
+    const fullKey = this.getKey(key);
+    this.cache.delete(fullKey);
+    if (!this.asyncStorage) {
+      return;
+    }
+    try {
+      await this.asyncStorage.removeItem(fullKey);
+    } catch (error) {
+      _logger.logger.error("AsyncStorageAdapter: Failed to remove item", error);
+      throw error;
+    }
+  }
+
+  /**
+   * Clear all cached data
+   */
+  clearCache() {
+    this.cache.clear();
+  }
+}
+var _default = exports.default = AsyncStorageAdapter;
+//# sourceMappingURL=AsyncStorageAdapter.js.map

package/lib/commonjs/lib/storage/AsyncStorageAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_StorageBlueprint","_interopRequireDefault","require","_logger","e","__esModule","default","AsyncStorageAdapter","StorageBlueprint","asyncStorage","cache","Map","constructor","writeKey","initialize","allKeys","getAllKeys","formoPrefix","getKey","formoKeys","filter","key","startsWith","length","pairs","multiGet","value","set","logger","debug","error","isAvailable","get","cachedValue","undefined","getAsync","catch","fullKey","getItem","setAsync","setItem","remove","delete","removeAsync","removeItem","clearCache","clear","_default","exports"],"sourceRoot":"../../../../src","sources":["lib/storage/AsyncStorageAdapter.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/lib/storage/MemoryStorage.js

@@ -0,0 +1,41 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _StorageBlueprint = _interopRequireDefault(require("./StorageBlueprint"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * In-memory storage fallback
+ * Data is lost when the app is closed
+ */
+class MemoryStorage extends _StorageBlueprint.default {
+  storage = new Map();
+  isAvailable() {
+    return true;
+  }
+  get(key) {
+    return this.storage.get(this.getKey(key)) ?? null;
+  }
+  async getAsync(key) {
+    return this.get(key);
+  }
+  set(key, value) {
+    this.storage.set(this.getKey(key), value);
+  }
+  async setAsync(key, value) {
+    this.set(key, value);
+  }
+  remove(key) {
+    this.storage.delete(this.getKey(key));
+  }
+  async removeAsync(key) {
+    this.remove(key);
+  }
+  clear() {
+    this.storage.clear();
+  }
+}
+var _default = exports.default = MemoryStorage;
+//# sourceMappingURL=MemoryStorage.js.map

package/lib/commonjs/lib/storage/MemoryStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_StorageBlueprint","_interopRequireDefault","require","e","__esModule","default","MemoryStorage","StorageBlueprint","storage","Map","isAvailable","get","key","getKey","getAsync","set","value","setAsync","remove","delete","removeAsync","clear","_default","exports"],"sourceRoot":"../../../../src","sources":["lib/storage/MemoryStorage.ts"],"mappings":";;;;;;AAAA,IAAAA,iBAAA,GAAAC,sBAAA,CAAAC,OAAA;AAAkD,SAAAD,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAElD;AACA;AACA;AACA;AACA,MAAMG,aAAa,SAASC,yBAAgB,CAAC;EACnCC,OAAO,GAAwB,IAAIC,GAAG,CAAC,CAAC;EAEzCC,WAAWA,CAAA,EAAY;IAC5B,OAAO,IAAI;EACb;EAEOC,GAAGA,CAACC,GAAW,EAAiB;IACrC,OAAO,IAAI,CAACJ,OAAO,CAACG,GAAG,CAAC,IAAI,CAACE,MAAM,CAACD,GAAG,CAAC,CAAC,IAAI,IAAI;EACnD;EAEA,MAAaE,QAAQA,CAACF,GAAW,EAA0B;IACzD,OAAO,IAAI,CAACD,GAAG,CAACC,GAAG,CAAC;EACtB;EAEOG,GAAGA,CAACH,GAAW,EAAEI,KAAa,EAAQ;IAC3C,IAAI,CAACR,OAAO,CAACO,GAAG,CAAC,IAAI,CAACF,MAAM,CAACD,GAAG,CAAC,EAAEI,KAAK,CAAC;EAC3C;EAEA,MAAaC,QAAQA,CAACL,GAAW,EAAEI,KAAa,EAAiB;IAC/D,IAAI,CAACD,GAAG,CAACH,GAAG,EAAEI,KAAK,CAAC;EACtB;EAEOE,MAAMA,CAACN,GAAW,EAAQ;IAC/B,IAAI,CAACJ,OAAO,CAACW,MAAM,CAAC,IAAI,CAACN,MAAM,CAACD,GAAG,CAAC,CAAC;EACvC;EAEA,MAAaQ,WAAWA,CAACR,GAAW,EAAiB;IACnD,IAAI,CAACM,MAAM,CAACN,GAAG,CAAC;EAClB;EAEOS,KAAKA,CAAA,EAAS;IACnB,IAAI,CAACb,OAAO,CAACa,KAAK,CAAC,CAAC;EACtB;AACF;AAAC,IAAAC,QAAA,GAAAC,OAAA,CAAAlB,OAAA,GAEcC,aAAa","ignoreList":[]}

package/lib/commonjs/lib/storage/StorageBlueprint.js

@@ -0,0 +1,24 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _constants = require("../../constants");
+/**
+ * Base storage class with key prefixing
+ */
+class StorageBlueprint {
+  constructor(writeKey) {
+    this.writeKey = writeKey;
+  }
+
+  /**
+   * Generate storage key with prefix
+   */
+  getKey(key) {
+    return `${_constants.STORAGE_PREFIX}${this.writeKey}_${key}`;
+  }
+}
+var _default = exports.default = StorageBlueprint;
+//# sourceMappingURL=StorageBlueprint.js.map

package/lib/commonjs/lib/storage/StorageBlueprint.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_constants","require","StorageBlueprint","constructor","writeKey","getKey","key","STORAGE_PREFIX","_default","exports","default"],"sourceRoot":"../../../../src","sources":["lib/storage/StorageBlueprint.ts"],"mappings":";;;;;;AAAA,IAAAA,UAAA,GAAAC,OAAA;AAGA;AACA;AACA;AACA,MAAeC,gBAAgB,CAAqB;EAGlDC,WAAWA,CAACC,QAAgB,EAAE;IAC5B,IAAI,CAACA,QAAQ,GAAGA,QAAQ;EAC1B;;EAEA;AACF;AACA;EACSC,MAAMA,CAACC,GAAW,EAAU;IACjC,OAAO,GAAGC,yBAAc,GAAG,IAAI,CAACH,QAAQ,IAAIE,GAAG,EAAE;EACnD;AASF;AAAC,IAAAE,QAAA,GAAAC,OAAA,CAAAC,OAAA,GAEcR,gBAAgB","ignoreList":[]}

package/lib/commonjs/lib/storage/StorageManager.js

@@ -0,0 +1,126 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.StorageManager = void 0;
+exports.getStorageManager = getStorageManager;
+exports.initStorageManager = initStorageManager;
+exports.storage = storage;
+var _logger = require("../logger");
+var _AsyncStorageAdapter = _interopRequireDefault(require("./AsyncStorageAdapter"));
+var _MemoryStorage = _interopRequireDefault(require("./MemoryStorage"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * Storage manager for React Native SDK
+ * Uses AsyncStorage as primary storage with MemoryStorage fallback
+ */
+class StorageManager {
+  storages = new Map();
+  constructor(writeKey) {
+    this.writeKey = writeKey;
+  }
+
+  /**
+   * Initialize with AsyncStorage instance
+   * This should be called during SDK initialization
+   */
+  async initialize(asyncStorage) {
+    // Create and initialize the AsyncStorage adapter directly.
+    // We bypass getStorage() here because it checks isAvailable() which
+    // returns false on an uninitialized adapter and would fall back to
+    // MemoryStorage, causing a crash when we call adapter.initialize().
+    const adapter = new _AsyncStorageAdapter.default(this.writeKey);
+    await adapter.initialize(asyncStorage);
+    this.storages.set("asyncStorage", adapter);
+    _logger.logger.debug("StorageManager: Initialized with AsyncStorage");
+  }
+
+  /**
+   * Get storage instance by type
+   */
+  getStorage(type) {
+    if (!this.storages.has(type)) {
+      const storage = this.createStorage(type);
+
+      // If storage is not available, fallback to memory and cache the fallback
+      if (!storage.isAvailable() && type !== "memoryStorage") {
+        _logger.logger.warn(`Storage ${type} is not available, falling back to memoryStorage`);
+        const fallback = this.getStorage("memoryStorage");
+        this.storages.set(type, fallback);
+        return fallback;
+      }
+      this.storages.set(type, storage);
+    }
+    return this.storages.get(type);
+  }
+
+  /**
+   * Create storage instance
+   */
+  createStorage(type) {
+    switch (type) {
+      case "asyncStorage":
+        return new _AsyncStorageAdapter.default(this.writeKey);
+      case "memoryStorage":
+      default:
+        return new _MemoryStorage.default(this.writeKey);
+    }
+  }
+
+  /**
+   * Get primary storage (AsyncStorage with fallback)
+   */
+  getPrimaryStorage() {
+    const asyncStorage = this.getStorage("asyncStorage");
+    if (asyncStorage.isAvailable()) {
+      return asyncStorage;
+    }
+    return this.getStorage("memoryStorage");
+  }
+
+  /**
+   * Check if persistent storage (AsyncStorage) has been initialized.
+   * Returns false if only MemoryStorage is available.
+   */
+  hasPersistentStorage() {
+    const stored = this.storages.get("asyncStorage");
+    return stored instanceof _AsyncStorageAdapter.default && stored.isAvailable();
+  }
+}
+
+// Global storage manager instance
+exports.StorageManager = StorageManager;
+let storageManagerInstance = null;
+
+/**
+ * Initialize global storage manager
+ */
+function initStorageManager(writeKey) {
+  if (!storageManagerInstance || storageManagerInstance["writeKey"] !== writeKey) {
+    // Clean up old instance before creating new one
+    if (storageManagerInstance) {
+      _logger.logger.debug("StorageManager: Replacing instance with new writeKey");
+    }
+    storageManagerInstance = new StorageManager(writeKey);
+  }
+  return storageManagerInstance;
+}
+
+/**
+ * Get global storage manager instance
+ */
+function getStorageManager() {
+  return storageManagerInstance;
+}
+
+/**
+ * Get primary storage
+ */
+function storage() {
+  if (!storageManagerInstance) {
+    throw new Error("StorageManager not initialized. Call initStorageManager first.");
+  }
+  return storageManagerInstance.getPrimaryStorage();
+}
+//# sourceMappingURL=StorageManager.js.map

package/lib/commonjs/lib/storage/StorageManager.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_logger","require","_AsyncStorageAdapter","_interopRequireDefault","_MemoryStorage","e","__esModule","default","StorageManager","storages","Map","constructor","writeKey","initialize","asyncStorage","adapter","AsyncStorageAdapter","set","logger","debug","getStorage","type","has","storage","createStorage","isAvailable","warn","fallback","get","MemoryStorage","getPrimaryStorage","hasPersistentStorage","stored","exports","storageManagerInstance","initStorageManager","getStorageManager","Error"],"sourceRoot":"../../../../src","sources":["lib/storage/StorageManager.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/lib/storage/index.js

@@ -0,0 +1,49 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _exportNames = {
+  AsyncStorageAdapter: true,
+  MemoryStorage: true
+};
+Object.defineProperty(exports, "AsyncStorageAdapter", {
+  enumerable: true,
+  get: function () {
+    return _AsyncStorageAdapter.default;
+  }
+});
+Object.defineProperty(exports, "MemoryStorage", {
+  enumerable: true,
+  get: function () {
+    return _MemoryStorage.default;
+  }
+});
+var _StorageManager = require("./StorageManager");
+Object.keys(_StorageManager).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _StorageManager[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _StorageManager[key];
+    }
+  });
+});
+var _types = require("./types");
+Object.keys(_types).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _types[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _types[key];
+    }
+  });
+});
+var _AsyncStorageAdapter = _interopRequireDefault(require("./AsyncStorageAdapter"));
+var _MemoryStorage = _interopRequireDefault(require("./MemoryStorage"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+//# sourceMappingURL=index.js.map

package/lib/commonjs/lib/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_StorageManager","require","Object","keys","forEach","key","prototype","hasOwnProperty","call","_exportNames","exports","defineProperty","enumerable","get","_types","_AsyncStorageAdapter","_interopRequireDefault","_MemoryStorage","e","__esModule","default"],"sourceRoot":"../../../../src","sources":["lib/storage/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,eAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,eAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAC,YAAA,EAAAJ,GAAA;EAAA,IAAAA,GAAA,IAAAK,OAAA,IAAAA,OAAA,CAAAL,GAAA,MAAAL,eAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAS,cAAA,CAAAD,OAAA,EAAAL,GAAA;IAAAO,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAb,eAAA,CAAAK,GAAA;IAAA;EAAA;AAAA;AACA,IAAAS,MAAA,GAAAb,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAW,MAAA,EAAAV,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAH,MAAA,CAAAI,SAAA,CAAAC,cAAA,CAAAC,IAAA,CAAAC,YAAA,EAAAJ,GAAA;EAAA,IAAAA,GAAA,IAAAK,OAAA,IAAAA,OAAA,CAAAL,GAAA,MAAAS,MAAA,CAAAT,GAAA;EAAAH,MAAA,CAAAS,cAAA,CAAAD,OAAA,EAAAL,GAAA;IAAAO,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,MAAA,CAAAT,GAAA;IAAA;EAAA;AAAA;AACA,IAAAU,oBAAA,GAAAC,sBAAA,CAAAf,OAAA;AACA,IAAAgB,cAAA,GAAAD,sBAAA,CAAAf,OAAA;AAA2D,SAAAe,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA","ignoreList":[]}

package/lib/commonjs/lib/storage/types.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=types.js.map

package/lib/commonjs/lib/storage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["lib/storage/types.ts"],"mappings":"","ignoreList":[]}