@oxy.so/services 13.7.0 → 13.8.0

package/lib/module/ui/utils/nativeAssetFiles.native.js

@@ -0,0 +1,197 @@
+"use strict";
+
+// File.slice() reads the WHOLE file on Expo; RN Blob does the same on Java's
+// heap. FileHandle reads and native file uploads keep both heaps bounded.
+const COPY_CHUNK_BYTES = 1024 * 1024;
+let partsDirectory;
+let nextPart = 0;
+let nextHash = 0;
+// FileHandle methods are synchronous: awaiting them alone only yields a
+// microtask. Let rendering, native events and abort timers run between chunks.
+function yieldToEventLoop() {
+  return new Promise(resolve => setTimeout(resolve, 0));
+}
+function abortError() {
+  const error = new Error('Upload aborted');
+  error.name = 'AbortError';
+  return error;
+}
+function checkAbort(signal) {
+  if (signal?.aborted) throw abortError();
+}
+async function temporaryParts() {
+  partsDirectory ??= import('expo-file-system').then(({
+    Directory,
+    Paths
+  }) => {
+    const directory = new Directory(Paths.cache, 'oxy-upload-parts');
+    // These are foreground transfers. A new JS runtime owns no previous parts;
+    // remove leftovers from a killed process before creating any new part.
+    if (directory.exists) directory.delete();
+    directory.create({
+      intermediates: true
+    });
+    return directory;
+  }).catch(error => {
+    partsDirectory = undefined;
+    throw error;
+  });
+  return partsDirectory;
+}
+async function copyRange(file, target, start, end, signal) {
+  const reader = file.open();
+  try {
+    reader.offset = start;
+    const writer = target.open();
+    try {
+      for (let offset = start; offset < end;) {
+        checkAbort(signal);
+        const bytes = await reader.readBytes(Math.min(COPY_CHUNK_BYTES, end - offset));
+        if (!bytes.length) throw new Error('File changed while preparing upload');
+        await writer.writeBytes(bytes);
+        offset += bytes.length;
+        await yieldToEventLoop();
+      }
+    } finally {
+      writer.close();
+    }
+  } finally {
+    reader.close();
+  }
+}
+async function putRange(file, request) {
+  const [{
+    File
+  }, legacy, directory] = await Promise.all([import('expo-file-system'), import('expo-file-system/legacy'), temporaryParts()]);
+  checkAbort(request.signal);
+  const part = new File(directory, `part-${++nextPart}`);
+  part.create();
+  try {
+    await copyRange(file, part, request.start, request.end, request.signal);
+    checkAbort(request.signal);
+    const task = legacy.createUploadTask(request.url, part.uri, {
+      httpMethod: 'PUT',
+      uploadType: legacy.FileSystemUploadType.BINARY_CONTENT,
+      sessionType: legacy.FileSystemSessionType.FOREGROUND,
+      headers: {}
+    }, ({
+      totalBytesSent
+    }) => request.onProgress(totalBytesSent));
+    let cancel;
+    let stop = () => {};
+    const interrupted = new Promise((_resolve, reject) => {
+      stop = () => {
+        cancel ??= task.cancelAsync();
+        void cancel.catch(() => undefined);
+        reject(abortError());
+      };
+    });
+    const timer = setTimeout(() => {
+      stop();
+    }, request.timeoutMs);
+    request.signal?.addEventListener('abort', stop, {
+      once: true
+    });
+    try {
+      checkAbort(request.signal);
+      const result = await Promise.race([task.uploadAsync(), interrupted]);
+      if (!result) throw abortError();
+      return result.status >= 200 && result.status < 300 ? {
+        ok: true
+      } : {
+        ok: false,
+        status: result.status
+      };
+    } catch {
+      if (request.signal?.aborted) throw abortError();
+      // The core session owner applies its bounded retry/backoff policy.
+      return {
+        ok: false,
+        status: 0
+      };
+    } finally {
+      clearTimeout(timer);
+      request.signal?.removeEventListener('abort', stop);
+      if (cancel) await cancel.catch(() => undefined);
+    }
+  } finally {
+    if (part.exists) part.delete();
+  }
+}
+async function openNativeFile(uri) {
+  const {
+    File
+  } = await import('expo-file-system');
+  let nativeHasher = null;
+  try {
+    const {
+      requireOptionalNativeModule
+    } = await import('expo-modules-core');
+    nativeHasher = requireOptionalNativeModule('OxyAssetFiles');
+  } catch {
+    // Hosts without the optional Expo module bridge retain bounded file access.
+  }
+  const file = new File(uri);
+  if (!file.exists) throw new Error('Native upload file is unavailable');
+  const size = file.size;
+  return {
+    size,
+    // Older native binaries can still use bounded JS reads after an OTA. New
+    // binaries hash entirely on a native worker, without sending bytes to JS.
+    hash: nativeHasher ? async (onProgress, signal) => {
+      checkAbort(signal);
+      if (file.size !== size) throw new Error('File changed while hashing');
+      const id = `upload-hash-${++nextHash}`;
+      const listener = nativeHasher.addListener('hashProgress', event => {
+        if (event.id === id && !signal?.aborted) onProgress?.(event.loaded);
+      });
+      const stop = () => nativeHasher.cancelHash(id);
+      try {
+        nativeHasher.createHash(id);
+        signal?.addEventListener('abort', stop, {
+          once: true
+        });
+        if (signal?.aborted) stop();
+        const digest = await nativeHasher.hashAsync(id, uri, size);
+        checkAbort(signal);
+        return digest;
+      } catch (error) {
+        checkAbort(signal);
+        throw error;
+      } finally {
+        signal?.removeEventListener('abort', stop);
+        listener.remove();
+      }
+    } : undefined,
+    async readRange(start, end) {
+      if (file.size !== size) throw new Error('File changed while uploading');
+      if (start < 0 || end > size || end < start) throw new Error('Invalid upload file range');
+      const reader = file.open();
+      try {
+        reader.offset = start;
+        const output = new Uint8Array(end - start);
+        let read = 0;
+        while (read < output.length) {
+          const bytes = await reader.readBytes(Math.min(COPY_CHUNK_BYTES, output.length - read));
+          if (!bytes.length) throw new Error('File changed while hashing');
+          output.set(bytes, read);
+          read += bytes.length;
+          await yieldToEventLoop();
+        }
+        return output;
+      } finally {
+        reader.close();
+      }
+    },
+    putPart: request => {
+      if (file.size !== size) throw new Error('File changed while uploading');
+      return putRange(file, request);
+    }
+  };
+}
+
+/** One provider-owned adapter; no native filesystem module loads before an upload. */
+export function installNativeAssetFiles(oxy) {
+  return oxy.assets.installFileAdapter(openNativeFile);
+}
+//# sourceMappingURL=nativeAssetFiles.native.js.map

