Use PermissionEvaluator instead of ServerPermissionClient

Signed-off-by: Vincenzo Scamporlino <me@vinzscam.dev>

.changeset/four-dolphins-report.md

@@ -1,5 +1,5 @@
 ---
-'@backstage/plugin-permission-node': patch
+'@backstage/plugin-permission-node': minor
 ---
 
-Use new `PermissionEvaluator#query` method in `ServerPermissionClient` and test suites.
+**BREAKING:** `ServerPermissionClient` now implements `PermissionEvaluator`, which moves out the capabilities for evaluating conditional decisions from `authorize()` to `query()` method.

.changeset/rare-parents-pretend.md

@@ -2,13 +2,13 @@
 '@backstage/create-app': patch
 ---
 
-Use `ServerPermissionClient` instead of `PermissionAuthorizer`.
+Use `PermissionEvaluator` instead of `PermissionAuthorizer`.
 
 Apply the following to `packages/backend/src/types.ts`:
 
 ```diff
 - import { PermissionAuthorizer } from '@backstage/plugin-permission-common';
-+ import { ServerPermissionClient } from '@backstage/plugin-permission-node';
++ import { PermissionEvaluator } from '@backstage/plugin-permission-common';
 
   export type PluginEnvironment = {
     ...
@@ -16,6 +16,6 @@ Apply the following to `packages/backend/src/types.ts`:
     tokenManager: TokenManager;
     scheduler: PluginTaskScheduler;
 -   permissions: PermissionAuthorizer;
-+   permissions: ServerPermissionClient;
++   permissions: PermissionEvaluator;
   };
 ```

packages/backend/src/types.ts

@@ -23,8 +23,8 @@ import {
   TokenManager,
   UrlReader,
 } from '@backstage/backend-common';
-import { ServerPermissionClient } from '@backstage/plugin-permission-node';
 import { PluginTaskScheduler } from '@backstage/backend-tasks';
+import { PermissionEvaluator } from '@backstage/plugin-permission-common';
 
 export type PluginEnvironment = {
   logger: Logger;
@@ -34,6 +34,6 @@ export type PluginEnvironment = {
   reader: UrlReader;
   discovery: PluginEndpointDiscovery;
   tokenManager: TokenManager;
-  permissions: ServerPermissionClient;
+  permissions: PermissionEvaluator;
   scheduler: PluginTaskScheduler;
 };

packages/create-app/templates/default-app/packages/backend/src/types.ts

@@ -8,7 +8,7 @@ import {
   UrlReader,
 } from '@backstage/backend-common';
 import { PluginTaskScheduler } from '@backstage/backend-tasks';
-import { ServerPermissionClient } from '@backstage/plugin-permission-node';
+import { PermissionEvaluator } from '@backstage/plugin-permission-common';
 
 export type PluginEnvironment = {
   logger: Logger;
@@ -19,5 +19,5 @@ export type PluginEnvironment = {
   discovery: PluginEndpointDiscovery;
   tokenManager: TokenManager;
   scheduler: PluginTaskScheduler;
-  permissions: ServerPermissionClient;
+  permissions: PermissionEvaluator;
 };