@rytass/bpm-core-shared 0.18.1 → 0.20.0

package/CHANGELOG.md

@@ -1,3 +1,49 @@
+## 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))
+- **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))
+- **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))
+
+### ⚠️  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
+
+- **bpm-core:** read form attachments from file_upload fields only ([e9cd71a](https://github.com/Rytass/BPMCore/commit/e9cd71a))
+- **bpm-core-react:** list file_upload files as the host holds them, in pick order ([20bf634](https://github.com/Rytass/BPMCore/commit/20bf634))
+- **bpm-core:** refuse a form attachment the case may not take ([4710a23](https://github.com/Rytass/BPMCore/commit/4710a23))
+- **bpm-core:** bind a free attachment only for the members who file the case ([ecd9d76](https://github.com/Rytass/BPMCore/commit/ecd9d76))
+- **bpm-core-react:** list every attachment a file_upload value holds ([da7ee9b](https://github.com/Rytass/BPMCore/commit/da7ee9b))
+- **bpm-core:** release form attachments a resubmit no longer refers to ([2580381](https://github.com/Rytass/BPMCore/commit/2580381))
+
+### ❤️ Thank You
+
+- Chia Yu Pai @fantasywind
+
 ## 0.18.1 (2026-11-01)
 
 ### 🚀 Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rytass/bpm-core-shared",
-  "version": "0.18.1",
+  "version": "0.20.0",
   "description": "Shared TypeScript contracts for the Rytass BPM approval workflow stack (workflow, form, condition, identity, organization, status types).",
   "keywords": [
     "bpm",

package/src/index.d.ts

@@ -1,4 +1,6 @@
 export * from './lib/condition';
+export * from './lib/expression-function';
+export * from './lib/expression-usage-point';
 export * from './lib/field-access';
 export * from './lib/field-access-lint';
 export * from './lib/field-access-matrix';

package/src/index.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./lib/condition"), exports);
+tslib_1.__exportStar(require("./lib/expression-function"), exports);
+tslib_1.__exportStar(require("./lib/expression-usage-point"), exports);
 tslib_1.__exportStar(require("./lib/field-access"), exports);
 tslib_1.__exportStar(require("./lib/field-access-lint"), exports);
 tslib_1.__exportStar(require("./lib/field-access-matrix"), exports);

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/shared/src/index.ts"],"names":[],"mappings":";;;AAAA,0DAAgC;AAChC,6DAAmC;AACnC,kEAAwC;AACxC,oEAA0C;AAC1C,qDAA2B;AAC3B,yDAA+B;AAC/B,6DAAmC;AACnC,uDAA6B;AAC7B,yDAA+B;AAC/B,+DAAqC;AACrC,iEAAuC;AACvC,iEAAuC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/shared/src/index.ts"],"names":[],"mappings":";;;AAAA,0DAAgC;AAChC,oEAA0C;AAC1C,uEAA6C;AAC7C,6DAAmC;AACnC,kEAAwC;AACxC,oEAA0C;AAC1C,qDAA2B;AAC3B,yDAA+B;AAC/B,6DAAmC;AACnC,uDAA6B;AAC7B,yDAA+B;AAC/B,+DAAqC;AACrC,iEAAuC;AACvC,iEAAuC"}

package/src/lib/expression-function.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The value types an expression function declares for its parameters and its
+ * result (ADR 22 §3.5). They name CEL types; `dyn` accepts any JSON value.
+ */
+export type BPMExpressionValueType = 'bool' | 'double' | 'dyn' | 'int' | 'list' | 'map' | 'null' | 'string';
+/** A JSON value as an expression function receives and returns it. */
+export type BPMExpressionValue = boolean | number | string | null | readonly BPMExpressionValue[] | {
+    readonly [key: string]: BPMExpressionValue;
+};
+export interface BPMExpressionFunctionParameter {
+    readonly description?: string;
+    readonly name: string;
+    readonly type: BPMExpressionValueType;
+}
+/**
+ * What the designer, the catalog and the publish lint may know about a
+ * function: everything except its handler. The browser only ever sees this.
+ */
+export interface BPMExpressionFunctionDescriptor {
+    /** `true` for the nine core functions (`round` … `upper`). */
+    readonly builtIn: boolean;
+    readonly description: string;
+    readonly label: string;
+    /** Host functions carry their version: `erp_costBand_v1`. Built-ins do not. */
+    readonly name: string;
+    readonly parameters: readonly BPMExpressionFunctionParameter[];
+    readonly returnType: BPMExpressionValueType;
+}
+/** The names the core reserves for its built-in functions (ADR 22 §3.5). */
+export declare const BPM_BUILT_IN_EXPRESSION_FUNCTION_NAMES: readonly ["abs", "ceil", "floor", "lower", "max", "min", "round", "trim", "upper"];
+export type BPMBuiltInExpressionFunctionName = (typeof BPM_BUILT_IN_EXPRESSION_FUNCTION_NAMES)[number];
+/** Host function names: lower camel segments joined by `_`, ending in `_vN`. */
+export declare const BPM_EXPRESSION_FUNCTION_NAME_PATTERN: RegExp;

package/src/lib/expression-function.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BPM_EXPRESSION_FUNCTION_NAME_PATTERN = exports.BPM_BUILT_IN_EXPRESSION_FUNCTION_NAMES = void 0;
+/** The names the core reserves for its built-in functions (ADR 22 §3.5). */
+exports.BPM_BUILT_IN_EXPRESSION_FUNCTION_NAMES = [
+    'abs',
+    'ceil',
+    'floor',
+    'lower',
+    'max',
+    'min',
+    'round',
+    'trim',
+    'upper',
+];
+/** Host function names: lower camel segments joined by `_`, ending in `_vN`. */
+exports.BPM_EXPRESSION_FUNCTION_NAME_PATTERN = /^[a-z][A-Za-z0-9]*(_[A-Za-z0-9]+)*_v[0-9]+$/u;
+//# sourceMappingURL=expression-function.js.map

package/src/lib/expression-function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-function.js","sourceRoot":"","sources":["../../../../../libs/shared/src/lib/expression-function.ts"],"names":[],"mappings":";;;AAqCA,4EAA4E;AAC/D,QAAA,sCAAsC,GAAG;IACpD,KAAK;IACL,MAAM;IACN,OAAO;IACP,OAAO;IACP,KAAK;IACL,KAAK;IACL,OAAO;IACP,MAAM;IACN,OAAO;CACC,CAAC;AAKX,gFAAgF;AACnE,QAAA,oCAAoC,GAC/C,8CAA8C,CAAC"}

package/src/lib/expression-usage-point.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Where an expression is evaluated, and so what it may read (docs/24 §2.3).
+ * Each use point has its own root list; they are deliberately not merged.
+ */
+export declare const EXPRESSION_USAGE_POINTS: readonly ["INITIATOR_POLICY", "ENTRY_CONDITION", "FLOW_CONDITION", "APPROVER_RESOLVER", "SERVICE_FORM_FIELD_VALUE", "WEBHOOK_PAYLOAD", "DELEGATION_CONDITION", "DATA_SOURCE_BINDING", "NOTIFY_WEBHOOK_BINDING"];
+export type ExpressionUsagePoint = (typeof EXPRESSION_USAGE_POINTS)[number];
+/**
+ * The root identifiers each use point evaluates with. Mirrors what the engine
+ * hands over at each point (workflow-engine `buildInitiatorPolicyContext`,
+ * `buildWorkflowExpressionContext`, the edge `lastDecision`, the delegation
+ * `principal`), so the lint refuses exactly what could only fail at run time.
+ */
+export declare const EXPRESSION_ROOT_IDENTIFIERS_BY_USAGE_POINT: Readonly<Record<ExpressionUsagePoint, readonly string[]>>;
+/**
+ * Use points that may only call the built-in functions (docs/24 §1: bindings
+ * get host functions later, if ever; widening is additive, narrowing is not).
+ */
+export declare const EXPRESSION_USAGE_POINTS_WITHOUT_HOST_FUNCTIONS: readonly ExpressionUsagePoint[];
+export declare const isExpressionUsagePoint: (value: unknown) => value is ExpressionUsagePoint;
+export declare const allowsHostExpressionFunctions: (usagePoint: ExpressionUsagePoint) => boolean;
+/**
+ * Lint findings that refuse a publish (docs/24 §2.2). Publish, the preview's
+ * LINT mode and the NOTIFY catalog share this one list.
+ */
+export declare const EXPRESSION_LINT_ERROR_CODES: readonly ["EXPR_PARSE_FAILED", "EXPR_ROOT_NOT_ALLOWED", "EXPR_WHOLE_FORM_REFERENCE", "EXPR_COMPUTED_KEY", "EXPR_RESERVED_PATH_SEGMENT", "EXPR_COMPLEXITY_EXCEEDED", "EXPR_COMPREHENSION_NESTING", "EXPR_FIELD_UNKNOWN", "EXPR_FIELD_TYPE_MISMATCH", "EXPR_RESULT_TYPE_MISMATCH", "EXPR_FUNCTION_NOT_REGISTERED", "EXPR_FUNCTION_NOT_ALLOWED"];
+/**
+ * Lint findings that only warn. `EXPR_DIVISOR_IS_FIELD` is the warning
+ * docs/24 §2.1 asks for (a `double` divided by a zero field is `Infinity` in
+ * cel-v2, which a comparison quietly turns into a routing decision; P1 P35).
+ * `EXPR_LAST_DECISION_UNAVAILABLE` is an edge condition that reads
+ * `lastDecision` on an edge leaving a node without tasks (a gateway, a
+ * service task, the start): no decision is made there, so it is always
+ * `null` at run time (Phase 23 P2 live finding, P4).
+ */
+export declare const EXPRESSION_LINT_WARNING_CODES: readonly ["EXPR_OPTIONAL_FIELD_WITHOUT_HAS", "EXPR_OR_ABSORBS_ERROR", "EXPR_HAS_NESTED_PARENT", "EXPR_APPROVER_READS_FORM", "EXPR_HIDDEN_FIELD_COPIED", "EXPR_DIVISOR_IS_FIELD", "EXPR_LAST_DECISION_UNAVAILABLE"];
+export type ExpressionLintErrorCode = (typeof EXPRESSION_LINT_ERROR_CODES)[number];
+export type ExpressionLintWarningCode = (typeof EXPRESSION_LINT_WARNING_CODES)[number];
+export type ExpressionLintCode = ExpressionLintErrorCode | ExpressionLintWarningCode;
+export type ExpressionLintSeverity = 'ERROR' | 'WARNING';
+/**
+ * One finding. `subject` names what the finding is about (a field key, a
+ * root, a function) and is only ever an identifier: anything else is dropped
+ * when the line is written, so a user-chosen key can never carry the `'; '`
+ * the publish lint joins lines with.
+ */
+export interface ExpressionLintIssue {
+    readonly code: ExpressionLintCode;
+    readonly label: string;
+    readonly severity: ExpressionLintSeverity;
+    readonly subject?: string;
+}
+export declare const EXPRESSION_LINT_SUBJECT_PATTERN: RegExp;
+export declare const isExpressionLintCode: (value: unknown) => value is ExpressionLintCode;
+export declare const readExpressionLintSeverity: (code: ExpressionLintCode) => ExpressionLintSeverity;
+/**
+ * The publish-lint line for a finding: `<label>: <code>` or
+ * `<label>: <code> <subject>`. The designer parses it back with
+ * {@link parseExpressionLintLine} to show its own copy.
+ */
+export declare const formatExpressionLintIssue: (issue: ExpressionLintIssue) => string;
+export interface ParsedExpressionLintLine {
+    readonly code: ExpressionLintCode;
+    readonly label: string;
+    readonly subject: string | null;
+}
+/** The parts of a line {@link formatExpressionLintIssue} wrote, or `null`. */
+export declare const parseExpressionLintLine: (line: string) => ParsedExpressionLintLine | null;
+/**
+ * The publish-lint line for a definition whose `expressionDialect` this
+ * version does not know (Phase 23 P2). Shared so the designer can match it.
+ */
+export declare const UNKNOWN_EXPRESSION_DIALECT_LINT_MESSAGE = "workflow.expressionDialect must be cel-legacy or cel-v2";

package/src/lib/expression-usage-point.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNKNOWN_EXPRESSION_DIALECT_LINT_MESSAGE = exports.parseExpressionLintLine = exports.formatExpressionLintIssue = exports.readExpressionLintSeverity = exports.isExpressionLintCode = exports.EXPRESSION_LINT_SUBJECT_PATTERN = exports.EXPRESSION_LINT_WARNING_CODES = exports.EXPRESSION_LINT_ERROR_CODES = exports.allowsHostExpressionFunctions = exports.isExpressionUsagePoint = exports.EXPRESSION_USAGE_POINTS_WITHOUT_HOST_FUNCTIONS = exports.EXPRESSION_ROOT_IDENTIFIERS_BY_USAGE_POINT = exports.EXPRESSION_USAGE_POINTS = void 0;
+/**
+ * Where an expression is evaluated, and so what it may read (docs/24 §2.3).
+ * Each use point has its own root list; they are deliberately not merged.
+ */
+exports.EXPRESSION_USAGE_POINTS = [
+    'INITIATOR_POLICY',
+    'ENTRY_CONDITION',
+    'FLOW_CONDITION',
+    'APPROVER_RESOLVER',
+    'SERVICE_FORM_FIELD_VALUE',
+    'WEBHOOK_PAYLOAD',
+    'DELEGATION_CONDITION',
+    'DATA_SOURCE_BINDING',
+    'NOTIFY_WEBHOOK_BINDING',
+];
+const INSTANCE_ROOTS = [
+    'env',
+    'form',
+    'formData',
+    'initiator',
+    'instance',
+];
+/**
+ * The root identifiers each use point evaluates with. Mirrors what the engine
+ * hands over at each point (workflow-engine `buildInitiatorPolicyContext`,
+ * `buildWorkflowExpressionContext`, the edge `lastDecision`, the delegation
+ * `principal`), so the lint refuses exactly what could only fail at run time.
+ */
+exports.EXPRESSION_ROOT_IDENTIFIERS_BY_USAGE_POINT = {
+    APPROVER_RESOLVER: INSTANCE_ROOTS,
+    DATA_SOURCE_BINDING: ['form', 'row'],
+    DELEGATION_CONDITION: [...INSTANCE_ROOTS, 'principal'],
+    ENTRY_CONDITION: INSTANCE_ROOTS,
+    FLOW_CONDITION: [...INSTANCE_ROOTS, 'lastDecision'],
+    INITIATOR_POLICY: ['env', 'initiator', 'subject'],
+    NOTIFY_WEBHOOK_BINDING: ['form'],
+    SERVICE_FORM_FIELD_VALUE: INSTANCE_ROOTS,
+    WEBHOOK_PAYLOAD: INSTANCE_ROOTS,
+};
+/**
+ * Use points that may only call the built-in functions (docs/24 §1: bindings
+ * get host functions later, if ever; widening is additive, narrowing is not).
+ */
+exports.EXPRESSION_USAGE_POINTS_WITHOUT_HOST_FUNCTIONS = ['DATA_SOURCE_BINDING', 'NOTIFY_WEBHOOK_BINDING'];
+const isExpressionUsagePoint = (value) => typeof value === 'string' &&
+    exports.EXPRESSION_USAGE_POINTS.includes(value);
+exports.isExpressionUsagePoint = isExpressionUsagePoint;
+const allowsHostExpressionFunctions = (usagePoint) => !exports.EXPRESSION_USAGE_POINTS_WITHOUT_HOST_FUNCTIONS.includes(usagePoint);
+exports.allowsHostExpressionFunctions = allowsHostExpressionFunctions;
+/**
+ * Lint findings that refuse a publish (docs/24 §2.2). Publish, the preview's
+ * LINT mode and the NOTIFY catalog share this one list.
+ */
+exports.EXPRESSION_LINT_ERROR_CODES = [
+    'EXPR_PARSE_FAILED',
+    'EXPR_ROOT_NOT_ALLOWED',
+    'EXPR_WHOLE_FORM_REFERENCE',
+    'EXPR_COMPUTED_KEY',
+    'EXPR_RESERVED_PATH_SEGMENT',
+    'EXPR_COMPLEXITY_EXCEEDED',
+    'EXPR_COMPREHENSION_NESTING',
+    'EXPR_FIELD_UNKNOWN',
+    'EXPR_FIELD_TYPE_MISMATCH',
+    'EXPR_RESULT_TYPE_MISMATCH',
+    'EXPR_FUNCTION_NOT_REGISTERED',
+    'EXPR_FUNCTION_NOT_ALLOWED',
+];
+/**
+ * Lint findings that only warn. `EXPR_DIVISOR_IS_FIELD` is the warning
+ * docs/24 §2.1 asks for (a `double` divided by a zero field is `Infinity` in
+ * cel-v2, which a comparison quietly turns into a routing decision; P1 P35).
+ * `EXPR_LAST_DECISION_UNAVAILABLE` is an edge condition that reads
+ * `lastDecision` on an edge leaving a node without tasks (a gateway, a
+ * service task, the start): no decision is made there, so it is always
+ * `null` at run time (Phase 23 P2 live finding, P4).
+ */
+exports.EXPRESSION_LINT_WARNING_CODES = [
+    'EXPR_OPTIONAL_FIELD_WITHOUT_HAS',
+    'EXPR_OR_ABSORBS_ERROR',
+    'EXPR_HAS_NESTED_PARENT',
+    'EXPR_APPROVER_READS_FORM',
+    'EXPR_HIDDEN_FIELD_COPIED',
+    'EXPR_DIVISOR_IS_FIELD',
+    'EXPR_LAST_DECISION_UNAVAILABLE',
+];
+exports.EXPRESSION_LINT_SUBJECT_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/u;
+const EXPRESSION_LINT_CODES = [
+    ...exports.EXPRESSION_LINT_ERROR_CODES,
+    ...exports.EXPRESSION_LINT_WARNING_CODES,
+];
+const isExpressionLintCode = (value) => typeof value === 'string' && EXPRESSION_LINT_CODES.includes(value);
+exports.isExpressionLintCode = isExpressionLintCode;
+const readExpressionLintSeverity = (code) => exports.EXPRESSION_LINT_WARNING_CODES.includes(code)
+    ? 'WARNING'
+    : 'ERROR';
+exports.readExpressionLintSeverity = readExpressionLintSeverity;
+/**
+ * The publish-lint line for a finding: `<label>: <code>` or
+ * `<label>: <code> <subject>`. The designer parses it back with
+ * {@link parseExpressionLintLine} to show its own copy.
+ */
+const formatExpressionLintIssue = (issue) => issue.subject !== undefined &&
+    exports.EXPRESSION_LINT_SUBJECT_PATTERN.test(issue.subject)
+    ? `${issue.label}: ${issue.code} ${issue.subject}`
+    : `${issue.label}: ${issue.code}`;
+exports.formatExpressionLintIssue = formatExpressionLintIssue;
+const EXPRESSION_LINT_LINE_PATTERN = /^(.+): (EXPR_[A-Z_]+)(?: ([A-Za-z_][A-Za-z0-9_]*))?$/u;
+/** The parts of a line {@link formatExpressionLintIssue} wrote, or `null`. */
+const parseExpressionLintLine = (line) => {
+    var _a;
+    const match = EXPRESSION_LINT_LINE_PATTERN.exec(line);
+    if (!match || !(0, exports.isExpressionLintCode)(match[2])) {
+        return null;
+    }
+    return {
+        code: match[2],
+        label: match[1],
+        subject: (_a = match[3]) !== null && _a !== void 0 ? _a : null,
+    };
+};
+exports.parseExpressionLintLine = parseExpressionLintLine;
+/**
+ * The publish-lint line for a definition whose `expressionDialect` this
+ * version does not know (Phase 23 P2). Shared so the designer can match it.
+ */
+exports.UNKNOWN_EXPRESSION_DIALECT_LINT_MESSAGE = 'workflow.expressionDialect must be cel-legacy or cel-v2';
+//# sourceMappingURL=expression-usage-point.js.map

package/src/lib/expression-usage-point.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-usage-point.js","sourceRoot":"","sources":["../../../../../libs/shared/src/lib/expression-usage-point.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,uBAAuB,GAAG;IACrC,kBAAkB;IAClB,iBAAiB;IACjB,gBAAgB;IAChB,mBAAmB;IACnB,0BAA0B;IAC1B,iBAAiB;IACjB,sBAAsB;IACtB,qBAAqB;IACrB,wBAAwB;CAChB,CAAC;AAIX,MAAM,cAAc,GAAG;IACrB,KAAK;IACL,MAAM;IACN,UAAU;IACV,WAAW;IACX,UAAU;CACF,CAAC;AAEX;;;;;GAKG;AACU,QAAA,0CAA0C,GAEnD;IACF,iBAAiB,EAAE,cAAc;IACjC,mBAAmB,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;IACpC,oBAAoB,EAAE,CAAC,GAAG,cAAc,EAAE,WAAW,CAAC;IACtD,eAAe,EAAE,cAAc;IAC/B,cAAc,EAAE,CAAC,GAAG,cAAc,EAAE,cAAc,CAAC;IACnD,gBAAgB,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,CAAC;IACjD,sBAAsB,EAAE,CAAC,MAAM,CAAC;IAChC,wBAAwB,EAAE,cAAc;IACxC,eAAe,EAAE,cAAc;CAChC,CAAC;AAEF;;;GAGG;AACU,QAAA,8CAA8C,GACzD,CAAC,qBAAqB,EAAE,wBAAwB,CAAC,CAAC;AAE7C,MAAM,sBAAsB,GAAG,CACpC,KAAc,EACiB,EAAE,CACjC,OAAO,KAAK,KAAK,QAAQ;IACxB,+BAA6C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAJpD,QAAA,sBAAsB,0BAI8B;AAE1D,MAAM,6BAA6B,GAAG,CAC3C,UAAgC,EACvB,EAAE,CACX,CAAC,sDAA8C,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAH1D,QAAA,6BAA6B,iCAG6B;AAEvE;;;GAGG;AACU,QAAA,2BAA2B,GAAG;IACzC,mBAAmB;IACnB,uBAAuB;IACvB,2BAA2B;IAC3B,mBAAmB;IACnB,4BAA4B;IAC5B,0BAA0B;IAC1B,4BAA4B;IAC5B,oBAAoB;IACpB,0BAA0B;IAC1B,2BAA2B;IAC3B,8BAA8B;IAC9B,2BAA2B;CACnB,CAAC;AAEX;;;;;;;;GAQG;AACU,QAAA,6BAA6B,GAAG;IAC3C,iCAAiC;IACjC,uBAAuB;IACvB,wBAAwB;IACxB,0BAA0B;IAC1B,0BAA0B;IAC1B,uBAAuB;IACvB,gCAAgC;CACxB,CAAC;AA0BE,QAAA,+BAA+B,GAAG,2BAA2B,CAAC;AAE3E,MAAM,qBAAqB,GAAsB;IAC/C,GAAG,mCAA2B;IAC9B,GAAG,qCAA6B;CACjC,CAAC;AAEK,MAAM,oBAAoB,GAAG,CAClC,KAAc,EACe,EAAE,CAC/B,OAAO,KAAK,KAAK,QAAQ,IAAI,qBAAqB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAHxD,QAAA,oBAAoB,wBAGoC;AAE9D,MAAM,0BAA0B,GAAG,CACxC,IAAwB,EACA,EAAE,CACzB,qCAAmD,CAAC,QAAQ,CAAC,IAAI,CAAC;IACjE,CAAC,CAAC,SAAS;IACX,CAAC,CAAC,OAAO,CAAC;AALD,QAAA,0BAA0B,8BAKzB;AAEd;;;;GAIG;AACI,MAAM,yBAAyB,GAAG,CACvC,KAA0B,EAClB,EAAE,CACV,KAAK,CAAC,OAAO,KAAK,SAAS;IAC3B,uCAA+B,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;IACjD,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE;IAClD,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;AANzB,QAAA,yBAAyB,6BAMA;AAQtC,MAAM,4BAA4B,GAChC,uDAAuD,CAAC;AAE1D,8EAA8E;AACvE,MAAM,uBAAuB,GAAG,CACrC,IAAY,EACqB,EAAE;;IACnC,MAAM,KAAK,GAAG,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEtD,IAAI,CAAC,KAAK,IAAI,CAAC,IAAA,4BAAoB,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACd,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACf,OAAO,EAAE,MAAA,KAAK,CAAC,CAAC,CAAC,mCAAI,IAAI;KAC1B,CAAC;AACJ,CAAC,CAAC;AAdW,QAAA,uBAAuB,2BAclC;AAEF;;;GAGG;AACU,QAAA,uCAAuC,GAClD,yDAAyD,CAAC"}

package/src/lib/form.d.ts

@@ -72,7 +72,24 @@ export type FormDataSourceBindingSource = {
 } | {
     readonly columnKey: string;
     readonly kind: 'ROW_FIELD';
+} | {
+    /**
+     * A cel-v2 expression over `form` (and `row` inside a table column)
+     * whose result fills the parameter (ADR 22 §3.7). Always cel-v2, built-in
+     * functions only; evaluated only by the backend, from the stored schema.
+     */
+    readonly expression: string;
+    readonly kind: 'EXPRESSION';
 };
+/** Every `FormDataSourceBindingSource` kind this version understands. */
+export declare const FORM_DATA_SOURCE_BINDING_KINDS: readonly ["CONSTANT", "EXPRESSION", "FIELD", "ROW_FIELD"];
+export type FormDataSourceBindingKind = (typeof FORM_DATA_SOURCE_BINDING_KINDS)[number];
+/**
+ * Whether `kind` is a binding source this version understands. A schema
+ * written by a newer version may carry one it does not; readers must treat
+ * that binding as unusable instead of guessing (docs/24 §2.8).
+ */
+export declare const isFormDataSourceBindingKind: (kind: unknown) => kind is FormDataSourceBindingKind;
 export interface FormDataSourceBinding {
     readonly from: FormDataSourceBindingSource;
     readonly parameter: string;
@@ -114,6 +131,13 @@ export type FormDataSourceValueSnapshot = {
 };
 export type FormDataSourceValueSnapshots = Readonly<Record<string, FormDataSourceValueSnapshot>>;
 export type BooleanFieldDefinition = BaseFormFieldDefinition<'boolean'>;
+/**
+ * Leads the message of a submission the server refuses because a
+ * `file_upload` value names an attachment the case may not take: one uploaded
+ * by someone other than its applicant, or one that belongs to another case.
+ * A client matches it to show its own copy instead of the server's text.
+ */
+export declare const ATTACHMENT_NOT_BINDABLE_ERROR_CODE = "ATTACHMENT_NOT_BINDABLE";
 export type FileUploadFieldDefinition = BaseFormFieldDefinition<'file_upload'> & {
     readonly acceptedMimeTypes?: readonly string[];
     readonly maxFiles?: number;

package/src/lib/form.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TEXT_FIELD_PATTERN_ERROR_MESSAGE_MAX_LENGTH = exports.TEXT_FIELD_PATTERN_MAX_LENGTH = exports.TEXT_FIELD_PATTERN_TIME_BUDGET_MS = exports.FORM_TABLE_MAX_ROWS = exports.TABLE_COLUMN_FIELD_TYPES = void 0;
+exports.TEXT_FIELD_PATTERN_ERROR_MESSAGE_MAX_LENGTH = exports.TEXT_FIELD_PATTERN_MAX_LENGTH = exports.TEXT_FIELD_PATTERN_TIME_BUDGET_MS = exports.FORM_TABLE_MAX_ROWS = exports.TABLE_COLUMN_FIELD_TYPES = exports.ATTACHMENT_NOT_BINDABLE_ERROR_CODE = exports.isFormDataSourceBindingKind = exports.FORM_DATA_SOURCE_BINDING_KINDS = void 0;
 exports.isFormOptionFieldDefinition = isFormOptionFieldDefinition;
 exports.isMemberFieldDefinition = isMemberFieldDefinition;
 exports.isOrgUnitFieldDefinition = isOrgUnitFieldDefinition;
@@ -21,6 +21,28 @@ exports.isFormDataSourceFieldDefinition = isFormDataSourceFieldDefinition;
 exports.isFormStaticOptionFieldDefinition = isFormStaticOptionFieldDefinition;
 exports.readFormFieldSelectionMode = readFormFieldSelectionMode;
 exports.normalizeFormDefinitionSchema = normalizeFormDefinitionSchema;
+/** Every `FormDataSourceBindingSource` kind this version understands. */
+exports.FORM_DATA_SOURCE_BINDING_KINDS = [
+    'CONSTANT',
+    'EXPRESSION',
+    'FIELD',
+    'ROW_FIELD',
+];
+/**
+ * Whether `kind` is a binding source this version understands. A schema
+ * written by a newer version may carry one it does not; readers must treat
+ * that binding as unusable instead of guessing (docs/24 §2.8).
+ */
+const isFormDataSourceBindingKind = (kind) => typeof kind === 'string' &&
+    exports.FORM_DATA_SOURCE_BINDING_KINDS.includes(kind);
+exports.isFormDataSourceBindingKind = isFormDataSourceBindingKind;
+/**
+ * Leads the message of a submission the server refuses because a
+ * `file_upload` value names an attachment the case may not take: one uploaded
+ * by someone other than its applicant, or one that belongs to another case.
+ * A client matches it to show its own copy instead of the server's text.
+ */
+exports.ATTACHMENT_NOT_BINDABLE_ERROR_CODE = 'ATTACHMENT_NOT_BINDABLE';
 /**
  * The column types the structural lint accepts. `text` is listed without
  * `textarea` on purpose — {@link TextFieldDefinition} covers both, and only

package/src/lib/form.js.map

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

package/src/lib/workflow-graph.d.ts

@@ -49,6 +49,16 @@ export declare const WORKFLOW_EXPRESSION_LABELS: Readonly<{
     nodeApproverResolverExpression: (nodeId: string) => string;
     nodeEntryCondition: (nodeId: string) => string;
 }>;
+/**
+ * Node types whose completion records a decision, which is what `lastDecision`
+ * reads on the edges leaving them. Every other node (a gateway, a service
+ * task, the start) has no task, so on its outgoing edges `lastDecision` is
+ * always `null` at run time; the expression lint warns about reading it there
+ * (`EXPR_LAST_DECISION_UNAVAILABLE`).
+ */
+export declare const WORKFLOW_DECISION_NODE_TYPES: readonly WorkflowNode['type'][];
+/** Whether an edge leaving a node of this type has a `lastDecision` to read. */
+export declare function hasWorkflowLastDecision(nodeType: string): boolean;
 /**
  * The structural lines of the backend publish lint (`lintWorkflowDefinition`
  * in `@rytass/bpm-core-nestjs-module`). The backend writes them from here and
@@ -311,7 +321,7 @@ export declare const NOTIFY_WEBHOOK_TARGET_LIMIT = 10;
 export declare const NOTIFY_WEBHOOK_ENDPOINT_VERSION_MAX = 2147483647;
 export declare const NOTIFY_WEBHOOK_CONTEXT_PATHS: readonly NotifyWebhookContextPath[];
 export type NotifyWebhookTargetIdFactory = () => string;
-export type NotifyWebhookStructureIssueCode = 'BINDING_CONSTANT_INVALID' | 'BINDING_CONTEXT_PATH_INVALID' | 'BINDING_FIELD_KEY_REQUIRED' | 'BINDING_INVALID' | 'BINDING_PARAMETER_DUPLICATE' | 'BINDING_PARAMETER_REQUIRED' | 'BINDING_SOURCE_INVALID' | 'BINDINGS_NOT_ARRAY' | 'ENDPOINT_KEY_REQUIRED' | 'ENDPOINT_VERSION_INVALID' | 'TARGET_ID_DUPLICATE' | 'TARGET_ID_REQUIRED' | 'TARGET_INVALID' | 'TARGET_LIMIT_EXCEEDED' | 'UNKNOWN_PROPERTY' | 'WEBHOOKS_NOT_ARRAY';
+export type NotifyWebhookStructureIssueCode = 'BINDING_CONSTANT_INVALID' | 'BINDING_CONTEXT_PATH_INVALID' | 'BINDING_EXPRESSION_REQUIRED' | 'BINDING_FIELD_KEY_REQUIRED' | 'BINDING_INVALID' | 'BINDING_PARAMETER_DUPLICATE' | 'BINDING_PARAMETER_REQUIRED' | 'BINDING_SOURCE_INVALID' | 'BINDINGS_NOT_ARRAY' | 'ENDPOINT_KEY_REQUIRED' | 'ENDPOINT_VERSION_INVALID' | 'TARGET_ID_DUPLICATE' | 'TARGET_ID_REQUIRED' | 'TARGET_INVALID' | 'TARGET_LIMIT_EXCEEDED' | 'UNKNOWN_PROPERTY' | 'WEBHOOKS_NOT_ARRAY';
 /**
  * A registry-independent shape problem in a NOTIFY node's `webhooks`.
  *

package/src/lib/workflow-graph.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NOTIFY_WEBHOOK_CONTEXT_PATHS = exports.NOTIFY_WEBHOOK_ENDPOINT_VERSION_MAX = exports.NOTIFY_WEBHOOK_TARGET_LIMIT = exports.DEFAULT_MANAGER_RESOLVER = exports.CONDITION_OPERATORS_REQUIRING_VALUE = exports.DEFAULT_QUORUM_THRESHOLD = exports.DEFAULT_SLA_CONFIG = exports.SLA_TIMEOUT_ACTION_OPTIONS = exports.SLA_CALENDAR_MODE_OPTIONS = exports.SLA_DURATION_UNIT_OPTIONS = exports.CONDITION_OPERATOR_OPTIONS = exports.WORKFLOW_LINT_MESSAGES = exports.WORKFLOW_EXPRESSION_LABELS = exports.APPLICANT_FIELD_CONDITION_RULES = exports.APPROVER_FILLED_FORM_RULES = exports.WORKFLOW_NODE_TYPE_LABELS = exports.WORKFLOW_OUTPUT_HANDLE_ID = exports.WORKFLOW_INPUT_HANDLE_ID = exports.EXCLUDE_INITIATOR_WHEN_EMPTY_VALUES = void 0;
+exports.NOTIFY_WEBHOOK_CONTEXT_PATHS = exports.NOTIFY_WEBHOOK_ENDPOINT_VERSION_MAX = exports.NOTIFY_WEBHOOK_TARGET_LIMIT = exports.DEFAULT_MANAGER_RESOLVER = exports.CONDITION_OPERATORS_REQUIRING_VALUE = exports.DEFAULT_QUORUM_THRESHOLD = exports.DEFAULT_SLA_CONFIG = exports.SLA_TIMEOUT_ACTION_OPTIONS = exports.SLA_CALENDAR_MODE_OPTIONS = exports.SLA_DURATION_UNIT_OPTIONS = exports.CONDITION_OPERATOR_OPTIONS = exports.WORKFLOW_LINT_MESSAGES = exports.WORKFLOW_DECISION_NODE_TYPES = exports.WORKFLOW_EXPRESSION_LABELS = exports.APPLICANT_FIELD_CONDITION_RULES = exports.APPROVER_FILLED_FORM_RULES = exports.WORKFLOW_NODE_TYPE_LABELS = exports.WORKFLOW_OUTPUT_HANDLE_ID = exports.WORKFLOW_INPUT_HANDLE_ID = exports.EXCLUDE_INITIATOR_WHEN_EMPTY_VALUES = void 0;
+exports.hasWorkflowLastDecision = hasWorkflowLastDecision;
 exports.composeSlaDuration = composeSlaDuration;
 exports.composeQuorumThreshold = composeQuorumThreshold;
 exports.readDesignTimeApproverCount = readDesignTimeApproverCount;
@@ -122,6 +123,18 @@ exports.WORKFLOW_EXPRESSION_LABELS = Object.freeze({
     nodeApproverResolverExpression: (nodeId) => `workflow.nodes.${nodeId}.data.approverResolver.expression`,
     nodeEntryCondition: (nodeId) => `workflow.nodes.${nodeId}.data.entryCondition`,
 });
+/**
+ * Node types whose completion records a decision, which is what `lastDecision`
+ * reads on the edges leaving them. Every other node (a gateway, a service
+ * task, the start) has no task, so on its outgoing edges `lastDecision` is
+ * always `null` at run time; the expression lint warns about reading it there
+ * (`EXPR_LAST_DECISION_UNAVAILABLE`).
+ */
+exports.WORKFLOW_DECISION_NODE_TYPES = Object.freeze(['userTask']);
+/** Whether an edge leaving a node of this type has a `lastDecision` to read. */
+function hasWorkflowLastDecision(nodeType) {
+    return exports.WORKFLOW_DECISION_NODE_TYPES.includes(nodeType);
+}
 /**
  * The structural lines of the backend publish lint (`lintWorkflowDefinition`
  * in `@rytass/bpm-core-nestjs-module`). The backend writes them from here and
@@ -1111,11 +1124,20 @@ function readNotifyWebhookTargetCatalogIssues({ endpoint, formFields, target, })
                 ? []
                 : [createNotifyWebhookCatalogIssue('CONSTANT_INCOMPATIBLE', typed)];
         }
-        // Every CONTEXT path resolves to a string, so anything but a string or
-        // an opaque json parameter is a mistake the author should see.
-        return parameter.type === 'string' || parameter.type === 'json'
-            ? []
-            : [createNotifyWebhookCatalogIssue('CONTEXT_INCOMPATIBLE', typed)];
+        if (from.kind === 'CONTEXT') {
+            // Every CONTEXT path resolves to a string, so anything but a string
+            // or an opaque json parameter is a mistake the author should see.
+            return parameter.type === 'string' || parameter.type === 'json'
+                ? []
+                : [createNotifyWebhookCatalogIssue('CONTEXT_INCOMPATIBLE', typed)];
+        }
+        if (from.kind === 'EXPRESSION') {
+            // The browser never parses CEL (docs/24 §2.5): whether the result
+            // fits the parameter is the backend publish lint's call
+            // (`EXPR_RESULT_TYPE_MISMATCH`), against the same endpoint.
+            return [];
+        }
+        return rejectUnknownNotifyWebhookSource(from);
     });
     return [...requiredIssues, ...bindingIssues];
 }
@@ -1147,6 +1169,12 @@ function readNotifyWebhookCatalogIssueMessage({ endpointLabel, issue, nodeLabel,
             return `${target}的${parameter}無法使用案件資訊（案件資訊皆為文字）。`;
     }
 }
+function rejectUnknownNotifyWebhookSource(from) {
+    void from;
+    // Unreachable for a structurally valid target; a kind this version does not
+    // know is never read as some other kind.
+    return [];
+}
 function createNotifyWebhookCatalogIssue(code, location = {}) {
     var _a, _b, _c, _d, _e;
     return {
@@ -1245,10 +1273,14 @@ const BINDING_PROPERTIES = ['from', 'parameter'];
 const SOURCE_PROPERTIES = {
     CONSTANT: ['kind', 'value'],
     CONTEXT: ['kind', 'path'],
+    EXPRESSION: ['expression', 'kind'],
     FIELD: ['fieldKey', 'kind'],
 };
 function isNotifyWebhookSourceKind(value) {
-    return value === 'CONSTANT' || value === 'CONTEXT' || value === 'FIELD';
+    return (value === 'CONSTANT' ||
+        value === 'CONTEXT' ||
+        value === 'EXPRESSION' ||
+        value === 'FIELD');
 }
 function readUnknownProperties(value, allowed, prefix) {
     // A key holding `undefined` disappears in JSON, so the backend never sees
@@ -1281,6 +1313,14 @@ function readNotifyWebhookSourceIssues(source, location) {
             ? []
             : [createNotifyWebhookIssue('BINDING_CONSTANT_INVALID', location)];
     }
+    // Only the shape: a non-blank string. Roots, fields, functions and the
+    // result type are the backend publish lint's (ADR 22 §3.7).
+    if (source['kind'] === 'EXPRESSION') {
+        const expression = source['expression'];
+        return typeof expression === 'string' && expression.trim()
+            ? []
+            : [createNotifyWebhookIssue('BINDING_EXPRESSION_REQUIRED', location)];
+    }
     return [createNotifyWebhookIssue('BINDING_SOURCE_INVALID', location)];
 }
 function createNotifyWebhookIssue(code, location = {}) {
@@ -1297,7 +1337,7 @@ function isPlainRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
 function readNotifyWebhookIssueMessage(issue, nodeLabel) {
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c, _d, _e, _f;
     const target = issue.targetIndex === null
         ? `知會節點「${nodeLabel}」`
         : `知會節點「${nodeLabel}」的第 ${issue.targetIndex + 1} 個 Webhook`;
@@ -1317,8 +1357,10 @@ function readNotifyWebhookIssueMessage(issue, nodeLabel) {
             return `${target}的參數「${(_c = issue.parameter) !== null && _c !== void 0 ? _c : ''}」需要選擇案件資訊。`;
         case 'BINDING_CONSTANT_INVALID':
             return `${target}的參數「${(_d = issue.parameter) !== null && _d !== void 0 ? _d : ''}」固定值格式錯誤。`;
+        case 'BINDING_EXPRESSION_REQUIRED':
+            return `${target}的參數「${(_e = issue.parameter) !== null && _e !== void 0 ? _e : ''}」需要填寫運算式。`;
         case 'UNKNOWN_PROPERTY':
-            return `${target}包含不支援的設定「${(_e = issue.property) !== null && _e !== void 0 ? _e : ''}」，請移除後重新新增。`;
+            return `${target}包含不支援的設定「${(_f = issue.property) !== null && _f !== void 0 ? _f : ''}」，請移除後重新新增。`;
         default:
             return `${target}設定格式錯誤，請移除後重新新增。`;
     }