@acorex-platform/framework-server 0.0.10

package/domain/seed/src/lib/collect-entity-factories.util.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectEntityFactories = collectEntityFactories;
+//#region ---- Entity factory collection ----
+const FACTORY_NAME_PATTERN = /factory/i;
+/**
+ * Collects async entity factory functions from a domain package namespace export.
+ * Matches exported zero-arg functions whose name contains `Factory` (any casing),
+ * e.g. `localesFactory`, `tenantEntityFactory`, `factoryAssessmentCase`.
+ */
+function collectEntityFactories(moduleExports) {
+    const factories = [];
+    for (const [exportName, value] of Object.entries(moduleExports)) {
+        if (!FACTORY_NAME_PATTERN.test(exportName)) {
+            continue;
+        }
+        if (typeof value !== 'function' || value.length > 0) {
+            continue;
+        }
+        factories.push(value);
+    }
+    return factories;
+}
+//#endregion
+//# sourceMappingURL=collect-entity-factories.util.js.map

package/domain/seed/src/lib/collect-entity-factories.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-entity-factories.util.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/domain/seed/src/lib/collect-entity-factories.util.ts"],"names":[],"mappings":";;AAWA,wDAkBC;AA3BD,6CAA6C;AAE7C,MAAM,oBAAoB,GAAG,UAAU,CAAC;AAExC;;;;GAIG;AACH,SAAgB,sBAAsB,CACpC,aAAsC;IAEtC,MAAM,SAAS,GAA6B,EAAE,CAAC;IAE/C,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QAChE,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3C,SAAS;QACX,CAAC;QAED,IAAI,OAAO,KAAK,KAAK,UAAU,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,SAAS;QACX,CAAC;QAED,SAAS,CAAC,IAAI,CAAC,KAA+B,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,YAAY"}

package/domain/seed/src/lib/domain-definition-seed.provider.d.ts

@@ -0,0 +1,13 @@
+import type { JqlSeedProvider } from '@acorex-platform/framework-server/jql/seed';
+import type { AXPModuleDomainExports } from './domain-seed.types';
+export interface DomainDefinitionSeedProviderOptions {
+    readonly modules: readonly AXPModuleDomainExports[];
+    readonly providerName?: string;
+    readonly jqlInstance?: string;
+    readonly store?: string;
+}
+/**
+ * Collects `*.entity.ts` factories from module domain packages, converts them to
+ * domain entity definitions, and seeds the entity-definition JQL `entities` store.
+ */
+export declare function createDomainDefinitionSeedProvider(options: DomainDefinitionSeedProviderOptions): JqlSeedProvider;

package/domain/seed/src/lib/domain-definition-seed.provider.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDomainDefinitionSeedProvider = createDomainDefinitionSeedProvider;
+const providers_1 = require("@acorex-platform/framework-server/domain/providers");
+const collect_entity_factories_util_1 = require("./collect-entity-factories.util");
+const axp_entity_to_definition_converter_1 = require("./axp-entity-to-definition.converter");
+const category_companion_entity_builder_1 = require("./category-companion-entity.builder");
+/**
+ * Collects `*.entity.ts` factories from module domain packages, converts them to
+ * domain entity definitions, and seeds the entity-definition JQL `entities` store.
+ */
+function createDomainDefinitionSeedProvider(options) {
+    const jqlInstance = options.jqlInstance ?? (0, providers_1.resolveDomainDefinitionJqlInstance)();
+    const store = options.store ?? providers_1.DOMAIN_DEFINITION_STORES.entities;
+    return {
+        name: options.providerName ?? 'domain-entity-definitions',
+        phase: 'definitions',
+        async resolve() {
+            const records = [];
+            const entitiesByFullName = new Map();
+            for (const { moduleName, exports } of options.modules) {
+                const factories = (0, collect_entity_factories_util_1.collectEntityFactories)(exports);
+                for (const factory of factories) {
+                    try {
+                        const entity = await factory();
+                        if (!entity?.module || !entity.name) {
+                            continue;
+                        }
+                        const entityFullName = `${entity.module}.${entity.name}`;
+                        if (entitiesByFullName.has(entityFullName)) {
+                            continue;
+                        }
+                        entitiesByFullName.set(entityFullName, entity);
+                    }
+                    catch (error) {
+                        const message = error instanceof Error ? error.message : String(error);
+                        console.warn(`[DomainDefinitionSeed] Failed factory in module "${moduleName}": ${message}`);
+                    }
+                }
+            }
+            const seen = new Set();
+            for (const entity of entitiesByFullName.values()) {
+                const entityFullName = `${entity.module}.${entity.name}`;
+                if (seen.has(entityFullName)) {
+                    continue;
+                }
+                seen.add(entityFullName);
+                records.push((0, axp_entity_to_definition_converter_1.buildDomainEntityStoreRecord)(entity));
+                const categoryCompanion = (0, category_companion_entity_builder_1.buildCategoryCompanionEntity)(entity);
+                if (!categoryCompanion) {
+                    continue;
+                }
+                const companionFullName = `${categoryCompanion.module}.${categoryCompanion.name}`;
+                if (entitiesByFullName.has(companionFullName) || seen.has(companionFullName)) {
+                    continue;
+                }
+                seen.add(companionFullName);
+                records.push((0, axp_entity_to_definition_converter_1.buildDomainEntityStoreRecord)(categoryCompanion));
+            }
+            return [
+                {
+                    name: 'domain-entities',
+                    phase: 'definitions',
+                    kind: 'store',
+                    jqlInstance,
+                    target: store,
+                    records,
+                    mergeType: 'replace',
+                },
+            ];
+        },
+    };
+}
+//#endregion
+//# sourceMappingURL=domain-definition-seed.provider.js.map

