@geekmidas/constructs 0.0.22 → 0.1.0

package/dist/EndpointBuilder-CYkeYpsL.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"EndpointBuilder-CYkeYpsL.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<TAuditAction, 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 {\n  AuditStorage,\n  AuditableAction,\n  ExtractStorageAuditAction,\n} 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, TDatabase> = () =>\n    ({}) 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    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\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    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\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    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\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    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\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   * The audit action type is automatically inferred from the storage's generic parameter.\n   */\n  auditor<T extends AuditStorage<any>, 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    ExtractStorageAuditAction<T>,\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      ExtractStorageAuditAction<T>,\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(audits: MappedAudit<TAuditAction, OutSchema>[]): this {\n    this._audits = audits;\n    return this;\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    // If the authorizer name is set but not in availableAuthorizers, create a simple authorizer object\n    const authorizer = this._authorizerName\n      ? (this._availableAuthorizers.find(\n          (a) => a.name === this._authorizerName,\n        ) ?? { 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":";;;;;;;AAwBA,IAAa,kBAAb,cAmBUA,gDAWR;CACA,AAAU,UAAkB,CAAE;CAC9B,AAAU;CACV,AAAU;CACV,AAAU;CACV,AAAU;CACV,cAAkE,OAC/D,CAAE;CACL,aAAwD,MAAM;CAC9D;CACA,wBAAsC,CAAE;CACxC;CACA;CACA,UAAkD,CAAE;CAEpD,YACWC,OACAC,QACT;AACA,QAAMC,gCAAc,SAAS;EAHpB;EACA;CAGV;CAGD,cACEC,WACA;AACA,OAAK,aAAa;CACnB;CAGD,mBACEC,SACA;AACA,OAAK,kBAAkB;CACxB;CAGD,oBAAoBC,SAAmD;AACrE,OAAK,mBAAmB;CACzB;CAED,YAAYC,aAA2B;AACrC,OAAK,eAAe;AACpB,SAAO;CACR;CAED,OAAOC,QAA6B;AAClC,OAAK,UAAU;AACf,SAAO;CACR;CAED,MACEC,OACM;AACN,OAAK,QAAQ,KAAK,MAAM;AACxB,SAAO;CACR;CAED,KAAKC,MAAsB;AACzB,OAAK,QAAQ;AACb,SAAO;CACR;CAED,WAAWC,YAA0B;AACnC,OAAK,cAAc;AACnB,SAAO;CACR;CAED,UACEC,WAiBA;AACA,OAAK,aAAa;AAKlB,SAAO;CAiBR;CAED,KACEC,QAiBA;AACA,OAAK,QAAQ,OAAO;AAEpB,SAAO;CACR;CAED,OACEA,QAiBA;AACA,OAAK,QAAQ,QAAQ;AAErB,SAAO;CACR;CAED,MACEA,QAiBA;AACA,SAAO,KAAK,OAAO,OAAO;CAC3B;CAED,OACEA,QAiBA;AACA,OAAK,QAAQ,SAAS;AAEtB,SAAO;CACR;CAED,UAAUC,QAA+B;AACvC,OAAK,aAAa;AAClB,SAAO;CACR;CAED,WACEC,MAiBA;AAEA,MAAI,SAAS,QAAQ;AACnB,QAAK;AACL,UAAO;EACR;EAGD,MAAM,mBAAmB,KAAK,sBAAsB,KAClD,CAAC,MAAM,EAAE,SAAS,KACnB;AACD,OAAK,oBAAoB,KAAK,sBAAsB,SAAS,GAAG;GAC9D,MAAM,YAAY,KAAK,sBACpB,IAAI,CAAC,MAAM,EAAE,KAAK,CAClB,KAAK,KAAK;AACb,SAAM,IAAI,OACP,cAAc,KAAe,wCAAwC,UAAU;EAEnF;AACD,OAAK,kBAAkB;AACvB,SAAO;CACR;CAED,SACEC,UAiBA;AACA,OAAK,YAAY,2BACf,CAAC,GAAG,KAAK,WAAW,GAAG,QAAS,GAChC,CAAC,MAAM,EAAE,YACV;AAED,SAAO;CAiBR;CAED,OACEC,QAiBA;AACA,OAAK,UAAU;AAEf,SAAO;CAiBR;CAED,OACEJ,QAiBA;AACA,OAAK,eAAe;AAEpB,SAAO;CAiBR;;;;;;CAOD,QACEK,SAiBA;AACA,OAAK,kBAAkB;AAKvB,SAAO;CAiBR;;;;;CAMD,MACEC,WAiBA;AACA,OAAK,kBAAkB;AACvB,SAAO;CACR;;;;;;;;;;;;;;;;;;CAmBD,MAAMC,QAAsD;AAC1D,OAAK,UAAU;AACf,SAAO;CACR;;;;;;;;;;;;;;;;CAiBD,SACEC,SAiBA;AACA,OAAK,mBAAmB;AAKxB,SAAO;CAiBR;CAGD,MAAMC,SAAmB;AACvB,QAAM,IAAI,MACR;CAEH;CAED,OACEC,IAyBA;EAGA,MAAM,aAAa,KAAK,kBACnB,KAAK,sBAAsB,KAC1B,CAAC,MAAM,EAAE,SAAS,KAAK,gBACxB,IAAI,EAAE,MAAM,KAAK,gBAAiB;AAGvC,SAAO,IAAIC,0BAAS;GAClB;GACA,QAAQ,KAAK;GACb,OAAO,KAAK;GACZ,aAAa,KAAK;GAClB,MAAM,KAAK;GACX,OAAO,KAAK;GACZ,QAAQ,KAAK;GACb,UAAU,KAAK;GACf,QAAQ,KAAK;GACb,SAAS,KAAK;GACd,YAAY,KAAK;GACjB,WAAW,KAAK;GAChB,QAAQ,KAAK;GACb,YAAY,KAAK;GACjB,WAAW,KAAK;GAChB,kBAAkB,KAAK;GACvB,QAAQ,KAAK;GACb;GACA,uBAAuB,KAAK;GAC5B,gBAAgB,KAAK;GACrB,QAAQ,KAAK;GACb,iBAAiB,KAAK;EACvB;CACF;AACF"}

package/dist/EndpointBuilder-W5fdXxYQ.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"EndpointBuilder-W5fdXxYQ.mjs","names":["route: TRoute","method: TMethod","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<TAuditAction, 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    >"],"sources":["../src/endpoints/EndpointBuilder.ts"],"sourcesContent":["import type {\n  AuditStorage,\n  AuditableAction,\n  ExtractStorageAuditAction,\n} 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, TDatabase> = () =>\n    ({}) 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    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\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    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\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    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\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    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\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   * The audit action type is automatically inferred from the storage's generic parameter.\n   */\n  auditor<T extends AuditStorage<any>, 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    ExtractStorageAuditAction<T>,\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      ExtractStorageAuditAction<T>,\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(audits: MappedAudit<TAuditAction, OutSchema>[]): this {\n    this._audits = audits;\n    return this;\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    // If the authorizer name is set but not in availableAuthorizers, create a simple authorizer object\n    const authorizer = this._authorizerName\n      ? (this._availableAuthorizers.find(\n          (a) => a.name === this._authorizerName,\n        ) ?? { 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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"}

