@acorex-platform/framework-server 0.0.10 → 0.0.14

package/rule-engine/src/lib/rule-engine.service.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AXPRuleEngine = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const rule_engine_1 = require("@acorex-platform/framework-shared/rule-engine");
+const action_executor_1 = require("./action-executor");
+const condition_evaluator_1 = require("./condition-evaluator");
+const decision_table_evaluator_1 = require("./decision-table.evaluator");
+const fact_path_util_1 = require("./fact-path.util");
+const rule_set_registry_service_1 = require("./rule-set-registry.service");
+//#region ---- Rule engine ----
+let AXPRuleEngine = class AXPRuleEngine {
+    constructor(registry) {
+        this.registry = registry;
+        this.customActions = new Map();
+    }
+    registerActionProvider(provider) {
+        this.customActions.set(provider.name, provider);
+    }
+    async evaluateById(ruleSetId, facts, options = {}) {
+        const ruleSet = await this.registry.get(ruleSetId);
+        return this.evaluate(ruleSet, facts, options);
+    }
+    async evaluate(ruleSet, facts, options = {}) {
+        const status = ruleSet.status ?? 'published';
+        if (status !== 'published' && !options.allowDraft) {
+            throw new rule_engine_1.AXPRuleSetNotPublishedError(ruleSet.id, status);
+        }
+        if (ruleSet.enabled === false) {
+            const skipped = emptyPassResult(ruleSet, facts, ['RuleSet disabled']);
+            if (options.onAfterEvaluate) {
+                await options.onAfterEvaluate(skipped);
+            }
+            return skipped;
+        }
+        if (ruleSet.featureFlag) {
+            const flagValue = options.featureFlags?.[ruleSet.featureFlag];
+            if (flagValue === false) {
+                const skipped = emptyPassResult(ruleSet, facts, [
+                    `Feature flag ${ruleSet.featureFlag} disabled`,
+                ]);
+                if (options.onAfterEvaluate) {
+                    await options.onAfterEvaluate(skipped);
+                }
+                return skipped;
+            }
+        }
+        const mode = options.mode ?? 'validate';
+        const dryRun = options.dryRun ?? mode === 'validate';
+        const factsOut = structuredCloneSafe(facts);
+        const matchedRuleIds = [];
+        const matchedTableRowIds = [];
+        const warnings = [];
+        for (const table of ruleSet.tables ?? []) {
+            warnings.push(...(0, decision_table_evaluator_1.validateDecisionTable)(table));
+            const matches = (0, decision_table_evaluator_1.evaluateDecisionTable)(table, factsOut);
+            for (const match of matches) {
+                matchedTableRowIds.push(match.rowId);
+                for (const [key, value] of Object.entries(match.outputs)) {
+                    (0, fact_path_util_1.setFactPath)(factsOut, key, value);
+                }
+            }
+        }
+        const rules = [...ruleSet.rules]
+            .filter((r) => r.enabled !== false)
+            .sort((a, b) => {
+            const pa = (a.priority ?? 0) * 1000 + (a.salience ?? 0);
+            const pb = (b.priority ?? 0) * 1000 + (b.salience ?? 0);
+            return pb - pa;
+        });
+        const activationFired = new Set();
+        const state = {
+            findings: [],
+            facts: factsOut,
+            denied: false,
+            warnings,
+            firedActions: [],
+        };
+        for (const rule of rules) {
+            if (state.denied) {
+                break;
+            }
+            if (rule.activationGroup && activationFired.has(rule.activationGroup)) {
+                continue;
+            }
+            const matched = await (0, condition_evaluator_1.evaluateCondition)(rule.when, factsOut, rule, options);
+            if (!matched) {
+                continue;
+            }
+            matchedRuleIds.push(rule.id);
+            if (rule.activationGroup) {
+                activationFired.add(rule.activationGroup);
+            }
+            await (0, action_executor_1.executeActions)(rule.then, rule.id, rule.severity, state, {
+                dryRun,
+                mode,
+                customProviders: this.customActions,
+            });
+        }
+        const result = buildResult(ruleSet, state, matchedRuleIds, matchedTableRowIds);
+        if (options.onAfterEvaluate) {
+            await options.onAfterEvaluate(result);
+        }
+        return result;
+    }
+};
+exports.AXPRuleEngine = AXPRuleEngine;
+exports.AXPRuleEngine = AXPRuleEngine = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [rule_set_registry_service_1.RuleSetRegistryService])
+], AXPRuleEngine);
+function emptyPassResult(ruleSet, facts, warnings) {
+    return {
+        passed: true,
+        findings: [],
+        actions: [],
+        factsOut: structuredCloneSafe(facts),
+        matchedRuleIds: [],
+        matchedTableRowIds: [],
+        denied: false,
+        warnings,
+        summary: { critical: 0, major: 0, minor: 0, info: 0 },
+        ruleSetId: ruleSet.id,
+        ruleSetVersion: ruleSet.version,
+    };
+}
+function buildResult(ruleSet, state, matchedRuleIds, matchedTableRowIds) {
+    const summary = summarize(state.findings);
+    const hasBlocking = state.denied || summary.critical > 0 || summary.major > 0;
+    return {
+        passed: !hasBlocking,
+        findings: state.findings,
+        actions: state.firedActions,
+        factsOut: state.facts,
+        matchedRuleIds,
+        matchedTableRowIds,
+        denied: state.denied,
+        warnings: state.warnings,
+        summary,
+        ruleSetId: ruleSet.id,
+        ruleSetVersion: ruleSet.version,
+    };
+}
+function summarize(findings) {
+    const summary = { critical: 0, major: 0, minor: 0, info: 0 };
+    for (const f of findings) {
+        const key = f.severity;
+        if (key in summary) {
+            summary[key] += 1;
+        }
+    }
+    return summary;
+}
+function structuredCloneSafe(value) {
+    if (typeof structuredClone === 'function') {
+        return structuredClone(value);
+    }
+    return JSON.parse(JSON.stringify(value));
+}
+//#endregion
+//# sourceMappingURL=rule-engine.service.js.map

