uploados 0.1.0

package/build/providers/defineUploadProvider.d.ts

@@ -0,0 +1,26 @@
+import type { CompleteMultipartInput, CompleteMultipartResult, CreateMultipartInput, CreateMultipartResult, SignPartInput, SignedPartResult, UploadHttpMethod, UploadProvider } from '../Uploados.types';
+export type ProviderUploadUrlInput = {
+    key: string;
+    contentType?: string;
+    metadata?: Record<string, string>;
+};
+export type ProviderUploadUrlResult = {
+    url: string;
+    method?: UploadHttpMethod;
+    headers?: Record<string, string>;
+};
+export type UploadProviderDefinition = {
+    getUploadUrl?: (input: ProviderUploadUrlInput) => Promise<ProviderUploadUrlResult>;
+    createMultipartUpload?: (input: CreateMultipartInput) => Promise<CreateMultipartResult>;
+    signPart?: (input: SignPartInput) => Promise<SignedPartResult>;
+    completeMultipartUpload?: (input: CompleteMultipartInput) => Promise<CompleteMultipartResult>;
+    abortMultipartUpload?: (input: {
+        key: string;
+        uploadId: string;
+    }) => Promise<void>;
+};
+export declare function defineUploadProvider(definition: UploadProviderDefinition): UploadProvider;
+export declare function assertUploadProvider(provider: UploadProvider | undefined): UploadProvider;
+export declare function assertProviderMultipartSupported(provider: UploadProvider): void;
+export declare function assertProviderDirectUploadSupported(provider: UploadProvider): void;
+//# sourceMappingURL=defineUploadProvider.d.ts.map

package/build/providers/defineUploadProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineUploadProvider.d.ts","sourceRoot":"","sources":["../../src/providers/defineUploadProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,sBAAsB,GAAG;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACnF,qBAAqB,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACxF,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/D,uBAAuB,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC9F,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACpF,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,wBAAwB,GAAG,cAAc,CAQzF;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,GAAG,cAAc,CAKzF;AAED,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAU/E;AAED,wBAAgB,mCAAmC,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAIlF"}

package/build/providers/defineUploadProvider.js

@@ -0,0 +1,39 @@
+export function defineUploadProvider(definition) {
+    return {
+        getUploadUrl: definition.getUploadUrl,
+        createMultipartUpload: definition.createMultipartUpload,
+        signPart: definition.signPart,
+        completeMultipartUpload: definition.completeMultipartUpload,
+        abortMultipartUpload: definition.abortMultipartUpload,
+    };
+}
+export function assertUploadProvider(provider) {
+    if (!provider) {
+        throw providerError('Upload provider is required for provider-based uploads.');
+    }
+    return provider;
+}
+export function assertProviderMultipartSupported(provider) {
+    if (typeof provider.createMultipartUpload !== 'function') {
+        throw providerError('Provider must implement createMultipartUpload.');
+    }
+    if (typeof provider.signPart !== 'function') {
+        throw providerError('Provider must implement signPart.');
+    }
+    if (typeof provider.completeMultipartUpload !== 'function') {
+        throw providerError('Provider must implement completeMultipartUpload.');
+    }
+}
+export function assertProviderDirectUploadSupported(provider) {
+    if (typeof provider.getUploadUrl !== 'function') {
+        throw providerError('Provider must implement getUploadUrl for direct signed-URL uploads.');
+    }
+}
+function providerError(message) {
+    return Object.assign(new Error(message), {
+        code: 'PROVIDER_ERROR',
+        retryable: false,
+        taskId: '',
+    });
+}
+//# sourceMappingURL=defineUploadProvider.js.map

