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

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# @backstage/plugin-events-backend-module-azure
+
+## 0.0.0-nightly-20221115024001
+
+### Minor Changes
+
+- 12cd94b7e9: Adds a new module `azure` to plugin-events-backend.
+
+  The module adds a new event router `AzureDevOpsEventRouter`.
+
+  The event router will re-publish events received at topic `azureDevOps`
+  under a more specific topic depending on their `$.eventType` value
+  (e.g., `azureDevOps.git.push`).
+
+  Please find more information at
+  https://github.com/backstage/backstage/tree/master/plugins/events-backend-module-azure/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,43 @@
+# events-backend-module-azure
+
+Welcome to the `events-backend-module-azure` backend plugin!
+
+This plugin is a module for the `events-backend` backend plugin
+and extends it with an `AzureDevOpsEventRouter`.
+
+The event router will subscribe to the topic `azureDevOps`
+and route the events to more concrete topics based on the value
+of the provided `$.eventType` payload field.
+
+Examples:
+
+| `$.eventType`             | topic                                 |
+| ------------------------- | ------------------------------------- |
+| `git.push`                | `azureDevOps.git.push`                |
+| `git.pullrequest.created` | `azureDevOps.git.pullrequest.created` |
+
+Please find all possible webhook event types at the
+[official documentation of events](https://learn.microsoft.com/en-us/azure/devops/service-hooks/events?source=recommendations&view=azure-devops)
+and [webhooks](https://learn.microsoft.com/en-us/azure/devops/service-hooks/services/webhooks?view=azure-devops).
+
+## 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-azure
+```
+
+Add the event router to the `EventsBackend`:
+
+```diff
++const githubEventRouter = new AzureDevOpsEventRouter();
+
+ EventsBackend
++  .addPublishers(githubEventRouter)
++  .addSubscribers(githubEventRouter);
+// [...]
+```

package/alpha/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "@backstage/plugin-events-backend-module-azure",
+  "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 "azure" for the Backstage backend plugin "events-backend"
+ * adding an event router for Azure DevOps.
+ *
+ * @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 `azureDevOps` topic
+ * and publishes the events under the more concrete sub-topic
+ * depending on the `$.eventType` provided.
+ *
+ * @public
+ */
+export declare class AzureDevOpsEventRouter extends SubTopicEventRouter {
+    constructor();
+    protected determineSubTopic(params: EventParams): string | undefined;
+}
+
+/**
+ * Module for the events-backend plugin, adding an event router for Azure DevOps.
+ *
+ * Registers the {@link AzureDevOpsEventRouter}.
+ *
+ * @alpha
+ */
+export declare const azureDevOpsEventRouterEventsModule: (options?: undefined) => BackendFeature;
+
+export { }

package/dist/index.beta.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The module "azure" for the Backstage backend plugin "events-backend"
+ * adding an event router for Azure DevOps.
+ *
+ * @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 `azureDevOps` topic
+ * and publishes the events under the more concrete sub-topic
+ * depending on the `$.eventType` provided.
+ *
+ * @public
+ */
+export declare class AzureDevOpsEventRouter extends SubTopicEventRouter {
+    constructor();
+    protected determineSubTopic(params: EventParams): string | undefined;
+}
+
+/* Excluded from this release type: azureDevOpsEventRouterEventsModule */
+
+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 AzureDevOpsEventRouter extends pluginEventsNode.SubTopicEventRouter {
+  constructor() {
+    super("azureDevOps");
+  }
+  determineSubTopic(params) {
+    if ("eventType" in params.eventPayload) {
+      const payload = params.eventPayload;
+      return payload.eventType;
+    }
+    return void 0;
+  }
+}
+
+const azureDevOpsEventRouterEventsModule = backendPluginApi.createBackendModule({
+  pluginId: "events",
+  moduleId: "azureDevOpsEventRouter",
+  register(env) {
+    env.registerInit({
+      deps: {
+        events: pluginEventsNode.eventsExtensionPoint
+      },
+      async init({ events }) {
+        const eventRouter = new AzureDevOpsEventRouter();
+        events.addPublishers(eventRouter);
+        events.addSubscribers(eventRouter);
+      }
+    });
+  }
+});
+
+exports.AzureDevOpsEventRouter = AzureDevOpsEventRouter;
+exports.azureDevOpsEventRouterEventsModule = azureDevOpsEventRouterEventsModule;
+//# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":["../src/router/AzureDevOpsEventRouter.ts","../src/service/AzureDevOpsEventRouterEventsModule.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 `azureDevOps` topic\n * and publishes the events under the more concrete sub-topic\n * depending on the `$.eventType` provided.\n *\n * @public\n */\nexport class AzureDevOpsEventRouter extends SubTopicEventRouter {\n  constructor() {\n    super('azureDevOps');\n  }\n\n  protected determineSubTopic(params: EventParams): string | undefined {\n    if ('eventType' in (params.eventPayload as object)) {\n      const payload = params.eventPayload as { eventType: string };\n      return payload.eventType;\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 { AzureDevOpsEventRouter } from '../router/AzureDevOpsEventRouter';\n\n/**\n * Module for the events-backend plugin, adding an event router for Azure DevOps.\n *\n * Registers the {@link AzureDevOpsEventRouter}.\n *\n * @alpha\n */\nexport const azureDevOpsEventRouterEventsModule = createBackendModule({\n  pluginId: 'events',\n  moduleId: 'azureDevOpsEventRouter',\n  register(env) {\n    env.registerInit({\n      deps: {\n        events: eventsExtensionPoint,\n      },\n      async init({ events }) {\n        const eventRouter = new AzureDevOpsEventRouter();\n\n        events.addPublishers(eventRouter);\n        events.addSubscribers(eventRouter);\n      },\n    });\n  },\n});\n"],"names":["SubTopicEventRouter","createBackendModule","eventsExtensionPoint"],"mappings":";;;;;;;AA4BO,MAAM,+BAA+BA,oCAAoB,CAAA;AAAA,EAC9D,WAAc,GAAA;AACZ,IAAA,KAAA,CAAM,aAAa,CAAA,CAAA;AAAA,GACrB;AAAA,EAEU,kBAAkB,MAAyC,EAAA;AACnE,IAAI,IAAA,WAAA,IAAgB,OAAO,YAAyB,EAAA;AAClD,MAAA,MAAM,UAAU,MAAO,CAAA,YAAA,CAAA;AACvB,MAAA,OAAO,OAAQ,CAAA,SAAA,CAAA;AAAA,KACjB;AAEA,IAAO,OAAA,KAAA,CAAA,CAAA;AAAA,GACT;AACF;;ACdO,MAAM,qCAAqCC,oCAAoB,CAAA;AAAA,EACpE,QAAU,EAAA,QAAA;AAAA,EACV,QAAU,EAAA,wBAAA;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,sBAAuB,EAAA,CAAA;AAE/C,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 "azure" for the Backstage backend plugin "events-backend"
+ * adding an event router for Azure DevOps.
+ *
+ * @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 `azureDevOps` topic
+ * and publishes the events under the more concrete sub-topic
+ * depending on the `$.eventType` provided.
+ *
+ * @public
+ */
+export declare class AzureDevOpsEventRouter extends SubTopicEventRouter {
+    constructor();
+    protected determineSubTopic(params: EventParams): string | undefined;
+}
+
+/* Excluded from this release type: azureDevOpsEventRouterEventsModule */
+
+export { }

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@backstage/plugin-events-backend-module-azure",
+  "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"
+  ]
+}