stratal 0.0.16 → 0.0.18

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

@@ -0,0 +1,273 @@
+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-YRtyYBxV.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 presigningClient;
+  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,2 @@
+import { t as S3StorageProvider } from "../../s3-storage.provider-BAhHDMI3.mjs";
+export { S3StorageProvider };

package/dist/{storage-By_ow2o_.mjs → storage-CJ-QOwNv.mjs}

@@ -1,8 +1,8 @@
-import { s as Scope } from "./errors-CtCi1wn6.mjs";
-import { i as Transient, n as __decorateParam, r as __decorateMetadata, t as __decorate } from "./decorate-D5j-d9_z.mjs";
-import { r as Module } from "./module-BgdxxzBe.mjs";
-import { a as withI18n, i as z } from "./validation-Bh875Lyg.mjs";
-import { a as InvalidDiskError, c as DiskNotConfiguredError, n as StorageProviderNotSupportedError, r as PresignedUrlInvalidExpiryError } from "./errors-H3TZnVeX.mjs";
+import { A as Scope } from "./errors--RBIvDXr.mjs";
+import { a as __decorate, o as __decorateParam, p as Transient, s as __decorateMetadata } from "./logger-c0ftIK4G.mjs";
+import { S as Module } from "./module-C3YZ-kZN.mjs";
+import { a as withI18n, i as z } from "./validation-B4bePOa_.mjs";
+import { a as InvalidDiskError, c as DiskNotConfiguredError, n as StorageProviderNotSupportedError, r as PresignedUrlInvalidExpiryError } from "./errors-B7hCnXgB.mjs";
 import { inject } from "tsyringe";
 //#region src/storage/storage.tokens.ts
 /**
@@ -63,7 +63,7 @@ let StorageManagerService = class StorageManagerService {
 	async createProvider(config) {
 		switch (config.provider) {
 			case "s3": {
-				const { S3StorageProvider } = await import("./s3-storage.provider-BLlzQYiJ.mjs");
+				const { S3StorageProvider } = await import("./s3-storage.provider-BAhHDMI3.mjs").then((n) => n.n);
 				return new S3StorageProvider(config);
 			}
 			case "gcs": throw new StorageProviderNotSupportedError(config.provider);
@@ -103,7 +103,6 @@ StorageManagerService = __decorate([
 ], StorageManagerService);
 //#endregion
 //#region src/storage/services/storage.service.ts
-var _ref;
 let StorageService = class StorageService {
 	constructor(storageManager, options) {
 		this.storageManager = storageManager;
@@ -285,7 +284,7 @@ StorageService = __decorate([
 	Transient(STORAGE_TOKENS.StorageService),
 	__decorateParam(0, inject(STORAGE_TOKENS.StorageManager)),
 	__decorateParam(1, inject(STORAGE_TOKENS.Options)),
-	__decorateMetadata("design:paramtypes", [typeof (_ref = typeof StorageManagerService !== "undefined" && StorageManagerService) === "function" ? _ref : Object, Object])
+	__decorateMetadata("design:paramtypes", [Object, Object])
 ], StorageService);
 //#endregion
 //#region src/storage/storage.module.ts
@@ -408,4 +407,4 @@ const uploadResultSchema = z.object({
 //#endregion
 export { deleteFileInputSchema as a, StorageManagerService as c, fileExistsInputSchema as i, STORAGE_TOKENS as l, getPresignedUrlInputSchema as n, StorageModule as o, presignedUrlResultSchema as r, StorageService as s, uploadResultSchema as t };
 
-//# sourceMappingURL=storage-By_ow2o_.mjs.map
+//# sourceMappingURL=storage-CJ-QOwNv.mjs.map

package/dist/storage-CJ-QOwNv.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-CJ-QOwNv.mjs","names":[],"sources":["../src/storage/storage.tokens.ts","../src/storage/services/storage-manager.service.ts","../src/storage/services/storage.service.ts","../src/storage/storage.module.ts","../src/storage/contracts/delete-file.input.ts","../src/storage/contracts/file-exists.input.ts","../src/storage/contracts/get-presigned-url.input.ts","../src/storage/contracts/upload-file.input.ts"],"sourcesContent":["/**\n * Dependency injection tokens for the Storage module\n * Using Symbol-based tokens to avoid magic strings\n */\nexport const STORAGE_TOKENS = {\n  Options: Symbol.for('stratal:storage:options'),\n  StorageService: Symbol.for('stratal:storage:service'),\n  StorageManager: Symbol.for('stratal:storage:manager'),\n} as const\n","import { inject } from 'tsyringe'\nimport { Transient } from '../../di/decorators'\nimport { DiskNotConfiguredError, StorageProviderNotSupportedError } from '../errors'\nimport type { IStorageProvider } from '../providers/storage-provider.interface'\nimport { STORAGE_TOKENS } from '../storage.tokens'\nimport type { StorageConfig, StorageEntry } from '../types'\n\n/**\n * Storage Manager Service\n * Manages multiple storage providers (one per disk)\n * Handles lazy initialization and caching of S3Clients\n */\n@Transient(STORAGE_TOKENS.StorageManager)\nexport class StorageManagerService {\n  private readonly providers = new Map<string, IStorageProvider>()\n  private readonly creationPromises = new Map<string, Promise<IStorageProvider>>()\n  private readonly diskConfigs = new Map<string, StorageEntry>()\n\n  constructor(\n    @inject(STORAGE_TOKENS.Options)\n    private readonly options: StorageConfig\n  ) {\n    this.initializeDiskConfigs()\n  }\n\n  /**\n   * Initialize disk configurations from options\n   */\n  private initializeDiskConfigs(): void {\n    for (const entry of this.options.storage) {\n      this.diskConfigs.set(entry.disk, entry)\n    }\n  }\n\n  /**\n   * Get provider for a specific disk\n   * Lazily initializes provider on first access\n   * @param diskName - Name of the disk\n   * @returns Storage provider instance\n   */\n  async getProvider(diskName: string): Promise<IStorageProvider> {\n    // Return cached provider if exists\n    const cached = this.providers.get(diskName)\n    if (cached) {\n      return cached\n    }\n\n    // Return in-flight creation promise to deduplicate concurrent calls\n    const inflight = this.creationPromises.get(diskName)\n    if (inflight) {\n      return inflight\n    }\n\n    // Get disk configuration\n    const diskConfig = this.diskConfigs.get(diskName)\n    if (!diskConfig) {\n      throw new DiskNotConfiguredError(diskName)\n    }\n\n    // Create provider and deduplicate concurrent calls\n    const promise = this.createProvider(diskConfig).then((provider) => {\n      this.providers.set(diskName, provider)\n      this.creationPromises.delete(diskName)\n      return provider\n    }).catch((error: unknown) => {\n      this.creationPromises.delete(diskName)\n      throw error\n    })\n\n    this.creationPromises.set(diskName, promise)\n\n    return promise\n  }\n\n  /**\n   * Create a provider instance based on configuration\n   * Dynamically imports S3StorageProvider to avoid loading AWS SDK at module evaluation time\n   * @param config - Storage entry configuration\n   * @returns Storage provider instance\n   */\n  private async createProvider(config: StorageEntry): Promise<IStorageProvider> {\n    switch (config.provider) {\n      case 's3': {\n        const { S3StorageProvider } = await import('../providers/s3-storage.provider')\n        return new S3StorageProvider(config)\n      }\n      case 'gcs':\n        throw new StorageProviderNotSupportedError(config.provider)\n      default:\n        throw new StorageProviderNotSupportedError(config.provider)\n    }\n  }\n\n  /**\n   * Get disk configuration\n   * @param diskName - Name of the disk\n   * @returns Storage entry configuration\n   */\n  getDiskConfig(diskName: string): StorageEntry {\n    const config = this.diskConfigs.get(diskName)\n    if (!config) {\n      throw new DiskNotConfiguredError(diskName)\n    }\n    return config\n  }\n\n  /**\n   * Check if a disk exists\n   * @param diskName - Name of the disk\n   * @returns True if disk exists, false otherwise\n   */\n  hasDisk(diskName: string): boolean {\n    return this.diskConfigs.has(diskName)\n  }\n\n  /**\n   * Get all available disk names\n   * @returns Array of disk names\n   */\n  getAvailableDisks(): string[] {\n    return Array.from(this.diskConfigs.keys())\n  }\n}\n","import { inject } from 'tsyringe'\nimport { Transient } from '../../di/decorators'\nimport type { DownloadResult, PresignedUrlResult, UploadOptions, UploadResult } from '../contracts'\nimport {\n  InvalidDiskError,\n  PresignedUrlInvalidExpiryError,\n} from '../errors'\nimport type { StreamingBlobPayloadInputTypes } from '../providers/storage-provider.interface'\nimport { STORAGE_TOKENS } from '../storage.tokens'\nimport type { StorageConfig } from '../types'\nimport { type StorageManagerService } from './storage-manager.service'\n\n/**\n * Storage Service\n *\n * Main facade for storage operations.\n * Request-scoped for proper isolation.\n *\n * @example\n * ```typescript\n * @inject(STORAGE_TOKENS.StorageService)\n * private readonly storage: StorageService\n *\n * await this.storage.upload(file, 'documents/report.pdf')\n * ```\n */\n@Transient(STORAGE_TOKENS.StorageService)\nexport class StorageService {\n  constructor(\n    @inject(STORAGE_TOKENS.StorageManager)\n    protected readonly storageManager: StorageManagerService,\n    @inject(STORAGE_TOKENS.Options)\n    protected readonly options: StorageConfig\n  ) { }\n\n  /**\n   * Upload content to storage\n   * @param body - Content to upload (stream, buffer, or string)\n   * @param relativePath - Relative path within the disk\n   * @param options - Upload options including size and mime type\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns Upload result with metadata\n   */\n  async upload(\n    body: StreamingBlobPayloadInputTypes,\n    relativePath: string,\n    options: UploadOptions,\n    disk?: string\n  ): Promise<UploadResult> {\n    const diskName = this.resolveDisk(disk)\n    const provider = await this.storageManager.getProvider(diskName)\n    const fullPath = this.buildFullPath(relativePath, diskName)\n\n    return provider.upload(body, fullPath, options)\n  }\n\n  /**\n   * Download a file from storage\n   * @param relativePath - Relative path within the disk\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns Download result with stream and metadata\n   */\n  async download(relativePath: string, disk?: string): Promise<DownloadResult> {\n    const diskName = this.resolveDisk(disk)\n    const provider = await this.storageManager.getProvider(diskName)\n    const fullPath = this.buildFullPath(relativePath, diskName)\n\n    return provider.download(fullPath)\n  }\n\n  /**\n   * Delete a file from storage\n   * @param relativePath - Relative path within the disk\n   * @param disk - Optional disk name (uses default if not provided)\n   */\n  async delete(relativePath: string, disk?: string): Promise<void> {\n    const diskName = this.resolveDisk(disk)\n    const provider = await this.storageManager.getProvider(diskName)\n    const fullPath = this.buildFullPath(relativePath, diskName)\n\n    await provider.delete(fullPath)\n  }\n\n  /**\n   * Check if a file exists in storage\n   * @param relativePath - Relative path within the disk\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns True if file exists, false otherwise\n   */\n  async exists(relativePath: string, disk?: string): Promise<boolean> {\n    const diskName = this.resolveDisk(disk)\n    const provider = await this.storageManager.getProvider(diskName)\n    const fullPath = this.buildFullPath(relativePath, diskName)\n\n    return provider.exists(fullPath)\n  }\n\n  /**\n   * Generate a presigned download URL\n   * @param relativePath - Relative path within the disk\n   * @param expiresIn - Optional expiry time in seconds (uses default if not provided)\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns Presigned URL result\n   */\n  async getPresignedDownloadUrl(\n    relativePath: string,\n    expiresIn?: number,\n    disk?: string\n  ): Promise<PresignedUrlResult> {\n    return this.getPresignedUrl(relativePath, 'GET', expiresIn, disk)\n  }\n\n  /**\n   * Generate a presigned upload URL\n   * @param relativePath - Relative path within the disk\n   * @param expiresIn - Optional expiry time in seconds (uses default if not provided)\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns Presigned URL result\n   */\n  async getPresignedUploadUrl(\n    relativePath: string,\n    expiresIn?: number,\n    disk?: string\n  ): Promise<PresignedUrlResult> {\n    return this.getPresignedUrl(relativePath, 'PUT', expiresIn, disk)\n  }\n\n  /**\n   * Generate a presigned delete URL\n   * @param relativePath - Relative path within the disk\n   * @param expiresIn - Optional expiry time in seconds (uses default if not provided)\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns Presigned URL result\n   */\n  async getPresignedDeleteUrl(\n    relativePath: string,\n    expiresIn?: number,\n    disk?: string\n  ): Promise<PresignedUrlResult> {\n    return this.getPresignedUrl(relativePath, 'DELETE', expiresIn, disk)\n  }\n\n  /**\n   * Generate a presigned URL for any method\n   * @param relativePath - Relative path within the disk\n   * @param method - HTTP method (GET, PUT, DELETE, HEAD)\n   * @param expiresIn - Optional expiry time in seconds (uses default if not provided)\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns Presigned URL result\n   */\n  protected async getPresignedUrl(\n    relativePath: string,\n    method: 'GET' | 'PUT' | 'DELETE' | 'HEAD',\n    expiresIn?: number,\n    disk?: string\n  ): Promise<PresignedUrlResult> {\n    const diskName = this.resolveDisk(disk)\n    const provider = await this.storageManager.getProvider(diskName)\n    const fullPath = this.buildFullPath(relativePath, diskName)\n    const validatedExpiresIn = this.validateExpiresIn(expiresIn)\n\n    return provider.getPresignedUrl(fullPath, method, validatedExpiresIn)\n  }\n\n  /**\n   * Resolve disk name (use default if not provided)\n   * @param disk - Optional disk name\n   * @returns Resolved disk name\n   */\n  protected resolveDisk(disk?: string): string {\n    const diskName = disk ?? this.options.defaultStorageDisk\n\n    if (!this.storageManager.hasDisk(diskName)) {\n      throw new InvalidDiskError(diskName)\n    }\n\n    return diskName\n  }\n\n  /**\n   * Build full path with disk root and path template substitution\n   * @param relativePath - Relative path within the disk\n   * @param diskName - Name of the disk\n   * @returns Full path including disk root\n   */\n  protected buildFullPath(relativePath: string, diskName: string): string {\n    const diskConfig = this.storageManager.getDiskConfig(diskName)\n    let root = diskConfig.root || ''\n\n    // Substitute template variables\n    root = this.substituteTemplateVariables(root)\n\n    // Combine root and relative path\n    const fullPath = `${root}/${relativePath}`.replace(/\\/+/g, '/').replace(/^\\//, '')\n\n    return fullPath\n  }\n\n  /**\n   * Substitute template variables in path\n   * Override this method in subclasses to add custom substitutions\n   *\n   * @param path - Path with template variables\n   * @returns Path with substituted variables\n   */\n  protected substituteTemplateVariables(path: string): string {\n    let result = path\n\n    // Substitute {date}, {year}, {month}\n    const now = new Date()\n    result = result.replace(/{date}/g, now.toISOString().split('T')[0])\n    result = result.replace(/{year}/g, now.getFullYear().toString())\n    result = result.replace(/{month}/g, (now.getMonth() + 1).toString().padStart(2, '0'))\n\n    return result\n  }\n\n  /**\n   * Validate expiry time for presigned URLs\n   * @param expiresIn - Optional expiry time in seconds\n   * @returns Validated expiry time\n   */\n  protected validateExpiresIn(expiresIn?: number): number {\n    const presignedUrlConfig = this.options.presignedUrl\n    const validatedExpiresIn = expiresIn ?? presignedUrlConfig.defaultExpiry\n\n    // S3 presigned URL limits: 1 second to 7 days (604800 seconds)\n    const minExpiry = 1\n    const maxExpiry = presignedUrlConfig.maxExpiry\n\n    if (validatedExpiresIn < minExpiry || validatedExpiresIn > maxExpiry) {\n      throw new PresignedUrlInvalidExpiryError(validatedExpiresIn, minExpiry, maxExpiry)\n    }\n\n    return validatedExpiresIn\n  }\n\n  /**\n   * Get all available disk names\n   * @returns Array of disk names\n   */\n  getAvailableDisks(): string[] {\n    return this.storageManager.getAvailableDisks()\n  }\n\n  /**\n   * Chunked upload for streaming data without known size\n   * Uses multipart upload under the hood - handles retries and large files\n   *\n   * Use this method when:\n   * - Content-Length is unknown or unreliable\n   * - Uploading from streams that can't be rewound\n   * - Need automatic retry handling for transient failures\n   *\n   * @param body - Content to upload (stream or buffer)\n   * @param relativePath - Relative path within the disk\n   * @param options - Upload options (mimeType required, size optional)\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns Upload result with metadata\n   */\n  async chunkedUpload(\n    body: StreamingBlobPayloadInputTypes,\n    relativePath: string,\n    options: Omit<UploadOptions, 'size'> & { size?: number },\n    disk?: string\n  ): Promise<UploadResult> {\n    const diskName = this.resolveDisk(disk)\n    const provider = await this.storageManager.getProvider(diskName)\n    const fullPath = this.buildFullPath(relativePath, diskName)\n\n    return provider.chunkedUpload(body, fullPath, options)\n  }\n}\n","/**\n * Storage Module\n * Provides file storage capabilities using AWS S3\n * Supports multiple disk configurations with dynamic path templates\n */\n\nimport { Scope } from '../di/types'\nimport { Module } from '../module'\nimport type { AsyncModuleOptions, DynamicModule } from '../module/types'\nimport { StorageManagerService } from './services/storage-manager.service'\nimport { StorageService } from './services/storage.service'\nimport { STORAGE_TOKENS } from './storage.tokens'\nimport type { StorageConfig } from './types'\n\n/**\n * Storage module options\n * Same as StorageConfig from types.ts\n */\nexport type StorageModuleOptions = StorageConfig\n\n@Module({\n  providers: [{ provide: STORAGE_TOKENS.StorageManager, useClass: StorageManagerService, scope: Scope.Singleton },\n  { provide: STORAGE_TOKENS.StorageService, useClass: StorageService },],\n})\nexport class StorageModule {\n  /**\n   * Configure StorageModule with static options\n   *\n   * @param options - Storage configuration options\n   * @returns Dynamic module with storage infrastructure\n   *\n   * @example\n   * ```typescript\n   * StorageModule.forRoot({\n   *   storage: [{ disk: 'uploads', provider: 's3', ... }],\n   *   defaultStorageDisk: 'uploads',\n   *   presignedUrl: { defaultExpiry: 3600, maxExpiry: 86400 }\n   * })\n   * ```\n   */\n  static forRoot(options: StorageModuleOptions): DynamicModule {\n    return {\n      module: StorageModule,\n      providers: [\n        { provide: STORAGE_TOKENS.Options, useValue: options },\n      ],\n    }\n  }\n\n  /**\n   * Configure StorageModule with async factory\n   *\n   * Use when configuration depends on other services.\n   *\n   * @param options - Async configuration with factory and inject tokens\n   * @returns Dynamic module with storage infrastructure\n   *\n   * @example\n   * ```typescript\n   * StorageModule.forRootAsync({\n   *   inject: [storageConfig.KEY],\n   *   useFactory: (storage) => ({\n   *     storage: storage.storage,\n   *     defaultStorageDisk: storage.defaultStorageDisk,\n   *     presignedUrl: storage.presignedUrl\n   *   })\n   * })\n   * ```\n   */\n  static forRootAsync(options: AsyncModuleOptions<StorageModuleOptions>): DynamicModule {\n    return {\n      module: StorageModule,\n      providers: [\n        {\n          provide: STORAGE_TOKENS.Options,\n          useFactory: options.useFactory,\n          inject: options.inject,\n        },\n      ],\n    }\n  }\n}\n","import { z, withI18n } from '../../i18n/validation'\n\nexport const deleteFileInputSchema = z.object({\n  path: z.string().min(1, withI18n('zodI18n.errors.custom.filePathRequired')),\n  disk: z.string().optional(),\n})\n\nexport type DeleteFileInput = z.infer<typeof deleteFileInputSchema>\n","import { z, withI18n } from '../../i18n/validation'\n\nexport const fileExistsInputSchema = z.object({\n  path: z.string().min(1, withI18n('zodI18n.errors.custom.filePathRequired')),\n  disk: z.string().optional(),\n})\n\nexport type FileExistsInput = z.infer<typeof fileExistsInputSchema>\n","import { z, withI18n } from '../../i18n/validation'\n\nexport const getPresignedUrlInputSchema = z.object({\n  path: z.string().min(1, withI18n('zodI18n.errors.custom.filePathRequired')),\n  method: z.enum(['GET', 'PUT', 'DELETE', 'HEAD']).default('GET'),\n  expiresIn: z.number().int().min(1).max(604800).optional(),\n  disk: z.string().optional(),\n})\n\nexport type GetPresignedUrlInput = z.infer<typeof getPresignedUrlInputSchema>\n\nexport const presignedUrlResultSchema = z.object({\n  url: z.string().url(),\n  expiresIn: z.number(),\n  expiresAt: z.date(),\n  method: z.enum(['GET', 'PUT', 'DELETE', 'HEAD']),\n})\n\nexport type PresignedUrlResult = z.infer<typeof presignedUrlResultSchema>\n","import { z } from '../../i18n/validation'\n\n/**\n * Upload options for streaming uploads\n */\nexport interface UploadOptions {\n  /**\n   * Size of the content in bytes\n   */\n  size: number\n  /**\n   * MIME type of the content\n   */\n  mimeType?: string\n  /**\n   * Custom metadata to store with the object (S3-specific)\n   * Stored as S3 object metadata headers\n   */\n  metadata?: Record<string, string>\n  /**\n   * Object tagging for lifecycle policies (S3-specific)\n   * Format: key=value (e.g., \"Tus-Completed=true\")\n   */\n  tagging?: string\n}\n\nexport const uploadResultSchema = z.object({\n  path: z.string(),\n  disk: z.string(),\n  fullPath: z.string(),\n  size: z.number(),\n  mimeType: z.string(),\n  uploadedAt: z.date(),\n})\n\nexport type UploadResult = z.infer<typeof uploadResultSchema>\n"],"mappings":"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"}

package/dist/storage-provider.interface-YRtyYBxV.d.mts

@@ -0,0 +1,203 @@
+import { o as z } from "./index-Dfpd_ypO.mjs";
+import { PutObjectCommandInput } from "@aws-sdk/client-s3";
+
+//#region src/storage/types.d.ts
+/**
+ * Storage entry configuration
+ * Represents a single storage disk with its credentials
+ */
+interface StorageEntry {
+  disk: string;
+  provider: 's3' | 'gcs';
+  endpoint: string;
+  /**
+   * Base URL for generating presigned/temporary URLs (client-accessible).
+   * When set, presigned URLs use this host instead of `endpoint`.
+   * Useful when the S3 API endpoint differs from the client-facing URL.
+   */
+  url?: string;
+  bucket: string;
+  region: string;
+  accessKeyId: string;
+  secretAccessKey: string;
+  root: string;
+  visibility: 'public' | 'private';
+}
+/**
+ * Presigned URL configuration
+ */
+interface PresignedUrlConfig {
+  defaultExpiry: number;
+  maxExpiry: number;
+}
+/**
+ * Storage configuration used by framework
+ */
+interface StorageConfig {
+  storage: StorageEntry[];
+  defaultStorageDisk: string;
+  presignedUrl: PresignedUrlConfig;
+}
+//#endregion
+//#region src/storage/contracts/delete-file.input.d.ts
+declare const deleteFileInputSchema: z.ZodObject<{
+  path: z.ZodString;
+  disk: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type DeleteFileInput = z.infer<typeof deleteFileInputSchema>;
+//#endregion
+//#region src/storage/contracts/download-result.d.ts
+/**
+ * Download Result
+ *
+ * Result of downloading a file from storage.
+ * Includes the file stream and metadata.
+ */
+interface DownloadResult {
+  /**
+   * ReadableStream of file contents
+   */
+  toStream(): undefined | ReadableStream<Uint8Array>;
+  toString(): undefined | Promise<string>;
+  toArrayBuffer(): undefined | Promise<Uint8Array>;
+  /**
+   * MIME type of the file (e.g., 'application/pdf', 'image/png')
+   */
+  contentType: string;
+  /**
+   * Size of the file in bytes
+   */
+  size: number;
+  /**
+   * Custom object metadata (S3-specific)
+   * Key-value pairs stored with the object
+   */
+  metadata?: Record<string, string>;
+}
+//#endregion
+//#region src/storage/contracts/file-exists.input.d.ts
+declare const fileExistsInputSchema: z.ZodObject<{
+  path: z.ZodString;
+  disk: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type FileExistsInput = z.infer<typeof fileExistsInputSchema>;
+//#endregion
+//#region src/storage/contracts/get-presigned-url.input.d.ts
+declare const getPresignedUrlInputSchema: z.ZodObject<{
+  path: z.ZodString;
+  method: z.ZodDefault<z.ZodEnum<{
+    GET: "GET";
+    PUT: "PUT";
+    DELETE: "DELETE";
+    HEAD: "HEAD";
+  }>>;
+  expiresIn: z.ZodOptional<z.ZodNumber>;
+  disk: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type GetPresignedUrlInput = z.infer<typeof getPresignedUrlInputSchema>;
+declare const presignedUrlResultSchema: z.ZodObject<{
+  url: z.ZodString;
+  expiresIn: z.ZodNumber;
+  expiresAt: z.ZodDate;
+  method: z.ZodEnum<{
+    GET: "GET";
+    PUT: "PUT";
+    DELETE: "DELETE";
+    HEAD: "HEAD";
+  }>;
+}, z.core.$strip>;
+type PresignedUrlResult = z.infer<typeof presignedUrlResultSchema>;
+//#endregion
+//#region src/storage/contracts/upload-file.input.d.ts
+/**
+ * Upload options for streaming uploads
+ */
+interface UploadOptions {
+  /**
+   * Size of the content in bytes
+   */
+  size: number;
+  /**
+   * MIME type of the content
+   */
+  mimeType?: string;
+  /**
+   * Custom metadata to store with the object (S3-specific)
+   * Stored as S3 object metadata headers
+   */
+  metadata?: Record<string, string>;
+  /**
+   * Object tagging for lifecycle policies (S3-specific)
+   * Format: key=value (e.g., "Tus-Completed=true")
+   */
+  tagging?: string;
+}
+declare const uploadResultSchema: z.ZodObject<{
+  path: z.ZodString;
+  disk: z.ZodString;
+  fullPath: z.ZodString;
+  size: z.ZodNumber;
+  mimeType: z.ZodString;
+  uploadedAt: z.ZodDate;
+}, z.core.$strip>;
+type UploadResult = z.infer<typeof uploadResultSchema>;
+//#endregion
+//#region src/storage/providers/storage-provider.interface.d.ts
+/**
+ * Streaming blob payload input types from AWS SDK
+ * Represents the types that can be used as the Body of a PutObjectCommand
+ */
+type StreamingBlobPayloadInputTypes = PutObjectCommandInput['Body'];
+/**
+ * Storage provider interface
+ * Defines the contract for storage implementations (R2, S3, GCS, etc.)
+ */
+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>;
+}
+//#endregion
+export { StorageEntry as _, uploadResultSchema as a, getPresignedUrlInputSchema as c, fileExistsInputSchema as d, DownloadResult as f, StorageConfig as g, PresignedUrlConfig as h, UploadResult as i, presignedUrlResultSchema as l, deleteFileInputSchema as m, StreamingBlobPayloadInputTypes as n, GetPresignedUrlInput as o, DeleteFileInput as p, UploadOptions as r, PresignedUrlResult as s, IStorageProvider as t, FileExistsInput as u };
+//# sourceMappingURL=storage-provider.interface-YRtyYBxV.d.mts.map

package/dist/storage-provider.interface-YRtyYBxV.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-provider.interface-YRtyYBxV.d.mts","names":[],"sources":["../src/storage/types.ts","../src/storage/contracts/delete-file.input.ts","../src/storage/contracts/download-result.ts","../src/storage/contracts/file-exists.input.ts","../src/storage/contracts/get-presigned-url.input.ts","../src/storage/contracts/upload-file.input.ts","../src/storage/providers/storage-provider.interface.ts"],"mappings":";;;;;;;;UAIiB,YAAA;EAChB,IAAA;EACA,QAAA;EACA,QAAA;EAFA;;;;;EAQA,GAAA;EACA,MAAA;EACA,MAAA;EACA,WAAA;EACA,eAAA;EACA,IAAA;EACA,UAAA;AAAA;;;;UAMgB,kBAAA;EAChB,aAAA;EACA,SAAA;AAAA;;;;UAMgB,aAAA;EAChB,OAAA,EAAS,YAAA;EACT,kBAAA;EACA,YAAA,EAAc,kBAAA;AAAA;;;cClCF,qBAAA,EAAqB,CAAA,CAAA,SAAA;;;;KAKtB,eAAA,GAAkB,CAAA,CAAE,KAAA,QAAa,qBAAA;;;;;;;ADH7C;;UEEiB,cAAA;EFFY;;;EEM3B,QAAA,gBAAwB,cAAA,CAAe,UAAA;EAEvC,QAAA,gBAAwB,OAAA;EAExB,aAAA,gBAA6B,OAAA,CAAQ,UAAA;EFCtC;;;EEIC,WAAA;EFAD;;;EEKC,IAAA;EFCiC;;;;EEKjC,QAAA,GAAW,MAAA;AAAA;;;cC5BA,qBAAA,EAAqB,CAAA,CAAA,SAAA;;;;KAKtB,eAAA,GAAkB,CAAA,CAAE,KAAA,QAAa,qBAAA;;;cCLhC,0BAAA,EAA0B,CAAA,CAAA,SAAA;;;;;;;;;;;KAO3B,oBAAA,GAAuB,CAAA,CAAE,KAAA,QAAa,0BAAA;AAAA,cAErC,wBAAA,EAAwB,CAAA,CAAA,SAAA;;;;;;;;;;;KAOzB,kBAAA,GAAqB,CAAA,CAAE,KAAA,QAAa,wBAAA;;;;;;UCb/B,aAAA;ELDY;;;EKK3B,IAAA;ELHD;;;EKOC,QAAA;ELED;;;;EKGC,QAAA,GAAW,MAAA;ELCF;;AAMX;;EKFE,OAAA;AAAA;AAAA,cAGW,kBAAA,EAAkB,CAAA,CAAA,SAAA;;;;;;;;KASnB,YAAA,GAAe,CAAA,CAAE,KAAA,QAAa,kBAAA;;;;;AL/B1C;;KMGY,8BAAA,GAAiC,qBAAA;;;;;UAM5B,gBAAA;ENChB;;;;;;;EMOC,MAAA,CAAO,IAAA,EAAM,8BAAA,EAAgC,IAAA,UAAc,OAAA,EAAS,aAAA,GAAgB,OAAA,CAAQ,YAAA;ENI7E;;;;;EMGf,QAAA,CAAS,IAAA,WAAe,OAAA,CAAQ,cAAA;ENKJ;;;;EMC5B,MAAA,CAAO,IAAA,WAAe,OAAA;ENCvB;;;;;EMMC,MAAA,CAAO,IAAA,WAAe,OAAA;;;ALvCxB;;;;;EKgDE,eAAA,CACE,IAAA,UACA,MAAA,qCACA,SAAA,WACC,OAAA,CAAQ,kBAAA;;;;;;;;;EAUX,aAAA,CACE,IAAA,EAAM,8BAAA,EACN,IAAA,UACA,OAAA,EAAS,IAAA,CAAK,aAAA;IAA2B,IAAA;EAAA,IACxC,OAAA,CAAQ,YAAA;AAAA"}