stratal 0.0.1

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

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

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

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

package/dist/storage/services/storage-manager.service.d.ts

@@ -0,0 +1,48 @@
+import type { IStorageProvider } from '../providers/storage-provider.interface';
+import type { StorageConfig, StorageEntry } from '../types';
+/**
+ * Storage Manager Service
+ * Manages multiple storage providers (one per disk)
+ * Handles lazy initialization and caching of S3Clients
+ */
+export declare class StorageManagerService {
+    private readonly options;
+    private readonly providers;
+    private readonly diskConfigs;
+    constructor(options: StorageConfig);
+    /**
+     * Initialize disk configurations from options
+     */
+    private initializeDiskConfigs;
+    /**
+     * Get provider for a specific disk
+     * Lazily initializes provider on first access
+     * @param diskName - Name of the disk
+     * @returns Storage provider instance
+     */
+    getProvider(diskName: string): IStorageProvider;
+    /**
+     * Create a provider instance based on configuration
+     * @param config - Storage entry configuration
+     * @returns Storage provider instance
+     */
+    private createProvider;
+    /**
+     * Get disk configuration
+     * @param diskName - Name of the disk
+     * @returns Storage entry configuration
+     */
+    getDiskConfig(diskName: string): StorageEntry;
+    /**
+     * Check if a disk exists
+     * @param diskName - Name of the disk
+     * @returns True if disk exists, false otherwise
+     */
+    hasDisk(diskName: string): boolean;
+    /**
+     * Get all available disk names
+     * @returns Array of disk names
+     */
+    getAvailableDisks(): string[];
+}
+//# sourceMappingURL=storage-manager.service.d.ts.map

package/dist/storage/services/storage-manager.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-manager.service.d.ts","sourceRoot":"","sources":["../../../src/storage/services/storage-manager.service.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAA;AAE/E,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAE3D;;;;GAIG;AACH,qBACa,qBAAqB;IAM9B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAChE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkC;gBAI3C,OAAO,EAAE,aAAa;IAKzC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAM7B;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB;IAsB/C;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAWtB;;;;OAIG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IAQ7C;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIlC;;;OAGG;IACH,iBAAiB,IAAI,MAAM,EAAE;CAG9B"}

package/dist/storage/services/storage-manager.service.js

@@ -0,0 +1,111 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject } from 'tsyringe';
+import { Transient } from '../../di/decorators';
+import { DiskNotConfiguredError, StorageProviderNotSupportedError } from '../errors';
+import { S3StorageProvider } from '../providers/s3-storage.provider';
+import { STORAGE_TOKENS } from '../storage.tokens';
+/**
+ * Storage Manager Service
+ * Manages multiple storage providers (one per disk)
+ * Handles lazy initialization and caching of S3Clients
+ */
+let StorageManagerService = class StorageManagerService {
+    options;
+    providers = new Map();
+    diskConfigs = new Map();
+    constructor(options) {
+        this.options = options;
+        this.initializeDiskConfigs();
+    }
+    /**
+     * Initialize disk configurations from options
+     */
+    initializeDiskConfigs() {
+        for (const entry of this.options.storage) {
+            this.diskConfigs.set(entry.disk, entry);
+        }
+    }
+    /**
+     * Get provider for a specific disk
+     * Lazily initializes provider on first access
+     * @param diskName - Name of the disk
+     * @returns Storage provider instance
+     */
+    getProvider(diskName) {
+        // Return cached provider if exists
+        const cached = this.providers.get(diskName);
+        if (cached) {
+            return cached;
+        }
+        // Get disk configuration
+        const diskConfig = this.diskConfigs.get(diskName);
+        if (!diskConfig) {
+            throw new DiskNotConfiguredError(diskName);
+        }
+        // Create provider based on configuration
+        const provider = this.createProvider(diskConfig);
+        // Cache provider
+        this.providers.set(diskName, provider);
+        return provider;
+    }
+    /**
+     * Create a provider instance based on configuration
+     * @param config - Storage entry configuration
+     * @returns Storage provider instance
+     */
+    createProvider(config) {
+        switch (config.provider) {
+            case 's3':
+                return new S3StorageProvider(config);
+            case 'gcs':
+                throw new StorageProviderNotSupportedError(config.provider);
+            default:
+                throw new StorageProviderNotSupportedError(config.provider);
+        }
+    }
+    /**
+     * Get disk configuration
+     * @param diskName - Name of the disk
+     * @returns Storage entry configuration
+     */
+    getDiskConfig(diskName) {
+        const config = this.diskConfigs.get(diskName);
+        if (!config) {
+            throw new DiskNotConfiguredError(diskName);
+        }
+        return config;
+    }
+    /**
+     * Check if a disk exists
+     * @param diskName - Name of the disk
+     * @returns True if disk exists, false otherwise
+     */
+    hasDisk(diskName) {
+        return this.diskConfigs.has(diskName);
+    }
+    /**
+     * Get all available disk names
+     * @returns Array of disk names
+     */
+    getAvailableDisks() {
+        return Array.from(this.diskConfigs.keys());
+    }
+};
+StorageManagerService = __decorate([
+    Transient(STORAGE_TOKENS.StorageManager),
+    __param(0, inject(STORAGE_TOKENS.Options)),
+    __metadata("design:paramtypes", [Object])
+], StorageManagerService);
+export { StorageManagerService };
+//# sourceMappingURL=storage-manager.service.js.map

