@acorex-platform/framework-server 0.0.10

package/file-storage/http/src/lib/file-storage.controller.js

@@ -0,0 +1,188 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileStorageController = void 0;
+const tslib_1 = require("tslib");
+const security_1 = require("@acorex-platform/framework-server/security");
+const common_1 = require("@nestjs/common");
+const platform_express_1 = require("@nestjs/platform-express");
+const swagger_1 = require("@nestjs/swagger");
+const multer_1 = require("multer");
+const file_storage_facade_service_1 = require("./file-storage-facade.service");
+//#region ---- Request DTOs ----
+class FileStorageUpdateBodyDto {
+}
+class FindManyBodyDto {
+}
+//#endregion
+//#region ---- File storage REST API ----
+let FileStorageController = class FileStorageController {
+    constructor(facade) {
+        this.facade = facade;
+    }
+    async save(file, refId, refType, category, name, path, isPrimary, status, metadata) {
+        if (!file?.buffer) {
+            throw new common_1.BadRequestException('File is required');
+        }
+        const parsedMetadata = metadata ? JSON.parse(metadata) : undefined;
+        return this.facade.save({
+            buffer: file.buffer,
+            originalName: file.originalname,
+            mimeType: file.mimetype,
+            refId,
+            refType,
+            category,
+            name,
+            path,
+            isPrimary: isPrimary !== undefined ? isPrimary === 'true' : undefined,
+            status: status,
+            metadata: parsedMetadata,
+        });
+    }
+    async update(fileId, body) {
+        return this.facade.update({
+            fileId,
+            metadata: body.metadata,
+            path: body.path,
+            name: body.name,
+            isPrimary: body.isPrimary,
+        });
+    }
+    async find(refId, refType, category, mimeType, isPublic, isPrimary, uploadedAtFrom, uploadedAtTo) {
+        return this.facade.find({
+            refId,
+            refType,
+            category,
+            mimeType,
+            isPublic: isPublic !== undefined ? isPublic === 'true' : undefined,
+            isPrimary: isPrimary !== undefined ? isPrimary === 'true' : undefined,
+            uploadedAtFrom,
+            uploadedAtTo,
+        });
+    }
+    async getInfo(fileId) {
+        return this.facade.getInfo(fileId);
+    }
+    async findMany(body) {
+        return this.facade.findMany(body.ids ?? []);
+    }
+    async remove(fileId) {
+        await this.facade.remove(fileId);
+    }
+    async commit(fileId) {
+        await this.facade.commit(fileId);
+    }
+    async markForDeletion(fileId) {
+        await this.facade.markForDeletion(fileId);
+    }
+    async download(fileId, res) {
+        const { buffer, mimeType, name } = await this.facade.readBinary(fileId);
+        res.setHeader('Content-Type', mimeType);
+        if (name) {
+            res.setHeader('Content-Disposition', `inline; filename="${encodeURIComponent(name)}"`);
+        }
+        res.send(buffer);
+    }
+};
+exports.FileStorageController = FileStorageController;
+tslib_1.__decorate([
+    (0, common_1.Post)('save'),
+    (0, swagger_1.ApiOperation)({ summary: 'Save a file' }),
+    (0, swagger_1.ApiConsumes)('multipart/form-data'),
+    (0, common_1.UseInterceptors)((0, platform_express_1.FileInterceptor)('file', {
+        storage: (0, multer_1.memoryStorage)(),
+    })),
+    tslib_1.__param(0, (0, common_1.UploadedFile)()),
+    tslib_1.__param(1, (0, common_1.Body)('refId')),
+    tslib_1.__param(2, (0, common_1.Body)('refType')),
+    tslib_1.__param(3, (0, common_1.Body)('category')),
+    tslib_1.__param(4, (0, common_1.Body)('name')),
+    tslib_1.__param(5, (0, common_1.Body)('path')),
+    tslib_1.__param(6, (0, common_1.Body)('isPrimary')),
+    tslib_1.__param(7, (0, common_1.Body)('status')),
+    tslib_1.__param(8, (0, common_1.Body)('metadata')),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object, String, String, String, String, String, String, String, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], FileStorageController.prototype, "save", null);
+tslib_1.__decorate([
+    (0, common_1.Put)('update/:fileId'),
+    (0, swagger_1.ApiOperation)({ summary: 'Update file metadata' }),
+    tslib_1.__param(0, (0, common_1.Param)('fileId')),
+    tslib_1.__param(1, (0, common_1.Body)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, FileStorageUpdateBodyDto]),
+    tslib_1.__metadata("design:returntype", Promise)
+], FileStorageController.prototype, "update", null);
+tslib_1.__decorate([
+    (0, common_1.Get)('find'),
+    (0, swagger_1.ApiOperation)({ summary: 'Find committed files' }),
+    tslib_1.__param(0, (0, common_1.Query)('refId')),
+    tslib_1.__param(1, (0, common_1.Query)('refType')),
+    tslib_1.__param(2, (0, common_1.Query)('category')),
+    tslib_1.__param(3, (0, common_1.Query)('mimeType')),
+    tslib_1.__param(4, (0, common_1.Query)('isPublic')),
+    tslib_1.__param(5, (0, common_1.Query)('isPrimary')),
+    tslib_1.__param(6, (0, common_1.Query)('uploadedAtFrom')),
+    tslib_1.__param(7, (0, common_1.Query)('uploadedAtTo')),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, String, String, String, String, String, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], FileStorageController.prototype, "find", null);
+tslib_1.__decorate([
+    (0, common_1.Get)('info/:fileId'),
+    (0, swagger_1.ApiOperation)({ summary: 'Get file info' }),
+    tslib_1.__param(0, (0, common_1.Param)('fileId')),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], FileStorageController.prototype, "getInfo", null);
+tslib_1.__decorate([
+    (0, common_1.Post)('find-many'),
+    (0, swagger_1.ApiOperation)({ summary: 'Find many files by ids' }),
+    tslib_1.__param(0, (0, common_1.Body)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [FindManyBodyDto]),
+    tslib_1.__metadata("design:returntype", Promise)
+], FileStorageController.prototype, "findMany", null);
+tslib_1.__decorate([
+    (0, common_1.Delete)('remove/:fileId'),
+    (0, swagger_1.ApiOperation)({ summary: 'Remove a file' }),
+    tslib_1.__param(0, (0, common_1.Param)('fileId')),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], FileStorageController.prototype, "remove", null);
+tslib_1.__decorate([
+    (0, common_1.Post)('commit/:fileId'),
+    (0, swagger_1.ApiOperation)({ summary: 'Commit a file' }),
+    tslib_1.__param(0, (0, common_1.Param)('fileId')),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], FileStorageController.prototype, "commit", null);
+tslib_1.__decorate([
+    (0, common_1.Post)('mark-for-deletion/:fileId'),
+    (0, swagger_1.ApiOperation)({ summary: 'Mark a file for deletion' }),
+    tslib_1.__param(0, (0, common_1.Param)('fileId')),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], FileStorageController.prototype, "markForDeletion", null);
+tslib_1.__decorate([
+    (0, common_1.Get)('download/:fileId'),
+    (0, swagger_1.ApiOperation)({ summary: 'Download file binary' }),
+    tslib_1.__param(0, (0, common_1.Param)('fileId')),
+    tslib_1.__param(1, (0, common_1.Res)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], FileStorageController.prototype, "download", null);
+exports.FileStorageController = FileStorageController = tslib_1.__decorate([
+    (0, swagger_1.ApiTags)('file-storage'),
+    (0, swagger_1.ApiBearerAuth)(),
+    (0, common_1.UseGuards)(security_1.JwtAuthGuard),
+    (0, common_1.Controller)('file-storage'),
+    tslib_1.__metadata("design:paramtypes", [file_storage_facade_service_1.FileStorageFacadeService])
+], FileStorageController);
+//#endregion
+//# sourceMappingURL=file-storage.controller.js.map

package/file-storage/http/src/lib/file-storage.controller.js.map

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

package/file-storage/local/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@acorex-platform/framework-server/file-storage/local",
+  "version": "0.0.0-ACOREX",
+  "private": true,
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "peerDependencies": {
+    "@acorex-platform/framework-server/file-storage/abstract": "0.0.0-ACOREX",
+    "@acorex-platform/framework-shared": "0.0.0-ACOREX",
+    "@nestjs/common": "^11.0.0"
+  }
+}

