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

package/domain/notifications/messages/buildApprovedMessage.d.ts

@@ -0,0 +1,7 @@
+import type { NotificationMessage } from "../../../domain/notifications/types.js";
+export interface ApprovedMessageParams {
+    /** `review.title`. */
+    contentTitle: string;
+}
+/** The requester's review is approved by every step (R189, `approved`). */
+export declare const buildApprovedMessage: (params: ApprovedMessageParams) => NotificationMessage;

package/domain/notifications/messages/buildApprovedMessage.js

@@ -0,0 +1,13 @@
+const buildApprovedMessage = (params)=>{
+    const { contentTitle } = params;
+    return {
+        title: `“${contentTitle}” was approved`,
+        body: "All steps approved. It’s ready to publish.",
+        subject: `Approved: ${contentTitle}`,
+        text: "Every step approved this revision. It’s ready to publish.",
+        linkLabel: "Open content"
+    };
+};
+export { buildApprovedMessage };
+
+//# sourceMappingURL=buildApprovedMessage.js.map

package/domain/notifications/messages/buildApprovedMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/notifications/messages/buildApprovedMessage.js","sources":["../../../../src/domain/notifications/messages/buildApprovedMessage.ts"],"sourcesContent":["import type { NotificationMessage } from \"~/domain/notifications/types.js\";\n\nexport interface ApprovedMessageParams {\n    /** `review.title`. */\n    contentTitle: string;\n}\n\n/** The requester's review is approved by every step (R189, `approved`). */\nexport const buildApprovedMessage = (params: ApprovedMessageParams): NotificationMessage => {\n    const { contentTitle } = params;\n    return {\n        title: `“${contentTitle}” was approved`,\n        body: \"All steps approved. It’s ready to publish.\",\n        subject: `Approved: ${contentTitle}`,\n        text: \"Every step approved this revision. It’s ready to publish.\",\n        linkLabel: \"Open content\"\n    };\n};\n"],"names":["buildApprovedMessage","params","contentTitle"],"mappings":"AAQO,MAAMA,uBAAuB,CAACC;IACjC,MAAM,EAAEC,YAAY,EAAE,GAAGD;IACzB,OAAO;QACH,OAAO,CAAC,CAAC,EAAEC,aAAa,cAAc,CAAC;QACvC,MAAM;QACN,SAAS,CAAC,UAAU,EAAEA,cAAc;QACpC,MAAM;QACN,WAAW;IACf;AACJ"}

package/domain/notifications/messages/buildAssignedMessage.d.ts

@@ -0,0 +1,18 @@
+import type { NotificationMessage } from "../../../domain/notifications/types.js";
+export interface AssignedMessageParams {
+    /** `review.title`. */
+    contentTitle: string;
+    stepTitle: string;
+    /**
+     * Why the step is the recipient's, already resolved by `getAssignmentReason`. Used when
+     * `reassignedBy` is `null`; `null` reads "assigned to you".
+     */
+    reason: string | null;
+    /**
+     * The name of who reassigned the step to the recipient (`getActorName`), or `null` when the
+     * step was reached by routing.
+     */
+    reassignedBy: string | null;
+}
+/** A user owns a step: reached by routing or reassigned to them (R189, `assigned`). */
+export declare const buildAssignedMessage: (params: AssignedMessageParams) => NotificationMessage;

package/domain/notifications/messages/buildAssignedMessage.js

@@ -0,0 +1,14 @@
+const buildAssignedMessage = (params)=>{
+    const { contentTitle, stepTitle, reason, reassignedBy } = params;
+    const why = null !== reassignedBy ? `reassigned to you by ${reassignedBy}` : reason ?? "assigned to you";
+    return {
+        title: `You’re reviewing “${contentTitle}”`,
+        body: `${stepTitle} · ${why}`,
+        subject: `You’re reviewing: ${contentTitle} (${stepTitle})`,
+        text: `You are the owner of ${stepTitle}. Open the content to approve or reject it.`,
+        linkLabel: "Open content"
+    };
+};
+export { buildAssignedMessage };
+
+//# sourceMappingURL=buildAssignedMessage.js.map

