@acorex-platform/framework-server 0.0.10

package/report/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@acorex-platform/framework-server/report",
+  "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/core": "0.0.0-ACOREX",
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/core": "^11.0.0",
+    "lodash-es": "^4.17.21"
+  }
+}

package/report/src/index.d.ts

@@ -0,0 +1,8 @@
+export * from './lib/report.module';
+export * from './lib/report-execute.service';
+export * from './lib/report.types';
+export * from './lib/report.decorators';
+export * from './lib/report-query.registry';
+export * from './lib/report-definition.registry';
+export * from './lib/report.util';
+export * from './lib/report-summary.util';

package/report/src/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/report.module"), exports);
+tslib_1.__exportStar(require("./lib/report-execute.service"), exports);
+tslib_1.__exportStar(require("./lib/report.types"), exports);
+tslib_1.__exportStar(require("./lib/report.decorators"), exports);
+tslib_1.__exportStar(require("./lib/report-query.registry"), exports);
+tslib_1.__exportStar(require("./lib/report-definition.registry"), exports);
+tslib_1.__exportStar(require("./lib/report.util"), exports);
+tslib_1.__exportStar(require("./lib/report-summary.util"), exports);
+//# sourceMappingURL=index.js.map

package/report/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/framework/server/report/src/index.ts"],"names":[],"mappings":";;;AAAA,8DAAoC;AACpC,uEAA6C;AAC7C,6DAAmC;AACnC,kEAAwC;AACxC,sEAA4C;AAC5C,2EAAiD;AACjD,4DAAkC;AAClC,oEAA0C"}

package/report/src/lib/report-definition.registry.d.ts

@@ -0,0 +1,20 @@
+import { OnApplicationBootstrap } from '@nestjs/common';
+import { DiscoveryService, Reflector } from '@nestjs/core';
+import { EntityStorageMiddlewareService } from '@acorex-platform/framework-server/core';
+/**
+ * Discovers {@link BackendReportDefinitionProvider} classes and upserts categories
+ * and report definitions into entity storage (insert only when missing).
+ */
+export declare class BackendReportDefinitionRegistry implements OnApplicationBootstrap {
+    private readonly discovery;
+    private readonly reflector;
+    private readonly storage;
+    private readonly logger;
+    private seeded;
+    constructor(discovery: DiscoveryService, reflector: Reflector, storage: EntityStorageMiddlewareService);
+    onApplicationBootstrap(): Promise<void>;
+    seedDefinitions(): Promise<void>;
+    private collectDefinitionProviders;
+    private isDefinitionProvider;
+    private upsertDefinition;
+}

package/report/src/lib/report-definition.registry.js

