@wildo-ai/saas-backend-lib 1.0.1

package/dist/esm/files/storage/file-storage-router.backend.service.js

@@ -0,0 +1,168 @@
+/**
+ * File Storage Router Backend Service
+ *
+ * Selects the appropriate IFileStorageProvider based on:
+ * 1. Schema-declared `storageAccepted` (from z_file({ storageAccepted: [...] }))
+ * 2. Provider availability (isConfigured() check)
+ *
+ * Registered providers:
+ * - Wildo-managed (MinIO/S3) — default, used when no storageAccepted is specified
+ * - Local directory — filesystem-backed storage via STORAGE_LOCAL_BASE_DIR
+ *
+ * Resolution is strict: when `storageAccepted` is explicitly declared, only
+ * those providers are considered. A CONFIGURATION error is thrown when none
+ * of the declared providers are configured (no silent fallback to S3).
+ * When `storageAccepted` is omitted, Wildo-managed is the default and must
+ * be configured, otherwise a CONFIGURATION error is thrown.
+ */
+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 { injectable, inject } from 'inversify';
+import { ErrorType, ErrorCustomMessageReference } from '@wildo-ai/saas-models';
+import { FileStorageAccepted } from '@wildo-ai/zod-decorators';
+import { SAAS_SERVICE_TYPES } from '../../inject/models/service-types.js';
+import { ErrorBuilderBackendService } from '../../errors/services/error-builder.backend.service.js';
+let FileStorageRouterBackendService = class FileStorageRouterBackendService {
+    logger;
+    errorBuilder;
+    wildoManagedProvider;
+    localDirectoryProvider;
+    logDebug;
+    /** Map of providerId → IFileStorageProvider for O(1) lookup */
+    providerMap;
+    constructor(logger, errorBuilder, wildoManagedProvider, localDirectoryProvider) {
+        this.logger = logger;
+        this.errorBuilder = errorBuilder;
+        this.wildoManagedProvider = wildoManagedProvider;
+        this.localDirectoryProvider = localDirectoryProvider;
+        this.logDebug = this.logger.debugByType('FileStorageRouterBackendService');
+        this.logger.setDebugTypeLogging('FileStorageRouterBackendService', false);
+        this.providerMap = new Map();
+        this.providerMap.set(FileStorageAccepted.WILDO_MANAGED, this.wildoManagedProvider);
+        this.providerMap.set(FileStorageAccepted.LOCAL_DIRECTORY, this.localDirectoryProvider);
+    }
+    /**
+     * Resolve the appropriate storage provider for a given set of accepted providers.
+     *
+     * Resolution:
+     * - `storageAccepted` undefined/empty → default to Wildo-managed (must be configured)
+     * - `storageAccepted` specified → first configured match wins; if none configured → CONFIGURATION error
+     *
+     * Strict: when providers are explicitly declared, no silent fallback to an
+     * un-requested provider occurs. This prevents data landing in unexpected storage.
+     *
+     * @param storageAccepted - Accepted storage providers from z_file() schema (undefined = Wildo-managed)
+     * @returns The resolved storage provider
+     * @throws CONFIGURATION error when no suitable configured provider is found
+     */
+    resolveProvider(storageAccepted) {
+        if (!storageAccepted || storageAccepted.length === 0) {
+            if (!this.wildoManagedProvider.isConfigured()) {
+                throw this.errorBuilder.buildError(ErrorType.CONFIGURATION, undefined, {
+                    customMessageReference: ErrorCustomMessageReference.CONFIGURATION,
+                    context: {
+                        message: 'No storageAccepted specified and default Wildo-managed storage is not configured. ' +
+                            'Set STORAGE_ENDPOINT, STORAGE_ACCESS_KEY, STORAGE_SECRET_KEY or specify storageAccepted in z_file().',
+                    },
+                });
+            }
+            return this.wildoManagedProvider;
+        }
+        // Try to find a registered AND configured provider matching the schema preferences (in order)
+        for (const preferred of storageAccepted) {
+            const provider = this.providerMap.get(preferred);
+            if (provider && provider.isConfigured()) {
+                return provider;
+            }
+        }
+        // The developer explicitly declared accepted providers but none are configured.
+        // Strict behavior: do NOT silently fall back to a provider they didn't request.
+        const configuredProviders = Array.from(this.providerMap.entries())
+            .filter(([, p]) => p.isConfigured())
+            .map(([id]) => id);
+        throw this.errorBuilder.buildError(ErrorType.CONFIGURATION, undefined, {
+            customMessageReference: ErrorCustomMessageReference.CONFIGURATION,
+            context: {
+                message: 'None of the requested storage providers are configured. ' +
+                    'Ensure the corresponding environment variables are set for at least one of the declared providers.',
+                requestedProviders: storageAccepted,
+                configuredProviders,
+            },
+        });
+    }
+    /**
+     * Get the default storage provider (Wildo-managed).
+     * Use this when no schema-level preference is set.
+     */
+    getDefaultProvider() {
+        return this.wildoManagedProvider;
+    }
+    getProviderById(providerId) {
+        return this.providerMap.get(providerId);
+    }
+    /**
+     * Eagerly initialize all configured storage providers.
+     * Call at startup to fail fast on misconfiguration.
+     * Providers that are not configured are skipped.
+     */
+    async initialize() {
+        for (const [providerId, provider] of this.providerMap) {
+            if (!provider.isConfigured()) {
+                this.logDebug('Skipping unconfigured storage provider', { providerId });
+                continue;
+            }
+            this.logDebug('Initializing storage provider', { providerId });
+            await provider.initialize();
+            this.logDebug('Storage provider initialized', { providerId });
+        }
+    }
+    /**
+     * Run health checks on all configured providers.
+     */
+    async healthCheck() {
+        let totalLatency = 0;
+        for (const [providerId, provider] of this.providerMap) {
+            if (!provider.isConfigured()) {
+                continue;
+            }
+            const result = await provider.healthCheck();
+            totalLatency += result.latency;
+            if (!result.healthy) {
+                return { healthy: false, latency: totalLatency, error: `${providerId}: ${result.error}` };
+            }
+        }
+        return { healthy: true, latency: totalLatency };
+    }
+    /**
+     * Check if at least one storage provider is configured.
+     * Returns false when the app doesn't use file features.
+     */
+    isConfigured() {
+        for (const provider of this.providerMap.values()) {
+            if (provider.isConfigured()) {
+                return true;
+            }
+        }
+        return false;
+    }
+};
+FileStorageRouterBackendService = __decorate([
+    injectable(),
+    __param(0, inject(SAAS_SERVICE_TYPES.Logger)),
+    __param(1, inject(SAAS_SERVICE_TYPES.ErrorBuilderService)),
+    __param(2, inject(SAAS_SERVICE_TYPES.FileStorageProvider_WildoManaged)),
+    __param(3, inject(SAAS_SERVICE_TYPES.FileStorageProvider_LocalDirectory)),
+    __metadata("design:paramtypes", [Function, ErrorBuilderBackendService, Object, Object])
+], FileStorageRouterBackendService);
+export { FileStorageRouterBackendService };
+//# sourceMappingURL=file-storage-router.backend.service.js.map

