@webiny/api-workflows 0.0.0-unstable.0156a4c312

package/features/notifications/shared/getErrorLogFields.js

@@ -0,0 +1,10 @@
+const getErrorLogFields = (error)=>{
+    const source = "object" == typeof error && null !== error ? error : {};
+    return {
+        errorCode: "string" == typeof source.code ? source.code : void 0,
+        errorName: "string" == typeof source.name ? source.name : void 0
+    };
+};
+export { getErrorLogFields };
+
+//# sourceMappingURL=getErrorLogFields.js.map

package/features/notifications/shared/getErrorLogFields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/notifications/shared/getErrorLogFields.js","sources":["../../../../src/features/notifications/shared/getErrorLogFields.ts"],"sourcesContent":["/** What `getErrorLogFields` reads from a caught value: only these two, and only when strings. */\ninterface ErrorLike {\n    code?: unknown;\n    name?: unknown;\n}\n\nexport interface ErrorLogFields {\n    errorCode: string | undefined;\n    errorName: string | undefined;\n}\n\n/**\n * The only parts of a caught value a notification log carries (R196): its `code` and `name`, and\n * only when they are strings. Never the message (it can embed addresses or tokens), never the\n * error object. A `BaseError` subclass reports `\"Error\"` as its name. Pure.\n */\nexport const getErrorLogFields = (error: unknown): ErrorLogFields => {\n    const source: ErrorLike = typeof error === \"object\" && error !== null ? error : {};\n    return {\n        errorCode: typeof source.code === \"string\" ? source.code : undefined,\n        errorName: typeof source.name === \"string\" ? source.name : undefined\n    };\n};\n"],"names":["getErrorLogFields","error","source","undefined"],"mappings":"AAgBO,MAAMA,oBAAoB,CAACC;IAC9B,MAAMC,SAAoB,AAAiB,YAAjB,OAAOD,SAAsBA,AAAU,SAAVA,QAAiBA,QAAQ,CAAC;IACjF,OAAO;QACH,WAAW,AAAuB,YAAvB,OAAOC,OAAO,IAAI,GAAgBA,OAAO,IAAI,GAAGC;QAC3D,WAAW,AAAuB,YAAvB,OAAOD,OAAO,IAAI,GAAgBA,OAAO,IAAI,GAAGC;IAC/D;AACJ"}

package/features/permissions/WorkflowEditorAccess/WorkflowEditorAccess.d.ts

@@ -0,0 +1,13 @@
+import { CurrentReviewViewer } from "../../../features/identity/CurrentReviewViewer/index.js";
+import { WorkflowsPermissions } from "../../../features/permissions/WorkflowsPermissions/index.js";
+import { WorkflowEditorAccess as Abstraction } from "./abstractions.js";
+declare class WorkflowEditorAccessImpl implements Abstraction.Interface {
+    private viewer;
+    private permissions;
+    constructor(viewer: CurrentReviewViewer.Interface, permissions: WorkflowsPermissions.Interface);
+    check(action: string): Abstraction.Return;
+}
+export declare const WorkflowEditorAccess: typeof WorkflowEditorAccessImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("./abstractions.js").IWorkflowEditorAccess>;
+};
+export {};

package/features/permissions/WorkflowEditorAccess/WorkflowEditorAccess.js

@@ -0,0 +1,37 @@
+import { Result } from "@webiny/feature/api";
+import { WorkflowsNotAuthorizedError } from "../../../domain/permissions/errors.js";
+import { WorkflowLookupError } from "../../../domain/workflow/errors.js";
+import { CurrentReviewViewer } from "../../identity/CurrentReviewViewer/index.js";
+import { WorkflowsPermissions } from "../WorkflowsPermissions/index.js";
+import { WorkflowEditorAccess } from "./abstractions.js";
+class WorkflowEditorAccessImpl {
+    constructor(viewer, permissions){
+        this.viewer = viewer;
+        this.permissions = permissions;
+    }
+    async check(action) {
+        const actor = this.viewer.getActor();
+        if (actor.isFail()) return Result.fail(actor.error);
+        let canEdit;
+        try {
+            canEdit = await this.permissions.canEdit();
+        } catch (error) {
+            const cause = error instanceof Error ? error : new Error(String(error));
+            return Result.fail(new WorkflowLookupError(cause));
+        }
+        if (!canEdit) return Result.fail(new WorkflowsNotAuthorizedError({
+            action
+        }));
+        return Result.ok();
+    }
+}
+const WorkflowEditorAccess_WorkflowEditorAccess = WorkflowEditorAccess.createImplementation({
+    implementation: WorkflowEditorAccessImpl,
+    dependencies: [
+        CurrentReviewViewer,
+        WorkflowsPermissions
+    ]
+});
+export { WorkflowEditorAccess_WorkflowEditorAccess as WorkflowEditorAccess };
+
+//# sourceMappingURL=WorkflowEditorAccess.js.map

package/features/permissions/WorkflowEditorAccess/WorkflowEditorAccess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/permissions/WorkflowEditorAccess/WorkflowEditorAccess.js","sources":["../../../../src/features/permissions/WorkflowEditorAccess/WorkflowEditorAccess.ts"],"sourcesContent":["import { Result } from \"@webiny/feature/api\";\nimport { WorkflowsNotAuthorizedError } from \"~/domain/permissions/errors.js\";\nimport { WorkflowLookupError } from \"~/domain/workflow/errors.js\";\nimport { CurrentReviewViewer } from \"~/features/identity/CurrentReviewViewer/index.js\";\nimport { WorkflowsPermissions } from \"~/features/permissions/WorkflowsPermissions/index.js\";\nimport { WorkflowEditorAccess as Abstraction } from \"./abstractions.js\";\n\nclass WorkflowEditorAccessImpl implements Abstraction.Interface {\n    public constructor(\n        private viewer: CurrentReviewViewer.Interface,\n        private permissions: WorkflowsPermissions.Interface\n    ) {}\n\n    public async check(action: string): Abstraction.Return {\n        const actor = this.viewer.getActor();\n        if (actor.isFail()) {\n            return Result.fail(actor.error);\n        }\n        let canEdit: boolean;\n        try {\n            canEdit = await this.permissions.canEdit();\n        } catch (error) {\n            const cause = error instanceof Error ? error : new Error(String(error));\n            return Result.fail(new WorkflowLookupError(cause));\n        }\n        if (!canEdit) {\n            return Result.fail(new WorkflowsNotAuthorizedError({ action }));\n        }\n        return Result.ok();\n    }\n}\n\nexport const WorkflowEditorAccess = Abstraction.createImplementation({\n    implementation: WorkflowEditorAccessImpl,\n    dependencies: [CurrentReviewViewer, WorkflowsPermissions]\n});\n"],"names":["WorkflowEditorAccessImpl","viewer","permissions","action","actor","Result","canEdit","error","cause","Error","String","WorkflowLookupError","WorkflowsNotAuthorizedError","WorkflowEditorAccess","Abstraction","CurrentReviewViewer","WorkflowsPermissions"],"mappings":";;;;;;AAOA,MAAMA;IACF,YACYC,MAAqC,EACrCC,WAA2C,CACrD;aAFUD,MAAM,GAANA;aACAC,WAAW,GAAXA;IACT;IAEH,MAAa,MAAMC,MAAc,EAAsB;QACnD,MAAMC,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ;QAClC,IAAIA,MAAM,MAAM,IACZ,OAAOC,OAAO,IAAI,CAACD,MAAM,KAAK;QAElC,IAAIE;QACJ,IAAI;YACAA,UAAU,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO;QAC5C,EAAE,OAAOC,OAAO;YACZ,MAAMC,QAAQD,iBAAiBE,QAAQF,QAAQ,IAAIE,MAAMC,OAAOH;YAChE,OAAOF,OAAO,IAAI,CAAC,IAAIM,oBAAoBH;QAC/C;QACA,IAAI,CAACF,SACD,OAAOD,OAAO,IAAI,CAAC,IAAIO,4BAA4B;YAAET;QAAO;QAEhE,OAAOE,OAAO,EAAE;IACpB;AACJ;AAEO,MAAMQ,4CAAuBC,qBAAAA,oBAAgC,CAAC;IACjE,gBAAgBd;IAChB,cAAc;QAACe;QAAqBC;KAAqB;AAC7D"}