package/domain/notifications/messages/buildAssignedMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/notifications/messages/buildAssignedMessage.js","sources":["../../../../src/domain/notifications/messages/buildAssignedMessage.ts"],"sourcesContent":["import type { NotificationMessage } from \"~/domain/notifications/types.js\";\n\nexport interface AssignedMessageParams {\n    /** `review.title`. */\n    contentTitle: string;\n    stepTitle: string;\n    /**\n     * Why the step is the recipient's, already resolved by `getAssignmentReason`. Used when\n     * `reassignedBy` is `null`; `null` reads \"assigned to you\".\n     */\n    reason: string | null;\n    /**\n     * The name of who reassigned the step to the recipient (`getActorName`), or `null` when the\n     * step was reached by routing.\n     */\n    reassignedBy: string | null;\n}\n\n/** A user owns a step: reached by routing or reassigned to them (R189, `assigned`). */\nexport const buildAssignedMessage = (params: AssignedMessageParams): NotificationMessage => {\n    const { contentTitle, stepTitle, reason, reassignedBy } = params;\n    const why =\n        reassignedBy !== null\n            ? `reassigned to you by ${reassignedBy}`\n            : (reason ?? \"assigned to you\");\n    return {\n        title: `You’re reviewing “${contentTitle}”`,\n        body: `${stepTitle} · ${why}`,\n        subject: `You’re reviewing: ${contentTitle} (${stepTitle})`,\n        text: `You are the owner of ${stepTitle}. Open the content to approve or reject it.`,\n        linkLabel: \"Open content\"\n    };\n};\n"],"names":["buildAssignedMessage","params","contentTitle","stepTitle","reason","reassignedBy","why"],"mappings":"AAmBO,MAAMA,uBAAuB,CAACC;IACjC,MAAM,EAAEC,YAAY,EAAEC,SAAS,EAAEC,MAAM,EAAEC,YAAY,EAAE,GAAGJ;IAC1D,MAAMK,MACFD,AAAiB,SAAjBA,eACM,CAAC,qBAAqB,EAAEA,cAAc,GACrCD,UAAU;IACrB,OAAO;QACH,OAAO,CAAC,kBAAkB,EAAEF,aAAa,CAAC,CAAC;QAC3C,MAAM,GAAGC,UAAU,GAAG,EAAEG,KAAK;QAC7B,SAAS,CAAC,kBAAkB,EAAEJ,aAAa,EAAE,EAAEC,UAAU,CAAC,CAAC;QAC3D,MAAM,CAAC,qBAAqB,EAAEA,UAAU,2CAA2C,CAAC;QACpF,WAAW;IACf;AACJ"}

package/domain/notifications/messages/buildCancelledMessage.d.ts

@@ -0,0 +1,15 @@
+import type { NotificationMessage } from "../../../domain/notifications/types.js";
+export interface CancelledMessageParams {
+    /** `review.title`. */
+    contentTitle: string;
+    stepTitle: string;
+    /** Who cancelled (`getActorName`). */
+    canceller: string;
+    /**
+     * `fact.reason` of the cancel: the trashed and deleted constants have their own text, `null`
+     * and any other reason the normal one. The reason itself is never printed (R146 mirror).
+     */
+    reason: string | null;
+}
+/** The owner of a step whose review was cancelled (D134, R189, `cancelled`). */
+export declare const buildCancelledMessage: (params: CancelledMessageParams) => NotificationMessage;

package/domain/notifications/messages/buildCancelledMessage.js

@@ -0,0 +1,30 @@
+import { REVIEW_CANCEL_REASON_CONTENT_DELETED, REVIEW_CANCEL_REASON_CONTENT_TRASHED } from "../../review/getDeleteCancelReason.js";
+const buildCancelledMessage = (params)=>{
+    const { contentTitle, stepTitle, canceller, reason } = params;
+    const title = `The review of “${contentTitle}” was cancelled`;
+    const subject = `Review cancelled: ${contentTitle}`;
+    if (reason === REVIEW_CANCEL_REASON_CONTENT_TRASHED) return {
+        title,
+        body: `The content was moved to the trash. You no longer need to review ${stepTitle}.`,
+        subject,
+        text: `The content was moved to the trash, so this review was cancelled. You don’t need to review ${stepTitle} any more.`,
+        linkLabel: "Open content"
+    };
+    if (reason === REVIEW_CANCEL_REASON_CONTENT_DELETED) return {
+        title,
+        body: `The content was deleted. You no longer need to review ${stepTitle}.`,
+        subject,
+        text: `The content was deleted, so this review was cancelled. You don’t need to review ${stepTitle} any more.`,
+        linkLabel: "Open content"
+    };
+    return {
+        title,
+        body: `Cancelled by ${canceller}. You no longer need to review ${stepTitle}.`,
+        subject,
+        text: `${canceller} cancelled this review. You don’t need to review ${stepTitle} any more.`,
+        linkLabel: "Open content"
+    };
+};
+export { buildCancelledMessage };
+
+//# sourceMappingURL=buildCancelledMessage.js.map

