@react-native-firebase/app 26.4.0 → 27.0.0

package/ios/RNFBApp/RNFBSharedUtilsFIRApp.swift

@@ -0,0 +1,271 @@
+/**
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#if RNFB_DYNAMIC_FIREBASE_PROBE
+import RNFBFirebase
+#else
+import FirebaseCore
+#endif
+import Foundation
+
+#if RNFB_DYNAMIC_FIREBASE_PROBE
+/**
+ * Foundation snapshot from `RNFBFirebaseAppClient`, shaped as `RNFBFIROptionsProviding`.
+ */
+private final class RNFBOpaqueOptionsProvider: NSObject, RNFBFIROptionsProviding {
+  let apiKey: String?
+  let googleAppID: String?
+  let projectID: String?
+  let databaseURL: String?
+  let storageBucket: String?
+  let gcmSenderID: String?
+  let clientID: String?
+
+  init(_ snapshot: RNFBFirebaseAppSnapshot) {
+    apiKey = snapshot.apiKey
+    googleAppID = snapshot.googleAppID
+    projectID = snapshot.projectID
+    databaseURL = snapshot.databaseURL
+    storageBucket = snapshot.storageBucket
+    gcmSenderID = snapshot.gcmSenderID
+    clientID = snapshot.clientID
+  }
+}
+
+/**
+ * Foundation snapshot from `RNFBFirebaseAppClient`, shaped as `RNFBFIRAppProviding`.
+ */
+private final class RNFBOpaqueAppProvider: NSObject, RNFBFIRAppProviding {
+  let name: String
+  let options: RNFBFIROptionsProviding
+  private let dataCollectionEnabled: Bool
+
+  init(_ snapshot: RNFBFirebaseAppSnapshot) {
+    name = snapshot.name
+    options = RNFBOpaqueOptionsProvider(snapshot)
+    dataCollectionEnabled = snapshot.isDataCollectionDefaultEnabled
+  }
+
+  @objc(isDataCollectionDefaultEnabled)
+  func isDataCollectionDefaultEnabled() -> Bool {
+    dataCollectionEnabled
+  }
+}
+#else
+/**
+ * Adapts live `FirebaseOptions` (`FIROptions`) to `RNFBFIROptionsProviding`.
+ *
+ * Field mapping matches
+ * https://github.com/firebase/firebase-ios-sdk/blob/main/FirebaseCore/Sources/Public/FirebaseCore/FIROptions.h
+ * (`apiKey`, `googleAppID`, `projectID`, `databaseURL`, `storageBucket`, `gcmSenderID`, `clientID`).
+ */
+@objc(RNFBFIROptionsAdapter)
+final class RNFBFIROptionsAdapter: NSObject, RNFBFIROptionsProviding {
+  private let options: FirebaseOptions
+
+  init(options: FirebaseOptions) {
+    self.options = options
+  }
+
+  var apiKey: String? { options.apiKey }
+  var googleAppID: String? { options.googleAppID }
+  var projectID: String? { options.projectID }
+  var databaseURL: String? { options.databaseURL }
+  var storageBucket: String? { options.storageBucket }
+  var gcmSenderID: String? { options.gcmSenderID }
+  var clientID: String? { options.clientID }
+}
+
+/**
+ * Adapts live `FirebaseApp` (`FIRApp`) to `RNFBFIRAppProviding`.
+ *
+ * Uses `name`, `options`, and `isDataCollectionDefaultEnabled` from
+ * https://github.com/firebase/firebase-ios-sdk/blob/main/FirebaseCore/Sources/Public/FirebaseCore/FIRApp.h
+ */
+@objc(RNFBFIRAppAdapter)
+final class RNFBFIRAppAdapter: NSObject, RNFBFIRAppProviding {
+  private let app: FirebaseApp
+  private let optionsAdapter: RNFBFIROptionsAdapter
+
+  init(app: FirebaseApp) {
+    self.app = app
+    optionsAdapter = RNFBFIROptionsAdapter(options: app.options)
+  }
+
+  var name: String { app.name }
+
+  var options: RNFBFIROptionsProviding { optionsAdapter }
+
+  @objc(isDataCollectionDefaultEnabled)
+  func isDataCollectionDefaultEnabled() -> Bool {
+    app.isDataCollectionDefaultEnabled
+  }
+}
+#endif
+
+/**
+ * FIROptions fields needed by `firAppToDictionary`.
+ *
+ * Production adapts live `FIROptions`; unit tests inject doubles.
+ */
+@objc public protocol RNFBFIROptionsProviding: AnyObject {
+  var apiKey: String? { get }
+  var googleAppID: String? { get }
+  var projectID: String? { get }
+  var databaseURL: String? { get }
+  var storageBucket: String? { get }
+  var gcmSenderID: String? { get }
+  var clientID: String? { get }
+}
+
+/**
+ * FIRApp fields needed by SharedUtils FIR helpers.
+ *
+ * Production adapts live `FIRApp`; unit tests inject doubles.
+ */
+@objc public protocol RNFBFIRAppProviding: AnyObject {
+  var name: String { get }
+  var options: RNFBFIROptionsProviding { get }
+
+  @objc(isDataCollectionDefaultEnabled)
+  func isDataCollectionDefaultEnabled() -> Bool
+}
+
+/**
+ * Custom auth-domain lookup previously hard-wired to `RNFBAppModule getCustomDomain:`.
+ */
+@objc public protocol RNFBCustomDomainProviding: AnyObject {
+  @objc(getCustomDomain:)
+  func getCustomDomain(_ appName: String) -> String?
+}
+
+/**
+ * JS event sink previously hard-wired to `RNFBRCTEventEmitter.shared`.
+ */
+@objc public protocol RNFBJSEventSending: AnyObject {
+  @objc(sendEventWithName:body:)
+  func sendEvent(name: String, body: Any?)
+}
+
+/**
+ * FIR app dictionary / JS-event helpers previously inline in `RNFBSharedUtils.m`.
+ *
+ * Mirrors pre-port:
+ * - `__FIRAPP_DEFAULT` → `[DEFAULT]` for `appConfig.name`
+ * - options keys from FIROptions; `authDomain` only when custom-domain provider returns non-nil
+ * - `sendJSEventForApp` mutably copies body, injects `appName` via JS name mapping, forwards to sender
+ */
+@objc(RNFBSharedUtilsFIRApp)
+public final class RNFBSharedUtilsFIRApp: NSObject {
+  /// Matches `DEFAULT_APP_NAME` in `RNFBSharedUtils.m`.
+  private static let defaultAppName = "__FIRAPP_DEFAULT"
+  /// Matches `DEFAULT_APP_DISPLAY_NAME` in `RNFBSharedUtils.m`.
+  private static let defaultAppDisplayName = "[DEFAULT]"
+
+  /// Live `FIRApp` entry used by `RNFBSharedUtils`.
+  @objc(firAppToDictionaryFromFIRApp:customDomainProvider:)
+  public static func firAppToDictionary(
+    fromFIRApp firApp: NSObject,
+    customDomainProvider: RNFBCustomDomainProviding
+  ) -> NSDictionary {
+#if RNFB_DYNAMIC_FIREBASE_PROBE
+    firAppToDictionary(
+      RNFBOpaqueAppProvider(RNFBFirebaseAppClient.snapshot(of: firApp)),
+      customDomainProvider: customDomainProvider
+    )
+#else
+    firAppToDictionary(
+      RNFBFIRAppAdapter(app: firApp as! FirebaseApp),
+      customDomainProvider: customDomainProvider
+    )
+#endif
+  }
+
+  @objc(firAppToDictionary:customDomainProvider:)
+  public static func firAppToDictionary(
+    _ app: RNFBFIRAppProviding,
+    customDomainProvider: RNFBCustomDomainProviding
+  ) -> NSDictionary {
+    let firAppDictionary = NSMutableDictionary()
+    let firAppOptions = NSMutableDictionary()
+    let firAppConfig = NSMutableDictionary()
+
+    var name = app.name
+    if name == defaultAppName {
+      name = defaultAppDisplayName
+    }
+
+    firAppConfig["name"] = name
+    firAppConfig["automaticDataCollectionEnabled"] = NSNumber(
+      value: app.isDataCollectionDefaultEnabled()
+    )
+
+    let options = app.options
+    firAppOptions["apiKey"] = options.apiKey
+    firAppOptions["appId"] = options.googleAppID
+    firAppOptions["projectId"] = options.projectID
+    firAppOptions["databaseURL"] = options.databaseURL
+    firAppOptions["storageBucket"] = options.storageBucket
+    firAppOptions["messagingSenderId"] = options.gcmSenderID
+    // missing from android sdk - ios only:
+    firAppOptions["clientId"] = options.clientID
+    // not in FIROptions API but in JS SDK and project config JSON
+    if let customAuthDomain = customDomainProvider.getCustomDomain(name) {
+      firAppOptions["authDomain"] = customAuthDomain
+    }
+
+    firAppDictionary["options"] = firAppOptions
+    firAppDictionary["appConfig"] = firAppConfig
+    return firAppDictionary
+  }
+
+  /// Live `FIRApp` entry used by `RNFBSharedUtils`.
+  @objc(sendJSEventForFIRApp:name:body:eventSender:)
+  public static func sendJSEvent(
+    forFIRApp firApp: NSObject,
+    name: String,
+    body: NSDictionary,
+    eventSender: RNFBJSEventSending
+  ) {
+#if RNFB_DYNAMIC_FIREBASE_PROBE
+    sendJSEvent(
+      forApp: RNFBOpaqueAppProvider(RNFBFirebaseAppClient.snapshot(of: firApp)),
+      name: name,
+      body: body,
+      eventSender: eventSender
+    )
+#else
+    sendJSEvent(
+      forApp: RNFBFIRAppAdapter(app: firApp as! FirebaseApp),
+      name: name,
+      body: body,
+      eventSender: eventSender
+    )
+#endif
+  }
+
+  @objc(sendJSEventForApp:name:body:eventSender:)
+  public static func sendJSEvent(
+    forApp app: RNFBFIRAppProviding,
+    name: String,
+    body: NSDictionary,
+    eventSender: RNFBJSEventSending
+  ) {
+    let newBody = NSMutableDictionary(dictionary: body)
+    newBody["appName"] = RNFBSharedUtilsFormatting.getAppJavaScriptName(app.name)
+    eventSender.sendEvent(name: name, body: newBody)
+  }
+}

