@neohm/nestend 6.4.0 → 6.5.0

package/dist/report/types/report.types.d.ts

@@ -0,0 +1,71 @@
+import { FilterValueTypeEnum } from '../../common/enums/filter.value.type.enum';
+import { ReportParameterType } from '../enums/report.default.enum';
+import { SqlRow } from '../../common/types/sql.types';
+import { ReportDetailEntity } from '../entities/report.detail.entity';
+import { TenantReportDetailEntity } from '../entities/tenant.report.detail.entity';
+import { TenantReportEntity } from '../entities/tenant.report.entity';
+export interface ReportColumn {
+    identifier: string;
+    name?: string;
+    type?: FilterValueTypeEnum;
+    searchable?: boolean;
+}
+export interface ReportParameterDefinition {
+    name: string;
+    label?: string;
+    type: ReportParameterType;
+    required?: boolean;
+    default?: ReportParameterValue;
+}
+export type ReportParameterValue = string | number | boolean | null;
+export type ReportParameters = Record<string, ReportParameterValue>;
+export interface ResolvedTenantReport {
+    tenantReport: TenantReportDetailEntity;
+    report: ReportDetailEntity;
+    tenantId: string;
+}
+export interface ReportWorkbookSheet {
+    name: string;
+    rows: SqlRow[];
+}
+export interface ExcelWorkbookLike {
+    addWorksheet(name: string): {
+        columns: {
+            header: string;
+            key: string;
+        }[];
+        addRows(rows: unknown[]): void;
+    };
+    xlsx: {
+        writeBuffer(): Promise<ArrayBuffer | Buffer>;
+    };
+}
+export interface ExcelJsLike {
+    Workbook: new () => ExcelWorkbookLike;
+}
+export interface ReportModuleOptions {
+    dataSourceName?: string;
+}
+export interface ReportDetail extends ReportDetailEntity {
+    tenant_count: number;
+}
+export interface ReportAccessFilter {
+    tenantId: string;
+    scopeIds: string[];
+    permissions: string[];
+}
+export interface GeneratedReportDetail extends TenantReportEntity {
+    download_url: string | null;
+}
+export interface TenantReportView {
+    id: string;
+    report_id: string;
+    identifier: string;
+    name: string;
+    description: string;
+    is_generative: boolean;
+    columns: ReportColumn[];
+    parameters: ReportParameterDefinition[];
+    sheets: string[];
+}
+//# sourceMappingURL=report.types.d.ts.map

package/dist/report/types/report.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.types.d.ts","sourceRoot":"","sources":["../../../src/report/types/report.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAGtE,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAGD,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAGD,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAGpE,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAGpE,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,wBAAwB,CAAC;IACvC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAGD,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;QAC1B,OAAO,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC3C,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;KAChC,CAAC;IACF,IAAI,EAAE;QAAE,WAAW,IAAI,OAAO,CAAC,WAAW,GAAG,MAAM,CAAC,CAAA;KAAE,CAAC;CACxD;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,UAAU,iBAAiB,CAAC;CACvC;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAGD,MAAM,WAAW,YAAa,SAAQ,kBAAkB;IACtD,YAAY,EAAE,MAAM,CAAC;CACtB;AAGD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAGD,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAGD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,YAAY,EAAE,CAAC;IAExB,UAAU,EAAE,yBAAyB,EAAE,CAAC;IACxC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB"}

package/dist/report/types/report.types.js

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

package/dist/report/types/report.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.types.js","sourceRoot":"","sources":["../../../src/report/types/report.types.ts"],"names":[],"mappings":""}

package/dist/report/utilities/report.catalogue.d.ts

@@ -0,0 +1,6 @@
+import { EntityManager } from 'typeorm';
+import type { ReportDetail } from '../types/report.types';
+export declare class ReportCatalogue {
+    static detail(manager: EntityManager, reportId: string): Promise<ReportDetail>;
+}
+//# sourceMappingURL=report.catalogue.d.ts.map