package/domain/notifications/messages/buildCancelledMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/notifications/messages/buildCancelledMessage.js","sources":["../../../../src/domain/notifications/messages/buildCancelledMessage.ts"],"sourcesContent":["import {\n    REVIEW_CANCEL_REASON_CONTENT_DELETED,\n    REVIEW_CANCEL_REASON_CONTENT_TRASHED\n} from \"~/domain/review/getDeleteCancelReason.js\";\nimport type { NotificationMessage } from \"~/domain/notifications/types.js\";\n\nexport interface CancelledMessageParams {\n    /** `review.title`. */\n    contentTitle: string;\n    stepTitle: string;\n    /** Who cancelled (`getActorName`). */\n    canceller: string;\n    /**\n     * `fact.reason` of the cancel: the trashed and deleted constants have their own text, `null`\n     * and any other reason the normal one. The reason itself is never printed (R146 mirror).\n     */\n    reason: string | null;\n}\n\n/** The owner of a step whose review was cancelled (D134, R189, `cancelled`). */\nexport const buildCancelledMessage = (params: CancelledMessageParams): NotificationMessage => {\n    const { contentTitle, stepTitle, canceller, reason } = params;\n    const title = `The review of “${contentTitle}” was cancelled`;\n    const subject = `Review cancelled: ${contentTitle}`;\n\n    if (reason === REVIEW_CANCEL_REASON_CONTENT_TRASHED) {\n        return {\n            title,\n            body: `The content was moved to the trash. You no longer need to review ${stepTitle}.`,\n            subject,\n            text: `The content was moved to the trash, so this review was cancelled. You don’t need to review ${stepTitle} any more.`,\n            linkLabel: \"Open content\"\n        };\n    }\n    if (reason === REVIEW_CANCEL_REASON_CONTENT_DELETED) {\n        return {\n            title,\n            body: `The content was deleted. You no longer need to review ${stepTitle}.`,\n            subject,\n            text: `The content was deleted, so this review was cancelled. You don’t need to review ${stepTitle} any more.`,\n            linkLabel: \"Open content\"\n        };\n    }\n    return {\n        title,\n        body: `Cancelled by ${canceller}. You no longer need to review ${stepTitle}.`,\n        subject,\n        text: `${canceller} cancelled this review. You don’t need to review ${stepTitle} any more.`,\n        linkLabel: \"Open content\"\n    };\n};\n"],"names":["buildCancelledMessage","params","contentTitle","stepTitle","canceller","reason","title","subject","REVIEW_CANCEL_REASON_CONTENT_TRASHED","REVIEW_CANCEL_REASON_CONTENT_DELETED"],"mappings":";AAoBO,MAAMA,wBAAwB,CAACC;IAClC,MAAM,EAAEC,YAAY,EAAEC,SAAS,EAAEC,SAAS,EAAEC,MAAM,EAAE,GAAGJ;IACvD,MAAMK,QAAQ,CAAC,eAAe,EAAEJ,aAAa,eAAe,CAAC;IAC7D,MAAMK,UAAU,CAAC,kBAAkB,EAAEL,cAAc;IAEnD,IAAIG,WAAWG,sCACX,OAAO;QACHF;QACA,MAAM,CAAC,iEAAiE,EAAEH,UAAU,CAAC,CAAC;QACtFI;QACA,MAAM,CAAC,2FAA2F,EAAEJ,UAAU,UAAU,CAAC;QACzH,WAAW;IACf;IAEJ,IAAIE,WAAWI,sCACX,OAAO;QACHH;QACA,MAAM,CAAC,sDAAsD,EAAEH,UAAU,CAAC,CAAC;QAC3EI;QACA,MAAM,CAAC,gFAAgF,EAAEJ,UAAU,UAAU,CAAC;QAC9G,WAAW;IACf;IAEJ,OAAO;QACHG;QACA,MAAM,CAAC,aAAa,EAAEF,UAAU,+BAA+B,EAAED,UAAU,CAAC,CAAC;QAC7EI;QACA,MAAM,GAAGH,UAAU,iDAAiD,EAAED,UAAU,UAAU,CAAC;QAC3F,WAAW;IACf;AACJ"}

package/domain/notifications/messages/buildFailedMessage.d.ts

@@ -0,0 +1,13 @@
+import type { NotificationMessage } from "../../../domain/notifications/types.js";
+export interface FailedMessageParams {
+    /** `review.title`. */
+    contentTitle: string;
+    stepTitle: string;
+    /**
+     * `fact.reason` of the failed step: a fixed text that already ends in a full stop (R146,
+     * R170). The only error text a message may hold (R146 mirror).
+     */
+    reason: string;
+}
+/** An AI or automation step failed; the requester is told (R189, `failed`). */
+export declare const buildFailedMessage: (params: FailedMessageParams) => NotificationMessage;

package/domain/notifications/messages/buildFailedMessage.js

@@ -0,0 +1,13 @@
+const buildFailedMessage = (params)=>{
+    const { contentTitle, stepTitle, reason } = params;
+    return {
+        title: `${stepTitle} failed on “${contentTitle}”`,
+        body: `${reason} You can restart the step.`,
+        subject: `Step failed: ${contentTitle} (${stepTitle})`,
+        text: `${stepTitle} hit a technical error: ${reason} The review is paused at this step until it is restarted.`,
+        linkLabel: "Open content"
+    };
+};
+export { buildFailedMessage };
+
+//# sourceMappingURL=buildFailedMessage.js.map

package/domain/notifications/messages/buildFailedMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/notifications/messages/buildFailedMessage.js","sources":["../../../../src/domain/notifications/messages/buildFailedMessage.ts"],"sourcesContent":["import type { NotificationMessage } from \"~/domain/notifications/types.js\";\n\nexport interface FailedMessageParams {\n    /** `review.title`. */\n    contentTitle: string;\n    stepTitle: string;\n    /**\n     * `fact.reason` of the failed step: a fixed text that already ends in a full stop (R146,\n     * R170). The only error text a message may hold (R146 mirror).\n     */\n    reason: string;\n}\n\n/** An AI or automation step failed; the requester is told (R189, `failed`). */\nexport const buildFailedMessage = (params: FailedMessageParams): NotificationMessage => {\n    const { contentTitle, stepTitle, reason } = params;\n    return {\n        title: `${stepTitle} failed on “${contentTitle}”`,\n        body: `${reason} You can restart the step.`,\n        subject: `Step failed: ${contentTitle} (${stepTitle})`,\n        text: `${stepTitle} hit a technical error: ${reason} The review is paused at this step until it is restarted.`,\n        linkLabel: \"Open content\"\n    };\n};\n"],"names":["buildFailedMessage","params","contentTitle","stepTitle","reason"],"mappings":"AAcO,MAAMA,qBAAqB,CAACC;IAC/B,MAAM,EAAEC,YAAY,EAAEC,SAAS,EAAEC,MAAM,EAAE,GAAGH;IAC5C,OAAO;QACH,OAAO,GAAGE,UAAU,YAAY,EAAED,aAAa,CAAC,CAAC;QACjD,MAAM,GAAGE,OAAO,0BAA0B,CAAC;QAC3C,SAAS,CAAC,aAAa,EAAEF,aAAa,EAAE,EAAEC,UAAU,CAAC,CAAC;QACtD,MAAM,GAAGA,UAAU,wBAAwB,EAAEC,OAAO,yDAAyD,CAAC;QAC9G,WAAW;IACf;AACJ"}

