@geekmidas/constructs 0.0.15 → 0.0.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekmidas/constructs",
-  "version": "0.0.15",
+  "version": "0.0.17",
   "private": false,
   "type": "module",
   "exports": {
@@ -66,14 +66,14 @@
     "lodash.set": "~4.3.2",
     "lodash.uniqby": "~4.7.0",
     "openapi-types": "~12.1.3",
-    "@geekmidas/audit": "0.0.4",
-    "@geekmidas/logger": "0.0.1",
-    "@geekmidas/schema": "0.0.2",
-    "@geekmidas/services": "0.0.1",
-    "@geekmidas/errors": "0.0.1",
+    "@geekmidas/audit": "0.0.5",
     "@geekmidas/cache": "0.0.7",
     "@geekmidas/events": "0.0.2",
-    "@geekmidas/rate-limit": "0.1.0"
+    "@geekmidas/logger": "0.0.1",
+    "@geekmidas/services": "0.0.1",
+    "@geekmidas/rate-limit": "0.1.0",
+    "@geekmidas/schema": "0.0.2",
+    "@geekmidas/errors": "0.0.1"
   },
   "devDependencies": {
     "@types/lodash.compact": "~3.0.9",

package/src/endpoints/EndpointBuilder.ts

@@ -1,4 +1,8 @@
-import type { AuditStorage, AuditableAction } from '@geekmidas/audit';
+import type {
+  AuditStorage,
+  AuditableAction,
+  ExtractStorageAuditAction,
+} from '@geekmidas/audit';
 import type { EventPublisher, MappedEvent } from '@geekmidas/events';
 import type { Logger } from '@geekmidas/logger';
 import type { RateLimitConfig } from '@geekmidas/rate-limit';
@@ -172,7 +176,10 @@ export class EndpointBuilder<
     TEventPublisherServiceName,
     TAuthorizers,
     TAuditStorage,
-    TAuditStorageServiceName
+    TAuditStorageServiceName,
+    TAuditAction,
+    TDatabase,
+    TDatabaseServiceName
   > {
     this.schemas.body = schema as unknown as T;
     // @ts-ignore
@@ -193,7 +200,10 @@ export class EndpointBuilder<
     TEventPublisherServiceName,
     TAuthorizers,
     TAuditStorage,
-    TAuditStorageServiceName
+    TAuditStorageServiceName,
+    TAuditAction,
+    TDatabase,
+    TDatabaseServiceName
   > {
     this.schemas.query = schema as unknown as T;
     // @ts-ignore
@@ -214,7 +224,10 @@ export class EndpointBuilder<
     TEventPublisherServiceName,
     TAuthorizers,
     TAuditStorage,
-    TAuditStorageServiceName
+    TAuditStorageServiceName,
+    TAuditAction,
+    TDatabase,
+    TDatabaseServiceName
   > {
     return this.search(schema);
   }
@@ -233,7 +246,10 @@ export class EndpointBuilder<
     TEventPublisherServiceName,
     TAuthorizers,
     TAuditStorage,
-    TAuditStorageServiceName
+    TAuditStorageServiceName,
+    TAuditAction,
+    TDatabase,
+    TDatabaseServiceName
   > {
     this.schemas.params = schema as unknown as T;
     // @ts-ignore
@@ -412,8 +428,9 @@ export class EndpointBuilder<
   /**
    * Set the auditor storage service for this endpoint.
    * This enables audit functionality and makes `auditor` available in the handler context.
+   * The audit action type is automatically inferred from the storage's generic parameter.
    */
-  auditor<T extends AuditStorage, TName extends string>(
+  auditor<T extends AuditStorage<any>, TName extends string>(
     storage: Service<TName, T>,
   ): EndpointBuilder<
     TRoute,
@@ -428,7 +445,7 @@ export class EndpointBuilder<
     TAuthorizers,
     T,
     TName,
-    TAuditAction,
+    ExtractStorageAuditAction<T>,
     TDatabase,
     TDatabaseServiceName
   > {
@@ -450,7 +467,7 @@ export class EndpointBuilder<
       TAuthorizers,
       T,
       TName,
-      TAuditAction,
+      ExtractStorageAuditAction<T>,
       TDatabase,
       TDatabaseServiceName
     >;
@@ -500,43 +517,9 @@ export class EndpointBuilder<
    * ])
    * ```
    */
-  audit<T extends AuditableAction<string, unknown>>(
-    audits: MappedAudit<T, OutSchema>[],
-  ): EndpointBuilder<
-    TRoute,
-    TMethod,
-    TInput,
-    TServices,
-    TLogger,
-    OutSchema,
-    TSession,
-    TEventPublisher,
-    TEventPublisherServiceName,
-    TAuthorizers,
-    TAuditStorage,
-    TAuditStorageServiceName,
-    T,
-    TDatabase,
-    TDatabaseServiceName
-  > {
-    this._audits = audits as unknown as MappedAudit<TAuditAction, OutSchema>[];
-    return this as unknown as EndpointBuilder<
-      TRoute,
-      TMethod,
-      TInput,
-      TServices,
-      TLogger,
-      OutSchema,
-      TSession,
-      TEventPublisher,
-      TEventPublisherServiceName,
-      TAuthorizers,
-      TAuditStorage,
-      TAuditStorageServiceName,
-      T,
-      TDatabase,
-      TDatabaseServiceName
-    >;
+  audit(audits: MappedAudit<TAuditAction, OutSchema>[]): this {
+    this._audits = audits;
+    return this;
   }
 
   /**

package/src/endpoints/EndpointFactory.ts

@@ -1,10 +1,15 @@
-import type { AuditStorage } from '@geekmidas/audit';
+import type {
+  AuditStorage,
+  AuditableAction,
+  ExtractStorageAuditAction,
+} from '@geekmidas/audit';
 import type { EventPublisher, MappedEvent } from '@geekmidas/events';
 import type { Logger } from '@geekmidas/logger';
 import { ConsoleLogger } from '@geekmidas/logger/console';
 import type { Service } from '@geekmidas/services';
 import uniqBy from 'lodash.uniqby';
 import type { HttpMethod } from '../types';
+import type { ActorExtractor } from './audit';
 import type { Authorizer } from './Authorizer';
 import type { AuthorizeFn, SessionFn } from './Endpoint';
 import { EndpointBuilder } from './EndpointBuilder';
@@ -19,8 +24,11 @@ export class EndpointFactory<
   TEventPublisher extends EventPublisher<any> | undefined = undefined,
   TEventPublisherServiceName extends string = string,
   TAuthorizers extends readonly string[] = readonly string[],
-  TAuditStorage extends AuditStorage | undefined = undefined,
+  TAuditStorage extends AuditStorage<any> | undefined = undefined,
   TAuditStorageServiceName extends string = string,
+  TAuditAction extends AuditableAction<string, unknown> = ExtractStorageAuditAction<
+    NonNullable<TAuditStorage>
+  >,
   TDatabase = undefined,
   TDatabaseServiceName extends string = string,
 > {
@@ -41,6 +49,7 @@ export class EndpointFactory<
   private defaultDatabaseService:
     | Service<TDatabaseServiceName, TDatabase>
     | undefined;
+  private defaultActorExtractor?: ActorExtractor<TServices, TSession, TLogger>;
 
   constructor({
     basePath,
@@ -54,6 +63,7 @@ export class EndpointFactory<
     defaultAuthorizerName,
     defaultAuditorStorage,
     defaultDatabaseService,
+    defaultActorExtractor,
   }: EndpointFactoryOptions<
     TServices,
     TBasePath,
@@ -82,6 +92,7 @@ export class EndpointFactory<
     this.defaultAuthorizerName = defaultAuthorizerName;
     this.defaultAuditorStorage = defaultAuditorStorage;
     this.defaultDatabaseService = defaultDatabaseService;
+    this.defaultActorExtractor = defaultActorExtractor;
   }
 
   static joinPaths<TBasePath extends string, P extends string>(
@@ -134,6 +145,7 @@ export class EndpointFactory<
     T,
     TAuditStorage,
     TAuditStorageServiceName,
+    TAuditAction,
     TDatabase,
     TDatabaseServiceName
   > {
@@ -150,6 +162,7 @@ export class EndpointFactory<
       T,
       TAuditStorage,
       TAuditStorageServiceName,
+      TAuditAction,
       TDatabase,
       TDatabaseServiceName
     >({
@@ -163,6 +176,7 @@ export class EndpointFactory<
       defaultAuthorizerName: this.defaultAuthorizerName,
       defaultAuditorStorage: this.defaultAuditorStorage,
       defaultDatabaseService: this.defaultDatabaseService,
+      defaultActorExtractor: this.defaultActorExtractor,
     });
   }
 
@@ -179,6 +193,7 @@ export class EndpointFactory<
     TAuthorizers,
     TAuditStorage,
     TAuditStorageServiceName,
+    TAuditAction,
     TDatabase,
     TDatabaseServiceName
   > {
@@ -193,6 +208,7 @@ export class EndpointFactory<
       TAuthorizers,
       TAuditStorage,
       TAuditStorageServiceName,
+      TAuditAction,
       TDatabase,
       TDatabaseServiceName
     >({
@@ -206,6 +222,7 @@ export class EndpointFactory<
       defaultAuthorizerName: this.defaultAuthorizerName,
       defaultAuditorStorage: this.defaultAuditorStorage,
       defaultDatabaseService: this.defaultDatabaseService,
+      defaultActorExtractor: this.defaultActorExtractor,
     });
   }
 
@@ -222,6 +239,7 @@ export class EndpointFactory<
     TAuthorizers,
     TAuditStorage,
     TAuditStorageServiceName,
+    TAuditAction,
     TDatabase,
     TDatabaseServiceName
   > {
@@ -235,6 +253,7 @@ export class EndpointFactory<
       TAuthorizers,
       TAuditStorage,
       TAuditStorageServiceName,
+      TAuditAction,
       TDatabase,
       TDatabaseServiceName
     >({
@@ -248,6 +267,7 @@ export class EndpointFactory<
       defaultAuthorizerName: this.defaultAuthorizerName,
       defaultAuditorStorage: this.defaultAuditorStorage,
       defaultDatabaseService: this.defaultDatabaseService,
+      defaultActorExtractor: this.defaultActorExtractor,
     });
   }
 
@@ -264,6 +284,7 @@ export class EndpointFactory<
     TAuthorizers,
     TAuditStorage,
     TAuditStorageServiceName,
+    TAuditAction,
     TDatabase,
     TDatabaseServiceName
   > {
@@ -277,6 +298,7 @@ export class EndpointFactory<
       TAuthorizers,
       TAuditStorage,
       TAuditStorageServiceName,
+      TAuditAction,
       TDatabase,
       TDatabaseServiceName
     >({
@@ -290,6 +312,7 @@ export class EndpointFactory<
       defaultAuthorizerName: this.defaultAuthorizerName,
       defaultAuditorStorage: this.defaultAuditorStorage,
       defaultDatabaseService: this.defaultDatabaseService,
+      defaultActorExtractor: this.defaultActorExtractor,
     });
   }
 
@@ -305,6 +328,7 @@ export class EndpointFactory<
     TAuthorizers,
     TAuditStorage,
     TAuditStorageServiceName,
+    TAuditAction,
     TDatabase,
     TDatabaseServiceName
   > {
@@ -318,6 +342,7 @@ export class EndpointFactory<
       TAuthorizers,
       TAuditStorage,
       TAuditStorageServiceName,
+      TAuditAction,
       TDatabase,
       TDatabaseServiceName
     >({
@@ -340,6 +365,8 @@ export class EndpointFactory<
       defaultAuthorizerName: this.defaultAuthorizerName,
       defaultAuditorStorage: this.defaultAuditorStorage,
       defaultDatabaseService: this.defaultDatabaseService,
+      defaultActorExtractor: this
+        .defaultActorExtractor as unknown as ActorExtractor<TServices, TSession, L>,
     });
   }
 
@@ -358,6 +385,7 @@ export class EndpointFactory<
     TAuthorizers,
     TAuditStorage,
     TAuditStorageServiceName,
+    TAuditAction,
     TDatabase,
     TDatabaseServiceName
   > {
@@ -371,6 +399,7 @@ export class EndpointFactory<
       TAuthorizers,
       TAuditStorage,
       TAuditStorageServiceName,
+      TAuditAction,
       TDatabase,
       TDatabaseServiceName
     >({
@@ -384,6 +413,7 @@ export class EndpointFactory<
       defaultAuthorizerName: this.defaultAuthorizerName,
       defaultAuditorStorage: this.defaultAuditorStorage,
       defaultDatabaseService: this.defaultDatabaseService,
+      defaultActorExtractor: this.defaultActorExtractor,
     });
   }
 
@@ -399,6 +429,7 @@ export class EndpointFactory<
     TAuthorizers,
     TAuditStorage,
     TAuditStorageServiceName,
+    TAuditAction,
     TDatabase,
     TDatabaseServiceName
   > {
@@ -412,6 +443,7 @@ export class EndpointFactory<
       TAuthorizers,
       TAuditStorage,
       TAuditStorageServiceName,
+      TAuditAction,
       TDatabase,
       TDatabaseServiceName
     >({
@@ -429,6 +461,8 @@ export class EndpointFactory<
       defaultAuthorizerName: this.defaultAuthorizerName,
       defaultAuditorStorage: this.defaultAuditorStorage,
       defaultDatabaseService: this.defaultDatabaseService,
+      defaultActorExtractor: this
+        .defaultActorExtractor as unknown as ActorExtractor<TServices, T, TLogger>,
     });
   }
 
@@ -448,6 +482,7 @@ export class EndpointFactory<
     TAuthorizers,
     TAuditStorage,
     TAuditStorageServiceName,
+    TAuditAction,
     T,
     TName
   > {
@@ -461,6 +496,7 @@ export class EndpointFactory<
       TAuthorizers,
       TAuditStorage,
       TAuditStorageServiceName,
+      TAuditAction,
       T,
       TName
     >({
@@ -480,8 +516,9 @@ export class EndpointFactory<
   /**
    * Set the auditor storage service for endpoints created from this factory.
    * This enables audit functionality and makes `auditor` available in handler context.
+   * The audit action type is automatically inferred from the storage's generic parameter.
    */
-  auditor<T extends AuditStorage, TName extends string>(
+  auditor<T extends AuditStorage<any>, TName extends string>(
     storage: Service<TName, T>,
   ): EndpointFactory<
     TServices,
@@ -493,6 +530,7 @@ export class EndpointFactory<
     TAuthorizers,
     T,
     TName,
+    ExtractStorageAuditAction<T>,
     TDatabase,
     TDatabaseServiceName
   > {
@@ -506,6 +544,7 @@ export class EndpointFactory<
       TAuthorizers,
       T,
       TName,
+      ExtractStorageAuditAction<T>,
       TDatabase,
       TDatabaseServiceName
     >({
@@ -519,6 +558,59 @@ export class EndpointFactory<
       defaultAuthorizerName: this.defaultAuthorizerName,
       defaultAuditorStorage: storage,
       defaultDatabaseService: this.defaultDatabaseService,
+      defaultActorExtractor: this.defaultActorExtractor as unknown as ActorExtractor<
+        TServices,
+        TSession,
+        TLogger
+      >,
+    });
+  }
+
+  /**
+   * Set the actor extractor function for endpoints created from this factory.
+   * The actor is extracted from the request context and attached to all audits.
+   */
+  actor(
+    extractor: ActorExtractor<TServices, TSession, TLogger>,
+  ): EndpointFactory<
+    TServices,
+    TBasePath,
+    TLogger,
+    TSession,
+    TEventPublisher,
+    TEventPublisherServiceName,
+    TAuthorizers,
+    TAuditStorage,
+    TAuditStorageServiceName,
+    TAuditAction,
+    TDatabase,
+    TDatabaseServiceName
+  > {
+    return new EndpointFactory<
+      TServices,
+      TBasePath,
+      TLogger,
+      TSession,
+      TEventPublisher,
+      TEventPublisherServiceName,
+      TAuthorizers,
+      TAuditStorage,
+      TAuditStorageServiceName,
+      TAuditAction,
+      TDatabase,
+      TDatabaseServiceName
+    >({
+      defaultServices: this.defaultServices,
+      basePath: this.basePath,
+      defaultAuthorizeFn: this.defaultAuthorizeFn,
+      defaultLogger: this.defaultLogger,
+      defaultSessionExtractor: this.defaultSessionExtractor,
+      defaultEventPublisher: this.defaultEventPublisher,
+      availableAuthorizers: this.availableAuthorizers,
+      defaultAuthorizerName: this.defaultAuthorizerName,
+      defaultAuditorStorage: this.defaultAuditorStorage,
+      defaultDatabaseService: this.defaultDatabaseService,
+      defaultActorExtractor: extractor,
     });
   }
 
@@ -538,7 +630,7 @@ export class EndpointFactory<
     TAuthorizers,
     TAuditStorage,
     TAuditStorageServiceName,
-    any,
+    TAuditAction,
     TDatabase,
     TDatabaseServiceName
   > {
@@ -556,7 +648,7 @@ export class EndpointFactory<
       TAuthorizers,
       TAuditStorage,
       TAuditStorageServiceName,
-      any,
+      TAuditAction,
       TDatabase,
       TDatabaseServiceName
     >(fullPath, method);
@@ -602,6 +694,11 @@ export class EndpointFactory<
       builder._setDatabaseService(this.defaultDatabaseService as any);
     }
 
+    // Set actor extractor if configured
+    if (this.defaultActorExtractor) {
+      builder._actorExtractor = this.defaultActorExtractor;
+    }
+
     return builder;
   }
 
@@ -681,6 +778,7 @@ export interface EndpointFactoryOptions<
   defaultAuthorizerName?: TAuthorizers[number];
   defaultAuditorStorage?: Service<TAuditStorageServiceName, TAuditStorage>;
   defaultDatabaseService?: Service<TDatabaseServiceName, TDatabase>;
+  defaultActorExtractor?: ActorExtractor<TServices, TSession, TLogger>;
 }
 
 export const e = new EndpointFactory();

package/src/endpoints/__tests__/EndpointFactory.database-auditor.spec.ts

@@ -351,6 +351,102 @@ describe('EndpointFactory', () => {
     });
   });
 
+  describe('actor', () => {
+    it('should create a factory with actor extractor', () => {
+      const actorExtractor = () => ({ id: '123', type: 'user' as const });
+      const factory = new EndpointFactory();
+      const factoryWithActor = factory.actor(actorExtractor);
+
+      expect(factoryWithActor).toBeInstanceOf(EndpointFactory);
+      expect(factoryWithActor).not.toBe(factory);
+    });
+
+    it('should pass actor extractor to created endpoints', () => {
+      const actorExtractor = () => ({ id: '123', type: 'user' as const });
+      const factory = new EndpointFactory()
+        .logger(mockLogger)
+        .actor(actorExtractor);
+
+      const endpoint = factory
+        .get('/test')
+        .handle(async () => ({ success: true }));
+
+      expect(endpoint.actorExtractor).toBe(actorExtractor);
+    });
+
+    it('should preserve actor extractor through factory chains', () => {
+      const actorExtractor = () => ({ id: '123', type: 'user' as const });
+      const factory = new EndpointFactory()
+        .actor(actorExtractor)
+        .logger(mockLogger)
+        .route('/api');
+
+      const endpoint = factory
+        .get('/users')
+        .handle(async () => ({ users: [] }));
+
+      expect(endpoint.actorExtractor).toBe(actorExtractor);
+      expect(endpoint.route).toBe('/api/users');
+    });
+
+    it('should allow endpoints to override actor extractor', () => {
+      const factoryActor = () => ({ id: 'factory', type: 'system' as const });
+      const endpointActor = () => ({ id: 'endpoint', type: 'user' as const });
+
+      const factory = new EndpointFactory()
+        .logger(mockLogger)
+        .actor(factoryActor);
+
+      const endpoint = factory
+        .get('/test')
+        .actor(endpointActor)
+        .handle(async () => ({ success: true }));
+
+      expect(endpoint.actorExtractor).toBe(endpointActor);
+    });
+
+    it('should work with auditor and database', () => {
+      const actorExtractor = ({ session }: any) => ({
+        id: session.userId,
+        type: 'user' as const,
+      });
+
+      const mockAuditStorage: AuditStorage = {
+        write: vi.fn().mockResolvedValue(undefined),
+        query: vi.fn().mockResolvedValue([]),
+        count: vi.fn().mockResolvedValue(0),
+      };
+
+      const AuditStorageService = {
+        serviceName: 'auditStorage' as const,
+        async register() {
+          return mockAuditStorage;
+        },
+      };
+
+      const DatabaseService = {
+        serviceName: 'database' as const,
+        async register() {
+          return { query: vi.fn() };
+        },
+      };
+
+      const factory = new EndpointFactory()
+        .logger(mockLogger)
+        .database(DatabaseService)
+        .auditor(AuditStorageService)
+        .actor(actorExtractor);
+
+      const endpoint = factory
+        .get('/test')
+        .handle(async () => ({ success: true }));
+
+      expect(endpoint.actorExtractor).toBe(actorExtractor);
+      expect(endpoint.databaseService).toBe(DatabaseService);
+      expect(endpoint.auditorStorageService).toBe(AuditStorageService);
+    });
+  });
+
   describe('constructor options with database and auditor', () => {
     const DatabaseService = {
       serviceName: 'database' as const,

package/dist/EndpointBuilder-B8vyK_Fy.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"EndpointBuilder-B8vyK_Fy.cjs","names":["BaseFunctionBuilder","route: TRoute","method: TMethod","ConstructType","publisher: Service<TEventPublisherServiceName, TEventPublisher>","storage: Service<TAuditStorageServiceName, TAuditStorage>","service: Service<TDatabaseServiceName, TDatabase>","description: string","status: SuccessStatus","event: TEvent","tags: string[]","memorySize: number","publisher: Service<TName, T>","schema: T","config: RateLimitConfig","name: TAuthorizers[number] | 'none'","services: T","logger: T","storage: Service<TName, T>","extractor: ActorExtractor<TServices, TSession, TLogger>","audits: MappedAudit<T, OutSchema>[]","service: Service<TName, T>","_schema: any","fn: EndpointHandler<\n      TInput,\n      TServices,\n      TLogger,\n      OutSchema,\n      TSession,\n      TDatabase,\n      TAuditStorage,\n      TAuditAction\n    >","Endpoint"],"sources":["../src/endpoints/EndpointBuilder.ts"],"sourcesContent":["import type { AuditStorage, AuditableAction } from '@geekmidas/audit';\nimport type { EventPublisher, MappedEvent } from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport type { RateLimitConfig } from '@geekmidas/rate-limit';\nimport type { Service } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport uniqBy from 'lodash.uniqby';\nimport { ConstructType } from '../Construct';\nimport { BaseFunctionBuilder } from '../functions';\nimport type { HttpMethod } from '../types';\nimport type { Authorizer } from './Authorizer';\nimport { Endpoint, type EndpointSchemas } from './Endpoint';\nimport type {\n  AuthorizeFn,\n  EndpointHandler,\n  SessionFn,\n  SuccessStatus,\n} from './Endpoint';\nimport type { ActorExtractor, MappedAudit } from './audit';\n\nexport class EndpointBuilder<\n  TRoute extends string,\n  TMethod extends HttpMethod,\n  TInput extends EndpointSchemas = {},\n  TServices extends Service[] = [],\n  TLogger extends Logger = Logger,\n  OutSchema extends StandardSchemaV1 | undefined = undefined,\n  TSession = unknown,\n  TEventPublisher extends EventPublisher<any> | undefined = undefined,\n  TEventPublisherServiceName extends string = string,\n  TAuthorizers extends readonly string[] = readonly string[],\n  TAuditStorage extends AuditStorage | undefined = undefined,\n  TAuditStorageServiceName extends string = string,\n  TAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n    string,\n    unknown\n  >,\n  TDatabase = undefined,\n  TDatabaseServiceName extends string = string,\n> extends BaseFunctionBuilder<\n  TInput,\n  OutSchema,\n  TServices,\n  TLogger,\n  TEventPublisher,\n  TEventPublisherServiceName,\n  TAuditStorage,\n  TAuditStorageServiceName,\n  TDatabase,\n  TDatabaseServiceName\n> {\n  protected schemas: TInput = {} as TInput;\n  protected _description?: string;\n  protected _status?: SuccessStatus;\n  protected _tags?: string[];\n  protected _memorySize?: number;\n  _getSession: SessionFn<TServices, TLogger, TSession> = () => ({}) as TSession;\n  _authorize: AuthorizeFn<TServices, TLogger, TSession> = () => true;\n  _rateLimit?: RateLimitConfig;\n  _availableAuthorizers: Authorizer[] = [];\n  _authorizerName?: TAuthorizers[number];\n  _actorExtractor?: ActorExtractor<TServices, TSession, TLogger>;\n  _audits: MappedAudit<TAuditAction, OutSchema>[] = [];\n\n  constructor(\n    readonly route: TRoute,\n    readonly method: TMethod,\n  ) {\n    super(ConstructType.Endpoint);\n  }\n\n  // Internal setter for EndpointFactory to set default publisher\n  _setPublisher(\n    publisher: Service<TEventPublisherServiceName, TEventPublisher>,\n  ) {\n    this._publisher = publisher;\n  }\n\n  // Internal setter for EndpointFactory to set default auditor storage\n  _setAuditorStorage(\n    storage: Service<TAuditStorageServiceName, TAuditStorage>,\n  ) {\n    this._auditorStorage = storage;\n  }\n\n  // Internal setter for EndpointFactory to set default database service\n  _setDatabaseService(service: Service<TDatabaseServiceName, TDatabase>) {\n    this._databaseService = service;\n  }\n\n  description(description: string): this {\n    this._description = description;\n    return this;\n  }\n\n  status(status: SuccessStatus): this {\n    this._status = status;\n    return this;\n  }\n\n  event<TEvent extends MappedEvent<TEventPublisher, OutSchema>>(\n    event: TEvent,\n  ): this {\n    this._events.push(event);\n    return this;\n  }\n\n  tags(tags: string[]): this {\n    this._tags = tags;\n    return this;\n  }\n\n  memorySize(memorySize: number): this {\n    this._memorySize = memorySize;\n    return this;\n  }\n\n  publisher<T extends EventPublisher<any>, TName extends string>(\n    publisher: Service<TName, T>,\n  ): EndpointBuilder<\n    TRoute,\n    TMethod,\n    TInput,\n    TServices,\n    TLogger,\n    OutSchema,\n    TSession,\n    T,\n    TName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    this._publisher = publisher as unknown as Service<\n      TEventPublisherServiceName,\n      TEventPublisher\n    >;\n\n    return this as unknown as EndpointBuilder<\n      TRoute,\n      TMethod,\n      TInput,\n      TServices,\n      TLogger,\n      OutSchema,\n      TSession,\n      T,\n      TName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >;\n  }\n\n  body<T extends StandardSchemaV1>(\n    schema: T,\n  ): EndpointBuilder<\n    TRoute,\n    TMethod,\n    Omit<TInput, 'body'> & { body: T },\n    TServices,\n    TLogger,\n    OutSchema,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName\n  > {\n    this.schemas.body = schema as unknown as T;\n    // @ts-ignore\n    return this;\n  }\n\n  search<T extends StandardSchemaV1>(\n    schema: T,\n  ): EndpointBuilder<\n    TRoute,\n    TMethod,\n    Omit<TInput, 'query'> & { query: T },\n    TServices,\n    TLogger,\n    OutSchema,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName\n  > {\n    this.schemas.query = schema as unknown as T;\n    // @ts-ignore\n    return this;\n  }\n\n  query<T extends StandardSchemaV1>(\n    schema: T,\n  ): EndpointBuilder<\n    TRoute,\n    TMethod,\n    Omit<TInput, 'query'> & { query: T },\n    TServices,\n    TLogger,\n    OutSchema,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName\n  > {\n    return this.search(schema);\n  }\n\n  params<T extends StandardSchemaV1>(\n    schema: T,\n  ): EndpointBuilder<\n    TRoute,\n    TMethod,\n    Omit<TInput, 'params'> & { params: T },\n    TServices,\n    TLogger,\n    OutSchema,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName\n  > {\n    this.schemas.params = schema as unknown as T;\n    // @ts-ignore\n    return this;\n  }\n\n  rateLimit(config: RateLimitConfig): this {\n    this._rateLimit = config;\n    return this;\n  }\n\n  authorizer(\n    name: TAuthorizers[number] | 'none',\n  ): EndpointBuilder<\n    TRoute,\n    TMethod,\n    TInput,\n    TServices,\n    TLogger,\n    OutSchema,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    // Special case: 'none' explicitly marks endpoint as having no authorizer\n    if (name === 'none') {\n      this._authorizerName = undefined;\n      return this;\n    }\n\n    // Validate that the authorizer exists in available authorizers\n    const authorizerExists = this._availableAuthorizers.some(\n      (a) => a.name === name,\n    );\n    if (!authorizerExists && this._availableAuthorizers.length > 0) {\n      const available = this._availableAuthorizers\n        .map((a) => a.name)\n        .join(', ');\n      throw new Error(\n        `Authorizer \"${name as string}\" not found in available authorizers: ${available}`,\n      );\n    }\n    this._authorizerName = name;\n    return this;\n  }\n\n  services<T extends Service[]>(\n    services: T,\n  ): EndpointBuilder<\n    TRoute,\n    TMethod,\n    TInput,\n    [...TServices, ...T],\n    TLogger,\n    OutSchema,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    this._services = uniqBy(\n      [...this._services, ...services],\n      (s) => s.serviceName,\n    ) as TServices;\n\n    return this as unknown as EndpointBuilder<\n      TRoute,\n      TMethod,\n      TInput,\n      [...TServices, ...T],\n      TLogger,\n      OutSchema,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >;\n  }\n\n  logger<T extends Logger>(\n    logger: T,\n  ): EndpointBuilder<\n    TRoute,\n    TMethod,\n    TInput,\n    TServices,\n    T,\n    OutSchema,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    this._logger = logger as unknown as TLogger;\n\n    return this as unknown as EndpointBuilder<\n      TRoute,\n      TMethod,\n      TInput,\n      TServices,\n      T,\n      OutSchema,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >;\n  }\n\n  output<T extends StandardSchemaV1>(\n    schema: T,\n  ): EndpointBuilder<\n    TRoute,\n    TMethod,\n    TInput,\n    TServices,\n    TLogger,\n    T,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    this.outputSchema = schema as unknown as OutSchema;\n\n    return this as unknown as EndpointBuilder<\n      TRoute,\n      TMethod,\n      TInput,\n      TServices,\n      TLogger,\n      T,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >;\n  }\n\n  /**\n   * Set the auditor storage service for this endpoint.\n   * This enables audit functionality and makes `auditor` available in the handler context.\n   */\n  auditor<T extends AuditStorage, TName extends string>(\n    storage: Service<TName, T>,\n  ): EndpointBuilder<\n    TRoute,\n    TMethod,\n    TInput,\n    TServices,\n    TLogger,\n    OutSchema,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    T,\n    TName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    this._auditorStorage = storage as unknown as Service<\n      TAuditStorageServiceName,\n      TAuditStorage\n    >;\n\n    return this as unknown as EndpointBuilder<\n      TRoute,\n      TMethod,\n      TInput,\n      TServices,\n      TLogger,\n      OutSchema,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      T,\n      TName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >;\n  }\n\n  /**\n   * Set the actor extractor function for audit records.\n   * The actor is extracted from the request context and attached to all audits.\n   */\n  actor(\n    extractor: ActorExtractor<TServices, TSession, TLogger>,\n  ): EndpointBuilder<\n    TRoute,\n    TMethod,\n    TInput,\n    TServices,\n    TLogger,\n    OutSchema,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    this._actorExtractor = extractor;\n    return this;\n  }\n\n  /**\n   * Add declarative audit definitions that are processed after the handler executes.\n   * Similar to `.event()` for events, but for audits.\n   *\n   * @example\n   * ```typescript\n   * .audit<AppAuditAction>([\n   *   {\n   *     type: 'user.created',\n   *     payload: (response) => ({ userId: response.id, email: response.email }),\n   *     when: (response) => response.active,\n   *     entityId: (response) => response.id,\n   *     table: 'users',\n   *   },\n   * ])\n   * ```\n   */\n  audit<T extends AuditableAction<string, unknown>>(\n    audits: MappedAudit<T, OutSchema>[],\n  ): EndpointBuilder<\n    TRoute,\n    TMethod,\n    TInput,\n    TServices,\n    TLogger,\n    OutSchema,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    T,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    this._audits = audits as unknown as MappedAudit<TAuditAction, OutSchema>[];\n    return this as unknown as EndpointBuilder<\n      TRoute,\n      TMethod,\n      TInput,\n      TServices,\n      TLogger,\n      OutSchema,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      T,\n      TDatabase,\n      TDatabaseServiceName\n    >;\n  }\n\n  /**\n   * Set the database service for this endpoint.\n   * The database will be available in the handler context as `db`.\n   * When audit storage is configured and uses the same database,\n   * `db` will automatically be the transaction for ACID compliance.\n   *\n   * @example\n   * ```typescript\n   * .database(databaseService)\n   * .handle(async ({ db }) => {\n   *   // db is the raw database or transaction (when auditor uses same db)\n   *   return await db.selectFrom('users').selectAll().execute();\n   * })\n   * ```\n   */\n  database<T, TName extends string>(\n    service: Service<TName, T>,\n  ): EndpointBuilder<\n    TRoute,\n    TMethod,\n    TInput,\n    TServices,\n    TLogger,\n    OutSchema,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    T,\n    TName\n  > {\n    this._databaseService = service as unknown as Service<\n      TDatabaseServiceName,\n      TDatabase\n    >;\n\n    return this as unknown as EndpointBuilder<\n      TRoute,\n      TMethod,\n      TInput,\n      TServices,\n      TLogger,\n      OutSchema,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      T,\n      TName\n    >;\n  }\n\n  // EndpointBuilder doesn't have a generic input method - it uses body, query, params instead\n  input(_schema: any): any {\n    throw new Error(\n      'EndpointBuilder does not support generic input. Use body(), query(), or params() instead.',\n    );\n  }\n\n  handle(\n    fn: EndpointHandler<\n      TInput,\n      TServices,\n      TLogger,\n      OutSchema,\n      TSession,\n      TDatabase,\n      TAuditStorage,\n      TAuditAction\n    >,\n  ): Endpoint<\n    TRoute,\n    TMethod,\n    TInput,\n    OutSchema,\n    TServices,\n    TLogger,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    // Find authorizer metadata if name is set\n    const authorizer = this._authorizerName\n      ? this._availableAuthorizers.find((a) => a.name === this._authorizerName)\n      : undefined;\n\n    return new Endpoint({\n      fn,\n      method: this.method,\n      route: this.route,\n      description: this._description,\n      tags: this._tags,\n      input: this.schemas,\n      output: this.outputSchema,\n      services: this._services,\n      logger: this._logger,\n      timeout: this._timeout,\n      memorySize: this._memorySize,\n      authorize: this._authorize,\n      status: this._status,\n      getSession: this._getSession,\n      rateLimit: this._rateLimit,\n      publisherService: this._publisher,\n      events: this._events,\n      authorizer,\n      auditorStorageService: this._auditorStorage,\n      actorExtractor: this._actorExtractor,\n      audits: this._audits,\n      databaseService: this._databaseService,\n    });\n  }\n}\n"],"mappings":"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"}