@webiny/api-workflows 0.0.0-unstable.c27f4d8a31 → 0.0.0-unstable.d0f34a8194

package/features/notifications/ListNotificationTransports/ListNotificationTransportsRepository.js

@@ -0,0 +1,33 @@
+import { Result } from "@webiny/feature/api";
+import { ListNotificationTransportsRepository } from "./abstractions.js";
+import { NotificationTransport } from "../NotificationTransport/index.js";
+class ListNotificationTransportsRepositoryImpl {
+    constructor(transports){
+        this.transports = transports;
+    }
+    async execute() {
+        const registered = new Map(this.transports.map((transport)=>[
+                transport.id,
+                transport
+            ]));
+        return Result.ok(Array.from(registered.values()).map((transport)=>({
+                id: transport.id,
+                title: transport.title,
+                description: transport.description ?? null
+            })));
+    }
+}
+const ListNotificationTransportsRepository_ListNotificationTransportsRepository = ListNotificationTransportsRepository.createImplementation({
+    implementation: ListNotificationTransportsRepositoryImpl,
+    dependencies: [
+        [
+            NotificationTransport,
+            {
+                multiple: true
+            }
+        ]
+    ]
+});
+export { ListNotificationTransportsRepository_ListNotificationTransportsRepository as ListNotificationTransportsRepository };
+
+//# sourceMappingURL=ListNotificationTransportsRepository.js.map

package/features/notifications/ListNotificationTransports/ListNotificationTransportsRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/notifications/ListNotificationTransports/ListNotificationTransportsRepository.js","sources":["../../../../src/features/notifications/ListNotificationTransports/ListNotificationTransportsRepository.ts"],"sourcesContent":["import { Result } from \"@webiny/feature/api\";\nimport { ListNotificationTransportsRepository as Repository } from \"./abstractions.js\";\nimport { NotificationTransport } from \"~/features/notifications/NotificationTransport/index.js\";\n\nclass ListNotificationTransportsRepositoryImpl implements Repository.Interface {\n    private readonly transports;\n\n    public constructor(transports: NotificationTransport.Interface[]) {\n        this.transports = transports;\n    }\n\n    public async execute(): Repository.Return {\n        // One row per id: the last registration overrides, as when notifying (the Map keeps the\n        // first registration's position and the last one's value).\n        const registered = new Map(this.transports.map(transport => [transport.id, transport]));\n        return Result.ok(\n            Array.from(registered.values()).map(transport => {\n                return {\n                    id: transport.id,\n                    title: transport.title,\n                    description: transport.description ?? null\n                };\n            })\n        );\n    }\n}\n\nexport const ListNotificationTransportsRepository = Repository.createImplementation({\n    implementation: ListNotificationTransportsRepositoryImpl,\n    dependencies: [[NotificationTransport, { multiple: true }]]\n});\n"],"names":["ListNotificationTransportsRepositoryImpl","transports","registered","Map","transport","Result","Array","ListNotificationTransportsRepository","Repository","NotificationTransport"],"mappings":";;;AAIA,MAAMA;IAGF,YAAmBC,UAA6C,CAAE;QAC9D,IAAI,CAAC,UAAU,GAAGA;IACtB;IAEA,MAAa,UAA6B;QAGtC,MAAMC,aAAa,IAAIC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAACC,CAAAA,YAAa;gBAACA,UAAU,EAAE;gBAAEA;aAAU;QACrF,OAAOC,OAAO,EAAE,CACZC,MAAM,IAAI,CAACJ,WAAW,MAAM,IAAI,GAAG,CAACE,CAAAA,YACzB;gBACH,IAAIA,UAAU,EAAE;gBAChB,OAAOA,UAAU,KAAK;gBACtB,aAAaA,UAAU,WAAW,IAAI;YAC1C;IAGZ;AACJ;AAEO,MAAMG,4EAAuCC,qCAAAA,oBAA+B,CAAC;IAChF,gBAAgBR;IAChB,cAAc;QAAC;YAACS;YAAuB;gBAAE,UAAU;YAAK;SAAE;KAAC;AAC/D"}

package/features/notifications/ListNotificationTransports/ListNotificationTransportsUseCase.d.ts

@@ -0,0 +1,14 @@
+import { ListNotificationTransportsRepository, ListNotificationTransportsUseCase as UseCase } from "./abstractions.js";
+/**
+ * Lists the registered notification transports. Internal (D132): reads no identity and checks no
+ * permission; the shared transports operation checks `editor` (D133, R40).
+ */
+declare class ListNotificationTransportsUseCaseImpl implements UseCase.Interface {
+    private repository;
+    constructor(repository: ListNotificationTransportsRepository.Interface);
+    execute(): UseCase.Return;
+}
+export declare const ListNotificationTransportsUseCase: typeof ListNotificationTransportsUseCaseImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("./abstractions.js").IListNotificationTransportsUseCase>;
+};
+export {};

package/features/notifications/ListNotificationTransports/ListNotificationTransportsUseCase.js

@@ -0,0 +1,18 @@
+import { ListNotificationTransportsRepository, ListNotificationTransportsUseCase } from "./abstractions.js";
+class ListNotificationTransportsUseCaseImpl {
+    constructor(repository){
+        this.repository = repository;
+    }
+    async execute() {
+        return this.repository.execute();
+    }
+}
+const ListNotificationTransportsUseCase_ListNotificationTransportsUseCase = ListNotificationTransportsUseCase.createImplementation({
+    implementation: ListNotificationTransportsUseCaseImpl,
+    dependencies: [
+        ListNotificationTransportsRepository
+    ]
+});
+export { ListNotificationTransportsUseCase_ListNotificationTransportsUseCase as ListNotificationTransportsUseCase };
+
+//# sourceMappingURL=ListNotificationTransportsUseCase.js.map

package/features/notifications/ListNotificationTransports/ListNotificationTransportsUseCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/notifications/ListNotificationTransports/ListNotificationTransportsUseCase.js","sources":["../../../../src/features/notifications/ListNotificationTransports/ListNotificationTransportsUseCase.ts"],"sourcesContent":["import {\n    ListNotificationTransportsRepository,\n    ListNotificationTransportsUseCase as UseCase\n} from \"./abstractions.js\";\n\n/**\n * Lists the registered notification transports. Internal (D132): reads no identity and checks no\n * permission; the shared transports operation checks `editor` (D133, R40).\n */\nclass ListNotificationTransportsUseCaseImpl implements UseCase.Interface {\n    public constructor(private repository: ListNotificationTransportsRepository.Interface) {}\n\n    public async execute(): UseCase.Return {\n        return this.repository.execute();\n    }\n}\n\nexport const ListNotificationTransportsUseCase = UseCase.createImplementation({\n    implementation: ListNotificationTransportsUseCaseImpl,\n    dependencies: [ListNotificationTransportsRepository]\n});\n"],"names":["ListNotificationTransportsUseCaseImpl","repository","ListNotificationTransportsUseCase","UseCase","ListNotificationTransportsRepository"],"mappings":";AASA,MAAMA;IACF,YAA2BC,UAA0D,CAAE;aAA5DA,UAAU,GAAVA;IAA6D;IAExF,MAAa,UAA0B;QACnC,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO;IAClC;AACJ;AAEO,MAAMC,sEAAoCC,kCAAAA,oBAA4B,CAAC;IAC1E,gBAAgBH;IAChB,cAAc;QAACI;KAAqC;AACxD"}

