@rytass/bpm-core-nestjs-module 0.19.0 → 0.20.1

package/CHANGELOG.md

@@ -1,3 +1,58 @@
+## 0.20.1 (2026-11-10)
+
+### 🩹 Fixes
+
+- **workflow-graph:** read a multiple-selection "" as unfilled ([298753a](https://github.com/Rytass/BPMCore/commit/298753a))
+- **workflow-engine:** fall back on a missing key only when it is the edge's field ([d2c5589](https://github.com/Rytass/BPMCore/commit/d2c5589))
+- **workflow-engine:** fall back to structured fields only for an unfilled field ([1f626e0](https://github.com/Rytass/BPMCore/commit/1f626e0))
+- **condition:** drop missing-key names after a computed index ([74d8081](https://github.com/Rytass/BPMCore/commit/74d8081))
+- **workflow-engine:** cover empty strings and own keys in the structured fallback ([6371342](https://github.com/Rytass/BPMCore/commit/6371342))
+- **condition:** echo only names written in the expression in CEL error messages ([098f7d9](https://github.com/Rytass/BPMCore/commit/098f7d9))
+- **condition:** keep form and initiator values out of CEL error messages ([36757f4](https://github.com/Rytass/BPMCore/commit/36757f4))
+- **workflow-engine:** route designer edges with unfilled fields through the structured evaluator ([a57f10f](https://github.com/Rytass/BPMCore/commit/a57f10f))
+- **workflow-graph:** guard designer conditions against absent form keys ([a3d2cb6](https://github.com/Rytass/BPMCore/commit/a3d2cb6))
+
+### ❤️ Thank You
+
+- Chia Yu Pai @fantasywind
+- Kai-Chieh Yang
+
+## 0.20.0 (2026-11-08)
+
+### 🚀 Features
+
+- **workflow-chat:** require a BPM API session for /api/chat ([9906851](https://github.com/Rytass/BPMCore/commit/9906851))
+- ⚠️  **form-data-source:** pass a binding's position explicitly and lint NOTIFY expressions ([9987b12](https://github.com/Rytass/BPMCore/commit/9987b12))
+- **form-data-source:** bind DataSource and webhook parameters to expressions ([c2b18d3](https://github.com/Rytass/BPMCore/commit/c2b18d3))
+- **designer:** write, preview and upgrade expressions in the designer ([ec36bb7](https://github.com/Rytass/BPMCore/commit/ec36bb7))
+- **condition:** call registered functions from every evaluation and lint ([0c2a18f](https://github.com/Rytass/BPMCore/commit/0c2a18f))
+- **template:** lint expressions against their AST at publish ([61d07f5](https://github.com/Rytass/BPMCore/commit/61d07f5))
+- **expression-function:** register host and built-in functions ([f8763b4](https://github.com/Rytass/BPMCore/commit/f8763b4))
+- **expression-function:** define the function registry contract ([31e7e16](https://github.com/Rytass/BPMCore/commit/31e7e16))
+- **workflow-engine:** evaluate each definition in its expression dialect ([45b15c3](https://github.com/Rytass/BPMCore/commit/45b15c3))
+- **delegation:** store the dialect of a rule's scope condition ([acea3d0](https://github.com/Rytass/BPMCore/commit/acea3d0))
+- **condition:** evaluate expressions under a budget with sanitized errors ([38ef1f8](https://github.com/Rytass/BPMCore/commit/38ef1f8))
+
+### 🩹 Fixes
+
+- **form-data-source:** take a new pick over an expired EXPRESSION value ([3499115](https://github.com/Rytass/BPMCore/commit/3499115))
+- **condition:** check cel-v2 function argument types and log engine warm-up ([0834758](https://github.com/Rytass/BPMCore/commit/0834758))
+- **workflow-engine:** send webhooks after the transaction commits ([d74aba6](https://github.com/Rytass/BPMCore/commit/d74aba6))
+- **workflow-engine:** bound the work of one dry run ([7afacec](https://github.com/Rytass/BPMCore/commit/7afacec))
+- **workflow-engine:** keep transaction reads on one connection ([9bd9ee7](https://github.com/Rytass/BPMCore/commit/9bd9ee7))
+
+### ⚠️  Breaking Changes
+
+- **form-data-source:** pass a binding's position explicitly and lint NOTIFY expressions  ([9987b12](https://github.com/Rytass/BPMCore/commit/9987b12))
+  FormDataSourceService.searchFormFieldOptions takes a
+  required position instead of optional rowValues, and the
+  NotifyWebhookBindingSource union gains an EXPRESSION member, so an
+  exhaustive switch over from.kind needs a new case.
+
+### ❤️ Thank You
+
+- Chia Yu Pai @fantasywind
+
 ## 0.19.0 (2026-11-04)
 
 ### 🩹 Fixes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rytass/bpm-core-nestjs-module",
-  "version": "0.19.0",
+  "version": "0.20.1",
   "description": "Embeddable NestJS BPM approval workflow module: workflow engine, approval templates, forms, organization/member contracts, attachments, signatures, notifications, delegation, and TypeORM migrations.",
   "keywords": [
     "bpm",
@@ -162,7 +162,7 @@
     "@nestjs/core": ">=10.0.0",
     "@nestjs/graphql": ">=12.0.0",
     "@nestjs/typeorm": ">=10.0.0",
-    "@rytass/bpm-core-shared": "^0.19.0",
+    "@rytass/bpm-core-shared": "^0.20.1",
     "@rytass/secret-adapter-vault-nestjs": ">=0.4.5",
     "express": ">=4.0.0",
     "graphql": ">=16.0.0",
@@ -178,6 +178,7 @@
     }
   },
   "dependencies": {
+    "@marcbachmann/cel-js": "^8.0.0",
     "@rytass/storages": "^0.3.0",
     "@rytass/storages-adapter-local": "^0.3.0",
     "cel-js": "^0.8.2",

package/src/index.d.ts

@@ -6,6 +6,7 @@ export * from './lib/common';
 export * from './lib/condition';
 export * from './lib/database';
 export * from './lib/delegation';
+export * from './lib/expression-function';
 export * from './lib/form';
 export * from './lib/form-data-source';
 export * from './lib/identity';

package/src/index.js

@@ -9,6 +9,7 @@ tslib_1.__exportStar(require("./lib/common"), exports);
 tslib_1.__exportStar(require("./lib/condition"), exports);
 tslib_1.__exportStar(require("./lib/database"), exports);
 tslib_1.__exportStar(require("./lib/delegation"), exports);
+tslib_1.__exportStar(require("./lib/expression-function"), exports);
 tslib_1.__exportStar(require("./lib/form"), exports);
 tslib_1.__exportStar(require("./lib/form-data-source"), exports);
 tslib_1.__exportStar(require("./lib/identity"), exports);

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/bpm-core/src/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiC;AACjC,oDAA0B;AAC1B,yDAA+B;AAC/B,yDAA+B;AAC/B,uDAA6B;AAC7B,0DAAgC;AAChC,yDAA+B;AAC/B,2DAAiC;AACjC,qDAA2B;AAC3B,iEAAuC;AACvC,yDAA+B;AAC/B,6DAAmC;AACnC,6DAAmC;AACnC,0DAAgC;AAChC,yDAA+B;AAC/B,gEAAsC;AACtC,iEAAuC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/bpm-core/src/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiC;AACjC,oDAA0B;AAC1B,yDAA+B;AAC/B,yDAA+B;AAC/B,uDAA6B;AAC7B,0DAAgC;AAChC,yDAA+B;AAC/B,2DAAiC;AACjC,oEAA0C;AAC1C,qDAA2B;AAC3B,iEAAuC;AACvC,yDAA+B;AAC/B,6DAAmC;AACnC,6DAAmC;AACnC,0DAAgC;AAChC,yDAA+B;AAC/B,gEAAsC;AACtC,iEAAuC"}

package/src/lib/bpm/bpm-root-options.d.ts

@@ -3,6 +3,7 @@ import { BPMRootAttachmentOptions } from '../attachment/attachment-options';
 import { AttachmentStorage } from '../attachment/attachment-storage.token';
 import { BPMAuthModuleOptions } from '../bpm-auth/bpm-auth.options';
 import { BPMBusinessCalendar } from '../calendar/business-calendar.token';
+import type { BPMExpressionFunction } from '../expression-function/expression-function.types';
 import { BPMFormDataSourceRegistry } from '../form-data-source/form-data-source.types';
 import { BPMRootIdentityOptions } from '../identity/identity-options';
 import { BPMMemberResolver } from '../identity/member-resolver.interface';
@@ -65,6 +66,18 @@ export interface BPMRootRuntimeOptions extends BPMRootAttachmentOptions, BPMRoot
      * chain never runs through BPM's module context.
      */
     readonly businessCalendar?: BPMBusinessCalendar;
+    /**
+     * Host functions that expressions may call (ADR 22 §3.5), next to the nine
+     * built-ins that are always available. Each name ends in its version
+     * (`erp_costBand_v1`); handlers must be synchronous and pure, and only see
+     * deep-frozen copies of their arguments. Validated while BPM boots: a bad
+     * name, an async handler or an unsupported type fails the boot.
+     *
+     * Keep every function a published version still calls: once one is gone,
+     * cases on that version fail closed with `EXPRESSION_FUNCTION_FAILED`.
+     * When omitted, only the built-ins are available.
+     */
+    readonly expressionFunctions?: readonly BPMExpressionFunction[];
     /**
      * Versioned form option DataSource catalog, as a ready instance. When
      * omitted, BPM exposes an empty catalog.

package/src/lib/bpm/bpm-root-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"bpm-root-options.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/bpm/bpm-root-options.ts"],"names":[],"mappings":";;;;;AAAA,2CAMwB;AASxB,mFAGgD;AA0GhD;;;;;;;;;;;GAWG;AACU,QAAA,gBAAgB,GAC3B,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAoB7B;;;;;;GAMG;AAGI,IAAM,oBAAoB,4BAA1B,MAAM,oBAAoB;IAC/B,MAAM,CAAC,OAAO,CAAC,UAAiC,EAAE;QAChD,IAAA,uDAA8B,EAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAE7D,OAAO;YACL,OAAO,EAAE,CAAC,wBAAgB,CAAC;YAC3B,MAAM,EAAE,sBAAoB;YAC5B,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,wBAAgB;oBACzB,QAAQ,EAAE,OAAO;iBAClB;aACF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CACjB,UAA4C,EAAE;QAE9C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QAEtC,OAAO;YACL,OAAO,EAAE,CAAC,wBAAgB,CAAC;YAC3B,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE;YACpD,MAAM,EAAE,sBAAoB;YAC5B,SAAS,EAAE;gBACT;oBACE,MAAM,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;oBACnC,OAAO,EAAE,wBAAgB;oBACzB,UAAU,EAAE,KAAK,EACf,GAAG,IAAwB,EACK,EAAE;wBAClC,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;wBAE7D,IAAA,uDAA8B,EAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;wBAE9D,OAAO,QAAQ,CAAC;oBAClB,CAAC;iBACF;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AA1CY,oDAAoB;+BAApB,oBAAoB;IAFhC,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,oBAAoB,CA0ChC"}
+{"version":3,"file":"bpm-root-options.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/bpm/bpm-root-options.ts"],"names":[],"mappings":";;;;;AAAA,2CAMwB;AAUxB,mFAGgD;AAuHhD;;;;;;;;;;;GAWG;AACU,QAAA,gBAAgB,GAC3B,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAoB7B;;;;;;GAMG;AAGI,IAAM,oBAAoB,4BAA1B,MAAM,oBAAoB;IAC/B,MAAM,CAAC,OAAO,CAAC,UAAiC,EAAE;QAChD,IAAA,uDAA8B,EAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAE7D,OAAO;YACL,OAAO,EAAE,CAAC,wBAAgB,CAAC;YAC3B,MAAM,EAAE,sBAAoB;YAC5B,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,wBAAgB;oBACzB,QAAQ,EAAE,OAAO;iBAClB;aACF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CACjB,UAA4C,EAAE;QAE9C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QAEtC,OAAO;YACL,OAAO,EAAE,CAAC,wBAAgB,CAAC;YAC3B,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE;YACpD,MAAM,EAAE,sBAAoB;YAC5B,SAAS,EAAE;gBACT;oBACE,MAAM,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;oBACnC,OAAO,EAAE,wBAAgB;oBACzB,UAAU,EAAE,KAAK,EACf,GAAG,IAAwB,EACK,EAAE;wBAClC,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;wBAE7D,IAAA,uDAA8B,EAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;wBAE9D,OAAO,QAAQ,CAAC;oBAClB,CAAC;iBACF;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AA1CY,oDAAoB;+BAApB,oBAAoB;IAFhC,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,oBAAoB,CA0ChC"}

package/src/lib/bpm/bpm-root.module.d.ts

@@ -2,6 +2,7 @@ import { DynamicModule, InjectionToken, ModuleMetadata, Provider } from '@nestjs
 import { AttachmentStorage } from '../attachment/attachment-storage.token';
 import { BPMResolverMetadataFactory } from '../bpm-auth/bpm-resolver-metadata';
 import { BPMBusinessCalendar } from '../calendar/business-calendar.token';
+import type { BPMExpressionFunction } from '../expression-function/expression-function.types';
 import { BPMFormDataSourceRegistry } from '../form-data-source';
 import { BPMMemberResolver } from '../identity/member-resolver.interface';
 import { BPMWorkflowWebhookRegistry } from '../workflow-webhook/workflow-webhook.types';
@@ -40,6 +41,17 @@ interface BPMRootModuleWiringOptions extends Pick<ModuleMetadata, 'imports'> {
      * `notificationSlaBusinessCalendarTimeZone`).
      */
     readonly businessCalendarProvider?: Provider<BPMBusinessCalendar>;
+    /**
+     * Host expression functions as a Nest provider for
+     * `BPM_EXPRESSION_FUNCTIONS` (a list), for functions that need injected
+     * dependencies to be built.
+     *
+     * Runtime twin: {@link BPMRootRuntimeOptions.expressionFunctions}. Unlike
+     * the other twins the two are **combined**, the runtime list first; a name
+     * in both fails the boot. When neither is given, only the nine built-ins are
+     * available.
+     */
+    readonly expressionFunctionsProvider?: Provider<readonly BPMExpressionFunction[]>;
     /**
      * Host-provided registry containing versioned form option DataSources, as a
      * Nest provider.

package/src/lib/bpm/bpm-root.module.js

@@ -9,6 +9,7 @@ const bpm_auth_module_1 = require("../bpm-auth/bpm-auth.module");
 const bpm_resolver_metadata_1 = require("../bpm-auth/bpm-resolver-metadata");
 const calendar_module_1 = require("../calendar/calendar.module");
 const delegation_module_1 = require("../delegation/delegation.module");
+const expression_function_module_1 = require("../expression-function/expression-function.module");
 const form_module_1 = require("../form/form.module");
 const form_data_source_1 = require("../form-data-source");
 const identity_module_1 = require("../identity/identity.module");
@@ -141,6 +142,10 @@ function createBPMFeatureModules(wiring) {
             storageProvider: wiring.attachmentStorageProvider,
             useFactory,
         }),
+        expression_function_module_1.ExpressionFunctionModule.forRoot({
+            functionsProvider: wiring.expressionFunctionsProvider,
+            imports: wiring.imports,
+        }),
         form_module_1.FormModule,
         form_data_source_1.FormDataSourceModule.forRoot({
             imports: wiring.imports,

package/src/lib/bpm/bpm-root.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"bpm-root.module.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/bpm/bpm-root.module.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bpm-root.module.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/bpm/bpm-root.module.ts"],"names":[],"mappings":"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"}

package/src/lib/condition/adapters/cel-legacy.adapter.d.ts

@@ -0,0 +1,62 @@
+import type { ParseResult } from 'cel-js';
+import type { BPMExpressionFunctionRegistry } from '../../expression-function/expression-function.types';
+import type { ExpressionEngineAdapter, ExpressionHandle } from '../expression-runtime';
+type CelLegacyFunction = (...args: readonly unknown[]) => unknown;
+/**
+ * The slice of `cel-js` this adapter uses. The third `evaluate` argument is
+ * the function table: `cel-js` 0.8.2 merges it over its own `has` and `size`
+ * and calls an entry for every global call (`round(x)`), with the evaluated
+ * arguments. Methods (`x.round()`) never reach it.
+ */
+interface CelEngine {
+    readonly evaluate: (cst: unknown, context: Readonly<Record<string, unknown>>, functions?: Readonly<Record<string, CelLegacyFunction>>) => unknown;
+    readonly parse: (expression: string) => ParseResult;
+}
+/**
+ * Loads `cel-js` on first use rather than when this module is imported.
+ *
+ * `cel-js` is ESM-only and its `chevrotain` dependency ships an exports map
+ * that `jest-resolve` cannot follow. While the import sat at the top of this
+ * file, the package root pulled it in through
+ * `index → bpm-root → delegation → condition`, so *any* consumer test that
+ * imported anything from `@rytass/bpm-core-nestjs-module` failed to load with
+ * `Cannot find module 'chevrotain'` — pointing deep into `node_modules`, far
+ * from the code under test. Hosts had to stub `cel-js` before they could write
+ * a single test.
+ *
+ * Deferring the load means a host that never evaluates a CEL expression never
+ * resolves the package at all. `require` (not `await import`) keeps every
+ * caller in this file synchronous.
+ *
+ * The engine is loaded before a budget starts, so an interrupt can never land
+ * halfway through loading a module.
+ */
+export declare function loadCelEngine(): CelEngine;
+/**
+ * Parses with `cel-js`. Returns `null` when the expression does not parse.
+ *
+ * `cel-js` can throw instead of reporting failure: a deeply nested expression
+ * (about 200 levels, still under the length limit) overflows the parser's stack
+ * with a bare `RangeError`. That is a syntax refusal, not a crash, so it maps to
+ * `null`. The engine is loaded outside the `try`: a failure to load it is a
+ * configuration error and must not be reported as a bad expression.
+ */
+export declare function parseCelLegacy(expression: string): ExpressionHandle | null;
+/**
+ * The function table handed to `cel-js` for a registry, built once: every
+ * function the registry lists, wrapped for cel-legacy. Verified on the real
+ * engine (2026-11-07): `cel-js` 0.8.2 accepts the table and calls it.
+ *
+ * Exported so `ConditionService.prepareEngine` can build it before a budget
+ * starts; otherwise the first evaluation builds it inside its budget.
+ */
+export declare const readCelLegacyFunctions: (registry: BPMExpressionFunctionRegistry) => Readonly<Record<string, CelLegacyFunction>>;
+/**
+ * The cel-legacy adapter for a registry. A host function the registry no
+ * longer has fails the evaluation with `EXPRESSION_FUNCTION_FAILED` before the
+ * engine runs; any other unknown name keeps `cel-js`'s own error.
+ */
+export declare const createCelLegacyAdapter: (registry: BPMExpressionFunctionRegistry) => ExpressionEngineAdapter;
+/** The built-ins-only adapter, used wherever no registry was handed in. */
+export declare const celLegacyAdapter: ExpressionEngineAdapter;
+export {};

package/src/lib/condition/adapters/cel-legacy.adapter.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.celLegacyAdapter = exports.createCelLegacyAdapter = exports.readCelLegacyFunctions = void 0;
+exports.loadCelEngine = loadCelEngine;
+exports.parseCelLegacy = parseCelLegacy;
+const expression_function_registry_1 = require("../../expression-function/expression-function.registry");
+const expression_engine_failure_1 = require("../expression-engine-failure");
+const expression_function_invocation_1 = require("../expression-function-invocation");
+let celEngine = null;
+/**
+ * Loads `cel-js` on first use rather than when this module is imported.
+ *
+ * `cel-js` is ESM-only and its `chevrotain` dependency ships an exports map
+ * that `jest-resolve` cannot follow. While the import sat at the top of this
+ * file, the package root pulled it in through
+ * `index → bpm-root → delegation → condition`, so *any* consumer test that
+ * imported anything from `@rytass/bpm-core-nestjs-module` failed to load with
+ * `Cannot find module 'chevrotain'` — pointing deep into `node_modules`, far
+ * from the code under test. Hosts had to stub `cel-js` before they could write
+ * a single test.
+ *
+ * Deferring the load means a host that never evaluates a CEL expression never
+ * resolves the package at all. `require` (not `await import`) keeps every
+ * caller in this file synchronous.
+ *
+ * The engine is loaded before a budget starts, so an interrupt can never land
+ * halfway through loading a module.
+ */
+function loadCelEngine() {
+    if (celEngine === null) {
+        try {
+            celEngine = require('cel-js');
+        }
+        catch (error) {
+            // Deferring the load also defers this failure: it used to surface at
+            // boot as a bare ERR_REQUIRE_ESM, and would now surface as a 500 on
+            // whichever request first evaluated a condition. Name the cause where it
+            // is thrown.
+            if (isRequireEsmError(error)) {
+                throw new Error(`[@rytass/bpm-core-nestjs-module] This Node version cannot require the ESM-only 'cel-js'. BPM needs Node >=20.19 or >=22.12 to evaluate CEL conditions. Original error: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            throw error;
+        }
+    }
+    return celEngine;
+}
+function isRequireEsmError(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'code' in error &&
+        error.code === 'ERR_REQUIRE_ESM');
+}
+/**
+ * Parses with `cel-js`. Returns `null` when the expression does not parse.
+ *
+ * `cel-js` can throw instead of reporting failure: a deeply nested expression
+ * (about 200 levels, still under the length limit) overflows the parser's stack
+ * with a bare `RangeError`. That is a syntax refusal, not a crash, so it maps to
+ * `null`. The engine is loaded outside the `try`: a failure to load it is a
+ * configuration error and must not be reported as a bad expression.
+ */
+function parseCelLegacy(expression) {
+    const engine = loadCelEngine();
+    let parseResult;
+    try {
+        parseResult = engine.parse(expression);
+    }
+    catch {
+        return null;
+    }
+    return parseResult.isSuccess ? { native: parseResult.cst } : null;
+}
+const isCstNode = (value) => typeof value === 'object' &&
+    value !== null &&
+    typeof value.name === 'string' &&
+    typeof value.children === 'object' &&
+    value.children !== null;
+const readTokenImage = (token) => typeof token === 'object' &&
+    token !== null &&
+    typeof token.image === 'string'
+    ? token.image
+    : null;
+/**
+ * Names of the global functions a `cel-js` CST calls: its `macrosExpression`
+ * nodes, which is where `cel-js` looks a global call up in the function table.
+ * Anything that is not a CST node yields nothing, so the jest shim's stand-in
+ * CST simply has no calls.
+ */
+const readCalledFunctionNames = (node) => {
+    if (!isCstNode(node)) {
+        return [];
+    }
+    const identifier = node.name === 'macrosExpression'
+        ? readTokenImage(node.children.Identifier?.[0])
+        : null;
+    return [
+        ...(identifier === null ? [] : [identifier]),
+        ...Object.values(node.children).flatMap((children) => children.flatMap(readCalledFunctionNames)),
+    ];
+};
+const celLegacyFunctionTables = new WeakMap();
+/**
+ * The function table handed to `cel-js` for a registry, built once: every
+ * function the registry lists, wrapped for cel-legacy. Verified on the real
+ * engine (2026-11-07): `cel-js` 0.8.2 accepts the table and calls it.
+ *
+ * Exported so `ConditionService.prepareEngine` can build it before a budget
+ * starts; otherwise the first evaluation builds it inside its budget.
+ */
+const readCelLegacyFunctions = (registry) => {
+    const cached = celLegacyFunctionTables.get(registry);
+    if (cached) {
+        return cached;
+    }
+    const functions = Object.freeze(Object.fromEntries((0, expression_function_invocation_1.readExpressionFunctionTable)(registry).functions.map((fn) => [
+        fn.name,
+        (0, expression_function_invocation_1.createExpressionFunctionInvoker)(fn, 'cel-legacy'),
+    ])));
+    celLegacyFunctionTables.set(registry, functions);
+    return functions;
+};
+exports.readCelLegacyFunctions = readCelLegacyFunctions;
+/**
+ * The cel-legacy adapter for a registry. A host function the registry no
+ * longer has fails the evaluation with `EXPRESSION_FUNCTION_FAILED` before the
+ * engine runs; any other unknown name keeps `cel-js`'s own error.
+ */
+const createCelLegacyAdapter = (registry) => ({
+    compile: parseCelLegacy,
+    evaluate: (handle, roots) => {
+        if ((0, expression_function_invocation_1.callsUnavailableFunction)(readCalledFunctionNames(handle.native), (0, expression_function_invocation_1.readExpressionFunctionTable)(registry))) {
+            throw new expression_engine_failure_1.ExpressionEngineFailure('EXPRESSION_FUNCTION_FAILED');
+        }
+        const functions = (0, exports.readCelLegacyFunctions)(registry);
+        return (0, expression_function_invocation_1.runWithExpressionFunctionFrame)(() => loadCelEngine().evaluate(handle.native, { ...roots }, functions));
+    },
+});
+exports.createCelLegacyAdapter = createCelLegacyAdapter;
+/** The built-ins-only adapter, used wherever no registry was handed in. */
+exports.celLegacyAdapter = (0, exports.createCelLegacyAdapter)(expression_function_registry_1.BUILT_IN_EXPRESSION_FUNCTION_REGISTRY);
+//# sourceMappingURL=cel-legacy.adapter.js.map

package/src/lib/condition/adapters/cel-legacy.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cel-legacy.adapter.js","sourceRoot":"","sources":["../../../../../../../libs/bpm-core/src/lib/condition/adapters/cel-legacy.adapter.ts"],"names":[],"mappings":"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"}

package/src/lib/condition/adapters/cel-v2.adapter.d.ts

@@ -0,0 +1,76 @@
+import type { Environment } from '@marcbachmann/cel-js';
+import type { BPMExpressionValueType } from '@rytass/bpm-core-shared';
+import type { BPMExpressionFunctionRegistry } from '../../expression-function/expression-function.types';
+import type { ExpressionEngineAdapter, ExpressionHandle } from '../expression-runtime';
+/**
+ * Parse-time structure limits (ADR 22 §3.4, docs/24 §2.7). They are applied by
+ * the engine while parsing, so an over-large expression never reaches the
+ * budget. Comprehension nesting is not an engine limit; P2 checks it on the AST.
+ */
+export declare const CEL_V2_LIMITS: {
+    readonly maxAstNodes: 200;
+    readonly maxDepth: 32;
+};
+/**
+ * The cel-v2 environment for a registry: the base environment plus every
+ * function the registry lists (the nine built-ins and the host's), built once
+ * per registry and cached. Without a registry it is the built-ins-only one.
+ *
+ * Every function is registered as a global call (`round(x)`), never as a
+ * method. The name `trim` therefore sits beside cel-v2's own `string.trim()`
+ * method without replacing it; no other built-in name exists in cel-v2.
+ *
+ * The returned environment is frozen: registering on it throws. For a
+ * type check with declared variables (P2's `env.check()`), `clone()` it and
+ * register the variables on the clone.
+ */
+export declare function loadCelV2Environment(registry?: BPMExpressionFunctionRegistry): Environment;
+/** A call argument whose checked type its declared parameter never accepts. */
+export interface CelV2ArgumentTypeMismatch {
+    /** The argument's AST node, for the caller to read the fields it uses. */
+    readonly argument: unknown;
+    readonly functionName: string;
+    readonly parameterType: BPMExpressionValueType;
+}
+/**
+ * The first global call to a registered function whose argument the type
+ * check typed as something the declared parameter refuses (ADR 22 §3.5): a
+ * text field handed to a `double` parameter, say. Only meaningful on the AST
+ * of an expression `check()` accepted, parsed in a clone of
+ * `loadCelV2Environment(...)`'s environment (`environment` is that
+ * environment, not the clone); an argument without a checked type, or a
+ * function the environment does not know, is skipped.
+ *
+ * The engine checks every other parameter type itself through the
+ * signature; numbers are registered as `dyn` there, which is what this
+ * closes for the publish lint.
+ *
+ * `readArgumentType`, when given, may name the type to compare instead of
+ * the checked one (a base type, `null` to keep the checked one): the lint
+ * passes the schema type of a field it had to check as `dyn`, so that
+ * `form.title != null && f(form.title)` is compared as the text it is.
+ */
+export declare function findCelV2ArgumentTypeMismatch(ast: unknown, environment: Environment, readArgumentType?: (argument: unknown) => string | null): CelV2ArgumentTypeMismatch | null;
+/**
+ * Parses with cel-v2. Returns `null` when the expression does not parse or
+ * breaks a structure limit. The engine is loaded outside the `try`: a failure
+ * to load it is a configuration error, not a bad expression.
+ *
+ * Parsing does not check that a called function exists; evaluation does.
+ */
+export declare function parseCelV2(expression: string, registry?: BPMExpressionFunctionRegistry): ExpressionHandle | null;
+/**
+ * Maps an error cel-v2 threw to a classified failure, by its `code` only. Any
+ * code not listed is a type or evaluation error. Errors that are not cel-v2's
+ * (an operator handler's own failure, a stack overflow) pass through unchanged
+ * and are classified by the runtime.
+ */
+export declare function classifyCelV2Error(error: unknown): unknown;
+/**
+ * The cel-v2 adapter for a registry. A host function the registry no longer
+ * has (withdrawn after publishing) fails the evaluation with
+ * `EXPRESSION_FUNCTION_FAILED` before the engine runs, wherever the call sits.
+ */
+export declare const createCelV2Adapter: (registry: BPMExpressionFunctionRegistry) => ExpressionEngineAdapter;
+/** The built-ins-only adapter, used wherever no registry was handed in. */
+export declare const celV2Adapter: ExpressionEngineAdapter;