package/rule-engine/src/lib/rule-engine.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-engine.service.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/rule-engine/src/lib/rule-engine.service.ts"],"names":[],"mappings":";;;;AAAA,2CAA4C;AAC5C,+EASuD;AACvD,uDAA8E;AAC9E,+DAA0D;AAC1D,yEAA0F;AAC1F,qDAA+C;AAC/C,2EAAqE;AAErE,+BAA+B;AAGxB,IAAM,aAAa,GAAnB,MAAM,aAAa;IAGxB,YAA6B,QAAgC;QAAhC,aAAQ,GAAR,QAAQ,CAAwB;QAF5C,kBAAa,GAAG,IAAI,GAAG,EAAuC,CAAC;IAEhB,CAAC;IAEjE,sBAAsB,CAAC,QAAqC;QAC1D,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,SAAiB,EACjB,KAAiB,EACjB,UAAkC,EAAE;QAEpC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,OAAmB,EACnB,KAAiB,EACjB,UAAkC,EAAE;QAEpC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,WAAW,CAAC;QAC7C,IAAI,MAAM,KAAK,WAAW,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YAClD,MAAM,IAAI,yCAA2B,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC;YACtE,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;gBAC5B,MAAM,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YACzC,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,MAAM,SAAS,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAC9D,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;gBACxB,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE;oBAC9C,gBAAgB,OAAO,CAAC,WAAW,WAAW;iBAC/C,CAAC,CAAC;gBACH,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;oBAC5B,MAAM,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;gBACzC,CAAC;gBACD,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,UAAU,CAAC;QACxC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,KAAK,UAAU,CAAC;QACrD,MAAM,QAAQ,GAAe,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACxD,MAAM,cAAc,GAAa,EAAE,CAAC;QACpC,MAAM,kBAAkB,GAAa,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;YACzC,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAA,gDAAqB,EAAC,KAAK,CAAC,CAAC,CAAC;YAC/C,MAAM,OAAO,GAAG,IAAA,gDAAqB,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YACvD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACrC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;oBACzD,IAAA,4BAAW,EAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;gBACpC,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;aAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC;aAClC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACb,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;YACxD,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;YACxD,OAAO,EAAE,GAAG,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;QAEL,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;QAC1C,MAAM,KAAK,GAAyB;YAClC,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,QAAQ;YACf,MAAM,EAAE,KAAK;YACb,QAAQ;YACR,YAAY,EAAE,EAAE;SACjB,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,MAAM;YACR,CAAC;YACD,IAAI,IAAI,CAAC,eAAe,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;gBACtE,SAAS;YACX,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,IAAA,uCAAiB,EAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YAC5E,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,SAAS;YACX,CAAC;YAED,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC7B,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBACzB,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC5C,CAAC;YAED,MAAM,IAAA,gCAAc,EAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE;gBAC7D,MAAM;gBACN,IAAI;gBACJ,eAAe,EAAE,IAAI,CAAC,aAAa;aACpC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,kBAAkB,CAAC,CAAC;QAC/E,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC5B,MAAM,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAA;AAnHY,sCAAa;wBAAb,aAAa;IADzB,IAAA,mBAAU,GAAE;6CAI4B,kDAAsB;GAHlD,aAAa,CAmHzB;AAED,SAAS,eAAe,CACtB,OAAmB,EACnB,KAAiB,EACjB,QAAkB;IAElB,OAAO;QACL,MAAM,EAAE,IAAI;QACZ,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,mBAAmB,CAAC,KAAK,CAAC;QACpC,cAAc,EAAE,EAAE;QAClB,kBAAkB,EAAE,EAAE;QACtB,MAAM,EAAE,KAAK;QACb,QAAQ;QACR,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;QACrD,SAAS,EAAE,OAAO,CAAC,EAAE;QACrB,cAAc,EAAE,OAAO,CAAC,OAAO;KAChC,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAClB,OAAmB,EACnB,KAA2B,EAC3B,cAAwB,EACxB,kBAA4B;IAE5B,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,QAAQ,GAAG,CAAC,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC;IAC9E,OAAO;QACL,MAAM,EAAE,CAAC,WAAW;QACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,YAAY;QAC3B,QAAQ,EAAE,KAAK,CAAC,KAAK;QACrB,cAAc;QACd,kBAAkB;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO;QACP,SAAS,EAAE,OAAO,CAAC,EAAE;QACrB,cAAc,EAAE,OAAO,CAAC,OAAO;KAChC,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,QAA0B;IAC3C,MAAM,OAAO,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC7D,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,CAAC,CAAC,QAA2B,CAAC;QAC1C,IAAI,GAAG,IAAI,OAAO,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,mBAAmB,CAAI,KAAQ;IACtC,IAAI,OAAO,eAAe,KAAK,UAAU,EAAE,CAAC;QAC1C,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAM,CAAC;AAChD,CAAC;AAED,YAAY"}

