expo-file-system 58.0.6 → 58.0.7

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 58.0.7
+
+### Patch Changes
+
+- [iOS] Add opt-in control over background download completion with `DownloadTask.acknowledgeBackgroundCompletionAsync()`, so apps can finish processing downloads before returning control to iOS. ([#50543](https://github.com/expo/expo/pull/50543) by [@savv](https://github.com/savv))
+- Added static `File.preview()` and `File.canPreview()` methods for a file or array of files, with multi-file previews and initial selection on iOS. ([#50696](https://github.com/expo/expo/pull/50696) by [@eliotgevers](https://github.com/eliotgevers))
+
 ## 58.0.6
 
 ### Patch Changes

package/android/build.gradle

@@ -4,13 +4,13 @@ plugins {
 }
 
 group = 'host.exp.exponent'
-version = '58.0.6'
+version = '58.0.7'
 
 android {
   namespace "expo.modules.filesystem"
   defaultConfig {
     versionCode 30
-    versionName "58.0.6"
+    versionName "58.0.7"
     testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
   }
   testOptions {

package/build/ExpoFileSystem.d.ts

@@ -18,6 +18,9 @@ declare class ExpoFileSystemModule extends NativeModule<FileSystemEvents> {
     FileSystemDownloadTask: typeof FileSystemDownloadTask;
     FileSystemWatcher: typeof NativeFileSystemWatcher;
     downloadFileAsync(url: string, destination: File | Directory, options?: DownloadOptions, uuid?: string): Promise<string>;
+    /** Native iOS collection previews. Single-file requests use the File instance methods. */
+    canPreview(files: File[]): Promise<boolean>;
+    preview(files: File[], initialIndex: number): Promise<void>;
     cancelDownloadAsync(uuid: string): void;
     pickDirectoryAsync(initialUri?: string): Promise<Directory>;
     pickFileAsync(options: PickSingleFileOptions): Promise<File>;

package/build/ExpoFileSystem.js.map

@@ -1 +1 @@
-{"version":3,"sources":["ExpoFileSystem.ts"],"sourcesContent":[null],"names":["NativeModule","requireNativeModule"],"mappings":"AAAA,SAASA,YAAY,EAAEC,mBAAmB,QAAQ,oBAAoB;AA4CtE,eAAeA,oBAA0C,cAAc"}
+{"version":3,"sources":["ExpoFileSystem.ts"],"sourcesContent":[null],"names":["NativeModule","requireNativeModule"],"mappings":"AAAA,SAASA,YAAY,EAAEC,mBAAmB,QAAQ,oBAAoB;AA+CtE,eAAeA,oBAA0C,cAAc"}

package/build/File.d.ts

@@ -1,6 +1,6 @@
 import { Directory } from './Directory';
 import ExpoFileSystem from './ExpoFileSystem';
-import { type FileCanPreviewOptions, type FilePreviewOptions, type PickMultipleFilesOptions, type PickMultipleFilesResult, type PickSingleFileOptions, type PickSingleFileResult } from './File.types';
+import { type FileCanPreviewOptions, type FilePreviewOptions, type FilePreviewCollectionOptions, type PickMultipleFilesOptions, type PickMultipleFilesResult, type PickSingleFileOptions, type PickSingleFileResult } from './File.types';
 import { type WatchEvent, type WatchOptions, type WatchSubscription } from './FileSystemWatcher.types';
 import { DownloadTask, UploadTask } from './NetworkTasks';
 import { type DownloadOptions, type DownloadTaskOptions, type UploadOptions, type UploadResult } from './NetworkTasks.types';
@@ -16,6 +16,41 @@ import { type DownloadOptions, type DownloadTaskOptions, type UploadOptions, typ
  * ```
  */
 export declare class File extends ExpoFileSystem.FileSystemFile implements Blob {
+    /**
+     * Checks whether every supplied local file can be previewed.
+     * Android resolves to `false` for more than one file. Only iOS previews multiple files.
+     * An array with one file behaves like a single `File`.
+     * Rejects empty arrays and invalid arguments.
+     * @platform ios
+     * @platform android
+     *
+     * @example
+     * ```ts
+     * const files = [new File(Paths.cache, 'report.pdf'), new File(Paths.cache, 'notes.txt')];
+     * const canPreviewAll = await File.canPreview(files);
+     * ```
+     */
+    static canPreview(input: File | File[], options?: FileCanPreviewOptions): Promise<boolean>;
+    /**
+     * Previews local files in the supplied order, starting at `initialIndex` (default `0`).
+     * Android rejects more than one file. Only iOS previews multiple files.
+     * An array with one file behaves like a single `File`.
+     * Rejects if you pass `title` or `mimeType` with more than one file.
+     * Also rejects empty arrays, an invalid `initialIndex`, and files that cannot be previewed.
+     * Resolves at presentation or handoff to another app, not when the viewer closes.
+     * @platform ios
+     * @platform android
+     *
+     * @example
+     * ```ts
+     * // The files must exist before previewing.
+     * const files = [new File(Paths.cache, 'report.pdf'), new File(Paths.cache, 'notes.txt')];
+     * if (await File.canPreview(files)) {
+     *   await File.preview(files, { initialIndex: 1 });
+     * }
+     * ```
+     */
+    static preview(input: File | File[], options?: FilePreviewOptions & FilePreviewCollectionOptions): Promise<void>;
     /**
      * A static method that downloads a file from the network.
      *

package/build/File.js

@@ -1,4 +1,5 @@
-import { uuid } from 'expo-modules-core';
+import { UnavailabilityError, uuid } from 'expo-modules-core';
+import { Platform } from 'react-native';
 import { Directory } from './Directory';
 import ExpoFileSystem from './ExpoFileSystem';
 import { FileMode } from './File.types';
@@ -18,6 +19,69 @@ import { FileSystemReadableStreamSource, FileSystemWritableSink } from './intern
  * ```
  */ export class File extends ExpoFileSystem.FileSystemFile {
     /**
+   * Checks whether every supplied local file can be previewed.
+   * Android resolves to `false` for more than one file. Only iOS previews multiple files.
+   * An array with one file behaves like a single `File`.
+   * Rejects empty arrays and invalid arguments.
+   * @platform ios
+   * @platform android
+   *
+   * @example
+   * ```ts
+   * const files = [new File(Paths.cache, 'report.pdf'), new File(Paths.cache, 'notes.txt')];
+   * const canPreviewAll = await File.canPreview(files);
+   * ```
+   */ static async canPreview(input, options) {
+        const files = normalizePreviewFiles(input);
+        validateCollectionPreviewOptions(files, options);
+        if (files.length === 1) {
+            return files[0].canPreview(options);
+        }
+        if (Platform.OS !== 'ios' || Platform.isTV) {
+            return false;
+        }
+        if (!ExpoFileSystem.canPreview) {
+            throw new UnavailabilityError('expo-file-system', 'File.canPreview');
+        }
+        return ExpoFileSystem.canPreview(files);
+    }
+    /**
+   * Previews local files in the supplied order, starting at `initialIndex` (default `0`).
+   * Android rejects more than one file. Only iOS previews multiple files.
+   * An array with one file behaves like a single `File`.
+   * Rejects if you pass `title` or `mimeType` with more than one file.
+   * Also rejects empty arrays, an invalid `initialIndex`, and files that cannot be previewed.
+   * Resolves at presentation or handoff to another app, not when the viewer closes.
+   * @platform ios
+   * @platform android
+   *
+   * @example
+   * ```ts
+   * // The files must exist before previewing.
+   * const files = [new File(Paths.cache, 'report.pdf'), new File(Paths.cache, 'notes.txt')];
+   * if (await File.canPreview(files)) {
+   *   await File.preview(files, { initialIndex: 1 });
+   * }
+   * ```
+   */ static async preview(input, options) {
+        const files = normalizePreviewFiles(input);
+        const initialIndex = options?.initialIndex ?? 0;
+        if (!Number.isInteger(initialIndex) || initialIndex < 0 || initialIndex >= files.length) {
+            throw new RangeError('initialIndex must be an integer within the preview collection.');
+        }
+        validateCollectionPreviewOptions(files, options);
+        if (files.length === 1) {
+            return files[0].preview({
+                title: options?.title,
+                mimeType: options?.mimeType
+            });
+        }
+        if (Platform.OS !== 'ios' || Platform.isTV || !ExpoFileSystem.preview) {
+            throw new UnavailabilityError('expo-file-system', 'File.preview (multiple files)');
+        }
+        return ExpoFileSystem.preview(files, initialIndex);
+    }
+    /**
    * A static method that downloads a file from the network.
    *
    * On Android, the response body streams directly into the target file. If the download fails after
@@ -332,5 +396,26 @@ File.downloadFileAsync = async function downloadFileAsync(url, to, options) {
         usingOldAPI: mimeType !== undefined || typeof initialUriOrOptions === 'string'
     };
 }
+function normalizePreviewFiles(input) {
+    const files = Array.isArray(input) ? [
+        ...input
+    ] : [
+        input
+    ];
+    if (files.length === 0) {
+        throw new RangeError('At least one file is required for a preview.');
+    }
+    for (const file of files){
+        if (!(file instanceof ExpoFileSystem.FileSystemFile)) {
+            throw new TypeError('Preview input must contain File instances.');
+        }
+    }
+    return files;
+}
+function validateCollectionPreviewOptions(files, options) {
+    if (files.length > 1 && (options?.title !== undefined || options?.mimeType !== undefined)) {
+        throw new TypeError('title and mimeType are only supported for single-file previews.');
+    }
+}
 
 //# sourceMappingURL=File.js.map

package/build/File.js.map

@@ -1 +1 @@
-{"version":3,"sources":["File.ts"],"sourcesContent":[null],"names":["uuid","Directory","ExpoFileSystem","FileMode","DownloadTask","UploadTask","Paths","FileSystemWatcher","FileSystemReadableStreamSource","FileSystemWritableSink","File","FileSystemFile","downloadFileAsync","pickFileAsync","initialUriOrOptions","mimeType","options","usingOldAPI","parsePickFileOptions","multipleFiles","files","result","map","file","uri","canceled","e","uris","join","validatePath","parentDirectory","dirname","extension","extname","name","basename","readableStream","ReadableStream","open","ReadOnly","writableStream","WritableStream","WriteOnly","arrayBuffer","bytes","buffer","json","JSON","parse","text","formData","Response","headers","type","undefined","stream","slice","start","end","contentType","Blob","bytesSync","canPreview","preview","upload","url","uploadAsync","createUploadTask","createDownloadTask","destination","watch","callback","createAbortError","reason","error","Error","to","needsUuid","onProgress","signal","downloadUuid","v4","subscription","abortHandler","lastProgress","aborted","addListener","event","data","cancelDownloadAsync","addEventListener","once","outputURI","fileSize","size","bytesWritten","totalBytes","remove","removeEventListener","initialUri","mimeTypes"],"mappings":"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"}
+{"version":3,"sources":["File.ts"],"sourcesContent":[null],"names":["UnavailabilityError","uuid","Platform","Directory","ExpoFileSystem","FileMode","DownloadTask","UploadTask","Paths","FileSystemWatcher","FileSystemReadableStreamSource","FileSystemWritableSink","File","FileSystemFile","canPreview","input","options","files","normalizePreviewFiles","validateCollectionPreviewOptions","length","OS","isTV","preview","initialIndex","Number","isInteger","RangeError","title","mimeType","downloadFileAsync","pickFileAsync","initialUriOrOptions","usingOldAPI","parsePickFileOptions","multipleFiles","result","map","file","uri","canceled","e","uris","join","validatePath","parentDirectory","dirname","extension","extname","name","basename","readableStream","ReadableStream","open","ReadOnly","writableStream","WritableStream","WriteOnly","arrayBuffer","bytes","buffer","json","JSON","parse","text","formData","Response","headers","type","undefined","stream","slice","start","end","contentType","Blob","bytesSync","upload","url","uploadAsync","createUploadTask","createDownloadTask","destination","watch","callback","createAbortError","reason","error","Error","to","needsUuid","onProgress","signal","downloadUuid","v4","subscription","abortHandler","lastProgress","aborted","addListener","event","data","cancelDownloadAsync","addEventListener","once","outputURI","fileSize","size","bytesWritten","totalBytes","remove","removeEventListener","initialUri","mimeTypes","Array","isArray","TypeError"],"mappings":"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"}

package/build/File.types.d.ts

@@ -43,6 +43,11 @@ export type FileWriteOptions = {
      */
     append?: boolean;
 };
+/**
+ * Options for checking whether a file can be previewed.
+ * @platform android
+ * @platform ios
+ */
 export type FileCanPreviewOptions = {
     /**
      * MIME type of the file. Android uses this value to find a matching app for the preview intent.
@@ -50,6 +55,23 @@ export type FileCanPreviewOptions = {
      */
     mimeType?: string;
 };
+/**
+ * Options for choosing which file `File.preview()` displays first.
+ * @platform android
+ * @platform ios
+ */
+export type FilePreviewCollectionOptions = {
+    /**
+     * Zero-based index of the file to display first. Must be within the supplied array.
+     * @default 0
+     */
+    initialIndex?: number;
+};
+/**
+ * Options for previewing a single file.
+ * @platform android
+ * @platform ios
+ */
 export type FilePreviewOptions = {
     /**
      * Optional display title for the preview when the platform supports one.

package/build/File.types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["File.types.ts"],"sourcesContent":[null],"names":["EncodingType","FileMode"],"mappings":"AA0BA,OAAO,IAAA,AAAKA,sCAAAA;IACV;;GAEC;IAED;;GAEC;WAPSA;MASX;AAmCD;;CAEC,GACD,OAAO,IAAA,AAAKC,kCAAAA;IACV;;;;;GAKC;IAGD;;;GAGC;IAGD;;;GAGC;IAGD;;;;;;GAMC;IAGD;;GAEC;WAhCSA;MAkCX"}
+{"version":3,"sources":["File.types.ts"],"sourcesContent":[null],"names":["EncodingType","FileMode"],"mappings":"AA0BA,OAAO,IAAA,AAAKA,sCAAAA;IACV;;GAEC;IAED;;GAEC;WAPSA;MASX;AA0DD;;CAEC,GACD,OAAO,IAAA,AAAKC,kCAAAA;IACV;;;;;GAKC;IAGD;;;GAGC;IAGD;;;GAGC;IAGD;;;;;;GAMC;IAGD;;GAEC;WAhCSA;MAkCX"}

package/build/NetworkTasks.d.ts

@@ -99,6 +99,14 @@ export declare class DownloadTask {
      * The current state of the download task.
      */
     get state(): DownloadTaskState;
+    /**
+     * Acknowledges that processing this successful download has finished.
+     * Requires `deferBackgroundSessionCompletion`. Call after `downloadAsync()` or `resumeAsync()`
+     * resolves, normally in a `finally` block around processing. Early calls reject; repeated calls
+     * after completion are harmless. Android and foreground sessions require no acknowledgment.
+     * @platform ios
+     */
+    acknowledgeBackgroundCompletionAsync(): Promise<void>;
     /**
      * Starts the download operation.
      *

package/build/NetworkTasks.js

@@ -1,3 +1,4 @@
+import { Platform } from 'react-native';
 import { Directory } from './Directory';
 import ExpoFileSystem from './ExpoFileSystem';
 import { File } from './File';
@@ -200,6 +201,21 @@ function cleanupNetworkTask(signal, subscription, abortHandler) {
         return this._state;
     }
     /**
+   * Acknowledges that processing this successful download has finished.
+   * Requires `deferBackgroundSessionCompletion`. Call after `downloadAsync()` or `resumeAsync()`
+   * resolves, normally in a `finally` block around processing. Early calls reject; repeated calls
+   * after completion are harmless. Android and foreground sessions require no acknowledgment.
+   * @platform ios
+   */ async acknowledgeBackgroundCompletionAsync() {
+        if (Platform.OS !== 'ios' || !this._options?.deferBackgroundSessionCompletion || this._options?.sessionType === 'foreground') {
+            return;
+        }
+        if (this._state !== 'completed') {
+            throw new Error('Background completion can only be acknowledged after a successful download');
+        }
+        await this._nativeTask.acknowledgeBackgroundCompletionAsync();
+    }
+    /**
    * Starts the download operation.
    *
    * This method can only be called once, while the task is `idle`. The promise resolves with
@@ -217,7 +233,8 @@ function cleanupNetworkTask(signal, subscription, abortHandler) {
         this._pauseRequest = undefined;
         const operation = this._runDownloadOperation(()=>this._nativeTask.start(this._url, this._destination, {
                 headers: this._options?.headers,
-                sessionType: this._options?.sessionType
+                sessionType: this._options?.sessionType,
+                deferBackgroundSessionCompletion: this._options?.deferBackgroundSessionCompletion
             }));
         this._inFlightOperation = operation;
         return operation;
@@ -267,7 +284,8 @@ function cleanupNetworkTask(signal, subscription, abortHandler) {
         this._pauseRequest = undefined;
         const operation = this._runDownloadOperation(()=>this._nativeTask.resume(this._url, this._destination, this._resumeData, {
                 headers: this._options?.headers,
-                sessionType: this._options?.sessionType
+                sessionType: this._options?.sessionType,
+                deferBackgroundSessionCompletion: this._options?.deferBackgroundSessionCompletion
             }));
         this._inFlightOperation = operation;
         return operation;

package/build/NetworkTasks.js.map

@@ -1 +1 @@
-{"version":3,"sources":["NetworkTasks.ts"],"sourcesContent":[null],"names":["Directory","ExpoFileSystem","File","createAbortError","reason","error","Error","name","assertNetworkTaskState","state","allowedStates","methodName","includes","wireNetworkTaskAbortSignal","signal","cancel","aborted","abortHandler","addEventListener","once","undefined","wireNetworkTaskProgress","onProgress","addListener","cleanupNetworkTask","subscription","remove","removeEventListener","UploadTask","_state","_file","_url","_options","_subscription","_abortHandler","_nativeTask","file","url","options","FileSystemUploadTask","uploadAsync","listener","nativeOpts","httpMethod","uploadType","headers","fieldName","mimeType","parameters","sessionType","result","start","exists","size","bytesSent","totalBytes","eventName","release","DownloadTask","_destination","_resumeData","_inFlightOperation","_pauseRequest","destination","FileSystemDownloadTask","downloadAsync","operation","_runDownloadOperation","pause","Promise","resolve","then","resumeData","pauseAsync","resumeAsync","resume","savable","fileUri","uri","isDirectory","fromSavable","dest","mergedOptions","task","_emitFinalProgressEvent","fileSize","bytesWritten"],"mappings":"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"}
+{"version":3,"sources":["NetworkTasks.ts"],"sourcesContent":[null],"names":["Platform","Directory","ExpoFileSystem","File","createAbortError","reason","error","Error","name","assertNetworkTaskState","state","allowedStates","methodName","includes","wireNetworkTaskAbortSignal","signal","cancel","aborted","abortHandler","addEventListener","once","undefined","wireNetworkTaskProgress","onProgress","addListener","cleanupNetworkTask","subscription","remove","removeEventListener","UploadTask","_state","_file","_url","_options","_subscription","_abortHandler","_nativeTask","file","url","options","FileSystemUploadTask","uploadAsync","listener","nativeOpts","httpMethod","uploadType","headers","fieldName","mimeType","parameters","sessionType","result","start","exists","size","bytesSent","totalBytes","eventName","release","DownloadTask","_destination","_resumeData","_inFlightOperation","_pauseRequest","destination","FileSystemDownloadTask","acknowledgeBackgroundCompletionAsync","OS","deferBackgroundSessionCompletion","downloadAsync","operation","_runDownloadOperation","pause","Promise","resolve","then","resumeData","pauseAsync","resumeAsync","resume","savable","fileUri","uri","isDirectory","fromSavable","dest","mergedOptions","task","_emitFinalProgressEvent","fileSize","bytesWritten"],"mappings":"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"}

package/build/NetworkTasks.types.d.ts

@@ -150,6 +150,17 @@ export type DownloadTaskOptions = {
      * Custom headers to include in the request.
      */
     headers?: Record<string, string>;
+    /**
+     * Delays the iOS background session completion handler until processing is acknowledged with
+     * `DownloadTask.acknowledgeBackgroundCompletionAsync()` after the download succeeds.
+     * Every successful opted-in download needs its own acknowledgment. A 25-second deadline covers
+     * event delivery and JS processing; the system handler is never called before all events arrive.
+     * Applies only to iOS background sessions. Android and foreground sessions ignore this option.
+     * Does not restore JS tasks or acknowledgment state after process termination.
+     * @default false
+     * @platform ios
+     */
+    deferBackgroundSessionCompletion?: boolean;
     /**
      * Determines whether the iOS native session should continue in the background.
      * Android accepts this option for API consistency and ignores it.

package/build/index.d.ts

@@ -2,5 +2,5 @@ export { Paths } from './Paths';
 export { File } from './File';
 export { Directory } from './Directory';
 export { UploadTask, DownloadTask } from './NetworkTasks';
-export { DEFAULT_DEBOUNCE_MS, type FileCreateOptions, type FileDigestAlgorithm, type DirectoryCreateOptions, type RelocationOptions, type FileHandle, type FileInfo, type FileCanPreviewOptions, type FilePreviewOptions, type FileWriteOptions, type InfoOptions, type PathInfo, type DirectoryInfo, type DownloadOptions, type DownloadProgress, FileMode, EncodingType, UploadType, type PickFileOptions, type PickSingleFileOptions, type PickMultipleFilesOptions, type PickFileGeneralOptions, type PickSingleFileSuccessResult, type PickSingleFileResult, type PickMultipleFilesResult, type PickMultipleFilesSuccessResult, type PickFileCanceledResult, type UploadOptions, type UploadProgress, type UploadResult, type DownloadTaskOptions, type NetworkTaskSessionType, type DownloadPauseState, type UploadTaskState, type DownloadTaskState, type WatchEventType, type WatchEvent, type WatchOptions, type WatchSubscription, } from './FileSystem.types';
+export { DEFAULT_DEBOUNCE_MS, type FileCreateOptions, type FileDigestAlgorithm, type DirectoryCreateOptions, type RelocationOptions, type FileHandle, type FileInfo, type FileCanPreviewOptions, type FilePreviewOptions, type FilePreviewCollectionOptions, type FileWriteOptions, type InfoOptions, type PathInfo, type DirectoryInfo, type DownloadOptions, type DownloadProgress, FileMode, EncodingType, UploadType, type PickFileOptions, type PickSingleFileOptions, type PickMultipleFilesOptions, type PickFileGeneralOptions, type PickSingleFileSuccessResult, type PickSingleFileResult, type PickMultipleFilesResult, type PickMultipleFilesSuccessResult, type PickFileCanceledResult, type UploadOptions, type UploadProgress, type UploadResult, type DownloadTaskOptions, type NetworkTaskSessionType, type DownloadPauseState, type UploadTaskState, type DownloadTaskState, type WatchEventType, type WatchEvent, type WatchOptions, type WatchSubscription, } from './FileSystem.types';
 export * from './legacyWarnings';

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["index.ts"],"sourcesContent":[null],"names":["Paths","File","Directory","UploadTask","DownloadTask","DEFAULT_DEBOUNCE_MS","FileMode","EncodingType","UploadType"],"mappings":"AAAA,SAASA,KAAK,QAAQ,UAAU;AAChC,SAASC,IAAI,QAAQ,SAAS;AAC9B,SAASC,SAAS,QAAQ,cAAc;AACxC,SAASC,UAAU,EAAEC,YAAY,QAAQ,iBAAiB;AAE1D,SACEC,mBAAmB,EAenBC,QAAQ,EACRC,YAAY,EACZC,UAAU,QAsBL,qBAAqB;AAE5B,cAAc,mBAAmB"}
+{"version":3,"sources":["index.ts"],"sourcesContent":[null],"names":["Paths","File","Directory","UploadTask","DownloadTask","DEFAULT_DEBOUNCE_MS","FileMode","EncodingType","UploadType"],"mappings":"AAAA,SAASA,KAAK,QAAQ,UAAU;AAChC,SAASC,IAAI,QAAQ,SAAS;AAC9B,SAASC,SAAS,QAAQ,cAAc;AACxC,SAASC,UAAU,EAAEC,YAAY,QAAQ,iBAAiB;AAE1D,SACEC,mBAAmB,EAgBnBC,QAAQ,EACRC,YAAY,EACZC,UAAU,QAsBL,qBAAqB;AAE5B,cAAc,mBAAmB"}

package/build/internal/NativeFileSystem.types.d.ts

@@ -303,6 +303,10 @@ export declare class FileSystemDownloadTask extends SharedObject<DownloadTaskEve
      * @hidden
      */
     resume(url: string, to: PublicFile | PublicDirectory, resumeData: string, options?: Record<string, any>): Promise<string | null>;
+    /**
+     * @hidden
+     */
+    acknowledgeBackgroundCompletionAsync(): Promise<void>;
     /**
      * @hidden
      */

package/build/internal/NativeFileSystem.types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["internal/NativeFileSystem.types.ts"],"sourcesContent":[null],"names":[],"mappings":"AAkaA;;CAEC,GACD,WAIC"}
+{"version":3,"sources":["internal/NativeFileSystem.types.ts"],"sourcesContent":[null],"names":[],"mappings":"AAsaA;;CAEC,GACD,WAIC"}

package/ios/BackgroundSessionCompletion.swift

@@ -0,0 +1,77 @@
+// Copyright 2026-present 650 Industries. All rights reserved.
+
+import Foundation
+
+// Accessed only on the main queue by FileSystemBackgroundSessionHandler.
+final class BackgroundSessionCompletion {
+  private struct Session {
+    let token: UUID
+    var completions: [() -> Void]
+    var finishedEvents = false
+    var deadlineReached = false
+    var awaitingAcknowledgment: Set<ObjectIdentifier> = []
+  }
+
+  private var sessions: [String: Session] = [:]
+  private var downloads: [ObjectIdentifier: String] = [:]
+
+  func register(_ task: AnyObject, session identifier: String) {
+    discard(task)
+    downloads[ObjectIdentifier(task)] = identifier
+  }
+
+  func finish(_ task: AnyObject, succeeded: Bool) {
+    let key = ObjectIdentifier(task)
+    guard let identifier = downloads[key] else { return }
+    // Foreground completions have no system handler to defer. Do not retain them for a later wake.
+    guard succeeded, sessions[identifier] != nil else {
+      discard(task)
+      return
+    }
+    sessions[identifier]?.awaitingAcknowledgment.insert(key)
+    completeIfReady(identifier)
+  }
+
+  func discard(_ task: AnyObject) {
+    let key = ObjectIdentifier(task)
+    guard let identifier = downloads.removeValue(forKey: key) else { return }
+    sessions[identifier]?.awaitingAcknowledgment.remove(key)
+    completeIfReady(identifier)
+  }
+
+  @discardableResult
+  func receiveHandler(_ identifier: String, completion: @escaping () -> Void) -> UUID {
+    if let token = sessions[identifier]?.token {
+      // Keep pending processing and the original deadline, but wait for the new handler's final event.
+      sessions[identifier]?.completions.append(completion)
+      sessions[identifier]?.finishedEvents = false
+      return token
+    }
+    let token = UUID()
+    sessions[identifier] = Session(token: token, completions: [completion])
+    return token
+  }
+
+  func finishEvents(_ identifier: String) {
+    sessions[identifier]?.finishedEvents = true
+    completeIfReady(identifier)
+  }
+
+  func expire(_ identifier: String, token: UUID) {
+    guard sessions[identifier]?.token == token else { return }
+    sessions[identifier]?.deadlineReached = true
+    completeIfReady(identifier)
+  }
+
+  private func completeIfReady(_ identifier: String) {
+    guard let session = sessions[identifier], session.finishedEvents,
+      session.deadlineReached || session.awaitingAcknowledgment.isEmpty else { return }
+    sessions.removeValue(forKey: identifier)
+    for key in session.awaitingAcknowledgment {
+      downloads.removeValue(forKey: key)
+    }
+    for completion in session.completions {
+      completion()
+    }
+  }
+}

package/ios/ExpoFileSystem.podspec

@@ -29,4 +29,15 @@ Pod::Spec.new do |s|
   s.resource_bundles = {'ExpoFileSystem_privacy' => ['PrivacyInfo.xcprivacy']}
 
   s.source_files = "**/*.{h,m,swift}"
+  s.exclude_files = 'Tests/'
+
+  s.test_spec 'Tests' do |test_spec|
+    # ExpoModulesCore requires React-hermes or React-jsc in tests.
+    test_spec.dependency 'ExpoModulesTestCore'
+    test_spec.source_files = 'Tests/**/*.{m,swift}'
+    # Test bundles do not inherit ExpoModulesCore's user_target_xcconfig linker flags.
+    test_spec.pod_target_xcconfig = {
+      'OTHER_LDFLAGS' => '$(inherited) -lc++'
+    }
+  end
 end