@backstage/plugin-events-backend 0.0.0-nightly-20221115024001

package/CHANGELOG.md

@@ -0,0 +1,35 @@
+# @backstage/plugin-events-backend
+
+## 0.0.0-nightly-20221115024001
+
+### Minor Changes
+
+- dc9da28abd: Support events received via HTTP endpoints at plugin-events-backend.
+
+  The plugin provides an event publisher `HttpPostIngressEventPublisher`
+  which will allow you to receive events via
+  HTTP endpoints `POST /api/events/http/{topic}`
+  and will publish these to the used event broker.
+
+  Using a provided custom validator, you can participate in the decision
+  which events are accepted, e.g. by verifying the source of the request.
+
+  Please find more information at
+  https://github.com/backstage/backstage/tree/master/plugins/events-backend/README.md.
+
+- 7bbd2403a1: Adds a new backend plugin plugin-events-backend for managing events.
+
+  plugin-events-node exposes interfaces which can be used by modules.
+
+  plugin-events-backend-test-utils provides utilities which can be used while writing tests e.g. for modules.
+
+  Please find more information at
+  https://github.com/backstage/backstage/tree/master/plugins/events-backend/README.md.
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/backend-common@0.0.0-nightly-20221115024001
+  - @backstage/plugin-events-node@0.0.0-nightly-20221115024001
+  - @backstage/backend-plugin-api@0.0.0-nightly-20221115024001
+  - @backstage/config@0.0.0-nightly-20221115024001

package/README.md

@@ -0,0 +1,210 @@
+# events-backend
+
+Welcome to the events-backend backend plugin!
+
+This plugin provides the wiring of all extension points
+for managing events as defined by [plugin-events-node](../events-node)
+including backend plugin `EventsPlugin` and `EventsBackend`.
+
+Additionally, it uses a simple in-memory implementation for
+the `EventBroker` by default which you can replace with a more sophisticated
+implementation of your choice as you need (e.g., via module).
+
+Some of these (non-exhaustive) may provide added persistence,
+or use external systems like AWS EventBridge, AWS SNS, Kafka, etc.
+
+By default, the plugin ships with support to receive events via HTTP endpoints
+`POST /api/events/http/{topic}` and will publish these
+to the used event broker.
+
+## Installation
+
+```bash
+# From your Backstage root directory
+yarn add --cwd packages/backend @backstage/plugin-events-backend
+```
+
+Add a file [`packages/backend/src/plugins/events.ts`](../../packages/backend/src/plugins/events.ts)
+to your Backstage project.
+
+There, you can add all publishers, subscribers, etc. you want.
+
+Additionally, add the events plugin to your backend.
+
+```diff
+// packages/backend/src/index.ts
+// [...]
++import events from './plugins/events';
+// [...]
++  const eventsEnv = useHotMemoize(module, () => createEnv('events'));
+// [...]
++  apiRouter.use('/events', await events(eventsEnv, []));
+// [...]
+```
+
+### With Event-based Entity Providers
+
+In case you use event-based `EntityProviders`,
+you may need something like the following:
+
+```diff
+// packages/backend/src/index.ts
+-  apiRouter.use('/events', await events(eventsEnv, []));
++  apiRouter.use('/events', await events(eventsEnv, eventBasedEntityProviders));
+```
+
+as well as a file
+[`packages/backend/src/plugins/catalogEventBasedProviders.ts`](../../packages/backend/src/plugins/catalogEventBasedProviders.ts)
+which contains event-based entity providers.
+
+In case you don't have this dependency added yet:
+
+```bash
+# From your Backstage root directory
+yarn add --cwd packages/backend @backstage/plugin-events-backend
+```
+
+```diff
+// packages/backend/src/plugins/catalog.ts
+ import { CatalogBuilder } from '@backstage/plugin-catalog-backend';
++import { EntityProvider } from '@backstage/plugin-catalog-node';
+ import { ScaffolderEntitiesProcessor } from '@backstage/plugin-scaffolder-backend';
+ import { Router } from 'express';
+ import { PluginEnvironment } from '../types';
+
+ export default async function createPlugin(
+   env: PluginEnvironment,
++  providers?: Array<EntityProvider>,
+ ): Promise<Router> {
+   const builder = await CatalogBuilder.create(env);
+   builder.addProcessor(new ScaffolderEntitiesProcessor());
++  builder.addEntityProvider(providers ?? []);
+   const { processingEngine, router } = await builder.build();
+   await processingEngine.start();
+   return router;
+ }
+```
+
+## Configuration
+
+In order to create HTTP endpoints to receive events for a certain
+topic, you need to add them at your configuration:
+
+```yaml
+events:
+  http:
+    topics:
+      - bitbucketCloud
+      - github
+      - whatever
+```
+
+Only those topics added to the configuration will result in
+available endpoints.
+
+The example above would result in the following endpoints:
+
+```
+POST /api/events/http/bitbucketCloud
+POST /api/events/http/github
+POST /api/events/http/whatever
+```
+
+You may want to use these for webhooks by SCM providers
+in combination with suitable event subscribers.
+
+However, it is not limited to these use cases.
+
+## Use Cases
+
+### Custom Event Broker
+
+Example using the `EventsBackend`:
+
+```ts
+new EventsBackend(env.logger)
+  .setEventBroker(yourEventBroker)
+  // [...]
+  .start();
+```
+
+Example using a module:
+
+```ts
+import { eventsExtensionPoint } from '@backstage/plugin-events-node';
+
+// [...]
+
+export const yourModuleEventsModule = createBackendModule({
+  pluginId: 'events',
+  moduleId: 'yourModule',
+  register(env) {
+    // [...]
+    env.registerInit({
+      deps: {
+        // [...]
+        events: eventsExtensionPoint,
+        // [...]
+      },
+      async init({ /* ... */ events /*, ... */ }) {
+        // [...]
+        const yourEventBroker = new YourEventBroker();
+        // [...]
+        events.setEventBroker(yourEventBroker);
+      },
+    });
+  },
+});
+```
+
+### Request Validator
+
+Example using the `EventsBackend`:
+
+```ts
+const http = HttpPostIngressEventPublisher.fromConfig({
+  config: env.config,
+  ingresses: {
+    yourTopic: {
+      validator: yourValidator,
+    },
+  },
+  logger: env.logger,
+  router: httpRouter,
+});
+
+await new EventsBackend(env.logger)
+  .addPublishers(http)
+  // [...]
+  .start();
+```
+
+Example using a module:
+
+```ts
+import { eventsExtensionPoint } from '@backstage/plugin-events-node';
+
+// [...]
+
+export const yourModuleEventsModule = createBackendModule({
+  pluginId: 'events',
+  moduleId: 'yourModule',
+  register(env) {
+    // [...]
+    env.registerInit({
+      deps: {
+        // [...]
+        events: eventsExtensionPoint,
+        // [...]
+      },
+      async init({ /* ... */ events /*, ... */ }) {
+        // [...]
+        events.addHttpPostIngress({
+          topic: 'your-topic',
+          validator: yourValidator,
+        });
+      },
+    });
+  },
+});
+```