package/features/notifications/ListNotificationTransports/abstractions.d.ts

@@ -0,0 +1,25 @@
+import type { Result } from "@webiny/feature/api";
+import type { NotificationTransportInfo } from "../../../domain/notifications/types.js";
+/**
+ * ListNotificationTransports use case interface. Internal (D132): no permission check, so no
+ * error of its own; the shared transports operation checks `editor` (D133).
+ */
+export interface IListNotificationTransportsUseCase {
+    execute(): Promise<Result<NotificationTransportInfo[]>>;
+}
+export declare const ListNotificationTransportsUseCase: import("@webiny/di").Abstraction<IListNotificationTransportsUseCase>;
+export declare namespace ListNotificationTransportsUseCase {
+    type Interface = IListNotificationTransportsUseCase;
+    type Return = Promise<Result<NotificationTransportInfo[]>>;
+}
+/**
+ * ListNotificationTransports repository interface
+ */
+export interface IListNotificationTransportsRepository {
+    execute(): Promise<Result<NotificationTransportInfo[]>>;
+}
+export declare const ListNotificationTransportsRepository: import("@webiny/di").Abstraction<IListNotificationTransportsRepository>;
+export declare namespace ListNotificationTransportsRepository {
+    type Interface = IListNotificationTransportsRepository;
+    type Return = Promise<Result<NotificationTransportInfo[]>>;
+}

package/features/notifications/ListNotificationTransports/abstractions.js

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

package/features/notifications/ListNotificationTransports/abstractions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/notifications/ListNotificationTransports/abstractions.js","sources":["../../../../src/features/notifications/ListNotificationTransports/abstractions.ts"],"sourcesContent":["import type { Result } from \"@webiny/feature/api\";\nimport { createAbstraction } from \"@webiny/feature/api\";\nimport type { NotificationTransportInfo } from \"~/domain/notifications/types.js\";\n\n/**\n * ListNotificationTransports use case interface. Internal (D132): no permission check, so no\n * error of its own; the shared transports operation checks `editor` (D133).\n */\nexport interface IListNotificationTransportsUseCase {\n    execute(): Promise<Result<NotificationTransportInfo[]>>;\n}\n\nexport const ListNotificationTransportsUseCase =\n    createAbstraction<IListNotificationTransportsUseCase>(\"ListNotificationTransportsUseCase\");\n\nexport namespace ListNotificationTransportsUseCase {\n    export type Interface = IListNotificationTransportsUseCase;\n    export type Return = Promise<Result<NotificationTransportInfo[]>>;\n}\n\n/**\n * ListNotificationTransports repository interface\n */\nexport interface IListNotificationTransportsRepository {\n    execute(): Promise<Result<NotificationTransportInfo[]>>;\n}\n\nexport const ListNotificationTransportsRepository =\n    createAbstraction<IListNotificationTransportsRepository>(\n        \"ListNotificationTransportsRepository\"\n    );\n\nexport namespace ListNotificationTransportsRepository {\n    export type Interface = IListNotificationTransportsRepository;\n    export type Return = Promise<Result<NotificationTransportInfo[]>>;\n}\n"],"names":["ListNotificationTransportsUseCase","createAbstraction","ListNotificationTransportsRepository"],"mappings":";AAYO,MAAMA,oCACTC,kBAAsD;AAcnD,MAAMC,uCACTD,kBACI"}

package/features/notifications/ListNotificationTransports/feature.d.ts

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

package/features/notifications/ListNotificationTransports/feature.js

@@ -0,0 +1,13 @@
+import { createFeature } from "@webiny/feature/api";
+import { ListNotificationTransportsUseCase } from "./ListNotificationTransportsUseCase.js";
+import { ListNotificationTransportsRepository } from "./ListNotificationTransportsRepository.js";
+const ListNotificationTransportsFeature = createFeature({
+    name: "WorkflowNotifications/ListNotificationTransports",
+    register (container) {
+        container.register(ListNotificationTransportsRepository).inSingletonScope();
+        container.register(ListNotificationTransportsUseCase);
+    }
+});
+export { ListNotificationTransportsFeature };
+
+//# sourceMappingURL=feature.js.map

package/features/notifications/ListNotificationTransports/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/notifications/ListNotificationTransports/feature.js","sources":["../../../../src/features/notifications/ListNotificationTransports/feature.ts"],"sourcesContent":["import { createFeature } from \"@webiny/feature/api\";\nimport { ListNotificationTransportsUseCase } from \"./ListNotificationTransportsUseCase.js\";\nimport { ListNotificationTransportsRepository } from \"./ListNotificationTransportsRepository.js\";\n\nexport const ListNotificationTransportsFeature = createFeature({\n    name: \"WorkflowNotifications/ListNotificationTransports\",\n    register(container) {\n        container.register(ListNotificationTransportsRepository).inSingletonScope();\n        container.register(ListNotificationTransportsUseCase);\n    }\n});\n"],"names":["ListNotificationTransportsFeature","createFeature","container","ListNotificationTransportsRepository","ListNotificationTransportsUseCase"],"mappings":";;;AAIO,MAAMA,oCAAoCC,cAAc;IAC3D,MAAM;IACN,UAASC,SAAS;QACdA,UAAU,QAAQ,CAACC,sCAAsC,gBAAgB;QACzED,UAAU,QAAQ,CAACE;IACvB;AACJ"}

package/features/notifications/ListNotificationTransports/index.d.ts

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

package/features/notifications/ListNotificationTransports/index.js

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

package/features/notifications/NotificationRecipientService/NotificationRecipientService.d.ts

@@ -0,0 +1,16 @@
+import { IdentityContext } from "@webiny/api-core/features/security/IdentityContext/index.js";
+import { ListUsersUseCase } from "@webiny/api-core/features/users/ListUsers/index.js";
+import { RoutingEvaluatorService } from "../../../features/routing/RoutingEvaluatorService/index.js";
+import { NotificationRecipientService as Abstraction } from "./abstractions.js";
+declare class NotificationRecipientServiceImpl implements Abstraction.Interface {
+    private routing;
+    private identityContext;
+    private listUsersUseCase;
+    constructor(routing: RoutingEvaluatorService.Interface, identityContext: IdentityContext.Interface, listUsersUseCase: ListUsersUseCase.Interface);
+    listPool(params: Abstraction.PoolParams): Abstraction.PoolReturn;
+    listUsers(ids: string[]): Abstraction.UsersReturn;
+}
+export declare const NotificationRecipientService: typeof NotificationRecipientServiceImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("./abstractions.js").INotificationRecipientService>;
+};
+export {};

