@backstage/plugin-catalog-backend-module-bitbucket-server 0.5.11 → 0.5.12

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @backstage/plugin-catalog-backend-module-bitbucket-server
 
+## 0.5.12
+
+### Patch Changes
+
+- 9e2ff8c: Added a Bitbucket Server SCM event translation layer to the catalog backend module. The module now subscribes to Bitbucket Server webhook events and translates them into generic catalog SCM events, enabling instant catalog reprocessing when repositories are pushed to or renamed. The `analyzeBitbucketServerWebhookEvent` function is exported from the alpha entry point for custom integrations.
+- Updated dependencies
+  - @backstage/integration@2.0.3
+  - @backstage/backend-plugin-api@1.9.2
+  - @backstage/plugin-catalog-node@2.2.2
+  - @backstage/plugin-events-node@0.4.23
+
+## 0.5.12-next.0
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/integration@2.0.3-next.0
+  - @backstage/plugin-catalog-node@2.2.2-next.0
+  - @backstage/backend-plugin-api@1.9.2-next.0
+  - @backstage/plugin-events-node@0.4.23-next.0
+
 ## 0.5.11
 
 ### Patch Changes

package/dist/alpha.cjs.js

@@ -0,0 +1,12 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var catalogModuleBitbucketServerEntityProvider = require('./module/catalogModuleBitbucketServerEntityProvider.cjs.js');
+var analyzeBitbucketServerWebhookEvent = require('./events/analyzeBitbucketServerWebhookEvent.cjs.js');
+
+const _feature = catalogModuleBitbucketServerEntityProvider.catalogModuleBitbucketServerEntityProvider;
+
+exports.analyzeBitbucketServerWebhookEvent = analyzeBitbucketServerWebhookEvent.analyzeBitbucketServerWebhookEvent;
+exports.default = _feature;
+//# sourceMappingURL=alpha.cjs.js.map

package/dist/alpha.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alpha.cjs.js","sources":["../src/alpha.ts"],"sourcesContent":["/*\n * Copyright 2026 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 { default as feature } from './module';\n\n/** @alpha */\nconst _feature = feature;\nexport default _feature;\n\nexport {\n  analyzeBitbucketServerWebhookEvent,\n  type AnalyzeBitbucketServerWebhookEventResult,\n} from './events/analyzeBitbucketServerWebhookEvent';\n"],"names":["feature"],"mappings":";;;;;;;AAmBA,MAAM,QAAA,GAAWA;;;;;"}

package/dist/alpha.d.ts

@@ -0,0 +1,51 @@
+import * as _backstage_backend_plugin_api from '@backstage/backend-plugin-api';
+import { CatalogScmEvent } from '@backstage/plugin-catalog-node/alpha';
+
+/**
+ * The result of analyzing a Bitbucket Server webhook event.
+ *
+ * - `ok` — one or more catalog SCM events were produced.
+ * - `ignored` — the event was valid but not relevant.
+ * - `aborted` — the event could not be fully processed due to missing data.
+ * - `unsupported-event` — the event type is not handled by this analyzer.
+ *
+ * @alpha
+ */
+type AnalyzeBitbucketServerWebhookEventResult = {
+    result: 'unsupported-event';
+    event: string;
+} | {
+    result: 'ignored';
+    reason: string;
+} | {
+    result: 'aborted';
+    reason: string;
+} | {
+    result: 'ok';
+    events: CatalogScmEvent[];
+};
+/**
+ * Analyzes a Bitbucket Server webhook event and translates it into zero or more
+ * catalog SCM events that entity providers can act on.
+ *
+ * Bitbucket Server push payloads do not include file-level change data, so only
+ * repository-level events are produced (unlike the GitLab and Azure DevOps
+ * analyzers which can emit fine-grained `location.*` events). Bitbucket Server
+ * does not emit a repository deletion webhook, so no `repository.deleted` event
+ * is produced.
+ *
+ * Supported event types:
+ * - `repo:refs_changed` — emits a `repository.updated` event to trigger catalog
+ *   refresh for the repository.
+ * - `repo:modified` — translates repository renames into `repository.moved`
+ *   events, or emits `repository.updated` for other metadata changes.
+ *
+ * @alpha
+ */
+declare function analyzeBitbucketServerWebhookEvent(eventType: string, eventPayload: unknown): Promise<AnalyzeBitbucketServerWebhookEventResult>;
+
+/** @alpha */
+declare const _feature: _backstage_backend_plugin_api.BackendFeature;
+
+export { analyzeBitbucketServerWebhookEvent, _feature as default };
+export type { AnalyzeBitbucketServerWebhookEventResult };