package/dist/report/utilities/report.catalogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.catalogue.d.ts","sourceRoot":"","sources":["../../../src/report/utilities/report.catalogue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAKxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,qBAAa,eAAe;WAEb,MAAM,CACjB,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC;CAiBzB"}

package/dist/report/utilities/report.catalogue.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportCatalogue = void 0;
+const not_found_exception_1 = require("../../global/exceptions/not.found.exception");
+const report_detail_entity_1 = require("../entities/report.detail.entity");
+const tenant_report_detail_entity_1 = require("../entities/tenant.report.detail.entity");
+const report_default_enum_1 = require("../enums/report.default.enum");
+class ReportCatalogue {
+    static async detail(manager, reportId) {
+        const report = await manager.findOne(report_detail_entity_1.ReportDetailEntity, {
+            where: { id: reportId },
+            relations: {
+                script: true,
+                scope: true,
+                permission: true,
+                sheets: { script: true },
+            },
+            order: { sheets: { sort_order: 'ASC', created_at: 'ASC' } },
+        });
+        if (!report)
+            throw new not_found_exception_1.NotFoundException(report_default_enum_1.ReportMessage.NOT_FOUND);
+        const tenant_count = await manager.count(tenant_report_detail_entity_1.TenantReportDetailEntity, {
+            where: { report_id: reportId },
+        });
+        return Object.assign(report, { tenant_count });
+    }
+}
+exports.ReportCatalogue = ReportCatalogue;
+//# sourceMappingURL=report.catalogue.js.map

package/dist/report/utilities/report.catalogue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.catalogue.js","sourceRoot":"","sources":["../../../src/report/utilities/report.catalogue.ts"],"names":[],"mappings":";;;AACA,qFAAgF;AAChF,2EAAsE;AACtE,yFAAmF;AACnF,sEAA6D;AAI7D,MAAa,eAAe;IAE1B,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,OAAsB,EACtB,QAAgB;QAEhB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,yCAAkB,EAAE;YACvD,KAAK,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE;YACvB,SAAS,EAAE;gBACT,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,IAAI;gBACX,UAAU,EAAE,IAAI;gBAChB,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;aACzB;YACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE;SAC5D,CAAC,CAAC;QACH,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,uCAAiB,CAAC,mCAAa,CAAC,SAAS,CAAC,CAAC;QAClE,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,sDAAwB,EAAE;YACjE,KAAK,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE;SAC/B,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;IACjD,CAAC;CACF;AAtBD,0CAsBC"}

package/dist/report/utilities/report.run.parameters.d.ts

@@ -0,0 +1,7 @@
+import { ReportParameterType } from '../enums/report.default.enum';
+import type { ReportParameterDefinition, ReportParameterValue, ReportParameters } from '../types/report.types';
+export declare class ReportRunParameters {
+    static resolve(definitions: ReportParameterDefinition[] | null | undefined, sent: Record<string, unknown> | null | undefined): ReportParameters;
+    static cast(type: ReportParameterType, raw: unknown): ReportParameterValue | undefined;
+}
+//# sourceMappingURL=report.run.parameters.d.ts.map

package/dist/report/utilities/report.run.parameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.run.parameters.d.ts","sourceRoot":"","sources":["../../../src/report/utilities/report.run.parameters.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,mBAAmB,EACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,yBAAyB,EACzB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAS/B,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,OAAO,CACZ,WAAW,EAAE,yBAAyB,EAAE,GAAG,IAAI,GAAG,SAAS,EAC3D,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAC/C,gBAAgB;IAoCnB,MAAM,CAAC,IAAI,CACT,IAAI,EAAE,mBAAmB,EACzB,GAAG,EAAE,OAAO,GACX,oBAAoB,GAAG,SAAS;CAqCpC"}