package/dist/EndpointFactory-B27nfeiE.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"EndpointFactory-B27nfeiE.mjs","names":["DEFAULT_LOGGER","path: P","basePath: TBasePath","authorizers: T","name: TAuthorizers[number] | 'none'","path: TPath","fn: AuthorizeFn<TServices, TLogger, TSession>","services: S","logger: L","publisher: Service<TServiceName, T>","session: SessionFn<TServices, TLogger, T, TDatabase>","service: Service<TName, T>","storage: Service<TName, T>","extractor: ActorExtractor<TServices, TSession, TLogger>","method: TMethod"],"sources":["../src/endpoints/EndpointFactory.ts"],"sourcesContent":["import type {\n  AuditStorage,\n  AuditableAction,\n  ExtractStorageAuditAction,\n} from '@geekmidas/audit';\nimport type { EventPublisher, MappedEvent } from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport { ConsoleLogger } from '@geekmidas/logger/console';\nimport type { Service } from '@geekmidas/services';\nimport uniqBy from 'lodash.uniqby';\nimport type { HttpMethod } from '../types';\nimport type { Authorizer } from './Authorizer';\nimport type { AuthorizeFn, SessionFn } from './Endpoint';\nimport { EndpointBuilder } from './EndpointBuilder';\nimport type { ActorExtractor } from './audit';\n\nconst DEFAULT_LOGGER = new ConsoleLogger() as any;\n\nexport class EndpointFactory<\n  TServices extends Service[] = [],\n  TBasePath extends string = '',\n  TLogger extends Logger = Logger,\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<any> | undefined = undefined,\n  TAuditStorageServiceName extends string = string,\n  TAuditAction extends AuditableAction<\n    string,\n    unknown\n  > = ExtractStorageAuditAction<NonNullable<TAuditStorage>>,\n  TDatabase = undefined,\n  TDatabaseServiceName extends string = string,\n> {\n  // @ts-ignore\n  private defaultServices: TServices;\n  private basePath: TBasePath = '' as TBasePath;\n  private defaultAuthorizeFn?: AuthorizeFn<TServices, TLogger, TSession>;\n  private defaultEventPublisher:\n    | Service<TEventPublisherServiceName, TEventPublisher>\n    | undefined;\n  private defaultSessionExtractor?: SessionFn<\n    TServices,\n    TLogger,\n    TSession,\n    TDatabase\n  >;\n  private defaultLogger: TLogger = DEFAULT_LOGGER;\n  private availableAuthorizers: Authorizer[] = [];\n  private defaultAuthorizerName?: TAuthorizers[number];\n  private defaultAuditorStorage:\n    | Service<TAuditStorageServiceName, TAuditStorage>\n    | undefined;\n  private defaultDatabaseService:\n    | Service<TDatabaseServiceName, TDatabase>\n    | undefined;\n  private defaultActorExtractor?: ActorExtractor<TServices, TSession, TLogger>;\n\n  constructor({\n    basePath,\n    defaultAuthorizeFn,\n    defaultLogger,\n    defaultSessionExtractor,\n    // @ts-ignore\n    defaultServices = [] as TServices,\n    defaultEventPublisher,\n    availableAuthorizers = [],\n    defaultAuthorizerName,\n    defaultAuditorStorage,\n    defaultDatabaseService,\n    defaultActorExtractor,\n  }: EndpointFactoryOptions<\n    TServices,\n    TBasePath,\n    TLogger,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TDatabase,\n    TDatabaseServiceName\n  > = {}) {\n    // Initialize default services\n    this.defaultServices = uniqBy(\n      defaultServices,\n      (s) => s.serviceName,\n    ) as TServices;\n\n    this.basePath = basePath || ('' as TBasePath);\n    this.defaultAuthorizeFn = defaultAuthorizeFn;\n    this.defaultLogger = defaultLogger || (DEFAULT_LOGGER as TLogger);\n    this.defaultSessionExtractor = defaultSessionExtractor;\n    this.defaultEventPublisher = defaultEventPublisher;\n    this.availableAuthorizers = availableAuthorizers;\n    this.defaultAuthorizerName = defaultAuthorizerName;\n    this.defaultAuditorStorage = defaultAuditorStorage;\n    this.defaultDatabaseService = defaultDatabaseService;\n    this.defaultActorExtractor = defaultActorExtractor;\n  }\n\n  static joinPaths<TBasePath extends string, P extends string>(\n    path: P,\n    basePath: TBasePath = '' as TBasePath,\n  ): JoinPaths<TBasePath, P> {\n    // Handle empty cases\n    if (!basePath && !path) return '/' as JoinPaths<TBasePath, P>;\n    if (!basePath)\n      return (path.startsWith('/') ? path : '/' + path) as JoinPaths<\n        TBasePath,\n        P\n      >;\n    if (!path)\n      return (\n        basePath.startsWith('/') ? basePath : '/' + basePath\n      ) as JoinPaths<TBasePath, P>;\n\n    const base = basePath.endsWith('/') ? basePath.slice(0, -1) : basePath;\n    const segment = path.startsWith('/') ? path : '/' + path;\n\n    let result = base + segment;\n\n    // Ensure leading slash\n    if (!result.startsWith('/')) {\n      result = '/' + result;\n    }\n\n    // Normalize multiple slashes (except in the middle of the path where they might be intentional)\n    result = result.replace(/^\\/+/g, '/');\n\n    // Remove trailing slash unless it's the root path \"/\"\n    if (result.length > 1 && result.endsWith('/')) {\n      result = result.slice(0, -1);\n    }\n\n    return result as JoinPaths<TBasePath, P>;\n  }\n\n  // Configure available authorizers\n  authorizers<const T extends readonly string[]>(\n    authorizers: T,\n  ): EndpointFactory<\n    TServices,\n    TBasePath,\n    TLogger,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    T,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    const authorizerConfigs = authorizers.map((name) => ({\n      name,\n    }));\n    return new EndpointFactory<\n      TServices,\n      TBasePath,\n      TLogger,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      T,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >({\n      defaultServices: this.defaultServices,\n      basePath: this.basePath,\n      defaultAuthorizeFn: this.defaultAuthorizeFn,\n      defaultLogger: this.defaultLogger,\n      defaultSessionExtractor: this.defaultSessionExtractor,\n      defaultEventPublisher: this.defaultEventPublisher,\n      availableAuthorizers: authorizerConfigs,\n      defaultAuthorizerName: this.defaultAuthorizerName,\n      defaultAuditorStorage: this.defaultAuditorStorage,\n      defaultDatabaseService: this.defaultDatabaseService,\n      defaultActorExtractor: this.defaultActorExtractor,\n    });\n  }\n\n  /**\n   * Set the default authorizer for all endpoints created from this factory.\n   * Individual endpoints can override this by calling `.authorizer()` on the builder.\n   * Use `'none'` to explicitly disable authorization for all endpoints.\n   */\n  authorizer(\n    name: TAuthorizers[number] | 'none',\n  ): EndpointFactory<\n    TServices,\n    TBasePath,\n    TLogger,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    // Validate that the authorizer exists in available authorizers\n    if (name !== 'none' && this.availableAuthorizers.length > 0) {\n      const authorizerExists = this.availableAuthorizers.some(\n        (a) => a.name === name,\n      );\n      if (!authorizerExists) {\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    }\n\n    return new EndpointFactory<\n      TServices,\n      TBasePath,\n      TLogger,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >({\n      defaultServices: this.defaultServices,\n      basePath: this.basePath,\n      defaultAuthorizeFn: this.defaultAuthorizeFn,\n      defaultLogger: this.defaultLogger,\n      defaultSessionExtractor: this.defaultSessionExtractor,\n      defaultEventPublisher: this.defaultEventPublisher,\n      availableAuthorizers: this.availableAuthorizers,\n      defaultAuthorizerName: name === 'none' ? undefined : name,\n      defaultAuditorStorage: this.defaultAuditorStorage,\n      defaultDatabaseService: this.defaultDatabaseService,\n      defaultActorExtractor: this.defaultActorExtractor,\n    });\n  }\n\n  // Create a sub-router with a path prefix\n  route<TPath extends string>(\n    path: TPath,\n  ): EndpointFactory<\n    TServices,\n    JoinPaths<TBasePath, TPath>,\n    TLogger,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    const newBasePath = EndpointFactory.joinPaths(path, this.basePath);\n    return new EndpointFactory<\n      TServices,\n      JoinPaths<TBasePath, TPath>,\n      TLogger,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >({\n      defaultServices: this.defaultServices,\n      basePath: newBasePath,\n      defaultAuthorizeFn: this.defaultAuthorizeFn,\n      defaultLogger: this.defaultLogger,\n      defaultSessionExtractor: this.defaultSessionExtractor,\n      defaultEventPublisher: this.defaultEventPublisher,\n      availableAuthorizers: this.availableAuthorizers,\n      defaultAuthorizerName: this.defaultAuthorizerName,\n      defaultAuditorStorage: this.defaultAuditorStorage,\n      defaultDatabaseService: this.defaultDatabaseService,\n      defaultActorExtractor: this.defaultActorExtractor,\n    });\n  }\n\n  // Create a new factory with authorization\n  authorize(\n    fn: AuthorizeFn<TServices, TLogger, TSession>,\n  ): EndpointFactory<\n    TServices,\n    TBasePath,\n    TLogger,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    return new EndpointFactory<\n      TServices,\n      TBasePath,\n      TLogger,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >({\n      defaultServices: this.defaultServices,\n      basePath: this.basePath,\n      defaultAuthorizeFn: fn,\n      defaultLogger: this.defaultLogger,\n      defaultSessionExtractor: this.defaultSessionExtractor,\n      defaultEventPublisher: this.defaultEventPublisher,\n      availableAuthorizers: this.availableAuthorizers,\n      defaultAuthorizerName: this.defaultAuthorizerName,\n      defaultAuditorStorage: this.defaultAuditorStorage,\n      defaultDatabaseService: this.defaultDatabaseService,\n      defaultActorExtractor: this.defaultActorExtractor,\n    });\n  }\n\n  // Create a new factory with services\n  services<S extends Service[]>(\n    services: S,\n  ): EndpointFactory<\n    [...S, ...TServices],\n    TBasePath,\n    TLogger,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    return new EndpointFactory<\n      [...S, ...TServices],\n      TBasePath,\n      TLogger,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >({\n      defaultServices: [...services, ...this.defaultServices],\n      basePath: this.basePath,\n      defaultAuthorizeFn: this.defaultAuthorizeFn,\n      defaultLogger: this.defaultLogger,\n      defaultSessionExtractor: this.defaultSessionExtractor,\n      defaultEventPublisher: this.defaultEventPublisher,\n      availableAuthorizers: this.availableAuthorizers,\n      defaultAuthorizerName: this.defaultAuthorizerName,\n      defaultAuditorStorage: this.defaultAuditorStorage,\n      defaultDatabaseService: this.defaultDatabaseService,\n      defaultActorExtractor: this.defaultActorExtractor,\n    });\n  }\n\n  logger<L extends Logger>(\n    logger: L,\n  ): EndpointFactory<\n    TServices,\n    TBasePath,\n    L,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    return new EndpointFactory<\n      TServices,\n      TBasePath,\n      L,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >({\n      defaultServices: this.defaultServices,\n      basePath: this.basePath,\n      defaultAuthorizeFn: this.defaultAuthorizeFn as unknown as AuthorizeFn<\n        TServices,\n        L,\n        TSession\n      >,\n      defaultLogger: logger,\n      defaultSessionExtractor: this\n        .defaultSessionExtractor as unknown as SessionFn<\n        TServices,\n        L,\n        TSession\n      >,\n      defaultEventPublisher: this.defaultEventPublisher,\n      availableAuthorizers: this.availableAuthorizers,\n      defaultAuthorizerName: this.defaultAuthorizerName,\n      defaultAuditorStorage: this.defaultAuditorStorage,\n      defaultDatabaseService: this.defaultDatabaseService,\n      defaultActorExtractor: this\n        .defaultActorExtractor as unknown as ActorExtractor<\n        TServices,\n        TSession,\n        L\n      >,\n    });\n  }\n\n  publisher<\n    T extends EventPublisher<any>,\n    TServiceName extends string = string,\n  >(\n    publisher: Service<TServiceName, T>,\n  ): EndpointFactory<\n    TServices,\n    TBasePath,\n    TLogger,\n    TSession,\n    T,\n    TServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    return new EndpointFactory<\n      TServices,\n      TBasePath,\n      TLogger,\n      TSession,\n      T,\n      TServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >({\n      defaultServices: this.defaultServices,\n      basePath: this.basePath,\n      defaultAuthorizeFn: this.defaultAuthorizeFn,\n      defaultLogger: this.defaultLogger,\n      defaultSessionExtractor: this.defaultSessionExtractor,\n      defaultEventPublisher: publisher,\n      availableAuthorizers: this.availableAuthorizers,\n      defaultAuthorizerName: this.defaultAuthorizerName,\n      defaultAuditorStorage: this.defaultAuditorStorage,\n      defaultDatabaseService: this.defaultDatabaseService,\n      defaultActorExtractor: this.defaultActorExtractor,\n    });\n  }\n\n  session<T>(\n    session: SessionFn<TServices, TLogger, T, TDatabase>,\n  ): EndpointFactory<\n    TServices,\n    TBasePath,\n    TLogger,\n    T,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    return new EndpointFactory<\n      TServices,\n      TBasePath,\n      TLogger,\n      T,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >({\n      defaultServices: this.defaultServices,\n      basePath: this.basePath,\n      defaultAuthorizeFn: this.defaultAuthorizeFn as unknown as AuthorizeFn<\n        TServices,\n        TLogger,\n        T\n      >,\n      defaultLogger: this.defaultLogger,\n      defaultSessionExtractor: session,\n      defaultEventPublisher: this.defaultEventPublisher,\n      availableAuthorizers: this.availableAuthorizers,\n      defaultAuthorizerName: this.defaultAuthorizerName,\n      defaultAuditorStorage: this.defaultAuditorStorage,\n      defaultDatabaseService: this.defaultDatabaseService,\n      defaultActorExtractor: this\n        .defaultActorExtractor as unknown as ActorExtractor<\n        TServices,\n        T,\n        TLogger\n      >,\n    });\n  }\n\n  /**\n   * Set the database service for endpoints created from this factory.\n   * The database will be available in handler context as `db`.\n   */\n  database<T, TName extends string>(\n    service: Service<TName, T>,\n  ): EndpointFactory<\n    TServices,\n    TBasePath,\n    TLogger,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    T,\n    TName\n  > {\n    return new EndpointFactory<\n      TServices,\n      TBasePath,\n      TLogger,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      T,\n      TName\n    >({\n      defaultServices: this.defaultServices,\n      basePath: this.basePath,\n      defaultAuthorizeFn: this.defaultAuthorizeFn,\n      defaultLogger: this.defaultLogger,\n      // Reset session extractor when database changes - user should call .session() after .database()\n      // to get proper type inference for the new database type\n      defaultSessionExtractor: this.defaultSessionExtractor as unknown as\n        | SessionFn<TServices, TLogger, TSession, T>\n        | undefined,\n      defaultEventPublisher: this.defaultEventPublisher,\n      availableAuthorizers: this.availableAuthorizers,\n      defaultAuthorizerName: this.defaultAuthorizerName,\n      defaultAuditorStorage: this.defaultAuditorStorage,\n      defaultDatabaseService: service,\n    });\n  }\n\n  /**\n   * Set the auditor storage service for endpoints created from this factory.\n   * This enables audit functionality and makes `auditor` available in handler context.\n   * The audit action type is automatically inferred from the storage's generic parameter.\n   */\n  auditor<T extends AuditStorage<any>, TName extends string>(\n    storage: Service<TName, T>,\n  ): EndpointFactory<\n    TServices,\n    TBasePath,\n    TLogger,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    T,\n    TName,\n    ExtractStorageAuditAction<T>,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    return new EndpointFactory<\n      TServices,\n      TBasePath,\n      TLogger,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      T,\n      TName,\n      ExtractStorageAuditAction<T>,\n      TDatabase,\n      TDatabaseServiceName\n    >({\n      defaultServices: this.defaultServices,\n      basePath: this.basePath,\n      defaultAuthorizeFn: this.defaultAuthorizeFn,\n      defaultLogger: this.defaultLogger,\n      defaultSessionExtractor: this.defaultSessionExtractor,\n      defaultEventPublisher: this.defaultEventPublisher,\n      availableAuthorizers: this.availableAuthorizers,\n      defaultAuthorizerName: this.defaultAuthorizerName,\n      defaultAuditorStorage: storage,\n      defaultDatabaseService: this.defaultDatabaseService,\n      defaultActorExtractor: this\n        .defaultActorExtractor as unknown as ActorExtractor<\n        TServices,\n        TSession,\n        TLogger\n      >,\n    });\n  }\n\n  /**\n   * Set the actor extractor function for endpoints created from this factory.\n   * The actor is extracted from the request context and attached to all audits.\n   */\n  actor(\n    extractor: ActorExtractor<TServices, TSession, TLogger>,\n  ): EndpointFactory<\n    TServices,\n    TBasePath,\n    TLogger,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    return new EndpointFactory<\n      TServices,\n      TBasePath,\n      TLogger,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >({\n      defaultServices: this.defaultServices,\n      basePath: this.basePath,\n      defaultAuthorizeFn: this.defaultAuthorizeFn,\n      defaultLogger: this.defaultLogger,\n      defaultSessionExtractor: this.defaultSessionExtractor,\n      defaultEventPublisher: this.defaultEventPublisher,\n      availableAuthorizers: this.availableAuthorizers,\n      defaultAuthorizerName: this.defaultAuthorizerName,\n      defaultAuditorStorage: this.defaultAuditorStorage,\n      defaultDatabaseService: this.defaultDatabaseService,\n      defaultActorExtractor: extractor,\n    });\n  }\n\n  private createBuilder<TMethod extends HttpMethod, TPath extends string>(\n    method: TMethod,\n    path: TPath,\n  ): EndpointBuilder<\n    JoinPaths<TBasePath, TPath>,\n    TMethod,\n    {},\n    TServices,\n    TLogger,\n    undefined,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    const fullPath = EndpointFactory.joinPaths(path, this.basePath);\n    const builder = new EndpointBuilder<\n      JoinPaths<TBasePath, TPath>,\n      TMethod,\n      {},\n      TServices,\n      TLogger,\n      undefined,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >(fullPath, method);\n\n    if (this.defaultAuthorizeFn) {\n      // @ts-ignore\n      builder._authorize = this.defaultAuthorizeFn;\n    }\n    if (this.defaultServices.length) {\n      // Create a copy to avoid sharing references between builders\n      builder._services = [...this.defaultServices] as TServices;\n    }\n\n    if (this.defaultLogger) {\n      builder._logger = this.defaultLogger as TLogger;\n    }\n\n    if (this.defaultSessionExtractor) {\n      builder._getSession = this.defaultSessionExtractor as SessionFn<\n        TServices,\n        TLogger,\n        TSession\n      >;\n    }\n\n    if (this.defaultEventPublisher) {\n      builder._setPublisher(this.defaultEventPublisher);\n    }\n\n    // Set available authorizers and default\n    builder._availableAuthorizers = this.availableAuthorizers;\n    if (this.defaultAuthorizerName) {\n      builder._authorizerName = this.defaultAuthorizerName;\n    }\n\n    // Set auditor storage if configured\n    if (this.defaultAuditorStorage) {\n      builder._setAuditorStorage(this.defaultAuditorStorage as any);\n    }\n\n    // Set database service if configured\n    if (this.defaultDatabaseService) {\n      builder._setDatabaseService(this.defaultDatabaseService as any);\n    }\n\n    // Set actor extractor if configured\n    if (this.defaultActorExtractor) {\n      builder._actorExtractor = this.defaultActorExtractor;\n    }\n\n    return builder;\n  }\n\n  post<TPath extends string>(path: TPath) {\n    return this.createBuilder('POST', path);\n  }\n\n  get<TPath extends string>(path: TPath) {\n    return this.createBuilder('GET', path);\n  }\n\n  put<TPath extends string>(path: TPath) {\n    return this.createBuilder('PUT', path);\n  }\n\n  delete<TPath extends string>(path: TPath) {\n    return this.createBuilder('DELETE', path);\n  }\n\n  patch<TPath extends string>(path: TPath) {\n    return this.createBuilder('PATCH', path);\n  }\n\n  options<TPath extends string>(path: TPath) {\n    return this.createBuilder('OPTIONS', path);\n  }\n}\n\nexport type RemoveTrailingSlash<T extends string> = T extends `${infer Rest}/`\n  ? Rest extends ''\n    ? T // Keep \"/\" as is\n    : Rest\n  : T;\n\nexport type JoinPaths<\n  TBasePath extends string,\n  TPath extends string,\n> = RemoveTrailingSlash<\n  TBasePath extends ''\n    ? TPath\n    : TPath extends ''\n      ? TBasePath\n      : TBasePath extends '/'\n        ? TPath extends `/${string}`\n          ? TPath\n          : `/${TPath}`\n        : TBasePath extends `${infer Base}/`\n          ? TPath extends `/${infer Rest}`\n            ? `${Base}/${Rest}`\n            : `${Base}/${TPath}`\n          : TPath extends `/${infer Rest}`\n            ? `${TBasePath}/${Rest}`\n            : `${TBasePath}/${TPath}`\n>;\n\nexport interface EndpointFactoryOptions<\n  TServices extends Service[] = [],\n  TBasePath extends string = '',\n  TLogger extends Logger = Logger,\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  TDatabase = undefined,\n  TDatabaseServiceName extends string = string,\n> {\n  defaultServices?: TServices;\n  basePath?: TBasePath;\n  defaultAuthorizeFn?: AuthorizeFn<TServices, TLogger, TSession>;\n  defaultLogger?: TLogger;\n  defaultSessionExtractor?: SessionFn<TServices, TLogger, TSession, TDatabase>;\n  defaultEventPublisher?: Service<TEventPublisherServiceName, TEventPublisher>;\n  defaultEvents?: MappedEvent<TEventPublisher, undefined>[];\n  availableAuthorizers?: Authorizer[];\n  defaultAuthorizerName?: TAuthorizers[number];\n  defaultAuditorStorage?: Service<TAuditStorageServiceName, TAuditStorage>;\n  defaultDatabaseService?: Service<TDatabaseServiceName, TDatabase>;\n  defaultActorExtractor?: ActorExtractor<TServices, TSession, TLogger>;\n}\n\nexport const e = new EndpointFactory();\n"],"mappings":"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"}