package/file-storage/local/src/index.d.ts

@@ -0,0 +1,4 @@
+export * from './lib/local-disk-file-storage.engine';
+export * from './lib/local-file-storage-engine.module';
+export * from './lib/local-file-storage.config';
+export * from './lib/filename.util';

package/file-storage/local/src/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/local-disk-file-storage.engine"), exports);
+tslib_1.__exportStar(require("./lib/local-file-storage-engine.module"), exports);
+tslib_1.__exportStar(require("./lib/local-file-storage.config"), exports);
+tslib_1.__exportStar(require("./lib/filename.util"), exports);
+//# sourceMappingURL=index.js.map

package/file-storage/local/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/file-storage/local/src/index.ts"],"names":[],"mappings":";;;AAAA,+EAAqD;AACrD,iFAAuD;AACvD,0EAAgD;AAChD,8DAAoC"}

package/file-storage/local/src/lib/filename.util.d.ts

@@ -0,0 +1,14 @@
+/** Sanitize a filename for safe use on disk. */
+export declare function sanitizeFilename(name: string): string;
+/** Resolve a file extension from the original name or MIME type. */
+export declare function resolveFileExtension(fileName?: string, mimeType?: string): string;
+/**
+ * Year/month prefix for uploads (WordPress-style: uploads/YYYY/MM/).
+ * Uses UTC so paths are stable across server timezones.
+ */
+export declare function buildUploadDatePrefix(uploadedAt?: Date | string): string;
+/**
+ * Relative storage path: files/YYYY/MM/{fileId}/{sanitizedName}.{ext}
+ * Chronological folders keep directory listings fast; fileId subfolder supports renames.
+ */
+export declare function buildBinaryRelativePath(fileId: string, fileName: string, mimeType?: string, uploadedAt?: Date | string): string;