package/features/permissions/WorkflowEditorAccess/abstractions.d.ts

@@ -0,0 +1,28 @@
+import { type Result } from "@webiny/feature/api";
+import type { WorkflowLookupError } from "../../../domain/workflow/errors.js";
+import type { WorkflowsNotAuthenticatedError, WorkflowsNotAuthorizedError } from "../../../domain/permissions/errors.js";
+export interface IWorkflowEditorAccessErrors {
+    notAuthenticated: WorkflowsNotAuthenticatedError;
+    notAuthorized: WorkflowsNotAuthorizedError;
+    lookup: WorkflowLookupError;
+}
+type WorkflowEditorAccessError = IWorkflowEditorAccessErrors[keyof IWorkflowEditorAccessErrors];
+export interface IWorkflowEditorAccess {
+    /**
+     * Ok when the current identity is signed in and has `workflows.editor` (or full access).
+     * `action` names what is refused in the not-authorized error, e.g. `list users`. A permission
+     * load that throws is a lookup error.
+     */
+    check(action: string): Promise<Result<void, WorkflowEditorAccessError>>;
+}
+/**
+ * The editor access check shared by the configuration use cases (D133 point 2, R97): a signed-in
+ * identity with `workflows.editor`.
+ */
+export declare const WorkflowEditorAccess: import("@webiny/di").Abstraction<IWorkflowEditorAccess>;
+export declare namespace WorkflowEditorAccess {
+    type Interface = IWorkflowEditorAccess;
+    type Error = WorkflowEditorAccessError;
+    type Return = Promise<Result<void, WorkflowEditorAccessError>>;
+}
+export {};

package/features/permissions/WorkflowEditorAccess/abstractions.js

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

package/features/permissions/WorkflowEditorAccess/abstractions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/permissions/WorkflowEditorAccess/abstractions.js","sources":["../../../../src/features/permissions/WorkflowEditorAccess/abstractions.ts"],"sourcesContent":["import { createAbstraction, type Result } from \"@webiny/feature/api\";\nimport type { WorkflowLookupError } from \"~/domain/workflow/errors.js\";\nimport type {\n    WorkflowsNotAuthenticatedError,\n    WorkflowsNotAuthorizedError\n} from \"~/domain/permissions/errors.js\";\n\nexport interface IWorkflowEditorAccessErrors {\n    notAuthenticated: WorkflowsNotAuthenticatedError;\n    notAuthorized: WorkflowsNotAuthorizedError;\n    lookup: WorkflowLookupError;\n}\n\ntype WorkflowEditorAccessError = IWorkflowEditorAccessErrors[keyof IWorkflowEditorAccessErrors];\n\nexport interface IWorkflowEditorAccess {\n    /**\n     * Ok when the current identity is signed in and has `workflows.editor` (or full access).\n     * `action` names what is refused in the not-authorized error, e.g. `list users`. A permission\n     * load that throws is a lookup error.\n     */\n    check(action: string): Promise<Result<void, WorkflowEditorAccessError>>;\n}\n\n/**\n * The editor access check shared by the configuration use cases (D133 point 2, R97): a signed-in\n * identity with `workflows.editor`.\n */\nexport const WorkflowEditorAccess =\n    createAbstraction<IWorkflowEditorAccess>(\"WorkflowEditorAccess\");\n\nexport namespace WorkflowEditorAccess {\n    export type Interface = IWorkflowEditorAccess;\n    export type Error = WorkflowEditorAccessError;\n    export type Return = Promise<Result<void, WorkflowEditorAccessError>>;\n}\n"],"names":["WorkflowEditorAccess","createAbstraction"],"mappings":";AA4BO,MAAMA,uBACTC,kBAAyC"}

package/features/permissions/WorkflowEditorAccess/feature.d.ts

@@ -0,0 +1,4 @@
+export declare const WorkflowEditorAccessFeature: {
+    name: string;
+    register(container: import("@webiny/di").Container): void;
+};

package/features/permissions/WorkflowEditorAccess/feature.js

@@ -0,0 +1,11 @@
+import { createFeature } from "@webiny/feature/api";
+import { WorkflowEditorAccess } from "./WorkflowEditorAccess.js";
+const WorkflowEditorAccessFeature = createFeature({
+    name: "Workflows/WorkflowEditorAccess",
+    register (container) {
+        container.register(WorkflowEditorAccess);
+    }
+});
+export { WorkflowEditorAccessFeature };
+
+//# sourceMappingURL=feature.js.map

package/features/permissions/WorkflowEditorAccess/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/permissions/WorkflowEditorAccess/feature.js","sources":["../../../../src/features/permissions/WorkflowEditorAccess/feature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/api\";\nimport { WorkflowEditorAccess } from \"./WorkflowEditorAccess.js\";\n\nexport const WorkflowEditorAccessFeature = createFeature({\n    name: \"Workflows/WorkflowEditorAccess\",\n    register(container) {\n        container.register(WorkflowEditorAccess);\n    }\n});\n"],"names":["WorkflowEditorAccessFeature","createFeature","container","WorkflowEditorAccess"],"mappings":";;AAGO,MAAMA,8BAA8BC,cAAc;IACrD,MAAM;IACN,UAASC,SAAS;QACdA,UAAU,QAAQ,CAACC;IACvB;AACJ"}

package/features/permissions/WorkflowEditorAccess/index.d.ts

@@ -0,0 +1 @@
+export { WorkflowEditorAccess } from "./abstractions.js";

package/features/permissions/WorkflowEditorAccess/index.js

@@ -0,0 +1 @@
+export { WorkflowEditorAccess } from "./abstractions.js";

