@oronts/vendure-data-hub-plugin 0.1.0

package/dist/src/services/runtime/runtime-config.service.js

@@ -0,0 +1,87 @@
+"use strict";
+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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RuntimeConfigService = void 0;
+const common_1 = require("@nestjs/common");
+const defaults_1 = require("../../constants/defaults");
+let RuntimeConfigService = class RuntimeConfigService {
+    constructor() {
+        this.config = {};
+    }
+    initialize(config) {
+        this.config = config ?? {};
+    }
+    getBatchConfig() {
+        return {
+            size: this.config.batch?.size ?? defaults_1.BATCH.SIZE,
+            bulkSize: this.config.batch?.bulkSize ?? defaults_1.BATCH.BULK_SIZE,
+            maxInFlight: this.config.batch?.maxInFlight ?? defaults_1.BATCH.MAX_IN_FLIGHT,
+            rateLimitRps: this.config.batch?.rateLimitRps ?? defaults_1.BATCH.RATE_LIMIT_RPS,
+        };
+    }
+    getHttpConfig() {
+        return {
+            timeoutMs: this.config.http?.timeoutMs ?? defaults_1.HTTP.TIMEOUT_MS,
+            maxRetries: this.config.http?.maxRetries ?? defaults_1.HTTP.MAX_RETRIES,
+            retryDelayMs: this.config.http?.retryDelayMs ?? defaults_1.HTTP.RETRY_DELAY_MS,
+            retryMaxDelayMs: this.config.http?.retryMaxDelayMs ?? defaults_1.HTTP.RETRY_MAX_DELAY_MS,
+            exponentialBackoff: this.config.http?.exponentialBackoff ?? defaults_1.HTTP.EXPONENTIAL_BACKOFF,
+            backoffMultiplier: this.config.http?.backoffMultiplier ?? defaults_1.HTTP.BACKOFF_MULTIPLIER,
+        };
+    }
+    getCircuitBreakerConfig() {
+        return {
+            enabled: this.config.circuitBreaker?.enabled ?? defaults_1.CIRCUIT_BREAKER.ENABLED,
+            failureThreshold: this.config.circuitBreaker?.failureThreshold ?? defaults_1.CIRCUIT_BREAKER.FAILURE_THRESHOLD,
+            successThreshold: this.config.circuitBreaker?.successThreshold ?? defaults_1.CIRCUIT_BREAKER.SUCCESS_THRESHOLD,
+            resetTimeoutMs: this.config.circuitBreaker?.resetTimeoutMs ?? defaults_1.CIRCUIT_BREAKER.RESET_TIMEOUT_MS,
+            failureWindowMs: this.config.circuitBreaker?.failureWindowMs ?? defaults_1.CIRCUIT_BREAKER.FAILURE_WINDOW_MS,
+        };
+    }
+    getConnectionPoolConfig() {
+        return {
+            min: this.config.connectionPool?.min ?? defaults_1.CONNECTION_POOL.MIN,
+            max: this.config.connectionPool?.max ?? defaults_1.CONNECTION_POOL.MAX,
+            idleTimeoutMs: this.config.connectionPool?.idleTimeoutMs ?? defaults_1.CONNECTION_POOL.IDLE_TIMEOUT_MS,
+            acquireTimeoutMs: this.config.connectionPool?.acquireTimeoutMs ?? defaults_1.CONNECTION_POOL.ACQUIRE_TIMEOUT_MS,
+        };
+    }
+    getPaginationConfig() {
+        return {
+            maxPages: this.config.pagination?.maxPages ?? defaults_1.PAGINATION.MAX_PAGES,
+            pageSize: this.config.pagination?.pageSize ?? defaults_1.PAGINATION.PAGE_SIZE,
+            databasePageSize: this.config.pagination?.databasePageSize ?? defaults_1.PAGINATION.DATABASE_PAGE_SIZE,
+        };
+    }
+    /**
+     * Get scheduler configuration with defaults
+     */
+    getSchedulerConfig() {
+        return {
+            checkIntervalMs: this.config.scheduler?.checkIntervalMs ?? defaults_1.SCHEDULER.CHECK_INTERVAL_MS,
+            refreshIntervalMs: this.config.scheduler?.refreshIntervalMs ?? defaults_1.SCHEDULER.REFRESH_INTERVAL_MS,
+            minIntervalMs: this.config.scheduler?.minIntervalMs ?? defaults_1.SCHEDULER.MIN_INTERVAL_MS,
+        };
+    }
+    /**
+     * Get event trigger service configuration with defaults
+     */
+    getEventTriggerConfig() {
+        return {
+            cacheRefreshIntervalMs: this.config.eventTrigger?.cacheRefreshIntervalMs ?? defaults_1.SCHEDULER.REFRESH_INTERVAL_MS,
+        };
+    }
+    getRawConfig() {
+        return this.config;
+    }
+};
+exports.RuntimeConfigService = RuntimeConfigService;
+exports.RuntimeConfigService = RuntimeConfigService = __decorate([
+    (0, common_1.Injectable)()
+], RuntimeConfigService);
+//# sourceMappingURL=runtime-config.service.js.map

