@acorex-platform/framework-server 0.0.10

package/core/src/lib/entity-storage/entity-storage.controller.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityStorageController = void 0;
+const tslib_1 = require("tslib");
+const abstract_1 = require("@acorex-platform/framework-server/jql/abstract");
+const common_1 = require("@nestjs/common");
+const entity_storage_middleware_service_1 = require("./entity-storage-middleware.service");
+const entity_route_util_1 = require("./utils/entity-route.util");
+//#region ---- Entity storage REST controller ----
+let EntityStorageController = class EntityStorageController {
+    constructor(storage) {
+        this.storage = storage;
+    }
+    async query(area, module, entity, skip, take, orderBy, filterJson, quickSearch, bypassVisibility, bypassOwnership) {
+        const entityName = (0, entity_route_util_1.routeToEntityName)(area, module, entity);
+        let request;
+        try {
+            request = (0, entity_route_util_1.buildQueryRequest)({
+                skip,
+                take,
+                orderBy,
+                filter: filterJson,
+                quickSearch,
+                bypassVisibility,
+                bypassOwnership,
+            });
+        }
+        catch (error) {
+            if (error instanceof entity_route_util_1.InvalidEntityFilterError) {
+                throw new common_1.BadRequestException(error.message);
+            }
+            throw error;
+        }
+        return this.storage.query(entityName, request);
+    }
+    async aggregate(area, module, entity, body) {
+        const entityName = (0, entity_route_util_1.routeToEntityName)(area, module, entity);
+        if (!body?.measures?.length) {
+            throw new common_1.BadRequestException('Aggregate request must include at least one measure.');
+        }
+        return this.storage.aggregate(entityName, body);
+    }
+    async getOne(area, module, entity, id) {
+        const entityName = (0, entity_route_util_1.routeToEntityName)(area, module, entity);
+        return this.storage.getOne(entityName, id);
+    }
+    async insertOne(area, module, entity, body) {
+        const entityName = (0, entity_route_util_1.routeToEntityName)(area, module, entity);
+        const id = await this.storage.insertOne(entityName, body);
+        return { id };
+    }
+    async updateOne(area, module, entity, id, body) {
+        const entityName = (0, entity_route_util_1.routeToEntityName)(area, module, entity);
+        return this.storage.updateOne(entityName, id, body);
+    }
+    async deleteOne(area, module, entity, id) {
+        const entityName = (0, entity_route_util_1.routeToEntityName)(area, module, entity);
+        await this.storage.deleteOne(entityName, id);
+    }
+};
+exports.EntityStorageController = EntityStorageController;
+tslib_1.__decorate([
+    (0, common_1.Get)(),
+    tslib_1.__param(0, (0, common_1.Param)('area')),
+    tslib_1.__param(1, (0, common_1.Param)('module')),
+    tslib_1.__param(2, (0, common_1.Param)('entity')),
+    tslib_1.__param(3, (0, common_1.Query)('Skip')),
+    tslib_1.__param(4, (0, common_1.Query)('Take')),
+    tslib_1.__param(5, (0, common_1.Query)('$orderby')),
+    tslib_1.__param(6, (0, common_1.Query)('filter')),
+    tslib_1.__param(7, (0, common_1.Query)('quickSearch')),
+    tslib_1.__param(8, (0, common_1.Query)(abstract_1.VISIBILITY_FILTER_BYPASS)),
+    tslib_1.__param(9, (0, common_1.Query)(abstract_1.OWNERSHIP_FILTER_BYPASS)),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, String, String, String, String, String, String, String, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], EntityStorageController.prototype, "query", null);
+tslib_1.__decorate([
+    (0, common_1.Post)('_aggregate'),
+    (0, common_1.HttpCode)(common_1.HttpStatus.OK),
+    tslib_1.__param(0, (0, common_1.Param)('area')),
+    tslib_1.__param(1, (0, common_1.Param)('module')),
+    tslib_1.__param(2, (0, common_1.Param)('entity')),
+    tslib_1.__param(3, (0, common_1.Body)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], EntityStorageController.prototype, "aggregate", null);
+tslib_1.__decorate([
+    (0, common_1.Get)(':id'),
+    tslib_1.__param(0, (0, common_1.Param)('area')),
+    tslib_1.__param(1, (0, common_1.Param)('module')),
+    tslib_1.__param(2, (0, common_1.Param)('entity')),
+    tslib_1.__param(3, (0, common_1.Param)('id')),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, String, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], EntityStorageController.prototype, "getOne", null);
+tslib_1.__decorate([
+    (0, common_1.Post)(),
+    (0, common_1.HttpCode)(common_1.HttpStatus.CREATED),
+    tslib_1.__param(0, (0, common_1.Param)('area')),
+    tslib_1.__param(1, (0, common_1.Param)('module')),
+    tslib_1.__param(2, (0, common_1.Param)('entity')),
+    tslib_1.__param(3, (0, common_1.Body)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], EntityStorageController.prototype, "insertOne", null);
+tslib_1.__decorate([
+    (0, common_1.Put)(':id'),
+    tslib_1.__param(0, (0, common_1.Param)('area')),
+    tslib_1.__param(1, (0, common_1.Param)('module')),
+    tslib_1.__param(2, (0, common_1.Param)('entity')),
+    tslib_1.__param(3, (0, common_1.Param)('id')),
+    tslib_1.__param(4, (0, common_1.Body)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, String, String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], EntityStorageController.prototype, "updateOne", null);
+tslib_1.__decorate([
+    (0, common_1.Delete)(':id'),
+    (0, common_1.HttpCode)(common_1.HttpStatus.NO_CONTENT),
+    tslib_1.__param(0, (0, common_1.Param)('area')),
+    tslib_1.__param(1, (0, common_1.Param)('module')),
+    tslib_1.__param(2, (0, common_1.Param)('entity')),
+    tslib_1.__param(3, (0, common_1.Param)('id')),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, String, String, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], EntityStorageController.prototype, "deleteOne", null);
+exports.EntityStorageController = EntityStorageController = tslib_1.__decorate([
+    (0, common_1.Controller)('v1/entity/:area/:module/:entity'),
+    tslib_1.__metadata("design:paramtypes", [entity_storage_middleware_service_1.EntityStorageMiddlewareService])
+], EntityStorageController);
+//#endregion
+//# sourceMappingURL=entity-storage.controller.js.map

package/core/src/lib/entity-storage/entity-storage.controller.js.map

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

package/core/src/lib/entity-storage/entity-storage.module.d.ts

@@ -0,0 +1,8 @@
+import { MiddlewareConsumer, NestModule } from '@nestjs/common';
+/**
+ * HTTP + middleware pipeline. Register a persistence backend via
+ * `MongoEntityStorageModule.forRoot()` or `EntityStorageLoggingModule.forRoot()`.
+ */
+export declare class EntityStorageModule implements NestModule {
+    configure(consumer: MiddlewareConsumer): void;
+}

package/core/src/lib/entity-storage/entity-storage.module.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityStorageModule = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const entity_storage_controller_1 = require("./entity-storage.controller");
+const entity_storage_middleware_service_1 = require("./entity-storage-middleware.service");
+const entity_storage_tokens_1 = require("./entity-storage.tokens");
+const entity_storage_request_context_middleware_1 = require("./middlewares/entity-storage-request-context.middleware");
+const request_log_middleware_1 = require("./middlewares/request-log.middleware");
+const category_hierarchy_filter_middleware_1 = require("./middlewares/category-hierarchy-filter.middleware");
+//#region ---- Entity storage module ----
+/**
+ * HTTP + middleware pipeline. Register a persistence backend via
+ * `MongoEntityStorageModule.forRoot()` or `EntityStorageLoggingModule.forRoot()`.
+ */
+let EntityStorageModule = class EntityStorageModule {
+    configure(consumer) {
+        consumer.apply(entity_storage_request_context_middleware_1.EntityStorageRequestContextMiddleware).forRoutes('*');
+    }
+};
+exports.EntityStorageModule = EntityStorageModule;
+exports.EntityStorageModule = EntityStorageModule = tslib_1.__decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        controllers: [entity_storage_controller_1.EntityStorageController],
+        providers: [
+            entity_storage_middleware_service_1.EntityStorageMiddlewareService,
+            entity_storage_request_context_middleware_1.EntityStorageRequestContextMiddleware,
+            request_log_middleware_1.RequestLogMiddleware,
+            category_hierarchy_filter_middleware_1.CategoryHierarchyFilterMiddleware,
+            {
+                provide: entity_storage_tokens_1.ENTITY_STORAGE_MIDDLEWARE,
+                useExisting: category_hierarchy_filter_middleware_1.CategoryHierarchyFilterMiddleware,
+                multi: true,
+            },
+            {
+                provide: entity_storage_tokens_1.ENTITY_STORAGE_MIDDLEWARE,
+                useExisting: request_log_middleware_1.RequestLogMiddleware,
+                multi: true,
+            },
+        ],
+        exports: [entity_storage_middleware_service_1.EntityStorageMiddlewareService, entity_storage_tokens_1.ENTITY_STORAGE_MIDDLEWARE],
+    })
+], EntityStorageModule);
+//#endregion
+//# sourceMappingURL=entity-storage.module.js.map

