react-native-onyx 3.0.95 → 3.0.97

package/dist/Onyx.d.ts

@@ -1,5 +1,5 @@
 import * as Logger from './Logger';
-import type { CollectionKeyBase, ConnectOptions, InitOptions, OnyxKey, OnyxMergeCollectionInput, OnyxSetCollectionInput, OnyxMergeInput, OnyxMultiSetInput, OnyxSetInput, OnyxUpdate, SetOptions } from './types';
+import type { CollectionKeyBase, ConnectOptions, InitOptions, OnyxKey, OnyxMergeCollectionInput, OnyxMergeInput, OnyxMultiSetInput, OnyxSetCollectionInput, OnyxSetInput, OnyxUpdate, SetOptions } from './types';
 import type { Connection } from './OnyxConnectionManager';
 /** Initialize the store with actions and listening for storage events */
 declare function init({ keys, initialKeyStates, evictableKeys, shouldSyncMultipleInstances, enableDevTools, skippableCollectionMemberIDs, ramOnlyKeys, snapshotMergeKeys, }: InitOptions): void;

package/dist/Onyx.js

@@ -55,18 +55,49 @@ function init({ keys = {}, initialKeyStates = {}, evictableKeys = [], shouldSync
     OnyxUtils_1.default.setSnapshotMergeKeys(new Set(snapshotMergeKeys));
     OnyxKeys_1.default.setRamOnlyKeys(new Set(ramOnlyKeys));
     if (shouldSyncMultipleInstances) {
-        (_a = storage_1.default.keepInstancesSync) === null || _a === void 0 ? void 0 : _a.call(storage_1.default, (key, value) => {
-            // RAM-only keys should never sync from storage as they may have stale persisted data
-            // from before the key was migrated to RAM-only.
-            if (OnyxKeys_1.default.isRamOnlyKey(key)) {
-                return;
+        // Cross-tab sync (InstanceSync) hands us the full batch of key/value pairs that changed together in
+        // a single write. We process it synchronously, grouping collection members so each affected
+        // collection is notified once (mirroring the local mergeCollection batching) instead of
+        // re-delivering the whole collection per member.
+        (_a = storage_1.default.keepInstancesSync) === null || _a === void 0 ? void 0 : _a.call(storage_1.default, (pairs) => {
+            const individual = [];
+            const collectionBatches = new Map();
+            for (const [key, value] of pairs) {
+                // RAM-only keys should never sync from storage as they may have stale persisted data
+                // from before the key was migrated to RAM-only.
+                if (OnyxKeys_1.default.isRamOnlyKey(key)) {
+                    continue;
+                }
+                const collectionKey = OnyxKeys_1.default.getCollectionKey(key);
+                const isCollectionMember = !!collectionKey && OnyxKeys_1.default.isCollectionMemberKey(collectionKey, key);
+                // Capture the previous cached value BEFORE cache.set() so keysChanged() can diff old vs new per member.
+                const previousValue = isCollectionMember ? OnyxCache_1.default.get(key) : undefined;
+                OnyxCache_1.default.set(key, value);
+                if (isCollectionMember && collectionKey) {
+                    let batch = collectionBatches.get(collectionKey);
+                    if (!batch) {
+                        batch = { partial: {}, previous: {} };
+                        collectionBatches.set(collectionKey, batch);
+                    }
+                    batch.partial[key] = value;
+                    // Keep the earliest previous value in case the same member appears twice in one batch.
+                    if (!(key in batch.previous)) {
+                        batch.previous[key] = previousValue;
+                    }
+                }
+                else {
+                    individual.push([key, value]);
+                }
+            }
+            // Non-collection keys: notify individually, matching keyChanged() semantics for exact keys.
+            for (const [key, value] of individual) {
+                OnyxUtils_1.default.keyChanged(key, value);
+            }
+            // One keysChanged() per collection notifies the collection-root subscriber once and lets
+            // keysChanged() decide which individual member subscribers actually changed.
+            for (const [collectionKey, { partial, previous }] of collectionBatches) {
+                OnyxUtils_1.default.keysChanged(collectionKey, partial, previous);
             }
-            OnyxCache_1.default.set(key, value);
-            // Check if this is a collection member key to prevent duplicate callbacks
-            // When a collection is updated, individual members sync separately to other tabs
-            // Setting isProcessingCollectionUpdate=true prevents triggering collection callbacks for each individual update
-            const isKeyCollectionMember = OnyxKeys_1.default.isCollectionMember(key);
-            OnyxUtils_1.default.keyChanged(key, value, undefined, isKeyCollectionMember);
         });
     }
     OnyxUtils_1.default.initStoreValues(keys, initialKeyStates, evictableKeys);

package/dist/OnyxUtils.d.ts

@@ -12,6 +12,8 @@ declare const METHOD: {
     readonly MULTI_SET: "multiset";
     readonly CLEAR: "clear";
 };
+/** Test-only: clears the disk-pressure log throttle so each test observes its own alert. */
+declare function resetDiskPressureLogThrottle(): void;
 type OnyxMethod = ValueOf<typeof METHOD>;
 declare function getSnapshotKey(): OnyxKey | null;
 /**
@@ -143,6 +145,9 @@ declare function reportStorageQuota(error?: Error): Promise<void>;
  * - CAPACITY: evicts the least recently accessed evictable key and retries, under a session-level
  *   circuit breaker (see lib/StorageCircuitBreaker.ts) that halts the loop once eviction stops making
  *   progress or failures storm — the per-operation budget alone cannot stop a session-wide storm.
+ * - DISK_PRESSURE: the device disk itself is full (or the database files are unreadable), so neither
+ *   retries nor in-DB eviction can free space — the write is dropped (cache stays authoritative) with
+ *   a single throttled alert + quota snapshot per burst.
  * - UNKNOWN: the provider couldn't classify it — log the full error shape (name + message +
  *   provider) once so it's visible, then bounded retry without eviction.
  */
@@ -291,6 +296,7 @@ declare const OnyxUtils: {
     getCollectionDataAndSendAsObject: typeof getCollectionDataAndSendAsObject;
     remove: typeof remove;
     reportStorageQuota: typeof reportStorageQuota;
+    resetDiskPressureLogThrottle: typeof resetDiskPressureLogThrottle;
     retryOperation: typeof retryOperation;
     broadcastUpdate: typeof broadcastUpdate;
     hasPendingMergeForKey: typeof hasPendingMergeForKey;

package/dist/OnyxUtils.js

@@ -60,6 +60,14 @@ const METHOD = {
 };
 // Max number of retries for failed storage operations
 const MAX_STORAGE_OPERATION_RETRY_ATTEMPTS = 5;
+/** Minimum interval between disk-pressure alerts. One disk-pressure burst fails every queued operation
+ * with the identical error, so per-operation logging would amplify the very storm it reports. */
+const DISK_PRESSURE_LOG_INTERVAL_MS = 60000;
+let lastDiskPressureLogTime = 0;
+/** Test-only: clears the disk-pressure log throttle so each test observes its own alert. */
+function resetDiskPressureLogThrottle() {
+    lastDiskPressureLogTime = 0;
+}
 // Key/value store of Onyx key and arrays of values to merge
 let mergeQueue = {};
 let mergeQueuePromise = {};
@@ -659,6 +667,9 @@ function reportStorageQuota(error) {
  * - CAPACITY: evicts the least recently accessed evictable key and retries, under a session-level
  *   circuit breaker (see lib/StorageCircuitBreaker.ts) that halts the loop once eviction stops making
  *   progress or failures storm — the per-operation budget alone cannot stop a session-wide storm.
+ * - DISK_PRESSURE: the device disk itself is full (or the database files are unreadable), so neither
+ *   retries nor in-DB eviction can free space — the write is dropped (cache stays authoritative) with
+ *   a single throttled alert + quota snapshot per burst.
  * - UNKNOWN: the provider couldn't classify it — log the full error shape (name + message +
  *   provider) once so it's visible, then bounded retry without eviction.
  */
@@ -674,6 +685,18 @@ function retryOperation(error, onyxMethod, defaultParams, retryAttempt, inFlight
         StorageCircuitBreaker_1.default.recordProbeFailure();
         return Promise.resolve();
     }
+    // DISK_PRESSURE: the device disk is full, so neither retries nor eviction can succeed until the OS
+    // frees space. Drop the write (cache stays authoritative) and log one alert + quota snapshot per
+    // interval — the snapshot's free-disk bytes let telemetry confirm (or rule out) disk pressure.
+    if (errorClass === errors_1.StorageErrorClass.DISK_PRESSURE) {
+        const now = Date.now();
+        if (now - lastDiskPressureLogTime < DISK_PRESSURE_LOG_INTERVAL_MS) {
+            return Promise.resolve();
+        }
+        lastDiskPressureLogTime = now;
+        Logger.logAlert(`Disk-pressure storage error; skipping retries. provider: ${storage_1.default.getStorageProvider().name}. message: ${error === null || error === void 0 ? void 0 : error.message}. onyxMethod: ${onyxMethod.name}.`);
+        return reportStorageQuota(error);
+    }
     Logger.logInfo(`Failed to save to storage. Error: ${error}. class: ${errorClass}. onyxMethod: ${onyxMethod.name}. retryAttempt: ${currentRetryAttempt}/${MAX_STORAGE_OPERATION_RETRY_ATTEMPTS}`);
     if (errorClass === errors_1.StorageErrorClass.INVALID_DATA) {
         Logger.logAlert(`Attempted to set invalid data set in Onyx. Please ensure all data is serializable. Error: ${error}`);
@@ -1510,6 +1533,7 @@ const OnyxUtils = {
     getCollectionDataAndSendAsObject,
     remove,
     reportStorageQuota,
+    resetDiskPressureLogThrottle,
     retryOperation,
     broadcastUpdate,
     hasPendingMergeForKey,

package/dist/storage/InstanceSync/index.web.d.ts

@@ -1,23 +1,29 @@
-/**
- * The InstancesSync object provides data-changed events like the ones that exist
- * when using LocalStorage APIs in the browser. These events are great because multiple tabs can listen for when
- * data changes and then stay up-to-date with everything happening in Onyx.
- */
 import type { OnyxKey } from '../../types';
-import type { StorageKeyList, OnStorageKeyChanged } from '../providers/types';
+import type { StorageKeyList, OnStorageKeysChanged } from '../providers/types';
 import type StorageProvider from '../providers/types';
 /**
- * Raise an event through `localStorage` to let other tabs know a value changed
- * @param {String} onyxKey
+ * Raise cross-tab event(s) for a batch of changed keys. Sending keys together (instead of one event per
+ * key) preserves the write's batch boundary across tabs, so the receiving tab notifies collection
+ * subscribers once for the whole batch — matching the local mergeCollection behavior — instead of
+ * re-delivering the whole collection once per member (O(N^2), which can crash the tab). Large batches are
+ * chunked so no single payload approaches the localStorage quota.
  */
-declare function raiseStorageSyncEvent(onyxKey: OnyxKey): void;
 declare function raiseStorageSyncManyKeysEvent(onyxKeys: StorageKeyList): void;
+/**
+ * Raise an event through `localStorage` to let other tabs know a single key changed.
+ *
+ * This intentionally emits the raw key (the legacy, pre-batching format) rather than a JSON array, so a
+ * tab still running the previous bundle during a deploy keeps receiving single-key updates (a new message,
+ * a pin, a rename, etc.). Only multi-key writes use the batched JSON-array format; the receiver here
+ * understands both. The mixed-version gap is therefore limited to bulk collection writes, which resolve on reload.
+ */
+declare function raiseStorageSyncEvent(onyxKey: OnyxKey): void;
 declare const InstanceSync: {
     shouldBeUsed: boolean;
     /**
-     * @param {Function} onStorageKeyChanged Storage synchronization mechanism keeping all opened tabs in sync
+     * @param {Function} onStorageKeysChanged Storage synchronization mechanism keeping all opened tabs in sync
      */
-    init: (onStorageKeyChanged: OnStorageKeyChanged, store: StorageProvider<unknown>) => void;
+    init: (onStorageKeysChanged: OnStorageKeysChanged, store: StorageProvider<unknown>) => void;
     setItem: typeof raiseStorageSyncEvent;
     removeItem: typeof raiseStorageSyncEvent;
     removeItems: typeof raiseStorageSyncManyKeysEvent;

package/dist/storage/InstanceSync/index.web.js

@@ -1,30 +1,130 @@
 "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;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * The InstancesSync object provides data-changed events like the ones that exist
+ * when using LocalStorage APIs in the browser. These events are great because multiple tabs can listen for when
+ * data changes and then stay up-to-date with everything happening in Onyx.
+ */
+const Logger = __importStar(require("../../Logger"));
 const NoopProvider_1 = __importDefault(require("../providers/NoopProvider"));
 const SYNC_ONYX = 'SYNC_ONYX';
+// localStorage stores values as UTF-16 (~2 bytes/char). The per-origin quota isn't fixed by the spec —
+// it's user-agent dependent and commonly ~5MB — so we keep each SYNC_ONYX payload conservatively small
+// (and pair it with a try/catch in emitSyncEvent). This way a large key batch (e.g. Onyx.clear() on a
+// heavy account, or a bulk import) is split across several events instead of throwing QuotaExceededError.
+// See https://developer.mozilla.org/en-US/docs/Web/API/Web_Storage_API/Using_the_Web_Storage_API
+const MAX_SYNC_PAYLOAD_LENGTH = 1000000;
 /**
- * Raise an event through `localStorage` to let other tabs know a value changed
- * @param {String} onyxKey
+ * Parses the SYNC_ONYX storage event value.
+ * The payload is a JSON array of the changed keys (a batch). It falls back to treating the raw
+ * value as a single key for backwards compatibility with the previous one-key-per-event format.
  */
-function raiseStorageSyncEvent(onyxKey) {
-    global.localStorage.setItem(SYNC_ONYX, onyxKey);
-    global.localStorage.removeItem(SYNC_ONYX);
+function parseSyncOnyxStorageEventValue(value) {
+    let onyxKeys;
+    try {
+        const parsed = JSON.parse(value);
+        onyxKeys = Array.isArray(parsed) ? parsed : [value];
+    }
+    catch (_a) {
+        onyxKeys = [value];
+    }
+    return onyxKeys;
 }
+/**
+ * Emit a single SYNC_ONYX storage event. Wrapped so a failed cross-tab signal
+ * degrades gracefully — other tabs simply miss this update until their next organic sync/reload — instead
+ * of throwing an uncaught rejection in the writing tab.
+ */
+function emitSyncEvent(value) {
+    try {
+        global.localStorage.setItem(SYNC_ONYX, value);
+        global.localStorage.removeItem(SYNC_ONYX);
+    }
+    catch (error) {
+        Logger.logAlert(`[InstanceSync] Failed to raise storage sync event: ${error}`);
+    }
+}
+/**
+ * Raise cross-tab event(s) for a batch of changed keys. Sending keys together (instead of one event per
+ * key) preserves the write's batch boundary across tabs, so the receiving tab notifies collection
+ * subscribers once for the whole batch — matching the local mergeCollection behavior — instead of
+ * re-delivering the whole collection once per member (O(N^2), which can crash the tab). Large batches are
+ * chunked so no single payload approaches the localStorage quota.
+ */
 function raiseStorageSyncManyKeysEvent(onyxKeys) {
+    if (onyxKeys.length === 0) {
+        return;
+    }
+    let chunk = [];
+    let chunkLength = 2; // accounts for the surrounding `[]`
     for (const onyxKey of onyxKeys) {
-        raiseStorageSyncEvent(onyxKey);
+        const keyLength = onyxKey.length + 3; // quotes + comma separator
+        if (chunk.length > 0 && chunkLength + keyLength > MAX_SYNC_PAYLOAD_LENGTH) {
+            emitSyncEvent(JSON.stringify(chunk));
+            chunk = [];
+            chunkLength = 2;
+        }
+        chunk.push(onyxKey);
+        chunkLength += keyLength;
+    }
+    if (chunk.length > 0) {
+        emitSyncEvent(JSON.stringify(chunk));
     }
 }
+/**
+ * Raise an event through `localStorage` to let other tabs know a single key changed.
+ *
+ * This intentionally emits the raw key (the legacy, pre-batching format) rather than a JSON array, so a
+ * tab still running the previous bundle during a deploy keeps receiving single-key updates (a new message,
+ * a pin, a rename, etc.). Only multi-key writes use the batched JSON-array format; the receiver here
+ * understands both. The mixed-version gap is therefore limited to bulk collection writes, which resolve on reload.
+ */
+function raiseStorageSyncEvent(onyxKey) {
+    emitSyncEvent(onyxKey);
+}
 let storage = NoopProvider_1.default;
 const InstanceSync = {
     shouldBeUsed: true,
     /**
-     * @param {Function} onStorageKeyChanged Storage synchronization mechanism keeping all opened tabs in sync
+     * @param {Function} onStorageKeysChanged Storage synchronization mechanism keeping all opened tabs in sync
      */
-    init: (onStorageKeyChanged, store) => {
+    init: (onStorageKeysChanged, store) => {
         storage = store;
         // This listener will only be triggered by events coming from other tabs
         global.addEventListener('storage', (event) => {
@@ -32,8 +132,8 @@ const InstanceSync = {
             if (event.key !== SYNC_ONYX || !event.newValue) {
                 return;
             }
-            const onyxKey = event.newValue;
-            storage.getItem(onyxKey).then((value) => onStorageKeyChanged(onyxKey, value));
+            const onyxKeys = parseSyncOnyxStorageEventValue(event.newValue);
+            storage.multiGet(onyxKeys).then((pairs) => onStorageKeysChanged(pairs));
         });
     },
     setItem: raiseStorageSyncEvent,

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

@@ -3,6 +3,7 @@ declare const StorageMock: {
     classifyError: jest.Mock<import("type-fest").ValueOf<{
         readonly TRANSIENT: "transient";
         readonly CAPACITY: "capacity";
+        readonly DISK_PRESSURE: "diskPressure";
         readonly INVALID_DATA: "invalidData";
         readonly FATAL: "fatal";
         readonly UNKNOWN: "unknown";

package/dist/storage/errors.d.ts

@@ -15,6 +15,10 @@ declare const StorageErrorClass: {
     readonly TRANSIENT: "transient";
     /** Quota exceeded / disk full. Owner: operation layer — evict and retry. */
     readonly CAPACITY: "capacity";
+    /** Filesystem-level failure around the database files (device disk full, or the files cannot be
+     *  created/read). Owner: operation layer — skip retries and eviction (neither can free OS-level
+     *  space) and log one throttled alert + quota snapshot per burst. */
+    readonly DISK_PRESSURE: "diskPressure";
     /** Non-serializable payload. Never retriable — the same data will always fail. */
     readonly INVALID_DATA: "invalidData";
     /** Backing-store corruption. Owner: connection layer — budgeted heal, then give up. */

package/dist/storage/errors.js

@@ -19,6 +19,10 @@ const StorageErrorClass = {
     TRANSIENT: 'transient',
     /** Quota exceeded / disk full. Owner: operation layer — evict and retry. */
     CAPACITY: 'capacity',
+    /** Filesystem-level failure around the database files (device disk full, or the files cannot be
+     *  created/read). Owner: operation layer — skip retries and eviction (neither can free OS-level
+     *  space) and log one throttled alert + quota snapshot per burst. */
+    DISK_PRESSURE: 'diskPressure',
     /** Non-serializable payload. Never retriable — the same data will always fail. */
     INVALID_DATA: 'invalidData',
     /** Backing-store corruption. Owner: connection layer — budgeted heal, then give up. */

package/dist/storage/index.js

@@ -181,14 +181,14 @@ const storage = {
      */
     getDatabaseSize: () => tryOrDegradePerformance(() => provider.getDatabaseSize()),
     /**
-     * @param onStorageKeyChanged - Storage synchronization mechanism keeping all opened tabs in sync (web only)
+     * @param onStorageKeysChanged - Storage synchronization mechanism keeping all opened tabs in sync (web only)
      */
-    keepInstancesSync(onStorageKeyChanged) {
+    keepInstancesSync(onStorageKeysChanged) {
         // If InstanceSync shouldn't be used, it means we're on a native platform and we don't need to keep instances in sync
         if (!InstanceSync_1.default.shouldBeUsed)
             return;
         shouldKeepInstancesSync = true;
-        InstanceSync_1.default.init(onStorageKeyChanged, this);
+        InstanceSync_1.default.init(onStorageKeysChanged, this);
     },
 };
 exports.default = storage;

package/dist/storage/providers/SQLiteProvider.js

@@ -244,15 +244,20 @@ const provider = {
         if (!provider.store) {
             throw new Error('Store is not initialized!');
         }
-        return Promise.all([provider.store.executeAsync('PRAGMA page_size;'), provider.store.executeAsync('PRAGMA page_count;'), (0, react_native_device_info_1.getFreeDiskStorage)()]).then(([pageSizeResult, pageCountResult, bytesRemaining]) => {
+        // The PRAGMAs need the SQLite connection; getFreeDiskStorage() is filesystem-level. Degrade
+        // bytesUsed to -1 instead of failing, so the free-disk bytes always get logged.
+        const bytesUsedPromise = Promise.all([provider.store.executeAsync('PRAGMA page_size;'), provider.store.executeAsync('PRAGMA page_count;')])
+            .then(([pageSizeResult, pageCountResult]) => {
             var _a, _b, _c, _d, _e, _f;
             const pageSize = (_c = (_b = (_a = pageSizeResult.rows) === null || _a === void 0 ? void 0 : _a.item(0)) === null || _b === void 0 ? void 0 : _b.page_size) !== null && _c !== void 0 ? _c : 0;
             const pageCount = (_f = (_e = (_d = pageCountResult.rows) === null || _d === void 0 ? void 0 : _d.item(0)) === null || _e === void 0 ? void 0 : _e.page_count) !== null && _f !== void 0 ? _f : 0;
-            return {
-                bytesUsed: pageSize * pageCount,
-                bytesRemaining,
-            };
-        });
+            return pageSize * pageCount;
+        })
+            .catch(() => -1);
+        return Promise.all([bytesUsedPromise, (0, react_native_device_info_1.getFreeDiskStorage)()]).then(([bytesUsed, bytesRemaining]) => ({
+            bytesUsed,
+            bytesRemaining,
+        }));
     },
 };
 exports.default = provider;

package/dist/storage/providers/classifySQLiteError.js

@@ -16,6 +16,9 @@ function classifySQLiteError(error) {
     if (message.includes('database or disk is full')) {
         return errors_1.StorageErrorClass.CAPACITY;
     }
+    if (message.includes('disk i/o error') || message.includes('unable to open database file')) {
+        return errors_1.StorageErrorClass.DISK_PRESSURE;
+    }
     return errors_1.StorageErrorClass.UNKNOWN;
 }
 exports.default = classifySQLiteError;

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

@@ -9,7 +9,8 @@ type DatabaseSize = {
     bytesRemaining: number;
     usageDetails?: Record<string, number>;
 };
-type OnStorageKeyChanged = <TKey extends OnyxKey>(key: TKey, value: OnyxValue<TKey>) => void;
+/** Called with the full batch of key/value pairs that changed together in a single cross-tab sync event. */
+type OnStorageKeysChanged = (pairs: StorageKeyValuePair[]) => void;
 type StorageProvider<TStore> = {
     store: TStore;
     /**
@@ -77,9 +78,9 @@ type StorageProvider<TStore> = {
      */
     classifyError: (error: unknown) => ValueOf<typeof StorageErrorClass>;
     /**
-     * @param onStorageKeyChanged Storage synchronization mechanism keeping all opened tabs in sync
+     * @param onStorageKeysChanged Storage synchronization mechanism keeping all opened tabs in sync
      */
-    keepInstancesSync?: (onStorageKeyChanged: OnStorageKeyChanged) => void;
+    keepInstancesSync?: (onStorageKeysChanged: OnStorageKeysChanged) => void;
 };
 export default StorageProvider;
-export type { StorageKeyList, StorageKeyValuePair, OnStorageKeyChanged };
+export type { StorageKeyList, StorageKeyValuePair, OnStorageKeysChanged };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-onyx",
-  "version": "3.0.95",
+  "version": "3.0.97",
   "author": "Expensify, Inc.",
   "homepage": "https://expensify.com",
   "description": "State management for React Native",