package/file-storage/local/src/lib/filename.util.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeFilename = sanitizeFilename;
+exports.resolveFileExtension = resolveFileExtension;
+exports.buildUploadDatePrefix = buildUploadDatePrefix;
+exports.buildBinaryRelativePath = buildBinaryRelativePath;
+const path_1 = require("path");
+//#region ---- Filename utilities ----
+const MIME_EXTENSION_MAP = {
+    'application/pdf': 'pdf',
+    'image/png': 'png',
+    'image/jpeg': 'jpg',
+    'image/jpg': 'jpg',
+    'image/gif': 'gif',
+    'image/webp': 'webp',
+    'text/plain': 'txt',
+    'text/csv': 'csv',
+    'application/json': 'json',
+    'application/zip': 'zip',
+    'application/msword': 'doc',
+    'application/vnd.openxmlformats-officedocument.wordprocessingml.document': 'docx',
+    'application/vnd.ms-excel': 'xls',
+    'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet': 'xlsx',
+};
+/** Sanitize a filename for safe use on disk. */
+function sanitizeFilename(name) {
+    const cleaned = name.replace(/[/\\?%*:|"<>]/g, '_').trim();
+    return cleaned.length > 0 ? cleaned.slice(0, 200) : 'file';
+}
+/** Resolve a file extension from the original name or MIME type. */
+function resolveFileExtension(fileName, mimeType) {
+    if (fileName?.includes('.')) {
+        const ext = fileName.split('.').pop();
+        if (ext && /^[a-zA-Z0-9]{1,12}$/.test(ext)) {
+            return ext.toLowerCase();
+        }
+    }
+    if (mimeType) {
+        const mapped = MIME_EXTENSION_MAP[mimeType.toLowerCase()];
+        if (mapped) {
+            return mapped;
+        }
+        const subtype = mimeType.split('/')[1];
+        if (subtype && /^[a-zA-Z0-9.+-]{1,12}$/.test(subtype)) {
+            return subtype.replace('x-', '').toLowerCase();
+        }
+    }
+    return 'bin';
+}
+/**
+ * Year/month prefix for uploads (WordPress-style: uploads/YYYY/MM/).
+ * Uses UTC so paths are stable across server timezones.
+ */
+function buildUploadDatePrefix(uploadedAt = new Date()) {
+    const date = typeof uploadedAt === 'string' ? new Date(uploadedAt) : uploadedAt;
+    const year = date.getUTCFullYear();
+    const month = String(date.getUTCMonth() + 1).padStart(2, '0');
+    return path_1.posix.join(String(year), month);
+}
+/**
+ * Relative storage path: files/YYYY/MM/{fileId}/{sanitizedName}.{ext}
+ * Chronological folders keep directory listings fast; fileId subfolder supports renames.
+ */
+function buildBinaryRelativePath(fileId, fileName, mimeType, uploadedAt) {
+    const ext = resolveFileExtension(fileName, mimeType);
+    const baseName = fileName.includes('.') ? fileName.slice(0, fileName.lastIndexOf('.')) : fileName;
+    const sanitized = sanitizeFilename(baseName || 'file');
+    return path_1.posix.join('files', buildUploadDatePrefix(uploadedAt), fileId, `${sanitized}.${ext}`);
+}
+//#endregion
+//# sourceMappingURL=filename.util.js.map

package/file-storage/local/src/lib/filename.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filename.util.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/file-storage/local/src/lib/filename.util.ts"],"names":[],"mappings":"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"}

package/file-storage/local/src/lib/local-disk-file-storage.engine.d.ts

@@ -0,0 +1,9 @@
+import { FileStorageEngine, type FileStorageEnginePutHints } from '@acorex-platform/framework-server/file-storage/abstract';
+export declare class LocalDiskFileStorageEngine implements FileStorageEngine {
+    private readonly root;
+    put(fileId: string, buffer: Buffer, hints?: FileStorageEnginePutHints): Promise<string>;
+    get(storagePath: string): Promise<Buffer>;
+    delete(storagePath: string): Promise<void>;
+    rename(oldPath: string, newPath: string): Promise<void>;
+    buildPathForRename(fileId: string, fileName: string, mimeType?: string, uploadedAt?: string): string;
+}

package/file-storage/local/src/lib/local-disk-file-storage.engine.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalDiskFileStorageEngine = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+const filename_util_1 = require("./filename.util");
+const local_file_storage_config_1 = require("./local-file-storage.config");
+//#region ---- Local disk file storage engine ----
+let LocalDiskFileStorageEngine = class LocalDiskFileStorageEngine {
+    constructor() {
+        this.root = (0, local_file_storage_config_1.resolveFileStorageLocalRoot)();
+    }
+    async put(fileId, buffer, hints) {
+        const fileName = hints?.fileName ?? 'file';
+        const storagePath = (0, filename_util_1.buildBinaryRelativePath)(fileId, fileName, hints?.mimeType, hints?.uploadedAt);
+        const absolutePath = (0, path_1.join)(this.root, storagePath);
+        await (0, promises_1.mkdir)((0, path_1.dirname)(absolutePath), { recursive: true });
+        await (0, promises_1.writeFile)(absolutePath, buffer);
+        return storagePath;
+    }
+    async get(storagePath) {
+        return (0, promises_1.readFile)((0, path_1.join)(this.root, storagePath));
+    }
+    async delete(storagePath) {
+        try {
+            await (0, promises_1.unlink)((0, path_1.join)(this.root, storagePath));
+        }
+        catch {
+            // ignore missing binary
+        }
+    }
+    async rename(oldPath, newPath) {
+        const absoluteOld = (0, path_1.join)(this.root, oldPath);
+        const absoluteNew = (0, path_1.join)(this.root, newPath);
+        await (0, promises_1.mkdir)((0, path_1.dirname)(absoluteNew), { recursive: true });
+        await (0, promises_1.rename)(absoluteOld, absoluteNew);
+    }
+    buildPathForRename(fileId, fileName, mimeType, uploadedAt) {
+        return (0, filename_util_1.buildBinaryRelativePath)(fileId, fileName, mimeType, uploadedAt);
+    }
+};
+exports.LocalDiskFileStorageEngine = LocalDiskFileStorageEngine;
+exports.LocalDiskFileStorageEngine = LocalDiskFileStorageEngine = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], LocalDiskFileStorageEngine);
+//#endregion
+//# sourceMappingURL=local-disk-file-storage.engine.js.map

