From 23f9199a0f30ad13340699fedd9875b38c0883bb Mon Sep 17 00:00:00 2001
From: Patrick Jungermann <Patrick.Jungermann@gmail.com>
Date: Tue, 11 Oct 2022 01:48:29 +0200
Subject: [PATCH] chore(catalog/bitbucket): Deprecate
 catalog-backend-module-bitbucket

Deprecate `@backstage/plugin-catalog-backend-module-bitbucket`.

Please migrate to `@backstage/plugin-catalog-backend-module-bitbucket-cloud`
or `@backstage/plugin-catalog-backend-module-bitbucket-server` instead.

Signed-off-by: Patrick Jungermann <Patrick.Jungermann@gmail.com>
---
 .changeset/fresh-donuts-arrive.md                         | 8 ++++++++
 plugins/catalog-backend-module-bitbucket/api-report.md    | 4 ++--
 plugins/catalog-backend-module-bitbucket/package.json     | 1 +
 .../src/BitbucketDiscoveryProcessor.ts                    | 8 +++++++-
 .../src/lib/BitbucketRepositoryParser.ts                  | 1 +
 5 files changed, 19 insertions(+), 3 deletions(-)
 create mode 100644 .changeset/fresh-donuts-arrive.md

diff --git a/.changeset/fresh-donuts-arrive.md b/.changeset/fresh-donuts-arrive.md
new file mode 100644
index 0000000000..55a85533b8
--- /dev/null
+++ b/.changeset/fresh-donuts-arrive.md
@@ -0,0 +1,8 @@
+---
+'@backstage/plugin-catalog-backend-module-bitbucket': patch
+---
+
+Deprecate `@backstage/plugin-catalog-backend-module-bitbucket`.
+
+Please migrate to `@backstage/plugin-catalog-backend-module-bitbucket-cloud`
+or `@backstage/plugin-catalog-backend-module-bitbucket-server` instead.
diff --git a/plugins/catalog-backend-module-bitbucket/api-report.md b/plugins/catalog-backend-module-bitbucket/api-report.md
index 34acd6e76d..053c6040a4 100644
--- a/plugins/catalog-backend-module-bitbucket/api-report.md
+++ b/plugins/catalog-backend-module-bitbucket/api-report.md
@@ -12,7 +12,7 @@ import { LocationSpec } from '@backstage/plugin-catalog-backend';
 import { Logger } from 'winston';
 import { ScmIntegrationRegistry } from '@backstage/integration';
 
-// @public (undocumented)
+// @public @deprecated (undocumented)
 export class BitbucketDiscoveryProcessor implements CatalogProcessor {
   constructor(options: {
     integrations: ScmIntegrationRegistry;
@@ -37,7 +37,7 @@ export class BitbucketDiscoveryProcessor implements CatalogProcessor {
   ): Promise<boolean>;
 }
 
-// @public
+// @public @deprecated
 export type BitbucketRepositoryParser = (options: {
   integration: BitbucketIntegration;
   target: string;
diff --git a/plugins/catalog-backend-module-bitbucket/package.json b/plugins/catalog-backend-module-bitbucket/package.json
index ff0594154d..61657cfafd 100644
--- a/plugins/catalog-backend-module-bitbucket/package.json
+++ b/plugins/catalog-backend-module-bitbucket/package.json
@@ -2,6 +2,7 @@
   "name": "@backstage/plugin-catalog-backend-module-bitbucket",
   "description": "A Backstage catalog backend module that helps integrate towards Bitbucket",
   "version": "0.2.4-next.1",
+  "deprecated": true,
   "main": "src/index.ts",
   "types": "src/index.ts",
   "license": "Apache-2.0",
diff --git a/plugins/catalog-backend-module-bitbucket/src/BitbucketDiscoveryProcessor.ts b/plugins/catalog-backend-module-bitbucket/src/BitbucketDiscoveryProcessor.ts
index 14bf90ee62..6924765483 100644
--- a/plugins/catalog-backend-module-bitbucket/src/BitbucketDiscoveryProcessor.ts
+++ b/plugins/catalog-backend-module-bitbucket/src/BitbucketDiscoveryProcessor.ts
@@ -41,7 +41,10 @@ import {
 const DEFAULT_BRANCH = 'master';
 const DEFAULT_CATALOG_LOCATION = '/catalog-info.yaml';
 
-/** @public */
+/**
+ * @public
+ * @deprecated Please migrate to `@backstage/plugin-catalog-backend-module-bitbucket-cloud` or `@backstage/plugin-catalog-backend-module-bitbucket-server` instead.
+ */
 export class BitbucketDiscoveryProcessor implements CatalogProcessor {
   private readonly integrations: ScmIntegrationRegistry;
   private readonly parser: BitbucketRepositoryParser;
@@ -70,6 +73,9 @@ export class BitbucketDiscoveryProcessor implements CatalogProcessor {
     this.integrations = options.integrations;
     this.parser = options.parser || defaultRepositoryParser;
     this.logger = options.logger;
+    this.logger.warn(
+      'Please migrate to `@backstage/plugin-catalog-backend-module-bitbucket-cloud` or `@backstage/plugin-catalog-backend-module-bitbucket-server` instead.',
+    );
   }
 
   getProcessorName(): string {
diff --git a/plugins/catalog-backend-module-bitbucket/src/lib/BitbucketRepositoryParser.ts b/plugins/catalog-backend-module-bitbucket/src/lib/BitbucketRepositoryParser.ts
index 57a162e1e4..97225e2579 100644
--- a/plugins/catalog-backend-module-bitbucket/src/lib/BitbucketRepositoryParser.ts
+++ b/plugins/catalog-backend-module-bitbucket/src/lib/BitbucketRepositoryParser.ts
@@ -26,6 +26,7 @@ import { Logger } from 'winston';
  * results.
  *
  * @public
+ * @deprecated Please migrate to `@backstage/plugin-catalog-backend-module-bitbucket-cloud` or `@backstage/plugin-catalog-backend-module-bitbucket-server` instead.
  */
 export type BitbucketRepositoryParser = (options: {
   integration: BitbucketIntegration;