@webiny/api-workflows 0.0.0-unstable.9f53ea597d → 0.0.0-unstable.a85ef555b2

package/domain/routing/toRoutingEvaluation.js

@@ -0,0 +1,40 @@
+const toRoutingEvaluation = (input)=>{
+    const evaluation = {
+        owner: input.owner ? {
+            ...input.owner
+        } : null,
+        source: input.source,
+        ruleId: input.ruleId,
+        strategy: input.strategy,
+        candidateTeamIds: [
+            ...input.candidateTeamIds
+        ],
+        reason: input.reason,
+        records: [
+            ...input.skips.map((skip)=>({
+                    ...skip
+                })),
+            {
+                kind: "outcome",
+                userId: input.owner?.id ?? null,
+                source: input.source,
+                ruleId: input.ruleId,
+                by: null,
+                reason: input.reason
+            }
+        ],
+        trace: input.trace.map((entry)=>({
+                ...entry
+            })),
+        skipped: input.skipped.map((item)=>({
+                ...item
+            }))
+    };
+    if (input.strategyOrder) evaluation.strategyOrder = input.strategyOrder.map((user)=>({
+            ...user
+        }));
+    return evaluation;
+};
+export { toRoutingEvaluation };
+
+//# sourceMappingURL=toRoutingEvaluation.js.map

package/domain/routing/toRoutingEvaluation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/routing/toRoutingEvaluation.js","sources":["../../../src/domain/routing/toRoutingEvaluation.ts"],"sourcesContent":["import type { AssignmentDecision } from \"~/domain/assignment/types.js\";\nimport type { RoutingStrategy } from \"~/domain/workflow/types.js\";\nimport type {\n    RoutingEvaluation,\n    RoutingSkippedUser,\n    RoutingSource,\n    RoutingTraceEntry,\n    RoutingUser\n} from \"./types.js\";\n\nexport interface RoutingDecisionInput {\n    owner: RoutingUser | null;\n    source: RoutingSource;\n    ruleId: string | null;\n    strategy: RoutingStrategy;\n    candidateTeamIds: string[];\n    reason: string | null;\n    /** The skips so far, in decision order. */\n    skips: AssignmentDecision[];\n    trace: RoutingTraceEntry[];\n    /** The skipped people so far, in decision order (R129). */\n    skipped: RoutingSkippedUser[];\n    /** The strategy's candidate order; given only in inspector mode when a strategy ran (R289). */\n    strategyOrder?: RoutingUser[];\n}\n\n/** The evaluation with its outcome record appended after the skips (R117). Pure. */\nexport const toRoutingEvaluation = (input: RoutingDecisionInput): RoutingEvaluation => {\n    const evaluation: RoutingEvaluation = {\n        owner: input.owner ? { ...input.owner } : null,\n        source: input.source,\n        ruleId: input.ruleId,\n        strategy: input.strategy,\n        candidateTeamIds: [...input.candidateTeamIds],\n        reason: input.reason,\n        records: [\n            ...input.skips.map(skip => ({ ...skip })),\n            {\n                kind: \"outcome\",\n                userId: input.owner?.id ?? null,\n                source: input.source,\n                ruleId: input.ruleId,\n                by: null,\n                reason: input.reason\n            }\n        ],\n        trace: input.trace.map(entry => ({ ...entry })),\n        skipped: input.skipped.map(item => ({ ...item }))\n    };\n    if (input.strategyOrder) {\n        evaluation.strategyOrder = input.strategyOrder.map(user => ({ ...user }));\n    }\n    return evaluation;\n};\n"],"names":["toRoutingEvaluation","input","evaluation","skip","entry","item","user"],"mappings":"AA2BO,MAAMA,sBAAsB,CAACC;IAChC,MAAMC,aAAgC;QAClC,OAAOD,MAAM,KAAK,GAAG;YAAE,GAAGA,MAAM,KAAK;QAAC,IAAI;QAC1C,QAAQA,MAAM,MAAM;QACpB,QAAQA,MAAM,MAAM;QACpB,UAAUA,MAAM,QAAQ;QACxB,kBAAkB;eAAIA,MAAM,gBAAgB;SAAC;QAC7C,QAAQA,MAAM,MAAM;QACpB,SAAS;eACFA,MAAM,KAAK,CAAC,GAAG,CAACE,CAAAA,OAAS;oBAAE,GAAGA,IAAI;gBAAC;YACtC;gBACI,MAAM;gBACN,QAAQF,MAAM,KAAK,EAAE,MAAM;gBAC3B,QAAQA,MAAM,MAAM;gBACpB,QAAQA,MAAM,MAAM;gBACpB,IAAI;gBACJ,QAAQA,MAAM,MAAM;YACxB;SACH;QACD,OAAOA,MAAM,KAAK,CAAC,GAAG,CAACG,CAAAA,QAAU;gBAAE,GAAGA,KAAK;YAAC;QAC5C,SAASH,MAAM,OAAO,CAAC,GAAG,CAACI,CAAAA,OAAS;gBAAE,GAAGA,IAAI;YAAC;IAClD;IACA,IAAIJ,MAAM,aAAa,EACnBC,WAAW,aAAa,GAAGD,MAAM,aAAa,CAAC,GAAG,CAACK,CAAAA,OAAS;YAAE,GAAGA,IAAI;QAAC;IAE1E,OAAOJ;AACX"}

package/domain/routing/toStepAssignmentResolution.d.ts