package/features/notifications/NotificationRecipientService/NotificationRecipientService.js

@@ -0,0 +1,77 @@
+import { Result } from "@webiny/feature/api";
+import { IdentityContext } from "@webiny/api-core/features/security/IdentityContext/index.js";
+import { ListUsersUseCase } from "@webiny/api-core/features/users/ListUsers/index.js";
+import { MAX_USER_LIST_LIMIT } from "../../../constants.js";
+import { toStepMembersParams } from "../../../domain/routing/toStepMembersParams.js";
+import { WorkflowPersistenceError } from "../../../domain/workflow/errors.js";
+import { ReviewValidationError } from "../../../domain/review/errors.js";
+import { RoutingEvaluatorService } from "../../routing/RoutingEvaluatorService/index.js";
+import { NotificationRecipientService } from "./abstractions.js";
+class NotificationRecipientServiceImpl {
+    constructor(routing, identityContext, listUsersUseCase){
+        this.routing = routing;
+        this.identityContext = identityContext;
+        this.listUsersUseCase = listUsersUseCase;
+    }
+    async listPool(params) {
+        const { review, stepId, now } = params;
+        const step = review.steps.find((item)=>item.id === stepId);
+        if (!step) return Result.fail(new ReviewValidationError(`Step "${stepId}" does not exist in this review.`));
+        const membersParams = toStepMembersParams({
+            review,
+            step,
+            now
+        });
+        let listed;
+        try {
+            listed = await this.routing.listMembers(membersParams);
+        } catch (error) {
+            return Result.fail(new WorkflowPersistenceError(error instanceof Error ? error : new Error(String(error))));
+        }
+        if (listed.isFail()) return Result.fail(new WorkflowPersistenceError(listed.error));
+        const pool = [];
+        for (const member of listed.value)if (!member.exclusion && member.canRead) pool.push({
+            id: member.id,
+            displayName: member.displayName
+        });
+        return Result.ok(pool);
+    }
+    async listUsers(ids) {
+        const unique = [
+            ...new Set(ids.filter((id)=>"string" == typeof id && "" !== id.trim()))
+        ];
+        if (0 === unique.length) return Result.ok([]);
+        const users = [];
+        for(let start = 0; start < unique.length; start += MAX_USER_LIST_LIMIT){
+            const chunk = unique.slice(start, start + MAX_USER_LIST_LIMIT);
+            let listed;
+            try {
+                listed = await this.identityContext.withoutAuthorization(()=>this.listUsersUseCase.execute({
+                        where: {
+                            id_in: chunk
+                        }
+                    }));
+            } catch (error) {
+                return Result.fail(new WorkflowPersistenceError(error instanceof Error ? error : new Error(String(error))));
+            }
+            if (listed.isFail()) return Result.fail(new WorkflowPersistenceError(listed.error));
+            for (const user of listed.value)users.push({
+                id: user.id,
+                email: user.email,
+                displayName: user.displayName
+            });
+        }
+        return Result.ok(users);
+    }
+}
+const NotificationRecipientService_NotificationRecipientService = NotificationRecipientService.createImplementation({
+    implementation: NotificationRecipientServiceImpl,
+    dependencies: [
+        RoutingEvaluatorService,
+        IdentityContext,
+        ListUsersUseCase
+    ]
+});
+export { NotificationRecipientService_NotificationRecipientService as NotificationRecipientService };
+
+//# sourceMappingURL=NotificationRecipientService.js.map