package/file-storage/local/src/lib/local-disk-file-storage.engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-disk-file-storage.engine.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/file-storage/local/src/lib/local-disk-file-storage.engine.ts"],"names":[],"mappings":";;;;AAEA,2CAA4C;AAE5C,0CAAyE;AAEzE,+BAAqC;AAErC,mDAA0D;AAE1D,2EAA0E;AAI1E,kDAAkD;AAM3C,IAAM,0BAA0B,GAAhC,MAAM,0BAA0B;IAAhC;QAEY,SAAI,GAAG,IAAA,uDAA2B,GAAE,CAAC;IA8DxD,CAAC;IA1DC,KAAK,CAAC,GAAG,CAAC,MAAc,EAAE,MAAc,EAAE,KAAiC;QACzE,MAAM,QAAQ,GAAG,KAAK,EAAE,QAAQ,IAAI,MAAM,CAAC;QAC3C,MAAM,WAAW,GAAG,IAAA,uCAAuB,EAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;QAElG,MAAM,YAAY,GAAG,IAAA,WAAI,EAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAElD,MAAM,IAAA,gBAAK,EAAC,IAAA,cAAO,EAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAExD,MAAM,IAAA,oBAAS,EAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QAEtC,OAAO,WAAW,CAAC;IAErB,CAAC;IAID,KAAK,CAAC,GAAG,CAAC,WAAmB;QAE3B,OAAO,IAAA,mBAAQ,EAAC,IAAA,WAAI,EAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;IAEhD,CAAC;IAID,KAAK,CAAC,MAAM,CAAC,WAAmB;QAE9B,IAAI,CAAC;YAEH,MAAM,IAAA,iBAAM,EAAC,IAAA,WAAI,EAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;QAE7C,CAAC;QAAC,MAAM,CAAC;YAEP,wBAAwB;QAE1B,CAAC;IAEH,CAAC;IAID,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,OAAe;QAE3C,MAAM,WAAW,GAAG,IAAA,WAAI,EAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAE7C,MAAM,WAAW,GAAG,IAAA,WAAI,EAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAE7C,MAAM,IAAA,gBAAK,EAAC,IAAA,cAAO,EAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvD,MAAM,IAAA,iBAAM,EAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAEzC,CAAC;IAID,kBAAkB,CAAC,MAAc,EAAE,QAAgB,EAAE,QAAiB,EAAE,UAAmB;QACzF,OAAO,IAAA,uCAAuB,EAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IACzE,CAAC;CAEF,CAAA;AAhEY,gEAA0B;qCAA1B,0BAA0B;IAFtC,IAAA,mBAAU,GAAE;GAEA,0BAA0B,CAgEtC;AAID,YAAY"}