package/dist/report/utilities/report.run.parameters.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportRunParameters = void 0;
+const bad_request_exception_1 = require("../../global/exceptions/bad.request.exception");
+const report_default_enum_1 = require("../enums/report.default.enum");
+const report_patterns_1 = require("../validators/report.patterns");
+class ReportRunParameters {
+    static resolve(definitions, sent) {
+        const declared = definitions ?? [];
+        const given = sent ?? {};
+        const errors = {};
+        const fail = (name, message) => (errors[`parameters.${name}`] ??= []).push(message);
+        const names = new Set(declared.map((definition) => definition.name));
+        for (const name of Object.keys(given))
+            if (!names.has(name))
+                fail(name, 'is not a parameter of this report');
+        const values = {};
+        for (const definition of declared) {
+            const raw = given[definition.name] !== undefined
+                ? given[definition.name]
+                : definition.default;
+            if (raw === undefined || raw === null || raw === '') {
+                if (definition.required)
+                    fail(definition.name, 'is required');
+                else
+                    values[definition.name] = null;
+                continue;
+            }
+            const value = ReportRunParameters.cast(definition.type, raw);
+            if (value === undefined)
+                fail(definition.name, `must be a ${report_default_enum_1.REPORT_PARAMETER_TYPE_HINTS[definition.type]}`);
+            else
+                values[definition.name] = value;
+        }
+        if (Object.keys(errors).length)
+            throw new bad_request_exception_1.BadRequestException(errors);
+        return values;
+    }
+    static cast(type, raw) {
+        switch (type) {
+            case report_default_enum_1.ReportParameterType.NUMBER: {
+                const number = typeof raw === 'number'
+                    ? raw
+                    : typeof raw === 'string' && raw.trim() !== ''
+                        ? Number(raw)
+                        : NaN;
+                return Number.isFinite(number) ? number : undefined;
+            }
+            case report_default_enum_1.ReportParameterType.BOOLEAN:
+                if (typeof raw === 'boolean')
+                    return raw;
+                return raw === 'true' ? true : raw === 'false' ? false : undefined;
+            case report_default_enum_1.ReportParameterType.DATE: {
+                if (typeof raw !== 'string' || !report_patterns_1.REPORT_DATE_PATTERN.test(raw))
+                    return undefined;
+                const date = new Date(`${raw}T00:00:00Z`);
+                return !isNaN(date.getTime()) && date.toISOString().slice(0, 10) === raw
+                    ? raw
+                    : undefined;
+            }
+            case report_default_enum_1.ReportParameterType.DATETIME: {
+                if (typeof raw !== 'string')
+                    return undefined;
+                const date = new Date(raw);
+                return isNaN(date.getTime()) ? undefined : date.toISOString();
+            }
+            case report_default_enum_1.ReportParameterType.STRING:
+                return typeof raw === 'string' &&
+                    raw.length <= Number(report_default_enum_1.ReportLimit.PARAMETER_VALUE_MAX_LENGTH)
+                    ? raw
+                    : undefined;
+            default:
+                return undefined;
+        }
+    }
+}
+exports.ReportRunParameters = ReportRunParameters;
+//# sourceMappingURL=report.run.parameters.js.map

package/dist/report/utilities/report.run.parameters.js.map

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

package/dist/report/utilities/report.script.d.ts

@@ -0,0 +1,11 @@
+import { SqlService } from '../../common/services/sql.service';
+import { SqlParams } from '../../common/types/sql.types';
+import type { ReportParameters } from '../types/report.types';
+export declare class ReportScript {
+    static rows(script: string): string;
+    static assertTenantNarrowed(sqlService: SqlService, script: string): void;
+    static params(tenantId: string, ...bags: (ReportParameters | null | undefined)[]): SqlParams;
+    static unbound(sqlService: SqlService, script: string, params: SqlParams): string[];
+    static trim(script: string): string;
+}
+//# sourceMappingURL=report.script.d.ts.map