package/dist/events/BitbucketServerScmEventsBridge.cjs.js

@@ -0,0 +1,83 @@
+'use strict';
+
+var analyzeBitbucketServerWebhookEvent = require('./analyzeBitbucketServerWebhookEvent.cjs.js');
+
+class BitbucketServerScmEventsBridge {
+  #logger;
+  #events;
+  #catalogScmEvents;
+  #shuttingDown;
+  #pendingPublish;
+  constructor(options) {
+    this.#logger = options.logger;
+    this.#events = options.events;
+    this.#catalogScmEvents = options.catalogScmEvents;
+    this.#shuttingDown = false;
+  }
+  async start() {
+    await this.#events.subscribe({
+      id: "catalog-bitbucket-server-scm-events-bridge",
+      topics: ["bitbucketServer"],
+      onEvent: this.#onEvent.bind(this)
+    });
+  }
+  async stop() {
+    this.#shuttingDown = true;
+    await this.#pendingPublish;
+  }
+  async #onEvent(params) {
+    const eventType = params.metadata?.["x-event-key"] ?? this.#extractEventTypeFromTopic(params.topic);
+    if (!eventType || !params.eventPayload) {
+      return;
+    }
+    while (this.#pendingPublish) {
+      await this.#pendingPublish;
+    }
+    if (this.#shuttingDown) {
+      this.#logger.warn(
+        `Skipping Bitbucket Server webhook event of type "${eventType}" on topic "${params.topic}" because the bridge is shutting down`
+      );
+      return;
+    }
+    this.#pendingPublish = Promise.resolve().then(async () => {
+      try {
+        const output = await analyzeBitbucketServerWebhookEvent.analyzeBitbucketServerWebhookEvent(
+          eventType,
+          params.eventPayload
+        );
+        if (output.result === "ok") {
+          await this.#catalogScmEvents.publish(output.events);
+        } else if (output.result === "ignored") {
+          this.#logger.debug(
+            `Skipping Bitbucket Server webhook event of type "${eventType}" on topic "${params.topic}" because it is ignored: ${output.reason}`
+          );
+        } else if (output.result === "aborted") {
+          this.#logger.warn(
+            `Skipping Bitbucket Server webhook event of type "${eventType}" on topic "${params.topic}" because it is aborted: ${output.reason}`
+          );
+        } else if (output.result === "unsupported-event") {
+          this.#logger.debug(
+            `Skipping Bitbucket Server webhook event of type "${eventType}" on topic "${params.topic}" because it is unsupported: ${output.event}`
+          );
+        }
+      } catch (error) {
+        this.#logger.warn(
+          `Failed to handle Bitbucket Server webhook event of type "${eventType}"`,
+          error
+        );
+      } finally {
+        this.#pendingPublish = void 0;
+      }
+    });
+    await this.#pendingPublish;
+  }
+  #extractEventTypeFromTopic(topic) {
+    if (topic.startsWith("bitbucketServer.")) {
+      return topic.slice("bitbucketServer.".length);
+    }
+    return void 0;
+  }
+}
+
+exports.BitbucketServerScmEventsBridge = BitbucketServerScmEventsBridge;
+//# sourceMappingURL=BitbucketServerScmEventsBridge.cjs.js.map