package/dist/storage/services/storage-manager.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-manager.service.js","sourceRoot":"","sources":["../../../src/storage/services/storage-manager.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,sBAAsB,EAAE,gCAAgC,EAAE,MAAM,WAAW,CAAA;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AAEpE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGlD;;;;GAIG;AAEI,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAMb;IALF,SAAS,GAAG,IAAI,GAAG,EAA4B,CAAA;IAC/C,WAAW,GAAG,IAAI,GAAG,EAAwB,CAAA;IAE9D,YAEmB,OAAsB;QAAtB,YAAO,GAAP,OAAO,CAAe;QAEvC,IAAI,CAAC,qBAAqB,EAAE,CAAA;IAC9B,CAAC;IAED;;OAEG;IACK,qBAAqB;QAC3B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACzC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QACzC,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,QAAgB;QAC1B,mCAAmC;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC3C,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAA;QACf,CAAC;QAED,yBAAyB;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACjD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,sBAAsB,CAAC,QAAQ,CAAC,CAAA;QAC5C,CAAC;QAED,yCAAyC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAA;QAEhD,iBAAiB;QACjB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;QAEtC,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;;;OAIG;IACK,cAAc,CAAC,MAAoB;QACzC,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;YACxB,KAAK,IAAI;gBACP,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAA;YACtC,KAAK,KAAK;gBACR,MAAM,IAAI,gCAAgC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;YAC7D;gBACE,MAAM,IAAI,gCAAgC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QAC/D,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,QAAgB;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,sBAAsB,CAAC,QAAQ,CAAC,CAAA;QAC5C,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,QAAgB;QACtB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACvC,CAAC;IAED;;;OAGG;IACH,iBAAiB;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAA;IAC5C,CAAC;CACF,CAAA;AA7FY,qBAAqB;IADjC,SAAS,CAAC,cAAc,CAAC,cAAc,CAAC;IAMpC,WAAA,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAA;;GALtB,qBAAqB,CA6FjC"}

package/dist/storage/services/storage.service.d.ts