package/domain/notifications/messages/buildPoolReachedMessage.d.ts

@@ -0,0 +1,10 @@
+import type { NotificationMessage } from "../../../domain/notifications/types.js";
+export interface PoolReachedMessageParams {
+    /** `review.title`. */
+    contentTitle: string;
+    stepTitle: string;
+    /** `review.createdBy.displayName`. */
+    requester: string;
+}
+/** A step reached the team pool (R189, `poolReached`). */
+export declare const buildPoolReachedMessage: (params: PoolReachedMessageParams) => NotificationMessage;

package/domain/notifications/messages/buildPoolReachedMessage.js

@@ -0,0 +1,13 @@
+const buildPoolReachedMessage = (params)=>{
+    const { contentTitle, stepTitle, requester } = params;
+    return {
+        title: `“${contentTitle}” is waiting in the team pool`,
+        body: `${stepTitle} · requested by ${requester}`,
+        subject: `Team pool: ${contentTitle} (${stepTitle})`,
+        text: `“${stepTitle}” is waiting in the team pool. Anyone in the team can start it.`,
+        linkLabel: "Open content"
+    };
+};
+export { buildPoolReachedMessage };
+
+//# sourceMappingURL=buildPoolReachedMessage.js.map

package/domain/notifications/messages/buildPoolReachedMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/notifications/messages/buildPoolReachedMessage.js","sources":["../../../../src/domain/notifications/messages/buildPoolReachedMessage.ts"],"sourcesContent":["import type { NotificationMessage } from \"~/domain/notifications/types.js\";\n\nexport interface PoolReachedMessageParams {\n    /** `review.title`. */\n    contentTitle: string;\n    stepTitle: string;\n    /** `review.createdBy.displayName`. */\n    requester: string;\n}\n\n/** A step reached the team pool (R189, `poolReached`). */\nexport const buildPoolReachedMessage = (params: PoolReachedMessageParams): NotificationMessage => {\n    const { contentTitle, stepTitle, requester } = params;\n    return {\n        title: `“${contentTitle}” is waiting in the team pool`,\n        body: `${stepTitle} · requested by ${requester}`,\n        subject: `Team pool: ${contentTitle} (${stepTitle})`,\n        text: `“${stepTitle}” is waiting in the team pool. Anyone in the team can start it.`,\n        linkLabel: \"Open content\"\n    };\n};\n"],"names":["buildPoolReachedMessage","params","contentTitle","stepTitle","requester"],"mappings":"AAWO,MAAMA,0BAA0B,CAACC;IACpC,MAAM,EAAEC,YAAY,EAAEC,SAAS,EAAEC,SAAS,EAAE,GAAGH;IAC/C,OAAO;QACH,OAAO,CAAC,CAAC,EAAEC,aAAa,6BAA6B,CAAC;QACtD,MAAM,GAAGC,UAAU,gBAAgB,EAAEC,WAAW;QAChD,SAAS,CAAC,WAAW,EAAEF,aAAa,EAAE,EAAEC,UAAU,CAAC,CAAC;QACpD,MAAM,CAAC,CAAC,EAAEA,UAAU,+DAA+D,CAAC;QACpF,WAAW;IACf;AACJ"}

package/domain/notifications/messages/buildReassignedMessage.d.ts

@@ -0,0 +1,12 @@
+import type { NotificationMessage } from "../../../domain/notifications/types.js";
+export interface ReassignedMessageParams {
+    /** `review.title`. */
+    contentTitle: string;
+    stepTitle: string;
+    /** Who reassigned (`getActorName`). */
+    operator: string;
+    /** The new owner's display name. */
+    newOwner: string;
+}
+/** The old owner of a reassigned step (R189, `reassigned`). */
+export declare const buildReassignedMessage: (params: ReassignedMessageParams) => NotificationMessage;

package/domain/notifications/messages/buildReassignedMessage.js

@@ -0,0 +1,13 @@
+const buildReassignedMessage = (params)=>{
+    const { contentTitle, stepTitle, operator, newOwner } = params;
+    return {
+        title: `“${contentTitle}” was reassigned to ${newOwner}`,
+        body: `${stepTitle} · reassigned by ${operator}. You no longer own this step.`,
+        subject: `Reassigned: ${contentTitle} (${stepTitle})`,
+        text: `${operator} reassigned this step to ${newOwner}. You don’t need to review it any more.`,
+        linkLabel: "Open content"
+    };
+};
+export { buildReassignedMessage };
+
+//# sourceMappingURL=buildReassignedMessage.js.map