package/file-storage/local/src/lib/local-file-storage-engine.module.d.ts

@@ -0,0 +1,2 @@
+export declare class LocalFileStorageEngineModule {
+}

package/file-storage/local/src/lib/local-file-storage-engine.module.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalFileStorageEngineModule = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const local_disk_file_storage_engine_1 = require("./local-disk-file-storage.engine");
+//#region ---- Local file storage engine module ----
+let LocalFileStorageEngineModule = class LocalFileStorageEngineModule {
+};
+exports.LocalFileStorageEngineModule = LocalFileStorageEngineModule;
+exports.LocalFileStorageEngineModule = LocalFileStorageEngineModule = tslib_1.__decorate([
+    (0, common_1.Module)({
+        providers: [local_disk_file_storage_engine_1.LocalDiskFileStorageEngine],
+        exports: [local_disk_file_storage_engine_1.LocalDiskFileStorageEngine],
+    })
+], LocalFileStorageEngineModule);
+//#endregion
+//# sourceMappingURL=local-file-storage-engine.module.js.map

package/file-storage/local/src/lib/local-file-storage-engine.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-file-storage-engine.module.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/file-storage/local/src/lib/local-file-storage-engine.module.ts"],"names":[],"mappings":";;;;AAAA,2CAAwC;AACxC,qFAA8E;AAE9E,oDAAoD;AAM7C,IAAM,4BAA4B,GAAlC,MAAM,4BAA4B;CAAG,CAAA;AAA/B,oEAA4B;uCAA5B,4BAA4B;IAJxC,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC,2DAA0B,CAAC;QACvC,OAAO,EAAE,CAAC,2DAA0B,CAAC;KACtC,CAAC;GACW,4BAA4B,CAAG;AAE5C,YAAY"}

package/file-storage/local/src/lib/local-file-storage.config.d.ts

@@ -0,0 +1 @@
+export declare function resolveFileStorageLocalRoot(): string;

package/file-storage/local/src/lib/local-file-storage.config.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveFileStorageLocalRoot = resolveFileStorageLocalRoot;
+const path_1 = require("path");
+//#region ---- Local file storage config ----
+function resolveFileStorageLocalRoot() {
+    return (0, path_1.resolve)(process.cwd(), process.env['FILE_STORAGE_LOCAL_ROOT'] ?? 'storage');
+}
+//#endregion
+//# sourceMappingURL=local-file-storage.config.js.map

package/file-storage/local/src/lib/local-file-storage.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-file-storage.config.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/file-storage/local/src/lib/local-file-storage.config.ts"],"names":[],"mappings":";;AAIA,kEAEC;AAND,+BAA+B;AAE/B,6CAA6C;AAE7C,SAAgB,2BAA2B;IACzC,OAAO,IAAA,cAAO,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,IAAI,SAAS,CAAC,CAAC;AACrF,CAAC;AAED,YAAY"}

