stratal 0.0.1

package/dist/storage/providers/s3-multipart-provider.interface.d.ts

@@ -0,0 +1,194 @@
+import type { IStorageProvider } from './storage-provider.interface';
+/**
+ * Options for creating a multipart upload
+ */
+export interface CreateMultipartOptions {
+    /** Content type (MIME type) */
+    contentType?: string;
+    /** Cache control header */
+    cacheControl?: string;
+    /** Custom S3 metadata */
+    metadata?: Record<string, string>;
+    /** S3 object tagging (key=value format) */
+    tagging?: string;
+}
+/**
+ * Result of creating a multipart upload
+ */
+export interface CreateMultipartResult {
+    /** S3 upload ID for subsequent part uploads */
+    uploadId: string;
+    /** Object key */
+    key: string;
+}
+/**
+ * Result of uploading a part
+ */
+export interface UploadPartResult {
+    /** ETag returned by S3 */
+    etag: string;
+    /** Part number */
+    partNumber: number;
+}
+/**
+ * Part info for completing multipart upload
+ */
+export interface CompletedPart {
+    /** ETag from uploadPart */
+    etag: string;
+    /** Part number */
+    partNumber: number;
+}
+/**
+ * Result of completing a multipart upload
+ */
+export interface CompleteMultipartResult {
+    /** S3 location URL */
+    location?: string;
+    /** Object key */
+    key: string;
+}
+/**
+ * Individual part info from listParts
+ */
+export interface PartInfo {
+    /** Part number */
+    partNumber: number;
+    /** ETag */
+    etag: string;
+    /** Part size in bytes */
+    size: number;
+}
+/**
+ * Result of listing parts
+ */
+export interface ListPartsResult {
+    /** List of uploaded parts */
+    parts: PartInfo[];
+    /** Whether there are more parts */
+    isTruncated: boolean;
+    /** Marker for next page */
+    nextPartNumberMarker?: string;
+}
+/**
+ * Individual upload info from listMultipartUploads
+ */
+export interface MultipartUploadInfo {
+    /** Object key */
+    key: string;
+    /** Upload ID */
+    uploadId: string;
+    /** When the upload was initiated */
+    initiated?: Date;
+}
+/**
+ * Result of listing multipart uploads
+ */
+export interface ListMultipartUploadsResult {
+    /** List of in-progress uploads */
+    uploads: MultipartUploadInfo[];
+    /** Whether there are more uploads */
+    isTruncated: boolean;
+    /** Marker for next page (key) */
+    nextKeyMarker?: string;
+    /** Marker for next page (uploadId) */
+    nextUploadIdMarker?: string;
+}
+/**
+ * Result of headObject
+ */
+export interface HeadObjectResult {
+    /** Object size in bytes */
+    size: number;
+    /** Content type */
+    contentType?: string;
+    /** Custom metadata */
+    metadata?: Record<string, string>;
+}
+/**
+ * Result of batch delete
+ */
+export interface DeleteObjectsResult {
+    /** Number of objects deleted */
+    deleted: number;
+    /** Errors that occurred */
+    errors: {
+        key: string;
+        code: string;
+        message: string;
+    }[];
+}
+/**
+ * S3-specific storage provider interface with multipart upload support
+ *
+ * Extends the generic IStorageProvider with S3 multipart upload operations.
+ * This interface is S3-specific - other providers (GCS, local) would have
+ * their own resumable upload interfaces if needed.
+ */
+export interface IS3MultipartProvider extends IStorageProvider {
+    /**
+     * Create a multipart upload
+     * @param key - Object key
+     * @param options - Upload options
+     * @returns Upload ID and key
+     */
+    createMultipartUpload(key: string, options?: CreateMultipartOptions): Promise<CreateMultipartResult>;
+    /**
+     * Upload a part to an existing multipart upload
+     * @param key - Object key
+     * @param uploadId - Upload ID from createMultipartUpload
+     * @param partNumber - Part number (1-10000)
+     * @param body - Part data
+     * @returns ETag and part number
+     */
+    uploadPart(key: string, uploadId: string, partNumber: number, body: Uint8Array): Promise<UploadPartResult>;
+    /**
+     * Complete a multipart upload
+     * @param key - Object key
+     * @param uploadId - Upload ID
+     * @param parts - List of completed parts with ETags
+     * @returns Location and key
+     */
+    completeMultipartUpload(key: string, uploadId: string, parts: CompletedPart[]): Promise<CompleteMultipartResult>;
+    /**
+     * Abort a multipart upload
+     * @param key - Object key
+     * @param uploadId - Upload ID
+     */
+    abortMultipartUpload(key: string, uploadId: string): Promise<void>;
+    /**
+     * List parts of a multipart upload
+     * @param key - Object key
+     * @param uploadId - Upload ID
+     * @param partNumberMarker - Optional marker for pagination
+     * @returns List of parts
+     */
+    listParts(key: string, uploadId: string, partNumberMarker?: string): Promise<ListPartsResult>;
+    /**
+     * List all in-progress multipart uploads
+     * @param keyMarker - Optional key marker for pagination
+     * @param uploadIdMarker - Optional upload ID marker for pagination
+     * @returns List of uploads
+     */
+    listMultipartUploads(keyMarker?: string, uploadIdMarker?: string): Promise<ListMultipartUploadsResult>;
+    /**
+     * Get object metadata without downloading the body
+     * Unlike exists() which returns boolean, this returns actual metadata
+     * @param key - Object key
+     * @returns Object metadata or null if not found
+     */
+    headObject(key: string): Promise<HeadObjectResult | null>;
+    /**
+     * Delete multiple objects in a single request
+     * More efficient than individual delete() calls
+     * @param keys - Array of object keys
+     * @returns Delete results
+     */
+    deleteObjects(keys: string[]): Promise<DeleteObjectsResult>;
+    /**
+     * Get the bucket name
+     * @returns Bucket name from configuration
+     */
+    getBucket(): string;
+}
+//# sourceMappingURL=s3-multipart-provider.interface.d.ts.map