@@ -0,0 +1,7 @@
+import type { StepAssignmentResolution } from "../../domain/review/types.js";
+import type { RoutingEvaluation } from "./types.js";
+/**
+ * The resolution for `Review.reach` (spec 5.2, 6): the owner as an admin user actor, the
+ * assignment with the deciding rule and the pool reason when set, and the records (R117). Pure.
+ */
+export declare const toStepAssignmentResolution: (evaluation: RoutingEvaluation) => StepAssignmentResolution;

package/domain/routing/toStepAssignmentResolution.js

@@ -0,0 +1,24 @@
+const toStepAssignmentResolution = (evaluation)=>({
+        owner: evaluation.owner ? {
+            type: "user",
+            id: evaluation.owner.id,
+            displayName: evaluation.owner.displayName,
+            identityType: "admin"
+        } : null,
+        candidateTeamIds: [
+            ...evaluation.candidateTeamIds
+        ],
+        assignment: {
+            source: evaluation.source,
+            ...evaluation.ruleId ? {
+                ruleId: evaluation.ruleId
+            } : {},
+            ...evaluation.reason ? {
+                reason: evaluation.reason
+            } : {}
+        },
+        records: structuredClone(evaluation.records)
+    });
+export { toStepAssignmentResolution };
+
+//# sourceMappingURL=toStepAssignmentResolution.js.map

package/domain/routing/toStepAssignmentResolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/routing/toStepAssignmentResolution.js","sources":["../../../src/domain/routing/toStepAssignmentResolution.ts"],"sourcesContent":["import type { StepAssignmentResolution } from \"~/domain/review/types.js\";\nimport type { RoutingEvaluation } from \"./types.js\";\n\n/**\n * The resolution for `Review.reach` (spec 5.2, 6): the owner as an admin user actor, the\n * assignment with the deciding rule and the pool reason when set, and the records (R117). Pure.\n */\nexport const toStepAssignmentResolution = (\n    evaluation: RoutingEvaluation\n): StepAssignmentResolution => {\n    return {\n        owner: evaluation.owner\n            ? {\n                  type: \"user\",\n                  id: evaluation.owner.id,\n                  displayName: evaluation.owner.displayName,\n                  identityType: \"admin\"\n              }\n            : null,\n        candidateTeamIds: [...evaluation.candidateTeamIds],\n        assignment: {\n            source: evaluation.source,\n            ...(evaluation.ruleId ? { ruleId: evaluation.ruleId } : {}),\n            ...(evaluation.reason ? { reason: evaluation.reason } : {})\n        },\n        records: structuredClone(evaluation.records)\n    };\n};\n"],"names":["toStepAssignmentResolution","evaluation","structuredClone"],"mappings":"AAOO,MAAMA,6BAA6B,CACtCC,aAEO;QACH,OAAOA,WAAW,KAAK,GACjB;YACI,MAAM;YACN,IAAIA,WAAW,KAAK,CAAC,EAAE;YACvB,aAAaA,WAAW,KAAK,CAAC,WAAW;YACzC,cAAc;QAClB,IACA;QACN,kBAAkB;eAAIA,WAAW,gBAAgB;SAAC;QAClD,YAAY;YACR,QAAQA,WAAW,MAAM;YACzB,GAAIA,WAAW,MAAM,GAAG;gBAAE,QAAQA,WAAW,MAAM;YAAC,IAAI,CAAC,CAAC;YAC1D,GAAIA,WAAW,MAAM,GAAG;gBAAE,QAAQA,WAAW,MAAM;YAAC,IAAI,CAAC,CAAC;QAC9D;QACA,SAASC,gBAAgBD,WAAW,OAAO;IAC/C"}

package/domain/routing/toStepMembersParams.d.ts

@@ -0,0 +1,15 @@
+import type { ReviewData } from "../../domain/review/types.js";
+import type { ReviewStep } from "../../domain/review/types.js";
+import type { RoutingMembersParams } from "./types.js";
+export interface StepMembersParamsInput {
+    review: ReviewData;
+    /** The review's step whose members are listed. */
+    step: ReviewStep;
+    /** Exclusion expiry is evaluated at this instant. */
+    now: Date;
+}
+/**
+ * The `listMembers` params for a review's step (R120): the teams the step was reached with, the
+ * review's requester excluded, read access checked on the reviewed revision. Pure.
+ */
+export declare const toStepMembersParams: (input: StepMembersParamsInput) => RoutingMembersParams;

package/domain/routing/toStepMembersParams.js

@@ -0,0 +1,19 @@
+const toStepMembersParams = (input)=>{
+    const { review, step, now } = input;
+    return {
+        teamIds: [
+            ...step.candidateTeamIds
+        ],
+        requesterId: review.createdBy.id,
+        model: review.model,
+        read: {
+            type: "target",
+            targetId: review.targetId,
+            targetRevisionId: review.targetRevisionId
+        },
+        now
+    };
+};
+export { toStepMembersParams };
+
+//# sourceMappingURL=toStepMembersParams.js.map

