@backstage/plugin-notifications-backend-module-email 0.0.0-nightly-20240426021211

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# @backstage/plugin-notifications-backend-module-email
+
+## 0.0.0-nightly-20240426021211
+
+### Patch Changes
+
+- dbf2696: Allow sending notifications by email with the new notifications module
+- Updated dependencies
+  - @backstage/catalog-model@0.0.0-nightly-20240426021211
+  - @backstage/plugin-notifications-node@0.0.0-nightly-20240426021211
+  - @backstage/backend-common@0.0.0-nightly-20240426021211
+  - @backstage/backend-plugin-api@0.0.0-nightly-20240426021211
+  - @backstage/catalog-client@0.0.0-nightly-20240426021211
+  - @backstage/config@1.2.0
+  - @backstage/integration-aws-node@0.1.12
+  - @backstage/types@1.1.1
+  - @backstage/plugin-notifications-common@0.0.3

package/README.md

@@ -0,0 +1,72 @@
+# @backstage/plugin-notifications-backend-module-email
+
+Adds support for sending Backstage notifications as emails to users.
+
+Supports sending emails using `SMTP`, `SES`, or `sendmail`.
+
+## Customizing email content
+
+The email content can be customized with the `notificationsEmailTemplateExtensionPoint`. When you create
+this extension, you can set the custom `NotificationTemplateRenderer` to the module. To modify the contents,
+override the `getSubject`, `getHtml` and `getText` methods.
+
+```ts
+import { notificationsEmailTemplateExtensionPoint } from '@backstage/plugin-notifications-backend-module-email';
+import { Notification } from '@backstage/plugin-notifications-common';
+
+export const notificationsModuleEmailDecorator = createBackendModule({
+  pluginId: 'notifications',
+  moduleId: 'email.templates',
+  register(reg) {
+    reg.registerInit({
+      deps: {
+        emailTemplates: notificationsEmailTemplateExtensionPoint,
+      },
+      async init({ emailTemplates }) {
+        emailTemplates.setTemplateRenderer({
+          getSubject(notification) {
+            return `New notification from ${notification.source}`;
+          },
+          getText(notification) {
+            return notification.content;
+          },
+          getHtml(notification) {
+            return `<p>${notification.content}</p>`;
+          },
+        });
+      },
+    });
+  },
+});
+```
+
+## Example configuration:
+
+```yaml
+notifications:
+  processors:
+    email:
+      # Transport config, see options at `config.d.ts`
+      transportConfig:
+        transport: 'smtp'
+        hostname: 'my-smtp-server'
+        port: 587
+        secure: false
+        username: 'my-username'
+        password: 'my-password'
+      # The email sender address
+      sender: 'sender@mycompany.com'
+      replyTo: 'no-reply@mycompany.com'
+      # Who to get email for broadcast notifications
+      broadcastConfig:
+        receiver: 'users'
+      # How many emails to send concurrently, defaults to 2
+      concurrencyLimit: 10
+      # Cache configuration for email addresses
+      # This is to prevent unnecessary calls to the catalog
+      cache:
+        ttl:
+          days: 1
+```
+
+See `config.d.ts` for more options for configuration.

package/config.d.ts