package/file-storage/providers/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@acorex-platform/framework-server/file-storage/providers",
+  "version": "0.0.0-ACOREX",
+  "private": true,
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "peerDependencies": {
+    "@acorex-platform/framework-server/file-storage/abstract": "0.0.0-ACOREX",
+    "@acorex-platform/framework-server/file-storage/entity": "0.0.0-ACOREX",
+    "@acorex-platform/framework-server/file-storage/http": "0.0.0-ACOREX",
+    "@acorex-platform/framework-server/file-storage/database": "0.0.0-ACOREX",
+    "@acorex-platform/framework-server/file-storage/local": "0.0.0-ACOREX",
+    "@acorex-platform/framework-server/jql/abstract": "0.0.0-ACOREX",
+    "@acorex-platform/framework-server/jql/providers": "0.0.0-ACOREX",
+    "@nestjs/common": "^11.0.0"
+  }
+}

package/file-storage/providers/src/index.d.ts

@@ -0,0 +1,5 @@
+export * from './lib/file-storage-provider.types';
+export * from './lib/file-storage-provider.resolve';
+export * from './lib/file-storage-jql-instance.resolve';
+export * from './lib/file-storage-provider.module';
+export type { FileStorageProviderModuleOptions } from './lib/file-storage-provider.module';

package/file-storage/providers/src/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/file-storage-provider.types"), exports);
+tslib_1.__exportStar(require("./lib/file-storage-provider.resolve"), exports);
+tslib_1.__exportStar(require("./lib/file-storage-jql-instance.resolve"), exports);
+tslib_1.__exportStar(require("./lib/file-storage-provider.module"), exports);
+//# sourceMappingURL=index.js.map

package/file-storage/providers/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/file-storage/providers/src/index.ts"],"names":[],"mappings":";;;AAAA,4EAAkD;AAClD,8EAAoD;AACpD,kFAAwD;AACxD,6EAAmD"}

package/file-storage/providers/src/lib/file-storage-jql-instance.resolve.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Resolves the JQL instance name for the database file-storage driver.
+ * Override via `FILE_STORAGE_JQL_INSTANCE` env or module options.
+ */
+export declare function resolveFileStorageJqlInstance(explicit?: string): string;

package/file-storage/providers/src/lib/file-storage-jql-instance.resolve.js

@@ -0,0 +1,16 @@
+"use strict";
+//#region ---- File storage JQL instance resolution ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveFileStorageJqlInstance = resolveFileStorageJqlInstance;
+const FALLBACK_FILE_STORAGE_INSTANCE = 'file-storage';
+/**
+ * Resolves the JQL instance name for the database file-storage driver.
+ * Override via `FILE_STORAGE_JQL_INSTANCE` env or module options.
+ */
+function resolveFileStorageJqlInstance(explicit) {
+    return (explicit ??
+        process.env['FILE_STORAGE_JQL_INSTANCE'] ??
+        FALLBACK_FILE_STORAGE_INSTANCE);
+}
+//#endregion
+//# sourceMappingURL=file-storage-jql-instance.resolve.js.map

package/file-storage/providers/src/lib/file-storage-jql-instance.resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage-jql-instance.resolve.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/file-storage/providers/src/lib/file-storage-jql-instance.resolve.ts"],"names":[],"mappings":";AAAA,wDAAwD;;AAQxD,sEAMC;AAZD,MAAM,8BAA8B,GAAG,cAAc,CAAC;AAEtD;;;GAGG;AACH,SAAgB,6BAA6B,CAAC,QAAiB;IAC7D,OAAO,CACL,QAAQ;QACR,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC;QACxC,8BAA8B,CAC/B,CAAC;AACJ,CAAC;AAED,YAAY"}

package/file-storage/providers/src/lib/file-storage-provider.module.d.ts

@@ -0,0 +1,8 @@
+import { DynamicModule } from '@nestjs/common';
+export interface FileStorageProviderModuleOptions {
+    /** JQL instance name for file metadata (default: env `FILE_STORAGE_JQL_INSTANCE` or `file-storage`). */
+    jqlInstance?: string;
+}
+export declare class FileStorageProviderModule {
+    static forRoot(options?: FileStorageProviderModuleOptions): DynamicModule;
+}

package/file-storage/providers/src/lib/file-storage-provider.module.js

