openxiangda-contracts 2.78.0 → 2.81.0

package/dist/native-compiler/resource-query.d.ts

@@ -0,0 +1,21 @@
+import type { DataResourceSurface } from '../surface.js';
+import type { DataWhere } from '../types.js';
+export interface GenericResourceQuery {
+    page: number;
+    pageSize: number;
+    keyword?: string;
+    filters?: Record<string, unknown>;
+    sort?: ResourceSort;
+    sorts?: ResourceSort[];
+    where?: DataWhere;
+    /** “我的记录”标准页使用：按系统字段 created_by 精确过滤，不放宽其他系统字段。 */
+    createdBy?: string;
+}
+export interface ResourceSort {
+    field: string;
+    order: 'asc' | 'desc';
+}
+export declare function buildResourceWhere(resourceCode: string, surface: DataResourceSurface, query: GenericResourceQuery): DataWhere | undefined;
+/** Preserve the canonical logical tree while reducing field-kit selections to stable query values. */
+export declare function compileAdvancedWhere(code: string, surface: DataResourceSurface, node: DataWhere): DataWhere;
+//# sourceMappingURL=resource-query.d.ts.map

package/dist/native-compiler/resource-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-query.d.ts","sourceRoot":"","sources":["../../src/native-compiler/resource-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAQ7C,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE;AActE,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,oBAAoB,GAC1B,SAAS,GAAG,SAAS,CA6GvB;AAED,sGAAsG;AACtG,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,SAAS,GAAG,SAAS,CA8B3G"}

package/dist/native-compiler/resource-query.js

@@ -0,0 +1,154 @@
+import { cascadeTerminalValues, } from './cascade-value.js';
+import { deepestAddressPredicate } from './address-value.js';
+function isSelectionSnapshot(value) {
+    return Boolean(value && typeof value === 'object' && !Array.isArray(value) && 'value' in value);
+}
+function stableValue(value) {
+    return isSelectionSnapshot(value) ? String(value.value) : value;
+}
+function stableValues(value) {
+    return (Array.isArray(value) ? value : [value]).map(stableValue);
+}
+export function buildResourceWhere(resourceCode, surface, query) {
+    const declaredFields = new Set(Object.keys(surface.fields));
+    const assertField = (field) => {
+        if (!declaredFields.has(field)) {
+            throw new Error(`OPENXIANGDA_RESOURCE_QUERY_FIELD_NOT_DECLARED:${resourceCode}:${field}`);
+        }
+        return field;
+    };
+    const predicates = query.where ? [compileAdvancedWhere(resourceCode, surface, query.where)] : [];
+    if (query.createdBy !== undefined && query.createdBy !== '') {
+        predicates.push({ field: 'created_by', operator: 'eq', value: query.createdBy });
+    }
+    if (query.keyword?.trim()) {
+        const searchable = (surface.list?.searchableFields || []).filter(field => declaredFields.has(field));
+        if (searchable.length) {
+            predicates.push({
+                or: searchable.map(field => ({
+                    field: assertField(field),
+                    operator: 'contains',
+                    value: query.keyword.trim(),
+                })),
+            });
+        }
+    }
+    for (const [fieldCode, value] of Object.entries(query.filters || {})) {
+        if (value === undefined ||
+            value === null ||
+            value === '' ||
+            (Array.isArray(value) && value.length === 0))
+            continue;
+        // A list state can outlive a resource route during client-side navigation.
+        if (!declaredFields.has(fieldCode))
+            continue;
+        const field = surface.fields[fieldCode];
+        if (!field)
+            continue;
+        if (field.type === 'json') {
+            predicates.push({
+                field: fieldCode,
+                operator: 'jsonContains',
+                value,
+            });
+        }
+        else if (field.type === 'address') {
+            const address = deepestAddressPredicate(value);
+            if (address) {
+                predicates.push({
+                    field: fieldCode,
+                    operator: 'jsonContains',
+                    path: address.path,
+                    value: address.value,
+                });
+            }
+        }
+        else if (field.type === 'cascade.single' || field.type === 'cascade.multiple') {
+            const terminals = cascadeTerminalValues(value, field.type === 'cascade.multiple');
+            if (terminals.length) {
+                predicates.push({
+                    field: fieldCode,
+                    operator: field.type === 'cascade.multiple' ? 'hasAny' : 'has',
+                    value: field.type === 'cascade.multiple' ? terminals : terminals[0],
+                });
+            }
+        }
+        else if ((field.type === 'date-range' || field.type === 'datetime-range') &&
+            value !== null &&
+            typeof value === 'object' &&
+            !Array.isArray(value)) {
+            const range = value;
+            if (range.start !== undefined && range.end !== undefined) {
+                predicates.push({
+                    field: fieldCode,
+                    operator: 'overlaps',
+                    value: { start: range.start, end: range.end },
+                });
+            }
+        }
+        else if (Array.isArray(value) &&
+            value.length === 2 &&
+            ['date', 'datetime', 'number', 'money', 'percent'].includes(field.widget)) {
+            if (value[0] !== undefined && value[0] !== null && value[0] !== '') {
+                predicates.push({ field: fieldCode, operator: 'gte', value: value[0] });
+            }
+            if (value[1] !== undefined && value[1] !== null && value[1] !== '') {
+                predicates.push({ field: fieldCode, operator: 'lte', value: value[1] });
+            }
+        }
+        else if (field.type === 'option.multiple' ||
+            field.type === 'user.multiple' ||
+            field.type === 'department.multiple' ||
+            field.type === 'resource-ref.multiple') {
+            predicates.push({
+                field: fieldCode,
+                operator: 'hasAny',
+                value: stableValues(value),
+            });
+        }
+        else {
+            const [stable] = stableValues(value);
+            predicates.push({ field: fieldCode, operator: 'eq', value: stable });
+        }
+    }
+    return predicates.length ? { and: predicates } : undefined;
+}
+/** Preserve the canonical logical tree while reducing field-kit selections to stable query values. */
+export function compileAdvancedWhere(code, surface, node) {
+    if ('and' in node)
+        return { and: node.and.map(item => compileAdvancedWhere(code, surface, item)) };
+    if ('or' in node)
+        return { or: node.or.map(item => compileAdvancedWhere(code, surface, item)) };
+    if ('not' in node)
+        return { not: compileAdvancedWhere(code, surface, node.not) };
+    // A path already selects the canonical subvalue; top-level field control
+    // normalization must not replace its value or silently drop the path.
+    if (node.path !== undefined)
+        return node;
+    if (node.operator === 'isEmpty' || node.operator === 'isNotEmpty')
+        return { field: node.field, operator: node.operator };
+    const field = surface.fields[node.field];
+    if (node.operator === 'has') {
+        const cascadePath = field?.type === 'cascade.single' && Array.isArray(node.value) &&
+            node.value.length > 0 && node.value.every(isSelectionSnapshot);
+        return { ...node, value: cascadePath
+                ? cascadeTerminalValues(node.value, false)[0]
+                : stableValue(node.value) };
+    }
+    if (['in', 'between', 'hasAny', 'hasAll'].includes(node.operator)) {
+        // Explicit operators own operand cardinality. Do not apply shortcut
+        // filters, which infer hasAny or reduce a range to its first comparison.
+        if (!Array.isArray(node.value))
+            return node;
+        const cascadePaths = field?.type === 'cascade.multiple' &&
+            ['hasAny', 'hasAll'].includes(node.operator) && node.value.length > 0 &&
+            node.value.every(path => Array.isArray(path) && path.length > 0 && path.every(isSelectionSnapshot));
+        return { ...node, value: cascadePaths
+                ? cascadeTerminalValues(node.value, true)
+                : node.value.map(stableValue) };
+    }
+    const normalized = buildResourceWhere(code, surface, { page: 1, pageSize: 20, filters: { [node.field]: node.value } });
+    const predicate = normalized && 'and' in normalized ? normalized.and[0] : undefined;
+    return predicate && 'field' in predicate ? { ...predicate, operator: node.operator } : node;
+}
+//# sourceMappingURL=resource-query.js.map

