@rytass/bpm-core-nestjs-module 0.22.0 → 0.23.0

package/src/lib/workflow-engine/approver-filled-table-columns.d.ts

@@ -0,0 +1,91 @@
+import { FieldAccessFillUnit, FormDataSourceValueSnapshots, FormDefinitionSchema, UserTaskNode, WorkflowDefinition } from '@rytass/bpm-core-shared';
+/**
+ * What the user tasks of one workflow let an approver fill (ADR 27 §4(a)),
+ * split for a submission.
+ *
+ * `wholeKeys` are top-level fields granted whole. An end user's value for one
+ * is dropped and the field is only shape checked, as before.
+ *
+ * `openColumnsByTable` maps a table granted only per column to the column keys
+ * an approver fills. The table itself stays with the applicant (its rows are
+ * theirs to add, and the approver may not change their row structure); only
+ * those cells wait for the approver. Nobody can fill them before the approval
+ * node, so their required flags do not apply at submission.
+ */
+export interface ApproverFilledDeferral {
+    readonly openColumnsByTable: ReadonlyMap<string, ReadonlySet<string>>;
+    readonly wholeKeys: ReadonlySet<string>;
+}
+type FormRow = Readonly<Record<string, unknown>>;
+export declare const readApproverFilledDeferral: (definition: WorkflowDefinition) => ApproverFilledDeferral;
+/**
+ * The schema a submission is validated against: each open column of a
+ * deferred table is not required. Its type and a host-supplied value are still
+ * checked, and the table's own rules (`minRows`, `maxRows`) are untouched.
+ */
+export declare const projectOpenColumnsOptional: (schema: FormDefinitionSchema, deferral: ApproverFilledDeferral) => FormDefinitionSchema;
+/**
+ * Settles the open cells of each row of a deferred table. The submitted cell
+ * is dropped. The stored cell comes back only for a row the stored data has
+ * that cell on, and only when the applicant's own cells on that row equal the
+ * stored row's at the same position. Rows are matched by position (no row id),
+ * so a reordered, deleted or inserted row that now sits where a different row
+ * was would otherwise inherit an approver's value that judged another record.
+ * Such a row keeps no open cell and the later approver fills it again. A row
+ * past the stored length gets none. `stored` is `null` on a first submission,
+ * so no open cell survives it.
+ */
+export declare const applyOpenColumnCells: (formData: FormRow, stored: FormRow | null, deferral: ApproverFilledDeferral) => FormRow;
+export declare const APPROVER_FILL_ERROR_CODES: {
+    readonly CELL_LOCKED: "FORM_FIELD_ACCESS_CELL_LOCKED";
+    readonly DEPENDENT_COLUMN_STALE: "FORM_FIELD_ACCESS_DEPENDENT_COLUMN_STALE";
+    readonly TABLE_ROWS_LOCKED: "FORM_FIELD_ACCESS_TABLE_ROWS_LOCKED";
+};
+/**
+ * Fails closed when an approver changes a column that a column the approver
+ * may not fill reads (ADR 27 §4.3). The dependent column keeps its stored value
+ * and is not re-resolved, so a changed source would leave it stale. Current
+ * publish lint rejects such a template; this guards templates published before
+ * that rule. A dependent that is open to the same node is re-resolved at
+ * decide, so it is not a break.
+ */
+export declare const assertDependentColumnsFrozen: (schema: FormDefinitionSchema | null, node: UserTaskNode, storedFormData: Readonly<Record<string, unknown>>, mergedFormData: Readonly<Record<string, unknown>>) => void;
+type ColumnFill = FieldAccessFillUnit['fill'];
+/**
+ * The table columns one user task lets its approver fill (ADR 27 §4(a)), keyed
+ * by table, each with its fill. A table granted whole in the same node is left
+ * out: that grant is the whole-field path and is checked as before.
+ */
+export type NodeColumnFillMap = ReadonlyMap<string, ReadonlyMap<string, ColumnFill>>;
+export declare const readNodeColumnFillMap: (node: UserTaskNode) => NodeColumnFillMap;
+/**
+ * The schema the decide path validates against: each open column this node
+ * grants REQUIRED is required. Its own `required` flag is kept as well, so a
+ * column the template already requires stays required.
+ */
+export declare const projectNodeOpenColumnsRequired: (schema: FormDefinitionSchema, columnFillMap: NodeColumnFillMap) => FormDefinitionSchema;
+/**
+ * Settles an approver's payload against the stored form data, table by table
+ * (ADR 27 §4(a)). The row count and order must match the stored rows, and each
+ * row's applicant cells must match the stored row at that position. Only the
+ * open cells are taken from the payload. Other fields pass through unchanged.
+ */
+export declare const settleColumnFillPayload: (payload: FormRow, stored: FormRow, columnFillMap: NodeColumnFillMap) => FormRow;
+/**
+ * The schema narrowed to the open cells an approver fills that take a data
+ * source (ADR 27 §4(b)): one table per column-mode table with at least one such
+ * cell, keeping only those columns. A ROW_FIELD binding reads its value from
+ * the same row of the form data, so the narrowed schema needs no other column.
+ */
+export declare const readOpenDataSourceCellSchema: (schema: FormDefinitionSchema, columnFillMap: NodeColumnFillMap) => FormDefinitionSchema;
+/**
+ * The snapshots without the cells of `cellSchema`: the open data-source cells
+ * are re-resolved at decide time, so their stored snapshots must not survive
+ * into the merge. Other rows, other columns and whole-field snapshots are kept.
+ * This is not `readSnapshotWithoutFields`, which would also drop the applicant's
+ * own cells of the same table.
+ */
+export declare const readSnapshotWithoutOpenCells: (snapshots: FormDataSourceValueSnapshots | null | undefined, cellSchema: FormDefinitionSchema) => FormDataSourceValueSnapshots;
+/** Only the snapshots of the open cells of `cellSchema`, the complement of the above. */
+export declare const readOpenCellSnapshots: (snapshots: FormDataSourceValueSnapshots, cellSchema: FormDefinitionSchema) => FormDataSourceValueSnapshots;
+export {};