package/domain/notifications/messages/buildReassignedMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/notifications/messages/buildReassignedMessage.js","sources":["../../../../src/domain/notifications/messages/buildReassignedMessage.ts"],"sourcesContent":["import type { NotificationMessage } from \"~/domain/notifications/types.js\";\n\nexport interface ReassignedMessageParams {\n    /** `review.title`. */\n    contentTitle: string;\n    stepTitle: string;\n    /** Who reassigned (`getActorName`). */\n    operator: string;\n    /** The new owner's display name. */\n    newOwner: string;\n}\n\n/** The old owner of a reassigned step (R189, `reassigned`). */\nexport const buildReassignedMessage = (params: ReassignedMessageParams): NotificationMessage => {\n    const { contentTitle, stepTitle, operator, newOwner } = params;\n    return {\n        title: `“${contentTitle}” was reassigned to ${newOwner}`,\n        body: `${stepTitle} · reassigned by ${operator}. You no longer own this step.`,\n        subject: `Reassigned: ${contentTitle} (${stepTitle})`,\n        text: `${operator} reassigned this step to ${newOwner}. You don’t need to review it any more.`,\n        linkLabel: \"Open content\"\n    };\n};\n"],"names":["buildReassignedMessage","params","contentTitle","stepTitle","operator","newOwner"],"mappings":"AAaO,MAAMA,yBAAyB,CAACC;IACnC,MAAM,EAAEC,YAAY,EAAEC,SAAS,EAAEC,QAAQ,EAAEC,QAAQ,EAAE,GAAGJ;IACxD,OAAO;QACH,OAAO,CAAC,CAAC,EAAEC,aAAa,oBAAoB,EAAEG,UAAU;QACxD,MAAM,GAAGF,UAAU,iBAAiB,EAAEC,SAAS,8BAA8B,CAAC;QAC9E,SAAS,CAAC,YAAY,EAAEF,aAAa,EAAE,EAAEC,UAAU,CAAC,CAAC;QACrD,MAAM,GAAGC,SAAS,yBAAyB,EAAEC,SAAS,uCAAuC,CAAC;QAC9F,WAAW;IACf;AACJ"}

package/domain/notifications/messages/buildRejectedMessage.d.ts

@@ -0,0 +1,12 @@
+import type { NotificationMessage } from "../../../domain/notifications/types.js";
+export interface RejectedMessageParams {
+    /** `review.title`. */
+    contentTitle: string;
+    stepTitle: string;
+    /** Who rejected (`getActorName`): a person's name, or the step title for AI and automation. */
+    decider: string;
+    /** The rejection comment, if any; blank counts as none (D126). Clamped here (R189a). */
+    comment: string | null;
+}
+/** The requester's review was rejected (D107, R189, `rejected`). */
+export declare const buildRejectedMessage: (params: RejectedMessageParams) => NotificationMessage;

package/domain/notifications/messages/buildRejectedMessage.js

@@ -0,0 +1,25 @@
+import { clampComment } from "../clampComment.js";
+const buildRejectedMessage = (params)=>{
+    const { contentTitle, stepTitle, decider } = params;
+    const comment = null === params.comment ? "" : clampComment(params.comment);
+    if ("" === comment) {
+        const line = decider === stepTitle ? `Rejected at ${stepTitle}. Create a new revision to fix it, then request a new review.` : `Rejected at ${stepTitle} by ${decider}. Create a new revision to fix it, then request a new review.`;
+        return {
+            title: `“${contentTitle}” was rejected at ${stepTitle}`,
+            body: line,
+            subject: `Rejected: ${contentTitle} (${stepTitle})`,
+            text: line,
+            linkLabel: "Open content"
+        };
+    }
+    return {
+        title: `“${contentTitle}” was rejected at ${stepTitle}`,
+        body: `${decider}: “${comment}”. Create a new revision to fix it, then request a new review.`,
+        subject: `Rejected: ${contentTitle} (${stepTitle})`,
+        text: `${decider} rejected this revision at ${stepTitle}: “${comment}”. Create a new revision to fix it, then request a new review.`,
+        linkLabel: "Open content"
+    };
+};
+export { buildRejectedMessage };
+
+//# sourceMappingURL=buildRejectedMessage.js.map