@@ -0,0 +1,123 @@
+/*
+ * Copyright 2024 The Backstage Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { HumanDuration } from '@backstage/types';
+
+export interface Config {
+  /**
+   * Configuration options for notifications-backend-module-email */
+  notifications: {
+    processors: {
+      email: {
+        /**
+         * Transport to use for sending emails */
+        transportConfig:
+          | {
+              transport: 'smtp';
+              /**
+               * SMTP server hostname
+               */
+              hostname: string;
+              /**
+               * SMTP server port
+               */
+              port: number;
+              /**
+               * Use secure connection for SMTP, defaults to false
+               */
+              secure?: boolean;
+              /**
+               * Require TLS for SMTP connection, defaults to false
+               */
+              requireTls?: boolean;
+              /**
+               * SMTP username
+               */
+              username?: string;
+              /**
+               * SMTP password
+               * @visibility secret
+               */
+              password?: string;
+            }
+          | {
+              transport: 'ses';
+              /**
+               * SES ApiVersion to use, defaults to 2010-12-01
+               */
+              apiVersion?: string;
+              /**
+               * AWS account ID to use
+               */
+              accountId?: string;
+              /**
+               * AWS region to use
+               */
+              region?: string;
+            }
+          | {
+              transport: 'sendmail';
+              /**
+               * Sendmail binary path, defaults to /usr/sbin/sendmail
+               */
+              path?: string;
+              /**
+               * Newline style, defaults to 'unix'
+               */
+              newline?: 'unix' | 'windows';
+            };
+        /**
+         * Sender email address
+         */
+        sender: string;
+        /**
+         * Optional reply-to address
+         */
+        replyTo?: string;
+        /**
+         * Concurrency limit for email sending, defaults to 2
+         */
+        concurrencyLimit?: number;
+        /**
+         * Throttle duration between email sending, defaults to 100ms
+         */
+        throttleInterval?: HumanDuration;
+        /**
+         * Configuration for broadcast notifications
+         */
+        broadcastConfig?: {
+          /**
+           * Receiver of the broadcast notifications:
+           * none - skips sending
+           * users - sends to all users in backstage, might have performance impact
+           * config - sends to the emails specified in the config
+           */
+          receiver: 'none' | 'users' | 'config';
+          /**
+           * Broadcast notification receivers when receiver is set to config
+           */
+          receiverEmails?: string[];
+        };
+        cache?: {
+          /**
+           * Email cache TTL, defaults to 1 hour
+           */
+          ttl?: HumanDuration;
+        };
+      };
+    };
+  };
+}

package/dist/index.cjs.js