package/dist/EndpointFactory-D5lFZXqY.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"EndpointFactory-D5lFZXqY.cjs","names":["ConsoleLogger","path: P","basePath: TBasePath","authorizers: T","name: TAuthorizers[number] | 'none'","path: TPath","fn: AuthorizeFn<TServices, TLogger, TSession>","services: S","logger: L","publisher: Service<TServiceName, T>","session: SessionFn<TServices, TLogger, T, TDatabase>","service: Service<TName, T>","storage: Service<TName, T>","extractor: ActorExtractor<TServices, TSession, TLogger>","method: TMethod","EndpointBuilder"],"sources":["../src/endpoints/EndpointFactory.ts"],"sourcesContent":["import type {\n  AuditStorage,\n  AuditableAction,\n  ExtractStorageAuditAction,\n} from '@geekmidas/audit';\nimport type { EventPublisher, MappedEvent } from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport { ConsoleLogger } from '@geekmidas/logger/console';\nimport type { Service } from '@geekmidas/services';\nimport uniqBy from 'lodash.uniqby';\nimport type { HttpMethod } from '../types';\nimport type { Authorizer } from './Authorizer';\nimport type { AuthorizeFn, SessionFn } from './Endpoint';\nimport { EndpointBuilder } from './EndpointBuilder';\nimport type { ActorExtractor } from './audit';\n\nconst DEFAULT_LOGGER = new ConsoleLogger() as any;\n\nexport class EndpointFactory<\n  TServices extends Service[] = [],\n  TBasePath extends string = '',\n  TLogger extends Logger = Logger,\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<any> | undefined = undefined,\n  TAuditStorageServiceName extends string = string,\n  TAuditAction extends AuditableAction<\n    string,\n    unknown\n  > = ExtractStorageAuditAction<NonNullable<TAuditStorage>>,\n  TDatabase = undefined,\n  TDatabaseServiceName extends string = string,\n> {\n  // @ts-ignore\n  private defaultServices: TServices;\n  private basePath: TBasePath = '' as TBasePath;\n  private defaultAuthorizeFn?: AuthorizeFn<TServices, TLogger, TSession>;\n  private defaultEventPublisher:\n    | Service<TEventPublisherServiceName, TEventPublisher>\n    | undefined;\n  private defaultSessionExtractor?: SessionFn<\n    TServices,\n    TLogger,\n    TSession,\n    TDatabase\n  >;\n  private defaultLogger: TLogger = DEFAULT_LOGGER;\n  private availableAuthorizers: Authorizer[] = [];\n  private defaultAuthorizerName?: TAuthorizers[number];\n  private defaultAuditorStorage:\n    | Service<TAuditStorageServiceName, TAuditStorage>\n    | undefined;\n  private defaultDatabaseService:\n    | Service<TDatabaseServiceName, TDatabase>\n    | undefined;\n  private defaultActorExtractor?: ActorExtractor<TServices, TSession, TLogger>;\n\n  constructor({\n    basePath,\n    defaultAuthorizeFn,\n    defaultLogger,\n    defaultSessionExtractor,\n    // @ts-ignore\n    defaultServices = [] as TServices,\n    defaultEventPublisher,\n    availableAuthorizers = [],\n    defaultAuthorizerName,\n    defaultAuditorStorage,\n    defaultDatabaseService,\n    defaultActorExtractor,\n  }: EndpointFactoryOptions<\n    TServices,\n    TBasePath,\n    TLogger,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TDatabase,\n    TDatabaseServiceName\n  > = {}) {\n    // Initialize default services\n    this.defaultServices = uniqBy(\n      defaultServices,\n      (s) => s.serviceName,\n    ) as TServices;\n\n    this.basePath = basePath || ('' as TBasePath);\n    this.defaultAuthorizeFn = defaultAuthorizeFn;\n    this.defaultLogger = defaultLogger || (DEFAULT_LOGGER as TLogger);\n    this.defaultSessionExtractor = defaultSessionExtractor;\n    this.defaultEventPublisher = defaultEventPublisher;\n    this.availableAuthorizers = availableAuthorizers;\n    this.defaultAuthorizerName = defaultAuthorizerName;\n    this.defaultAuditorStorage = defaultAuditorStorage;\n    this.defaultDatabaseService = defaultDatabaseService;\n    this.defaultActorExtractor = defaultActorExtractor;\n  }\n\n  static joinPaths<TBasePath extends string, P extends string>(\n    path: P,\n    basePath: TBasePath = '' as TBasePath,\n  ): JoinPaths<TBasePath, P> {\n    // Handle empty cases\n    if (!basePath && !path) return '/' as JoinPaths<TBasePath, P>;\n    if (!basePath)\n      return (path.startsWith('/') ? path : '/' + path) as JoinPaths<\n        TBasePath,\n        P\n      >;\n    if (!path)\n      return (\n        basePath.startsWith('/') ? basePath : '/' + basePath\n      ) as JoinPaths<TBasePath, P>;\n\n    const base = basePath.endsWith('/') ? basePath.slice(0, -1) : basePath;\n    const segment = path.startsWith('/') ? path : '/' + path;\n\n    let result = base + segment;\n\n    // Ensure leading slash\n    if (!result.startsWith('/')) {\n      result = '/' + result;\n    }\n\n    // Normalize multiple slashes (except in the middle of the path where they might be intentional)\n    result = result.replace(/^\\/+/g, '/');\n\n    // Remove trailing slash unless it's the root path \"/\"\n    if (result.length > 1 && result.endsWith('/')) {\n      result = result.slice(0, -1);\n    }\n\n    return result as JoinPaths<TBasePath, P>;\n  }\n\n  // Configure available authorizers\n  authorizers<const T extends readonly string[]>(\n    authorizers: T,\n  ): EndpointFactory<\n    TServices,\n    TBasePath,\n    TLogger,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    T,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    const authorizerConfigs = authorizers.map((name) => ({\n      name,\n    }));\n    return new EndpointFactory<\n      TServices,\n      TBasePath,\n      TLogger,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      T,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >({\n      defaultServices: this.defaultServices,\n      basePath: this.basePath,\n      defaultAuthorizeFn: this.defaultAuthorizeFn,\n      defaultLogger: this.defaultLogger,\n      defaultSessionExtractor: this.defaultSessionExtractor,\n      defaultEventPublisher: this.defaultEventPublisher,\n      availableAuthorizers: authorizerConfigs,\n      defaultAuthorizerName: this.defaultAuthorizerName,\n      defaultAuditorStorage: this.defaultAuditorStorage,\n      defaultDatabaseService: this.defaultDatabaseService,\n      defaultActorExtractor: this.defaultActorExtractor,\n    });\n  }\n\n  /**\n   * Set the default authorizer for all endpoints created from this factory.\n   * Individual endpoints can override this by calling `.authorizer()` on the builder.\n   * Use `'none'` to explicitly disable authorization for all endpoints.\n   */\n  authorizer(\n    name: TAuthorizers[number] | 'none',\n  ): EndpointFactory<\n    TServices,\n    TBasePath,\n    TLogger,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    // Validate that the authorizer exists in available authorizers\n    if (name !== 'none' && this.availableAuthorizers.length > 0) {\n      const authorizerExists = this.availableAuthorizers.some(\n        (a) => a.name === name,\n      );\n      if (!authorizerExists) {\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    }\n\n    return new EndpointFactory<\n      TServices,\n      TBasePath,\n      TLogger,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >({\n      defaultServices: this.defaultServices,\n      basePath: this.basePath,\n      defaultAuthorizeFn: this.defaultAuthorizeFn,\n      defaultLogger: this.defaultLogger,\n      defaultSessionExtractor: this.defaultSessionExtractor,\n      defaultEventPublisher: this.defaultEventPublisher,\n      availableAuthorizers: this.availableAuthorizers,\n      defaultAuthorizerName: name === 'none' ? undefined : name,\n      defaultAuditorStorage: this.defaultAuditorStorage,\n      defaultDatabaseService: this.defaultDatabaseService,\n      defaultActorExtractor: this.defaultActorExtractor,\n    });\n  }\n\n  // Create a sub-router with a path prefix\n  route<TPath extends string>(\n    path: TPath,\n  ): EndpointFactory<\n    TServices,\n    JoinPaths<TBasePath, TPath>,\n    TLogger,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    const newBasePath = EndpointFactory.joinPaths(path, this.basePath);\n    return new EndpointFactory<\n      TServices,\n      JoinPaths<TBasePath, TPath>,\n      TLogger,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >({\n      defaultServices: this.defaultServices,\n      basePath: newBasePath,\n      defaultAuthorizeFn: this.defaultAuthorizeFn,\n      defaultLogger: this.defaultLogger,\n      defaultSessionExtractor: this.defaultSessionExtractor,\n      defaultEventPublisher: this.defaultEventPublisher,\n      availableAuthorizers: this.availableAuthorizers,\n      defaultAuthorizerName: this.defaultAuthorizerName,\n      defaultAuditorStorage: this.defaultAuditorStorage,\n      defaultDatabaseService: this.defaultDatabaseService,\n      defaultActorExtractor: this.defaultActorExtractor,\n    });\n  }\n\n  // Create a new factory with authorization\n  authorize(\n    fn: AuthorizeFn<TServices, TLogger, TSession>,\n  ): EndpointFactory<\n    TServices,\n    TBasePath,\n    TLogger,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    return new EndpointFactory<\n      TServices,\n      TBasePath,\n      TLogger,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >({\n      defaultServices: this.defaultServices,\n      basePath: this.basePath,\n      defaultAuthorizeFn: fn,\n      defaultLogger: this.defaultLogger,\n      defaultSessionExtractor: this.defaultSessionExtractor,\n      defaultEventPublisher: this.defaultEventPublisher,\n      availableAuthorizers: this.availableAuthorizers,\n      defaultAuthorizerName: this.defaultAuthorizerName,\n      defaultAuditorStorage: this.defaultAuditorStorage,\n      defaultDatabaseService: this.defaultDatabaseService,\n      defaultActorExtractor: this.defaultActorExtractor,\n    });\n  }\n\n  // Create a new factory with services\n  services<S extends Service[]>(\n    services: S,\n  ): EndpointFactory<\n    [...S, ...TServices],\n    TBasePath,\n    TLogger,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    return new EndpointFactory<\n      [...S, ...TServices],\n      TBasePath,\n      TLogger,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >({\n      defaultServices: [...services, ...this.defaultServices],\n      basePath: this.basePath,\n      defaultAuthorizeFn: this.defaultAuthorizeFn,\n      defaultLogger: this.defaultLogger,\n      defaultSessionExtractor: this.defaultSessionExtractor,\n      defaultEventPublisher: this.defaultEventPublisher,\n      availableAuthorizers: this.availableAuthorizers,\n      defaultAuthorizerName: this.defaultAuthorizerName,\n      defaultAuditorStorage: this.defaultAuditorStorage,\n      defaultDatabaseService: this.defaultDatabaseService,\n      defaultActorExtractor: this.defaultActorExtractor,\n    });\n  }\n\n  logger<L extends Logger>(\n    logger: L,\n  ): EndpointFactory<\n    TServices,\n    TBasePath,\n    L,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    return new EndpointFactory<\n      TServices,\n      TBasePath,\n      L,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >({\n      defaultServices: this.defaultServices,\n      basePath: this.basePath,\n      defaultAuthorizeFn: this.defaultAuthorizeFn as unknown as AuthorizeFn<\n        TServices,\n        L,\n        TSession\n      >,\n      defaultLogger: logger,\n      defaultSessionExtractor: this\n        .defaultSessionExtractor as unknown as SessionFn<\n        TServices,\n        L,\n        TSession\n      >,\n      defaultEventPublisher: this.defaultEventPublisher,\n      availableAuthorizers: this.availableAuthorizers,\n      defaultAuthorizerName: this.defaultAuthorizerName,\n      defaultAuditorStorage: this.defaultAuditorStorage,\n      defaultDatabaseService: this.defaultDatabaseService,\n      defaultActorExtractor: this\n        .defaultActorExtractor as unknown as ActorExtractor<\n        TServices,\n        TSession,\n        L\n      >,\n    });\n  }\n\n  publisher<\n    T extends EventPublisher<any>,\n    TServiceName extends string = string,\n  >(\n    publisher: Service<TServiceName, T>,\n  ): EndpointFactory<\n    TServices,\n    TBasePath,\n    TLogger,\n    TSession,\n    T,\n    TServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    return new EndpointFactory<\n      TServices,\n      TBasePath,\n      TLogger,\n      TSession,\n      T,\n      TServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >({\n      defaultServices: this.defaultServices,\n      basePath: this.basePath,\n      defaultAuthorizeFn: this.defaultAuthorizeFn,\n      defaultLogger: this.defaultLogger,\n      defaultSessionExtractor: this.defaultSessionExtractor,\n      defaultEventPublisher: publisher,\n      availableAuthorizers: this.availableAuthorizers,\n      defaultAuthorizerName: this.defaultAuthorizerName,\n      defaultAuditorStorage: this.defaultAuditorStorage,\n      defaultDatabaseService: this.defaultDatabaseService,\n      defaultActorExtractor: this.defaultActorExtractor,\n    });\n  }\n\n  session<T>(\n    session: SessionFn<TServices, TLogger, T, TDatabase>,\n  ): EndpointFactory<\n    TServices,\n    TBasePath,\n    TLogger,\n    T,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    return new EndpointFactory<\n      TServices,\n      TBasePath,\n      TLogger,\n      T,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >({\n      defaultServices: this.defaultServices,\n      basePath: this.basePath,\n      defaultAuthorizeFn: this.defaultAuthorizeFn as unknown as AuthorizeFn<\n        TServices,\n        TLogger,\n        T\n      >,\n      defaultLogger: this.defaultLogger,\n      defaultSessionExtractor: session,\n      defaultEventPublisher: this.defaultEventPublisher,\n      availableAuthorizers: this.availableAuthorizers,\n      defaultAuthorizerName: this.defaultAuthorizerName,\n      defaultAuditorStorage: this.defaultAuditorStorage,\n      defaultDatabaseService: this.defaultDatabaseService,\n      defaultActorExtractor: this\n        .defaultActorExtractor as unknown as ActorExtractor<\n        TServices,\n        T,\n        TLogger\n      >,\n    });\n  }\n\n  /**\n   * Set the database service for endpoints created from this factory.\n   * The database will be available in handler context as `db`.\n   */\n  database<T, TName extends string>(\n    service: Service<TName, T>,\n  ): EndpointFactory<\n    TServices,\n    TBasePath,\n    TLogger,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    T,\n    TName\n  > {\n    return new EndpointFactory<\n      TServices,\n      TBasePath,\n      TLogger,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      T,\n      TName\n    >({\n      defaultServices: this.defaultServices,\n      basePath: this.basePath,\n      defaultAuthorizeFn: this.defaultAuthorizeFn,\n      defaultLogger: this.defaultLogger,\n      // Reset session extractor when database changes - user should call .session() after .database()\n      // to get proper type inference for the new database type\n      defaultSessionExtractor: this.defaultSessionExtractor as unknown as\n        | SessionFn<TServices, TLogger, TSession, T>\n        | undefined,\n      defaultEventPublisher: this.defaultEventPublisher,\n      availableAuthorizers: this.availableAuthorizers,\n      defaultAuthorizerName: this.defaultAuthorizerName,\n      defaultAuditorStorage: this.defaultAuditorStorage,\n      defaultDatabaseService: service,\n    });\n  }\n\n  /**\n   * Set the auditor storage service for endpoints created from this factory.\n   * This enables audit functionality and makes `auditor` available in handler context.\n   * The audit action type is automatically inferred from the storage's generic parameter.\n   */\n  auditor<T extends AuditStorage<any>, TName extends string>(\n    storage: Service<TName, T>,\n  ): EndpointFactory<\n    TServices,\n    TBasePath,\n    TLogger,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    T,\n    TName,\n    ExtractStorageAuditAction<T>,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    return new EndpointFactory<\n      TServices,\n      TBasePath,\n      TLogger,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      T,\n      TName,\n      ExtractStorageAuditAction<T>,\n      TDatabase,\n      TDatabaseServiceName\n    >({\n      defaultServices: this.defaultServices,\n      basePath: this.basePath,\n      defaultAuthorizeFn: this.defaultAuthorizeFn,\n      defaultLogger: this.defaultLogger,\n      defaultSessionExtractor: this.defaultSessionExtractor,\n      defaultEventPublisher: this.defaultEventPublisher,\n      availableAuthorizers: this.availableAuthorizers,\n      defaultAuthorizerName: this.defaultAuthorizerName,\n      defaultAuditorStorage: storage,\n      defaultDatabaseService: this.defaultDatabaseService,\n      defaultActorExtractor: this\n        .defaultActorExtractor as unknown as ActorExtractor<\n        TServices,\n        TSession,\n        TLogger\n      >,\n    });\n  }\n\n  /**\n   * Set the actor extractor function for endpoints created from this factory.\n   * The actor is extracted from the request context and attached to all audits.\n   */\n  actor(\n    extractor: ActorExtractor<TServices, TSession, TLogger>,\n  ): EndpointFactory<\n    TServices,\n    TBasePath,\n    TLogger,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    return new EndpointFactory<\n      TServices,\n      TBasePath,\n      TLogger,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >({\n      defaultServices: this.defaultServices,\n      basePath: this.basePath,\n      defaultAuthorizeFn: this.defaultAuthorizeFn,\n      defaultLogger: this.defaultLogger,\n      defaultSessionExtractor: this.defaultSessionExtractor,\n      defaultEventPublisher: this.defaultEventPublisher,\n      availableAuthorizers: this.availableAuthorizers,\n      defaultAuthorizerName: this.defaultAuthorizerName,\n      defaultAuditorStorage: this.defaultAuditorStorage,\n      defaultDatabaseService: this.defaultDatabaseService,\n      defaultActorExtractor: extractor,\n    });\n  }\n\n  private createBuilder<TMethod extends HttpMethod, TPath extends string>(\n    method: TMethod,\n    path: TPath,\n  ): EndpointBuilder<\n    JoinPaths<TBasePath, TPath>,\n    TMethod,\n    {},\n    TServices,\n    TLogger,\n    undefined,\n    TSession,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuthorizers,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  > {\n    const fullPath = EndpointFactory.joinPaths(path, this.basePath);\n    const builder = new EndpointBuilder<\n      JoinPaths<TBasePath, TPath>,\n      TMethod,\n      {},\n      TServices,\n      TLogger,\n      undefined,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuthorizers,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >(fullPath, method);\n\n    if (this.defaultAuthorizeFn) {\n      // @ts-ignore\n      builder._authorize = this.defaultAuthorizeFn;\n    }\n    if (this.defaultServices.length) {\n      // Create a copy to avoid sharing references between builders\n      builder._services = [...this.defaultServices] as TServices;\n    }\n\n    if (this.defaultLogger) {\n      builder._logger = this.defaultLogger as TLogger;\n    }\n\n    if (this.defaultSessionExtractor) {\n      builder._getSession = this.defaultSessionExtractor as SessionFn<\n        TServices,\n        TLogger,\n        TSession\n      >;\n    }\n\n    if (this.defaultEventPublisher) {\n      builder._setPublisher(this.defaultEventPublisher);\n    }\n\n    // Set available authorizers and default\n    builder._availableAuthorizers = this.availableAuthorizers;\n    if (this.defaultAuthorizerName) {\n      builder._authorizerName = this.defaultAuthorizerName;\n    }\n\n    // Set auditor storage if configured\n    if (this.defaultAuditorStorage) {\n      builder._setAuditorStorage(this.defaultAuditorStorage as any);\n    }\n\n    // Set database service if configured\n    if (this.defaultDatabaseService) {\n      builder._setDatabaseService(this.defaultDatabaseService as any);\n    }\n\n    // Set actor extractor if configured\n    if (this.defaultActorExtractor) {\n      builder._actorExtractor = this.defaultActorExtractor;\n    }\n\n    return builder;\n  }\n\n  post<TPath extends string>(path: TPath) {\n    return this.createBuilder('POST', path);\n  }\n\n  get<TPath extends string>(path: TPath) {\n    return this.createBuilder('GET', path);\n  }\n\n  put<TPath extends string>(path: TPath) {\n    return this.createBuilder('PUT', path);\n  }\n\n  delete<TPath extends string>(path: TPath) {\n    return this.createBuilder('DELETE', path);\n  }\n\n  patch<TPath extends string>(path: TPath) {\n    return this.createBuilder('PATCH', path);\n  }\n\n  options<TPath extends string>(path: TPath) {\n    return this.createBuilder('OPTIONS', path);\n  }\n}\n\nexport type RemoveTrailingSlash<T extends string> = T extends `${infer Rest}/`\n  ? Rest extends ''\n    ? T // Keep \"/\" as is\n    : Rest\n  : T;\n\nexport type JoinPaths<\n  TBasePath extends string,\n  TPath extends string,\n> = RemoveTrailingSlash<\n  TBasePath extends ''\n    ? TPath\n    : TPath extends ''\n      ? TBasePath\n      : TBasePath extends '/'\n        ? TPath extends `/${string}`\n          ? TPath\n          : `/${TPath}`\n        : TBasePath extends `${infer Base}/`\n          ? TPath extends `/${infer Rest}`\n            ? `${Base}/${Rest}`\n            : `${Base}/${TPath}`\n          : TPath extends `/${infer Rest}`\n            ? `${TBasePath}/${Rest}`\n            : `${TBasePath}/${TPath}`\n>;\n\nexport interface EndpointFactoryOptions<\n  TServices extends Service[] = [],\n  TBasePath extends string = '',\n  TLogger extends Logger = Logger,\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  TDatabase = undefined,\n  TDatabaseServiceName extends string = string,\n> {\n  defaultServices?: TServices;\n  basePath?: TBasePath;\n  defaultAuthorizeFn?: AuthorizeFn<TServices, TLogger, TSession>;\n  defaultLogger?: TLogger;\n  defaultSessionExtractor?: SessionFn<TServices, TLogger, TSession, TDatabase>;\n  defaultEventPublisher?: Service<TEventPublisherServiceName, TEventPublisher>;\n  defaultEvents?: MappedEvent<TEventPublisher, undefined>[];\n  availableAuthorizers?: Authorizer[];\n  defaultAuthorizerName?: TAuthorizers[number];\n  defaultAuditorStorage?: Service<TAuditStorageServiceName, TAuditStorage>;\n  defaultDatabaseService?: Service<TDatabaseServiceName, TDatabase>;\n  defaultActorExtractor?: ActorExtractor<TServices, TSession, TLogger>;\n}\n\nexport const e = new EndpointFactory();\n"],"mappings":"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"}

