react-native-dynamic-resource-loader 0.2.0

package/DynamicResourceLoader.podspec

@@ -0,0 +1,20 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "DynamicResourceLoader"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/Rob117//react-native-dynamic-resource-loader.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift,cpp}"
+  s.private_header_files = "ios/**/*.h"
+
+  install_modules_dependencies(s)
+end

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 Robert Sherling
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,207 @@
+# react-native-dynamic-resource-loader
+
+Load iOS [On-Demand Resources](https://developer.apple.com/library/archive/documentation/FileManagement/Conceptual/On_Demand_Resources_Guide/) and Android [Play Asset Delivery](https://developer.android.com/guide/playcore/asset-delivery) from React Native. Download tagged assets at runtime to reduce your initial app size.
+
+## Installation
+
+```sh
+npm install react-native-dynamic-resource-loader
+```
+
+## Xcode Setup
+
+Before using the library, you need to configure On-Demand Resources in your Xcode project:
+
+1. **Enable ODR** — In your Xcode project, go to Build Settings and set `ENABLE_ON_DEMAND_RESOURCES = YES`.
+
+2. **Add resources and assign tags** — Add files (images, data files, etc.) to your Xcode project's Resources build phase. Select each file in Xcode, open the File Inspector, and add one or more tags under "On Demand Resource Tags".
+
+3. **Register tags** — Xcode does this automatically when you assign tags through the UI. You'll see them listed in your project's attributes under `KnownAssetTags`.
+
+4. **Debug builds** — When running from the command line (e.g. `yarn ios`), Xcode's local asset server isn't available. Set `EMBED_ASSET_PACKS_IN_PRODUCT_BUNDLE = YES` in your Debug build settings so ODR assets are embedded directly in the app bundle during development.
+
+Multiple resources can share the same tag. When you download a tag, iOS fetches all resources with that tag together.
+
+## Android Setup
+
+Android uses [Play Asset Delivery](https://developer.android.com/guide/playcore/asset-delivery) (PAD) to deliver assets on demand. Each iOS "tag" maps to an Android "asset pack".
+
+### 1. Add the PAD dependency
+
+In your app's `android/app/build.gradle`:
+
+```groovy
+dependencies {
+    implementation("com.google.android.play:asset-delivery:2.3.0")
+}
+```
+
+### 2. Create an asset pack module
+
+For each tag (e.g. `kichilogo`), create a directory at `android/kichilogo/` with this structure:
+
+```
+android/kichilogo/
+├── build.gradle
+└── src/main/assets/
+    └── your_file.png
+```
+
+`android/kichilogo/build.gradle`:
+```groovy
+apply plugin: 'com.android.asset-pack'
+
+assetPack {
+    packName = "kichilogo"
+    dynamicDelivery {
+        deliveryType = "on-demand"
+    }
+}
+```
+
+### 3. Wire up Gradle
+
+In `android/settings.gradle`, add:
+```groovy
+include ':kichilogo'
+```
+
+In `android/app/build.gradle`, inside the `android {}` block, add:
+```groovy
+assetPacks = [":kichilogo"]
+```
+
+### 4. Local testing
+
+On-demand asset packs are **not included** in a regular `./gradlew installDebug` APK. There is no Android equivalent to iOS's `EMBED_ASSET_PACKS_IN_PRODUCT_BUNDLE`. To test locally, use `bundletool` with the `--local-testing` flag, which tells the Play Core library to serve on-demand packs from the device's local storage instead of the Play Store.
+
+Install `bundletool`:
+```bash
+brew install bundletool
+```
+
+Build and install:
+```bash
+cd android
+
+# 1. Build an AAB (Android App Bundle)
+./gradlew bundleDebug
+
+# 2. Convert to APKs with --local-testing
+bundletool build-apks \
+  --bundle=app/build/outputs/bundle/debug/app-debug.aab \
+  --output=app.apks \
+  --local-testing
+
+# 3. Install on device/emulator
+bundletool install-apks --apks=app.apks
+```
+
+The `AssetPackManager` API works normally — `fetch()` will "download" instantly from the local copy.
+
+> **Note:** You need to re-run these steps whenever you change assets or native code. JS-only changes still work with Metro hot reload after the initial install.
+
+## Usage
+
+```js
+import {
+  checkResourcesAvailable,
+  downloadResources,
+  endAccessingResources,
+  getResourcePath,
+  setPreservationPriority,
+} from 'react-native-dynamic-resource-loader';
+```
+
+### Download resources and get file paths
+
+```js
+// Download all resources tagged "level1"
+const success = await downloadResources(['level1']);
+
+// Look up individual files by name (you know which files you tagged)
+const spritePath = await getResourcePath('enemy_sprite', 'png');
+const mapPath = await getResourcePath('level_map', 'json');
+```
+
+### Check if resources are already cached
+
+```js
+const available = await checkResourcesAvailable(['level1']);
+if (!available) {
+  await downloadResources(['level1']);
+}
+```
+
+### Release resources when done
+
+Tell the OS it can purge these resources when storage is low (on Android, removes the asset pack):
+
+```js
+endAccessingResources(['level1']);
+```
+
+### Set preservation priority
+
+Control which resources iOS purges first (0.0 = purge first, 1.0 = keep longest). No-op on Android:
+
+```js
+setPreservationPriority(0.8, ['level1']);
+```
+
+## API
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `downloadResources(tags)` | `Promise<boolean>` | Download resources for the given tags. Checks cache first. |
+| `checkResourcesAvailable(tags)` | `Promise<boolean>` | Check if tagged resources are already on device without downloading. |
+| `endAccessingResources(tags)` | `void` | Release resources so the OS can purge them (iOS) or remove the pack (Android). |
+| `getResourcePath(name, type)` | `Promise<string>` | Get the absolute file path for a resource after download. |
+| `setPreservationPriority(priority, tags)` | `void` | Set purge priority (0.0-1.0). iOS only; no-op on Android. |
+
+## Full Example
+
+```js
+import { useEffect, useState } from 'react';
+import {
+  downloadResources,
+  getResourcePath,
+  endAccessingResources,
+} from 'react-native-dynamic-resource-loader';
+
+function MyComponent() {
+  const [imagePath, setImagePath] = useState(null);
+
+  useEffect(() => {
+    let mounted = true;
+
+    downloadResources(['avatars'])
+      .then(() => getResourcePath('profile_pic', 'png'))
+      .then((path) => {
+        if (mounted) setImagePath(path);
+      })
+      .catch((e) => console.log('ODR failed:', e.message));
+
+    return () => {
+      mounted = false;
+      endAccessingResources(['avatars']);
+    };
+  }, []);
+
+  return imagePath ? <Image source={{ uri: `file://${imagePath}` }} /> : null;
+}
+```
+
+## Contributing
+
+- [Development workflow](CONTRIBUTING.md#development-workflow)
+- [Sending a pull request](CONTRIBUTING.md#sending-a-pull-request)
+- [Code of conduct](CODE_OF_CONDUCT.md)
+
+## License
+
+MIT
+
+---
+
+Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)

package/android/build.gradle

@@ -0,0 +1,68 @@
+buildscript {
+  ext.DynamicResourceLoader = [
+    kotlinVersion: "2.0.21",
+    minSdkVersion: 24,
+    compileSdkVersion: 36,
+    targetSdkVersion: 36
+  ]
+
+  ext.getExtOrDefault = { prop ->
+    if (rootProject.ext.has(prop)) {
+      return rootProject.ext.get(prop)
+    }
+
+    return DynamicResourceLoader[prop]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+apply plugin: "com.facebook.react"
+
+android {
+  namespace "com.dynamicresourceloader"
+
+  compileSdkVersion getExtOrDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrDefault("minSdkVersion")
+    targetSdkVersion getExtOrDefault("targetSdkVersion")
+  }
+
+  buildFeatures {
+    buildConfig true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lint {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+}
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "com.google.android.play:asset-delivery:2.3.0"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/java/com/dynamicresourceloader/DynamicResourceLoaderModule.kt

@@ -0,0 +1,154 @@
+package com.dynamicresourceloader
+
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReadableArray
+import com.google.android.play.core.assetpacks.AssetPackManager
+import com.google.android.play.core.assetpacks.AssetPackManagerFactory
+import com.google.android.play.core.assetpacks.AssetPackState
+import com.google.android.play.core.assetpacks.AssetPackStateUpdateListener
+import com.google.android.play.core.assetpacks.AssetPackStates
+import com.google.android.play.core.assetpacks.model.AssetPackStatus
+import java.io.File
+
+class DynamicResourceLoaderModule(reactContext: ReactApplicationContext) :
+  NativeDynamicResourceLoaderSpec(reactContext) {
+
+  private val assetPackManager: AssetPackManager =
+    AssetPackManagerFactory.getInstance(reactContext)
+
+  private fun emitProgress(tag: String, bytesDownloaded: Long, totalBytes: Long, fraction: Double, status: String) {
+    emitOnDownloadProgress(Arguments.createMap().apply {
+      putString("tag", tag)
+      putDouble("bytesDownloaded", bytesDownloaded.toDouble())
+      putDouble("totalBytes", totalBytes.toDouble())
+      putDouble("fractionCompleted", fraction)
+      putString("status", status)
+    })
+  }
+
+  private fun ReadableArray.toStringList(): List<String> {
+    val list = mutableListOf<String>()
+    for (i in 0 until size()) {
+      getString(i)?.let { list.add(it) }
+    }
+    return list
+  }
+
+  override fun checkResourcesAvailable(tags: ReadableArray, promise: Promise) {
+    val packNames = tags.toStringList()
+    assetPackManager.getPackStates(packNames)
+      .addOnSuccessListener { states: AssetPackStates ->
+        val allCompleted = packNames.all { name ->
+          states.packStates()[name]?.status() == AssetPackStatus.COMPLETED
+        }
+        promise.resolve(allCompleted)
+      }
+      .addOnFailureListener { e ->
+        promise.reject("ERR_CHECK_RESOURCES", e.message, e)
+      }
+  }
+
+  override fun downloadResources(tags: ReadableArray, promise: Promise) {
+    val packNames = tags.toStringList()
+
+    assetPackManager.getPackStates(packNames)
+      .addOnSuccessListener { states: AssetPackStates ->
+        val allCompleted = packNames.all { name ->
+          states.packStates()[name]?.status() == AssetPackStatus.COMPLETED
+        }
+        if (allCompleted) {
+          for (name in packNames) {
+            emitProgress(name, 1, 1, 1.0, "completed")
+          }
+          promise.resolve(true)
+          return@addOnSuccessListener
+        }
+
+        val pending = packNames.filter { name ->
+          states.packStates()[name]?.status() != AssetPackStatus.COMPLETED
+        }.toMutableSet()
+        var settled = false
+
+        val listener = object : AssetPackStateUpdateListener {
+          override fun onStateUpdate(state: AssetPackState) {
+            if (settled) return
+
+            val name = state.name()
+            val bytesDownloaded = state.bytesDownloaded()
+            val totalBytes = state.totalBytesToDownload()
+            val fraction = if (totalBytes > 0) bytesDownloaded.toDouble() / totalBytes.toDouble() else 0.0
+
+            when (state.status()) {
+              AssetPackStatus.DOWNLOADING, AssetPackStatus.TRANSFERRING -> {
+                emitProgress(name, bytesDownloaded, totalBytes, fraction, "downloading")
+              }
+              AssetPackStatus.WAITING_FOR_WIFI -> {
+                emitProgress(name, bytesDownloaded, totalBytes, fraction, "waiting")
+              }
+              AssetPackStatus.COMPLETED -> {
+                emitProgress(name, totalBytes, totalBytes, 1.0, "completed")
+                pending.remove(name)
+                if (pending.isEmpty()) {
+                  settled = true
+                  assetPackManager.unregisterListener(this)
+                  promise.resolve(true)
+                }
+              }
+              AssetPackStatus.FAILED -> {
+                emitProgress(name, bytesDownloaded, totalBytes, fraction, "failed")
+                settled = true
+                assetPackManager.unregisterListener(this)
+                promise.reject(
+                  "ERR_DOWNLOAD_FAILED",
+                  "Asset pack '$name' failed with error code ${state.errorCode()}"
+                )
+              }
+              AssetPackStatus.REQUIRES_USER_CONFIRMATION -> {
+                settled = true
+                assetPackManager.unregisterListener(this)
+                promise.reject(
+                  "ERR_REQUIRES_USER_CONFIRMATION",
+                  "Asset pack '$name' requires user confirmation"
+                )
+              }
+            }
+          }
+        }
+
+        assetPackManager.registerListener(listener)
+        assetPackManager.fetch(packNames)
+      }
+      .addOnFailureListener { e ->
+        promise.reject("ERR_DOWNLOAD_RESOURCES", e.message, e)
+      }
+  }
+
+  override fun endAccessingResources(tags: ReadableArray) {
+    val packNames = tags.toStringList()
+    for (name in packNames) {
+      assetPackManager.removePack(name)
+    }
+  }
+
+  override fun getResourcePath(resourceName: String, ofType: String, promise: Promise) {
+    val locations = assetPackManager.packLocations
+    for ((_, location) in locations) {
+      val file = File(location.assetsPath(), "$resourceName.$ofType")
+      if (file.exists()) {
+        promise.resolve(file.absolutePath)
+        return
+      }
+    }
+    promise.reject("RESOURCE_NOT_FOUND", "Could not find $resourceName.$ofType in any asset pack")
+  }
+
+  override fun setPreservationPriority(priority: Double, tags: ReadableArray) {
+    // No-op on Android — Play Asset Delivery has no preservation priority equivalent
+  }
+
+  companion object {
+    const val NAME = NativeDynamicResourceLoaderSpec.NAME
+  }
+}

package/android/src/main/java/com/dynamicresourceloader/DynamicResourceLoaderPackage.kt

@@ -0,0 +1,31 @@
+package com.dynamicresourceloader
+
+import com.facebook.react.BaseReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+import java.util.HashMap
+
+class DynamicResourceLoaderPackage : BaseReactPackage() {
+  override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? {
+    return if (name == DynamicResourceLoaderModule.NAME) {
+      DynamicResourceLoaderModule(reactContext)
+    } else {
+      null
+    }
+  }
+
+  override fun getReactModuleInfoProvider() = ReactModuleInfoProvider {
+    mapOf(
+      DynamicResourceLoaderModule.NAME to ReactModuleInfo(
+        name = DynamicResourceLoaderModule.NAME,
+        className = DynamicResourceLoaderModule.NAME,
+        canOverrideExistingModule = false,
+        needsEagerInit = false,
+        isCxxModule = false,
+        isTurboModule = true
+      )
+    )
+  }
+}

package/ios/DynamicResourceLoader.h

@@ -0,0 +1,5 @@
+#import <DynamicResourceLoaderSpec/DynamicResourceLoaderSpec.h>
+
+@interface DynamicResourceLoader : NativeDynamicResourceLoaderSpecBase <NativeDynamicResourceLoaderSpec>
+
+@end

package/ios/DynamicResourceLoader.mm

@@ -0,0 +1,83 @@
+#import "DynamicResourceLoader.h"
+#import <DynamicResourceLoader-Swift.h>
+
+@implementation DynamicResourceLoader {
+  DynamicResourceLoaderImpl *_impl;
+}
+
+- (instancetype)init {
+  self = [super init];
+  if (self) {
+    _impl = [[DynamicResourceLoaderImpl alloc] init];
+  }
+  return self;
+}
+
+- (void)checkResourcesAvailable:(NSArray<NSString *> *)tags
+                        resolve:(RCTPromiseResolveBlock)resolve
+                         reject:(RCTPromiseRejectBlock)reject {
+  [_impl checkResourcesAvailable:tags
+                         resolve:^(BOOL available) {
+    resolve(@(available));
+  }
+                          reject:^(NSString *code, NSString *message, NSError *error) {
+    reject(code, message, error);
+  }];
+}
+
+- (void)downloadResources:(NSArray<NSString *> *)tags
+                  resolve:(RCTPromiseResolveBlock)resolve
+                   reject:(RCTPromiseRejectBlock)reject {
+  [_impl downloadResources:tags
+                  progress:^(NSString *tag, int64_t bytesDownloaded, int64_t totalBytes, double fractionCompleted, NSString *status) {
+    [self emitOnDownloadProgress:@{
+      @"tag": tag,
+      @"bytesDownloaded": @(bytesDownloaded),
+      @"totalBytes": @(totalBytes),
+      @"fractionCompleted": @(fractionCompleted),
+      @"status": status,
+    }];
+  }
+                   resolve:^(BOOL success) {
+    resolve(@(success));
+  }
+                    reject:^(NSString *code, NSString *message, NSError *error) {
+    reject(code, message, error);
+  }];
+}
+
+- (void)endAccessingResources:(NSArray<NSString *> *)tags {
+  [_impl endAccessingResources:tags];
+}
+
+- (void)getResourcePath:(NSString *)resourceName
+                 ofType:(NSString *)ofType
+                resolve:(RCTPromiseResolveBlock)resolve
+                 reject:(RCTPromiseRejectBlock)reject {
+  [_impl getResourcePath:resourceName
+                  ofType:ofType
+                 resolve:^(NSString *path) {
+    resolve(path);
+  }
+                  reject:^(NSString *code, NSString *message, NSError *error) {
+    reject(code, message, error);
+  }];
+}
+
+- (void)setPreservationPriority:(double)priority
+                           tags:(NSArray<NSString *> *)tags {
+  [_impl setPreservationPriority:priority forTags:tags];
+}
+
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params
+{
+    return std::make_shared<facebook::react::NativeDynamicResourceLoaderSpecJSI>(params);
+}
+
++ (NSString *)moduleName
+{
+  return @"DynamicResourceLoader";
+}
+
+@end

package/ios/DynamicResourceLoaderImpl.swift

@@ -0,0 +1,110 @@
+import Foundation
+
+@objcMembers
+public class DynamicResourceLoaderImpl: NSObject {
+  private var activeRequests: [String: NSBundleResourceRequest] = [:]
+  private var progressObservations: [String: NSKeyValueObservation] = [:]
+
+  private func requestKey(for tags: [String]) -> String {
+    return tags.sorted().joined(separator: ",")
+  }
+
+  public func checkResourcesAvailable(
+    _ tags: [String],
+    resolve: @escaping (Bool) -> Void,
+    reject: @escaping (String, String, NSError) -> Void
+  ) {
+    let tagSet = Set(tags)
+    let request = NSBundleResourceRequest(tags: tagSet)
+
+    request.conditionallyBeginAccessingResources { available in
+      if available {
+        request.endAccessingResources()
+      }
+      resolve(available)
+    }
+  }
+
+  public func downloadResources(
+    _ tags: [String],
+    progress progressCallback: ((String, Int64, Int64, Double, String) -> Void)?,
+    resolve: @escaping (Bool) -> Void,
+    reject: @escaping (String, String, NSError) -> Void
+  ) {
+    let key = requestKey(for: tags)
+    let tagSet = Set(tags)
+    let request = NSBundleResourceRequest(tags: tagSet)
+
+    request.conditionallyBeginAccessingResources { [weak self] available in
+      if available {
+        self?.activeRequests[key] = request
+        for tag in tags {
+          progressCallback?(tag, 1, 1, 1.0, "completed")
+        }
+        resolve(true)
+        return
+      }
+
+      if let progressCallback = progressCallback {
+        let observation = request.progress.observe(\.fractionCompleted) { progress, _ in
+          for tag in tags {
+            progressCallback(
+              tag,
+              progress.completedUnitCount,
+              progress.totalUnitCount,
+              progress.fractionCompleted,
+              "downloading"
+            )
+          }
+        }
+        self?.progressObservations[key] = observation
+      }
+
+      request.beginAccessingResources { [weak self] error in
+        self?.progressObservations.removeValue(forKey: key)
+        if let error = error as NSError? {
+          for tag in tags {
+            progressCallback?(tag, 0, 0, 0.0, "failed")
+          }
+          reject("DOWNLOAD_FAILED", error.localizedDescription, error)
+          return
+        }
+        self?.activeRequests[key] = request
+        for tag in tags {
+          progressCallback?(tag, 1, 1, 1.0, "completed")
+        }
+        resolve(true)
+      }
+    }
+  }
+
+  public func endAccessingResources(_ tags: [String]) {
+    let key = requestKey(for: tags)
+    guard let request = activeRequests[key] else { return }
+    request.endAccessingResources()
+    activeRequests.removeValue(forKey: key)
+  }
+
+  public func getResourcePath(
+    _ resourceName: String,
+    ofType type: String,
+    resolve: @escaping (String) -> Void,
+    reject: @escaping (String, String, NSError) -> Void
+  ) {
+    if let path = Bundle.main.path(forResource: resourceName, ofType: type) {
+      resolve(path)
+    } else {
+      let error = NSError(
+        domain: "DynamicResourceLoader",
+        code: 1,
+        userInfo: [NSLocalizedDescriptionKey: "Resource '\(resourceName).\(type)' not found"]
+      )
+      reject("RESOURCE_NOT_FOUND", error.localizedDescription, error)
+    }
+  }
+
+  public func setPreservationPriority(_ priority: Double, forTags tags: [String]) {
+    let tagSet = Set(tags)
+    Bundle.main.setPreservationPriority(priority, forTags: tagSet)
+  }
+}

package/lib/module/NativeDynamicResourceLoader.js

@@ -0,0 +1,5 @@
+"use strict";
+
+import { TurboModuleRegistry } from 'react-native';
+export default TurboModuleRegistry.getEnforcing('DynamicResourceLoader');
+//# sourceMappingURL=NativeDynamicResourceLoader.js.map

package/lib/module/NativeDynamicResourceLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../src","sources":["NativeDynamicResourceLoader.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAA0B,cAAc;AAoBpE,eAAeA,mBAAmB,CAACC,YAAY,CAAO,uBAAuB,CAAC","ignoreList":[]}

package/lib/module/codegen-types.d.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=codegen-types.d.js.map

package/lib/module/codegen-types.d.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../src","sources":["codegen-types.d.ts"],"mappings":"","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,22 @@
+"use strict";
+
+import DynamicResourceLoader from "./NativeDynamicResourceLoader.js";
+export function checkResourcesAvailable(tags) {
+  return DynamicResourceLoader.checkResourcesAvailable(tags);
+}
+export function downloadResources(tags) {
+  return DynamicResourceLoader.downloadResources(tags);
+}
+export function endAccessingResources(tags) {
+  DynamicResourceLoader.endAccessingResources(tags);
+}
+export function getResourcePath(resourceName, ofType) {
+  return DynamicResourceLoader.getResourcePath(resourceName, ofType);
+}
+export function setPreservationPriority(priority, tags) {
+  DynamicResourceLoader.setPreservationPriority(priority, tags);
+}
+export function onDownloadProgress(handler) {
+  return DynamicResourceLoader.onDownloadProgress(handler);
+}
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DynamicResourceLoader","checkResourcesAvailable","tags","downloadResources","endAccessingResources","getResourcePath","resourceName","ofType","setPreservationPriority","priority","onDownloadProgress","handler"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,OAAOA,qBAAqB,MAAM,kCAA+B;AAKjE,OAAO,SAASC,uBAAuBA,CACrCC,IAA2B,EACT;EAClB,OAAOF,qBAAqB,CAACC,uBAAuB,CAACC,IAAI,CAAC;AAC5D;AAEA,OAAO,SAASC,iBAAiBA,CAC/BD,IAA2B,EACT;EAClB,OAAOF,qBAAqB,CAACG,iBAAiB,CAACD,IAAI,CAAC;AACtD;AAEA,OAAO,SAASE,qBAAqBA,CAACF,IAA2B,EAAQ;EACvEF,qBAAqB,CAACI,qBAAqB,CAACF,IAAI,CAAC;AACnD;AAEA,OAAO,SAASG,eAAeA,CAC7BC,YAAoB,EACpBC,MAAc,EACG;EACjB,OAAOP,qBAAqB,CAACK,eAAe,CAACC,YAAY,EAAEC,MAAM,CAAC;AACpE;AAEA,OAAO,SAASC,uBAAuBA,CACrCC,QAAgB,EAChBP,IAA2B,EACrB;EACNF,qBAAqB,CAACQ,uBAAuB,CAACC,QAAQ,EAAEP,IAAI,CAAC;AAC/D;AAEA,OAAO,SAASQ,kBAAkBA,CAChCC,OAA+C,EAC/C;EACA,OAAOX,qBAAqB,CAACU,kBAAkB,CAACC,OAAO,CAAC;AAC1D","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/src/NativeDynamicResourceLoader.d.ts

@@ -0,0 +1,20 @@
+import { type TurboModule } from 'react-native';
+import type { EventEmitter } from 'react-native/Libraries/Types/CodegenTypes';
+export type DownloadProgressEvent = {
+    tag: string;
+    bytesDownloaded: number;
+    totalBytes: number;
+    fractionCompleted: number;
+    status: string;
+};
+export interface Spec extends TurboModule {
+    checkResourcesAvailable(tags: ReadonlyArray<string>): Promise<boolean>;
+    downloadResources(tags: ReadonlyArray<string>): Promise<boolean>;
+    endAccessingResources(tags: ReadonlyArray<string>): void;
+    getResourcePath(resourceName: string, ofType: string): Promise<string>;
+    setPreservationPriority(priority: number, tags: ReadonlyArray<string>): void;
+    readonly onDownloadProgress: EventEmitter<DownloadProgressEvent>;
+}
+declare const _default: Spec;
+export default _default;
+//# sourceMappingURL=NativeDynamicResourceLoader.d.ts.map

package/lib/typescript/src/NativeDynamicResourceLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeDynamicResourceLoader.d.ts","sourceRoot":"","sources":["../../../src/NativeDynamicResourceLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAE9E,MAAM,MAAM,qBAAqB,GAAG;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,uBAAuB,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvE,iBAAiB,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjE,qBAAqB,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACzD,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvE,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC7E,QAAQ,CAAC,kBAAkB,EAAE,YAAY,CAAC,qBAAqB,CAAC,CAAC;CAClE;;AAED,wBAA+E"}

package/lib/typescript/src/index.d.ts

@@ -0,0 +1,9 @@
+import type { DownloadProgressEvent } from './NativeDynamicResourceLoader';
+export type { DownloadProgressEvent };
+export declare function checkResourcesAvailable(tags: ReadonlyArray<string>): Promise<boolean>;
+export declare function downloadResources(tags: ReadonlyArray<string>): Promise<boolean>;
+export declare function endAccessingResources(tags: ReadonlyArray<string>): void;
+export declare function getResourcePath(resourceName: string, ofType: string): Promise<string>;
+export declare function setPreservationPriority(priority: number, tags: ReadonlyArray<string>): void;
+export declare function onDownloadProgress(handler: (event: DownloadProgressEvent) => void): import("react-native").EventSubscription;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,YAAY,EAAE,qBAAqB,EAAE,CAAC;AAEtC,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAC1B,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAC1B,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,CAEvE;AAED,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAC1B,IAAI,CAEN;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,4CAGhD"}

package/package.json

@@ -0,0 +1,169 @@
+{
+  "name": "react-native-dynamic-resource-loader",
+  "version": "0.2.0",
+  "description": "Load dynamic files from the App and Play stores",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace react-native-dynamic-resource-loader-example",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "test": "jest",
+    "release": "release-it --only-version"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Rob117//react-native-dynamic-resource-loader.git"
+  },
+  "author": "Robert Sherling <5183016+Rob117@users.noreply.github.com> (https://github.com/Rob117/)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Rob117//react-native-dynamic-resource-loader/issues"
+  },
+  "homepage": "https://github.com/Rob117//react-native-dynamic-resource-loader#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@react-native/babel-preset": "0.83.0",
+    "@react-native/eslint-config": "0.83.0",
+    "@release-it/conventional-changelog": "^10.0.1",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^19.2.0",
+    "commitlint": "^19.8.1",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jest": "^29.7.0",
+    "lefthook": "^2.0.3",
+    "prettier": "^2.8.8",
+    "react": "19.2.0",
+    "react-native": "0.83.0",
+    "react-native-builder-bob": "^0.40.18",
+    "release-it": "^19.0.4",
+    "turbo": "^2.5.6",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "codegenConfig": {
+    "name": "DynamicResourceLoaderSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.dynamicresourceloader"
+    }
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "create-react-native-library": {
+    "type": "turbo-module",
+    "languages": "kotlin-objc",
+    "tools": [
+      "eslint",
+      "jest",
+      "lefthook",
+      "release-it"
+    ],
+    "version": "0.57.1"
+  }
+}

package/src/NativeDynamicResourceLoader.ts

@@ -0,0 +1,21 @@
+import { TurboModuleRegistry, type TurboModule } from 'react-native';
+import type { EventEmitter } from 'react-native/Libraries/Types/CodegenTypes';
+
+export type DownloadProgressEvent = {
+  tag: string;
+  bytesDownloaded: number;
+  totalBytes: number;
+  fractionCompleted: number;
+  status: string;
+};
+
+export interface Spec extends TurboModule {
+  checkResourcesAvailable(tags: ReadonlyArray<string>): Promise<boolean>;
+  downloadResources(tags: ReadonlyArray<string>): Promise<boolean>;
+  endAccessingResources(tags: ReadonlyArray<string>): void;
+  getResourcePath(resourceName: string, ofType: string): Promise<string>;
+  setPreservationPriority(priority: number, tags: ReadonlyArray<string>): void;
+  readonly onDownloadProgress: EventEmitter<DownloadProgressEvent>;
+}
+
+export default TurboModuleRegistry.getEnforcing<Spec>('DynamicResourceLoader');

package/src/codegen-types.d.ts

@@ -0,0 +1,9 @@
+// Type declarations for react-native codegen types that are blocked
+// by the react-native-strict-api custom condition in tsconfig.json.
+declare module 'react-native/Libraries/Types/CodegenTypes' {
+  import type { EventSubscription } from 'react-native';
+
+  export type EventEmitter<T> = (
+    handler: (event: T) => void | Promise<void>
+  ) => EventSubscription;
+}

package/src/index.tsx

@@ -0,0 +1,40 @@
+import DynamicResourceLoader from './NativeDynamicResourceLoader';
+import type { DownloadProgressEvent } from './NativeDynamicResourceLoader';
+
+export type { DownloadProgressEvent };
+
+export function checkResourcesAvailable(
+  tags: ReadonlyArray<string>
+): Promise<boolean> {
+  return DynamicResourceLoader.checkResourcesAvailable(tags);
+}
+
+export function downloadResources(
+  tags: ReadonlyArray<string>
+): Promise<boolean> {
+  return DynamicResourceLoader.downloadResources(tags);
+}
+
+export function endAccessingResources(tags: ReadonlyArray<string>): void {
+  DynamicResourceLoader.endAccessingResources(tags);
+}
+
+export function getResourcePath(
+  resourceName: string,
+  ofType: string
+): Promise<string> {
+  return DynamicResourceLoader.getResourcePath(resourceName, ofType);
+}
+
+export function setPreservationPriority(
+  priority: number,
+  tags: ReadonlyArray<string>
+): void {
+  DynamicResourceLoader.setPreservationPriority(priority, tags);
+}
+
+export function onDownloadProgress(
+  handler: (event: DownloadProgressEvent) => void
+) {
+  return DynamicResourceLoader.onDownloadProgress(handler);
+}