@@ -0,0 +1,70 @@
+"use strict";
+var FileStorageProviderModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileStorageProviderModule = void 0;
+const tslib_1 = require("tslib");
+const abstract_1 = require("@acorex-platform/framework-server/file-storage/abstract");
+const entity_1 = require("@acorex-platform/framework-server/file-storage/entity");
+const database_1 = require("@acorex-platform/framework-server/file-storage/database");
+const http_1 = require("@acorex-platform/framework-server/file-storage/http");
+const local_1 = require("@acorex-platform/framework-server/file-storage/local");
+const abstract_2 = require("@acorex-platform/framework-server/jql/abstract");
+const providers_1 = require("@acorex-platform/framework-server/jql/providers");
+const common_1 = require("@nestjs/common");
+const file_storage_jql_instance_resolve_1 = require("./file-storage-jql-instance.resolve");
+const file_storage_provider_resolve_1 = require("./file-storage-provider.resolve");
+//#endregion
+//#region ---- File storage provider module ----
+let FileStorageProviderModule = FileStorageProviderModule_1 = class FileStorageProviderModule {
+    static forRoot(options = {}) {
+        const provider = (0, file_storage_provider_resolve_1.resolveFileStorageProvider)();
+        const logger = new common_1.Logger(FileStorageProviderModule_1.name);
+        logger.log(`File storage binary provider: ${provider} (metadata: File Entity / JQL)`);
+        const instanceName = (0, file_storage_jql_instance_resolve_1.resolveFileStorageJqlInstance)(options.jqlInstance);
+        const engineToken = (0, abstract_2.JQL_ENGINE)(instanceName);
+        const engineImports = provider === 'database'
+            ? [local_1.LocalFileStorageEngineModule, database_1.DatabaseFileStorageEngineModule]
+            : [local_1.LocalFileStorageEngineModule];
+        return {
+            module: FileStorageProviderModule_1,
+            imports: [
+                providers_1.JqlModule.fromEnv(instanceName, 'file-storage'),
+                ...engineImports,
+                entity_1.EntityFileStorageModule,
+            ],
+            controllers: [http_1.FileStorageController],
+            providers: [
+                http_1.FileStorageFacadeService,
+                { provide: abstract_1.FILE_STORAGE_JQL_INSTANCE, useValue: instanceName },
+                { provide: abstract_1.FILE_STORAGE_JQL_ENGINE, useExisting: engineToken },
+                { provide: abstract_1.FILE_STORAGE_PROVIDER_KIND, useValue: provider },
+                entity_1.FileStorageEngineRegistry,
+                entity_1.FileStorageInfrastructureService,
+                {
+                    provide: abstract_1.FILE_STORAGE_BACKEND,
+                    useExisting: entity_1.FileStorageInfrastructureService,
+                },
+                {
+                    provide: abstract_1.FILE_STORAGE_ENGINE,
+                    useFactory: (registry) => registry.get(),
+                    inject: [entity_1.FileStorageEngineRegistry],
+                },
+            ],
+            exports: [
+                abstract_1.FILE_STORAGE_BACKEND,
+                abstract_1.FILE_STORAGE_ENGINE,
+                abstract_1.FILE_STORAGE_JQL_INSTANCE,
+                abstract_1.FILE_STORAGE_JQL_ENGINE,
+                http_1.FileStorageFacadeService,
+                entity_1.EntityFileStorageModule,
+            ],
+            global: true,
+        };
+    }
+};
+exports.FileStorageProviderModule = FileStorageProviderModule;
+exports.FileStorageProviderModule = FileStorageProviderModule = FileStorageProviderModule_1 = tslib_1.__decorate([
+    (0, common_1.Module)({})
+], FileStorageProviderModule);
+//#endregion
+//# sourceMappingURL=file-storage-provider.module.js.map