package/dist/src/services/runtime/runtime-config.service.js.map

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

package/dist/src/services/storage/file-storage.service.d.ts

@@ -0,0 +1,88 @@
+import { OnModuleInit, OnModuleDestroy } from '@nestjs/common';
+import { RequestContext, ConfigService } from '@vendure/core';
+import { DataHubLoggerFactory } from '../logger';
+export interface StoredFile {
+    id: string;
+    originalName: string;
+    storagePath: string;
+    mimeType: string;
+    size: number;
+    hash: string;
+    uploadedAt: Date;
+    expiresAt?: Date;
+    metadata?: Record<string, unknown>;
+}
+interface UploadResult {
+    success: boolean;
+    file?: StoredFile;
+    error?: string;
+}
+interface StorageOptions {
+    maxFileSize?: number;
+    allowedMimeTypes?: string[];
+    expiresInMinutes?: number;
+    metadata?: Record<string, unknown>;
+}
+export declare class FileStorageService implements OnModuleInit, OnModuleDestroy {
+    private configService;
+    private readonly logger;
+    private backend;
+    private fileIndex;
+    private cleanupHandle;
+    constructor(configService: ConfigService, loggerFactory: DataHubLoggerFactory);
+    onModuleDestroy(): Promise<void>;
+    onModuleInit(): Promise<void>;
+    storeFile(ctx: RequestContext, buffer: Buffer, originalName: string, mimeType: string, options?: StorageOptions): Promise<UploadResult>;
+    storeBase64(ctx: RequestContext, base64Data: string, originalName: string, mimeType: string, options?: StorageOptions): Promise<UploadResult>;
+    getFile(fileId: string): Promise<StoredFile | null>;
+    readFile(fileId: string): Promise<Buffer | null>;
+    readFileAsString(fileId: string, encoding?: BufferEncoding): Promise<string | null>;
+    deleteFile(fileId: string): Promise<boolean>;
+    getFileUrl(fileId: string, expiresInSeconds?: number): Promise<string | null>;
+    listFiles(options?: {
+        limit?: number;
+        offset?: number;
+        filter?: {
+            mimeType?: string;
+            uploadedAfter?: Date;
+            uploadedBefore?: Date;
+        };
+    }): Promise<{
+        files: StoredFile[];
+        totalItems: number;
+    }>;
+    getStorageStats(): Promise<{
+        totalFiles: number;
+        totalSize: number;
+        backendType: string;
+        byMimeType: Record<string, {
+            count: number;
+            size: number;
+        }>;
+    }>;
+    /**
+     * Rebuild the in-memory file index by scanning existing files from the storage backend.
+     * This ensures the index is recovered after a service restart.
+     * Only basic metadata (path, name, size) can be recovered; original upload metadata
+     * (hash, mimeType, expiresAt, custom metadata) are not available from the storage backend.
+     */
+    private rebuildIndex;
+    /**
+     * Infer MIME type from file extension for index recovery.
+     * Only covers types relevant to DataHub file storage.
+     */
+    private inferMimeType;
+    private startCleanupJob;
+    private cleanupExpiredFiles;
+    /**
+     * Evict oldest files from the in-memory index when it exceeds MAX_FILE_INDEX_SIZE.
+     * Sorts by uploadedAt (oldest first) and removes FILE_INDEX_EVICTION_RATIO of entries.
+     * Only removes from the index; does not delete the underlying storage files.
+     */
+    private evictOldestFromIndex;
+    private generateFileId;
+    private getDatePath;
+    private isAllowedMimeType;
+}
+export {};
+//# sourceMappingURL=file-storage.service.d.ts.map

