From 4a941e749c94ca66c93d5ba8ca0e14c09da1e961 Mon Sep 17 00:00:00 2001
From: Patrik Oldsberg <poldsberg@gmail.com>
Date: Wed, 8 Jan 2025 11:10:16 +0100
Subject: [PATCH] catalog-node: deprecate catalogPermissionExtensionPoint

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
---
 .changeset/old-moons-end.md              | 5 +++++
 plugins/catalog-node/report-alpha.api.md | 6 +++---
 plugins/catalog-node/src/extensions.ts   | 3 +++
 3 files changed, 11 insertions(+), 3 deletions(-)
 create mode 100644 .changeset/old-moons-end.md

diff --git a/.changeset/old-moons-end.md b/.changeset/old-moons-end.md
new file mode 100644
index 0000000000..36eaaec056
--- /dev/null
+++ b/.changeset/old-moons-end.md
@@ -0,0 +1,5 @@
+---
+'@backstage/plugin-catalog-node': patch
+---
+
+Deprecated the alpha `catalogPermissionExtensionPoint` and related types, since the same functionality is now available via the new `PermissionIntegrationsService`.
diff --git a/plugins/catalog-node/report-alpha.api.md b/plugins/catalog-node/report-alpha.api.md
index 044bc14de3..92dfaefb7a 100644
--- a/plugins/catalog-node/report-alpha.api.md
+++ b/plugins/catalog-node/report-alpha.api.md
@@ -51,7 +51,7 @@ export interface CatalogModelExtensionPoint {
 // @alpha (undocumented)
 export const catalogModelExtensionPoint: ExtensionPoint<CatalogModelExtensionPoint>;
 
-// @alpha (undocumented)
+// @alpha @deprecated (undocumented)
 export interface CatalogPermissionExtensionPoint {
   // (undocumented)
   addPermissionRules(
@@ -63,10 +63,10 @@ export interface CatalogPermissionExtensionPoint {
   addPermissions(...permissions: Array<Permission | Array<Permission>>): void;
 }
 
-// @alpha (undocumented)
+// @alpha @deprecated (undocumented)
 export const catalogPermissionExtensionPoint: ExtensionPoint<CatalogPermissionExtensionPoint>;
 
-// @alpha (undocumented)
+// @alpha @deprecated (undocumented)
 export type CatalogPermissionRuleInput<
   TParams extends PermissionRuleParams = PermissionRuleParams,
 > = PermissionRule<Entity, EntitiesSearchFilter, 'catalog-entity', TParams>;
diff --git a/plugins/catalog-node/src/extensions.ts b/plugins/catalog-node/src/extensions.ts
index a971e1588d..1861dbcea5 100644
--- a/plugins/catalog-node/src/extensions.ts
+++ b/plugins/catalog-node/src/extensions.ts
@@ -138,6 +138,7 @@ export const catalogModelExtensionPoint =
 
 /**
  * @alpha
+ * @deprecated Use the `coreServices.permissionIntegrations` instead.
  */
 export type CatalogPermissionRuleInput<
   TParams extends PermissionRuleParams = PermissionRuleParams,
@@ -145,6 +146,7 @@ export type CatalogPermissionRuleInput<
 
 /**
  * @alpha
+ * @deprecated Use the `coreServices.permissionIntegrations` instead.
  */
 export interface CatalogPermissionExtensionPoint {
   addPermissions(...permissions: Array<Permission | Array<Permission>>): void;
@@ -157,6 +159,7 @@ export interface CatalogPermissionExtensionPoint {
 
 /**
  * @alpha
+ * @deprecated Use the `coreServices.permissionIntegrations` instead.
  */
 export const catalogPermissionExtensionPoint =
   createExtensionPoint<CatalogPermissionExtensionPoint>({