package/src/lib/workflow-engine/approver-filled-table-columns.js

@@ -0,0 +1,301 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readOpenCellSnapshots = exports.readSnapshotWithoutOpenCells = exports.readOpenDataSourceCellSchema = exports.settleColumnFillPayload = exports.projectNodeOpenColumnsRequired = exports.readNodeColumnFillMap = exports.assertDependentColumnsFrozen = exports.APPROVER_FILL_ERROR_CODES = exports.applyOpenColumnCells = exports.projectOpenColumnsOptional = exports.readApproverFilledDeferral = void 0;
+const common_1 = require("@nestjs/common");
+const bpm_core_shared_1 = require("@rytass/bpm-core-shared");
+const form_data_fingerprint_1 = require("./form-data-fingerprint");
+const hasOwn = (target, key) => Object.prototype.hasOwnProperty.call(target, key);
+const isFormRow = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const isUserTaskNode = (node) => node.type === 'userTask';
+const readApproverFilledDeferral = (definition) => {
+    const units = definition.nodes
+        .filter(isUserTaskNode)
+        .flatMap((node) => (0, bpm_core_shared_1.readNodeFillUnits)(node));
+    const wholeKeys = new Set(units
+        .filter((unit) => unit.columnKey === null)
+        .map((unit) => unit.fieldKey));
+    const columnPairs = units.flatMap((unit) => unit.columnKey === null || wholeKeys.has(unit.fieldKey)
+        ? []
+        : [[unit.fieldKey, unit.columnKey]]);
+    const openColumnsByTable = new Map([...new Set(columnPairs.map(([fieldKey]) => fieldKey))].map((fieldKey) => [
+        fieldKey,
+        new Set(columnPairs
+            .filter(([key]) => key === fieldKey)
+            .map(([, columnKey]) => columnKey)),
+    ]));
+    return { openColumnsByTable, wholeKeys };
+};
+exports.readApproverFilledDeferral = readApproverFilledDeferral;
+/**
+ * The schema a submission is validated against: each open column of a
+ * deferred table is not required. Its type and a host-supplied value are still
+ * checked, and the table's own rules (`minRows`, `maxRows`) are untouched.
+ */
+const projectOpenColumnsOptional = (schema, deferral) => ({
+    ...schema,
+    fields: schema.fields.map((field) => {
+        const openColumns = (0, bpm_core_shared_1.isTableFieldDefinition)(field)
+            ? deferral.openColumnsByTable.get(field.fieldKey)
+            : undefined;
+        if (!(0, bpm_core_shared_1.isTableFieldDefinition)(field) || openColumns === undefined) {
+            return field;
+        }
+        return {
+            ...field,
+            columns: field.columns.map((column) => openColumns.has(column.fieldKey)
+                ? { ...column, required: false }
+                : column),
+        };
+    }),
+});
+exports.projectOpenColumnsOptional = projectOpenColumnsOptional;
+/**
+ * The cells of a row the applicant owns: every column that is not open.
+ */
+const readApplicantCells = (row, openColumns) => Object.fromEntries(Object.entries(row).filter(([column]) => !openColumns.has(column)));
+/**
+ * Settles the open cells of each row of a deferred table. The submitted cell
+ * is dropped. The stored cell comes back only for a row the stored data has
+ * that cell on, and only when the applicant's own cells on that row equal the
+ * stored row's at the same position. Rows are matched by position (no row id),
+ * so a reordered, deleted or inserted row that now sits where a different row
+ * was would otherwise inherit an approver's value that judged another record.
+ * Such a row keeps no open cell and the later approver fills it again. A row
+ * past the stored length gets none. `stored` is `null` on a first submission,
+ * so no open cell survives it.
+ */
+const applyOpenColumnCells = (formData, stored, deferral) => Object.fromEntries(Object.entries(formData).map(([key, value]) => {
+    const openColumns = deferral.openColumnsByTable.get(key);
+    if (openColumns === undefined || !Array.isArray(value)) {
+        return [key, value];
+    }
+    const storedValue = stored === null ? undefined : stored[key];
+    const storedRows = Array.isArray(storedValue)
+        ? storedValue
+        : [];
+    return [
+        key,
+        value.map((row, index) => {
+            if (!isFormRow(row)) {
+                return row;
+            }
+            const kept = readApplicantCells(row, openColumns);
+            const storedRow = storedRows[index];
+            if (!isFormRow(storedRow)) {
+                return kept;
+            }
+            const sameRecord = (0, form_data_fingerprint_1.computeStableValueFingerprint)(kept) ===
+                (0, form_data_fingerprint_1.computeStableValueFingerprint)(readApplicantCells(storedRow, openColumns));
+            if (!sameRecord) {
+                return kept;
+            }
+            const restored = Object.fromEntries([...openColumns]
+                .filter((column) => hasOwn(storedRow, column))
+                .map((column) => [
+                column,
+                storedRow[column],
+            ]));
+            return { ...kept, ...restored };
+        }),
+    ];
+}));
+exports.applyOpenColumnCells = applyOpenColumnCells;
+exports.APPROVER_FILL_ERROR_CODES = {
+    CELL_LOCKED: 'FORM_FIELD_ACCESS_CELL_LOCKED',
+    DEPENDENT_COLUMN_STALE: 'FORM_FIELD_ACCESS_DEPENDENT_COLUMN_STALE',
+    TABLE_ROWS_LOCKED: 'FORM_FIELD_ACCESS_TABLE_ROWS_LOCKED',
+};
+const readColumnFingerprints = (rows, columnKey) => Array.isArray(rows)
+    ? rows.map((row) => (0, form_data_fingerprint_1.computeStableValueFingerprint)(isFormRow(row) ? row[columnKey] : undefined))
+    : [];
+/**
+ * Fails closed when an approver changes a column that a column the approver
+ * may not fill reads (ADR 27 §4.3). The dependent column keeps its stored value
+ * and is not re-resolved, so a changed source would leave it stale. Current
+ * publish lint rejects such a template; this guards templates published before
+ * that rule. A dependent that is open to the same node is re-resolved at
+ * decide, so it is not a break.
+ */
+const assertDependentColumnsFrozen = (schema, node, storedFormData, mergedFormData) => {
+    const stale = (0, bpm_core_shared_1.readFieldAccessDependencyBreaks)(schema, (0, bpm_core_shared_1.readNodeFillUnits)(node)).find(({ fieldKey, sourceColumnKey }) => readColumnFingerprints(storedFormData[fieldKey], sourceColumnKey).join('\n') !==
+        readColumnFingerprints(mergedFormData[fieldKey], sourceColumnKey).join('\n'));
+    if (stale !== undefined) {
+        throw new common_1.ConflictException({
+            code: exports.APPROVER_FILL_ERROR_CODES.DEPENDENT_COLUMN_STALE,
+            message: `Column ${stale.sourceColumnKey} of table ${stale.fieldKey} is read by column ${stale.dependentColumnKey}, which an approver may not change at this step`,
+        });
+    }
+};
+exports.assertDependentColumnsFrozen = assertDependentColumnsFrozen;
+const readNodeColumnFillMap = (node) => {
+    const units = (0, bpm_core_shared_1.readNodeFillUnits)(node);
+    const wholeKeys = new Set(units
+        .filter((unit) => unit.columnKey === null)
+        .map((unit) => unit.fieldKey));
+    const columnUnits = units.filter((unit) => unit.columnKey !== null && !wholeKeys.has(unit.fieldKey));
+    return new Map([...new Set(columnUnits.map((unit) => unit.fieldKey))].map((fieldKey) => [
+        fieldKey,
+        new Map(columnUnits
+            .filter((unit) => unit.fieldKey === fieldKey)
+            .map((unit) => [
+            unit.columnKey,
+            unit.fill,
+        ])),
+    ]));
+};
+exports.readNodeColumnFillMap = readNodeColumnFillMap;
+/**
+ * The schema the decide path validates against: each open column this node
+ * grants REQUIRED is required. Its own `required` flag is kept as well, so a
+ * column the template already requires stays required.
+ */
+const projectNodeOpenColumnsRequired = (schema, columnFillMap) => ({
+    ...schema,
+    fields: schema.fields.map((field) => {
+        const columnFills = (0, bpm_core_shared_1.isTableFieldDefinition)(field)
+            ? columnFillMap.get(field.fieldKey)
+            : undefined;
+        if (!(0, bpm_core_shared_1.isTableFieldDefinition)(field) || columnFills === undefined) {
+            return field;
+        }
+        return {
+            ...field,
+            columns: field.columns.map((column) => columnFills.get(column.fieldKey) === 'REQUIRED' && !column.required
+                ? { ...column, required: true }
+                : column),
+        };
+    }),
+});
+exports.projectNodeOpenColumnsRequired = projectNodeOpenColumnsRequired;
+const cellValue = (row, columnKey) => row[columnKey] ?? null;
+/**
+ * The first applicant cell of `row` that differs from the stored row's, or
+ * `null` when every applicant cell is the same. A missing cell counts as null.
+ */
+const readFirstMismatchedApplicantCell = (row, storedRow, openColumns) => {
+    const applicant = readApplicantCells(row, openColumns);
+    const storedApplicant = readApplicantCells(storedRow, openColumns);
+    return ([
+        ...new Set([...Object.keys(applicant), ...Object.keys(storedApplicant)]),
+    ].find((columnKey) => (0, form_data_fingerprint_1.computeStableValueFingerprint)(cellValue(applicant, columnKey)) !==
+        (0, form_data_fingerprint_1.computeStableValueFingerprint)(cellValue(storedApplicant, columnKey))) ?? null);
+};
+const rowsLocked = (fieldKey) => new common_1.ConflictException({
+    code: exports.APPROVER_FILL_ERROR_CODES.TABLE_ROWS_LOCKED,
+    message: `Table ${fieldKey} has fixed rows at this step; an approver may only fill its open columns`,
+});
+const settleTableRows = (fieldKey, rows, storedValue, openColumns) => {
+    const storedRows = Array.isArray(storedValue)
+        ? storedValue
+        : [];
+    if (rows === null) {
+        if (storedRows.length === 0) {
+            return null;
+        }
+        throw rowsLocked(fieldKey);
+    }
+    // Not an array: the shape check in validation answers it with TYPE.
+    if (!Array.isArray(rows)) {
+        return rows;
+    }
+    if (rows.length !== storedRows.length) {
+        throw rowsLocked(fieldKey);
+    }
+    return rows.map((row, index) => {
+        const storedRow = storedRows[index];
+        if (!isFormRow(row) || !isFormRow(storedRow)) {
+            throw rowsLocked(fieldKey);
+        }
+        const mismatch = readFirstMismatchedApplicantCell(row, storedRow, openColumns);
+        if (mismatch !== null) {
+            // A row whose applicant cells match another stored row was moved, which
+            // changes the row order. Reporting it as a changed cell would hide that.
+            const movedElsewhere = storedRows.some((other, otherIndex) => otherIndex !== index &&
+                isFormRow(other) &&
+                readFirstMismatchedApplicantCell(row, other, openColumns) === null);
+            if (movedElsewhere) {
+                throw rowsLocked(fieldKey);
+            }
+            throw new common_1.ConflictException({
+                code: exports.APPROVER_FILL_ERROR_CODES.CELL_LOCKED,
+                message: `Column ${mismatch} of table ${fieldKey} row ${index + 1} is not open to approvers`,
+            });
+        }
+        // The applicant's cells come from the stored row, so a payload can only
+        // change the open cells. Any other key the payload sent is dropped.
+        return {
+            ...readApplicantCells(storedRow, openColumns),
+            ...Object.fromEntries([...openColumns].map((columnKey) => [
+                columnKey,
+                cellValue(row, columnKey),
+            ])),
+        };
+    });
+};
+/**
+ * Settles an approver's payload against the stored form data, table by table
+ * (ADR 27 §4(a)). The row count and order must match the stored rows, and each
+ * row's applicant cells must match the stored row at that position. Only the
+ * open cells are taken from the payload. Other fields pass through unchanged.
+ */
+const settleColumnFillPayload = (payload, stored, columnFillMap) => Object.fromEntries(Object.entries(payload).map(([fieldKey, value]) => {
+    const columnFills = columnFillMap.get(fieldKey);
+    return columnFills === undefined
+        ? [fieldKey, value]
+        : [
+            fieldKey,
+            settleTableRows(fieldKey, value, hasOwn(stored, fieldKey) ? stored[fieldKey] : undefined, new Set(columnFills.keys())),
+        ];
+}));
+exports.settleColumnFillPayload = settleColumnFillPayload;
+/**
+ * The schema narrowed to the open cells an approver fills that take a data
+ * source (ADR 27 §4(b)): one table per column-mode table with at least one such
+ * cell, keeping only those columns. A ROW_FIELD binding reads its value from
+ * the same row of the form data, so the narrowed schema needs no other column.
+ */
+const readOpenDataSourceCellSchema = (schema, columnFillMap) => ({
+    ...schema,
+    fields: schema.fields.flatMap((field) => {
+        const columnFills = (0, bpm_core_shared_1.isTableFieldDefinition)(field)
+            ? columnFillMap.get(field.fieldKey)
+            : undefined;
+        if (!(0, bpm_core_shared_1.isTableFieldDefinition)(field) || columnFills === undefined) {
+            return [];
+        }
+        const columns = field.columns.flatMap((column) => columnFills.has(column.fieldKey) &&
+            (0, bpm_core_shared_1.isFormDataSourceFieldDefinition)(column)
+            ? [column]
+            : []);
+        return columns.length === 0 ? [] : [{ ...field, columns }];
+    }),
+});
+exports.readOpenDataSourceCellSchema = readOpenDataSourceCellSchema;
+/** Matches a cell snapshot key, `<tableKey>[<rowIndex>].<columnKey>`. */
+const CELL_SNAPSHOT_KEY_PATTERN = /^([^[\].]+)\[\d+\]\.([^[\].]+)$/;
+const readOpenCellKeys = (cellSchema) => new Set(cellSchema.fields.flatMap((field) => (0, bpm_core_shared_1.isTableFieldDefinition)(field)
+    ? field.columns.map((column) => `${field.fieldKey}.${column.fieldKey}`)
+    : []));
+const isOpenCellSnapshotKey = (key, openCellKeys) => {
+    const match = CELL_SNAPSHOT_KEY_PATTERN.exec(key);
+    return match !== null && openCellKeys.has(`${match[1]}.${match[2]}`);
+};
+/**
+ * The snapshots without the cells of `cellSchema`: the open data-source cells
+ * are re-resolved at decide time, so their stored snapshots must not survive
+ * into the merge. Other rows, other columns and whole-field snapshots are kept.
+ * This is not `readSnapshotWithoutFields`, which would also drop the applicant's
+ * own cells of the same table.
+ */
+const readSnapshotWithoutOpenCells = (snapshots, cellSchema) => {
+    const openCellKeys = readOpenCellKeys(cellSchema);
+    return Object.fromEntries(Object.entries(snapshots ?? {}).filter(([key]) => !isOpenCellSnapshotKey(key, openCellKeys)));
+};
+exports.readSnapshotWithoutOpenCells = readSnapshotWithoutOpenCells;
+/** Only the snapshots of the open cells of `cellSchema`, the complement of the above. */
+const readOpenCellSnapshots = (snapshots, cellSchema) => {
+    const openCellKeys = readOpenCellKeys(cellSchema);
+    return Object.fromEntries(Object.entries(snapshots).filter(([key]) => isOpenCellSnapshotKey(key, openCellKeys)));
+};
+exports.readOpenCellSnapshots = readOpenCellSnapshots;
+//# sourceMappingURL=approver-filled-table-columns.js.map