package/dist/esm/files/storage/file-storage-router.backend.service.js.map

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

package/dist/esm/files/storage/local-directory-storage-provider.backend.service.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Local Directory Storage Provider
+ *
+ * IFileStorageProvider implementation backed by the local filesystem.
+ * Files are stored under a configurable base directory, organized by
+ * application and file ID. Path traversal attacks are guarded against
+ * by resolving all paths and verifying they stay inside the base dir.
+ *
+ * Configuration via env vars:
+ * - STORAGE_LOCAL_BASE_DIR: absolute path to the base directory
+ */
+import { Readable } from 'stream';
+import { FileStorageAccepted } from '@wildo-ai/zod-decorators';
+import type { LoggerService } from '../../monitoring/logger/services/logger.service.js';
+import { ErrorBuilderBackendService } from '../../errors/services/error-builder.backend.service.js';
+import { AppConfigurationService } from '../../config/services/app-configuration.backend.service.js';
+import type { ExecutionContext } from '../../runtime/models/execution-context.backend.schemas.js';
+import type { IFileStorageProvider, StorageUploadResult, StorageUploadOptions, StorageDownloadResult, StorageFileMetadata, StorageProviderHealthResult, StoredFileStorageTarget } from './file-storage-provider.types.js';
+export declare class LocalDirectoryStorageProvider implements IFileStorageProvider {
+    private readonly logger;
+    private readonly errorBuilder;
+    private readonly appConfigService;
+    readonly providerId = FileStorageAccepted.LOCAL_DIRECTORY;
+    private baseDir;
+    constructor(logger: LoggerService, errorBuilder: ErrorBuilderBackendService, appConfigService: AppConfigurationService);
+    isConfigured(): boolean;
+    initialize(): Promise<void>;
+    healthCheck(): Promise<StorageProviderHealthResult>;
+    private getBaseDir;
+    /**
+     * Compose the ordered path segments for an upload.
+     *
+     * Layout (all optional segments omitted when absent):
+     * [applicationId] / [folderPath] / <fileName|fileId>
+     *
+     * `includeApplicationId` defaults to `false` for local storage.
+     */
+    private composePathSegments;
+    /**
+     * Resolve a safe absolute path from a relative storage ref.
+     * Throws if the resolved path escapes the base directory (path traversal guard).
+     */
+    private resolveSafePathFromRelative;
+    private getApplicationId;
+    upload(fileStream: Readable, fileId: string, mimeType: string, size: number, executionContext: ExecutionContext<any>, options?: StorageUploadOptions): Promise<StorageUploadResult>;
+    download(file: StoredFileStorageTarget, executionContext: ExecutionContext<any>): Promise<StorageDownloadResult>;
+    delete(file: StoredFileStorageTarget, executionContext: ExecutionContext<any>): Promise<void>;
+    getMetadata(file: StoredFileStorageTarget, executionContext: ExecutionContext<any>): Promise<StorageFileMetadata>;
+    /**
+     * Resolve the absolute filesystem path from a persisted storageRef.
+     * The ref IS the relative path from baseDir — just validate traversal.
+     */
+    private resolvePathFromStorageRef;
+    private readLocalMetadata;
+    private convertStorageError;
+}
+//# sourceMappingURL=local-directory-storage-provider.backend.service.d.ts.map