package/features/notifications/NotificationRecipientService/NotificationRecipientService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/notifications/NotificationRecipientService/NotificationRecipientService.js","sources":["../../../../src/features/notifications/NotificationRecipientService/NotificationRecipientService.ts"],"sourcesContent":["import { Result } from \"@webiny/feature/api\";\nimport { IdentityContext } from \"@webiny/api-core/features/security/IdentityContext/index.js\";\nimport { ListUsersUseCase } from \"@webiny/api-core/features/users/ListUsers/index.js\";\nimport type { AdminUser } from \"@webiny/api-core/types/users.js\";\nimport { MAX_USER_LIST_LIMIT } from \"~/constants.js\";\nimport type { RoutingDependencyError } from \"~/domain/routing/errors.js\";\nimport type { RoutingMember } from \"~/domain/routing/types.js\";\nimport { toStepMembersParams } from \"~/domain/routing/toStepMembersParams.js\";\nimport { WorkflowPersistenceError } from \"~/domain/workflow/errors.js\";\nimport { ReviewValidationError } from \"~/domain/review/errors.js\";\nimport { RoutingEvaluatorService } from \"~/features/routing/RoutingEvaluatorService/index.js\";\nimport type { NotificationTransport } from \"~/features/notifications/NotificationTransport/abstractions.js\";\nimport { NotificationRecipientService as Abstraction } from \"./abstractions.js\";\n\nclass NotificationRecipientServiceImpl implements Abstraction.Interface {\n    public constructor(\n        private routing: RoutingEvaluatorService.Interface,\n        private identityContext: IdentityContext.Interface,\n        private listUsersUseCase: ListUsersUseCase.Interface\n    ) {}\n\n    public async listPool(params: Abstraction.PoolParams): Abstraction.PoolReturn {\n        const { review, stepId, now } = params;\n        const step = review.steps.find(item => item.id === stepId);\n        if (!step) {\n            return Result.fail(\n                new ReviewValidationError(`Step \"${stepId}\" does not exist in this review.`)\n            );\n        }\n\n        // The same params `ListStepCandidatesUseCase` builds for a review's step (R120).\n        const membersParams = toStepMembersParams({ review, step, now });\n\n        // `listMembers` returns every member except the requester, with `exclusion` and\n        // `canRead`, and filters nothing (R194). Its user lookup and its read checks (as the\n        // request identity) are its own business: nothing is wrapped here.\n        let listed: Result<RoutingMember[], RoutingDependencyError>;\n        try {\n            listed = await this.routing.listMembers(membersParams);\n        } catch (error) {\n            return Result.fail(\n                new WorkflowPersistenceError(\n                    error instanceof Error ? error : new Error(String(error))\n                )\n            );\n        }\n        if (listed.isFail()) {\n            return Result.fail(new WorkflowPersistenceError(listed.error));\n        }\n\n        const pool: Abstraction.Recipient[] = [];\n        for (const member of listed.value) {\n            if (!member.exclusion && member.canRead) {\n                pool.push({ id: member.id, displayName: member.displayName });\n            }\n        }\n        return Result.ok(pool);\n    }\n\n    public async listUsers(ids: string[]): Abstraction.UsersReturn {\n        const unique = [...new Set(ids.filter(id => typeof id === \"string\" && id.trim() !== \"\"))];\n        if (unique.length === 0) {\n            return Result.ok([]);\n        }\n\n        const users: NotificationTransport.User[] = [];\n        for (let start = 0; start < unique.length; start += MAX_USER_LIST_LIMIT) {\n            const chunk = unique.slice(start, start + MAX_USER_LIST_LIMIT);\n\n            // `ListUsersUseCase` needs `adminUsers.user`: a lookup of the people to tell, not an\n            // access decision. Only this call runs without authorization.\n            let listed: Result<AdminUser[], ListUsersUseCase.Error>;\n            try {\n                // oxlint-disable-next-line no-await-in-loop -- one query per chunk of user ids.\n                listed = await this.identityContext.withoutAuthorization(() => {\n                    return this.listUsersUseCase.execute({ where: { id_in: chunk } });\n                });\n            } catch (error) {\n                return Result.fail(\n                    new WorkflowPersistenceError(\n                        error instanceof Error ? error : new Error(String(error))\n                    )\n                );\n            }\n            if (listed.isFail()) {\n                return Result.fail(new WorkflowPersistenceError(listed.error));\n            }\n            for (const user of listed.value) {\n                users.push({ id: user.id, email: user.email, displayName: user.displayName });\n            }\n        }\n        return Result.ok(users);\n    }\n}\n\nexport const NotificationRecipientService = Abstraction.createImplementation({\n    implementation: NotificationRecipientServiceImpl,\n    dependencies: [RoutingEvaluatorService, IdentityContext, ListUsersUseCase]\n});\n"],"names":["NotificationRecipientServiceImpl","routing","identityContext","listUsersUseCase","params","review","stepId","now","step","item","Result","ReviewValidationError","membersParams","toStepMembersParams","listed","error","WorkflowPersistenceError","Error","String","pool","member","ids","unique","Set","id","users","start","MAX_USER_LIST_LIMIT","chunk","user","NotificationRecipientService","Abstraction","RoutingEvaluatorService","IdentityContext","ListUsersUseCase"],"mappings":";;;;;;;;;AAcA,MAAMA;IACF,YACYC,OAA0C,EAC1CC,eAA0C,EAC1CC,gBAA4C,CACtD;aAHUF,OAAO,GAAPA;aACAC,eAAe,GAAfA;aACAC,gBAAgB,GAAhBA;IACT;IAEH,MAAa,SAASC,MAA8B,EAA0B;QAC1E,MAAM,EAAEC,MAAM,EAAEC,MAAM,EAAEC,GAAG,EAAE,GAAGH;QAChC,MAAMI,OAAOH,OAAO,KAAK,CAAC,IAAI,CAACI,CAAAA,OAAQA,KAAK,EAAE,KAAKH;QACnD,IAAI,CAACE,MACD,OAAOE,OAAO,IAAI,CACd,IAAIC,sBAAsB,CAAC,MAAM,EAAEL,OAAO,gCAAgC,CAAC;QAKnF,MAAMM,gBAAgBC,oBAAoB;YAAER;YAAQG;YAAMD;QAAI;QAK9D,IAAIO;QACJ,IAAI;YACAA,SAAS,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAACF;QAC5C,EAAE,OAAOG,OAAO;YACZ,OAAOL,OAAO,IAAI,CACd,IAAIM,yBACAD,iBAAiBE,QAAQF,QAAQ,IAAIE,MAAMC,OAAOH;QAG9D;QACA,IAAID,OAAO,MAAM,IACb,OAAOJ,OAAO,IAAI,CAAC,IAAIM,yBAAyBF,OAAO,KAAK;QAGhE,MAAMK,OAAgC,EAAE;QACxC,KAAK,MAAMC,UAAUN,OAAO,KAAK,CAC7B,IAAI,CAACM,OAAO,SAAS,IAAIA,OAAO,OAAO,EACnCD,KAAK,IAAI,CAAC;YAAE,IAAIC,OAAO,EAAE;YAAE,aAAaA,OAAO,WAAW;QAAC;QAGnE,OAAOV,OAAO,EAAE,CAACS;IACrB;IAEA,MAAa,UAAUE,GAAa,EAA2B;QAC3D,MAAMC,SAAS;eAAI,IAAIC,IAAIF,IAAI,MAAM,CAACG,CAAAA,KAAM,AAAc,YAAd,OAAOA,MAAmBA,AAAc,OAAdA,GAAG,IAAI;SAAY;QACzF,IAAIF,AAAkB,MAAlBA,OAAO,MAAM,EACb,OAAOZ,OAAO,EAAE,CAAC,EAAE;QAGvB,MAAMe,QAAsC,EAAE;QAC9C,IAAK,IAAIC,QAAQ,GAAGA,QAAQJ,OAAO,MAAM,EAAEI,SAASC,oBAAqB;YACrE,MAAMC,QAAQN,OAAO,KAAK,CAACI,OAAOA,QAAQC;YAI1C,IAAIb;YACJ,IAAI;gBAEAA,SAAS,MAAM,IAAI,CAAC,eAAe,CAAC,oBAAoB,CAAC,IAC9C,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC;wBAAE,OAAO;4BAAE,OAAOc;wBAAM;oBAAE;YAEvE,EAAE,OAAOb,OAAO;gBACZ,OAAOL,OAAO,IAAI,CACd,IAAIM,yBACAD,iBAAiBE,QAAQF,QAAQ,IAAIE,MAAMC,OAAOH;YAG9D;YACA,IAAID,OAAO,MAAM,IACb,OAAOJ,OAAO,IAAI,CAAC,IAAIM,yBAAyBF,OAAO,KAAK;YAEhE,KAAK,MAAMe,QAAQf,OAAO,KAAK,CAC3BW,MAAM,IAAI,CAAC;gBAAE,IAAII,KAAK,EAAE;gBAAE,OAAOA,KAAK,KAAK;gBAAE,aAAaA,KAAK,WAAW;YAAC;QAEnF;QACA,OAAOnB,OAAO,EAAE,CAACe;IACrB;AACJ;AAEO,MAAMK,4DAA+BC,6BAAAA,oBAAgC,CAAC;IACzE,gBAAgB/B;IAChB,cAAc;QAACgC;QAAyBC;QAAiBC;KAAiB;AAC9E"}

package/features/notifications/NotificationRecipientService/abstractions.d.ts