package/src/lib/workflow-engine/approver-filled-table-columns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approver-filled-table-columns.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/workflow-engine/approver-filled-table-columns.ts"],"names":[],"mappings":"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"}

package/src/lib/workflow-engine/dto/dry-run-approval-workflow.input.d.ts

@@ -3,4 +3,11 @@ export declare class DryRunApprovalWorkflowInput {
     formDataJson: string;
     initiatorMemberId: string;
     initiatorMetadataSnapshotJson: string | null;
+    /**
+     * The form schema of the template being tried. Used only when the host turns
+     * on `expressionMissingFormFieldsAsNull`, so the dry run fills unfilled
+     * fields the way a real case would (ADR 27 §3); without it the form data is
+     * read as given.
+     */
+    formSchemaJson?: string | null;
 }

package/src/lib/workflow-engine/dto/dry-run-approval-workflow.input.js

@@ -28,6 +28,15 @@ tslib_1.__decorate([
     (0, class_validator_1.IsString)(),
     tslib_1.__metadata("design:type", Object)
 ], DryRunApprovalWorkflowInput.prototype, "initiatorMetadataSnapshotJson", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)(() => String, {
+        description: 'Form schema JSON of the template being tried. Only read when the host enables expressionMissingFormFieldsAsNull: unfilled top-level fields are then read as null ([] for a table), as in a real case.',
+        nullable: true,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    tslib_1.__metadata("design:type", Object)
+], DryRunApprovalWorkflowInput.prototype, "formSchemaJson", void 0);
 exports.DryRunApprovalWorkflowInput = DryRunApprovalWorkflowInput = tslib_1.__decorate([
     (0, graphql_1.InputType)()
 ], DryRunApprovalWorkflowInput);

