@acorex-platform/framework-server 0.0.10

package/domain/providers/src/lib/utils/merge-detail-query.util.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MERGE_DETAIL_QUERY_SCAN_CAP = void 0;
+exports.collectDottedFilterFieldPaths = collectDottedFilterFieldPaths;
+exports.filterFieldUsesMergeDetailPath = filterFieldUsesMergeDetailPath;
+exports.partitionFilterByMergeDetailDataPaths = partitionFilterByMergeDetailDataPaths;
+exports.partitionSortByMergeDetailDataPaths = partitionSortByMergeDetailDataPaths;
+exports.applyPostHydrateQueryReshape = applyPostHydrateQueryReshape;
+exports.buildMergeDetailWideQueryRequest = buildMergeDetailWideQueryRequest;
+const in_memory_query_util_1 = require("./in-memory-query.util");
+//#region ---- Merge-detail query utilities ----
+function collectDottedFilterFieldPaths(filter) {
+    if (!filter) {
+        return [];
+    }
+    if (filter.filters?.length) {
+        const paths = new Set();
+        for (const child of filter.filters) {
+            for (const p of collectDottedFilterFieldPaths(child)) {
+                paths.add(p);
+            }
+        }
+        return [...paths];
+    }
+    const field = filter.field?.trim();
+    if (field?.includes('.')) {
+        return [field];
+    }
+    return [];
+}
+function filterFieldUsesMergeDetailPath(field, dataPaths) {
+    if (!field) {
+        return false;
+    }
+    return dataPaths.some((dp) => field === dp || field.startsWith(`${dp}.`));
+}
+function isLeafFilter(filter) {
+    return !filter.filters?.length;
+}
+function subtreeContainsMergeDetailPath(filter, dataPaths) {
+    if (!filter) {
+        return false;
+    }
+    if (isLeafFilter(filter)) {
+        return filterFieldUsesMergeDetailPath(filter.field ?? undefined, dataPaths);
+    }
+    return (filter.filters ?? []).some((child) => subtreeContainsMergeDetailPath(child, dataPaths));
+}
+function partitionFilterByMergeDetailDataPaths(filter, dataPaths) {
+    if (!filter || !dataPaths.length) {
+        return { preBackend: filter };
+    }
+    if (isLeafFilter(filter)) {
+        if (filterFieldUsesMergeDetailPath(filter.field ?? undefined, dataPaths)) {
+            return { postHydrate: filter };
+        }
+        return { preBackend: filter };
+    }
+    const logic = filter.logic ?? 'and';
+    if (logic === 'or' && subtreeContainsMergeDetailPath(filter, dataPaths)) {
+        return { postHydrate: filter };
+    }
+    const preChildren = [];
+    const postChildren = [];
+    for (const child of filter.filters ?? []) {
+        const split = partitionFilterByMergeDetailDataPaths(child, dataPaths);
+        if (split.preBackend) {
+            preChildren.push(split.preBackend);
+        }
+        if (split.postHydrate) {
+            postChildren.push(split.postHydrate);
+        }
+    }
+    return {
+        preBackend: preChildren.length ? { ...filter, filters: preChildren, logic } : undefined,
+        postHydrate: postChildren.length ? { ...filter, filters: postChildren, logic } : undefined,
+    };
+}
+function partitionSortByMergeDetailDataPaths(sort, dataPaths) {
+    if (!sort?.length || !dataPaths.length) {
+        return { preBackend: sort };
+    }
+    const hasMergeDetailSort = sort.some((s) => filterFieldUsesMergeDetailPath(s.field, dataPaths));
+    if (!hasMergeDetailSort) {
+        return { preBackend: sort };
+    }
+    return { postHydrate: sort };
+}
+exports.MERGE_DETAIL_QUERY_SCAN_CAP = 50_000;
+function applyPostHydrateQueryReshape(result, options) {
+    const rows = Array.isArray(result)
+        ? result
+        : Array.isArray(result?.items)
+            ? result.items
+            : [];
+    let shaped = rows;
+    if (options.postHydrateFilter) {
+        shaped = (0, in_memory_query_util_1.applyFilterArray)(shaped, [options.postHydrateFilter], options.postHydrateFilter.logic ?? 'and');
+    }
+    if (options.postHydrateSort?.length) {
+        shaped = (0, in_memory_query_util_1.applySortArray)(shaped, options.postHydrateSort);
+    }
+    const safeSkip = Math.max(0, options.skip ?? 0);
+    const safeTake = options.take && options.take > 0 ? options.take : shaped.length || 10;
+    return {
+        total: shaped.length,
+        items: shaped.slice(safeSkip, safeSkip + safeTake),
+    };
+}
+function buildMergeDetailWideQueryRequest(request, preBackendFilter) {
+    return {
+        ...request,
+        skip: 0,
+        take: exports.MERGE_DETAIL_QUERY_SCAN_CAP,
+        filter: preBackendFilter,
+    };
+}
+//#endregion
+//# sourceMappingURL=merge-detail-query.util.js.map

