@geekmidas/constructs 0.0.22 → 0.2.0

package/dist/Endpoint-DbPsw13b.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"Endpoint-DbPsw13b.mjs","names":["endpoints: Endpoint<any, any, any, any, any, any>[]","options?: OpenApiSchemaOptions","input: unknown","key: K","body: unknown","status: number","headers: Record<string, string>","key?: string","cookieHeader: string | undefined","name?: string","name: string","value: string","options?: CookieOptions","ctx: EndpointContext<TInput, TServices, TLogger, TSession>","ctx: EndpointContext<\n      TInput,\n      TServices,\n      TLogger,\n      TSession,\n      TAuditAction,\n      TDatabase,\n      TAuditStorage\n    >","response: ResponseBuilder","obj: any","response: T | ResponseWithMetadata<T>","componentCollector?: ComponentCollector","operation: OpenAPIV3_1.OperationObject","pathParameters: OpenAPIV3_1.ParameterObject[]","queryParameters: OpenAPIV3_1.ParameterObject[]","routeObject: any","key: string","options?: Pick<CookieOptions, 'domain' | 'path'>","code: SuccessStatus","data: T"],"sources":["../src/endpoints/Endpoint.ts"],"sourcesContent":["import type { AuditStorage, AuditableAction, Auditor } from '@geekmidas/audit';\nimport type {\n  EventPublisher,\n  ExtractPublisherMessage,\n  MappedEvent,\n} from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport type { RateLimitConfig } from '@geekmidas/rate-limit';\nimport type {\n  InferComposableStandardSchema,\n  InferStandardSchema,\n} from '@geekmidas/schema';\nimport {\n  convertSchemaWithComponents,\n  convertStandardSchemaToJsonSchema,\n} from '@geekmidas/schema/conversion';\nimport {\n  type ComponentCollector,\n  type OpenApiSchemaOptions,\n  buildOpenApiSchema,\n} from '@geekmidas/schema/openapi';\nimport type { Service, ServiceRecord } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport pick from 'lodash.pick';\nimport set from 'lodash.set';\nimport type { OpenAPIV3_1 } from 'openapi-types';\nimport { ConstructType } from '../Construct';\nimport { Function, type FunctionHandler } from '../functions';\nimport type { HttpMethod, LowerHttpMethod, RemoveUndefined } from '../types';\nimport type { Authorizer } from './Authorizer';\nimport type { ActorExtractor, MappedAudit } from './audit';\n\n/**\n * Represents an HTTP endpoint that can handle requests with type-safe input/output validation,\n * dependency injection, session management, and authorization.\n *\n * @template TRoute - The route path string with parameter placeholders (e.g., '/users/:id')\n * @template TMethod - The HTTP method (GET, POST, PUT, DELETE, PATCH)\n * @template TInput - The input schema definition for body, query, and path parameters\n * @template OutSchema - The output schema for response validation\n * @template TServices - Array of service dependencies to inject\n * @template TLogger - The logger instance type\n * @template TSession - The session data type\n *\n * @extends Function - Base function construct for handler execution\n *\n * @example\n * ```typescript\n * const endpoint = new Endpoint({\n *   route: '/users/:id',\n *   method: 'GET',\n *   input: { params: userIdSchema },\n *   output: userSchema,\n *   fn: async ({ params }) => getUserById(params.id)\n * });\n * ```\n */\nexport class Endpoint<\n  TRoute extends string,\n  TMethod extends HttpMethod,\n  TInput extends EndpointSchemas = {},\n  OutSchema extends StandardSchemaV1 | undefined = undefined,\n  TServices extends Service[] = [],\n  TLogger extends Logger = Logger,\n  TSession = unknown,\n  TEventPublisher extends EventPublisher<any> | undefined = undefined,\n  TEventPublisherServiceName extends string = 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 Function<\n  TInput,\n  TServices,\n  TLogger,\n  OutSchema,\n  TEventPublisher,\n  TEventPublisherServiceName,\n  TAuditStorage,\n  TAuditStorageServiceName,\n  TDatabase,\n  TDatabaseServiceName,\n  TAuditAction,\n  FunctionHandler<\n    TInput,\n    TServices,\n    TLogger,\n    OutSchema,\n    TDatabase,\n    TAuditStorage,\n    TAuditAction\n  >\n> {\n  operationId?: string;\n  /** The route path pattern with parameter placeholders */\n  route: TRoute;\n  /** The HTTP method for this endpoint */\n  method: TMethod;\n  /** Optional description for OpenAPI documentation */\n  description?: string;\n  /** Optional tags for OpenAPI documentation */\n  tags?: string[];\n  /** The HTTP success status code to return (default: 200) */\n  public readonly status: SuccessStatus;\n  /** Default headers to apply to all responses */\n  public readonly defaultHeaders: Record<string, string> = {};\n  /** Function to extract session data from the request context */\n  public getSession: SessionFn<TServices, TLogger, TSession, TDatabase> = () =>\n    ({}) as TSession;\n  /** Function to determine if the request is authorized */\n  public authorize: AuthorizeFn<TServices, TLogger, TSession> = () => true;\n  /** Optional rate limiting configuration */\n  public rateLimit?: RateLimitConfig;\n  /** Optional authorizer for this endpoint */\n  public authorizer?: Authorizer;\n  /** Optional actor extractor for audit records */\n  public actorExtractor?: ActorExtractor<TServices, TSession, TLogger>;\n  /** Declarative audit definitions */\n  public audits: MappedAudit<TAuditAction, OutSchema>[] = [];\n  /** Database service for this endpoint */\n  public declare databaseService?: Service<TDatabaseServiceName, TDatabase>;\n  /** The endpoint handler function */\n  private endpointFn!: EndpointHandler<\n    TInput,\n    TServices,\n    TLogger,\n    OutSchema,\n    TSession,\n    TDatabase,\n    TAuditStorage,\n    TAuditAction\n  >;\n\n  /**\n   * Builds a complete OpenAPI 3.1 schema from an array of endpoints.\n   *\n   * @param endpoints - Array of endpoint instances to document\n   * @param options - Optional configuration for OpenAPI generation\n   * @returns OpenAPI 3.1 specification object\n   *\n   * @example\n   * ```typescript\n   * const schema = await Endpoint.buildOpenApiSchema([\n   *   getUserEndpoint,\n   *   createUserEndpoint\n   * ], {\n   *   title: 'User API',\n   *   version: '1.0.0'\n   * });\n   * ```\n   */\n  static async buildOpenApiSchema(\n    endpoints: Endpoint<any, any, any, any, any, any>[],\n    options?: OpenApiSchemaOptions,\n  ) {\n    return buildOpenApiSchema(endpoints, options);\n  }\n\n  /**\n   * Gets the full path including HTTP method and route.\n   * @returns Formatted string like 'GET /users/{id}'\n   */\n  get fullPath() {\n    return `${this.method} ${this._path}` as const;\n  }\n\n  /**\n   * Parses and validates input data for a specific input type (body, query, params).\n   *\n   * @param input - The raw input data to validate\n   * @param key - The input type key ('body', 'query', or 'params')\n   * @returns The validated input data for the specified key\n   * @throws {UnprocessableEntityError} When validation fails\n   */\n  async parseInput<K extends keyof TInput>(\n    input: unknown,\n    key: K,\n  ): Promise<InferComposableStandardSchema<TInput[K]>> {\n    const schema = this.input?.[key];\n    return Endpoint.parseSchema(schema as StandardSchemaV1, input) as Promise<\n      InferComposableStandardSchema<TInput[K]>\n    >;\n  }\n\n  /**\n   * Parses and validates the request body against the body schema.\n   *\n   * @param body - The raw request body to validate\n   * @returns The validated body data\n   * @throws {UnprocessableEntityError} When body validation fails\n   */\n  async parseBody(body: unknown): Promise<InferStandardSchema<TInput['body']>> {\n    return this.parseInput(body, 'body') as Promise<\n      InferStandardSchema<TInput['body']>\n    >;\n  }\n\n  static isSuccessStatus(status: number): boolean {\n    return status >= 200 && status < 300;\n  }\n\n  /**\n   * Creates a case-insensitive header lookup function from a headers object.\n   *\n   * @param headers - Object containing header key-value pairs\n   * @returns Function to retrieve header values by case-insensitive key, or all headers\n   *\n   * @example\n   * ```typescript\n   * const headerFn = Endpoint.createHeaders({ 'Content-Type': 'application/json' });\n   * headerFn('content-type'); // Returns 'application/json'\n   * headerFn(); // Returns { 'content-type': 'application/json' }\n   * ```\n   */\n  static createHeaders(headers: Record<string, string>): HeaderFn {\n    const headerMap = new Map<string, string>();\n    for (const [k, v] of Object.entries(headers)) {\n      const key = k.toLowerCase();\n      headerMap.set(key, v);\n    }\n\n    function get(): Record<string, string>;\n    function get(key: string): string | undefined;\n    function get(key?: string): string | undefined | Record<string, string> {\n      if (key === undefined) {\n        // Return all headers as plain object\n        return Object.fromEntries(headerMap.entries());\n      }\n      return headerMap.get(key.toLowerCase());\n    }\n\n    return get;\n  }\n\n  /**\n   * Parses cookie string and creates a cookie lookup function.\n   *\n   * @param cookieHeader - The Cookie header value\n   * @returns Function to retrieve cookie values by name, or all cookies\n   *\n   * @example\n   * ```typescript\n   * const cookieFn = Endpoint.createCookies('session=abc123; theme=dark');\n   * cookieFn('session'); // Returns 'abc123'\n   * cookieFn(); // Returns { session: 'abc123', theme: 'dark' }\n   * ```\n   */\n  static createCookies(cookieHeader: string | undefined): CookieFn {\n    const cookieMap = new Map<string, string>();\n\n    if (cookieHeader) {\n      // Parse cookie string: \"name1=value1; name2=value2\"\n      const cookies = cookieHeader.split(';');\n      for (const cookie of cookies) {\n        const [name, ...valueParts] = cookie.trim().split('=');\n        if (name) {\n          const value = valueParts.join('='); // Handle values with = in them\n          cookieMap.set(name, decodeURIComponent(value));\n        }\n      }\n    }\n\n    function get(): Record<string, string>;\n    function get(name: string): string | undefined;\n    function get(name?: string): string | undefined | Record<string, string> {\n      if (name === undefined) {\n        // Return all cookies as plain object\n        return Object.fromEntries(cookieMap.entries());\n      }\n      return cookieMap.get(name);\n    }\n\n    return get;\n  }\n\n  /**\n   * Formats a cookie as a Set-Cookie header string.\n   *\n   * @param name - Cookie name\n   * @param value - Cookie value\n   * @param options - Cookie options (httpOnly, secure, sameSite, etc.)\n   * @returns Formatted Set-Cookie header string\n   *\n   * @example\n   * ```typescript\n   * const header = Endpoint.formatCookieHeader('session', 'abc123', {\n   *   httpOnly: true,\n   *   secure: true,\n   *   sameSite: 'strict',\n   *   maxAge: 3600\n   * });\n   * // Returns: \"session=abc123; Max-Age=3600; HttpOnly; Secure; SameSite=Strict\"\n   * ```\n   */\n  static formatCookieHeader(\n    name: string,\n    value: string,\n    options?: CookieOptions,\n  ): string {\n    let cookie = `${name}=${value}`;\n\n    if (options) {\n      if (options.domain) cookie += `; Domain=${options.domain}`;\n      if (options.path) cookie += `; Path=${options.path}`;\n      if (options.expires)\n        cookie += `; Expires=${options.expires.toUTCString()}`;\n      if (options.maxAge !== undefined) cookie += `; Max-Age=${options.maxAge}`;\n      if (options.httpOnly) cookie += '; HttpOnly';\n      if (options.secure) cookie += '; Secure';\n      if (options.sameSite) {\n        cookie += `; SameSite=${options.sameSite.charAt(0).toUpperCase() + options.sameSite.slice(1)}`;\n      }\n    }\n\n    return cookie;\n  }\n\n  /**\n   * Extracts and refines input data from the endpoint context.\n   *\n   * @param ctx - The endpoint execution context\n   * @returns Object containing only the input data (body, query, params)\n   * @internal\n   */\n  refineInput(\n    ctx: EndpointContext<TInput, TServices, TLogger, TSession>,\n  ): InferComposableStandardSchema<TInput> {\n    const input = pick(ctx, [\n      'body',\n      'query',\n      'params',\n    ]) as InferComposableStandardSchema<TInput>;\n\n    return input;\n  }\n\n  handler = (\n    ctx: EndpointContext<\n      TInput,\n      TServices,\n      TLogger,\n      TSession,\n      TAuditAction,\n      TDatabase,\n      TAuditStorage\n    >,\n    response: ResponseBuilder,\n  ): OutSchema extends StandardSchemaV1\n    ?\n        | InferStandardSchema<OutSchema>\n        | ResponseWithMetadata<InferStandardSchema<OutSchema>>\n        | Promise<InferStandardSchema<OutSchema>>\n        | Promise<ResponseWithMetadata<InferStandardSchema<OutSchema>>>\n    :\n        | any\n        | ResponseWithMetadata<any>\n        | Promise<any>\n        | Promise<ResponseWithMetadata<any>> => {\n    // Apply default headers to response builder\n    for (const [key, value] of Object.entries(this.defaultHeaders)) {\n      response.header(key, value);\n    }\n\n    // Build context object, conditionally including auditor and db\n    const handlerCtx = {\n      ...this.refineInput(ctx),\n      services: ctx.services,\n      logger: ctx.logger,\n      header: ctx.header,\n      cookie: ctx.cookie,\n      session: ctx.session,\n      // These are conditionally present based on configuration\n      ...('auditor' in ctx && { auditor: ctx.auditor }),\n      ...('db' in ctx && { db: ctx.db }),\n    } as EndpointContext<\n      TInput,\n      TServices,\n      TLogger,\n      TSession,\n      TAuditAction,\n      TDatabase,\n      TAuditStorage\n    >;\n\n    return this.endpointFn(handlerCtx, response);\n  };\n\n  /**\n   * Type guard to check if an object is an Endpoint instance.\n   *\n   * @param obj - The object to check\n   * @returns True if the object is an Endpoint\n   */\n  static isEndpoint(obj: any): obj is Endpoint<any, any, any, any> {\n    return Boolean(\n      obj &&\n        (obj as Function).__IS_FUNCTION__ === true &&\n        obj.type === ConstructType.Endpoint,\n    );\n  }\n\n  /**\n   * Helper to check if response has metadata\n   */\n  static hasMetadata<T>(\n    response: T | ResponseWithMetadata<T>,\n  ): response is ResponseWithMetadata<T> {\n    return (\n      response !== null &&\n      typeof response === 'object' &&\n      'data' in response &&\n      'metadata' in response\n    );\n  }\n\n  /**\n   * Converts Express-style route params to OpenAPI format.\n   * @returns Route with ':param' converted to '{param}'\n   * @internal\n   */\n  get _path() {\n    return this.route.replace(/:(\\w+)/g, '{$1}') as ConvertRouteParams<TRoute>;\n  }\n\n  /**\n   * Generates OpenAPI 3.1 schema for this endpoint.\n   *\n   * @returns OpenAPI route definition with operation details\n   */\n  async toOpenApi3Route(\n    componentCollector?: ComponentCollector,\n  ): Promise<EndpointOpenApiSchema<TRoute, TMethod>> {\n    const operation: OpenAPIV3_1.OperationObject = {\n      operationId: this.operationId,\n      ...(this.description && { description: this.description }),\n      ...(this.tags && this.tags.length > 0 && { tags: this.tags }),\n      responses: {\n        '200': {\n          description: 'Successful response',\n        } as OpenAPIV3_1.ResponseObject,\n      },\n    };\n\n    // Add response schema\n    if (this.outputSchema) {\n      const responseSchema = await convertSchemaWithComponents(\n        this.outputSchema,\n        componentCollector,\n      );\n      if (responseSchema) {\n        set(\n          operation,\n          ['responses', '200', 'content', 'application/json', 'schema'],\n          responseSchema,\n        );\n      }\n    }\n\n    // Separate path and query parameters\n    const pathParameters: OpenAPIV3_1.ParameterObject[] = [];\n    const queryParameters: OpenAPIV3_1.ParameterObject[] = [];\n\n    // Since the EndpointBuilder doesn't have body/search/params methods yet,\n    // and the input is a composite type, we need to check if input exists\n    // and has the expected shape\n    if (this.input && typeof this.input === 'object') {\n      // Add request body for methods that support it\n      if (\n        ['POST', 'PUT', 'PATCH'].includes(this.method) &&\n        'body' in this.input &&\n        this.input.body\n      ) {\n        const bodySchema = await convertSchemaWithComponents(\n          this.input.body as StandardSchemaV1,\n          componentCollector,\n        );\n        if (bodySchema) {\n          set(operation, ['requestBody'], {\n            required: true,\n            content: {\n              'application/json': {\n                schema: bodySchema,\n              },\n            },\n          });\n        }\n      }\n\n      // Add path parameters\n      if ('params' in this.input && this.input.params) {\n        const paramsSchema = await convertStandardSchemaToJsonSchema(\n          this.input.params as StandardSchemaV1,\n        );\n        if (\n          paramsSchema &&\n          paramsSchema.type === 'object' &&\n          paramsSchema.properties\n        ) {\n          for (const [name, schema] of Object.entries(\n            paramsSchema.properties,\n          )) {\n            pathParameters.push({\n              name,\n              in: 'path',\n              required: paramsSchema.required?.includes(name) ?? true,\n              schema: schema as any,\n            });\n          }\n        }\n      }\n\n      // Add query parameters\n      if ('query' in this.input && this.input.query) {\n        const querySchema = await convertStandardSchemaToJsonSchema(\n          this.input.query,\n        );\n        if (\n          querySchema &&\n          querySchema.type === 'object' &&\n          querySchema.properties\n        ) {\n          for (const [name, schema] of Object.entries(querySchema.properties)) {\n            queryParameters.push({\n              name,\n              in: 'query',\n              required: querySchema.required?.includes(name) ?? false,\n              schema: schema as any,\n            });\n          }\n        }\n      }\n    }\n\n    // Only add query parameters to the operation\n    if (queryParameters.length > 0) {\n      operation.parameters = queryParameters;\n    }\n\n    // Build the route object with path parameters at the route level\n    const routeObject: any = {};\n    if (pathParameters.length > 0) {\n      routeObject.parameters = pathParameters;\n    }\n    routeObject[this.method.toLowerCase()] = operation;\n\n    return {\n      [this._path]: routeObject,\n    } as EndpointOpenApiSchema<TRoute, TMethod>;\n  }\n\n  /**\n   * Creates a new Endpoint instance.\n   *\n   * @param options - Configuration options for the endpoint\n   * @param options.fn - The handler function to execute\n   * @param options.method - HTTP method\n   * @param options.route - Route path with parameter placeholders\n   * @param options.description - Optional description for documentation\n   * @param options.input - Input schemas for validation\n   * @param options.logger - Logger instance\n   * @param options.output - Output schema for response validation\n   * @param options.services - Service dependencies\n   * @param options.timeout - Execution timeout in milliseconds\n   * @param options.getSession - Session extraction function\n   * @param options.authorize - Authorization check function\n   * @param options.status - Success HTTP status code (default: 200)\n   * @param options.authorizer - Optional authorizer configuration\n   */\n  constructor({\n    fn,\n    method,\n    route,\n    description,\n    tags,\n    input,\n    logger,\n    output: outputSchema,\n    services,\n    timeout,\n    memorySize,\n    getSession,\n    authorize,\n    rateLimit,\n    status = SuccessStatus.OK,\n    publisherService,\n    events,\n    authorizer,\n    auditorStorageService,\n    actorExtractor,\n    audits,\n    databaseService,\n  }: EndpointOptions<\n    TRoute,\n    TMethod,\n    TInput,\n    OutSchema,\n    TServices,\n    TLogger,\n    TSession,\n    OutSchema,\n    TEventPublisher,\n    TEventPublisherServiceName,\n    TAuditStorage,\n    TAuditStorageServiceName,\n    TAuditAction,\n    TDatabase,\n    TDatabaseServiceName\n  >) {\n    super(\n      fn as unknown as FunctionHandler<TInput, TServices, TLogger, OutSchema>,\n      timeout,\n      ConstructType.Endpoint,\n      input,\n      outputSchema,\n      services,\n      logger,\n      publisherService,\n      events,\n      memorySize,\n      auditorStorageService,\n    );\n\n    this.route = route;\n    this.method = method;\n    this.description = description;\n    this.tags = tags;\n    this.status = status;\n    this.endpointFn = fn;\n\n    if (getSession) {\n      this.getSession = getSession;\n    }\n\n    if (authorize) {\n      this.authorize = authorize;\n    }\n\n    if (rateLimit) {\n      this.rateLimit = rateLimit;\n    }\n\n    if (authorizer) {\n      this.authorizer = authorizer;\n    }\n\n    if (actorExtractor) {\n      this.actorExtractor = actorExtractor;\n    }\n\n    if (audits) {\n      this.audits = audits;\n    }\n\n    if (databaseService) {\n      this.databaseService = databaseService;\n    }\n  }\n}\n\n/**\n * Defines the input schema structure for an endpoint.\n *\n * @template TBody - Schema for request body validation\n * @template TSearch - Schema for query string validation\n * @template TParams - Schema for URL path parameters validation\n *\n * @example\n * ```typescript\n * type UserInput = EndpointInput<\n *   typeof createUserBodySchema,\n *   typeof userQuerySchema,\n *   typeof userParamsSchema\n * >;\n * ```\n */\nexport type EndpointInput<\n  TBody extends StandardSchemaV1 | undefined = undefined,\n  TSearch extends StandardSchemaV1 | undefined = undefined,\n  TParams extends StandardSchemaV1 | undefined = undefined,\n> = RemoveUndefined<{\n  body: TBody;\n  search: TSearch;\n  params: TParams;\n}>;\n\n/**\n * Configuration options for creating an Endpoint instance.\n *\n * @template TRoute - The route path string\n * @template TMethod - The HTTP method\n * @template TInput - Input schema definitions\n * @template TOutput - Output schema definition\n * @template TServices - Service dependencies array\n * @template TLogger - Logger type\n * @template TSession - Session data type\n */\nexport interface EndpointOptions<\n  TRoute extends string,\n  TMethod extends HttpMethod,\n  TInput extends EndpointSchemas = {},\n  TOutput extends StandardSchemaV1 | undefined = undefined,\n  TServices extends Service[] = [],\n  TLogger extends Logger = Logger,\n  TSession = unknown,\n  OutSchema extends StandardSchemaV1 | undefined = undefined,\n  TEventPublisher extends EventPublisher<any> | undefined = undefined,\n  TEventPublisherServiceName extends string = 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> {\n  /** The route path with parameter placeholders */\n  route: TRoute;\n  /** The HTTP method for this endpoint */\n  method: TMethod;\n  /** The handler function that implements the endpoint logic */\n  fn: EndpointHandler<\n    TInput,\n    TServices,\n    TLogger,\n    TOutput,\n    TSession,\n    TDatabase,\n    TAuditStorage,\n    TAuditAction\n  >;\n  /** Optional authorization check function */\n  authorize: AuthorizeFn<TServices, TLogger, TSession> | undefined;\n  /** Optional description for documentation */\n  description: string | undefined;\n  /** Optional tags for OpenAPI documentation */\n  tags?: string[];\n  /** Optional execution timeout in milliseconds */\n  timeout: number | undefined;\n  /** Optional memory size in MB for serverless deployments */\n  memorySize: number | undefined;\n  /** Input validation schemas */\n  input: TInput | undefined;\n  /** Output validation schema */\n  output: TOutput | undefined;\n  /** Service dependencies to inject */\n  services: TServices;\n  /** Logger instance */\n  logger: TLogger;\n  /** Optional session extraction function */\n  getSession: SessionFn<TServices, TLogger, TSession, TDatabase> | undefined;\n  /** Optional rate limiting configuration */\n  rateLimit?: RateLimitConfig;\n  /** Success HTTP status code */\n  status: SuccessStatus | undefined;\n  /**\n   * Event publisher service for publishing events from this endpoint\n   */\n  publisherService?: Service<TEventPublisherServiceName, TEventPublisher>;\n\n  events?: MappedEvent<TEventPublisher, OutSchema>[];\n  /** Optional authorizer configuration */\n  authorizer?: Authorizer;\n  /**\n   * Auditor storage service for persisting audit records from this endpoint\n   */\n  auditorStorageService?: Service<TAuditStorageServiceName, TAuditStorage>;\n  /** Optional actor extractor function for audit records */\n  actorExtractor?: ActorExtractor<TServices, TSession, TLogger>;\n  /** Declarative audit definitions */\n  audits?: MappedAudit<TAuditAction, OutSchema>[];\n  /** Database service for this endpoint */\n  databaseService?: Service<TDatabaseServiceName, TDatabase>;\n}\n\n/**\n * Defines the possible input schema types for an endpoint.\n * Each property represents a different part of the HTTP request.\n */\nexport type EndpointSchemas = Partial<{\n  /** Schema for URL path parameters (e.g., /users/:id) */\n  params: StandardSchemaV1;\n  /** Schema for query string parameters */\n  query: StandardSchemaV1;\n  /** Schema for request body (POST, PUT, PATCH) */\n  body: StandardSchemaV1;\n}>;\n\nexport type AuthorizeContext<\n  TServices extends Service[] = [],\n  TLogger extends Logger = Logger,\n  TSession = unknown,\n> = {\n  services: ServiceRecord<TServices>;\n  logger: TLogger;\n  header: HeaderFn;\n  cookie: CookieFn;\n  session: TSession;\n};\n/**\n * Function type for endpoint authorization checks.\n *\n * @template TServices - Available service dependencies\n * @template TLogger - Logger type\n * @template TSession - Session data type\n *\n * @param ctx - Context containing services, logger, headers, and session\n * @returns Boolean indicating if the request is authorized\n *\n * @example\n * ```typescript\n * const authorize: AuthorizeFn = ({ session }) => {\n *   return session.userId !== undefined;\n * };\n * ```\n */\nexport type AuthorizeFn<\n  TServices extends Service[] = [],\n  TLogger extends Logger = Logger,\n  TSession = unknown,\n> = (\n  ctx: AuthorizeContext<TServices, TLogger, TSession>,\n) => Promise<boolean> | boolean;\n\n/**\n * Base session context without database\n */\ntype BaseSessionContext<\n  TServices extends Service[] = [],\n  TLogger extends Logger = Logger,\n> = {\n  services: ServiceRecord<TServices>;\n  logger: TLogger;\n  header: HeaderFn;\n  cookie: CookieFn;\n};\n\n/**\n * Conditional database context for session - only present when database service is configured\n */\ntype SessionDatabaseContext<TDatabase = undefined> = TDatabase extends undefined\n  ? {}\n  : {\n      /**\n       * Database instance for session extraction.\n       * Available when a database service is configured via `.database()`.\n       * Useful for looking up user data from the database based on auth tokens.\n       */\n      db: TDatabase;\n    };\n\nexport type SessionContext<\n  TServices extends Service[] = [],\n  TLogger extends Logger = Logger,\n  TDatabase = undefined,\n> = BaseSessionContext<TServices, TLogger> & SessionDatabaseContext<TDatabase>;\n/**\n * Function type for extracting session data from a request.\n *\n * @template TServices - Available service dependencies\n * @template TLogger - Logger type\n * @template TSession - Session data type to extract\n * @template TDatabase - Database type (when database service is configured)\n *\n * @param ctx - Context containing services, logger, headers, and optionally database\n * @returns The extracted session data\n *\n * @example\n * ```typescript\n * // Without database\n * const getSession: SessionFn<Services, Logger, UserSession> = async ({ header, services }) => {\n *   const token = header('authorization');\n *   return await services.auth.verifyToken(token);\n * };\n *\n * // With database\n * const getSession: SessionFn<Services, Logger, UserSession, Database> = async ({ header, db }) => {\n *   const token = header('authorization');\n *   const user = await db.selectFrom('users').where('token', '=', token).executeTakeFirst();\n *   return { userId: user?.id };\n * };\n * ```\n */\nexport type SessionFn<\n  TServices extends Service[] = [],\n  TLogger extends Logger = Logger,\n  TSession = unknown,\n  TDatabase = undefined,\n> = (\n  ctx: SessionContext<TServices, TLogger, TDatabase>,\n) => Promise<TSession> | TSession;\n\n/**\n * Utility type that converts Express-style route parameters to OpenAPI format.\n * Transforms ':param' syntax to '{param}' syntax.\n *\n * @template T - The route string to convert\n *\n * @example\n * ```typescript\n * type Route1 = ConvertRouteParams<'/users/:id'>; // '/users/{id}'\n * type Route2 = ConvertRouteParams<'/users/:userId/posts/:postId'>; // '/users/{userId}/posts/{postId}'\n * ```\n */\nexport type ConvertRouteParams<T extends string> =\n  T extends `${infer Start}:${infer Param}/${infer Rest}`\n    ? `${Start}{${Param}}/${ConvertRouteParams<Rest>}`\n    : T extends `${infer Start}:${infer Param}`\n      ? `${Start}{${Param}}`\n      : T;\n\n/**\n * Type representing the OpenAPI schema structure for an endpoint.\n *\n * @template TRoute - The route path\n * @template TMethod - The HTTP method\n *\n * @example\n * ```typescript\n * type Schema = EndpointOpenApiSchema<'/users/:id', 'GET'>;\n * // Results in: { '/users/{id}': { get: OperationObject, parameters?: ParameterObject[] } }\n * ```\n */\nexport type EndpointOpenApiSchema<\n  TRoute extends string,\n  TMethod extends HttpMethod,\n> = {\n  [key in ConvertRouteParams<TRoute>]: {\n    [key in LowerHttpMethod<TMethod>]: OpenAPIV3_1.OperationObject<{}>;\n  } & {\n    parameters?: OpenAPIV3_1.ParameterObject[];\n  };\n};\n\nexport type SingleHeaderFn = (key: string) => string | undefined;\nexport type MultiHeaderFn = () => EndpointHeaders;\n/**\n * Type representing HTTP headers as a Map.\n */\nexport type EndpointHeaders = Map<string, string>;\n\n/**\n * Function type for retrieving HTTP header values.\n * Supports two calling patterns:\n * - `header(key)` - Get a single header value (case-insensitive)\n * - `header()` - Get all headers as a plain object\n *\n * @example\n * ```typescript\n * // Get single header\n * const contentType = header('content-type');\n *\n * // Get all headers\n * const allHeaders = header();\n * // { 'content-type': 'application/json', 'host': 'example.com', ... }\n * ```\n */\nexport interface HeaderFn {\n  (): Record<string, string>;\n  (key: string): string | undefined;\n}\n\n/**\n * Function type for retrieving cookie values.\n * Supports two calling patterns:\n * - `cookie(name)` - Get a single cookie value\n * - `cookie()` - Get all cookies as a plain object\n *\n * @example\n * ```typescript\n * // Get single cookie\n * const sessionId = cookie('session');\n *\n * // Get all cookies\n * const allCookies = cookie();\n * // { session: 'abc123', theme: 'dark', ... }\n * ```\n */\nexport interface CookieFn {\n  (): Record<string, string>;\n  (name: string): string | undefined;\n}\n\n/**\n * Cookie options matching standard Set-Cookie attributes\n */\nexport interface CookieOptions {\n  domain?: string;\n  path?: string;\n  expires?: Date;\n  maxAge?: number;\n  httpOnly?: boolean;\n  secure?: boolean;\n  sameSite?: 'strict' | 'lax' | 'none';\n}\n\n/**\n * Response metadata that handlers can set\n */\nexport interface ResponseMetadata {\n  headers?: Record<string, string>;\n  cookies?: Map<string, { value: string; options?: CookieOptions }>;\n  status?: SuccessStatus;\n}\n\n/**\n * Return type for handlers that want to set response metadata\n */\nexport interface ResponseWithMetadata<T> {\n  data: T;\n  metadata: ResponseMetadata;\n}\n\n/**\n * Response builder for fluent API in handlers\n */\nexport class ResponseBuilder {\n  private metadata: ResponseMetadata = {\n    headers: {},\n    cookies: new Map(),\n  };\n\n  header(key: string, value: string): this {\n    this.metadata.headers![key] = value;\n    return this;\n  }\n\n  cookie(name: string, value: string, options?: CookieOptions): this {\n    this.metadata.cookies!.set(name, { value, options });\n    return this;\n  }\n\n  deleteCookie(\n    name: string,\n    options?: Pick<CookieOptions, 'domain' | 'path'>,\n  ): this {\n    this.metadata.cookies!.set(name, {\n      value: '',\n      options: { ...options, maxAge: 0, expires: new Date(0) },\n    });\n    return this;\n  }\n\n  status(code: SuccessStatus): this {\n    this.metadata.status = code;\n    return this;\n  }\n\n  send<T>(data: T): ResponseWithMetadata<T> {\n    return { data, metadata: this.metadata };\n  }\n\n  getMetadata(): ResponseMetadata {\n    return this.metadata;\n  }\n}\n\n/**\n * Base context properties that are always available\n */\ntype BaseEndpointContext<\n  TServices extends Service[] = [],\n  TLogger extends Logger = Logger,\n  TSession = unknown,\n> = {\n  /** Injected service instances */\n  services: ServiceRecord<TServices>;\n  /** Logger instance for this request */\n  logger: TLogger;\n  /** Function to retrieve request headers */\n  header: HeaderFn;\n  /** Function to retrieve request cookies */\n  cookie: CookieFn;\n  /** Session data extracted by getSession */\n  session: TSession;\n};\n\n/**\n * Conditional auditor context - only present when audit storage is configured\n */\ntype AuditorContext<\n  TAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n    string,\n    unknown\n  >,\n  TAuditStorage = undefined,\n> = TAuditStorage extends undefined\n  ? {}\n  : {\n      /**\n       * Auditor instance for recording audit events.\n       * Only present when audit storage is configured on the endpoint.\n       * When a transactional database is used for audit storage,\n       * the auditor is pre-configured with the transaction context.\n       */\n      auditor: Auditor<TAuditAction>;\n    };\n\n/**\n * Conditional database context - only present when database service is configured\n */\ntype DatabaseContext<TDatabase = undefined> = TDatabase extends undefined\n  ? {}\n  : {\n      /**\n       * Database instance for this request.\n       * When audit storage is configured and uses the same database,\n       * this will be the transaction for ACID compliance.\n       * Otherwise, it's the raw database connection.\n       */\n      db: TDatabase;\n    };\n\n/**\n * The execution context provided to endpoint handlers.\n * Contains all parsed input data, services, logger, headers, cookies, and session.\n *\n * @template Input - The input schemas (body, query, params)\n * @template TServices - Available service dependencies\n * @template TLogger - Logger type\n * @template TSession - Session data type\n * @template TAuditAction - Audit action types (when auditor is configured)\n * @template TDatabase - Database type (when database service is configured)\n * @template TAuditStorage - Audit storage type (determines if auditor is present)\n */\nexport type EndpointContext<\n  Input extends EndpointSchemas | undefined = undefined,\n  TServices extends Service[] = [],\n  TLogger extends Logger = Logger,\n  TSession = unknown,\n  TAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n    string,\n    unknown\n  >,\n  TDatabase = undefined,\n  TAuditStorage = undefined,\n> = BaseEndpointContext<TServices, TLogger, TSession> &\n  InferComposableStandardSchema<Input> &\n  AuditorContext<TAuditAction, TAuditStorage> &\n  DatabaseContext<TDatabase>;\n\n/**\n * Handler function type for endpoint implementations.\n *\n * @template TInput - Input schemas for validation\n * @template TServices - Available service dependencies\n * @template TLogger - Logger type\n * @template OutSchema - Output schema for response validation\n * @template TSession - Session data type\n *\n * @param ctx - The endpoint execution context\n * @param response - Response builder for setting cookies, headers, and status\n * @returns The response data (validated if OutSchema is provided) or ResponseWithMetadata\n *\n * @example\n * ```typescript\n * // Simple response\n * const handler: EndpointHandler<Input, [UserService], Logger, UserSchema> =\n *   async ({ params, services }) => {\n *     return await services.users.findById(params.id);\n *   };\n *\n * // With response builder\n * const handler: EndpointHandler<Input, [UserService], Logger, UserSchema> =\n *   async ({ params, services }, response) => {\n *     const user = await services.users.findById(params.id);\n *     return response.header('X-User-Id', user.id).send(user);\n *   };\n * ```\n */\nexport type EndpointHandler<\n  TInput extends EndpointSchemas | undefined = undefined,\n  TServices extends Service[] = [],\n  TLogger extends Logger = Logger,\n  OutSchema extends StandardSchemaV1 | undefined = undefined,\n  TSession = unknown,\n  TDatabase = undefined,\n  TAuditStorage = undefined,\n  TAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n    string,\n    unknown\n  >,\n> = (\n  ctx: EndpointContext<\n    TInput,\n    TServices,\n    TLogger,\n    TSession,\n    TAuditAction,\n    TDatabase,\n    TAuditStorage\n  >,\n  response: ResponseBuilder,\n) => OutSchema extends StandardSchemaV1\n  ?\n      | InferStandardSchema<OutSchema>\n      | ResponseWithMetadata<InferStandardSchema<OutSchema>>\n      | Promise<InferStandardSchema<OutSchema>>\n      | Promise<ResponseWithMetadata<InferStandardSchema<OutSchema>>>\n  :\n      | unknown\n      | ResponseWithMetadata<unknown>\n      | Promise<unknown>\n      | Promise<ResponseWithMetadata<unknown>>;\n\n/**\n * HTTP success status codes that can be returned by endpoints.\n */\nexport enum SuccessStatus {\n  /** Standard response for successful HTTP requests */\n  OK = 200,\n  /** Request has been fulfilled and resulted in a new resource being created */\n  Created = 201,\n  /** Request has been accepted for processing, but processing is not complete */\n  Accepted = 202,\n  /** Server successfully processed the request but is not returning any content */\n  NoContent = 204,\n  /** Server successfully processed the request and is not returning any content, client should reset the document view */\n  ResetContent = 205,\n  /** Server is delivering only part of the resource due to a range header */\n  PartialContent = 206,\n}\n\nexport type EndpointOutput<T> = T extends Endpoint<\n  any,\n  any,\n  any,\n  infer OutSchema,\n  any,\n  any,\n  any,\n  any\n>\n  ? InferStandardSchema<OutSchema>\n  : never;\n\nexport type EndpointEvent<T> = T extends Endpoint<\n  any,\n  any,\n  any,\n  any,\n  any,\n  any,\n  any,\n  infer TEventPublisher\n>\n  ? ExtractPublisherMessage<TEventPublisher>\n  : never;\n"],"mappings":"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"}

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":"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"}

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/HonoEndpointAdaptor-B_gJPWGD.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"HonoEndpointAdaptor-B_gJPWGD.cjs","names":["endpoint: Endpoint<\n      TRoute,\n      TMethod,\n      TInput,\n      TOutSchema,\n      TServices,\n      TLogger,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >","c: Context<any, string, {}>","data: unknown","schema?: T","serviceDiscovery: ServiceDiscovery<ServiceRecord<TServices>, TLogger>","app: Hono","serviceDiscovery: ServiceDiscovery<any, any>","routes: string[]","envParser: EnvironmentParser<{}>","Hono","logger: TLogger","options?: HonoEndpointOptions","endpoints: Endpoint<string, HttpMethod, any, any, TServices, TLogger>[]","ResponseBuilder","metadata","output","result","validationError: any","e: any","docsPath: string","openApiOptions?: HonoEndpointOptions['openApiOptions']"],"sources":["../src/endpoints/HonoEndpointAdaptor.ts"],"sourcesContent":["import type { AuditStorage, AuditableAction } from '@geekmidas/audit';\nimport type { EnvironmentParser } from '@geekmidas/envkit';\nimport type { EventPublisher } from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport { checkRateLimit, getRateLimitHeaders } from '@geekmidas/rate-limit';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { type Context, Hono } from 'hono';\nimport { setCookie } from 'hono/cookie';\nimport { logger as honoLogger } from 'hono/logger';\nimport { timing } from 'hono/timing';\nimport { validator } from 'hono/validator';\nimport type { HttpMethod, LowerHttpMethod } from '../types';\nimport {\n  Endpoint,\n  type EndpointContext,\n  type EndpointSchemas,\n  ResponseBuilder,\n} from './Endpoint';\nimport { getEndpointsFromRoutes } from './helpers';\nimport { parseHonoQuery } from './parseHonoQuery';\n\nimport { wrapError } from '@geekmidas/errors';\nimport {\n  type Service,\n  ServiceDiscovery,\n  type ServiceRecord,\n} from '@geekmidas/services';\nimport type { ContentfulStatusCode } from 'hono/utils/http-status';\nimport { publishConstructEvents } from '../publisher';\nimport type { MappedAudit } from './audit';\nimport {\n  createAuditContext,\n  executeWithAuditTransaction,\n} from './processAudits';\n\nexport interface HonoEndpointOptions {\n  /**\n   * Path where OpenAPI documentation will be served.\n   * Set to false to disable docs route.\n   * @default '/docs'\n   */\n  docsPath?: string | false;\n  /**\n   * OpenAPI schema options\n   */\n  openApiOptions?: {\n    title?: string;\n    version?: string;\n    description?: string;\n  };\n}\n\nexport class HonoEndpoint<\n  TRoute extends string,\n  TMethod extends HttpMethod,\n  TInput extends EndpointSchemas = {},\n  TOutSchema extends StandardSchemaV1 | undefined = undefined,\n  TServices extends Service[] = [],\n  TLogger extends Logger = Logger,\n  TSession = unknown,\n  TEventPublisher extends EventPublisher<any> | undefined = undefined,\n  TEventPublisherServiceName extends string = 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> {\n  constructor(\n    private readonly endpoint: Endpoint<\n      TRoute,\n      TMethod,\n      TInput,\n      TOutSchema,\n      TServices,\n      TLogger,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >,\n  ) {}\n\n  static isDev = process.env.NODE_ENV === 'development';\n\n  static async validate<T extends StandardSchemaV1>(\n    c: Context<any, string, {}>,\n    data: unknown,\n    schema?: T,\n  ) {\n    if (!schema) {\n      return undefined;\n    }\n\n    const parsed = await Endpoint.validate(schema, data);\n\n    if (parsed.issues) {\n      return c.json(parsed.issues, 422);\n    }\n\n    return parsed.value;\n  }\n  addRoute(\n    serviceDiscovery: ServiceDiscovery<ServiceRecord<TServices>, TLogger>,\n    app: Hono,\n  ): void {\n    HonoEndpoint.addRoute(this.endpoint, serviceDiscovery, app);\n  }\n\n  static applyEventMiddleware(\n    app: Hono,\n    serviceDiscovery: ServiceDiscovery<any, any>,\n  ) {\n    app.use(async (c, next) => {\n      await next();\n      // @ts-ignore\n      const endpoint = c.get('__endpoint') as Endpoint<\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any\n      >;\n      // @ts-ignore\n      const response = c.get('__response');\n      // @ts-ignore\n      const logger = c.get('__logger') as Logger;\n\n      if (Endpoint.isSuccessStatus(c.res.status) && endpoint) {\n        // Process events (audits are handled in the handler with transaction support)\n        await publishConstructEvents<any, any>(\n          endpoint,\n          response,\n          serviceDiscovery,\n          logger,\n        );\n      }\n    });\n  }\n\n  static async fromRoutes<TLogger extends Logger, TServices extends Service[]>(\n    routes: string[],\n    envParser: EnvironmentParser<{}>,\n    app = new Hono(),\n    logger: TLogger,\n    cwd = process.cwd(),\n    options?: HonoEndpointOptions,\n  ): Promise<Hono> {\n    const endpoints = await getEndpointsFromRoutes<TServices>(routes, cwd);\n    const serviceDiscovery = ServiceDiscovery.getInstance<\n      ServiceRecord<TServices>,\n      TLogger\n    >(logger, envParser);\n\n    HonoEndpoint.addRoutes(endpoints, serviceDiscovery, app, options);\n\n    return app;\n  }\n\n  static addRoutes<\n    TServices extends Service[] = [],\n    TLogger extends Logger = Logger,\n  >(\n    endpoints: Endpoint<string, HttpMethod, any, any, TServices, TLogger>[],\n    serviceDiscovery: ServiceDiscovery<ServiceRecord<TServices>, TLogger>,\n    app: Hono,\n    options?: HonoEndpointOptions,\n  ): void {\n    // Add timing middleware (always enabled)\n    app.use('*', timing());\n\n    // Add logger middleware in development mode\n\n    if (HonoEndpoint.isDev) {\n      app.use('*', honoLogger());\n    }\n\n    // Add docs route if not disabled\n    const docsPath =\n      options?.docsPath !== false ? options?.docsPath || '/docs' : null;\n    if (docsPath) {\n      HonoEndpoint.addDocsRoute(\n        endpoints,\n        app,\n        docsPath,\n        options?.openApiOptions,\n      );\n    }\n\n    // Sort endpoints to ensure static routes come before dynamic ones\n    const sortedEndpoints = endpoints.sort((a, b) => {\n      const aSegments = a.route.split('/');\n      const bSegments = b.route.split('/');\n\n      // Compare each segment\n      for (let i = 0; i < Math.max(aSegments.length, bSegments.length); i++) {\n        const aSegment = aSegments[i] || '';\n        const bSegment = bSegments[i] || '';\n\n        // If one is dynamic and the other is not, static comes first\n        const aIsDynamic = aSegment.startsWith(':');\n        const bIsDynamic = bSegment.startsWith(':');\n\n        if (!aIsDynamic && bIsDynamic) return -1;\n        if (aIsDynamic && !bIsDynamic) return 1;\n\n        // If both are the same type, compare alphabetically\n        if (aSegment !== bSegment) {\n          return aSegment.localeCompare(bSegment);\n        }\n      }\n\n      return 0;\n    });\n    HonoEndpoint.applyEventMiddleware(app, serviceDiscovery);\n    for (const endpoint of sortedEndpoints) {\n      HonoEndpoint.addRoute(endpoint, serviceDiscovery, app);\n    }\n  }\n\n  static addRoute<\n    TRoute extends string,\n    TMethod extends HttpMethod,\n    TInput extends EndpointSchemas = {},\n    TOutSchema extends StandardSchemaV1 | undefined = undefined,\n    TServices extends Service[] = [],\n    TLogger extends Logger = Logger,\n    TSession = unknown,\n    TEventPublisher extends EventPublisher<any> | undefined = undefined,\n    TEventPublisherServiceName extends string = 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  >(\n    endpoint: Endpoint<\n      TRoute,\n      TMethod,\n      TInput,\n      TOutSchema,\n      TServices,\n      TLogger,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >,\n    serviceDiscovery: ServiceDiscovery<ServiceRecord<TServices>, TLogger>,\n    app: Hono,\n  ): void {\n    const { route } = endpoint;\n    const method = endpoint.method.toLowerCase() as LowerHttpMethod<TMethod>;\n\n    app[method](\n      route,\n      validator('json', (value, c) =>\n        HonoEndpoint.validate(c, value, endpoint.input?.body),\n      ),\n      validator('query', (_, c) => {\n        const parsedQuery = parseHonoQuery(c);\n        return HonoEndpoint.validate(c, parsedQuery, endpoint.input?.query);\n      }),\n      validator('param', (params, c) =>\n        HonoEndpoint.validate(c, params, endpoint.input?.params),\n      ),\n      async (c) => {\n        const logger = endpoint.logger.child({\n          endpoint: endpoint.fullPath,\n          route: endpoint.route,\n          host: c.header('host'),\n          method: endpoint.method,\n          path: c.req.path,\n        }) as TLogger;\n\n        try {\n          const headerValues = c.req.header();\n\n          const header = Endpoint.createHeaders(headerValues);\n          const cookie = Endpoint.createCookies(headerValues.cookie);\n\n          const services = await serviceDiscovery.register(endpoint.services);\n\n          // Resolve database service early so it's available for session extraction\n          const rawDb = endpoint.databaseService\n            ? await serviceDiscovery\n                .register([endpoint.databaseService])\n                .then(\n                  (s) =>\n                    s[endpoint.databaseService!.serviceName as keyof typeof s],\n                )\n            : undefined;\n\n          const session = await endpoint.getSession({\n            services,\n            logger,\n            header,\n            cookie,\n            ...(rawDb !== undefined && { db: rawDb }),\n          } as any);\n\n          const isAuthorized = await endpoint.authorize({\n            header,\n            cookie,\n            services,\n            logger,\n            session,\n          });\n\n          if (!isAuthorized) {\n            logger.warn('Unauthorized access attempt');\n            return c.json({ error: 'Unauthorized' }, 401);\n          }\n\n          // Check rate limit if configured\n          if (endpoint.rateLimit) {\n            const rateLimitInfo = await checkRateLimit(endpoint.rateLimit, {\n              header,\n              services,\n              logger,\n              session,\n              path: c.req.path,\n              method: endpoint.method,\n            });\n\n            // Set rate limit headers\n            const rateLimitHeaders = getRateLimitHeaders(\n              rateLimitInfo,\n              endpoint.rateLimit,\n            );\n            for (const [key, value] of Object.entries(rateLimitHeaders)) {\n              if (value) {\n                c.header(key, value);\n              }\n            }\n          }\n\n          // Create audit context if audit storage is configured\n          const auditContext = await createAuditContext(\n            endpoint,\n            serviceDiscovery,\n            logger,\n            {\n              session,\n              header,\n              cookie,\n              services: services as Record<string, unknown>,\n            },\n          );\n\n          // Warn if declarative audits are configured but no audit storage\n          const audits = endpoint.audits as MappedAudit<\n            TAuditAction,\n            TOutSchema\n          >[];\n          if (!auditContext && audits?.length) {\n            logger.warn('No auditor storage service available');\n          }\n\n          // Execute handler with automatic audit transaction support\n          const result = await executeWithAuditTransaction(\n            auditContext,\n            async (auditor) => {\n              // Use audit transaction as db only if the storage uses the same database service\n              const sameDatabase =\n                auditContext?.storage?.databaseServiceName &&\n                auditContext.storage.databaseServiceName ===\n                  endpoint.databaseService?.serviceName;\n              const db = sameDatabase\n                ? (auditor?.getTransaction?.() ?? rawDb)\n                : rawDb;\n\n              const responseBuilder = new ResponseBuilder();\n              const response = await endpoint.handler(\n                {\n                  services,\n                  logger,\n                  body: c.req.valid('json'),\n                  query: c.req.valid('query'),\n                  params: c.req.valid('param'),\n                  session,\n                  header,\n                  cookie,\n                  auditor,\n                  db,\n                } as unknown as EndpointContext<\n                  TInput,\n                  TServices,\n                  TLogger,\n                  TSession,\n                  TAuditAction,\n                  TDatabase,\n                  TAuditStorage\n                >,\n                responseBuilder,\n              );\n\n              // Check if response has metadata\n              let data = response;\n              let metadata = responseBuilder.getMetadata();\n\n              if (Endpoint.hasMetadata(response)) {\n                data = response.data;\n                metadata = response.metadata;\n              }\n\n              const output = endpoint.outputSchema\n                ? await endpoint.parseOutput(data)\n                : undefined;\n\n              return { output, metadata, responseBuilder };\n            },\n            // Process declarative audits after handler (inside transaction)\n            async (result, auditor) => {\n              if (!audits?.length) return;\n\n              for (const audit of audits) {\n                if (audit.when && !audit.when(result.output as any)) {\n                  continue;\n                }\n                const payload = audit.payload(result.output as any);\n                const entityId = audit.entityId?.(result.output as any);\n                auditor.audit(audit.type as any, payload as any, {\n                  table: audit.table,\n                  entityId,\n                });\n              }\n            },\n          );\n\n          const { output, metadata } = result;\n\n          try {\n            let status = endpoint.status as ContentfulStatusCode;\n\n            // Apply response metadata\n            if (metadata.status) {\n              status = metadata.status as ContentfulStatusCode;\n            }\n\n            if (metadata.headers) {\n              for (const [key, value] of Object.entries(metadata.headers)) {\n                c.header(key, value);\n              }\n            }\n\n            if (metadata.cookies) {\n              for (const [name, { value, options }] of metadata.cookies) {\n                setCookie(c, name, value, options);\n              }\n            }\n\n            // @ts-ignore\n            c.set('__response', output);\n            // @ts-ignore\n            c.set('__endpoint', endpoint);\n            // @ts-ignore\n            c.set('__logger', logger);\n            // @ts-ignore\n            c.set('__session', session);\n            // @ts-ignore\n            c.set('__services', services);\n\n            if (HonoEndpoint.isDev) {\n              logger.info({ status, body: output }, 'Outgoing response');\n            }\n            // @ts-ignore\n            return c.json(output, status);\n          } catch (validationError: any) {\n            logger.error(validationError, 'Output validation failed');\n            const error = wrapError(\n              validationError,\n              422,\n              'Response validation failed',\n            );\n            if (HonoEndpoint.isDev) {\n              logger.info(\n                { status: error.statusCode, body: error },\n                'Outgoing response',\n              );\n            }\n            return c.json(error, error.statusCode as ContentfulStatusCode);\n          }\n        } catch (e: any) {\n          logger.error(e, 'Error processing endpoint request');\n          const error = wrapError(e, 500, 'Internal Server Error');\n          if (HonoEndpoint.isDev) {\n            logger.info(\n              { status: error.statusCode, body: error },\n              'Outgoing response',\n            );\n          }\n          return c.json(error, error.statusCode as ContentfulStatusCode);\n        }\n      },\n    );\n  }\n\n  static addDocsRoute<\n    TServices extends Service[] = [],\n    TLogger extends Logger = Logger,\n  >(\n    endpoints: Endpoint<string, HttpMethod, any, any, TServices, TLogger>[],\n    app: Hono,\n    docsPath: string,\n    openApiOptions?: HonoEndpointOptions['openApiOptions'],\n  ): void {\n    app.get(docsPath, async (c) => {\n      try {\n        const openApiSchema = await Endpoint.buildOpenApiSchema(\n          endpoints,\n          openApiOptions,\n        );\n\n        return c.json(openApiSchema);\n      } catch (error) {\n        console.error('Error generating OpenAPI schema:', error);\n        return c.json(\n          { error: 'Failed to generate OpenAPI documentation' },\n          500,\n        );\n      }\n    });\n  }\n}\n"],"mappings":"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"}