package/src/lib/workflow-engine/dto/dry-run-approval-workflow.input.js.map

@@ -1 +1 @@
-{"version":3,"file":"dry-run-approval-workflow.input.js","sourceRoot":"","sources":["../../../../../../../libs/bpm-core/src/lib/workflow-engine/dto/dry-run-approval-workflow.input.ts"],"names":[],"mappings":";;;;AAAA,6CAAmD;AACnD,qDAAuD;AAGhD,IAAM,2BAA2B,GAAjC,MAAM,2BAA2B;CAiBvC,CAAA;AAjBY,kEAA2B;AAGtC;IAFC,IAAA,eAAK,GAAE;IACP,IAAA,0BAAQ,GAAE;;2EACqB;AAIhC;IAFC,IAAA,eAAK,GAAE;IACP,IAAA,0BAAQ,GAAE;;iEACW;AAItB;IAFC,IAAA,eAAK,GAAE;IACP,IAAA,0BAAQ,GAAE;;sEACgB;AAK3B;IAHC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACvC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;kFACmC;sCAhBnC,2BAA2B;IADvC,IAAA,mBAAS,GAAE;GACC,2BAA2B,CAiBvC"}
+{"version":3,"file":"dry-run-approval-workflow.input.js","sourceRoot":"","sources":["../../../../../../../libs/bpm-core/src/lib/workflow-engine/dto/dry-run-approval-workflow.input.ts"],"names":[],"mappings":";;;;AAAA,6CAAmD;AACnD,qDAAuD;AAGhD,IAAM,2BAA2B,GAAjC,MAAM,2BAA2B;CAgCvC,CAAA;AAhCY,kEAA2B;AAGtC;IAFC,IAAA,eAAK,GAAE;IACP,IAAA,0BAAQ,GAAE;;2EACqB;AAIhC;IAFC,IAAA,eAAK,GAAE;IACP,IAAA,0BAAQ,GAAE;;iEACW;AAItB;IAFC,IAAA,eAAK,GAAE;IACP,IAAA,0BAAQ,GAAE;;sEACgB;AAK3B;IAHC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACvC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;kFACmC;AAe9C;IAPC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,MAAM,EAAE;QACnB,WAAW,EACT,uMAAuM;QACzM,QAAQ,EAAE,IAAI;KACf,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;mEACoB;sCA/BpB,2BAA2B;IADvC,IAAA,mBAAS,GAAE;GACC,2BAA2B,CAgCvC"}