package/lib/module/ui/utils/nativeAssetFiles.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["COPY_CHUNK_BYTES","partsDirectory","nextPart","nextHash","yieldToEventLoop","Promise","resolve","setTimeout","abortError","error","Error","name","checkAbort","signal","aborted","temporaryParts","then","Directory","Paths","directory","cache","exists","delete","create","intermediates","catch","undefined","copyRange","file","target","start","end","reader","open","offset","writer","bytes","readBytes","Math","min","length","writeBytes","close","putRange","request","File","legacy","all","part","task","createUploadTask","url","uri","httpMethod","uploadType","FileSystemUploadType","BINARY_CONTENT","sessionType","FileSystemSessionType","FOREGROUND","headers","totalBytesSent","onProgress","cancel","stop","interrupted","_resolve","reject","cancelAsync","timer","timeoutMs","addEventListener","once","result","race","uploadAsync","status","ok","clearTimeout","removeEventListener","openNativeFile","nativeHasher","requireOptionalNativeModule","size","hash","id","listener","addListener","event","loaded","cancelHash","createHash","digest","hashAsync","remove","readRange","output","Uint8Array","read","set","putPart","installNativeAssetFiles","oxy","assets","installFileAdapter"],"sourceRoot":"../../../../src","sources":["ui/utils/nativeAssetFiles.native.ts"],"mappings":"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","ignoreList":[]}