package/dist/storage/providers/s3-multipart-provider.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-multipart-provider.interface.d.ts","sourceRoot":"","sources":["../../../src/storage/providers/s3-multipart-provider.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAEpE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAA;IAChB,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,mCAAmC;IACnC,WAAW,EAAE,OAAO,CAAA;IACpB,2BAA2B;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,oCAAoC;IACpC,SAAS,CAAC,EAAE,IAAI,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,kCAAkC;IAClC,OAAO,EAAE,mBAAmB,EAAE,CAAA;IAC9B,qCAAqC;IACrC,WAAW,EAAE,OAAO,CAAA;IACpB,iCAAiC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,sCAAsC;IACtC,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,2BAA2B;IAC3B,MAAM,EAAE;QACN,GAAG,EAAE,MAAM,CAAA;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;KAChB,EAAE,CAAA;CACJ;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAK5D;;;;;OAKG;IACH,qBAAqB,CACnB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CAAA;IAEjC;;;;;;;OAOG;IACH,UAAU,CACR,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAE5B;;;;;;OAMG;IACH,uBAAuB,CACrB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EAAE,GACrB,OAAO,CAAC,uBAAuB,CAAC,CAAA;IAEnC;;;;OAIG;IACH,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAElE;;;;;;OAMG;IACH,SAAS,CACP,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,eAAe,CAAC,CAAA;IAE3B;;;;;OAKG;IACH,oBAAoB,CAClB,SAAS,CAAC,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,0BAA0B,CAAC,CAAA;IAMtC;;;;;OAKG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;IAEzD;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAM3D;;;OAGG;IACH,SAAS,IAAI,MAAM,CAAA;CACpB"}

package/dist/storage/providers/s3-multipart-provider.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=s3-multipart-provider.interface.js.map

package/dist/storage/providers/s3-multipart-provider.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-multipart-provider.interface.js","sourceRoot":"","sources":["../../../src/storage/providers/s3-multipart-provider.interface.ts"],"names":[],"mappings":""}

package/dist/storage/providers/s3-storage.provider.d.ts