package/domain/providers/src/lib/utils/merge-detail-query.util.js.map

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

package/domain/providers/src/lib/utils/parse-related-entity-cascade.util.d.ts

@@ -0,0 +1,16 @@
+import { AXPDomainRelatedEntityDefinition } from '@acorex-platform/framework-server/domain/abstract';
+import { AXPRelationOnDelete } from '@acorex-platform/framework-shared/domain';
+export type RelatedEntityCascadeDirection = 'childList' | 'referencedHostFk' | 'embedded';
+export interface RelatedEntityCascadeRule {
+    hostEntity: string;
+    relatedEntity: string;
+    direction: RelatedEntityCascadeDirection;
+    /** FK field on child (childList) or host (referencedHostFk). */
+    foreignKeyField: string;
+    onDelete: AXPRelationOnDelete;
+}
+/**
+ * Normalizes a host {@link AXPDomainRelatedEntityDefinition} into a cascade rule.
+ * Returns null when the related entity cannot drive persistence cascade (e.g. missing FK).
+ */
+export declare function parseRelatedEntityCascadeRule(hostEntity: string, related: AXPDomainRelatedEntityDefinition): RelatedEntityCascadeRule | null;

package/domain/providers/src/lib/utils/parse-related-entity-cascade.util.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseRelatedEntityCascadeRule = parseRelatedEntityCascadeRule;
+const abstract_1 = require("@acorex-platform/framework-server/domain/abstract");
+const domain_1 = require("@acorex-platform/framework-shared/domain");
+const HOST_ID_CONTEXT_PATTERN = /context\.eval\s*\(\s*["']id["']\s*\)/i;
+const HOST_FIELD_CONTEXT_PATTERN = /context\.eval\s*\(\s*["']([^"']+)["']\s*\)/i;
+/**
+ * Normalizes a host {@link AXPDomainRelatedEntityDefinition} into a cascade rule.
+ * Returns null when the related entity cannot drive persistence cascade (e.g. missing FK).
+ */
+function parseRelatedEntityCascadeRule(hostEntity, related) {
+    const relatedEntity = related.entity?.trim();
+    if (!relatedEntity) {
+        return null;
+    }
+    const strategy = related.persistence?.strategy;
+    const layoutType = related.layout?.type;
+    if (strategy === 'embedded' || (layoutType === 'merge-detail' && strategy !== 'referenced')) {
+        return {
+            hostEntity,
+            relatedEntity,
+            direction: 'embedded',
+            foreignKeyField: '',
+            onDelete: domain_1.AXPRelationOnDelete.NoAction,
+        };
+    }
+    if (strategy === 'referenced' || isReferencedHostFkPattern(related)) {
+        const foreignKeyField = resolveHostForeignKeyField(related);
+        if (!foreignKeyField) {
+            return null;
+        }
+        return {
+            hostEntity,
+            relatedEntity,
+            direction: 'referencedHostFk',
+            foreignKeyField,
+            onDelete: (0, domain_1.resolveRelatedEntityOnDelete)(related.persistence, abstract_1.AXPRelationshipKind.Aggregation),
+        };
+    }
+    const childFk = resolveChildListForeignKeyField(related);
+    if (!childFk) {
+        return null;
+    }
+    return {
+        hostEntity,
+        relatedEntity,
+        direction: 'childList',
+        foreignKeyField: childFk,
+        onDelete: (0, domain_1.resolveRelatedEntityOnDelete)(related.persistence, abstract_1.AXPRelationshipKind.Composition),
+    };
+}
+function isReferencedHostFkPattern(related) {
+    for (const condition of related.conditions ?? []) {
+        const fieldName = condition.name ?? condition.field;
+        if (fieldName !== 'id') {
+            continue;
+        }
+        if (condition.operator?.type !== 'equal') {
+            continue;
+        }
+        const value = String(condition.value ?? '');
+        if (HOST_ID_CONTEXT_PATTERN.test(value)) {
+            continue;
+        }
+        if (HOST_FIELD_CONTEXT_PATTERN.test(value)) {
+            return true;
+        }
+    }
+    return false;
+}
+function resolveHostForeignKeyField(related) {
+    if (related.persistence?.idField?.trim()) {
+        return related.persistence.idField.trim();
+    }
+    if (related.persistence?.dataPath?.trim()) {
+        const segment = related.persistence.dataPath.trim();
+        return segment.endsWith('Id') ? segment : `${segment}Id`;
+    }
+    for (const condition of related.conditions ?? []) {
+        const fieldName = condition.name ?? condition.field;
+        if (fieldName !== 'id' || condition.operator?.type !== 'equal') {
+            continue;
+        }
+        const value = String(condition.value ?? '');
+        const match = value.match(HOST_FIELD_CONTEXT_PATTERN);
+        if (match?.[1] && match[1] !== 'id') {
+            return match[1];
+        }
+    }
+    return null;
+}
+function resolveChildListForeignKeyField(related) {
+    if (related.persistence?.foreignKeyField?.trim()) {
+        return related.persistence.foreignKeyField.trim();
+    }
+    for (const condition of related.conditions ?? []) {
+        const fieldName = condition.name ?? condition.field;
+        if (!fieldName || condition.operator?.type !== 'equal') {
+            continue;
+        }
+        if (HOST_ID_CONTEXT_PATTERN.test(String(condition.value ?? ''))) {
+            return fieldName;
+        }
+    }
+    return null;
+}
+//#endregion
+//# sourceMappingURL=parse-related-entity-cascade.util.js.map

package/domain/providers/src/lib/utils/parse-related-entity-cascade.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-related-entity-cascade.util.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/domain/providers/src/lib/utils/parse-related-entity-cascade.util.ts"],"names":[],"mappings":";;AA6BA,sEAuDC;AApFD,gFAG2D;AAC3D,qEAGkD;AAelD,MAAM,uBAAuB,GAAG,uCAAuC,CAAC;AACxE,MAAM,0BAA0B,GAAG,6CAA6C,CAAC;AAEjF;;;GAGG;AACH,SAAgB,6BAA6B,CAC3C,UAAkB,EAClB,OAAyC;IAEzC,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IAC7C,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC;IAC/C,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;IAExC,IAAI,QAAQ,KAAK,UAAU,IAAI,CAAC,UAAU,KAAK,cAAc,IAAI,QAAQ,KAAK,YAAY,CAAC,EAAE,CAAC;QAC5F,OAAO;YACL,UAAU;YACV,aAAa;YACb,SAAS,EAAE,UAAU;YACrB,eAAe,EAAE,EAAE;YACnB,QAAQ,EAAE,4BAAmB,CAAC,QAAQ;SACvC,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,KAAK,YAAY,IAAI,yBAAyB,CAAC,OAAO,CAAC,EAAE,CAAC;QACpE,MAAM,eAAe,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;QAC5D,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO;YACL,UAAU;YACV,aAAa;YACb,SAAS,EAAE,kBAAkB;YAC7B,eAAe;YACf,QAAQ,EAAE,IAAA,qCAA4B,EACpC,OAAO,CAAC,WAAW,EACnB,8BAAmB,CAAC,WAAW,CAChC;SACF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,+BAA+B,CAAC,OAAO,CAAC,CAAC;IACzD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,UAAU;QACV,aAAa;QACb,SAAS,EAAE,WAAW;QACtB,eAAe,EAAE,OAAO;QACxB,QAAQ,EAAE,IAAA,qCAA4B,EACpC,OAAO,CAAC,WAAW,EACnB,8BAAmB,CAAC,WAAW,CAChC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAAC,OAAyC;IAC1E,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;QACjD,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,KAAK,CAAC;QACpD,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,SAAS;QACX,CAAC;QAED,IAAI,SAAS,CAAC,QAAQ,EAAE,IAAI,KAAK,OAAO,EAAE,CAAC;YACzC,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5C,IAAI,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACxC,SAAS;QACX,CAAC;QAED,IAAI,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,0BAA0B,CAAC,OAAyC;IAC3E,IAAI,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QACzC,OAAO,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED,IAAI,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpD,OAAO,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC;IAC3D,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;QACjD,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,KAAK,CAAC;QACpD,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,QAAQ,EAAE,IAAI,KAAK,OAAO,EAAE,CAAC;YAC/D,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACtD,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACpC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,+BAA+B,CAAC,OAAyC;IAChF,IAAI,OAAO,CAAC,WAAW,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,CAAC;QACjD,OAAO,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;IACpD,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC;QACjD,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,KAAK,CAAC;QACpD,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,QAAQ,EAAE,IAAI,KAAK,OAAO,EAAE,CAAC;YACvD,SAAS;QACX,CAAC;QAED,IAAI,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YAChE,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,YAAY"}

package/domain/providers/src/lib/utils/policy-field.util.d.ts

@@ -0,0 +1,3 @@
+export declare function maskPolicyValue(value: unknown): unknown;
+export declare function removePolicyFields(obj: Record<string, unknown>, paths: string[]): void;
+export declare function setMaskedPolicyFields(obj: Record<string, unknown>, paths: string[]): void;

package/domain/providers/src/lib/utils/policy-field.util.js

@@ -0,0 +1,95 @@
+"use strict";
+//#region ---- Policy field transforms ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.maskPolicyValue = maskPolicyValue;
+exports.removePolicyFields = removePolicyFields;
+exports.setMaskedPolicyFields = setMaskedPolicyFields;
+function maskPolicyValue(value) {
+    if (value == null) {
+        return value;
+    }
+    const str = String(value);
+    if (str.length <= 4) {
+        return '****';
+    }
+    return `${'*'.repeat(Math.max(0, str.length - 4))}${str.slice(-4)}`;
+}
+function removePolicyFields(obj, paths) {
+    if (!obj || !paths?.length) {
+        return;
+    }
+    const deleteByPath = (target, path) => {
+        const parts = path.split('.');
+        let cursor = target;
+        for (let i = 0; i < parts.length - 1; i++) {
+            const key = parts[i];
+            if (cursor == null || typeof cursor !== 'object') {
+                return;
+            }
+            cursor = cursor[key];
+        }
+        const lastKey = parts[parts.length - 1];
+        if (cursor && typeof cursor === 'object' && Object.prototype.hasOwnProperty.call(cursor, lastKey)) {
+            delete cursor[lastKey];
+        }
+    };
+    if (paths.includes('*')) {
+        for (const key of Object.keys(obj)) {
+            delete obj[key];
+        }
+    }
+    for (const p of paths) {
+        if (!p || p === '*') {
+            continue;
+        }
+        if (p.includes('.')) {
+            deleteByPath(obj, p);
+        }
+        else if (Object.prototype.hasOwnProperty.call(obj, p)) {
+            delete obj[p];
+        }
+    }
+}
+function setMaskedPolicyFields(obj, paths) {
+    if (!obj || !paths?.length) {
+        return;
+    }
+    const maskByPath = (target, path) => {
+        const parts = path.split('.');
+        let cursor = target;
+        for (let i = 0; i < parts.length - 1; i++) {
+            const key = parts[i];
+            if (cursor == null || typeof cursor !== 'object') {
+                return;
+            }
+            cursor = cursor[key];
+        }
+        const lastKey = parts[parts.length - 1];
+        if (cursor && typeof cursor === 'object' && Object.prototype.hasOwnProperty.call(cursor, lastKey)) {
+            cursor[lastKey] = maskPolicyValue(cursor[lastKey]);
+        }
+    };
+    if (paths.includes('*')) {
+        for (const key of Object.keys(obj)) {
+            if (Object.prototype.hasOwnProperty.call(obj, key)) {
+                const val = obj[key];
+                if (val == null || typeof val !== 'object') {
+                    obj[key] = maskPolicyValue(val);
+                }
+            }
+        }
+    }
+    for (const p of paths) {
+        if (!p || p === '*') {
+            continue;
+        }
+        if (p.includes('.')) {
+            maskByPath(obj, p);
+        }
+        else if (Object.prototype.hasOwnProperty.call(obj, p)) {
+            obj[p] = maskPolicyValue(obj[p]);
+        }
+    }
+}
+//#endregion
+//# sourceMappingURL=policy-field.util.js.map

package/domain/providers/src/lib/utils/policy-field.util.js.map

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

package/domain/providers/src/lib/validators/domain-entity.validator.d.ts

@@ -0,0 +1,32 @@
+import type { AXPQueryRequest, EntityStoragePagedResponse } from '@acorex-platform/framework-server/jql/abstract';
+import { DomainDefinitionLoader } from '@acorex-platform/framework-server/domain/abstract';
+export interface DomainEntityValidationBackend {
+    getOne(entityName: string, id: string): Promise<unknown>;
+    query(entityName: string, request: AXPQueryRequest): Promise<EntityStoragePagedResponse>;
+}
+export interface DomainEntityMutationValidationOptions {
+    op: 'create' | 'update';
+    entityName: string;
+    data: Record<string, unknown>;
+    backend: DomainEntityValidationBackend;
+    id?: string;
+    /** When true, missing entity definitions are ignored (middleware REST path). */
+    skipWhenDefinitionMissing?: boolean;
+}
+export declare class DomainEntityValidationError extends Error {
+    readonly errors: string[];
+    readonly code: string;
+    readonly status: number;
+    constructor(message: string, errors?: string[], code?: string, status?: number);
+}
+export declare class DomainEntityValidator {
+    private readonly loader;
+    private validationCatalog;
+    constructor(loader: DomainDefinitionLoader | null);
+    /** Validates seed/create payloads against domain entity definitions. */
+    validateForCreate(entityName: string, data: Record<string, unknown>, backend: DomainEntityValidationBackend): Promise<void>;
+    /** Validates REST create/update payloads against domain entity definitions. */
+    validateMutation(options: DomainEntityMutationValidationOptions): Promise<void>;
+    private resolveEntityDefinition;
+    private loadValidationCatalog;
+}