package/lib/typescript/commonjs/ui/context/OxyContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OxyContext.d.ts","sourceRoot":"","sources":["../../../../../src/ui/context/OxyContext.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAqG/B,OAAO,KAAK,EAAmB,uBAAuB,EAAe,MAAM,mBAAmB,CAAC;AAQ/F,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAOhG,OAAO,EACL,iBAAiB,EACjB,MAAM,EACN,cAAc,EACd,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAovDhE,CAAC"}
+{"version":3,"file":"OxyContext.d.ts","sourceRoot":"","sources":["../../../../../src/ui/context/OxyContext.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AA6G/B,OAAO,KAAK,EAAmB,uBAAuB,EAAe,MAAM,mBAAmB,CAAC;AAQ/F,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAOhG,OAAO,EACL,iBAAiB,EACjB,MAAM,EACN,cAAc,EACd,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAuvDhE,CAAC"}

package/lib/typescript/commonjs/ui/utils/nativeAssetFiles.d.ts

@@ -0,0 +1,4 @@
+import type { OxyServices } from '@oxy.so/core';
+/** Web/Node use their existing Blob transport. Metro selects the native adapter. */
+export declare function installNativeAssetFiles(_oxy: OxyServices): undefined;
+//# sourceMappingURL=nativeAssetFiles.d.ts.map

package/lib/typescript/commonjs/ui/utils/nativeAssetFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeAssetFiles.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/nativeAssetFiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,oFAAoF;AACpF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,CAEpE"}

package/lib/typescript/commonjs/ui/utils/nativeAssetFiles.macos.d.ts

@@ -0,0 +1,4 @@
+import type { OxyServices } from '@oxy.so/core';
+/** Web/Node use their existing Blob transport. Metro selects the native adapter. */
+export declare function installNativeAssetFiles(_oxy: OxyServices): undefined;
+//# sourceMappingURL=nativeAssetFiles.macos.d.ts.map

package/lib/typescript/commonjs/ui/utils/nativeAssetFiles.macos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeAssetFiles.macos.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/nativeAssetFiles.macos.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,oFAAoF;AACpF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,CAEpE"}

package/lib/typescript/commonjs/ui/utils/nativeAssetFiles.native.d.ts

@@ -0,0 +1,4 @@
+import type { OxyServices } from '@oxy.so/core';
+/** One provider-owned adapter; no native filesystem module loads before an upload. */
+export declare function installNativeAssetFiles(oxy: OxyServices): () => void;
+//# sourceMappingURL=nativeAssetFiles.native.d.ts.map

package/lib/typescript/commonjs/ui/utils/nativeAssetFiles.native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeAssetFiles.native.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/nativeAssetFiles.native.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAyC,WAAW,EAAE,MAAM,cAAc,CAAC;AAgNvF,sFAAsF;AACtF,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,IAAI,CAEpE"}

package/lib/typescript/module/ui/context/OxyContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OxyContext.d.ts","sourceRoot":"","sources":["../../../../../src/ui/context/OxyContext.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAqG/B,OAAO,KAAK,EAAmB,uBAAuB,EAAe,MAAM,sBAAmB,CAAC;AAQ/F,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,sBAAmB,CAAC;AAOhG,OAAO,EACL,iBAAiB,EACjB,MAAM,EACN,cAAc,EACd,uBAAuB,GACxB,MAAM,wBAAqB,CAAC;AAE7B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAovDhE,CAAC"}
+{"version":3,"file":"OxyContext.d.ts","sourceRoot":"","sources":["../../../../../src/ui/context/OxyContext.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AA6G/B,OAAO,KAAK,EAAmB,uBAAuB,EAAe,MAAM,sBAAmB,CAAC;AAQ/F,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,sBAAmB,CAAC;AAOhG,OAAO,EACL,iBAAiB,EACjB,MAAM,EACN,cAAc,EACd,uBAAuB,GACxB,MAAM,wBAAqB,CAAC;AAE7B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAuvDhE,CAAC"}

package/lib/typescript/module/ui/utils/nativeAssetFiles.d.ts

@@ -0,0 +1,4 @@
+import type { OxyServices } from '@oxy.so/core';
+/** Web/Node use their existing Blob transport. Metro selects the native adapter. */
+export declare function installNativeAssetFiles(_oxy: OxyServices): undefined;
+//# sourceMappingURL=nativeAssetFiles.d.ts.map

package/lib/typescript/module/ui/utils/nativeAssetFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeAssetFiles.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/nativeAssetFiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,oFAAoF;AACpF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,CAEpE"}

package/lib/typescript/module/ui/utils/nativeAssetFiles.macos.d.ts

@@ -0,0 +1,4 @@
+import type { OxyServices } from '@oxy.so/core';
+/** Web/Node use their existing Blob transport. Metro selects the native adapter. */
+export declare function installNativeAssetFiles(_oxy: OxyServices): undefined;
+//# sourceMappingURL=nativeAssetFiles.macos.d.ts.map

package/lib/typescript/module/ui/utils/nativeAssetFiles.macos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeAssetFiles.macos.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/nativeAssetFiles.macos.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,oFAAoF;AACpF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,CAEpE"}

package/lib/typescript/module/ui/utils/nativeAssetFiles.native.d.ts

@@ -0,0 +1,4 @@
+import type { OxyServices } from '@oxy.so/core';
+/** One provider-owned adapter; no native filesystem module loads before an upload. */
+export declare function installNativeAssetFiles(oxy: OxyServices): () => void;
+//# sourceMappingURL=nativeAssetFiles.native.d.ts.map

package/lib/typescript/module/ui/utils/nativeAssetFiles.native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeAssetFiles.native.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/nativeAssetFiles.native.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAyC,WAAW,EAAE,MAAM,cAAc,CAAC;AAgNvF,sFAAsF;AACtF,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,IAAI,CAEpE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxy.so/services",
-  "version": "13.7.0",
+  "version": "13.8.0",
   "description": "OxyHQ Expo/React Native SDK — UI components, screens, and native features",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -107,6 +107,7 @@
     "android/build.gradle",
     "android/src",
     "ios/OxyIdentityModule.swift",
+    "ios/OxyAssetFilesModule.swift",
     "ios/OxyIdentity.podspec",
     "plugins",
     "expo-module.config.json"
@@ -160,7 +161,7 @@
     "@commitlint/config-conventional": "^21.2.0",
     "@expo/app-integrity": "~58.0.2",
     "@expo/vector-icons": "^15.0.3",
-    "@oxy.so/core": "7.6.0",
+    "@oxy.so/core": "7.7.0",
     "@react-native-async-storage/async-storage": "^2.0.0",
     "@react-native-community/netinfo": "^12.0.1",
     "@react-native/babel-preset": "^0.88.0",
@@ -210,13 +211,13 @@
     "expo-video": "~58.0.12"
   },
   "//@oxy.so/bloom": "Bloom 11.1.0 adds the shared grouped sections, usage card, subscription plans, frame appearance and overlay navigation APIs used by this SDK. First-party Bloom peers remain open above this tested minimum.",
-  "//@oxy.so/core": "Core 7.6.0 forwards guest locale and first-touch campaign metadata through signup; 7.3.0 supplies `users.lookupMany`, with which the account members screen fails (and retries) a profile read whose chunk failed instead of caching those members as handle-less; 7.2.0 supplies `assets.cachedUrl`, with which `useFileDownloadUrl` answers an already-resolved URL in its first render; 6.16.0 supplies `requireServerVerdict` and `onHolderRejected`, with which the cold boot checks a session it painted from the cache; 6.13.0 supplies the `accounts.settings.*` strings (picture, categories) the account settings speak in every language; 6.12.0 supplies `fileManagement.contentLost` and the `lost` file status a lost file is listed with; 6.11.0 supplies the `follow.errors.*` strings the follow error codes are worded with; 6.4.0 the `follow.*` strings the follow buttons read for every verb and language; 6.1.0 the `oxy.auth.email.{startChange,change,remove}` and `oxy.auth.password.remove` the sign-in & security panels call. Keep one Core instance per app; raise this floor with the root catalogue when new runtime APIs are required.",
+  "//@oxy.so/core": "Core 7.7.0 supplies the bounded native asset file adapter and phase progress installed by OxyProvider; 7.6.0 forwards guest locale and first-touch campaign metadata through signup; 7.3.0 supplies `users.lookupMany`, with which the account members screen fails (and retries) a profile read whose chunk failed instead of caching those members as handle-less; 7.2.0 supplies `assets.cachedUrl`, with which `useFileDownloadUrl` answers an already-resolved URL in its first render; 6.16.0 supplies `requireServerVerdict` and `onHolderRejected`, with which the cold boot checks a session it painted from the cache; 6.13.0 supplies the `accounts.settings.*` strings (picture, categories) the account settings speak in every language; 6.12.0 supplies `fileManagement.contentLost` and the `lost` file status a lost file is listed with; 6.11.0 supplies the `follow.errors.*` strings the follow error codes are worded with; 6.4.0 the `follow.*` strings the follow buttons read for every verb and language; 6.1.0 the `oxy.auth.email.{startChange,change,remove}` and `oxy.auth.password.remove` the sign-in & security panels call. Keep one Core instance per app; raise this floor with the root catalogue when new runtime APIs are required.",
   "//react-native": "React Native 0.81 to 0.88, React 19.1+ and Expo SDK 54 to 58. The floors are the Expo SDK 54 stack (react-native 0.81.6, react 19.1.4, react-native-web 0.21.4, expo 54.0.38 and the module versions its bundledNativeModules.json pins), which compat/expo-54 installs as an external consumer and checks on every CI run (`bun check.mjs`): every peer here admits that stack, services' published src typechecks against its types, and <OxyProvider> mounts and settles its cold boot on iOS (React Native 0.81), web (react-native-web 0.21) and react-native-macos 0.81 with the native modules macOS lacks absent. Astro, Oxy's browser, runs react-native-macos 0.81 (0.83 is its latest release), which is why the floor is not 0.85. The SDK 56 floors these replaced were the versions current when the ranges were first written, not measurements.",
   "peerDependencies": {
     "@expo/app-integrity": ">=0.1.10 <59.0.0",
     "@expo/vector-icons": "^15.0.3",
     "@oxy.so/bloom": ">=11.1.0",
-    "@oxy.so/core": "^7.6.0",
+    "@oxy.so/core": "^7.7.0",
     "@react-native-async-storage/async-storage": "^2.0.0",
     "@react-native-community/netinfo": ">=11.4.1 <13.0.0",
     "@tanstack/query-async-storage-persister": "^5.101",

package/src/ui/context/OxyContext.tsx

@@ -1,3 +1,4 @@
+import { installNativeAssetFiles } from '../utils/nativeAssetFiles';
 import {
   startNativeOAuthSignIn,
   type StartNativeOAuthSignInOptions,
@@ -9,7 +10,15 @@ import {
   setIsolatedOAuthSession,
 } from './isolatedOAuthSession';
 import type React from 'react';
-import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';
+import {
+  useCallback,
+  useEffect,
+  useLayoutEffect,
+  useMemo,
+  useRef,
+  useState,
+  useSyncExternalStore,
+} from 'react';
 import { AppState, Linking, Platform } from 'react-native';
 import { OxyServices } from '@oxy.so/core';
 import type { LoginSessionResult } from '@oxy.so/contracts';
@@ -182,6 +191,9 @@ export const OxyRuntimeProvider: React.FC<OxyRuntimeProviderProps> = ({
     }
   }
   const oxyServices = oxyServicesRef.current;
+  // Child passive effects may upload immediately on mount. Configure transport
+  // during commit, before those effects, without mutating the client in render.
+  useLayoutEffect(() => installNativeAssetFiles(oxyServices), [oxyServices]);
 
   // The device-first persisted auth-state store (per-origin device credential on
   // web; SecureStore session blob on native). Built ONCE per provider mount.

package/src/ui/utils/__tests__/nativeAssetFiles.test.ts

@@ -0,0 +1,270 @@
+import type { AssetFileAdapter, OxyServices } from '@oxy.so/core';
+import { installNativeAssetFiles } from '../nativeAssetFiles.native';
+
+const originalUri = 'file:///capture.mp4';
+const mockFiles = new Map<string, { size: number; written: number }>();
+const mockReads: number[] = [];
+const mockDeleted: string[] = [];
+let mockNativeHasher: unknown = null;
+jest.mock('expo-modules-core', () => ({ requireOptionalNativeModule: () => mockNativeHasher }));
+let mockUpload: jest.Mock;
+let mockCancel: jest.Mock;
+let mockRequest: { url: string; uri: string; options: unknown } | undefined;
+
+jest.mock('expo-file-system', () => {
+  const uriOf = (value: string | { uri: string }) =>
+    typeof value === 'string' ? value : value.uri;
+  class Directory {
+    uri: string;
+    constructor(base: string, name: string) {
+      this.uri = `${base}/${name}`;
+    }
+    get exists() {
+      return false;
+    }
+    create() {}
+    delete() {}
+  }
+  class File {
+    uri: string;
+    constructor(base: string | { uri: string }, name?: string) {
+      this.uri = name ? `${uriOf(base)}/${name}` : uriOf(base);
+    }
+    get exists() {
+      return mockFiles.has(this.uri);
+    }
+    get size() {
+      return mockFiles.get(this.uri)?.size ?? 0;
+    }
+    create() {
+      mockFiles.set(this.uri, { size: 0, written: 0 });
+    }
+    delete() {
+      mockDeleted.push(this.uri);
+      mockFiles.delete(this.uri);
+    }
+    open() {
+      const uri = this.uri;
+      let offset = 0;
+      let closed = false;
+      return {
+        get offset() {
+          return offset;
+        },
+        set offset(next: number) {
+          offset = next;
+        },
+        readBytes(length: number) {
+          if (closed) throw new Error('Closed');
+          mockReads.push(length);
+          const size = mockFiles.get(uri)?.size ?? 0;
+          const bytes = new Uint8Array(Math.max(0, Math.min(length, size - offset))).fill(7);
+          offset += bytes.length;
+          return bytes;
+        },
+        writeBytes(bytes: Uint8Array) {
+          if (closed) throw new Error('Closed');
+          const file = mockFiles.get(uri);
+          if (!file) throw new Error('Missing target');
+          file.written += bytes.length;
+          file.size += bytes.length;
+        },
+        close() {
+          closed = true;
+        },
+      };
+    }
+  }
+  return { File, Directory, Paths: { cache: 'file:///cache' } };
+});
+jest.mock('expo-file-system/legacy', () => ({
+  FileSystemUploadType: { BINARY_CONTENT: 0 },
+  FileSystemSessionType: { FOREGROUND: 0 },
+  createUploadTask: (
+    url: string,
+    uri: string,
+    options: unknown,
+    progress: (event: { totalBytesSent: number }) => void,
+  ) => {
+    mockRequest = { url, uri, options };
+    return { uploadAsync: () => mockUpload(uri, progress), cancelAsync: () => mockCancel() };
+  },
+}));
+
+function adapter(): AssetFileAdapter {
+  let installed: AssetFileAdapter | undefined;
+  const oxy = {
+    assets: {
+      installFileAdapter: (value: AssetFileAdapter) => {
+        installed = value;
+        return () => {};
+      },
+    },
+  } as unknown as OxyServices;
+  installNativeAssetFiles(oxy);
+  if (!installed) throw new Error('Adapter was not installed');
+  return installed;
+}
+
+beforeEach(() => {
+  mockNativeHasher = null;
+  mockFiles.clear();
+  mockFiles.set(originalUri, { size: 370 * 1024 * 1024, written: 0 });
+  mockReads.length = 0;
+  mockDeleted.length = 0;
+  mockRequest = undefined;
+  mockCancel = jest.fn(async () => undefined);
+  mockUpload = jest.fn(
+    async (uri: string, progress: (event: { totalBytesSent: number }) => void) => {
+      progress({ totalBytesSent: mockFiles.get(uri)?.size ?? 0 });
+      return { status: 200 };
+    },
+  );
+});
+
+test('reads bounded ranges and streams only a temporary part of a larger-than-heap file', async () => {
+  const source = await adapter()(originalUri);
+  expect(source.size).toBe(370 * 1024 * 1024);
+  const bytes = await source.readRange(16 * 1024 * 1024, 24 * 1024 * 1024);
+  expect(bytes.length).toBe(8 * 1024 * 1024);
+  expect(bytes[bytes.length - 1]).toBe(7);
+  const onProgress = jest.fn();
+  await expect(
+    source.putPart({
+      url: 'https://storage.example/part?signed=1',
+      start: 32 * 1024 * 1024,
+      end: 40 * 1024 * 1024,
+      timeoutMs: 1000,
+      onProgress,
+    }),
+  ).resolves.toEqual({ ok: true });
+  expect(Math.max(...mockReads)).toBe(1024 * 1024);
+  expect(mockReads.reduce((sum, size) => sum + size, 0)).toBe(16 * 1024 * 1024);
+  expect(mockRequest).toMatchObject({
+    url: 'https://storage.example/part?signed=1',
+    options: { httpMethod: 'PUT', uploadType: 0, sessionType: 0, headers: {} },
+  });
+  expect(onProgress).toHaveBeenCalledWith(8 * 1024 * 1024);
+  expect(mockFiles.has(originalUri)).toBe(true);
+  expect(mockFiles.size).toBe(1);
+  expect(mockDeleted).toHaveLength(1);
+});
+
+test('abort cancels the native transfer and deletes its part while preserving the capture', async () => {
+  const source = await adapter()(originalUri);
+  const controller = new AbortController();
+  mockUpload.mockImplementation(() => new Promise(() => {}));
+  const pending = source.putPart({
+    url: 'https://storage.example/part',
+    start: 0,
+    end: 2 * 1024 * 1024,
+    timeoutMs: 1000,
+    signal: controller.signal,
+    onProgress: jest.fn(),
+  });
+  while (!mockRequest) await new Promise((resolve) => setTimeout(resolve, 0));
+  controller.abort();
+  await expect(pending).rejects.toMatchObject({ name: 'AbortError' });
+  expect(mockCancel).toHaveBeenCalledTimes(1);
+  expect(mockFiles.size).toBe(1);
+  expect(mockFiles.has(originalUri)).toBe(true);
+});
+
+test('a stalled native PUT times out and cleans its temporary part', async () => {
+  const source = await adapter()(originalUri);
+  mockUpload.mockImplementation(() => new Promise(() => {}));
+  await expect(
+    source.putPart({
+      url: 'https://storage.example/part',
+      start: 0,
+      end: 1024,
+      timeoutMs: 5,
+      onProgress: jest.fn(),
+    }),
+  ).resolves.toEqual({ ok: false, status: 0 });
+  expect(mockCancel).toHaveBeenCalledTimes(1);
+  expect(mockFiles.size).toBe(1);
+});
+
+test('hash reads let scheduled UI work run before the complete range is read', async () => {
+  const source = await adapter()(originalUri);
+  let readsAtTick = -1;
+  const tick = new Promise<void>((resolve) =>
+    setTimeout(() => {
+      readsAtTick = mockReads.length;
+      resolve();
+    }, 0),
+  );
+  await source.readRange(0, 8 * 1024 * 1024);
+  await tick;
+  expect(readsAtTick).toBeGreaterThan(0);
+  expect(readsAtTick).toBeLessThan(8);
+});
+
+test('an abort timer interrupts part preparation before copying the complete range', async () => {
+  const source = await adapter()(originalUri);
+  const controller = new AbortController();
+  setTimeout(() => controller.abort(), 0);
+  await expect(
+    source.putPart({
+      url: 'https://storage.example/part',
+      start: 0,
+      end: 8 * 1024 * 1024,
+      timeoutMs: 1000,
+      signal: controller.signal,
+      onProgress: jest.fn(),
+    }),
+  ).rejects.toMatchObject({ name: 'AbortError' });
+  expect(mockReads.length).toBeLessThan(8);
+  expect(mockUpload).not.toHaveBeenCalled();
+  expect(mockFiles.size).toBe(1);
+  expect(mockFiles.has(originalUri)).toBe(true);
+});
+
+test('uses the native streaming hash without reading bytes into JavaScript', async () => {
+  let progress: (event: { id: string; loaded: number }) => void;
+  const remove = jest.fn();
+  const digest = 'ab'.repeat(32);
+  mockNativeHasher = {
+    createHash: jest.fn(),
+    cancelHash: jest.fn(),
+    addListener: jest.fn((_event, callback) => {
+      progress = callback;
+      return { remove };
+    }),
+    hashAsync: jest.fn(async (id, _uri, size) => {
+      progress({ id: 'another-upload', loaded: 1 });
+      progress({ id, loaded: size });
+      return digest;
+    }),
+  };
+  const source = await adapter()(originalUri);
+  const onProgress = jest.fn();
+  await expect(source.hash?.(onProgress)).resolves.toBe(digest);
+  expect(mockReads).toHaveLength(0);
+  expect(onProgress).toHaveBeenCalledTimes(1);
+  expect(onProgress).toHaveBeenCalledWith(source.size);
+  expect(remove).toHaveBeenCalledTimes(1);
+});
+
+test('native hash cancellation waits for worker cleanup and removes its listener', async () => {
+  const controller = new AbortController();
+  const remove = jest.fn();
+  let finish: (value: string) => void;
+  const cancelHash = jest.fn(() => finish('ab'.repeat(32)));
+  mockNativeHasher = {
+    createHash: jest.fn(),
+    cancelHash,
+    addListener: () => ({ remove }),
+    hashAsync: () =>
+      new Promise<string>((resolve) => {
+        finish = resolve;
+      }),
+  };
+  const source = await adapter()(originalUri);
+  const pending = source.hash?.(undefined, controller.signal);
+  controller.abort();
+  await expect(pending).rejects.toMatchObject({ name: 'AbortError' });
+  expect(cancelHash).toHaveBeenCalledTimes(1);
+  expect(remove).toHaveBeenCalledTimes(1);
+});

package/src/ui/utils/nativeAssetFiles.macos.ts

@@ -0,0 +1,6 @@
+import type { OxyServices } from '@oxy.so/core';
+
+/** Web/Node use their existing Blob transport. Metro selects the native adapter. */
+export function installNativeAssetFiles(_oxy: OxyServices): undefined {
+  return undefined;
+}