package/domain/routing/toStepMembersParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/routing/toStepMembersParams.js","sources":["../../../src/domain/routing/toStepMembersParams.ts"],"sourcesContent":["import type { ReviewData } from \"~/domain/review/types.js\";\nimport type { ReviewStep } from \"~/domain/review/types.js\";\nimport type { RoutingMembersParams } from \"./types.js\";\n\nexport interface StepMembersParamsInput {\n    review: ReviewData;\n    /** The review's step whose members are listed. */\n    step: ReviewStep;\n    /** Exclusion expiry is evaluated at this instant. */\n    now: Date;\n}\n\n/**\n * The `listMembers` params for a review's step (R120): the teams the step was reached with, the\n * review's requester excluded, read access checked on the reviewed revision. Pure.\n */\nexport const toStepMembersParams = (input: StepMembersParamsInput): RoutingMembersParams => {\n    const { review, step, now } = input;\n    return {\n        teamIds: [...step.candidateTeamIds],\n        requesterId: review.createdBy.id,\n        model: review.model,\n        read: {\n            type: \"target\",\n            targetId: review.targetId,\n            targetRevisionId: review.targetRevisionId\n        },\n        now\n    };\n};\n"],"names":["toStepMembersParams","input","review","step","now"],"mappings":"AAgBO,MAAMA,sBAAsB,CAACC;IAChC,MAAM,EAAEC,MAAM,EAAEC,IAAI,EAAEC,GAAG,EAAE,GAAGH;IAC9B,OAAO;QACH,SAAS;eAAIE,KAAK,gBAAgB;SAAC;QACnC,aAAaD,OAAO,SAAS,CAAC,EAAE;QAChC,OAAOA,OAAO,KAAK;QACnB,MAAM;YACF,MAAM;YACN,UAAUA,OAAO,QAAQ;YACzB,kBAAkBA,OAAO,gBAAgB;QAC7C;QACAE;IACJ;AACJ"}

package/domain/routing/types.d.ts

@@ -0,0 +1,198 @@
+import type { AssignmentDecision, AssignmentSource } from "../../domain/assignment/types.js";
+import type { TargetContextFolder } from "../../domain/review/types.js";
+import type { WorkflowExclusion } from "../../domain/settings/types.js";
+import type { ReviewStepConfig, RoutingStrategy } from "../../domain/workflow/types.js";
+import type { RoutingSkipReason } from "./reasons.js";
+/** Read access to a target revision: step reach, request candidates, reassign. */
+export interface RoutingTargetReadScope {
+    type: "target";
+    targetId: string;
+    targetRevisionId: string;
+}
+/** Read access to a folder's content, without a revision: the inspector (R121). */
+export interface RoutingFolderReadScope {
+    type: "folder";
+    /** `null`: the root folder (model read only). */
+    folderId: string | null;
+}
+export type RoutingReadScope = RoutingTargetReadScope | RoutingFolderReadScope;
+export interface RoutingUser {
+    id: string;
+    displayName: string;
+}
+/** What routing reads of an admin user (`AdminUser` fits). */
+export interface RoutingDirectoryUser {
+    id: string;
+    displayName: string;
+    teams?: string[];
+}
+/** The sources a step-reach decision can have (R109). */
+export type RoutingSource = Extract<AssignmentSource, "picked" | "rule" | "roundRobin" | "leastLoaded" | "pool">;
+export type RoutingStrategyName = Exclude<RoutingStrategy, "none">;
+/**
+ * `notEvaluated` is a rule after the deciding one; only an inspector evaluation (`explain`) lists
+ * such rules (R289).
+ */
+export type RoutingTraceOutcome = "matched" | "notMatched" | "skipped" | "notEvaluated";
+/**
+ * The rule conditions the editor can name when a rule does not match (R289). A failed `modelId`
+ * condition names nothing.
+ */
+export type RoutingCondition = "requesterUser" | "requesterTeam" | "folder";
+/** One evaluated rule, for the inspector (R121). No load numbers. */
+export interface RoutingTraceEntry {
+    ruleId: string;
+    outcome: RoutingTraceOutcome;
+    /**
+     * The skip reason for `skipped`; `null` otherwise. An excluded user target shows the
+     * exclusion's own reason, or "Excluded from reviews." when it has none (R129, D118).
+     */
+    reason: string | null;
+    /**
+     * The conditions that failed, set on `notMatched` entries of an inspector evaluation
+     * (`explain`); absent in live assignment, which stops at the first failed condition.
+     */
+    failedConditions?: RoutingCondition[];
+}
+/** A trace entry of the inspector's answer: `failedConditions` is always there (R289). */
+export interface RoutingInspectionTraceEntry extends RoutingTraceEntry {
+    failedConditions: RoutingCondition[];
+}
+/**
+ * A person routing skipped, for the inspector (R129, D118): a pick, a rule user target or a
+ * strategy candidate refused read access. Same reason as the trace; never written to a record.
+ */
+export interface RoutingSkippedUser {
+    userId: string;
+    /** `null` for a user who is not a member of the step's teams (not looked up). */
+    displayName: string | null;
+    reason: string;
+}
+/** What rule conditions are matched against without a lookup (R113). */
+export interface RoutingRuleLocalFacts {
+    requesterId: string;
+    /** The id of the review's model, as its app parses it; `null` when no app knows the model. */
+    modelId: string | null;
+    /** The target's folder; `null` for the root. */
+    folder: TargetContextFolder | null;
+}
+/** What rule conditions are matched against (R113). */
+export interface RoutingRuleFacts extends RoutingRuleLocalFacts {
+    /** Empty when the lookup failed or the requester is an API key. */
+    requesterTeamIds: string[];
+    /** The folder and its ancestors, nearest first; empty when not read. */
+    folderChainIds: string[];
+}
+export interface RoutingEvaluateParams {
+    config: ReviewStepConfig;
+    /** Namespace id, e.g. "cms.article" or "wb.page". */
+    model: string;
+    /** `null` for a workflow not stored yet: round robin has no history. */
+    workflowId: string | null;
+    /**
+     * The review being routed; least loaded does not count it as load. `null` without a review
+     * (the inspector).
+     */
+    reviewId: string | null;
+    stepId: string;
+    requesterId: string;
+    /** The requester's pick for this step; used only when the step allows picks. */
+    pickedUserId: string | null;
+    folder: TargetContextFolder | null;
+    read: RoutingReadScope;
+    /** The reach time (R118): exclusion expiry is evaluated at this instant. */
+    now: Date;
+    /**
+     * Inspector mode (R289): evaluate every condition of every rule up to the deciding one, name
+     * the failed conditions, list the later rules as `notEvaluated` and return the strategy's
+     * candidate order. Absent or false is live assignment, which stays lazy.
+     */
+    explain?: boolean;
+}
+/** The decision for one step (spec 6). */
+export interface RoutingEvaluation {
+    owner: RoutingUser | null;
+    source: RoutingSource;
+    /** The rule that decided, also for a team target that narrowed the candidates (R109). */
+    ruleId: string | null;
+    /** The step's configured strategy. */
+    strategy: RoutingStrategy;
+    candidateTeamIds: string[];
+    /** The pool reason, e.g. no eligible candidate; `null` for an owner. */
+    reason: string | null;
+    /** Skips in decision order, then one outcome (R117). Fixed reasons only (D89, D97). */
+    records: AssignmentDecision[];
+    trace: RoutingTraceEntry[];
+    /** The skipped people in decision order, with the trace's reasons (R129). */
+    skipped: RoutingSkippedUser[];
+    /**
+     * The strategy's order of the eligible candidates, before read access is checked. Set only in
+     * inspector mode (`explain`) and only when a strategy ran: absent when a rule chose the owner
+     * or the strategy is `none` (R289).
+     */
+    strategyOrder?: RoutingUser[];
+}
+export interface RoutingMembersParams {
+    teamIds: string[];
+    requesterId: string;
+    model: string;
+    read: RoutingReadScope;
+    now: Date;
+}
+/** A member of the step's teams, for candidate lists (R120). */
+export interface RoutingMember {
+    id: string;
+    displayName: string;
+    teamIds: string[];
+    /** The active exclusion, with its own reason; `null` when not excluded. */
+    exclusion: WorkflowExclusion | null;
+    canRead: boolean;
+}
+export interface RoutingUserCheckParams {
+    userId: string;
+    teamIds: string[];
+    requesterId: string;
+    model: string;
+    read: RoutingReadScope;
+    now: Date;
+}
+/** Validity of one person target (R112). Valid when `skipReason` is `null`. */
+export interface RoutingUserCheck {
+    /** Set whenever the user is a member of the teams. */
+    user: RoutingUser | null;
+    skipReason: RoutingSkipReason | null;
+}
+/** What the rule inspector shows for an unsaved step config (R121): no records, no load numbers (D104). */
+export interface RoutingInspection {
+    owner: RoutingUser | null;
+    source: RoutingSource;
+    ruleId: string | null;
+    /** The step's configured strategy. */
+    strategy: RoutingStrategy;
+    /**
+     * Every rule in order (R289). Excluded rule targets show the exclusion's own reason; editor
+     * only (R129, D118).
+     */
+    trace: RoutingInspectionTraceEntry[];
+    /** The skipped people with the trace's reasons (R129, D118). */
+    skipped: RoutingSkippedUser[];
+    /** The team a matched team-target rule narrowed the candidates to; null otherwise (R289). */
+    narrowedTeamId: string | null;
+    /** The first `INSPECTION_CANDIDATE_LIMIT` candidates in the strategy's order (R289). */
+    candidateIds: string[];
+    /** All candidates of the strategy, so the editor can say "and others" (R289). */
+    candidateCount: number;
+}
+/**
+ * A row of the request dialog's picker or the reassign dialog (R120, D128). `excludedReason`: the
+ * exclusion's own reason, a fixed reason, or `null`; the wrappers null it for viewers without
+ * `editor` / `reassign` (D97). No workload counts (D104).
+ */
+export interface StepCandidate {
+    id: string;
+    displayName: string;
+    /** The member's teams among the step's teams, in the step's order; team names are not sensitive (R208). */
+    teamIds: string[];
+    excluded: boolean;
+    excludedReason: string | null;
+}