package/dist/events/BitbucketServerScmEventsBridge.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BitbucketServerScmEventsBridge.cjs.js","sources":["../../src/events/BitbucketServerScmEventsBridge.ts"],"sourcesContent":["/*\n * Copyright 2026 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 { LoggerService } from '@backstage/backend-plugin-api';\nimport { CatalogScmEventsService } from '@backstage/plugin-catalog-node/alpha';\nimport { EventParams, EventsService } from '@backstage/plugin-events-node';\nimport { analyzeBitbucketServerWebhookEvent } from './analyzeBitbucketServerWebhookEvent';\n\n/**\n * Takes Bitbucket Server webhook events, analyzes them, and publishes them as\n * catalog SCM events that entity providers and others can subscribe to.\n */\nexport class BitbucketServerScmEventsBridge {\n  readonly #logger: LoggerService;\n  readonly #events: EventsService;\n  readonly #catalogScmEvents: CatalogScmEventsService;\n  #shuttingDown: boolean;\n  #pendingPublish: Promise<void> | undefined;\n\n  constructor(options: {\n    logger: LoggerService;\n    events: EventsService;\n    catalogScmEvents: CatalogScmEventsService;\n  }) {\n    this.#logger = options.logger;\n    this.#events = options.events;\n    this.#catalogScmEvents = options.catalogScmEvents;\n    this.#shuttingDown = false;\n  }\n\n  async start() {\n    await this.#events.subscribe({\n      id: 'catalog-bitbucket-server-scm-events-bridge',\n      topics: ['bitbucketServer'],\n      onEvent: this.#onEvent.bind(this),\n    });\n  }\n\n  async stop() {\n    this.#shuttingDown = true;\n    await this.#pendingPublish;\n  }\n\n  async #onEvent(params: EventParams): Promise<void> {\n    const eventType =\n      (params.metadata?.['x-event-key'] as string | undefined) ??\n      this.#extractEventTypeFromTopic(params.topic);\n    if (!eventType || !params.eventPayload) {\n      return;\n    }\n\n    while (this.#pendingPublish) {\n      await this.#pendingPublish;\n    }\n\n    if (this.#shuttingDown) {\n      this.#logger.warn(\n        `Skipping Bitbucket Server webhook event of type \"${eventType}\" on topic \"${params.topic}\" because the bridge is shutting down`,\n      );\n      return;\n    }\n\n    this.#pendingPublish = Promise.resolve().then(async () => {\n      try {\n        const output = await analyzeBitbucketServerWebhookEvent(\n          eventType,\n          params.eventPayload,\n        );\n\n        if (output.result === 'ok') {\n          await this.#catalogScmEvents.publish(output.events);\n        } else if (output.result === 'ignored') {\n          this.#logger.debug(\n            `Skipping Bitbucket Server webhook event of type \"${eventType}\" on topic \"${params.topic}\" because it is ignored: ${output.reason}`,\n          );\n        } else if (output.result === 'aborted') {\n          this.#logger.warn(\n            `Skipping Bitbucket Server webhook event of type \"${eventType}\" on topic \"${params.topic}\" because it is aborted: ${output.reason}`,\n          );\n        } else if (output.result === 'unsupported-event') {\n          this.#logger.debug(\n            `Skipping Bitbucket Server webhook event of type \"${eventType}\" on topic \"${params.topic}\" because it is unsupported: ${output.event}`,\n          );\n        }\n      } catch (error) {\n        this.#logger.warn(\n          `Failed to handle Bitbucket Server webhook event of type \"${eventType}\"`,\n          error,\n        );\n      } finally {\n        this.#pendingPublish = undefined;\n      }\n    });\n\n    await this.#pendingPublish;\n  }\n\n  #extractEventTypeFromTopic(topic: string): string | undefined {\n    if (topic.startsWith('bitbucketServer.')) {\n      return topic.slice('bitbucketServer.'.length);\n    }\n    return undefined;\n  }\n}\n"],"names":["analyzeBitbucketServerWebhookEvent"],"mappings":"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"}

package/dist/events/analyzeBitbucketServerWebhookEvent.cjs.js

@@ -0,0 +1,80 @@
+'use strict';
+
+var errors = require('@backstage/errors');
+
+function asObject(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return void 0;
+  }
+  return value;
+}
+function asArray(value) {
+  return Array.isArray(value) ? value : void 0;
+}
+function asString(value) {
+  return typeof value === "string" ? value : void 0;
+}
+function getRepositoryUrl(repository) {
+  const links = asObject(repository?.links);
+  const self = asArray(links?.self);
+  const first = asObject(self?.[0]);
+  return asString(first?.href);
+}
+async function onRefsChangedEvent(payload) {
+  const repositoryUrl = getRepositoryUrl(asObject(payload.repository));
+  if (!repositoryUrl) {
+    return {
+      result: "aborted",
+      reason: "Bitbucket Server repo:refs_changed event did not include repository.links.self[0].href"
+    };
+  }
+  return {
+    result: "ok",
+    events: [{ type: "repository.updated", url: repositoryUrl }]
+  };
+}
+async function onModifiedEvent(payload) {
+  const repositoryUrl = getRepositoryUrl(asObject(payload.new));
+  const oldRepositoryUrl = getRepositoryUrl(asObject(payload.old));
+  if (!repositoryUrl) {
+    return {
+      result: "aborted",
+      reason: "Bitbucket Server repo:modified event did not include new.links.self[0].href"
+    };
+  }
+  if (oldRepositoryUrl && oldRepositoryUrl !== repositoryUrl) {
+    return {
+      result: "ok",
+      events: [
+        {
+          type: "repository.moved",
+          fromUrl: oldRepositoryUrl,
+          toUrl: repositoryUrl
+        }
+      ]
+    };
+  }
+  return {
+    result: "ok",
+    events: [{ type: "repository.updated", url: repositoryUrl }]
+  };
+}
+async function analyzeBitbucketServerWebhookEvent(eventType, eventPayload) {
+  const payload = asObject(eventPayload);
+  if (!payload) {
+    throw new errors.InputError(
+      "Bitbucket Server webhook event payload is not an object"
+    );
+  }
+  switch (eventType) {
+    case "repo:refs_changed":
+      return onRefsChangedEvent(payload);
+    case "repo:modified":
+      return onModifiedEvent(payload);
+    default:
+      return { result: "unsupported-event", event: eventType };
+  }
+}
+
+exports.analyzeBitbucketServerWebhookEvent = analyzeBitbucketServerWebhookEvent;
+//# sourceMappingURL=analyzeBitbucketServerWebhookEvent.cjs.js.map