package/rule-engine/src/lib/rule-set-registry.service.d.ts

@@ -0,0 +1,9 @@
+import { type AXPRuleSet } from '@acorex-platform/framework-shared/rule-engine';
+export declare class RuleSetRegistryService {
+    private readonly packs;
+    register(ruleSet: AXPRuleSet): void;
+    getSync(idOrName: string): AXPRuleSet;
+    get(idOrName: string): Promise<AXPRuleSet>;
+    list(): AXPRuleSet[];
+}
+//# sourceMappingURL=rule-set-registry.service.d.ts.map

package/rule-engine/src/lib/rule-set-registry.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-set-registry.service.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/rule-engine/src/lib/rule-set-registry.service.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,UAAU,EAChB,MAAM,+CAA+C,CAAC;AAIvD,qBACa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IAEvD,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAKnC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU;IAQ/B,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAIhD,IAAI,IAAI,UAAU,EAAE;CAYrB"}

package/rule-engine/src/lib/rule-set-registry.service.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RuleSetRegistryService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const rule_engine_1 = require("@acorex-platform/framework-shared/rule-engine");
+//#region ---- RuleSet registry ----
+let RuleSetRegistryService = class RuleSetRegistryService {
+    constructor() {
+        this.packs = new Map();
+    }
+    register(ruleSet) {
+        this.packs.set(ruleSet.id, structuredCloneSafe(ruleSet));
+        this.packs.set(ruleSet.name, structuredCloneSafe(ruleSet));
+    }
+    getSync(idOrName) {
+        const found = this.packs.get(idOrName);
+        if (!found) {
+            throw new rule_engine_1.AXPRuleSetNotFoundError(idOrName);
+        }
+        return structuredCloneSafe(found);
+    }
+    async get(idOrName) {
+        return this.getSync(idOrName);
+    }
+    list() {
+        const seen = new Set();
+        const result = [];
+        for (const pack of this.packs.values()) {
+            if (seen.has(pack.id)) {
+                continue;
+            }
+            seen.add(pack.id);
+            result.push(structuredCloneSafe(pack));
+        }
+        return result;
+    }
+};
+exports.RuleSetRegistryService = RuleSetRegistryService;
+exports.RuleSetRegistryService = RuleSetRegistryService = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], RuleSetRegistryService);
+function structuredCloneSafe(value) {
+    if (typeof structuredClone === 'function') {
+        return structuredClone(value);
+    }
+    return JSON.parse(JSON.stringify(value));
+}
+//#endregion
+//# sourceMappingURL=rule-set-registry.service.js.map