@@ -0,0 +1,134 @@
+"use strict";
+var BackendReportDefinitionRegistry_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackendReportDefinitionRegistry = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const core_2 = require("@acorex-platform/framework-server/core");
+const abstract_1 = require("@acorex-platform/framework-server/jql/abstract");
+const lodash_es_1 = require("lodash-es");
+const report_decorators_1 = require("./report.decorators");
+const report_types_1 = require("./report.types");
+//#region ---- Report definition registry ----
+/**
+ * Discovers {@link BackendReportDefinitionProvider} classes and upserts categories
+ * and report definitions into entity storage (insert only when missing).
+ */
+let BackendReportDefinitionRegistry = BackendReportDefinitionRegistry_1 = class BackendReportDefinitionRegistry {
+    constructor(discovery, reflector, storage) {
+        this.discovery = discovery;
+        this.reflector = reflector;
+        this.storage = storage;
+        this.logger = new common_1.Logger(BackendReportDefinitionRegistry_1.name);
+        this.seeded = false;
+    }
+    async onApplicationBootstrap() {
+        await this.seedDefinitions();
+    }
+    async seedDefinitions() {
+        if (this.seeded) {
+            return;
+        }
+        const providers = this.collectDefinitionProviders();
+        const categories = [];
+        const definitions = [];
+        for (const provider of providers) {
+            if (provider.getCategories) {
+                categories.push(...provider.getCategories());
+            }
+            definitions.push(...provider.getDefinitions());
+        }
+        let categoryCount = 0;
+        let categoryUpdated = 0;
+        for (const category of categories) {
+            const result = await this.upsertDefinition(report_types_1.REPORT_CATEGORY_ENTITY, category.id, category);
+            if (result === 'inserted') {
+                categoryCount += 1;
+            }
+            else if (result === 'updated') {
+                categoryUpdated += 1;
+            }
+        }
+        let definitionCount = 0;
+        let definitionUpdated = 0;
+        for (const definition of definitions) {
+            const result = await this.upsertDefinition(report_types_1.REPORT_ENTITY, definition.id, definition);
+            if (result === 'inserted') {
+                definitionCount += 1;
+            }
+            else if (result === 'updated') {
+                definitionUpdated += 1;
+            }
+        }
+        this.seeded = true;
+        this.logger.log(`Report definition seed finished: ${categoryCount} new categories, ${categoryUpdated} updated categories, ` +
+            `${definitionCount} new reports, ${definitionUpdated} updated reports (${providers.length} provider(s))`);
+    }
+    collectDefinitionProviders() {
+        const providers = [];
+        const wrappers = this.discovery.getProviders();
+        for (const wrapper of wrappers) {
+            const { instance } = wrapper;
+            if (!instance || typeof instance !== 'object') {
+                continue;
+            }
+            const metatype = wrapper.metatype;
+            if (!metatype) {
+                continue;
+            }
+            const isProvider = this.reflector.get(report_decorators_1.REPORT_DEFINITION_PROVIDER_METADATA, metatype);
+            if (!isProvider) {
+                continue;
+            }
+            if (!this.isDefinitionProvider(instance)) {
+                this.logger.warn(`Provider ${metatype.name} is marked @ReportDefinitionProvider but does not implement BackendReportDefinitionProvider`);
+                continue;
+            }
+            providers.push(instance);
+        }
+        return providers;
+    }
+    isDefinitionProvider(value) {
+        const candidate = value;
+        return typeof candidate.getDefinitions === 'function';
+    }
+    async upsertDefinition(entityName, id, document) {
+        if (!id) {
+            return 'skipped';
+        }
+        const payload = { ...document, id };
+        try {
+            const existing = await this.storage.getOne(entityName, id);
+            if (existing) {
+                await this.storage.updateOne(entityName, id, payload);
+                this.logger.debug(`Updated ${entityName}: ${id} (${String((0, lodash_es_1.get)(document, 'title') ?? id)})`);
+                return 'updated';
+            }
+        }
+        catch {
+            // Entity may not exist yet; proceed with insert.
+        }
+        try {
+            await this.storage.insertOne(entityName, payload);
+        }
+        catch (error) {
+            if (error instanceof abstract_1.JqlEntitySchemaNotFoundError) {
+                this.logger.warn(`Skipping report upsert for ${entityName}; entity schema is not registered yet.`);
+                return 'skipped';
+            }
+            throw error;
+        }
+        this.logger.debug(`Seeded ${entityName}: ${id} (${String((0, lodash_es_1.get)(document, 'title') ?? id)})`);
+        return 'inserted';
+    }
+};
+exports.BackendReportDefinitionRegistry = BackendReportDefinitionRegistry;
+exports.BackendReportDefinitionRegistry = BackendReportDefinitionRegistry = BackendReportDefinitionRegistry_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [core_1.DiscoveryService,
+        core_1.Reflector,
+        core_2.EntityStorageMiddlewareService])
+], BackendReportDefinitionRegistry);
+//#endregion
+//# sourceMappingURL=report-definition.registry.js.map

package/report/src/lib/report-definition.registry.js.map

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

package/report/src/lib/report-execute.service.d.ts

@@ -0,0 +1,14 @@
+import { EntityStorageMiddlewareService } from '@acorex-platform/framework-server/core';
+import { BackendReportQueryRegistry } from './report-query.registry';
+import type { ReportExecuteBodyDto, ReportExecuteResponseDto } from './report.types';
+/**
+ * Server-side report execution: loads report definition from entity storage,
+ * runs the registered query handler, and normalizes the result by layout type.
+ */
+export declare class ReportExecuteService {
+    private readonly storage;
+    private readonly queryRegistry;
+    constructor(storage: EntityStorageMiddlewareService, queryRegistry: BackendReportQueryRegistry);
+    execute(body: ReportExecuteBodyDto): Promise<ReportExecuteResponseDto>;
+    private buildQueryInput;
+}

