@backstage/plugin-catalog-backend-module-bitbucket-server 0.5.12-next.0 → 0.5.13-next.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @backstage/plugin-catalog-backend-module-bitbucket-server
 
+## 0.5.13-next.0
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/backend-plugin-api@1.9.3-next.0
+  - @backstage/plugin-catalog-node@2.2.3-next.0
+  - @backstage/plugin-events-node@0.4.24-next.0
+
+## 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

package/config.schema.json

@@ -0,0 +1,406 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "catalog": {
+      "type": "object",
+      "properties": {
+        "providers": {
+          "type": "object",
+          "properties": {
+            "bitbucketServer": {
+              "anyOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "catalogPath": {
+                      "type": "string",
+                      "description": "(Optional) Path to the catalog file. Default to \"/catalog-info.yaml\".",
+                      "visibility": "frontend"
+                    },
+                    "filters": {
+                      "type": "object",
+                      "properties": {
+                        "repoSlug": {
+                          "type": "string",
+                          "description": "(Optional) Regular expression filter for the repository slug.",
+                          "visibility": "frontend"
+                        },
+                        "projectKey": {
+                          "type": "string",
+                          "description": "(Optional) Regular expression filter for the project key.",
+                          "visibility": "frontend"
+                        },
+                        "skipArchivedRepos": {
+                          "type": "boolean",
+                          "description": "(Optional) Skip archived repositories"
+                        }
+                      },
+                      "description": "(Optional) Filters applied to discovered catalog files in repositories.",
+                      "visibility": "frontend"
+                    },
+                    "validateLocationsExist": {
+                      "type": "boolean",
+                      "description": "(Optional) Whether to validate locations that exist before emitting them. Default: `false`."
+                    },
+                    "schedule": {
+                      "type": "object",
+                      "properties": {
+                        "frequency": {
+                          "anyOf": [
+                            {
+                              "type": "object",
+                              "properties": {
+                                "cron": {
+                                  "type": "string",
+                                  "description": "A crontab style string."
+                                }
+                              },
+                              "required": [
+                                "cron"
+                              ]
+                            },
+                            {
+                              "type": "string"
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "years": {
+                                  "type": "number"
+                                },
+                                "months": {
+                                  "type": "number"
+                                },
+                                "weeks": {
+                                  "type": "number"
+                                },
+                                "days": {
+                                  "type": "number"
+                                },
+                                "hours": {
+                                  "type": "number"
+                                },
+                                "minutes": {
+                                  "type": "number"
+                                },
+                                "seconds": {
+                                  "type": "number"
+                                },
+                                "milliseconds": {
+                                  "type": "number"
+                                }
+                              },
+                              "description": "Human friendly durations object."
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "trigger": {
+                                  "type": "string",
+                                  "const": "manual"
+                                }
+                              },
+                              "required": [
+                                "trigger"
+                              ]
+                            }
+                          ],
+                          "description": "How often you want the task to run. The system does its best to avoid overlapping invocations."
+                        },
+                        "timeout": {
+                          "anyOf": [
+                            {
+                              "type": "string"
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "years": {
+                                  "type": "number"
+                                },
+                                "months": {
+                                  "type": "number"
+                                },
+                                "weeks": {
+                                  "type": "number"
+                                },
+                                "days": {
+                                  "type": "number"
+                                },
+                                "hours": {
+                                  "type": "number"
+                                },
+                                "minutes": {
+                                  "type": "number"
+                                },
+                                "seconds": {
+                                  "type": "number"
+                                },
+                                "milliseconds": {
+                                  "type": "number"
+                                }
+                              },
+                              "description": "Human friendly durations object."
+                            }
+                          ],
+                          "description": "The maximum amount of time that a single task invocation can take, before it's considered timed out and gets \"released\" such that a new invocation is permitted to take place (possibly, then, on a different worker)."
+                        },
+                        "initialDelay": {
+                          "anyOf": [
+                            {
+                              "type": "string"
+                            },
+                            {
+                              "type": "object",
+                              "properties": {
+                                "years": {
+                                  "type": "number"
+                                },
+                                "months": {
+                                  "type": "number"
+                                },
+                                "weeks": {
+                                  "type": "number"
+                                },
+                                "days": {
+                                  "type": "number"
+                                },
+                                "hours": {
+                                  "type": "number"
+                                },
+                                "minutes": {
+                                  "type": "number"
+                                },
+                                "seconds": {
+                                  "type": "number"
+                                },
+                                "milliseconds": {
+                                  "type": "number"
+                                }
+                              },
+                              "description": "Human friendly durations object."
+                            }
+                          ],
+                          "description": "The amount of time that should pass before the first invocation happens."
+                        },
+                        "scope": {
+                          "type": "string",
+                          "enum": [
+                            "global",
+                            "local"
+                          ],
+                          "description": "Sets the scope of concurrency control / locking to apply for invocations of this task."
+                        }
+                      },
+                      "required": [
+                        "frequency",
+                        "timeout"
+                      ],
+                      "description": "(Optional) TaskScheduleDefinition for the refresh."
+                    }
+                  }
+                },
+                {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "object",
+                    "properties": {
+                      "catalogPath": {
+                        "type": "string",
+                        "description": "(Optional) Path to the catalog file. Default to \"/catalog-info.yaml\".",
+                        "visibility": "frontend"
+                      },
+                      "filters": {
+                        "type": "object",
+                        "properties": {
+                          "repoSlug": {
+                            "type": "string",
+                            "description": "(Optional) Regular expression filter for the repository slug.",
+                            "visibility": "frontend"
+                          },
+                          "projectKey": {
+                            "type": "string",
+                            "description": "(Optional) Regular expression filter for the project key.",
+                            "visibility": "frontend"
+                          },
+                          "skipArchivedRepos": {
+                            "type": "boolean",
+                            "description": "(Optional) Skip archived repositories"
+                          }
+                        },
+                        "description": "(Optional) Filters applied to discovered catalog files in repositories.",
+                        "visibility": "frontend"
+                      },
+                      "validateLocationsExist": {
+                        "type": "boolean",
+                        "description": "(Optional) Whether to validate locations that exist before emitting them. Default: `false`."
+                      },
+                      "schedule": {
+                        "type": "object",
+                        "properties": {
+                          "frequency": {
+                            "anyOf": [
+                              {
+                                "type": "object",
+                                "properties": {
+                                  "cron": {
+                                    "type": "string",
+                                    "description": "A crontab style string."
+                                  }
+                                },
+                                "required": [
+                                  "cron"
+                                ]
+                              },
+                              {
+                                "type": "string"
+                              },
+                              {
+                                "type": "object",
+                                "properties": {
+                                  "years": {
+                                    "type": "number"
+                                  },
+                                  "months": {
+                                    "type": "number"
+                                  },
+                                  "weeks": {
+                                    "type": "number"
+                                  },
+                                  "days": {
+                                    "type": "number"
+                                  },
+                                  "hours": {
+                                    "type": "number"
+                                  },
+                                  "minutes": {
+                                    "type": "number"
+                                  },
+                                  "seconds": {
+                                    "type": "number"
+                                  },
+                                  "milliseconds": {
+                                    "type": "number"
+                                  }
+                                },
+                                "description": "Human friendly durations object."
+                              },
+                              {
+                                "type": "object",
+                                "properties": {
+                                  "trigger": {
+                                    "type": "string",
+                                    "const": "manual"
+                                  }
+                                },
+                                "required": [
+                                  "trigger"
+                                ]
+                              }
+                            ],
+                            "description": "How often you want the task to run. The system does its best to avoid overlapping invocations."
+                          },
+                          "timeout": {
+                            "anyOf": [
+                              {
+                                "type": "string"
+                              },
+                              {
+                                "type": "object",
+                                "properties": {
+                                  "years": {
+                                    "type": "number"
+                                  },
+                                  "months": {
+                                    "type": "number"
+                                  },
+                                  "weeks": {
+                                    "type": "number"
+                                  },
+                                  "days": {
+                                    "type": "number"
+                                  },
+                                  "hours": {
+                                    "type": "number"
+                                  },
+                                  "minutes": {
+                                    "type": "number"
+                                  },
+                                  "seconds": {
+                                    "type": "number"
+                                  },
+                                  "milliseconds": {
+                                    "type": "number"
+                                  }
+                                },
+                                "description": "Human friendly durations object."
+                              }
+                            ],
+                            "description": "The maximum amount of time that a single task invocation can take, before it's considered timed out and gets \"released\" such that a new invocation is permitted to take place (possibly, then, on a different worker)."
+                          },
+                          "initialDelay": {
+                            "anyOf": [
+                              {
+                                "type": "string"
+                              },
+                              {
+                                "type": "object",
+                                "properties": {
+                                  "years": {
+                                    "type": "number"
+                                  },
+                                  "months": {
+                                    "type": "number"
+                                  },
+                                  "weeks": {
+                                    "type": "number"
+                                  },
+                                  "days": {
+                                    "type": "number"
+                                  },
+                                  "hours": {
+                                    "type": "number"
+                                  },
+                                  "minutes": {
+                                    "type": "number"
+                                  },
+                                  "seconds": {
+                                    "type": "number"
+                                  },
+                                  "milliseconds": {
+                                    "type": "number"
+                                  }
+                                },
+                                "description": "Human friendly durations object."
+                              }
+                            ],
+                            "description": "The amount of time that should pass before the first invocation happens."
+                          },
+                          "scope": {
+                            "type": "string",
+                            "enum": [
+                              "global",
+                              "local"
+                            ],
+                            "description": "Sets the scope of concurrency control / locking to apply for invocations of this task."
+                          }
+                        },
+                        "required": [
+                          "frequency",
+                          "timeout"
+                        ],
+                        "description": "(Optional) TaskScheduleDefinition for the refresh."
+                      }
+                    }
+                  }
+                }
+              ],
+              "description": "BitbucketServerEntityProvider configuration\n\nUses \"default\" as default id for the single config variant."
+            }
+          }
+        }
+      }
+    }
+  }
+}

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":";;;;AAyBO,MAAM,8BAAA,CAA+B;AAAA,EACjC,OAAA;AAAA,EACA,OAAA;AAAA,EACA,iBAAA;AAAA,EACT,aAAA;AAAA,EACA,eAAA;AAAA,EAEA,YAAY,OAAA,EAIT;AACD,IAAA,IAAA,CAAK,UAAU,OAAA,CAAQ,MAAA;AACvB,IAAA,IAAA,CAAK,UAAU,OAAA,CAAQ,MAAA;AACvB,IAAA,IAAA,CAAK,oBAAoB,OAAA,CAAQ,gBAAA;AACjC,IAAA,IAAA,CAAK,aAAA,GAAgB,KAAA;AAAA,EACvB;AAAA,EAEA,MAAM,KAAA,GAAQ;AACZ,IAAA,MAAM,IAAA,CAAK,QAAQ,SAAA,CAAU;AAAA,MAC3B,EAAA,EAAI,4CAAA;AAAA,MACJ,MAAA,EAAQ,CAAC,iBAAiB,CAAA;AAAA,MAC1B,OAAA,EAAS,IAAA,CAAK,QAAA,CAAS,IAAA,CAAK,IAAI;AAAA,KACjC,CAAA;AAAA,EACH;AAAA,EAEA,MAAM,IAAA,GAAO;AACX,IAAA,IAAA,CAAK,aAAA,GAAgB,IAAA;AACrB,IAAA,MAAM,IAAA,CAAK,eAAA;AAAA,EACb;AAAA,EAEA,MAAM,SAAS,MAAA,EAAoC;AACjD,IAAA,MAAM,SAAA,GACH,OAAO,QAAA,GAAW,aAAa,KAChC,IAAA,CAAK,0BAAA,CAA2B,OAAO,KAAK,CAAA;AAC9C,IAAA,IAAI,CAAC,SAAA,IAAa,CAAC,MAAA,CAAO,YAAA,EAAc;AACtC,MAAA;AAAA,IACF;AAEA,IAAA,OAAO,KAAK,eAAA,EAAiB;AAC3B,MAAA,MAAM,IAAA,CAAK,eAAA;AAAA,IACb;AAEA,IAAA,IAAI,KAAK,aAAA,EAAe;AACtB,MAAA,IAAA,CAAK,OAAA,CAAQ,IAAA;AAAA,QACX,CAAA,iDAAA,EAAoD,SAAS,CAAA,YAAA,EAAe,MAAA,CAAO,KAAK,CAAA,qCAAA;AAAA,OAC1F;AACA,MAAA;AAAA,IACF;AAEA,IAAA,IAAA,CAAK,eAAA,GAAkB,OAAA,CAAQ,OAAA,EAAQ,CAAE,KAAK,YAAY;AACxD,MAAA,IAAI;AACF,QAAA,MAAM,SAAS,MAAMA,qEAAA;AAAA,UACnB,SAAA;AAAA,UACA,MAAA,CAAO;AAAA,SACT;AAEA,QAAA,IAAI,MAAA,CAAO,WAAW,IAAA,EAAM;AAC1B,UAAA,MAAM,IAAA,CAAK,iBAAA,CAAkB,OAAA,CAAQ,MAAA,CAAO,MAAM,CAAA;AAAA,QACpD,CAAA,MAAA,IAAW,MAAA,CAAO,MAAA,KAAW,SAAA,EAAW;AACtC,UAAA,IAAA,CAAK,OAAA,CAAQ,KAAA;AAAA,YACX,oDAAoD,SAAS,CAAA,YAAA,EAAe,OAAO,KAAK,CAAA,yBAAA,EAA4B,OAAO,MAAM,CAAA;AAAA,WACnI;AAAA,QACF,CAAA,MAAA,IAAW,MAAA,CAAO,MAAA,KAAW,SAAA,EAAW;AACtC,UAAA,IAAA,CAAK,OAAA,CAAQ,IAAA;AAAA,YACX,oDAAoD,SAAS,CAAA,YAAA,EAAe,OAAO,KAAK,CAAA,yBAAA,EAA4B,OAAO,MAAM,CAAA;AAAA,WACnI;AAAA,QACF,CAAA,MAAA,IAAW,MAAA,CAAO,MAAA,KAAW,mBAAA,EAAqB;AAChD,UAAA,IAAA,CAAK,OAAA,CAAQ,KAAA;AAAA,YACX,oDAAoD,SAAS,CAAA,YAAA,EAAe,OAAO,KAAK,CAAA,6BAAA,EAAgC,OAAO,KAAK,CAAA;AAAA,WACtI;AAAA,QACF;AAAA,MACF,SAAS,KAAA,EAAO;AACd,QAAA,IAAA,CAAK,OAAA,CAAQ,IAAA;AAAA,UACX,4DAA4D,SAAS,CAAA,CAAA,CAAA;AAAA,UACrE;AAAA,SACF;AAAA,MACF,CAAA,SAAE;AACA,QAAA,IAAA,CAAK,eAAA,GAAkB,MAAA;AAAA,MACzB;AAAA,IACF,CAAC,CAAA;AAED,IAAA,MAAM,IAAA,CAAK,eAAA;AAAA,EACb;AAAA,EAEA,2BAA2B,KAAA,EAAmC;AAC5D,IAAA,IAAI,KAAA,CAAM,UAAA,CAAW,kBAAkB,CAAA,EAAG;AACxC,MAAA,OAAO,KAAA,CAAM,KAAA,CAAM,kBAAA,CAAmB,MAAM,CAAA;AAAA,IAC9C;AACA,IAAA,OAAO,MAAA;AAAA,EACT;AACF;;;;"}

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.12-next.0",
+  "version": "0.5.13-next.0",
   "backstage": {
     "role": "backend-plugin-module",
     "pluginId": "catalog",
     "pluginPackage": "@backstage/plugin-catalog-backend",
     "features": {
-      ".": "@backstage/BackendFeature"
+      ".": "@backstage/BackendFeature",
+      "./alpha": "@backstage/BackendFeature"
     }
   },
   "publishConfig": {
@@ -29,19 +30,28 @@
       "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"
       ]
     }
   },
   "files": [
-    "config.d.ts",
+    "config.schema.json",
     "dist"
   ],
   "scripts": {
@@ -54,20 +64,20 @@
     "test": "backstage-cli package test"
   },
   "dependencies": {
-    "@backstage/backend-plugin-api": "1.9.2-next.0",
+    "@backstage/backend-plugin-api": "1.9.3-next.0",
     "@backstage/catalog-model": "1.9.0",
     "@backstage/config": "1.3.8",
     "@backstage/errors": "1.3.1",
-    "@backstage/integration": "2.0.3-next.0",
+    "@backstage/integration": "2.0.3",
     "@backstage/plugin-catalog-common": "1.1.10",
-    "@backstage/plugin-catalog-node": "2.2.2-next.0",
-    "@backstage/plugin-events-node": "0.4.23-next.0"
+    "@backstage/plugin-catalog-node": "2.2.3-next.0",
+    "@backstage/plugin-events-node": "0.4.24-next.0"
   },
   "devDependencies": {
-    "@backstage/backend-test-utils": "1.11.4-next.0",
-    "@backstage/cli": "0.36.3-next.0",
-    "@backstage/plugin-events-backend-test-utils": "0.1.56-next.0",
+    "@backstage/backend-test-utils": "1.11.5-next.0",
+    "@backstage/cli": "0.36.4-next.0",
+    "@backstage/plugin-events-backend-test-utils": "0.1.57-next.0",
     "msw": "^1.0.0"
   },