package/rule-engine/src/lib/rule-set-registry.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-set-registry.service.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/rule-engine/src/lib/rule-set-registry.service.ts"],"names":[],"mappings":";;;;AAAA,2CAA4C;AAC5C,+EAGuD;AAEvD,oCAAoC;AAG7B,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IAA5B;QACY,UAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IA+BzD,CAAC;IA7BC,QAAQ,CAAC,OAAmB;QAC1B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;QACzD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,CAAC,QAAgB;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,qCAAuB,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,QAAgB;QACxB,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,IAAI;QACF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,MAAM,MAAM,GAAiB,EAAE,CAAC;QAChC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;gBACtB,SAAS;YACX,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAA;AAhCY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,mBAAU,GAAE;GACA,sBAAsB,CAgClC;AAED,SAAS,mBAAmB,CAAI,KAAQ;IACtC,IAAI,OAAO,eAAe,KAAK,UAAU,EAAE,CAAC;QAC1C,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAM,CAAC;AAChD,CAAC;AAED,YAAY"}

package/rule-engine/src/lib/rule-set-yaml.util.d.ts

@@ -0,0 +1,11 @@
+import type { AXPRuleSet } from '@acorex-platform/framework-shared/rule-engine';
+/** Export RuleSet as indented JSON (YAML-compatible subset for tooling). */
+export declare function exportRuleSetJson(ruleSet: AXPRuleSet): string;
+export declare function importRuleSetJson(raw: string): AXPRuleSet;
+/**
+ * Minimal YAML subset: if content starts with `{` treat as JSON;
+ * otherwise attempt a very small key: value pack (not a full YAML parser).
+ * Prefer JSON for interchange until a YAML dependency is added.
+ */
+export declare function importRuleSetDocument(raw: string): AXPRuleSet;
+//# sourceMappingURL=rule-set-yaml.util.d.ts.map

package/rule-engine/src/lib/rule-set-yaml.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-set-yaml.util.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/rule-engine/src/lib/rule-set-yaml.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+CAA+C,CAAC;AAIhF,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAE7D;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAMzD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAQ7D"}

package/rule-engine/src/lib/rule-set-yaml.util.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exportRuleSetJson = exportRuleSetJson;
+exports.importRuleSetJson = importRuleSetJson;
+exports.importRuleSetDocument = importRuleSetDocument;
+//#region ---- YAML / JSON pack import-export ----
+/** Export RuleSet as indented JSON (YAML-compatible subset for tooling). */
+function exportRuleSetJson(ruleSet) {
+    return `${JSON.stringify(ruleSet, null, 2)}\n`;
+}
+function importRuleSetJson(raw) {
+    const parsed = JSON.parse(raw);
+    if (!parsed?.id || !parsed?.name || !Array.isArray(parsed.rules)) {
+        throw new Error('Invalid RuleSet JSON: id, name, and rules are required');
+    }
+    return parsed;
+}
+/**
+ * Minimal YAML subset: if content starts with `{` treat as JSON;
+ * otherwise attempt a very small key: value pack (not a full YAML parser).
+ * Prefer JSON for interchange until a YAML dependency is added.
+ */
+function importRuleSetDocument(raw) {
+    const trimmed = raw.trim();
+    if (trimmed.startsWith('{')) {
+        return importRuleSetJson(trimmed);
+    }
+    // Strip simple YAML document marker and parse as JSON after converting is out of scope;
+    // require JSON for now with clear error.
+    throw new Error('YAML import requires JSON document (start with `{`). Full YAML parser deferred.');
+}
+//#endregion
+//# sourceMappingURL=rule-set-yaml.util.js.map