package/report/src/lib/report-execute.service.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportExecuteService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const core_1 = require("@acorex-platform/framework-server/core");
+const report_query_registry_1 = require("./report-query.registry");
+const report_result_normalizer_1 = require("./report-result-normalizer");
+const report_types_1 = require("./report.types");
+//#region ---- Report execute service ----
+/**
+ * Server-side report execution: loads report definition from entity storage,
+ * runs the registered query handler, and normalizes the result by layout type.
+ */
+let ReportExecuteService = class ReportExecuteService {
+    constructor(storage, queryRegistry) {
+        this.storage = storage;
+        this.queryRegistry = queryRegistry;
+    }
+    async execute(body) {
+        const { reportId, layoutId, filters: parameters } = body;
+        const reportDefinition = (await this.storage.getOne(report_types_1.REPORT_ENTITY, reportId));
+        if (!reportDefinition) {
+            throw new common_1.NotFoundException(`Report with ID ${reportId} not found`);
+        }
+        const layouts = reportDefinition['layouts'];
+        const layoutDefinition = layouts?.find((l) => l['id'] === layoutId);
+        if (!layoutDefinition) {
+            throw new common_1.NotFoundException(`Layout with ID ${layoutId} not found in report ${reportId}`);
+        }
+        const layout = layoutDefinition['layout'];
+        if (!layout?.['type']) {
+            throw new common_1.BadRequestException('Layout configuration is missing or invalid');
+        }
+        const dataSource = (body.dataSource ?? layoutDefinition['dataSource']);
+        if (!dataSource || dataSource.type !== 'query') {
+            throw new common_1.BadRequestException('Report dataSource must be of type "query"');
+        }
+        if (!dataSource.name) {
+            throw new common_1.BadRequestException('Query name is required in dataSource');
+        }
+        const queryInput = this.buildQueryInput(dataSource, parameters, layout);
+        if (!this.queryRegistry.has(dataSource.name)) {
+            throw new common_1.NotFoundException(`Query "${dataSource.name}" is not registered. Available queries: ${this.queryRegistry.keys().join(', ')}`);
+        }
+        const result = await this.queryRegistry.run(dataSource.name, queryInput);
+        if (result == null) {
+            throw new common_1.BadRequestException(`Query "${dataSource.name}" returned null`);
+        }
+        const layoutType = String(layout['type']);
+        let data;
+        if (layoutType === 'table') {
+            data = (0, report_result_normalizer_1.normalizeTableResult)(result);
+        }
+        else if (layoutType === 'chart') {
+            const options = layout['options'];
+            data = (0, report_result_normalizer_1.normalizeChartResult)(result, options?.['dataMapping']);
+        }
+        else if (layoutType === 'pdf') {
+            data = (0, report_result_normalizer_1.normalizePdfResult)(result);
+        }
+        else {
+            throw new common_1.BadRequestException(`Unsupported layout type: ${layoutType}`);
+        }
+        return {
+            layout,
+            data,
+        };
+    }
+    buildQueryInput(dataSource, parameters, layout) {
+        const paramsAny = (parameters ?? {});
+        const { skip, take, sort, ...filterRest } = paramsAny;
+        const input = {
+            filters: filterRest,
+            logic: filterRest['logic'] ?? 'and',
+        };
+        const runtimeSort = sort;
+        if (Array.isArray(runtimeSort) && runtimeSort.length > 0) {
+            input.sort = runtimeSort.map((s) => ({
+                field: s.field ?? s.name ?? '',
+                dir: s.dir === 'desc' ? 'desc' : 'asc',
+            }));
+        }
+        else if (dataSource.sortFields?.length) {
+            input.sort = dataSource.sortFields.map((s) => ({
+                field: s.name,
+                dir: s.dir ?? 'asc',
+            }));
+        }
+        if (layout['type'] === 'table') {
+            const summary = layout['summary'];
+            const reportFooterSummary = summary?.filter((s) => s.displayIn === 'reportFooter') ?? [];
+            if (reportFooterSummary.length > 0) {
+                input.summary = reportFooterSummary;
+            }
+        }
+        if (dataSource.pagination === true) {
+            if (typeof skip === 'number') {
+                input.skip = skip;
+            }
+            if (typeof take === 'number') {
+                input.take = take;
+            }
+        }
+        return input;
+    }
+};
+exports.ReportExecuteService = ReportExecuteService;
+exports.ReportExecuteService = ReportExecuteService = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [core_1.EntityStorageMiddlewareService,
+        report_query_registry_1.BackendReportQueryRegistry])
+], ReportExecuteService);
+//#endregion
+//# sourceMappingURL=report-execute.service.js.map