package/domain/settings/WorkflowSettingsValidator.d.ts

@@ -0,0 +1,7 @@
+import { Result } from "@webiny/feature/api";
+import { WorkflowSettingsValidationError } from "./errors.js";
+import type { WorkflowSettings } from "./types.js";
+/** One entry per user (D105); end dates are stored as UTC instants (D43, D110). */
+export declare class WorkflowSettingsValidator {
+    static validate(settings: WorkflowSettings): Result<WorkflowSettings, WorkflowSettingsValidationError>;
+}

package/domain/settings/WorkflowSettingsValidator.js

@@ -0,0 +1,39 @@
+import { Result } from "@webiny/feature/api";
+import { WorkflowSettingsValidationError } from "./errors.js";
+const fail = (message, userId)=>Result.fail(new WorkflowSettingsValidationError(message, {
+        userId
+    }));
+class WorkflowSettingsValidator {
+    static validate(settings) {
+        const userIds = new Set();
+        const exclusions = [];
+        for (const exclusion of settings.exclusions){
+            const userId = (exclusion.userId ?? "").trim();
+            if (!userId) return fail("Every exclusion needs a user.", "");
+            if (userIds.has(userId)) return fail("This user is already in the list. Edit it instead.", userId);
+            userIds.add(userId);
+            let endsOn;
+            if (exclusion.endsOn) {
+                const time = Date.parse(exclusion.endsOn);
+                if (Number.isNaN(time)) return fail(`The end date "${exclusion.endsOn}" is not a valid date.`, userId);
+                endsOn = new Date(time).toISOString();
+            }
+            const reason = exclusion.reason?.trim();
+            exclusions.push({
+                userId,
+                ...reason ? {
+                    reason
+                } : {},
+                ...endsOn ? {
+                    endsOn
+                } : {}
+            });
+        }
+        return Result.ok({
+            exclusions
+        });
+    }
+}
+export { WorkflowSettingsValidator };
+
+//# sourceMappingURL=WorkflowSettingsValidator.js.map