package/core/src/lib/entity-storage/entity-storage.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-storage.module.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/core/src/lib/entity-storage/entity-storage.module.ts"],"names":[],"mappings":";;;;AAAA,2CAA+F;AAC/F,2EAAsE;AACtE,2FAAqF;AACrF,mEAAoE;AACpE,uHAAgH;AAChH,iFAA4E;AAC5E,6GAAuG;AAEvG,yCAAyC;AAEzC;;;GAGG;AAsBI,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAC9B,SAAS,CAAC,QAA4B;QACpC,QAAQ,CAAC,KAAK,CAAC,iFAAqC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACvE,CAAC;CACF,CAAA;AAJY,kDAAmB;8BAAnB,mBAAmB;IArB/B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,WAAW,EAAE,CAAC,mDAAuB,CAAC;QACtC,SAAS,EAAE;YACT,kEAA8B;YAC9B,iFAAqC;YACrC,6CAAoB;YACpB,wEAAiC;YACjC;gBACE,OAAO,EAAE,iDAAyB;gBAClC,WAAW,EAAE,wEAAiC;gBAC9C,KAAK,EAAE,IAAI;aACA;YACb;gBACE,OAAO,EAAE,iDAAyB;gBAClC,WAAW,EAAE,6CAAoB;gBACjC,KAAK,EAAE,IAAI;aACA;SACd;QACD,OAAO,EAAE,CAAC,kEAA8B,EAAE,iDAAyB,CAAC;KACrE,CAAC;GACW,mBAAmB,CAI/B;AAED,YAAY"}