@@ -0,0 +1,309 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var backendPluginApi = require('@backstage/backend-plugin-api');
+var catalogClient = require('@backstage/catalog-client');
+var pluginNotificationsNode = require('@backstage/plugin-notifications-node');
+var config = require('@backstage/config');
+var types = require('@backstage/types');
+var nodemailer = require('nodemailer');
+var clientSes = require('@aws-sdk/client-ses');
+var lodash = require('lodash');
+var integrationAwsNode = require('@backstage/integration-aws-node');
+var pThrottle = require('p-throttle');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
+
+var pThrottle__default = /*#__PURE__*/_interopDefaultCompat(pThrottle);
+
+const createSmtpTransport = (config) => {
+  var _a, _b;
+  const username = config.getOptionalString("username");
+  const password = config.getOptionalString("password");
+  return nodemailer.createTransport({
+    host: config.getString("hostname"),
+    port: config.getNumber("port"),
+    secure: (_a = config.getOptionalBoolean("secure")) != null ? _a : false,
+    requireTLS: (_b = config.getOptionalBoolean("requireTls")) != null ? _b : false,
+    auth: username && password ? { user: username, pass: password } : void 0
+  });
+};
+
+const createSesTransport = async (config, credentialsManager) => {
+  var _a;
+  const credentials = await credentialsManager.getCredentialProvider({
+    accountId: config.getOptionalString("accountId")
+  });
+  const ses = new clientSes.SES([
+    {
+      apiVersion: (_a = config.getOptionalString("apiVersion")) != null ? _a : "2010-12-01",
+      credentials: credentials.sdkCredentialProvider,
+      region: config.getOptionalString("region")
+    }
+  ]);
+  return nodemailer.createTransport({
+    SES: { ses, aws: { SendRawEmailCommand: clientSes.SendRawEmailCommand } }
+  });
+};
+
+const createSendmailTransport = (config) => {
+  var _a, _b;
+  return nodemailer.createTransport({
+    sendmail: true,
+    newline: (_a = config.getOptionalString("newline")) != null ? _a : "unix",
+    path: (_b = config.getOptionalString("path")) != null ? _b : "/usr/sbin/sendmail"
+  });
+};
+
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+class NotificationsEmailProcessor {
+  constructor(logger, config$1, catalog, auth, cache, templateRenderer) {
+    this.logger = logger;
+    this.config = config$1;
+    this.catalog = catalog;
+    this.auth = auth;
+    this.cache = cache;
+    this.templateRenderer = templateRenderer;
+    __publicField(this, "transporter");
+    __publicField(this, "broadcastConfig");
+    __publicField(this, "transportConfig");
+    __publicField(this, "sender");
+    __publicField(this, "replyTo");
+    __publicField(this, "cacheTtl");
+    __publicField(this, "concurrencyLimit");
+    __publicField(this, "throttleInterval");
+    var _a;
+    const emailProcessorConfig = config$1.getConfig(
+      "notifications.processors.email"
+    );
+    this.transportConfig = emailProcessorConfig.getConfig("transport");
+    this.broadcastConfig = emailProcessorConfig.getOptionalConfig("broadcastConfig");
+    this.sender = emailProcessorConfig.getString("sender");
+    this.replyTo = emailProcessorConfig.getOptionalString("replyTo");
+    this.concurrencyLimit = (_a = emailProcessorConfig.getOptionalNumber("concurrencyLimit")) != null ? _a : 2;
+    const throttleConfig = emailProcessorConfig.getOptionalConfig("throttleInterval");
+    this.throttleInterval = throttleConfig ? types.durationToMilliseconds(config.readDurationFromConfig(throttleConfig)) : 100;
+    const cacheConfig = emailProcessorConfig.getOptionalConfig("cache.ttl");
+    this.cacheTtl = cacheConfig ? types.durationToMilliseconds(config.readDurationFromConfig(cacheConfig)) : 36e5;
+  }
+  async getTransporter() {
+    if (this.transporter) {
+      return this.transporter;
+    }
+    const transport = this.transportConfig.getString("transport");
+    if (transport === "smtp") {
+      this.transporter = createSmtpTransport(this.transportConfig);
+    } else if (transport === "ses") {
+      const awsCredentialsManager = integrationAwsNode.DefaultAwsCredentialsManager.fromConfig(
+        this.config
+      );
+      this.transporter = await createSesTransport(
+        this.transportConfig,
+        awsCredentialsManager
+      );
+    } else if (transport === "sendmail") {
+      this.transporter = createSendmailTransport(this.transportConfig);
+    } else {
+      throw new Error(`Unsupported transport: ${transport}`);
+    }
+    return this.transporter;
+  }
+  getName() {
+    return "Email";
+  }
+  async getBroadcastEmails() {
+    var _a, _b, _c;
+    if (!this.broadcastConfig) {
+      return [];
+    }
+    const receiver = this.broadcastConfig.getString("receiver");
+    if (receiver === "none") {
+      return [];
+    }
+    if (receiver === "config") {
+      return (_a = this.broadcastConfig.getOptionalStringArray("receiverEmails")) != null ? _a : [];
+    }
+    if (receiver === "users") {
+      const cached = await ((_b = this.cache) == null ? void 0 : _b.get("user-emails:all"));
+      if (cached) {
+        return cached;
+      }
+      const { token } = await this.auth.getPluginRequestToken({
+        onBehalfOf: await this.auth.getOwnServiceCredentials(),
+        targetPluginId: "catalog"
+      });
+      const entities = await this.catalog.getEntities(
+        {
+          filter: [
+            { kind: "user", "spec.profile.email": catalogClient.CATALOG_FILTER_EXISTS }
+          ],
+          fields: ["spec.profile.email"]
+        },
+        { token }
+      );
+      const ret = lodash.compact([
+        ...new Set(
+          entities.items.map((entity) => {
+            var _a2;
+            return (_a2 = entity == null ? void 0 : entity.spec.profile) == null ? void 0 : _a2.email;
+          })
+        )
+      ]);
+      await ((_c = this.cache) == null ? void 0 : _c.set("user-emails:all", ret, {
+        ttl: this.cacheTtl
+      }));
+      return ret;
+    }
+    throw new Error(`Unsupported broadcast receiver: ${receiver}`);
+  }
+  async getUserEmail(entityRef) {
+    var _a, _b, _c;
+    const cached = await ((_a = this.cache) == null ? void 0 : _a.get(`user-emails:${entityRef}`));
+    if (cached) {
+      return cached;
+    }
+    const { token } = await this.auth.getPluginRequestToken({
+      onBehalfOf: await this.auth.getOwnServiceCredentials(),
+      targetPluginId: "catalog"
+    });
+    const entity = await this.catalog.getEntityByRef(entityRef, { token });
+    const ret = [];
+    if (entity) {
+      const userEntity = entity;
+      if ((_b = userEntity.spec.profile) == null ? void 0 : _b.email) {
+        ret.push(userEntity.spec.profile.email);
+      }
+    }
+    await ((_c = this.cache) == null ? void 0 : _c.set(`user-emails:${entityRef}`, ret, {
+      ttl: this.cacheTtl
+    }));
+    return ret;
+  }
+  async getRecipientEmails(notification, options) {
+    if (options.recipients.type === "broadcast" || notification.user === null) {
+      return await this.getBroadcastEmails();
+    }
+    return await this.getUserEmail(notification.user);
+  }
+  async sendMail(options) {
+    try {
+      await this.transporter.sendMail(options);
+    } catch (e) {
+      this.logger.error(`Failed to send email to ${options.to}: ${e}`);
+    }
+  }
+  async sendMails(options, emails) {
+    const throttle = pThrottle__default.default({
+      limit: this.concurrencyLimit,
+      interval: this.throttleInterval
+    });
+    const throttled = throttle((opts) => this.sendMail(opts));
+    await Promise.all(
+      emails.map((email) => throttled({ ...options, to: email }))
+    );
+  }
+  async sendPlainEmail(notification, emails) {
+    const contentParts = [];
+    if (notification.payload.description) {
+      contentParts.push(`${notification.payload.description}`);
+    }
+    if (notification.payload.link) {
+      contentParts.push(`${notification.payload.link}`);
+    }
+    const mailOptions = {
+      from: this.sender,
+      subject: notification.payload.title,
+      html: `<p>${contentParts.join("<br/>")}</p>`,
+      text: contentParts.join("\n\n"),
+      replyTo: this.replyTo
+    };
+    await this.sendMails(mailOptions, emails);
+  }
+  async sendTemplateEmail(notification, emails) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    const mailOptions = {
+      from: this.sender,
+      subject: (_c = (_b = (_a = this.templateRenderer) == null ? void 0 : _a.getSubject) == null ? void 0 : _b.call(_a, notification)) != null ? _c : notification.payload.title,
+      html: (_e = (_d = this.templateRenderer) == null ? void 0 : _d.getHtml) == null ? void 0 : _e.call(_d, notification),
+      text: (_g = (_f = this.templateRenderer) == null ? void 0 : _f.getText) == null ? void 0 : _g.call(_f, notification),
+      replyTo: this.replyTo
+    };
+    await this.sendMails(mailOptions, emails);
+  }
+  async postProcess(notification, options) {
+    this.transporter = await this.getTransporter();
+    let emails = [];
+    try {
+      emails = await this.getRecipientEmails(notification, options);
+    } catch (e) {
+      this.logger.error(`Failed to resolve recipient emails: ${e}`);
+      return;
+    }
+    if (emails.length === 0) {
+      this.logger.info(
+        `No email recipients found for notification: ${notification.id}, skipping`
+      );
+      return;
+    }
+    if (!this.templateRenderer) {
+      await this.sendPlainEmail(notification, emails);
+      return;
+    }
+    await this.sendTemplateEmail(notification, emails);
+  }
+}
+
+const notificationsEmailTemplateExtensionPoint = backendPluginApi.createExtensionPoint({
+  id: "notifications.email.templates"
+});
+
+const notificationsModuleEmail = backendPluginApi.createBackendModule({
+  pluginId: "notifications",
+  moduleId: "email",
+  register(reg) {
+    let templateRenderer;
+    reg.registerExtensionPoint(notificationsEmailTemplateExtensionPoint, {
+      setTemplateRenderer(renderer) {
+        if (templateRenderer) {
+          throw new Error(`Email template renderer was already registered`);
+        }
+        templateRenderer = renderer;
+      }
+    });
+    reg.registerInit({
+      deps: {
+        config: backendPluginApi.coreServices.rootConfig,
+        notifications: pluginNotificationsNode.notificationsProcessingExtensionPoint,
+        discovery: backendPluginApi.coreServices.discovery,
+        logger: backendPluginApi.coreServices.logger,
+        auth: backendPluginApi.coreServices.auth,
+        cache: backendPluginApi.coreServices.cache
+      },
+      async init({ config, notifications, discovery, logger, auth, cache }) {
+        const catalogClient$1 = new catalogClient.CatalogClient({
+          discoveryApi: discovery
+        });
+        notifications.addProcessor(
+          new NotificationsEmailProcessor(
+            logger,
+            config,
+            catalogClient$1,
+            auth,
+            cache,
+            templateRenderer
+          )
+        );
+      }
+    });
+  }
+});
+
+exports.default = notificationsModuleEmail;
+exports.notificationsEmailTemplateExtensionPoint = notificationsEmailTemplateExtensionPoint;
+//# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":["../src/processor/transports/smtp.ts","../src/processor/transports/ses.ts","../src/processor/transports/sendmail.ts","../src/processor/NotificationsEmailProcessor.ts","../src/extensions.ts","../src/module.ts"],"sourcesContent":["/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { createTransport } from 'nodemailer';\nimport { Config } from '@backstage/config';\n\nexport const createSmtpTransport = (config: Config) => {\n  const username = config.getOptionalString('username');\n  const password = config.getOptionalString('password');\n\n  return createTransport({\n    host: config.getString('hostname'),\n    port: config.getNumber('port'),\n    secure: config.getOptionalBoolean('secure') ?? false,\n    requireTLS: config.getOptionalBoolean('requireTls') ?? false,\n    auth: username && password ? { user: username, pass: password } : undefined,\n  });\n};\n","/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { createTransport } from 'nodemailer';\nimport { SendRawEmailCommand, SES } from '@aws-sdk/client-ses';\nimport { Config } from '@backstage/config';\nimport { AwsCredentialsManager } from '@backstage/integration-aws-node';\n\nexport const createSesTransport = async (\n  config: Config,\n  credentialsManager: AwsCredentialsManager,\n) => {\n  const credentials = await credentialsManager.getCredentialProvider({\n    accountId: config.getOptionalString('accountId'),\n  });\n  const ses = new SES([\n    {\n      apiVersion: config.getOptionalString('apiVersion') ?? '2010-12-01',\n      credentials: credentials.sdkCredentialProvider,\n      region: config.getOptionalString('region'),\n    },\n  ]);\n  return createTransport({\n    SES: { ses, aws: { SendRawEmailCommand } },\n  });\n};\n","/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { createTransport } from 'nodemailer';\nimport { Config } from '@backstage/config';\n\nexport const createSendmailTransport = (config: Config) => {\n  return createTransport({\n    sendmail: true,\n    newline: config.getOptionalString('newline') ?? 'unix',\n    path: config.getOptionalString('path') ?? '/usr/sbin/sendmail',\n  });\n};\n","/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport {\n  NotificationProcessor,\n  NotificationSendOptions,\n} from '@backstage/plugin-notifications-node';\nimport {\n  AuthService,\n  CacheService,\n  LoggerService,\n} from '@backstage/backend-plugin-api';\nimport { Config, readDurationFromConfig } from '@backstage/config';\nimport { durationToMilliseconds } from '@backstage/types';\nimport {\n  CATALOG_FILTER_EXISTS,\n  CatalogClient,\n} from '@backstage/catalog-client';\nimport { Notification } from '@backstage/plugin-notifications-common';\nimport {\n  createSendmailTransport,\n  createSesTransport,\n  createSmtpTransport,\n} from './transports';\nimport { UserEntity } from '@backstage/catalog-model';\nimport { compact } from 'lodash';\nimport { DefaultAwsCredentialsManager } from '@backstage/integration-aws-node';\nimport { NotificationTemplateRenderer } from '../extensions';\nimport Mail from 'nodemailer/lib/mailer';\nimport pThrottle from 'p-throttle';\n\nexport class NotificationsEmailProcessor implements NotificationProcessor {\n  private transporter: any;\n  private readonly broadcastConfig?: Config;\n  private readonly transportConfig: Config;\n  private readonly sender: string;\n  private readonly replyTo?: string;\n  private readonly cacheTtl: number;\n  private readonly concurrencyLimit: number;\n  private readonly throttleInterval: number;\n\n  constructor(\n    private readonly logger: LoggerService,\n    private readonly config: Config,\n    private readonly catalog: CatalogClient,\n    private readonly auth: AuthService,\n    private readonly cache?: CacheService,\n    private readonly templateRenderer?: NotificationTemplateRenderer,\n  ) {\n    const emailProcessorConfig = config.getConfig(\n      'notifications.processors.email',\n    );\n    this.transportConfig = emailProcessorConfig.getConfig('transport');\n    this.broadcastConfig =\n      emailProcessorConfig.getOptionalConfig('broadcastConfig');\n    this.sender = emailProcessorConfig.getString('sender');\n    this.replyTo = emailProcessorConfig.getOptionalString('replyTo');\n    this.concurrencyLimit =\n      emailProcessorConfig.getOptionalNumber('concurrencyLimit') ?? 2;\n    const throttleConfig =\n      emailProcessorConfig.getOptionalConfig('throttleInterval');\n    this.throttleInterval = throttleConfig\n      ? durationToMilliseconds(readDurationFromConfig(throttleConfig))\n      : 100;\n    const cacheConfig = emailProcessorConfig.getOptionalConfig('cache.ttl');\n    this.cacheTtl = cacheConfig\n      ? durationToMilliseconds(readDurationFromConfig(cacheConfig))\n      : 3_600_000;\n  }\n\n  private async getTransporter() {\n    if (this.transporter) {\n      return this.transporter;\n    }\n    const transport = this.transportConfig.getString('transport');\n    if (transport === 'smtp') {\n      this.transporter = createSmtpTransport(this.transportConfig);\n    } else if (transport === 'ses') {\n      const awsCredentialsManager = DefaultAwsCredentialsManager.fromConfig(\n        this.config,\n      );\n      this.transporter = await createSesTransport(\n        this.transportConfig,\n        awsCredentialsManager,\n      );\n    } else if (transport === 'sendmail') {\n      this.transporter = createSendmailTransport(this.transportConfig);\n    } else {\n      throw new Error(`Unsupported transport: ${transport}`);\n    }\n    return this.transporter;\n  }\n\n  getName(): string {\n    return 'Email';\n  }\n\n  private async getBroadcastEmails(): Promise<string[]> {\n    if (!this.broadcastConfig) {\n      return [];\n    }\n\n    const receiver = this.broadcastConfig.getString('receiver');\n    if (receiver === 'none') {\n      return [];\n    }\n\n    if (receiver === 'config') {\n      return (\n        this.broadcastConfig.getOptionalStringArray('receiverEmails') ?? []\n      );\n    }\n\n    if (receiver === 'users') {\n      const cached = await this.cache?.get<string[]>('user-emails:all');\n      if (cached) {\n        return cached;\n      }\n\n      const { token } = await this.auth.getPluginRequestToken({\n        onBehalfOf: await this.auth.getOwnServiceCredentials(),\n        targetPluginId: 'catalog',\n      });\n      const entities = await this.catalog.getEntities(\n        {\n          filter: [\n            { kind: 'user', 'spec.profile.email': CATALOG_FILTER_EXISTS },\n          ],\n          fields: ['spec.profile.email'],\n        },\n        { token },\n      );\n      const ret = compact([\n        ...new Set(\n          entities.items.map(entity => {\n            return (entity as UserEntity)?.spec.profile?.email;\n          }),\n        ),\n      ]);\n\n      await this.cache?.set('user-emails:all', ret, {\n        ttl: this.cacheTtl,\n      });\n      return ret;\n    }\n\n    throw new Error(`Unsupported broadcast receiver: ${receiver}`);\n  }\n\n  private async getUserEmail(entityRef: string): Promise<string[]> {\n    const cached = await this.cache?.get<string[]>(`user-emails:${entityRef}`);\n    if (cached) {\n      return cached;\n    }\n\n    const { token } = await this.auth.getPluginRequestToken({\n      onBehalfOf: await this.auth.getOwnServiceCredentials(),\n      targetPluginId: 'catalog',\n    });\n    const entity = await this.catalog.getEntityByRef(entityRef, { token });\n    const ret: string[] = [];\n    if (entity) {\n      const userEntity = entity as UserEntity;\n      if (userEntity.spec.profile?.email) {\n        ret.push(userEntity.spec.profile.email);\n      }\n    }\n\n    await this.cache?.set(`user-emails:${entityRef}`, ret, {\n      ttl: this.cacheTtl,\n    });\n\n    return ret;\n  }\n\n  private async getRecipientEmails(\n    notification: Notification,\n    options: NotificationSendOptions,\n  ) {\n    if (options.recipients.type === 'broadcast' || notification.user === null) {\n      return await this.getBroadcastEmails();\n    }\n    return await this.getUserEmail(notification.user);\n  }\n\n  private async sendMail(options: Mail.Options) {\n    try {\n      await this.transporter.sendMail(options);\n    } catch (e) {\n      this.logger.error(`Failed to send email to ${options.to}: ${e}`);\n    }\n  }\n\n  private async sendMails(options: Mail.Options, emails: string[]) {\n    const throttle = pThrottle({\n      limit: this.concurrencyLimit,\n      interval: this.throttleInterval,\n    });\n\n    const throttled = throttle((opts: Mail.Options) => this.sendMail(opts));\n    await Promise.all(\n      emails.map(email => throttled({ ...options, to: email })),\n    );\n  }\n\n  private async sendPlainEmail(notification: Notification, emails: string[]) {\n    const contentParts: string[] = [];\n    if (notification.payload.description) {\n      contentParts.push(`${notification.payload.description}`);\n    }\n    if (notification.payload.link) {\n      contentParts.push(`${notification.payload.link}`);\n    }\n\n    const mailOptions = {\n      from: this.sender,\n      subject: notification.payload.title,\n      html: `<p>${contentParts.join('<br/>')}</p>`,\n      text: contentParts.join('\\n\\n'),\n      replyTo: this.replyTo,\n    };\n\n    await this.sendMails(mailOptions, emails);\n  }\n\n  private async sendTemplateEmail(\n    notification: Notification,\n    emails: string[],\n  ) {\n    const mailOptions = {\n      from: this.sender,\n      subject:\n        this.templateRenderer?.getSubject?.(notification) ??\n        notification.payload.title,\n      html: this.templateRenderer?.getHtml?.(notification),\n      text: this.templateRenderer?.getText?.(notification),\n      replyTo: this.replyTo,\n    };\n\n    await this.sendMails(mailOptions, emails);\n  }\n\n  async postProcess(\n    notification: Notification,\n    options: NotificationSendOptions,\n  ): Promise<void> {\n    this.transporter = await this.getTransporter();\n\n    let emails: string[] = [];\n    try {\n      emails = await this.getRecipientEmails(notification, options);\n    } catch (e) {\n      this.logger.error(`Failed to resolve recipient emails: ${e}`);\n      return;\n    }\n\n    if (emails.length === 0) {\n      this.logger.info(\n        `No email recipients found for notification: ${notification.id}, skipping`,\n      );\n      return;\n    }\n\n    if (!this.templateRenderer) {\n      await this.sendPlainEmail(notification, emails);\n      return;\n    }\n\n    await this.sendTemplateEmail(notification, emails);\n  }\n}\n","/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { createExtensionPoint } from '@backstage/backend-plugin-api';\nimport { Notification } from '@backstage/plugin-notifications-common';\n\n/**\n * @public\n */\nexport interface NotificationTemplateRenderer {\n  getSubject?(notification: Notification): string;\n  getText?(notification: Notification): string;\n  getHtml?(notification: Notification): string;\n}\n\n/**\n * @public\n */\nexport interface NotificationsEmailTemplateExtensionPoint {\n  setTemplateRenderer(renderer: NotificationTemplateRenderer): void;\n}\n\n/**\n * @public\n */\nexport const notificationsEmailTemplateExtensionPoint =\n  createExtensionPoint<NotificationsEmailTemplateExtensionPoint>({\n    id: 'notifications.email.templates',\n  });\n","/*\n * Copyright 2024 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport {\n  coreServices,\n  createBackendModule,\n} from '@backstage/backend-plugin-api';\nimport { CatalogClient } from '@backstage/catalog-client';\nimport { notificationsProcessingExtensionPoint } from '@backstage/plugin-notifications-node';\nimport { NotificationsEmailProcessor } from './processor';\nimport {\n  notificationsEmailTemplateExtensionPoint,\n  NotificationTemplateRenderer,\n} from './extensions';\n\n/**\n * @public\n */\nexport const notificationsModuleEmail = createBackendModule({\n  pluginId: 'notifications',\n  moduleId: 'email',\n  register(reg) {\n    let templateRenderer: NotificationTemplateRenderer | undefined;\n    reg.registerExtensionPoint(notificationsEmailTemplateExtensionPoint, {\n      setTemplateRenderer(renderer) {\n        if (templateRenderer) {\n          throw new Error(`Email template renderer was already registered`);\n        }\n        templateRenderer = renderer;\n      },\n    });\n\n    reg.registerInit({\n      deps: {\n        config: coreServices.rootConfig,\n        notifications: notificationsProcessingExtensionPoint,\n        discovery: coreServices.discovery,\n        logger: coreServices.logger,\n        auth: coreServices.auth,\n        cache: coreServices.cache,\n      },\n      async init({ config, notifications, discovery, logger, auth, cache }) {\n        const catalogClient = new CatalogClient({\n          discoveryApi: discovery,\n        });\n\n        notifications.addProcessor(\n          new NotificationsEmailProcessor(\n            logger,\n            config,\n            catalogClient,\n            auth,\n            cache,\n            templateRenderer,\n          ),\n        );\n      },\n    });\n  },\n});\n"],"names":["createTransport","SES","SendRawEmailCommand","config","durationToMilliseconds","readDurationFromConfig","DefaultAwsCredentialsManager","CATALOG_FILTER_EXISTS","compact","_a","pThrottle","createExtensionPoint","createBackendModule","coreServices","notificationsProcessingExtensionPoint","catalogClient","CatalogClient"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+import * as _backstage_backend_plugin_api from '@backstage/backend-plugin-api';
+import { Notification } from '@backstage/plugin-notifications-common';
+
+/**
+ * @public
+ */
+declare const notificationsModuleEmail: () => _backstage_backend_plugin_api.BackendFeature;
+
+/**
+ * @public
+ */
+interface NotificationTemplateRenderer {
+    getSubject?(notification: Notification): string;
+    getText?(notification: Notification): string;
+    getHtml?(notification: Notification): string;
+}
+/**
+ * @public
+ */
+interface NotificationsEmailTemplateExtensionPoint {
+    setTemplateRenderer(renderer: NotificationTemplateRenderer): void;
+}
+/**
+ * @public
+ */
+declare const notificationsEmailTemplateExtensionPoint: _backstage_backend_plugin_api.ExtensionPoint<NotificationsEmailTemplateExtensionPoint>;
+
+export { type NotificationTemplateRenderer, type NotificationsEmailTemplateExtensionPoint, notificationsModuleEmail as default, notificationsEmailTemplateExtensionPoint };

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@backstage/plugin-notifications-backend-module-email",
+  "version": "0.0.0-nightly-20240426021211",
+  "description": "The email backend module for the notifications plugin.",
+  "backstage": {
+    "role": "backend-plugin-module"
+  },
+  "publishConfig": {
+    "access": "public",
+    "main": "dist/index.cjs.js",
+    "types": "dist/index.d.ts"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/backstage/backstage",
+    "directory": "plugins/notifications-backend-module-email"
+  },
+  "license": "Apache-2.0",
+  "main": "dist/index.cjs.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "config.d.ts"
+  ],
+  "scripts": {
+    "build": "backstage-cli package build",
+    "clean": "backstage-cli package clean",
+    "lint": "backstage-cli package lint",
+    "prepack": "backstage-cli package prepack",
+    "postpack": "backstage-cli package postpack",
+    "start": "backstage-cli package start",
+    "test": "backstage-cli package test"
+  },
+  "dependencies": {
+    "@aws-sdk/client-ses": "^3.550.0",
+    "@aws-sdk/types": "^3.347.0",
+    "@backstage/backend-common": "^0.0.0-nightly-20240426021211",
+    "@backstage/backend-plugin-api": "^0.0.0-nightly-20240426021211",
+    "@backstage/catalog-client": "^0.0.0-nightly-20240426021211",
+    "@backstage/catalog-model": "^0.0.0-nightly-20240426021211",
+    "@backstage/config": "^1.2.0",
+    "@backstage/integration-aws-node": "^0.1.12",
+    "@backstage/plugin-notifications-common": "^0.0.3",
+    "@backstage/plugin-notifications-node": "^0.0.0-nightly-20240426021211",
+    "@backstage/types": "^1.1.1",
+    "lodash": "^4.17.21",
+    "nodemailer": "^6.9.13",
+    "p-throttle": "^6.1.0"
+  },
+  "devDependencies": {
+    "@backstage/backend-test-utils": "^0.0.0-nightly-20240426021211",
+    "@backstage/cli": "^0.0.0-nightly-20240426021211",
+    "@types/nodemailer": "^6.4.14"
+  },
+  "configSchema": "config.d.ts"
+}