package/features/permissions/WorkflowsPermissions/WorkflowsPermissions.d.ts

@@ -0,0 +1,20 @@
+import { IdentityContext } from "@webiny/api-core/features/security/IdentityContext/index.js";
+import type { WorkflowsPermissionSet } from "../../../domain/permissions/types.js";
+import { WorkflowsPermissions as Abstraction } from "./abstractions.js";
+/**
+ * Reads the identity's `workflows` permissions on every call: `IdentityContext` already caches
+ * the loaded permissions per identity, and `withIdentity` can switch the identity mid-request, so
+ * a second cache here could answer for the wrong identity.
+ */
+declare class WorkflowsPermissionsImpl implements Abstraction.Interface {
+    private identityContext;
+    constructor(identityContext: IdentityContext.Interface);
+    isFullAccess(): Promise<boolean>;
+    canEdit(): Promise<boolean>;
+    canReassign(): Promise<boolean>;
+    getPermissionSet(): Promise<WorkflowsPermissionSet>;
+}
+export declare const WorkflowsPermissions: typeof WorkflowsPermissionsImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("./abstractions.js").IWorkflowsPermissions>;
+};
+export {};

package/features/permissions/WorkflowsPermissions/WorkflowsPermissions.js

@@ -0,0 +1,44 @@
+import { IdentityContext } from "@webiny/api-core/features/security/IdentityContext/index.js";
+import { WORKFLOWS_PERMISSION } from "../../../constants.js";
+import { WorkflowsPermissions } from "./abstractions.js";
+const FULL_ACCESS_PERMISSION = `${WORKFLOWS_PERMISSION}.*`;
+class WorkflowsPermissionsImpl {
+    constructor(identityContext){
+        this.identityContext = identityContext;
+    }
+    async isFullAccess() {
+        const permission = await this.identityContext.getPermission(FULL_ACCESS_PERMISSION);
+        return null !== permission;
+    }
+    async canEdit() {
+        if (await this.isFullAccess()) return true;
+        const permissions = await this.identityContext.getPermissions(WORKFLOWS_PERMISSION);
+        return permissions.some((permission)=>true === permission.editor);
+    }
+    async canReassign() {
+        if (await this.isFullAccess()) return true;
+        const permissions = await this.identityContext.getPermissions(WORKFLOWS_PERMISSION);
+        return permissions.some((permission)=>true === permission.reassign);
+    }
+    async getPermissionSet() {
+        const [fullAccess, editor, reassign] = await Promise.all([
+            this.isFullAccess(),
+            this.canEdit(),
+            this.canReassign()
+        ]);
+        return {
+            fullAccess,
+            editor,
+            reassign
+        };
+    }
+}
+const WorkflowsPermissions_WorkflowsPermissions = WorkflowsPermissions.createImplementation({
+    implementation: WorkflowsPermissionsImpl,
+    dependencies: [
+        IdentityContext
+    ]
+});
+export { WorkflowsPermissions_WorkflowsPermissions as WorkflowsPermissions };
+
+//# sourceMappingURL=WorkflowsPermissions.js.map

package/features/permissions/WorkflowsPermissions/WorkflowsPermissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/permissions/WorkflowsPermissions/WorkflowsPermissions.js","sources":["../../../../src/features/permissions/WorkflowsPermissions/WorkflowsPermissions.ts"],"sourcesContent":["import { IdentityContext } from \"@webiny/api-core/features/security/IdentityContext/index.js\";\nimport { WORKFLOWS_PERMISSION } from \"~/constants.js\";\nimport type { IWorkflowsSecurityPermission } from \"~/types.js\";\nimport type { WorkflowsPermissionSet } from \"~/domain/permissions/types.js\";\nimport { WorkflowsPermissions as Abstraction } from \"./abstractions.js\";\n\nconst FULL_ACCESS_PERMISSION = `${WORKFLOWS_PERMISSION}.*`;\n\n/**\n * Reads the identity's `workflows` permissions on every call: `IdentityContext` already caches\n * the loaded permissions per identity, and `withIdentity` can switch the identity mid-request, so\n * a second cache here could answer for the wrong identity.\n */\nclass WorkflowsPermissionsImpl implements Abstraction.Interface {\n    public constructor(private identityContext: IdentityContext.Interface) {}\n\n    public async isFullAccess(): Promise<boolean> {\n        // `getPermission` matches patterns, so `*` matches too; with authorization disabled it\n        // returns `*`.\n        const permission = await this.identityContext.getPermission(FULL_ACCESS_PERMISSION);\n        return permission !== null;\n    }\n\n    public async canEdit(): Promise<boolean> {\n        // Granted when full access, or when any `workflows` permission (one per role) sets the flag.\n        if (await this.isFullAccess()) {\n            return true;\n        }\n        const permissions =\n            await this.identityContext.getPermissions<IWorkflowsSecurityPermission>(\n                WORKFLOWS_PERMISSION\n            );\n        return permissions.some(permission => permission.editor === true);\n    }\n\n    public async canReassign(): Promise<boolean> {\n        // Granted when full access, or when any `workflows` permission (one per role) sets the flag.\n        if (await this.isFullAccess()) {\n            return true;\n        }\n        const permissions =\n            await this.identityContext.getPermissions<IWorkflowsSecurityPermission>(\n                WORKFLOWS_PERMISSION\n            );\n        return permissions.some(permission => permission.reassign === true);\n    }\n\n    public async getPermissionSet(): Promise<WorkflowsPermissionSet> {\n        const [fullAccess, editor, reassign] = await Promise.all([\n            this.isFullAccess(),\n            this.canEdit(),\n            this.canReassign()\n        ]);\n        return { fullAccess, editor, reassign };\n    }\n}\n\nexport const WorkflowsPermissions = Abstraction.createImplementation({\n    implementation: WorkflowsPermissionsImpl,\n    dependencies: [IdentityContext]\n});\n"],"names":["FULL_ACCESS_PERMISSION","WORKFLOWS_PERMISSION","WorkflowsPermissionsImpl","identityContext","permission","permissions","fullAccess","editor","reassign","Promise","WorkflowsPermissions","Abstraction","IdentityContext"],"mappings":";;;AAMA,MAAMA,yBAAyB,GAAGC,qBAAqB,EAAE,CAAC;AAO1D,MAAMC;IACF,YAA2BC,eAA0C,CAAE;aAA5CA,eAAe,GAAfA;IAA6C;IAExE,MAAa,eAAiC;QAG1C,MAAMC,aAAa,MAAM,IAAI,CAAC,eAAe,CAAC,aAAa,CAACJ;QAC5D,OAAOI,AAAe,SAAfA;IACX;IAEA,MAAa,UAA4B;QAErC,IAAI,MAAM,IAAI,CAAC,YAAY,IACvB,OAAO;QAEX,MAAMC,cACF,MAAM,IAAI,CAAC,eAAe,CAAC,cAAc,CACrCJ;QAER,OAAOI,YAAY,IAAI,CAACD,CAAAA,aAAcA,AAAsB,SAAtBA,WAAW,MAAM;IAC3D;IAEA,MAAa,cAAgC;QAEzC,IAAI,MAAM,IAAI,CAAC,YAAY,IACvB,OAAO;QAEX,MAAMC,cACF,MAAM,IAAI,CAAC,eAAe,CAAC,cAAc,CACrCJ;QAER,OAAOI,YAAY,IAAI,CAACD,CAAAA,aAAcA,AAAwB,SAAxBA,WAAW,QAAQ;IAC7D;IAEA,MAAa,mBAAoD;QAC7D,MAAM,CAACE,YAAYC,QAAQC,SAAS,GAAG,MAAMC,QAAQ,GAAG,CAAC;YACrD,IAAI,CAAC,YAAY;YACjB,IAAI,CAAC,OAAO;YACZ,IAAI,CAAC,WAAW;SACnB;QACD,OAAO;YAAEH;YAAYC;YAAQC;QAAS;IAC1C;AACJ;AAEO,MAAME,4CAAuBC,qBAAAA,oBAAgC,CAAC;IACjE,gBAAgBT;IAChB,cAAc;QAACU;KAAgB;AACnC"}