package/ios/RNFBApp/RNFBSharedUtilsFormatting.swift

@@ -0,0 +1,59 @@
+/**
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import Foundation
+
+/**
+ * Name/date formatting helpers previously inline in `RNFBSharedUtils.m`.
+ *
+ * Mirrors pre-port:
+ * - `__FIRAPP_DEFAULT` → `[DEFAULT]` for JS app names
+ * - ISO-8601 via POSIX/`UTC` formatter + trailing `Z` (no fractional seconds)
+ */
+@objc(RNFBSharedUtilsFormatting)
+public final class RNFBSharedUtilsFormatting: NSObject {
+  /// Matches `DEFAULT_APP_NAME` in `RNFBSharedUtils.m`.
+  private static let defaultAppName = "__FIRAPP_DEFAULT"
+  /// Matches `DEFAULT_APP_DISPLAY_NAME` in `RNFBSharedUtils.m`.
+  private static let defaultAppDisplayName = "[DEFAULT]"
+
+  private static let iso8601Formatter: DateFormatter = {
+    let formatter = DateFormatter()
+    formatter.locale = Locale(identifier: "en_US_POSIX")
+    formatter.timeZone = TimeZone(abbreviation: "UTC")
+    formatter.dateFormat = "yyyy-MM-dd'T'HH:mm:ss"
+    return formatter
+  }()
+
+  @objc(getAppJavaScriptName:)
+  public static func getAppJavaScriptName(_ appDisplayName: String?) -> String? {
+    guard let appDisplayName else {
+      return nil
+    }
+    if appDisplayName == defaultAppName {
+      return defaultAppDisplayName
+    }
+    return appDisplayName
+  }
+
+  @objc(getISO8601String:)
+  public static func getISO8601String(_ date: Date?) -> String? {
+    guard let date else {
+      return nil
+    }
+    return iso8601Formatter.string(from: date) + "Z"
+  }
+}