package/src/lib/workflow-engine/index.d.ts

@@ -13,6 +13,7 @@ export * from './dto/reassign-task.input';
 export * from './dto/resubmit-approval-instance.input';
 export * from './dto/submit-approval-instance.input';
 export * from './initiator-custom-fields-resolver.token';
+export * from './instance-guard.token';
 export * from './task-candidate.entity';
 export * from './task-decision.entity';
 export * from './task.entity';

package/src/lib/workflow-engine/index.js

@@ -16,6 +16,7 @@ tslib_1.__exportStar(require("./dto/reassign-task.input"), exports);
 tslib_1.__exportStar(require("./dto/resubmit-approval-instance.input"), exports);
 tslib_1.__exportStar(require("./dto/submit-approval-instance.input"), exports);
 tslib_1.__exportStar(require("./initiator-custom-fields-resolver.token"), exports);
+tslib_1.__exportStar(require("./instance-guard.token"), exports);
 tslib_1.__exportStar(require("./task-candidate.entity"), exports);
 tslib_1.__exportStar(require("./task-decision.entity"), exports);
 tslib_1.__exportStar(require("./task.entity"), exports);

package/src/lib/workflow-engine/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/workflow-engine/index.ts"],"names":[],"mappings":";;;AAAA,gEAAsC;AACtC,mEAAyC;AACzC,wDAA8B;AAC9B,+EAAqD;AACrD,qEAA2C;AAC3C,yEAA+C;AAC/C,mEAAyC;AACzC,+EAAqD;AACrD,kEAAwC;AACxC,gFAAsD;AACtD,4EAAkD;AAClD,oEAA0C;AAC1C,iFAAuD;AACvD,+EAAqD;AACrD,mFAAyD;AACzD,kEAAwC;AACxC,iEAAuC;AACvC,wDAA8B;AAC9B,qEAA2C;AAC3C,yEAA+C;AAC/C,oEAA0C;AAC1C,8EAAoD;AACpD,kEAAwC;AACxC,mEAAyC;AACzC,oEAA0C;AAC1C,mEAAyC;AACzC,mFAAyD;AACzD,kEAAwC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/workflow-engine/index.ts"],"names":[],"mappings":";;;AAAA,gEAAsC;AACtC,mEAAyC;AACzC,wDAA8B;AAC9B,+EAAqD;AACrD,qEAA2C;AAC3C,yEAA+C;AAC/C,mEAAyC;AACzC,+EAAqD;AACrD,kEAAwC;AACxC,gFAAsD;AACtD,4EAAkD;AAClD,oEAA0C;AAC1C,iFAAuD;AACvD,+EAAqD;AACrD,mFAAyD;AACzD,iEAAuC;AACvC,kEAAwC;AACxC,iEAAuC;AACvC,wDAA8B;AAC9B,qEAA2C;AAC3C,yEAA+C;AAC/C,oEAA0C;AAC1C,8EAAoD;AACpD,kEAAwC;AACxC,mEAAyC;AACzC,oEAA0C;AAC1C,mEAAyC;AACzC,mFAAyD;AACzD,kEAAwC"}