package/dist/native-compiler/resource-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-query.js","sourceRoot":"","sources":["../../src/native-compiler/resource-query.ts"],"names":[],"mappings":"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"}

package/dist/native-compiler/workflow-approval-empty.d.ts

@@ -1,5 +1,5 @@
 /** Only these sources can currently attest a genuine empty approval result. */
-export declare const WORKFLOW_APPROVAL_EMPTY_PROVIDERS: readonly ["fixed_users", "input_users", "form_field_users", "app_role", "app_role_in_scope"];
+export declare const WORKFLOW_APPROVAL_EMPTY_PROVIDERS: readonly ["supervisor_chain", "fixed_users", "input_users", "form_field_users", "app_role", "app_role_in_scope"];
 type Node = {
     kind: string;
     emptyPolicy?: unknown;

package/dist/native-compiler/workflow-approval-empty.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-approval-empty.d.ts","sourceRoot":"","sources":["../../src/native-compiler/workflow-approval-empty.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,eAAO,MAAM,iCAAiC,8FAEpC,CAAC;AAEX,KAAK,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACtE,KAAK,UAAU,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;CAAE,CAAC;AACnD,KAAK,OAAO,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC;AAEnE,wBAAgB,mCAAmC,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAYvG;AAED,kFAAkF;AAClF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,UAAU,EAAE,OAAO,EAAE,CAAC;IACtB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB,GAAG,SAAS,GAAG,OAAO,CAOtB;AAED,0FAA0F;AAC1F,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAGpG"}
+{"version":3,"file":"workflow-approval-empty.d.ts","sourceRoot":"","sources":["../../src/native-compiler/workflow-approval-empty.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,eAAO,MAAM,iCAAiC,kHAEpC,CAAC;AAEX,KAAK,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACtE,KAAK,UAAU,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;CAAE,CAAC;AACnD,KAAK,OAAO,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC;AAEnE,wBAAgB,mCAAmC,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAYvG;AAED,kFAAkF;AAClF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,UAAU,EAAE,OAAO,EAAE,CAAC;IACtB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB,GAAG,SAAS,GAAG,OAAO,CAOtB;AAED,0FAA0F;AAC1F,wBAAgB,+BAA+B,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAGpG"}

package/dist/native-compiler/workflow-approval-empty.js

@@ -1,6 +1,6 @@
 /** Only these sources can currently attest a genuine empty approval result. */
 export const WORKFLOW_APPROVAL_EMPTY_PROVIDERS = [
-    'fixed_users', 'input_users', 'form_field_users', 'app_role', 'app_role_in_scope',
+    'supervisor_chain', 'fixed_users', 'input_users', 'form_field_users', 'app_role', 'app_role_in_scope',
 ];
 export function validateWorkflowApprovalEmptyPolicy(definition, binding) {
     const errors = [];

package/dist/native-compiler/workflow-approval-empty.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-approval-empty.js","sourceRoot":"","sources":["../../src/native-compiler/workflow-approval-empty.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,iCAAiC,GAAG;IAC/C,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,UAAU,EAAE,mBAAmB;CACzE,CAAC;AAMX,MAAM,UAAU,mCAAmC,CAAC,UAAsB,EAAE,OAAiB;IAC3F,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QACjE,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;YAAE,SAAS;QACnE,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAqB,CAAC,EAAE,CAAC;YACxF,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE,EAAE,CAAC,CAAC;QAC9D,CAAC;aAAM,IAAI,IAAI,CAAC,WAAW,KAAK,MAAM,IAAI,OAAO;YAC/C,CAAC,iCAAiC,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,QAAe,CAAC,EAAE,CAAC;YACvG,MAAM,CAAC,IAAI,CAAC,gDAAgD,EAAE,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,uBAAuB,CAAC,IAAU,EAAE,UAMvC;IACX,OAAO,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,WAAW,KAAK,MAAM;QAC5D,UAAU,EAAE,WAAW,KAAK,eAAe;QAC3C,iCAAiC,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAe,CAAC;QACtE,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAC1E,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QACtE,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC;AAC3E,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,+BAA+B,CAAC,UAAsB,EAAE,WAAmB;IACzF,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,WAAW,CAAC,CAAC;IACrG,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,WAAW,KAAK,MAAM,CAAC,CAAC;AAClH,CAAC"}
+{"version":3,"file":"workflow-approval-empty.js","sourceRoot":"","sources":["../../src/native-compiler/workflow-approval-empty.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,iCAAiC,GAAG;IAC/C,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,UAAU,EAAE,mBAAmB;CAC7F,CAAC;AAMX,MAAM,UAAU,mCAAmC,CAAC,UAAsB,EAAE,OAAiB;IAC3F,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QACjE,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;YAAE,SAAS;QACnE,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAqB,CAAC,EAAE,CAAC;YACxF,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE,EAAE,CAAC,CAAC;QAC9D,CAAC;aAAM,IAAI,IAAI,CAAC,WAAW,KAAK,MAAM,IAAI,OAAO;YAC/C,CAAC,iCAAiC,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,QAAe,CAAC,EAAE,CAAC;YACvG,MAAM,CAAC,IAAI,CAAC,gDAAgD,EAAE,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,uBAAuB,CAAC,IAAU,EAAE,UAMvC;IACX,OAAO,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,WAAW,KAAK,MAAM;QAC5D,UAAU,EAAE,WAAW,KAAK,eAAe;QAC3C,iCAAiC,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAe,CAAC;QACtE,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAC1E,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QACtE,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC;AAC3E,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,+BAA+B,CAAC,UAAsB,EAAE,WAAmB;IACzF,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,WAAW,CAAC,CAAC;IACrG,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,WAAW,KAAK,MAAM,CAAC,CAAC;AAClH,CAAC"}

package/dist/native-compiler/workflow-authoring.d.ts

@@ -0,0 +1,24 @@
+import type { WorkflowBinding, WorkflowBindingEntry, WorkflowDefinition, WorkflowNode, WorkflowConfigurableOperation } from '../types.js';
+import type { WorkflowBusinessStepNode } from './workflow-business-step.js';
+/** Released source declaration, including capabilities not yet used by the workflow. */
+export interface WorkflowAuthoring {
+    businessSteps?: Array<Omit<WorkflowBusinessStepNode, 'id' | 'kind' | 'next' | 'inputs' | 'notification'>>;
+}
+export interface WorkflowDesignerCatalog {
+    appVersionId: string;
+    digest: string;
+    taskPages: NonNullable<WorkflowDefinition['taskPages']>;
+    steps: NonNullable<WorkflowAuthoring['businessSteps']>;
+    peopleSources: WorkflowBinding['bindings'];
+}
+export declare const workflowCanvasBindingKey: (id: string) => string;
+export declare const workflowHumanOperations: (kind: "approval" | "handle", hasPage: boolean) => WorkflowConfigurableOperation[];
+export declare function workflowAuthoringCatalog(definition: WorkflowDefinition, binding: WorkflowBinding, appVersionId?: string, digest?: string): WorkflowDesignerCatalog;
+/** Standard blank nodes do not borrow authority from a previous human node. */
+export declare function createWorkflowHumanNode(id: string, kind: 'approval' | 'handle' | 'cc', title: string, next: string, pageCode?: string, pages?: WorkflowDesignerCatalog['taskPages'], rejectTarget?: string): WorkflowNode;
+export declare function validateWorkflowCanvasHuman(node: WorkflowNode, catalog: WorkflowDesignerCatalog): string[];
+/** New bindings can select principals or reuse a released source, never invent a provider implementation. */
+export declare function validateWorkflowCanvasBinding(entry: WorkflowBindingEntry, catalog: WorkflowDesignerCatalog, incomplete?: boolean): string[];
+/** Only unreferenced new canvas bindings are removed; released bindings keep their source identity. */
+export declare function pruneWorkflowCanvasBindings(definition: WorkflowDefinition, binding: WorkflowBinding, published: WorkflowBinding): WorkflowBinding;
+//# sourceMappingURL=workflow-authoring.d.ts.map

package/dist/native-compiler/workflow-authoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-authoring.d.ts","sourceRoot":"","sources":["../../src/native-compiler/workflow-authoring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,kBAAkB,EAAqB,YAAY,EAAE,6BAA6B,EAAmF,MAAM,aAAa,CAAC;AAC9O,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAI5E,wFAAwF;AACxF,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,wBAAwB,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,cAAc,CAAC,CAAC,CAAC;CAC3G;AACD,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,WAAW,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC;IACxD,KAAK,EAAE,WAAW,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC,CAAC;IACvD,aAAa,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;CAC5C;AACD,eAAO,MAAM,wBAAwB,GAAI,IAAI,MAAM,WAAmB,CAAC;AACvE,eAAO,MAAM,uBAAuB,GAAI,MAAM,UAAU,GAAG,QAAQ,EAAE,SAAS,OAAO,KAAG,6BAA6B,EAGpH,CAAC;AACF,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,kBAAkB,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,SAAK,EAAE,MAAM,SAAK,GAAG,uBAAuB,CAO1J;AACD,+EAA+E;AAC/E,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,uBAAuB,CAAC,WAAW,CAAM,EAAE,YAAY,SAAO,GAAG,YAAY,CAY3N;AAKD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,uBAAuB,GAAG,MAAM,EAAE,CAkB1G;AACD,6GAA6G;AAC7G,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,uBAAuB,EAAE,UAAU,UAAQ,GAAG,MAAM,EAAE,CASzI;AAED,uGAAuG;AACvG,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,kBAAkB,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,eAAe,GAAG,eAAe,CAEjJ"}

package/dist/native-compiler/workflow-authoring.js

@@ -0,0 +1,84 @@
+import { isWorkflowPlatformNotify } from './workflow-platform-notify.js';
+import { workflowOperationMinimumOpinion, workflowOperationOpinion } from './workflow-node-administration.js';
+export const workflowCanvasBindingKey = (id) => `canvas_${id}`;
+export const workflowHumanOperations = (kind, hasPage) => [
+    ...(kind === 'approval' ? ['approve', 'reject'] : ['complete']),
+    ...(hasPage ? ['save_form'] : []), 'return', 'transfer', 'delegate', ...(kind === 'approval' ? ['add_assignee'] : []),
+];
+export function workflowAuthoringCatalog(definition, binding, appVersionId = '', digest = '') {
+    const steps = new Map();
+    for (const node of [...Object.values(definition.nodes), ...definition.authoring?.businessSteps || []]) {
+        if (!('handler' in node) || isWorkflowPlatformNotify(node))
+            continue;
+        steps.set(`${node.handler.code}@${node.handler.version}`, { title: node.title, handler: node.handler, inputSchema: node.inputSchema, outputSchema: node.outputSchema });
+    }
+    return { appVersionId, digest, taskPages: definition.taskPages || {}, steps: [...steps.values()], peopleSources: binding.bindings };
+}
+/** Standard blank nodes do not borrow authority from a previous human node. */
+export function createWorkflowHumanNode(id, kind, title, next, pageCode, pages = {}, rejectTarget = next) {
+    const binding = workflowCanvasBindingKey(id);
+    if (kind === 'cc')
+        return { id, kind, title, next, binding, emptyPolicy: 'block', notify: true, administration: { assigneeProviders: ['fixed_users', 'app_role'] } };
+    const page = pageCode ? pages[pageCode] : undefined;
+    const operations = workflowHumanOperations(kind, !!page);
+    const human = { id, title, binding, mode: 'single', allowedOperations: operations, requiredOperations: [kind === 'approval' ? 'approve' : 'complete'],
+        administration: { modes: ['single', 'any', 'all', 'sequence'], assigneeProviders: ['fixed_users', 'app_role'], operations },
+        fieldPolicy: { default: 'readonly', fields: Object.fromEntries((page?.fields || []).map(field => [field.code, field.readonly ? 'readonly' : field.required ? 'edit_required' : 'edit'])) },
+        operationPolicy: { ...(kind === 'approval' ? { approve: { opinion: 'optional', minimumOpinion: 'optional' }, reject: { opinion: 'required', minimumOpinion: 'required' } } : { complete: { opinion: 'optional', minimumOpinion: 'optional' } }),
+            return: { opinion: 'required', minimumOpinion: 'required' }, transfer: { opinion: 'required', minimumOpinion: 'required' }, delegate: { opinion: 'required', minimumOpinion: 'required' }, ...(kind === 'approval' ? { add_assignee: { opinion: 'required', minimumOpinion: 'required' } } : {}) },
+        ...(page ? { taskPageCode: pageCode } : {}) };
+    return (kind === 'approval' ? { ...human, kind, onApprove: next, onReject: rejectTarget } : { ...human, kind, next });
+}
+const same = (a, b) => {
+    const sort = (v) => Array.isArray(v) ? v.map(sort) : v && typeof v === 'object' ? Object.fromEntries(Object.keys(v).sort().filter(key => v[key] !== undefined).map(key => [key, sort(v[key])])) : v;
+    return JSON.stringify(sort(a)) === JSON.stringify(sort(b));
+};
+export function validateWorkflowCanvasHuman(node, catalog) {
+    if (!['approval', 'handle', 'cc'].includes(node.kind) || !('binding' in node) || node.binding !== workflowCanvasBindingKey(node.id))
+        return ['WORKFLOW_DESIGNER_CANVAS_BINDING_REQUIRED'];
+    if (node.kind === 'cc')
+        return same(node.administration, { assigneeProviders: ['fixed_users', 'app_role'] }) ? [] : ['WORKFLOW_DESIGNER_CODE_OWNED:administration'];
+    if (node.kind !== 'approval' && node.kind !== 'handle')
+        return [];
+    const standard = createWorkflowHumanNode(node.id, node.kind, node.title, '', node.taskPageCode, catalog.taskPages);
+    const errors = [];
+    for (const key of ['administration', 'requiredOperations'])
+        if (!same(node[key], standard[key]))
+            errors.push(`WORKFLOW_DESIGNER_CODE_OWNED:${node.id}.${key}`);
+    if (node.taskPageCode && !catalog.taskPages[node.taskPageCode])
+        errors.push(`WORKFLOW_DESIGNER_PAGE_UNRELEASED:${node.id}`);
+    const ceiling = standard.fieldPolicy;
+    if (node.fieldPolicy?.default && node.fieldPolicy.default !== 'readonly')
+        errors.push(`WORKFLOW_DESIGNER_FIELD_CEILING:${node.id}`);
+    for (const [code, policy] of Object.entries(node.fieldPolicy?.fields || {}))
+        if (!(code in ceiling.fields) || !['readonly', 'edit', 'edit_required'].includes(policy) || ['edit', 'edit_required'].includes(policy) && ceiling.fields[code] === 'readonly')
+            errors.push(`WORKFLOW_DESIGNER_FIELD_CEILING:${node.id}.${code}`);
+    const operations = workflowHumanOperations(node.kind, !!node.taskPageCode);
+    if ((node.allowedOperations || operations).some(operation => !operations.includes(operation)))
+        errors.push(`WORKFLOW_DESIGNER_OPERATION_NOT_ALLOWED:${node.id}`);
+    for (const [operation, policy] of Object.entries(node.operationPolicy || {})) {
+        const baseline = standard.operationPolicy?.[operation];
+        if (!operations.includes(operation) || !same(policy.minimumOpinion, baseline?.minimumOpinion) || ['none', 'optional', 'required'].indexOf(workflowOperationOpinion(operation, policy)) < ['none', 'optional', 'required'].indexOf(workflowOperationMinimumOpinion(operation, baseline)))
+            errors.push(`WORKFLOW_DESIGNER_OPINION_MINIMUM:${node.id}.${operation}`);
+    }
+    return errors;
+}
+/** New bindings can select principals or reuse a released source, never invent a provider implementation. */
+export function validateWorkflowCanvasBinding(entry, catalog, incomplete = false) {
+    if (Object.values(catalog.peopleSources).some(source => same(source, entry)))
+        return [];
+    const keys = Object.keys(entry);
+    if (entry.provider === 'fixed_users' && keys.every(key => ['provider', 'users'].includes(key)) && Array.isArray(entry.users) && entry.users.length <= 200 && (incomplete || entry.users.length > 0) && new Set(entry.users).size === entry.users.length && entry.users.every(id => typeof id === 'string' && !!id.trim() && id.length <= 255))
+        return [];
+    if (entry.provider === 'app_role' && keys.every(key => ['provider', 'roleCode', 'roleCodes'].includes(key))) {
+        const roles = entry.roleCodes || (entry.roleCode ? [entry.roleCode] : []);
+        if (!(entry.roleCode && entry.roleCodes) && (incomplete || roles.length > 0) && roles.length <= 8 && new Set(roles).size === roles.length && roles.every(role => /^[a-z][a-z0-9_-]{0,127}$/.test(role)))
+            return [];
+    }
+    return ['WORKFLOW_DESIGNER_BINDING_UNRELEASED'];
+}
+/** Only unreferenced new canvas bindings are removed; released bindings keep their source identity. */
+export function pruneWorkflowCanvasBindings(definition, binding, published) {
+    return { ...binding, bindings: Object.fromEntries(Object.entries(binding.bindings).filter(([key]) => Object.hasOwn(published.bindings, key) || !key.startsWith('canvas_') || Object.values(definition.nodes).some(node => 'binding' in node && node.binding === key))) };
+}
+//# sourceMappingURL=workflow-authoring.js.map

package/dist/native-compiler/workflow-authoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-authoring.js","sourceRoot":"","sources":["../../src/native-compiler/workflow-authoring.ts"],"names":[],"mappings":"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"}

package/dist/native-compiler/workflow-business-step.d.ts

@@ -1,3 +1,4 @@
+import { type WorkflowPlatformNotification } from './workflow-platform-notify.js';
 export declare const WORKFLOW_BUSINESS_STEP_EVENT = "openxiangda.workflow.step.requested.v2";
 export declare const WORKFLOW_BUSINESS_STEP_EVENTS: readonly ["openxiangda.workflow.step.requested.v2", "openxiangda.workflow.step.result_received.v2", "openxiangda.workflow.step.completed.v2", "openxiangda.workflow.step.continuation_failed.v2"];
 export declare const WORKFLOW_BUSINESS_STEP_MAX_BYTES = 16384;
@@ -32,6 +33,7 @@ export interface WorkflowBusinessStepNode {
     inputSchema: Record<string, unknown>;
     outputSchema: Record<string, unknown>;
     inputs: Record<string, WorkflowBusinessStepInput>;
+    notification?: WorkflowPlatformNotification;
 }
 /** This result is authenticated by the claimed request event, never by a userId. */
 export interface WorkflowBusinessStepResult {
@@ -64,7 +66,7 @@ export interface WorkflowBusinessStepSummary {
     handlerVersion: number;
     mode?: WorkflowBusinessStepHandlerContract['mode'];
     nodeId?: string;
-    status: 'waiting' | 'result_ready' | 'completed' | 'cancelled';
+    status: 'waiting' | 'result_ready' | 'result_stale_inputs' | 'completed' | 'cancelled';
     inputDigest?: string;
     resultDigest?: string;
     expectedFactRevision?: number;
@@ -79,6 +81,7 @@ export interface WorkflowBusinessStepRecoveryOptions {
     status: string;
     canRetryBusinessStep: boolean;
     businessStep: WorkflowBusinessStepSummary | null;
+    businessSteps?: WorkflowBusinessStepSummary[];
 }
 export interface WorkflowBusinessStepRecoveryPreview {
     action: 'admin_retry_step';
@@ -92,10 +95,16 @@ export interface WorkflowBusinessStepRecoveryPreview {
         resultDigest: string;
         lastErrorCode?: string;
         continuationAttempts: number;
-        reexecutesBusinessHandler: false;
+        reexecutesBusinessHandler: boolean;
+        recovery?: 'continue' | 'recompute' | 'apply_stored';
+        inputsChanged?: boolean;
+        mode?: WorkflowBusinessStepHandlerContract['mode'];
     };
 }
 type Definition = {
+    authoring?: {
+        businessSteps?: Array<Record<string, any>>;
+    };
     code?: string;
     startAt?: string;
     inputSchema?: Record<string, any>;
@@ -111,6 +120,8 @@ export declare function validateWorkflowBusinessStepSchema(value: unknown): bool
 /** Business input stays closed; only the kernel adds committed step outputs. */
 export declare function workflowBusinessStepFactSchema(definition: Definition): Record<string, any>;
 export declare function validateWorkflowBusinessStepHandlerContract(value: unknown): value is WorkflowBusinessStepHandlerContract;
+/** Handler declarations not yet placed on a graph still need a released execution contract. */
+export declare function validateWorkflowAuthoringSteps(definition: Definition): string[];
 export declare function validateWorkflowBusinessSteps(definition: Definition, binding?: {
     bindings?: Record<string, Record<string, any>>;
 }): string[];

package/dist/native-compiler/workflow-business-step.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-business-step.d.ts","sourceRoot":"","sources":["../../src/native-compiler/workflow-business-step.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workflow-business-step.d.ts","sourceRoot":"","sources":["../../src/native-compiler/workflow-business-step.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4D,KAAK,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAE5I,eAAO,MAAM,4BAA4B,2CAA2C,CAAC;AACrF,eAAO,MAAM,6BAA6B,mMAAwL,CAAC;AACnO,eAAO,MAAM,gCAAgC,QAAS,CAAC;AACvD,eAAO,MAAM,wCAAwC,OAAQ,CAAC;AAC9D,eAAO,MAAM,gCAAgC,UAAU,CAAC;AAExD,MAAM,MAAM,yBAAyB,GACjC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAE1C,MAAM,WAAW,mCAAmC;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACnC,yEAAyE;IACzE,eAAe,CAAC,EAAE,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,mCAAmC,CAAC,MAAM,CAAC,CAAC;QAAC,eAAe,CAAC,EAAE,IAAI,CAAA;KAAE,CAAC;IACtH,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;IAClD,YAAY,CAAC,EAAE,4BAA4B,CAAC;CAC7C;AAED,oFAAoF;AACpF,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,mCAAmC,CAAC,MAAM,CAAC,CAAC;IAClD,eAAe,CAAC,EAAE,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,qFAAqF;AACrF,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,mCAAmC,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,cAAc,GAAG,qBAAqB,GAAG,WAAW,GAAG,WAAW,CAAC;IACvF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,mCAAmC;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,EAAE,OAAO,CAAC;IAC9B,YAAY,EAAE,2BAA2B,GAAG,IAAI,CAAC;IACjD,aAAa,CAAC,EAAE,2BAA2B,EAAE,CAAC;CAC/C;AACD,MAAM,WAAW,mCAAmC;IAClD,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,oBAAoB,EAAE,MAAM,CAAC;QAAC,yBAAyB,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,cAAc,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,mCAAmC,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC;CACnT;AAED,KAAK,UAAU,GAAG;IAChB,SAAS,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAC,GAAG,CAAC,CAAC,CAAA;KAAE,CAAC;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;CAC7C,CAAC;AA6BF,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,0BAA0B,CAOtG;AAED,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,2BAA2B,CAOxG;AAED,kFAAkF;AAClF,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,SAAmC,GAAG,OAAO,CAyB/I;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAGtE;AAED,qFAAqF;AACrF,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAsC1E;AAED,gFAAgF;AAChF,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAO1F;AAYD,wBAAgB,2CAA2C,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mCAAmC,CAMxH;AAmBD,+FAA+F;AAC/F,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,EAAE,CAc/E;AAED,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA;CAAE,GAAG,MAAM,EAAE,CAyE5I;AAED,qFAAqF;AACrF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASjI;AAED,wBAAgB,yCAAyC,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,EAAE,aAAa,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAAE,cAAc,EAAE,OAAO,GAAG,MAAM,EAAE,CAe9K;AAED,kFAAkF;AAClF,wBAAgB,mCAAmC,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,mCAAmC,CAAC,CAe3I"}

package/dist/native-compiler/workflow-business-step.js

@@ -1,3 +1,4 @@
+import { isWorkflowPlatformNotify, validateWorkflowPlatformNotify } from './workflow-platform-notify.js';
 export const WORKFLOW_BUSINESS_STEP_EVENT = 'openxiangda.workflow.step.requested.v2';
 export const WORKFLOW_BUSINESS_STEP_EVENTS = [WORKFLOW_BUSINESS_STEP_EVENT, 'openxiangda.workflow.step.result_received.v2', 'openxiangda.workflow.step.completed.v2', 'openxiangda.workflow.step.continuation_failed.v2'];
 export const WORKFLOW_BUSINESS_STEP_MAX_BYTES = 16_384;
@@ -193,9 +194,13 @@ export function validateWorkflowBusinessStepHandlerContract(value) {
 function targets(node) {
     if (node.kind === 'approval')
         return [node.onApprove, node.onReject];
+    if (node.kind === 'parallel')
+        return [...(Array.isArray(node.branches) ? node.branches.map((branch) => branch.target) : []), node.join];
+    if (node.kind === 'join')
+        return [node.next];
     if (node.kind === 'condition')
         return [...(Array.isArray(node.branches) ? node.branches.map((branch) => branch.target) : []), node.otherwise];
-    if (node.kind === 'cc' || node.kind === 'action')
+    if (node.kind === 'cc' || node.kind === 'action' || node.kind === 'handle')
         return [node.next];
     return [];
 }
@@ -206,6 +211,26 @@ function expressionPaths(value, depth = 0) {
         return typeof value.path === 'string' ? [value.path] : [];
     return ['left', 'right', 'value'].flatMap(key => expressionPaths(value[key], depth + 1)).concat(Array.isArray(value.values) ? value.values.flatMap(child => expressionPaths(child, depth + 1)) : []);
 }
+/** Handler declarations not yet placed on a graph still need a released execution contract. */
+export function validateWorkflowAuthoringSteps(definition) {
+    if (definition.authoring === undefined)
+        return [];
+    const authoring = definition.authoring;
+    if (!record(authoring) || Object.keys(authoring).some(key => key !== 'businessSteps') || authoring.businessSteps !== undefined && (!Array.isArray(authoring.businessSteps) || authoring.businessSteps.length > 100))
+        return ['WORKFLOW_AUTHORING_CATALOG_INVALID'];
+    const errors = [], codes = new Set();
+    for (const step of authoring.businessSteps || []) {
+        const handler = step?.handler;
+        if (!record(step) || Object.keys(step).some(key => !['title', 'handler', 'inputSchema', 'outputSchema'].includes(key)) || typeof step.title !== 'string' || !step.title.trim() || step.title.length > 160 ||
+            !record(handler) || Object.keys(handler).some(key => !['code', 'version', 'mode', 'dataTransaction'].includes(key)) || !Number.isSafeInteger(handler.version) || handler.version < 1 || handler.version > 1000000 ||
+            !/^[a-z][a-z0-9-]{0,100}$/.test(handler.code || '') || !handler.code.endsWith(`-v${handler.version}`) || !['pure', 'reconciled-effect'].includes(handler.mode) || handler.dataTransaction !== undefined && (handler.dataTransaction !== true || handler.mode !== 'reconciled-effect') ||
+            !validateWorkflowBusinessStepSchema(step.inputSchema) || !validateWorkflowBusinessStepSchema(step.outputSchema) || codes.has(handler.code))
+            errors.push('WORKFLOW_AUTHORING_STEP_INVALID');
+        if (handler?.code)
+            codes.add(handler.code);
+    }
+    return errors;
+}
 export function validateWorkflowBusinessSteps(definition, binding) {
     if (!record(definition) || !record(definition.nodes))
         return ['WORKFLOW_STEP_DEFINITION_INVALID'];
@@ -213,12 +238,12 @@ export function validateWorkflowBusinessSteps(definition, binding) {
     const actions = Object.entries(nodes).filter(([, node]) => node?.kind === 'action');
     if (!actions.length)
         return [];
-    const errors = [];
+    const errors = [...validateWorkflowPlatformNotify(definition), ...validateWorkflowAuthoringSteps(definition)];
     if (Object.hasOwn(definition.inputSchema?.properties || {}, 'steps'))
         errors.push('WORKFLOW_STEP_FACT_NAMESPACE_RESERVED');
     const factSchema = workflowBusinessStepFactSchema(definition);
     for (const [id, node] of actions) {
-        if (Object.keys(node).some(key => !['id', 'kind', 'title', 'next', 'handler', 'inputSchema', 'outputSchema', 'inputs'].includes(key)) ||
+        if (Object.keys(node).some(key => !['id', 'kind', 'title', 'next', 'handler', 'inputSchema', 'outputSchema', 'inputs', ...(isWorkflowPlatformNotify(node) ? ['notification'] : [])].includes(key)) ||
             node.id !== id || !keyPattern.test(id) || forbidden.has(id) || typeof node.title !== 'string' || !node.title.trim() || node.title.length > 255 || typeof node.next !== 'string' || !Object.hasOwn(nodes, node.next))
             errors.push(`WORKFLOW_STEP_NODE_INVALID:${id}`);
         const handler = node.handler;
@@ -287,7 +312,7 @@ export function validateWorkflowBusinessSteps(definition, binding) {
         }
     }
     if (binding)
-        for (const [, action] of actions) {
+        for (const [, action] of actions.filter(([, node]) => !isWorkflowPlatformNotify(node))) {
             const visited = new Set(), queue = [action.next];
             while (queue.length && visited.size <= 200) {
                 const id = queue.shift();
@@ -346,8 +371,8 @@ export function compileWorkflowBusinessStepHandlers(definitions) {
         const errors = validateWorkflowBusinessSteps(definition);
         if (errors.length)
             throw new Error(errors.join('; '));
-        for (const node of Object.values(definition.nodes || {})) {
-            if (node.kind !== 'action')
+        for (const node of [...Object.values(definition.nodes || {}), ...definition.authoring?.businessSteps || []]) {
+            if (!node.handler || isWorkflowPlatformNotify(node))
                 continue;
             const contract = { version: node.handler.version, mode: node.handler.mode,
                 ...(node.handler.dataTransaction ? { dataTransaction: true } : {}), inputSchema: node.inputSchema, outputSchema: node.outputSchema };