@hortemo/expo-photos 1.0.0 → 2.0.0

package/ExpoPhotos.podspec

@@ -16,7 +16,7 @@ Pod::Spec.new do |s|
   s.static_framework = true
 
   s.dependency 'ExpoModulesCore'
-  s.dependency 'React'
+  s.dependency 'React-Core'
   s.dependency 'SDWebImageWebPCoder', '0.15.0'
 
   s.source_files = 'ios/**/*.{h,m,swift}'

package/README.md

@@ -16,3 +16,4 @@ npm install @hortemo/expo-photos
 - `pickAssets(options: PickAssetsOptions): Promise<PHAsset[]>`
 - `requestAuthorization(accessLevel: PHAccessLevel): Promise<PHAuthorizationStatus>`
 - `presentLimitedLibraryPicker(): Promise<void>`
+- `createPHImageSource(options: PHImageSourceOptions): ImageSourcePropType | undefined`

package/build/PHImageSource.d.ts

@@ -0,0 +1,32 @@
+import type { ImageSourcePropType } from "react-native";
+import { CGSize, PHImageContentMode, PHImageRequestOptionsDeliveryMode, PHImageRequestOptionsResizeMode } from "./ExpoPhotos.types";
+export interface PHImageSourceOptions {
+    localIdentifier: string;
+    targetSize?: CGSize;
+    resizeMode?: PHImageRequestOptionsResizeMode;
+    deliveryMode?: PHImageRequestOptionsDeliveryMode;
+    contentMode?: PHImageContentMode;
+    isNetworkAccessAllowed?: boolean;
+}
+/**
+ * Creates a source object for React Native's Image component from a Photos library asset identifier.
+ *
+ * @param options - Configuration for image source, including the local identifier
+ * @returns A source object that can be used with the Image component's `source` prop, or undefined if no identifier is provided
+ *
+ * @example
+ * ```tsx
+ * import { Image } from 'react-native';
+ * import { createPHImageSource } from '@hortemo/expo-photos';
+ *
+ * <Image
+ *   source={createPHImageSource({
+ *     localIdentifier: asset.localIdentifier,
+ *     targetSize: { width: 200, height: 200 },
+ *     contentMode: PHImageContentMode.aspectFill,
+ *   })}
+ * />
+ * ```
+ */
+export declare function createPHImageSource(options: PHImageSourceOptions): ImageSourcePropType | undefined;
+//# sourceMappingURL=PHImageSource.d.ts.map

package/build/PHImageSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PHImageSource.d.ts","sourceRoot":"","sources":["../src/PHImageSource.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EACL,MAAM,EACN,kBAAkB,EAClB,iCAAiC,EACjC,+BAA+B,EAChC,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,+BAA+B,CAAC;IAC7C,YAAY,CAAC,EAAE,iCAAiC,CAAC;IACjD,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAwBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,oBAAoB,GAC5B,mBAAmB,GAAG,SAAS,CA6BjC"}

package/build/PHImageSource.js

@@ -0,0 +1,51 @@
+import { PHImageContentMode, PHImageRequestOptionsDeliveryMode, PHImageRequestOptionsResizeMode, } from "./ExpoPhotos.types";
+const buildQueryString = (params) => {
+    const entries = Object.entries(params).filter(([, value]) => value !== undefined);
+    if (entries.length === 0) {
+        return "";
+    }
+    return ("?" +
+        entries
+            .map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value ?? "")}`)
+            .join("&"));
+};
+/**
+ * Creates a source object for React Native's Image component from a Photos library asset identifier.
+ *
+ * @param options - Configuration for image source, including the local identifier
+ * @returns A source object that can be used with the Image component's `source` prop, or undefined if no identifier is provided
+ *
+ * @example
+ * ```tsx
+ * import { Image } from 'react-native';
+ * import { createPHImageSource } from '@hortemo/expo-photos';
+ *
+ * <Image
+ *   source={createPHImageSource({
+ *     localIdentifier: asset.localIdentifier,
+ *     targetSize: { width: 200, height: 200 },
+ *     contentMode: PHImageContentMode.aspectFill,
+ *   })}
+ * />
+ * ```
+ */
+export function createPHImageSource(options) {
+    const { localIdentifier } = options;
+    if (!localIdentifier) {
+        return undefined;
+    }
+    const { targetSize, resizeMode = PHImageRequestOptionsResizeMode.Fast, deliveryMode = PHImageRequestOptionsDeliveryMode.Opportunistic, contentMode = PHImageContentMode.aspectFill, isNetworkAccessAllowed = true, } = options;
+    const targetSizeValue = targetSize
+        ? `${targetSize.width}x${targetSize.height}`
+        : undefined;
+    const query = buildQueryString({
+        localIdentifier,
+        targetSize: targetSizeValue,
+        resizeMode: resizeMode.toString(),
+        deliveryMode: deliveryMode.toString(),
+        contentMode: contentMode.toString(),
+        isNetworkAccessAllowed: isNetworkAccessAllowed.toString(),
+    });
+    return { uri: `expo-photos://${query}` };
+}
+//# sourceMappingURL=PHImageSource.js.map