@@ -0,0 +1,47 @@
+import type { Result } from "@webiny/feature/api";
+import type { ReviewData } from "../../../domain/review/types.js";
+import type { WorkflowPersistenceError } from "../../../domain/workflow/errors.js";
+import type { ReviewValidationError } from "../../../domain/review/errors.js";
+import type { NotificationTransport } from "../../../features/notifications/NotificationTransport/abstractions.js";
+/** A person a notification goes to: an id and the name messages show (R194). */
+export interface NotificationRecipient {
+    id: string;
+    displayName: string;
+}
+export interface NotificationPoolParams {
+    review: ReviewData;
+    /** The step that reached the pool. */
+    stepId: string;
+    /** The notification time: exclusion expiry is evaluated at this instant (R118). */
+    now: Date;
+}
+export interface INotificationRecipientService {
+    /**
+     * The people a pool step is announced to (R183, R194): the members of the step's candidate
+     * teams, without the requester, without an active exclusion and only those who can read the
+     * target. Fails when the step is not in the review or routing fails.
+     */
+    listPool(params: NotificationPoolParams): Promise<Result<NotificationRecipient[], WorkflowPersistenceError | ReviewValidationError>>;
+    /**
+     * The e-mail data of users by id (R194). Ids with no user (an api-key requester, A67) are
+     * omitted. Runs the lookup without authorization, and only that. Users are returned as
+     * stored: no address filtering here, a transport decides what it can use (the e-mail
+     * transport filters addresses). A failed Result's message can embed addresses, so callers
+     * must not log `error.message`: only `error.code` and `error.name` (R196).
+     */
+    listUsers(ids: string[]): Promise<Result<NotificationTransport.User[], WorkflowPersistenceError>>;
+}
+/**
+ * Finds the people a notification goes to. Internal (D132): no permission check. A failed or
+ * throwing dependency is a failed Result; the caller logs it (R196) and still sends the
+ * websocket message.
+ */
+export declare const NotificationRecipientService: import("@webiny/di").Abstraction<INotificationRecipientService>;
+export declare namespace NotificationRecipientService {
+    type Interface = INotificationRecipientService;
+    type Recipient = NotificationRecipient;
+    type PoolParams = NotificationPoolParams;
+    type Error = WorkflowPersistenceError;
+    type PoolReturn = Promise<Result<NotificationRecipient[], WorkflowPersistenceError | ReviewValidationError>>;
+    type UsersReturn = Promise<Result<NotificationTransport.User[], WorkflowPersistenceError>>;
+}

package/features/notifications/NotificationRecipientService/abstractions.js

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

package/features/notifications/NotificationRecipientService/abstractions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/notifications/NotificationRecipientService/abstractions.js","sources":["../../../../src/features/notifications/NotificationRecipientService/abstractions.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/api\";\nimport type { Result } from \"@webiny/feature/api\";\nimport type { ReviewData } from \"~/domain/review/types.js\";\nimport type { WorkflowPersistenceError } from \"~/domain/workflow/errors.js\";\nimport type { ReviewValidationError } from \"~/domain/review/errors.js\";\nimport type { NotificationTransport } from \"~/features/notifications/NotificationTransport/abstractions.js\";\n\n/** A person a notification goes to: an id and the name messages show (R194). */\nexport interface NotificationRecipient {\n    id: string;\n    displayName: string;\n}\n\nexport interface NotificationPoolParams {\n    review: ReviewData;\n    /** The step that reached the pool. */\n    stepId: string;\n    /** The notification time: exclusion expiry is evaluated at this instant (R118). */\n    now: Date;\n}\n\nexport interface INotificationRecipientService {\n    /**\n     * The people a pool step is announced to (R183, R194): the members of the step's candidate\n     * teams, without the requester, without an active exclusion and only those who can read the\n     * target. Fails when the step is not in the review or routing fails.\n     */\n    listPool(\n        params: NotificationPoolParams\n    ): Promise<Result<NotificationRecipient[], WorkflowPersistenceError | ReviewValidationError>>;\n    /**\n     * The e-mail data of users by id (R194). Ids with no user (an api-key requester, A67) are\n     * omitted. Runs the lookup without authorization, and only that. Users are returned as\n     * stored: no address filtering here, a transport decides what it can use (the e-mail\n     * transport filters addresses). A failed Result's message can embed addresses, so callers\n     * must not log `error.message`: only `error.code` and `error.name` (R196).\n     */\n    listUsers(\n        ids: string[]\n    ): Promise<Result<NotificationTransport.User[], WorkflowPersistenceError>>;\n}\n\n/**\n * Finds the people a notification goes to. Internal (D132): no permission check. A failed or\n * throwing dependency is a failed Result; the caller logs it (R196) and still sends the\n * websocket message.\n */\nexport const NotificationRecipientService = createAbstraction<INotificationRecipientService>(\n    \"NotificationRecipientService\"\n);\n\nexport namespace NotificationRecipientService {\n    export type Interface = INotificationRecipientService;\n    export type Recipient = NotificationRecipient;\n    export type PoolParams = NotificationPoolParams;\n    export type Error = WorkflowPersistenceError;\n    export type PoolReturn = Promise<\n        Result<NotificationRecipient[], WorkflowPersistenceError | ReviewValidationError>\n    >;\n    export type UsersReturn = Promise<\n        Result<NotificationTransport.User[], WorkflowPersistenceError>\n    >;\n}\n"],"names":["NotificationRecipientService","createAbstraction"],"mappings":";AA+CO,MAAMA,+BAA+BC,kBACxC"}

package/features/notifications/NotificationRecipientService/feature.d.ts

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

package/features/notifications/NotificationRecipientService/feature.js

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

package/features/notifications/NotificationRecipientService/feature.js.map

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

package/features/notifications/NotificationRecipientService/index.d.ts

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

package/features/notifications/NotificationRecipientService/index.js

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

package/features/notifications/NotificationTransport/MailNotificationTransport.d.ts

