@fto-consult/expo-ui 6.37.3 → 6.37.4

package/node_modules/@react-native-async-storage/async-storage/ios/RNCAsyncStorage.m

@@ -0,0 +1,898 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#import "RNCAsyncStorage.h"
+
+#import <CommonCrypto/CommonCryptor.h>
+#import <CommonCrypto/CommonDigest.h>
+
+#import <React/RCTConvert.h>
+#import <React/RCTLog.h>
+#import <React/RCTUtils.h>
+
+static NSString *const RCTStorageDirectory = @"RCTAsyncLocalStorage_V1";
+static NSString *const RCTOldStorageDirectory = @"RNCAsyncLocalStorage_V1";
+static NSString *const RCTExpoStorageDirectory = @"RCTAsyncLocalStorage";
+static NSString *const RCTManifestFileName = @"manifest.json";
+static const NSUInteger RCTInlineValueThreshold = 1024;
+
+#pragma mark - Static helper functions
+
+static NSDictionary *RCTErrorForKey(NSString *key)
+{
+    if (![key isKindOfClass:[NSString class]]) {
+        return RCTMakeAndLogError(@"Invalid key - must be a string.  Key: ", key, @{@"key": key});
+    } else if (key.length < 1) {
+        return RCTMakeAndLogError(
+            @"Invalid key - must be at least one character.  Key: ", key, @{@"key": key});
+    } else {
+        return nil;
+    }
+}
+
+static BOOL RCTAsyncStorageSetExcludedFromBackup(NSString *path, NSNumber *isExcluded)
+{
+    NSFileManager *fileManager = [[NSFileManager alloc] init];
+
+    BOOL isDir;
+    BOOL exists = [fileManager fileExistsAtPath:path isDirectory:&isDir];
+    BOOL success = false;
+
+    if (isDir && exists) {
+        NSURL *pathUrl = [NSURL fileURLWithPath:path];
+        NSError *error = nil;
+        success = [pathUrl setResourceValue:isExcluded
+                                     forKey:NSURLIsExcludedFromBackupKey
+                                      error:&error];
+
+        if (!success) {
+            NSLog(@"Could not exclude AsyncStorage dir from backup %@", error);
+        }
+    }
+    return success;
+}
+
+static void RCTAppendError(NSDictionary *error, NSMutableArray<NSDictionary *> **errors)
+{
+    if (error && errors) {
+        if (!*errors) {
+            *errors = [NSMutableArray new];
+        }
+        [*errors addObject:error];
+    }
+}
+
+static NSArray<NSDictionary *> *RCTMakeErrors(NSArray<id<NSObject>> *results)
+{
+    NSMutableArray<NSDictionary *> *errors;
+    for (id object in results) {
+        if ([object isKindOfClass:[NSError class]]) {
+            NSError *error = (NSError *)object;
+            NSDictionary *keyError = RCTMakeError(error.localizedDescription, error, nil);
+            RCTAppendError(keyError, &errors);
+        }
+    }
+    return errors;
+}
+
+static NSString *RCTReadFile(NSString *filePath, NSString *key, NSDictionary **errorOut)
+{
+    if ([[NSFileManager defaultManager] fileExistsAtPath:filePath]) {
+        NSError *error;
+        NSStringEncoding encoding;
+        NSString *entryString = [NSString stringWithContentsOfFile:filePath
+                                                      usedEncoding:&encoding
+                                                             error:&error];
+        NSDictionary *extraData = @{@"key": RCTNullIfNil(key)};
+
+        if (error) {
+            if (errorOut) {
+                *errorOut = RCTMakeError(@"Failed to read storage file.", error, extraData);
+            }
+            return nil;
+        }
+
+        if (encoding != NSUTF8StringEncoding) {
+            if (errorOut) {
+                *errorOut =
+                    RCTMakeError(@"Incorrect encoding of storage file: ", @(encoding), extraData);
+            }
+            return nil;
+        }
+        return entryString;
+    }
+
+    return nil;
+}
+
+// DO NOT USE
+// This is used internally to migrate data from the old file location to the new one.
+// Please use `RCTCreateStorageDirectoryPath` instead
+static NSString *RCTCreateStorageDirectoryPath_deprecated(NSString *storageDir)
+{
+    NSString *storageDirectoryPath;
+#if TARGET_OS_TV
+    storageDirectoryPath =
+        NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES).firstObject;
+#else
+    storageDirectoryPath =
+        NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject;
+#endif
+    storageDirectoryPath = [storageDirectoryPath stringByAppendingPathComponent:storageDir];
+    return storageDirectoryPath;
+}
+
+static NSString *RCTCreateStorageDirectoryPath(NSString *storageDir)
+{
+    NSString *storageDirectoryPath = @"";
+
+#if TARGET_OS_TV
+    storageDirectoryPath =
+        NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES).firstObject;
+#else
+    storageDirectoryPath =
+        NSSearchPathForDirectoriesInDomains(NSApplicationSupportDirectory, NSUserDomainMask, YES)
+            .firstObject;
+    // We should use the "Application Support/[bundleID]" folder for persistent data storage that's
+    // hidden from users
+    storageDirectoryPath = [storageDirectoryPath
+        stringByAppendingPathComponent:[[NSBundle mainBundle] bundleIdentifier]];
+#endif
+
+    // Per Apple's docs, all app content in Application Support must be within a subdirectory of the
+    // app's bundle identifier
+    storageDirectoryPath = [storageDirectoryPath stringByAppendingPathComponent:storageDir];
+
+    return storageDirectoryPath;
+}
+
+static NSString *RCTGetStorageDirectory()
+{
+    static NSString *storageDirectory = nil;
+    static dispatch_once_t onceToken;
+    dispatch_once(&onceToken, ^{
+      storageDirectory = RCTCreateStorageDirectoryPath(RCTStorageDirectory);
+    });
+    return storageDirectory;
+}
+
+static NSString *RCTCreateManifestFilePath(NSString *storageDirectory)
+{
+    return [storageDirectory stringByAppendingPathComponent:RCTManifestFileName];
+}
+
+static NSString *RCTGetManifestFilePath()
+{
+    static NSString *manifestFilePath = nil;
+    static dispatch_once_t onceToken;
+    dispatch_once(&onceToken, ^{
+      manifestFilePath = RCTCreateManifestFilePath(RCTStorageDirectory);
+    });
+    return manifestFilePath;
+}
+
+// Only merges objects - all other types are just clobbered (including arrays)
+static BOOL RCTMergeRecursive(NSMutableDictionary *destination, NSDictionary *source)
+{
+    BOOL modified = NO;
+    for (NSString *key in source) {
+        id sourceValue = source[key];
+        id destinationValue = destination[key];
+        if ([sourceValue isKindOfClass:[NSDictionary class]]) {
+            if ([destinationValue isKindOfClass:[NSDictionary class]]) {
+                if ([destinationValue classForCoder] != [NSMutableDictionary class]) {
+                    destinationValue = [destinationValue mutableCopy];
+                }
+                if (RCTMergeRecursive(destinationValue, sourceValue)) {
+                    destination[key] = destinationValue;
+                    modified = YES;
+                }
+            } else {
+                destination[key] = [sourceValue copy];
+                modified = YES;
+            }
+        } else if (![source isEqual:destinationValue]) {
+            destination[key] = [sourceValue copy];
+            modified = YES;
+        }
+    }
+    return modified;
+}
+
+static dispatch_queue_t RCTGetMethodQueue()
+{
+    // We want all instances to share the same queue since they will be reading/writing the same
+    // files.
+    static dispatch_queue_t queue;
+    static dispatch_once_t onceToken;
+    dispatch_once(&onceToken, ^{
+      queue =
+          dispatch_queue_create("com.facebook.react.AsyncLocalStorageQueue", DISPATCH_QUEUE_SERIAL);
+    });
+    return queue;
+}
+
+static NSCache *RCTGetCache()
+{
+    // We want all instances to share the same cache since they will be reading/writing the same
+    // files.
+    static NSCache *cache;
+    static dispatch_once_t onceToken;
+    dispatch_once(&onceToken, ^{
+      cache = [NSCache new];
+      cache.totalCostLimit = 2 * 1024 * 1024;  // 2MB
+
+#if !TARGET_OS_OSX
+      // Clear cache in the event of a memory warning
+      [[NSNotificationCenter defaultCenter]
+          addObserverForName:UIApplicationDidReceiveMemoryWarningNotification
+                      object:nil
+                       queue:nil
+                  usingBlock:^(__unused NSNotification *note) {
+                    [cache removeAllObjects];
+                  }];
+#endif  // !TARGET_OS_OSX
+    });
+    return cache;
+}
+
+static BOOL RCTHasCreatedStorageDirectory = NO;
+static NSDictionary *RCTDeleteStorageDirectory()
+{
+    NSError *error;
+    [[NSFileManager defaultManager] removeItemAtPath:RCTGetStorageDirectory() error:&error];
+    RCTHasCreatedStorageDirectory = NO;
+    return error ? RCTMakeError(@"Failed to delete storage directory.", error, nil) : nil;
+}
+
+static NSDate *RCTManifestModificationDate(NSString *manifestFilePath)
+{
+    NSDictionary *attributes =
+        [[NSFileManager defaultManager] attributesOfItemAtPath:manifestFilePath error:nil];
+    return [attributes fileModificationDate];
+}
+
+/**
+ * Creates an NSException used during Storage Directory Migration.
+ */
+static void RCTStorageDirectoryMigrationLogError(NSString *reason, NSError *error)
+{
+    RCTLogWarn(@"%@: %@", reason, error ? error.description : @"");
+}
+
+static void RCTStorageDirectoryCleanupOld(NSString *oldDirectoryPath)
+{
+    NSError *error;
+    if (![[NSFileManager defaultManager] removeItemAtPath:oldDirectoryPath error:&error]) {
+        RCTStorageDirectoryMigrationLogError(
+            @"Failed to remove old storage directory during migration", error);
+    }
+}
+
+static void _createStorageDirectory(NSString *storageDirectory, NSError **error)
+{
+    [[NSFileManager defaultManager] createDirectoryAtPath:storageDirectory
+                              withIntermediateDirectories:YES
+                                               attributes:nil
+                                                    error:error];
+}
+
+static void RCTStorageDirectoryMigrate(NSString *oldDirectoryPath,
+                                       NSString *newDirectoryPath,
+                                       BOOL shouldCleanupOldDirectory)
+{
+    NSError *error;
+    // Migrate data by copying old storage directory to new storage directory location
+    if (![[NSFileManager defaultManager] copyItemAtPath:oldDirectoryPath
+                                                 toPath:newDirectoryPath
+                                                  error:&error]) {
+        // the new storage directory "Application Support/[bundleID]/RCTAsyncLocalStorage_V1" seems
+        // unable to migrate because folder "Application Support/[bundleID]" doesn't exist.. create
+        // this folder and attempt folder copying again
+        if (error != nil && error.code == 4 &&
+            [newDirectoryPath isEqualToString:RCTGetStorageDirectory()]) {
+            NSError *error = nil;
+            _createStorageDirectory(RCTCreateStorageDirectoryPath(@""), &error);
+            if (error == nil) {
+                RCTStorageDirectoryMigrate(
+                    oldDirectoryPath, newDirectoryPath, shouldCleanupOldDirectory);
+            } else {
+                RCTStorageDirectoryMigrationLogError(
+                    @"Failed to create storage directory during migration.", error);
+            }
+        } else {
+            RCTStorageDirectoryMigrationLogError(
+                @"Failed to copy old storage directory to new storage directory location during "
+                @"migration",
+                error);
+        }
+    } else if (shouldCleanupOldDirectory) {
+        // If copying succeeds, remove old storage directory
+        RCTStorageDirectoryCleanupOld(oldDirectoryPath);
+    }
+}
+
+/**
+ * Determine which of RCTOldStorageDirectory or RCTExpoStorageDirectory needs to migrated.
+ * If both exist, we remove the least recently modified and return the most recently modified.
+ * Otherwise, this will return the path to whichever directory exists.
+ * If no directory exists, then return nil.
+ */
+static NSString *RCTGetStoragePathForMigration()
+{
+    BOOL isDir;
+    NSString *oldStoragePath = RCTCreateStorageDirectoryPath_deprecated(RCTOldStorageDirectory);
+    NSString *expoStoragePath = RCTCreateStorageDirectoryPath_deprecated(RCTExpoStorageDirectory);
+    NSFileManager *fileManager = [NSFileManager defaultManager];
+    BOOL oldStorageDirectoryExists =
+        [fileManager fileExistsAtPath:oldStoragePath isDirectory:&isDir] && isDir;
+    BOOL expoStorageDirectoryExists =
+        [fileManager fileExistsAtPath:expoStoragePath isDirectory:&isDir] && isDir;
+
+    // Check if both the old storage directory and Expo storage directory exist
+    if (oldStorageDirectoryExists && expoStorageDirectoryExists) {
+        // If the old storage has been modified more recently than Expo storage, then clear Expo
+        // storage. Otherwise, clear the old storage.
+        if ([RCTManifestModificationDate(RCTCreateManifestFilePath(oldStoragePath))
+                compare:RCTManifestModificationDate(RCTCreateManifestFilePath(expoStoragePath))] ==
+            NSOrderedDescending) {
+            RCTStorageDirectoryCleanupOld(expoStoragePath);
+            return oldStoragePath;
+        } else {
+            RCTStorageDirectoryCleanupOld(oldStoragePath);
+            return expoStoragePath;
+        }
+    } else if (oldStorageDirectoryExists) {
+        return oldStoragePath;
+    } else if (expoStorageDirectoryExists) {
+        return expoStoragePath;
+    } else {
+        return nil;
+    }
+}
+
+/**
+ * This check is added to make sure that anyone coming from pre-1.2.2 does not lose cached data.
+ * Check that data is migrated from the old location to the new location
+ * fromStorageDirectory: the directory where the older data lives
+ * toStorageDirectory: the directory where the new data should live
+ * shouldCleanupOldDirectoryAndOverwriteNewDirectory: YES if we should delete the old directory's
+ * contents and overwrite the new directory's contents during the migration to the new directory
+ */
+static void
+RCTStorageDirectoryMigrationCheck(NSString *fromStorageDirectory,
+                                  NSString *toStorageDirectory,
+                                  BOOL shouldCleanupOldDirectoryAndOverwriteNewDirectory)
+{
+    NSError *error;
+    BOOL isDir;
+    NSFileManager *fileManager = [NSFileManager defaultManager];
+    // If the old directory exists, it means we may need to migrate old data to the new directory
+    if ([fileManager fileExistsAtPath:fromStorageDirectory isDirectory:&isDir] && isDir) {
+        // Check if the new storage directory location already exists
+        if ([fileManager fileExistsAtPath:toStorageDirectory]) {
+            // If new storage location exists, check if the new storage has been modified sooner in
+            // which case we may want to cleanup the old location
+            if ([RCTManifestModificationDate(RCTCreateManifestFilePath(toStorageDirectory))
+                    compare:RCTManifestModificationDate(
+                                RCTCreateManifestFilePath(fromStorageDirectory))] == 1) {
+                // If new location has been modified more recently, simply clean out old data
+                if (shouldCleanupOldDirectoryAndOverwriteNewDirectory) {
+                    RCTStorageDirectoryCleanupOld(fromStorageDirectory);
+                }
+            } else if (shouldCleanupOldDirectoryAndOverwriteNewDirectory) {
+                // If old location has been modified more recently, remove new storage and migrate
+                if (![fileManager removeItemAtPath:toStorageDirectory error:&error]) {
+                    RCTStorageDirectoryMigrationLogError(
+                        @"Failed to remove new storage directory during migration", error);
+                } else {
+                    RCTStorageDirectoryMigrate(fromStorageDirectory,
+                                               toStorageDirectory,
+                                               shouldCleanupOldDirectoryAndOverwriteNewDirectory);
+                }
+            }
+        } else {
+            // If new storage location doesn't exist, migrate data
+            RCTStorageDirectoryMigrate(fromStorageDirectory,
+                                       toStorageDirectory,
+                                       shouldCleanupOldDirectoryAndOverwriteNewDirectory);
+        }
+    }
+}
+
+#pragma mark - RNCAsyncStorage
+
+@implementation RNCAsyncStorage {
+    BOOL _haveSetup;
+    // The manifest is a dictionary of all keys with small values inlined.  Null values indicate
+    // values that are stored in separate files (as opposed to nil values which don't exist).  The
+    // manifest is read off disk at startup, and written to disk after all mutations.
+    NSMutableDictionary<NSString *, NSString *> *_manifest;
+}
+
++ (BOOL)requiresMainQueueSetup
+{
+    return NO;
+}
+
+- (instancetype)init
+{
+    if (!(self = [super init])) {
+        return nil;
+    }
+
+    // Get the path to any old storage directory that needs to be migrated. If multiple exist,
+    // the oldest are removed and the most recently modified is returned.
+    NSString *oldStoragePath = RCTGetStoragePathForMigration();
+    if (oldStoragePath != nil) {
+        // Migrate our deprecated path "Documents/.../RNCAsyncLocalStorage_V1" or
+        // "Documents/.../RCTAsyncLocalStorage" to "Documents/.../RCTAsyncLocalStorage_V1"
+        RCTStorageDirectoryMigrationCheck(
+            oldStoragePath, RCTCreateStorageDirectoryPath_deprecated(RCTStorageDirectory), YES);
+    }
+
+    // Migrate what's in "Documents/.../RCTAsyncLocalStorage_V1" to
+    // "Application Support/[bundleID]/RCTAsyncLocalStorage_V1"
+    RCTStorageDirectoryMigrationCheck(RCTCreateStorageDirectoryPath_deprecated(RCTStorageDirectory),
+                                      RCTCreateStorageDirectoryPath(RCTStorageDirectory),
+                                      NO);
+
+    return self;
+}
+
+RCT_EXPORT_MODULE()
+
+- (dispatch_queue_t)methodQueue
+{
+    return RCTGetMethodQueue();
+}
+
+- (void)clearAllData
+{
+    dispatch_async(RCTGetMethodQueue(), ^{
+      [self->_manifest removeAllObjects];
+      [RCTGetCache() removeAllObjects];
+      RCTDeleteStorageDirectory();
+    });
+}
+
++ (void)clearAllData
+{
+    dispatch_async(RCTGetMethodQueue(), ^{
+      [RCTGetCache() removeAllObjects];
+      RCTDeleteStorageDirectory();
+    });
+}
+
+- (void)invalidate
+{
+    if (_clearOnInvalidate) {
+        [RCTGetCache() removeAllObjects];
+        RCTDeleteStorageDirectory();
+    }
+    _clearOnInvalidate = NO;
+    [_manifest removeAllObjects];
+    _haveSetup = NO;
+}
+
+- (BOOL)isValid
+{
+    return _haveSetup;
+}
+
+- (void)dealloc
+{
+    [self invalidate];
+}
+
+- (NSString *)_filePathForKey:(NSString *)key
+{
+    NSString *safeFileName = RCTMD5Hash(key);
+    return [RCTGetStorageDirectory() stringByAppendingPathComponent:safeFileName];
+}
+
+- (NSDictionary *)_ensureSetup
+{
+    RCTAssertThread(RCTGetMethodQueue(), @"Must be executed on storage thread");
+
+#if TARGET_OS_TV
+    RCTLogWarn(
+        @"Persistent storage is not supported on tvOS, your data may be removed at any point.");
+#endif
+
+    NSError *error = nil;
+    if (!RCTHasCreatedStorageDirectory) {
+        _createStorageDirectory(RCTGetStorageDirectory(), &error);
+        if (error) {
+            return RCTMakeError(@"Failed to create storage directory.", error, nil);
+        }
+        RCTHasCreatedStorageDirectory = YES;
+    }
+
+    if (!_haveSetup) {
+        // iCloud backup exclusion
+        NSNumber *isExcludedFromBackup =
+            [[NSBundle mainBundle] objectForInfoDictionaryKey:@"RCTAsyncStorageExcludeFromBackup"];
+        if (isExcludedFromBackup == nil) {
+            // by default, we want to exclude AsyncStorage data from backup
+            isExcludedFromBackup = @YES;
+        }
+        RCTAsyncStorageSetExcludedFromBackup(RCTCreateStorageDirectoryPath(RCTStorageDirectory),
+                                             isExcludedFromBackup);
+
+        NSDictionary *errorOut = nil;
+        NSString *serialized = RCTReadFile(RCTCreateStorageDirectoryPath(RCTGetManifestFilePath()),
+                                           RCTManifestFileName,
+                                           &errorOut);
+        if (!serialized) {
+            if (errorOut) {
+                // We cannot simply create a new manifest in case the file does exist but we have no
+                // access to it. This can happen when data protection is enabled for the app and we
+                // are trying to read the manifest while the device is locked. (The app can be
+                // started by the system even if the device is locked due to e.g. a geofence event.)
+                RCTLogError(
+                    @"Could not open the existing manifest, perhaps data protection is "
+                    @"enabled?\n\n%@",
+                    errorOut);
+                return errorOut;
+            } else {
+                // We can get nil without errors only when the file does not exist.
+                RCTLogTrace(@"Manifest does not exist - creating a new one.\n\n%@", errorOut);
+                _manifest = [NSMutableDictionary new];
+            }
+        } else {
+            _manifest = RCTJSONParseMutable(serialized, &error);
+            if (!_manifest) {
+                RCTLogError(@"Failed to parse manifest - creating a new one.\n\n%@", error);
+                _manifest = [NSMutableDictionary new];
+            }
+        }
+        _haveSetup = YES;
+    }
+
+    return nil;
+}
+
+- (NSDictionary *)_writeManifest:(NSMutableArray<NSDictionary *> **)errors
+{
+    NSError *error;
+    NSString *serialized = RCTJSONStringify(_manifest, &error);
+    [serialized writeToFile:RCTCreateStorageDirectoryPath(RCTGetManifestFilePath())
+                 atomically:YES
+                   encoding:NSUTF8StringEncoding
+                      error:&error];
+    NSDictionary *errorOut;
+    if (error) {
+        errorOut = RCTMakeError(@"Failed to write manifest file.", error, nil);
+        RCTAppendError(errorOut, errors);
+    }
+    return errorOut;
+}
+
+- (NSDictionary *)_appendItemForKey:(NSString *)key
+                            toArray:(NSMutableArray<NSArray<NSString *> *> *)result
+{
+    NSDictionary *errorOut = RCTErrorForKey(key);
+    if (errorOut) {
+        return errorOut;
+    }
+    NSString *value = [self _getValueForKey:key errorOut:&errorOut];
+    [result addObject:@[key, RCTNullIfNil(value)]];  // Insert null if missing or failure.
+    return errorOut;
+}
+
+- (NSString *)_getValueForKey:(NSString *)key errorOut:(NSDictionary **)errorOut
+{
+    NSString *value =
+        _manifest[key];  // nil means missing, null means there may be a data file, else: NSString
+    if (value == (id)kCFNull) {
+        value = [RCTGetCache() objectForKey:key];
+        if (!value) {
+            NSString *filePath = [self _filePathForKey:key];
+            value = RCTReadFile(filePath, key, errorOut);
+            if (value) {
+                [RCTGetCache() setObject:value forKey:key cost:value.length];
+            } else {
+                // file does not exist after all, so remove from manifest (no need to save
+                // manifest immediately though, as cost of checking again next time is negligible)
+                [_manifest removeObjectForKey:key];
+            }
+        }
+    }
+    return value;
+}
+
+- (NSDictionary *)_writeEntry:(NSArray<NSString *> *)entry changedManifest:(BOOL *)changedManifest
+{
+    if (entry.count != 2) {
+        return RCTMakeAndLogError(
+            @"Entries must be arrays of the form [key: string, value: string], got: ", entry, nil);
+    }
+    NSString *key = entry[0];
+    NSDictionary *errorOut = RCTErrorForKey(key);
+    if (errorOut) {
+        return errorOut;
+    }
+    NSString *value = entry[1];
+    NSString *filePath = [self _filePathForKey:key];
+    NSError *error;
+    if (value.length <= RCTInlineValueThreshold) {
+        if (_manifest[key] == (id)kCFNull) {
+            // If the value already existed but wasn't inlined, remove the old file.
+            [[NSFileManager defaultManager] removeItemAtPath:filePath error:nil];
+            [RCTGetCache() removeObjectForKey:key];
+        }
+        *changedManifest = YES;
+        _manifest[key] = value;
+        return nil;
+    }
+    [value writeToFile:filePath atomically:YES encoding:NSUTF8StringEncoding error:&error];
+    [RCTGetCache() setObject:value forKey:key cost:value.length];
+    if (error) {
+        errorOut = RCTMakeError(@"Failed to write value.", error, @{@"key": key});
+    } else if (_manifest[key] != (id)kCFNull) {
+        *changedManifest = YES;
+        _manifest[key] = (id)kCFNull;
+    }
+    return errorOut;
+}
+
+- (void)_multiGet:(NSArray<NSString *> *)keys
+         callback:(RCTResponseSenderBlock)callback
+           getter:(NSString * (^)(NSUInteger i, NSString *key, NSDictionary **errorOut))getValue
+{
+    NSMutableArray<NSDictionary *> *errors;
+    NSMutableArray<NSArray<NSString *> *> *result = [NSMutableArray arrayWithCapacity:keys.count];
+    for (NSUInteger i = 0; i < keys.count; ++i) {
+        NSString *key = keys[i];
+        id keyError;
+        id value = getValue(i, key, &keyError);
+        [result addObject:@[key, RCTNullIfNil(value)]];
+        RCTAppendError(keyError, &errors);
+    }
+    callback(@[RCTNullIfNil(errors), result]);
+}
+
+- (BOOL)_passthroughDelegate
+{
+    return
+        [self.delegate respondsToSelector:@selector(isPassthrough)] && self.delegate.isPassthrough;
+}
+
+#pragma mark - Exported JS Functions
+
+// clang-format off
+RCT_EXPORT_METHOD(multiGet:(NSArray<NSString *> *)keys
+                  callback:(RCTResponseSenderBlock)callback)
+// clang-format on
+{
+    if (self.delegate != nil) {
+        [self.delegate
+            valuesForKeys:keys
+               completion:^(NSArray<id<NSObject>> *valuesOrErrors) {
+                 [self _multiGet:keys
+                        callback:callback
+                          getter:^NSString *(NSUInteger i, NSString *key, NSDictionary **errorOut) {
+                            id valueOrError = valuesOrErrors[i];
+                            if ([valueOrError isKindOfClass:[NSError class]]) {
+                                NSError *error = (NSError *)valueOrError;
+                                NSDictionary *extraData = @{@"key": RCTNullIfNil(key)};
+                                *errorOut =
+                                    RCTMakeError(error.localizedDescription, error, extraData);
+                                return nil;
+                            } else {
+                                return [valueOrError isKindOfClass:[NSString class]]
+                                           ? (NSString *)valueOrError
+                                           : nil;
+                            }
+                          }];
+               }];
+
+        if (![self _passthroughDelegate]) {
+            return;
+        }
+    }
+
+    NSDictionary *errorOut = [self _ensureSetup];
+    if (errorOut) {
+        callback(@[@[errorOut], (id)kCFNull]);
+        return;
+    }
+    [self _multiGet:keys
+           callback:callback
+             getter:^(NSUInteger i, NSString *key, NSDictionary **errorOut) {
+               return [self _getValueForKey:key errorOut:errorOut];
+             }];
+}
+
+// clang-format off
+RCT_EXPORT_METHOD(multiSet:(NSArray<NSArray<NSString *> *> *)kvPairs
+                  callback:(RCTResponseSenderBlock)callback)
+// clang-format on
+{
+    if (self.delegate != nil) {
+        NSMutableArray<NSString *> *keys = [NSMutableArray arrayWithCapacity:kvPairs.count];
+        NSMutableArray<NSString *> *values = [NSMutableArray arrayWithCapacity:kvPairs.count];
+        for (NSArray<NSString *> *entry in kvPairs) {
+            [keys addObject:entry[0]];
+            [values addObject:entry[1]];
+        }
+        [self.delegate setValues:values
+                         forKeys:keys
+                      completion:^(NSArray<id<NSObject>> *results) {
+                        NSArray<NSDictionary *> *errors = RCTMakeErrors(results);
+                        callback(@[RCTNullIfNil(errors)]);
+                      }];
+
+        if (![self _passthroughDelegate]) {
+            return;
+        }
+    }
+
+    NSDictionary *errorOut = [self _ensureSetup];
+    if (errorOut) {
+        callback(@[@[errorOut]]);
+        return;
+    }
+    BOOL changedManifest = NO;
+    NSMutableArray<NSDictionary *> *errors;
+    for (NSArray<NSString *> *entry in kvPairs) {
+        NSDictionary *keyError = [self _writeEntry:entry changedManifest:&changedManifest];
+        RCTAppendError(keyError, &errors);
+    }
+    if (changedManifest) {
+        [self _writeManifest:&errors];
+    }
+    callback(@[RCTNullIfNil(errors)]);
+}
+
+// clang-format off
+RCT_EXPORT_METHOD(multiMerge:(NSArray<NSArray<NSString *> *> *)kvPairs
+                    callback:(RCTResponseSenderBlock)callback)
+// clang-format on
+{
+    if (self.delegate != nil) {
+        NSMutableArray<NSString *> *keys = [NSMutableArray arrayWithCapacity:kvPairs.count];
+        NSMutableArray<NSString *> *values = [NSMutableArray arrayWithCapacity:kvPairs.count];
+        for (NSArray<NSString *> *entry in kvPairs) {
+            [keys addObject:entry[0]];
+            [values addObject:entry[1]];
+        }
+        [self.delegate mergeValues:values
+                           forKeys:keys
+                        completion:^(NSArray<id<NSObject>> *results) {
+                          NSArray<NSDictionary *> *errors = RCTMakeErrors(results);
+                          callback(@[RCTNullIfNil(errors)]);
+                        }];
+
+        if (![self _passthroughDelegate]) {
+            return;
+        }
+    }
+
+    NSDictionary *errorOut = [self _ensureSetup];
+    if (errorOut) {
+        callback(@[@[errorOut]]);
+        return;
+    }
+    BOOL changedManifest = NO;
+    NSMutableArray<NSDictionary *> *errors;
+    for (__strong NSArray<NSString *> *entry in kvPairs) {
+        NSDictionary *keyError;
+        NSString *value = [self _getValueForKey:entry[0] errorOut:&keyError];
+        if (!keyError) {
+            if (value) {
+                NSError *jsonError;
+                NSMutableDictionary *mergedVal = RCTJSONParseMutable(value, &jsonError);
+                if (RCTMergeRecursive(mergedVal, RCTJSONParse(entry[1], &jsonError))) {
+                    entry = @[entry[0], RCTNullIfNil(RCTJSONStringify(mergedVal, NULL))];
+                }
+                if (jsonError) {
+                    keyError = RCTJSErrorFromNSError(jsonError);
+                }
+            }
+            if (!keyError) {
+                keyError = [self _writeEntry:entry changedManifest:&changedManifest];
+            }
+        }
+        RCTAppendError(keyError, &errors);
+    }
+    if (changedManifest) {
+        [self _writeManifest:&errors];
+    }
+    callback(@[RCTNullIfNil(errors)]);
+}
+
+// clang-format off
+RCT_EXPORT_METHOD(multiRemove:(NSArray<NSString *> *)keys
+                     callback:(RCTResponseSenderBlock)callback)
+// clang-format on
+{
+    if (self.delegate != nil) {
+        [self.delegate removeValuesForKeys:keys
+                                completion:^(NSArray<id<NSObject>> *results) {
+                                  NSArray<NSDictionary *> *errors = RCTMakeErrors(results);
+                                  callback(@[RCTNullIfNil(errors)]);
+                                }];
+
+        if (![self _passthroughDelegate]) {
+            return;
+        }
+    }
+
+    NSDictionary *errorOut = [self _ensureSetup];
+    if (errorOut) {
+        callback(@[@[errorOut]]);
+        return;
+    }
+    NSMutableArray<NSDictionary *> *errors;
+    BOOL changedManifest = NO;
+    for (NSString *key in keys) {
+        NSDictionary *keyError = RCTErrorForKey(key);
+        if (!keyError) {
+            if (_manifest[key] == (id)kCFNull) {
+                NSString *filePath = [self _filePathForKey:key];
+                [[NSFileManager defaultManager] removeItemAtPath:filePath error:nil];
+                [RCTGetCache() removeObjectForKey:key];
+            }
+            if (_manifest[key]) {
+                changedManifest = YES;
+                [_manifest removeObjectForKey:key];
+            }
+        }
+        RCTAppendError(keyError, &errors);
+    }
+    if (changedManifest) {
+        [self _writeManifest:&errors];
+    }
+    callback(@[RCTNullIfNil(errors)]);
+}
+
+// clang-format off
+RCT_EXPORT_METHOD(clear:(RCTResponseSenderBlock)callback)
+// clang-format on
+{
+    if (self.delegate != nil) {
+        [self.delegate removeAllValues:^(NSError *error) {
+          NSDictionary *result = nil;
+          if (error != nil) {
+              result = RCTMakeError(error.localizedDescription, error, nil);
+          }
+          callback(@[RCTNullIfNil(result)]);
+        }];
+        return;
+    }
+
+    [_manifest removeAllObjects];
+    [RCTGetCache() removeAllObjects];
+    NSDictionary *error = RCTDeleteStorageDirectory();
+    callback(@[RCTNullIfNil(error)]);
+}
+
+// clang-format off
+RCT_EXPORT_METHOD(getAllKeys:(RCTResponseSenderBlock)callback)
+// clang-format on
+{
+    if (self.delegate != nil) {
+        [self.delegate allKeys:^(NSArray<id<NSObject>> *keys) {
+          callback(@[(id)kCFNull, keys]);
+        }];
+
+        if (![self _passthroughDelegate]) {
+            return;
+        }
+    }
+
+    NSDictionary *errorOut = [self _ensureSetup];
+    if (errorOut) {
+        callback(@[errorOut, (id)kCFNull]);
+    } else {
+        callback(@[(id)kCFNull, _manifest.allKeys]);
+    }
+}
+
+@end