package/core/src/lib/entity-storage/entity-storage.tokens.d.ts

@@ -0,0 +1,2 @@
+export { ENTITY_STORAGE_BACKEND } from '@acorex-platform/framework-server/jql/abstract';
+export declare const ENTITY_STORAGE_MIDDLEWARE: unique symbol;

package/core/src/lib/entity-storage/entity-storage.tokens.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENTITY_STORAGE_MIDDLEWARE = exports.ENTITY_STORAGE_BACKEND = void 0;
+var abstract_1 = require("@acorex-platform/framework-server/jql/abstract");
+Object.defineProperty(exports, "ENTITY_STORAGE_BACKEND", { enumerable: true, get: function () { return abstract_1.ENTITY_STORAGE_BACKEND; } });
+exports.ENTITY_STORAGE_MIDDLEWARE = Symbol('ENTITY_STORAGE_MIDDLEWARE');
+//# sourceMappingURL=entity-storage.tokens.js.map

package/core/src/lib/entity-storage/entity-storage.tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-storage.tokens.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/core/src/lib/entity-storage/entity-storage.tokens.ts"],"names":[],"mappings":";;;AAAA,2EAAwF;AAA/E,kHAAA,sBAAsB,OAAA;AAElB,QAAA,yBAAyB,GAAG,MAAM,CAAC,2BAA2B,CAAC,CAAC"}