package/dist/report/utilities/report.script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.script.d.ts","sourceRoot":"","sources":["../../../src/report/utilities/report.script.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAGzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,qBAAa,YAAY;IAKvB,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAKnC,MAAM,CAAC,oBAAoB,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAczE,MAAM,CAAC,MAAM,CACX,QAAQ,EAAE,MAAM,EAChB,GAAG,IAAI,EAAE,CAAC,gBAAgB,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAC/C,SAAS;IAOZ,MAAM,CAAC,OAAO,CACZ,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,SAAS,GAChB,MAAM,EAAE;IAMX,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAGpC"}

package/dist/report/utilities/report.script.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportScript = void 0;
+const operation_exception_1 = require("../../global/exceptions/operation.exception");
+const report_default_enum_1 = require("../enums/report.default.enum");
+class ReportScript {
+    static rows(script) {
+        return `select * from (${ReportScript.trim(script)}) ${report_default_enum_1.ReportDefault.ROWS_ALIAS}`;
+    }
+    static assertTenantNarrowed(sqlService, script) {
+        if (!sqlService
+            .getPlaceholders(script)
+            .includes(report_default_enum_1.ReportDefault.TENANT_PLACEHOLDER))
+            throw new operation_exception_1.OperationException(report_default_enum_1.ReportMessage.TENANT_PLACEHOLDER_MISSING);
+    }
+    static params(tenantId, ...bags) {
+        return Object.assign({}, ...bags.map((bag) => bag ?? {}), {
+            [report_default_enum_1.ReportDefault.TENANT_PLACEHOLDER]: tenantId,
+        });
+    }
+    static unbound(sqlService, script, params) {
+        return sqlService
+            .getPlaceholders(script)
+            .filter((name) => !(name in params));
+    }
+    static trim(script) {
+        return script.trim().replace(/;+\s*$/, '');
+    }
+}
+exports.ReportScript = ReportScript;
+//# sourceMappingURL=report.script.js.map

package/dist/report/utilities/report.script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.script.js","sourceRoot":"","sources":["../../../src/report/utilities/report.script.ts"],"names":[],"mappings":";;;AAEA,qFAAiF;AACjF,sEAA4E;AAI5E,MAAa,YAAY;IAKvB,MAAM,CAAC,IAAI,CAAC,MAAc;QACxB,OAAO,kBAAkB,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,mCAAa,CAAC,UAAU,EAAE,CAAC;IACpF,CAAC;IAGD,MAAM,CAAC,oBAAoB,CAAC,UAAsB,EAAE,MAAc;QAChE,IACE,CAAC,UAAU;aACR,eAAe,CAAC,MAAM,CAAC;aACvB,QAAQ,CAAC,mCAAa,CAAC,kBAAkB,CAAC;YAE7C,MAAM,IAAI,wCAAkB,CAAC,mCAAa,CAAC,0BAA0B,CAAC,CAAC;IAC3E,CAAC;IAOD,MAAM,CAAC,MAAM,CACX,QAAgB,EAChB,GAAG,IAA6C;QAEhD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE;YACxD,CAAC,mCAAa,CAAC,kBAAkB,CAAC,EAAE,QAAQ;SAC7C,CAAc,CAAC;IAClB,CAAC;IAGD,MAAM,CAAC,OAAO,CACZ,UAAsB,EACtB,MAAc,EACd,MAAiB;QAEjB,OAAO,UAAU;aACd,eAAe,CAAC,MAAM,CAAC;aACvB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,MAAc;QACxB,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC7C,CAAC;CACF;AA/CD,oCA+CC"}

package/dist/report/utilities/report.workbook.d.ts

@@ -0,0 +1,8 @@
+import type { ReportWorkbookSheet } from '../types/report.types';
+export declare class ReportWorkbook {
+    static build(sheets: ReportWorkbookSheet[]): Promise<Buffer>;
+    static sheetName(name: string): string;
+    private static uniqueName;
+    private static excelJs;
+}
+//# sourceMappingURL=report.workbook.d.ts.map