package/alpha/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "@backstage/plugin-events-backend",
+  "version": "0.0.0-nightly-20221115024001",
+  "main": "../dist/index.cjs.js",
+  "types": "../dist/index.alpha.d.ts"
+}

package/config.d.ts

@@ -0,0 +1,28 @@
+/*
+ * Copyright 2022 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.
+ */
+
+export interface Config {
+  events?: {
+    http?: {
+      /**
+       * Topics for which a route has to be registered
+       * at which we can receive events via HTTP POST requests
+       * (i.e. received from webhooks).
+       */
+      topics?: string[];
+    };
+  };
+}

package/dist/index.alpha.d.ts

@@ -0,0 +1,65 @@
+/**
+ * The Backstage backend plugin "events" that provides the event management.
+ *
+ * @packageDocumentation
+ */
+
+import { BackendFeature } from '@backstage/backend-plugin-api';
+import { Config } from '@backstage/config';
+import { EventBroker } from '@backstage/plugin-events-node';
+import { EventPublisher } from '@backstage/plugin-events-node';
+import { EventSubscriber } from '@backstage/plugin-events-node';
+import express from 'express';
+import { HttpPostIngressOptions } from '@backstage/plugin-events-node';
+import { Logger } from 'winston';
+
+/**
+ * A builder that helps wire up all component parts of the event management.
+ *
+ * @public
+ */
+export declare class EventsBackend {
+    private eventBroker;
+    private publishers;
+    private subscribers;
+    constructor(logger: Logger);
+    setEventBroker(eventBroker: EventBroker): EventsBackend;
+    addPublishers(...publishers: Array<EventPublisher | Array<EventPublisher>>): EventsBackend;
+    addSubscribers(...subscribers: Array<EventSubscriber | Array<EventSubscriber>>): EventsBackend;
+    /**
+     * Wires up and returns all component parts of the event management.
+     */
+    start(): Promise<void>;
+}
+
+/**
+ * Events plugin
+ *
+ * @alpha
+ */
+export declare const eventsPlugin: (options?: undefined) => BackendFeature;
+
+/**
+ * Publishes events received from their origin (e.g., webhook events from an SCM system)
+ * via HTTP POST endpoint and passes the request body as event payload to the registered subscribers.
+ *
+ * @public
+ */
+export declare class HttpPostIngressEventPublisher implements EventPublisher {
+    private logger;
+    private eventBroker?;
+    static fromConfig(env: {
+        config: Config;
+        ingresses?: {
+            [topic: string]: Omit<HttpPostIngressOptions, 'topic'>;
+        };
+        logger: Logger;
+        router: express.Router;
+    }): HttpPostIngressEventPublisher;
+    private constructor();
+    setEventBroker(eventBroker: EventBroker): Promise<void>;
+    private createRouter;
+    private addRouteForTopic;
+}
+
+export { }