package/dist/HonoEndpointAdaptor-Bg_vTyA5.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"HonoEndpointAdaptor-Bg_vTyA5.mjs","names":["endpoint: Endpoint<\n      TRoute,\n      TMethod,\n      TInput,\n      TOutSchema,\n      TServices,\n      TLogger,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >","c: Context<any, string, {}>","data: unknown","schema?: T","serviceDiscovery: ServiceDiscovery<ServiceRecord<TServices>, TLogger>","app: Hono","serviceDiscovery: ServiceDiscovery<any, any>","logger","routes: string[]","envParser: EnvironmentParser<{}>","logger: TLogger","options?: HonoEndpointOptions","endpoints: Endpoint<string, HttpMethod, any, any, TServices, TLogger>[]","metadata","output","result","validationError: any","e: any","docsPath: string","openApiOptions?: HonoEndpointOptions['openApiOptions']"],"sources":["../src/endpoints/HonoEndpointAdaptor.ts"],"sourcesContent":["import type { AuditStorage, AuditableAction } from '@geekmidas/audit';\nimport type { EnvironmentParser } from '@geekmidas/envkit';\nimport type { EventPublisher } from '@geekmidas/events';\nimport type { Logger } from '@geekmidas/logger';\nimport { checkRateLimit, getRateLimitHeaders } from '@geekmidas/rate-limit';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { type Context, Hono } from 'hono';\nimport { setCookie } from 'hono/cookie';\nimport { logger as honoLogger } from 'hono/logger';\nimport { timing } from 'hono/timing';\nimport { validator } from 'hono/validator';\nimport type { HttpMethod, LowerHttpMethod } from '../types';\nimport {\n  Endpoint,\n  type EndpointContext,\n  type EndpointSchemas,\n  ResponseBuilder,\n} from './Endpoint';\nimport { getEndpointsFromRoutes } from './helpers';\nimport { parseHonoQuery } from './parseHonoQuery';\n\nimport { wrapError } from '@geekmidas/errors';\nimport {\n  type Service,\n  ServiceDiscovery,\n  type ServiceRecord,\n} from '@geekmidas/services';\nimport type { ContentfulStatusCode } from 'hono/utils/http-status';\nimport { publishConstructEvents } from '../publisher';\nimport type { MappedAudit } from './audit';\nimport {\n  createAuditContext,\n  executeWithAuditTransaction,\n} from './processAudits';\n\nexport interface HonoEndpointOptions {\n  /**\n   * Path where OpenAPI documentation will be served.\n   * Set to false to disable docs route.\n   * @default '/docs'\n   */\n  docsPath?: string | false;\n  /**\n   * OpenAPI schema options\n   */\n  openApiOptions?: {\n    title?: string;\n    version?: string;\n    description?: string;\n  };\n}\n\nexport class HonoEndpoint<\n  TRoute extends string,\n  TMethod extends HttpMethod,\n  TInput extends EndpointSchemas = {},\n  TOutSchema extends StandardSchemaV1 | undefined = undefined,\n  TServices extends Service[] = [],\n  TLogger extends Logger = Logger,\n  TSession = unknown,\n  TEventPublisher extends EventPublisher<any> | undefined = undefined,\n  TEventPublisherServiceName extends string = 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> {\n  constructor(\n    private readonly endpoint: Endpoint<\n      TRoute,\n      TMethod,\n      TInput,\n      TOutSchema,\n      TServices,\n      TLogger,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >,\n  ) {}\n\n  static isDev = process.env.NODE_ENV === 'development';\n\n  static async validate<T extends StandardSchemaV1>(\n    c: Context<any, string, {}>,\n    data: unknown,\n    schema?: T,\n  ) {\n    if (!schema) {\n      return undefined;\n    }\n\n    const parsed = await Endpoint.validate(schema, data);\n\n    if (parsed.issues) {\n      return c.json(parsed.issues, 422);\n    }\n\n    return parsed.value;\n  }\n  addRoute(\n    serviceDiscovery: ServiceDiscovery<ServiceRecord<TServices>, TLogger>,\n    app: Hono,\n  ): void {\n    HonoEndpoint.addRoute(this.endpoint, serviceDiscovery, app);\n  }\n\n  static applyEventMiddleware(\n    app: Hono,\n    serviceDiscovery: ServiceDiscovery<any, any>,\n  ) {\n    app.use(async (c, next) => {\n      await next();\n      // @ts-ignore\n      const endpoint = c.get('__endpoint') as Endpoint<\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any,\n        any\n      >;\n      // @ts-ignore\n      const response = c.get('__response');\n      // @ts-ignore\n      const logger = c.get('__logger') as Logger;\n\n      if (Endpoint.isSuccessStatus(c.res.status) && endpoint) {\n        // Process events (audits are handled in the handler with transaction support)\n        await publishConstructEvents<any, any>(\n          endpoint,\n          response,\n          serviceDiscovery,\n          logger,\n        );\n      }\n    });\n  }\n\n  static async fromRoutes<TLogger extends Logger, TServices extends Service[]>(\n    routes: string[],\n    envParser: EnvironmentParser<{}>,\n    app = new Hono(),\n    logger: TLogger,\n    cwd = process.cwd(),\n    options?: HonoEndpointOptions,\n  ): Promise<Hono> {\n    const endpoints = await getEndpointsFromRoutes<TServices>(routes, cwd);\n    const serviceDiscovery = ServiceDiscovery.getInstance<\n      ServiceRecord<TServices>,\n      TLogger\n    >(logger, envParser);\n\n    HonoEndpoint.addRoutes(endpoints, serviceDiscovery, app, options);\n\n    return app;\n  }\n\n  static addRoutes<\n    TServices extends Service[] = [],\n    TLogger extends Logger = Logger,\n  >(\n    endpoints: Endpoint<string, HttpMethod, any, any, TServices, TLogger>[],\n    serviceDiscovery: ServiceDiscovery<ServiceRecord<TServices>, TLogger>,\n    app: Hono,\n    options?: HonoEndpointOptions,\n  ): void {\n    // Add timing middleware (always enabled)\n    app.use('*', timing());\n\n    // Add logger middleware in development mode\n\n    if (HonoEndpoint.isDev) {\n      app.use('*', honoLogger());\n    }\n\n    // Add docs route if not disabled\n    const docsPath =\n      options?.docsPath !== false ? options?.docsPath || '/docs' : null;\n    if (docsPath) {\n      HonoEndpoint.addDocsRoute(\n        endpoints,\n        app,\n        docsPath,\n        options?.openApiOptions,\n      );\n    }\n\n    // Sort endpoints to ensure static routes come before dynamic ones\n    const sortedEndpoints = endpoints.sort((a, b) => {\n      const aSegments = a.route.split('/');\n      const bSegments = b.route.split('/');\n\n      // Compare each segment\n      for (let i = 0; i < Math.max(aSegments.length, bSegments.length); i++) {\n        const aSegment = aSegments[i] || '';\n        const bSegment = bSegments[i] || '';\n\n        // If one is dynamic and the other is not, static comes first\n        const aIsDynamic = aSegment.startsWith(':');\n        const bIsDynamic = bSegment.startsWith(':');\n\n        if (!aIsDynamic && bIsDynamic) return -1;\n        if (aIsDynamic && !bIsDynamic) return 1;\n\n        // If both are the same type, compare alphabetically\n        if (aSegment !== bSegment) {\n          return aSegment.localeCompare(bSegment);\n        }\n      }\n\n      return 0;\n    });\n    HonoEndpoint.applyEventMiddleware(app, serviceDiscovery);\n    for (const endpoint of sortedEndpoints) {\n      HonoEndpoint.addRoute(endpoint, serviceDiscovery, app);\n    }\n  }\n\n  static addRoute<\n    TRoute extends string,\n    TMethod extends HttpMethod,\n    TInput extends EndpointSchemas = {},\n    TOutSchema extends StandardSchemaV1 | undefined = undefined,\n    TServices extends Service[] = [],\n    TLogger extends Logger = Logger,\n    TSession = unknown,\n    TEventPublisher extends EventPublisher<any> | undefined = undefined,\n    TEventPublisherServiceName extends string = 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  >(\n    endpoint: Endpoint<\n      TRoute,\n      TMethod,\n      TInput,\n      TOutSchema,\n      TServices,\n      TLogger,\n      TSession,\n      TEventPublisher,\n      TEventPublisherServiceName,\n      TAuditStorage,\n      TAuditStorageServiceName,\n      TAuditAction,\n      TDatabase,\n      TDatabaseServiceName\n    >,\n    serviceDiscovery: ServiceDiscovery<ServiceRecord<TServices>, TLogger>,\n    app: Hono,\n  ): void {\n    const { route } = endpoint;\n    const method = endpoint.method.toLowerCase() as LowerHttpMethod<TMethod>;\n\n    app[method](\n      route,\n      validator('json', (value, c) =>\n        HonoEndpoint.validate(c, value, endpoint.input?.body),\n      ),\n      validator('query', (_, c) => {\n        const parsedQuery = parseHonoQuery(c);\n        return HonoEndpoint.validate(c, parsedQuery, endpoint.input?.query);\n      }),\n      validator('param', (params, c) =>\n        HonoEndpoint.validate(c, params, endpoint.input?.params),\n      ),\n      async (c) => {\n        const logger = endpoint.logger.child({\n          endpoint: endpoint.fullPath,\n          route: endpoint.route,\n          host: c.header('host'),\n          method: endpoint.method,\n          path: c.req.path,\n        }) as TLogger;\n\n        try {\n          const headerValues = c.req.header();\n\n          const header = Endpoint.createHeaders(headerValues);\n          const cookie = Endpoint.createCookies(headerValues.cookie);\n\n          const services = await serviceDiscovery.register(endpoint.services);\n\n          // Resolve database service early so it's available for session extraction\n          const rawDb = endpoint.databaseService\n            ? await serviceDiscovery\n                .register([endpoint.databaseService])\n                .then(\n                  (s) =>\n                    s[endpoint.databaseService!.serviceName as keyof typeof s],\n                )\n            : undefined;\n\n          const session = await endpoint.getSession({\n            services,\n            logger,\n            header,\n            cookie,\n            ...(rawDb !== undefined && { db: rawDb }),\n          } as any);\n\n          const isAuthorized = await endpoint.authorize({\n            header,\n            cookie,\n            services,\n            logger,\n            session,\n          });\n\n          if (!isAuthorized) {\n            logger.warn('Unauthorized access attempt');\n            return c.json({ error: 'Unauthorized' }, 401);\n          }\n\n          // Check rate limit if configured\n          if (endpoint.rateLimit) {\n            const rateLimitInfo = await checkRateLimit(endpoint.rateLimit, {\n              header,\n              services,\n              logger,\n              session,\n              path: c.req.path,\n              method: endpoint.method,\n            });\n\n            // Set rate limit headers\n            const rateLimitHeaders = getRateLimitHeaders(\n              rateLimitInfo,\n              endpoint.rateLimit,\n            );\n            for (const [key, value] of Object.entries(rateLimitHeaders)) {\n              if (value) {\n                c.header(key, value);\n              }\n            }\n          }\n\n          // Create audit context if audit storage is configured\n          const auditContext = await createAuditContext(\n            endpoint,\n            serviceDiscovery,\n            logger,\n            {\n              session,\n              header,\n              cookie,\n              services: services as Record<string, unknown>,\n            },\n          );\n\n          // Warn if declarative audits are configured but no audit storage\n          const audits = endpoint.audits as MappedAudit<\n            TAuditAction,\n            TOutSchema\n          >[];\n          if (!auditContext && audits?.length) {\n            logger.warn('No auditor storage service available');\n          }\n\n          // Execute handler with automatic audit transaction support\n          const result = await executeWithAuditTransaction(\n            auditContext,\n            async (auditor) => {\n              // Use audit transaction as db only if the storage uses the same database service\n              const sameDatabase =\n                auditContext?.storage?.databaseServiceName &&\n                auditContext.storage.databaseServiceName ===\n                  endpoint.databaseService?.serviceName;\n              const db = sameDatabase\n                ? (auditor?.getTransaction?.() ?? rawDb)\n                : rawDb;\n\n              const responseBuilder = new ResponseBuilder();\n              const response = await endpoint.handler(\n                {\n                  services,\n                  logger,\n                  body: c.req.valid('json'),\n                  query: c.req.valid('query'),\n                  params: c.req.valid('param'),\n                  session,\n                  header,\n                  cookie,\n                  auditor,\n                  db,\n                } as unknown as EndpointContext<\n                  TInput,\n                  TServices,\n                  TLogger,\n                  TSession,\n                  TAuditAction,\n                  TDatabase,\n                  TAuditStorage\n                >,\n                responseBuilder,\n              );\n\n              // Check if response has metadata\n              let data = response;\n              let metadata = responseBuilder.getMetadata();\n\n              if (Endpoint.hasMetadata(response)) {\n                data = response.data;\n                metadata = response.metadata;\n              }\n\n              const output = endpoint.outputSchema\n                ? await endpoint.parseOutput(data)\n                : undefined;\n\n              return { output, metadata, responseBuilder };\n            },\n            // Process declarative audits after handler (inside transaction)\n            async (result, auditor) => {\n              if (!audits?.length) return;\n\n              for (const audit of audits) {\n                if (audit.when && !audit.when(result.output as any)) {\n                  continue;\n                }\n                const payload = audit.payload(result.output as any);\n                const entityId = audit.entityId?.(result.output as any);\n                auditor.audit(audit.type as any, payload as any, {\n                  table: audit.table,\n                  entityId,\n                });\n              }\n            },\n          );\n\n          const { output, metadata } = result;\n\n          try {\n            let status = endpoint.status as ContentfulStatusCode;\n\n            // Apply response metadata\n            if (metadata.status) {\n              status = metadata.status as ContentfulStatusCode;\n            }\n\n            if (metadata.headers) {\n              for (const [key, value] of Object.entries(metadata.headers)) {\n                c.header(key, value);\n              }\n            }\n\n            if (metadata.cookies) {\n              for (const [name, { value, options }] of metadata.cookies) {\n                setCookie(c, name, value, options);\n              }\n            }\n\n            // @ts-ignore\n            c.set('__response', output);\n            // @ts-ignore\n            c.set('__endpoint', endpoint);\n            // @ts-ignore\n            c.set('__logger', logger);\n            // @ts-ignore\n            c.set('__session', session);\n            // @ts-ignore\n            c.set('__services', services);\n\n            if (HonoEndpoint.isDev) {\n              logger.info({ status, body: output }, 'Outgoing response');\n            }\n            // @ts-ignore\n            return c.json(output, status);\n          } catch (validationError: any) {\n            logger.error(validationError, 'Output validation failed');\n            const error = wrapError(\n              validationError,\n              422,\n              'Response validation failed',\n            );\n            if (HonoEndpoint.isDev) {\n              logger.info(\n                { status: error.statusCode, body: error },\n                'Outgoing response',\n              );\n            }\n            return c.json(error, error.statusCode as ContentfulStatusCode);\n          }\n        } catch (e: any) {\n          logger.error(e, 'Error processing endpoint request');\n          const error = wrapError(e, 500, 'Internal Server Error');\n          if (HonoEndpoint.isDev) {\n            logger.info(\n              { status: error.statusCode, body: error },\n              'Outgoing response',\n            );\n          }\n          return c.json(error, error.statusCode as ContentfulStatusCode);\n        }\n      },\n    );\n  }\n\n  static addDocsRoute<\n    TServices extends Service[] = [],\n    TLogger extends Logger = Logger,\n  >(\n    endpoints: Endpoint<string, HttpMethod, any, any, TServices, TLogger>[],\n    app: Hono,\n    docsPath: string,\n    openApiOptions?: HonoEndpointOptions['openApiOptions'],\n  ): void {\n    app.get(docsPath, async (c) => {\n      try {\n        const openApiSchema = await Endpoint.buildOpenApiSchema(\n          endpoints,\n          openApiOptions,\n        );\n\n        return c.json(openApiSchema);\n      } catch (error) {\n        console.error('Error generating OpenAPI schema:', error);\n        return c.json(\n          { error: 'Failed to generate OpenAPI documentation' },\n          500,\n        );\n      }\n    });\n  }\n}\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":";;;;;;;;;;;;;;;;;;AA4BA,eAAsB,sBAYpBA,UAcAC,UACAC,kBACAC,QACAC,KAMAC,iBACe;AACf,KAAI;EACF,MAAM,SAAS,SAAS;EAIxB,MAAM,qBACJ,mBAAmB,gBAAgB,YAAY,CAAC,SAAS;AAG3D,OAAK,QAAQ,WAAW,oBAAoB;AAC1C,UAAO,MAAM,uBAAuB;AACpC;EACD;AAGD,OAAK,SAAS,uBAAuB;AACnC,OAAI,sBAAsB,QAAQ,OAChC,QAAO,KAAK,uCAAuC;AAErD;EACD;EAGD,IAAIC;AAEJ,MAAI,iBAAiB;AAEnB,aAAU;AACV,UAAO,MAAM,8CAA8C;EAC5D,OAAM;GAEL,MAAM,WAAW,MAAM,iBAAiB,SAAS,CAC/C,SAAS,qBACV,EAAC;GACF,MAAM,UAAU,SACd,SAAS,sBAAsB;GAIjC,IAAIC,QAAoB;IAAE,IAAI;IAAU,MAAM;GAAU;AACxD,OAAI,SAAS,eACX,KAAI;AACF,YAAQ,MAAM,AACZ,SAAS,eAKT;KACA,UAAU,IAAI;KACd,SAAS,IAAI;KACb,QAAQ,IAAI;KACZ,QAAQ,IAAI;KACZ;IACD,EAAC;GACH,SAAQ,OAAO;AACd,WAAO,MAAM,OAAgB,qCAAqC;GAEnE;AAGH,aAAU,IAAIC,iCAA6B;IACzC;IACA;IACA,UAAU;KACR,UAAU,SAAS;KACnB,QAAQ,SAAS;IAClB;GACF;EACF;AAGD,MAAI,QAAQ,OACV,MAAK,MAAM,SAAS,QAAQ;AAC1B,UAAO,MAAM,EAAE,OAAO,MAAM,KAAM,GAAE,+BAA+B;AAGnE,OAAI,MAAM,SAAS,MAAM,KAAK,SAAgB,EAAE;AAC9C,WAAO,MACL,EAAE,OAAO,MAAM,KAAM,GACrB,sCACD;AACD;GACD;GAGD,MAAM,UAAU,MAAM,QAAQ,SAAgB;GAG9C,MAAM,WAAW,MAAM,WAAW,SAAgB;AAGlD,WAAQ,MAAM,MAAM,MAAa,SAAgB;IAC/C,OAAO,MAAM;IACb;GACD,EAAC;EACH;EAMH,MAAM,cAAc,QAAQ,YAAY,CAAC;AACzC,MAAI,cAAc,GAAG;GAEnB,MAAM,MACJ,oBAAoB,UAChB,AAAC,QAA0C,gBAAgB;AAEjE,UAAO,MACL;IAAE,YAAY;IAAa,kBAAkB;GAAK,GAClD,kBACD;AACD,SAAM,QAAQ,OAAO;EACtB;CACF,SAAQ,OAAO;AACd,SAAO,MAAM,OAAgB,2BAA2B;CAEzD;AACF;;;;;;;;;;;AA2BD,eAAsB,mBAapBC,UAgBAP,kBACAC,QACAC,KAM0D;AAC1D,MAAK,SAAS,sBACZ;CAGF,MAAM,WAAW,MAAM,iBAAiB,SAAS,CAC/C,SAAS,qBACV,EAAC;CACF,MAAM,UAAU,SACd,SAAS,sBAAsB;CAIjC,IAAIG,QAAoB;EAAE,IAAI;EAAU,MAAM;CAAU;AACxD,KAAI,SAAS,eACX,KAAI;AACF,UAAQ,MAAM,AACZ,SAAS,eACT;GACA,UAAU,IAAI;GACd,SAAS,IAAI;GACb,QAAQ,IAAI;GACZ,QAAQ,IAAI;GACZ;EACD,EAAC;CACH,SAAQ,OAAO;AACd,SAAO,MAAM,OAAgB,qCAAqC;CACnE;CAGH,MAAM,UAAU,IAAIC,iCAA6B;EAC/C;EACA;EACA,UAAU;GACR,UAAU,SAAS;GACnB,QAAQ,SAAS;EAClB;CACF;AAED,QAAO;EAAE;EAAS;CAAS;AAC5B;;;;;;;;;;;AAYD,eAAsB,4BAOpBE,cACAC,SACAC,YACY;AAEZ,MAAK,aACH,QAAO,eAAkB;CAG3B,MAAM,EAAE,SAAS,SAAS,GAAG;CAG7B,MAAM,KAAK,QAAQ,eAAe;AAElC,KAAI,GAEF,QAAO,uDAAyB,IAAW,SAAgB,YAAY;EACrE,MAAMC,aAAW,MAAM,QAAQ,QAAQ;AAGvC,MAAI,WACF,OAAM,WAAWA,YAAU,QAAQ;AAIrC,SAAOA;CACR,EAAC;CAIJ,MAAM,WAAW,MAAM,QAAQ,QAAQ;AAEvC,KAAI,WACF,OAAM,WAAW,UAAU,QAAQ;AAIrC,OAAM,QAAQ,OAAO;AAErB,QAAO;AACR"}

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":";;;;;;;;;;;;;;;;;AA4BA,eAAsB,sBAYpBA,UAcAC,UACAC,kBACAC,QACAC,KAMAC,iBACe;AACf,KAAI;EACF,MAAM,SAAS,SAAS;EAIxB,MAAM,qBACJ,mBAAmB,gBAAgB,YAAY,CAAC,SAAS;AAG3D,OAAK,QAAQ,WAAW,oBAAoB;AAC1C,UAAO,MAAM,uBAAuB;AACpC;EACD;AAGD,OAAK,SAAS,uBAAuB;AACnC,OAAI,sBAAsB,QAAQ,OAChC,QAAO,KAAK,uCAAuC;AAErD;EACD;EAGD,IAAIC;AAEJ,MAAI,iBAAiB;AAEnB,aAAU;AACV,UAAO,MAAM,8CAA8C;EAC5D,OAAM;GAEL,MAAM,WAAW,MAAM,iBAAiB,SAAS,CAC/C,SAAS,qBACV,EAAC;GACF,MAAM,UAAU,SACd,SAAS,sBAAsB;GAIjC,IAAIC,QAAoB;IAAE,IAAI;IAAU,MAAM;GAAU;AACxD,OAAI,SAAS,eACX,KAAI;AACF,YAAQ,MAAM,AACZ,SAAS,eAKT;KACA,UAAU,IAAI;KACd,SAAS,IAAI;KACb,QAAQ,IAAI;KACZ,QAAQ,IAAI;KACZ;IACD,EAAC;GACH,SAAQ,OAAO;AACd,WAAO,MAAM,OAAgB,qCAAqC;GAEnE;AAGH,aAAU,IAAI,eAA6B;IACzC;IACA;IACA,UAAU;KACR,UAAU,SAAS;KACnB,QAAQ,SAAS;IAClB;GACF;EACF;AAGD,MAAI,QAAQ,OACV,MAAK,MAAM,SAAS,QAAQ;AAC1B,UAAO,MAAM,EAAE,OAAO,MAAM,KAAM,GAAE,+BAA+B;AAGnE,OAAI,MAAM,SAAS,MAAM,KAAK,SAAgB,EAAE;AAC9C,WAAO,MACL,EAAE,OAAO,MAAM,KAAM,GACrB,sCACD;AACD;GACD;GAGD,MAAM,UAAU,MAAM,QAAQ,SAAgB;GAG9C,MAAM,WAAW,MAAM,WAAW,SAAgB;AAGlD,WAAQ,MAAM,MAAM,MAAa,SAAgB;IAC/C,OAAO,MAAM;IACb;GACD,EAAC;EACH;EAMH,MAAM,cAAc,QAAQ,YAAY,CAAC;AACzC,MAAI,cAAc,GAAG;GAEnB,MAAM,MACJ,oBAAoB,UAChB,AAAC,QAA0C,gBAAgB;AAEjE,UAAO,MACL;IAAE,YAAY;IAAa,kBAAkB;GAAK,GAClD,kBACD;AACD,SAAM,QAAQ,OAAO;EACtB;CACF,SAAQ,OAAO;AACd,SAAO,MAAM,OAAgB,2BAA2B;CAEzD;AACF;;;;;;;;;;;AA2BD,eAAsB,mBAapBC,UAgBAN,kBACAC,QACAC,KAM0D;AAC1D,MAAK,SAAS,sBACZ;CAGF,MAAM,WAAW,MAAM,iBAAiB,SAAS,CAC/C,SAAS,qBACV,EAAC;CACF,MAAM,UAAU,SACd,SAAS,sBAAsB;CAIjC,IAAIG,QAAoB;EAAE,IAAI;EAAU,MAAM;CAAU;AACxD,KAAI,SAAS,eACX,KAAI;AACF,UAAQ,MAAM,AACZ,SAAS,eACT;GACA,UAAU,IAAI;GACd,SAAS,IAAI;GACb,QAAQ,IAAI;GACZ,QAAQ,IAAI;GACZ;EACD,EAAC;CACH,SAAQ,OAAO;AACd,SAAO,MAAM,OAAgB,qCAAqC;CACnE;CAGH,MAAM,UAAU,IAAI,eAA6B;EAC/C;EACA;EACA,UAAU;GACR,UAAU,SAAS;GACnB,QAAQ,SAAS;EAClB;CACF;AAED,QAAO;EAAE;EAAS;CAAS;AAC5B;;;;;;;;;;;AAYD,eAAsB,4BAOpBE,cACAC,SACAC,YACY;AAEZ,MAAK,aACH,QAAO,eAAkB;CAG3B,MAAM,EAAE,SAAS,SAAS,GAAG;CAG7B,MAAM,KAAK,QAAQ,eAAe;AAElC,KAAI,GAEF,QAAO,yBAAyB,IAAW,SAAgB,YAAY;EACrE,MAAMC,aAAW,MAAM,QAAQ,QAAQ;AAGvC,MAAI,WACF,OAAM,WAAWA,YAAU,QAAQ;AAIrC,SAAOA;CACR,EAAC;CAIJ,MAAM,WAAW,MAAM,QAAQ,QAAQ;AAEvC,KAAI,WACF,OAAM,WAAW,UAAU,QAAQ;AAIrC,OAAM,QAAQ,OAAO;AAErB,QAAO;AACR"}