@tstdl/base 0.93.2 → 0.93.4

package/audit/auditor.d.ts

@@ -1,9 +1,30 @@
+import type { IsEqual } from 'type-fest';
 import { type Resolvable, type resolveArgumentType } from '../injector/index.js';
 import type { TypedOmit, UndefinableJsonObject } from '../types/index.js';
 import { AuditEvent } from './audit.model.js';
-export type AuditPayload = Partial<TypedOmit<AuditEvent, 'id' | 'timestamp' | 'module' | 'action' | 'details'> & {
-    details: UndefinableJsonObject;
-}>;
+export type AuditPayload<Details extends UndefinableJsonObject = never> = Partial<TypedOmit<AuditEvent, 'id' | 'timestamp' | 'module' | 'action' | 'tenantId' | 'correlationId' | 'targetId' | 'network' | 'changes' | 'details'>> & {
+    tenantId?: string | null;
+    correlationId?: string | null;
+    targetId?: string;
+    network?: {
+        path?: string | null;
+        ipAddress?: string | null;
+        userAgent?: string | null;
+        sessionId?: string | null;
+    };
+    changes?: {
+        before?: unknown;
+        after?: unknown;
+    };
+} & ([
+    Details
+] extends [never] ? {
+    details?: UndefinableJsonObject;
+} : IsEqual<Details, {}> extends true ? {
+    details?: UndefinableJsonObject;
+} : {
+    details: Details;
+});
 export type AuditorArgument = string | string[] | {
     /**
      * The module or path of modules for the auditor.
@@ -22,7 +43,7 @@ type AuditEvents = Record<string, UndefinableJsonObject>;
  *
  * @template Events A record mapping event action names to their specific `details` payload types.
  */
-export declare class Auditor<Events extends AuditEvents = AuditEvents> implements Resolvable<AuditorArgument> {
+export declare class Auditor<Events extends AuditEvents = Record<never, never>> implements Resolvable<AuditorArgument> {
     #private;
     /**
      * The module path for this auditor instance.
@@ -31,9 +52,7 @@ export declare class Auditor<Events extends AuditEvents = AuditEvents> implement
     /**
      * The context that is automatically merged into every event logged by this auditor.
      */
-    readonly context: Partial<Partial<TypedOmit<AuditEvent<UndefinableJsonObject>, "module" | "timestamp" | "id" | "details" | "action"> & {
-        details: UndefinableJsonObject;
-    }>>;
+    readonly context: Partial<AuditPayload<never>>;
     /**
      * A dot-separated string representation of the module path.
      * @example ['user', 'authentication'] becomes 'user.authentication'
@@ -48,7 +67,7 @@ export declare class Auditor<Events extends AuditEvents = AuditEvents> implement
      * @returns A new `Auditor` instance for the specified submodule.
      * @template T The event map of the new Auditor instance.
      */
-    fork<T extends AuditEvents = Events>(subModule: string | string[]): Auditor<T>;
+    fork<T extends AuditEvents = Record<string, never>>(subModule: string | string[]): Auditor<T>;
     /**
      * Creates a new `Auditor` instance with additional context.
      * The new context is merged with the existing context.
@@ -71,9 +90,7 @@ export declare class Auditor<Events extends AuditEvents = AuditEvents> implement
      * @param action The name of the action being logged. Must be a key of the `Events` type.
      * @param data The payload containing details about the event.
      */
-    log<E extends Extract<keyof Events, string>>(action: E, data?: AuditPayload & {
-        details: Events[E];
-    }): Promise<void>;
+    log<const E extends Extract<keyof Events, string>>(action: E, data?: AuditPayload<Events[E]>): Promise<void>;
     /**
      * Logs an informational event.
      * Automatically sets severity to `Info` and defaults outcome to `Success`.
@@ -81,9 +98,7 @@ export declare class Auditor<Events extends AuditEvents = AuditEvents> implement
      * @param action The name of the action being logged.
      * @param data The payload containing details about the event.
      */
-    info<E extends Extract<keyof Events, string>>(action: E, data: AuditPayload & {
-        details: Events[E];
-    }): Promise<void>;
+    info<const E extends Extract<keyof Events, string>>(action: E, data: AuditPayload<Events[E]>): Promise<void>;
     /**
      * Logs a warning event.
      * Automatically sets severity to `Warn` and defaults outcome to `Failure`.
@@ -91,9 +106,7 @@ export declare class Auditor<Events extends AuditEvents = AuditEvents> implement
      * @param action The name of the action being logged.
      * @param data The payload containing details about the event.
      */
-    warn<E extends Extract<keyof Events, string>>(action: E, data: AuditPayload & {
-        details: Events[E];
-    }): Promise<void>;
+    warn<const E extends Extract<keyof Events, string>>(action: E, data: AuditPayload<Events[E]>): Promise<void>;
     /**
      * Logs an error event.
      * Automatically sets severity to `Error` and defaults outcome to `Failure`.
@@ -101,9 +114,7 @@ export declare class Auditor<Events extends AuditEvents = AuditEvents> implement
      * @param action The name of the action being logged.
      * @param data The payload containing details about the event.
      */
-    error<E extends Extract<keyof Events, string>>(action: E, data: AuditPayload & {
-        details: Events[E];
-    }): Promise<void>;
+    error<const E extends Extract<keyof Events, string>>(action: E, data: AuditPayload<Events[E]>): Promise<void>;
     /**
      * Logs a critical event.
      * Automatically sets severity to `Critical` and defaults outcome to `Failure`.
@@ -111,8 +122,6 @@ export declare class Auditor<Events extends AuditEvents = AuditEvents> implement
      * @param action The name of the action being logged.
      * @param data The payload containing details about the event.
      */
-    critical<E extends Extract<keyof Events, string>>(action: E, data: AuditPayload & {
-        details: Events[E];
-    }): Promise<void>;
+    critical<const E extends Extract<keyof Events, string>>(action: E, data: AuditPayload<Events[E]>): Promise<void>;
 }
 export {};

package/audit/auditor.js

@@ -9,16 +9,24 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 var Auditor_1;
 import { createContextProvider } from '../context/index.js';
-import { Injectable, injectArgument } from '../injector/index.js';
-import { injectRepository } from '../orm/server/index.js';
-import { TRANSACTION_TIMESTAMP } from '../orm/sqls.js';
+import { inject, Injectable, injectArgument, provide } from '../injector/index.js';
+import { Logger, LogLevel } from '../logger/index.js';
+import { TRANSACTION_TIMESTAMP } from '../orm/index.js';
+import { DatabaseConfig, EntityRepositoryConfig, injectRepository, isInTransactionalContext } from '../orm/server/index.js';
 import { toArray } from '../utils/array/index.js';
 import { Memoize } from '../utils/function/memoize.js';
-import { filterUndefinedFromRecord, objectKeys } from '../utils/object/object.js';
+import { filterNullishFromRecord, filterUndefinedFromRecord, objectKeys } from '../utils/object/object.js';
 import { assertDefinedPass, isArray, isNotArray, isObject, isString } from '../utils/type-guards.js';
 import { AuditEvent } from './audit.model.js';
+import { AuditModuleConfig } from './module.js';
 import { AuditOutcome, AuditSeverity } from './types.js';
 const { runInAuditorCreationContext, getCurrentAuditorCreationContext, isInAuditorCreationContext } = createContextProvider('AuditorCreation');
+const severityLogLevelMap = {
+    [AuditSeverity.Info]: 'info',
+    [AuditSeverity.Warn]: 'warn',
+    [AuditSeverity.Error]: 'error',
+    [AuditSeverity.Critical]: 'error',
+};
 /**
  * A service for logging audit events.
  * It provides a structured way to record activities within the system.
@@ -27,17 +35,17 @@ const { runInAuditorCreationContext, getCurrentAuditorCreationContext, isInAudit
  * @template Events A record mapping event action names to their specific `details` payload types.
  */
 let Auditor = Auditor_1 = class Auditor {
-    #repository = injectRepository(AuditEvent);
-    #argument = isInAuditorCreationContext() ? injectArgument(this, { optional: true }) : undefined;
-    #creationContext = getCurrentAuditorCreationContext();
+    #repository = getCurrentAuditorCreationContext()?.repository ?? injectRepository(AuditEvent);
+    #logger = getCurrentAuditorCreationContext()?.logger ?? inject(Logger, 'Audit');
+    #argument = (isInAuditorCreationContext() || isInTransactionalContext()) ? undefined : injectArgument(this, { optional: true });
     /**
      * The module path for this auditor instance.
      */
-    module = this.#creationContext?.module ?? moduleFromArgument(this.#argument);
+    module = getCurrentAuditorCreationContext()?.module ?? moduleFromArgument(this.#argument);
     /**
      * The context that is automatically merged into every event logged by this auditor.
      */
-    context = this.#creationContext?.context ?? ((isObject(this.#argument) && isNotArray(this.#argument)) ? (this.#argument.context ?? {}) : {});
+    context = getCurrentAuditorCreationContext()?.context ?? ((isObject(this.#argument) && isNotArray(this.#argument)) ? (this.#argument.context ?? {}) : {});
     /**
      * A dot-separated string representation of the module path.
      * @example ['user', 'authentication'] becomes 'user.authentication'
@@ -55,8 +63,10 @@ let Auditor = Auditor_1 = class Auditor {
      */
     fork(subModule) {
         return runInAuditorCreationContext({
+            repository: this.#repository,
             module: [...this.module, ...toArray(subModule)],
             context: this.context,
+            logger: this.#logger,
         }, () => new Auditor_1());
     }
     /**
@@ -69,8 +79,16 @@ let Auditor = Auditor_1 = class Auditor {
      */
     with(context) {
         return runInAuditorCreationContext({
+            repository: this.#repository,
             module: this.module,
-            context: { ...this.context, ...context, details: { ...this.context.details, ...context.details } },
+            context: {
+                ...this.context,
+                ...context,
+                network: { ...this.context.network, ...context.network },
+                changes: { ...this.context.changes, ...context.changes },
+                details: { ...this.context.details, ...context.details },
+            },
+            logger: this.#logger,
         }, () => new Auditor_1());
     }
     /**
@@ -89,24 +107,64 @@ let Auditor = Auditor_1 = class Auditor {
      * @param data The payload containing details about the event.
      */
     async log(action, data) {
-        const mergedData = { ...this.context, ...data, details: filterUndefinedFromRecord({ ...this.context.details, ...data?.details }) };
+        const mergedData = {
+            ...this.context,
+            ...data,
+            network: { ...this.context.network, ...data?.network },
+            changes: { ...this.context.changes, ...data?.changes },
+            details: filterUndefinedFromRecord({ ...this.context.details, ...data?.details }),
+        };
+        const outcome = assertDefinedPass(mergedData.outcome, 'Audit outcome is required');
+        const severity = assertDefinedPass(mergedData.severity, 'Audit severity is required');
+        const logMessage = `<${this.moduleString}> ${action} - ${outcome}`;
+        const details = (objectKeys(mergedData.details).length > 0) ? mergedData.details : undefined;
+        const network = filterNullishFromRecord({
+            ipAddress: mergedData.network.ipAddress,
+            userAgent: mergedData.network.userAgent,
+            sessionId: mergedData.network.sessionId,
+        });
+        const changes = filterUndefinedFromRecord({
+            before: mergedData.changes.before,
+            after: mergedData.changes.after,
+        });
+        const logContext = filterNullishFromRecord({
+            correlationId: mergedData.correlationId,
+            actorType: mergedData.actorType,
+            actor: mergedData.actor,
+            targetType: mergedData.targetType,
+            targetId: mergedData.targetId,
+            impersonatorType: mergedData.impersonatorType,
+            impersonator: mergedData.impersonator,
+            network: (objectKeys(network).length > 0) ? network : undefined,
+            changes: (objectKeys(changes).length > 0) ? changes : undefined,
+            details,
+        });
+        this.#logger[severityLogLevelMap[severity]](logMessage, logContext);
         await this.#repository.insert({
             timestamp: TRANSACTION_TIMESTAMP,
             tenantId: mergedData.tenantId ?? null,
             correlationId: mergedData.correlationId ?? null,
             module: this.moduleString,
-            action: action,
-            outcome: assertDefinedPass(mergedData.outcome, 'Audit outcome is required'),
-            severity: assertDefinedPass(mergedData.severity, 'Audit severity is required'),
-            actorId: assertDefinedPass(mergedData.actorId, 'Audit actorId is required'),
+            action,
+            outcome,
+            severity,
             actorType: assertDefinedPass(mergedData.actorType, 'Audit actorType is required'),
-            impersonatorId: mergedData.impersonatorId ?? null,
+            actor: assertDefinedPass(mergedData.actor, 'Audit actor is required'),
             impersonatorType: mergedData.impersonatorType ?? null,
-            targetId: assertDefinedPass(mergedData.targetId, 'Audit targetId is required'),
+            impersonator: mergedData.impersonator ?? null,
             targetType: assertDefinedPass(mergedData.targetType, 'Audit targetType is required'),
-            network: mergedData.network ?? null,
-            changes: mergedData.changes ?? null,
-            details: (objectKeys(mergedData.details).length > 0) ? mergedData.details : null,
+            targetId: assertDefinedPass(mergedData.targetId, 'Audit targetId is required'),
+            network: {
+                path: mergedData.network.path ?? null,
+                ipAddress: mergedData.network.ipAddress ?? null,
+                userAgent: mergedData.network.userAgent ?? null,
+                sessionId: mergedData.network.sessionId ?? null,
+            },
+            changes: {
+                before: mergedData.changes.before ?? null,
+                after: mergedData.changes.after ?? null,
+            },
+            details: details ?? null,
         });
     }
     /**
@@ -172,7 +230,12 @@ __decorate([
     __metadata("design:paramtypes", [])
 ], Auditor.prototype, "moduleString", null);
 Auditor = Auditor_1 = __decorate([
-    Injectable()
+    Injectable({
+        providers: [
+            provide(EntityRepositoryConfig, { useValue: { schema: 'audit' } }),
+            { provide: DatabaseConfig, useFactory: (_, context) => context.resolve(AuditModuleConfig).database ?? context.resolve(DatabaseConfig, undefined, { skipSelf: true }) },
+        ],
+    })
 ], Auditor);
 export { Auditor };
 function moduleFromArgument(argument) {

package/audit/drizzle/{0000_tiny_the_captain.sql → 0000_bored_stick.sql}

@@ -1,4 +1,4 @@
-CREATE TYPE "audit"."actor_type" AS ENUM('user', 'system', 'api-key');--> statement-breakpoint
+CREATE TYPE "audit"."actor_type" AS ENUM('anonymous', 'system', 'api-key', 'user');--> statement-breakpoint
 CREATE TYPE "audit"."audit_outcome" AS ENUM('pending', 'success', 'cancelled', 'failure', 'denied');--> statement-breakpoint
 CREATE TYPE "audit"."audit_severity" AS ENUM('info', 'warn', 'error', 'critical');--> statement-breakpoint
 CREATE TABLE "audit"."event" (
@@ -10,12 +10,13 @@ CREATE TABLE "audit"."event" (
 	"action" text NOT NULL,
 	"outcome" "audit"."audit_outcome" NOT NULL,
 	"severity" "audit"."audit_severity" NOT NULL,
-	"actor_id" uuid NOT NULL,
 	"actor_type" "audit"."actor_type" NOT NULL,
-	"impersonator_id" uuid,
+	"actor" text NOT NULL,
 	"impersonator_type" "audit"."actor_type",
-	"target_id" uuid NOT NULL,
+	"impersonator" text,
 	"target_type" text NOT NULL,
+	"target_id" uuid NOT NULL,
+	"network_path" text NOT NULL,
 	"network_ip_address" text,
 	"network_user_agent" text,
 	"network_session_id" uuid,

package/audit/drizzle/meta/0000_snapshot.json

@@ -1,5 +1,5 @@
 {
-  "id": "bf59778c-5f0d-4a3f-9d71-4ff638082201",
+  "id": "8f6c87f8-1692-49bd-9bd4-09dc9d0bdcd4",
   "prevId": "00000000-0000-0000-0000-000000000000",
   "version": "7",
   "dialect": "postgresql",
@@ -59,12 +59,6 @@
           "primaryKey": false,
           "notNull": true
         },
-        "actor_id": {
-          "name": "actor_id",
-          "type": "uuid",
-          "primaryKey": false,
-          "notNull": true
-        },
         "actor_type": {
           "name": "actor_type",
           "type": "actor_type",
@@ -72,11 +66,11 @@
           "primaryKey": false,
           "notNull": true
         },
-        "impersonator_id": {
-          "name": "impersonator_id",
-          "type": "uuid",
+        "actor": {
+          "name": "actor",
+          "type": "text",
           "primaryKey": false,
-          "notNull": false
+          "notNull": true
         },
         "impersonator_type": {
           "name": "impersonator_type",
@@ -85,14 +79,26 @@
           "primaryKey": false,
           "notNull": false
         },
+        "impersonator": {
+          "name": "impersonator",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false
+        },
+        "target_type": {
+          "name": "target_type",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true
+        },
         "target_id": {
           "name": "target_id",
           "type": "uuid",
           "primaryKey": false,
           "notNull": true
         },
-        "target_type": {
-          "name": "target_type",
+        "network_path": {
+          "name": "network_path",
           "type": "text",
           "primaryKey": false,
           "notNull": true
@@ -148,9 +154,10 @@
       "name": "actor_type",
       "schema": "audit",
       "values": [
-        "user",
+        "anonymous",
         "system",
-        "api-key"
+        "api-key",
+        "user"
       ]
     },
     "audit.audit_outcome": {

package/audit/drizzle/meta/_journal.json

@@ -5,8 +5,8 @@
     {
       "idx": 0,
       "version": "7",
-      "when": 1757676176019,
-      "tag": "0000_tiny_the_captain",
+      "when": 1758041172363,
+      "tag": "0000_bored_stick",
       "breakpoints": true
     }
   ]

package/audit/index.d.ts

@@ -1,3 +1,5 @@
-export * from './auditor.js';
 export * from './audit.model.js';
+export * from './auditor.js';
+export * from './module.js';
+export * from './schemas.js';
 export * from './types.js';

package/audit/index.js

@@ -1,3 +1,5 @@
-export * from './auditor.js';
 export * from './audit.model.js';
+export * from './auditor.js';
+export * from './module.js';
+export * from './schemas.js';
 export * from './types.js';

package/audit/module.d.ts

@@ -1,4 +1,4 @@
-import type { DatabaseConfig } from '../orm/server/module.js';
+import { type DatabaseConfig } from '../orm/server/index.js';
 /**
  * Configuration for {@link configureAuditServer}.
  */

package/audit/module.js

@@ -1,5 +1,4 @@
-import { inject } from '../injector/index.js';
-import { Injector } from '../injector/injector.js';
+import { inject, Injector } from '../injector/index.js';
 import { Database, migrate } from '../orm/server/index.js';
 /**
  * Configuration for {@link configureAuditServer}.

package/audit/schemas.d.ts

@@ -1,6 +1,6 @@
 import { AuditEvent } from './audit.model.js';
-export declare const auditSchema: import("../orm/server/database-schema.js").DatabaseSchema<"audit">;
+export declare const auditSchema: import("../orm/server/index.js").DatabaseSchema<"audit">;
 export declare const auditOutcome: import("drizzle-orm/pg-core").PgEnum<["pending", "success", "cancelled", "failure", "denied"]>;
 export declare const auditSeverity: import("drizzle-orm/pg-core").PgEnum<["error", "warn", "info", "critical"]>;
-export declare const actorType: import("drizzle-orm/pg-core").PgEnum<["user", "system", "api-key"]>;
+export declare const actorType: import("drizzle-orm/pg-core").PgEnum<["user", "anonymous", "system", "api-key"]>;
 export declare const auditEvent: import("../orm/server/types.js").PgTableFromType<typeof AuditEvent, "audit">;

package/audit/schemas.js

@@ -1,4 +1,4 @@
-import { databaseSchema } from '../orm/server/database-schema.js';
+import { databaseSchema } from '../orm/server/index.js';
 import { AuditEvent } from './audit.model.js';
 import { ActorType, AuditOutcome, AuditSeverity } from './types.js';
 export const auditSchema = databaseSchema('audit');

package/audit/types.d.ts

@@ -15,8 +15,9 @@ export declare const AuditOutcome: {
 };
 export type AuditOutcome = EnumType<typeof AuditOutcome>;
 export declare const ActorType: {
-    readonly User: "user";
+    readonly Anonymous: "anonymous";
     readonly System: "system";
     readonly ApiKey: "api-key";
+    readonly User: "user";
 };
 export type ActorType = EnumType<typeof ActorType>;

package/audit/types.js

@@ -13,7 +13,8 @@ export const AuditOutcome = defineEnum('AuditOutcome', {
     Denied: 'denied',
 });
 export const ActorType = defineEnum('ActorType', {
-    User: 'user',
+    Anonymous: 'anonymous',
     System: 'system',
     ApiKey: 'api-key',
+    User: 'user',
 });

package/authentication/models/authentication-credentials.model.js

@@ -7,8 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { Table } from '../../orm/decorators.js';
-import { Entity, Unique } from '../../orm/index.js';
+import { Entity, Table, Unique } from '../../orm/index.js';
 import { Integer, StringProperty, Uint8ArrayProperty } from '../../schema/index.js';
 let AuthenticationCredentials = class AuthenticationCredentials extends Entity {
     subject;

package/authentication/models/authentication-session.model.d.ts

@@ -1,5 +1,5 @@
-import { Entity } from '../../orm/entity.js';
-import { Timestamp } from '../../orm/types.js';
+import type { Timestamp } from '../../orm/index.js';
+import { Entity } from '../../orm/index.js';
 export declare class AuthenticationSession extends Entity {
     subject: string;
     begin: Timestamp;

package/authentication/models/authentication-session.model.js

@@ -7,9 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-import { Table } from '../../orm/decorators.js';
-import { Entity } from '../../orm/entity.js';
-import { Timestamp } from '../../orm/types.js';
+import { Entity, Table, TimestampProperty } from '../../orm/index.js';
 import { Integer, StringProperty, Uint8ArrayProperty } from '../../schema/index.js';
 let AuthenticationSession = class AuthenticationSession extends Entity {
     subject;
@@ -30,11 +28,11 @@ __decorate([
     __metadata("design:type", String)
 ], AuthenticationSession.prototype, "subject", void 0);
 __decorate([
-    Timestamp(),
+    TimestampProperty(),
     __metadata("design:type", Number)
 ], AuthenticationSession.prototype, "begin", void 0);
 __decorate([
-    Timestamp(),
+    TimestampProperty(),
     __metadata("design:type", Number)
 ], AuthenticationSession.prototype, "end", void 0);
 __decorate([

package/authentication/server/authentication-api-request-token.provider.d.ts

@@ -2,10 +2,10 @@ import type { ApiRequestData } from '../../api/index.js';
 import { ApiRequestTokenProvider } from '../../api/server/api-request-token.provider.js';
 import { AuthenticationService } from './authentication.service.js';
 /**
- * Provides the token for an API request from the authorization header.
+ * Provides the info for an API request from the authorization header.
  */
 export declare class AuthenticationApiRequestTokenProvider extends ApiRequestTokenProvider {
     private readonly authenticationService;
     constructor(authenticationService: AuthenticationService);
-    getToken<T>(data: ApiRequestData): Promise<T>;
+    tryGetToken<T>(data: ApiRequestData): Promise<T | null>;
 }

package/authentication/server/authentication-api-request-token.provider.js

@@ -9,10 +9,11 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 import { ApiRequestTokenProvider } from '../../api/server/api-request-token.provider.js';
 import { Singleton } from '../../injector/decorators.js';
+import { isUndefined } from '../../utils/type-guards.js';
 import { AuthenticationService } from './authentication.service.js';
 import { tryGetAuthorizationTokenStringFromRequest } from './helper.js';
 /**
- * Provides the token for an API request from the authorization header.
+ * Provides the info for an API request from the authorization header.
  */
 let AuthenticationApiRequestTokenProvider = class AuthenticationApiRequestTokenProvider extends ApiRequestTokenProvider {
     authenticationService;
@@ -20,10 +21,12 @@ let AuthenticationApiRequestTokenProvider = class AuthenticationApiRequestTokenP
         super();
         this.authenticationService = authenticationService;
     }
-    async getToken(data) {
-        const tokenString = tryGetAuthorizationTokenStringFromRequest(data.request) ?? '';
-        const token = await this.authenticationService.validateToken(tokenString);
-        return token;
+    async tryGetToken(data) {
+        const tokenString = tryGetAuthorizationTokenStringFromRequest(data.request);
+        if (isUndefined(tokenString)) {
+            return null;
+        }
+        return await this.authenticationService.validateToken(tokenString);
     }
 };
 AuthenticationApiRequestTokenProvider = __decorate([

package/authentication/server/authentication.api-controller.d.ts

@@ -20,47 +20,47 @@ export declare class AuthenticationApiController<AdditionalTokenPayload extends
      * @param parameters The parameters for the request.
      * @returns The token result.
      */
-    login({ parameters }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'login'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'login'>>;
+    login({ parameters, getAuditor }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'login'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'login'>>;
     /**
      * Refresh a token.
      * @param request The request context.
      * @param parameters The parameters for the request.
      * @returns The token result.
      */
-    refresh({ request, parameters }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'refresh'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'refresh'>>;
+    refresh({ request, parameters, getAuditor }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'refresh'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'refresh'>>;
     /**
      * Impersonate a subject.
      * @param request The request context.
      * @param parameters The parameters for the request.
      * @returns The token result.
      */
-    impersonate({ request, parameters }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'impersonate'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'impersonate'>>;
+    impersonate({ request, parameters, getAuditor }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'impersonate'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'impersonate'>>;
     /**
      * Unimpersonate a subject.
      * @param request The request context.
      * @param parameters The parameters for the request.
      * @returns The token result.
      */
-    unimpersonate({ request, parameters }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'unimpersonate'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'unimpersonate'>>;
+    unimpersonate({ request, parameters, getAuditor }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'unimpersonate'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'unimpersonate'>>;
     /**
      * End a session.
      * @param request The request context.
      * @returns 'ok' if the session was ended.
      */
-    endSession({ request }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'endSession'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'endSession'>>;
-    changeSecret({ parameters }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'changeSecret'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'changeSecret'>>;
+    endSession({ request, getAuditor }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'endSession'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'endSession'>>;
+    changeSecret({ parameters, getAuditor }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'changeSecret'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'changeSecret'>>;
     /**
      * Initialize a secret reset.
      * @param parameters The parameters for the request.
      * @returns 'ok' if the secret reset was initialized.
      */
-    initSecretReset({ parameters }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'initSecretReset'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'initSecretReset'>>;
+    initSecretReset({ parameters, getAuditor }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'initSecretReset'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'initSecretReset'>>;
     /**
      * Reset a secret.
      * @param parameters The parameters for the request.
      * @returns 'ok' if the secret was reset.
      */
-    resetSecret({ parameters }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'resetSecret'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'resetSecret'>>;
+    resetSecret({ parameters, getAuditor }: ApiRequestContext<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'resetSecret'>): Promise<ApiServerResult<AuthenticationApiDefinition<AdditionalTokenPayload, AuthenticationData, AdditionalInitSecretResetData>, 'resetSecret'>>;
     /**
      * Check a secret.
      * @param parameters The parameters for the request.