package/file-storage/providers/src/lib/file-storage-provider.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage-provider.module.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/file-storage/providers/src/lib/file-storage-provider.module.ts"],"names":[],"mappings":";;;;;AAAA,sFAMiE;AACjE,kFAI+D;AAC/D,sFAA0G;AAC1G,8EAG6D;AAC7D,gFAAoG;AACpG,6EAA4E;AAC5E,+EAA4E;AAC5E,2CAA+D;AAC/D,2FAAoF;AACpF,mFAA6E;AAS7E,YAAY;AAEZ,gDAAgD;AAGzC,IAAM,yBAAyB,iCAA/B,MAAM,yBAAyB;IACpC,MAAM,CAAC,OAAO,CAAC,UAA4C,EAAE;QAC3D,MAAM,QAAQ,GAAG,IAAA,0DAA0B,GAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,2BAAyB,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,CAAC,GAAG,CAAC,iCAAiC,QAAQ,gCAAgC,CAAC,CAAC;QAEtF,MAAM,YAAY,GAAG,IAAA,iEAA6B,EAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACxE,MAAM,WAAW,GAAG,IAAA,qBAAU,EAAC,YAAY,CAAC,CAAC;QAE7C,MAAM,aAAa,GACjB,QAAQ,KAAK,UAAU;YACrB,CAAC,CAAC,CAAC,oCAA4B,EAAE,0CAA+B,CAAC;YACjE,CAAC,CAAC,CAAC,oCAA4B,CAAC,CAAC;QAErC,OAAO;YACL,MAAM,EAAE,2BAAyB;YACjC,OAAO,EAAE;gBACP,qBAAS,CAAC,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC;gBAC/C,GAAG,aAAa;gBAChB,gCAAuB;aACxB;YACD,WAAW,EAAE,CAAC,4BAAqB,CAAC;YACpC,SAAS,EAAE;gBACT,+BAAwB;gBACxB,EAAE,OAAO,EAAE,oCAAyB,EAAE,QAAQ,EAAE,YAAY,EAAE;gBAC9D,EAAE,OAAO,EAAE,kCAAuB,EAAE,WAAW,EAAE,WAAW,EAAE;gBAC9D,EAAE,OAAO,EAAE,qCAA0B,EAAE,QAAQ,EAAE,QAAQ,EAAE;gBAC3D,kCAAyB;gBACzB,yCAAgC;gBAChC;oBACE,OAAO,EAAE,+BAAoB;oBAC7B,WAAW,EAAE,yCAAgC;iBAC9C;gBACD;oBACE,OAAO,EAAE,8BAAmB;oBAC5B,UAAU,EAAE,CAAC,QAAmC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE;oBACnE,MAAM,EAAE,CAAC,kCAAyB,CAAC;iBACpC;aACF;YACD,OAAO,EAAE;gBACP,+BAAoB;gBACpB,8BAAmB;gBACnB,oCAAyB;gBACzB,kCAAuB;gBACvB,+BAAwB;gBACxB,gCAAuB;aACxB;YACD,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;CACF,CAAA;AAlDY,8DAAyB;oCAAzB,yBAAyB;IADrC,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,yBAAyB,CAkDrC;AAED,YAAY"}

package/file-storage/providers/src/lib/file-storage-provider.resolve.d.ts

@@ -0,0 +1,5 @@
+import { FileStorageProviderKind } from './file-storage-provider.types';
+/**
+ * Reads `FILE_STORAGE_PROVIDER` (default: `local`).
+ */
+export declare function resolveFileStorageProvider(): FileStorageProviderKind;

package/file-storage/providers/src/lib/file-storage-provider.resolve.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveFileStorageProvider = resolveFileStorageProvider;
+//#region ---- Provider resolution ----
+const SUPPORTED = ['local', 'database'];
+/**
+ * Reads `FILE_STORAGE_PROVIDER` (default: `local`).
+ */
+function resolveFileStorageProvider() {
+    const raw = (process.env['FILE_STORAGE_PROVIDER'] ?? 'local').trim().toLowerCase();
+    if (raw === 's3') {
+        throw new Error('FILE_STORAGE_PROVIDER "s3" is not implemented yet.');
+    }
+    if (SUPPORTED.includes(raw)) {
+        return raw;
+    }
+    throw new Error(`Unsupported FILE_STORAGE_PROVIDER "${raw}". Supported: ${SUPPORTED.join(', ')}.`);
+}
+//#endregion
+//# sourceMappingURL=file-storage-provider.resolve.js.map

package/file-storage/providers/src/lib/file-storage-provider.resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage-provider.resolve.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/file-storage/providers/src/lib/file-storage-provider.resolve.ts"],"names":[],"mappings":";;AASA,gEAcC;AArBD,uCAAuC;AAEvC,MAAM,SAAS,GAA8B,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AAEnE;;GAEG;AACH,SAAgB,0BAA0B;IACxC,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAEnF,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,SAAS,CAAC,QAAQ,CAAC,GAA8B,CAAC,EAAE,CAAC;QACvD,OAAO,GAA8B,CAAC;IACxC,CAAC;IAED,MAAM,IAAI,KAAK,CACb,sCAAsC,GAAG,iBAAiB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAClF,CAAC;AACJ,CAAC;AAED,YAAY"}