package/dist/endpoints/Authorizer.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"Authorizer.cjs","names":["name: string","options?: Omit<Authorizer, 'name'>"],"sources":["../../src/endpoints/Authorizer.ts"],"sourcesContent":["/**\n * Represents an authorizer configuration for endpoints\n */\nexport interface Authorizer {\n  /**\n   * Unique identifier for the authorizer\n   */\n  name: string;\n  /**\n   * Type of authorizer (e.g., 'iam', 'jwt', 'custom')\n   */\n  type?: string;\n  /**\n   * Description of what this authorizer does\n   */\n  description?: string;\n  /**\n   * Additional metadata specific to the authorizer type\n   */\n  metadata?: Record<string, any>;\n}\n\n/**\n * Helper to create an authorizer configuration\n */\nexport function createAuthorizer(\n  name: string,\n  options?: Omit<Authorizer, 'name'>,\n): Authorizer {\n  return {\n    name,\n    ...options,\n  };\n}\n"],"mappings":";;;;;AAyBA,SAAgB,iBACdA,MACAC,SACY;AACZ,QAAO;EACL;EACA,GAAG;CACJ;AACF"}

package/dist/endpoints/Authorizer.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"Authorizer.mjs","names":["name: string","options?: Omit<Authorizer, 'name'>"],"sources":["../../src/endpoints/Authorizer.ts"],"sourcesContent":["/**\n * Represents an authorizer configuration for endpoints\n */\nexport interface Authorizer {\n  /**\n   * Unique identifier for the authorizer\n   */\n  name: string;\n  /**\n   * Type of authorizer (e.g., 'iam', 'jwt', 'custom')\n   */\n  type?: string;\n  /**\n   * Description of what this authorizer does\n   */\n  description?: string;\n  /**\n   * Additional metadata specific to the authorizer type\n   */\n  metadata?: Record<string, any>;\n}\n\n/**\n * Helper to create an authorizer configuration\n */\nexport function createAuthorizer(\n  name: string,\n  options?: Omit<Authorizer, 'name'>,\n): Authorizer {\n  return {\n    name,\n    ...options,\n  };\n}\n"],"mappings":";;;;AAyBA,SAAgB,iBACdA,MACAC,SACY;AACZ,QAAO;EACL;EACA,GAAG;CACJ;AACF"}

