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

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# @backstage/plugin-events-backend-module-gerrit
+
+## 0.0.0-nightly-20221115024001
+
+### Minor Changes
+
+- 25f6d7bddb: Adds a new module `gerrit` to plugin-events-backend.
+
+  The module adds a new event router `GerritEventRouter`.
+
+  The event router will re-publish events received at topic `gerrit`
+  under a more specific topic depending on their `$.type` value
+  (e.g., `gerrit.change-merged`).
+
+  Please find more information at
+  https://github.com/backstage/backstage/tree/master/plugins/events-backend-module-gerrit/README.md.
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/plugin-events-node@0.0.0-nightly-20221115024001
+  - @backstage/backend-plugin-api@0.0.0-nightly-20221115024001

package/README.md

@@ -0,0 +1,42 @@
+# events-backend-module-gerrit
+
+Welcome to the `events-backend-module-gerrit` backend plugin!
+
+This plugin is a module for the `events-backend` backend plugin
+and extends it with an `GerritEventRouter`.
+
+The event router will subscribe to the topic `gerrit`
+and route the events to more concrete topics based on the value
+of the provided `$.type` payload field.
+
+Examples:
+
+| `$.type`         | topic                   |
+| ---------------- | ----------------------- |
+| `change-created` | `gerrit.change-created` |
+| `change-merged`  | `gerrit.change-merged`  |
+
+Please find all possible webhook event types at the
+[official documentation](https://gerrit-review.googlesource.com/Documentation/cmd-stream-events.html#events).
+
+## Installation
+
+Install the [`events-backend` plugin](../events-backend/README.md).
+
+Install this module:
+
+```bash
+# From your Backstage root directory
+yarn add --cwd packages/backend @backstage/plugin-events-backend-module-gerrit
+```
+
+Add the event router to the `EventsBackend`:
+
+```diff
++const gerritEventRouter = new GerritEventRouter();
+
+ EventsBackend
++  .addPublishers(gerritEventRouter)
++  .addSubscribers(gerritEventRouter);
+// [...]
+```

package/alpha/package.json

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

package/dist/index.alpha.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The module `gerrit` for the Backstage backend plugin "events-backend"
+ * adding an event router for Gerrit.
+ *
+ * @packageDocumentation
+ */
+
+import { BackendFeature } from '@backstage/backend-plugin-api';
+import { EventParams } from '@backstage/plugin-events-node';
+import { SubTopicEventRouter } from '@backstage/plugin-events-node';
+
+/**
+ * Subscribes to the generic `gerrit` topic
+ * and publishes the events under the more concrete sub-topic
+ * depending on the `$.type` field provided.
+ *
+ * @public
+ */
+export declare class GerritEventRouter extends SubTopicEventRouter {
+    constructor();
+    protected determineSubTopic(params: EventParams): string | undefined;
+}
+
+/**
+ * Module for the events-backend plugin, adding an event router for Gerrit.
+ *
+ * Registers the {@link GerritEventRouter}.
+ *
+ * @alpha
+ */
+export declare const gerritEventRouterEventsModule: (options?: undefined) => BackendFeature;
+
+export { }

package/dist/index.beta.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The module `gerrit` for the Backstage backend plugin "events-backend"
+ * adding an event router for Gerrit.
+ *
+ * @packageDocumentation
+ */
+
+import { BackendFeature } from '@backstage/backend-plugin-api';
+import { EventParams } from '@backstage/plugin-events-node';
+import { SubTopicEventRouter } from '@backstage/plugin-events-node';
+
+/**
+ * Subscribes to the generic `gerrit` topic
+ * and publishes the events under the more concrete sub-topic
+ * depending on the `$.type` field provided.
+ *
+ * @public
+ */
+export declare class GerritEventRouter extends SubTopicEventRouter {
+    constructor();
+    protected determineSubTopic(params: EventParams): string | undefined;
+}
+
+/* Excluded from this release type: gerritEventRouterEventsModule */
+
+export { }

package/dist/index.cjs.js

@@ -0,0 +1,40 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var pluginEventsNode = require('@backstage/plugin-events-node');
+var backendPluginApi = require('@backstage/backend-plugin-api');
+
+class GerritEventRouter extends pluginEventsNode.SubTopicEventRouter {
+  constructor() {
+    super("gerrit");
+  }
+  determineSubTopic(params) {
+    if ("type" in params.eventPayload) {
+      const payload = params.eventPayload;
+      return payload.type;
+    }
+    return void 0;
+  }
+}
+
+const gerritEventRouterEventsModule = backendPluginApi.createBackendModule({
+  pluginId: "events",
+  moduleId: "gerritEventRouter",
+  register(env) {
+    env.registerInit({
+      deps: {
+        events: pluginEventsNode.eventsExtensionPoint
+      },
+      async init({ events }) {
+        const eventRouter = new GerritEventRouter();
+        events.addPublishers(eventRouter);
+        events.addSubscribers(eventRouter);
+      }
+    });
+  }
+});
+
+exports.GerritEventRouter = GerritEventRouter;
+exports.gerritEventRouterEventsModule = gerritEventRouterEventsModule;
+//# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":["../src/router/GerritEventRouter.ts","../src/service/GerritEventRouterEventsModule.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  EventParams,\n  SubTopicEventRouter,\n} from '@backstage/plugin-events-node';\n\n/**\n * Subscribes to the generic `gerrit` topic\n * and publishes the events under the more concrete sub-topic\n * depending on the `$.type` field provided.\n *\n * @public\n */\nexport class GerritEventRouter extends SubTopicEventRouter {\n  constructor() {\n    super('gerrit');\n  }\n\n  protected determineSubTopic(params: EventParams): string | undefined {\n    if ('type' in (params.eventPayload as object)) {\n      const payload = params.eventPayload as { type: string };\n      return payload.type;\n    }\n\n    return undefined;\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 { createBackendModule } from '@backstage/backend-plugin-api';\nimport { eventsExtensionPoint } from '@backstage/plugin-events-node';\nimport { GerritEventRouter } from '../router/GerritEventRouter';\n\n/**\n * Module for the events-backend plugin, adding an event router for Gerrit.\n *\n * Registers the {@link GerritEventRouter}.\n *\n * @alpha\n */\nexport const gerritEventRouterEventsModule = createBackendModule({\n  pluginId: 'events',\n  moduleId: 'gerritEventRouter',\n  register(env) {\n    env.registerInit({\n      deps: {\n        events: eventsExtensionPoint,\n      },\n      async init({ events }) {\n        const eventRouter = new GerritEventRouter();\n\n        events.addPublishers(eventRouter);\n        events.addSubscribers(eventRouter);\n      },\n    });\n  },\n});\n"],"names":["SubTopicEventRouter","createBackendModule","eventsExtensionPoint"],"mappings":";;;;;;;AA4BO,MAAM,0BAA0BA,oCAAoB,CAAA;AAAA,EACzD,WAAc,GAAA;AACZ,IAAA,KAAA,CAAM,QAAQ,CAAA,CAAA;AAAA,GAChB;AAAA,EAEU,kBAAkB,MAAyC,EAAA;AACnE,IAAI,IAAA,MAAA,IAAW,OAAO,YAAyB,EAAA;AAC7C,MAAA,MAAM,UAAU,MAAO,CAAA,YAAA,CAAA;AACvB,MAAA,OAAO,OAAQ,CAAA,IAAA,CAAA;AAAA,KACjB;AAEA,IAAO,OAAA,KAAA,CAAA,CAAA;AAAA,GACT;AACF;;ACdO,MAAM,gCAAgCC,oCAAoB,CAAA;AAAA,EAC/D,QAAU,EAAA,QAAA;AAAA,EACV,QAAU,EAAA,mBAAA;AAAA,EACV,SAAS,GAAK,EAAA;AACZ,IAAA,GAAA,CAAI,YAAa,CAAA;AAAA,MACf,IAAM,EAAA;AAAA,QACJ,MAAQ,EAAAC,qCAAA;AAAA,OACV;AAAA,MACA,MAAM,IAAA,CAAK,EAAE,MAAA,EAAU,EAAA;AACrB,QAAM,MAAA,WAAA,GAAc,IAAI,iBAAkB,EAAA,CAAA;AAE1C,QAAA,MAAA,CAAO,cAAc,WAAW,CAAA,CAAA;AAChC,QAAA,MAAA,CAAO,eAAe,WAAW,CAAA,CAAA;AAAA,OACnC;AAAA,KACD,CAAA,CAAA;AAAA,GACH;AACF,CAAC;;;;;"}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The module `gerrit` for the Backstage backend plugin "events-backend"
+ * adding an event router for Gerrit.
+ *
+ * @packageDocumentation
+ */
+
+import { BackendFeature } from '@backstage/backend-plugin-api';
+import { EventParams } from '@backstage/plugin-events-node';
+import { SubTopicEventRouter } from '@backstage/plugin-events-node';
+
+/**
+ * Subscribes to the generic `gerrit` topic
+ * and publishes the events under the more concrete sub-topic
+ * depending on the `$.type` field provided.
+ *
+ * @public
+ */
+export declare class GerritEventRouter extends SubTopicEventRouter {
+    constructor();
+    protected determineSubTopic(params: EventParams): string | undefined;
+}
+
+/* Excluded from this release type: gerritEventRouterEventsModule */
+
+export { }

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@backstage/plugin-events-backend-module-gerrit",
+  "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-module"
+  },
+  "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-plugin-api": "^0.0.0-nightly-20221115024001",
+    "@backstage/plugin-events-node": "^0.0.0-nightly-20221115024001",
+    "winston": "^3.2.1"
+  },
+  "devDependencies": {
+    "@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",
+    "dist"
+  ]
+}