package/domain/seed/src/lib/domain-definition-seed.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-definition-seed.provider.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/domain/seed/src/lib/domain-definition-seed.provider.ts"],"names":[],"mappings":";;AAwBA,gFA8EC;AAtGD,kFAG4D;AAE5D,mFAAyE;AACzE,6FAAoF;AACpF,2FAAmF;AAanF;;;GAGG;AACH,SAAgB,kCAAkC,CAChD,OAA4C;IAE5C,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAA,8CAAkC,GAAE,CAAC;IAChF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,oCAAwB,CAAC,QAAQ,CAAC;IAEjE,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,YAAY,IAAI,2BAA2B;QACzD,KAAK,EAAE,aAAa;QAEpB,KAAK,CAAC,OAAO;YACX,MAAM,OAAO,GAA8B,EAAE,CAAC;YAC9C,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAqB,CAAC;YAExD,KAAK,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACtD,MAAM,SAAS,GAAG,IAAA,sDAAsB,EAAC,OAAO,CAAC,CAAC;gBAElD,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;oBAChC,IAAI,CAAC;wBACH,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC;wBAE/B,IAAI,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;4BACpC,SAAS;wBACX,CAAC;wBAED,MAAM,cAAc,GAAG,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;wBACzD,IAAI,kBAAkB,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;4BAC3C,SAAS;wBACX,CAAC;wBAED,kBAAkB,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;oBACjD,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;wBACvE,OAAO,CAAC,IAAI,CACV,oDAAoD,UAAU,MAAM,OAAO,EAAE,CAC9E,CAAC;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;YAE/B,KAAK,MAAM,MAAM,IAAI,kBAAkB,CAAC,MAAM,EAAE,EAAE,CAAC;gBACjD,MAAM,cAAc,GAAG,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBACzD,IAAI,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;oBAC7B,SAAS;gBACX,CAAC;gBAED,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;gBACzB,OAAO,CAAC,IAAI,CAAC,IAAA,iEAA4B,EAAC,MAAM,CAAC,CAAC,CAAC;gBAEnD,MAAM,iBAAiB,GAAG,IAAA,gEAA4B,EAAC,MAAM,CAAC,CAAC;gBAC/D,IAAI,CAAC,iBAAiB,EAAE,CAAC;oBACvB,SAAS;gBACX,CAAC;gBAED,MAAM,iBAAiB,GAAG,GAAG,iBAAiB,CAAC,MAAM,IAAI,iBAAiB,CAAC,IAAI,EAAE,CAAC;gBAClF,IAAI,kBAAkB,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC;oBAC7E,SAAS;gBACX,CAAC;gBAED,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;gBAC5B,OAAO,CAAC,IAAI,CAAC,IAAA,iEAA4B,EAAC,iBAAiB,CAAC,CAAC,CAAC;YAChE,CAAC;YAED,OAAO;gBACL;oBACE,IAAI,EAAE,iBAAiB;oBACvB,KAAK,EAAE,aAAa;oBACpB,IAAI,EAAE,OAAO;oBACb,WAAW;oBACX,MAAM,EAAE,KAAK;oBACb,OAAO;oBACP,SAAS,EAAE,SAAS;iBACrB;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,YAAY"}

package/domain/seed/src/lib/domain-seed.types.d.ts