package/build/providers/defineUploadProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineUploadProvider.js","sourceRoot":"","sources":["../../src/providers/defineUploadProvider.ts"],"names":[],"mappings":"AA+BA,MAAM,UAAU,oBAAoB,CAAC,UAAoC;IACvE,OAAO;QACL,YAAY,EAAE,UAAU,CAAC,YAAY;QACrC,qBAAqB,EAAE,UAAU,CAAC,qBAAqB;QACvD,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,uBAAuB,EAAE,UAAU,CAAC,uBAAuB;QAC3D,oBAAoB,EAAE,UAAU,CAAC,oBAAoB;KACtD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAoC;IACvE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,aAAa,CAAC,yDAAyD,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,QAAwB;IACvE,IAAI,OAAO,QAAQ,CAAC,qBAAqB,KAAK,UAAU,EAAE,CAAC;QACzD,MAAM,aAAa,CAAC,gDAAgD,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,OAAO,QAAQ,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC5C,MAAM,aAAa,CAAC,mCAAmC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,OAAO,QAAQ,CAAC,uBAAuB,KAAK,UAAU,EAAE,CAAC;QAC3D,MAAM,aAAa,CAAC,kDAAkD,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mCAAmC,CAAC,QAAwB;IAC1E,IAAI,OAAO,QAAQ,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;QAChD,MAAM,aAAa,CAAC,qEAAqE,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CACpB,OAAe;IAEf,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE;QACvC,IAAI,EAAE,gBAAgB;QACtB,SAAS,EAAE,KAAK;QAChB,MAAM,EAAE,EAAE;KACX,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type {\n  CompleteMultipartInput,\n  CompleteMultipartResult,\n  CreateMultipartInput,\n  CreateMultipartResult,\n  SignPartInput,\n  SignedPartResult,\n  UploadHttpMethod,\n  UploadProvider,\n} from '../Uploados.types';\n\nexport type ProviderUploadUrlInput = {\n  key: string;\n  contentType?: string;\n  metadata?: Record<string, string>;\n};\n\nexport type ProviderUploadUrlResult = {\n  url: string;\n  method?: UploadHttpMethod;\n  headers?: Record<string, string>;\n};\n\nexport type UploadProviderDefinition = {\n  getUploadUrl?: (input: ProviderUploadUrlInput) => Promise<ProviderUploadUrlResult>;\n  createMultipartUpload?: (input: CreateMultipartInput) => Promise<CreateMultipartResult>;\n  signPart?: (input: SignPartInput) => Promise<SignedPartResult>;\n  completeMultipartUpload?: (input: CompleteMultipartInput) => Promise<CompleteMultipartResult>;\n  abortMultipartUpload?: (input: { key: string; uploadId: string }) => Promise<void>;\n};\n\nexport function defineUploadProvider(definition: UploadProviderDefinition): UploadProvider {\n  return {\n    getUploadUrl: definition.getUploadUrl,\n    createMultipartUpload: definition.createMultipartUpload,\n    signPart: definition.signPart,\n    completeMultipartUpload: definition.completeMultipartUpload,\n    abortMultipartUpload: definition.abortMultipartUpload,\n  };\n}\n\nexport function assertUploadProvider(provider: UploadProvider | undefined): UploadProvider {\n  if (!provider) {\n    throw providerError('Upload provider is required for provider-based uploads.');\n  }\n  return provider;\n}\n\nexport function assertProviderMultipartSupported(provider: UploadProvider): void {\n  if (typeof provider.createMultipartUpload !== 'function') {\n    throw providerError('Provider must implement createMultipartUpload.');\n  }\n  if (typeof provider.signPart !== 'function') {\n    throw providerError('Provider must implement signPart.');\n  }\n  if (typeof provider.completeMultipartUpload !== 'function') {\n    throw providerError('Provider must implement completeMultipartUpload.');\n  }\n}\n\nexport function assertProviderDirectUploadSupported(provider: UploadProvider): void {\n  if (typeof provider.getUploadUrl !== 'function') {\n    throw providerError('Provider must implement getUploadUrl for direct signed-URL uploads.');\n  }\n}\n\nfunction providerError(\n  message: string\n): Error & { code: string; retryable: boolean; taskId: string } {\n  return Object.assign(new Error(message), {\n    code: 'PROVIDER_ERROR',\n    retryable: false,\n    taskId: '',\n  });\n}\n"]}

package/build/providers/multipartPlan.d.ts

@@ -0,0 +1,10 @@
+export declare const DEFAULT_MULTIPART_PART_SIZE: number;
+export declare const MIN_MULTIPART_PART_SIZE: number;
+export type MultipartUploadPlan = {
+    partSize: number;
+    partCount: number;
+    totalBytes: number;
+};
+export declare function createMultipartUploadPlan(totalBytes: number, partSize?: number): MultipartUploadPlan;
+export declare function validateMultipartPartNumber(partNumber: number, partCount: number): void;
+//# sourceMappingURL=multipartPlan.d.ts.map

package/build/providers/multipartPlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipartPlan.d.ts","sourceRoot":"","sources":["../../src/providers/multipartPlan.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,QAAkB,CAAC;AAC3D,eAAO,MAAM,uBAAuB,QAAkB,CAAC;AAEvD,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,MAAoC,GAC7C,mBAAmB,CAiBrB;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAWvF"}

package/build/providers/multipartPlan.js