package/dist/report/utilities/report.workbook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.workbook.d.ts","sourceRoot":"","sources":["../../../src/report/utilities/report.workbook.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAe,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG9E,qBAAa,cAAc;WACZ,KAAK,CAAC,MAAM,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBlE,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQtC,OAAO,CAAC,MAAM,CAAC,UAAU;IAazB,OAAO,CAAC,MAAM,CAAC,OAAO;CAWvB"}

package/dist/report/utilities/report.workbook.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportWorkbook = void 0;
+const operation_exception_1 = require("../../global/exceptions/operation.exception");
+const report_default_enum_1 = require("../enums/report.default.enum");
+const report_patterns_1 = require("../validators/report.patterns");
+class ReportWorkbook {
+    static async build(sheets) {
+        const workbook = new (ReportWorkbook.excelJs().Workbook)();
+        const used = new Set();
+        for (const sheet of sheets) {
+            const worksheet = workbook.addWorksheet(ReportWorkbook.uniqueName(sheet.name, used));
+            const keys = sheet.rows.length ? Object.keys(sheet.rows[0]) : [];
+            worksheet.columns = keys.map((key) => ({ header: key, key }));
+            worksheet.addRows(sheet.rows);
+        }
+        const output = await workbook.xlsx.writeBuffer();
+        return Buffer.isBuffer(output)
+            ? output
+            : Buffer.from(new Uint8Array(output));
+    }
+    static sheetName(name) {
+        const cleaned = name
+            .replace(new RegExp(report_patterns_1.SHEET_NAME_FORBIDDEN.source, 'g'), ' ')
+            .trim()
+            .slice(0, report_default_enum_1.ReportLimit.SHEET_NAME_MAX_LENGTH);
+        return cleaned || 'Sheet';
+    }
+    static uniqueName(name, used) {
+        const base = ReportWorkbook.sheetName(name);
+        let candidate = base;
+        for (let index = 2; used.has(candidate.toLowerCase()); index++) {
+            const suffix = ` (${index})`;
+            candidate =
+                base.slice(0, report_default_enum_1.ReportLimit.SHEET_NAME_MAX_LENGTH - suffix.length) +
+                    suffix;
+        }
+        used.add(candidate.toLowerCase());
+        return candidate;
+    }
+    static excelJs() {
+        try {
+            const mod = require('exceljs');
+            return mod.default ?? mod;
+        }
+        catch {
+            throw new operation_exception_1.OperationException(report_default_enum_1.ReportMessage.EXCELJS_MISSING);
+        }
+    }
+}
+exports.ReportWorkbook = ReportWorkbook;
+//# sourceMappingURL=report.workbook.js.map

package/dist/report/utilities/report.workbook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.workbook.js","sourceRoot":"","sources":["../../../src/report/utilities/report.workbook.ts"],"names":[],"mappings":";;;AAAA,qFAAiF;AACjF,sEAA0E;AAC1E,mEAAqE;AAIrE,MAAa,cAAc;IACzB,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAA6B;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,SAAS,GAAG,QAAQ,CAAC,YAAY,CACrC,cAAc,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAC5C,CAAC;YACF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;YAC9D,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjD,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC5B,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1C,CAAC;IAGD,MAAM,CAAC,SAAS,CAAC,IAAY;QAC3B,MAAM,OAAO,GAAG,IAAI;aACjB,OAAO,CAAC,IAAI,MAAM,CAAC,sCAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC;aAC1D,IAAI,EAAE;aACN,KAAK,CAAC,CAAC,EAAE,iCAAW,CAAC,qBAAqB,CAAC,CAAC;QAC/C,OAAO,OAAO,IAAI,OAAO,CAAC;IAC5B,CAAC;IAEO,MAAM,CAAC,UAAU,CAAC,IAAY,EAAE,IAAiB;QACvD,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,SAAS,GAAG,IAAI,CAAC;QACrB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;YAC/D,MAAM,MAAM,GAAG,KAAK,KAAK,GAAG,CAAC;YAC7B,SAAS;gBACP,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,iCAAW,CAAC,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC;oBAChE,MAAM,CAAC;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;QAClC,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,MAAM,CAAC,OAAO;QACpB,IAAI,CAAC;YAEH,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAE5B,CAAC;YACF,OAAO,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,wCAAkB,CAAC,mCAAa,CAAC,eAAe,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;CACF;AAnDD,wCAmDC"}