@@ -0,0 +1,8 @@
+import type { AXPEntity } from '@acorex-platform/framework-shared/entity';
+/** Async factory that returns a layout entity definition from a module domain package. */
+export type AXPDomainEntityFactory = () => Promise<AXPEntity | null>;
+/** One module domain package namespace (`import * as domain from '…/domain'`). */
+export interface AXPModuleDomainExports {
+    readonly moduleName: string;
+    readonly exports: Record<string, unknown>;
+}

package/domain/seed/src/lib/domain-seed.types.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//#endregion
+//# sourceMappingURL=domain-seed.types.js.map

package/domain/seed/src/lib/domain-seed.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-seed.types.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/domain/seed/src/lib/domain-seed.types.ts"],"names":[],"mappings":";;AAaA,YAAY"}

package/file-storage/abstract/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@acorex-platform/framework-server/file-storage/abstract",
+  "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-shared": "0.0.0-ACOREX",
+    "@nestjs/common": "^11.0.0"
+  }
+}

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

@@ -0,0 +1,5 @@
+export * from './lib/file-storage.types';
+export * from './lib/file-storage.tokens';
+export * from './lib/file-storage-engine.interface';
+export * from './lib/file-storage-backend.interface';
+export * from './lib/file-storage.mapper';

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

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/file-storage.types"), exports);
+tslib_1.__exportStar(require("./lib/file-storage.tokens"), exports);
+tslib_1.__exportStar(require("./lib/file-storage-engine.interface"), exports);
+tslib_1.__exportStar(require("./lib/file-storage-backend.interface"), exports);
+tslib_1.__exportStar(require("./lib/file-storage.mapper"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/file-storage/abstract/src/index.ts"],"names":[],"mappings":";;;AAAA,mEAAyC;AACzC,oEAA0C;AAC1C,8EAAoD;AACpD,+EAAqD;AACrD,oEAA0C"}

package/file-storage/abstract/src/lib/file-storage-backend.interface.d.ts

@@ -0,0 +1,12 @@
+import type { FileStorageFindFilter, FileStorageManyRecord, FileStorageRecord, FileStorageSaveInput, FileStorageUpdateInput } from './file-storage.types';
+export interface FileStorageBackend {
+    save(input: FileStorageSaveInput): Promise<FileStorageRecord>;
+    update(input: FileStorageUpdateInput): Promise<FileStorageRecord>;
+    find(filter: FileStorageFindFilter): Promise<FileStorageRecord[]>;
+    findMany(ids: string[]): Promise<FileStorageManyRecord[]>;
+    getInfo(fileId: string): Promise<FileStorageRecord>;
+    remove(fileId: string): Promise<void>;
+    commit(fileId: string): Promise<void>;
+    markForDeletion(fileId: string): Promise<void>;
+    readBinary(fileId: string): Promise<Buffer>;
+}

package/file-storage/abstract/src/lib/file-storage-backend.interface.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//#endregion
+//# sourceMappingURL=file-storage-backend.interface.js.map

package/file-storage/abstract/src/lib/file-storage-backend.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage-backend.interface.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/file-storage/abstract/src/lib/file-storage-backend.interface.ts"],"names":[],"mappings":";;AAsBA,YAAY"}

package/file-storage/abstract/src/lib/file-storage-engine.interface.d.ts

@@ -0,0 +1,14 @@
+export type FileBinaryProvider = 'local' | 'database' | 's3';
+export interface FileStorageEnginePutHints {
+    fileName?: string;
+    mimeType?: string;
+    /** ISO timestamp for date-based folder layout (local disk). */
+    uploadedAt?: string;
+}
+/** Stores and retrieves raw file bytes only. */
+export interface FileStorageEngine {
+    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>;
+}

package/file-storage/abstract/src/lib/file-storage-engine.interface.js

@@ -0,0 +1,5 @@
+"use strict";
+//#region ---- Binary file storage engine (no metadata) ----
+Object.defineProperty(exports, "__esModule", { value: true });
+//#endregion
+//# sourceMappingURL=file-storage-engine.interface.js.map

package/file-storage/abstract/src/lib/file-storage-engine.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage-engine.interface.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/file-storage/abstract/src/lib/file-storage-engine.interface.ts"],"names":[],"mappings":";AAAA,4DAA4D;;AAmB5D,YAAY"}

package/file-storage/abstract/src/lib/file-storage.mapper.d.ts

@@ -0,0 +1,8 @@
+import type { AXPFileManyStorageInfo, AXPFileStorageInfo } from '@acorex-platform/framework-shared/core';
+import type { FileStorageManyRecord, FileStorageRecord } from './file-storage.types';
+export declare function buildFileDownloadUrl(fileId: string): string;
+export declare function toFileStorageRecord(document: FileStorageRecord, options?: {
+    includeUrl?: boolean;
+}): FileStorageRecord;
+export declare function toAxpFileStorageInfo(record: FileStorageRecord): AXPFileStorageInfo;
+export declare function toAxpFileManyStorageInfo(record: FileStorageManyRecord): AXPFileManyStorageInfo;

package/file-storage/abstract/src/lib/file-storage.mapper.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildFileDownloadUrl = buildFileDownloadUrl;
+exports.toFileStorageRecord = toFileStorageRecord;
+exports.toAxpFileStorageInfo = toAxpFileStorageInfo;
+exports.toAxpFileManyStorageInfo = toAxpFileManyStorageInfo;
+//#region ---- API response mapping ----
+function buildFileDownloadUrl(fileId) {
+    return `/api/file-storage/download/${fileId}`;
+}
+function toFileStorageRecord(document, options) {
+    if (options?.includeUrl === false) {
+        return document;
+    }
+    return {
+        ...document,
+        url: document.url ?? buildFileDownloadUrl(document.fileId),
+    };
+}
+function toAxpFileStorageInfo(record) {
+    return {
+        fileId: record.fileId,
+        refId: record.refId,
+        refType: record.refType,
+        category: record.category,
+        size: record.size,
+        mimeType: record.mimeType,
+        uploadedAt: new Date(record.uploadedAt),
+        isPublic: record.isPublic,
+        isPrimary: record.isPrimary,
+        status: record.status,
+        name: record.name,
+        title: record.title,
+        description: record.description,
+        metadata: record.metadata,
+        url: record.url ?? buildFileDownloadUrl(record.fileId),
+        binary: undefined,
+    };
+}
+function toAxpFileManyStorageInfo(record) {
+    return {
+        id: record.fileId,
+        fileId: record.fileId,
+        refId: record.refId,
+        refType: record.refType,
+        size: record.size,
+        name: record.name,
+        url: record.url ?? buildFileDownloadUrl(record.fileId),
+        title: record.title,
+        description: record.description,
+    };
+}
+//#endregion
+//# sourceMappingURL=file-storage.mapper.js.map

package/file-storage/abstract/src/lib/file-storage.mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage.mapper.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/file-storage/abstract/src/lib/file-storage.mapper.ts"],"names":[],"mappings":";;AASA,oDAEC;AAED,kDAYC;AAED,oDAmBC;AAED,4DAYC;AArDD,wCAAwC;AAExC,SAAgB,oBAAoB,CAAC,MAAc;IACjD,OAAO,8BAA8B,MAAM,EAAE,CAAC;AAChD,CAAC;AAED,SAAgB,mBAAmB,CACjC,QAA2B,EAC3B,OAAkC;IAElC,IAAI,OAAO,EAAE,UAAU,KAAK,KAAK,EAAE,CAAC;QAClC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO;QACL,GAAG,QAAQ;QACX,GAAG,EAAE,QAAQ,CAAC,GAAG,IAAI,oBAAoB,CAAC,QAAQ,CAAC,MAAM,CAAC;KAC3D,CAAC;AACJ,CAAC;AAED,SAAgB,oBAAoB,CAAC,MAAyB;IAC5D,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,UAAU,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;QACvC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,oBAAoB,CAAC,MAAM,CAAC,MAAM,CAAC;QACtD,MAAM,EAAE,SAA4B;KACrC,CAAC;AACJ,CAAC;AAED,SAAgB,wBAAwB,CAAC,MAA6B;IACpE,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,MAAM;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,oBAAoB,CAAC,MAAM,CAAC,MAAM,CAAC;QACtD,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC;AACJ,CAAC;AAED,YAAY"}

package/file-storage/abstract/src/lib/file-storage.tokens.d.ts

@@ -0,0 +1,10 @@
+/** Infrastructure orchestrator (metadata + engine) for /file-storage API. */
+export declare const FILE_STORAGE_BACKEND: unique symbol;
+/** Binary file storage engine (local / database / s3). */
+export declare const FILE_STORAGE_ENGINE: unique symbol;
+/** Resolved JQL instance name for file metadata. */
+export declare const FILE_STORAGE_JQL_INSTANCE: unique symbol;
+/** JQL engine bound to {@link FILE_STORAGE_JQL_INSTANCE}. */
+export declare const FILE_STORAGE_JQL_ENGINE: unique symbol;
+/** Active binary storage provider from env (`FILE_STORAGE_PROVIDER`). */
+export declare const FILE_STORAGE_PROVIDER_KIND: unique symbol;

package/file-storage/abstract/src/lib/file-storage.tokens.js

@@ -0,0 +1,16 @@
+"use strict";
+//#region ---- File storage DI tokens ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FILE_STORAGE_PROVIDER_KIND = exports.FILE_STORAGE_JQL_ENGINE = exports.FILE_STORAGE_JQL_INSTANCE = exports.FILE_STORAGE_ENGINE = exports.FILE_STORAGE_BACKEND = void 0;
+/** Infrastructure orchestrator (metadata + engine) for /file-storage API. */
+exports.FILE_STORAGE_BACKEND = Symbol('FILE_STORAGE_BACKEND');
+/** Binary file storage engine (local / database / s3). */
+exports.FILE_STORAGE_ENGINE = Symbol('FILE_STORAGE_ENGINE');
+/** Resolved JQL instance name for file metadata. */
+exports.FILE_STORAGE_JQL_INSTANCE = Symbol('FILE_STORAGE_JQL_INSTANCE');
+/** JQL engine bound to {@link FILE_STORAGE_JQL_INSTANCE}. */
+exports.FILE_STORAGE_JQL_ENGINE = Symbol('FILE_STORAGE_JQL_ENGINE');
+/** Active binary storage provider from env (`FILE_STORAGE_PROVIDER`). */
+exports.FILE_STORAGE_PROVIDER_KIND = Symbol('FILE_STORAGE_PROVIDER_KIND');
+//#endregion
+//# sourceMappingURL=file-storage.tokens.js.map

package/file-storage/abstract/src/lib/file-storage.tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage.tokens.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/file-storage/abstract/src/lib/file-storage.tokens.ts"],"names":[],"mappings":";AAAA,0CAA0C;;;AAE1C,6EAA6E;AAChE,QAAA,oBAAoB,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAEnE,0DAA0D;AAC7C,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAEjE,oDAAoD;AACvC,QAAA,yBAAyB,GAAG,MAAM,CAAC,2BAA2B,CAAC,CAAC;AAE7E,6DAA6D;AAChD,QAAA,uBAAuB,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC;AAEzE,yEAAyE;AAC5D,QAAA,0BAA0B,GAAG,MAAM,CAAC,4BAA4B,CAAC,CAAC;AAE/E,YAAY"}

package/file-storage/abstract/src/lib/file-storage.types.d.ts

@@ -0,0 +1,86 @@
+import type { AXPFileStorageStatus } from '@acorex-platform/framework-shared/core';
+import type { FileBinaryProvider } from './file-storage-engine.interface';
+export interface FileStorageDocument {
+    fileId: string;
+    refId: string;
+    refType: string;
+    category: string;
+    name?: string;
+    path?: string;
+    mimeType: string;
+    size: number;
+    uploadedAt: string;
+    isPublic: boolean;
+    isPrimary?: boolean;
+    status: AXPFileStorageStatus;
+    metadata?: Record<string, unknown>;
+    /** @deprecated legacy inline binary; use storagePath + binary engine */
+    binaryBase64?: string;
+    storagePath?: string;
+    binaryProvider?: FileBinaryProvider;
+    title?: string;
+    description?: string;
+}
+/** Persisted file metadata entity (id === fileId). Binary locator in storagePath. */
+export interface FileEntityRecord {
+    fileId: string;
+    refId: string;
+    refType: string;
+    category: string;
+    name?: string;
+    path?: string;
+    mimeType: string;
+    size: number;
+    uploadedAt: string;
+    isPublic: boolean;
+    isPrimary?: boolean;
+    status: AXPFileStorageStatus;
+    metadata?: Record<string, unknown>;
+    storagePath: string;
+    binaryProvider: FileBinaryProvider;
+    title?: string;
+    description?: string;
+}
+export interface FileStorageSaveInput {
+    buffer: Buffer;
+    originalName?: string;
+    mimeType: string;
+    refId: string;
+    refType: string;
+    category: string;
+    name?: string;
+    path?: string;
+    metadata?: Record<string, unknown>;
+    isPrimary?: boolean;
+    status?: AXPFileStorageStatus;
+}
+export interface FileStorageUpdateInput {
+    fileId: string;
+    metadata?: Record<string, unknown>;
+    path?: string;
+    name?: string;
+    isPrimary?: boolean;
+}
+export interface FileStorageFindFilter {
+    refId?: string;
+    refType?: string;
+    category?: string;
+    mimeType?: string;
+    isPublic?: boolean;
+    isPrimary?: boolean;
+    uploadedAtFrom?: string;
+    uploadedAtTo?: string;
+}
+export interface FileStorageRecord extends FileStorageDocument {
+    url?: string;
+}
+export interface FileStorageManyRecord {
+    fileId: string;
+    refId: string;
+    refType: string;
+    size: number;
+    name?: string;
+    url?: string;
+    title?: string;
+    description?: string;
+}

package/file-storage/abstract/src/lib/file-storage.types.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//#endregion
+//# sourceMappingURL=file-storage.types.js.map

package/file-storage/abstract/src/lib/file-storage.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage.types.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/file-storage/abstract/src/lib/file-storage.types.ts"],"names":[],"mappings":";;AAgGA,YAAY"}

package/file-storage/database/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@acorex-platform/framework-server/file-storage/database",
+  "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/jql/abstract": "0.0.0-ACOREX",
+    "@acorex-platform/framework-shared": "0.0.0-ACOREX",
+    "@nestjs/common": "^11.0.0"
+  }
+}

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