package/src/lib/workflow-engine/instance-guard.runner.d.ts

@@ -0,0 +1,19 @@
+import type { BPMInstanceGuard, BPMInstanceGuardInput } from './instance-guard.token';
+/** Default for `instanceGuardTimeoutMs` (ADR 27 §2.2). */
+export declare const BPM_INSTANCE_GUARD_DEFAULT_TIMEOUT_MS = 5000;
+export declare const BPM_INSTANCE_GUARD_TIMEOUT_CODE = "BPM_INSTANCE_GUARD_TIMEOUT";
+export declare const BPM_INSTANCE_GUARD_FAILED_CODE = "BPM_INSTANCE_GUARD_FAILED";
+export declare function isInstanceGuardError(error: unknown): boolean;
+/**
+ * Runs the host guard for one engine path and throws if the path must stop.
+ *
+ * Returns normally only when the guard answered with an empty list in time.
+ * Call it inside the engine transaction, after the case lock is taken, so a
+ * throw rolls the whole change back.
+ *
+ * - non-empty issues: 400 `createFormDataBadRequest`
+ * - no answer within `timeoutMs`: 503 `BPM_INSTANCE_GUARD_TIMEOUT` (fail closed)
+ * - a thrown `HttpException`: rethrown unchanged
+ * - any other error, or a malformed answer: 503 `BPM_INSTANCE_GUARD_FAILED`
+ */
+export declare function runInstanceGuard(guard: BPMInstanceGuard, input: BPMInstanceGuardInput, timeoutMs: number): Promise<void>;