-  "configSchema": "config.d.ts"
+  "configSchema": "config.schema.json"
 }

package/config.d.ts

@@ -1,104 +0,0 @@
-/*
- * 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.
- */
-
-import { SchedulerServiceTaskScheduleDefinitionConfig } from '@backstage/backend-plugin-api';
-
-export interface Config {
-  catalog?: {
-    providers?: {
-      /**
-       * BitbucketServerEntityProvider configuration
-       *
-       * Uses "default" as default id for the single config variant.
-       */
-      bitbucketServer?:
-        | {
-            /**
-             * (Optional) Path to the catalog file. Default to "/catalog-info.yaml".
-             * @visibility frontend
-             */
-            catalogPath?: string;
-            /**
-             * (Optional) Filters applied to discovered catalog files in repositories.
-             * @visibility frontend
-             */
-            filters?: {
-              /**
-               * (Optional) Regular expression filter for the repository slug.
-               * @visibility frontend
-               */
-              repoSlug?: string;
-              /**
-               * (Optional) Regular expression filter for the project key.
-               * @visibility frontend
-               */
-              projectKey?: string;
-              /**
-               * (Optional) Skip archived repositories
-               */
-              skipArchivedRepos?: boolean;
-            };
-            /**
-             * (Optional) Whether to validate locations that exist before emitting them.
-             * Default: `false`.
-             */
-            validateLocationsExist?: boolean;
-            /**
-             * (Optional) TaskScheduleDefinition for the refresh.
-             */
-            schedule?: SchedulerServiceTaskScheduleDefinitionConfig;
-          }
-        | {
-            [name: string]: {
-              /**
-               * (Optional) Path to the catalog file. Default to "/catalog-info.yaml".
-               * @visibility frontend
-               */
-              catalogPath?: string;
-              /**
-               * (Optional) Filters applied to discovered catalog files in repositories.
-               * @visibility frontend
-               */
-              filters?: {
-                /**
-                 * (Optional) Regular expression filter for the repository slug.
-                 * @visibility frontend
-                 */
-                repoSlug?: string;
-                /**
-                 * (Optional) Regular expression filter for the project key.
-                 * @visibility frontend
-                 */
-                projectKey?: string;
-                /**
-                 * (Optional) Skip archived repositories
-                 */
-                skipArchivedRepos?: boolean;
-              };
-              /**
-               * (Optional) Whether to validate locations that exist before emitting them.
-               * Default: `false`.
-               */
-              validateLocationsExist?: boolean;
-              /**
-               * (Optional) TaskScheduleDefinition for the refresh.
-               */
-              schedule?: SchedulerServiceTaskScheduleDefinitionConfig;
-            };
-          };
-    };
-  };
-}