package/core/src/lib/entity-storage/entity-storage.types.d.ts

@@ -0,0 +1,41 @@
+export type { AXPQuerySort, AXPQueryRequest, AXPPagedListResult, EntityStoragePagedResponse, AXPEntityOp, } from '@acorex-platform/framework-server/jql/abstract';
+import type { AXPEntityAggregateRequest, AXPEntityAggregateResult } from '@acorex-platform/framework-shared/entity';
+import type { AXPEntityOp, AXPQueryRequest, EntityStoragePagedResponse } from '@acorex-platform/framework-server/jql/abstract';
+export interface EntityStorageBackendDelegate {
+    getOne: (entityName: string, id: string) => Promise<unknown>;
+    insertOne: (entityName: string, entity: unknown) => Promise<string>;
+    query: (entityName: string, request: AXPQueryRequest) => Promise<EntityStoragePagedResponse>;
+    aggregate: (entityName: string, request: AXPEntityAggregateRequest) => Promise<AXPEntityAggregateResult>;
+    updateOne: (entityName: string, id: string, data: Record<string, unknown>) => Promise<unknown>;
+    deleteOne: (entityName: string, id: string) => Promise<void>;
+}
+export interface EntityStorageContext {
+    op: AXPEntityOp;
+    entityName: string;
+    id?: string;
+    data?: unknown;
+    request?: AXPQueryRequest;
+    previous?: unknown;
+    result?: unknown;
+    locals: Map<string, unknown>;
+    backend: EntityStorageBackendDelegate;
+}
+export interface EntityStorageMiddlewareTarget {
+    ops?: AXPEntityOp[];
+    entity?: string | RegExp;
+    predicate?: (ctx: EntityStorageContext) => boolean;
+    order?: number;
+}
+export interface EntityStorageMiddleware {
+    readonly target?: EntityStorageMiddlewareTarget;
+    execute: (ctx: EntityStorageContext, next: () => Promise<void>) => Promise<void>;
+}
+export interface AXPMiddlewareErrorResponse {
+    success: false;
+    error: {
+        code?: string;
+        message: string;
+        status?: number;
+        details?: unknown;
+    };
+}

package/core/src/lib/entity-storage/entity-storage.types.js

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

package/core/src/lib/entity-storage/entity-storage.types.js.map

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

package/core/src/lib/entity-storage/errors/middleware-abort.error.d.ts

@@ -0,0 +1,18 @@
+import { HttpException } from '@nestjs/common';
+import { AXPMiddlewareErrorResponse } from '../entity-storage.types';
+export declare class MiddlewareAbortError extends Error {
+    readonly message: string;
+    readonly options: {
+        code?: string;
+        status?: number;
+        details?: unknown;
+    };
+    constructor(message: string, options?: {
+        code?: string;
+        status?: number;
+        details?: unknown;
+    });
+    toResponse(): AXPMiddlewareErrorResponse;
+}
+export declare function isMiddlewareAbortError(error: unknown): error is MiddlewareAbortError;
+export declare function middlewareAbortToHttpException(error: MiddlewareAbortError): HttpException;