package/rule-engine/src/lib/rule-set-yaml.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-set-yaml.util.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/rule-engine/src/lib/rule-set-yaml.util.ts"],"names":[],"mappings":";;AAKA,8CAEC;AAED,8CAMC;AAOD,sDAQC;AA5BD,kDAAkD;AAElD,4EAA4E;AAC5E,SAAgB,iBAAiB,CAAC,OAAmB;IACnD,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC;AAED,SAAgB,iBAAiB,CAAC,GAAW;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;IAC7C,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,SAAgB,qBAAqB,CAAC,GAAW;IAC/C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IACD,wFAAwF;IACxF,yCAAyC;IACzC,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;AACrG,CAAC;AAED,YAAY"}

package/rule-engine/src/lib/rule-test-harness.d.ts

@@ -0,0 +1,14 @@
+import type { AXPFactBag, AXPRuleDecisionResult, AXPRuleSet } from '@acorex-platform/framework-shared/rule-engine';
+export interface RuleHarnessCase {
+    name: string;
+    facts: AXPFactBag;
+    expectPassed: boolean;
+    expectCodes?: string[];
+}
+export declare function runRuleHarness(ruleSet: AXPRuleSet, cases: RuleHarnessCase[]): Promise<{
+    name: string;
+    ok: boolean;
+    result: AXPRuleDecisionResult;
+    error?: string;
+}[]>;
+//# sourceMappingURL=rule-test-harness.d.ts.map

package/rule-engine/src/lib/rule-test-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-test-harness.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/rule-engine/src/lib/rule-test-harness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,qBAAqB,EACrB,UAAU,EACX,MAAM,+CAA+C,CAAC;AAMvD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,eAAe,EAAE,GACvB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,qBAAqB,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CA0BzF"}

package/rule-engine/src/lib/rule-test-harness.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runRuleHarness = runRuleHarness;
+const rule_engine_service_1 = require("./rule-engine.service");
+const rule_set_registry_service_1 = require("./rule-set-registry.service");
+async function runRuleHarness(ruleSet, cases) {
+    const registry = new rule_set_registry_service_1.RuleSetRegistryService();
+    registry.register(ruleSet);
+    const engine = new rule_engine_service_1.AXPRuleEngine(registry);
+    const out = [];
+    for (const c of cases) {
+        const result = await engine.evaluate(ruleSet, c.facts, { allowDraft: true });
+        const codes = result.findings.map((f) => f.code);
+        let ok = result.passed === c.expectPassed;
+        let error;
+        if (ok && c.expectCodes) {
+            for (const code of c.expectCodes) {
+                if (!codes.includes(code)) {
+                    ok = false;
+                    error = `missing finding code ${code}`;
+                    break;
+                }
+            }
+        }
+        if (!ok && !error) {
+            error = `expected passed=${c.expectPassed}, got ${result.passed}`;
+        }
+        out.push({ name: c.name, ok, result, error });
+    }
+    return out;
+}
+//#endregion
+//# sourceMappingURL=rule-test-harness.js.map