package/dist/events/analyzeBitbucketServerWebhookEvent.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzeBitbucketServerWebhookEvent.cjs.js","sources":["../../src/events/analyzeBitbucketServerWebhookEvent.ts"],"sourcesContent":["/*\n * Copyright 2026 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 { InputError } from '@backstage/errors';\nimport { CatalogScmEvent } from '@backstage/plugin-catalog-node/alpha';\n\n/**\n * The result of analyzing a Bitbucket Server webhook event.\n *\n * - `ok` — one or more catalog SCM events were produced.\n * - `ignored` — the event was valid but not relevant.\n * - `aborted` — the event could not be fully processed due to missing data.\n * - `unsupported-event` — the event type is not handled by this analyzer.\n *\n * @alpha\n */\nexport type AnalyzeBitbucketServerWebhookEventResult =\n  | {\n      result: 'unsupported-event';\n      event: string;\n    }\n  | {\n      result: 'ignored';\n      reason: string;\n    }\n  | {\n      result: 'aborted';\n      reason: string;\n    }\n  | {\n      result: 'ok';\n      events: CatalogScmEvent[];\n    };\n\ntype JsonObject = Record<string, unknown>;\n\nfunction asObject(value: unknown): JsonObject | undefined {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return undefined;\n  }\n  return value as JsonObject;\n}\n\nfunction asArray(value: unknown): unknown[] | undefined {\n  return Array.isArray(value) ? value : undefined;\n}\n\nfunction asString(value: unknown): string | undefined {\n  return typeof value === 'string' ? value : undefined;\n}\n\nfunction getRepositoryUrl(\n  repository: JsonObject | undefined,\n): string | undefined {\n  const links = asObject(repository?.links);\n  const self = asArray(links?.self);\n  const first = asObject(self?.[0]);\n  return asString(first?.href);\n}\n\nasync function onRefsChangedEvent(\n  payload: JsonObject,\n): Promise<AnalyzeBitbucketServerWebhookEventResult> {\n  const repositoryUrl = getRepositoryUrl(asObject(payload.repository));\n\n  if (!repositoryUrl) {\n    return {\n      result: 'aborted',\n      reason:\n        'Bitbucket Server repo:refs_changed event did not include repository.links.self[0].href',\n    };\n  }\n\n  return {\n    result: 'ok',\n    events: [{ type: 'repository.updated', url: repositoryUrl }],\n  };\n}\n\nasync function onModifiedEvent(\n  payload: JsonObject,\n): Promise<AnalyzeBitbucketServerWebhookEventResult> {\n  const repositoryUrl = getRepositoryUrl(asObject(payload.new));\n  const oldRepositoryUrl = getRepositoryUrl(asObject(payload.old));\n\n  if (!repositoryUrl) {\n    return {\n      result: 'aborted',\n      reason:\n        'Bitbucket Server repo:modified event did not include new.links.self[0].href',\n    };\n  }\n\n  if (oldRepositoryUrl && oldRepositoryUrl !== repositoryUrl) {\n    return {\n      result: 'ok',\n      events: [\n        {\n          type: 'repository.moved',\n          fromUrl: oldRepositoryUrl,\n          toUrl: repositoryUrl,\n        },\n      ],\n    };\n  }\n\n  return {\n    result: 'ok',\n    events: [{ type: 'repository.updated', url: repositoryUrl }],\n  };\n}\n\n/**\n * Analyzes a Bitbucket Server webhook event and translates it into zero or more\n * catalog SCM events that entity providers can act on.\n *\n * Bitbucket Server push payloads do not include file-level change data, so only\n * repository-level events are produced (unlike the GitLab and Azure DevOps\n * analyzers which can emit fine-grained `location.*` events). Bitbucket Server\n * does not emit a repository deletion webhook, so no `repository.deleted` event\n * is produced.\n *\n * Supported event types:\n * - `repo:refs_changed` — emits a `repository.updated` event to trigger catalog\n *   refresh for the repository.\n * - `repo:modified` — translates repository renames into `repository.moved`\n *   events, or emits `repository.updated` for other metadata changes.\n *\n * @alpha\n */\nexport async function analyzeBitbucketServerWebhookEvent(\n  eventType: string,\n  eventPayload: unknown,\n): Promise<AnalyzeBitbucketServerWebhookEventResult> {\n  const payload = asObject(eventPayload);\n  if (!payload) {\n    throw new InputError(\n      'Bitbucket Server webhook event payload is not an object',\n    );\n  }\n\n  switch (eventType) {\n    case 'repo:refs_changed':\n      return onRefsChangedEvent(payload);\n    case 'repo:modified':\n      return onModifiedEvent(payload);\n    default:\n      return { result: 'unsupported-event', event: eventType };\n  }\n}\n"],"names":["InputError"],"mappings":";;;;AAiDA,SAAS,SAAS,KAAA,EAAwC;AACxD,EAAA,IAAI,CAAC,SAAS,OAAO,KAAA,KAAU,YAAY,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AAC/D,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,OAAO,KAAA;AACT;AAEA,SAAS,QAAQ,KAAA,EAAuC;AACtD,EAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,GAAI,KAAA,GAAQ,MAAA;AACxC;AAEA,SAAS,SAAS,KAAA,EAAoC;AACpD,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,GAAW,KAAA,GAAQ,MAAA;AAC7C;AAEA,SAAS,iBACP,UAAA,EACoB;AACpB,EAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,UAAA,EAAY,KAAK,CAAA;AACxC,EAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,KAAA,EAAO,IAAI,CAAA;AAChC,EAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,IAAA,GAAO,CAAC,CAAC,CAAA;AAChC,EAAA,OAAO,QAAA,CAAS,OAAO,IAAI,CAAA;AAC7B;AAEA,eAAe,mBACb,OAAA,EACmD;AACnD,EAAA,MAAM,aAAA,GAAgB,gBAAA,CAAiB,QAAA,CAAS,OAAA,CAAQ,UAAU,CAAC,CAAA;AAEnE,EAAA,IAAI,CAAC,aAAA,EAAe;AAClB,IAAA,OAAO;AAAA,MACL,MAAA,EAAQ,SAAA;AAAA,MACR,MAAA,EACE;AAAA,KACJ;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,MAAA,EAAQ,IAAA;AAAA,IACR,QAAQ,CAAC,EAAE,MAAM,oBAAA,EAAsB,GAAA,EAAK,eAAe;AAAA,GAC7D;AACF;AAEA,eAAe,gBACb,OAAA,EACmD;AACnD,EAAA,MAAM,aAAA,GAAgB,gBAAA,CAAiB,QAAA,CAAS,OAAA,CAAQ,GAAG,CAAC,CAAA;AAC5D,EAAA,MAAM,gBAAA,GAAmB,gBAAA,CAAiB,QAAA,CAAS,OAAA,CAAQ,GAAG,CAAC,CAAA;AAE/D,EAAA,IAAI,CAAC,aAAA,EAAe;AAClB,IAAA,OAAO;AAAA,MACL,MAAA,EAAQ,SAAA;AAAA,MACR,MAAA,EACE;AAAA,KACJ;AAAA,EACF;AAEA,EAAA,IAAI,gBAAA,IAAoB,qBAAqB,aAAA,EAAe;AAC1D,IAAA,OAAO;AAAA,MACL,MAAA,EAAQ,IAAA;AAAA,MACR,MAAA,EAAQ;AAAA,QACN;AAAA,UACE,IAAA,EAAM,kBAAA;AAAA,UACN,OAAA,EAAS,gBAAA;AAAA,UACT,KAAA,EAAO;AAAA;AACT;AACF,KACF;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,MAAA,EAAQ,IAAA;AAAA,IACR,QAAQ,CAAC,EAAE,MAAM,oBAAA,EAAsB,GAAA,EAAK,eAAe;AAAA,GAC7D;AACF;AAoBA,eAAsB,kCAAA,CACpB,WACA,YAAA,EACmD;AACnD,EAAA,MAAM,OAAA,GAAU,SAAS,YAAY,CAAA;AACrC,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,MAAM,IAAIA,iBAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AAEA,EAAA,QAAQ,SAAA;AAAW,IACjB,KAAK,mBAAA;AACH,MAAA,OAAO,mBAAmB,OAAO,CAAA;AAAA,IACnC,KAAK,eAAA;AACH,MAAA,OAAO,gBAAgB,OAAO,CAAA;AAAA,IAChC;AACE,MAAA,OAAO,EAAE,MAAA,EAAQ,mBAAA,EAAqB,KAAA,EAAO,SAAA,EAAU;AAAA;AAE7D;;;;"}