@@ -0,0 +1,28 @@
+export const DEFAULT_MULTIPART_PART_SIZE = 8 * 1024 * 1024;
+export const MIN_MULTIPART_PART_SIZE = 5 * 1024 * 1024;
+export function createMultipartUploadPlan(totalBytes, partSize = DEFAULT_MULTIPART_PART_SIZE) {
+    if (!Number.isFinite(totalBytes) || totalBytes <= 0) {
+        throw Object.assign(new Error('File size must be greater than zero for multipart uploads.'), {
+            code: 'FILE_NOT_FOUND',
+            retryable: false,
+            taskId: '',
+        });
+    }
+    const normalizedPartSize = Math.max(MIN_MULTIPART_PART_SIZE, Math.floor(partSize));
+    const partCount = Math.max(1, Math.ceil(totalBytes / normalizedPartSize));
+    return {
+        partSize: normalizedPartSize,
+        partCount,
+        totalBytes,
+    };
+}
+export function validateMultipartPartNumber(partNumber, partCount) {
+    if (!Number.isInteger(partNumber) || partNumber < 1 || partNumber > partCount) {
+        throw Object.assign(new Error(`Invalid multipart part number ${partNumber}. Expected 1..${partCount}.`), {
+            code: 'MULTIPART_FAILED',
+            retryable: false,
+            taskId: '',
+        });
+    }
+}
+//# sourceMappingURL=multipartPlan.js.map

package/build/providers/multipartPlan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipartPlan.js","sourceRoot":"","sources":["../../src/providers/multipartPlan.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAC3D,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAQvD,MAAM,UAAU,yBAAyB,CACvC,UAAkB,EAClB,WAAmB,2BAA2B;IAE9C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,4DAA4D,CAAC,EAAE;YAC3F,IAAI,EAAE,gBAAgB;YACtB,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,EAAE;SACX,CAAC,CAAC;IACL,CAAC;IAED,MAAM,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAAC,uBAAuB,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,kBAAkB,CAAC,CAAC,CAAC;IAE1E,OAAO;QACL,QAAQ,EAAE,kBAAkB;QAC5B,SAAS;QACT,UAAU;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,UAAkB,EAAE,SAAiB;IAC/E,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,SAAS,EAAE,CAAC;QAC9E,MAAM,MAAM,CAAC,MAAM,CACjB,IAAI,KAAK,CAAC,iCAAiC,UAAU,iBAAiB,SAAS,GAAG,CAAC,EACnF;YACE,IAAI,EAAE,kBAAkB;YACxB,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,EAAE;SACX,CACF,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["export const DEFAULT_MULTIPART_PART_SIZE = 8 * 1024 * 1024;\nexport const MIN_MULTIPART_PART_SIZE = 5 * 1024 * 1024;\n\nexport type MultipartUploadPlan = {\n  partSize: number;\n  partCount: number;\n  totalBytes: number;\n};\n\nexport function createMultipartUploadPlan(\n  totalBytes: number,\n  partSize: number = DEFAULT_MULTIPART_PART_SIZE\n): MultipartUploadPlan {\n  if (!Number.isFinite(totalBytes) || totalBytes <= 0) {\n    throw Object.assign(new Error('File size must be greater than zero for multipart uploads.'), {\n      code: 'FILE_NOT_FOUND',\n      retryable: false,\n      taskId: '',\n    });\n  }\n\n  const normalizedPartSize = Math.max(MIN_MULTIPART_PART_SIZE, Math.floor(partSize));\n  const partCount = Math.max(1, Math.ceil(totalBytes / normalizedPartSize));\n\n  return {\n    partSize: normalizedPartSize,\n    partCount,\n    totalBytes,\n  };\n}\n\nexport function validateMultipartPartNumber(partNumber: number, partCount: number): void {\n  if (!Number.isInteger(partNumber) || partNumber < 1 || partNumber > partCount) {\n    throw Object.assign(\n      new Error(`Invalid multipart part number ${partNumber}. Expected 1..${partCount}.`),\n      {\n        code: 'MULTIPART_FAILED',\n        retryable: false,\n        taskId: '',\n      }\n    );\n  }\n}\n"]}

package/eslint.config.cjs

@@ -0,0 +1,5 @@
+const { defineConfig } = require('eslint/config');
+const universe = require('eslint-config-universe/flat/native');
+const universeWeb = require('eslint-config-universe/flat/web');
+
+module.exports = defineConfig([{ ignores: ['build'] }, ...universe, ...universeWeb]);

package/expo-module.config.json