@@ -0,0 +1,140 @@
+import '../../polyfills';
+import type { DownloadResult, PresignedUrlResult, UploadOptions, UploadResult } from '../contracts';
+import type { StreamingBlobPayloadInputTypes } from '../providers/storage-provider.interface';
+import type { StorageConfig } from '../types';
+import { StorageManagerService } from './storage-manager.service';
+/**
+ * Storage Service
+ *
+ * Main facade for storage operations.
+ * Request-scoped for proper isolation.
+ *
+ * This service is tenant-agnostic. For tenant-aware path resolution,
+ * use TenantStorageService from the tenant module.
+ *
+ * @example
+ * ```typescript
+ * @inject(STORAGE_TOKENS.StorageService)
+ * private readonly storage: StorageService
+ *
+ * await this.storage.upload(file, 'documents/report.pdf')
+ * ```
+ */
+export declare class StorageService {
+    protected readonly storageManager: StorageManagerService;
+    protected readonly options: StorageConfig;
+    constructor(storageManager: StorageManagerService, options: StorageConfig);
+    /**
+     * Upload content to storage
+     * @param body - Content to upload (stream, buffer, or string)
+     * @param relativePath - Relative path within the disk
+     * @param options - Upload options including size and mime type
+     * @param disk - Optional disk name (uses default if not provided)
+     * @returns Upload result with metadata
+     */
+    upload(body: StreamingBlobPayloadInputTypes, relativePath: string, options: UploadOptions, disk?: string): Promise<UploadResult>;
+    /**
+     * Download a file from storage
+     * @param relativePath - Relative path within the disk
+     * @param disk - Optional disk name (uses default if not provided)
+     * @returns Download result with stream and metadata
+     */
+    download(relativePath: string, disk?: string): Promise<DownloadResult>;
+    /**
+     * Delete a file from storage
+     * @param relativePath - Relative path within the disk
+     * @param disk - Optional disk name (uses default if not provided)
+     */
+    delete(relativePath: string, disk?: string): Promise<void>;
+    /**
+     * Check if a file exists in storage
+     * @param relativePath - Relative path within the disk
+     * @param disk - Optional disk name (uses default if not provided)
+     * @returns True if file exists, false otherwise
+     */
+    exists(relativePath: string, disk?: string): Promise<boolean>;
+    /**
+     * Generate a presigned download URL
+     * @param relativePath - Relative path within the disk
+     * @param expiresIn - Optional expiry time in seconds (uses default if not provided)
+     * @param disk - Optional disk name (uses default if not provided)
+     * @returns Presigned URL result
+     */
+    getPresignedDownloadUrl(relativePath: string, expiresIn?: number, disk?: string): Promise<PresignedUrlResult>;
+    /**
+     * Generate a presigned upload URL
+     * @param relativePath - Relative path within the disk
+     * @param expiresIn - Optional expiry time in seconds (uses default if not provided)
+     * @param disk - Optional disk name (uses default if not provided)
+     * @returns Presigned URL result
+     */
+    getPresignedUploadUrl(relativePath: string, expiresIn?: number, disk?: string): Promise<PresignedUrlResult>;
+    /**
+     * Generate a presigned delete URL
+     * @param relativePath - Relative path within the disk
+     * @param expiresIn - Optional expiry time in seconds (uses default if not provided)
+     * @param disk - Optional disk name (uses default if not provided)
+     * @returns Presigned URL result
+     */
+    getPresignedDeleteUrl(relativePath: string, expiresIn?: number, disk?: string): Promise<PresignedUrlResult>;
+    /**
+     * Generate a presigned URL for any method
+     * @param relativePath - Relative path within the disk
+     * @param method - HTTP method (GET, PUT, DELETE, HEAD)
+     * @param expiresIn - Optional expiry time in seconds (uses default if not provided)
+     * @param disk - Optional disk name (uses default if not provided)
+     * @returns Presigned URL result
+     */
+    protected getPresignedUrl(relativePath: string, method: 'GET' | 'PUT' | 'DELETE' | 'HEAD', expiresIn?: number, disk?: string): Promise<PresignedUrlResult>;
+    /**
+     * Resolve disk name (use default if not provided)
+     * @param disk - Optional disk name
+     * @returns Resolved disk name
+     */
+    protected resolveDisk(disk?: string): string;
+    /**
+     * Build full path with disk root and path template substitution
+     * @param relativePath - Relative path within the disk
+     * @param diskName - Name of the disk
+     * @returns Full path including disk root
+     */
+    protected buildFullPath(relativePath: string, diskName: string): string;
+    /**
+     * Substitute template variables in path
+     * Override this method in subclasses to add tenant-specific substitutions
+     *
+     * @param path - Path with template variables
+     * @returns Path with substituted variables
+     */
+    protected substituteTemplateVariables(path: string): string;
+    /**
+     * Validate expiry time for presigned URLs
+     * @param expiresIn - Optional expiry time in seconds
+     * @returns Validated expiry time
+     */
+    protected validateExpiresIn(expiresIn?: number): number;
+    /**
+     * Get all available disk names
+     * @returns Array of disk names
+     */
+    getAvailableDisks(): string[];
+    /**
+     * Chunked upload for streaming data without known size
+     * Uses multipart upload under the hood - handles retries and large files
+     *
+     * Use this method when:
+     * - Content-Length is unknown or unreliable
+     * - Uploading from streams that can't be rewound
+     * - Need automatic retry handling for transient failures
+     *
+     * @param body - Content to upload (stream or buffer)
+     * @param relativePath - Relative path within the disk
+     * @param options - Upload options (mimeType required, size optional)
+     * @param disk - Optional disk name (uses default if not provided)
+     * @returns Upload result with metadata
+     */
+    chunkedUpload(body: StreamingBlobPayloadInputTypes, relativePath: string, options: Omit<UploadOptions, 'size'> & {
+        size?: number;
+    }, disk?: string): Promise<UploadResult>;
+}
+//# sourceMappingURL=storage.service.d.ts.map