package/features/permissions/WorkflowsPermissions/abstractions.d.ts

@@ -0,0 +1,20 @@
+import type { WorkflowsPermissionSet } from "../../../domain/permissions/types.js";
+export interface IWorkflowsPermissions {
+    /** `*` or `workflows.*` (D54). */
+    isFullAccess(): Promise<boolean>;
+    /** `editor`, or full access: configure workflows and tenant settings (spec 8). */
+    canEdit(): Promise<boolean>;
+    /** `reassign`, or full access: reassign, restart, cancel reviews of others (spec 8, D34). */
+    canReassign(): Promise<boolean>;
+    /** All three answers at once, for viewer flags (spec 5.3). */
+    getPermissionSet(): Promise<WorkflowsPermissionSet>;
+}
+/**
+ * The one shared checker of the `workflows` permission (spec 8, D54). A building block for the
+ * app wrappers (D132). The api-workflows engine use cases never call it; only the app wrappers
+ * and the shared configuration use cases (R97) do.
+ */
+export declare const WorkflowsPermissions: import("@webiny/di").Abstraction<IWorkflowsPermissions>;
+export declare namespace WorkflowsPermissions {
+    type Interface = IWorkflowsPermissions;
+}

package/features/permissions/WorkflowsPermissions/abstractions.js

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

package/features/permissions/WorkflowsPermissions/abstractions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/permissions/WorkflowsPermissions/abstractions.js","sources":["../../../../src/features/permissions/WorkflowsPermissions/abstractions.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/api\";\nimport type { WorkflowsPermissionSet } from \"~/domain/permissions/types.js\";\n\nexport interface IWorkflowsPermissions {\n    /** `*` or `workflows.*` (D54). */\n    isFullAccess(): Promise<boolean>;\n    /** `editor`, or full access: configure workflows and tenant settings (spec 8). */\n    canEdit(): Promise<boolean>;\n    /** `reassign`, or full access: reassign, restart, cancel reviews of others (spec 8, D34). */\n    canReassign(): Promise<boolean>;\n    /** All three answers at once, for viewer flags (spec 5.3). */\n    getPermissionSet(): Promise<WorkflowsPermissionSet>;\n}\n\n/**\n * The one shared checker of the `workflows` permission (spec 8, D54). A building block for the\n * app wrappers (D132). The api-workflows engine use cases never call it; only the app wrappers\n * and the shared configuration use cases (R97) do.\n */\nexport const WorkflowsPermissions =\n    createAbstraction<IWorkflowsPermissions>(\"WorkflowsPermissions\");\n\nexport namespace WorkflowsPermissions {\n    export type Interface = IWorkflowsPermissions;\n}\n"],"names":["WorkflowsPermissions","createAbstraction"],"mappings":";AAmBO,MAAMA,uBACTC,kBAAyC"}

package/features/permissions/WorkflowsPermissions/feature.d.ts

@@ -0,0 +1,4 @@
+export declare const WorkflowsPermissionsFeature: {
+    name: string;
+    register(container: import("@webiny/di").Container): void;
+};

package/features/permissions/WorkflowsPermissions/feature.js

@@ -0,0 +1,11 @@
+import { createFeature } from "@webiny/feature/api";
+import { WorkflowsPermissions } from "./WorkflowsPermissions.js";
+const WorkflowsPermissionsFeature = createFeature({
+    name: "Workflows/WorkflowsPermissions",
+    register (container) {
+        container.register(WorkflowsPermissions);
+    }
+});
+export { WorkflowsPermissionsFeature };
+
+//# sourceMappingURL=feature.js.map

package/features/permissions/WorkflowsPermissions/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/permissions/WorkflowsPermissions/feature.js","sources":["../../../../src/features/permissions/WorkflowsPermissions/feature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/api\";\nimport { WorkflowsPermissions } from \"./WorkflowsPermissions.js\";\n\nexport const WorkflowsPermissionsFeature = createFeature({\n    name: \"Workflows/WorkflowsPermissions\",\n    register(container) {\n        container.register(WorkflowsPermissions);\n    }\n});\n"],"names":["WorkflowsPermissionsFeature","createFeature","container","WorkflowsPermissions"],"mappings":";;AAGO,MAAMA,8BAA8BC,cAAc;IACrD,MAAM;IACN,UAASC,SAAS;QACdA,UAAU,QAAQ,CAACC;IACvB;AACJ"}

package/features/permissions/WorkflowsPermissions/index.d.ts

@@ -0,0 +1 @@
+export { WorkflowsPermissions } from "./abstractions.js";

package/features/permissions/WorkflowsPermissions/index.js

@@ -0,0 +1 @@
+export { WorkflowsPermissions } from "./abstractions.js";

package/features/review/ApproveReviewStep/ApproveReviewStepUseCase.d.ts

@@ -0,0 +1,15 @@
+import { ReviewRepository } from "../../../domain/review/abstractions/ReviewRepository.js";
+import { ReviewStepReacher } from "../ReviewStepReacher/abstractions.js";
+import { ReviewSaver } from "../ReviewSaver/abstractions.js";
+import { ApproveReviewStepUseCase as ApproveReviewStepUseCaseAbstraction } from "./abstractions.js";
+declare class ApproveReviewStepUseCaseImpl implements ApproveReviewStepUseCaseAbstraction.Interface {
+    private repository;
+    private stepReacher;
+    private saver;
+    constructor(repository: ReviewRepository.Interface, stepReacher: ReviewStepReacher.Interface, saver: ReviewSaver.Interface);
+    execute(input: ApproveReviewStepUseCaseAbstraction.Input): ApproveReviewStepUseCaseAbstraction.Return;
+}
+export declare const ApproveReviewStepUseCase: typeof ApproveReviewStepUseCaseImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("./abstractions.js").IApproveReviewStepUseCase>;
+};
+export {};