@@ -0,0 +1,77 @@
+import type { StorageEntry } from 'stratal';
+import type { DownloadResult, PresignedUrlResult, UploadOptions, UploadResult } from '../contracts';
+import type { CompletedPart, CompleteMultipartResult, CreateMultipartOptions, CreateMultipartResult, DeleteObjectsResult, HeadObjectResult, IS3MultipartProvider, ListMultipartUploadsResult, ListPartsResult, UploadPartResult } from './s3-multipart-provider.interface';
+import type { StreamingBlobPayloadInputTypes } from './storage-provider.interface';
+/**
+ * S3 Storage Provider
+ * Implements storage operations using AWS SDK for S3-compatible storage
+ * Works with AWS S3, Cloudflare R2, MinIO, and other S3-compatible services
+ *
+ * Implements IS3MultipartProvider for multipart upload support needed by TUS
+ */
+export declare class S3StorageProvider implements IS3MultipartProvider {
+    private readonly client;
+    private readonly bucket;
+    private readonly disk;
+    constructor(config: StorageEntry);
+    upload(body: StreamingBlobPayloadInputTypes, path: string, options: UploadOptions): Promise<UploadResult>;
+    download(path: string): Promise<DownloadResult>;
+    delete(path: string): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    getPresignedUrl(path: string, method: 'GET' | 'PUT' | 'DELETE' | 'HEAD', expiresIn: number): Promise<PresignedUrlResult>;
+    /**
+     * Chunked upload for streaming data without known size
+     * Uses @aws-sdk/lib-storage for multipart upload handling
+     *
+     * Benefits:
+     * - Handles unknown Content-Length automatically
+     * - Automatic retry on transient failures
+     * - Cleanup of partial uploads on error
+     * - Works with S3-compatible storage (R2, MinIO, RustFS)
+     *
+     * @param body - Content to upload (stream or buffer)
+     * @param path - Full path including disk root
+     * @param options - Upload options (mimeType required, size optional)
+     * @returns Upload result with metadata
+     */
+    chunkedUpload(body: StreamingBlobPayloadInputTypes, path: string, options: Omit<UploadOptions, 'size'> & {
+        size?: number;
+    }): Promise<UploadResult>;
+    /**
+     * Get the bucket name
+     */
+    getBucket(): string;
+    /**
+     * Get object metadata without downloading the body
+     */
+    headObject(key: string): Promise<HeadObjectResult | null>;
+    /**
+     * Delete multiple objects in a single request
+     */
+    deleteObjects(keys: string[]): Promise<DeleteObjectsResult>;
+    /**
+     * Create a multipart upload
+     */
+    createMultipartUpload(key: string, options?: CreateMultipartOptions): Promise<CreateMultipartResult>;
+    /**
+     * Upload a part to an existing multipart upload
+     */
+    uploadPart(key: string, uploadId: string, partNumber: number, body: Uint8Array): Promise<UploadPartResult>;
+    /**
+     * Complete a multipart upload
+     */
+    completeMultipartUpload(key: string, uploadId: string, parts: CompletedPart[]): Promise<CompleteMultipartResult>;
+    /**
+     * Abort a multipart upload
+     */
+    abortMultipartUpload(key: string, uploadId: string): Promise<void>;
+    /**
+     * List parts of a multipart upload
+     */
+    listParts(key: string, uploadId: string, partNumberMarker?: string): Promise<ListPartsResult>;
+    /**
+     * List all in-progress multipart uploads
+     */
+    listMultipartUploads(keyMarker?: string, uploadIdMarker?: string): Promise<ListMultipartUploadsResult>;
+}
+//# sourceMappingURL=s3-storage.provider.d.ts.map

package/dist/storage/providers/s3-storage.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-storage.provider.d.ts","sourceRoot":"","sources":["../../../src/storage/providers/s3-storage.provider.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEnG,OAAO,KAAK,EACV,aAAa,EACb,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,0BAA0B,EAC1B,eAAe,EACf,gBAAgB,EACjB,MAAM,mCAAmC,CAAA;AAC1C,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAA;AAElF;;;;;;GAMG;AACH,qBAAa,iBAAkB,YAAW,oBAAoB;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAQ;gBAEjB,MAAM,EAAE,YAAY;IAgB1B,MAAM,CACV,IAAI,EAAE,8BAA8B,EACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC;IAuBlB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAsB/C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASnC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAetC,eAAe,CACnB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,EACzC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC;IA4B9B;;;;;;;;;;;;;;OAcG;IACG,aAAa,CACjB,IAAI,EAAE,8BAA8B,EACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GACvD,OAAO,CAAC,YAAY,CAAC;IAyCxB;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAc/D;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAwBjE;;OAEG;IACG,qBAAqB,CACzB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,qBAAqB,CAAC;IAkBjC;;OAEG;IACG,UAAU,CACd,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,gBAAgB,CAAC;IAkB5B;;OAEG;IACG,uBAAuB,CAC3B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EAAE,GACrB,OAAO,CAAC,uBAAuB,CAAC;IAqBnC;;OAEG;IACG,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxE;;OAEG;IACG,SAAS,CACb,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,eAAe,CAAC;IAqB3B;;OAEG;IACG,oBAAoB,CACxB,SAAS,CAAC,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,0BAA0B,CAAC;CAoBvC"}

package/dist/storage/providers/s3-storage.provider.js