package/dist/index.beta.d.ts

@@ -0,0 +1,60 @@
+/**
+ * The Backstage backend plugin "events" that provides the event management.
+ *
+ * @packageDocumentation
+ */
+
+import { BackendFeature } from '@backstage/backend-plugin-api';
+import { Config } from '@backstage/config';
+import { EventBroker } from '@backstage/plugin-events-node';
+import { EventPublisher } from '@backstage/plugin-events-node';
+import { EventSubscriber } from '@backstage/plugin-events-node';
+import express from 'express';
+import { HttpPostIngressOptions } from '@backstage/plugin-events-node';
+import { Logger } from 'winston';
+
+/**
+ * A builder that helps wire up all component parts of the event management.
+ *
+ * @public
+ */
+export declare class EventsBackend {
+    private eventBroker;
+    private publishers;
+    private subscribers;
+    constructor(logger: Logger);
+    setEventBroker(eventBroker: EventBroker): EventsBackend;
+    addPublishers(...publishers: Array<EventPublisher | Array<EventPublisher>>): EventsBackend;
+    addSubscribers(...subscribers: Array<EventSubscriber | Array<EventSubscriber>>): EventsBackend;
+    /**
+     * Wires up and returns all component parts of the event management.
+     */
+    start(): Promise<void>;
+}
+
+/* Excluded from this release type: eventsPlugin */
+
+/**
+ * Publishes events received from their origin (e.g., webhook events from an SCM system)
+ * via HTTP POST endpoint and passes the request body as event payload to the registered subscribers.
+ *
+ * @public
+ */
+export declare class HttpPostIngressEventPublisher implements EventPublisher {
+    private logger;
+    private eventBroker?;
+    static fromConfig(env: {
+        config: Config;
+        ingresses?: {
+            [topic: string]: Omit<HttpPostIngressOptions, 'topic'>;
+        };
+        logger: Logger;
+        router: express.Router;
+    }): HttpPostIngressEventPublisher;
+    private constructor();
+    setEventBroker(eventBroker: EventBroker): Promise<void>;
+    private createRouter;
+    private addRouteForTopic;
+}
+
+export { }

package/dist/index.cjs.js