package/ios/RNFBApp/RNFBSharedUtilsPromiseRejection.swift

@@ -0,0 +1,88 @@
+/**
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import Foundation
+
+/// Reject callback matching `RCTPromiseRejectBlock` (`code`, `message`, `error`).
+public typealias RNFBPromiseRejectCallback = (String?, String?, (any Error)?) -> Void
+
+/**
+ * Promise-rejection helpers previously inline in `RNFBSharedUtils.m`.
+ *
+ * Mirrors pre-port:
+ * - Constructed `NSError` always uses domain `RNFBErrorDomain` and code `666`
+ * - Exception path: fatal=YES, code="unknown", message/nativeErrorMessage=reason,
+ *   nativeErrorCode=name; reject(name, reason, error)
+ * - NSError path: fatal=NO, code="unknown", message/nativeErrorMessage=localizedDescription,
+ *   nativeErrorCode=@(error.code); reject("unknown", localizedDescription, newError)
+ * - UserInfo path: NSError from given userInfo; reject(userInfo["code"], userInfo["message"], error)
+ */
+@objc(RNFBSharedUtilsPromiseRejection)
+public final class RNFBSharedUtilsPromiseRejection: NSObject {
+  /// Matches pre-port private `RNFBErrorDomain` in `RNFBSharedUtils.m`.
+  private static let errorDomain = "RNFBErrorDomain"
+  private static let constructedErrorCode = 666
+
+  @objc(rejectPromiseWithException:exception:)
+  public static func rejectPromise(
+    withException reject: @escaping RNFBPromiseRejectCallback,
+    exception: NSException
+  ) {
+    let userInfo = NSMutableDictionary()
+    userInfo.setValue(true, forKey: "fatal")
+    userInfo.setValue("unknown", forKey: "code")
+    userInfo.setValue(exception.reason, forKey: "message")
+    userInfo.setValue(exception.name.rawValue, forKey: "nativeErrorCode")
+    userInfo.setValue(exception.reason, forKey: "nativeErrorMessage")
+
+    let error = makeError(userInfo: userInfo)
+    reject(exception.name.rawValue, exception.reason, error)
+  }
+
+  @objc(rejectPromiseWithNSError:error:)
+  public static func rejectPromise(
+    withNSError reject: @escaping RNFBPromiseRejectCallback,
+    error: NSError
+  ) {
+    let userInfo = NSMutableDictionary()
+    userInfo.setValue(false, forKey: "fatal")
+    userInfo.setValue("unknown", forKey: "code")
+    userInfo.setValue(error.localizedDescription, forKey: "message")
+    userInfo.setValue(NSNumber(value: error.code), forKey: "nativeErrorCode")
+    userInfo.setValue(error.localizedDescription, forKey: "nativeErrorMessage")
+
+    let newError = makeError(userInfo: userInfo)
+    reject("unknown", error.localizedDescription, newError)
+  }
+
+  @objc(rejectPromiseWithUserInfo:userInfo:)
+  public static func rejectPromise(
+    withUserInfo reject: @escaping RNFBPromiseRejectCallback,
+    userInfo: NSMutableDictionary
+  ) {
+    let error = makeError(userInfo: userInfo)
+    reject(userInfo["code"] as? String, userInfo["message"] as? String, error)
+  }
+
+  private static func makeError(userInfo: NSDictionary) -> NSError {
+    // NSDictionary bridges to [String: Any] for NSError when keys are strings.
+    NSError(
+      domain: errorDomain,
+      code: constructedErrorCode,
+      userInfo: (userInfo as! [String: Any])
+    )
+  }
+}