@@ -0,0 +1,10 @@
+{
+  "platforms": ["apple", "android"],
+  "apple": {
+    "modules": ["UploadosModule"],
+    "appDelegateSubscribers": ["UploadosAppDelegate"]
+  },
+  "android": {
+    "modules": ["expo.modules.uploados.UploadosModule"]
+  }
+}

package/ios/Upload/CompressionPipeline.swift

@@ -0,0 +1,183 @@
+import Foundation
+import ImageIO
+import UIKit
+import UniformTypeIdentifiers
+
+enum CompressionPreset: String, Codable {
+  case balanced
+  case inspection
+  case avatar
+
+  init(raw: String) {
+    self = CompressionPreset(rawValue: raw) ?? .balanced
+  }
+
+  var maxDimension: CGFloat {
+    switch self {
+    case .balanced:
+      return 2048
+    case .inspection:
+      return 4096
+    case .avatar:
+      return 512
+    }
+  }
+
+  var jpegQuality: CGFloat {
+    switch self {
+    case .balanced:
+      return 0.82
+    case .inspection:
+      return 0.92
+    case .avatar:
+      return 0.85
+    }
+  }
+}
+
+struct CompressionStats: Codable {
+  let preset: CompressionPreset
+  let originalSize: Int
+  let optimizedSize: Int
+  let format: String
+
+  func toDictionary() -> [String: Any] {
+    [
+      "preset": preset.rawValue,
+      "originalSize": originalSize,
+      "optimizedSize": optimizedSize,
+      "format": format,
+    ]
+  }
+}
+
+struct CompressionResult {
+  let outputURL: URL
+  let stats: CompressionStats
+}
+
+enum CompressionPipeline {
+  private static let optimizedDirectoryName = "optimized"
+
+  static func optimizedDirectoryURL() -> URL? {
+    FileManager.default.urls(for: .applicationSupportDirectory, in: .userDomainMask).first?
+      .appendingPathComponent("uploados", isDirectory: true)
+      .appendingPathComponent(optimizedDirectoryName, isDirectory: true)
+  }
+
+  static func isSdkOwnedOptimizedPath(_ path: String) -> Bool {
+    guard let root = optimizedDirectoryURL()?.path else {
+      return false
+    }
+    return path.hasPrefix(root + "/") || path == root
+  }
+
+  static func cleanupOptimizedFile(path: String) {
+    guard isSdkOwnedOptimizedPath(path) else {
+      return
+    }
+    try? FileManager.default.removeItem(atPath: path)
+  }
+
+  static func compress(sourceURL: URL, taskId: String, preset: CompressionPreset) throws -> CompressionResult {
+    guard let directory = optimizedDirectoryURL() else {
+      throw CompressionPipelineError.directoryUnavailable
+    }
+    try FileManager.default.createDirectory(at: directory, withIntermediateDirectories: true)
+    let destination = directory.appendingPathComponent("\(taskId).jpg")
+    if FileManager.default.fileExists(atPath: destination.path) {
+      let attributes = try FileManager.default.attributesOfItem(atPath: sourceURL.path)
+      let originalSize = (attributes[.size] as? NSNumber)?.intValue ?? 0
+      let optimizedAttributes = try FileManager.default.attributesOfItem(atPath: destination.path)
+      let optimizedSize = (optimizedAttributes[.size] as? NSNumber)?.intValue ?? 0
+      return CompressionResult(
+        outputURL: destination,
+        stats: CompressionStats(
+          preset: preset,
+          originalSize: originalSize,
+          optimizedSize: optimizedSize,
+          format: "jpeg"
+        )
+      )
+    }
+
+    guard let source = CGImageSourceCreateWithURL(sourceURL as CFURL, nil) else {
+      throw CompressionPipelineError.unsupportedInput
+    }
+    guard let properties = CGImageSourceCopyPropertiesAtIndex(source, 0, nil) as? [CFString: Any],
+          let width = properties[kCGImagePropertyPixelWidth] as? NSNumber,
+          let height = properties[kCGImagePropertyPixelHeight] as? NSNumber else {
+      throw CompressionPipelineError.unsupportedInput
+    }
+
+    let originalAttributes = try FileManager.default.attributesOfItem(atPath: sourceURL.path)
+    let originalSize = (originalAttributes[.size] as? NSNumber)?.intValue ?? 0
+    let maxDimension = preset.maxDimension
+    let scale = min(
+      1,
+      maxDimension / max(CGFloat(truncating: width), CGFloat(truncating: height))
+    )
+    let targetWidth = Int(CGFloat(truncating: width) * scale)
+    let targetHeight = Int(CGFloat(truncating: height) * scale)
+
+    let options: [CFString: Any] = [
+      kCGImageSourceCreateThumbnailFromImageAlways: true,
+      kCGImageSourceCreateThumbnailWithTransform: true,
+      kCGImageSourceThumbnailMaxPixelSize: max(targetWidth, targetHeight),
+    ]
+    guard let image = CGImageSourceCreateThumbnailAtIndex(source, 0, options as CFDictionary) else {
+      throw CompressionPipelineError.compressionFailed
+    }
+
+    guard let destinationRef = CGImageDestinationCreateWithURL(
+      destination as CFURL,
+      UTType.jpeg.identifier as CFString,
+      1,
+      nil
+    ) else {
+      throw CompressionPipelineError.compressionFailed
+    }
+
+    let jpegProperties: [CFString: Any] = [
+      kCGImageDestinationLossyCompressionQuality: preset.jpegQuality,
+      kCGImagePropertyOrientation: properties[kCGImagePropertyOrientation] ?? 1,
+    ]
+    CGImageDestinationAddImage(destinationRef, image, jpegProperties as CFDictionary)
+    guard CGImageDestinationFinalize(destinationRef) else {
+      throw CompressionPipelineError.compressionFailed
+    }
+
+    let optimizedAttributes = try FileManager.default.attributesOfItem(atPath: destination.path)
+    let optimizedSize = (optimizedAttributes[.size] as? NSNumber)?.intValue ?? 0
+    guard optimizedSize > 0 else {
+      throw CompressionPipelineError.compressionFailed
+    }
+
+    return CompressionResult(
+      outputURL: destination,
+      stats: CompressionStats(
+        preset: preset,
+        originalSize: originalSize,
+        optimizedSize: optimizedSize,
+        format: "jpeg"
+      )
+    )
+  }
+}
+
+enum CompressionPipelineError: Error, LocalizedError {
+  case directoryUnavailable
+  case unsupportedInput
+  case compressionFailed
+
+  var errorDescription: String? {
+    switch self {
+    case .directoryUnavailable:
+      return "Compression output directory is unavailable."
+    case .unsupportedInput:
+      return "The selected file is not a supported image format."
+    case .compressionFailed:
+      return "Image compression failed."
+    }
+  }
+}