package/src/lib/workflow-engine/instance-guard.runner.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BPM_INSTANCE_GUARD_FAILED_CODE = exports.BPM_INSTANCE_GUARD_TIMEOUT_CODE = exports.BPM_INSTANCE_GUARD_DEFAULT_TIMEOUT_MS = void 0;
+exports.isInstanceGuardError = isInstanceGuardError;
+exports.runInstanceGuard = runInstanceGuard;
+const common_1 = require("@nestjs/common");
+const form_data_issue_1 = require("../form/form-data-issue");
+/** Default for `instanceGuardTimeoutMs` (ADR 27 §2.2). */
+exports.BPM_INSTANCE_GUARD_DEFAULT_TIMEOUT_MS = 5000;
+exports.BPM_INSTANCE_GUARD_TIMEOUT_CODE = 'BPM_INSTANCE_GUARD_TIMEOUT';
+exports.BPM_INSTANCE_GUARD_FAILED_CODE = 'BPM_INSTANCE_GUARD_FAILED';
+/**
+ * Every error the guard path raises: the 400 for refused issues, the 503 for a
+ * timeout or a failing guard, and an `HttpException` the host threw itself.
+ * Lets a caller tell a guard refusal apart from any other failure without
+ * matching on messages.
+ */
+const instanceGuardErrors = new WeakSet();
+function markInstanceGuardError(error) {
+    instanceGuardErrors.add(error);
+    return error;
+}
+function isInstanceGuardError(error) {
+    return typeof error === 'object' && error !== null
+        ? instanceGuardErrors.has(error)
+        : false;
+}
+function createGuardUnavailable(code, message) {
+    return markInstanceGuardError(new common_1.ServiceUnavailableException({
+        code,
+        error: 'Service Unavailable',
+        message,
+        statusCode: 503,
+    }));
+}
+function isGuardIssue(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const issue = value;
+    return (typeof issue.message === 'string' &&
+        typeof issue.path === 'string' &&
+        issue.reason === 'HOST_RULE' &&
+        (issue.code === undefined || typeof issue.code === 'string'));
+}
+function readIssueFormDataErrors(issues) {
+    return issues.map((issue) => ({
+        message: issue.message,
+        path: issue.path,
+        reason: issue.reason,
+        ...(issue.code === undefined ? {} : { code: issue.code }),
+    }));
+}
+/**
+ * Runs the host guard for one engine path and throws if the path must stop.
+ *
+ * Returns normally only when the guard answered with an empty list in time.
+ * Call it inside the engine transaction, after the case lock is taken, so a
+ * throw rolls the whole change back.
+ *
+ * - non-empty issues: 400 `createFormDataBadRequest`
+ * - no answer within `timeoutMs`: 503 `BPM_INSTANCE_GUARD_TIMEOUT` (fail closed)
+ * - a thrown `HttpException`: rethrown unchanged
+ * - any other error, or a malformed answer: 503 `BPM_INSTANCE_GUARD_FAILED`
+ */
+async function runInstanceGuard(guard, input, timeoutMs) {
+    const timeoutError = markInstanceGuardError(new Error(`BPM_INSTANCE_GUARD_TIMEOUT_${timeoutMs}MS`));
+    let timer;
+    let issues;
+    try {
+        issues = await Promise.race([
+            Promise.resolve().then(() => guard.check(input)),
+            new Promise((_resolve, reject) => {
+                timer = setTimeout(() => {
+                    reject(timeoutError);
+                }, timeoutMs);
+            }),
+        ]);
+    }
+    catch (error) {
+        if (error === timeoutError) {
+            throw createGuardUnavailable(exports.BPM_INSTANCE_GUARD_TIMEOUT_CODE, `Instance guard did not answer within ${timeoutMs} ms`);
+        }
+        if (error instanceof common_1.HttpException) {
+            markInstanceGuardError(error);
+            throw error;
+        }
+        throw createGuardUnavailable(exports.BPM_INSTANCE_GUARD_FAILED_CODE, 'Instance guard failed');
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    if (!Array.isArray(issues) || !issues.every(isGuardIssue)) {
+        throw createGuardUnavailable(exports.BPM_INSTANCE_GUARD_FAILED_CODE, 'Instance guard returned an answer of the wrong shape');
+    }
+    if (issues.length === 0) {
+        return;
+    }
+    const formDataErrors = readIssueFormDataErrors(issues);
+    throw markInstanceGuardError((0, form_data_issue_1.createFormDataBadRequest)((0, form_data_issue_1.readFormDataIssueMessage)(formDataErrors), formDataErrors));
+}
+//# sourceMappingURL=instance-guard.runner.js.map

package/src/lib/workflow-engine/instance-guard.runner.js.map

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