package/dist/esm/files/storage/local-directory-storage-provider.backend.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-directory-storage-provider.backend.service.d.ts","sourceRoot":"","sources":["../../../../src/files/storage/local-directory-storage-provider.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAKlC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAClG,OAAO,EAAE,0BAA0B,EAAE,MAAM,kEAAkE,CAAC;AAC9G,OAAO,EAAE,uBAAuB,EAAE,MAAM,sEAAsE,CAAC;AAC/G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qEAAqE,CAAC;AAE5G,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,EACxB,MAAM,+BAA+B,CAAC;AAUvC,qBACa,6BAA8B,YAAW,oBAAoB;IAMtE,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IATnC,QAAQ,CAAC,UAAU,uCAAuC;IAC1D,OAAO,CAAC,OAAO,CAAuB;gBAInB,MAAM,EAAE,aAAa,EAErB,YAAY,EAAE,0BAA0B,EAExC,gBAAgB,EAAE,uBAAuB;IAG5D,YAAY,IAAI,OAAO;IAIjB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B,WAAW,IAAI,OAAO,CAAC,2BAA2B,CAAC;IAmBzD,OAAO,CAAC,UAAU;IAkBlB;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IAoC3B;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAmBnC,OAAO,CAAC,gBAAgB;IAMlB,MAAM,CACV,UAAU,EAAE,QAAQ,EACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,gBAAgB,CAAC,GAAG,CAAC,EACvC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC;IAsCzB,QAAQ,CACZ,IAAI,EAAE,uBAAuB,EAC7B,gBAAgB,EAAE,gBAAgB,CAAC,GAAG,CAAC,GACtC,OAAO,CAAC,qBAAqB,CAAC;IAgC3B,MAAM,CACV,IAAI,EAAE,uBAAuB,EAC7B,gBAAgB,EAAE,gBAAgB,CAAC,GAAG,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC;IAoBV,WAAW,CACf,IAAI,EAAE,uBAAuB,EAC7B,gBAAgB,EAAE,gBAAgB,CAAC,GAAG,CAAC,GACtC,OAAO,CAAC,mBAAmB,CAAC;IA8B/B;;;OAGG;IACH,OAAO,CAAC,yBAAyB;YAYnB,iBAAiB;IAkB/B,OAAO,CAAC,mBAAmB;CAuD5B"}