package/ios/Upload/FileStager.swift

@@ -0,0 +1,67 @@
+import Foundation
+
+enum FileStager {
+  private static let stagedDirectoryName = "staged"
+
+  static func stagedDirectoryURL() -> URL? {
+    FileManager.default.urls(for: .applicationSupportDirectory, in: .userDomainMask).first?
+      .appendingPathComponent("uploados", isDirectory: true)
+      .appendingPathComponent(stagedDirectoryName, isDirectory: true)
+  }
+
+  static func needsStaging(uri: String, fileURL: URL) -> Bool {
+    if uri.hasPrefix("content://") {
+      return true
+    }
+    let path = fileURL.path
+    if path.contains("-Inbox/") {
+      return true
+    }
+    if path.contains("/tmp/") {
+      return true
+    }
+    if path.contains("/Library/Caches/") {
+      return true
+    }
+    return false
+  }
+
+  static func stageFile(sourceURL: URL, taskId: String) throws -> URL {
+    guard let directory = stagedDirectoryURL() else {
+      throw FileStagerError.directoryUnavailable
+    }
+    try FileManager.default.createDirectory(at: directory, withIntermediateDirectories: true)
+    let ext = sourceURL.pathExtension.isEmpty ? "" : ".\(sourceURL.pathExtension)"
+    let destination = directory.appendingPathComponent("\(taskId)\(ext)")
+    if FileManager.default.fileExists(atPath: destination.path) {
+      return destination
+    }
+    try FileManager.default.copyItem(at: sourceURL, to: destination)
+    return destination
+  }
+
+  static func isSdkOwnedStagedPath(_ path: String) -> Bool {
+    guard let stagedRoot = stagedDirectoryURL()?.path else {
+      return false
+    }
+    return path.hasPrefix(stagedRoot + "/") || path == stagedRoot
+  }
+
+  static func cleanupStagedFile(path: String) {
+    guard isSdkOwnedStagedPath(path) else {
+      return
+    }
+    try? FileManager.default.removeItem(atPath: path)
+  }
+}
+
+enum FileStagerError: Error, LocalizedError {
+  case directoryUnavailable
+
+  var errorDescription: String? {
+    switch self {
+    case .directoryUnavailable:
+      return "Upload staging directory is unavailable."
+    }
+  }
+}