package/rule-engine/src/lib/rule-test-harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-test-harness.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/rule-engine/src/lib/rule-test-harness.ts"],"names":[],"mappings":";;AAiBA,wCA6BC;AAzCD,+DAAsD;AACtD,2EAAqE;AAW9D,KAAK,UAAU,cAAc,CAClC,OAAmB,EACnB,KAAwB;IAExB,MAAM,QAAQ,GAAG,IAAI,kDAAsB,EAAE,CAAC;IAC9C,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC3B,MAAM,MAAM,GAAG,IAAI,mCAAa,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAmF,EAAE,CAAC;IAE/F,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7E,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,EAAE,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,YAAY,CAAC;QAC1C,IAAI,KAAyB,CAAC;QAC9B,IAAI,EAAE,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YACxB,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;gBACjC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC1B,EAAE,GAAG,KAAK,CAAC;oBACX,KAAK,GAAG,wBAAwB,IAAI,EAAE,CAAC;oBACvC,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;YAClB,KAAK,GAAG,mBAAmB,CAAC,CAAC,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC;QACpE,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,YAAY"}

package/search/abstract/src/index.d.ts

@@ -0,0 +1,6 @@
+export * from './lib/quick-search.types';
+export * from './lib/quick-search.tokens';
+export * from './lib/quick-search-backend.interface';
+export * from './lib/quick-search-content.util';
+export * from './lib/noop-quick-search.backend';
+//# sourceMappingURL=index.d.ts.map

package/search/abstract/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../libs/framework/server/search/abstract/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sCAAsC,CAAC;AACrD,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC"}

package/search/abstract/src/index.js

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

package/search/abstract/src/index.js.map

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

package/search/abstract/src/lib/noop-quick-search.backend.d.ts

@@ -0,0 +1,10 @@
+import type { QuickSearchBackend } from './quick-search-backend.interface';
+import type { QuickSearchDocument, QuickSearchQuery, QuickSearchResult } from './quick-search.types';
+/** Used when `QUICK_SEARCH_PROVIDER=none` — mutations are no-ops, search returns empty. */
+export declare class NoopQuickSearchBackend implements QuickSearchBackend {
+    save(_doc: QuickSearchDocument): Promise<void>;
+    update(_doc: QuickSearchDocument): Promise<void>;
+    delete(_refType: string, _refId: string): Promise<void>;
+    quickSearch(_query: QuickSearchQuery): Promise<QuickSearchResult>;
+}
+//# sourceMappingURL=noop-quick-search.backend.d.ts.map

package/search/abstract/src/lib/noop-quick-search.backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop-quick-search.backend.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/search/abstract/src/lib/noop-quick-search.backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAIrG,2FAA2F;AAC3F,qBAAa,sBAAuB,YAAW,kBAAkB;IACzD,IAAI,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,MAAM,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAGxE"}

package/search/abstract/src/lib/noop-quick-search.backend.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoopQuickSearchBackend = void 0;
+//#region ---- Noop quick search backend ----
+/** Used when `QUICK_SEARCH_PROVIDER=none` — mutations are no-ops, search returns empty. */
+class NoopQuickSearchBackend {
+    async save(_doc) {
+        return;
+    }
+    async update(_doc) {
+        return;
+    }
+    async delete(_refType, _refId) {
+        return;
+    }
+    async quickSearch(_query) {
+        return { total: 0, hits: [] };
+    }
+}
+exports.NoopQuickSearchBackend = NoopQuickSearchBackend;
+//#endregion
+//# sourceMappingURL=noop-quick-search.backend.js.map

package/search/abstract/src/lib/noop-quick-search.backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop-quick-search.backend.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/search/abstract/src/lib/noop-quick-search.backend.ts"],"names":[],"mappings":";;;AAGA,6CAA6C;AAE7C,2FAA2F;AAC3F,MAAa,sBAAsB;IACjC,KAAK,CAAC,IAAI,CAAC,IAAyB;QAClC,OAAO;IACT,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAyB;QACpC,OAAO;IACT,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,MAAc;QAC3C,OAAO;IACT,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAwB;QACxC,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAChC,CAAC;CACF;AAhBD,wDAgBC;AAED,YAAY"}

package/search/abstract/src/lib/quick-search-backend.interface.d.ts