package/report/src/lib/report-execute.service.js.map

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

package/report/src/lib/report-query.registry.d.ts

@@ -0,0 +1,19 @@
+import { OnApplicationBootstrap } from '@nestjs/common';
+import { DiscoveryService, Reflector } from '@nestjs/core';
+import type { ReportQueryInput, ReportQueryResult } from './report.types';
+/**
+ * Discovers {@link BackendReportQueryHandler} providers marked with {@link ReportQuery}
+ * across all loaded Nest modules.
+ */
+export declare class BackendReportQueryRegistry implements OnApplicationBootstrap {
+    private readonly discovery;
+    private readonly reflector;
+    private readonly logger;
+    private readonly handlers;
+    constructor(discovery: DiscoveryService, reflector: Reflector);
+    onApplicationBootstrap(): void;
+    has(name: string): boolean;
+    keys(): string[];
+    run(name: string, input: ReportQueryInput): Promise<ReportQueryResult>;
+    private isQueryHandler;
+}

package/report/src/lib/report-query.registry.js

@@ -0,0 +1,73 @@
+"use strict";
+var BackendReportQueryRegistry_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackendReportQueryRegistry = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const report_decorators_1 = require("./report.decorators");
+//#region ---- Report query registry ----
+/**
+ * Discovers {@link BackendReportQueryHandler} providers marked with {@link ReportQuery}
+ * across all loaded Nest modules.
+ */
+let BackendReportQueryRegistry = BackendReportQueryRegistry_1 = class BackendReportQueryRegistry {
+    constructor(discovery, reflector) {
+        this.discovery = discovery;
+        this.reflector = reflector;
+        this.logger = new common_1.Logger(BackendReportQueryRegistry_1.name);
+        this.handlers = new Map();
+    }
+    onApplicationBootstrap() {
+        const wrappers = this.discovery.getProviders();
+        for (const wrapper of wrappers) {
+            const { instance } = wrapper;
+            if (!instance || typeof instance !== 'object') {
+                continue;
+            }
+            const metatype = wrapper.metatype;
+            if (!metatype) {
+                continue;
+            }
+            const isQueryHandler = this.reflector.get(report_decorators_1.REPORT_QUERY_METADATA, metatype);
+            if (!isQueryHandler) {
+                continue;
+            }
+            if (!this.isQueryHandler(instance)) {
+                this.logger.warn(`Provider ${metatype.name} is marked @ReportQuery but does not implement BackendReportQueryHandler`);
+                continue;
+            }
+            const handler = instance;
+            if (this.handlers.has(handler.name)) {
+                throw new Error(`Duplicate report query handler registered: "${handler.name}"`);
+            }
+            this.handlers.set(handler.name, handler);
+            this.logger.log(`Registered report query handler: ${handler.name}`);
+        }
+    }
+    has(name) {
+        return this.handlers.has(name);
+    }
+    keys() {
+        return [...this.handlers.keys()];
+    }
+    async run(name, input) {
+        const handler = this.handlers.get(name);
+        if (!handler) {
+            throw new common_1.NotFoundException(`Query "${name}" is not registered. Available queries: ${this.keys().join(', ')}`);
+        }
+        return handler.run(input);
+    }
+    isQueryHandler(value) {
+        const candidate = value;
+        return typeof candidate.name === 'string' && typeof candidate.run === 'function';
+    }
+};
+exports.BackendReportQueryRegistry = BackendReportQueryRegistry;
+exports.BackendReportQueryRegistry = BackendReportQueryRegistry = BackendReportQueryRegistry_1 = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [core_1.DiscoveryService,
+        core_1.Reflector])
+], BackendReportQueryRegistry);
+//#endregion
+//# sourceMappingURL=report-query.registry.js.map