package/dist/storage/services/storage.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.service.d.ts","sourceRoot":"","sources":["../../../src/storage/services/storage.service.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,CAAA;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAKnG,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAA;AAE7F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AAEjE;;;;;;;;;;;;;;;;GAgBG;AACH,qBACa,cAAc;IAGvB,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,qBAAqB;IAExD,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,aAAa;gBAFtB,cAAc,EAAE,qBAAqB,EAErC,OAAO,EAAE,aAAa;IAG3C;;;;;;;OAOG;IACG,MAAM,CACV,IAAI,EAAE,8BAA8B,EACpC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,aAAa,EACtB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,CAAC;IAQxB;;;;;OAKG;IACG,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAQ5E;;;;OAIG;IACG,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhE;;;;;OAKG;IACG,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQnE;;;;;;OAMG;IACG,uBAAuB,CAC3B,YAAY,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,kBAAkB,CAAC;IAI9B;;;;;;OAMG;IACG,qBAAqB,CACzB,YAAY,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,kBAAkB,CAAC;IAI9B;;;;;;OAMG;IACG,qBAAqB,CACzB,YAAY,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,kBAAkB,CAAC;IAI9B;;;;;;;OAOG;cACa,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,EACzC,SAAS,CAAC,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,kBAAkB,CAAC;IAS9B;;;;OAIG;IACH,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAU5C;;;;;OAKG;IACH,SAAS,CAAC,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAavE;;;;;;OAMG;IACH,SAAS,CAAC,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAY3D;;;;OAIG;IACH,SAAS,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAevD;;;OAGG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAI7B;;;;;;;;;;;;;;OAcG;IACG,aAAa,CACjB,IAAI,EAAE,8BAA8B,EACpC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EACxD,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,YAAY,CAAC;CAOzB"}

package/dist/storage/services/storage.service.js