package/dist/esm/files/storage/local-directory-storage-provider.backend.service.js

@@ -0,0 +1,307 @@
+/**
+ * Local Directory Storage Provider
+ *
+ * IFileStorageProvider implementation backed by the local filesystem.
+ * Files are stored under a configurable base directory, organized by
+ * application and file ID. Path traversal attacks are guarded against
+ * by resolving all paths and verifying they stay inside the base dir.
+ *
+ * Configuration via env vars:
+ * - STORAGE_LOCAL_BASE_DIR: absolute path to the base directory
+ */
+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 { injectable, inject } from 'inversify';
+import * as fs from 'fs';
+import * as path from 'path';
+import { pipeline } from 'stream/promises';
+import { ErrorType, ErrorCustomMessageReference, isWildoBackendError } from '@wildo-ai/saas-models';
+import { FileStorageAccepted } from '@wildo-ai/zod-decorators';
+import { SAAS_SERVICE_TYPES } from '../../inject/models/service-types.js';
+import { ErrorBuilderBackendService } from '../../errors/services/error-builder.backend.service.js';
+import { AppConfigurationService } from '../../config/services/app-configuration.backend.service.js';
+import { validateAppId, validateContentType, validateFileId, validateSize, validateStream, resolveConfiguredMaxFileSize } from '../../files/utils/file-validation.utils.js';
+const METADATA_SUFFIX = '.meta.json';
+let LocalDirectoryStorageProvider = class LocalDirectoryStorageProvider {
+    logger;
+    errorBuilder;
+    appConfigService;
+    providerId = FileStorageAccepted.LOCAL_DIRECTORY;
+    baseDir = null;
+    constructor(logger, errorBuilder, appConfigService) {
+        this.logger = logger;
+        this.errorBuilder = errorBuilder;
+        this.appConfigService = appConfigService;
+    }
+    isConfigured() {
+        return !!process.env.STORAGE_LOCAL_BASE_DIR;
+    }
+    async initialize() {
+        const rawDir = process.env.STORAGE_LOCAL_BASE_DIR;
+        if (!rawDir) {
+            throw this.errorBuilder.buildError(ErrorType.CONFIGURATION, undefined, {
+                customMessageReference: ErrorCustomMessageReference.CONFIGURATION,
+                context: {
+                    message: 'STORAGE_LOCAL_BASE_DIR is required for local directory storage',
+                },
+            });
+        }
+        const resolved = path.resolve(rawDir);
+        await fs.promises.mkdir(resolved, { recursive: true });
+        this.baseDir = resolved;
+    }
+    async healthCheck() {
+        const startTime = Date.now();
+        if (!this.baseDir) {
+            return { healthy: false, latency: Date.now() - startTime, error: 'Local storage not initialized' };
+        }
+        try {
+            await fs.promises.access(this.baseDir, fs.constants.R_OK | fs.constants.W_OK);
+            return { healthy: true, latency: Date.now() - startTime };
+        }
+        catch (error) {
+            return {
+                healthy: false,
+                latency: Date.now() - startTime,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    getBaseDir() {
+        if (!this.baseDir) {
+            const raw = process.env.STORAGE_LOCAL_BASE_DIR;
+            if (!raw) {
+                throw this.errorBuilder.buildError(ErrorType.CONFIGURATION, undefined, {
+                    customMessageReference: ErrorCustomMessageReference.CONFIGURATION,
+                    context: { message: 'STORAGE_LOCAL_BASE_DIR is not configured' },
+                });
+            }
+            this.baseDir = path.resolve(raw);
+        }
+        return this.baseDir;
+    }
+    /**
+     * Compose the ordered path segments for an upload.
+     *
+     * Layout (all optional segments omitted when absent):
+     * [applicationId] / [folderPath] / <fileName|fileId>
+     *
+     * `includeApplicationId` defaults to `false` for local storage.
+     */
+    composePathSegments(fileId, executionContext, options) {
+        const segments = [];
+        const includeAppId = options?.includeApplicationId ?? false;
+        if (includeAppId) {
+            const applicationId = this.getApplicationId(executionContext);
+            segments.push(applicationId);
+        }
+        if (options?.folderPath) {
+            const trimmed = options.folderPath.trim();
+            if (trimmed) {
+                segments.push(trimmed);
+            }
+        }
+        const leaf = options?.fileName?.trim() || fileId;
+        if (!leaf) {
+            throw this.errorBuilder.buildError(ErrorType.VALIDATION, executionContext, {
+                customMessageReference: ErrorCustomMessageReference.VALIDATION,
+                context: { message: 'Cannot compose storage path: both fileName and fileId are empty' },
+            });
+        }
+        segments.push(leaf);
+        return segments;
+    }
+    /**
+     * Resolve a safe absolute path from a relative storage ref.
+     * Throws if the resolved path escapes the base directory (path traversal guard).
+     */
+    resolveSafePathFromRelative(relativePath) {
+        const base = this.getBaseDir();
+        const filePath = path.resolve(base, relativePath);
+        if (!filePath.startsWith(base + path.sep) && filePath !== base) {
+            throw this.errorBuilder.buildError(ErrorType.AUTHORIZATION, undefined, {
+                customMessageReference: ErrorCustomMessageReference.AUTHORIZATION,
+                context: {
+                    message: 'Path traversal detected',
+                    relativePath,
+                },
+            });
+        }
+        return filePath;
+    }
+    getApplicationId(executionContext) {
+        const applicationId = executionContext.applicationId || this.appConfigService.applicationId;
+        validateAppId(applicationId, this.errorBuilder, executionContext, 'applicationId');
+        return applicationId;
+    }
+    async upload(fileStream, fileId, mimeType, size, executionContext, options) {
+        validateFileId(fileId, this.errorBuilder, executionContext, 'fileId');
+        validateContentType(mimeType, this.errorBuilder, executionContext, 'mimeType');
+        validateSize(size, resolveConfiguredMaxFileSize(this.appConfigService.config.storage?.maxFileSize), this.errorBuilder, executionContext, 'size');
+        validateStream(fileStream, this.errorBuilder, executionContext, 'fileStream');
+        const segments = this.composePathSegments(fileId, executionContext, options);
+        const relativePath = segments.join('/');
+        const filePath = this.resolveSafePathFromRelative(relativePath);
+        await fs.promises.mkdir(path.dirname(filePath), { recursive: true });
+        try {
+            const writeStream = fs.createWriteStream(filePath);
+            await pipeline(fileStream, writeStream);
+        }
+        catch (error) {
+            this.convertStorageError(error, 'upload', executionContext, {
+                fileId,
+                provider: this.providerId,
+            });
+        }
+        const metadataRecord = {
+            contentType: mimeType,
+            size,
+            createdAt: new Date().toISOString(),
+        };
+        await fs.promises.writeFile(filePath + METADATA_SUFFIX, JSON.stringify(metadataRecord), 'utf-8');
+        return { storageRef: relativePath, provider: this.providerId };
+    }
+    async download(file, executionContext) {
+        const filePath = this.resolvePathFromStorageRef(file, executionContext);
+        try {
+            await fs.promises.access(filePath, fs.constants.R_OK);
+        }
+        catch {
+            throw this.errorBuilder.buildError(ErrorType.NOT_FOUND, executionContext, {
+                customMessageReference: ErrorCustomMessageReference.NOT_FOUND,
+                context: {
+                    message: 'File not found in local storage',
+                    fileId: file.fileId,
+                    provider: this.providerId,
+                },
+            });
+        }
+        const metadata = await this.readLocalMetadata(filePath, file.fileId, executionContext);
+        const stat = await fs.promises.stat(filePath);
+        const stream = fs.createReadStream(filePath);
+        return {
+            stream,
+            contentType: metadata.contentType,
+            size: stat.size,
+            lastModified: stat.mtime,
+        };
+    }
+    async delete(file, executionContext) {
+        const filePath = this.resolvePathFromStorageRef(file, executionContext);
+        try {
+            await fs.promises.unlink(filePath);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return;
+            this.convertStorageError(error, 'delete', executionContext, {
+                fileId: file.fileId,
+                provider: this.providerId,
+            });
+        }
+        try {
+            await fs.promises.unlink(filePath + METADATA_SUFFIX);
+        }
+        catch {
+            // metadata file already gone — fine
+        }
+    }
+    async getMetadata(file, executionContext) {
+        const filePath = this.resolvePathFromStorageRef(file, executionContext);
+        try {
+            await fs.promises.access(filePath, fs.constants.R_OK);
+        }
+        catch {
+            throw this.errorBuilder.buildError(ErrorType.NOT_FOUND, executionContext, {
+                customMessageReference: ErrorCustomMessageReference.NOT_FOUND,
+                context: {
+                    message: 'File not found in local storage',
+                    fileId: file.fileId,
+                    provider: this.providerId,
+                },
+            });
+        }
+        const metadata = await this.readLocalMetadata(filePath, file.fileId, executionContext);
+        const stat = await fs.promises.stat(filePath);
+        return {
+            contentType: metadata.contentType,
+            size: stat.size,
+            lastModified: stat.mtime,
+        };
+    }
+    /**
+     * Resolve the absolute filesystem path from a persisted storageRef.
+     * The ref IS the relative path from baseDir — just validate traversal.
+     */
+    resolvePathFromStorageRef(file, executionContext) {
+        const ref = file.storageRef;
+        if (!ref) {
+            const appId = this.getApplicationId(executionContext);
+            return this.resolveSafePathFromRelative(`${appId}/${file.fileId}`);
+        }
+        return this.resolveSafePathFromRelative(ref);
+    }
+    async readLocalMetadata(filePath, fileId, executionContext) {
+        const metaPath = filePath + METADATA_SUFFIX;
+        try {
+            const raw = await fs.promises.readFile(metaPath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return {
+                contentType: 'application/octet-stream',
+                size: 0,
+                createdAt: new Date().toISOString(),
+            };
+        }
+    }
+    convertStorageError(error, operation, executionContext, context) {
+        if (isWildoBackendError(error)) {
+            throw error;
+        }
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorCode = error?.code;
+        if (errorCode === 'ENOENT') {
+            throw this.errorBuilder.buildError(ErrorType.NOT_FOUND, executionContext, {
+                customMessageReference: ErrorCustomMessageReference.NOT_FOUND,
+                context: { message: 'File not found in local storage', operation, ...context },
+            });
+        }
+        if (errorCode === 'EACCES' || errorCode === 'EPERM') {
+            throw this.errorBuilder.buildError(ErrorType.AUTHORIZATION, executionContext, {
+                customMessageReference: ErrorCustomMessageReference.AUTHORIZATION,
+                context: { message: 'Local storage permission denied', operation, ...context, originalError: errorMessage },
+            });
+        }
+        if (errorCode === 'ENOSPC') {
+            throw this.errorBuilder.buildError(ErrorType.EXTERNAL_SERVICE, executionContext, {
+                customMessageReference: ErrorCustomMessageReference.EXTERNAL_SERVICE,
+                context: { message: 'Local storage disk full', operation, ...context, originalError: errorMessage },
+            });
+        }
+        throw this.errorBuilder.buildError(ErrorType.EXTERNAL_SERVICE, executionContext, {
+            customMessageReference: ErrorCustomMessageReference.EXTERNAL_SERVICE,
+            context: { message: `Local storage operation failed: ${operation}`, operation, ...context, originalError: errorMessage },
+        });
+    }
+};
+LocalDirectoryStorageProvider = __decorate([
+    injectable(),
+    __param(0, inject(SAAS_SERVICE_TYPES.Logger)),
+    __param(1, inject(SAAS_SERVICE_TYPES.ErrorBuilderService)),
+    __param(2, inject(SAAS_SERVICE_TYPES.AppConfigService)),
+    __metadata("design:paramtypes", [Function, ErrorBuilderBackendService,
+        AppConfigurationService])
+], LocalDirectoryStorageProvider);
+export { LocalDirectoryStorageProvider };
+//# sourceMappingURL=local-directory-storage-provider.backend.service.js.map

package/dist/esm/files/storage/local-directory-storage-provider.backend.service.js.map

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

package/dist/esm/files/storage/wildo-managed-storage-provider.backend.service.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Wildo-Managed Storage Provider
+ *
+ * Default IFileStorageProvider implementation backed by MinIO/S3.
+ * All file operations go through z_file() declarations and the unified
+ * IFileStorageProvider interface. Storage credentials are injected
+ * via STORAGE_* env vars, managed by apps-manager.
+ */
+import { Readable } from 'stream';
+import { FileStorageAccepted } from '@wildo-ai/zod-decorators';
+import type { LoggerService } from '../../monitoring/logger/services/logger.service.js';
+import { ErrorBuilderBackendService } from '../../errors/services/error-builder.backend.service.js';
+import { AppConfigurationService } from '../../config/services/app-configuration.backend.service.js';
+import type { ExecutionContext } from '../../runtime/models/execution-context.backend.schemas.js';
+import type { IFileStorageProvider, StorageUploadResult, StorageUploadOptions, StorageDownloadResult, StorageFileMetadata, StorageProviderHealthResult, StoredFileStorageTarget } from './file-storage-provider.types.js';
+export declare class WildoManagedStorageProvider implements IFileStorageProvider {
+    private readonly logger;
+    private readonly errorBuilder;
+    private readonly appConfigService;
+    readonly providerId = FileStorageAccepted.WILDO_MANAGED;
+    private client;
+    private bucketName;
+    constructor(logger: LoggerService, errorBuilder: ErrorBuilderBackendService, appConfigService: AppConfigurationService);
+    isConfigured(): boolean;
+    /**
+     * Eagerly initialize the MinIO client and verify bucket access.
+     * Call this at startup to fail fast on misconfiguration.
+     * If not called, the client is created lazily on first operation.
+     */
+    initialize(): Promise<void>;
+    private getClient;
+    private getApplicationId;
+    private resolveApplicationObjectKey;
+    private convertStorageError;
+    upload(fileStream: Readable, fileId: string, mimeType: string, size: number, executionContext: ExecutionContext<any>, options?: StorageUploadOptions): Promise<StorageUploadResult>;
+    download(file: StoredFileStorageTarget, executionContext: ExecutionContext<any>): Promise<StorageDownloadResult>;
+    delete(file: StoredFileStorageTarget, executionContext: ExecutionContext<any>): Promise<void>;
+    getMetadata(file: StoredFileStorageTarget, executionContext: ExecutionContext<any>): Promise<StorageFileMetadata>;
+    healthCheck(): Promise<StorageProviderHealthResult>;
+}
+//# sourceMappingURL=wildo-managed-storage-provider.backend.service.d.ts.map

package/dist/esm/files/storage/wildo-managed-storage-provider.backend.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wildo-managed-storage-provider.backend.service.d.ts","sourceRoot":"","sources":["../../../../src/files/storage/wildo-managed-storage-provider.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAGlC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAClG,OAAO,EAAE,0BAA0B,EAAE,MAAM,kEAAkE,CAAC;AAC9G,OAAO,EAAE,uBAAuB,EAAE,MAAM,sEAAsE,CAAC;AAC/G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qEAAqE,CAAC;AAG5G,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,EACxB,MAAM,+BAA+B,CAAC;AAIvC,qBACa,2BAA4B,YAAW,oBAAoB;IAOpE,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAE7B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAVnC,QAAQ,CAAC,UAAU,qCAAqC;IACxD,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,UAAU,CAAyD;gBAIxD,MAAM,EAAE,aAAa,EAErB,YAAY,EAAE,0BAA0B,EAExC,gBAAgB,EAAE,uBAAuB;IAG5D,YAAY,IAAI,OAAO;IAIvB;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAInB,SAAS;IAyFvB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,2BAA2B;IA6CnC,OAAO,CAAC,mBAAmB;IA8HrB,MAAM,CACV,UAAU,EAAE,QAAQ,EACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,gBAAgB,CAAC,GAAG,CAAC,EACvC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC;IA2DzB,QAAQ,CACZ,IAAI,EAAE,uBAAuB,EAC7B,gBAAgB,EAAE,gBAAgB,CAAC,GAAG,CAAC,GACtC,OAAO,CAAC,qBAAqB,CAAC;IAgD3B,MAAM,CACV,IAAI,EAAE,uBAAuB,EAC7B,gBAAgB,EAAE,gBAAgB,CAAC,GAAG,CAAC,GACtC,OAAO,CAAC,IAAI,CAAC;IAoBV,WAAW,CACf,IAAI,EAAE,uBAAuB,EAC7B,gBAAgB,EAAE,gBAAgB,CAAC,GAAG,CAAC,GACtC,OAAO,CAAC,mBAAmB,CAAC;IAyCzB,WAAW,IAAI,OAAO,CAAC,2BAA2B,CAAC;CAiB1D"}