package/ios/RNFBApp/RNFBUtilsHelpers.swift

@@ -0,0 +1,116 @@
+/**
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import Foundation
+
+/// Path lookup previously hard-wired to `NSSearchPathForDirectoriesInDomains`.
+public typealias RNFBUtilsPathProvider = (Int32) -> String?
+
+/**
+ * Foundation-pure helpers previously inline in `RNFBUtilsModule.mm`.
+ *
+ * Mirrors pre-port:
+ * - `pathForDirectory` → `NSSearchPathForDirectoriesInDomains(..., NSUserDomainMask, YES).firstObject`
+ * - constants keys + optional `appVersion` when `CFBundleShortVersionString` is a non-empty `NSString`
+ * - remote asset prefixes `assets-library://` / `ph://`
+ * - HEIC via `pathExtension` + `caseInsensitiveCompare:` (nil path → YES, matching ObjC nil messaging)
+ * - query item lookup via `NSPredicate` `name=%@` + `firstObject`
+ */
+@objc(RNFBUtilsHelpers)
+public final class RNFBUtilsHelpers: NSObject {
+  @objc(pathForDirectory:)
+  public static func path(forDirectory directory: Int32) -> String? {
+    let searchDirectory = FileManager.SearchPathDirectory(rawValue: UInt(directory))!
+    let paths = NSSearchPathForDirectoriesInDomains(searchDirectory, .userDomainMask, true)
+    return paths.first
+  }
+
+  @objc(utilsConstantsDictionary)
+  public static func utilsConstantsDictionary() -> NSDictionary {
+    utilsConstantsDictionary(
+      bundlePath: Bundle.main.bundlePath,
+      appVersion: Bundle.main.object(forInfoDictionaryKey: "CFBundleShortVersionString"),
+      pathProvider: { directory in path(forDirectory: directory) },
+      temporaryDirectory: NSTemporaryDirectory()
+    )
+  }
+
+  @objc(utilsConstantsDictionaryWithBundlePath:appVersion:pathProvider:temporaryDirectory:)
+  public static func utilsConstantsDictionary(
+    bundlePath: String,
+    appVersion: Any?,
+    pathProvider: @escaping RNFBUtilsPathProvider,
+    temporaryDirectory: String
+  ) -> NSDictionary {
+    let constants = NSMutableDictionary()
+    constants["isRunningInTestLab"] = NSNumber(value: false)
+    constants["MAIN_BUNDLE"] = bundlePath
+    constants["CACHES_DIRECTORY"] = pathProvider(
+      Int32(FileManager.SearchPathDirectory.cachesDirectory.rawValue)
+    )
+    constants["DOCUMENT_DIRECTORY"] = pathProvider(
+      Int32(FileManager.SearchPathDirectory.documentDirectory.rawValue)
+    )
+    constants["PICTURES_DIRECTORY"] = pathProvider(
+      Int32(FileManager.SearchPathDirectory.picturesDirectory.rawValue)
+    )
+    constants["MOVIES_DIRECTORY"] = pathProvider(
+      Int32(FileManager.SearchPathDirectory.moviesDirectory.rawValue)
+    )
+    constants["TEMP_DIRECTORY"] = temporaryDirectory
+    constants["LIBRARY_DIRECTORY"] = pathProvider(
+      Int32(FileManager.SearchPathDirectory.libraryDirectory.rawValue)
+    )
+
+    // Pre-port: `[appVersion isKindOfClass:[NSString class]] && appVersion.length > 0`
+    if let appVersion = appVersion as? String, !appVersion.isEmpty {
+      constants["appVersion"] = appVersion
+    }
+
+    return constants.copy() as! NSDictionary
+  }
+
+  @objc(isRemoteAsset:)
+  public static func isRemoteAsset(_ localFilePath: String?) -> Bool {
+    // Pre-port: nil receiver → hasPrefix returns NO
+    guard let localFilePath else {
+      return false
+    }
+    return localFilePath.hasPrefix("assets-library://") || localFilePath.hasPrefix("ph://")
+  }
+
+  @objc(unused_isHeic:)
+  public static func unusedIsHeic(_ localFilePath: String?) -> Bool {
+    // Pre-port: `[[localFilePath pathExtension] caseInsensitiveCompare:@"heic"] == NSOrderedSame`
+    // Messaging nil returns 0 for NSComparisonResult → equals NSOrderedSame → YES.
+    let pathExtension = (localFilePath as NSString?)?.pathExtension
+    guard let pathExtension else {
+      return true
+    }
+    return (pathExtension as NSString).caseInsensitiveCompare("heic") == .orderedSame
+  }
+
+  @objc(valueForKey:fromQueryItems:)
+  public static func value(forKey key: String?, fromQueryItems queryItems: [Any]?) -> String? {
+    // Pre-port: nil queryItems → filteredArray nil → firstObject nil → value nil
+    guard let queryItems else {
+      return nil
+    }
+    let predicate = NSPredicate(format: "name=%@", key ?? "")
+    let queryItem = (queryItems as NSArray).filtered(using: predicate).first as? URLQueryItem
+    return queryItem?.value
+  }
+}