package/dist/module/catalogModuleBitbucketServerEntityProvider.cjs.js

@@ -2,8 +2,10 @@
 
 var backendPluginApi = require('@backstage/backend-plugin-api');
 var pluginCatalogNode = require('@backstage/plugin-catalog-node');
+var alpha = require('@backstage/plugin-catalog-node/alpha');
 var pluginEventsNode = require('@backstage/plugin-events-node');
 var BitbucketServerEntityProvider = require('../providers/BitbucketServerEntityProvider.cjs.js');
+var BitbucketServerScmEventsBridge = require('../events/BitbucketServerScmEventsBridge.cjs.js');
 
 const catalogModuleBitbucketServerEntityProvider = backendPluginApi.createBackendModule({
   pluginId: "catalog",
@@ -17,7 +19,9 @@ const catalogModuleBitbucketServerEntityProvider = backendPluginApi.createBacken
         events: pluginEventsNode.eventsServiceRef,
         logger: backendPluginApi.coreServices.logger,
         scheduler: backendPluginApi.coreServices.scheduler,
-        auth: backendPluginApi.coreServices.auth
+        auth: backendPluginApi.coreServices.auth,
+        catalogScmEvents: alpha.catalogScmEventsServiceRef,
+        lifecycle: backendPluginApi.coreServices.lifecycle
       },
       async init({
         catalog,
@@ -26,7 +30,9 @@ const catalogModuleBitbucketServerEntityProvider = backendPluginApi.createBacken
         events,
         logger,
         scheduler,
-        auth
+        auth,
+        catalogScmEvents,
+        lifecycle
       }) {
         const providers = BitbucketServerEntityProvider.BitbucketServerEntityProvider.fromConfig(config, {
           catalogApi,
@@ -36,6 +42,17 @@ const catalogModuleBitbucketServerEntityProvider = backendPluginApi.createBacken
           auth
         });
         catalog.addEntityProvider(providers);
+        const bridge = new BitbucketServerScmEventsBridge.BitbucketServerScmEventsBridge({
+          logger,
+          events,
+          catalogScmEvents
+        });
+        lifecycle.addStartupHook(async () => {
+          await bridge.start();
+        });
+        lifecycle.addShutdownHook(async () => {
+          await bridge.stop();
+        });
       }
     });
   }

