@backstage/plugin-catalog-backend-module-bitbucket-server 0.0.0-nightly-20220810023539

package/CHANGELOG.md

@@ -0,0 +1,118 @@
+# @backstage/plugin-catalog-backend-module-bitbucket-server
+
+## 0.0.0-nightly-20220810023539
+
+### Minor Changes
+
+- f7607f9d85: Add new plugin catalog-backend-module-bitbucket-server which adds the `BitbucketServerEntityProvider`.
+
+  The entity provider is meant as a replacement for the `BitbucketDiscoveryProcessor` to be used with Bitbucket Server (Bitbucket Cloud already has a replacement).
+
+  **Before:**
+
+  ```typescript
+  // packages/backend/src/plugins/catalog.ts
+  builder.addProcessor(
+    BitbucketDiscoveryProcessor.fromConfig(env.config, { logger: env.logger }),
+  );
+  ```
+
+  ```yaml
+  # app-config.yaml
+  catalog:
+    locations:
+      - type: bitbucket-discovery
+        target: 'https://bitbucket.mycompany.com/projects/*/repos/*/catalog-info.yaml
+  ```
+
+  **After:**
+
+  ```typescript
+  // packages/backend/src/plugins/catalog.ts
+  builder.addEntityProvider(
+    BitbucketServerEntityProvider.fromConfig(env.config, {
+      logger: env.logger,
+      schedule: env.scheduler.createScheduledTaskRunner({
+        frequency: { minutes: 30 },
+        timeout: { minutes: 3 },
+      }),
+    }),
+  );
+  ```
+
+  ```yaml
+  # app-config.yaml
+  catalog:
+    providers:
+      bitbucketServer:
+        yourProviderId: # identifies your ingested dataset
+          catalogPath: /catalog-info.yaml # default value
+          filters: # optional
+            projectKey: '.*' # optional; RegExp
+            repoSlug: '.*' # optional; RegExp
+  ```
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/backend-common@0.0.0-nightly-20220810023539
+  - @backstage/integration@0.0.0-nightly-20220810023539
+  - @backstage/backend-tasks@0.0.0-nightly-20220810023539
+  - @backstage/plugin-catalog-backend@0.0.0-nightly-20220810023539
+
+## 0.1.0-next.0
+
+### Minor Changes
+
+- f7607f9d85: Add new plugin catalog-backend-module-bitbucket-server which adds the `BitbucketServerEntityProvider`.
+
+  The entity provider is meant as a replacement for the `BitbucketDiscoveryProcessor` to be used with Bitbucket Server (Bitbucket Cloud already has a replacement).
+
+  **Before:**
+
+  ```typescript
+  // packages/backend/src/plugins/catalog.ts
+  builder.addProcessor(
+    BitbucketDiscoveryProcessor.fromConfig(env.config, { logger: env.logger }),
+  );
+  ```
+
+  ```yaml
+  # app-config.yaml
+  catalog:
+    locations:
+      - type: bitbucket-discovery
+        target: 'https://bitbucket.mycompany.com/projects/*/repos/*/catalog-info.yaml
+  ```
+
+  **After:**
+
+  ```typescript
+  // packages/backend/src/plugins/catalog.ts
+  builder.addEntityProvider(
+    BitbucketServerEntityProvider.fromConfig(env.config, {
+      logger: env.logger,
+      schedule: env.scheduler.createScheduledTaskRunner({
+        frequency: { minutes: 30 },
+        timeout: { minutes: 3 },
+      }),
+    }),
+  );
+  ```
+
+  ```yaml
+  # app-config.yaml
+  catalog:
+    providers:
+      bitbucketServer:
+        yourProviderId: # identifies your ingested dataset
+          catalogPath: /catalog-info.yaml # default value
+          filters: # optional
+            projectKey: '.*' # optional; RegExp
+            repoSlug: '.*' # optional; RegExp
+  ```
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/plugin-catalog-backend@1.3.1-next.2

package/README.md

@@ -0,0 +1,9 @@
+# Catalog Backend Module for Bitbucket Server
+
+This is an extension module to the catalog-backend plugin,
+providing extensions targeted at Bitbucket Server offerings.
+
+## Getting started
+
+See [Backstage documentation](https://backstage.io/docs/integrations/bitbucketServer/discovery)
+for details on how to install and configure the plugin.

package/config.d.ts

@@ -0,0 +1,80 @@
+/*
+ * 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.
+ */
+
+export interface Config {
+  catalog?: {
+    /**
+     * List of provider-specific options and attributes
+     */
+    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) Filter for the repository slug.
+               * @visibility frontend
+               */
+              repoSlug?: RegExp;
+              /**
+               * (Optional) Filter for the project key.
+               * @visibility frontend
+               */
+              projectKey?: RegExp;
+            };
+          }
+        | Record<
+            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) Filter for the repository slug.
+                 * @visibility frontend
+                 */
+                repoSlug?: RegExp;
+                /**
+                 * (Optional) Filter for the project key.
+                 * @visibility frontend
+                 */
+                projectKey?: RegExp;
+              };
+            }
+          >;
+    };
+  };
+}

package/dist/index.cjs.js