package/domain/notifications/messages/buildRejectedMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/notifications/messages/buildRejectedMessage.js","sources":["../../../../src/domain/notifications/messages/buildRejectedMessage.ts"],"sourcesContent":["import { clampComment } from \"~/domain/notifications/clampComment.js\";\nimport type { NotificationMessage } from \"~/domain/notifications/types.js\";\n\nexport interface RejectedMessageParams {\n    /** `review.title`. */\n    contentTitle: string;\n    stepTitle: string;\n    /** Who rejected (`getActorName`): a person's name, or the step title for AI and automation. */\n    decider: string;\n    /** The rejection comment, if any; blank counts as none (D126). Clamped here (R189a). */\n    comment: string | null;\n}\n\n/** The requester's review was rejected (D107, R189, `rejected`). */\nexport const buildRejectedMessage = (params: RejectedMessageParams): NotificationMessage => {\n    const { contentTitle, stepTitle, decider } = params;\n    const comment = params.comment === null ? \"\" : clampComment(params.comment);\n    if (comment === \"\") {\n        // D126: an AI or automation decider is the step itself, so it is not named twice.\n        const line =\n            decider === stepTitle\n                ? `Rejected at ${stepTitle}. Create a new revision to fix it, then request a new review.`\n                : `Rejected at ${stepTitle} by ${decider}. Create a new revision to fix it, then request a new review.`;\n        return {\n            title: `“${contentTitle}” was rejected at ${stepTitle}`,\n            body: line,\n            subject: `Rejected: ${contentTitle} (${stepTitle})`,\n            text: line,\n            linkLabel: \"Open content\"\n        };\n    }\n    return {\n        title: `“${contentTitle}” was rejected at ${stepTitle}`,\n        body: `${decider}: “${comment}”. Create a new revision to fix it, then request a new review.`,\n        subject: `Rejected: ${contentTitle} (${stepTitle})`,\n        text: `${decider} rejected this revision at ${stepTitle}: “${comment}”. Create a new revision to fix it, then request a new review.`,\n        linkLabel: \"Open content\"\n    };\n};\n"],"names":["buildRejectedMessage","params","contentTitle","stepTitle","decider","comment","clampComment","line"],"mappings":";AAcO,MAAMA,uBAAuB,CAACC;IACjC,MAAM,EAAEC,YAAY,EAAEC,SAAS,EAAEC,OAAO,EAAE,GAAGH;IAC7C,MAAMI,UAAUJ,AAAmB,SAAnBA,OAAO,OAAO,GAAY,KAAKK,aAAaL,OAAO,OAAO;IAC1E,IAAII,AAAY,OAAZA,SAAgB;QAEhB,MAAME,OACFH,YAAYD,YACN,CAAC,YAAY,EAAEA,UAAU,6DAA6D,CAAC,GACvF,CAAC,YAAY,EAAEA,UAAU,IAAI,EAAEC,QAAQ,6DAA6D,CAAC;QAC/G,OAAO;YACH,OAAO,CAAC,CAAC,EAAEF,aAAa,kBAAkB,EAAEC,WAAW;YACvD,MAAMI;YACN,SAAS,CAAC,UAAU,EAAEL,aAAa,EAAE,EAAEC,UAAU,CAAC,CAAC;YACnD,MAAMI;YACN,WAAW;QACf;IACJ;IACA,OAAO;QACH,OAAO,CAAC,CAAC,EAAEL,aAAa,kBAAkB,EAAEC,WAAW;QACvD,MAAM,GAAGC,QAAQ,GAAG,EAAEC,QAAQ,8DAA8D,CAAC;QAC7F,SAAS,CAAC,UAAU,EAAEH,aAAa,EAAE,EAAEC,UAAU,CAAC,CAAC;QACnD,MAAM,GAAGC,QAAQ,2BAA2B,EAAED,UAAU,GAAG,EAAEE,QAAQ,8DAA8D,CAAC;QACpI,WAAW;IACf;AACJ"}

package/domain/notifications/messages/buildTakenOverMessage.d.ts

@@ -0,0 +1,10 @@
+import type { NotificationMessage } from "../../../domain/notifications/types.js";
+export interface TakenOverMessageParams {
+    /** `review.title`. */
+    contentTitle: string;
+    stepTitle: string;
+    /** Who took the step over (`getActorName`). */
+    taker: string;
+}
+/** The previous owner of a step somebody took over (D111, R189, `takenOver`). */
+export declare const buildTakenOverMessage: (params: TakenOverMessageParams) => NotificationMessage;

package/domain/notifications/messages/buildTakenOverMessage.js

@@ -0,0 +1,13 @@
+const buildTakenOverMessage = (params)=>{
+    const { contentTitle, stepTitle, taker } = params;
+    return {
+        title: `${taker} took over ${stepTitle} on “${contentTitle}”.`,
+        body: "You no longer own this step.",
+        subject: `Taken over: ${contentTitle} (${stepTitle})`,
+        text: `${taker} took over ${stepTitle} on “${contentTitle}”. You don’t need to review it any more.`,
+        linkLabel: "Open content"
+    };
+};
+export { buildTakenOverMessage };
+
+//# sourceMappingURL=buildTakenOverMessage.js.map

package/domain/notifications/messages/buildTakenOverMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/notifications/messages/buildTakenOverMessage.js","sources":["../../../../src/domain/notifications/messages/buildTakenOverMessage.ts"],"sourcesContent":["import type { NotificationMessage } from \"~/domain/notifications/types.js\";\n\nexport interface TakenOverMessageParams {\n    /** `review.title`. */\n    contentTitle: string;\n    stepTitle: string;\n    /** Who took the step over (`getActorName`). */\n    taker: string;\n}\n\n/** The previous owner of a step somebody took over (D111, R189, `takenOver`). */\nexport const buildTakenOverMessage = (params: TakenOverMessageParams): NotificationMessage => {\n    const { contentTitle, stepTitle, taker } = params;\n    return {\n        title: `${taker} took over ${stepTitle} on “${contentTitle}”.`,\n        body: \"You no longer own this step.\",\n        subject: `Taken over: ${contentTitle} (${stepTitle})`,\n        text: `${taker} took over ${stepTitle} on “${contentTitle}”. You don’t need to review it any more.`,\n        linkLabel: \"Open content\"\n    };\n};\n"],"names":["buildTakenOverMessage","params","contentTitle","stepTitle","taker"],"mappings":"AAWO,MAAMA,wBAAwB,CAACC;IAClC,MAAM,EAAEC,YAAY,EAAEC,SAAS,EAAEC,KAAK,EAAE,GAAGH;IAC3C,OAAO;QACH,OAAO,GAAGG,MAAM,WAAW,EAAED,UAAU,KAAK,EAAED,aAAa,EAAE,CAAC;QAC9D,MAAM;QACN,SAAS,CAAC,YAAY,EAAEA,aAAa,EAAE,EAAEC,UAAU,CAAC,CAAC;QACrD,MAAM,GAAGC,MAAM,WAAW,EAAED,UAAU,KAAK,EAAED,aAAa,wCAAwC,CAAC;QACnG,WAAW;IACf;AACJ"}