package/dist/module/catalogModuleBitbucketServerEntityProvider.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalogModuleBitbucketServerEntityProvider.cjs.js","sources":["../../src/module/catalogModuleBitbucketServerEntityProvider.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  coreServices,\n  createBackendModule,\n} from '@backstage/backend-plugin-api';\nimport { catalogServiceRef } from '@backstage/plugin-catalog-node';\nimport { catalogProcessingExtensionPoint } from '@backstage/plugin-catalog-node';\nimport { eventsServiceRef } from '@backstage/plugin-events-node';\nimport { BitbucketServerEntityProvider } from '../providers/BitbucketServerEntityProvider';\n\n/**\n * @public\n */\nexport const catalogModuleBitbucketServerEntityProvider = createBackendModule({\n  pluginId: 'catalog',\n  moduleId: 'bitbucket-server-entity-provider',\n  register(env) {\n    env.registerInit({\n      deps: {\n        catalog: catalogProcessingExtensionPoint,\n        catalogApi: catalogServiceRef,\n        config: coreServices.rootConfig,\n        events: eventsServiceRef,\n        logger: coreServices.logger,\n        scheduler: coreServices.scheduler,\n        auth: coreServices.auth,\n      },\n      async init({\n        catalog,\n        catalogApi,\n        config,\n        events,\n        logger,\n        scheduler,\n        auth,\n      }) {\n        const providers = BitbucketServerEntityProvider.fromConfig(config, {\n          catalogApi,\n          events,\n          logger,\n          scheduler,\n          auth,\n        });\n\n        catalog.addEntityProvider(providers);\n      },\n    });\n  },\n});\n"],"names":["createBackendModule","catalogProcessingExtensionPoint","catalogServiceRef","coreServices","eventsServiceRef","BitbucketServerEntityProvider"],"mappings":";;;;;;;AA4BO,MAAM,6CAA6CA,oCAAA,CAAoB;AAAA,EAC5E,QAAA,EAAU,SAAA;AAAA,EACV,QAAA,EAAU,kCAAA;AAAA,EACV,SAAS,GAAA,EAAK;AACZ,IAAA,GAAA,CAAI,YAAA,CAAa;AAAA,MACf,IAAA,EAAM;AAAA,QACJ,OAAA,EAASC,iDAAA;AAAA,QACT,UAAA,EAAYC,mCAAA;AAAA,QACZ,QAAQC,6BAAA,CAAa,UAAA;AAAA,QACrB,MAAA,EAAQC,iCAAA;AAAA,QACR,QAAQD,6BAAA,CAAa,MAAA;AAAA,QACrB,WAAWA,6BAAA,CAAa,SAAA;AAAA,QACxB,MAAMA,6BAAA,CAAa;AAAA,OACrB;AAAA,MACA,MAAM,IAAA,CAAK;AAAA,QACT,OAAA;AAAA,QACA,UAAA;AAAA,QACA,MAAA;AAAA,QACA,MAAA;AAAA,QACA,MAAA;AAAA,QACA,SAAA;AAAA,QACA;AAAA,OACF,EAAG;AACD,QAAA,MAAM,SAAA,GAAYE,2DAAA,CAA8B,UAAA,CAAW,MAAA,EAAQ;AAAA,UACjE,UAAA;AAAA,UACA,MAAA;AAAA,UACA,MAAA;AAAA,UACA,SAAA;AAAA,UACA;AAAA,SACD,CAAA;AAED,QAAA,OAAA,CAAQ,kBAAkB,SAAS,CAAA;AAAA,MACrC;AAAA,KACD,CAAA;AAAA,EACH;AACF,CAAC;;;;"}
+{"version":3,"file":"catalogModuleBitbucketServerEntityProvider.cjs.js","sources":["../../src/module/catalogModuleBitbucketServerEntityProvider.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  coreServices,\n  createBackendModule,\n} from '@backstage/backend-plugin-api';\nimport { catalogServiceRef } from '@backstage/plugin-catalog-node';\nimport { catalogProcessingExtensionPoint } from '@backstage/plugin-catalog-node';\nimport { catalogScmEventsServiceRef } from '@backstage/plugin-catalog-node/alpha';\nimport { eventsServiceRef } from '@backstage/plugin-events-node';\nimport { BitbucketServerEntityProvider } from '../providers/BitbucketServerEntityProvider';\nimport { BitbucketServerScmEventsBridge } from '../events/BitbucketServerScmEventsBridge';\n\n/**\n * @public\n */\nexport const catalogModuleBitbucketServerEntityProvider = createBackendModule({\n  pluginId: 'catalog',\n  moduleId: 'bitbucket-server-entity-provider',\n  register(env) {\n    env.registerInit({\n      deps: {\n        catalog: catalogProcessingExtensionPoint,\n        catalogApi: catalogServiceRef,\n        config: coreServices.rootConfig,\n        events: eventsServiceRef,\n        logger: coreServices.logger,\n        scheduler: coreServices.scheduler,\n        auth: coreServices.auth,\n        catalogScmEvents: catalogScmEventsServiceRef,\n        lifecycle: coreServices.lifecycle,\n      },\n      async init({\n        catalog,\n        catalogApi,\n        config,\n        events,\n        logger,\n        scheduler,\n        auth,\n        catalogScmEvents,\n        lifecycle,\n      }) {\n        const providers = BitbucketServerEntityProvider.fromConfig(config, {\n          catalogApi,\n          events,\n          logger,\n          scheduler,\n          auth,\n        });\n\n        catalog.addEntityProvider(providers);\n\n        const bridge = new BitbucketServerScmEventsBridge({\n          logger,\n          events,\n          catalogScmEvents,\n        });\n        lifecycle.addStartupHook(async () => {\n          await bridge.start();\n        });\n        lifecycle.addShutdownHook(async () => {\n          await bridge.stop();\n        });\n      },\n    });\n  },\n});\n"],"names":["createBackendModule","catalogProcessingExtensionPoint","catalogServiceRef","coreServices","eventsServiceRef","catalogScmEventsServiceRef","BitbucketServerEntityProvider","BitbucketServerScmEventsBridge"],"mappings":";;;;;;;;;AA8BO,MAAM,6CAA6CA,oCAAA,CAAoB;AAAA,EAC5E,QAAA,EAAU,SAAA;AAAA,EACV,QAAA,EAAU,kCAAA;AAAA,EACV,SAAS,GAAA,EAAK;AACZ,IAAA,GAAA,CAAI,YAAA,CAAa;AAAA,MACf,IAAA,EAAM;AAAA,QACJ,OAAA,EAASC,iDAAA;AAAA,QACT,UAAA,EAAYC,mCAAA;AAAA,QACZ,QAAQC,6BAAA,CAAa,UAAA;AAAA,QACrB,MAAA,EAAQC,iCAAA;AAAA,QACR,QAAQD,6BAAA,CAAa,MAAA;AAAA,QACrB,WAAWA,6BAAA,CAAa,SAAA;AAAA,QACxB,MAAMA,6BAAA,CAAa,IAAA;AAAA,QACnB,gBAAA,EAAkBE,gCAAA;AAAA,QAClB,WAAWF,6BAAA,CAAa;AAAA,OAC1B;AAAA,MACA,MAAM,IAAA,CAAK;AAAA,QACT,OAAA;AAAA,QACA,UAAA;AAAA,QACA,MAAA;AAAA,QACA,MAAA;AAAA,QACA,MAAA;AAAA,QACA,SAAA;AAAA,QACA,IAAA;AAAA,QACA,gBAAA;AAAA,QACA;AAAA,OACF,EAAG;AACD,QAAA,MAAM,SAAA,GAAYG,2DAAA,CAA8B,UAAA,CAAW,MAAA,EAAQ;AAAA,UACjE,UAAA;AAAA,UACA,MAAA;AAAA,UACA,MAAA;AAAA,UACA,SAAA;AAAA,UACA;AAAA,SACD,CAAA;AAED,QAAA,OAAA,CAAQ,kBAAkB,SAAS,CAAA;AAEnC,QAAA,MAAM,MAAA,GAAS,IAAIC,6DAAA,CAA+B;AAAA,UAChD,MAAA;AAAA,UACA,MAAA;AAAA,UACA;AAAA,SACD,CAAA;AACD,QAAA,SAAA,CAAU,eAAe,YAAY;AACnC,UAAA,MAAM,OAAO,KAAA,EAAM;AAAA,QACrB,CAAC,CAAA;AACD,QAAA,SAAA,CAAU,gBAAgB,YAAY;AACpC,UAAA,MAAM,OAAO,IAAA,EAAK;AAAA,QACpB,CAAC,CAAA;AAAA,MACH;AAAA,KACD,CAAA;AAAA,EACH;AACF,CAAC;;;;"}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@backstage/plugin-catalog-backend-module-bitbucket-server",
-  "version": "0.5.11",
+  "version": "0.5.12",
   "backstage": {
     "role": "backend-plugin-module",
     "pluginId": "catalog",
     "pluginPackage": "@backstage/plugin-catalog-backend",
     "features": {
-      ".": "@backstage/BackendFeature"
+      ".": "@backstage/BackendFeature",
+      "./alpha": "@backstage/BackendFeature"
     }
   },
   "publishConfig": {
@@ -29,12 +30,21 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.cjs.js"
     },
