stratal 0.0.15 → 0.0.17

package/dist/storage/providers/index.d.mts

@@ -0,0 +1,272 @@
+import { _ as StorageEntry, f as DownloadResult, i as UploadResult, n as StreamingBlobPayloadInputTypes, r as UploadOptions, s as PresignedUrlResult, t as IStorageProvider } from "../../storage-provider.interface-0IqcdhBf.mjs";
+
+//#region src/storage/providers/s3-multipart-provider.interface.d.ts
+/**
+ * Options for creating a multipart upload
+ */
+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
+ */
+interface CreateMultipartResult {
+  /** S3 upload ID for subsequent part uploads */
+  uploadId: string;
+  /** Object key */
+  key: string;
+}
+/**
+ * Result of uploading a part
+ */
+interface UploadPartResult {
+  /** ETag returned by S3 */
+  etag: string;
+  /** Part number */
+  partNumber: number;
+}
+/**
+ * Part info for completing multipart upload
+ */
+interface CompletedPart {
+  /** ETag from uploadPart */
+  etag: string;
+  /** Part number */
+  partNumber: number;
+}
+/**
+ * Result of completing a multipart upload
+ */
+interface CompleteMultipartResult {
+  /** S3 location URL */
+  location?: string;
+  /** Object key */
+  key: string;
+}
+/**
+ * Individual part info from listParts
+ */
+interface PartInfo {
+  /** Part number */
+  partNumber: number;
+  /** ETag */
+  etag: string;
+  /** Part size in bytes */
+  size: number;
+}
+/**
+ * Result of listing parts
+ */
+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
+ */
+interface MultipartUploadInfo {
+  /** Object key */
+  key: string;
+  /** Upload ID */
+  uploadId: string;
+  /** When the upload was initiated */
+  initiated?: Date;
+}
+/**
+ * Result of listing multipart uploads
+ */
+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
+ */
+interface HeadObjectResult {
+  /** Object size in bytes */
+  size: number;
+  /** Content type */
+  contentType?: string;
+  /** Custom metadata */
+  metadata?: Record<string, string>;
+}
+/**
+ * Result of batch delete
+ */
+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.
+ */
+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;
+}
+//#endregion
+//#region src/storage/providers/s3-storage.provider.d.ts
+/**
+ * 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
+ */
+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>;
+}
+//#endregion
+export { CompleteMultipartResult, CompletedPart, CreateMultipartOptions, CreateMultipartResult, DeleteObjectsResult, HeadObjectResult, IS3MultipartProvider, IStorageProvider, ListMultipartUploadsResult, ListPartsResult, MultipartUploadInfo, PartInfo, S3StorageProvider, StreamingBlobPayloadInputTypes, UploadPartResult };
+//# sourceMappingURL=index.d.mts.map

package/dist/storage/providers/index.d.mts.map

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

package/dist/storage/providers/index.mjs

@@ -0,0 +1,5 @@
+import "../../errors-DSKapqD8.mjs";
+import "../../logger-CGT91VY6.mjs";
+import "../../errors-DuAR5Wke.mjs";
+import { t as S3StorageProvider } from "../../s3-storage.provider-CttzNnDR.mjs";
+export { S3StorageProvider };