package/domain/settings/WorkflowSettingsValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/settings/WorkflowSettingsValidator.js","sources":["../../../src/domain/settings/WorkflowSettingsValidator.ts"],"sourcesContent":["import { Result } from \"@webiny/feature/api\";\nimport { WorkflowSettingsValidationError } from \"./errors.js\";\nimport type { WorkflowExclusion, WorkflowSettings } from \"./types.js\";\n\nconst fail = (message: string, userId: string) => {\n    return Result.fail(new WorkflowSettingsValidationError(message, { userId }));\n};\n\n/** One entry per user (D105); end dates are stored as UTC instants (D43, D110). */\nexport class WorkflowSettingsValidator {\n    public static validate(\n        settings: WorkflowSettings\n    ): Result<WorkflowSettings, WorkflowSettingsValidationError> {\n        const userIds = new Set<string>();\n        const exclusions: WorkflowExclusion[] = [];\n\n        for (const exclusion of settings.exclusions) {\n            const userId = (exclusion.userId ?? \"\").trim();\n            if (!userId) {\n                return fail(\"Every exclusion needs a user.\", \"\");\n            }\n            if (userIds.has(userId)) {\n                return fail(\"This user is already in the list. Edit it instead.\", userId);\n            }\n            userIds.add(userId);\n\n            let endsOn: string | undefined;\n            if (exclusion.endsOn) {\n                const time = Date.parse(exclusion.endsOn);\n                if (Number.isNaN(time)) {\n                    return fail(`The end date \"${exclusion.endsOn}\" is not a valid date.`, userId);\n                }\n                endsOn = new Date(time).toISOString();\n            }\n\n            const reason = exclusion.reason?.trim();\n            exclusions.push({\n                userId,\n                ...(reason ? { reason } : {}),\n                ...(endsOn ? { endsOn } : {})\n            });\n        }\n\n        return Result.ok({ exclusions });\n    }\n}\n"],"names":["fail","message","userId","Result","WorkflowSettingsValidationError","WorkflowSettingsValidator","settings","userIds","Set","exclusions","exclusion","endsOn","time","Date","Number","reason"],"mappings":";;AAIA,MAAMA,OAAO,CAACC,SAAiBC,SACpBC,OAAO,IAAI,CAAC,IAAIC,gCAAgCH,SAAS;QAAEC;IAAO;AAItE,MAAMG;IACT,OAAc,SACVC,QAA0B,EAC+B;QACzD,MAAMC,UAAU,IAAIC;QACpB,MAAMC,aAAkC,EAAE;QAE1C,KAAK,MAAMC,aAAaJ,SAAS,UAAU,CAAE;YACzC,MAAMJ,SAAUQ,AAAAA,CAAAA,UAAU,MAAM,IAAI,EAAC,EAAG,IAAI;YAC5C,IAAI,CAACR,QACD,OAAOF,KAAK,iCAAiC;YAEjD,IAAIO,QAAQ,GAAG,CAACL,SACZ,OAAOF,KAAK,sDAAsDE;YAEtEK,QAAQ,GAAG,CAACL;YAEZ,IAAIS;YACJ,IAAID,UAAU,MAAM,EAAE;gBAClB,MAAME,OAAOC,KAAK,KAAK,CAACH,UAAU,MAAM;gBACxC,IAAII,OAAO,KAAK,CAACF,OACb,OAAOZ,KAAK,CAAC,cAAc,EAAEU,UAAU,MAAM,CAAC,sBAAsB,CAAC,EAAER;gBAE3ES,SAAS,IAAIE,KAAKD,MAAM,WAAW;YACvC;YAEA,MAAMG,SAASL,UAAU,MAAM,EAAE;YACjCD,WAAW,IAAI,CAAC;gBACZP;gBACA,GAAIa,SAAS;oBAAEA;gBAAO,IAAI,CAAC,CAAC;gBAC5B,GAAIJ,SAAS;oBAAEA;gBAAO,IAAI,CAAC,CAAC;YAChC;QACJ;QAEA,OAAOR,OAAO,EAAE,CAAC;YAAEM;QAAW;IAClC;AACJ"}

package/domain/settings/abstractions/WorkflowSettingsModelProvider.d.ts

@@ -0,0 +1,9 @@
+import type { CmsModel } from "@webiny/api-headless-cms/types/index.js";
+export interface IWorkflowSettingsModelProvider {
+    get(): Promise<CmsModel>;
+}
+/** Provides the tenant's `wbyWorkflowSettings` model on demand. */
+export declare const WorkflowSettingsModelProvider: import("@webiny/di").Abstraction<IWorkflowSettingsModelProvider>;
+export declare namespace WorkflowSettingsModelProvider {
+    type Interface = IWorkflowSettingsModelProvider;
+}

package/domain/settings/abstractions/WorkflowSettingsModelProvider.js

@@ -0,0 +1,5 @@
+import { createAbstraction } from "@webiny/feature/api";
+const WorkflowSettingsModelProvider = createAbstraction("WorkflowSettingsModelProvider");
+export { WorkflowSettingsModelProvider };
+
+//# sourceMappingURL=WorkflowSettingsModelProvider.js.map