@@ -0,0 +1,8 @@
+import type { QuickSearchDocument, QuickSearchQuery, QuickSearchResult } from './quick-search.types';
+export interface QuickSearchBackend {
+    save(doc: QuickSearchDocument): Promise<void>;
+    update(doc: QuickSearchDocument): Promise<void>;
+    delete(refType: string, refId: string): Promise<void>;
+    quickSearch(query: QuickSearchQuery): Promise<QuickSearchResult>;
+}
+//# sourceMappingURL=quick-search-backend.interface.d.ts.map

package/search/abstract/src/lib/quick-search-backend.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-search-backend.interface.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/search/abstract/src/lib/quick-search-backend.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAI9B,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAClE"}

package/search/abstract/src/lib/quick-search-backend.interface.js

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

package/search/abstract/src/lib/quick-search-backend.interface.js.map

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

package/search/abstract/src/lib/quick-search-content.util.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Merges searchable field values from a record into a single space-separated string.
+ */
+export declare function buildQuickSearchContent(record: Record<string, unknown>, paths: string[]): string;
+/**
+ * Flattens all searchable text from a hydrated record/object.
+ * Excludes ids, foreign keys, and audit fields at every nesting level.
+ */
+export declare function buildQuickSearchObjectContent(record: Record<string, unknown>): string;
+export declare function buildQuickSearchDocumentId(refType: string, refId: string): string;
+/** Lowercase copy of searchable content for substring wildcard queries in Elasticsearch. */
+export declare function foldQuickSearchContent(content: string): string;
+//# sourceMappingURL=quick-search-content.util.d.ts.map

package/search/abstract/src/lib/quick-search-content.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-search-content.util.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/search/abstract/src/lib/quick-search-content.util.ts"],"names":[],"mappings":"AA+DA;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,EAAE,MAAM,EAAE,GACd,MAAM,CAYR;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAGrF;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED,4FAA4F;AAC5F,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9D"}

package/search/abstract/src/lib/quick-search-content.util.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildQuickSearchContent = buildQuickSearchContent;
+exports.buildQuickSearchObjectContent = buildQuickSearchObjectContent;
+exports.buildQuickSearchDocumentId = buildQuickSearchDocumentId;
+exports.foldQuickSearchContent = foldQuickSearchContent;
+const lodash_es_1 = require("lodash-es");
+//#region ---- Quick search content builder ----
+const QUICK_SEARCH_EXCLUDED_KEYS = new Set(['id', 'created', 'updated']);
+function isQuickSearchExcludedKey(key) {
+    if (QUICK_SEARCH_EXCLUDED_KEYS.has(key)) {
+        return true;
+    }
+    return key.endsWith('Id');
+}
+function sanitizeQuickSearchValue(value) {
+    if (value == null || typeof value !== 'object') {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => sanitizeQuickSearchValue(item));
+    }
+    const sanitized = {};
+    for (const [key, nested] of Object.entries(value)) {
+        if (isQuickSearchExcludedKey(key)) {
+            continue;
+        }
+        sanitized[key] = sanitizeQuickSearchValue(nested);
+    }
+    return sanitized;
+}
+function toSearchableText(value) {
+    if (value == null) {
+        return undefined;
+    }
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        return trimmed || undefined;
+    }
+    if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') {
+        return String(value);
+    }
+    if (Array.isArray(value)) {
+        const parts = value.flatMap((item) => {
+            const text = toSearchableText(item);
+            return text ? [text] : [];
+        });
+        return parts.length ? parts.join(' ') : undefined;
+    }
+    if (typeof value === 'object') {
+        const parts = Object.values(value).flatMap((item) => {
+            const text = toSearchableText(item);
+            return text ? [text] : [];
+        });
+        return parts.length ? parts.join(' ') : undefined;
+    }
+    return undefined;
+}
+/**
+ * Merges searchable field values from a record into a single space-separated string.
+ */
+function buildQuickSearchContent(record, paths) {
+    const parts = [];
+    for (const path of paths) {
+        const value = (0, lodash_es_1.get)(record, path);
+        const text = toSearchableText(value);
+        if (text) {
+            parts.push(text);
+        }
+    }
+    return parts.join(' ');
+}
+/**
+ * Flattens all searchable text from a hydrated record/object.
+ * Excludes ids, foreign keys, and audit fields at every nesting level.
+ */
+function buildQuickSearchObjectContent(record) {
+    const sanitized = sanitizeQuickSearchValue(record);
+    return toSearchableText(sanitized) ?? '';
+}
+function buildQuickSearchDocumentId(refType, refId) {
+    return `${refType}:${refId}`;
+}
+/** Lowercase copy of searchable content for substring wildcard queries in Elasticsearch. */
+function foldQuickSearchContent(content) {
+    return content.trim().toLowerCase();
+}
+//#endregion
+//# sourceMappingURL=quick-search-content.util.js.map