package/build/PHImageSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PHImageSource.js","sourceRoot":"","sources":["../src/PHImageSource.tsx"],"names":[],"mappings":"AACA,OAAO,EAEL,kBAAkB,EAClB,iCAAiC,EACjC,+BAA+B,GAChC,MAAM,oBAAoB,CAAC;AAW5B,MAAM,gBAAgB,GAAG,CACvB,MAA0C,EAClC,EAAE;IACV,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAC3C,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CACnC,CAAC;IAEF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,CACL,GAAG;QACH,OAAO;aACJ,GAAG,CACF,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CACf,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAClE;aACA,IAAI,CAAC,GAAG,CAAC,CACb,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAA6B;IAE7B,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;IAEpC,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,EACJ,UAAU,EACV,UAAU,GAAG,+BAA+B,CAAC,IAAI,EACjD,YAAY,GAAG,iCAAiC,CAAC,aAAa,EAC9D,WAAW,GAAG,kBAAkB,CAAC,UAAU,EAC3C,sBAAsB,GAAG,IAAI,GAC9B,GAAG,OAAO,CAAC;IAEZ,MAAM,eAAe,GAAG,UAAU;QAChC,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,IAAI,UAAU,CAAC,MAAM,EAAE;QAC5C,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,KAAK,GAAG,gBAAgB,CAAC;QAC7B,eAAe;QACf,UAAU,EAAE,eAAe;QAC3B,UAAU,EAAE,UAAU,CAAC,QAAQ,EAAE;QACjC,YAAY,EAAE,YAAY,CAAC,QAAQ,EAAE;QACrC,WAAW,EAAE,WAAW,CAAC,QAAQ,EAAE;QACnC,sBAAsB,EAAE,sBAAsB,CAAC,QAAQ,EAAE;KAC1D,CAAC,CAAC;IAEH,OAAO,EAAE,GAAG,EAAE,iBAAiB,KAAK,EAAE,EAAE,CAAC;AAC3C,CAAC","sourcesContent":["import type { ImageSourcePropType } from \"react-native\";\nimport {\n  CGSize,\n  PHImageContentMode,\n  PHImageRequestOptionsDeliveryMode,\n  PHImageRequestOptionsResizeMode,\n} from \"./ExpoPhotos.types\";\n\nexport interface PHImageSourceOptions {\n  localIdentifier: string;\n  targetSize?: CGSize;\n  resizeMode?: PHImageRequestOptionsResizeMode;\n  deliveryMode?: PHImageRequestOptionsDeliveryMode;\n  contentMode?: PHImageContentMode;\n  isNetworkAccessAllowed?: boolean;\n}\n\nconst buildQueryString = (\n  params: Record<string, string | undefined>\n): string => {\n  const entries = Object.entries(params).filter(\n    ([, value]) => value !== undefined\n  );\n\n  if (entries.length === 0) {\n    return \"\";\n  }\n\n  return (\n    \"?\" +\n    entries\n      .map(\n        ([key, value]) =>\n          `${encodeURIComponent(key)}=${encodeURIComponent(value ?? \"\")}`\n      )\n      .join(\"&\")\n  );\n};\n\n/**\n * Creates a source object for React Native's Image component from a Photos library asset identifier.\n *\n * @param options - Configuration for image source, including the local identifier\n * @returns A source object that can be used with the Image component's `source` prop, or undefined if no identifier is provided\n *\n * @example\n * ```tsx\n * import { Image } from 'react-native';\n * import { createPHImageSource } from '@hortemo/expo-photos';\n *\n * <Image\n *   source={createPHImageSource({\n *     localIdentifier: asset.localIdentifier,\n *     targetSize: { width: 200, height: 200 },\n *     contentMode: PHImageContentMode.aspectFill,\n *   })}\n * />\n * ```\n */\nexport function createPHImageSource(\n  options: PHImageSourceOptions\n): ImageSourcePropType | undefined {\n  const { localIdentifier } = options;\n\n  if (!localIdentifier) {\n    return undefined;\n  }\n\n  const {\n    targetSize,\n    resizeMode = PHImageRequestOptionsResizeMode.Fast,\n    deliveryMode = PHImageRequestOptionsDeliveryMode.Opportunistic,\n    contentMode = PHImageContentMode.aspectFill,\n    isNetworkAccessAllowed = true,\n  } = options;\n\n  const targetSizeValue = targetSize\n    ? `${targetSize.width}x${targetSize.height}`\n    : undefined;\n\n  const query = buildQueryString({\n    localIdentifier,\n    targetSize: targetSizeValue,\n    resizeMode: resizeMode.toString(),\n    deliveryMode: deliveryMode.toString(),\n    contentMode: contentMode.toString(),\n    isNetworkAccessAllowed: isNetworkAccessAllowed.toString(),\n  });\n\n  return { uri: `expo-photos://${query}` };\n}\n"]}