package/domain/settings/abstractions/WorkflowSettingsModelProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/settings/abstractions/WorkflowSettingsModelProvider.js","sources":["../../../../src/domain/settings/abstractions/WorkflowSettingsModelProvider.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/api\";\nimport type { CmsModel } from \"@webiny/api-headless-cms/types/index.js\";\n\nexport interface IWorkflowSettingsModelProvider {\n    get(): Promise<CmsModel>;\n}\n\n/** Provides the tenant's `wbyWorkflowSettings` model on demand. */\nexport const WorkflowSettingsModelProvider = createAbstraction<IWorkflowSettingsModelProvider>(\n    \"WorkflowSettingsModelProvider\"\n);\n\nexport namespace WorkflowSettingsModelProvider {\n    export type Interface = IWorkflowSettingsModelProvider;\n}\n"],"names":["WorkflowSettingsModelProvider","createAbstraction"],"mappings":";AAQO,MAAMA,gCAAgCC,kBACzC"}

package/domain/settings/abstractions/WorkflowSettingsRepository.d.ts

@@ -0,0 +1,13 @@
+import { type Result } from "@webiny/feature/api";
+import type { WorkflowSettings } from "../types.js";
+import type { WorkflowSettingsPersistenceError } from "../errors.js";
+export interface IWorkflowSettingsRepository {
+    /** Stored settings, including expired exclusions; empty when nothing was saved yet. */
+    get(): Promise<Result<WorkflowSettings, WorkflowSettingsPersistenceError>>;
+    /** Writes the whole record; the last save wins (D106). */
+    save(settings: WorkflowSettings): Promise<Result<WorkflowSettings, WorkflowSettingsPersistenceError>>;
+}
+export declare const WorkflowSettingsRepository: import("@webiny/di").Abstraction<IWorkflowSettingsRepository>;
+export declare namespace WorkflowSettingsRepository {
+    type Interface = IWorkflowSettingsRepository;
+}

package/domain/settings/abstractions/WorkflowSettingsRepository.js

@@ -0,0 +1,5 @@
+import { createAbstraction } from "@webiny/feature/api";
+const WorkflowSettingsRepository = createAbstraction("WorkflowSettingsRepository");
+export { WorkflowSettingsRepository };
+
+//# sourceMappingURL=WorkflowSettingsRepository.js.map

package/domain/settings/abstractions/WorkflowSettingsRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/settings/abstractions/WorkflowSettingsRepository.js","sources":["../../../../src/domain/settings/abstractions/WorkflowSettingsRepository.ts"],"sourcesContent":["import { createAbstraction, type Result } from \"@webiny/feature/api\";\nimport type { WorkflowSettings } from \"../types.js\";\nimport type { WorkflowSettingsPersistenceError } from \"../errors.js\";\n\nexport interface IWorkflowSettingsRepository {\n    /** Stored settings, including expired exclusions; empty when nothing was saved yet. */\n    get(): Promise<Result<WorkflowSettings, WorkflowSettingsPersistenceError>>;\n    /** Writes the whole record; the last save wins (D106). */\n    save(\n        settings: WorkflowSettings\n    ): Promise<Result<WorkflowSettings, WorkflowSettingsPersistenceError>>;\n}\n\nexport const WorkflowSettingsRepository = createAbstraction<IWorkflowSettingsRepository>(\n    \"WorkflowSettingsRepository\"\n);\n\nexport namespace WorkflowSettingsRepository {\n    export type Interface = IWorkflowSettingsRepository;\n}\n"],"names":["WorkflowSettingsRepository","createAbstraction"],"mappings":";AAaO,MAAMA,6BAA6BC,kBACtC"}

package/domain/settings/errors.d.ts

@@ -0,0 +1,14 @@
+import { BaseError } from "@webiny/feature/api";
+import type { PersistenceErrorSource } from "../../domain/PersistenceErrorSource.js";
+import { PersistenceError } from "../../domain/PersistenceError.js";
+export interface WorkflowSettingsValidationErrorData {
+    userId: string;
+}
+export declare class WorkflowSettingsValidationError extends BaseError<WorkflowSettingsValidationErrorData> {
+    readonly code: "Workflows/Settings/Validation";
+    constructor(message: string, data: WorkflowSettingsValidationErrorData);
+}
+export declare class WorkflowSettingsPersistenceError extends PersistenceError {
+    readonly code: "Workflows/Settings/Persistence";
+    constructor(error: PersistenceErrorSource);
+}

package/domain/settings/errors.js

@@ -0,0 +1,18 @@
+import { BaseError } from "@webiny/feature/api";
+import { PersistenceError } from "../PersistenceError.js";
+class WorkflowSettingsValidationError extends BaseError {
+    constructor(message, data){
+        super({
+            message,
+            data
+        }), this.code = "Workflows/Settings/Validation";
+    }
+}
+class WorkflowSettingsPersistenceError extends PersistenceError {
+    constructor(error){
+        super("The workflow settings could not be read or saved.", error), this.code = "Workflows/Settings/Persistence";
+    }
+}
+export { WorkflowSettingsPersistenceError, WorkflowSettingsValidationError };
+
+//# sourceMappingURL=errors.js.map