@@ -1,10 +1,13 @@
-import { MailerService } from "@webiny/api-mailer";
+import { SendMailUseCase } from "@webiny/api-mailer/features/SendMail/index.js";
+import { Logger } from "@webiny/api-core/features/logger/index.js";
 import { NotificationTransport } from "./abstractions.js";
 declare class MailNotificationTransportImpl implements NotificationTransport.Interface {
+    private sendMail;
+    private logger;
     readonly id = "e-mail";
-    readonly title = "E-Mail";
-    private readonly mailer;
-    constructor(mailer: MailerService.Interface);
+    readonly title = "E-mail";
+    readonly description = "Sends an e-mail to the people who need to act.";
+    constructor(sendMail: SendMailUseCase.Interface, logger: Logger.Interface);
     send(params: NotificationTransport.SendParams): Promise<void>;
 }
 export declare const MailNotificationTransport: typeof MailNotificationTransportImpl & {

package/features/notifications/NotificationTransport/MailNotificationTransport.js

@@ -1,47 +1,68 @@
-import { MailerService } from "@webiny/api-mailer";
+import { SendMailUseCase } from "@webiny/api-mailer/features/SendMail/index.js";
+import { Logger } from "@webiny/api-core/features/logger/index.js";
+import { MAIL_BCC_CHUNK_SIZE } from "../shared/constants.js";
+import { getErrorLogFields } from "../shared/getErrorLogFields.js";
+import { escapeHtml } from "../shared/escapeHtml.js";
+import { toSingleLine } from "../../../domain/notifications/toSingleLine.js";
 import { NotificationTransport } from "./abstractions.js";
+const PLAIN_ADDRESS = /^[^@\s,;<>]+@[^@\s,;<>]+$/;
+const SEND_FAILURE_LOG = "Could not send a workflow notification e-mail.";
 class MailNotificationTransportImpl {
-  id = "e-mail";
-  title = "E-Mail";
-  constructor(mailer) {
-    this.mailer = mailer;
-  }
-  async send(params) {
-    const {
-      users,
-      message
-    } = params;
-    const bcc = users.map(user => {
-      if (!user.displayName) {
-        return user.email;
-      }
-      return `"${user.displayName}" <${user.email}>`;
-    })
-    /**
-     * Just in case...
-     */.filter(user => !!user);
-    if (bcc.length === 0) {
-      return;
+    constructor(sendMail, logger){
+        this.sendMail = sendMail;
+        this.logger = logger;
+        this.id = "e-mail";
+        this.title = "E-mail";
+        this.description = "Sends an e-mail to the people who need to act.";
     }
-    const result = await this.mailer.sendMail({
-      bcc,
-      subject: message.title,
-      text: message.body,
-      html: `<p>${message.body.replace(/\n/g, "<br/>")}</p>`
-    });
-    if (result.isOk()) {
-      return;
+    async send(params) {
+        const { users, message } = params;
+        const seen = new Set();
+        const recipients = users.filter((user)=>{
+            if ("string" != typeof user.email || !PLAIN_ADDRESS.test(user.email)) return false;
+            if (seen.has(user.email)) return false;
+            seen.add(user.email);
+            return true;
+        });
+        if (0 === recipients.length) return;
+        const subject = toSingleLine(message.title);
+        let text = message.body;
+        let html = `<p>${escapeHtml(message.body).replace(/\n/g, "<br/>")}</p>`;
+        if (null !== message.url) {
+            text = `${message.body}\n\n${message.linkLabel}: ${message.url}`;
+            html += `<p><a href="${escapeHtml(message.url)}">${escapeHtml(message.linkLabel)}</a></p>`;
+        }
+        for(let start = 0; start < recipients.length; start += MAIL_BCC_CHUNK_SIZE){
+            const chunk = recipients.slice(start, start + MAIL_BCC_CHUNK_SIZE);
+            const bcc = chunk.map((user)=>user.email);
+            const userIds = chunk.map((user)=>user.id);
+            try {
+                const result = await this.sendMail.execute({
+                    bcc,
+                    subject,
+                    text,
+                    html
+                });
+                if (result.isFail()) this.logger.error({
+                    ...getErrorLogFields(result.error),
+                    userIds
+                }, SEND_FAILURE_LOG);
+            } catch (error) {
+                this.logger.error({
+                    ...getErrorLogFields(error),
+                    userIds
+                }, SEND_FAILURE_LOG);
+            }
+        }
     }
-    console.error({
-      message: "Failed to send e-mail notification.",
-      error: result.error,
-      users: users.map(u => u.email)
-    });
-  }
 }
-export const MailNotificationTransport = NotificationTransport.createImplementation({
-  implementation: MailNotificationTransportImpl,
-  dependencies: [MailerService]
+const MailNotificationTransport = NotificationTransport.createImplementation({
+    implementation: MailNotificationTransportImpl,
+    dependencies: [
+        SendMailUseCase,
+        Logger
+    ]
 });
+export { MailNotificationTransport };
 
 //# sourceMappingURL=MailNotificationTransport.js.map

package/features/notifications/NotificationTransport/MailNotificationTransport.js.map

@@ -1 +1 @@
-{"version":3,"names":["MailerService","NotificationTransport","MailNotificationTransportImpl","id","title","constructor","mailer","send","params","users","message","bcc","map","user","displayName","email","filter","length","result","sendMail","subject","text","body","html","replace","isOk","console","error","u","MailNotificationTransport","createImplementation","implementation","dependencies"],"sources":["MailNotificationTransport.ts"],"sourcesContent":["import { MailerService } from \"@webiny/api-mailer\";\nimport { NotificationTransport } from \"./abstractions.js\";\n\nclass MailNotificationTransportImpl implements NotificationTransport.Interface {\n    public readonly id = \"e-mail\";\n    public readonly title = \"E-Mail\";\n\n    private readonly mailer: MailerService.Interface;\n\n    public constructor(mailer: MailerService.Interface) {\n        this.mailer = mailer;\n    }\n\n    public async send(params: NotificationTransport.SendParams): Promise<void> {\n        const { users, message } = params;\n\n        const bcc = users\n            .map(user => {\n                if (!user.displayName) {\n                    return user.email;\n                }\n                return `\"${user.displayName}\" <${user.email}>`;\n            })\n            /**\n             * Just in case...\n             */\n            .filter(user => !!user);\n\n        if (bcc.length === 0) {\n            return;\n        }\n\n        const result = await this.mailer.sendMail({\n            bcc,\n            subject: message.title,\n            text: message.body,\n            html: `<p>${message.body.replace(/\\n/g, \"<br/>\")}</p>`\n        });\n        if (result.isOk()) {\n            return;\n        }\n        console.error({\n            message: \"Failed to send e-mail notification.\",\n            error: result.error,\n            users: users.map(u => u.email)\n        });\n    }\n}\n\nexport const MailNotificationTransport = NotificationTransport.createImplementation({\n    implementation: MailNotificationTransportImpl,\n    dependencies: [MailerService]\n});\n"],"mappings":"AAAA,SAASA,aAAa,QAAQ,oBAAoB;AAClD,SAASC,qBAAqB;AAE9B,MAAMC,6BAA6B,CAA4C;EAC3DC,EAAE,GAAG,QAAQ;EACbC,KAAK,GAAG,QAAQ;EAIzBC,WAAWA,CAACC,MAA+B,EAAE;IAChD,IAAI,CAACA,MAAM,GAAGA,MAAM;EACxB;EAEA,MAAaC,IAAIA,CAACC,MAAwC,EAAiB;IACvE,MAAM;MAAEC,KAAK;MAAEC;IAAQ,CAAC,GAAGF,MAAM;IAEjC,MAAMG,GAAG,GAAGF,KAAK,CACZG,GAAG,CAACC,IAAI,IAAI;MACT,IAAI,CAACA,IAAI,CAACC,WAAW,EAAE;QACnB,OAAOD,IAAI,CAACE,KAAK;MACrB;MACA,OAAO,IAAIF,IAAI,CAACC,WAAW,MAAMD,IAAI,CAACE,KAAK,GAAG;IAClD,CAAC;IACD;AACZ;AACA,OAFY,CAGCC,MAAM,CAACH,IAAI,IAAI,CAAC,CAACA,IAAI,CAAC;IAE3B,IAAIF,GAAG,CAACM,MAAM,KAAK,CAAC,EAAE;MAClB;IACJ;IAEA,MAAMC,MAAM,GAAG,MAAM,IAAI,CAACZ,MAAM,CAACa,QAAQ,CAAC;MACtCR,GAAG;MACHS,OAAO,EAAEV,OAAO,CAACN,KAAK;MACtBiB,IAAI,EAAEX,OAAO,CAACY,IAAI;MAClBC,IAAI,EAAE,MAAMb,OAAO,CAACY,IAAI,CAACE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC;IACpD,CAAC,CAAC;IACF,IAAIN,MAAM,CAACO,IAAI,CAAC,CAAC,EAAE;MACf;IACJ;IACAC,OAAO,CAACC,KAAK,CAAC;MACVjB,OAAO,EAAE,qCAAqC;MAC9CiB,KAAK,EAAET,MAAM,CAACS,KAAK;MACnBlB,KAAK,EAAEA,KAAK,CAACG,GAAG,CAACgB,CAAC,IAAIA,CAAC,CAACb,KAAK;IACjC,CAAC,CAAC;EACN;AACJ;AAEA,OAAO,MAAMc,yBAAyB,GAAG5B,qBAAqB,CAAC6B,oBAAoB,CAAC;EAChFC,cAAc,EAAE7B,6BAA6B;EAC7C8B,YAAY,EAAE,CAAChC,aAAa;AAChC,CAAC,CAAC","ignoreList":[]}
+{"version":3,"file":"features/notifications/NotificationTransport/MailNotificationTransport.js","sources":["../../../../src/features/notifications/NotificationTransport/MailNotificationTransport.ts"],"sourcesContent":["import { SendMailUseCase } from \"@webiny/api-mailer/features/SendMail/index.js\";\nimport { Logger } from \"@webiny/api-core/features/logger/index.js\";\nimport { MAIL_BCC_CHUNK_SIZE } from \"~/features/notifications/shared/constants.js\";\nimport { getErrorLogFields } from \"~/features/notifications/shared/getErrorLogFields.js\";\nimport { escapeHtml } from \"~/features/notifications/shared/escapeHtml.js\";\nimport { toSingleLine } from \"~/domain/notifications/toSingleLine.js\";\nimport { NotificationTransport } from \"./abstractions.js\";\n\n/** Exactly one \"@\" with text on both sides; no whitespace, comma, semicolon or angle bracket. */\nconst PLAIN_ADDRESS = /^[^@\\s,;<>]+@[^@\\s,;<>]+$/;\n\nconst SEND_FAILURE_LOG = \"Could not send a workflow notification e-mail.\";\n\nclass MailNotificationTransportImpl implements NotificationTransport.Interface {\n    public readonly id = \"e-mail\";\n    public readonly title = \"E-mail\";\n    public readonly description = \"Sends an e-mail to the people who need to act.\";\n\n    public constructor(\n        private sendMail: SendMailUseCase.Interface,\n        private logger: Logger.Interface\n    ) {}\n\n    public async send(params: NotificationTransport.SendParams): Promise<void> {\n        const { users, message } = params;\n\n        // An external IdP user can have its identity id as `email`; only plain addresses get\n        // mail: exactly one \"@\" with text on both sides, no whitespace, comma, semicolon or angle\n        // bracket. An address used by several users is sent once.\n        const seen = new Set<string>();\n        const recipients = users.filter(user => {\n            if (typeof user.email !== \"string\" || !PLAIN_ADDRESS.test(user.email)) {\n                return false;\n            }\n            if (seen.has(user.email)) {\n                return false;\n            }\n            seen.add(user.email);\n            return true;\n        });\n        if (recipients.length === 0) {\n            return;\n        }\n\n        const subject = toSingleLine(message.title);\n        let text = message.body;\n        let html = `<p>${escapeHtml(message.body).replace(/\\n/g, \"<br/>\")}</p>`;\n        if (message.url !== null) {\n            text = `${message.body}\\n\\n${message.linkLabel}: ${message.url}`;\n            html += `<p><a href=\"${escapeHtml(message.url)}\">${escapeHtml(message.linkLabel)}</a></p>`;\n        }\n\n        for (let start = 0; start < recipients.length; start += MAIL_BCC_CHUNK_SIZE) {\n            const chunk = recipients.slice(start, start + MAIL_BCC_CHUNK_SIZE);\n            // Bare addresses only: no display name, so no quoting or header injection (R193).\n            const bcc = chunk.map(user => user.email);\n            const userIds = chunk.map(user => user.id);\n            try {\n                // oxlint-disable-next-line no-await-in-loop -- one mail per BCC chunk.\n                const result = await this.sendMail.execute({ bcc, subject, text, html });\n                if (result.isFail()) {\n                    this.logger.error(\n                        {\n                            ...getErrorLogFields(result.error),\n                            userIds\n                        },\n                        SEND_FAILURE_LOG\n                    );\n                }\n            } catch (error) {\n                this.logger.error(\n                    {\n                        ...getErrorLogFields(error),\n                        userIds\n                    },\n                    SEND_FAILURE_LOG\n                );\n            }\n        }\n    }\n}\n\nexport const MailNotificationTransport = NotificationTransport.createImplementation({\n    implementation: MailNotificationTransportImpl,\n    dependencies: [SendMailUseCase, Logger]\n});\n"],"names":["PLAIN_ADDRESS","SEND_FAILURE_LOG","MailNotificationTransportImpl","sendMail","logger","params","users","message","seen","Set","recipients","user","subject","toSingleLine","text","html","escapeHtml","start","MAIL_BCC_CHUNK_SIZE","chunk","bcc","userIds","result","getErrorLogFields","error","MailNotificationTransport","NotificationTransport","SendMailUseCase","Logger"],"mappings":";;;;;;;AASA,MAAMA,gBAAgB;AAEtB,MAAMC,mBAAmB;AAEzB,MAAMC;IAKF,YACYC,QAAmC,EACnCC,MAAwB,CAClC;aAFUD,QAAQ,GAARA;aACAC,MAAM,GAANA;aANI,EAAE,GAAG;aACL,KAAK,GAAG;aACR,WAAW,GAAG;IAK3B;IAEH,MAAa,KAAKC,MAAwC,EAAiB;QACvE,MAAM,EAAEC,KAAK,EAAEC,OAAO,EAAE,GAAGF;QAK3B,MAAMG,OAAO,IAAIC;QACjB,MAAMC,aAAaJ,MAAM,MAAM,CAACK,CAAAA;YAC5B,IAAI,AAAsB,YAAtB,OAAOA,KAAK,KAAK,IAAiB,CAACX,cAAc,IAAI,CAACW,KAAK,KAAK,GAChE,OAAO;YAEX,IAAIH,KAAK,GAAG,CAACG,KAAK,KAAK,GACnB,OAAO;YAEXH,KAAK,GAAG,CAACG,KAAK,KAAK;YACnB,OAAO;QACX;QACA,IAAID,AAAsB,MAAtBA,WAAW,MAAM,EACjB;QAGJ,MAAME,UAAUC,aAAaN,QAAQ,KAAK;QAC1C,IAAIO,OAAOP,QAAQ,IAAI;QACvB,IAAIQ,OAAO,CAAC,GAAG,EAAEC,WAAWT,QAAQ,IAAI,EAAE,OAAO,CAAC,OAAO,SAAS,IAAI,CAAC;QACvE,IAAIA,AAAgB,SAAhBA,QAAQ,GAAG,EAAW;YACtBO,OAAO,GAAGP,QAAQ,IAAI,CAAC,IAAI,EAAEA,QAAQ,SAAS,CAAC,EAAE,EAAEA,QAAQ,GAAG,EAAE;YAChEQ,QAAQ,CAAC,YAAY,EAAEC,WAAWT,QAAQ,GAAG,EAAE,EAAE,EAAES,WAAWT,QAAQ,SAAS,EAAE,QAAQ,CAAC;QAC9F;QAEA,IAAK,IAAIU,QAAQ,GAAGA,QAAQP,WAAW,MAAM,EAAEO,SAASC,oBAAqB;YACzE,MAAMC,QAAQT,WAAW,KAAK,CAACO,OAAOA,QAAQC;YAE9C,MAAME,MAAMD,MAAM,GAAG,CAACR,CAAAA,OAAQA,KAAK,KAAK;YACxC,MAAMU,UAAUF,MAAM,GAAG,CAACR,CAAAA,OAAQA,KAAK,EAAE;YACzC,IAAI;gBAEA,MAAMW,SAAS,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAAEF;oBAAKR;oBAASE;oBAAMC;gBAAK;gBACtE,IAAIO,OAAO,MAAM,IACb,IAAI,CAAC,MAAM,CAAC,KAAK,CACb;oBACI,GAAGC,kBAAkBD,OAAO,KAAK,CAAC;oBAClCD;gBACJ,GACApB;YAGZ,EAAE,OAAOuB,OAAO;gBACZ,IAAI,CAAC,MAAM,CAAC,KAAK,CACb;oBACI,GAAGD,kBAAkBC,MAAM;oBAC3BH;gBACJ,GACApB;YAER;QACJ;IACJ;AACJ;AAEO,MAAMwB,4BAA4BC,sBAAsB,oBAAoB,CAAC;IAChF,gBAAgBxB;IAChB,cAAc;QAACyB;QAAiBC;KAAO;AAC3C"}

package/features/notifications/NotificationTransport/abstractions.d.ts

@@ -1,21 +1,40 @@
-import type { INotificationType, INotificationTypeMessage } from "../../../domain/notifications/abstractions.js";
 import type { NonEmptyArray } from "@webiny/api/types.js";
 export interface INotificationTransportUser {
     id: string;
     email: string;
     displayName: string;
 }
+/**
+ * What a transport sends. `title` is the subject line, `body` the plain text, `url` the link to
+ * the content (`null` when there is none) and `linkLabel` the text of that link (R190).
+ */
+export interface INotificationTransportMessage {
+    title: string;
+    body: string;
+    url: string | null;
+    linkLabel: string;
+}
 export interface INotificationTransportSendParams {
     users: NonEmptyArray<INotificationTransportUser>;
-    message: INotificationTypeMessage;
+    message: INotificationTransportMessage;
 }
 export interface INotificationTransport {
-    id: INotificationType["id"];
-    title: INotificationType["title"];
+    readonly id: string;
+    readonly title: string;
+    /** Shown next to the transport in the workflow editor (D129). */
+    readonly description?: string;
+    /**
+     * Never throws and never fails the notification (R190, R87): the review action that caused it
+     * has already been saved. A transport catches its own failures, logs each one once with
+     * `Logger.error` (never the error text of a mailer or provider, which can embed addresses)
+     * and returns.
+     */
     send(params: INotificationTransportSendParams): Promise<void>;
 }
 export declare const NotificationTransport: import("@webiny/di").Abstraction<INotificationTransport>;
 export declare namespace NotificationTransport {
     type Interface = INotificationTransport;
     type SendParams = INotificationTransportSendParams;
+    type User = INotificationTransportUser;
+    type Message = INotificationTransportMessage;
 }

package/features/notifications/NotificationTransport/abstractions.js

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

package/features/notifications/NotificationTransport/abstractions.js.map

@@ -1 +1 @@
-{"version":3,"names":["createAbstraction","NotificationTransport"],"sources":["abstractions.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/api\";\nimport type {\n    INotificationType,\n    INotificationTypeMessage\n} from \"~/domain/notifications/abstractions.js\";\nimport type { NonEmptyArray } from \"@webiny/api/types.js\";\n\nexport interface INotificationTransportUser {\n    id: string;\n    email: string;\n    displayName: string;\n}\n\nexport interface INotificationTransportSendParams {\n    users: NonEmptyArray<INotificationTransportUser>;\n    message: INotificationTypeMessage;\n}\n\nexport interface INotificationTransport {\n    id: INotificationType[\"id\"];\n    title: INotificationType[\"title\"];\n    send(params: INotificationTransportSendParams): Promise<void>;\n}\n\nexport const NotificationTransport = createAbstraction<INotificationTransport>(\n    \"WorkflowNotificationTransport\"\n);\n\nexport namespace NotificationTransport {\n    export type Interface = INotificationTransport;\n    export type SendParams = INotificationTransportSendParams;\n}\n"],"mappings":"AAAA,SAASA,iBAAiB,QAAQ,qBAAqB;AAwBvD,OAAO,MAAMC,qBAAqB,GAAGD,iBAAiB,CAClD,+BACJ,CAAC","ignoreList":[]}
+{"version":3,"file":"features/notifications/NotificationTransport/abstractions.js","sources":["../../../../src/features/notifications/NotificationTransport/abstractions.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/api\";\nimport type { NonEmptyArray } from \"@webiny/api/types.js\";\n\nexport interface INotificationTransportUser {\n    id: string;\n    email: string;\n    displayName: string;\n}\n\n/**\n * What a transport sends. `title` is the subject line, `body` the plain text, `url` the link to\n * the content (`null` when there is none) and `linkLabel` the text of that link (R190).\n */\nexport interface INotificationTransportMessage {\n    title: string;\n    body: string;\n    url: string | null;\n    linkLabel: string;\n}\n\nexport interface INotificationTransportSendParams {\n    users: NonEmptyArray<INotificationTransportUser>;\n    message: INotificationTransportMessage;\n}\n\nexport interface INotificationTransport {\n    readonly id: string;\n    readonly title: string;\n    /** Shown next to the transport in the workflow editor (D129). */\n    readonly description?: string;\n    /**\n     * Never throws and never fails the notification (R190, R87): the review action that caused it\n     * has already been saved. A transport catches its own failures, logs each one once with\n     * `Logger.error` (never the error text of a mailer or provider, which can embed addresses)\n     * and returns.\n     */\n    send(params: INotificationTransportSendParams): Promise<void>;\n}\n\nexport const NotificationTransport = createAbstraction<INotificationTransport>(\n    \"WorkflowNotificationTransport\"\n);\n\nexport namespace NotificationTransport {\n    export type Interface = INotificationTransport;\n    export type SendParams = INotificationTransportSendParams;\n    export type User = INotificationTransportUser;\n    export type Message = INotificationTransportMessage;\n}\n"],"names":["NotificationTransport","createAbstraction"],"mappings":";AAuCO,MAAMA,wBAAwBC,kBACjC"}

package/features/notifications/NotificationTransport/feature.d.ts

@@ -1 +1,4 @@
-export declare const NotificationTransportFeature: import("@webiny/feature/api/createFeature.js").FeatureDefinition<unknown>;
+export declare const NotificationTransportFeature: {
+    name: string;
+    register(container: import("@webiny/di").Container): void;
+};