package/dist/report/validators/report.patterns.d.ts

@@ -0,0 +1,5 @@
+export declare const REPORT_FIELD_PATTERN: RegExp;
+export declare const SHEET_NAME_FORBIDDEN: RegExp;
+export declare const REPORT_RESERVED_COLUMN_NAMES: readonly string[];
+export declare const REPORT_DATE_PATTERN: RegExp;
+//# sourceMappingURL=report.patterns.d.ts.map

package/dist/report/validators/report.patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.patterns.d.ts","sourceRoot":"","sources":["../../../src/report/validators/report.patterns.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,oBAAoB,QAA4B,CAAC;AAG9D,eAAO,MAAM,oBAAoB,QAAgB,CAAC;AAGlD,eAAO,MAAM,4BAA4B,EAAE,SAAS,MAAM,EAsGzD,CAAC;AAGF,eAAO,MAAM,mBAAmB,QAAwB,CAAC"}

package/dist/report/validators/report.patterns.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REPORT_DATE_PATTERN = exports.REPORT_RESERVED_COLUMN_NAMES = exports.SHEET_NAME_FORBIDDEN = exports.REPORT_FIELD_PATTERN = void 0;
+exports.REPORT_FIELD_PATTERN = /^[a-z_][a-z0-9_]{0,62}$/;
+exports.SHEET_NAME_FORBIDDEN = /[\\/?*[\]:]/;
+exports.REPORT_RESERVED_COLUMN_NAMES = [
+    'all',
+    'analyse',
+    'analyze',
+    'and',
+    'any',
+    'array',
+    'as',
+    'asc',
+    'asymmetric',
+    'authorization',
+    'binary',
+    'both',
+    'case',
+    'cast',
+    'check',
+    'collate',
+    'collation',
+    'column',
+    'concurrently',
+    'constraint',
+    'create',
+    'cross',
+    'current_catalog',
+    'current_date',
+    'current_role',
+    'current_schema',
+    'current_time',
+    'current_timestamp',
+    'current_user',
+    'default',
+    'deferrable',
+    'desc',
+    'distinct',
+    'do',
+    'else',
+    'end',
+    'except',
+    'false',
+    'fetch',
+    'for',
+    'foreign',
+    'freeze',
+    'from',
+    'full',
+    'grant',
+    'group',
+    'having',
+    'ilike',
+    'in',
+    'initially',
+    'inner',
+    'intersect',
+    'into',
+    'is',
+    'isnull',
+    'join',
+    'lateral',
+    'leading',
+    'left',
+    'like',
+    'limit',
+    'localtime',
+    'localtimestamp',
+    'natural',
+    'not',
+    'notnull',
+    'null',
+    'offset',
+    'on',
+    'only',
+    'or',
+    'order',
+    'outer',
+    'overlaps',
+    'placing',
+    'primary',
+    'references',
+    'returning',
+    'right',
+    'select',
+    'session_user',
+    'similar',
+    'some',
+    'symmetric',
+    'system_user',
+    'table',
+    'tablesample',
+    'then',
+    'to',
+    'trailing',
+    'true',
+    'union',
+    'unique',
+    'user',
+    'using',
+    'variadic',
+    'verbose',
+    'when',
+    'where',
+    'window',
+    'with',
+];
+exports.REPORT_DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+//# sourceMappingURL=report.patterns.js.map