package/features/review/ApproveReviewStep/ApproveReviewStepUseCase.js

@@ -0,0 +1,46 @@
+import { Result } from "@webiny/feature/api";
+import { Review } from "../../../domain/review/Review.js";
+import { ReviewRepository } from "../../../domain/review/abstractions/ReviewRepository.js";
+import { ReviewStepReacher } from "../ReviewStepReacher/abstractions.js";
+import { ReviewSaver } from "../ReviewSaver/abstractions.js";
+import { ApproveReviewStepUseCase } from "./abstractions.js";
+class ApproveReviewStepUseCaseImpl {
+    constructor(repository, stepReacher, saver){
+        this.repository = repository;
+        this.stepReacher = stepReacher;
+        this.saver = saver;
+    }
+    async execute(input) {
+        const loaded = await this.repository.get(input.reviewId);
+        if (loaded.isFail()) return Result.fail(loaded.error);
+        const review = Review.fromData(loaded.value);
+        const now = new Date().toISOString();
+        const approved = review.approve({
+            stepId: input.stepId,
+            actor: input.actor,
+            actorTeamIds: input.actorTeamIds,
+            comment: input.comment ?? null,
+            issues: input.issues,
+            now
+        });
+        if (approved.isFail()) return Result.fail(approved.error);
+        const reached = await this.stepReacher.reach({
+            review,
+            actor: input.actor,
+            now
+        });
+        if (reached.isFail()) return Result.fail(reached.error);
+        return this.saver.save(review);
+    }
+}
+const ApproveReviewStepUseCase_ApproveReviewStepUseCase = ApproveReviewStepUseCase.createImplementation({
+    implementation: ApproveReviewStepUseCaseImpl,
+    dependencies: [
+        ReviewRepository,
+        ReviewStepReacher,
+        ReviewSaver
+    ]
+});
+export { ApproveReviewStepUseCase_ApproveReviewStepUseCase as ApproveReviewStepUseCase };
+
+//# sourceMappingURL=ApproveReviewStepUseCase.js.map

package/features/review/ApproveReviewStep/ApproveReviewStepUseCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/review/ApproveReviewStep/ApproveReviewStepUseCase.js","sources":["../../../../src/features/review/ApproveReviewStep/ApproveReviewStepUseCase.ts"],"sourcesContent":["import { Result } from \"@webiny/feature/api\";\nimport { Review } from \"~/domain/review/Review.js\";\nimport { ReviewRepository } from \"~/domain/review/abstractions/ReviewRepository.js\";\nimport { ReviewStepReacher } from \"../ReviewStepReacher/abstractions.js\";\nimport { ReviewSaver } from \"../ReviewSaver/abstractions.js\";\nimport { ApproveReviewStepUseCase as ApproveReviewStepUseCaseAbstraction } from \"./abstractions.js\";\n\nclass ApproveReviewStepUseCaseImpl implements ApproveReviewStepUseCaseAbstraction.Interface {\n    constructor(\n        private repository: ReviewRepository.Interface,\n        private stepReacher: ReviewStepReacher.Interface,\n        private saver: ReviewSaver.Interface\n    ) {}\n\n    async execute(\n        input: ApproveReviewStepUseCaseAbstraction.Input\n    ): ApproveReviewStepUseCaseAbstraction.Return {\n        const loaded = await this.repository.get(input.reviewId);\n        if (loaded.isFail()) {\n            return Result.fail(loaded.error);\n        }\n        const review = Review.fromData(loaded.value);\n        const now = new Date().toISOString();\n\n        const approved = review.approve({\n            stepId: input.stepId,\n            actor: input.actor,\n            actorTeamIds: input.actorTeamIds,\n            comment: input.comment ?? null,\n            issues: input.issues,\n            now\n        });\n        if (approved.isFail()) {\n            return Result.fail(approved.error);\n        }\n\n        // The next step goes through the same step-reached path as step 1 (D6).\n        const reached = await this.stepReacher.reach({ review, actor: input.actor, now });\n        if (reached.isFail()) {\n            return Result.fail(reached.error);\n        }\n\n        return this.saver.save(review);\n    }\n}\n\nexport const ApproveReviewStepUseCase = ApproveReviewStepUseCaseAbstraction.createImplementation({\n    implementation: ApproveReviewStepUseCaseImpl,\n    dependencies: [ReviewRepository, ReviewStepReacher, ReviewSaver]\n});\n"],"names":["ApproveReviewStepUseCaseImpl","repository","stepReacher","saver","input","loaded","Result","review","Review","now","Date","approved","reached","ApproveReviewStepUseCase","ApproveReviewStepUseCaseAbstraction","ReviewRepository","ReviewStepReacher","ReviewSaver"],"mappings":";;;;;;AAOA,MAAMA;IACF,YACYC,UAAsC,EACtCC,WAAwC,EACxCC,KAA4B,CACtC;aAHUF,UAAU,GAAVA;aACAC,WAAW,GAAXA;aACAC,KAAK,GAALA;IACT;IAEH,MAAM,QACFC,KAAgD,EACN;QAC1C,MAAMC,SAAS,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAACD,MAAM,QAAQ;QACvD,IAAIC,OAAO,MAAM,IACb,OAAOC,OAAO,IAAI,CAACD,OAAO,KAAK;QAEnC,MAAME,SAASC,OAAO,QAAQ,CAACH,OAAO,KAAK;QAC3C,MAAMI,MAAM,IAAIC,OAAO,WAAW;QAElC,MAAMC,WAAWJ,OAAO,OAAO,CAAC;YAC5B,QAAQH,MAAM,MAAM;YACpB,OAAOA,MAAM,KAAK;YAClB,cAAcA,MAAM,YAAY;YAChC,SAASA,MAAM,OAAO,IAAI;YAC1B,QAAQA,MAAM,MAAM;YACpBK;QACJ;QACA,IAAIE,SAAS,MAAM,IACf,OAAOL,OAAO,IAAI,CAACK,SAAS,KAAK;QAIrC,MAAMC,UAAU,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;YAAEL;YAAQ,OAAOH,MAAM,KAAK;YAAEK;QAAI;QAC/E,IAAIG,QAAQ,MAAM,IACd,OAAON,OAAO,IAAI,CAACM,QAAQ,KAAK;QAGpC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAACL;IAC3B;AACJ;AAEO,MAAMM,oDAA2BC,yBAAAA,oBAAwD,CAAC;IAC7F,gBAAgBd;IAChB,cAAc;QAACe;QAAkBC;QAAmBC;KAAY;AACpE"}

package/features/review/ApproveReviewStep/abstractions.d.ts