@@ -0,0 +1,255 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var backendPluginApi = require('@backstage/backend-plugin-api');
+var pluginEventsNode = require('@backstage/plugin-events-node');
+var Router = require('express-promise-router');
+var backendCommon = require('@backstage/backend-common');
+var express = require('express');
+
+function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
+
+var Router__default = /*#__PURE__*/_interopDefaultLegacy(Router);
+var express__default = /*#__PURE__*/_interopDefaultLegacy(express);
+
+class InMemoryEventBroker {
+  constructor(logger) {
+    this.logger = logger;
+    this.subscribers = {};
+  }
+  async publish(params) {
+    var _a;
+    this.logger.debug(
+      `Event received: topic=${params.topic}, metadata=${JSON.stringify(
+        params.metadata
+      )}, payload=${JSON.stringify(params.eventPayload)}`
+    );
+    const subscribed = (_a = this.subscribers[params.topic]) != null ? _a : [];
+    subscribed.forEach((subscriber) => subscriber.onEvent(params));
+  }
+  subscribe(...subscribers) {
+    subscribers.flat().forEach((subscriber) => {
+      subscriber.supportsEventTopics().forEach((topic) => {
+        var _a;
+        this.subscribers[topic] = (_a = this.subscribers[topic]) != null ? _a : [];
+        this.subscribers[topic].push(subscriber);
+      });
+    });
+  }
+}
+
+class EventsBackend {
+  constructor(logger) {
+    this.publishers = [];
+    this.subscribers = [];
+    this.eventBroker = new InMemoryEventBroker(logger);
+  }
+  setEventBroker(eventBroker) {
+    this.eventBroker = eventBroker;
+    return this;
+  }
+  addPublishers(...publishers) {
+    this.publishers.push(...publishers.flat());
+    return this;
+  }
+  addSubscribers(...subscribers) {
+    this.subscribers.push(...subscribers.flat());
+    return this;
+  }
+  async start() {
+    this.eventBroker.subscribe(this.subscribers);
+    this.publishers.forEach(
+      (publisher) => publisher.setEventBroker(this.eventBroker)
+    );
+  }
+}
+
+var __accessCheck$1 = (obj, member, msg) => {
+  if (!member.has(obj))
+    throw TypeError("Cannot " + msg);
+};
+var __privateGet$1 = (obj, member, getter) => {
+  __accessCheck$1(obj, member, "read from private field");
+  return getter ? getter.call(obj) : member.get(obj);
+};
+var __privateAdd$1 = (obj, member, value) => {
+  if (member.has(obj))
+    throw TypeError("Cannot add the same private member more than once");
+  member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+};
+var __privateSet$1 = (obj, member, value, setter) => {
+  __accessCheck$1(obj, member, "write to private field");
+  setter ? setter.call(obj, value) : member.set(obj, value);
+  return value;
+};
+var _rejectionDetails;
+class RequestValidationContextImpl {
+  constructor() {
+    __privateAdd$1(this, _rejectionDetails, void 0);
+  }
+  reject(details) {
+    var _a, _b;
+    __privateSet$1(this, _rejectionDetails, {
+      status: (_a = details == null ? void 0 : details.status) != null ? _a : 403,
+      payload: (_b = details == null ? void 0 : details.payload) != null ? _b : {}
+    });
+  }
+  wasRejected() {
+    return __privateGet$1(this, _rejectionDetails) !== void 0;
+  }
+  get rejectionDetails() {
+    return __privateGet$1(this, _rejectionDetails);
+  }
+}
+_rejectionDetails = new WeakMap();
+
+class HttpPostIngressEventPublisher {
+  constructor(logger, router, ingresses) {
+    this.logger = logger;
+    router.use(this.createRouter(ingresses));
+  }
+  static fromConfig(env) {
+    var _a, _b;
+    const topics = (_a = env.config.getOptionalStringArray("events.http.topics")) != null ? _a : [];
+    const ingresses = (_b = env.ingresses) != null ? _b : {};
+    topics.forEach((topic) => {
+      if (!ingresses[topic]) {
+        ingresses[topic] = {};
+      }
+    });
+    return new HttpPostIngressEventPublisher(env.logger, env.router, ingresses);
+  }
+  async setEventBroker(eventBroker) {
+    this.eventBroker = eventBroker;
+  }
+  createRouter(ingresses) {
+    const router = Router__default["default"]();
+    router.use(express__default["default"].json());
+    Object.keys(ingresses).forEach(
+      (topic) => this.addRouteForTopic(router, topic, ingresses[topic].validator)
+    );
+    router.use(backendCommon.errorHandler());
+    return router;
+  }
+  addRouteForTopic(router, topic, validator) {
+    const path = `/${topic}`;
+    router.post(path, async (request, response) => {
+      const context = new RequestValidationContextImpl();
+      await (validator == null ? void 0 : validator(request, context));
+      if (context.wasRejected()) {
+        response.status(context.rejectionDetails.status).json(context.rejectionDetails.payload);
+        return;
+      }
+      const eventPayload = request.body;
+      await this.eventBroker.publish({
+        topic,
+        eventPayload,
+        metadata: request.headers
+      });
+      response.status(202).json({ status: "accepted" });
+    });
+    this.logger.info(`Registered /api/events/http${path} to receive events`);
+  }
+}
+
+var __accessCheck = (obj, member, msg) => {
+  if (!member.has(obj))
+    throw TypeError("Cannot " + msg);
+};
+var __privateGet = (obj, member, getter) => {
+  __accessCheck(obj, member, "read from private field");
+  return getter ? getter.call(obj) : member.get(obj);
+};
+var __privateAdd = (obj, member, value) => {
+  if (member.has(obj))
+    throw TypeError("Cannot add the same private member more than once");
+  member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+};
+var __privateSet = (obj, member, value, setter) => {
+  __accessCheck(obj, member, "write to private field");
+  setter ? setter.call(obj, value) : member.set(obj, value);
+  return value;
+};
+var _eventBroker, _httpPostIngresses, _publishers, _subscribers;
+class EventsExtensionPointImpl {
+  constructor() {
+    __privateAdd(this, _eventBroker, void 0);
+    __privateAdd(this, _httpPostIngresses, []);
+    __privateAdd(this, _publishers, []);
+    __privateAdd(this, _subscribers, []);
+  }
+  setEventBroker(eventBroker) {
+    __privateSet(this, _eventBroker, eventBroker);
+  }
+  addPublishers(...publishers) {
+    __privateGet(this, _publishers).push(...publishers.flat());
+  }
+  addSubscribers(...subscribers) {
+    __privateGet(this, _subscribers).push(...subscribers.flat());
+  }
+  addHttpPostIngress(options) {
+    __privateGet(this, _httpPostIngresses).push(options);
+  }
+  get eventBroker() {
+    return __privateGet(this, _eventBroker);
+  }
+  get publishers() {
+    return __privateGet(this, _publishers);
+  }
+  get subscribers() {
+    return __privateGet(this, _subscribers);
+  }
+  get httpPostIngresses() {
+    return __privateGet(this, _httpPostIngresses);
+  }
+}
+_eventBroker = new WeakMap();
+_httpPostIngresses = new WeakMap();
+_publishers = new WeakMap();
+_subscribers = new WeakMap();
+const eventsPlugin = backendPluginApi.createBackendPlugin({
+  id: "events",
+  register(env) {
+    const extensionPoint = new EventsExtensionPointImpl();
+    env.registerExtensionPoint(pluginEventsNode.eventsExtensionPoint, extensionPoint);
+    env.registerInit({
+      deps: {
+        config: backendPluginApi.configServiceRef,
+        httpRouter: backendPluginApi.httpRouterServiceRef,
+        logger: backendPluginApi.loggerServiceRef
+      },
+      async init({ config, httpRouter, logger }) {
+        const winstonLogger = backendPluginApi.loggerToWinstonLogger(logger);
+        const eventsRouter = Router__default["default"]();
+        const router = Router__default["default"]();
+        eventsRouter.use("/http", router);
+        const ingresses = Object.fromEntries(
+          extensionPoint.httpPostIngresses.map((ingress) => [
+            ingress.topic,
+            ingress
+          ])
+        );
+        const http = HttpPostIngressEventPublisher.fromConfig({
+          config,
+          logger: winstonLogger,
+          router,
+          ingresses
+        });
+        if (!extensionPoint.eventBroker) {
+          extensionPoint.setEventBroker(new InMemoryEventBroker(winstonLogger));
+        }
+        extensionPoint.eventBroker.subscribe(extensionPoint.subscribers);
+        [extensionPoint.publishers, http].flat().forEach(
+          (publisher) => publisher.setEventBroker(extensionPoint.eventBroker)
+        );
+        httpRouter.use(eventsRouter);
+      }
+    });
+  }
+});
+
+exports.EventsBackend = EventsBackend;
+exports.HttpPostIngressEventPublisher = HttpPostIngressEventPublisher;
+exports.eventsPlugin = eventsPlugin;
+//# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":["../src/service/InMemoryEventBroker.ts","../src/service/EventsBackend.ts","../src/service/http/validation/RequestValidationContextImpl.ts","../src/service/http/HttpPostIngressEventPublisher.ts","../src/service/EventsPlugin.ts"],"sourcesContent":["/*\n * Copyright 2022 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 */\n\nimport {\n  EventBroker,\n  EventParams,\n  EventSubscriber,\n} from '@backstage/plugin-events-node';\nimport { Logger } from 'winston';\n\n/**\n * In-memory event broker which will pass the event to all registered subscribers\n * interested in it.\n * Events will not be persisted in any form.\n */\n// TODO(pjungermann): add prom metrics? (see plugins/catalog-backend/src/util/metrics.ts, etc.)\nexport class InMemoryEventBroker implements EventBroker {\n  constructor(private readonly logger: Logger) {}\n\n  private readonly subscribers: {\n    [topic: string]: EventSubscriber[];\n  } = {};\n\n  async publish(params: EventParams): Promise<void> {\n    this.logger.debug(\n      `Event received: topic=${params.topic}, metadata=${JSON.stringify(\n        params.metadata,\n      )}, payload=${JSON.stringify(params.eventPayload)}`,\n    );\n\n    const subscribed = this.subscribers[params.topic] ?? [];\n    subscribed.forEach(subscriber => subscriber.onEvent(params));\n  }\n\n  subscribe(\n    ...subscribers: Array<EventSubscriber | Array<EventSubscriber>>\n  ): void {\n    subscribers.flat().forEach(subscriber => {\n      subscriber.supportsEventTopics().forEach(topic => {\n        this.subscribers[topic] = this.subscribers[topic] ?? [];\n        this.subscribers[topic].push(subscriber);\n      });\n    });\n  }\n}\n","/*\n * Copyright 2022 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 */\n\nimport {\n  EventBroker,\n  EventPublisher,\n  EventSubscriber,\n} from '@backstage/plugin-events-node';\nimport { Logger } from 'winston';\nimport { InMemoryEventBroker } from './InMemoryEventBroker';\n\n/**\n * A builder that helps wire up all component parts of the event management.\n *\n * @public\n */\nexport class EventsBackend {\n  private eventBroker: EventBroker;\n  private publishers: EventPublisher[] = [];\n  private subscribers: EventSubscriber[] = [];\n\n  constructor(logger: Logger) {\n    this.eventBroker = new InMemoryEventBroker(logger);\n  }\n\n  setEventBroker(eventBroker: EventBroker): EventsBackend {\n    this.eventBroker = eventBroker;\n    return this;\n  }\n\n  addPublishers(\n    ...publishers: Array<EventPublisher | Array<EventPublisher>>\n  ): EventsBackend {\n    this.publishers.push(...publishers.flat());\n    return this;\n  }\n\n  addSubscribers(\n    ...subscribers: Array<EventSubscriber | Array<EventSubscriber>>\n  ): EventsBackend {\n    this.subscribers.push(...subscribers.flat());\n    return this;\n  }\n\n  /**\n   * Wires up and returns all component parts of the event management.\n   */\n  async start(): Promise<void> {\n    this.eventBroker.subscribe(this.subscribers);\n    this.publishers.forEach(publisher =>\n      publisher.setEventBroker(this.eventBroker),\n    );\n  }\n}\n","/*\n * Copyright 2022 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 */\n\nimport {\n  RequestRejectionDetails,\n  RequestValidationContext,\n} from '@backstage/plugin-events-node';\n\nexport class RequestValidationContextImpl implements RequestValidationContext {\n  #rejectionDetails: RequestRejectionDetails | undefined;\n\n  reject(details?: Partial<RequestRejectionDetails>): void {\n    this.#rejectionDetails = {\n      status: details?.status ?? 403,\n      payload: details?.payload ?? {},\n    };\n  }\n\n  wasRejected(): boolean {\n    return this.#rejectionDetails !== undefined;\n  }\n\n  get rejectionDetails() {\n    return this.#rejectionDetails;\n  }\n}\n","/*\n * Copyright 2022 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 */\n\nimport { errorHandler } from '@backstage/backend-common';\nimport { Config } from '@backstage/config';\nimport {\n  EventBroker,\n  EventPublisher,\n  HttpPostIngressOptions,\n  RequestValidator,\n} from '@backstage/plugin-events-node';\nimport express from 'express';\nimport Router from 'express-promise-router';\nimport { Logger } from 'winston';\nimport { RequestValidationContextImpl } from './validation';\n\n/**\n * Publishes events received from their origin (e.g., webhook events from an SCM system)\n * via HTTP POST endpoint and passes the request body as event payload to the registered subscribers.\n *\n * @public\n */\n// TODO(pjungermann): add prom metrics? (see plugins/catalog-backend/src/util/metrics.ts, etc.)\nexport class HttpPostIngressEventPublisher implements EventPublisher {\n  private eventBroker?: EventBroker;\n\n  static fromConfig(env: {\n    config: Config;\n    ingresses?: { [topic: string]: Omit<HttpPostIngressOptions, 'topic'> };\n    logger: Logger;\n    router: express.Router;\n  }): HttpPostIngressEventPublisher {\n    const topics =\n      env.config.getOptionalStringArray('events.http.topics') ?? [];\n\n    const ingresses = env.ingresses ?? {};\n    topics.forEach(topic => {\n      // don't overwrite topic settings\n      // (e.g., added at the config as well as argument)\n      if (!ingresses[topic]) {\n        ingresses[topic] = {};\n      }\n    });\n\n    return new HttpPostIngressEventPublisher(env.logger, env.router, ingresses);\n  }\n\n  private constructor(\n    private logger: Logger,\n    router: express.Router,\n    ingresses: { [topic: string]: Omit<HttpPostIngressOptions, 'topic'> },\n  ) {\n    router.use(this.createRouter(ingresses));\n  }\n\n  async setEventBroker(eventBroker: EventBroker): Promise<void> {\n    this.eventBroker = eventBroker;\n  }\n\n  private createRouter(ingresses: {\n    [topic: string]: Omit<HttpPostIngressOptions, 'topic'>;\n  }): express.Router {\n    const router = Router();\n    router.use(express.json());\n\n    Object.keys(ingresses).forEach(topic =>\n      this.addRouteForTopic(router, topic, ingresses[topic].validator),\n    );\n\n    router.use(errorHandler());\n    return router;\n  }\n\n  private addRouteForTopic(\n    router: express.Router,\n    topic: string,\n    validator?: RequestValidator,\n  ): void {\n    const path = `/${topic}`;\n\n    router.post(path, async (request, response) => {\n      const context = new RequestValidationContextImpl();\n      await validator?.(request, context);\n      if (context.wasRejected()) {\n        response\n          .status(context.rejectionDetails!.status)\n          .json(context.rejectionDetails!.payload);\n        return;\n      }\n\n      const eventPayload = request.body;\n      await this.eventBroker!.publish({\n        topic,\n        eventPayload,\n        metadata: request.headers,\n      });\n\n      response.status(202).json({ status: 'accepted' });\n    });\n\n    // TODO(pjungermann): We don't really know the externally defined path prefix here,\n    //  however it is more useful for users to have it. Is there a better way?\n    this.logger.info(`Registered /api/events/http${path} to receive events`);\n  }\n}\n","/*\n * Copyright 2022 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 */\n\nimport {\n  configServiceRef,\n  createBackendPlugin,\n  httpRouterServiceRef,\n  loggerServiceRef,\n  loggerToWinstonLogger,\n} from '@backstage/backend-plugin-api';\nimport {\n  EventBroker,\n  EventPublisher,\n  EventSubscriber,\n  eventsExtensionPoint,\n  EventsExtensionPoint,\n  HttpPostIngressOptions,\n} from '@backstage/plugin-events-node';\nimport { InMemoryEventBroker } from './InMemoryEventBroker';\nimport Router from 'express-promise-router';\nimport { HttpPostIngressEventPublisher } from './http';\n\nclass EventsExtensionPointImpl implements EventsExtensionPoint {\n  #eventBroker: EventBroker | undefined;\n  #httpPostIngresses: HttpPostIngressOptions[] = [];\n  #publishers: EventPublisher[] = [];\n  #subscribers: EventSubscriber[] = [];\n\n  setEventBroker(eventBroker: EventBroker): void {\n    this.#eventBroker = eventBroker;\n  }\n\n  addPublishers(\n    ...publishers: Array<EventPublisher | Array<EventPublisher>>\n  ): void {\n    this.#publishers.push(...publishers.flat());\n  }\n\n  addSubscribers(\n    ...subscribers: Array<EventSubscriber | Array<EventSubscriber>>\n  ): void {\n    this.#subscribers.push(...subscribers.flat());\n  }\n\n  addHttpPostIngress(options: HttpPostIngressOptions) {\n    this.#httpPostIngresses.push(options);\n  }\n\n  get eventBroker() {\n    return this.#eventBroker;\n  }\n\n  get publishers() {\n    return this.#publishers;\n  }\n\n  get subscribers() {\n    return this.#subscribers;\n  }\n\n  get httpPostIngresses() {\n    return this.#httpPostIngresses;\n  }\n}\n\n/**\n * Events plugin\n *\n * @alpha\n */\nexport const eventsPlugin = createBackendPlugin({\n  id: 'events',\n  register(env) {\n    const extensionPoint = new EventsExtensionPointImpl();\n    env.registerExtensionPoint(eventsExtensionPoint, extensionPoint);\n\n    env.registerInit({\n      deps: {\n        config: configServiceRef,\n        httpRouter: httpRouterServiceRef,\n        logger: loggerServiceRef,\n      },\n      async init({ config, httpRouter, logger }) {\n        const winstonLogger = loggerToWinstonLogger(logger);\n        const eventsRouter = Router();\n        const router = Router();\n        eventsRouter.use('/http', router);\n\n        const ingresses = Object.fromEntries(\n          extensionPoint.httpPostIngresses.map(ingress => [\n            ingress.topic,\n            ingress as Omit<HttpPostIngressOptions, 'topic'>,\n          ]),\n        );\n\n        const http = HttpPostIngressEventPublisher.fromConfig({\n          config,\n          logger: winstonLogger,\n          router,\n          ingresses,\n        });\n\n        if (!extensionPoint.eventBroker) {\n          extensionPoint.setEventBroker(new InMemoryEventBroker(winstonLogger));\n        }\n\n        extensionPoint.eventBroker!.subscribe(extensionPoint.subscribers);\n        [extensionPoint.publishers, http]\n          .flat()\n          .forEach(publisher =>\n            publisher.setEventBroker(extensionPoint.eventBroker!),\n          );\n\n        httpRouter.use(eventsRouter);\n      },\n    });\n  },\n});\n"],"names":["__privateAdd","__privateSet","__privateGet","Router","express","errorHandler","createBackendPlugin","eventsExtensionPoint","configServiceRef","httpRouterServiceRef","loggerServiceRef","loggerToWinstonLogger"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,60 @@
+/**
+ * The Backstage backend plugin "events" that provides the event management.
+ *
+ * @packageDocumentation
+ */
+
+import { BackendFeature } from '@backstage/backend-plugin-api';
+import { Config } from '@backstage/config';
+import { EventBroker } from '@backstage/plugin-events-node';
+import { EventPublisher } from '@backstage/plugin-events-node';
+import { EventSubscriber } from '@backstage/plugin-events-node';
+import express from 'express';
+import { HttpPostIngressOptions } from '@backstage/plugin-events-node';
+import { Logger } from 'winston';
+
+/**
+ * A builder that helps wire up all component parts of the event management.
+ *
+ * @public
+ */
+export declare class EventsBackend {
+    private eventBroker;
+    private publishers;
+    private subscribers;
+    constructor(logger: Logger);
+    setEventBroker(eventBroker: EventBroker): EventsBackend;
+    addPublishers(...publishers: Array<EventPublisher | Array<EventPublisher>>): EventsBackend;
+    addSubscribers(...subscribers: Array<EventSubscriber | Array<EventSubscriber>>): EventsBackend;
+    /**
+     * Wires up and returns all component parts of the event management.
+     */
+    start(): Promise<void>;
+}
+
+/* Excluded from this release type: eventsPlugin */
+
+/**
+ * Publishes events received from their origin (e.g., webhook events from an SCM system)
+ * via HTTP POST endpoint and passes the request body as event payload to the registered subscribers.
+ *
+ * @public
+ */
+export declare class HttpPostIngressEventPublisher implements EventPublisher {
+    private logger;
+    private eventBroker?;
+    static fromConfig(env: {
+        config: Config;
+        ingresses?: {
+            [topic: string]: Omit<HttpPostIngressOptions, 'topic'>;
+        };
+        logger: Logger;
+        router: express.Router;
+    }): HttpPostIngressEventPublisher;
+    private constructor();
+    setEventBroker(eventBroker: EventBroker): Promise<void>;
+    private createRouter;
+    private addRouteForTopic;
+}
+
+export { }

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@backstage/plugin-events-backend",
+  "version": "0.0.0-nightly-20221115024001",
+  "main": "dist/index.cjs.js",
+  "types": "dist/index.d.ts",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public",
+    "alphaTypes": "dist/index.alpha.d.ts",
+    "main": "dist/index.cjs.js",
+    "types": "dist/index.d.ts"
+  },
+  "backstage": {
+    "role": "backend-plugin"
+  },
+  "scripts": {
+    "start": "backstage-cli package start",
+    "build": "backstage-cli package build --experimental-type-build",
+    "lint": "backstage-cli package lint",
+    "test": "backstage-cli package test",
+    "clean": "backstage-cli package clean",
+    "prepack": "backstage-cli package prepack",
+    "postpack": "backstage-cli package postpack"
+  },
+  "dependencies": {
+    "@backstage/backend-common": "^0.0.0-nightly-20221115024001",
+    "@backstage/backend-plugin-api": "^0.0.0-nightly-20221115024001",
+    "@backstage/config": "^0.0.0-nightly-20221115024001",
+    "@backstage/plugin-events-node": "^0.0.0-nightly-20221115024001",
+    "@types/express": "^4.17.6",
+    "express": "^4.17.1",
+    "express-promise-router": "^4.1.0",
+    "winston": "^3.2.1"
+  },
+  "devDependencies": {
+    "@backstage/backend-common": "^0.0.0-nightly-20221115024001",
+    "@backstage/backend-test-utils": "^0.0.0-nightly-20221115024001",
+    "@backstage/cli": "^0.0.0-nightly-20221115024001",
+    "@backstage/plugin-events-backend-test-utils": "^0.0.0-nightly-20221115024001",
+    "supertest": "^6.1.3"
+  },
+  "files": [
+    "alpha",
+    "config.d.ts",
+    "dist"
+  ],
+  "configSchema": "config.d.ts"
+}