package/dist/report/validators/report.patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.patterns.js","sourceRoot":"","sources":["../../../src/report/validators/report.patterns.ts"],"names":[],"mappings":";;;AACa,QAAA,oBAAoB,GAAG,yBAAyB,CAAC;AAGjD,QAAA,oBAAoB,GAAG,aAAa,CAAC;AAGrC,QAAA,4BAA4B,GAAsB;IAC7D,KAAK;IACL,SAAS;IACT,SAAS;IACT,KAAK;IACL,KAAK;IACL,OAAO;IACP,IAAI;IACJ,KAAK;IACL,YAAY;IACZ,eAAe;IACf,QAAQ;IACR,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,SAAS;IACT,WAAW;IACX,QAAQ;IACR,cAAc;IACd,YAAY;IACZ,QAAQ;IACR,OAAO;IACP,iBAAiB;IACjB,cAAc;IACd,cAAc;IACd,gBAAgB;IAChB,cAAc;IACd,mBAAmB;IACnB,cAAc;IACd,SAAS;IACT,YAAY;IACZ,MAAM;IACN,UAAU;IACV,IAAI;IACJ,MAAM;IACN,KAAK;IACL,QAAQ;IACR,OAAO;IACP,OAAO;IACP,KAAK;IACL,SAAS;IACT,QAAQ;IACR,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,QAAQ;IACR,OAAO;IACP,IAAI;IACJ,WAAW;IACX,OAAO;IACP,WAAW;IACX,MAAM;IACN,IAAI;IACJ,QAAQ;IACR,MAAM;IACN,SAAS;IACT,SAAS;IACT,MAAM;IACN,MAAM;IACN,OAAO;IACP,WAAW;IACX,gBAAgB;IAChB,SAAS;IACT,KAAK;IACL,SAAS;IACT,MAAM;IACN,QAAQ;IACR,IAAI;IACJ,MAAM;IACN,IAAI;IACJ,OAAO;IACP,OAAO;IACP,UAAU;IACV,SAAS;IACT,SAAS;IACT,YAAY;IACZ,WAAW;IACX,OAAO;IACP,QAAQ;IACR,cAAc;IACd,SAAS;IACT,MAAM;IACN,WAAW;IACX,aAAa;IACb,OAAO;IACP,aAAa;IACb,MAAM;IACN,IAAI;IACJ,UAAU;IACV,MAAM;IACN,OAAO;IACP,QAAQ;IACR,MAAM;IACN,OAAO;IACP,UAAU;IACV,SAAS;IACT,MAAM;IACN,OAAO;IACP,QAAQ;IACR,MAAM;CACP,CAAC;AAGW,QAAA,mBAAmB,GAAG,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neohm/nestend",
-  "version": "6.4.0",
+  "version": "6.5.0",
   "description": "Reusable NestJS utilities: entities, queue, auth, cache, encryption, migrations and more",
   "author": "Neohm",
   "license": "MIT",
@@ -33,6 +33,7 @@
   },
   "peerDependencies": {
     "@sentry/node": ">=8.0.0",
+    "exceljs": ">=4.4.0",
     "firebase-admin": ">=12.0.0",
     "puppeteer": ">=22.0.0"
   },
@@ -45,6 +46,9 @@
     },
     "puppeteer": {
       "optional": true
+    },
+    "exceljs": {
+      "optional": true
     }
   },
   "dependencies": {
@@ -91,6 +95,7 @@
     "eslint": "^10.9.1",
     "eslint-config-prettier": "^10.0.1",
     "eslint-plugin-prettier": "^5.2.2",
+    "exceljs": "4.4.0",
     "globals": "^16.0.0",
     "jest": "^30.5.1",
     "prettier": "^3.4.2",