package/ios/RNFBApp/RNFBUtilsModule+Foundation.m

@@ -0,0 +1,44 @@
+/**
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ */
+
+#import "RNFBUtilsModule.h"
+
+#if __has_include(<RNFBApp/RNFBApp-Swift.h>)
+#import <RNFBApp/RNFBApp-Swift.h>
+#elif __has_include("RNFBApp-Swift.h")
+#import "RNFBApp-Swift.h"
+#elif __has_include("RNFBHandleMapStorage-Swift.inc")
+#import "RNFBHandleMapStorage-Swift.inc"
+#else
+#error "RNFBApp Swift interface not found"
+#endif
+
+@implementation RNFBUtilsModule (FoundationHelpers)
+
++ (BOOL)isRemoteAsset:(NSString *)localFilePath {
+  return [RNFBUtilsHelpers isRemoteAsset:localFilePath];
+}
+
++ (BOOL)unused_isHeic:(NSString *)localFilePath {
+  return [RNFBUtilsHelpers unused_isHeic:localFilePath];
+}
+
++ (NSString *)valueForKey:(NSString *)key fromQueryItems:(NSArray *)queryItems {
+  return [RNFBUtilsHelpers valueForKey:key fromQueryItems:queryItems];
+}
+
+@end

package/ios/RNFBApp/RNFBUtilsModule+PhotoAssets.m