@@ -0,0 +1,310 @@
+import { AbortMultipartUploadCommand, CompleteMultipartUploadCommand, CreateMultipartUploadCommand, DeleteObjectCommand, DeleteObjectsCommand, GetObjectCommand, HeadObjectCommand, ListMultipartUploadsCommand, ListPartsCommand, PutObjectCommand, S3Client, UploadPartCommand } from '@aws-sdk/client-s3';
+import { Upload } from '@aws-sdk/lib-storage';
+import { getSignedUrl } from '@aws-sdk/s3-request-presigner';
+import { StorageResponseBodyMissingError } from '../errors';
+/**
+ * S3 Storage Provider
+ * Implements storage operations using AWS SDK for S3-compatible storage
+ * Works with AWS S3, Cloudflare R2, MinIO, and other S3-compatible services
+ *
+ * Implements IS3MultipartProvider for multipart upload support needed by TUS
+ */
+export class S3StorageProvider {
+    client;
+    bucket;
+    disk;
+    constructor(config) {
+        // Configure S3Client for S3-compatible storage
+        this.client = new S3Client({
+            region: config.region || 'auto',
+            endpoint: config.endpoint,
+            credentials: {
+                accessKeyId: config.accessKeyId,
+                secretAccessKey: config.secretAccessKey,
+            },
+            forcePathStyle: true,
+        });
+        this.bucket = config.bucket;
+        this.disk = config.disk;
+    }
+    async upload(body, path, options) {
+        const command = new PutObjectCommand({
+            Bucket: this.bucket,
+            Key: path,
+            Body: body,
+            ContentType: options.mimeType,
+            ContentLength: options.size,
+            Metadata: options.metadata,
+            Tagging: options.tagging,
+        });
+        await this.client.send(command);
+        return {
+            path,
+            disk: this.disk,
+            fullPath: `${this.bucket}/${path}`,
+            size: options.size,
+            mimeType: options.mimeType ?? 'application/octet-stream',
+            uploadedAt: new Date(),
+        };
+    }
+    async download(path) {
+        const command = new GetObjectCommand({
+            Bucket: this.bucket,
+            Key: path,
+        });
+        const response = await this.client.send(command);
+        if (!response.Body) {
+            throw new StorageResponseBodyMissingError(path);
+        }
+        return {
+            toStream: () => response.Body?.transformToWebStream(),
+            contentType: response.ContentType ?? 'application/octet-stream',
+            size: response.ContentLength ?? 0,
+            metadata: response.Metadata,
+            toString: () => response.Body?.transformToString(),
+            toArrayBuffer: () => response.Body?.transformToByteArray(),
+        };
+    }
+    async delete(path) {
+        const command = new DeleteObjectCommand({
+            Bucket: this.bucket,
+            Key: path,
+        });
+        await this.client.send(command);
+    }
+    async exists(path) {
+        try {
+            const command = new HeadObjectCommand({
+                Bucket: this.bucket,
+                Key: path,
+            });
+            await this.client.send(command);
+            return true;
+        }
+        catch {
+            // HeadObject throws error if file doesn't exist
+            return false;
+        }
+    }
+    async getPresignedUrl(path, method, expiresIn) {
+        // Select appropriate command based on method
+        let command;
+        switch (method) {
+            case 'GET':
+                command = new GetObjectCommand({ Bucket: this.bucket, Key: path });
+                break;
+            case 'PUT':
+                command = new PutObjectCommand({ Bucket: this.bucket, Key: path });
+                break;
+            case 'DELETE':
+                command = new DeleteObjectCommand({ Bucket: this.bucket, Key: path });
+                break;
+            case 'HEAD':
+                command = new HeadObjectCommand({ Bucket: this.bucket, Key: path });
+                break;
+        }
+        const url = await getSignedUrl(this.client, command, { expiresIn });
+        return {
+            url,
+            expiresIn,
+            expiresAt: new Date(Date.now() + expiresIn * 1000),
+            method,
+        };
+    }
+    /**
+     * Chunked upload for streaming data without known size
+     * Uses @aws-sdk/lib-storage for multipart upload handling
+     *
+     * Benefits:
+     * - Handles unknown Content-Length automatically
+     * - Automatic retry on transient failures
+     * - Cleanup of partial uploads on error
+     * - Works with S3-compatible storage (R2, MinIO, RustFS)
+     *
+     * @param body - Content to upload (stream or buffer)
+     * @param path - Full path including disk root
+     * @param options - Upload options (mimeType required, size optional)
+     * @returns Upload result with metadata
+     */
+    async chunkedUpload(body, path, options) {
+        const upload = new Upload({
+            client: this.client,
+            params: {
+                Bucket: this.bucket,
+                Key: path,
+                Body: body,
+                ContentType: options.mimeType,
+            },
+            // Concurrency configuration
+            queueSize: 4,
+            // Part size: 5MB minimum for S3
+            partSize: 5 * 1024 * 1024,
+            // Don't leave orphaned parts on error
+            leavePartsOnError: false,
+        });
+        await upload.done();
+        // Get the actual uploaded size via HeadObject
+        const headResponse = await this.client.send(new HeadObjectCommand({
+            Bucket: this.bucket,
+            Key: path,
+        }));
+        return {
+            path,
+            disk: this.disk,
+            fullPath: `${this.bucket}/${path}`,
+            size: headResponse.ContentLength ?? options.size ?? 0,
+            mimeType: options.mimeType ?? 'application/octet-stream',
+            uploadedAt: new Date(),
+        };
+    }
+    // ============================================
+    // IS3MultipartProvider - Multipart upload methods
+    // ============================================
+    /**
+     * Get the bucket name
+     */
+    getBucket() {
+        return this.bucket;
+    }
+    /**
+     * Get object metadata without downloading the body
+     */
+    async headObject(key) {
+        const response = await this.client.send(new HeadObjectCommand({
+            Bucket: this.bucket,
+            Key: key,
+        }));
+        return {
+            size: response.ContentLength ?? 0,
+            contentType: response.ContentType,
+            metadata: response.Metadata,
+        };
+    }
+    /**
+     * Delete multiple objects in a single request
+     */
+    async deleteObjects(keys) {
+        if (keys.length === 0) {
+            return { deleted: 0, errors: [] };
+        }
+        const response = await this.client.send(new DeleteObjectsCommand({
+            Bucket: this.bucket,
+            Delete: {
+                Objects: keys.map((key) => ({ Key: key })),
+            },
+        }));
+        return {
+            deleted: response.Deleted?.length ?? 0,
+            errors: (response.Errors ?? []).map((e) => ({
+                key: e.Key ?? '',
+                code: e.Code ?? 'Unknown',
+                message: e.Message ?? 'Unknown error',
+            })),
+        };
+    }
+    /**
+     * Create a multipart upload
+     */
+    async createMultipartUpload(key, options) {
+        const response = await this.client.send(new CreateMultipartUploadCommand({
+            Bucket: this.bucket,
+            Key: key,
+            ContentType: options?.contentType,
+            CacheControl: options?.cacheControl,
+            Metadata: options?.metadata,
+            Tagging: options?.tagging,
+        }));
+        return {
+            uploadId: response.UploadId ?? '',
+            key: response.Key ?? '',
+        };
+    }
+    /**
+     * Upload a part to an existing multipart upload
+     */
+    async uploadPart(key, uploadId, partNumber, body) {
+        const response = await this.client.send(new UploadPartCommand({
+            Bucket: this.bucket,
+            Key: key,
+            UploadId: uploadId,
+            PartNumber: partNumber,
+            Body: body,
+            ContentLength: body.length,
+        }));
+        return {
+            etag: response.ETag ?? '',
+            partNumber,
+        };
+    }
+    /**
+     * Complete a multipart upload
+     */
+    async completeMultipartUpload(key, uploadId, parts) {
+        const response = await this.client.send(new CompleteMultipartUploadCommand({
+            Bucket: this.bucket,
+            Key: key,
+            UploadId: uploadId,
+            MultipartUpload: {
+                Parts: parts.map((p) => ({
+                    ETag: p.etag,
+                    PartNumber: p.partNumber,
+                })),
+            },
+        }));
+        return {
+            location: response.Location,
+            key: response.Key ?? '',
+        };
+    }
+    /**
+     * Abort a multipart upload
+     */
+    async abortMultipartUpload(key, uploadId) {
+        await this.client.send(new AbortMultipartUploadCommand({
+            Bucket: this.bucket,
+            Key: key,
+            UploadId: uploadId,
+        }));
+    }
+    /**
+     * List parts of a multipart upload
+     */
+    async listParts(key, uploadId, partNumberMarker) {
+        const response = await this.client.send(new ListPartsCommand({
+            Bucket: this.bucket,
+            Key: key,
+            UploadId: uploadId,
+            PartNumberMarker: partNumberMarker,
+        }));
+        return {
+            parts: (response.Parts ?? []).map((p) => ({
+                partNumber: p.PartNumber ?? 0,
+                etag: p.ETag ?? '',
+                size: p.Size ?? 0,
+            })),
+            isTruncated: response.IsTruncated ?? false,
+            nextPartNumberMarker: response.NextPartNumberMarker?.toString(),
+        };
+    }
+    /**
+     * List all in-progress multipart uploads
+     */
+    async listMultipartUploads(keyMarker, uploadIdMarker) {
+        const response = await this.client.send(new ListMultipartUploadsCommand({
+            Bucket: this.bucket,
+            KeyMarker: keyMarker,
+            UploadIdMarker: uploadIdMarker,
+        }));
+        return {
+            uploads: (response.Uploads ?? []).map((u) => ({
+                key: u.Key ?? '',
+                uploadId: u.UploadId ?? '',
+                initiated: u.Initiated,
+            })),
+            isTruncated: response.IsTruncated ?? false,
+            nextKeyMarker: response.NextKeyMarker,
+            nextUploadIdMarker: response.NextUploadIdMarker,
+        };
+    }
+}
+//# sourceMappingURL=s3-storage.provider.js.map

