@amplitude/analytics-react-native 1.5.54 → 1.5.55

package/lib/commonjs/storage/local-storage.js

@@ -5,14 +5,62 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.LocalStorage = void 0;
 var _analyticsCore = require("@amplitude/analytics-core");
-var _asyncStorage = _interopRequireDefault(require("@react-native-async-storage/async-storage"));
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+// Three sentinel states:
+//   undefined - not tried yet
+//   null      - tried, package isn't available (don't retry)
+//   object    - tried, succeeded
+//
+// Resolve AsyncStorage lazily so the module can be opted out of via custom
+// `storageProvider` + `react-native.config.js` autolinking exclusion without
+// the SDK throwing at module-load time.
+//
+// The result is cached for the app lifetime: `require()` is synchronous in
+// React Native and the module registry is stable, so retrying after a failed
+// resolution would never produce a different result. Caching the failure as
+// `null` lets us skip re-running `require()` on every storage call — Metro
+// doesn't cache failed module resolutions, so without this we'd re-throw on
+// every storage call. See https://nodejs.org/api/modules.html#requirecache
+// for the success-case caching that `require()` gives us for free.
+let asyncStorage = undefined;
+const getAsyncStorage = () => {
+  if (asyncStorage !== undefined) {
+    return asyncStorage;
+  }
+  /* eslint-disable @typescript-eslint/no-var-requires, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access */
+  try {
+    const mod = require('@react-native-async-storage/async-storage');
+    // Handles both ES-module (`{ default: AsyncStorage }`) and direct-export
+    // shapes — e.g. `jest.mock(..., () => mockAsyncStorage)` returns the mock
+    // directly without a `default` wrapper. The outer `?? null` ensures we
+    // never cache a falsy success value, which would be misread as "not tried".
+    asyncStorage = (mod === null || mod === void 0 ? void 0 : mod.default) ?? mod ?? null;
+  } catch (e) {
+    asyncStorage = null;
+    // Only swallow "this exact package is not installed" silently — that's
+    // the supported opt-out path. Anything else — including a `MODULE_NOT_FOUND`
+    // that's actually about a transitive dependency, or syntax/eval errors in
+    // the package itself — should be surfaced so it can be diagnosed instead of
+    // silently degrading to in-memory storage.
+    const code = e === null || e === void 0 ? void 0 : e.code;
+    const message = e instanceof Error ? e.message : '';
+    const ourPackageMissing = code === 'MODULE_NOT_FOUND' && message.includes('@react-native-async-storage/async-storage');
+    if (!ourPackageMissing) {
+      // eslint-disable-next-line no-console
+      console.warn('[Amplitude] Failed to load @react-native-async-storage/async-storage; persistence is disabled.', e);
+    }
+  }
+  /* eslint-enable @typescript-eslint/no-var-requires, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access */
+  return asyncStorage;
+};
 class LocalStorage {
   async isEnabled() {
     /* istanbul ignore if */
     if (!(0, _analyticsCore.getGlobalScope)()) {
       return false;
     }
+    if (!getAsyncStorage()) {
+      return false;
+    }
     const random = String(Date.now());
     const testStorage = new LocalStorage();
     const testKey = 'AMP_TEST';
@@ -41,25 +89,49 @@ class LocalStorage {
     }
   }
   async getRaw(key) {
-    return (await _asyncStorage.default.getItem(key)) || undefined;
+    const storage = getAsyncStorage();
+    if (!storage) {
+      return undefined;
+    }
+    try {
+      return (await storage.getItem(key)) || undefined;
+    } catch {
+      // AsyncStorage's JS package is resolvable but the native bridge is null
+      // (e.g. customer excluded it via autolinking but the JS package is still
+      // in node_modules). Callers like `parseOldCookies` consume `getRaw`
+      // directly without their own try/catch, so we must not propagate.
+      return undefined;
+    }
   }
   async set(key, value) {
+    const storage = getAsyncStorage();
+    if (!storage) {
+      return;
+    }
     try {
-      await _asyncStorage.default.setItem(key, JSON.stringify(value));
+      await storage.setItem(key, JSON.stringify(value));
     } catch {
       //
     }
   }
   async remove(key) {
+    const storage = getAsyncStorage();
+    if (!storage) {
+      return;
+    }
     try {
-      await _asyncStorage.default.removeItem(key);
+      await storage.removeItem(key);
     } catch {
       //
     }
   }
   async reset() {
+    const storage = getAsyncStorage();
+    if (!storage) {
+      return;
+    }
     try {
-      await _asyncStorage.default.clear();
+      await storage.clear();
     } catch {
       //
     }

package/lib/commonjs/storage/local-storage.js.map

@@ -1 +1 @@
-{"version":3,"names":["_analyticsCore","require","_asyncStorage","_interopRequireDefault","e","__esModule","default","LocalStorage","isEnabled","getGlobalScope","random","String","Date","now","testStorage","testKey","set","value","get","remove","key","getRaw","undefined","JSON","parse","AsyncStorage","getItem","setItem","stringify","removeItem","reset","clear","exports"],"sourceRoot":"../../../src","sources":["storage/local-storage.ts"],"mappings":";;;;;;AAAA,IAAAA,cAAA,GAAAC,OAAA;AACA,IAAAC,aAAA,GAAAC,sBAAA,CAAAF,OAAA;AAAqE,SAAAE,uBAAAC,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAE9D,MAAMG,YAAY,CAA0B;EACjD,MAAMC,SAASA,CAAA,EAAqB;IAClC;IACA,IAAI,CAAC,IAAAC,6BAAc,EAAC,CAAC,EAAE;MACrB,OAAO,KAAK;IACd;IAEA,MAAMC,MAAM,GAAGC,MAAM,CAACC,IAAI,CAACC,GAAG,CAAC,CAAC,CAAC;IACjC,MAAMC,WAAW,GAAG,IAAIP,YAAY,CAAS,CAAC;IAC9C,MAAMQ,OAAO,GAAG,UAAU;IAC1B,IAAI;MACF,MAAMD,WAAW,CAACE,GAAG,CAACD,OAAO,EAAEL,MAAM,CAAC;MACtC,MAAMO,KAAK,GAAG,MAAMH,WAAW,CAACI,GAAG,CAACH,OAAO,CAAC;MAC5C,OAAOE,KAAK,KAAKP,MAAM;IACzB,CAAC,CAAC,MAAM;MACN;MACA,OAAO,KAAK;IACd,CAAC,SAAS;MACR,MAAMI,WAAW,CAACK,MAAM,CAACJ,OAAO,CAAC;IACnC;EACF;EAEA,MAAMG,GAAGA,CAACE,GAAW,EAA0B;IAC7C,IAAI;MACF,MAAMH,KAAK,GAAG,MAAM,IAAI,CAACI,MAAM,CAACD,GAAG,CAAC;MACpC,IAAI,CAACH,KAAK,EAAE;QACV,OAAOK,SAAS;MAClB;MACA;MACA,OAAOC,IAAI,CAACC,KAAK,CAACP,KAAK,CAAC;IAC1B,CAAC,CAAC,MAAM;MACN;MACA,OAAOK,SAAS;IAClB;EACF;EAEA,MAAMD,MAAMA,CAACD,GAAW,EAA+B;IACrD,OAAO,CAAC,MAAMK,qBAAY,CAACC,OAAO,CAACN,GAAG,CAAC,KAAKE,SAAS;EACvD;EAEA,MAAMN,GAAGA,CAACI,GAAW,EAAEH,KAAQ,EAAiB;IAC9C,IAAI;MACF,MAAMQ,qBAAY,CAACE,OAAO,CAACP,GAAG,EAAEG,IAAI,CAACK,SAAS,CAACX,KAAK,CAAC,CAAC;IACxD,CAAC,CAAC,MAAM;MACN;IAAA;EAEJ;EAEA,MAAME,MAAMA,CAACC,GAAW,EAAiB;IACvC,IAAI;MACF,MAAMK,qBAAY,CAACI,UAAU,CAACT,GAAG,CAAC;IACpC,CAAC,CAAC,MAAM;MACN;IAAA;EAEJ;EAEA,MAAMU,KAAKA,CAAA,EAAkB;IAC3B,IAAI;MACF,MAAML,qBAAY,CAACM,KAAK,CAAC,CAAC;IAC5B,CAAC,CAAC,MAAM;MACN;IAAA;EAEJ;AACF;AAACC,OAAA,CAAAzB,YAAA,GAAAA,YAAA","ignoreList":[]}
+{"version":3,"names":["_analyticsCore","require","asyncStorage","undefined","getAsyncStorage","mod","default","e","code","message","Error","ourPackageMissing","includes","console","warn","LocalStorage","isEnabled","getGlobalScope","random","String","Date","now","testStorage","testKey","set","value","get","remove","key","getRaw","JSON","parse","storage","getItem","setItem","stringify","removeItem","reset","clear","exports"],"sourceRoot":"../../../src","sources":["storage/local-storage.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/version.js

@@ -4,5 +4,5 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.VERSION = void 0;
-const VERSION = exports.VERSION = '1.5.54';
+const VERSION = exports.VERSION = '1.5.55';
 //# sourceMappingURL=version.js.map

package/lib/module/storage/local-storage.js

@@ -1,11 +1,60 @@
 import { getGlobalScope } from '@amplitude/analytics-core';
-import AsyncStorage from '@react-native-async-storage/async-storage';
+// Three sentinel states:
+//   undefined - not tried yet
+//   null      - tried, package isn't available (don't retry)
+//   object    - tried, succeeded
+//
+// Resolve AsyncStorage lazily so the module can be opted out of via custom
+// `storageProvider` + `react-native.config.js` autolinking exclusion without
+// the SDK throwing at module-load time.
+//
+// The result is cached for the app lifetime: `require()` is synchronous in
+// React Native and the module registry is stable, so retrying after a failed
+// resolution would never produce a different result. Caching the failure as
+// `null` lets us skip re-running `require()` on every storage call — Metro
+// doesn't cache failed module resolutions, so without this we'd re-throw on
+// every storage call. See https://nodejs.org/api/modules.html#requirecache
+// for the success-case caching that `require()` gives us for free.
+let asyncStorage = undefined;
+const getAsyncStorage = () => {
+  if (asyncStorage !== undefined) {
+    return asyncStorage;
+  }
+  /* eslint-disable @typescript-eslint/no-var-requires, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access */
+  try {
+    const mod = require('@react-native-async-storage/async-storage');
+    // Handles both ES-module (`{ default: AsyncStorage }`) and direct-export
+    // shapes — e.g. `jest.mock(..., () => mockAsyncStorage)` returns the mock
+    // directly without a `default` wrapper. The outer `?? null` ensures we
+    // never cache a falsy success value, which would be misread as "not tried".
+    asyncStorage = (mod === null || mod === void 0 ? void 0 : mod.default) ?? mod ?? null;
+  } catch (e) {
+    asyncStorage = null;
+    // Only swallow "this exact package is not installed" silently — that's
+    // the supported opt-out path. Anything else — including a `MODULE_NOT_FOUND`
+    // that's actually about a transitive dependency, or syntax/eval errors in
+    // the package itself — should be surfaced so it can be diagnosed instead of
+    // silently degrading to in-memory storage.
+    const code = e === null || e === void 0 ? void 0 : e.code;
+    const message = e instanceof Error ? e.message : '';
+    const ourPackageMissing = code === 'MODULE_NOT_FOUND' && message.includes('@react-native-async-storage/async-storage');
+    if (!ourPackageMissing) {
+      // eslint-disable-next-line no-console
+      console.warn('[Amplitude] Failed to load @react-native-async-storage/async-storage; persistence is disabled.', e);
+    }
+  }
+  /* eslint-enable @typescript-eslint/no-var-requires, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access */
+  return asyncStorage;
+};
 export class LocalStorage {
   async isEnabled() {
     /* istanbul ignore if */
     if (!getGlobalScope()) {
       return false;
     }
+    if (!getAsyncStorage()) {
+      return false;
+    }
     const random = String(Date.now());
     const testStorage = new LocalStorage();
     const testKey = 'AMP_TEST';
@@ -34,25 +83,49 @@ export class LocalStorage {
     }
   }
   async getRaw(key) {
-    return (await AsyncStorage.getItem(key)) || undefined;
+    const storage = getAsyncStorage();
+    if (!storage) {
+      return undefined;
+    }
+    try {
+      return (await storage.getItem(key)) || undefined;
+    } catch {
+      // AsyncStorage's JS package is resolvable but the native bridge is null
+      // (e.g. customer excluded it via autolinking but the JS package is still
+      // in node_modules). Callers like `parseOldCookies` consume `getRaw`
+      // directly without their own try/catch, so we must not propagate.
+      return undefined;
+    }
   }
   async set(key, value) {
+    const storage = getAsyncStorage();
+    if (!storage) {
+      return;
+    }
     try {
-      await AsyncStorage.setItem(key, JSON.stringify(value));
+      await storage.setItem(key, JSON.stringify(value));
     } catch {
       //
     }
   }
   async remove(key) {
+    const storage = getAsyncStorage();
+    if (!storage) {
+      return;
+    }
     try {
-      await AsyncStorage.removeItem(key);
+      await storage.removeItem(key);
     } catch {
       //
     }
   }
   async reset() {
+    const storage = getAsyncStorage();
+    if (!storage) {
+      return;
+    }
     try {
-      await AsyncStorage.clear();
+      await storage.clear();
     } catch {
       //
     }

package/lib/module/storage/local-storage.js.map

@@ -1 +1 @@
-{"version":3,"names":["getGlobalScope","AsyncStorage","LocalStorage","isEnabled","random","String","Date","now","testStorage","testKey","set","value","get","remove","key","getRaw","undefined","JSON","parse","getItem","setItem","stringify","removeItem","reset","clear"],"sourceRoot":"../../../src","sources":["storage/local-storage.ts"],"mappings":"AAAA,SAAkBA,cAAc,QAAQ,2BAA2B;AACnE,OAAOC,YAAY,MAAM,2CAA2C;AAEpE,OAAO,MAAMC,YAAY,CAA0B;EACjD,MAAMC,SAASA,CAAA,EAAqB;IAClC;IACA,IAAI,CAACH,cAAc,CAAC,CAAC,EAAE;MACrB,OAAO,KAAK;IACd;IAEA,MAAMI,MAAM,GAAGC,MAAM,CAACC,IAAI,CAACC,GAAG,CAAC,CAAC,CAAC;IACjC,MAAMC,WAAW,GAAG,IAAIN,YAAY,CAAS,CAAC;IAC9C,MAAMO,OAAO,GAAG,UAAU;IAC1B,IAAI;MACF,MAAMD,WAAW,CAACE,GAAG,CAACD,OAAO,EAAEL,MAAM,CAAC;MACtC,MAAMO,KAAK,GAAG,MAAMH,WAAW,CAACI,GAAG,CAACH,OAAO,CAAC;MAC5C,OAAOE,KAAK,KAAKP,MAAM;IACzB,CAAC,CAAC,MAAM;MACN;MACA,OAAO,KAAK;IACd,CAAC,SAAS;MACR,MAAMI,WAAW,CAACK,MAAM,CAACJ,OAAO,CAAC;IACnC;EACF;EAEA,MAAMG,GAAGA,CAACE,GAAW,EAA0B;IAC7C,IAAI;MACF,MAAMH,KAAK,GAAG,MAAM,IAAI,CAACI,MAAM,CAACD,GAAG,CAAC;MACpC,IAAI,CAACH,KAAK,EAAE;QACV,OAAOK,SAAS;MAClB;MACA;MACA,OAAOC,IAAI,CAACC,KAAK,CAACP,KAAK,CAAC;IAC1B,CAAC,CAAC,MAAM;MACN;MACA,OAAOK,SAAS;IAClB;EACF;EAEA,MAAMD,MAAMA,CAACD,GAAW,EAA+B;IACrD,OAAO,CAAC,MAAMb,YAAY,CAACkB,OAAO,CAACL,GAAG,CAAC,KAAKE,SAAS;EACvD;EAEA,MAAMN,GAAGA,CAACI,GAAW,EAAEH,KAAQ,EAAiB;IAC9C,IAAI;MACF,MAAMV,YAAY,CAACmB,OAAO,CAACN,GAAG,EAAEG,IAAI,CAACI,SAAS,CAACV,KAAK,CAAC,CAAC;IACxD,CAAC,CAAC,MAAM;MACN;IAAA;EAEJ;EAEA,MAAME,MAAMA,CAACC,GAAW,EAAiB;IACvC,IAAI;MACF,MAAMb,YAAY,CAACqB,UAAU,CAACR,GAAG,CAAC;IACpC,CAAC,CAAC,MAAM;MACN;IAAA;EAEJ;EAEA,MAAMS,KAAKA,CAAA,EAAkB;IAC3B,IAAI;MACF,MAAMtB,YAAY,CAACuB,KAAK,CAAC,CAAC;IAC5B,CAAC,CAAC,MAAM;MACN;IAAA;EAEJ;AACF","ignoreList":[]}
+{"version":3,"names":["getGlobalScope","asyncStorage","undefined","getAsyncStorage","mod","require","default","e","code","message","Error","ourPackageMissing","includes","console","warn","LocalStorage","isEnabled","random","String","Date","now","testStorage","testKey","set","value","get","remove","key","getRaw","JSON","parse","storage","getItem","setItem","stringify","removeItem","reset","clear"],"sourceRoot":"../../../src","sources":["storage/local-storage.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/version.js

@@ -1,2 +1,2 @@
-export const VERSION = '1.5.54';
+export const VERSION = '1.5.55';
 //# sourceMappingURL=version.js.map

package/lib/typescript/storage/local-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-storage.d.ts","sourceRoot":"","sources":["../../../src/storage/local-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAkB,MAAM,2BAA2B,CAAC;AAGpE,qBAAa,YAAY,CAAC,CAAC,CAAE,YAAW,OAAO,CAAC,CAAC,CAAC;IAC1C,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAqB7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAcxC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAIhD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}
+{"version":3,"file":"local-storage.d.ts","sourceRoot":"","sources":["../../../src/storage/local-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAkB,MAAM,2BAA2B,CAAC;AA2DpE,qBAAa,YAAY,CAAC,CAAC,CAAE,YAAW,OAAO,CAAC,CAAC,CAAC;IAC1C,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAwB7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAcxC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAgBhD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAW7B"}

package/lib/typescript/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.5.54";
+export declare const VERSION = "1.5.55";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amplitude/analytics-react-native",
-  "version": "1.5.54",
+  "version": "1.5.55",
   "description": "Official React Native SDK",
   "keywords": [
     "analytics",

package/src/storage/local-storage.ts

@@ -1,5 +1,61 @@
 import { Storage, getGlobalScope } from '@amplitude/analytics-core';
-import AsyncStorage from '@react-native-async-storage/async-storage';
+
+interface AsyncStorageLike {
+  getItem(key: string): Promise<string | null>;
+  setItem(key: string, value: string): Promise<void>;
+  removeItem(key: string): Promise<void>;
+  clear(): Promise<void>;
+}
+
+// Three sentinel states:
+//   undefined - not tried yet
+//   null      - tried, package isn't available (don't retry)
+//   object    - tried, succeeded
+//
+// Resolve AsyncStorage lazily so the module can be opted out of via custom
+// `storageProvider` + `react-native.config.js` autolinking exclusion without
+// the SDK throwing at module-load time.
+//
+// The result is cached for the app lifetime: `require()` is synchronous in
+// React Native and the module registry is stable, so retrying after a failed
+// resolution would never produce a different result. Caching the failure as
+// `null` lets us skip re-running `require()` on every storage call — Metro
+// doesn't cache failed module resolutions, so without this we'd re-throw on
+// every storage call. See https://nodejs.org/api/modules.html#requirecache
+// for the success-case caching that `require()` gives us for free.
+let asyncStorage: AsyncStorageLike | null | undefined = undefined;
+
+const getAsyncStorage = (): AsyncStorageLike | null | undefined => {
+  if (asyncStorage !== undefined) {
+    return asyncStorage;
+  }
+  /* eslint-disable @typescript-eslint/no-var-requires, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access */
+  try {
+    const mod = require('@react-native-async-storage/async-storage');
+    // Handles both ES-module (`{ default: AsyncStorage }`) and direct-export
+    // shapes — e.g. `jest.mock(..., () => mockAsyncStorage)` returns the mock
+    // directly without a `default` wrapper. The outer `?? null` ensures we
+    // never cache a falsy success value, which would be misread as "not tried".
+    asyncStorage = mod?.default ?? mod ?? null;
+  } catch (e) {
+    asyncStorage = null;
+    // Only swallow "this exact package is not installed" silently — that's
+    // the supported opt-out path. Anything else — including a `MODULE_NOT_FOUND`
+    // that's actually about a transitive dependency, or syntax/eval errors in
+    // the package itself — should be surfaced so it can be diagnosed instead of
+    // silently degrading to in-memory storage.
+    const code = (e as NodeJS.ErrnoException | undefined)?.code;
+    const message = e instanceof Error ? e.message : '';
+    const ourPackageMissing =
+      code === 'MODULE_NOT_FOUND' && message.includes('@react-native-async-storage/async-storage');
+    if (!ourPackageMissing) {
+      // eslint-disable-next-line no-console
+      console.warn('[Amplitude] Failed to load @react-native-async-storage/async-storage; persistence is disabled.', e);
+    }
+  }
+  /* eslint-enable @typescript-eslint/no-var-requires, @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access */
+  return asyncStorage;
+};
 
 export class LocalStorage<T> implements Storage<T> {
   async isEnabled(): Promise<boolean> {
@@ -7,6 +63,9 @@ export class LocalStorage<T> implements Storage<T> {
     if (!getGlobalScope()) {
       return false;
     }
+    if (!getAsyncStorage()) {
+      return false;
+    }
 
     const random = String(Date.now());
     const testStorage = new LocalStorage<string>();
@@ -38,28 +97,52 @@ export class LocalStorage<T> implements Storage<T> {
   }
 
   async getRaw(key: string): Promise<string | undefined> {
-    return (await AsyncStorage.getItem(key)) || undefined;
+    const storage = getAsyncStorage();
+    if (!storage) {
+      return undefined;
+    }
+    try {
+      return (await storage.getItem(key)) || undefined;
+    } catch {
+      // AsyncStorage's JS package is resolvable but the native bridge is null
+      // (e.g. customer excluded it via autolinking but the JS package is still
+      // in node_modules). Callers like `parseOldCookies` consume `getRaw`
+      // directly without their own try/catch, so we must not propagate.
+      return undefined;
+    }
   }
 
   async set(key: string, value: T): Promise<void> {
+    const storage = getAsyncStorage();
+    if (!storage) {
+      return;
+    }
     try {
-      await AsyncStorage.setItem(key, JSON.stringify(value));
+      await storage.setItem(key, JSON.stringify(value));
     } catch {
       //
     }
   }
 
   async remove(key: string): Promise<void> {
+    const storage = getAsyncStorage();
+    if (!storage) {
+      return;
+    }
     try {
-      await AsyncStorage.removeItem(key);
+      await storage.removeItem(key);
     } catch {
       //
     }
   }
 
   async reset(): Promise<void> {
+    const storage = getAsyncStorage();
+    if (!storage) {
+      return;
+    }
     try {
-      await AsyncStorage.clear();
+      await storage.clear();
     } catch {
       //
     }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.5.54';
+export const VERSION = '1.5.55';