package/domain/notifications/messages/getAssignmentReason.d.ts

@@ -0,0 +1,7 @@
+import type { AssignmentSource } from "../../../domain/assignment/types.js";
+/**
+ * The `{reason}` of an `assigned` message (R189a). `rule` carries no rule name (A62: a rule id is
+ * not a name); a pool start, take over, reassign or a missing source reads "assigned to you".
+ * Pure.
+ */
+export declare const getAssignmentReason: (source: AssignmentSource | null | undefined, requesterName: string) => string;

package/domain/notifications/messages/getAssignmentReason.js

@@ -0,0 +1,17 @@
+const getAssignmentReason = (source, requesterName)=>{
+    switch(source){
+        case "picked":
+            return `picked by ${requesterName}`;
+        case "rule":
+            return "assigned by a routing rule";
+        case "roundRobin":
+            return "assigned by round-robin";
+        case "leastLoaded":
+            return "assigned by least-loaded";
+        default:
+            return "assigned to you";
+    }
+};
+export { getAssignmentReason };
+
+//# sourceMappingURL=getAssignmentReason.js.map

package/domain/notifications/messages/getAssignmentReason.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/notifications/messages/getAssignmentReason.js","sources":["../../../../src/domain/notifications/messages/getAssignmentReason.ts"],"sourcesContent":["import type { AssignmentSource } from \"~/domain/assignment/types.js\";\n\n/**\n * The `{reason}` of an `assigned` message (R189a). `rule` carries no rule name (A62: a rule id is\n * not a name); a pool start, take over, reassign or a missing source reads \"assigned to you\".\n * Pure.\n */\nexport const getAssignmentReason = (\n    source: AssignmentSource | null | undefined,\n    requesterName: string\n): string => {\n    switch (source) {\n        case \"picked\":\n            return `picked by ${requesterName}`;\n        case \"rule\":\n            return \"assigned by a routing rule\";\n        case \"roundRobin\":\n            return \"assigned by round-robin\";\n        case \"leastLoaded\":\n            return \"assigned by least-loaded\";\n        default:\n            return \"assigned to you\";\n    }\n};\n"],"names":["getAssignmentReason","source","requesterName"],"mappings":"AAOO,MAAMA,sBAAsB,CAC/BC,QACAC;IAEA,OAAQD;QACJ,KAAK;YACD,OAAO,CAAC,UAAU,EAAEC,eAAe;QACvC,KAAK;YACD,OAAO;QACX,KAAK;YACD,OAAO;QACX,KAAK;YACD,OAAO;QACX;YACI,OAAO;IACf;AACJ"}

package/domain/notifications/toSingleLine.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Collapses every CR, LF and run of whitespace to one space and trims (R193). The mail subject
+ * holds user content (content and step titles), so a line break in it must not become a header.
+ * Pure.
+ */
+export declare const toSingleLine: (value: string) => string;

package/domain/notifications/toSingleLine.js

@@ -0,0 +1,4 @@
+const toSingleLine = (value)=>value.replace(/\s+/g, " ").trim();
+export { toSingleLine };
+
+//# sourceMappingURL=toSingleLine.js.map

package/domain/notifications/toSingleLine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/notifications/toSingleLine.js","sources":["../../../src/domain/notifications/toSingleLine.ts"],"sourcesContent":["/**\n * Collapses every CR, LF and run of whitespace to one space and trims (R193). The mail subject\n * holds user content (content and step titles), so a line break in it must not become a header.\n * Pure.\n */\nexport const toSingleLine = (value: string): string => {\n    return value.replace(/\\s+/g, \" \").trim();\n};\n"],"names":["toSingleLine","value"],"mappings":"AAKO,MAAMA,eAAe,CAACC,QAClBA,MAAM,OAAO,CAAC,QAAQ,KAAK,IAAI"}

