permission-node: deprecate createPermisisonIntegrationRouter + docs fix

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>

plugins/permission-node/report.api.md

@@ -138,7 +138,7 @@ export function createConditionTransformer<
   TRules extends PermissionRule<any, TQuery, string>[],
 >(permissionRules: [...TRules]): ConditionTransformer<TQuery>;
 
-// @public
+// @public @deprecated
 export function createPermissionIntegrationRouter<
   TResourceType1 extends string,
   TResource1,
@@ -177,7 +177,7 @@ export function createPermissionIntegrationRouter<
   ): PermissionRuleset<TResource, TQuery, TResourceType>;
 };
 
-// @public
+// @public @deprecated
 export type CreatePermissionIntegrationRouterResourceOptions<
   TResourceType extends string,
   TResource,
@@ -266,7 +266,7 @@ export type MetadataResponse = MetadataResponse_2;
 // @public @deprecated
 export type MetadataResponseSerializedRule = MetadataResponseSerializedRule_2;
 
-// @public
+// @public @deprecated
 export type PermissionIntegrationRouterOptions<
   TResourceType1 extends string = string,
   TResource1 = any,

plugins/permission-node/src/integration/createPermissionIntegrationRouter.ts

@@ -201,6 +201,7 @@ export function createConditionAuthorizer<TResource, TQuery>(
  * for a particular resource type.
  *
  * @public
+ * @deprecated {@link createPermissionIntegrationRouter} is deprecated
  */
 export type CreatePermissionIntegrationRouterResourceOptions<
   TResourceType extends string,
@@ -223,6 +224,7 @@ export type CreatePermissionIntegrationRouterResourceOptions<
  * permissions and rules from multiple resource types.
  *
  * @public
+ * @deprecated {@link createPermissionIntegrationRouter} is deprecated
  */
 export type PermissionIntegrationRouterOptions<
   TResourceType1 extends string = string,
@@ -410,6 +412,7 @@ class PermissionIntegrationMetadataStore {
  * need to be evaluated.
  *
  * @public
+ * @deprecated use `PermissionRegistryService` instead, see {@link https://backstage.io/docs/backend-system/core-services/permissions-registry#migrating-from-createpermissionintegrationrouter | the migration section in the service docs} for more details.
  */
 export function createPermissionIntegrationRouter<
   TResourceType1 extends string,