@@ -0,0 +1,47 @@
+/**
+ * Copyright (c) 2016-present Invertase Limited & Contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this library except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#import <Photos/Photos.h>
+
+#import "RNFBUtilsModule.h"
+
+@implementation RNFBUtilsModule (PhotoAssets)
+
++ (PHAsset *)fetchAssetForPath:(NSString *)localFilePath {
+  PHAsset *asset = nil;
+
+  if ([localFilePath hasPrefix:@"assets-library://"] || [localFilePath hasPrefix:@"ph://"]) {
+    if ([localFilePath hasPrefix:@"assets-library://"]) {
+      static BOOL hasWarned = NO;
+      if (!hasWarned) {
+        NSLog(@"'assets-library://' & 'ph://' URLs are not supported in Catalyst-based targets "
+              @"or iOS 12 and higher; returning nil (future warnings will be suppressed)");
+        hasWarned = YES;
+      }
+    } else {
+      NSString *assetId = [localFilePath substringFromIndex:@"ph://".length];
+      asset = [[PHAsset fetchAssetsWithLocalIdentifiers:@[ assetId ] options:nil] firstObject];
+    }
+  } else {
+    NSURLComponents *components = [NSURLComponents componentsWithString:localFilePath];
+    NSString *assetId = [self valueForKey:@"id" fromQueryItems:components.queryItems];
+    asset = [[PHAsset fetchAssetsWithLocalIdentifiers:@[ assetId ] options:nil] firstObject];
+  }
+
+  return asset;
+}
+
+@end

package/ios/RNFBApp/RNFBUtilsModule.h

@@ -16,13 +16,23 @@
  */
 
 #import <Foundation/Foundation.h>
-#import <Photos/Photos.h>
+
+@class PHAsset;
 
 @interface RNFBUtilsModule : NSObject
 
+@end
+
+@interface RNFBUtilsModule (FoundationHelpers)
+
 + (BOOL)isRemoteAsset:(NSString *)localFilePath;
 + (BOOL)unused_isHeic:(NSString *)localFilePath;
 + (NSString *)valueForKey:(NSString *)key fromQueryItems:(NSArray *)queryItems;
+
+@end
+
+@interface RNFBUtilsModule (PhotoAssets)
+
 + (PHAsset *)fetchAssetForPath:(NSString *)localFilePath;
 
 @end