@pristine-ts/security 2.0.4 → 2.0.6

package/dist/types/managers/authorizer.manager.d.ts

@@ -1,6 +1,6 @@
 import { DependencyContainer } from "tsyringe";
 import { LogHandlerInterface } from "@pristine-ts/logging";
-import { IdentityInterface, Request } from "@pristine-ts/common";
+import { IdentityInterface, Request, TracingManagerInterface } from "@pristine-ts/common";
 import { AuthorizerManagerInterface } from "../interfaces/authorizer-manager.interface";
 import { GuardFactory } from "../factories/guard.factory";
 /**
@@ -9,15 +9,19 @@ import { GuardFactory } from "../factories/guard.factory";
  */
 export declare class AuthorizerManager implements AuthorizerManagerInterface {
     private readonly logHandler;
+    private readonly tracingManager;
     private readonly guardFactory;
     /**
      * The authorizer manager provides authorization by authorizing the action.
      * @param logHandler The log handler to output logs.
+     * @param tracingManager The tracing manager used to attach markers per guard decision.
      * @param guardFactory The factory to create the guard.
      */
-    constructor(logHandler: LogHandlerInterface, guardFactory: GuardFactory);
+    constructor(logHandler: LogHandlerInterface, tracingManager: TracingManagerInterface, guardFactory: GuardFactory);
     /**
-     * Returns whether or not the request is authorized to access the route.
+     * Returns whether or not the request is authorized to access the route. Drops one marker
+     * per guard (`authz.guard-decision` with the guard's class name and `allow`/`deny`/`error`)
+     * so the trace shows which guard was the deciding one.
      * @param request The request to authorize.
      * @param routeContext The route context.
      * @param container The dependency container to resolve the guard from.

package/dist/types/managers/permission.manager.d.ts

@@ -1,6 +1,6 @@
 import { VoterInterface } from "../interfaces/voter.interface";
 import { VotingStrategyEnum } from "../enums/voting-strategy.enum";
-import { IdentityInterface } from "@pristine-ts/common";
+import { IdentityInterface, TracingManagerInterface } from "@pristine-ts/common";
 import { LogHandlerInterface } from "@pristine-ts/logging";
 /**
  * The permission manager verifies if the correct permission are there to access and take an action on a resource.
@@ -8,15 +8,20 @@ import { LogHandlerInterface } from "@pristine-ts/logging";
 export declare class PermissionManager {
     private readonly voters;
     private readonly logHandler;
+    private readonly tracingManager;
     /**
      * The permission manager verifies if the correct permission are there to access and take an action on a resource.
      * @param voters The voters that determine if access is granted.
      * All services with the tag ServiceDefinitionTagEnum.Voter will be injected here
      * @param logHandler The log handler to output logs.
+     * @param tracingManager The tracing manager used to attach markers for the voting decisions.
      */
-    constructor(voters: VoterInterface[], logHandler: LogHandlerInterface);
+    constructor(voters: VoterInterface[], logHandler: LogHandlerInterface, tracingManager: TracingManagerInterface);
     /**
-     * Returns whether or not the permission manager grants access to the resource.
+     * Returns whether or not the permission manager grants access to the resource. Drops one
+     * marker per voter (`permission.voter-vote` with `{voter, vote}`) so the trace shows which
+     * voter swung the decision. `@traced()` puts the whole call in its own span so the
+     * voting work is visible in the trace tree alongside auth/authz.
      * @param identity The identity trying to have access to a resource.
      * @param action The action trying to be executed on the resource.
      * @param resource The resource being accessed.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pristine-ts/security",
-  "version": "2.0.4",
+  "version": "2.0.6",
   "description": "",
   "module": "dist/lib/esm/security.module.js",
   "main": "dist/lib/cjs/security.module.js",
@@ -20,8 +20,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pristine-ts/common": "^2.0.4",
-    "@pristine-ts/logging": "^2.0.4"
+    "@pristine-ts/common": "^2.0.6",
+    "@pristine-ts/logging": "^2.0.6"
   },
   "devDependencies": {
     "@types/jsonwebtoken": "^8.5.1"
@@ -60,7 +60,7 @@
       "src/*.{js,ts}"
     ]
   },
-  "gitHead": "f376d34e13c1b17b7764c0b47708148e4e51390b",
+  "gitHead": "539029d624372f9bb1e22e09da7152eabb95c105",
   "repository": {
     "type": "git",
     "url": "https://github.com/magieno/pristine-ts.git",