package/domain/settings/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/settings/errors.js","sources":["../../../src/domain/settings/errors.ts"],"sourcesContent":["import { BaseError } from \"@webiny/feature/api\";\nimport type { PersistenceErrorSource } from \"~/domain/PersistenceErrorSource.js\";\nimport { PersistenceError } from \"~/domain/PersistenceError.js\";\n\nexport interface WorkflowSettingsValidationErrorData {\n    userId: string;\n}\n\nexport class WorkflowSettingsValidationError extends BaseError<WorkflowSettingsValidationErrorData> {\n    override readonly code = \"Workflows/Settings/Validation\" as const;\n\n    constructor(message: string, data: WorkflowSettingsValidationErrorData) {\n        super({ message, data });\n    }\n}\n\nexport class WorkflowSettingsPersistenceError extends PersistenceError {\n    override readonly code = \"Workflows/Settings/Persistence\" as const;\n\n    constructor(error: PersistenceErrorSource) {\n        super(\"The workflow settings could not be read or saved.\", error);\n    }\n}\n"],"names":["WorkflowSettingsValidationError","BaseError","message","data","WorkflowSettingsPersistenceError","PersistenceError","error"],"mappings":";;AAQO,MAAMA,wCAAwCC;IAGjD,YAAYC,OAAe,EAAEC,IAAyC,CAAE;QACpE,KAAK,CAAC;YAAED;YAASC;QAAK,SAHR,IAAI,GAAG;IAIzB;AACJ;AAEO,MAAMC,yCAAyCC;IAGlD,YAAYC,KAA6B,CAAE;QACvC,KAAK,CAAC,qDAAqDA,QAAAA,IAAAA,CAH7C,IAAI,GAAG;IAIzB;AACJ"}

package/domain/settings/filterActiveExclusions.d.ts

@@ -0,0 +1,3 @@
+import type { WorkflowExclusion } from "./types.js";
+/** Expired entries stay stored until removed (D105) but are filtered on read (spec 4.4). */
+export declare const filterActiveExclusions: (exclusions: WorkflowExclusion[], now: Date) => WorkflowExclusion[];

package/domain/settings/filterActiveExclusions.js

@@ -0,0 +1,4 @@
+const filterActiveExclusions = (exclusions, now)=>exclusions.filter((exclusion)=>!exclusion.endsOn || Date.parse(exclusion.endsOn) > now.getTime());
+export { filterActiveExclusions };
+
+//# sourceMappingURL=filterActiveExclusions.js.map

package/domain/settings/filterActiveExclusions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/settings/filterActiveExclusions.js","sources":["../../../src/domain/settings/filterActiveExclusions.ts"],"sourcesContent":["import type { WorkflowExclusion } from \"./types.js\";\n\n/** Expired entries stay stored until removed (D105) but are filtered on read (spec 4.4). */\nexport const filterActiveExclusions = (\n    exclusions: WorkflowExclusion[],\n    now: Date\n): WorkflowExclusion[] => {\n    return exclusions.filter(exclusion => {\n        return !exclusion.endsOn || Date.parse(exclusion.endsOn) > now.getTime();\n    });\n};\n"],"names":["filterActiveExclusions","exclusions","now","exclusion","Date"],"mappings":"AAGO,MAAMA,yBAAyB,CAClCC,YACAC,MAEOD,WAAW,MAAM,CAACE,CAAAA,YACd,CAACA,UAAU,MAAM,IAAIC,KAAK,KAAK,CAACD,UAAU,MAAM,IAAID,IAAI,OAAO"}

package/domain/settings/settings.model.d.ts

@@ -0,0 +1,9 @@
+import { ModelFactory } from "@webiny/api-headless-cms/features/modelBuilder/index.js";
+/** Private model for tenant workflow settings (spec 4.4); one entry per tenant. */
+declare class WorkflowSettingsModelImpl implements ModelFactory.Interface {
+    execute(builder: ModelFactory.Builder): Promise<import("@webiny/api-headless-cms/features/modelBuilder/index.js").PrivateModelBuilder[]>;
+}
+export declare const WorkflowSettingsModel: typeof WorkflowSettingsModelImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("@webiny/api-headless-cms/features/modelBuilder/abstractions").IModelFactory>;
+};
+export {};

package/domain/settings/settings.model.js

@@ -0,0 +1,26 @@
+import { ModelFactory } from "@webiny/api-headless-cms/features/modelBuilder/index.js";
+import { WORKFLOW_SETTINGS_MODEL_ID } from "../../constants.js";
+class WorkflowSettingsModelImpl {
+    async execute(builder) {
+        return [
+            builder.private({
+                modelId: WORKFLOW_SETTINGS_MODEL_ID,
+                name: "Workflow Settings",
+                lifecycleEvents: false
+            }).fields((fields)=>({
+                    exclusions: fields.object().label("Exclusions").list().fields((exclusionFields)=>({
+                            userId: exclusionFields.text().label("User ID"),
+                            reason: exclusionFields.longText().label("Reason"),
+                            endsOn: exclusionFields.datetime().label("Ends on").withoutTimezone()
+                        }))
+                }))
+        ];
+    }
+}
+const WorkflowSettingsModel = ModelFactory.createImplementation({
+    implementation: WorkflowSettingsModelImpl,
+    dependencies: []
+});
+export { WorkflowSettingsModel };
+
+//# sourceMappingURL=settings.model.js.map