package/dist/src/services/storage/file-storage.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage.service.d.ts","sourceRoot":"","sources":["../../../../src/services/storage/file-storage.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EACH,cAAc,EACd,aAAa,EAChB,MAAM,eAAe,CAAC;AAIvB,OAAO,EAAiB,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAMhE,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,UAAU,YAAY;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,cAAc;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAaD,qBACa,kBAAmB,YAAW,YAAY,EAAE,eAAe;IAOhE,OAAO,CAAC,aAAa;IANzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,aAAa,CAA+C;gBAGxD,aAAa,EAAE,aAAa,EACpC,aAAa,EAAE,oBAAoB;IAMjC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAQhC,YAAY;IAYZ,SAAS,CACX,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,cAAmB,GAC7B,OAAO,CAAC,YAAY,CAAC;IAoElB,WAAW,CACb,GAAG,EAAE,cAAc,EACnB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,cAAmB,GAC7B,OAAO,CAAC,YAAY,CAAC;IAMlB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAInD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAMhD,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,cAAwB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAM5F,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAe5C,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAW7E,SAAS,CAAC,OAAO,CAAC,EAAE;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE;YACL,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,aAAa,CAAC,EAAE,IAAI,CAAC;YACrB,cAAc,CAAC,EAAE,IAAI,CAAC;SACzB,CAAC;KACL,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IA8BlD,eAAe,IAAI,OAAO,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC/D,CAAC;IAsBF;;;;;OAKG;YACW,YAAY;IAkD1B;;;OAGG;IACH,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,eAAe;YAOT,mBAAmB;IAmBjC;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAoB5B,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,iBAAiB;CAY5B"}

package/dist/src/services/storage/file-storage.service.js