package/domain/notifications/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * One registered notification transport, as the transports operation lists it (D129, R191).
+ * `description` is `null` when the transport has none.
+ */
+export interface NotificationTransportInfo {
+    id: string;
+    title: string;
+    description: string | null;
+}
+/**
+ * The events a recipient is told about (R187). Not the review fact names: `poolReached` and
+ * `assigned` are the two shapes of `stepReached`.
+ */
+export type WorkflowNotificationEvent = "poolReached" | "assigned" | "reassigned" | "takenOver" | "approved" | "rejected" | "failed" | "cancelled";
+/**
+ * One notification's texts (R189). `title` and `body` are the websocket (in-app) texts;
+ * `subject`, `text` and `linkLabel` go to the transports (`subject` is the transport message
+ * `title`, `text` its `body`). Plain text: escaping is the transport's job.
+ */
+export interface NotificationMessage {
+    title: string;
+    body: string;
+    subject: string;
+    text: string;
+    linkLabel: string;
+}
+/**
+ * The `data` of the `workflows.notification` websocket action (R187). Ids, the namespace and the
+ * in-app texts only (R200); `stepId` is `null` only for a cancel with no step, which notifies
+ * nobody.
+ */
+export interface WorkflowNotificationWebsocketData {
+    event: WorkflowNotificationEvent;
+    reviewId: string;
+    stepId: string | null;
+    /** `review.model`: the client opens the CMS or Website Builder app by it (D133). */
+    namespace: string;
+    targetId: string;
+    targetRevisionId: string;
+    title: string;
+    body: string;
+}
+/** What changed in a review, as the silent change message names it (R253). */
+export type WorkflowReviewChangedKind = "requested" | "stepStarted" | "stepApproved" | "stepRestarted";
+/**
+ * The `data` of the `workflows.reviewChanged` websocket action (R253). Ids and the namespace
+ * only (R200): the client refetches what shows the review. `stepId` is the step the change is
+ * about, `null` when the review has none.
+ */
+export interface WorkflowReviewChangedWebsocketData {
+    kind: WorkflowReviewChangedKind;
+    reviewId: string;
+    stepId: string | null;
+    /** `review.model`: the client opens the CMS or Website Builder app by it (D133). */
+    namespace: string;
+    targetId: string;
+    targetRevisionId: string;
+}

package/domain/permissions/errors.d.ts

@@ -0,0 +1,15 @@
+import { BaseError } from "@webiny/feature/api";
+/** Workflow actions need a signed-in identity; returned to app wrappers by `CurrentReviewViewer`. */
+export declare class WorkflowsNotAuthenticatedError extends BaseError {
+    readonly code: "Workflows/NotAuthenticated";
+    constructor();
+}
+export interface WorkflowsNotAuthorizedErrorData {
+    /** What was refused, e.g. `cancel`. */
+    action: string;
+}
+/** Shared by the app wrappers when a workflows permission or target access check refuses an action. */
+export declare class WorkflowsNotAuthorizedError extends BaseError<WorkflowsNotAuthorizedErrorData> {
+    readonly code: "Workflows/NotAuthorized";
+    constructor(data: WorkflowsNotAuthorizedErrorData);
+}

package/domain/permissions/errors.js

@@ -0,0 +1,19 @@
+import { BaseError } from "@webiny/feature/api";
+class WorkflowsNotAuthenticatedError extends BaseError {
+    constructor(){
+        super({
+            message: "You must be signed in to use workflows."
+        }), this.code = "Workflows/NotAuthenticated";
+    }
+}
+class WorkflowsNotAuthorizedError extends BaseError {
+    constructor(data){
+        super({
+            message: `You are not allowed to ${data.action}.`,
+            data
+        }), this.code = "Workflows/NotAuthorized";
+    }
+}
+export { WorkflowsNotAuthenticatedError, WorkflowsNotAuthorizedError };
+
+//# sourceMappingURL=errors.js.map

package/domain/permissions/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain/permissions/errors.js","sources":["../../../src/domain/permissions/errors.ts"],"sourcesContent":["import { BaseError } from \"@webiny/feature/api\";\n\n/** Workflow actions need a signed-in identity; returned to app wrappers by `CurrentReviewViewer`. */\nexport class WorkflowsNotAuthenticatedError extends BaseError {\n    override readonly code = \"Workflows/NotAuthenticated\" as const;\n\n    constructor() {\n        super({ message: \"You must be signed in to use workflows.\" });\n    }\n}\n\nexport interface WorkflowsNotAuthorizedErrorData {\n    /** What was refused, e.g. `cancel`. */\n    action: string;\n}\n\n/** Shared by the app wrappers when a workflows permission or target access check refuses an action. */\nexport class WorkflowsNotAuthorizedError extends BaseError<WorkflowsNotAuthorizedErrorData> {\n    override readonly code = \"Workflows/NotAuthorized\" as const;\n\n    constructor(data: WorkflowsNotAuthorizedErrorData) {\n        super({ message: `You are not allowed to ${data.action}.`, data });\n    }\n}\n"],"names":["WorkflowsNotAuthenticatedError","BaseError","WorkflowsNotAuthorizedError","data"],"mappings":";AAGO,MAAMA,uCAAuCC;IAGhD,aAAc;QACV,KAAK,CAAC;YAAE,SAAS;QAA0C,SAH7C,IAAI,GAAG;IAIzB;AACJ;AAQO,MAAMC,oCAAoCD;IAG7C,YAAYE,IAAqC,CAAE;QAC/C,KAAK,CAAC;YAAE,SAAS,CAAC,uBAAuB,EAAEA,KAAK,MAAM,CAAC,CAAC,CAAC;YAAEA;QAAK,SAHlD,IAAI,GAAG;IAIzB;AACJ"}

package/domain/permissions/types.d.ts

@@ -0,0 +1,11 @@
+/** Custom boolean actions of the `workflows` permission (spec 8, D54). */
+export type WorkflowsPermissionAction = "editor" | "reassign";
+/**
+ * What the current identity may do in workflows (spec 8, D54). Full access (`*`, `workflows.*`)
+ * sets `editor` and `reassign` too, so callers only ever read the action they need.
+ */
+export interface WorkflowsPermissionSet {
+    fullAccess: boolean;
+    editor: boolean;
+    reassign: boolean;
+}