@@ -0,0 +1,25 @@
+import { type Result } from "@webiny/feature/api";
+import type { ReviewData } from "../../../domain/review/types.js";
+import type { ReviewInvalidStateError, ReviewNotFoundError, ReviewNotOwnerError, ReviewPersistenceError, ReviewStepNotCurrentError, ReviewTargetSyncError } from "../../../domain/review/errors.js";
+import type { ReviewDecisionInput } from "../shared/types.js";
+export interface IApproveReviewStepUseCaseErrors {
+    notFound: ReviewNotFoundError;
+    invalidState: ReviewInvalidStateError;
+    stepNotCurrent: ReviewStepNotCurrentError;
+    notOwner: ReviewNotOwnerError;
+    persistence: ReviewPersistenceError;
+    targetSync: ReviewTargetSyncError;
+}
+type UseCaseError = IApproveReviewStepUseCaseErrors[keyof IApproveReviewStepUseCaseErrors];
+export interface IApproveReviewStepUseCase {
+    execute(input: ReviewDecisionInput): Promise<Result<ReviewData, UseCaseError>>;
+}
+/** The owner approves the current step; the next step is reached, or the review is approved. */
+export declare const ApproveReviewStepUseCase: import("@webiny/di").Abstraction<IApproveReviewStepUseCase>;
+export declare namespace ApproveReviewStepUseCase {
+    type Interface = IApproveReviewStepUseCase;
+    type Input = ReviewDecisionInput;
+    type Error = UseCaseError;
+    type Return = Promise<Result<ReviewData, UseCaseError>>;
+}
+export {};

package/features/review/ApproveReviewStep/abstractions.js

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

package/features/review/ApproveReviewStep/abstractions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/review/ApproveReviewStep/abstractions.js","sources":["../../../../src/features/review/ApproveReviewStep/abstractions.ts"],"sourcesContent":["import { createAbstraction, type Result } from \"@webiny/feature/api\";\nimport type { ReviewData } from \"~/domain/review/types.js\";\nimport type {\n    ReviewInvalidStateError,\n    ReviewNotFoundError,\n    ReviewNotOwnerError,\n    ReviewPersistenceError,\n    ReviewStepNotCurrentError,\n    ReviewTargetSyncError\n} from \"~/domain/review/errors.js\";\nimport type { ReviewDecisionInput } from \"../shared/types.js\";\n\nexport interface IApproveReviewStepUseCaseErrors {\n    notFound: ReviewNotFoundError;\n    invalidState: ReviewInvalidStateError;\n    stepNotCurrent: ReviewStepNotCurrentError;\n    notOwner: ReviewNotOwnerError;\n    persistence: ReviewPersistenceError;\n    targetSync: ReviewTargetSyncError;\n}\n\ntype UseCaseError = IApproveReviewStepUseCaseErrors[keyof IApproveReviewStepUseCaseErrors];\n\nexport interface IApproveReviewStepUseCase {\n    execute(input: ReviewDecisionInput): Promise<Result<ReviewData, UseCaseError>>;\n}\n\n/** The owner approves the current step; the next step is reached, or the review is approved. */\nexport const ApproveReviewStepUseCase = createAbstraction<IApproveReviewStepUseCase>(\n    \"ApproveReviewStepUseCase\"\n);\n\nexport namespace ApproveReviewStepUseCase {\n    export type Interface = IApproveReviewStepUseCase;\n    export type Input = ReviewDecisionInput;\n    export type Error = UseCaseError;\n    export type Return = Promise<Result<ReviewData, UseCaseError>>;\n}\n"],"names":["ApproveReviewStepUseCase","createAbstraction"],"mappings":";AA4BO,MAAMA,2BAA2BC,kBACpC"}

package/features/review/ApproveReviewStep/events.d.ts

@@ -0,0 +1,29 @@
+import { DomainEvent } from "@webiny/api-core/features/eventPublisher/index.js";
+import type { IEventHandler } from "@webiny/api-core/features/eventPublisher/index.js";
+import type { ReviewApprovedFact } from "../../../domain/review/facts.js";
+import type { ReviewStepApprovedFact } from "../../../domain/review/facts.js";
+import type { ReviewEventPayload } from "../shared/events.js";
+/**
+ * ReviewStepApprovedEvent - published after the review is saved.
+ */
+export declare class ReviewStepApprovedEvent extends DomainEvent<ReviewEventPayload<ReviewStepApprovedFact>> {
+    eventType: "Workflows/Review/StepApproved";
+    getHandlerAbstraction(): import("@webiny/di").Abstraction<IEventHandler<ReviewStepApprovedEvent>>;
+}
+export declare const ReviewStepApprovedEventHandler: import("@webiny/di").Abstraction<IEventHandler<ReviewStepApprovedEvent>>;
+export declare namespace ReviewStepApprovedEventHandler {
+    type Interface = IEventHandler<ReviewStepApprovedEvent>;
+    type Event = ReviewStepApprovedEvent;
+}
+/**
+ * ReviewApprovedEvent - published after the review is saved. The last step was approved.
+ */
+export declare class ReviewApprovedEvent extends DomainEvent<ReviewEventPayload<ReviewApprovedFact>> {
+    eventType: "Workflows/Review/Approved";
+    getHandlerAbstraction(): import("@webiny/di").Abstraction<IEventHandler<ReviewApprovedEvent>>;
+}
+export declare const ReviewApprovedEventHandler: import("@webiny/di").Abstraction<IEventHandler<ReviewApprovedEvent>>;
+export declare namespace ReviewApprovedEventHandler {
+    type Interface = IEventHandler<ReviewApprovedEvent>;
+    type Event = ReviewApprovedEvent;
+}

package/features/review/ApproveReviewStep/events.js

@@ -0,0 +1,23 @@
+import { createAbstraction } from "@webiny/feature/api";
+import { DomainEvent } from "@webiny/api-core/features/eventPublisher/index.js";
+class ReviewStepApprovedEvent extends DomainEvent {
+    getHandlerAbstraction() {
+        return ReviewStepApprovedEventHandler;
+    }
+    constructor(...args){
+        super(...args), this.eventType = "Workflows/Review/StepApproved";
+    }
+}
+const ReviewStepApprovedEventHandler = createAbstraction("ReviewStepApprovedEventHandler");
+class ReviewApprovedEvent extends DomainEvent {
+    getHandlerAbstraction() {
+        return ReviewApprovedEventHandler;
+    }
+    constructor(...args){
+        super(...args), this.eventType = "Workflows/Review/Approved";
+    }
+}
+const ReviewApprovedEventHandler = createAbstraction("ReviewApprovedEventHandler");
+export { ReviewApprovedEvent, ReviewApprovedEventHandler, ReviewStepApprovedEvent, ReviewStepApprovedEventHandler };
+
+//# sourceMappingURL=events.js.map