@@ -0,0 +1,3 @@
+export * from './lib/file-binary-blob-jql-source';
+export * from './lib/jql-binary-file-storage.engine';
+export * from './lib/database-file-storage-engine.module';

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

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/file-binary-blob-jql-source"), exports);
+tslib_1.__exportStar(require("./lib/jql-binary-file-storage.engine"), exports);
+tslib_1.__exportStar(require("./lib/database-file-storage-engine.module"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/file-storage/database/src/index.ts"],"names":[],"mappings":";;;AAAA,4EAAkD;AAClD,+EAAqD;AACrD,oFAA0D"}

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

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

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

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseFileStorageEngineModule = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const jql_binary_file_storage_engine_1 = require("./jql-binary-file-storage.engine");
+//#region ---- Database binary file storage engine module ----
+let DatabaseFileStorageEngineModule = class DatabaseFileStorageEngineModule {
+};
+exports.DatabaseFileStorageEngineModule = DatabaseFileStorageEngineModule;
+exports.DatabaseFileStorageEngineModule = DatabaseFileStorageEngineModule = tslib_1.__decorate([
+    (0, common_1.Module)({
+        providers: [jql_binary_file_storage_engine_1.JqlBinaryFileStorageEngine],
+        exports: [jql_binary_file_storage_engine_1.JqlBinaryFileStorageEngine],
+    })
+], DatabaseFileStorageEngineModule);
+//#endregion
+//# sourceMappingURL=database-file-storage-engine.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"database-file-storage-engine.module.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/file-storage/database/src/lib/database-file-storage-engine.module.ts"],"names":[],"mappings":";;;;AAAA,2CAAwC;AACxC,qFAA8E;AAE9E,8DAA8D;AAMvD,IAAM,+BAA+B,GAArC,MAAM,+BAA+B;CAAG,CAAA;AAAlC,0EAA+B;0CAA/B,+BAA+B;IAJ3C,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC,2DAA0B,CAAC;QACvC,OAAO,EAAE,CAAC,2DAA0B,CAAC;KACtC,CAAC;GACW,+BAA+B,CAAG;AAE/C,YAAY"}

package/file-storage/database/src/lib/file-binary-blob-jql-source.d.ts

@@ -0,0 +1,5 @@
+import { JqlSource } from '@acorex-platform/framework-server/jql/abstract';
+export declare const FILE_BINARY_BLOB_JQL_SOURCE = "file_binary_blobs";
+export declare function resolveFileBinaryBlobCollectionName(): string;
+export declare const FILE_BINARY_BLOB_TABLE_DDL_POSTGRES: (table: string) => string;
+export declare function createFileBinaryBlobJqlSource(collectionName?: string): JqlSource;

package/file-storage/database/src/lib/file-binary-blob-jql-source.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FILE_BINARY_BLOB_TABLE_DDL_POSTGRES = exports.FILE_BINARY_BLOB_JQL_SOURCE = void 0;
+exports.resolveFileBinaryBlobCollectionName = resolveFileBinaryBlobCollectionName;
+exports.createFileBinaryBlobJqlSource = createFileBinaryBlobJqlSource;
+//#region ---- JQL source: binary blobs only ----
+exports.FILE_BINARY_BLOB_JQL_SOURCE = 'file_binary_blobs';
+const DEFAULT_COLLECTION = 'file_binary_blobs';
+function resolveFileBinaryBlobCollectionName() {
+    return process.env['FILE_BINARY_BLOB_COLLECTION'] ?? DEFAULT_COLLECTION;
+}
+const FILE_BINARY_BLOB_TABLE_DDL_POSTGRES = (table) => `
+  CREATE TABLE IF NOT EXISTS ${table} (
+    id TEXT PRIMARY KEY,
+    file_id TEXT NOT NULL UNIQUE,
+    payload JSONB NOT NULL
+  );
+  CREATE INDEX IF NOT EXISTS idx_${table}_file_id ON ${table} (file_id);
+`;
+exports.FILE_BINARY_BLOB_TABLE_DDL_POSTGRES = FILE_BINARY_BLOB_TABLE_DDL_POSTGRES;
+function createFileBinaryBlobJqlSource(collectionName) {
+    const collection = collectionName ?? resolveFileBinaryBlobCollectionName();
+    return {
+        name: exports.FILE_BINARY_BLOB_JQL_SOURCE,
+        storage: 'document',
+        table: collection,
+        collection,
+        documentColumn: 'payload',
+        idField: 'fileId',
+        fields: {
+            fileId: { column: 'file_id', jsonPath: 'fileId' },
+        },
+        schema: {
+            ddl: (0, exports.FILE_BINARY_BLOB_TABLE_DDL_POSTGRES)(collection),
+            indexes: [{ fileId: 1 }],
+        },
+    };
+}
+//#endregion
+//# sourceMappingURL=file-binary-blob-jql-source.js.map

package/file-storage/database/src/lib/file-binary-blob-jql-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-binary-blob-jql-source.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/file-storage/database/src/lib/file-binary-blob-jql-source.ts"],"names":[],"mappings":";;;AAQA,kFAEC;AAWD,sEAiBC;AApCD,iDAAiD;AAEpC,QAAA,2BAA2B,GAAG,mBAAmB,CAAC;AAE/D,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;AAE/C,SAAgB,mCAAmC;IACjD,OAAO,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,IAAI,kBAAkB,CAAC;AAC1E,CAAC;AAEM,MAAM,mCAAmC,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC;+BAC/C,KAAK;;;;;mCAKD,KAAK,eAAe,KAAK;CAC3D,CAAC;AAPW,QAAA,mCAAmC,uCAO9C;AAEF,SAAgB,6BAA6B,CAAC,cAAuB;IACnE,MAAM,UAAU,GAAG,cAAc,IAAI,mCAAmC,EAAE,CAAC;IAC3E,OAAO;QACL,IAAI,EAAE,mCAA2B;QACjC,OAAO,EAAE,UAAU;QACnB,KAAK,EAAE,UAAU;QACjB,UAAU;QACV,cAAc,EAAE,SAAS;QACzB,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE;YACN,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE;SAClD;QACD,MAAM,EAAE;YACN,GAAG,EAAE,IAAA,2CAAmC,EAAC,UAAU,CAAC;YACpD,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;SACzB;KACF,CAAC;AACJ,CAAC;AAED,YAAY"}

package/file-storage/database/src/lib/jql-binary-file-storage.engine.d.ts

@@ -0,0 +1,13 @@
+import { type FileStorageEngine, type FileStorageEnginePutHints } from '@acorex-platform/framework-server/file-storage/abstract';
+import { JqlEngineBase } from '@acorex-platform/framework-server/jql/abstract';
+import { OnModuleInit } from '@nestjs/common';
+export declare class JqlBinaryFileStorageEngine implements FileStorageEngine, OnModuleInit {
+    private readonly engine;
+    private readonly logger;
+    constructor(engine: JqlEngineBase);
+    onModuleInit(): Promise<void>;
+    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>;
+}

package/file-storage/database/src/lib/jql-binary-file-storage.engine.js

@@ -0,0 +1,59 @@
+"use strict";
+var JqlBinaryFileStorageEngine_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JqlBinaryFileStorageEngine = void 0;
+const tslib_1 = require("tslib");
+const abstract_1 = require("@acorex-platform/framework-server/file-storage/abstract");
+const abstract_2 = require("@acorex-platform/framework-server/jql/abstract");
+const common_1 = require("@nestjs/common");
+const file_binary_blob_jql_source_1 = require("./file-binary-blob-jql-source");
+let JqlBinaryFileStorageEngine = JqlBinaryFileStorageEngine_1 = class JqlBinaryFileStorageEngine {
+    constructor(engine) {
+        this.engine = engine;
+        this.logger = new common_1.Logger(JqlBinaryFileStorageEngine_1.name);
+    }
+    async onModuleInit() {
+        const source = (0, file_binary_blob_jql_source_1.createFileBinaryBlobJqlSource)();
+        await this.engine.registerAndEnsureSource(source);
+        this.logger.log(`JQL binary blob storage ready (collection: ${source.collection})`);
+    }
+    async put(fileId, buffer, _hints) {
+        const document = {
+            fileId,
+            binaryBase64: buffer.toString('base64'),
+            size: buffer.length,
+        };
+        await this.engine.insert({
+            into: file_binary_blob_jql_source_1.FILE_BINARY_BLOB_JQL_SOURCE,
+            documents: [document],
+        });
+        return fileId;
+    }
+    async get(storagePath) {
+        const record = await this.engine.findOne({
+            from: file_binary_blob_jql_source_1.FILE_BINARY_BLOB_JQL_SOURCE,
+            where: (0, abstract_2.eqCondition)('fileId', storagePath),
+        });
+        if (!record?.binaryBase64) {
+            throw new Error(`Binary blob not found: ${storagePath}`);
+        }
+        return Buffer.from(record.binaryBase64, 'base64');
+    }
+    async delete(storagePath) {
+        await this.engine.delete({
+            from: file_binary_blob_jql_source_1.FILE_BINARY_BLOB_JQL_SOURCE,
+            where: (0, abstract_2.eqCondition)('fileId', storagePath),
+        });
+    }
+    async rename(_oldPath, _newPath) {
+        // Blob keyed by fileId; locator does not change on rename.
+    }
+};
+exports.JqlBinaryFileStorageEngine = JqlBinaryFileStorageEngine;
+exports.JqlBinaryFileStorageEngine = JqlBinaryFileStorageEngine = JqlBinaryFileStorageEngine_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(0, (0, common_1.Inject)(abstract_1.FILE_STORAGE_JQL_ENGINE)),
+    tslib_1.__metadata("design:paramtypes", [abstract_2.JqlEngineBase])
+], JqlBinaryFileStorageEngine);
+//#endregion
+//# sourceMappingURL=jql-binary-file-storage.engine.js.map