package/dist/index-licEVXjh.d.mts

@@ -1,10 +0,0 @@
-import { FunctionBuilder } from "./FunctionBuilder-j2VkwuGf.mjs";
-import * as _geekmidas_audit5 from "@geekmidas/audit";
-import * as _geekmidas_logger4 from "@geekmidas/logger";
-import * as _geekmidas_schema3 from "@geekmidas/schema";
-
-//#region src/functions/index.d.ts
-declare const f: FunctionBuilder<_geekmidas_schema3.ComposableStandardSchema, undefined, [], _geekmidas_logger4.Logger, undefined, string, undefined, string, undefined, string, _geekmidas_audit5.AuditableAction<string, unknown>>;
-//#endregion
-export { f };
-//# sourceMappingURL=index-licEVXjh.d.mts.map

package/dist/processAudits-BFokHhCO.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"processAudits-BFokHhCO.cjs","names":["endpoint: Endpoint<\n    any,\n    any,\n    any,\n    OutSchema,\n    TServices,\n    TLogger,\n    TSession,\n    any,\n    any,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction\n  >","response: InferStandardSchema<OutSchema>","serviceDiscovery: ServiceDiscovery<any, any>","logger: TLogger","ctx: {\n    session: TSession;\n    header: HeaderFn;\n    cookie: CookieFn;\n    services: Record<string, unknown>;\n  }","existingAuditor?: Auditor<TAuditAction>","auditor: Auditor<TAuditAction>","actor: AuditActor","DefaultAuditor","endpoint: Endpoint<\n    any,\n    any,\n    any,\n    any,\n    TServices,\n    TLogger,\n    TSession,\n    any,\n    any,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  >","auditContext: AuditExecutionContext<TAuditAction> | undefined","handler: (auditor?: Auditor<TAuditAction>) => Promise<T>","onComplete?: (response: T, auditor: Auditor<TAuditAction>) => Promise<void>","response"],"sources":["../src/endpoints/processAudits.ts"],"sourcesContent":["import type {\n  AuditActor,\n  AuditStorage,\n  AuditableAction,\n  Auditor,\n} from '@geekmidas/audit';\nimport { DefaultAuditor } from '@geekmidas/audit';\nimport { withAuditableTransaction } from '@geekmidas/audit/kysely';\nimport type { Logger } from '@geekmidas/logger';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service, ServiceDiscovery } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { CookieFn, Endpoint, HeaderFn } from './Endpoint';\nimport type { ActorExtractor, MappedAudit } from './audit';\n\n/**\n * Process declarative audit definitions after successful endpoint execution.\n * Similar to publishConstructEvents for events.\n *\n * @param endpoint - The endpoint with audit configuration\n * @param response - The handler response to generate audit payloads from\n * @param serviceDiscovery - Service discovery for registering audit storage\n * @param logger - Logger for debug/error messages\n * @param ctx - Request context (session, headers, cookies, services)\n * @param existingAuditor - Optional existing auditor instance (e.g., from handler context).\n *                          If provided, uses this auditor (with its stored transaction).\n *                          If not provided, creates a new auditor.\n */\nexport async function processEndpointAudits<\n  TServices extends Service[] = [],\n  TSession = unknown,\n  TLogger extends Logger = Logger,\n  OutSchema extends StandardSchemaV1 | undefined = undefined,\n  TAuditStorage extends AuditStorage | undefined = undefined,\n  TAuditStorageServiceName extends string = string,\n  TAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n    string,\n    unknown\n  >,\n>(\n  endpoint: Endpoint<\n    any,\n    any,\n    any,\n    OutSchema,\n    TServices,\n    TLogger,\n    TSession,\n    any,\n    any,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction\n  >,\n  response: InferStandardSchema<OutSchema>,\n  serviceDiscovery: ServiceDiscovery<any, any>,\n  logger: TLogger,\n  ctx: {\n    session: TSession;\n    header: HeaderFn;\n    cookie: CookieFn;\n    services: Record<string, unknown>;\n  },\n  existingAuditor?: Auditor<TAuditAction>,\n): Promise<void> {\n  try {\n    const audits = endpoint.audits as MappedAudit<TAuditAction, OutSchema>[];\n\n    // If we have an existing auditor (from handler context), we need to flush\n    // any manual audits it collected, even if there are no declarative audits\n    const hasExistingRecords =\n      existingAuditor && existingAuditor.getRecords().length > 0;\n\n    // Skip if no declarative audits and no existing records to flush\n    if (!audits?.length && !hasExistingRecords) {\n      logger.debug('No audits to process');\n      return;\n    }\n\n    // If no auditor storage service and we have things to process, warn\n    if (!endpoint.auditorStorageService) {\n      if (hasExistingRecords || audits?.length) {\n        logger.warn('No auditor storage service available');\n      }\n      return;\n    }\n\n    // Get or create auditor\n    let auditor: Auditor<TAuditAction>;\n\n    if (existingAuditor) {\n      // Use existing auditor (preserves stored transaction and manual audits)\n      auditor = existingAuditor;\n      logger.debug('Using existing auditor from handler context');\n    } else {\n      // Create new auditor (backward compatibility)\n      const services = await serviceDiscovery.register([\n        endpoint.auditorStorageService,\n      ]);\n      const storage = services[\n        endpoint.auditorStorageService.serviceName\n      ] as AuditStorage;\n\n      // Extract actor if configured\n      let actor: AuditActor = { id: 'system', type: 'system' };\n      if (endpoint.actorExtractor) {\n        try {\n          actor = await (\n            endpoint.actorExtractor as ActorExtractor<\n              TServices,\n              TSession,\n              TLogger\n            >\n          )({\n            services: ctx.services as any,\n            session: ctx.session,\n            header: ctx.header,\n            cookie: ctx.cookie,\n            logger,\n          });\n        } catch (error) {\n          logger.error(error as Error, 'Failed to extract actor for audits');\n          // Continue with system actor\n        }\n      }\n\n      auditor = new DefaultAuditor<TAuditAction>({\n        actor,\n        storage,\n        metadata: {\n          endpoint: endpoint.route,\n          method: endpoint.method,\n        },\n      });\n    }\n\n    // Process each declarative audit\n    if (audits?.length) {\n      for (const audit of audits) {\n        logger.debug({ audit: audit.type }, 'Processing declarative audit');\n\n        // Check when condition\n        if (audit.when && !audit.when(response as any)) {\n          logger.debug(\n            { audit: audit.type },\n            'Audit skipped due to when condition',\n          );\n          continue;\n        }\n\n        // Extract payload\n        const payload = audit.payload(response as any);\n\n        // Extract entityId if configured\n        const entityId = audit.entityId?.(response as any);\n\n        // Record the audit\n        auditor.audit(audit.type as any, payload as any, {\n          table: audit.table,\n          entityId,\n        });\n      }\n    }\n\n    // Flush audits to storage\n    // Note: If existingAuditor has a stored transaction (via setTransaction),\n    // flush() will use it automatically\n    const recordCount = auditor.getRecords().length;\n    if (recordCount > 0) {\n      // Check if auditor has a stored transaction (for logging purposes)\n      const trx =\n        'getTransaction' in auditor\n          ? (auditor as { getTransaction(): unknown }).getTransaction()\n          : undefined;\n      logger.debug(\n        { auditCount: recordCount, hasTransaction: !!trx },\n        'Flushing audits',\n      );\n      await auditor.flush();\n    }\n  } catch (error) {\n    logger.error(error as Error, 'Failed to process audits');\n    // Don't rethrow - audit failures shouldn't fail the request\n  }\n}\n\n/**\n * Context for audit-aware handler execution.\n */\nexport interface AuditExecutionContext<\n  TAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n    string,\n    unknown\n  >,\n> {\n  /** The auditor instance for recording audits */\n  auditor: Auditor<TAuditAction>;\n  /** The audit storage instance */\n  storage: AuditStorage;\n}\n\n/**\n * Create audit context for handler execution.\n * Returns the auditor and storage for use in the handler.\n *\n * @param endpoint - The endpoint with audit configuration\n * @param serviceDiscovery - Service discovery for getting audit storage\n * @param logger - Logger for debug/error messages\n * @param ctx - Request context for actor extraction\n * @returns Audit context with auditor and storage, or undefined if not configured\n */\nexport async function createAuditContext<\n  TServices extends Service[] = [],\n  TSession = unknown,\n  TLogger extends Logger = Logger,\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>(\n  endpoint: Endpoint<\n    any,\n    any,\n    any,\n    any,\n    TServices,\n    TLogger,\n    TSession,\n    any,\n    any,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  >,\n  serviceDiscovery: ServiceDiscovery<any, any>,\n  logger: TLogger,\n  ctx: {\n    session: TSession;\n    header: HeaderFn;\n    cookie: CookieFn;\n    services: Record<string, unknown>;\n  },\n): Promise<AuditExecutionContext<TAuditAction> | undefined> {\n  if (!endpoint.auditorStorageService) {\n    return undefined;\n  }\n\n  const services = await serviceDiscovery.register([\n    endpoint.auditorStorageService,\n  ]);\n  const storage = services[\n    endpoint.auditorStorageService.serviceName\n  ] as AuditStorage;\n\n  // Extract actor if configured\n  let actor: AuditActor = { id: 'system', type: 'system' };\n  if (endpoint.actorExtractor) {\n    try {\n      actor = await (\n        endpoint.actorExtractor as ActorExtractor<TServices, TSession, TLogger>\n      )({\n        services: ctx.services as any,\n        session: ctx.session,\n        header: ctx.header,\n        cookie: ctx.cookie,\n        logger,\n      });\n    } catch (error) {\n      logger.error(error as Error, 'Failed to extract actor for audits');\n    }\n  }\n\n  const auditor = new DefaultAuditor<TAuditAction>({\n    actor,\n    storage,\n    metadata: {\n      endpoint: endpoint.route,\n      method: endpoint.method,\n    },\n  });\n\n  return { auditor, storage };\n}\n\n/**\n * Execute a handler with automatic audit transaction support.\n * If the audit storage has a database (via getDatabase()), wraps execution\n * in a transaction so audits are atomic with handler's database operations.\n *\n * @param auditContext - The audit context from createAuditContext\n * @param handler - The handler function to execute (receives auditor)\n * @param onComplete - Called after handler with response, to process declarative audits\n * @returns The handler result\n */\nexport async function executeWithAuditTransaction<\n  T,\n  TAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n    string,\n    unknown\n  >,\n>(\n  auditContext: AuditExecutionContext<TAuditAction> | undefined,\n  handler: (auditor?: Auditor<TAuditAction>) => Promise<T>,\n  onComplete?: (response: T, auditor: Auditor<TAuditAction>) => Promise<void>,\n): Promise<T> {\n  // No audit context - just run handler\n  if (!auditContext) {\n    return handler(undefined);\n  }\n\n  const { auditor, storage } = auditContext;\n\n  // Check if storage has a database for transactional execution\n  const db = storage.getDatabase?.();\n\n  if (db) {\n    // Wrap in transaction - audits are atomic with handler operations\n    return withAuditableTransaction(db as any, auditor as any, async () => {\n      const response = await handler(auditor);\n\n      // Process declarative audits within the transaction\n      if (onComplete) {\n        await onComplete(response, auditor);\n      }\n\n      // Audits are flushed by withAuditableTransaction before commit\n      return response;\n    });\n  }\n\n  // No database - run handler and flush audits after\n  const response = await handler(auditor);\n\n  if (onComplete) {\n    await onComplete(response, auditor);\n  }\n\n  // Flush audits (no transaction)\n  await auditor.flush();\n\n  return response;\n}\n"],"mappings":"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"}