@@ -0,0 +1,269 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var crossFetch = require('cross-fetch');
+var integration = require('@backstage/integration');
+var uuid = require('uuid');
+var pluginCatalogBackend = require('@backstage/plugin-catalog-backend');
+var errors = require('@backstage/errors');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n["default"] = e;
+  return Object.freeze(n);
+}
+
+var uuid__namespace = /*#__PURE__*/_interopNamespace(uuid);
+
+class BitbucketServerClient {
+  static fromConfig(options) {
+    return new BitbucketServerClient(options);
+  }
+  constructor(options) {
+    this.config = options.config;
+  }
+  async listProjects(options) {
+    return this.pagedRequest(
+      `${this.config.apiBaseUrl}/projects`,
+      options.listOptions
+    );
+  }
+  async listRepositories(options) {
+    return this.pagedRequest(
+      `${this.config.apiBaseUrl}/projects/${encodeURIComponent(
+        options.projectKey
+      )}/repos`,
+      options.listOptions
+    );
+  }
+  async getFile(options) {
+    const base = new URL(this.config.apiBaseUrl);
+    return crossFetch.fetch(
+      `${base.protocol}//${base.host}/projects/${options.projectKey}/repos/${options.repo}/raw/${options.path}`,
+      integration.getBitbucketServerRequestOptions(this.config)
+    );
+  }
+  async getRepository(options) {
+    const request = `${this.config.apiBaseUrl}/projects/${options.projectKey}/repos/${options.repo}`;
+    const response = await crossFetch.fetch(
+      request,
+      integration.getBitbucketServerRequestOptions(this.config)
+    );
+    return response.json();
+  }
+  resolvePath(options) {
+    const base = new URL(this.config.apiBaseUrl || "");
+    return {
+      path: `${base.protocol}//${base.host}/projects/${options.projectKey}/repos/${options.repo}${options.path}`
+    };
+  }
+  async pagedRequest(endpoint, options) {
+    const request = new URL(endpoint);
+    for (const key in options) {
+      if (options[key]) {
+        request.searchParams.append(key, options[key].toString());
+      }
+    }
+    return this.getTypeMapped(request);
+  }
+  async getTypeMapped(url) {
+    return this.get(url).then((response) => {
+      return response.json();
+    });
+  }
+  async get(url) {
+    return this.request(new crossFetch.Request(url.toString(), { method: "GET" }));
+  }
+  async request(req) {
+    return crossFetch.fetch(req, integration.getBitbucketServerRequestOptions(this.config)).then(
+      (response) => {
+        if (!response.ok) {
+          throw new Error(
+            `Unexpected response for ${req.method} ${req.url}. Expected 200 but got ${response.status} - ${response.statusText}`
+          );
+        }
+        return response;
+      }
+    );
+  }
+}
+async function* paginated(request, options) {
+  const opts = options || { start: 0 };
+  let res;
+  do {
+    res = await request(opts);
+    opts.start = res.nextPageStart;
+    for (const item of res.values) {
+      yield item;
+    }
+  } while (!res.isLastPage);
+}
+
+const defaultBitbucketServerLocationParser = async function* defaultBitbucketServerLocationParser2(options) {
+  yield pluginCatalogBackend.locationSpecToLocationEntity({ location: options.location });
+};
+
+const DEFAULT_CATALOG_PATH = "/catalog-info.yaml";
+const DEFAULT_PROVIDER_ID = "default";
+function readProviderConfigs(config) {
+  const providersConfig = config.getOptionalConfig(
+    "catalog.providers.bitbucketServer"
+  );
+  if (!providersConfig) {
+    return [];
+  }
+  if (providersConfig.has("host")) {
+    return [readProviderConfig(DEFAULT_PROVIDER_ID, providersConfig)];
+  }
+  return providersConfig.keys().map((id) => {
+    const providerConfig = providersConfig.getConfig(id);
+    return readProviderConfig(id, providerConfig);
+  });
+}
+function readProviderConfig(id, config) {
+  var _a;
+  const host = config.getString("host");
+  const catalogPath = (_a = config.getOptionalString("catalogPath")) != null ? _a : DEFAULT_CATALOG_PATH;
+  const projectKeyPattern = config.getOptionalString("filters.projectKey");
+  const repoSlugPattern = config.getOptionalString("filters.repoSlug");
+  return {
+    id,
+    host,
+    catalogPath,
+    filters: {
+      projectKey: projectKeyPattern ? new RegExp(projectKeyPattern) : void 0,
+      repoSlug: repoSlugPattern ? new RegExp(repoSlugPattern) : void 0
+    }
+  };
+}
+
+class BitbucketServerEntityProvider {
+  static fromConfig(config, options) {
+    const integrations = integration.ScmIntegrations.fromConfig(config);
+    return readProviderConfigs(config).map((providerConfig) => {
+      const integration = integrations.bitbucketServer.byHost(
+        providerConfig.host
+      );
+      if (!integration) {
+        throw new errors.InputError(
+          `No BitbucketServer integration found that matches host ${providerConfig.host}`
+        );
+      }
+      return new BitbucketServerEntityProvider(
+        providerConfig,
+        integration,
+        options.logger,
+        options.schedule,
+        options.parser
+      );
+    });
+  }
+  constructor(config, integration, logger, schedule, parser) {
+    this.integration = integration;
+    this.config = config;
+    this.parser = parser || defaultBitbucketServerLocationParser;
+    this.logger = logger.child({
+      target: this.getProviderName()
+    });
+    this.scheduleFn = this.createScheduleFn(schedule);
+  }
+  createScheduleFn(schedule) {
+    return async () => {
+      const taskId = `${this.getProviderName()}:refresh`;
+      return schedule.run({
+        id: taskId,
+        fn: async () => {
+          const logger = this.logger.child({
+            class: BitbucketServerEntityProvider.prototype.constructor.name,
+            taskId,
+            taskInstanceId: uuid__namespace.v4()
+          });
+          try {
+            await this.refresh(logger);
+          } catch (error) {
+            logger.error(error);
+          }
+        }
+      });
+    };
+  }
+  getProviderName() {
+    return `bitbucketServer-provider:${this.config.id}`;
+  }
+  async connect(connection) {
+    this.connection = connection;
+    await this.scheduleFn();
+  }
+  async refresh(logger) {
+    if (!this.connection) {
+      throw new Error("Not initialized");
+    }
+    logger.info("Discovering catalog files in Bitbucket Server repositories");
+    const entities = await this.findEntities();
+    await this.connection.applyMutation({
+      type: "full",
+      entities: entities.map((entity) => ({
+        locationKey: this.getProviderName(),
+        entity
+      }))
+    });
+    logger.info(
+      `Committed ${entities.length} entities for Bitbucket Server repositories`
+    );
+  }
+  async findEntities() {
+    var _a, _b, _c, _d;
+    const client = BitbucketServerClient.fromConfig({
+      config: this.integration.config
+    });
+    const projects = paginated(
+      (options) => client.listProjects({ listOptions: options })
+    );
+    const result = [];
+    for await (const project of projects) {
+      if (((_b = (_a = this.config) == null ? void 0 : _a.filters) == null ? void 0 : _b.projectKey) && !this.config.filters.projectKey.test(project.key)) {
+        continue;
+      }
+      const repositories = paginated(
+        (options) => client.listRepositories({
+          projectKey: project.key,
+          listOptions: options
+        })
+      );
+      for await (const repository of repositories) {
+        if (((_d = (_c = this.config) == null ? void 0 : _c.filters) == null ? void 0 : _d.repoSlug) && !this.config.filters.repoSlug.test(repository.slug)) {
+          continue;
+        }
+        for await (const entity of this.parser({
+          client,
+          logger: this.logger,
+          location: {
+            type: "url",
+            target: `${repository.links.self[0].href}${this.config.catalogPath}`,
+            presence: "optional"
+          }
+        })) {
+          result.push(entity);
+        }
+      }
+    }
+    return result;
+  }
+}
+
+exports.BitbucketServerClient = BitbucketServerClient;
+exports.BitbucketServerEntityProvider = BitbucketServerEntityProvider;
+//# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":["../src/lib/BitbucketServerClient.ts","../src/providers/BitbucketServerLocationParser.ts","../src/providers/BitbucketServerEntityProviderConfig.ts","../src/providers/BitbucketServerEntityProvider.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 { fetch, Request } from 'cross-fetch';\nimport {\n  BitbucketServerIntegrationConfig,\n  getBitbucketServerRequestOptions,\n} from '@backstage/integration';\nimport { BitbucketServerProject, BitbucketServerRepository } from './types';\n\n/**\n * A client for interacting with a Bitbucket Server instance\n *\n * @public\n */\nexport class BitbucketServerClient {\n  private readonly config: BitbucketServerIntegrationConfig;\n\n  static fromConfig(options: {\n    config: BitbucketServerIntegrationConfig;\n  }): BitbucketServerClient {\n    return new BitbucketServerClient(options);\n  }\n\n  constructor(options: { config: BitbucketServerIntegrationConfig }) {\n    this.config = options.config;\n  }\n\n  async listProjects(options: {\n    listOptions?: BitbucketServerListOptions;\n  }): Promise<BitbucketServerPagedResponse<BitbucketServerProject>> {\n    return this.pagedRequest(\n      `${this.config.apiBaseUrl}/projects`,\n      options.listOptions,\n    );\n  }\n\n  async listRepositories(options: {\n    projectKey: string;\n    listOptions?: BitbucketServerListOptions;\n  }): Promise<BitbucketServerPagedResponse<BitbucketServerRepository>> {\n    return this.pagedRequest(\n      `${this.config.apiBaseUrl}/projects/${encodeURIComponent(\n        options.projectKey,\n      )}/repos`,\n      options.listOptions,\n    );\n  }\n\n  async getFile(options: {\n    projectKey: string;\n    repo: string;\n    path: string;\n  }): Promise<Response> {\n    const base = new URL(this.config.apiBaseUrl);\n    return fetch(\n      `${base.protocol}//${base.host}/projects/${options.projectKey}/repos/${options.repo}/raw/${options.path}`,\n      getBitbucketServerRequestOptions(this.config),\n    );\n  }\n\n  async getRepository(options: {\n    projectKey: string;\n    repo: string;\n  }): Promise<BitbucketServerRepository> {\n    const request = `${this.config.apiBaseUrl}/projects/${options.projectKey}/repos/${options.repo}`;\n    const response = await fetch(\n      request,\n      getBitbucketServerRequestOptions(this.config),\n    );\n    return response.json();\n  }\n\n  resolvePath(options: { projectKey: string; repo: string; path: string }): {\n    path: string;\n  } {\n    const base = new URL(this.config.apiBaseUrl || '');\n\n    return {\n      path: `${base.protocol}//${base.host}/projects/${options.projectKey}/repos/${options.repo}${options.path}`,\n    };\n  }\n\n  private async pagedRequest(\n    endpoint: string,\n    options?: BitbucketServerListOptions,\n  ): Promise<BitbucketServerPagedResponse<any>> {\n    const request = new URL(endpoint);\n    for (const key in options) {\n      if (options[key]) {\n        request.searchParams.append(key, options[key]!.toString());\n      }\n    }\n    return this.getTypeMapped(request);\n  }\n\n  private async getTypeMapped<T = any>(url: URL): Promise<T> {\n    return this.get(url).then((response: Response) => {\n      return response.json() as Promise<T>;\n    });\n  }\n\n  private async get(url: URL): Promise<Response> {\n    return this.request(new Request(url.toString(), { method: 'GET' }));\n  }\n\n  private async request(req: Request): Promise<Response> {\n    return fetch(req, getBitbucketServerRequestOptions(this.config)).then(\n      (response: Response) => {\n        if (!response.ok) {\n          throw new Error(\n            `Unexpected response for ${req.method} ${req.url}. Expected 200 but got ${response.status} - ${response.statusText}`,\n          );\n        }\n        return response;\n      },\n    );\n  }\n}\n\n/**\n * @public\n */\nexport type BitbucketServerListOptions = {\n  [key: string]: number | undefined;\n  limit?: number | undefined;\n  start?: number | undefined;\n};\n\n/**\n * @public\n */\nexport type BitbucketServerPagedResponse<T> = {\n  size: number;\n  limit: number;\n  start: number;\n  isLastPage: boolean;\n  values: T[];\n  nextPageStart: number;\n};\n\nexport async function* paginated(\n  request: (\n    options: BitbucketServerListOptions,\n  ) => Promise<BitbucketServerPagedResponse<any>>,\n  options?: BitbucketServerListOptions,\n) {\n  const opts = options || { start: 0 };\n  let res;\n  do {\n    res = await request(opts);\n    opts.start = res.nextPageStart;\n    for (const item of res.values) {\n      yield item;\n    }\n  } while (!res.isLastPage);\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 {\n  LocationSpec,\n  locationSpecToLocationEntity,\n} from '@backstage/plugin-catalog-backend';\nimport { Entity } from '@backstage/catalog-model';\nimport { Logger } from 'winston';\nimport { BitbucketServerClient } from '../lib';\n\n/**\n * A custom callback that reacts to finding a location by yielding entities.\n * Can be used for custom location/repository parsing logic.\n *\n * @public\n */\nexport type BitbucketServerLocationParser = (options: {\n  client: BitbucketServerClient;\n  location: LocationSpec;\n  logger: Logger;\n}) => AsyncIterable<Entity>;\n\nexport const defaultBitbucketServerLocationParser =\n  async function* defaultBitbucketServerLocationParser(options: {\n    location: LocationSpec;\n  }) {\n    yield locationSpecToLocationEntity({ location: options.location });\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 { Config } from '@backstage/config';\n\nconst DEFAULT_CATALOG_PATH = '/catalog-info.yaml';\nconst DEFAULT_PROVIDER_ID = 'default';\n\nexport type BitbucketServerEntityProviderConfig = {\n  id: string;\n  host: string;\n  catalogPath: string;\n  filters?: {\n    projectKey?: RegExp;\n    repoSlug?: RegExp;\n  };\n};\n\nexport function readProviderConfigs(\n  config: Config,\n): BitbucketServerEntityProviderConfig[] {\n  const providersConfig = config.getOptionalConfig(\n    'catalog.providers.bitbucketServer',\n  );\n  if (!providersConfig) {\n    return [];\n  }\n  if (providersConfig.has('host')) {\n    // simple/single config variant\n    return [readProviderConfig(DEFAULT_PROVIDER_ID, providersConfig)];\n  }\n\n  return providersConfig.keys().map(id => {\n    const providerConfig = providersConfig.getConfig(id);\n\n    return readProviderConfig(id, providerConfig);\n  });\n}\n\nfunction readProviderConfig(\n  id: string,\n  config: Config,\n): BitbucketServerEntityProviderConfig {\n  const host = config.getString('host');\n  const catalogPath =\n    config.getOptionalString('catalogPath') ?? DEFAULT_CATALOG_PATH;\n  const projectKeyPattern = config.getOptionalString('filters.projectKey');\n  const repoSlugPattern = config.getOptionalString('filters.repoSlug');\n\n  return {\n    id,\n    host,\n    catalogPath,\n    filters: {\n      projectKey: projectKeyPattern ? new RegExp(projectKeyPattern) : undefined,\n      repoSlug: repoSlugPattern ? new RegExp(repoSlugPattern) : undefined,\n    },\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 {\n  EntityProvider,\n  EntityProviderConnection,\n} from '@backstage/plugin-catalog-backend';\nimport { Logger } from 'winston';\nimport { Config } from '@backstage/config';\nimport { TaskRunner } from '@backstage/backend-tasks';\nimport * as uuid from 'uuid';\nimport {\n  BitbucketServerLocationParser,\n  defaultBitbucketServerLocationParser,\n} from './BitbucketServerLocationParser';\nimport {\n  BitbucketServerIntegration,\n  ScmIntegrations,\n} from '@backstage/integration';\nimport { BitbucketServerClient, paginated } from '../lib';\nimport { InputError } from '@backstage/errors';\nimport {\n  BitbucketServerEntityProviderConfig,\n  readProviderConfigs,\n} from './BitbucketServerEntityProviderConfig';\nimport { Entity } from '@backstage/catalog-model';\n\n/**\n * Discovers catalog files located in Bitbucket Server.\n * The provider will search your Bitbucket Server instance and register catalog files matching the configured path\n * as Location entity and via following processing steps add all contained catalog entities.\n * This can be useful as an alternative to static locations or manually adding things to the catalog.\n *\n * @public\n */\nexport class BitbucketServerEntityProvider implements EntityProvider {\n  private readonly integration: BitbucketServerIntegration;\n  private readonly config: BitbucketServerEntityProviderConfig;\n  private readonly parser: BitbucketServerLocationParser;\n  private readonly logger: Logger;\n  private readonly scheduleFn: () => Promise<void>;\n  private connection?: EntityProviderConnection;\n\n  static fromConfig(\n    config: Config,\n    options: {\n      logger: Logger;\n      schedule: TaskRunner;\n      parser?: BitbucketServerLocationParser;\n    },\n  ): BitbucketServerEntityProvider[] {\n    const integrations = ScmIntegrations.fromConfig(config);\n\n    return readProviderConfigs(config).map(providerConfig => {\n      const integration = integrations.bitbucketServer.byHost(\n        providerConfig.host,\n      );\n      if (!integration) {\n        throw new InputError(\n          `No BitbucketServer integration found that matches host ${providerConfig.host}`,\n        );\n      }\n      return new BitbucketServerEntityProvider(\n        providerConfig,\n        integration,\n        options.logger,\n        options.schedule,\n        options.parser,\n      );\n    });\n  }\n\n  private constructor(\n    config: BitbucketServerEntityProviderConfig,\n    integration: BitbucketServerIntegration,\n    logger: Logger,\n    schedule: TaskRunner,\n    parser?: BitbucketServerLocationParser,\n  ) {\n    this.integration = integration;\n    this.config = config;\n    this.parser = parser || defaultBitbucketServerLocationParser;\n    this.logger = logger.child({\n      target: this.getProviderName(),\n    });\n    this.scheduleFn = this.createScheduleFn(schedule);\n  }\n\n  private createScheduleFn(schedule: TaskRunner): () => Promise<void> {\n    return async () => {\n      const taskId = `${this.getProviderName()}:refresh`;\n      return schedule.run({\n        id: taskId,\n        fn: async () => {\n          const logger = this.logger.child({\n            class: BitbucketServerEntityProvider.prototype.constructor.name,\n            taskId,\n            taskInstanceId: uuid.v4(),\n          });\n\n          try {\n            await this.refresh(logger);\n          } catch (error) {\n            logger.error(error);\n          }\n        },\n      });\n    };\n  }\n\n  /** {@inheritdoc @backstage/plugin-catalog-backend#EntityProvider.getProviderName} */\n  getProviderName(): string {\n    return `bitbucketServer-provider:${this.config.id}`;\n  }\n\n  /** {@inheritdoc @backstage/plugin-catalog-backend#EntityProvider.connect} */\n  async connect(connection: EntityProviderConnection): Promise<void> {\n    this.connection = connection;\n    await this.scheduleFn();\n  }\n\n  async refresh(logger: Logger) {\n    if (!this.connection) {\n      throw new Error('Not initialized');\n    }\n\n    logger.info('Discovering catalog files in Bitbucket Server repositories');\n\n    const entities = await this.findEntities();\n\n    await this.connection.applyMutation({\n      type: 'full',\n      entities: entities.map(entity => ({\n        locationKey: this.getProviderName(),\n        entity: entity,\n      })),\n    });\n\n    logger.info(\n      `Committed ${entities.length} entities for Bitbucket Server repositories`,\n    );\n  }\n\n  private async findEntities(): Promise<Entity[]> {\n    const client = BitbucketServerClient.fromConfig({\n      config: this.integration.config,\n    });\n    const projects = paginated(options =>\n      client.listProjects({ listOptions: options }),\n    );\n    const result: Entity[] = [];\n    for await (const project of projects) {\n      if (\n        this.config?.filters?.projectKey &&\n        !this.config.filters.projectKey.test(project.key)\n      ) {\n        continue;\n      }\n      const repositories = paginated(options =>\n        client.listRepositories({\n          projectKey: project.key,\n          listOptions: options,\n        }),\n      );\n      for await (const repository of repositories) {\n        if (\n          this.config?.filters?.repoSlug &&\n          !this.config.filters.repoSlug.test(repository.slug)\n        ) {\n          continue;\n        }\n        for await (const entity of this.parser({\n          client,\n          logger: this.logger,\n          location: {\n            type: 'url',\n            target: `${repository.links.self[0].href}${this.config.catalogPath}`,\n            presence: 'optional',\n          },\n        })) {\n          result.push(entity);\n        }\n      }\n    }\n    return result;\n  }\n}\n"],"names":["fetch","getBitbucketServerRequestOptions","Request","locationSpecToLocationEntity","ScmIntegrations","InputError","uuid"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIO,MAAM,qBAAqB,CAAC;AACnC,EAAE,OAAO,UAAU,CAAC,OAAO,EAAE;AAC7B,IAAI,OAAO,IAAI,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC9C,GAAG;AACH,EAAE,WAAW,CAAC,OAAO,EAAE;AACvB,IAAI,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;AACjC,GAAG;AACH,EAAE,MAAM,YAAY,CAAC,OAAO,EAAE;AAC9B,IAAI,OAAO,IAAI,CAAC,YAAY;AAC5B,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC;AAC1C,MAAM,OAAO,CAAC,WAAW;AACzB,KAAK,CAAC;AACN,GAAG;AACH,EAAE,MAAM,gBAAgB,CAAC,OAAO,EAAE;AAClC,IAAI,OAAO,IAAI,CAAC,YAAY;AAC5B,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,kBAAkB;AAC9D,QAAQ,OAAO,CAAC,UAAU;AAC1B,OAAO,CAAC,MAAM,CAAC;AACf,MAAM,OAAO,CAAC,WAAW;AACzB,KAAK,CAAC;AACN,GAAG;AACH,EAAE,MAAM,OAAO,CAAC,OAAO,EAAE;AACzB,IAAI,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AACjD,IAAI,OAAOA,gBAAK;AAChB,MAAM,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AAC/G,MAAMC,4CAAgC,CAAC,IAAI,CAAC,MAAM,CAAC;AACnD,KAAK,CAAC;AACN,GAAG;AACH,EAAE,MAAM,aAAa,CAAC,OAAO,EAAE;AAC/B,IAAI,MAAM,OAAO,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AACrG,IAAI,MAAM,QAAQ,GAAG,MAAMD,gBAAK;AAChC,MAAM,OAAO;AACb,MAAMC,4CAAgC,CAAC,IAAI,CAAC,MAAM,CAAC;AACnD,KAAK,CAAC;AACN,IAAI,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AAC3B,GAAG;AACH,EAAE,WAAW,CAAC,OAAO,EAAE;AACvB,IAAI,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;AACvD,IAAI,OAAO;AACX,MAAM,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;AAChH,KAAK,CAAC;AACN,GAAG;AACH,EAAE,MAAM,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE;AACxC,IAAI,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;AACtC,IAAI,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE;AAC/B,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE;AACxB,QAAQ,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;AAClE,OAAO;AACP,KAAK;AACL,IAAI,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;AACvC,GAAG;AACH,EAAE,MAAM,aAAa,CAAC,GAAG,EAAE;AAC3B,IAAI,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,KAAK;AAC5C,MAAM,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AAC7B,KAAK,CAAC,CAAC;AACP,GAAG;AACH,EAAE,MAAM,GAAG,CAAC,GAAG,EAAE;AACjB,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,IAAIC,kBAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AACxE,GAAG;AACH,EAAE,MAAM,OAAO,CAAC,GAAG,EAAE;AACrB,IAAI,OAAOF,gBAAK,CAAC,GAAG,EAAEC,4CAAgC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;AACzE,MAAM,CAAC,QAAQ,KAAK;AACpB,QAAQ,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE;AAC1B,UAAU,MAAM,IAAI,KAAK;AACzB,YAAY,CAAC,wBAAwB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;AAChI,WAAW,CAAC;AACZ,SAAS;AACT,QAAQ,OAAO,QAAQ,CAAC;AACxB,OAAO;AACP,KAAK,CAAC;AACN,GAAG;AACH,CAAC;AACM,gBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE;AACnD,EAAE,MAAM,IAAI,GAAG,OAAO,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AACvC,EAAE,IAAI,GAAG,CAAC;AACV,EAAE,GAAG;AACL,IAAI,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAC9B,IAAI,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC;AACnC,IAAI,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,MAAM,EAAE;AACnC,MAAM,MAAM,IAAI,CAAC;AACjB,KAAK;AACL,GAAG,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE;AAC5B;;ACnFO,MAAM,oCAAoC,GAAG,gBAAgB,qCAAqC,CAAC,OAAO,EAAE;AACnH,EAAE,MAAME,iDAA4B,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;AACrE,CAAC;;ACLD,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAClD,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAC/B,SAAS,mBAAmB,CAAC,MAAM,EAAE;AAC5C,EAAE,MAAM,eAAe,GAAG,MAAM,CAAC,iBAAiB;AAClD,IAAI,mCAAmC;AACvC,GAAG,CAAC;AACJ,EAAE,IAAI,CAAC,eAAe,EAAE;AACxB,IAAI,OAAO,EAAE,CAAC;AACd,GAAG;AACH,EAAE,IAAI,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;AACnC,IAAI,OAAO,CAAC,kBAAkB,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC,CAAC;AACtE,GAAG;AACH,EAAE,OAAO,eAAe,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK;AAC5C,IAAI,MAAM,cAAc,GAAG,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;AACzD,IAAI,OAAO,kBAAkB,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC;AAClD,GAAG,CAAC,CAAC;AACL,CAAC;AACD,SAAS,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE;AACxC,EAAE,IAAI,EAAE,CAAC;AACT,EAAE,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AACxC,EAAE,MAAM,WAAW,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,iBAAiB,CAAC,aAAa,CAAC,KAAK,IAAI,GAAG,EAAE,GAAG,oBAAoB,CAAC;AACzG,EAAE,MAAM,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,CAAC;AAC3E,EAAE,MAAM,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;AACvE,EAAE,OAAO;AACT,IAAI,EAAE;AACN,IAAI,IAAI;AACR,IAAI,WAAW;AACf,IAAI,OAAO,EAAE;AACb,MAAM,UAAU,EAAE,iBAAiB,GAAG,IAAI,MAAM,CAAC,iBAAiB,CAAC,GAAG,KAAK,CAAC;AAC5E,MAAM,QAAQ,EAAE,eAAe,GAAG,IAAI,MAAM,CAAC,eAAe,CAAC,GAAG,KAAK,CAAC;AACtE,KAAK;AACL,GAAG,CAAC;AACJ;;ACpBO,MAAM,6BAA6B,CAAC;AAC3C,EAAE,OAAO,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE;AACrC,IAAI,MAAM,YAAY,GAAGC,2BAAe,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5D,IAAI,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,cAAc,KAAK;AAC/D,MAAM,MAAM,WAAW,GAAG,YAAY,CAAC,eAAe,CAAC,MAAM;AAC7D,QAAQ,cAAc,CAAC,IAAI;AAC3B,OAAO,CAAC;AACR,MAAM,IAAI,CAAC,WAAW,EAAE;AACxB,QAAQ,MAAM,IAAIC,iBAAU;AAC5B,UAAU,CAAC,uDAAuD,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;AACzF,SAAS,CAAC;AACV,OAAO;AACP,MAAM,OAAO,IAAI,6BAA6B;AAC9C,QAAQ,cAAc;AACtB,QAAQ,WAAW;AACnB,QAAQ,OAAO,CAAC,MAAM;AACtB,QAAQ,OAAO,CAAC,QAAQ;AACxB,QAAQ,OAAO,CAAC,MAAM;AACtB,OAAO,CAAC;AACR,KAAK,CAAC,CAAC;AACP,GAAG;AACH,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE;AAC7D,IAAI,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;AACnC,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;AACzB,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,oCAAoC,CAAC;AACjE,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC;AAC/B,MAAM,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE;AACpC,KAAK,CAAC,CAAC;AACP,IAAI,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AACtD,GAAG;AACH,EAAE,gBAAgB,CAAC,QAAQ,EAAE;AAC7B,IAAI,OAAO,YAAY;AACvB,MAAM,MAAM,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,QAAQ,CAAC,CAAC;AACzD,MAAM,OAAO,QAAQ,CAAC,GAAG,CAAC;AAC1B,QAAQ,EAAE,EAAE,MAAM;AAClB,QAAQ,EAAE,EAAE,YAAY;AACxB,UAAU,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;AAC3C,YAAY,KAAK,EAAE,6BAA6B,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI;AAC3E,YAAY,MAAM;AAClB,YAAY,cAAc,EAAEC,eAAI,CAAC,EAAE,EAAE;AACrC,WAAW,CAAC,CAAC;AACb,UAAU,IAAI;AACd,YAAY,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AACvC,WAAW,CAAC,OAAO,KAAK,EAAE;AAC1B,YAAY,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAChC,WAAW;AACX,SAAS;AACT,OAAO,CAAC,CAAC;AACT,KAAK,CAAC;AACN,GAAG;AACH,EAAE,eAAe,GAAG;AACpB,IAAI,OAAO,CAAC,yBAAyB,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AACxD,GAAG;AACH,EAAE,MAAM,OAAO,CAAC,UAAU,EAAE;AAC5B,IAAI,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;AACjC,IAAI,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;AAC5B,GAAG;AACH,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE;AACxB,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;AAC1B,MAAM,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;AACzC,KAAK;AACL,IAAI,MAAM,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;AAC9E,IAAI,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;AAC/C,IAAI,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;AACxC,MAAM,IAAI,EAAE,MAAM;AAClB,MAAM,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,MAAM;AAC1C,QAAQ,WAAW,EAAE,IAAI,CAAC,eAAe,EAAE;AAC3C,QAAQ,MAAM;AACd,OAAO,CAAC,CAAC;AACT,KAAK,CAAC,CAAC;AACP,IAAI,MAAM,CAAC,IAAI;AACf,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,2CAA2C,CAAC;AAC/E,KAAK,CAAC;AACN,GAAG;AACH,EAAE,MAAM,YAAY,GAAG;AACvB,IAAI,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;AACvB,IAAI,MAAM,MAAM,GAAG,qBAAqB,CAAC,UAAU,CAAC;AACpD,MAAM,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM;AACrC,KAAK,CAAC,CAAC;AACP,IAAI,MAAM,QAAQ,GAAG,SAAS;AAC9B,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,YAAY,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AAChE,KAAK,CAAC;AACN,IAAI,MAAM,MAAM,GAAG,EAAE,CAAC;AACtB,IAAI,WAAW,MAAM,OAAO,IAAI,QAAQ,EAAE;AAC1C,MAAM,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,KAAK,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,KAAK,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,UAAU,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;AAC3J,QAAQ,SAAS;AACjB,OAAO;AACP,MAAM,MAAM,YAAY,GAAG,SAAS;AACpC,QAAQ,CAAC,OAAO,KAAK,MAAM,CAAC,gBAAgB,CAAC;AAC7C,UAAU,UAAU,EAAE,OAAO,CAAC,GAAG;AACjC,UAAU,WAAW,EAAE,OAAO;AAC9B,SAAS,CAAC;AACV,OAAO,CAAC;AACR,MAAM,WAAW,MAAM,UAAU,IAAI,YAAY,EAAE;AACnD,QAAQ,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,KAAK,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,KAAK,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE;AAC7J,UAAU,SAAS;AACnB,SAAS;AACT,QAAQ,WAAW,MAAM,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;AAC/C,UAAU,MAAM;AAChB,UAAU,MAAM,EAAE,IAAI,CAAC,MAAM;AAC7B,UAAU,QAAQ,EAAE;AACpB,YAAY,IAAI,EAAE,KAAK;AACvB,YAAY,MAAM,EAAE,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AAChF,YAAY,QAAQ,EAAE,UAAU;AAChC,WAAW;AACX,SAAS,CAAC,EAAE;AACZ,UAAU,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC9B,SAAS;AACT,OAAO;AACP,KAAK;AACL,IAAI,OAAO,MAAM,CAAC;AAClB,GAAG;AACH;;;;;"}