package/file-storage/database/src/lib/jql-binary-file-storage.engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jql-binary-file-storage.engine.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/file-storage/database/src/lib/jql-binary-file-storage.engine.ts"],"names":[],"mappings":";;;;;AAAA,sFAQiE;AAEjE,6EAA4F;AAE5F,2CAA0E;AAE1E,+EAMuC;AAsBhC,IAAM,0BAA0B,kCAAhC,MAAM,0BAA0B;IAMrC,YAIE,MAAsC;QAArB,WAAM,GAAN,MAAM,CAAe;QARvB,WAAM,GAAG,IAAI,eAAM,CAAC,4BAA0B,CAAC,IAAI,CAAC,CAAC;IAUnE,CAAC;IAIJ,KAAK,CAAC,YAAY;QAEhB,MAAM,MAAM,GAAG,IAAA,2DAA6B,GAAE,CAAC;QAE/C,MAAM,IAAI,CAAC,MAAM,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC;QAElD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,8CAA8C,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC;IAEtF,CAAC;IAID,KAAK,CAAC,GAAG,CAAC,MAAc,EAAE,MAAc,EAAE,MAAkC;QAE1E,MAAM,QAAQ,GAAuB;YAEnC,MAAM;YAEN,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAEvC,IAAI,EAAE,MAAM,CAAC,MAAM;SAEpB,CAAC;QAIF,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;YAEvB,IAAI,EAAE,yDAA2B;YAEjC,SAAS,EAAE,CAAC,QAA8C,CAAC;SAE5D,CAAC,CAAC;QAIH,OAAO,MAAM,CAAC;IAEhB,CAAC;IAID,KAAK,CAAC,GAAG,CAAC,WAAmB;QAE3B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAqB;YAE3D,IAAI,EAAE,yDAA2B;YAEjC,KAAK,EAAE,IAAA,sBAAW,EAAC,QAAQ,EAAE,WAAW,CAAC;SAE1C,CAAC,CAAC;QAIH,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC;YAE1B,MAAM,IAAI,KAAK,CAAC,0BAA0B,WAAW,EAAE,CAAC,CAAC;QAE3D,CAAC;QAID,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAEpD,CAAC;IAID,KAAK,CAAC,MAAM,CAAC,WAAmB;QAE9B,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;YAEvB,IAAI,EAAE,yDAA2B;YAEjC,KAAK,EAAE,IAAA,sBAAW,EAAC,QAAQ,EAAE,WAAW,CAAC;SAE1C,CAAC,CAAC;IAEL,CAAC;IAID,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,QAAgB;QAE7C,2DAA2D;IAE7D,CAAC;CAEF,CAAA;AAxGY,gEAA0B;qCAA1B,0BAA0B;IAFtC,IAAA,mBAAU,GAAE;IAUR,mBAAA,IAAA,eAAM,EAAC,kCAAuB,CAAC,CAAA;6CAEP,wBAAa;GAV7B,0BAA0B,CAwGtC;AAID,YAAY"}