package/features/review/ApproveReviewStep/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/review/ApproveReviewStep/events.js","sources":["../../../../src/features/review/ApproveReviewStep/events.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/api\";\nimport { DomainEvent } from \"@webiny/api-core/features/eventPublisher/index.js\";\nimport type { IEventHandler } from \"@webiny/api-core/features/eventPublisher/index.js\";\nimport type { ReviewApprovedFact } from \"~/domain/review/facts.js\";\nimport type { ReviewStepApprovedFact } from \"~/domain/review/facts.js\";\nimport type { ReviewEventPayload } from \"../shared/events.js\";\n\n/**\n * ReviewStepApprovedEvent - published after the review is saved.\n */\nexport class ReviewStepApprovedEvent extends DomainEvent<\n    ReviewEventPayload<ReviewStepApprovedFact>\n> {\n    eventType = \"Workflows/Review/StepApproved\" as const;\n\n    getHandlerAbstraction() {\n        return ReviewStepApprovedEventHandler;\n    }\n}\n\nexport const ReviewStepApprovedEventHandler = createAbstraction<\n    IEventHandler<ReviewStepApprovedEvent>\n>(\"ReviewStepApprovedEventHandler\");\n\nexport namespace ReviewStepApprovedEventHandler {\n    export type Interface = IEventHandler<ReviewStepApprovedEvent>;\n    export type Event = ReviewStepApprovedEvent;\n}\n\n/**\n * ReviewApprovedEvent - published after the review is saved. The last step was approved.\n */\nexport class ReviewApprovedEvent extends DomainEvent<ReviewEventPayload<ReviewApprovedFact>> {\n    eventType = \"Workflows/Review/Approved\" as const;\n\n    getHandlerAbstraction() {\n        return ReviewApprovedEventHandler;\n    }\n}\n\nexport const ReviewApprovedEventHandler = createAbstraction<IEventHandler<ReviewApprovedEvent>>(\n    \"ReviewApprovedEventHandler\"\n);\n\nexport namespace ReviewApprovedEventHandler {\n    export type Interface = IEventHandler<ReviewApprovedEvent>;\n    export type Event = ReviewApprovedEvent;\n}\n"],"names":["ReviewStepApprovedEvent","DomainEvent","ReviewStepApprovedEventHandler","createAbstraction","ReviewApprovedEvent","ReviewApprovedEventHandler"],"mappings":";;AAUO,MAAMA,gCAAgCC;IAKzC,wBAAwB;QACpB,OAAOC;IACX;;QAPG,qBAGH,SAAS,GAAG;;AAKhB;AAEO,MAAMA,iCAAiCC,kBAE5C;AAUK,MAAMC,4BAA4BH;IAGrC,wBAAwB;QACpB,OAAOI;IACX;;QALG,qBACH,SAAS,GAAG;;AAKhB;AAEO,MAAMA,6BAA6BF,kBACtC"}

package/features/review/ApproveReviewStep/feature.d.ts

@@ -0,0 +1,4 @@
+export declare const ApproveReviewStepFeature: {
+    name: string;
+    register(container: import("@webiny/di").Container): void;
+};

package/features/review/ApproveReviewStep/feature.js

@@ -0,0 +1,11 @@
+import { createFeature } from "@webiny/feature/api";
+import { ApproveReviewStepUseCase } from "./ApproveReviewStepUseCase.js";
+const ApproveReviewStepFeature = createFeature({
+    name: "Workflows/ApproveReviewStep",
+    register (container) {
+        container.register(ApproveReviewStepUseCase);
+    }
+});
+export { ApproveReviewStepFeature };
+
+//# sourceMappingURL=feature.js.map

package/features/review/ApproveReviewStep/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/review/ApproveReviewStep/feature.js","sources":["../../../../src/features/review/ApproveReviewStep/feature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/api\";\nimport { ApproveReviewStepUseCase } from \"./ApproveReviewStepUseCase.js\";\n\nexport const ApproveReviewStepFeature = createFeature({\n    name: \"Workflows/ApproveReviewStep\",\n    register(container) {\n        container.register(ApproveReviewStepUseCase);\n    }\n});\n"],"names":["ApproveReviewStepFeature","createFeature","container","ApproveReviewStepUseCase"],"mappings":";;AAGO,MAAMA,2BAA2BC,cAAc;IAClD,MAAM;IACN,UAASC,SAAS;QACdA,UAAU,QAAQ,CAACC;IACvB;AACJ"}

package/features/review/ApproveReviewStep/index.d.ts

@@ -0,0 +1,4 @@
+export { ApproveReviewStepUseCase } from "./abstractions.js";
+export type { ReviewDecisionInput } from "../shared/types.js";
+export { ReviewStepApprovedEventHandler } from "./events.js";
+export { ReviewApprovedEventHandler } from "./events.js";

package/features/review/ApproveReviewStep/index.js

@@ -0,0 +1,2 @@
+export { ApproveReviewStepUseCase } from "./abstractions.js";
+export { ReviewApprovedEventHandler, ReviewStepApprovedEventHandler } from "./events.js";

package/features/review/CancelReview/CancelReviewUseCase.d.ts

@@ -0,0 +1,15 @@
+import { ReviewRepository } from "../../../domain/review/abstractions/ReviewRepository.js";
+import { ReviewTaskAbortService } from "../../../features/stepRun/ReviewTaskAbortService/index.js";
+import { ReviewSaver } from "../ReviewSaver/abstractions.js";
+import { CancelReviewUseCase as CancelReviewUseCaseAbstraction } from "./abstractions.js";
+declare class CancelReviewUseCaseImpl implements CancelReviewUseCaseAbstraction.Interface {
+    private repository;
+    private saver;
+    private taskAbort;
+    constructor(repository: ReviewRepository.Interface, saver: ReviewSaver.Interface, taskAbort: ReviewTaskAbortService.Interface);
+    execute(input: CancelReviewUseCaseAbstraction.Input): CancelReviewUseCaseAbstraction.Return;
+}
+export declare const CancelReviewUseCase: typeof CancelReviewUseCaseImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("./abstractions.js").ICancelReviewUseCase>;
+};
+export {};

package/features/review/CancelReview/CancelReviewUseCase.js

@@ -0,0 +1,45 @@
+import { Result } from "@webiny/feature/api";
+import { Review } from "../../../domain/review/Review.js";
+import { ReviewTargetSyncError } from "../../../domain/review/errors.js";
+import { ReviewRepository } from "../../../domain/review/abstractions/ReviewRepository.js";
+import { ReviewTaskAbortService } from "../../stepRun/ReviewTaskAbortService/index.js";
+import { ReviewSaver } from "../ReviewSaver/abstractions.js";
+import { CancelReviewUseCase } from "./abstractions.js";
+class CancelReviewUseCaseImpl {
+    constructor(repository, saver, taskAbort){
+        this.repository = repository;
+        this.saver = saver;
+        this.taskAbort = taskAbort;
+    }
+    async execute(input) {
+        const loaded = await this.repository.get(input.reviewId);
+        if (loaded.isFail()) return Result.fail(loaded.error);
+        const review = Review.fromData(loaded.value);
+        const runningTaskId = review.getRunningTaskId();
+        const cancelled = review.cancel({
+            actor: input.actor,
+            now: new Date().toISOString(),
+            reason: input.reason
+        });
+        if (cancelled.isFail()) return Result.fail(cancelled.error);
+        const saved = await this.saver.save(review);
+        if (saved.isOk() || saved.error instanceof ReviewTargetSyncError) await this.taskAbort.abort({
+            taskIds: runningTaskId ? [
+                runningTaskId
+            ] : [],
+            message: "The review was cancelled."
+        });
+        return saved;
+    }
+}
+const CancelReviewUseCase_CancelReviewUseCase = CancelReviewUseCase.createImplementation({
+    implementation: CancelReviewUseCaseImpl,
+    dependencies: [
+        ReviewRepository,
+        ReviewSaver,
+        ReviewTaskAbortService
+    ]
+});
+export { CancelReviewUseCase_CancelReviewUseCase as CancelReviewUseCase };
+
+//# sourceMappingURL=CancelReviewUseCase.js.map