package/report/src/lib/report-query.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-query.registry.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/report/src/lib/report-query.registry.ts"],"names":[],"mappings":";;;;;AAAA,2CAA+F;AAC/F,uCAA2D;AAC3D,2DAA4D;AAG5D,yCAAyC;AAEzC;;;GAGG;AAEI,IAAM,0BAA0B,kCAAhC,MAAM,0BAA0B;IAIrC,YACmB,SAA2B,EAC3B,SAAoB;QADpB,cAAS,GAAT,SAAS,CAAkB;QAC3B,cAAS,GAAT,SAAS,CAAW;QALtB,WAAM,GAAG,IAAI,eAAM,CAAC,4BAA0B,CAAC,IAAI,CAAC,CAAC;QACrD,aAAQ,GAAG,IAAI,GAAG,EAAqC,CAAC;IAKtE,CAAC;IAEJ,sBAAsB;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;QAE/C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;YAC7B,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC9C,SAAS;YACX,CAAC;YAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;YAClC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,SAAS;YACX,CAAC;YAED,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,yCAAqB,EAAE,QAAQ,CAAC,CAAC;YAC3E,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,SAAS;YACX,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACnC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,QAAQ,CAAC,IAAI,0EAA0E,CAAC,CAAC;gBACtH,SAAS;YACX,CAAC;YAED,MAAM,OAAO,GAAG,QAAqC,CAAC;YACtD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpC,MAAM,IAAI,KAAK,CAAC,+CAA+C,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;YAClF,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACzC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,oCAAoC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAY,EAAE,KAAuB;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,0BAAiB,CACzB,UAAU,IAAI,2CAA2C,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClF,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAEO,cAAc,CAAC,KAAa;QAClC,MAAM,SAAS,GAAG,KAAkC,CAAC;QACrD,OAAO,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,SAAS,CAAC,GAAG,KAAK,UAAU,CAAC;IACnF,CAAC;CACF,CAAA;AAjEY,gEAA0B;qCAA1B,0BAA0B;IADtC,IAAA,mBAAU,GAAE;6CAMmB,uBAAgB;QAChB,gBAAS;GAN5B,0BAA0B,CAiEtC;AAED,YAAY"}

package/report/src/lib/report-result-normalizer.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Mirrors mock report viewer normalization for table/chart/pdf layouts.
+ */
+export declare function normalizeTableResult(result: unknown): Record<string, unknown>;
+export declare function normalizeChartResult(result: unknown, mapping?: Record<string, unknown>): Record<string, unknown>;
+export declare function normalizePdfResult(result: unknown): Record<string, unknown>;

package/report/src/lib/report-result-normalizer.js