@@ -0,0 +1,362 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+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 __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileStorageService = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@vendure/core");
+const crypto = __importStar(require("crypto"));
+const path = __importStar(require("path"));
+const index_1 = require("../../constants/index");
+const logger_1 = require("../logger");
+const storage_backend_factory_1 = require("./storage-backend.factory");
+const error_utils_1 = require("../../utils/error.utils");
+const id_generation_utils_1 = require("../../utils/id-generation.utils");
+const DEFAULT_MAX_FILE_SIZE = index_1.FILE_STORAGE.MAX_FILE_SIZE_BYTES;
+const DEFAULT_ALLOWED_TYPES = [
+    index_1.CONTENT_TYPES.CSV,
+    index_1.CONTENT_TYPES.PLAIN,
+    index_1.CONTENT_TYPES.JSON,
+    index_1.CONTENT_TYPES.XML,
+    'text/xml',
+    index_1.EXTENSION_MIME_MAP['.xls'],
+    index_1.EXTENSION_MIME_MAP['.xlsx'],
+];
+let FileStorageService = class FileStorageService {
+    constructor(configService, loggerFactory) {
+        this.configService = configService;
+        this.fileIndex = new Map();
+        this.cleanupHandle = null;
+        this.logger = loggerFactory.createLogger(index_1.LOGGER_CONTEXTS.FILE_STORAGE_SERVICE);
+        this.backend = (0, storage_backend_factory_1.createStorageBackendFromEnv)();
+    }
+    async onModuleDestroy() {
+        if (this.cleanupHandle) {
+            clearInterval(this.cleanupHandle);
+            this.cleanupHandle = null;
+            this.logger.debug('File storage cleanup job stopped');
+        }
+    }
+    async onModuleInit() {
+        await this.backend.init();
+        await this.rebuildIndex();
+        this.startCleanupJob();
+        this.logger.info('FileStorageService initialized', {
+            backendType: this.backend.type,
+            cleanupIntervalMs: index_1.SCHEDULER.FILE_CLEANUP_INTERVAL_MS,
+            recoveredFiles: this.fileIndex.size,
+        });
+    }
+    async storeFile(ctx, buffer, originalName, mimeType, options = {}) {
+        try {
+            const maxSize = options.maxFileSize ?? DEFAULT_MAX_FILE_SIZE;
+            if (buffer.length > maxSize) {
+                return {
+                    success: false,
+                    error: `File size ${buffer.length} exceeds maximum ${maxSize} bytes`,
+                };
+            }
+            const allowedTypes = options.allowedMimeTypes ?? DEFAULT_ALLOWED_TYPES;
+            if (!this.isAllowedMimeType(mimeType, allowedTypes)) {
+                return {
+                    success: false,
+                    error: `File type ${mimeType} is not allowed. Allowed types: ${allowedTypes.join(', ')}`,
+                };
+            }
+            const fileId = this.generateFileId();
+            const hash = crypto.createHash('sha256').update(buffer).digest('hex');
+            const datePath = this.getDatePath();
+            const storagePath = path.join(datePath, `${fileId}${path.extname(originalName)}`);
+            await this.backend.write(storagePath, buffer);
+            const expiresAt = options.expiresInMinutes
+                ? new Date(Date.now() + options.expiresInMinutes * 60 * 1000)
+                : undefined;
+            const storedFile = {
+                id: fileId,
+                originalName,
+                storagePath,
+                mimeType,
+                size: buffer.length,
+                hash,
+                uploadedAt: new Date(),
+                expiresAt,
+                metadata: options.metadata,
+            };
+            this.evictOldestFromIndex();
+            this.fileIndex.set(fileId, storedFile);
+            this.logger.info('Stored file successfully', {
+                fileId,
+                originalName,
+                size: buffer.length,
+                mimeType,
+                backendType: this.backend.type,
+                expiresAt: expiresAt?.toISOString(),
+            });
+            return { success: true, file: storedFile };
+        }
+        catch (error) {
+            this.logger.error('Failed to store file', (0, error_utils_1.ensureError)(error), {
+                originalName,
+                mimeType,
+                size: buffer.length,
+            });
+            return {
+                success: false,
+                error: (0, error_utils_1.getErrorMessage)(error),
+            };
+        }
+    }
+    async storeBase64(ctx, base64Data, originalName, mimeType, options = {}) {
+        const cleanBase64 = base64Data.replace(/^data:[^;]+;base64,/, '');
+        const buffer = Buffer.from(cleanBase64, 'base64');
+        return this.storeFile(ctx, buffer, originalName, mimeType, options);
+    }
+    async getFile(fileId) {
+        return this.fileIndex.get(fileId) ?? null;
+    }
+    async readFile(fileId) {
+        const file = this.fileIndex.get(fileId);
+        if (!file)
+            return null;
+        return this.backend.read(file.storagePath);
+    }
+    async readFileAsString(fileId, encoding = 'utf-8') {
+        const buffer = await this.readFile(fileId);
+        if (!buffer)
+            return null;
+        return buffer.toString(encoding);
+    }
+    async deleteFile(fileId) {
+        const file = this.fileIndex.get(fileId);
+        if (!file)
+            return false;
+        try {
+            await this.backend.delete(file.storagePath);
+            this.fileIndex.delete(fileId);
+            this.logger.debug('Deleted file', { fileId, originalName: file.originalName });
+            return true;
+        }
+        catch (error) {
+            this.logger.error('Failed to delete file', (0, error_utils_1.ensureError)(error), { fileId });
+            return false;
+        }
+    }
+    async getFileUrl(fileId, expiresInSeconds) {
+        const file = this.fileIndex.get(fileId);
+        if (!file)
+            return null;
+        if (this.backend.getUrl) {
+            return this.backend.getUrl(file.storagePath, expiresInSeconds);
+        }
+        return null;
+    }
+    async listFiles(options) {
+        let files = Array.from(this.fileIndex.values());
+        if (options?.filter) {
+            const { mimeType, uploadedAfter, uploadedBefore } = options.filter;
+            if (mimeType) {
+                files = files.filter(f => f.mimeType === mimeType);
+            }
+            if (uploadedAfter) {
+                files = files.filter(f => f.uploadedAt >= uploadedAfter);
+            }
+            if (uploadedBefore) {
+                files = files.filter(f => f.uploadedAt <= uploadedBefore);
+            }
+        }
+        files.sort((a, b) => b.uploadedAt.getTime() - a.uploadedAt.getTime());
+        const totalItems = files.length;
+        if (options?.offset) {
+            files = files.slice(options.offset);
+        }
+        if (options?.limit) {
+            files = files.slice(0, options.limit);
+        }
+        return { files, totalItems };
+    }
+    async getStorageStats() {
+        const files = Array.from(this.fileIndex.values());
+        const byMimeType = {};
+        let totalSize = 0;
+        for (const file of files) {
+            totalSize += file.size;
+            if (!byMimeType[file.mimeType]) {
+                byMimeType[file.mimeType] = { count: 0, size: 0 };
+            }
+            byMimeType[file.mimeType].count++;
+            byMimeType[file.mimeType].size += file.size;
+        }
+        return {
+            totalFiles: files.length,
+            totalSize,
+            backendType: this.backend.type,
+            byMimeType,
+        };
+    }
+    /**
+     * Rebuild the in-memory file index by scanning existing files from the storage backend.
+     * This ensures the index is recovered after a service restart.
+     * Only basic metadata (path, name, size) can be recovered; original upload metadata
+     * (hash, mimeType, expiresAt, custom metadata) are not available from the storage backend.
+     */
+    async rebuildIndex() {
+        try {
+            const files = await this.backend.list('');
+            let recovered = 0;
+            for (const storagePath of files) {
+                // Extract file ID from path: paths are like "2026/01/15/file_12345_abc.csv"
+                const fileName = path.basename(storagePath);
+                const fileIdMatch = fileName.match(/^(file_[a-z0-9]+_[a-f0-9]+)/);
+                if (!fileIdMatch)
+                    continue;
+                const fileId = fileIdMatch[1];
+                // Skip if already in the index (e.g. from a previous call)
+                if (this.fileIndex.has(fileId))
+                    continue;
+                // Read file to compute size; skip files that can't be read
+                const buffer = await this.backend.read(storagePath);
+                if (!buffer)
+                    continue;
+                const ext = path.extname(fileName).toLowerCase();
+                const mimeType = this.inferMimeType(ext);
+                const storedFile = {
+                    id: fileId,
+                    originalName: fileName,
+                    storagePath,
+                    mimeType,
+                    size: buffer.length,
+                    hash: crypto.createHash('sha256').update(buffer).digest('hex'),
+                    uploadedAt: new Date(),
+                };
+                this.fileIndex.set(fileId, storedFile);
+                recovered++;
+            }
+            if (recovered > 0) {
+                this.logger.info('Rebuilt file index from storage backend', {
+                    recoveredFiles: recovered,
+                });
+            }
+        }
+        catch (error) {
+            this.logger.warn('Failed to rebuild file index from storage backend', {
+                error: (0, error_utils_1.getErrorMessage)(error),
+            });
+        }
+    }
+    /**
+     * Infer MIME type from file extension for index recovery.
+     * Only covers types relevant to DataHub file storage.
+     */
+    inferMimeType(ext) {
+        return index_1.EXTENSION_MIME_MAP[ext] ?? index_1.CONTENT_TYPES.OCTET_STREAM;
+    }
+    startCleanupJob() {
+        this.cleanupHandle = setInterval(() => {
+            this.cleanupExpiredFiles();
+        }, index_1.SCHEDULER.FILE_CLEANUP_INTERVAL_MS);
+        this.cleanupHandle.unref();
+    }
+    async cleanupExpiredFiles() {
+        const now = new Date();
+        const expiredFiles = [];
+        for (const [id, file] of this.fileIndex.entries()) {
+            if (file.expiresAt && file.expiresAt <= now) {
+                expiredFiles.push(id);
+            }
+        }
+        for (const fileId of expiredFiles) {
+            await this.deleteFile(fileId);
+        }
+        if (expiredFiles.length > 0) {
+            this.logger.info('Cleaned up expired files', { filesDeleted: expiredFiles.length });
+        }
+    }
+    /**
+     * Evict oldest files from the in-memory index when it exceeds MAX_FILE_INDEX_SIZE.
+     * Sorts by uploadedAt (oldest first) and removes FILE_INDEX_EVICTION_RATIO of entries.
+     * Only removes from the index; does not delete the underlying storage files.
+     */
+    evictOldestFromIndex() {
+        const maxSize = index_1.FILE_STORAGE.MAX_FILE_INDEX_SIZE;
+        if (this.fileIndex.size < maxSize)
+            return;
+        const evictCount = Math.ceil(maxSize * index_1.FILE_STORAGE.FILE_INDEX_EVICTION_RATIO);
+        const sorted = Array.from(this.fileIndex.entries())
+            .sort((a, b) => a[1].uploadedAt.getTime() - b[1].uploadedAt.getTime());
+        const toEvict = sorted.slice(0, evictCount);
+        for (const [id] of toEvict) {
+            this.fileIndex.delete(id);
+        }
+        this.logger.info('Evicted oldest entries from file index', {
+            evictedCount: toEvict.length,
+            remainingCount: this.fileIndex.size,
+            maxSize,
+        });
+    }
+    generateFileId() {
+        return (0, id_generation_utils_1.generateTimestampedId)('file', 16);
+    }
+    getDatePath() {
+        const now = new Date();
+        return `${now.getFullYear()}/${String(now.getMonth() + 1).padStart(2, '0')}/${String(now.getDate()).padStart(2, '0')}`;
+    }
+    isAllowedMimeType(mimeType, allowedTypes) {
+        const normalizedType = mimeType.toLowerCase().split(';')[0].trim();
+        return allowedTypes.some(allowed => {
+            if (allowed === '*/*')
+                return true;
+            if (allowed.endsWith('/*')) {
+                const prefix = allowed.slice(0, -2);
+                return normalizedType.startsWith(prefix);
+            }
+            return normalizedType === allowed.toLowerCase();
+        });
+    }
+};
+exports.FileStorageService = FileStorageService;
+exports.FileStorageService = FileStorageService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.ConfigService,
+        logger_1.DataHubLoggerFactory])
+], FileStorageService);
+//# sourceMappingURL=file-storage.service.js.map