package/build/index.d.ts

@@ -1,3 +1,5 @@
 export { default } from "./ExpoPhotosModule";
 export * from "./ExpoPhotos.types";
+export { createPHImageSource } from "./PHImageSource";
+export type { PHImageSourceOptions } from "./PHImageSource";
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}

package/build/index.js

@@ -1,3 +1,4 @@
 export { default } from "./ExpoPhotosModule";
 export * from "./ExpoPhotos.types";
+export { createPHImageSource } from "./PHImageSource";
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,cAAc,oBAAoB,CAAC","sourcesContent":["export { default } from \"./ExpoPhotosModule\";\nexport * from \"./ExpoPhotos.types\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC","sourcesContent":["export { default } from \"./ExpoPhotosModule\";\nexport * from \"./ExpoPhotos.types\";\nexport { createPHImageSource } from \"./PHImageSource\";\nexport type { PHImageSourceOptions } from \"./PHImageSource\";\n"]}

package/expo-module.config.json

@@ -1,7 +1,6 @@
 {
   "platforms": ["apple"],
   "apple": {
-    "modules": ["ExpoPhotos"],
-    "podspecPath": "ExpoPhotos.podspec"
+    "modules": ["ExpoPhotos"]
   }
 }

package/ios/ExpoPhotos.podspec

@@ -0,0 +1,24 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, '..', 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name         = 'ExpoPhotos'
+  s.version      = package['version']
+  s.summary      = package['description']
+  s.description  = package['description']
+  s.license      = package['license']
+  s.author       = package['author']
+  s.homepage     = package['homepage']
+  s.platform     = :ios, '15.0'
+  s.swift_version = '5.9'
+  s.source       = { git: package['repository'] || 'https://github.com/hortemo/expo-photos' }
+  s.static_framework = true
+
+  s.dependency 'ExpoModulesCore'
+  s.dependency 'React-Core'
+  s.dependency 'SDWebImageWebPCoder', '0.15.0'
+
+  s.source_files = '**/*.{h,m,swift}'
+  s.requires_arc = true
+end

package/ios/ExpoPhotosImageLoader.swift