package/domain/settings/settings.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/settings/settings.model.js","sources":["../../../src/domain/settings/settings.model.ts"],"sourcesContent":["import { ModelFactory } from \"@webiny/api-headless-cms/features/modelBuilder/index.js\";\nimport { WORKFLOW_SETTINGS_MODEL_ID } from \"~/constants.js\";\n\n/** Private model for tenant workflow settings (spec 4.4); one entry per tenant. */\nclass WorkflowSettingsModelImpl implements ModelFactory.Interface {\n    public async execute(builder: ModelFactory.Builder) {\n        return [\n            builder\n                .private({\n                    modelId: WORKFLOW_SETTINGS_MODEL_ID,\n                    name: \"Workflow Settings\",\n                    lifecycleEvents: false\n                })\n                .fields(fields => ({\n                    exclusions: fields\n                        .object()\n                        .label(\"Exclusions\")\n                        .list()\n                        .fields(exclusionFields => ({\n                            userId: exclusionFields.text().label(\"User ID\"),\n                            reason: exclusionFields.longText().label(\"Reason\"),\n                            endsOn: exclusionFields.datetime().label(\"Ends on\").withoutTimezone()\n                        }))\n                }))\n        ];\n    }\n}\n\nexport const WorkflowSettingsModel = ModelFactory.createImplementation({\n    implementation: WorkflowSettingsModelImpl,\n    dependencies: []\n});\n"],"names":["WorkflowSettingsModelImpl","builder","WORKFLOW_SETTINGS_MODEL_ID","fields","exclusionFields","WorkflowSettingsModel","ModelFactory"],"mappings":";;AAIA,MAAMA;IACF,MAAa,QAAQC,OAA6B,EAAE;QAChD,OAAO;YACHA,QACK,OAAO,CAAC;gBACL,SAASC;gBACT,MAAM;gBACN,iBAAiB;YACrB,GACC,MAAM,CAACC,CAAAA,SAAW;oBACf,YAAYA,OACP,MAAM,GACN,KAAK,CAAC,cACN,IAAI,GACJ,MAAM,CAACC,CAAAA,kBAAoB;4BACxB,QAAQA,gBAAgB,IAAI,GAAG,KAAK,CAAC;4BACrC,QAAQA,gBAAgB,QAAQ,GAAG,KAAK,CAAC;4BACzC,QAAQA,gBAAgB,QAAQ,GAAG,KAAK,CAAC,WAAW,eAAe;wBACvE;gBACR;SACP;IACL;AACJ;AAEO,MAAMC,wBAAwBC,aAAa,oBAAoB,CAAC;IACnE,gBAAgBN;IAChB,cAAc,EAAE;AACpB"}

package/domain/settings/types.d.ts

@@ -0,0 +1,10 @@
+export interface WorkflowExclusion {
+    userId: string;
+    reason?: string;
+    /** ISO datetime in UTC (D43, D110). */
+    endsOn?: string;
+}
+/** Tenant workflow settings (spec 4.4, D16). */
+export interface WorkflowSettings {
+    exclusions: WorkflowExclusion[];
+}

package/domain/toChunks.d.ts

@@ -0,0 +1,2 @@
+/** Splits items into chunks of `size`, in order. Pure. */
+export declare const toChunks: <T>(items: T[], size: number) => T[][];

package/domain/toChunks.js

@@ -0,0 +1,8 @@
+const toChunks = (items, size)=>{
+    const chunks = [];
+    for(let index = 0; index < items.length; index += size)chunks.push(items.slice(index, index + size));
+    return chunks;
+};
+export { toChunks };
+
+//# sourceMappingURL=toChunks.js.map

package/domain/toChunks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/toChunks.js","sources":["../../src/domain/toChunks.ts"],"sourcesContent":["/** Splits items into chunks of `size`, in order. Pure. */\nexport const toChunks = <T>(items: T[], size: number): T[][] => {\n    const chunks: T[][] = [];\n    for (let index = 0; index < items.length; index += size) {\n        chunks.push(items.slice(index, index + size));\n    }\n    return chunks;\n};\n"],"names":["toChunks","items","size","chunks","index"],"mappings":"AACO,MAAMA,WAAW,CAAIC,OAAYC;IACpC,MAAMC,SAAgB,EAAE;IACxB,IAAK,IAAIC,QAAQ,GAAGA,QAAQH,MAAM,MAAM,EAAEG,SAASF,KAC/CC,OAAO,IAAI,CAACF,MAAM,KAAK,CAACG,OAAOA,QAAQF;IAE3C,OAAOC;AACX"}

package/domain/workflow/WorkflowValidator.d.ts

@@ -0,0 +1,26 @@
+import { Result } from "@webiny/feature/api";
+import { WorkflowValidationError } from "./errors.js";
+import type { WorkflowStep, WorkflowValues } from "./types.js";
+/**
+ * Whether an app knows the model: `WorkflowModelParserService` parses it (each app adapter
+ * registers its parser). Whether the model exists and is publishable is checked by the app's
+ * workflows package on `WorkflowBeforeCreate|Update`.
+ */
+export type WorkflowModelCheck = (model: string) => boolean;
+/**
+ * Validates one step's type and config: the step type registry's `validate` (R131). Returns the
+ * step with its normalised `config`.
+ */
+export type WorkflowStepValidator = (step: WorkflowStep) => Result<WorkflowStep, WorkflowValidationError>;
+/**
+ * Validates a workflow on create and update (one path, spec 4.1, D41, D108). It checks the
+ * structure (id, name, one model an app knows, steps, step ids and titles) and normalises each step; the step
+ * type and its config are checked by `validateStep`, which `StoreWorkflowUseCase` builds from the
+ * step type registry. Checks that need storage (model already bound to another workflow) live in
+ * `StoreWorkflowUseCase`; the "model is publishable" check is a `WorkflowBeforeCreate` /
+ * `WorkflowBeforeUpdate` handler in the CMS workflows package.
+ */
+export declare class WorkflowValidator {
+    static validate(values: WorkflowValues, validateStep: WorkflowStepValidator, isKnownModel: WorkflowModelCheck): Result<WorkflowValues, WorkflowValidationError>;
+    private static validateStep;
+}