package/search/abstract/src/lib/quick-search-content.util.js.map

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

package/search/abstract/src/lib/quick-search.tokens.d.ts

@@ -0,0 +1,4 @@
+export declare const QUICK_SEARCH_BACKEND: unique symbol;
+export declare const QUICK_SEARCH_PROVIDER_KIND: unique symbol;
+export declare const QUICK_SEARCH_CONFIG: unique symbol;
+//# sourceMappingURL=quick-search.tokens.d.ts.map

package/search/abstract/src/lib/quick-search.tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-search.tokens.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/search/abstract/src/lib/quick-search.tokens.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,oBAAoB,eAAiC,CAAC;AAEnE,eAAO,MAAM,0BAA0B,eAAuC,CAAC;AAE/E,eAAO,MAAM,mBAAmB,eAAgC,CAAC"}

package/search/abstract/src/lib/quick-search.tokens.js

@@ -0,0 +1,9 @@
+"use strict";
+//#region ---- Quick search DI tokens ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QUICK_SEARCH_CONFIG = exports.QUICK_SEARCH_PROVIDER_KIND = exports.QUICK_SEARCH_BACKEND = void 0;
+exports.QUICK_SEARCH_BACKEND = Symbol('QUICK_SEARCH_BACKEND');
+exports.QUICK_SEARCH_PROVIDER_KIND = Symbol('QUICK_SEARCH_PROVIDER_KIND');
+exports.QUICK_SEARCH_CONFIG = Symbol('QUICK_SEARCH_CONFIG');
+//#endregion
+//# sourceMappingURL=quick-search.tokens.js.map

package/search/abstract/src/lib/quick-search.tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-search.tokens.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/search/abstract/src/lib/quick-search.tokens.ts"],"names":[],"mappings":";AAAA,0CAA0C;;;AAE7B,QAAA,oBAAoB,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAEtD,QAAA,0BAA0B,GAAG,MAAM,CAAC,4BAA4B,CAAC,CAAC;AAElE,QAAA,mBAAmB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAEjE,YAAY"}

package/search/abstract/src/lib/quick-search.types.d.ts

@@ -0,0 +1,29 @@
+export interface QuickSearchDocument {
+    refId: string;
+    /** Platform entity name, e.g. `ProductCatalog.Product`. */
+    refType: string;
+    /** Merged searchable field values (space-separated). */
+    content: string;
+}
+export interface QuickSearchQuery {
+    term: string;
+    refType: string;
+    skip?: number;
+    take?: number;
+}
+export interface QuickSearchHit {
+    refId: string;
+    refType: string;
+    score?: number;
+}
+export interface QuickSearchResult {
+    total: number;
+    hits: QuickSearchHit[];
+}
+export type QuickSearchProviderKind = 'elasticsearch' | 'none';
+export interface QuickSearchConfig {
+    provider: QuickSearchProviderKind;
+    indexName: string;
+    nodeUrl?: string;
+}
+//# sourceMappingURL=quick-search.types.d.ts.map

package/search/abstract/src/lib/quick-search.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-search.types.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/search/abstract/src/lib/quick-search.types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,cAAc,EAAE,CAAC;CACxB;AAED,MAAM,MAAM,uBAAuB,GAAG,eAAe,GAAG,MAAM,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,uBAAuB,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/search/abstract/src/lib/quick-search.types.js

@@ -0,0 +1,5 @@
+"use strict";
+//#region ---- Quick search document types ----
+Object.defineProperty(exports, "__esModule", { value: true });
+//#endregion
+//# sourceMappingURL=quick-search.types.js.map