+    "./alpha": {
+      "backstage": "@backstage/BackendFeature",
+      "require": "./dist/alpha.cjs.js",
+      "types": "./dist/alpha.d.ts",
+      "default": "./dist/alpha.cjs.js"
+    },
     "./package.json": "./package.json"
   },
   "main": "./dist/index.cjs.js",
   "types": "./dist/index.d.ts",
   "typesVersions": {
     "*": {
+      "alpha": [
+        "dist/alpha.d.ts"
+      ],
       "package.json": [
         "package.json"
       ]
@@ -54,19 +64,19 @@
     "test": "backstage-cli package test"
   },
   "dependencies": {
-    "@backstage/backend-plugin-api": "^1.9.1",
+    "@backstage/backend-plugin-api": "^1.9.2",
     "@backstage/catalog-model": "^1.9.0",
     "@backstage/config": "^1.3.8",
     "@backstage/errors": "^1.3.1",
-    "@backstage/integration": "^2.0.2",
+    "@backstage/integration": "^2.0.3",
     "@backstage/plugin-catalog-common": "^1.1.10",
-    "@backstage/plugin-catalog-node": "^2.2.1",
-    "@backstage/plugin-events-node": "^0.4.22"
+    "@backstage/plugin-catalog-node": "^2.2.2",
+    "@backstage/plugin-events-node": "^0.4.23"
   },
   "devDependencies": {
-    "@backstage/backend-test-utils": "^1.11.3",
-    "@backstage/cli": "^0.36.2",
-    "@backstage/plugin-events-backend-test-utils": "^0.1.55",
+    "@backstage/backend-test-utils": "^1.11.4",
+    "@backstage/cli": "^0.36.3",
+    "@backstage/plugin-events-backend-test-utils": "^0.1.56",
     "msw": "^1.0.0"
   },
   "configSchema": "config.d.ts"