package/dist/index.d.ts

@@ -0,0 +1,127 @@
+import { BitbucketServerIntegrationConfig } from '@backstage/integration';
+import { LocationSpec, EntityProvider, EntityProviderConnection } from '@backstage/plugin-catalog-backend';
+import { Logger } from 'winston';
+import { Config } from '@backstage/config';
+import { TaskRunner } from '@backstage/backend-tasks';
+import { Entity } from '@backstage/catalog-model';
+
+/** @public */
+declare type BitbucketServerRepository = {
+    project: {
+        key: string;
+    };
+    slug: string;
+    description: string;
+    links: Record<string, {
+        href: string;
+    }[]>;
+};
+/** @public */
+declare type BitbucketServerProject = {
+    key: string;
+};
+
+/**
+ * A client for interacting with a Bitbucket Server instance
+ *
+ * @public
+ */
+declare class BitbucketServerClient {
+    private readonly config;
+    static fromConfig(options: {
+        config: BitbucketServerIntegrationConfig;
+    }): BitbucketServerClient;
+    constructor(options: {
+        config: BitbucketServerIntegrationConfig;
+    });
+    listProjects(options: {
+        listOptions?: BitbucketServerListOptions;
+    }): Promise<BitbucketServerPagedResponse<BitbucketServerProject>>;
+    listRepositories(options: {
+        projectKey: string;
+        listOptions?: BitbucketServerListOptions;
+    }): Promise<BitbucketServerPagedResponse<BitbucketServerRepository>>;
+    getFile(options: {
+        projectKey: string;
+        repo: string;
+        path: string;
+    }): Promise<Response>;
+    getRepository(options: {
+        projectKey: string;
+        repo: string;
+    }): Promise<BitbucketServerRepository>;
+    resolvePath(options: {
+        projectKey: string;
+        repo: string;
+        path: string;
+    }): {
+        path: string;
+    };
+    private pagedRequest;
+    private getTypeMapped;
+    private get;
+    private request;
+}
+/**
+ * @public
+ */
+declare type BitbucketServerListOptions = {
+    [key: string]: number | undefined;
+    limit?: number | undefined;
+    start?: number | undefined;
+};
+/**
+ * @public
+ */
+declare type BitbucketServerPagedResponse<T> = {
+    size: number;
+    limit: number;
+    start: number;
+    isLastPage: boolean;
+    values: T[];
+    nextPageStart: number;
+};
+
+/**
+ * A custom callback that reacts to finding a location by yielding entities.
+ * Can be used for custom location/repository parsing logic.
+ *
+ * @public
+ */
+declare type BitbucketServerLocationParser = (options: {
+    client: BitbucketServerClient;
+    location: LocationSpec;
+    logger: Logger;
+}) => AsyncIterable<Entity>;
+
+/**
+ * Discovers catalog files located in Bitbucket Server.
+ * The provider will search your Bitbucket Server instance and register catalog files matching the configured path
+ * as Location entity and via following processing steps add all contained catalog entities.
+ * This can be useful as an alternative to static locations or manually adding things to the catalog.
+ *
+ * @public
+ */
+declare class BitbucketServerEntityProvider implements EntityProvider {
+    private readonly integration;
+    private readonly config;
+    private readonly parser;
+    private readonly logger;
+    private readonly scheduleFn;
+    private connection?;
+    static fromConfig(config: Config, options: {
+        logger: Logger;
+        schedule: TaskRunner;
+        parser?: BitbucketServerLocationParser;
+    }): BitbucketServerEntityProvider[];
+    private constructor();
+    private createScheduleFn;
+    /** {@inheritdoc @backstage/plugin-catalog-backend#EntityProvider.getProviderName} */
+    getProviderName(): string;
+    /** {@inheritdoc @backstage/plugin-catalog-backend#EntityProvider.connect} */
+    connect(connection: EntityProviderConnection): Promise<void>;
+    refresh(logger: Logger): Promise<void>;
+    private findEntities;
+}
+
+export { BitbucketServerClient, BitbucketServerEntityProvider, BitbucketServerListOptions, BitbucketServerLocationParser, BitbucketServerPagedResponse, BitbucketServerProject, BitbucketServerRepository };

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@backstage/plugin-catalog-backend-module-bitbucket-server",
+  "version": "0.0.0-nightly-20220810023539",
+  "main": "dist/index.cjs.js",
+  "types": "dist/index.d.ts",
+  "license": "Apache-2.0",
+  "private": false,
+  "publishConfig": {
+    "access": "public",
+    "main": "dist/index.cjs.js",
+    "types": "dist/index.d.ts"
+  },
+  "backstage": {
+    "role": "backend-plugin-module"
+  },
+  "homepage": "https://backstage.io",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/backstage/backstage",
+    "directory": "plugins/catalog-backend-module-bitbucket-server"
+  },
+  "keywords": [
+    "backstage"
+  ],
+  "scripts": {
+    "start": "backstage-cli package start",
+    "build": "backstage-cli package 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-common": "0.0.0-nightly-20220810023539",
+    "@backstage/backend-tasks": "0.0.0-nightly-20220810023539",
+    "@backstage/catalog-model": "^1.0.1",
+    "@backstage/config": "^1.0.0",
+    "@backstage/errors": "^1.0.0",
+    "@backstage/integration": "0.0.0-nightly-20220810023539",
+    "@backstage/plugin-catalog-backend": "0.0.0-nightly-20220810023539",
+    "cross-fetch": "^3.1.5",
+    "uuid": "^8.0.0",
+    "winston": "^3.2.1"
+  },
+  "devDependencies": {
+    "@backstage/backend-test-utils": "0.0.0-nightly-20220810023539",
+    "@backstage/cli": "0.0.0-nightly-20220810023539",
+    "msw": "^0.44.0"
+  },
+  "files": [
+    "dist",
+    "config.d.ts"
+  ],
+  "configSchema": "config.d.ts"
+}