package/core/src/lib/entity-storage/errors/middleware-abort.error.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MiddlewareAbortError = void 0;
+exports.isMiddlewareAbortError = isMiddlewareAbortError;
+exports.middlewareAbortToHttpException = middlewareAbortToHttpException;
+const common_1 = require("@nestjs/common");
+//#region ---- Middleware abort error ----
+class MiddlewareAbortError extends Error {
+    constructor(message, options = {}) {
+        super(message);
+        this.message = message;
+        this.options = options;
+        this.name = 'MiddlewareAbortError';
+    }
+    toResponse() {
+        return {
+            success: false,
+            error: {
+                code: this.options.code,
+                message: this.message,
+                status: this.options.status,
+                details: this.options.details,
+            },
+        };
+    }
+}
+exports.MiddlewareAbortError = MiddlewareAbortError;
+function isMiddlewareAbortError(error) {
+    return error instanceof MiddlewareAbortError;
+}
+function middlewareAbortToHttpException(error) {
+    const status = error.options.status ?? common_1.HttpStatus.BAD_REQUEST;
+    return new common_1.HttpException(error.toResponse(), status);
+}
+//#endregion
+//# sourceMappingURL=middleware-abort.error.js.map

package/core/src/lib/entity-storage/errors/middleware-abort.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-abort.error.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/core/src/lib/entity-storage/errors/middleware-abort.error.ts"],"names":[],"mappings":";;;AA2BA,wDAEC;AAED,wEAGC;AAlCD,2CAA2D;AAG3D,0CAA0C;AAE1C,MAAa,oBAAqB,SAAQ,KAAK;IAC7C,YACoB,OAAe,EACjB,UAAiE,EAAE;QAEnF,KAAK,CAAC,OAAO,CAAC,CAAC;QAHG,YAAO,GAAP,OAAO,CAAQ;QACjB,YAAO,GAAP,OAAO,CAA4D;QAGnF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;IAED,UAAU;QACR,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;gBACvB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;gBAC3B,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;aAC9B;SACF,CAAC;IACJ,CAAC;CACF;AApBD,oDAoBC;AAED,SAAgB,sBAAsB,CAAC,KAAc;IACnD,OAAO,KAAK,YAAY,oBAAoB,CAAC;AAC/C,CAAC;AAED,SAAgB,8BAA8B,CAAC,KAA2B;IACxE,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,IAAI,mBAAU,CAAC,WAAW,CAAC;IAC9D,OAAO,IAAI,sBAAa,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC,CAAC;AACvD,CAAC;AAED,YAAY"}

package/core/src/lib/entity-storage/index.d.ts

@@ -0,0 +1,14 @@
+export * from '@acorex-platform/framework-server/jql/abstract';
+export * from './entity-storage.types';
+export * from './entity-storage.tokens';
+export * from './entity-storage-backend.interface';
+export * from './entity-storage.module';
+export * from './entity-storage-logging.module';
+export * from './entity-storage-middleware.service';
+export * from './entity-storage.controller';
+export * from './backends/logging.entity-storage.backend';
+export * from './errors/middleware-abort.error';
+export * from './entity-storage-request-context';
+export * from './utils/entity-route.util';
+export * from './middlewares/request-log.middleware';
+export * from './middlewares/category-hierarchy-filter.middleware';

package/core/src/lib/entity-storage/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("@acorex-platform/framework-server/jql/abstract"), exports);
+tslib_1.__exportStar(require("./entity-storage.types"), exports);
+tslib_1.__exportStar(require("./entity-storage.tokens"), exports);
+tslib_1.__exportStar(require("./entity-storage-backend.interface"), exports);
+tslib_1.__exportStar(require("./entity-storage.module"), exports);
+tslib_1.__exportStar(require("./entity-storage-logging.module"), exports);
+tslib_1.__exportStar(require("./entity-storage-middleware.service"), exports);
+tslib_1.__exportStar(require("./entity-storage.controller"), exports);
+tslib_1.__exportStar(require("./backends/logging.entity-storage.backend"), exports);
+tslib_1.__exportStar(require("./errors/middleware-abort.error"), exports);
+tslib_1.__exportStar(require("./entity-storage-request-context"), exports);
+tslib_1.__exportStar(require("./utils/entity-route.util"), exports);
+tslib_1.__exportStar(require("./middlewares/request-log.middleware"), exports);
+tslib_1.__exportStar(require("./middlewares/category-hierarchy-filter.middleware"), exports);
+//# sourceMappingURL=index.js.map