package/dist/src/services/storage/file-storage.service.js.map

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

package/dist/src/services/storage/index.d.ts

@@ -0,0 +1,2 @@
+export * from './file-storage.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/services/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/dist/src/services/storage/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./file-storage.service"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/services/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/storage/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC"}

package/dist/src/services/storage/local-storage.backend.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Local Filesystem Storage Backend
+ */
+import { StorageBackend, LocalStorageOptions } from './storage-backend.interface';
+export declare class LocalStorageBackend implements StorageBackend {
+    private options;
+    readonly type: "local";
+    private basePath;
+    constructor(options: LocalStorageOptions);
+    /**
+     * Securely resolve a path within the storage base directory.
+     * Prevents path traversal attacks by ensuring the resolved path
+     * stays within the basePath boundary.
+     */
+    private getSecurePath;
+    init(): Promise<void>;
+    write(filePath: string, data: Buffer): Promise<void>;
+    read(filePath: string): Promise<Buffer | null>;
+    delete(filePath: string): Promise<boolean>;
+    exists(filePath: string): Promise<boolean>;
+    list(prefix: string): Promise<string[]>;
+    private walkDir;
+}
+//# sourceMappingURL=local-storage.backend.d.ts.map

package/dist/src/services/storage/local-storage.backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-storage.backend.d.ts","sourceRoot":"","sources":["../../../../src/services/storage/local-storage.backend.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGlF,qBAAa,mBAAoB,YAAW,cAAc;IAI1C,OAAO,CAAC,OAAO;IAH3B,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAS;gBAEL,OAAO,EAAE,mBAAmB;IAIhD;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAIf,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQrB,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAapD,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAU9C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAW1C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU1C,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAuB/B,OAAO;CAkBxB"}