package/features/review/CancelReview/CancelReviewUseCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/review/CancelReview/CancelReviewUseCase.js","sources":["../../../../src/features/review/CancelReview/CancelReviewUseCase.ts"],"sourcesContent":["import { Result } from \"@webiny/feature/api\";\nimport { Review } from \"~/domain/review/Review.js\";\nimport { ReviewTargetSyncError } from \"~/domain/review/errors.js\";\nimport { ReviewRepository } from \"~/domain/review/abstractions/ReviewRepository.js\";\nimport { ReviewTaskAbortService } from \"~/features/stepRun/ReviewTaskAbortService/index.js\";\nimport { ReviewSaver } from \"../ReviewSaver/abstractions.js\";\nimport { CancelReviewUseCase as CancelReviewUseCaseAbstraction } from \"./abstractions.js\";\n\nclass CancelReviewUseCaseImpl implements CancelReviewUseCaseAbstraction.Interface {\n    constructor(\n        private repository: ReviewRepository.Interface,\n        private saver: ReviewSaver.Interface,\n        private taskAbort: ReviewTaskAbortService.Interface\n    ) {}\n\n    async execute(\n        input: CancelReviewUseCaseAbstraction.Input\n    ): CancelReviewUseCaseAbstraction.Return {\n        const loaded = await this.repository.get(input.reviewId);\n        if (loaded.isFail()) {\n            return Result.fail(loaded.error);\n        }\n        const review = Review.fromData(loaded.value);\n\n        // The running task of the current step, read before the cancel clears the current step\n        // (D25, R151).\n        const runningTaskId = review.getRunningTaskId();\n\n        const cancelled = review.cancel({\n            actor: input.actor,\n            now: new Date().toISOString(),\n            reason: input.reason\n        });\n        if (cancelled.isFail()) {\n            return Result.fail(cancelled.error);\n        }\n\n        const saved = await this.saver.save(review);\n        // Abort once the cancel is persisted: the save succeeded, or only the target sync failed\n        // (R16) and the review is cancelled all the same. A failed save leaves the review in\n        // progress, so its task keeps running. An abort failure is logged by the service and never\n        // changes the result (R151).\n        if (saved.isOk() || saved.error instanceof ReviewTargetSyncError) {\n            await this.taskAbort.abort({\n                taskIds: runningTaskId ? [runningTaskId] : [],\n                message: \"The review was cancelled.\"\n            });\n        }\n        return saved;\n    }\n}\n\nexport const CancelReviewUseCase = CancelReviewUseCaseAbstraction.createImplementation({\n    implementation: CancelReviewUseCaseImpl,\n    dependencies: [ReviewRepository, ReviewSaver, ReviewTaskAbortService]\n});\n"],"names":["CancelReviewUseCaseImpl","repository","saver","taskAbort","input","loaded","Result","review","Review","runningTaskId","cancelled","Date","saved","ReviewTargetSyncError","CancelReviewUseCase","CancelReviewUseCaseAbstraction","ReviewRepository","ReviewSaver","ReviewTaskAbortService"],"mappings":";;;;;;;AAQA,MAAMA;IACF,YACYC,UAAsC,EACtCC,KAA4B,EAC5BC,SAA2C,CACrD;aAHUF,UAAU,GAAVA;aACAC,KAAK,GAALA;aACAC,SAAS,GAATA;IACT;IAEH,MAAM,QACFC,KAA2C,EACN;QACrC,MAAMC,SAAS,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAACD,MAAM,QAAQ;QACvD,IAAIC,OAAO,MAAM,IACb,OAAOC,OAAO,IAAI,CAACD,OAAO,KAAK;QAEnC,MAAME,SAASC,OAAO,QAAQ,CAACH,OAAO,KAAK;QAI3C,MAAMI,gBAAgBF,OAAO,gBAAgB;QAE7C,MAAMG,YAAYH,OAAO,MAAM,CAAC;YAC5B,OAAOH,MAAM,KAAK;YAClB,KAAK,IAAIO,OAAO,WAAW;YAC3B,QAAQP,MAAM,MAAM;QACxB;QACA,IAAIM,UAAU,MAAM,IAChB,OAAOJ,OAAO,IAAI,CAACI,UAAU,KAAK;QAGtC,MAAME,QAAQ,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAACL;QAKpC,IAAIK,MAAM,IAAI,MAAMA,MAAM,KAAK,YAAYC,uBACvC,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YACvB,SAASJ,gBAAgB;gBAACA;aAAc,GAAG,EAAE;YAC7C,SAAS;QACb;QAEJ,OAAOG;IACX;AACJ;AAEO,MAAME,0CAAsBC,oBAAAA,oBAAmD,CAAC;IACnF,gBAAgBf;IAChB,cAAc;QAACgB;QAAkBC;QAAaC;KAAuB;AACzE"}

package/features/review/CancelReview/abstractions.d.ts

@@ -0,0 +1,23 @@
+import { type Result } from "@webiny/feature/api";
+import type { ReviewData } from "../../../domain/review/types.js";
+import type { ReviewInvalidStateError, ReviewNotFoundError, ReviewPersistenceError, ReviewTargetSyncError } from "../../../domain/review/errors.js";
+import type { CancelReviewInput } from "../shared/types.js";
+export interface ICancelReviewUseCaseErrors {
+    notFound: ReviewNotFoundError;
+    invalidState: ReviewInvalidStateError;
+    persistence: ReviewPersistenceError;
+    targetSync: ReviewTargetSyncError;
+}
+type UseCaseError = ICancelReviewUseCaseErrors[keyof ICancelReviewUseCaseErrors];
+export interface ICancelReviewUseCase {
+    execute(input: CancelReviewInput): Promise<Result<ReviewData, UseCaseError>>;
+}
+/** Cancel an in-progress review; the target is unlocked (D25, D75). */
+export declare const CancelReviewUseCase: import("@webiny/di").Abstraction<ICancelReviewUseCase>;
+export declare namespace CancelReviewUseCase {
+    type Interface = ICancelReviewUseCase;
+    type Input = CancelReviewInput;
+    type Error = UseCaseError;
+    type Return = Promise<Result<ReviewData, UseCaseError>>;
+}
+export {};

package/features/review/CancelReview/abstractions.js

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