package/core/src/lib/entity-storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/core/src/lib/entity-storage/index.ts"],"names":[],"mappings":";;;AAAA,yFAA+D;AAC/D,iEAAuC;AACvC,kEAAwC;AACxC,6EAAmD;AACnD,kEAAwC;AACxC,0EAAgD;AAChD,8EAAoD;AACpD,sEAA4C;AAC5C,oFAA0D;AAC1D,0EAAgD;AAChD,2EAAiD;AACjD,oEAA0C;AAC1C,+EAAqD;AACrD,6FAAmE"}

package/core/src/lib/entity-storage/middlewares/category-hierarchy-filter.middleware.d.ts

@@ -0,0 +1,10 @@
+import { EntityStorageContext, EntityStorageMiddleware, EntityStorageMiddlewareTarget } from '../entity-storage.types';
+/**
+ * Expands category hierarchy filters before query execution.
+ * Rewrites `contains` on categoryIds/*Ids (except roleIds) to `arrayOverlaps` with descendant ids.
+ */
+export declare class CategoryHierarchyFilterMiddleware implements EntityStorageMiddleware {
+    readonly target: EntityStorageMiddlewareTarget;
+    execute(ctx: EntityStorageContext, next: () => Promise<void>): Promise<void>;
+    private loadCategoryTree;
+}

package/core/src/lib/entity-storage/middlewares/category-hierarchy-filter.middleware.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CategoryHierarchyFilterMiddleware = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const abstract_1 = require("@acorex-platform/framework-server/jql/abstract");
+//#region ---- Category hierarchy filter middleware ----
+/**
+ * Expands category hierarchy filters before query execution.
+ * Rewrites `contains` on categoryIds/*Ids (except roleIds) to `arrayOverlaps` with descendant ids.
+ */
+let CategoryHierarchyFilterMiddleware = class CategoryHierarchyFilterMiddleware {
+    constructor() {
+        this.target = {
+            ops: ['query'],
+            order: 5,
+        };
+    }
+    async execute(ctx, next) {
+        const request = ctx.request;
+        if (!request?.filter || !(0, abstract_1.isCategoryFilter)(request.filter)) {
+            await next();
+            return;
+        }
+        const categoryEntityName = (0, abstract_1.resolveCompanionCategoryEntityName)(ctx.entityName);
+        const tree = await this.loadCategoryTree(categoryEntityName, ctx);
+        const expandIds = (categoryId) => (0, abstract_1.collectDescendantCategoryIds)(categoryId, tree);
+        const rewrittenFilter = (0, abstract_1.rewriteAxpCategoryHierarchyFilter)(request.filter, expandIds);
+        ctx.request = { ...request, filter: rewrittenFilter };
+        await next();
+    }
+    async loadCategoryTree(categoryEntityName, ctx) {
+        const cacheKey = (0, abstract_1.categoryTreeCacheKey)(categoryEntityName);
+        const cached = ctx.locals.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        try {
+            const result = await ctx.backend.query(categoryEntityName, { skip: 0, take: 10000 });
+            const items = (result?.items ?? []);
+            const tree = (0, abstract_1.buildCategoryTreeIndex)(items);
+            ctx.locals.set(cacheKey, tree);
+            return tree;
+        }
+        catch {
+            const emptyTree = (0, abstract_1.buildCategoryTreeIndex)([]);
+            ctx.locals.set(cacheKey, emptyTree);
+            return emptyTree;
+        }
+    }
+};
+exports.CategoryHierarchyFilterMiddleware = CategoryHierarchyFilterMiddleware;
+exports.CategoryHierarchyFilterMiddleware = CategoryHierarchyFilterMiddleware = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], CategoryHierarchyFilterMiddleware);
+//#endregion
+//# sourceMappingURL=category-hierarchy-filter.middleware.js.map