package/dist/storage/providers/s3-storage.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-storage.provider.js","sourceRoot":"","sources":["../../../src/storage/providers/s3-storage.provider.ts"],"names":[],"mappings":"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"}

package/dist/storage/providers/storage-provider.interface.d.ts

@@ -0,0 +1,58 @@
+import type { PutObjectCommandInput } from '@aws-sdk/client-s3';
+import type { DownloadResult, PresignedUrlResult, UploadOptions, UploadResult } from '../contracts';
+/**
+ * Streaming blob payload input types from AWS SDK
+ * Represents the types that can be used as the Body of a PutObjectCommand
+ */
+export type StreamingBlobPayloadInputTypes = PutObjectCommandInput['Body'];
+/**
+ * Storage provider interface
+ * Defines the contract for storage implementations (R2, S3, GCS, etc.)
+ */
+export interface IStorageProvider {
+    /**
+     * Upload content to storage
+     * @param body - Content to upload (stream, buffer, or string)
+     * @param path - Full path including disk root
+     * @param options - Upload options including size and mime type
+     * @returns Upload result with metadata
+     */
+    upload(body: StreamingBlobPayloadInputTypes, path: string, options: UploadOptions): Promise<UploadResult>;
+    /**
+     * Download a file from storage
+     * @param path - Full path to the file
+     * @returns Download result with stream and metadata
+     */
+    download(path: string): Promise<DownloadResult>;
+    /**
+     * Delete a file from storage
+     * @param path - Full path to the file
+     */
+    delete(path: string): Promise<void>;
+    /**
+     * Check if a file exists in storage
+     * @param path - Full path to the file
+     * @returns True if file exists, false otherwise
+     */
+    exists(path: string): Promise<boolean>;
+    /**
+     * Generate a presigned URL for temporary access
+     * @param path - Full path to the file
+     * @param method - HTTP method (GET, PUT, DELETE, HEAD)
+     * @param expiresIn - Expiry time in seconds (1-604800)
+     * @returns Presigned URL result
+     */
+    getPresignedUrl(path: string, method: 'GET' | 'PUT' | 'DELETE' | 'HEAD', expiresIn: number): Promise<PresignedUrlResult>;
+    /**
+     * Chunked upload for streaming data without known size
+     * Uses multipart upload under the hood for reliability
+     * @param body - Content to upload (stream or buffer)
+     * @param path - Full path including disk root
+     * @param options - Upload options (mimeType required, size optional)
+     * @returns Upload result with metadata
+     */
+    chunkedUpload(body: StreamingBlobPayloadInputTypes, path: string, options: Omit<UploadOptions, 'size'> & {
+        size?: number;
+    }): Promise<UploadResult>;
+}
+//# sourceMappingURL=storage-provider.interface.d.ts.map

package/dist/storage/providers/storage-provider.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-provider.interface.d.ts","sourceRoot":"","sources":["../../../src/storage/providers/storage-provider.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEnG;;;GAGG;AACH,MAAM,MAAM,8BAA8B,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAA;AAE1E;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,EAAE,8BAA8B,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAEzG;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAE/C;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnC;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAEtC;;;;;;OAMG;IACH,eAAe,CACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,EACzC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAE9B;;;;;;;OAOG;IACH,aAAa,CACX,IAAI,EAAE,8BAA8B,EACpC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GACvD,OAAO,CAAC,YAAY,CAAC,CAAA;CACzB"}