package/dist/processAudits-DfcB-X-4.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"processAudits-DfcB-X-4.mjs","names":["endpoint: Endpoint<\n    any,\n    any,\n    any,\n    OutSchema,\n    TServices,\n    TLogger,\n    TSession,\n    any,\n    any,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction\n  >","response: InferStandardSchema<OutSchema>","serviceDiscovery: ServiceDiscovery<any, any>","logger: TLogger","ctx: {\n    session: TSession;\n    header: HeaderFn;\n    cookie: CookieFn;\n    services: Record<string, unknown>;\n  }","existingAuditor?: Auditor<TAuditAction>","auditor: Auditor<TAuditAction>","actor: AuditActor","endpoint: Endpoint<\n    any,\n    any,\n    any,\n    any,\n    TServices,\n    TLogger,\n    TSession,\n    any,\n    any,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  >","auditContext: AuditExecutionContext<TAuditAction> | undefined","handler: (auditor?: Auditor<TAuditAction>) => Promise<T>","onComplete?: (response: T, auditor: Auditor<TAuditAction>) => Promise<void>","response"],"sources":["../src/endpoints/processAudits.ts"],"sourcesContent":["import type {\n  AuditActor,\n  AuditStorage,\n  AuditableAction,\n  Auditor,\n} from '@geekmidas/audit';\nimport { DefaultAuditor } from '@geekmidas/audit';\nimport { withAuditableTransaction } from '@geekmidas/audit/kysely';\nimport type { Logger } from '@geekmidas/logger';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service, ServiceDiscovery } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { CookieFn, Endpoint, HeaderFn } from './Endpoint';\nimport type { ActorExtractor, MappedAudit } from './audit';\n\n/**\n * Process declarative audit definitions after successful endpoint execution.\n * Similar to publishConstructEvents for events.\n *\n * @param endpoint - The endpoint with audit configuration\n * @param response - The handler response to generate audit payloads from\n * @param serviceDiscovery - Service discovery for registering audit storage\n * @param logger - Logger for debug/error messages\n * @param ctx - Request context (session, headers, cookies, services)\n * @param existingAuditor - Optional existing auditor instance (e.g., from handler context).\n *                          If provided, uses this auditor (with its stored transaction).\n *                          If not provided, creates a new auditor.\n */\nexport async function processEndpointAudits<\n  TServices extends Service[] = [],\n  TSession = unknown,\n  TLogger extends Logger = Logger,\n  OutSchema extends StandardSchemaV1 | undefined = undefined,\n  TAuditStorage extends AuditStorage | undefined = undefined,\n  TAuditStorageServiceName extends string = string,\n  TAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n    string,\n    unknown\n  >,\n>(\n  endpoint: Endpoint<\n    any,\n    any,\n    any,\n    OutSchema,\n    TServices,\n    TLogger,\n    TSession,\n    any,\n    any,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction\n  >,\n  response: InferStandardSchema<OutSchema>,\n  serviceDiscovery: ServiceDiscovery<any, any>,\n  logger: TLogger,\n  ctx: {\n    session: TSession;\n    header: HeaderFn;\n    cookie: CookieFn;\n    services: Record<string, unknown>;\n  },\n  existingAuditor?: Auditor<TAuditAction>,\n): Promise<void> {\n  try {\n    const audits = endpoint.audits as MappedAudit<TAuditAction, OutSchema>[];\n\n    // If we have an existing auditor (from handler context), we need to flush\n    // any manual audits it collected, even if there are no declarative audits\n    const hasExistingRecords =\n      existingAuditor && existingAuditor.getRecords().length > 0;\n\n    // Skip if no declarative audits and no existing records to flush\n    if (!audits?.length && !hasExistingRecords) {\n      logger.debug('No audits to process');\n      return;\n    }\n\n    // If no auditor storage service and we have things to process, warn\n    if (!endpoint.auditorStorageService) {\n      if (hasExistingRecords || audits?.length) {\n        logger.warn('No auditor storage service available');\n      }\n      return;\n    }\n\n    // Get or create auditor\n    let auditor: Auditor<TAuditAction>;\n\n    if (existingAuditor) {\n      // Use existing auditor (preserves stored transaction and manual audits)\n      auditor = existingAuditor;\n      logger.debug('Using existing auditor from handler context');\n    } else {\n      // Create new auditor (backward compatibility)\n      const services = await serviceDiscovery.register([\n        endpoint.auditorStorageService,\n      ]);\n      const storage = services[\n        endpoint.auditorStorageService.serviceName\n      ] as AuditStorage;\n\n      // Extract actor if configured\n      let actor: AuditActor = { id: 'system', type: 'system' };\n      if (endpoint.actorExtractor) {\n        try {\n          actor = await (\n            endpoint.actorExtractor as ActorExtractor<\n              TServices,\n              TSession,\n              TLogger\n            >\n          )({\n            services: ctx.services as any,\n            session: ctx.session,\n            header: ctx.header,\n            cookie: ctx.cookie,\n            logger,\n          });\n        } catch (error) {\n          logger.error(error as Error, 'Failed to extract actor for audits');\n          // Continue with system actor\n        }\n      }\n\n      auditor = new DefaultAuditor<TAuditAction>({\n        actor,\n        storage,\n        metadata: {\n          endpoint: endpoint.route,\n          method: endpoint.method,\n        },\n      });\n    }\n\n    // Process each declarative audit\n    if (audits?.length) {\n      for (const audit of audits) {\n        logger.debug({ audit: audit.type }, 'Processing declarative audit');\n\n        // Check when condition\n        if (audit.when && !audit.when(response as any)) {\n          logger.debug(\n            { audit: audit.type },\n            'Audit skipped due to when condition',\n          );\n          continue;\n        }\n\n        // Extract payload\n        const payload = audit.payload(response as any);\n\n        // Extract entityId if configured\n        const entityId = audit.entityId?.(response as any);\n\n        // Record the audit\n        auditor.audit(audit.type as any, payload as any, {\n          table: audit.table,\n          entityId,\n        });\n      }\n    }\n\n    // Flush audits to storage\n    // Note: If existingAuditor has a stored transaction (via setTransaction),\n    // flush() will use it automatically\n    const recordCount = auditor.getRecords().length;\n    if (recordCount > 0) {\n      // Check if auditor has a stored transaction (for logging purposes)\n      const trx =\n        'getTransaction' in auditor\n          ? (auditor as { getTransaction(): unknown }).getTransaction()\n          : undefined;\n      logger.debug(\n        { auditCount: recordCount, hasTransaction: !!trx },\n        'Flushing audits',\n      );\n      await auditor.flush();\n    }\n  } catch (error) {\n    logger.error(error as Error, 'Failed to process audits');\n    // Don't rethrow - audit failures shouldn't fail the request\n  }\n}\n\n/**\n * Context for audit-aware handler execution.\n */\nexport interface AuditExecutionContext<\n  TAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n    string,\n    unknown\n  >,\n> {\n  /** The auditor instance for recording audits */\n  auditor: Auditor<TAuditAction>;\n  /** The audit storage instance */\n  storage: AuditStorage;\n}\n\n/**\n * Create audit context for handler execution.\n * Returns the auditor and storage for use in the handler.\n *\n * @param endpoint - The endpoint with audit configuration\n * @param serviceDiscovery - Service discovery for getting audit storage\n * @param logger - Logger for debug/error messages\n * @param ctx - Request context for actor extraction\n * @returns Audit context with auditor and storage, or undefined if not configured\n */\nexport async function createAuditContext<\n  TServices extends Service[] = [],\n  TSession = unknown,\n  TLogger extends Logger = Logger,\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>(\n  endpoint: Endpoint<\n    any,\n    any,\n    any,\n    any,\n    TServices,\n    TLogger,\n    TSession,\n    any,\n    any,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  >,\n  serviceDiscovery: ServiceDiscovery<any, any>,\n  logger: TLogger,\n  ctx: {\n    session: TSession;\n    header: HeaderFn;\n    cookie: CookieFn;\n    services: Record<string, unknown>;\n  },\n): Promise<AuditExecutionContext<TAuditAction> | undefined> {\n  if (!endpoint.auditorStorageService) {\n    return undefined;\n  }\n\n  const services = await serviceDiscovery.register([\n    endpoint.auditorStorageService,\n  ]);\n  const storage = services[\n    endpoint.auditorStorageService.serviceName\n  ] as AuditStorage;\n\n  // Extract actor if configured\n  let actor: AuditActor = { id: 'system', type: 'system' };\n  if (endpoint.actorExtractor) {\n    try {\n      actor = await (\n        endpoint.actorExtractor as ActorExtractor<TServices, TSession, TLogger>\n      )({\n        services: ctx.services as any,\n        session: ctx.session,\n        header: ctx.header,\n        cookie: ctx.cookie,\n        logger,\n      });\n    } catch (error) {\n      logger.error(error as Error, 'Failed to extract actor for audits');\n    }\n  }\n\n  const auditor = new DefaultAuditor<TAuditAction>({\n    actor,\n    storage,\n    metadata: {\n      endpoint: endpoint.route,\n      method: endpoint.method,\n    },\n  });\n\n  return { auditor, storage };\n}\n\n/**\n * Execute a handler with automatic audit transaction support.\n * If the audit storage has a database (via getDatabase()), wraps execution\n * in a transaction so audits are atomic with handler's database operations.\n *\n * @param auditContext - The audit context from createAuditContext\n * @param handler - The handler function to execute (receives auditor)\n * @param onComplete - Called after handler with response, to process declarative audits\n * @returns The handler result\n */\nexport async function executeWithAuditTransaction<\n  T,\n  TAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n    string,\n    unknown\n  >,\n>(\n  auditContext: AuditExecutionContext<TAuditAction> | undefined,\n  handler: (auditor?: Auditor<TAuditAction>) => Promise<T>,\n  onComplete?: (response: T, auditor: Auditor<TAuditAction>) => Promise<void>,\n): Promise<T> {\n  // No audit context - just run handler\n  if (!auditContext) {\n    return handler(undefined);\n  }\n\n  const { auditor, storage } = auditContext;\n\n  // Check if storage has a database for transactional execution\n  const db = storage.getDatabase?.();\n\n  if (db) {\n    // Wrap in transaction - audits are atomic with handler operations\n    return withAuditableTransaction(db as any, auditor as any, async () => {\n      const response = await handler(auditor);\n\n      // Process declarative audits within the transaction\n      if (onComplete) {\n        await onComplete(response, auditor);\n      }\n\n      // Audits are flushed by withAuditableTransaction before commit\n      return response;\n    });\n  }\n\n  // No database - run handler and flush audits after\n  const response = await handler(auditor);\n\n  if (onComplete) {\n    await onComplete(response, auditor);\n  }\n\n  // Flush audits (no transaction)\n  await auditor.flush();\n\n  return response;\n}\n"],"mappings":"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"}