package/core/src/lib/entity-storage/middlewares/category-hierarchy-filter.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"category-hierarchy-filter.middleware.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/core/src/lib/entity-storage/middlewares/category-hierarchy-filter.middleware.ts"],"names":[],"mappings":";;;;AAAA,2CAA4C;AAC5C,6EAQwD;AAOxD,wDAAwD;AAExD;;;GAGG;AAEI,IAAM,iCAAiC,GAAvC,MAAM,iCAAiC;IAAvC;QACI,WAAM,GAAkC;YAC/C,GAAG,EAAE,CAAC,OAAO,CAAC;YACd,KAAK,EAAE,CAAC;SACT,CAAC;IAyCJ,CAAC;IAvCC,KAAK,CAAC,OAAO,CAAC,GAAyB,EAAE,IAAyB;QAChE,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,IAAA,2BAAgB,EAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,MAAM,kBAAkB,GAAG,IAAA,6CAAkC,EAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC9E,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;QAElE,MAAM,SAAS,GAAG,CAAC,UAAkB,EAAE,EAAE,CAAC,IAAA,uCAA4B,EAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACzF,MAAM,eAAe,GAAG,IAAA,4CAAiC,EAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAErF,GAAG,CAAC,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;QACtD,MAAM,IAAI,EAAE,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC5B,kBAA0B,EAC1B,GAAyB;QAEzB,MAAM,QAAQ,GAAG,IAAA,+BAAoB,EAAC,kBAAkB,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAA2B,CAAC;QACrC,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACrF,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAoD,CAAC;YACvF,MAAM,IAAI,GAAG,IAAA,iCAAsB,EAAC,KAAK,CAAC,CAAC;YAC3C,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,SAAS,GAAG,IAAA,iCAAsB,EAAC,EAAE,CAAC,CAAC;YAC7C,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YACpC,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;CACF,CAAA;AA7CY,8EAAiC;4CAAjC,iCAAiC;IAD7C,IAAA,mBAAU,GAAE;GACA,iCAAiC,CA6C7C;AAED,YAAY"}

package/core/src/lib/entity-storage/middlewares/entity-storage-request-context.middleware.d.ts

@@ -0,0 +1,9 @@
+import { NestMiddleware } from '@nestjs/common';
+import type { NextFunction, Request, Response } from 'express';
+/**
+ * Binds the current HTTP request to Nest's DI context so request-scoped
+ * entity storage middleware (e.g. folder storage) resolves with session data.
+ */
+export declare class EntityStorageRequestContextMiddleware implements NestMiddleware {
+    use(req: Request, _res: Response, next: NextFunction): void;
+}

package/core/src/lib/entity-storage/middlewares/entity-storage-request-context.middleware.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityStorageRequestContextMiddleware = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const entity_storage_request_context_1 = require("../entity-storage-request-context");
+//#region ---- HTTP request context for scoped entity middleware ----
+/**
+ * Binds the current HTTP request to Nest's DI context so request-scoped
+ * entity storage middleware (e.g. folder storage) resolves with session data.
+ */
+let EntityStorageRequestContextMiddleware = class EntityStorageRequestContextMiddleware {
+    use(req, _res, next) {
+        (0, entity_storage_request_context_1.runWithEntityStorageRequestContext)(req, () => next());
+    }
+};
+exports.EntityStorageRequestContextMiddleware = EntityStorageRequestContextMiddleware;
+exports.EntityStorageRequestContextMiddleware = EntityStorageRequestContextMiddleware = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], EntityStorageRequestContextMiddleware);
+//#endregion
+//# sourceMappingURL=entity-storage-request-context.middleware.js.map

package/core/src/lib/entity-storage/middlewares/entity-storage-request-context.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-storage-request-context.middleware.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/core/src/lib/entity-storage/middlewares/entity-storage-request-context.middleware.ts"],"names":[],"mappings":";;;;AAAA,2CAA4D;AAE5D,sFAAuF;AAEvF,qEAAqE;AAErE;;;GAGG;AAEI,IAAM,qCAAqC,GAA3C,MAAM,qCAAqC;IAChD,GAAG,CAAC,GAAY,EAAE,IAAc,EAAE,IAAkB;QAClD,IAAA,mEAAkC,EAAC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;CACF,CAAA;AAJY,sFAAqC;gDAArC,qCAAqC;IADjD,IAAA,mBAAU,GAAE;GACA,qCAAqC,CAIjD;AAED,YAAY"}