@@ -0,0 +1,232 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import '../../polyfills';
+import { inject } from 'tsyringe';
+import { Transient } from '../../di/decorators';
+import { InvalidDiskError, PresignedUrlInvalidExpiryError, } from '../errors';
+import { STORAGE_TOKENS } from '../storage.tokens';
+import { StorageManagerService } from './storage-manager.service';
+/**
+ * Storage Service
+ *
+ * Main facade for storage operations.
+ * Request-scoped for proper isolation.
+ *
+ * This service is tenant-agnostic. For tenant-aware path resolution,
+ * use TenantStorageService from the tenant module.
+ *
+ * @example
+ * ```typescript
+ * @inject(STORAGE_TOKENS.StorageService)
+ * private readonly storage: StorageService
+ *
+ * await this.storage.upload(file, 'documents/report.pdf')
+ * ```
+ */
+let StorageService = class StorageService {
+    storageManager;
+    options;
+    constructor(storageManager, options) {
+        this.storageManager = storageManager;
+        this.options = options;
+    }
+    /**
+     * Upload content to storage
+     * @param body - Content to upload (stream, buffer, or string)
+     * @param relativePath - Relative path within the disk
+     * @param options - Upload options including size and mime type
+     * @param disk - Optional disk name (uses default if not provided)
+     * @returns Upload result with metadata
+     */
+    async upload(body, relativePath, options, disk) {
+        const diskName = this.resolveDisk(disk);
+        const provider = this.storageManager.getProvider(diskName);
+        const fullPath = this.buildFullPath(relativePath, diskName);
+        return provider.upload(body, fullPath, options);
+    }
+    /**
+     * Download a file from storage
+     * @param relativePath - Relative path within the disk
+     * @param disk - Optional disk name (uses default if not provided)
+     * @returns Download result with stream and metadata
+     */
+    async download(relativePath, disk) {
+        const diskName = this.resolveDisk(disk);
+        const provider = this.storageManager.getProvider(diskName);
+        const fullPath = this.buildFullPath(relativePath, diskName);
+        return provider.download(fullPath);
+    }
+    /**
+     * Delete a file from storage
+     * @param relativePath - Relative path within the disk
+     * @param disk - Optional disk name (uses default if not provided)
+     */
+    async delete(relativePath, disk) {
+        const diskName = this.resolveDisk(disk);
+        const provider = this.storageManager.getProvider(diskName);
+        const fullPath = this.buildFullPath(relativePath, diskName);
+        await provider.delete(fullPath);
+    }
+    /**
+     * Check if a file exists in storage
+     * @param relativePath - Relative path within the disk
+     * @param disk - Optional disk name (uses default if not provided)
+     * @returns True if file exists, false otherwise
+     */
+    async exists(relativePath, disk) {
+        const diskName = this.resolveDisk(disk);
+        const provider = this.storageManager.getProvider(diskName);
+        const fullPath = this.buildFullPath(relativePath, diskName);
+        return provider.exists(fullPath);
+    }
+    /**
+     * Generate a presigned download URL
+     * @param relativePath - Relative path within the disk
+     * @param expiresIn - Optional expiry time in seconds (uses default if not provided)
+     * @param disk - Optional disk name (uses default if not provided)
+     * @returns Presigned URL result
+     */
+    async getPresignedDownloadUrl(relativePath, expiresIn, disk) {
+        return this.getPresignedUrl(relativePath, 'GET', expiresIn, disk);
+    }
+    /**
+     * Generate a presigned upload URL
+     * @param relativePath - Relative path within the disk
+     * @param expiresIn - Optional expiry time in seconds (uses default if not provided)
+     * @param disk - Optional disk name (uses default if not provided)
+     * @returns Presigned URL result
+     */
+    async getPresignedUploadUrl(relativePath, expiresIn, disk) {
+        return this.getPresignedUrl(relativePath, 'PUT', expiresIn, disk);
+    }
+    /**
+     * Generate a presigned delete URL
+     * @param relativePath - Relative path within the disk
+     * @param expiresIn - Optional expiry time in seconds (uses default if not provided)
+     * @param disk - Optional disk name (uses default if not provided)
+     * @returns Presigned URL result
+     */
+    async getPresignedDeleteUrl(relativePath, expiresIn, disk) {
+        return this.getPresignedUrl(relativePath, 'DELETE', expiresIn, disk);
+    }
+    /**
+     * Generate a presigned URL for any method
+     * @param relativePath - Relative path within the disk
+     * @param method - HTTP method (GET, PUT, DELETE, HEAD)
+     * @param expiresIn - Optional expiry time in seconds (uses default if not provided)
+     * @param disk - Optional disk name (uses default if not provided)
+     * @returns Presigned URL result
+     */
+    async getPresignedUrl(relativePath, method, expiresIn, disk) {
+        const diskName = this.resolveDisk(disk);
+        const provider = this.storageManager.getProvider(diskName);
+        const fullPath = this.buildFullPath(relativePath, diskName);
+        const validatedExpiresIn = this.validateExpiresIn(expiresIn);
+        return provider.getPresignedUrl(fullPath, method, validatedExpiresIn);
+    }
+    /**
+     * Resolve disk name (use default if not provided)
+     * @param disk - Optional disk name
+     * @returns Resolved disk name
+     */
+    resolveDisk(disk) {
+        const diskName = disk ?? this.options.defaultStorageDisk;
+        if (!this.storageManager.hasDisk(diskName)) {
+            throw new InvalidDiskError(diskName);
+        }
+        return diskName;
+    }
+    /**
+     * Build full path with disk root and path template substitution
+     * @param relativePath - Relative path within the disk
+     * @param diskName - Name of the disk
+     * @returns Full path including disk root
+     */
+    buildFullPath(relativePath, diskName) {
+        const diskConfig = this.storageManager.getDiskConfig(diskName);
+        let root = diskConfig.root || '';
+        // Substitute template variables
+        root = this.substituteTemplateVariables(root);
+        // Combine root and relative path
+        const fullPath = `${root}/${relativePath}`.replace(/\/+/g, '/').replace(/^\//, '');
+        return fullPath;
+    }
+    /**
+     * Substitute template variables in path
+     * Override this method in subclasses to add tenant-specific substitutions
+     *
+     * @param path - Path with template variables
+     * @returns Path with substituted variables
+     */
+    substituteTemplateVariables(path) {
+        let result = path;
+        // Substitute {date}, {year}, {month}
+        const now = new Date();
+        result = result.replace(/{date}/g, now.toISOString().split('T')[0]);
+        result = result.replace(/{year}/g, now.getFullYear().toString());
+        result = result.replace(/{month}/g, (now.getMonth() + 1).toString().padStart(2, '0'));
+        return result;
+    }
+    /**
+     * Validate expiry time for presigned URLs
+     * @param expiresIn - Optional expiry time in seconds
+     * @returns Validated expiry time
+     */
+    validateExpiresIn(expiresIn) {
+        const presignedUrlConfig = this.options.presignedUrl;
+        const validatedExpiresIn = expiresIn ?? presignedUrlConfig.defaultExpiry;
+        // S3 presigned URL limits: 1 second to 7 days (604800 seconds)
+        const minExpiry = 1;
+        const maxExpiry = presignedUrlConfig.maxExpiry;
+        if (validatedExpiresIn < minExpiry || validatedExpiresIn > maxExpiry) {
+            throw new PresignedUrlInvalidExpiryError(validatedExpiresIn, minExpiry, maxExpiry);
+        }
+        return validatedExpiresIn;
+    }
+    /**
+     * Get all available disk names
+     * @returns Array of disk names
+     */
+    getAvailableDisks() {
+        return this.storageManager.getAvailableDisks();
+    }
+    /**
+     * Chunked upload for streaming data without known size
+     * Uses multipart upload under the hood - handles retries and large files
+     *
+     * Use this method when:
+     * - Content-Length is unknown or unreliable
+     * - Uploading from streams that can't be rewound
+     * - Need automatic retry handling for transient failures
+     *
+     * @param body - Content to upload (stream or buffer)
+     * @param relativePath - Relative path within the disk
+     * @param options - Upload options (mimeType required, size optional)
+     * @param disk - Optional disk name (uses default if not provided)
+     * @returns Upload result with metadata
+     */
+    async chunkedUpload(body, relativePath, options, disk) {
+        const diskName = this.resolveDisk(disk);
+        const provider = this.storageManager.getProvider(diskName);
+        const fullPath = this.buildFullPath(relativePath, diskName);
+        return provider.chunkedUpload(body, fullPath, options);
+    }
+};
+StorageService = __decorate([
+    Transient(STORAGE_TOKENS.StorageService),
+    __param(0, inject(STORAGE_TOKENS.StorageManager)),
+    __param(1, inject(STORAGE_TOKENS.Options)),
+    __metadata("design:paramtypes", [StorageManagerService, Object])
+], StorageService);
+export { StorageService };
+//# sourceMappingURL=storage.service.js.map

package/dist/storage/services/storage.service.js.map

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

package/dist/storage/storage.module.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Storage Module
+ * Provides file storage capabilities using AWS S3
+ * Supports multiple disk configurations with tenant-aware path templates
+ */
+import type { AsyncModuleOptions, DynamicModule } from '../module/types';
+import type { StorageConfig } from './types';
+/**
+ * Storage module options
+ * Same as StorageConfig from types.ts
+ */
+export type StorageModuleOptions = StorageConfig;
+export declare class StorageModule {
+    /**
+     * Configure StorageModule with static options
+     *
+     * @param options - Storage configuration options
+     * @returns Dynamic module with storage infrastructure
+     *
+     * @example
+     * ```typescript
+     * StorageModule.forRoot({
+     *   storage: [{ disk: 'uploads', provider: 's3', ... }],
+     *   defaultStorageDisk: 'uploads',
+     *   presignedUrl: { defaultExpiry: 3600, maxExpiry: 86400 }
+     * })
+     * ```
+     */
+    static forRoot(options: StorageModuleOptions): DynamicModule;
+    /**
+     * Configure StorageModule with async factory
+     *
+     * Use when configuration depends on other services.
+     *
+     * @param options - Async configuration with factory and inject tokens
+     * @returns Dynamic module with storage infrastructure
+     *
+     * @example
+     * ```typescript
+     * StorageModule.forRootAsync({
+     *   inject: [storageConfig.KEY],
+     *   useFactory: (storage) => ({
+     *     storage: storage.storage,
+     *     defaultStorageDisk: storage.defaultStorageDisk,
+     *     presignedUrl: storage.presignedUrl
+     *   })
+     * })
+     * ```
+     */
+    static forRootAsync(options: AsyncModuleOptions<StorageModuleOptions>): DynamicModule;
+}
+//# sourceMappingURL=storage.module.d.ts.map

package/dist/storage/storage.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.module.d.ts","sourceRoot":"","sources":["../../src/storage/storage.module.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAIxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,aAAa,CAAA;AAEhD,qBAIa,aAAa;IACxB;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa;IAS5D;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,kBAAkB,CAAC,oBAAoB,CAAC,GAAG,aAAa;CAYtF"}