@@ -0,0 +1,183 @@
+#if canImport(React)
+import Foundation
+import Photos
+import React
+import UIKit
+
+@objc(ExpoPhotosImageLoader)
+class ExpoPhotosImageLoader: NSObject, RCTBridgeModule, RCTImageURLLoader {
+  static func moduleName() -> String! {
+    return "ExpoPhotosImageLoader"
+  }
+
+  static func requiresMainQueueSetup() -> Bool {
+    return false
+  }
+
+  // MARK: - Helper Functions
+
+  private static func queryItems(from url: URL) -> [String: String] {
+    guard let components = URLComponents(url: url, resolvingAgainstBaseURL: false),
+          let queryItems = components.queryItems else {
+      return [:]
+    }
+
+    var result: [String: String] = [:]
+    for item in queryItems {
+      if let value = item.value {
+        result[item.name] = value
+      }
+    }
+    return result
+  }
+
+  // MARK: - RCTImageURLLoader
+
+  func canLoadImageURL(_ requestURL: URL) -> Bool {
+    return requestURL.scheme?.caseInsensitiveCompare("expo-photos") == .orderedSame
+  }
+
+  func loaderPriority() -> Float {
+    return 1.0
+  }
+
+  func loadImage(
+    for imageURL: URL,
+    size: CGSize,
+    scale: CGFloat,
+    resizeMode: RCTResizeMode,
+    progressHandler: RCTImageLoaderProgressBlock!,
+    partialLoadHandler: RCTImageLoaderPartialLoadBlock!,
+    completionHandler: @escaping RCTImageLoaderCompletionBlock
+  ) -> RCTImageLoaderCancellationBlock! {
+
+    guard imageURL.scheme?.caseInsensitiveCompare("expo-photos") == .orderedSame else {
+      completionHandler(RCTErrorWithMessage("Unsupported image URL scheme for ExpoPhotos"), nil)
+      return {}
+    }
+
+    let queryParams = Self.queryItems(from: imageURL)
+
+    guard let localIdentifier = queryParams["localIdentifier"], !localIdentifier.isEmpty else {
+      completionHandler(RCTErrorWithMessage("Missing localIdentifier query parameter"), nil)
+      return {}
+    }
+
+    let assets = PHAsset.fetchAssets(withLocalIdentifiers: [localIdentifier], options: nil)
+    guard let asset = assets.firstObject else {
+      completionHandler(RCTErrorWithMessage("Failed to fetch PHAsset with local identifier \(localIdentifier)"), nil)
+      return {}
+    }
+
+    let imageOptions = PHImageRequestOptions()
+
+    var targetSize = size.applying(CGAffineTransform(scaleX: scale, y: scale))
+
+    if let targetSizeString = queryParams["targetSize"] {
+      let components = targetSizeString.lowercased().components(separatedBy: "x")
+      guard components.count == 2,
+            let width = Double(components[0]),
+            let height = Double(components[1]) else {
+        completionHandler(RCTErrorWithMessage("Invalid targetSize format. Expected WIDTHxHEIGHT."), nil)
+        return {}
+      }
+      targetSize = CGSize(width: width, height: height)
+    }
+
+    if let deliveryModeString = queryParams["deliveryMode"] {
+      guard let deliveryMode = PHImageRequestOptionsDeliveryMode.from(queryParam: deliveryModeString) else {
+        completionHandler(RCTErrorWithMessage("Invalid deliveryMode value."), nil)
+        return {}
+      }
+      imageOptions.deliveryMode = deliveryMode
+    }
+
+    if let resizeModeString = queryParams["resizeMode"] {
+      guard let resizeMode = PHImageRequestOptionsResizeMode.from(queryParam: resizeModeString) else {
+        completionHandler(RCTErrorWithMessage("Invalid resizeMode value."), nil)
+        return {}
+      }
+      imageOptions.resizeMode = resizeMode
+    }
+
+    if let isNetworkAccessAllowedString = queryParams["isNetworkAccessAllowed"] {
+      imageOptions.isNetworkAccessAllowed = Bool.from(queryParam: isNetworkAccessAllowedString)
+    }
+
+    var contentMode: PHImageContentMode = .default
+    if let contentModeString = queryParams["contentMode"] {
+      guard let _contentMode = PHImageContentMode.from(queryParam: contentModeString) else {
+        completionHandler(RCTErrorWithMessage("Invalid contentMode value."), nil)
+        return {}
+      }
+      contentMode = _contentMode
+    }
+
+    if let progressHandler = progressHandler {
+      imageOptions.progressHandler = { progress, error, stop, info in
+        let multiplier: Int64 = 1_000_000
+        progressHandler(Int64(progress * Double(multiplier)), multiplier)
+      }
+    }
+
+    let requestID = PHImageManager.default().requestImage(
+      for: asset,
+      targetSize: targetSize,
+      contentMode: contentMode,
+      options: imageOptions
+    ) { result, info in
+      guard let info = info else {
+        return
+      }
+
+      let isCancelled = (info[PHImageCancelledKey] as? NSNumber)?.boolValue ?? false
+      let isDegraded = (info[PHImageResultIsDegradedKey] as? NSNumber)?.boolValue ?? false
+
+      if isCancelled {
+        return
+      }
+
+      if let result = result {
+        if isDegraded {
+          partialLoadHandler?(result)
+        } else {
+          completionHandler(nil, result)
+        }
+      } else if let error = info[PHImageErrorKey] as? Error {
+        completionHandler(error, nil)
+      }
+    }
+
+    return {
+      PHImageManager.default().cancelImageRequest(requestID)
+    }
+  }
+}
+
+// MARK: - RawRepresentable Extension
+
+extension RawRepresentable where RawValue == Int {
+  static func from(queryParam string: String?) -> Self? {
+    guard let string = string, !string.isEmpty else {
+      return nil
+    }
+    guard let intValue = Int(string) else {
+      return nil
+    }
+    return Self(rawValue: intValue)
+  }
+}
+
+// MARK: - Bool Extension
+
+extension Bool {
+  static func from(queryParam string: String?) -> Bool {
+    guard let string = string, !string.isEmpty else {
+      return false
+    }
+    return string.lowercased() == "true"
+  }
+}
+
+#endif
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hortemo/expo-photos",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "description": "Expo module exposing advanced iOS Photos APIs.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -39,5 +39,15 @@
     "expo": "*",
     "react": "*",
     "react-native": "*"
