@backstage/plugin-events-backend-module-bitbucket-cloud 0.0.0-nightly-20221115024001

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# @backstage/plugin-events-backend-module-bitbucket-cloud
+
+## 0.0.0-nightly-20221115024001
+
+### Minor Changes
+
+- 6bc121bf0d: Adds a new module `bitbucket-cloud` to plugin-events-backend.
+
+  The module adds a new event router `BitbucketCloudEventRouter`.
+
+  The event router will re-publish events received at topic `bitbucketCloud`
+  under a more specific topic depending on their `x-event-key` value
+  (e.g., `bitbucketCloud.repo:push`).
+
+  Please find more information at
+  https://github.com/backstage/backstage/tree/master/plugins/events-backend-module-bitbucket-cloud/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-bitbucket-cloud
+
+Welcome to the `events-backend-module-bitbucket-cloud` backend plugin!
+
+This plugin is a module for the `events-backend` backend plugin
+and extends it with an `BitbucketCloudEventRouter`.
+
+The event router will subscribe to the topic `bitbucketCloud`
+and route the events to more concrete topics based on the value
+of the provided `x-event-key` metadata field.
+
+Examples:
+
+| x-event-key           | topic                                |
+| --------------------- | ------------------------------------ |
+| `repo:push`           | `bitbucketCloud.repo:push`           |
+| `repo:updated`        | `bitbucketCloud.repo:updated`        |
+| `pullrequest:created` | `bitbucketCloud.pullrequest:created` |
+
+Please find all possible webhook event types at the
+[official documentation](https://support.atlassian.com/bitbucket-cloud/docs/event-payloads/).
+
+## 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-bitbucket-cloud
+```
+
+Add the event router to the `EventsBackend`:
+
+```diff
++const bitbucketCloudEventRouter = new BitbucketCloudEventRouter();
+
+ EventsBackend
++  .addPublishers(bitbucketCloudEventRouter)
++  .addSubscribers(bitbucketCloudEventRouter);
+// [...]
+```

package/alpha/package.json

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

package/dist/index.beta.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The module "bitbucket-cloud" for the Backstage backend plugin "events-backend"
+ * adding an event router for Bitbucket Cloud.
+ *
+ * @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 `bitbucketCloud` topic
+ * and publishes the events under the more concrete sub-topic
+ * depending on the `x-event-key` provided.
+ *
+ * @public
+ */
+export declare class BitbucketCloudEventRouter extends SubTopicEventRouter {
+    constructor();
+    protected determineSubTopic(params: EventParams): string | undefined;
+}
+
+/* Excluded from this release type: bitbucketCloudEventRouterEventsModule */
+
+export { }

package/dist/index.cjs.js

@@ -0,0 +1,37 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var pluginEventsNode = require('@backstage/plugin-events-node');
+var backendPluginApi = require('@backstage/backend-plugin-api');
+
+class BitbucketCloudEventRouter extends pluginEventsNode.SubTopicEventRouter {
+  constructor() {
+    super("bitbucketCloud");
+  }
+  determineSubTopic(params) {
+    var _a;
+    return (_a = params.metadata) == null ? void 0 : _a["x-event-key"];
+  }
+}
+
+const bitbucketCloudEventRouterEventsModule = backendPluginApi.createBackendModule({
+  pluginId: "events",
+  moduleId: "bitbucketCloudEventRouter",
+  register(env) {
+    env.registerInit({
+      deps: {
+        events: pluginEventsNode.eventsExtensionPoint
+      },
+      async init({ events }) {
+        const eventRouter = new BitbucketCloudEventRouter();
+        events.addPublishers(eventRouter);
+        events.addSubscribers(eventRouter);
+      }
+    });
+  }
+});
+
+exports.BitbucketCloudEventRouter = BitbucketCloudEventRouter;
+exports.bitbucketCloudEventRouterEventsModule = bitbucketCloudEventRouterEventsModule;
+//# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":["../src/router/BitbucketCloudEventRouter.ts","../src/service/BitbucketCloudEventRouterEventsModule.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 `bitbucketCloud` topic\n * and publishes the events under the more concrete sub-topic\n * depending on the `x-event-key` provided.\n *\n * @public\n */\nexport class BitbucketCloudEventRouter extends SubTopicEventRouter {\n  constructor() {\n    super('bitbucketCloud');\n  }\n\n  protected determineSubTopic(params: EventParams): string | undefined {\n    return params.metadata?.['x-event-key'] as string | 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 { BitbucketCloudEventRouter } from '../router/BitbucketCloudEventRouter';\n\n/**\n * Module for the events-backend plugin, adding an event router for Bitbucket Cloud.\n *\n * Registers the {@link BitbucketCloudEventRouter}.\n *\n * @alpha\n */\nexport const bitbucketCloudEventRouterEventsModule = createBackendModule({\n  pluginId: 'events',\n  moduleId: 'bitbucketCloudEventRouter',\n  register(env) {\n    env.registerInit({\n      deps: {\n        events: eventsExtensionPoint,\n      },\n      async init({ events }) {\n        const eventRouter = new BitbucketCloudEventRouter();\n\n        events.addPublishers(eventRouter);\n        events.addSubscribers(eventRouter);\n      },\n    });\n  },\n});\n"],"names":["SubTopicEventRouter","createBackendModule","eventsExtensionPoint"],"mappings":";;;;;;;AA4BO,MAAM,kCAAkCA,oCAAoB,CAAA;AAAA,EACjE,WAAc,GAAA;AACZ,IAAA,KAAA,CAAM,gBAAgB,CAAA,CAAA;AAAA,GACxB;AAAA,EAEU,kBAAkB,MAAyC,EAAA;AAjCvE,IAAA,IAAA,EAAA,CAAA;AAkCI,IAAO,OAAA,CAAA,EAAA,GAAA,MAAA,CAAO,aAAP,IAAkB,GAAA,KAAA,CAAA,GAAA,EAAA,CAAA,aAAA,CAAA,CAAA;AAAA,GAC3B;AACF;;ACTO,MAAM,wCAAwCC,oCAAoB,CAAA;AAAA,EACvE,QAAU,EAAA,QAAA;AAAA,EACV,QAAU,EAAA,2BAAA;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,yBAA0B,EAAA,CAAA;AAElD,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 "bitbucket-cloud" for the Backstage backend plugin "events-backend"
+ * adding an event router for Bitbucket Cloud.
+ *
+ * @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 `bitbucketCloud` topic
+ * and publishes the events under the more concrete sub-topic
+ * depending on the `x-event-key` provided.
+ *
+ * @public
+ */
+export declare class BitbucketCloudEventRouter extends SubTopicEventRouter {
+    constructor();
+    protected determineSubTopic(params: EventParams): string | undefined;
+}
+
+/* Excluded from this release type: bitbucketCloudEventRouterEventsModule */
+
+export { }

package/package.json

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