package/core/src/lib/entity-storage/middlewares/request-log.middleware.d.ts

@@ -0,0 +1,11 @@
+import { EntityStorageContext, EntityStorageMiddleware } from '../entity-storage.types';
+/**
+ * Sample middleware: logs each entity storage operation before delegate runs.
+ */
+export declare class RequestLogMiddleware implements EntityStorageMiddleware {
+    private readonly logger;
+    readonly target: {
+        order: number;
+    };
+    execute(ctx: EntityStorageContext, next: () => Promise<void>): Promise<void>;
+}

package/core/src/lib/entity-storage/middlewares/request-log.middleware.js

@@ -0,0 +1,26 @@
+"use strict";
+var RequestLogMiddleware_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestLogMiddleware = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+//#region ---- Request log middleware ----
+/**
+ * Sample middleware: logs each entity storage operation before delegate runs.
+ */
+let RequestLogMiddleware = RequestLogMiddleware_1 = class RequestLogMiddleware {
+    constructor() {
+        this.logger = new common_1.Logger(RequestLogMiddleware_1.name);
+        this.target = { order: 1 };
+    }
+    async execute(ctx, next) {
+        this.logger.debug(`[${ctx.op}] ${ctx.entityName}`);
+        await next();
+    }
+};
+exports.RequestLogMiddleware = RequestLogMiddleware;
+exports.RequestLogMiddleware = RequestLogMiddleware = RequestLogMiddleware_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], RequestLogMiddleware);
+//#endregion
+//# sourceMappingURL=request-log.middleware.js.map

package/core/src/lib/entity-storage/middlewares/request-log.middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-log.middleware.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/core/src/lib/entity-storage/middlewares/request-log.middleware.ts"],"names":[],"mappings":";;;;;AAAA,2CAAoD;AAGpD,0CAA0C;AAE1C;;GAEG;AAEI,IAAM,oBAAoB,4BAA1B,MAAM,oBAAoB;IAA1B;QACY,WAAM,GAAG,IAAI,eAAM,CAAC,sBAAoB,CAAC,IAAI,CAAC,CAAC;QAEvD,WAAM,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAMjC,CAAC;IAJC,KAAK,CAAC,OAAO,CAAC,GAAyB,EAAE,IAAyB;QAChE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QACnD,MAAM,IAAI,EAAE,CAAC;IACf,CAAC;CACF,CAAA;AATY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;GACA,oBAAoB,CAShC;AAED,YAAY"}

package/core/src/lib/entity-storage/utils/entity-route.util.d.ts

@@ -0,0 +1,24 @@
+import { AXPQueryRequest, AXPQuerySort } from '@acorex-platform/framework-server/jql/abstract';
+/**
+ * Converts a kebab-case path segment to PascalCase (e.g. document-management → DocumentManagement).
+ */
+export declare function kebabSegmentToPascal(kebab: string): string;
+/**
+ * Builds platform entity name from REST path segments (inverse of AXCApiEntityStorageService.getConfigEntity).
+ */
+export declare function routeToEntityName(area: string, module: string, entity: string): string;
+export declare class InvalidEntityFilterError extends Error {
+    constructor(message?: string);
+}
+export declare function parseOrderByParam(orderBy?: string): AXPQuerySort[] | undefined;
+/** Parses URL-encoded JSON from the `filter` query parameter into an AXP filter object. */
+export declare function parseFilterQueryParam(filterJson?: string): unknown;
+export declare function buildQueryRequest(params: {
+    skip?: string;
+    take?: string;
+    orderBy?: string;
+    filter?: string;
+    quickSearch?: string;
+    bypassVisibility?: string;
+    bypassOwnership?: string;
+}): AXPQueryRequest;