@@ -0,0 +1,108 @@
+"use strict";
+//#region ---- Report execution result normalization ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeTableResult = normalizeTableResult;
+exports.normalizeChartResult = normalizeChartResult;
+exports.normalizePdfResult = normalizePdfResult;
+/**
+ * Mirrors mock report viewer normalization for table/chart/pdf layouts.
+ */
+function normalizeTableResult(result) {
+    if (Array.isArray(result)) {
+        return {
+            type: 'table',
+            items: result,
+            total: result.length,
+        };
+    }
+    const row = result;
+    if (row && Array.isArray(row.items)) {
+        return {
+            type: 'table',
+            items: row.items,
+            total: Number(row.total ?? row.items.length),
+            ...(row.summary ? { summary: row.summary } : {}),
+        };
+    }
+    return {
+        type: 'table',
+        items: [],
+        total: 0,
+    };
+}
+function normalizeChartResult(result, mapping) {
+    if (result && typeof result === 'object' && !Array.isArray(result) && !('items' in result)) {
+        return {
+            type: 'chart',
+            data: result,
+        };
+    }
+    const rows = Array.isArray(result)
+        ? result
+        : Array.isArray(result?.items)
+            ? (result.items ?? [])
+            : [];
+    const xField = mapping?.['xField'] ?? (rows.length > 0 ? Object.keys(rows[0] ?? {})[0] : 'x');
+    const yFieldsRaw = mapping?.['yFields'];
+    const yFields = Array.isArray(yFieldsRaw)
+        ? yFieldsRaw
+        : yFieldsRaw
+            ? [String(yFieldsRaw)]
+            : rows.length > 0 && Object.keys(rows[0] ?? {}).length > 1
+                ? [Object.keys(rows[0] ?? {})[1]]
+                : ['value'];
+    if (yFields.length === 1) {
+        const chartData = {};
+        for (const row of rows) {
+            const key = String(row[xField] ?? '');
+            if (!key) {
+                continue;
+            }
+            const value = Number(row[yFields[0]] ?? 0);
+            if (Number.isFinite(value)) {
+                chartData[key] = value;
+            }
+        }
+        return { type: 'chart', data: chartData };
+    }
+    const chartData = {};
+    for (const row of rows) {
+        const key = String(row[xField] ?? '');
+        if (!key) {
+            continue;
+        }
+        if (!(key in chartData)) {
+            chartData[key] = {};
+        }
+        const bucket = chartData[key];
+        for (const yf of yFields) {
+            const v = Number(row[yf] ?? 0);
+            if (Number.isFinite(v)) {
+                bucket[yf] = v;
+            }
+        }
+    }
+    return { type: 'chart', data: chartData };
+}
+function normalizePdfResult(result) {
+    if (result && typeof result === 'object') {
+        const row = result;
+        const pdf = row['base64'] != null || row['url'] != null || row['filename'] != null
+            ? row
+            : Array.isArray(row['items']) && row['items'][0]
+                ? row['items'][0]
+                : null;
+        if (pdf) {
+            return {
+                type: 'pdf',
+                url: pdf['url'],
+                base64: pdf['base64'],
+                blob: pdf['blob'],
+                filename: pdf['filename'],
+            };
+        }
+    }
+    return { type: 'pdf', filename: 'report.pdf' };
+}
+//#endregion
+//# sourceMappingURL=report-result-normalizer.js.map

package/report/src/lib/report-result-normalizer.js.map

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

package/report/src/lib/report-summary.util.d.ts

@@ -0,0 +1,9 @@
+export interface ReportSummarySpec {
+    field: string;
+    operation: 'sum' | 'avg' | 'min' | 'max' | 'count';
+    displayIn?: string;
+}
+/**
+ * Computes server-side report footer totals over the full filtered dataset (before pagination).
+ */
+export declare function computeReportFooterSummary(rows: Record<string, unknown>[], summaryConfig: ReportSummarySpec[] | undefined): Record<string, number | null> | undefined;

package/report/src/lib/report-summary.util.js

@@ -0,0 +1,56 @@
+"use strict";
+//#region ---- Report footer summary ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeReportFooterSummary = computeReportFooterSummary;
+/**
+ * Computes server-side report footer totals over the full filtered dataset (before pagination).
+ */
+function computeReportFooterSummary(rows, summaryConfig) {
+    const specs = summaryConfig?.filter((s) => s.displayIn === 'reportFooter') ?? [];
+    if (specs.length === 0) {
+        return undefined;
+    }
+    const result = {};
+    for (const spec of specs) {
+        result[spec.field] = computeSummaryOperation(rows, spec.field, spec.operation);
+    }
+    return result;
+}
+function computeSummaryOperation(rows, field, operation) {
+    if (operation === 'count') {
+        return rows.filter((row) => row[field] != null && row[field] !== '').length;
+    }
+    const numbers = rows
+        .map((row) => toNumber(row[field]))
+        .filter((n) => n !== null);
+    if (numbers.length === 0) {
+        return null;
+    }
+    switch (operation) {
+        case 'sum':
+            return roundDecimal(numbers.reduce((acc, n) => acc + n, 0));
+        case 'avg':
+            return roundDecimal(numbers.reduce((acc, n) => acc + n, 0) / numbers.length);
+        case 'min':
+            return roundDecimal(Math.min(...numbers));
+        case 'max':
+            return roundDecimal(Math.max(...numbers));
+        default:
+            return null;
+    }
+}
+function roundDecimal(value, decimals = 2) {
+    return Number(value.toFixed(decimals));
+}
+function toNumber(value) {
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        return value;
+    }
+    if (typeof value === 'string' && value.trim().length > 0) {
+        const parsed = Number(value);
+        return Number.isFinite(parsed) ? parsed : null;
+    }
+    return null;
+}
+//#endregion
+//# sourceMappingURL=report-summary.util.js.map

package/report/src/lib/report-summary.util.js.map

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