+  },
+  "codegenConfig": {
+    "name": "expo-photos",
+    "type": "modules",
+    "jsSrcsDir": "./src",
+    "ios": {
+      "modulesConformingToProtocol": {
+        "RCTImageURLLoader": "ExpoPhotosImageLoader"
+      }
+    }
   }
 }

package/src/PHImageSource.tsx

@@ -0,0 +1,91 @@
+import type { ImageSourcePropType } from "react-native";
+import {
+  CGSize,
+  PHImageContentMode,
+  PHImageRequestOptionsDeliveryMode,
+  PHImageRequestOptionsResizeMode,
+} from "./ExpoPhotos.types";
+
+export interface PHImageSourceOptions {
+  localIdentifier: string;
+  targetSize?: CGSize;
+  resizeMode?: PHImageRequestOptionsResizeMode;
+  deliveryMode?: PHImageRequestOptionsDeliveryMode;
+  contentMode?: PHImageContentMode;
+  isNetworkAccessAllowed?: boolean;
+}
+
+const buildQueryString = (
+  params: Record<string, string | undefined>
+): string => {
+  const entries = Object.entries(params).filter(
+    ([, value]) => value !== undefined
+  );
+
+  if (entries.length === 0) {
+    return "";
+  }
+
+  return (
+    "?" +
+    entries
+      .map(
+        ([key, value]) =>
+          `${encodeURIComponent(key)}=${encodeURIComponent(value ?? "")}`
+      )
+      .join("&")
+  );
+};
+
+/**
+ * Creates a source object for React Native's Image component from a Photos library asset identifier.
+ *
+ * @param options - Configuration for image source, including the local identifier
+ * @returns A source object that can be used with the Image component's `source` prop, or undefined if no identifier is provided
+ *
+ * @example
+ * ```tsx
+ * import { Image } from 'react-native';
+ * import { createPHImageSource } from '@hortemo/expo-photos';
+ *
+ * <Image
+ *   source={createPHImageSource({
+ *     localIdentifier: asset.localIdentifier,
+ *     targetSize: { width: 200, height: 200 },
+ *     contentMode: PHImageContentMode.aspectFill,
+ *   })}
+ * />
+ * ```
+ */
+export function createPHImageSource(
+  options: PHImageSourceOptions
+): ImageSourcePropType | undefined {
+  const { localIdentifier } = options;
+
+  if (!localIdentifier) {
+    return undefined;
+  }
+
+  const {
+    targetSize,
+    resizeMode = PHImageRequestOptionsResizeMode.Fast,
+    deliveryMode = PHImageRequestOptionsDeliveryMode.Opportunistic,
+    contentMode = PHImageContentMode.aspectFill,
+    isNetworkAccessAllowed = true,
+  } = options;
+
+  const targetSizeValue = targetSize
+    ? `${targetSize.width}x${targetSize.height}`
+    : undefined;
+
+  const query = buildQueryString({
+    localIdentifier,
+    targetSize: targetSizeValue,
+    resizeMode: resizeMode.toString(),
+    deliveryMode: deliveryMode.toString(),
+    contentMode: contentMode.toString(),
+    isNetworkAccessAllowed: isNetworkAccessAllowed.toString(),
+  });
+
+  return { uri: `expo-photos://${query}` };
+}

package/src/index.ts

@@ -1,2 +1,4 @@
 export { default } from "./ExpoPhotosModule";
 export * from "./ExpoPhotos.types";
+export { createPHImageSource } from "./PHImageSource";
+export type { PHImageSourceOptions } from "./PHImageSource";