zlient 2.1.4 → 2.1.5

package/dist/endpoint/base-endpoint.d.ts

@@ -11,6 +11,8 @@ export type EndpointConfig<ResSchema extends z.ZodType | Record<number, z.ZodTyp
     advanced?: {
         baseUrlKey?: string;
         skipAuth?: boolean;
+        skipRequestValidation?: boolean;
+        skipResponseValidation?: boolean;
     };
     description?: string;
 };

package/dist/endpoint/base-endpoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-endpoint.d.ts","sourceRoot":"","sources":["../../lib/endpoint/base-endpoint.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base-endpoint.d.ts","sourceRoot":"","sources":["../../lib/endpoint/base-endpoint.ts"],"names":[],"mappings":"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"}

package/dist/index.cjs

@@ -315,15 +315,17 @@ var EndpointImpl = class {
 	}
 	async call(params) {
 		const { data, query, pathParams, headers, signal } = params;
-		if (this.config.request && data !== void 0) {
+		const skipRequestValidation = this.config.advanced?.skipRequestValidation ?? false;
+		const skipResponseValidation = this.config.advanced?.skipResponseValidation ?? false;
+		if (!skipRequestValidation && this.config.request && data !== void 0) {
 			const parsed = this.config.request.safeParse(data);
 			if (!parsed.success) throw parsed.error;
 		}
-		if (this.config.query && query !== void 0) {
+		if (!skipRequestValidation && this.config.query && query !== void 0) {
 			const parsed = this.config.query.safeParse(query);
 			if (!parsed.success) throw parsed.error;
 		}
-		if (this.config.pathParams && pathParams !== void 0) {
+		if (!skipRequestValidation && this.config.pathParams && pathParams !== void 0) {
 			const parsed = this.config.pathParams.safeParse(pathParams);
 			if (!parsed.success) throw parsed.error;
 		}
@@ -342,6 +344,7 @@ var EndpointImpl = class {
 			signal
 		});
 		const schema = this.config.response;
+		if (skipResponseValidation) return responseData;
 		if (schema instanceof zod.z.ZodType) return parseOrThrow(schema, responseData);
 		const specificSchema = schema[status];
 		if (!specificSchema) throw new SchemaDefinitionError(status);

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["opts: { header?: string; query?: string; value: string }","getToken: () => Promise<string> | string","message: string","options?: { status?: number; cause?: unknown; details?: unknown; zodError?: ZodError }","status: number","q?: RequestOptions['query']","s","schema: z.ZodType","data: unknown","client: HttpClient","config: EndpointConfig<ResSchema, ReqSchema, QuerySchema, PathSchema>","params: EndpointCallParams<ReqSchema, QuerySchema, PathSchema>","pathStr: string","z","minLevel: LogLevel","entry: LogEntry","_entry: LogEntry","logger: Logger","message: string","context?: Record<string, unknown>","error?: Error","_metrics: RequestMetrics","metrics: RequestMetrics","opts: ClientOptions","auth: AuthProvider","key?: keyof typeof this.baseUrls","k: string","ms: number","fn: () => Promise<T>","canRetry: (ctx: { attempt: number; error?: unknown; response?: Response }) => boolean","err: unknown","url: string","init: RequestInit & { __urlOverride?: string }","req: Request","res: Response","parsed?: unknown","key: string","method: keyof typeof HTTPMethod","path: string","body?: unknown","options?: RequestOptions","timeoutId: NodeJS.Timeout | number | undefined","config: EndpointConfig<ResSchema, ReqSchema, QuerySchema, PathSchema>","inner: T","meta?: M"],"sources":["../lib/auth.ts","../lib/types.ts","../lib/validation.ts","../lib/endpoint/base-endpoint.ts","../lib/logger.ts","../lib/metrics.ts","../lib/http/http-client.ts","../lib/schemas/common.ts"],"sourcesContent":["import type { RequestOptions as ReqOpts } from './types';\n\n/**\n * Extended RequestInit with URL override capability for query-based auth.\n */\nexport interface AuthContext {\n  url: string;\n  init: RequestInit & { __urlOverride?: string };\n  options?: ReqOpts;\n}\n\n/**\n * Interface for authentication providers.\n * Implement this to create custom authentication strategies.\n *\n * @example\n * ```ts\n * class CustomAuth implements AuthProvider {\n *   async apply({ init }) {\n *     init.headers = { ...init.headers, 'X-Custom-Auth': 'token' };\n *   }\n * }\n * ```\n */\nexport interface AuthProvider {\n  /**\n   * Apply authentication to the outgoing request.\n   * Called after SDK headers are assembled, but before request is sent.\n   *\n   * @param req - Request context including URL, init, and options\n   */\n  apply(req: AuthContext): Promise<void> | void;\n}\n\n/**\n * No-op authentication provider (no authentication applied).\n * Use this when you don't need authentication.\n */\nexport class NoAuth implements AuthProvider {\n  async apply() {\n    /* no-op */\n  }\n}\n\n/**\n * API Key authentication provider.\n * Supports both header-based and query parameter-based authentication.\n *\n * @example\n * ```ts\n * // Header-based\n * const auth = new ApiKeyAuth({ header: 'X-API-Key', value: 'secret' });\n *\n * // Query parameter-based\n * const auth = new ApiKeyAuth({ query: 'apiKey', value: 'secret' });\n * ```\n */\nexport class ApiKeyAuth implements AuthProvider {\n  constructor(private opts: { header?: string; query?: string; value: string }) {\n    if (!opts.header && !opts.query) {\n      throw new Error('ApiKeyAuth requires either \"header\" or \"query\" option');\n    }\n    if (opts.header && opts.query) {\n      throw new Error('ApiKeyAuth cannot use both \"header\" and \"query\" options');\n    }\n  }\n  apply({ url, init }: AuthContext) {\n    const value = this.opts.value;\n    if (this.opts.header) {\n      if (init.headers instanceof Headers) {\n        init.headers.set(this.opts.header, value);\n      } else if (Array.isArray(init.headers)) {\n        init.headers.push([this.opts.header, value]);\n      } else {\n        init.headers = { ...init.headers, [this.opts.header]: value };\n      }\n    } else if (this.opts.query) {\n      const u = new URL(url);\n      u.searchParams.set(this.opts.query, value);\n      init.__urlOverride = u.toString();\n    }\n  }\n}\n/**\n * Bearer token authentication provider.\n * Supports both static tokens and dynamic token fetching (e.g., for OAuth2 refresh).\n *\n * @example\n * ```ts\n * // Static token\n * const auth = new BearerTokenAuth(() => 'my-token');\n *\n * // Dynamic token with refresh\n * const auth = new BearerTokenAuth(async () => {\n *   return await refreshAccessToken();\n * });\n * ```\n */\nexport class BearerTokenAuth implements AuthProvider {\n  constructor(private getToken: () => Promise<string> | string) {}\n  async apply({ init }: AuthContext) {\n    const token = await this.getToken();\n    if (!token) {\n      throw new Error('BearerTokenAuth: token is empty or undefined');\n    }\n    const authHeader = `Bearer ${token}`;\n    if (init.headers instanceof Headers) {\n      init.headers.set('Authorization', authHeader);\n    } else if (Array.isArray(init.headers)) {\n      init.headers.push(['Authorization', authHeader]);\n    } else {\n      init.headers = { ...init.headers, Authorization: authHeader };\n    }\n  }\n}\n","import { z, ZodError } from 'zod';\nimport { AuthProvider } from './auth';\nimport { Logger } from './logger';\nimport { MetricsCollector } from './metrics';\n\nexport type Dictionary<T> = Record<string, T>;\n\nexport type FetchLike = (input: string | Request | URL, init?: RequestInit) => Promise<Response>;\n\n/**\n * Map of base URLs for different services.\n * The 'default' key is required and used when no specific key is provided.\n *\n * @example\n * ```ts\n * {\n *   default: 'https://api.example.com',\n *   auth: 'https://auth.example.com',\n *   cdn: 'https://cdn.example.com'\n * }\n * ```\n */\nexport type BaseUrlMap = {\n  default: string;\n} & Record<string, string>;\n\n/**\n * Configuration for retry behavior on failed requests.\n * Implements exponential backoff with optional jitter.\n *\n * @example\n * ```ts\n * {\n *   maxRetries: 3,\n *   baseDelayMs: 1000,\n *   jitter: 0.2,\n *   retryMethods: ['GET', 'HEAD', 'PUT']\n * }\n * ```\n */\nexport type RetryStrategy = {\n  /** Maximum number of retry attempts */\n  maxRetries: number;\n  /** Base delay in milliseconds (will be exponentially increased) */\n  baseDelayMs: number;\n  /** Jitter factor 0..1 to randomize delays and prevent thundering herd */\n  jitter?: number;\n  /** HTTP methods eligible for retry */\n  retryMethods?: (keyof typeof HTTPMethod)[];\n  /** HTTP status codes eligible for retry */\n  retryStatusCodes?: (keyof typeof HTTPStatusCode)[];\n  /** Custom function to determine if a request should be retried */\n  shouldRetry?: (ctx: { attempt: number; error?: unknown; response?: Response }) => boolean;\n};\n\nexport const HTTPMethod = {\n  GET: 'GET',\n  POST: 'POST',\n  PUT: 'PUT',\n  PATCH: 'PATCH',\n  DELETE: 'DELETE',\n  HEAD: 'HEAD',\n  OPTIONS: 'OPTIONS',\n} as const;\n\nexport type HttpMethod = keyof typeof HTTPMethod;\n\nexport const HTTPStatusCode = {\n  // 1xx — Informational\n  CONTINUE: 100,\n  SWITCHING_PROTOCOLS: 101,\n  PROCESSING: 102,\n  EARLY_HINTS: 103,\n\n  // 2xx — Success\n  OK: 200,\n  CREATED: 201,\n  ACCEPTED: 202,\n  NON_AUTHORITATIVE_INFORMATION: 203,\n  NO_CONTENT: 204,\n  RESET_CONTENT: 205,\n  PARTIAL_CONTENT: 206,\n  MULTI_STATUS: 207,\n  ALREADY_REPORTED: 208,\n  IM_USED: 226,\n\n  // 3xx — Redirection\n  MULTIPLE_CHOICES: 300,\n  MOVED_PERMANENTLY: 301,\n  FOUND: 302,\n  SEE_OTHER: 303,\n  NOT_MODIFIED: 304,\n  USE_PROXY: 305,\n  TEMPORARY_REDIRECT: 307,\n  PERMANENT_REDIRECT: 308,\n\n  // 4xx — Client Errors\n  BAD_REQUEST: 400,\n  UNAUTHORIZED: 401,\n  PAYMENT_REQUIRED: 402,\n  FORBIDDEN: 403,\n  NOT_FOUND: 404,\n  METHOD_NOT_ALLOWED: 405,\n  NOT_ACCEPTABLE: 406,\n  PROXY_AUTHENTICATION_REQUIRED: 407,\n  REQUEST_TIMEOUT: 408,\n  CONFLICT: 409,\n  GONE: 410,\n  LENGTH_REQUIRED: 411,\n  PRECONDITION_FAILED: 412,\n  PAYLOAD_TOO_LARGE: 413,\n  URI_TOO_LONG: 414,\n  UNSUPPORTED_MEDIA_TYPE: 415,\n  RANGE_NOT_SATISFIABLE: 416,\n  EXPECTATION_FAILED: 417,\n  IM_A_TEAPOT: 418,\n  MISDIRECTED_REQUEST: 421,\n  UNPROCESSABLE_ENTITY: 422,\n  LOCKED: 423,\n  FAILED_DEPENDENCY: 424,\n  TOO_EARLY: 425,\n  UPGRADE_REQUIRED: 426,\n  PRECONDITION_REQUIRED: 428,\n  TOO_MANY_REQUESTS: 429,\n  REQUEST_HEADER_FIELDS_TOO_LARGE: 431,\n  UNAVAILABLE_FOR_LEGAL_REASONS: 451,\n\n  // 5xx — Server Errors\n  INTERNAL_SERVER_ERROR: 500,\n  NOT_IMPLEMENTED: 501,\n  BAD_GATEWAY: 502,\n  SERVICE_UNAVAILABLE: 503,\n  GATEWAY_TIMEOUT: 504,\n  HTTP_VERSION_NOT_SUPPORTED: 505,\n  VARIANT_ALSO_NEGOTIATES: 506,\n  INSUFFICIENT_STORAGE: 507,\n  LOOP_DETECTED: 508,\n  NOT_EXTENDED: 510,\n  NETWORK_AUTHENTICATION_REQUIRED: 511,\n} as const;\n\nexport type HTTPStatusCode = keyof typeof HTTPStatusCode;\nexport type HTTPStatusCodeNumber = (typeof HTTPStatusCode)[HTTPStatusCode];\n\n/**\n * Hook called after a response is received and parsed.\n * Useful for logging, metrics, or global error handling.\n */\nexport type AfterResponseHook = (ctx: {\n  request: Request;\n  response: Response;\n  parsed?: unknown;\n}) => Promise<void> | void;\n\n/**\n * Hook called before a request is sent.\n * Useful for logging, adding headers, or modifying the request.\n */\nexport type BeforeRequestHook = (ctx: { url: string; init: RequestInit }) => Promise<void> | void;\n\nexport interface Interceptors {\n  /** Hooks executed before each request is sent */\n  beforeRequest?: BeforeRequestHook[];\n  /** Hooks executed after each response is received */\n  afterResponse?: AfterResponseHook[];\n}\n\nexport interface TimeoutOptions {\n  /** Request timeout in milliseconds */\n  requestTimeoutMs?: number;\n}\n\n/**\n * Configuration options for the HTTP client.\n *\n * @example\n * ```ts\n * const options: ClientOptions = {\n *   baseUrls: { default: 'https://api.example.com' },\n *   headers: { 'X-API-Version': '1.0' },\n *   retry: { maxRetries: 3, baseDelayMs: 1000 },\n *   timeout: { requestTimeoutMs: 30000 }\n * }\n * ```\n */\nexport interface ClientOptions {\n  /** Map of base URLs for different services */\n  baseUrls: BaseUrlMap;\n  /** Custom fetch implementation (defaults to globalThis.fetch) */\n  fetch?: FetchLike;\n  /** Default headers applied to all requests */\n  headers?: Record<string, string>;\n  /** Retry strategy configuration */\n  retry?: RetryStrategy;\n  /** Request/response interceptors */\n  interceptors?: Interceptors;\n  /** Timeout configuration */\n  timeout?: TimeoutOptions;\n  /** Authentication provider */\n  auth?: AuthProvider;\n  /** Logger instance */\n  logger?: Logger;\n  /** Metrics collector */\n  metrics?: MetricsCollector;\n  /**\n   * Callback to handle 401 Unauthorized responses.\n   * Return true to retry the request (e.g. after refreshing tokens),\n   * or false to return the 401 response as is.\n   */\n  onUnauthenticated?: (response: Response) => Promise<boolean> | boolean;\n}\n\nexport type SafeParseResult<T> = { success: true; data: T } | { success: false; error: ZodError };\n\n/**\n * Custom error class for API-related errors.\n * Includes HTTP status codes, response details, and validation errors.\n *\n * @example\n * ```ts\n * throw new ApiError('Invalid request', {\n *   status: 400,\n *   details: { field: 'email', message: 'Invalid format' }\n * });\n * ```\n */\nexport class ApiError extends Error {\n  public status?: number;\n  public details?: unknown;\n  public zodError?: ZodError;\n\n  constructor(\n    message: string,\n    options?: { status?: number; cause?: unknown; details?: unknown; zodError?: ZodError }\n  ) {\n    super(message);\n    this.name = 'ApiError';\n    this.status = options?.status;\n    this.details = options?.details;\n    this.cause = options?.cause;\n    this.zodError = options?.zodError;\n\n    // Maintains proper stack trace for where error was thrown\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, ApiError);\n    }\n  }\n\n  /**\n   * Check if this is a validation error (has zodError)\n   */\n  isValidationError(): boolean {\n    return !!this.zodError;\n  }\n\n  /**\n   * Check if this is a client error (4xx status)\n   */\n  isClientError(): boolean {\n    return !!this.status && this.status >= 400 && this.status < 500;\n  }\n\n  /**\n   * Check if this is a server error (5xx status)\n   */\n  isServerError(): boolean {\n    return !!this.status && this.status >= 500;\n  }\n\n  /**\n   * Get a formatted error message with all available details\n   */\n  toJSON() {\n    return {\n      name: this.name,\n      message: this.message,\n      status: this.status,\n      details: this.details,\n      zodError: this.zodError?.issues,\n      stack: this.stack,\n    };\n  }\n}\n\n/**\n * Error thrown when an endpoint receives a response with a status code\n * that has no defined schema in the endpoint configuration.\n */\nexport class SchemaDefinitionError extends Error {\n  constructor(public status: number) {\n    super(`No schema defined for status code ${status}`);\n    this.name = 'SchemaDefinitionError';\n\n    // Maintains proper stack trace\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, SchemaDefinitionError);\n    }\n  }\n}\n\nexport type Paginated<T> = {\n  items: T[];\n  total: number;\n  page: number;\n  pageSize: number;\n};\n\n/**\n * Schema for paginated responses\n */\nexport const PaginationSchema = z.object({\n  items: z.array(z.unknown()),\n  total: z.number().int().nonnegative(),\n  page: z.number().int().nonnegative(),\n  pageSize: z.number().int().positive(),\n});\n\n/**\n * Options that can be passed to individual requests to override defaults.\n *\n * @example\n * ```ts\n * await endpoint.call(data, {\n *   baseUrlKey: 'v2',\n *   headers: { 'X-Custom': 'value' },\n *   query: { filter: 'active' }\n * });\n * ```\n */\nexport type RequestOptions = {\n  /** Override base URL for a single call */\n  baseUrlKey?: keyof BaseUrlMap;\n  /** Additional headers for this call only */\n  headers?: Record<string, string>;\n  /** Abort controller signal for cancellation */\n  signal?: AbortSignal;\n  /** Custom query params */\n  query?: URLSearchParams | Record<string, string | number | boolean | undefined>;\n  /** Skip authentication for this request */\n  skipAuth?: boolean;\n};\n\n/**\n * Converts query parameters to a URL query string.\n * Filters out undefined values automatically.\n *\n * @param q - Query parameters as URLSearchParams or object\n * @returns Query string with leading '?' or empty string\n *\n * @example\n * ```ts\n * toQueryString({ page: 1, filter: 'active' }) // \"?page=1&filter=active\"\n * toQueryString({ optional: undefined }) // \"\"\n * ```\n */\nexport function toQueryString(q?: RequestOptions['query']): string {\n  if (!q) return '';\n  if (q instanceof URLSearchParams) {\n    const s = q.toString();\n    return s ? `?${s}` : '';\n  }\n  const params = new URLSearchParams();\n  Object.entries(q).forEach(([k, v]) => {\n    if (v !== undefined) {\n      params.append(k, String(v));\n    }\n  });\n  const s = params.toString();\n  return s ? `?${s}` : '';\n}\n","import { z } from 'zod';\nimport { ApiError, SafeParseResult } from './types';\n\n/**\n * Safely parse data with a Zod schema without throwing.\n * Returns a result object with success status and data or error.\n *\n * @param schema - Zod schema to validate against\n * @param data - Data to validate\n * @returns Result object with success flag and data/error\n *\n * @example\n * ```ts\n * const result = safeParse(UserSchema, userData);\n * if (result.success) {\n *   console.log(result.data);\n * } else {\n *   console.error(result.error);\n * }\n * ```\n */\nexport function safeParse<T>(schema: z.ZodType, data: unknown): SafeParseResult<T> {\n  const res = schema.safeParse(data);\n  if (res.success) return { success: true, data: res.data as T };\n  return { success: false, error: res.error };\n}\n\n/**\n * Parse data with a Zod schema, throwing an ApiError on validation failure.\n * Use this when you want to fail fast on invalid data.\n *\n * @param schema - Zod schema to validate against\n * @param data - Data to validate\n * @returns Validated and typed data\n * @throws {ApiError} If validation fails\n *\n * @example\n * ```ts\n * try {\n *   const user = parseOrThrow(UserSchema, userData);\n *   console.log(user);\n * } catch (error) {\n *   if (error instanceof ApiError && error.zodError) {\n *     console.error('Validation failed:', error.zodError.issues);\n *   }\n * }\n * ```\n */\nexport function parseOrThrow<T>(schema: z.ZodType, data: unknown): T {\n  const res = schema.safeParse(data);\n  if (!res.success) {\n    throw new ApiError('Response validation failed', { zodError: res.error });\n  }\n  return res.data as T;\n}\n","import { z } from 'zod';\nimport { HttpClient } from '../http/http-client';\nimport { HTTPMethod, SchemaDefinitionError } from '../types';\nimport { parseOrThrow } from '../validation';\n\nexport type EndpointConfig<\n  ResSchema extends z.ZodType | Record<number, z.ZodType>,\n  ReqSchema extends z.ZodType | undefined = undefined,\n  QuerySchema extends z.ZodType | undefined = undefined,\n  PathSchema extends z.ZodType | undefined = undefined,\n> = {\n  method: keyof typeof HTTPMethod;\n  path: string | ((params: z.infer<Exclude<PathSchema, undefined>>) => string);\n  response: ResSchema;\n  request?: ReqSchema;\n  query?: QuerySchema;\n  pathParams?: PathSchema;\n  advanced?: {\n    baseUrlKey?: string;\n    skipAuth?: boolean;\n  };\n  description?: string;\n};\n\nexport type EndpointCallParams<\n  ReqSchema extends z.ZodType | undefined,\n  QuerySchema extends z.ZodType | undefined,\n  PathSchema extends z.ZodType | undefined,\n> = {\n  data?: ReqSchema extends z.ZodType ? z.infer<ReqSchema> : never;\n  query?: QuerySchema extends z.ZodType ? z.infer<QuerySchema> : never;\n  pathParams?: PathSchema extends z.ZodType ? z.infer<PathSchema> : never;\n  headers?: Record<string, string>;\n  signal?: globalThis.AbortSignal;\n};\n\n// Helper to extract the response type from a schema which might be a single ZodType or a status map\ntype InferResponse<S> = S extends z.ZodType\n  ? z.infer<S>\n  : S extends Record<number, z.ZodType>\n  ? z.infer<S[keyof S]>\n  : never;\n\nexport type EndpointCall<\n  ResSchema extends z.ZodType | Record<number, z.ZodType>,\n  ReqSchema extends z.ZodType | undefined,\n  QuerySchema extends z.ZodType | undefined,\n  PathSchema extends z.ZodType | undefined,\n> = (\n  params: EndpointCallParams<ReqSchema, QuerySchema, PathSchema>\n) => Promise<InferResponse<ResSchema>>;\n\nexport class EndpointImpl<\n  ResSchema extends z.ZodType | Record<number, z.ZodType>,\n  ReqSchema extends z.ZodType | undefined,\n  QuerySchema extends z.ZodType | undefined,\n  PathSchema extends z.ZodType | undefined,\n> {\n  constructor(\n    private client: HttpClient,\n    private config: EndpointConfig<ResSchema, ReqSchema, QuerySchema, PathSchema>\n  ) { }\n\n  async call(\n    params: EndpointCallParams<ReqSchema, QuerySchema, PathSchema>\n  ): Promise<InferResponse<ResSchema>> {\n    const { data, query, pathParams, headers, signal } = params;\n\n    // Validate Request Body\n    if (this.config.request && data !== undefined) {\n      const parsed = this.config.request.safeParse(data);\n      if (!parsed.success) throw parsed.error;\n    }\n\n    // Validate Query Params\n    if (this.config.query && query !== undefined) {\n      const parsed = this.config.query.safeParse(query);\n      if (!parsed.success) throw parsed.error;\n    }\n\n    // Validate Path Params\n    if (this.config.pathParams && pathParams !== undefined) {\n      const parsed = this.config.pathParams.safeParse(pathParams);\n      if (!parsed.success) throw parsed.error;\n    }\n\n    // Check for missing required params\n    if (this.config.request && data === undefined) {\n      throw new Error('Missing required request body (data)');\n    }\n    if (this.config.pathParams && pathParams === undefined) {\n      throw new Error('Missing required path parameters (pathParams)');\n    }\n\n    // Resolve Path\n    let pathStr: string;\n    if (typeof this.config.path === 'function') {\n      if (!pathParams) throw new Error('Path function requires pathParams');\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      pathStr = this.config.path(pathParams as any);\n    } else {\n      pathStr = this.config.path;\n    }\n\n    const { data: responseData, status } = await this.client.request(\n      this.config.method,\n      pathStr,\n      data,\n      {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        query: query as any,\n        headers,\n        baseUrlKey: this.config.advanced?.baseUrlKey,\n        skipAuth: this.config.advanced?.skipAuth,\n        signal,\n      }\n    );\n\n    // Handle Response Validation\n    const schema = this.config.response;\n    if (schema instanceof z.ZodType) {\n      // Single schema for all success codes\n      return parseOrThrow(schema, responseData) as InferResponse<ResSchema>;\n    }\n\n    // Map of status codes\n    const specificSchema = (schema as Record<number, z.ZodType>)[status];\n    if (!specificSchema) {\n      // Fallback or error? For now, rigorous error.\n      throw new SchemaDefinitionError(status);\n    }\n\n    return parseOrThrow(specificSchema, responseData) as InferResponse<ResSchema>;\n  }\n}\n","/**\n * Log levels for structured logging.\n */\nexport enum LogLevel {\n  DEBUG = 'debug',\n  INFO = 'info',\n  WARN = 'warn',\n  ERROR = 'error',\n}\n\n/**\n * Structured log entry with metadata.\n */\nexport interface LogEntry {\n  level: LogLevel;\n  message: string;\n  timestamp: string;\n  context?: Record<string, unknown>;\n  error?: Error;\n}\n\n/**\n * Logger interface for custom logger implementations.\n * Implement this to integrate with your logging infrastructure.\n *\n * @example\n * ```ts\n * class ConsoleLogger implements Logger {\n *   log(entry: LogEntry) {\n *     console.log(JSON.stringify(entry));\n *   }\n * }\n * ```\n */\nexport interface Logger {\n  log(entry: LogEntry): void;\n}\n\n/**\n * Default console logger implementation.\n * Formats log entries as JSON for easy parsing.\n */\nexport class ConsoleLogger implements Logger {\n  constructor(private minLevel: LogLevel = LogLevel.INFO) {}\n\n  log(entry: LogEntry): void {\n    const levels = [LogLevel.DEBUG, LogLevel.INFO, LogLevel.WARN, LogLevel.ERROR];\n    const entryLevelIndex = levels.indexOf(entry.level);\n    const minLevelIndex = levels.indexOf(this.minLevel);\n\n    if (entryLevelIndex < minLevelIndex) return;\n\n    const output = {\n      ...entry,\n      error: entry.error\n        ? {\n            message: entry.error.message,\n            stack: entry.error.stack,\n            name: entry.error.name,\n          }\n        : undefined,\n    };\n\n    switch (entry.level) {\n      case LogLevel.DEBUG:\n        console.debug(JSON.stringify(output));\n        break;\n      case LogLevel.INFO:\n        console.info(JSON.stringify(output));\n        break;\n      case LogLevel.WARN:\n        console.warn(JSON.stringify(output));\n        break;\n      case LogLevel.ERROR:\n        console.error(JSON.stringify(output));\n        break;\n    }\n  }\n}\n\n/**\n * No-op logger that discards all log entries.\n * Use this in production if you don't want any logging.\n */\nexport class NoOpLogger implements Logger {\n  log(_entry: LogEntry): void {\n    // no-op\n  }\n}\n\n/**\n * Utility class for creating structured log entries.\n */\nexport class LoggerUtil {\n  constructor(private logger: Logger) {}\n\n  debug(message: string, context?: Record<string, unknown>): void {\n    this.logger.log({\n      level: LogLevel.DEBUG,\n      message,\n      timestamp: new Date().toISOString(),\n      context,\n    });\n  }\n\n  info(message: string, context?: Record<string, unknown>): void {\n    this.logger.log({\n      level: LogLevel.INFO,\n      message,\n      timestamp: new Date().toISOString(),\n      context,\n    });\n  }\n\n  warn(message: string, context?: Record<string, unknown>): void {\n    this.logger.log({\n      level: LogLevel.WARN,\n      message,\n      timestamp: new Date().toISOString(),\n      context,\n    });\n  }\n\n  error(message: string, error?: Error, context?: Record<string, unknown>): void {\n    this.logger.log({\n      level: LogLevel.ERROR,\n      message,\n      timestamp: new Date().toISOString(),\n      context,\n      error,\n    });\n  }\n}\n","/**\n * Metrics data for HTTP requests.\n */\nexport interface RequestMetrics {\n  method: string;\n  path: string;\n  status?: number;\n  durationMs: number;\n  timestamp: string;\n  success: boolean;\n  error?: string;\n}\n\n/**\n * Interface for metrics collectors.\n * Implement this to integrate with your monitoring infrastructure (DataDog, Prometheus, etc.).\n *\n * @example\n * ```ts\n * class DataDogMetrics implements MetricsCollector {\n *   collect(metrics: RequestMetrics) {\n *     dogstatsd.histogram('http.request.duration', metrics.durationMs, {\n *       method: metrics.method,\n *       status: String(metrics.status)\n *     });\n *   }\n * }\n * ```\n */\nexport interface MetricsCollector {\n  collect(metrics: RequestMetrics): void;\n}\n\n/**\n * No-op metrics collector that discards all metrics.\n */\nexport class NoOpMetricsCollector implements MetricsCollector {\n  collect(_metrics: RequestMetrics): void {\n    // no-op\n  }\n}\n\n/**\n * In-memory metrics collector for testing and development.\n * Stores metrics in memory with configurable retention.\n */\nexport class InMemoryMetricsCollector implements MetricsCollector {\n  private metrics: RequestMetrics[] = [];\n  private readonly maxEntries: number;\n\n  constructor(maxEntries = 1000) {\n    this.maxEntries = maxEntries;\n  }\n\n  collect(metrics: RequestMetrics): void {\n    this.metrics.push(metrics);\n    if (this.metrics.length > this.maxEntries) {\n      this.metrics.shift();\n    }\n  }\n\n  /**\n   * Get all collected metrics.\n   */\n  getMetrics(): RequestMetrics[] {\n    return [...this.metrics];\n  }\n\n  /**\n   * Get metrics summary statistics.\n   */\n  getSummary(): {\n    total: number;\n    successful: number;\n    failed: number;\n    avgDurationMs: number;\n    minDurationMs: number;\n    maxDurationMs: number;\n  } {\n    if (this.metrics.length === 0) {\n      return {\n        total: 0,\n        successful: 0,\n        failed: 0,\n        avgDurationMs: 0,\n        minDurationMs: 0,\n        maxDurationMs: 0,\n      };\n    }\n\n    const successful = this.metrics.filter((m) => m.success).length;\n\n    // Calculate stats in a single pass to avoid stack overflow with spread operator\n    let sum = 0;\n    let min = Infinity;\n    let max = -Infinity;\n\n    for (const m of this.metrics) {\n      const d = m.durationMs;\n      sum += d;\n      if (d < min) min = d;\n      if (d > max) max = d;\n    }\n\n    return {\n      total: this.metrics.length,\n      successful,\n      failed: this.metrics.length - successful,\n      avgDurationMs: sum / this.metrics.length,\n      minDurationMs: min === Infinity ? 0 : min,\n      maxDurationMs: max === -Infinity ? 0 : max,\n    };\n  }\n\n  /**\n   * Clear all collected metrics.\n   */\n  clear(): void {\n    this.metrics = [];\n  }\n}\n\n/**\n * Console-based metrics collector for debugging.\n */\nexport class ConsoleMetricsCollector implements MetricsCollector {\n  collect(metrics: RequestMetrics): void {\n    console.log('[METRICS]', JSON.stringify(metrics));\n  }\n}\n","import { z } from 'zod';\nimport type { AuthProvider } from '../auth';\nimport { NoAuth } from '../auth';\nimport { EndpointCall, EndpointConfig, EndpointImpl } from '../endpoint/base-endpoint';\nimport { LoggerUtil, NoOpLogger } from '../logger';\nimport { MetricsCollector, NoOpMetricsCollector } from '../metrics';\nimport {\n  ApiError,\n  ClientOptions,\n  FetchLike,\n  HTTPMethod,\n  HTTPStatusCode,\n  HTTPStatusCodeNumber,\n  Interceptors,\n  RequestOptions,\n  RetryStrategy,\n  toQueryString,\n} from '../types';\n\n/**\n * HTTP client with built-in retry logic, authentication, and interceptors.\n * Supports multiple base URLs, type-safe requests, and comprehensive error handling.\n *\n * @example\n * ```ts\n * const client = new HttpClient({\n *   baseUrls: { default: 'https://api.example.com' },\n *   headers: { 'Content-Type': 'application/json' },\n *   retry: { maxRetries: 3, baseDelayMs: 1000 },\n *   timeout: { requestTimeoutMs: 30000 }\n * });\n *\n * const { data } = await client.request('GET', '/users', undefined, { query: { page: 1 } });\n * ```\n */\nexport class HttpClient {\n  private fetchImpl: FetchLike;\n  private baseUrls: ClientOptions['baseUrls'];\n  private headers: Record<string, string>;\n  private interceptors: Interceptors;\n  private retry: RetryStrategy;\n  private timeoutMs?: number;\n  private auth: AuthProvider;\n  private logger: LoggerUtil;\n  private metrics: MetricsCollector;\n  private onUnauthenticated?: (response: Response) => Promise<boolean> | boolean;\n\n  /**\n   * Creates a new HTTP client instance.\n   *\n   * @param opts - Client configuration options\n   * @throws {Error} If no fetch implementation is available\n   */\n  constructor(opts: ClientOptions) {\n    this.fetchImpl = opts.fetch ?? (globalThis.fetch?.bind(globalThis) as FetchLike);\n    if (!this.fetchImpl)\n      throw new Error('No fetch implementation found. Pass one via options.fetch.');\n\n    // Validate baseUrls configuration\n    if (!opts.baseUrls || typeof opts.baseUrls !== 'object') {\n      throw new Error('baseUrls must be provided and must be an object');\n    }\n    if (!opts.baseUrls.default) {\n      throw new Error('baseUrls must include a \"default\" key');\n    }\n\n    this.baseUrls = opts.baseUrls;\n    this.headers = opts.headers ?? { 'Content-Type': 'application/json' };\n    this.interceptors = opts.interceptors ?? {};\n    this.retry = opts.retry ?? {\n      maxRetries: 2,\n      baseDelayMs: 250,\n      jitter: 0.2,\n      retryMethods: ['GET', 'HEAD'],\n    };\n\n    // Default retryStatusCodes if not provided\n    if (!this.retry.retryStatusCodes) {\n      this.retry.retryStatusCodes = (\n        Object.keys(HTTPStatusCode) as (keyof typeof HTTPStatusCode)[]\n      ).filter((key) => {\n        const code = HTTPStatusCode[key];\n        return typeof code === 'number' && code >= 500;\n      });\n    }\n\n    // Validate retry configuration\n    if (this.retry.maxRetries < 0) {\n      throw new Error('retry.maxRetries must be non-negative');\n    }\n    if (this.retry.baseDelayMs < 0) {\n      throw new Error('retry.baseDelayMs must be non-negative');\n    }\n    if (this.retry.jitter !== undefined && (this.retry.jitter < 0 || this.retry.jitter > 1)) {\n      throw new Error('retry.jitter must be between 0 and 1');\n    }\n\n    this.timeoutMs = opts.timeout?.requestTimeoutMs;\n    if (this.timeoutMs !== undefined && this.timeoutMs < 0) {\n      throw new Error('timeout.requestTimeoutMs must be non-negative');\n    }\n\n    this.auth = opts['auth'] ?? new NoAuth();\n    this.logger = new LoggerUtil(opts.logger ?? new NoOpLogger());\n    this.metrics = opts.metrics ?? new NoOpMetricsCollector();\n    this.onUnauthenticated = opts.onUnauthenticated;\n  }\n\n  /**\n   * Set or update the authentication provider.\n   *\n   * @param auth - Authentication provider instance\n   * @example\n   * ```ts\n   * client.setAuth(new BearerTokenAuth(() => getToken()));\n   * ```\n   */\n  setAuth(auth: AuthProvider) {\n    this.auth = auth;\n  }\n\n  private resolveBaseUrl(key?: keyof typeof this.baseUrls) {\n    const k: string = (key as string) || 'default';\n    const url = this.baseUrls[k];\n    if (!url) {\n      const availableKeys = Object.keys(this.baseUrls).join(', ');\n      throw new Error(`Unknown baseUrl key: \"${k}\". Available keys: ${availableKeys}`);\n    }\n    return url.replace(/\\/$/, '');\n  }\n\n  /**\n   * Sleep for a specified duration (used for retry backoff).\n   * @private\n   */\n  private sleep(ms: number) {\n    return new Promise((res) => setTimeout(res, ms));\n  }\n\n  /**\n   * Execute a function with retry logic and exponential backoff.\n   * @private\n   */\n  private async withRetry<T>(\n    fn: () => Promise<T>,\n    canRetry: (ctx: { attempt: number; error?: unknown; response?: Response }) => boolean\n  ): Promise<T> {\n    let attempt = 0;\n    const { maxRetries, baseDelayMs, jitter = 0.2 } = this.retry;\n    while (true) {\n      try {\n        return await fn();\n      } catch (err: unknown) {\n        if (attempt >= maxRetries || !canRetry({ attempt, error: err })) throw err;\n        const backoff = baseDelayMs * 2 ** attempt;\n        const j = 1 + (Math.random() * 2 - 1) * jitter;\n        await this.sleep(backoff * j);\n        attempt++;\n      }\n    }\n  }\n\n  /**\n   * Run all registered before-request hooks.\n   * @private\n   */\n  private async runBeforeHooks(url: string, init: RequestInit & { __urlOverride?: string }) {\n    for (const h of this.interceptors.beforeRequest ?? []) {\n      await h({ url, init });\n    }\n  }\n\n  /**\n   * Run all registered after-response hooks.\n   * @private\n   */\n  private async runAfterHooks(req: Request, res: Response, parsed?: unknown) {\n    for (const h of this.interceptors.afterResponse ?? []) {\n      await h({ request: req, response: res, parsed });\n    }\n  }\n\n  /**\n   * Get all configured base URLs.\n   *\n   * @returns Object mapping base URL keys to their resolved URLs\n   */\n  public getBaseUrls() {\n    return this.baseUrls;\n  }\n\n  /**\n   * Get the resolved base URL for a given key.\n   *\n   * @param key - Base URL key (defaults to 'default' if not provided)\n   * @returns Resolved base URL string\n   */\n  public getBaseUrl(key: string) {\n    return this.resolveBaseUrl(key);\n  }\n\n  /**\n   * Make an HTTP request with automatic retry, authentication, and validation.\n   *\n   * @param method - HTTP method (GET, POST, PUT, etc.)\n   * @param path - Request path (will be appended to base URL)\n   * @param body - Request body (will be JSON.stringify'd if Content-Type is json)\n   * @param options - Additional request options (headers, query params, etc.)\n   * @returns Promise resolving to response data and Response object\n   * @throws {ApiError} If request fails or response validation fails\n   *\n   * @example\n   * ```ts\n   * const { data, response } = await client.request('GET', '/users', undefined, {\n   *   query: { page: 1, limit: 10 },\n   *   headers: { 'X-Custom': 'value' }\n   * });\n   * ```\n   */\n  async request<T = unknown>(\n    method: keyof typeof HTTPMethod,\n    path: string,\n    body?: unknown,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    const startTime = Date.now();\n    const base = this.resolveBaseUrl(options?.baseUrlKey);\n    let url = `${base}${path}${toQueryString(options?.query)}`;\n\n    this.logger.debug('HTTP request initiated', {\n      method,\n      path,\n      baseUrlKey: options?.baseUrlKey,\n      hasBody: body !== undefined,\n    });\n\n    const headers = { ...this.headers, ...(options?.headers ?? {}) };\n\n    const controller = new AbortController();\n    const signal = options?.signal ?? controller.signal;\n    const init: RequestInit & { __urlOverride?: string } = {\n      method,\n      headers,\n      body:\n        body != null\n          ? headers['Content-Type']?.includes('json')\n            ? JSON.stringify(body)\n            : String(body)\n          : undefined,\n      signal,\n    };\n\n    if (!options?.skipAuth) {\n      await this.auth.apply({ url, init, options });\n    }\n    if (init.__urlOverride) url = init.__urlOverride;\n    await this.runBeforeHooks(url, init);\n    // Track refresh attempts to prevent infinite loops\n    let refreshAttempted = false;\n\n    const doFetch = async () => {\n      // Loop for potential token refresh retry\n      while (true) {\n        // Apply timeout if configured\n        let timeoutId: NodeJS.Timeout | number | undefined;\n        if (this.timeoutMs && !options?.signal) {\n          timeoutId = setTimeout(() => {\n            const timeoutError = new Error('Request timeout');\n            timeoutError.name = 'TimeoutError';\n            controller.abort(timeoutError);\n          }, this.timeoutMs);\n        }\n\n        try {\n          // Re-apply auth headers if this is a retry\n          if (refreshAttempted) {\n            const freshInit = { ...init };\n            // We need to re-run apply to get new token\n            await this.auth.apply({ url, init: freshInit, options });\n            // Update headers with potentially new token\n            init.headers = freshInit.headers;\n          }\n\n          const req = new Request(url, init);\n\n          const res = await this.fetchImpl(req);\n\n          if (res.status === 401 && this.onUnauthenticated && !refreshAttempted) {\n            const shouldRetry = await this.onUnauthenticated(res.clone() as unknown as Response);\n            if (shouldRetry) {\n              refreshAttempted = true;\n              // Clear timeout before retrying\n              if (timeoutId) clearTimeout(timeoutId);\n              continue;\n            }\n          }\n\n          const status = res.status as HTTPStatusCodeNumber;\n          const contentType = res.headers.get('content-type') || '';\n          const data = contentType.includes('json') ? await res.json() : await res.text();\n          await this.runAfterHooks(new Request(url, init), res, data);\n\n          const duration = Date.now() - startTime;\n          this.logger.info('HTTP request successful', {\n            method,\n            url,\n            status: res.status,\n            durationMs: duration,\n          });\n\n          this.metrics.collect({\n            method,\n            path,\n            status: res.status,\n            durationMs: duration,\n            timestamp: new Date().toISOString(),\n            success: true,\n          });\n\n          return { data: data as T, status: status };\n        } catch (error) {\n          const duration = Date.now() - startTime;\n          this.logger.error('HTTP request failed', error as Error, {\n            method,\n            url,\n            durationMs: duration,\n          });\n\n          this.metrics.collect({\n            method,\n            path,\n            status: error instanceof ApiError ? error.status : undefined,\n            durationMs: duration,\n            timestamp: new Date().toISOString(),\n            success: false,\n            error: error instanceof Error ? error.message : String(error),\n          });\n\n          throw error;\n        } finally {\n          if (timeoutId) clearTimeout(timeoutId);\n        }\n      }\n    };\n\n    const canRetry = ({ error }: { error?: unknown }) => {\n      // Don't retry timeouts or aborts\n      if (error && typeof error === 'object' && 'name' in error) {\n        const errorName = (error as { name?: string }).name;\n        if (errorName === 'AbortError' || errorName === 'TimeoutError') return false;\n      }\n      // Retry on network errors or configured status codes\n      if (error instanceof ApiError && error.status) {\n        const retryCodes = this.retry.retryStatusCodes;\n        if (retryCodes?.some((codeKey) => HTTPStatusCode[codeKey] === error.status)) {\n          return true;\n        }\n      }\n      return false;\n    };\n\n    if (!this.retry.retryMethods?.includes(method)) {\n      return doFetch();\n    }\n\n    return this.withRetry(doFetch, canRetry);\n  }\n\n  /**\n   * Convenience method for GET requests.\n   *\n   * @example\n   * ```ts\n   * const { data } = await client.get('/users', { query: { page: 1 } });\n   * ```\n   */\n  async get<T = unknown>(\n    path: string,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    return this.request<T>('GET', path, undefined, options);\n  }\n\n  /**\n   * Convenience method for POST requests.\n   *\n   * @example\n   * ```ts\n   * const { data } = await client.post('/users', { name: 'John' });\n   * ```\n   */\n  async post<T = unknown>(\n    path: string,\n    body?: unknown,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    return this.request<T>('POST', path, body, options);\n  }\n\n  /**\n   * Convenience method for PUT requests.\n   *\n   * @example\n   * ```ts\n   * const { data } = await client.put('/users/1', { name: 'John Updated' });\n   * ```\n   */\n  async put<T = unknown>(\n    path: string,\n    body?: unknown,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    return this.request<T>('PUT', path, body, options);\n  }\n\n  /**\n   * Convenience method for PATCH requests.\n   *\n   * @example\n   * ```ts\n   * const { data } = await client.patch('/users/1', { name: 'John' });\n   * ```\n   */\n  async patch<T = unknown>(\n    path: string,\n    body?: unknown,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    return this.request<T>('PATCH', path, body, options);\n  }\n\n  /**\n   * Convenience method for DELETE requests.\n   *\n   * @example\n   * ```ts\n   * const { data } = await client.delete('/users/1');\n   * ```\n   */\n  async delete<T = unknown>(\n    path: string,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    return this.request<T>('DELETE', path, undefined, options);\n  }\n\n  /**\n   * Create a strongly-typed endpoint builder.\n   *\n   * @param config - Endpoint configuration\n   * @returns Endpoint instance\n   */\n  createEndpoint<\n    ResSchema extends z.ZodType | Record<number, z.ZodType>,\n    ReqSchema extends z.ZodType | undefined = undefined,\n    QuerySchema extends z.ZodType | undefined = undefined,\n    PathSchema extends z.ZodType | undefined = undefined,\n  >(\n    config: EndpointConfig<ResSchema, ReqSchema, QuerySchema, PathSchema>\n  ): EndpointCall<ResSchema, ReqSchema, QuerySchema, PathSchema> {\n    const endpoint = new EndpointImpl(this, config);\n    return (params) => endpoint.call(params);\n  }\n}\n","import { z } from 'zod';\n\n/**\n * Common ID type that supports strings, numbers, or UUIDs.\n * Use this for entity identifiers in your schemas.\n *\n * @example\n * ```ts\n * const UserSchema = z.object({ id: Id, name: z.string() });\n * ```\n */\nexport const Id = z.union([\n  z.string().min(1),\n  z.number(),\n  z.uuid({\n    version: 'v4',\n  }),\n]);\nexport type IdType = z.infer<typeof Id>;\n\n/**\n * Common timestamp fields for entities.\n * Use this for database models with creation/update tracking.\n *\n * @example\n * ```ts\n * const UserSchema = z.object({\n *   id: Id,\n *   name: z.string(),\n *   ...Timestamps.shape\n * });\n * ```\n */\nexport const Timestamps = z.object({\n  createdAt: z.iso.datetime(),\n  updatedAt: z.iso.datetime(),\n});\n\n/**\n * Metadata information typically included in API responses.\n * Contains request tracking and debugging information.\n */\nexport const Meta = z.object({\n  timestamp: z.iso.datetime().optional(),\n});\n\n/**\n * Detailed error information for a specific field or path.\n */\nexport const ErrorDetail = z.object({\n  path: z.string().optional(),\n  message: z.string(),\n});\n\n/**\n * Standard API error response schema.\n * Use this for consistent error handling across your API.\n */\nexport const ApiErrorSchema = z.object({\n  code: z.string(),\n  message: z.string(),\n  details: z.array(ErrorDetail).optional(),\n});\n\n/**\n * Generic envelope wrapper for API responses.\n * Provides consistent structure with success flag, data, error, and metadata.\n *\n * @param inner - Zod schema for the response data\n * @returns Envelope schema wrapping the inner schema\n *\n * @example\n * ```ts\n * const UserResponseSchema = Envelope(z.object({ id: Id, name: z.string() }));\n *\n * // Response structure:\n * // {\n * //   success: true,\n * //   data: { id: 1, name: 'John' },\n * //   meta: { timestamp: '...' }\n * // }\n * ```\n */\nexport const Envelope = <T extends z.ZodType, M extends z.ZodType = z.ZodOptional<typeof Meta>>(\n  inner: T,\n  meta?: M\n) => {\n  return z.object({\n    success: z.boolean(),\n    data: inner.optional().nullable(),\n    error: ApiErrorSchema.optional(),\n    meta: (meta !== undefined ? meta : Meta.optional()) as M extends undefined ? z.ZodOptional<typeof Meta> : M,\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["opts: { header?: string; query?: string; value: string }","getToken: () => Promise<string> | string","message: string","options?: { status?: number; cause?: unknown; details?: unknown; zodError?: ZodError }","status: number","q?: RequestOptions['query']","s","schema: z.ZodType","data: unknown","client: HttpClient","config: EndpointConfig<ResSchema, ReqSchema, QuerySchema, PathSchema>","params: EndpointCallParams<ReqSchema, QuerySchema, PathSchema>","pathStr: string","z","minLevel: LogLevel","entry: LogEntry","_entry: LogEntry","logger: Logger","message: string","context?: Record<string, unknown>","error?: Error","_metrics: RequestMetrics","metrics: RequestMetrics","opts: ClientOptions","auth: AuthProvider","key?: keyof typeof this.baseUrls","k: string","ms: number","fn: () => Promise<T>","canRetry: (ctx: { attempt: number; error?: unknown; response?: Response }) => boolean","err: unknown","url: string","init: RequestInit & { __urlOverride?: string }","req: Request","res: Response","parsed?: unknown","key: string","method: keyof typeof HTTPMethod","path: string","body?: unknown","options?: RequestOptions","timeoutId: NodeJS.Timeout | number | undefined","config: EndpointConfig<ResSchema, ReqSchema, QuerySchema, PathSchema>","inner: T","meta?: M"],"sources":["../lib/auth.ts","../lib/types.ts","../lib/validation.ts","../lib/endpoint/base-endpoint.ts","../lib/logger.ts","../lib/metrics.ts","../lib/http/http-client.ts","../lib/schemas/common.ts"],"sourcesContent":["import type { RequestOptions as ReqOpts } from './types';\n\n/**\n * Extended RequestInit with URL override capability for query-based auth.\n */\nexport interface AuthContext {\n  url: string;\n  init: RequestInit & { __urlOverride?: string };\n  options?: ReqOpts;\n}\n\n/**\n * Interface for authentication providers.\n * Implement this to create custom authentication strategies.\n *\n * @example\n * ```ts\n * class CustomAuth implements AuthProvider {\n *   async apply({ init }) {\n *     init.headers = { ...init.headers, 'X-Custom-Auth': 'token' };\n *   }\n * }\n * ```\n */\nexport interface AuthProvider {\n  /**\n   * Apply authentication to the outgoing request.\n   * Called after SDK headers are assembled, but before request is sent.\n   *\n   * @param req - Request context including URL, init, and options\n   */\n  apply(req: AuthContext): Promise<void> | void;\n}\n\n/**\n * No-op authentication provider (no authentication applied).\n * Use this when you don't need authentication.\n */\nexport class NoAuth implements AuthProvider {\n  async apply() {\n    /* no-op */\n  }\n}\n\n/**\n * API Key authentication provider.\n * Supports both header-based and query parameter-based authentication.\n *\n * @example\n * ```ts\n * // Header-based\n * const auth = new ApiKeyAuth({ header: 'X-API-Key', value: 'secret' });\n *\n * // Query parameter-based\n * const auth = new ApiKeyAuth({ query: 'apiKey', value: 'secret' });\n * ```\n */\nexport class ApiKeyAuth implements AuthProvider {\n  constructor(private opts: { header?: string; query?: string; value: string }) {\n    if (!opts.header && !opts.query) {\n      throw new Error('ApiKeyAuth requires either \"header\" or \"query\" option');\n    }\n    if (opts.header && opts.query) {\n      throw new Error('ApiKeyAuth cannot use both \"header\" and \"query\" options');\n    }\n  }\n  apply({ url, init }: AuthContext) {\n    const value = this.opts.value;\n    if (this.opts.header) {\n      if (init.headers instanceof Headers) {\n        init.headers.set(this.opts.header, value);\n      } else if (Array.isArray(init.headers)) {\n        init.headers.push([this.opts.header, value]);\n      } else {\n        init.headers = { ...init.headers, [this.opts.header]: value };\n      }\n    } else if (this.opts.query) {\n      const u = new URL(url);\n      u.searchParams.set(this.opts.query, value);\n      init.__urlOverride = u.toString();\n    }\n  }\n}\n/**\n * Bearer token authentication provider.\n * Supports both static tokens and dynamic token fetching (e.g., for OAuth2 refresh).\n *\n * @example\n * ```ts\n * // Static token\n * const auth = new BearerTokenAuth(() => 'my-token');\n *\n * // Dynamic token with refresh\n * const auth = new BearerTokenAuth(async () => {\n *   return await refreshAccessToken();\n * });\n * ```\n */\nexport class BearerTokenAuth implements AuthProvider {\n  constructor(private getToken: () => Promise<string> | string) {}\n  async apply({ init }: AuthContext) {\n    const token = await this.getToken();\n    if (!token) {\n      throw new Error('BearerTokenAuth: token is empty or undefined');\n    }\n    const authHeader = `Bearer ${token}`;\n    if (init.headers instanceof Headers) {\n      init.headers.set('Authorization', authHeader);\n    } else if (Array.isArray(init.headers)) {\n      init.headers.push(['Authorization', authHeader]);\n    } else {\n      init.headers = { ...init.headers, Authorization: authHeader };\n    }\n  }\n}\n","import { z, ZodError } from 'zod';\nimport { AuthProvider } from './auth';\nimport { Logger } from './logger';\nimport { MetricsCollector } from './metrics';\n\nexport type Dictionary<T> = Record<string, T>;\n\nexport type FetchLike = (input: string | Request | URL, init?: RequestInit) => Promise<Response>;\n\n/**\n * Map of base URLs for different services.\n * The 'default' key is required and used when no specific key is provided.\n *\n * @example\n * ```ts\n * {\n *   default: 'https://api.example.com',\n *   auth: 'https://auth.example.com',\n *   cdn: 'https://cdn.example.com'\n * }\n * ```\n */\nexport type BaseUrlMap = {\n  default: string;\n} & Record<string, string>;\n\n/**\n * Configuration for retry behavior on failed requests.\n * Implements exponential backoff with optional jitter.\n *\n * @example\n * ```ts\n * {\n *   maxRetries: 3,\n *   baseDelayMs: 1000,\n *   jitter: 0.2,\n *   retryMethods: ['GET', 'HEAD', 'PUT']\n * }\n * ```\n */\nexport type RetryStrategy = {\n  /** Maximum number of retry attempts */\n  maxRetries: number;\n  /** Base delay in milliseconds (will be exponentially increased) */\n  baseDelayMs: number;\n  /** Jitter factor 0..1 to randomize delays and prevent thundering herd */\n  jitter?: number;\n  /** HTTP methods eligible for retry */\n  retryMethods?: (keyof typeof HTTPMethod)[];\n  /** HTTP status codes eligible for retry */\n  retryStatusCodes?: (keyof typeof HTTPStatusCode)[];\n  /** Custom function to determine if a request should be retried */\n  shouldRetry?: (ctx: { attempt: number; error?: unknown; response?: Response }) => boolean;\n};\n\nexport const HTTPMethod = {\n  GET: 'GET',\n  POST: 'POST',\n  PUT: 'PUT',\n  PATCH: 'PATCH',\n  DELETE: 'DELETE',\n  HEAD: 'HEAD',\n  OPTIONS: 'OPTIONS',\n} as const;\n\nexport type HttpMethod = keyof typeof HTTPMethod;\n\nexport const HTTPStatusCode = {\n  // 1xx — Informational\n  CONTINUE: 100,\n  SWITCHING_PROTOCOLS: 101,\n  PROCESSING: 102,\n  EARLY_HINTS: 103,\n\n  // 2xx — Success\n  OK: 200,\n  CREATED: 201,\n  ACCEPTED: 202,\n  NON_AUTHORITATIVE_INFORMATION: 203,\n  NO_CONTENT: 204,\n  RESET_CONTENT: 205,\n  PARTIAL_CONTENT: 206,\n  MULTI_STATUS: 207,\n  ALREADY_REPORTED: 208,\n  IM_USED: 226,\n\n  // 3xx — Redirection\n  MULTIPLE_CHOICES: 300,\n  MOVED_PERMANENTLY: 301,\n  FOUND: 302,\n  SEE_OTHER: 303,\n  NOT_MODIFIED: 304,\n  USE_PROXY: 305,\n  TEMPORARY_REDIRECT: 307,\n  PERMANENT_REDIRECT: 308,\n\n  // 4xx — Client Errors\n  BAD_REQUEST: 400,\n  UNAUTHORIZED: 401,\n  PAYMENT_REQUIRED: 402,\n  FORBIDDEN: 403,\n  NOT_FOUND: 404,\n  METHOD_NOT_ALLOWED: 405,\n  NOT_ACCEPTABLE: 406,\n  PROXY_AUTHENTICATION_REQUIRED: 407,\n  REQUEST_TIMEOUT: 408,\n  CONFLICT: 409,\n  GONE: 410,\n  LENGTH_REQUIRED: 411,\n  PRECONDITION_FAILED: 412,\n  PAYLOAD_TOO_LARGE: 413,\n  URI_TOO_LONG: 414,\n  UNSUPPORTED_MEDIA_TYPE: 415,\n  RANGE_NOT_SATISFIABLE: 416,\n  EXPECTATION_FAILED: 417,\n  IM_A_TEAPOT: 418,\n  MISDIRECTED_REQUEST: 421,\n  UNPROCESSABLE_ENTITY: 422,\n  LOCKED: 423,\n  FAILED_DEPENDENCY: 424,\n  TOO_EARLY: 425,\n  UPGRADE_REQUIRED: 426,\n  PRECONDITION_REQUIRED: 428,\n  TOO_MANY_REQUESTS: 429,\n  REQUEST_HEADER_FIELDS_TOO_LARGE: 431,\n  UNAVAILABLE_FOR_LEGAL_REASONS: 451,\n\n  // 5xx — Server Errors\n  INTERNAL_SERVER_ERROR: 500,\n  NOT_IMPLEMENTED: 501,\n  BAD_GATEWAY: 502,\n  SERVICE_UNAVAILABLE: 503,\n  GATEWAY_TIMEOUT: 504,\n  HTTP_VERSION_NOT_SUPPORTED: 505,\n  VARIANT_ALSO_NEGOTIATES: 506,\n  INSUFFICIENT_STORAGE: 507,\n  LOOP_DETECTED: 508,\n  NOT_EXTENDED: 510,\n  NETWORK_AUTHENTICATION_REQUIRED: 511,\n} as const;\n\nexport type HTTPStatusCode = keyof typeof HTTPStatusCode;\nexport type HTTPStatusCodeNumber = (typeof HTTPStatusCode)[HTTPStatusCode];\n\n/**\n * Hook called after a response is received and parsed.\n * Useful for logging, metrics, or global error handling.\n */\nexport type AfterResponseHook = (ctx: {\n  request: Request;\n  response: Response;\n  parsed?: unknown;\n}) => Promise<void> | void;\n\n/**\n * Hook called before a request is sent.\n * Useful for logging, adding headers, or modifying the request.\n */\nexport type BeforeRequestHook = (ctx: { url: string; init: RequestInit }) => Promise<void> | void;\n\nexport interface Interceptors {\n  /** Hooks executed before each request is sent */\n  beforeRequest?: BeforeRequestHook[];\n  /** Hooks executed after each response is received */\n  afterResponse?: AfterResponseHook[];\n}\n\nexport interface TimeoutOptions {\n  /** Request timeout in milliseconds */\n  requestTimeoutMs?: number;\n}\n\n/**\n * Configuration options for the HTTP client.\n *\n * @example\n * ```ts\n * const options: ClientOptions = {\n *   baseUrls: { default: 'https://api.example.com' },\n *   headers: { 'X-API-Version': '1.0' },\n *   retry: { maxRetries: 3, baseDelayMs: 1000 },\n *   timeout: { requestTimeoutMs: 30000 }\n * }\n * ```\n */\nexport interface ClientOptions {\n  /** Map of base URLs for different services */\n  baseUrls: BaseUrlMap;\n  /** Custom fetch implementation (defaults to globalThis.fetch) */\n  fetch?: FetchLike;\n  /** Default headers applied to all requests */\n  headers?: Record<string, string>;\n  /** Retry strategy configuration */\n  retry?: RetryStrategy;\n  /** Request/response interceptors */\n  interceptors?: Interceptors;\n  /** Timeout configuration */\n  timeout?: TimeoutOptions;\n  /** Authentication provider */\n  auth?: AuthProvider;\n  /** Logger instance */\n  logger?: Logger;\n  /** Metrics collector */\n  metrics?: MetricsCollector;\n  /**\n   * Callback to handle 401 Unauthorized responses.\n   * Return true to retry the request (e.g. after refreshing tokens),\n   * or false to return the 401 response as is.\n   */\n  onUnauthenticated?: (response: Response) => Promise<boolean> | boolean;\n}\n\nexport type SafeParseResult<T> = { success: true; data: T } | { success: false; error: ZodError };\n\n/**\n * Custom error class for API-related errors.\n * Includes HTTP status codes, response details, and validation errors.\n *\n * @example\n * ```ts\n * throw new ApiError('Invalid request', {\n *   status: 400,\n *   details: { field: 'email', message: 'Invalid format' }\n * });\n * ```\n */\nexport class ApiError extends Error {\n  public status?: number;\n  public details?: unknown;\n  public zodError?: ZodError;\n\n  constructor(\n    message: string,\n    options?: { status?: number; cause?: unknown; details?: unknown; zodError?: ZodError }\n  ) {\n    super(message);\n    this.name = 'ApiError';\n    this.status = options?.status;\n    this.details = options?.details;\n    this.cause = options?.cause;\n    this.zodError = options?.zodError;\n\n    // Maintains proper stack trace for where error was thrown\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, ApiError);\n    }\n  }\n\n  /**\n   * Check if this is a validation error (has zodError)\n   */\n  isValidationError(): boolean {\n    return !!this.zodError;\n  }\n\n  /**\n   * Check if this is a client error (4xx status)\n   */\n  isClientError(): boolean {\n    return !!this.status && this.status >= 400 && this.status < 500;\n  }\n\n  /**\n   * Check if this is a server error (5xx status)\n   */\n  isServerError(): boolean {\n    return !!this.status && this.status >= 500;\n  }\n\n  /**\n   * Get a formatted error message with all available details\n   */\n  toJSON() {\n    return {\n      name: this.name,\n      message: this.message,\n      status: this.status,\n      details: this.details,\n      zodError: this.zodError?.issues,\n      stack: this.stack,\n    };\n  }\n}\n\n/**\n * Error thrown when an endpoint receives a response with a status code\n * that has no defined schema in the endpoint configuration.\n */\nexport class SchemaDefinitionError extends Error {\n  constructor(public status: number) {\n    super(`No schema defined for status code ${status}`);\n    this.name = 'SchemaDefinitionError';\n\n    // Maintains proper stack trace\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, SchemaDefinitionError);\n    }\n  }\n}\n\nexport type Paginated<T> = {\n  items: T[];\n  total: number;\n  page: number;\n  pageSize: number;\n};\n\n/**\n * Schema for paginated responses\n */\nexport const PaginationSchema = z.object({\n  items: z.array(z.unknown()),\n  total: z.number().int().nonnegative(),\n  page: z.number().int().nonnegative(),\n  pageSize: z.number().int().positive(),\n});\n\n/**\n * Options that can be passed to individual requests to override defaults.\n *\n * @example\n * ```ts\n * await endpoint.call(data, {\n *   baseUrlKey: 'v2',\n *   headers: { 'X-Custom': 'value' },\n *   query: { filter: 'active' }\n * });\n * ```\n */\nexport type RequestOptions = {\n  /** Override base URL for a single call */\n  baseUrlKey?: keyof BaseUrlMap;\n  /** Additional headers for this call only */\n  headers?: Record<string, string>;\n  /** Abort controller signal for cancellation */\n  signal?: AbortSignal;\n  /** Custom query params */\n  query?: URLSearchParams | Record<string, string | number | boolean | undefined>;\n  /** Skip authentication for this request */\n  skipAuth?: boolean;\n};\n\n/**\n * Converts query parameters to a URL query string.\n * Filters out undefined values automatically.\n *\n * @param q - Query parameters as URLSearchParams or object\n * @returns Query string with leading '?' or empty string\n *\n * @example\n * ```ts\n * toQueryString({ page: 1, filter: 'active' }) // \"?page=1&filter=active\"\n * toQueryString({ optional: undefined }) // \"\"\n * ```\n */\nexport function toQueryString(q?: RequestOptions['query']): string {\n  if (!q) return '';\n  if (q instanceof URLSearchParams) {\n    const s = q.toString();\n    return s ? `?${s}` : '';\n  }\n  const params = new URLSearchParams();\n  Object.entries(q).forEach(([k, v]) => {\n    if (v !== undefined) {\n      params.append(k, String(v));\n    }\n  });\n  const s = params.toString();\n  return s ? `?${s}` : '';\n}\n","import { z } from 'zod';\nimport { ApiError, SafeParseResult } from './types';\n\n/**\n * Safely parse data with a Zod schema without throwing.\n * Returns a result object with success status and data or error.\n *\n * @param schema - Zod schema to validate against\n * @param data - Data to validate\n * @returns Result object with success flag and data/error\n *\n * @example\n * ```ts\n * const result = safeParse(UserSchema, userData);\n * if (result.success) {\n *   console.log(result.data);\n * } else {\n *   console.error(result.error);\n * }\n * ```\n */\nexport function safeParse<T>(schema: z.ZodType, data: unknown): SafeParseResult<T> {\n  const res = schema.safeParse(data);\n  if (res.success) return { success: true, data: res.data as T };\n  return { success: false, error: res.error };\n}\n\n/**\n * Parse data with a Zod schema, throwing an ApiError on validation failure.\n * Use this when you want to fail fast on invalid data.\n *\n * @param schema - Zod schema to validate against\n * @param data - Data to validate\n * @returns Validated and typed data\n * @throws {ApiError} If validation fails\n *\n * @example\n * ```ts\n * try {\n *   const user = parseOrThrow(UserSchema, userData);\n *   console.log(user);\n * } catch (error) {\n *   if (error instanceof ApiError && error.zodError) {\n *     console.error('Validation failed:', error.zodError.issues);\n *   }\n * }\n * ```\n */\nexport function parseOrThrow<T>(schema: z.ZodType, data: unknown): T {\n  const res = schema.safeParse(data);\n  if (!res.success) {\n    throw new ApiError('Response validation failed', { zodError: res.error });\n  }\n  return res.data as T;\n}\n","import { z } from 'zod';\nimport { HttpClient } from '../http/http-client';\nimport { HTTPMethod, SchemaDefinitionError } from '../types';\nimport { parseOrThrow } from '../validation';\n\nexport type EndpointConfig<\n  ResSchema extends z.ZodType | Record<number, z.ZodType>,\n  ReqSchema extends z.ZodType | undefined = undefined,\n  QuerySchema extends z.ZodType | undefined = undefined,\n  PathSchema extends z.ZodType | undefined = undefined,\n> = {\n  method: keyof typeof HTTPMethod;\n  path: string | ((params: z.infer<Exclude<PathSchema, undefined>>) => string);\n  response: ResSchema;\n  request?: ReqSchema;\n  query?: QuerySchema;\n  pathParams?: PathSchema;\n  advanced?: {\n    baseUrlKey?: string;\n    skipAuth?: boolean;\n    skipRequestValidation?: boolean;\n    skipResponseValidation?: boolean;\n  };\n  description?: string;\n};\n\nexport type EndpointCallParams<\n  ReqSchema extends z.ZodType | undefined,\n  QuerySchema extends z.ZodType | undefined,\n  PathSchema extends z.ZodType | undefined,\n> = {\n  data?: ReqSchema extends z.ZodType ? z.infer<ReqSchema> : never;\n  query?: QuerySchema extends z.ZodType ? z.infer<QuerySchema> : never;\n  pathParams?: PathSchema extends z.ZodType ? z.infer<PathSchema> : never;\n  headers?: Record<string, string>;\n  signal?: globalThis.AbortSignal;\n};\n\n// Helper to extract the response type from a schema which might be a single ZodType or a status map\ntype InferResponse<S> = S extends z.ZodType\n  ? z.infer<S>\n  : S extends Record<number, z.ZodType>\n  ? z.infer<S[keyof S]>\n  : never;\n\nexport type EndpointCall<\n  ResSchema extends z.ZodType | Record<number, z.ZodType>,\n  ReqSchema extends z.ZodType | undefined,\n  QuerySchema extends z.ZodType | undefined,\n  PathSchema extends z.ZodType | undefined,\n> = (\n  params: EndpointCallParams<ReqSchema, QuerySchema, PathSchema>\n) => Promise<InferResponse<ResSchema>>;\n\nexport class EndpointImpl<\n  ResSchema extends z.ZodType | Record<number, z.ZodType>,\n  ReqSchema extends z.ZodType | undefined,\n  QuerySchema extends z.ZodType | undefined,\n  PathSchema extends z.ZodType | undefined,\n> {\n  constructor(\n    private client: HttpClient,\n    private config: EndpointConfig<ResSchema, ReqSchema, QuerySchema, PathSchema>\n  ) { }\n\n  async call(\n    params: EndpointCallParams<ReqSchema, QuerySchema, PathSchema>\n  ): Promise<InferResponse<ResSchema>> {\n    const { data, query, pathParams, headers, signal } = params;\n\n    const skipRequestValidation = this.config.advanced?.skipRequestValidation ?? false;\n    const skipResponseValidation = this.config.advanced?.skipResponseValidation ?? false;\n\n    // Validate Request Body\n    if (!skipRequestValidation && this.config.request && data !== undefined) {\n      const parsed = this.config.request.safeParse(data);\n      if (!parsed.success) throw parsed.error;\n    }\n\n    // Validate Query Params\n    if (!skipRequestValidation && this.config.query && query !== undefined) {\n      const parsed = this.config.query.safeParse(query);\n      if (!parsed.success) throw parsed.error;\n    }\n\n    // Validate Path Params\n    if (!skipRequestValidation && this.config.pathParams && pathParams !== undefined) {\n      const parsed = this.config.pathParams.safeParse(pathParams);\n      if (!parsed.success) throw parsed.error;\n    }\n\n    // Check for missing required params\n    if (this.config.request && data === undefined) {\n      throw new Error('Missing required request body (data)');\n    }\n    if (this.config.pathParams && pathParams === undefined) {\n      throw new Error('Missing required path parameters (pathParams)');\n    }\n\n    // Resolve Path\n    let pathStr: string;\n    if (typeof this.config.path === 'function') {\n      if (!pathParams) throw new Error('Path function requires pathParams');\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      pathStr = this.config.path(pathParams as any);\n    } else {\n      pathStr = this.config.path;\n    }\n\n    const { data: responseData, status } = await this.client.request(\n      this.config.method,\n      pathStr,\n      data,\n      {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        query: query as any,\n        headers,\n        baseUrlKey: this.config.advanced?.baseUrlKey,\n        skipAuth: this.config.advanced?.skipAuth,\n        signal,\n      }\n    );\n\n    // Handle Response Validation\n    const schema = this.config.response;\n    if (skipResponseValidation) {\n      return responseData as InferResponse<ResSchema>;\n    }\n\n    if (schema instanceof z.ZodType) {\n      // Single schema for all success codes\n      return parseOrThrow(schema, responseData) as InferResponse<ResSchema>;\n    }\n\n    // Map of status codes\n    const specificSchema = (schema as Record<number, z.ZodType>)[status];\n    if (!specificSchema) {\n      // Fallback or error? For now, rigorous error.\n      throw new SchemaDefinitionError(status);\n    }\n\n    return parseOrThrow(specificSchema, responseData) as InferResponse<ResSchema>;\n  }\n}\n","/**\n * Log levels for structured logging.\n */\nexport enum LogLevel {\n  DEBUG = 'debug',\n  INFO = 'info',\n  WARN = 'warn',\n  ERROR = 'error',\n}\n\n/**\n * Structured log entry with metadata.\n */\nexport interface LogEntry {\n  level: LogLevel;\n  message: string;\n  timestamp: string;\n  context?: Record<string, unknown>;\n  error?: Error;\n}\n\n/**\n * Logger interface for custom logger implementations.\n * Implement this to integrate with your logging infrastructure.\n *\n * @example\n * ```ts\n * class ConsoleLogger implements Logger {\n *   log(entry: LogEntry) {\n *     console.log(JSON.stringify(entry));\n *   }\n * }\n * ```\n */\nexport interface Logger {\n  log(entry: LogEntry): void;\n}\n\n/**\n * Default console logger implementation.\n * Formats log entries as JSON for easy parsing.\n */\nexport class ConsoleLogger implements Logger {\n  constructor(private minLevel: LogLevel = LogLevel.INFO) {}\n\n  log(entry: LogEntry): void {\n    const levels = [LogLevel.DEBUG, LogLevel.INFO, LogLevel.WARN, LogLevel.ERROR];\n    const entryLevelIndex = levels.indexOf(entry.level);\n    const minLevelIndex = levels.indexOf(this.minLevel);\n\n    if (entryLevelIndex < minLevelIndex) return;\n\n    const output = {\n      ...entry,\n      error: entry.error\n        ? {\n            message: entry.error.message,\n            stack: entry.error.stack,\n            name: entry.error.name,\n          }\n        : undefined,\n    };\n\n    switch (entry.level) {\n      case LogLevel.DEBUG:\n        console.debug(JSON.stringify(output));\n        break;\n      case LogLevel.INFO:\n        console.info(JSON.stringify(output));\n        break;\n      case LogLevel.WARN:\n        console.warn(JSON.stringify(output));\n        break;\n      case LogLevel.ERROR:\n        console.error(JSON.stringify(output));\n        break;\n    }\n  }\n}\n\n/**\n * No-op logger that discards all log entries.\n * Use this in production if you don't want any logging.\n */\nexport class NoOpLogger implements Logger {\n  log(_entry: LogEntry): void {\n    // no-op\n  }\n}\n\n/**\n * Utility class for creating structured log entries.\n */\nexport class LoggerUtil {\n  constructor(private logger: Logger) {}\n\n  debug(message: string, context?: Record<string, unknown>): void {\n    this.logger.log({\n      level: LogLevel.DEBUG,\n      message,\n      timestamp: new Date().toISOString(),\n      context,\n    });\n  }\n\n  info(message: string, context?: Record<string, unknown>): void {\n    this.logger.log({\n      level: LogLevel.INFO,\n      message,\n      timestamp: new Date().toISOString(),\n      context,\n    });\n  }\n\n  warn(message: string, context?: Record<string, unknown>): void {\n    this.logger.log({\n      level: LogLevel.WARN,\n      message,\n      timestamp: new Date().toISOString(),\n      context,\n    });\n  }\n\n  error(message: string, error?: Error, context?: Record<string, unknown>): void {\n    this.logger.log({\n      level: LogLevel.ERROR,\n      message,\n      timestamp: new Date().toISOString(),\n      context,\n      error,\n    });\n  }\n}\n","/**\n * Metrics data for HTTP requests.\n */\nexport interface RequestMetrics {\n  method: string;\n  path: string;\n  status?: number;\n  durationMs: number;\n  timestamp: string;\n  success: boolean;\n  error?: string;\n}\n\n/**\n * Interface for metrics collectors.\n * Implement this to integrate with your monitoring infrastructure (DataDog, Prometheus, etc.).\n *\n * @example\n * ```ts\n * class DataDogMetrics implements MetricsCollector {\n *   collect(metrics: RequestMetrics) {\n *     dogstatsd.histogram('http.request.duration', metrics.durationMs, {\n *       method: metrics.method,\n *       status: String(metrics.status)\n *     });\n *   }\n * }\n * ```\n */\nexport interface MetricsCollector {\n  collect(metrics: RequestMetrics): void;\n}\n\n/**\n * No-op metrics collector that discards all metrics.\n */\nexport class NoOpMetricsCollector implements MetricsCollector {\n  collect(_metrics: RequestMetrics): void {\n    // no-op\n  }\n}\n\n/**\n * In-memory metrics collector for testing and development.\n * Stores metrics in memory with configurable retention.\n */\nexport class InMemoryMetricsCollector implements MetricsCollector {\n  private metrics: RequestMetrics[] = [];\n  private readonly maxEntries: number;\n\n  constructor(maxEntries = 1000) {\n    this.maxEntries = maxEntries;\n  }\n\n  collect(metrics: RequestMetrics): void {\n    this.metrics.push(metrics);\n    if (this.metrics.length > this.maxEntries) {\n      this.metrics.shift();\n    }\n  }\n\n  /**\n   * Get all collected metrics.\n   */\n  getMetrics(): RequestMetrics[] {\n    return [...this.metrics];\n  }\n\n  /**\n   * Get metrics summary statistics.\n   */\n  getSummary(): {\n    total: number;\n    successful: number;\n    failed: number;\n    avgDurationMs: number;\n    minDurationMs: number;\n    maxDurationMs: number;\n  } {\n    if (this.metrics.length === 0) {\n      return {\n        total: 0,\n        successful: 0,\n        failed: 0,\n        avgDurationMs: 0,\n        minDurationMs: 0,\n        maxDurationMs: 0,\n      };\n    }\n\n    const successful = this.metrics.filter((m) => m.success).length;\n\n    // Calculate stats in a single pass to avoid stack overflow with spread operator\n    let sum = 0;\n    let min = Infinity;\n    let max = -Infinity;\n\n    for (const m of this.metrics) {\n      const d = m.durationMs;\n      sum += d;\n      if (d < min) min = d;\n      if (d > max) max = d;\n    }\n\n    return {\n      total: this.metrics.length,\n      successful,\n      failed: this.metrics.length - successful,\n      avgDurationMs: sum / this.metrics.length,\n      minDurationMs: min === Infinity ? 0 : min,\n      maxDurationMs: max === -Infinity ? 0 : max,\n    };\n  }\n\n  /**\n   * Clear all collected metrics.\n   */\n  clear(): void {\n    this.metrics = [];\n  }\n}\n\n/**\n * Console-based metrics collector for debugging.\n */\nexport class ConsoleMetricsCollector implements MetricsCollector {\n  collect(metrics: RequestMetrics): void {\n    console.log('[METRICS]', JSON.stringify(metrics));\n  }\n}\n","import { z } from 'zod';\nimport type { AuthProvider } from '../auth';\nimport { NoAuth } from '../auth';\nimport { EndpointCall, EndpointConfig, EndpointImpl } from '../endpoint/base-endpoint';\nimport { LoggerUtil, NoOpLogger } from '../logger';\nimport { MetricsCollector, NoOpMetricsCollector } from '../metrics';\nimport {\n  ApiError,\n  ClientOptions,\n  FetchLike,\n  HTTPMethod,\n  HTTPStatusCode,\n  HTTPStatusCodeNumber,\n  Interceptors,\n  RequestOptions,\n  RetryStrategy,\n  toQueryString,\n} from '../types';\n\n/**\n * HTTP client with built-in retry logic, authentication, and interceptors.\n * Supports multiple base URLs, type-safe requests, and comprehensive error handling.\n *\n * @example\n * ```ts\n * const client = new HttpClient({\n *   baseUrls: { default: 'https://api.example.com' },\n *   headers: { 'Content-Type': 'application/json' },\n *   retry: { maxRetries: 3, baseDelayMs: 1000 },\n *   timeout: { requestTimeoutMs: 30000 }\n * });\n *\n * const { data } = await client.request('GET', '/users', undefined, { query: { page: 1 } });\n * ```\n */\nexport class HttpClient {\n  private fetchImpl: FetchLike;\n  private baseUrls: ClientOptions['baseUrls'];\n  private headers: Record<string, string>;\n  private interceptors: Interceptors;\n  private retry: RetryStrategy;\n  private timeoutMs?: number;\n  private auth: AuthProvider;\n  private logger: LoggerUtil;\n  private metrics: MetricsCollector;\n  private onUnauthenticated?: (response: Response) => Promise<boolean> | boolean;\n\n  /**\n   * Creates a new HTTP client instance.\n   *\n   * @param opts - Client configuration options\n   * @throws {Error} If no fetch implementation is available\n   */\n  constructor(opts: ClientOptions) {\n    this.fetchImpl = opts.fetch ?? (globalThis.fetch?.bind(globalThis) as FetchLike);\n    if (!this.fetchImpl)\n      throw new Error('No fetch implementation found. Pass one via options.fetch.');\n\n    // Validate baseUrls configuration\n    if (!opts.baseUrls || typeof opts.baseUrls !== 'object') {\n      throw new Error('baseUrls must be provided and must be an object');\n    }\n    if (!opts.baseUrls.default) {\n      throw new Error('baseUrls must include a \"default\" key');\n    }\n\n    this.baseUrls = opts.baseUrls;\n    this.headers = opts.headers ?? { 'Content-Type': 'application/json' };\n    this.interceptors = opts.interceptors ?? {};\n    this.retry = opts.retry ?? {\n      maxRetries: 2,\n      baseDelayMs: 250,\n      jitter: 0.2,\n      retryMethods: ['GET', 'HEAD'],\n    };\n\n    // Default retryStatusCodes if not provided\n    if (!this.retry.retryStatusCodes) {\n      this.retry.retryStatusCodes = (\n        Object.keys(HTTPStatusCode) as (keyof typeof HTTPStatusCode)[]\n      ).filter((key) => {\n        const code = HTTPStatusCode[key];\n        return typeof code === 'number' && code >= 500;\n      });\n    }\n\n    // Validate retry configuration\n    if (this.retry.maxRetries < 0) {\n      throw new Error('retry.maxRetries must be non-negative');\n    }\n    if (this.retry.baseDelayMs < 0) {\n      throw new Error('retry.baseDelayMs must be non-negative');\n    }\n    if (this.retry.jitter !== undefined && (this.retry.jitter < 0 || this.retry.jitter > 1)) {\n      throw new Error('retry.jitter must be between 0 and 1');\n    }\n\n    this.timeoutMs = opts.timeout?.requestTimeoutMs;\n    if (this.timeoutMs !== undefined && this.timeoutMs < 0) {\n      throw new Error('timeout.requestTimeoutMs must be non-negative');\n    }\n\n    this.auth = opts['auth'] ?? new NoAuth();\n    this.logger = new LoggerUtil(opts.logger ?? new NoOpLogger());\n    this.metrics = opts.metrics ?? new NoOpMetricsCollector();\n    this.onUnauthenticated = opts.onUnauthenticated;\n  }\n\n  /**\n   * Set or update the authentication provider.\n   *\n   * @param auth - Authentication provider instance\n   * @example\n   * ```ts\n   * client.setAuth(new BearerTokenAuth(() => getToken()));\n   * ```\n   */\n  setAuth(auth: AuthProvider) {\n    this.auth = auth;\n  }\n\n  private resolveBaseUrl(key?: keyof typeof this.baseUrls) {\n    const k: string = (key as string) || 'default';\n    const url = this.baseUrls[k];\n    if (!url) {\n      const availableKeys = Object.keys(this.baseUrls).join(', ');\n      throw new Error(`Unknown baseUrl key: \"${k}\". Available keys: ${availableKeys}`);\n    }\n    return url.replace(/\\/$/, '');\n  }\n\n  /**\n   * Sleep for a specified duration (used for retry backoff).\n   * @private\n   */\n  private sleep(ms: number) {\n    return new Promise((res) => setTimeout(res, ms));\n  }\n\n  /**\n   * Execute a function with retry logic and exponential backoff.\n   * @private\n   */\n  private async withRetry<T>(\n    fn: () => Promise<T>,\n    canRetry: (ctx: { attempt: number; error?: unknown; response?: Response }) => boolean\n  ): Promise<T> {\n    let attempt = 0;\n    const { maxRetries, baseDelayMs, jitter = 0.2 } = this.retry;\n    while (true) {\n      try {\n        return await fn();\n      } catch (err: unknown) {\n        if (attempt >= maxRetries || !canRetry({ attempt, error: err })) throw err;\n        const backoff = baseDelayMs * 2 ** attempt;\n        const j = 1 + (Math.random() * 2 - 1) * jitter;\n        await this.sleep(backoff * j);\n        attempt++;\n      }\n    }\n  }\n\n  /**\n   * Run all registered before-request hooks.\n   * @private\n   */\n  private async runBeforeHooks(url: string, init: RequestInit & { __urlOverride?: string }) {\n    for (const h of this.interceptors.beforeRequest ?? []) {\n      await h({ url, init });\n    }\n  }\n\n  /**\n   * Run all registered after-response hooks.\n   * @private\n   */\n  private async runAfterHooks(req: Request, res: Response, parsed?: unknown) {\n    for (const h of this.interceptors.afterResponse ?? []) {\n      await h({ request: req, response: res, parsed });\n    }\n  }\n\n  /**\n   * Get all configured base URLs.\n   *\n   * @returns Object mapping base URL keys to their resolved URLs\n   */\n  public getBaseUrls() {\n    return this.baseUrls;\n  }\n\n  /**\n   * Get the resolved base URL for a given key.\n   *\n   * @param key - Base URL key (defaults to 'default' if not provided)\n   * @returns Resolved base URL string\n   */\n  public getBaseUrl(key: string) {\n    return this.resolveBaseUrl(key);\n  }\n\n  /**\n   * Make an HTTP request with automatic retry, authentication, and validation.\n   *\n   * @param method - HTTP method (GET, POST, PUT, etc.)\n   * @param path - Request path (will be appended to base URL)\n   * @param body - Request body (will be JSON.stringify'd if Content-Type is json)\n   * @param options - Additional request options (headers, query params, etc.)\n   * @returns Promise resolving to response data and Response object\n   * @throws {ApiError} If request fails or response validation fails\n   *\n   * @example\n   * ```ts\n   * const { data, response } = await client.request('GET', '/users', undefined, {\n   *   query: { page: 1, limit: 10 },\n   *   headers: { 'X-Custom': 'value' }\n   * });\n   * ```\n   */\n  async request<T = unknown>(\n    method: keyof typeof HTTPMethod,\n    path: string,\n    body?: unknown,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    const startTime = Date.now();\n    const base = this.resolveBaseUrl(options?.baseUrlKey);\n    let url = `${base}${path}${toQueryString(options?.query)}`;\n\n    this.logger.debug('HTTP request initiated', {\n      method,\n      path,\n      baseUrlKey: options?.baseUrlKey,\n      hasBody: body !== undefined,\n    });\n\n    const headers = { ...this.headers, ...(options?.headers ?? {}) };\n\n    const controller = new AbortController();\n    const signal = options?.signal ?? controller.signal;\n    const init: RequestInit & { __urlOverride?: string } = {\n      method,\n      headers,\n      body:\n        body != null\n          ? headers['Content-Type']?.includes('json')\n            ? JSON.stringify(body)\n            : String(body)\n          : undefined,\n      signal,\n    };\n\n    if (!options?.skipAuth) {\n      await this.auth.apply({ url, init, options });\n    }\n    if (init.__urlOverride) url = init.__urlOverride;\n    await this.runBeforeHooks(url, init);\n    // Track refresh attempts to prevent infinite loops\n    let refreshAttempted = false;\n\n    const doFetch = async () => {\n      // Loop for potential token refresh retry\n      while (true) {\n        // Apply timeout if configured\n        let timeoutId: NodeJS.Timeout | number | undefined;\n        if (this.timeoutMs && !options?.signal) {\n          timeoutId = setTimeout(() => {\n            const timeoutError = new Error('Request timeout');\n            timeoutError.name = 'TimeoutError';\n            controller.abort(timeoutError);\n          }, this.timeoutMs);\n        }\n\n        try {\n          // Re-apply auth headers if this is a retry\n          if (refreshAttempted) {\n            const freshInit = { ...init };\n            // We need to re-run apply to get new token\n            await this.auth.apply({ url, init: freshInit, options });\n            // Update headers with potentially new token\n            init.headers = freshInit.headers;\n          }\n\n          const req = new Request(url, init);\n\n          const res = await this.fetchImpl(req);\n\n          if (res.status === 401 && this.onUnauthenticated && !refreshAttempted) {\n            const shouldRetry = await this.onUnauthenticated(res.clone() as unknown as Response);\n            if (shouldRetry) {\n              refreshAttempted = true;\n              // Clear timeout before retrying\n              if (timeoutId) clearTimeout(timeoutId);\n              continue;\n            }\n          }\n\n          const status = res.status as HTTPStatusCodeNumber;\n          const contentType = res.headers.get('content-type') || '';\n          const data = contentType.includes('json') ? await res.json() : await res.text();\n          await this.runAfterHooks(new Request(url, init), res, data);\n\n          const duration = Date.now() - startTime;\n          this.logger.info('HTTP request successful', {\n            method,\n            url,\n            status: res.status,\n            durationMs: duration,\n          });\n\n          this.metrics.collect({\n            method,\n            path,\n            status: res.status,\n            durationMs: duration,\n            timestamp: new Date().toISOString(),\n            success: true,\n          });\n\n          return { data: data as T, status: status };\n        } catch (error) {\n          const duration = Date.now() - startTime;\n          this.logger.error('HTTP request failed', error as Error, {\n            method,\n            url,\n            durationMs: duration,\n          });\n\n          this.metrics.collect({\n            method,\n            path,\n            status: error instanceof ApiError ? error.status : undefined,\n            durationMs: duration,\n            timestamp: new Date().toISOString(),\n            success: false,\n            error: error instanceof Error ? error.message : String(error),\n          });\n\n          throw error;\n        } finally {\n          if (timeoutId) clearTimeout(timeoutId);\n        }\n      }\n    };\n\n    const canRetry = ({ error }: { error?: unknown }) => {\n      // Don't retry timeouts or aborts\n      if (error && typeof error === 'object' && 'name' in error) {\n        const errorName = (error as { name?: string }).name;\n        if (errorName === 'AbortError' || errorName === 'TimeoutError') return false;\n      }\n      // Retry on network errors or configured status codes\n      if (error instanceof ApiError && error.status) {\n        const retryCodes = this.retry.retryStatusCodes;\n        if (retryCodes?.some((codeKey) => HTTPStatusCode[codeKey] === error.status)) {\n          return true;\n        }\n      }\n      return false;\n    };\n\n    if (!this.retry.retryMethods?.includes(method)) {\n      return doFetch();\n    }\n\n    return this.withRetry(doFetch, canRetry);\n  }\n\n  /**\n   * Convenience method for GET requests.\n   *\n   * @example\n   * ```ts\n   * const { data } = await client.get('/users', { query: { page: 1 } });\n   * ```\n   */\n  async get<T = unknown>(\n    path: string,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    return this.request<T>('GET', path, undefined, options);\n  }\n\n  /**\n   * Convenience method for POST requests.\n   *\n   * @example\n   * ```ts\n   * const { data } = await client.post('/users', { name: 'John' });\n   * ```\n   */\n  async post<T = unknown>(\n    path: string,\n    body?: unknown,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    return this.request<T>('POST', path, body, options);\n  }\n\n  /**\n   * Convenience method for PUT requests.\n   *\n   * @example\n   * ```ts\n   * const { data } = await client.put('/users/1', { name: 'John Updated' });\n   * ```\n   */\n  async put<T = unknown>(\n    path: string,\n    body?: unknown,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    return this.request<T>('PUT', path, body, options);\n  }\n\n  /**\n   * Convenience method for PATCH requests.\n   *\n   * @example\n   * ```ts\n   * const { data } = await client.patch('/users/1', { name: 'John' });\n   * ```\n   */\n  async patch<T = unknown>(\n    path: string,\n    body?: unknown,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    return this.request<T>('PATCH', path, body, options);\n  }\n\n  /**\n   * Convenience method for DELETE requests.\n   *\n   * @example\n   * ```ts\n   * const { data } = await client.delete('/users/1');\n   * ```\n   */\n  async delete<T = unknown>(\n    path: string,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    return this.request<T>('DELETE', path, undefined, options);\n  }\n\n  /**\n   * Create a strongly-typed endpoint builder.\n   *\n   * @param config - Endpoint configuration\n   * @returns Endpoint instance\n   */\n  createEndpoint<\n    ResSchema extends z.ZodType | Record<number, z.ZodType>,\n    ReqSchema extends z.ZodType | undefined = undefined,\n    QuerySchema extends z.ZodType | undefined = undefined,\n    PathSchema extends z.ZodType | undefined = undefined,\n  >(\n    config: EndpointConfig<ResSchema, ReqSchema, QuerySchema, PathSchema>\n  ): EndpointCall<ResSchema, ReqSchema, QuerySchema, PathSchema> {\n    const endpoint = new EndpointImpl(this, config);\n    return (params) => endpoint.call(params);\n  }\n}\n","import { z } from 'zod';\n\n/**\n * Common ID type that supports strings, numbers, or UUIDs.\n * Use this for entity identifiers in your schemas.\n *\n * @example\n * ```ts\n * const UserSchema = z.object({ id: Id, name: z.string() });\n * ```\n */\nexport const Id = z.union([\n  z.string().min(1),\n  z.number(),\n  z.uuid({\n    version: 'v4',\n  }),\n]);\nexport type IdType = z.infer<typeof Id>;\n\n/**\n * Common timestamp fields for entities.\n * Use this for database models with creation/update tracking.\n *\n * @example\n * ```ts\n * const UserSchema = z.object({\n *   id: Id,\n *   name: z.string(),\n *   ...Timestamps.shape\n * });\n * ```\n */\nexport const Timestamps = z.object({\n  createdAt: z.iso.datetime(),\n  updatedAt: z.iso.datetime(),\n});\n\n/**\n * Metadata information typically included in API responses.\n * Contains request tracking and debugging information.\n */\nexport const Meta = z.object({\n  timestamp: z.iso.datetime().optional(),\n});\n\n/**\n * Detailed error information for a specific field or path.\n */\nexport const ErrorDetail = z.object({\n  path: z.string().optional(),\n  message: z.string(),\n});\n\n/**\n * Standard API error response schema.\n * Use this for consistent error handling across your API.\n */\nexport const ApiErrorSchema = z.object({\n  code: z.string(),\n  message: z.string(),\n  details: z.array(ErrorDetail).optional(),\n});\n\n/**\n * Generic envelope wrapper for API responses.\n * Provides consistent structure with success flag, data, error, and metadata.\n *\n * @param inner - Zod schema for the response data\n * @returns Envelope schema wrapping the inner schema\n *\n * @example\n * ```ts\n * const UserResponseSchema = Envelope(z.object({ id: Id, name: z.string() }));\n *\n * // Response structure:\n * // {\n * //   success: true,\n * //   data: { id: 1, name: 'John' },\n * //   meta: { timestamp: '...' }\n * // }\n * ```\n */\nexport const Envelope = <T extends z.ZodType, M extends z.ZodType = z.ZodOptional<typeof Meta>>(\n  inner: T,\n  meta?: M\n) => {\n  return z.object({\n    success: z.boolean(),\n    data: inner.optional().nullable(),\n    error: ApiErrorSchema.optional(),\n    meta: (meta !== undefined ? meta : Meta.optional()) as M extends undefined ? z.ZodOptional<typeof Meta> : M,\n  });\n}\n"],"mappings":"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"}

package/dist/index.js

@@ -292,15 +292,17 @@ var EndpointImpl = class {
 	}
 	async call(params) {
 		const { data, query, pathParams, headers, signal } = params;
-		if (this.config.request && data !== void 0) {
+		const skipRequestValidation = this.config.advanced?.skipRequestValidation ?? false;
+		const skipResponseValidation = this.config.advanced?.skipResponseValidation ?? false;
+		if (!skipRequestValidation && this.config.request && data !== void 0) {
 			const parsed = this.config.request.safeParse(data);
 			if (!parsed.success) throw parsed.error;
 		}
-		if (this.config.query && query !== void 0) {
+		if (!skipRequestValidation && this.config.query && query !== void 0) {
 			const parsed = this.config.query.safeParse(query);
 			if (!parsed.success) throw parsed.error;
 		}
-		if (this.config.pathParams && pathParams !== void 0) {
+		if (!skipRequestValidation && this.config.pathParams && pathParams !== void 0) {
 			const parsed = this.config.pathParams.safeParse(pathParams);
 			if (!parsed.success) throw parsed.error;
 		}
@@ -319,6 +321,7 @@ var EndpointImpl = class {
 			signal
 		});
 		const schema = this.config.response;
+		if (skipResponseValidation) return responseData;
 		if (schema instanceof z.ZodType) return parseOrThrow(schema, responseData);
 		const specificSchema = schema[status];
 		if (!specificSchema) throw new SchemaDefinitionError(status);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["opts: { header?: string; query?: string; value: string }","getToken: () => Promise<string> | string","message: string","options?: { status?: number; cause?: unknown; details?: unknown; zodError?: ZodError }","status: number","q?: RequestOptions['query']","s","schema: z.ZodType","data: unknown","client: HttpClient","config: EndpointConfig<ResSchema, ReqSchema, QuerySchema, PathSchema>","params: EndpointCallParams<ReqSchema, QuerySchema, PathSchema>","pathStr: string","minLevel: LogLevel","entry: LogEntry","_entry: LogEntry","logger: Logger","message: string","context?: Record<string, unknown>","error?: Error","_metrics: RequestMetrics","metrics: RequestMetrics","opts: ClientOptions","auth: AuthProvider","key?: keyof typeof this.baseUrls","k: string","ms: number","fn: () => Promise<T>","canRetry: (ctx: { attempt: number; error?: unknown; response?: Response }) => boolean","err: unknown","url: string","init: RequestInit & { __urlOverride?: string }","req: Request","res: Response","parsed?: unknown","key: string","method: keyof typeof HTTPMethod","path: string","body?: unknown","options?: RequestOptions","timeoutId: NodeJS.Timeout | number | undefined","config: EndpointConfig<ResSchema, ReqSchema, QuerySchema, PathSchema>","inner: T","meta?: M"],"sources":["../lib/auth.ts","../lib/types.ts","../lib/validation.ts","../lib/endpoint/base-endpoint.ts","../lib/logger.ts","../lib/metrics.ts","../lib/http/http-client.ts","../lib/schemas/common.ts"],"sourcesContent":["import type { RequestOptions as ReqOpts } from './types';\n\n/**\n * Extended RequestInit with URL override capability for query-based auth.\n */\nexport interface AuthContext {\n  url: string;\n  init: RequestInit & { __urlOverride?: string };\n  options?: ReqOpts;\n}\n\n/**\n * Interface for authentication providers.\n * Implement this to create custom authentication strategies.\n *\n * @example\n * ```ts\n * class CustomAuth implements AuthProvider {\n *   async apply({ init }) {\n *     init.headers = { ...init.headers, 'X-Custom-Auth': 'token' };\n *   }\n * }\n * ```\n */\nexport interface AuthProvider {\n  /**\n   * Apply authentication to the outgoing request.\n   * Called after SDK headers are assembled, but before request is sent.\n   *\n   * @param req - Request context including URL, init, and options\n   */\n  apply(req: AuthContext): Promise<void> | void;\n}\n\n/**\n * No-op authentication provider (no authentication applied).\n * Use this when you don't need authentication.\n */\nexport class NoAuth implements AuthProvider {\n  async apply() {\n    /* no-op */\n  }\n}\n\n/**\n * API Key authentication provider.\n * Supports both header-based and query parameter-based authentication.\n *\n * @example\n * ```ts\n * // Header-based\n * const auth = new ApiKeyAuth({ header: 'X-API-Key', value: 'secret' });\n *\n * // Query parameter-based\n * const auth = new ApiKeyAuth({ query: 'apiKey', value: 'secret' });\n * ```\n */\nexport class ApiKeyAuth implements AuthProvider {\n  constructor(private opts: { header?: string; query?: string; value: string }) {\n    if (!opts.header && !opts.query) {\n      throw new Error('ApiKeyAuth requires either \"header\" or \"query\" option');\n    }\n    if (opts.header && opts.query) {\n      throw new Error('ApiKeyAuth cannot use both \"header\" and \"query\" options');\n    }\n  }\n  apply({ url, init }: AuthContext) {\n    const value = this.opts.value;\n    if (this.opts.header) {\n      if (init.headers instanceof Headers) {\n        init.headers.set(this.opts.header, value);\n      } else if (Array.isArray(init.headers)) {\n        init.headers.push([this.opts.header, value]);\n      } else {\n        init.headers = { ...init.headers, [this.opts.header]: value };\n      }\n    } else if (this.opts.query) {\n      const u = new URL(url);\n      u.searchParams.set(this.opts.query, value);\n      init.__urlOverride = u.toString();\n    }\n  }\n}\n/**\n * Bearer token authentication provider.\n * Supports both static tokens and dynamic token fetching (e.g., for OAuth2 refresh).\n *\n * @example\n * ```ts\n * // Static token\n * const auth = new BearerTokenAuth(() => 'my-token');\n *\n * // Dynamic token with refresh\n * const auth = new BearerTokenAuth(async () => {\n *   return await refreshAccessToken();\n * });\n * ```\n */\nexport class BearerTokenAuth implements AuthProvider {\n  constructor(private getToken: () => Promise<string> | string) {}\n  async apply({ init }: AuthContext) {\n    const token = await this.getToken();\n    if (!token) {\n      throw new Error('BearerTokenAuth: token is empty or undefined');\n    }\n    const authHeader = `Bearer ${token}`;\n    if (init.headers instanceof Headers) {\n      init.headers.set('Authorization', authHeader);\n    } else if (Array.isArray(init.headers)) {\n      init.headers.push(['Authorization', authHeader]);\n    } else {\n      init.headers = { ...init.headers, Authorization: authHeader };\n    }\n  }\n}\n","import { z, ZodError } from 'zod';\nimport { AuthProvider } from './auth';\nimport { Logger } from './logger';\nimport { MetricsCollector } from './metrics';\n\nexport type Dictionary<T> = Record<string, T>;\n\nexport type FetchLike = (input: string | Request | URL, init?: RequestInit) => Promise<Response>;\n\n/**\n * Map of base URLs for different services.\n * The 'default' key is required and used when no specific key is provided.\n *\n * @example\n * ```ts\n * {\n *   default: 'https://api.example.com',\n *   auth: 'https://auth.example.com',\n *   cdn: 'https://cdn.example.com'\n * }\n * ```\n */\nexport type BaseUrlMap = {\n  default: string;\n} & Record<string, string>;\n\n/**\n * Configuration for retry behavior on failed requests.\n * Implements exponential backoff with optional jitter.\n *\n * @example\n * ```ts\n * {\n *   maxRetries: 3,\n *   baseDelayMs: 1000,\n *   jitter: 0.2,\n *   retryMethods: ['GET', 'HEAD', 'PUT']\n * }\n * ```\n */\nexport type RetryStrategy = {\n  /** Maximum number of retry attempts */\n  maxRetries: number;\n  /** Base delay in milliseconds (will be exponentially increased) */\n  baseDelayMs: number;\n  /** Jitter factor 0..1 to randomize delays and prevent thundering herd */\n  jitter?: number;\n  /** HTTP methods eligible for retry */\n  retryMethods?: (keyof typeof HTTPMethod)[];\n  /** HTTP status codes eligible for retry */\n  retryStatusCodes?: (keyof typeof HTTPStatusCode)[];\n  /** Custom function to determine if a request should be retried */\n  shouldRetry?: (ctx: { attempt: number; error?: unknown; response?: Response }) => boolean;\n};\n\nexport const HTTPMethod = {\n  GET: 'GET',\n  POST: 'POST',\n  PUT: 'PUT',\n  PATCH: 'PATCH',\n  DELETE: 'DELETE',\n  HEAD: 'HEAD',\n  OPTIONS: 'OPTIONS',\n} as const;\n\nexport type HttpMethod = keyof typeof HTTPMethod;\n\nexport const HTTPStatusCode = {\n  // 1xx — Informational\n  CONTINUE: 100,\n  SWITCHING_PROTOCOLS: 101,\n  PROCESSING: 102,\n  EARLY_HINTS: 103,\n\n  // 2xx — Success\n  OK: 200,\n  CREATED: 201,\n  ACCEPTED: 202,\n  NON_AUTHORITATIVE_INFORMATION: 203,\n  NO_CONTENT: 204,\n  RESET_CONTENT: 205,\n  PARTIAL_CONTENT: 206,\n  MULTI_STATUS: 207,\n  ALREADY_REPORTED: 208,\n  IM_USED: 226,\n\n  // 3xx — Redirection\n  MULTIPLE_CHOICES: 300,\n  MOVED_PERMANENTLY: 301,\n  FOUND: 302,\n  SEE_OTHER: 303,\n  NOT_MODIFIED: 304,\n  USE_PROXY: 305,\n  TEMPORARY_REDIRECT: 307,\n  PERMANENT_REDIRECT: 308,\n\n  // 4xx — Client Errors\n  BAD_REQUEST: 400,\n  UNAUTHORIZED: 401,\n  PAYMENT_REQUIRED: 402,\n  FORBIDDEN: 403,\n  NOT_FOUND: 404,\n  METHOD_NOT_ALLOWED: 405,\n  NOT_ACCEPTABLE: 406,\n  PROXY_AUTHENTICATION_REQUIRED: 407,\n  REQUEST_TIMEOUT: 408,\n  CONFLICT: 409,\n  GONE: 410,\n  LENGTH_REQUIRED: 411,\n  PRECONDITION_FAILED: 412,\n  PAYLOAD_TOO_LARGE: 413,\n  URI_TOO_LONG: 414,\n  UNSUPPORTED_MEDIA_TYPE: 415,\n  RANGE_NOT_SATISFIABLE: 416,\n  EXPECTATION_FAILED: 417,\n  IM_A_TEAPOT: 418,\n  MISDIRECTED_REQUEST: 421,\n  UNPROCESSABLE_ENTITY: 422,\n  LOCKED: 423,\n  FAILED_DEPENDENCY: 424,\n  TOO_EARLY: 425,\n  UPGRADE_REQUIRED: 426,\n  PRECONDITION_REQUIRED: 428,\n  TOO_MANY_REQUESTS: 429,\n  REQUEST_HEADER_FIELDS_TOO_LARGE: 431,\n  UNAVAILABLE_FOR_LEGAL_REASONS: 451,\n\n  // 5xx — Server Errors\n  INTERNAL_SERVER_ERROR: 500,\n  NOT_IMPLEMENTED: 501,\n  BAD_GATEWAY: 502,\n  SERVICE_UNAVAILABLE: 503,\n  GATEWAY_TIMEOUT: 504,\n  HTTP_VERSION_NOT_SUPPORTED: 505,\n  VARIANT_ALSO_NEGOTIATES: 506,\n  INSUFFICIENT_STORAGE: 507,\n  LOOP_DETECTED: 508,\n  NOT_EXTENDED: 510,\n  NETWORK_AUTHENTICATION_REQUIRED: 511,\n} as const;\n\nexport type HTTPStatusCode = keyof typeof HTTPStatusCode;\nexport type HTTPStatusCodeNumber = (typeof HTTPStatusCode)[HTTPStatusCode];\n\n/**\n * Hook called after a response is received and parsed.\n * Useful for logging, metrics, or global error handling.\n */\nexport type AfterResponseHook = (ctx: {\n  request: Request;\n  response: Response;\n  parsed?: unknown;\n}) => Promise<void> | void;\n\n/**\n * Hook called before a request is sent.\n * Useful for logging, adding headers, or modifying the request.\n */\nexport type BeforeRequestHook = (ctx: { url: string; init: RequestInit }) => Promise<void> | void;\n\nexport interface Interceptors {\n  /** Hooks executed before each request is sent */\n  beforeRequest?: BeforeRequestHook[];\n  /** Hooks executed after each response is received */\n  afterResponse?: AfterResponseHook[];\n}\n\nexport interface TimeoutOptions {\n  /** Request timeout in milliseconds */\n  requestTimeoutMs?: number;\n}\n\n/**\n * Configuration options for the HTTP client.\n *\n * @example\n * ```ts\n * const options: ClientOptions = {\n *   baseUrls: { default: 'https://api.example.com' },\n *   headers: { 'X-API-Version': '1.0' },\n *   retry: { maxRetries: 3, baseDelayMs: 1000 },\n *   timeout: { requestTimeoutMs: 30000 }\n * }\n * ```\n */\nexport interface ClientOptions {\n  /** Map of base URLs for different services */\n  baseUrls: BaseUrlMap;\n  /** Custom fetch implementation (defaults to globalThis.fetch) */\n  fetch?: FetchLike;\n  /** Default headers applied to all requests */\n  headers?: Record<string, string>;\n  /** Retry strategy configuration */\n  retry?: RetryStrategy;\n  /** Request/response interceptors */\n  interceptors?: Interceptors;\n  /** Timeout configuration */\n  timeout?: TimeoutOptions;\n  /** Authentication provider */\n  auth?: AuthProvider;\n  /** Logger instance */\n  logger?: Logger;\n  /** Metrics collector */\n  metrics?: MetricsCollector;\n  /**\n   * Callback to handle 401 Unauthorized responses.\n   * Return true to retry the request (e.g. after refreshing tokens),\n   * or false to return the 401 response as is.\n   */\n  onUnauthenticated?: (response: Response) => Promise<boolean> | boolean;\n}\n\nexport type SafeParseResult<T> = { success: true; data: T } | { success: false; error: ZodError };\n\n/**\n * Custom error class for API-related errors.\n * Includes HTTP status codes, response details, and validation errors.\n *\n * @example\n * ```ts\n * throw new ApiError('Invalid request', {\n *   status: 400,\n *   details: { field: 'email', message: 'Invalid format' }\n * });\n * ```\n */\nexport class ApiError extends Error {\n  public status?: number;\n  public details?: unknown;\n  public zodError?: ZodError;\n\n  constructor(\n    message: string,\n    options?: { status?: number; cause?: unknown; details?: unknown; zodError?: ZodError }\n  ) {\n    super(message);\n    this.name = 'ApiError';\n    this.status = options?.status;\n    this.details = options?.details;\n    this.cause = options?.cause;\n    this.zodError = options?.zodError;\n\n    // Maintains proper stack trace for where error was thrown\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, ApiError);\n    }\n  }\n\n  /**\n   * Check if this is a validation error (has zodError)\n   */\n  isValidationError(): boolean {\n    return !!this.zodError;\n  }\n\n  /**\n   * Check if this is a client error (4xx status)\n   */\n  isClientError(): boolean {\n    return !!this.status && this.status >= 400 && this.status < 500;\n  }\n\n  /**\n   * Check if this is a server error (5xx status)\n   */\n  isServerError(): boolean {\n    return !!this.status && this.status >= 500;\n  }\n\n  /**\n   * Get a formatted error message with all available details\n   */\n  toJSON() {\n    return {\n      name: this.name,\n      message: this.message,\n      status: this.status,\n      details: this.details,\n      zodError: this.zodError?.issues,\n      stack: this.stack,\n    };\n  }\n}\n\n/**\n * Error thrown when an endpoint receives a response with a status code\n * that has no defined schema in the endpoint configuration.\n */\nexport class SchemaDefinitionError extends Error {\n  constructor(public status: number) {\n    super(`No schema defined for status code ${status}`);\n    this.name = 'SchemaDefinitionError';\n\n    // Maintains proper stack trace\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, SchemaDefinitionError);\n    }\n  }\n}\n\nexport type Paginated<T> = {\n  items: T[];\n  total: number;\n  page: number;\n  pageSize: number;\n};\n\n/**\n * Schema for paginated responses\n */\nexport const PaginationSchema = z.object({\n  items: z.array(z.unknown()),\n  total: z.number().int().nonnegative(),\n  page: z.number().int().nonnegative(),\n  pageSize: z.number().int().positive(),\n});\n\n/**\n * Options that can be passed to individual requests to override defaults.\n *\n * @example\n * ```ts\n * await endpoint.call(data, {\n *   baseUrlKey: 'v2',\n *   headers: { 'X-Custom': 'value' },\n *   query: { filter: 'active' }\n * });\n * ```\n */\nexport type RequestOptions = {\n  /** Override base URL for a single call */\n  baseUrlKey?: keyof BaseUrlMap;\n  /** Additional headers for this call only */\n  headers?: Record<string, string>;\n  /** Abort controller signal for cancellation */\n  signal?: AbortSignal;\n  /** Custom query params */\n  query?: URLSearchParams | Record<string, string | number | boolean | undefined>;\n  /** Skip authentication for this request */\n  skipAuth?: boolean;\n};\n\n/**\n * Converts query parameters to a URL query string.\n * Filters out undefined values automatically.\n *\n * @param q - Query parameters as URLSearchParams or object\n * @returns Query string with leading '?' or empty string\n *\n * @example\n * ```ts\n * toQueryString({ page: 1, filter: 'active' }) // \"?page=1&filter=active\"\n * toQueryString({ optional: undefined }) // \"\"\n * ```\n */\nexport function toQueryString(q?: RequestOptions['query']): string {\n  if (!q) return '';\n  if (q instanceof URLSearchParams) {\n    const s = q.toString();\n    return s ? `?${s}` : '';\n  }\n  const params = new URLSearchParams();\n  Object.entries(q).forEach(([k, v]) => {\n    if (v !== undefined) {\n      params.append(k, String(v));\n    }\n  });\n  const s = params.toString();\n  return s ? `?${s}` : '';\n}\n","import { z } from 'zod';\nimport { ApiError, SafeParseResult } from './types';\n\n/**\n * Safely parse data with a Zod schema without throwing.\n * Returns a result object with success status and data or error.\n *\n * @param schema - Zod schema to validate against\n * @param data - Data to validate\n * @returns Result object with success flag and data/error\n *\n * @example\n * ```ts\n * const result = safeParse(UserSchema, userData);\n * if (result.success) {\n *   console.log(result.data);\n * } else {\n *   console.error(result.error);\n * }\n * ```\n */\nexport function safeParse<T>(schema: z.ZodType, data: unknown): SafeParseResult<T> {\n  const res = schema.safeParse(data);\n  if (res.success) return { success: true, data: res.data as T };\n  return { success: false, error: res.error };\n}\n\n/**\n * Parse data with a Zod schema, throwing an ApiError on validation failure.\n * Use this when you want to fail fast on invalid data.\n *\n * @param schema - Zod schema to validate against\n * @param data - Data to validate\n * @returns Validated and typed data\n * @throws {ApiError} If validation fails\n *\n * @example\n * ```ts\n * try {\n *   const user = parseOrThrow(UserSchema, userData);\n *   console.log(user);\n * } catch (error) {\n *   if (error instanceof ApiError && error.zodError) {\n *     console.error('Validation failed:', error.zodError.issues);\n *   }\n * }\n * ```\n */\nexport function parseOrThrow<T>(schema: z.ZodType, data: unknown): T {\n  const res = schema.safeParse(data);\n  if (!res.success) {\n    throw new ApiError('Response validation failed', { zodError: res.error });\n  }\n  return res.data as T;\n}\n","import { z } from 'zod';\nimport { HttpClient } from '../http/http-client';\nimport { HTTPMethod, SchemaDefinitionError } from '../types';\nimport { parseOrThrow } from '../validation';\n\nexport type EndpointConfig<\n  ResSchema extends z.ZodType | Record<number, z.ZodType>,\n  ReqSchema extends z.ZodType | undefined = undefined,\n  QuerySchema extends z.ZodType | undefined = undefined,\n  PathSchema extends z.ZodType | undefined = undefined,\n> = {\n  method: keyof typeof HTTPMethod;\n  path: string | ((params: z.infer<Exclude<PathSchema, undefined>>) => string);\n  response: ResSchema;\n  request?: ReqSchema;\n  query?: QuerySchema;\n  pathParams?: PathSchema;\n  advanced?: {\n    baseUrlKey?: string;\n    skipAuth?: boolean;\n  };\n  description?: string;\n};\n\nexport type EndpointCallParams<\n  ReqSchema extends z.ZodType | undefined,\n  QuerySchema extends z.ZodType | undefined,\n  PathSchema extends z.ZodType | undefined,\n> = {\n  data?: ReqSchema extends z.ZodType ? z.infer<ReqSchema> : never;\n  query?: QuerySchema extends z.ZodType ? z.infer<QuerySchema> : never;\n  pathParams?: PathSchema extends z.ZodType ? z.infer<PathSchema> : never;\n  headers?: Record<string, string>;\n  signal?: globalThis.AbortSignal;\n};\n\n// Helper to extract the response type from a schema which might be a single ZodType or a status map\ntype InferResponse<S> = S extends z.ZodType\n  ? z.infer<S>\n  : S extends Record<number, z.ZodType>\n  ? z.infer<S[keyof S]>\n  : never;\n\nexport type EndpointCall<\n  ResSchema extends z.ZodType | Record<number, z.ZodType>,\n  ReqSchema extends z.ZodType | undefined,\n  QuerySchema extends z.ZodType | undefined,\n  PathSchema extends z.ZodType | undefined,\n> = (\n  params: EndpointCallParams<ReqSchema, QuerySchema, PathSchema>\n) => Promise<InferResponse<ResSchema>>;\n\nexport class EndpointImpl<\n  ResSchema extends z.ZodType | Record<number, z.ZodType>,\n  ReqSchema extends z.ZodType | undefined,\n  QuerySchema extends z.ZodType | undefined,\n  PathSchema extends z.ZodType | undefined,\n> {\n  constructor(\n    private client: HttpClient,\n    private config: EndpointConfig<ResSchema, ReqSchema, QuerySchema, PathSchema>\n  ) { }\n\n  async call(\n    params: EndpointCallParams<ReqSchema, QuerySchema, PathSchema>\n  ): Promise<InferResponse<ResSchema>> {\n    const { data, query, pathParams, headers, signal } = params;\n\n    // Validate Request Body\n    if (this.config.request && data !== undefined) {\n      const parsed = this.config.request.safeParse(data);\n      if (!parsed.success) throw parsed.error;\n    }\n\n    // Validate Query Params\n    if (this.config.query && query !== undefined) {\n      const parsed = this.config.query.safeParse(query);\n      if (!parsed.success) throw parsed.error;\n    }\n\n    // Validate Path Params\n    if (this.config.pathParams && pathParams !== undefined) {\n      const parsed = this.config.pathParams.safeParse(pathParams);\n      if (!parsed.success) throw parsed.error;\n    }\n\n    // Check for missing required params\n    if (this.config.request && data === undefined) {\n      throw new Error('Missing required request body (data)');\n    }\n    if (this.config.pathParams && pathParams === undefined) {\n      throw new Error('Missing required path parameters (pathParams)');\n    }\n\n    // Resolve Path\n    let pathStr: string;\n    if (typeof this.config.path === 'function') {\n      if (!pathParams) throw new Error('Path function requires pathParams');\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      pathStr = this.config.path(pathParams as any);\n    } else {\n      pathStr = this.config.path;\n    }\n\n    const { data: responseData, status } = await this.client.request(\n      this.config.method,\n      pathStr,\n      data,\n      {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        query: query as any,\n        headers,\n        baseUrlKey: this.config.advanced?.baseUrlKey,\n        skipAuth: this.config.advanced?.skipAuth,\n        signal,\n      }\n    );\n\n    // Handle Response Validation\n    const schema = this.config.response;\n    if (schema instanceof z.ZodType) {\n      // Single schema for all success codes\n      return parseOrThrow(schema, responseData) as InferResponse<ResSchema>;\n    }\n\n    // Map of status codes\n    const specificSchema = (schema as Record<number, z.ZodType>)[status];\n    if (!specificSchema) {\n      // Fallback or error? For now, rigorous error.\n      throw new SchemaDefinitionError(status);\n    }\n\n    return parseOrThrow(specificSchema, responseData) as InferResponse<ResSchema>;\n  }\n}\n","/**\n * Log levels for structured logging.\n */\nexport enum LogLevel {\n  DEBUG = 'debug',\n  INFO = 'info',\n  WARN = 'warn',\n  ERROR = 'error',\n}\n\n/**\n * Structured log entry with metadata.\n */\nexport interface LogEntry {\n  level: LogLevel;\n  message: string;\n  timestamp: string;\n  context?: Record<string, unknown>;\n  error?: Error;\n}\n\n/**\n * Logger interface for custom logger implementations.\n * Implement this to integrate with your logging infrastructure.\n *\n * @example\n * ```ts\n * class ConsoleLogger implements Logger {\n *   log(entry: LogEntry) {\n *     console.log(JSON.stringify(entry));\n *   }\n * }\n * ```\n */\nexport interface Logger {\n  log(entry: LogEntry): void;\n}\n\n/**\n * Default console logger implementation.\n * Formats log entries as JSON for easy parsing.\n */\nexport class ConsoleLogger implements Logger {\n  constructor(private minLevel: LogLevel = LogLevel.INFO) {}\n\n  log(entry: LogEntry): void {\n    const levels = [LogLevel.DEBUG, LogLevel.INFO, LogLevel.WARN, LogLevel.ERROR];\n    const entryLevelIndex = levels.indexOf(entry.level);\n    const minLevelIndex = levels.indexOf(this.minLevel);\n\n    if (entryLevelIndex < minLevelIndex) return;\n\n    const output = {\n      ...entry,\n      error: entry.error\n        ? {\n            message: entry.error.message,\n            stack: entry.error.stack,\n            name: entry.error.name,\n          }\n        : undefined,\n    };\n\n    switch (entry.level) {\n      case LogLevel.DEBUG:\n        console.debug(JSON.stringify(output));\n        break;\n      case LogLevel.INFO:\n        console.info(JSON.stringify(output));\n        break;\n      case LogLevel.WARN:\n        console.warn(JSON.stringify(output));\n        break;\n      case LogLevel.ERROR:\n        console.error(JSON.stringify(output));\n        break;\n    }\n  }\n}\n\n/**\n * No-op logger that discards all log entries.\n * Use this in production if you don't want any logging.\n */\nexport class NoOpLogger implements Logger {\n  log(_entry: LogEntry): void {\n    // no-op\n  }\n}\n\n/**\n * Utility class for creating structured log entries.\n */\nexport class LoggerUtil {\n  constructor(private logger: Logger) {}\n\n  debug(message: string, context?: Record<string, unknown>): void {\n    this.logger.log({\n      level: LogLevel.DEBUG,\n      message,\n      timestamp: new Date().toISOString(),\n      context,\n    });\n  }\n\n  info(message: string, context?: Record<string, unknown>): void {\n    this.logger.log({\n      level: LogLevel.INFO,\n      message,\n      timestamp: new Date().toISOString(),\n      context,\n    });\n  }\n\n  warn(message: string, context?: Record<string, unknown>): void {\n    this.logger.log({\n      level: LogLevel.WARN,\n      message,\n      timestamp: new Date().toISOString(),\n      context,\n    });\n  }\n\n  error(message: string, error?: Error, context?: Record<string, unknown>): void {\n    this.logger.log({\n      level: LogLevel.ERROR,\n      message,\n      timestamp: new Date().toISOString(),\n      context,\n      error,\n    });\n  }\n}\n","/**\n * Metrics data for HTTP requests.\n */\nexport interface RequestMetrics {\n  method: string;\n  path: string;\n  status?: number;\n  durationMs: number;\n  timestamp: string;\n  success: boolean;\n  error?: string;\n}\n\n/**\n * Interface for metrics collectors.\n * Implement this to integrate with your monitoring infrastructure (DataDog, Prometheus, etc.).\n *\n * @example\n * ```ts\n * class DataDogMetrics implements MetricsCollector {\n *   collect(metrics: RequestMetrics) {\n *     dogstatsd.histogram('http.request.duration', metrics.durationMs, {\n *       method: metrics.method,\n *       status: String(metrics.status)\n *     });\n *   }\n * }\n * ```\n */\nexport interface MetricsCollector {\n  collect(metrics: RequestMetrics): void;\n}\n\n/**\n * No-op metrics collector that discards all metrics.\n */\nexport class NoOpMetricsCollector implements MetricsCollector {\n  collect(_metrics: RequestMetrics): void {\n    // no-op\n  }\n}\n\n/**\n * In-memory metrics collector for testing and development.\n * Stores metrics in memory with configurable retention.\n */\nexport class InMemoryMetricsCollector implements MetricsCollector {\n  private metrics: RequestMetrics[] = [];\n  private readonly maxEntries: number;\n\n  constructor(maxEntries = 1000) {\n    this.maxEntries = maxEntries;\n  }\n\n  collect(metrics: RequestMetrics): void {\n    this.metrics.push(metrics);\n    if (this.metrics.length > this.maxEntries) {\n      this.metrics.shift();\n    }\n  }\n\n  /**\n   * Get all collected metrics.\n   */\n  getMetrics(): RequestMetrics[] {\n    return [...this.metrics];\n  }\n\n  /**\n   * Get metrics summary statistics.\n   */\n  getSummary(): {\n    total: number;\n    successful: number;\n    failed: number;\n    avgDurationMs: number;\n    minDurationMs: number;\n    maxDurationMs: number;\n  } {\n    if (this.metrics.length === 0) {\n      return {\n        total: 0,\n        successful: 0,\n        failed: 0,\n        avgDurationMs: 0,\n        minDurationMs: 0,\n        maxDurationMs: 0,\n      };\n    }\n\n    const successful = this.metrics.filter((m) => m.success).length;\n\n    // Calculate stats in a single pass to avoid stack overflow with spread operator\n    let sum = 0;\n    let min = Infinity;\n    let max = -Infinity;\n\n    for (const m of this.metrics) {\n      const d = m.durationMs;\n      sum += d;\n      if (d < min) min = d;\n      if (d > max) max = d;\n    }\n\n    return {\n      total: this.metrics.length,\n      successful,\n      failed: this.metrics.length - successful,\n      avgDurationMs: sum / this.metrics.length,\n      minDurationMs: min === Infinity ? 0 : min,\n      maxDurationMs: max === -Infinity ? 0 : max,\n    };\n  }\n\n  /**\n   * Clear all collected metrics.\n   */\n  clear(): void {\n    this.metrics = [];\n  }\n}\n\n/**\n * Console-based metrics collector for debugging.\n */\nexport class ConsoleMetricsCollector implements MetricsCollector {\n  collect(metrics: RequestMetrics): void {\n    console.log('[METRICS]', JSON.stringify(metrics));\n  }\n}\n","import { z } from 'zod';\nimport type { AuthProvider } from '../auth';\nimport { NoAuth } from '../auth';\nimport { EndpointCall, EndpointConfig, EndpointImpl } from '../endpoint/base-endpoint';\nimport { LoggerUtil, NoOpLogger } from '../logger';\nimport { MetricsCollector, NoOpMetricsCollector } from '../metrics';\nimport {\n  ApiError,\n  ClientOptions,\n  FetchLike,\n  HTTPMethod,\n  HTTPStatusCode,\n  HTTPStatusCodeNumber,\n  Interceptors,\n  RequestOptions,\n  RetryStrategy,\n  toQueryString,\n} from '../types';\n\n/**\n * HTTP client with built-in retry logic, authentication, and interceptors.\n * Supports multiple base URLs, type-safe requests, and comprehensive error handling.\n *\n * @example\n * ```ts\n * const client = new HttpClient({\n *   baseUrls: { default: 'https://api.example.com' },\n *   headers: { 'Content-Type': 'application/json' },\n *   retry: { maxRetries: 3, baseDelayMs: 1000 },\n *   timeout: { requestTimeoutMs: 30000 }\n * });\n *\n * const { data } = await client.request('GET', '/users', undefined, { query: { page: 1 } });\n * ```\n */\nexport class HttpClient {\n  private fetchImpl: FetchLike;\n  private baseUrls: ClientOptions['baseUrls'];\n  private headers: Record<string, string>;\n  private interceptors: Interceptors;\n  private retry: RetryStrategy;\n  private timeoutMs?: number;\n  private auth: AuthProvider;\n  private logger: LoggerUtil;\n  private metrics: MetricsCollector;\n  private onUnauthenticated?: (response: Response) => Promise<boolean> | boolean;\n\n  /**\n   * Creates a new HTTP client instance.\n   *\n   * @param opts - Client configuration options\n   * @throws {Error} If no fetch implementation is available\n   */\n  constructor(opts: ClientOptions) {\n    this.fetchImpl = opts.fetch ?? (globalThis.fetch?.bind(globalThis) as FetchLike);\n    if (!this.fetchImpl)\n      throw new Error('No fetch implementation found. Pass one via options.fetch.');\n\n    // Validate baseUrls configuration\n    if (!opts.baseUrls || typeof opts.baseUrls !== 'object') {\n      throw new Error('baseUrls must be provided and must be an object');\n    }\n    if (!opts.baseUrls.default) {\n      throw new Error('baseUrls must include a \"default\" key');\n    }\n\n    this.baseUrls = opts.baseUrls;\n    this.headers = opts.headers ?? { 'Content-Type': 'application/json' };\n    this.interceptors = opts.interceptors ?? {};\n    this.retry = opts.retry ?? {\n      maxRetries: 2,\n      baseDelayMs: 250,\n      jitter: 0.2,\n      retryMethods: ['GET', 'HEAD'],\n    };\n\n    // Default retryStatusCodes if not provided\n    if (!this.retry.retryStatusCodes) {\n      this.retry.retryStatusCodes = (\n        Object.keys(HTTPStatusCode) as (keyof typeof HTTPStatusCode)[]\n      ).filter((key) => {\n        const code = HTTPStatusCode[key];\n        return typeof code === 'number' && code >= 500;\n      });\n    }\n\n    // Validate retry configuration\n    if (this.retry.maxRetries < 0) {\n      throw new Error('retry.maxRetries must be non-negative');\n    }\n    if (this.retry.baseDelayMs < 0) {\n      throw new Error('retry.baseDelayMs must be non-negative');\n    }\n    if (this.retry.jitter !== undefined && (this.retry.jitter < 0 || this.retry.jitter > 1)) {\n      throw new Error('retry.jitter must be between 0 and 1');\n    }\n\n    this.timeoutMs = opts.timeout?.requestTimeoutMs;\n    if (this.timeoutMs !== undefined && this.timeoutMs < 0) {\n      throw new Error('timeout.requestTimeoutMs must be non-negative');\n    }\n\n    this.auth = opts['auth'] ?? new NoAuth();\n    this.logger = new LoggerUtil(opts.logger ?? new NoOpLogger());\n    this.metrics = opts.metrics ?? new NoOpMetricsCollector();\n    this.onUnauthenticated = opts.onUnauthenticated;\n  }\n\n  /**\n   * Set or update the authentication provider.\n   *\n   * @param auth - Authentication provider instance\n   * @example\n   * ```ts\n   * client.setAuth(new BearerTokenAuth(() => getToken()));\n   * ```\n   */\n  setAuth(auth: AuthProvider) {\n    this.auth = auth;\n  }\n\n  private resolveBaseUrl(key?: keyof typeof this.baseUrls) {\n    const k: string = (key as string) || 'default';\n    const url = this.baseUrls[k];\n    if (!url) {\n      const availableKeys = Object.keys(this.baseUrls).join(', ');\n      throw new Error(`Unknown baseUrl key: \"${k}\". Available keys: ${availableKeys}`);\n    }\n    return url.replace(/\\/$/, '');\n  }\n\n  /**\n   * Sleep for a specified duration (used for retry backoff).\n   * @private\n   */\n  private sleep(ms: number) {\n    return new Promise((res) => setTimeout(res, ms));\n  }\n\n  /**\n   * Execute a function with retry logic and exponential backoff.\n   * @private\n   */\n  private async withRetry<T>(\n    fn: () => Promise<T>,\n    canRetry: (ctx: { attempt: number; error?: unknown; response?: Response }) => boolean\n  ): Promise<T> {\n    let attempt = 0;\n    const { maxRetries, baseDelayMs, jitter = 0.2 } = this.retry;\n    while (true) {\n      try {\n        return await fn();\n      } catch (err: unknown) {\n        if (attempt >= maxRetries || !canRetry({ attempt, error: err })) throw err;\n        const backoff = baseDelayMs * 2 ** attempt;\n        const j = 1 + (Math.random() * 2 - 1) * jitter;\n        await this.sleep(backoff * j);\n        attempt++;\n      }\n    }\n  }\n\n  /**\n   * Run all registered before-request hooks.\n   * @private\n   */\n  private async runBeforeHooks(url: string, init: RequestInit & { __urlOverride?: string }) {\n    for (const h of this.interceptors.beforeRequest ?? []) {\n      await h({ url, init });\n    }\n  }\n\n  /**\n   * Run all registered after-response hooks.\n   * @private\n   */\n  private async runAfterHooks(req: Request, res: Response, parsed?: unknown) {\n    for (const h of this.interceptors.afterResponse ?? []) {\n      await h({ request: req, response: res, parsed });\n    }\n  }\n\n  /**\n   * Get all configured base URLs.\n   *\n   * @returns Object mapping base URL keys to their resolved URLs\n   */\n  public getBaseUrls() {\n    return this.baseUrls;\n  }\n\n  /**\n   * Get the resolved base URL for a given key.\n   *\n   * @param key - Base URL key (defaults to 'default' if not provided)\n   * @returns Resolved base URL string\n   */\n  public getBaseUrl(key: string) {\n    return this.resolveBaseUrl(key);\n  }\n\n  /**\n   * Make an HTTP request with automatic retry, authentication, and validation.\n   *\n   * @param method - HTTP method (GET, POST, PUT, etc.)\n   * @param path - Request path (will be appended to base URL)\n   * @param body - Request body (will be JSON.stringify'd if Content-Type is json)\n   * @param options - Additional request options (headers, query params, etc.)\n   * @returns Promise resolving to response data and Response object\n   * @throws {ApiError} If request fails or response validation fails\n   *\n   * @example\n   * ```ts\n   * const { data, response } = await client.request('GET', '/users', undefined, {\n   *   query: { page: 1, limit: 10 },\n   *   headers: { 'X-Custom': 'value' }\n   * });\n   * ```\n   */\n  async request<T = unknown>(\n    method: keyof typeof HTTPMethod,\n    path: string,\n    body?: unknown,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    const startTime = Date.now();\n    const base = this.resolveBaseUrl(options?.baseUrlKey);\n    let url = `${base}${path}${toQueryString(options?.query)}`;\n\n    this.logger.debug('HTTP request initiated', {\n      method,\n      path,\n      baseUrlKey: options?.baseUrlKey,\n      hasBody: body !== undefined,\n    });\n\n    const headers = { ...this.headers, ...(options?.headers ?? {}) };\n\n    const controller = new AbortController();\n    const signal = options?.signal ?? controller.signal;\n    const init: RequestInit & { __urlOverride?: string } = {\n      method,\n      headers,\n      body:\n        body != null\n          ? headers['Content-Type']?.includes('json')\n            ? JSON.stringify(body)\n            : String(body)\n          : undefined,\n      signal,\n    };\n\n    if (!options?.skipAuth) {\n      await this.auth.apply({ url, init, options });\n    }\n    if (init.__urlOverride) url = init.__urlOverride;\n    await this.runBeforeHooks(url, init);\n    // Track refresh attempts to prevent infinite loops\n    let refreshAttempted = false;\n\n    const doFetch = async () => {\n      // Loop for potential token refresh retry\n      while (true) {\n        // Apply timeout if configured\n        let timeoutId: NodeJS.Timeout | number | undefined;\n        if (this.timeoutMs && !options?.signal) {\n          timeoutId = setTimeout(() => {\n            const timeoutError = new Error('Request timeout');\n            timeoutError.name = 'TimeoutError';\n            controller.abort(timeoutError);\n          }, this.timeoutMs);\n        }\n\n        try {\n          // Re-apply auth headers if this is a retry\n          if (refreshAttempted) {\n            const freshInit = { ...init };\n            // We need to re-run apply to get new token\n            await this.auth.apply({ url, init: freshInit, options });\n            // Update headers with potentially new token\n            init.headers = freshInit.headers;\n          }\n\n          const req = new Request(url, init);\n\n          const res = await this.fetchImpl(req);\n\n          if (res.status === 401 && this.onUnauthenticated && !refreshAttempted) {\n            const shouldRetry = await this.onUnauthenticated(res.clone() as unknown as Response);\n            if (shouldRetry) {\n              refreshAttempted = true;\n              // Clear timeout before retrying\n              if (timeoutId) clearTimeout(timeoutId);\n              continue;\n            }\n          }\n\n          const status = res.status as HTTPStatusCodeNumber;\n          const contentType = res.headers.get('content-type') || '';\n          const data = contentType.includes('json') ? await res.json() : await res.text();\n          await this.runAfterHooks(new Request(url, init), res, data);\n\n          const duration = Date.now() - startTime;\n          this.logger.info('HTTP request successful', {\n            method,\n            url,\n            status: res.status,\n            durationMs: duration,\n          });\n\n          this.metrics.collect({\n            method,\n            path,\n            status: res.status,\n            durationMs: duration,\n            timestamp: new Date().toISOString(),\n            success: true,\n          });\n\n          return { data: data as T, status: status };\n        } catch (error) {\n          const duration = Date.now() - startTime;\n          this.logger.error('HTTP request failed', error as Error, {\n            method,\n            url,\n            durationMs: duration,\n          });\n\n          this.metrics.collect({\n            method,\n            path,\n            status: error instanceof ApiError ? error.status : undefined,\n            durationMs: duration,\n            timestamp: new Date().toISOString(),\n            success: false,\n            error: error instanceof Error ? error.message : String(error),\n          });\n\n          throw error;\n        } finally {\n          if (timeoutId) clearTimeout(timeoutId);\n        }\n      }\n    };\n\n    const canRetry = ({ error }: { error?: unknown }) => {\n      // Don't retry timeouts or aborts\n      if (error && typeof error === 'object' && 'name' in error) {\n        const errorName = (error as { name?: string }).name;\n        if (errorName === 'AbortError' || errorName === 'TimeoutError') return false;\n      }\n      // Retry on network errors or configured status codes\n      if (error instanceof ApiError && error.status) {\n        const retryCodes = this.retry.retryStatusCodes;\n        if (retryCodes?.some((codeKey) => HTTPStatusCode[codeKey] === error.status)) {\n          return true;\n        }\n      }\n      return false;\n    };\n\n    if (!this.retry.retryMethods?.includes(method)) {\n      return doFetch();\n    }\n\n    return this.withRetry(doFetch, canRetry);\n  }\n\n  /**\n   * Convenience method for GET requests.\n   *\n   * @example\n   * ```ts\n   * const { data } = await client.get('/users', { query: { page: 1 } });\n   * ```\n   */\n  async get<T = unknown>(\n    path: string,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    return this.request<T>('GET', path, undefined, options);\n  }\n\n  /**\n   * Convenience method for POST requests.\n   *\n   * @example\n   * ```ts\n   * const { data } = await client.post('/users', { name: 'John' });\n   * ```\n   */\n  async post<T = unknown>(\n    path: string,\n    body?: unknown,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    return this.request<T>('POST', path, body, options);\n  }\n\n  /**\n   * Convenience method for PUT requests.\n   *\n   * @example\n   * ```ts\n   * const { data } = await client.put('/users/1', { name: 'John Updated' });\n   * ```\n   */\n  async put<T = unknown>(\n    path: string,\n    body?: unknown,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    return this.request<T>('PUT', path, body, options);\n  }\n\n  /**\n   * Convenience method for PATCH requests.\n   *\n   * @example\n   * ```ts\n   * const { data } = await client.patch('/users/1', { name: 'John' });\n   * ```\n   */\n  async patch<T = unknown>(\n    path: string,\n    body?: unknown,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    return this.request<T>('PATCH', path, body, options);\n  }\n\n  /**\n   * Convenience method for DELETE requests.\n   *\n   * @example\n   * ```ts\n   * const { data } = await client.delete('/users/1');\n   * ```\n   */\n  async delete<T = unknown>(\n    path: string,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    return this.request<T>('DELETE', path, undefined, options);\n  }\n\n  /**\n   * Create a strongly-typed endpoint builder.\n   *\n   * @param config - Endpoint configuration\n   * @returns Endpoint instance\n   */\n  createEndpoint<\n    ResSchema extends z.ZodType | Record<number, z.ZodType>,\n    ReqSchema extends z.ZodType | undefined = undefined,\n    QuerySchema extends z.ZodType | undefined = undefined,\n    PathSchema extends z.ZodType | undefined = undefined,\n  >(\n    config: EndpointConfig<ResSchema, ReqSchema, QuerySchema, PathSchema>\n  ): EndpointCall<ResSchema, ReqSchema, QuerySchema, PathSchema> {\n    const endpoint = new EndpointImpl(this, config);\n    return (params) => endpoint.call(params);\n  }\n}\n","import { z } from 'zod';\n\n/**\n * Common ID type that supports strings, numbers, or UUIDs.\n * Use this for entity identifiers in your schemas.\n *\n * @example\n * ```ts\n * const UserSchema = z.object({ id: Id, name: z.string() });\n * ```\n */\nexport const Id = z.union([\n  z.string().min(1),\n  z.number(),\n  z.uuid({\n    version: 'v4',\n  }),\n]);\nexport type IdType = z.infer<typeof Id>;\n\n/**\n * Common timestamp fields for entities.\n * Use this for database models with creation/update tracking.\n *\n * @example\n * ```ts\n * const UserSchema = z.object({\n *   id: Id,\n *   name: z.string(),\n *   ...Timestamps.shape\n * });\n * ```\n */\nexport const Timestamps = z.object({\n  createdAt: z.iso.datetime(),\n  updatedAt: z.iso.datetime(),\n});\n\n/**\n * Metadata information typically included in API responses.\n * Contains request tracking and debugging information.\n */\nexport const Meta = z.object({\n  timestamp: z.iso.datetime().optional(),\n});\n\n/**\n * Detailed error information for a specific field or path.\n */\nexport const ErrorDetail = z.object({\n  path: z.string().optional(),\n  message: z.string(),\n});\n\n/**\n * Standard API error response schema.\n * Use this for consistent error handling across your API.\n */\nexport const ApiErrorSchema = z.object({\n  code: z.string(),\n  message: z.string(),\n  details: z.array(ErrorDetail).optional(),\n});\n\n/**\n * Generic envelope wrapper for API responses.\n * Provides consistent structure with success flag, data, error, and metadata.\n *\n * @param inner - Zod schema for the response data\n * @returns Envelope schema wrapping the inner schema\n *\n * @example\n * ```ts\n * const UserResponseSchema = Envelope(z.object({ id: Id, name: z.string() }));\n *\n * // Response structure:\n * // {\n * //   success: true,\n * //   data: { id: 1, name: 'John' },\n * //   meta: { timestamp: '...' }\n * // }\n * ```\n */\nexport const Envelope = <T extends z.ZodType, M extends z.ZodType = z.ZodOptional<typeof Meta>>(\n  inner: T,\n  meta?: M\n) => {\n  return z.object({\n    success: z.boolean(),\n    data: inner.optional().nullable(),\n    error: ApiErrorSchema.optional(),\n    meta: (meta !== undefined ? meta : Meta.optional()) as M extends undefined ? z.ZodOptional<typeof Meta> : M,\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["opts: { header?: string; query?: string; value: string }","getToken: () => Promise<string> | string","message: string","options?: { status?: number; cause?: unknown; details?: unknown; zodError?: ZodError }","status: number","q?: RequestOptions['query']","s","schema: z.ZodType","data: unknown","client: HttpClient","config: EndpointConfig<ResSchema, ReqSchema, QuerySchema, PathSchema>","params: EndpointCallParams<ReqSchema, QuerySchema, PathSchema>","pathStr: string","minLevel: LogLevel","entry: LogEntry","_entry: LogEntry","logger: Logger","message: string","context?: Record<string, unknown>","error?: Error","_metrics: RequestMetrics","metrics: RequestMetrics","opts: ClientOptions","auth: AuthProvider","key?: keyof typeof this.baseUrls","k: string","ms: number","fn: () => Promise<T>","canRetry: (ctx: { attempt: number; error?: unknown; response?: Response }) => boolean","err: unknown","url: string","init: RequestInit & { __urlOverride?: string }","req: Request","res: Response","parsed?: unknown","key: string","method: keyof typeof HTTPMethod","path: string","body?: unknown","options?: RequestOptions","timeoutId: NodeJS.Timeout | number | undefined","config: EndpointConfig<ResSchema, ReqSchema, QuerySchema, PathSchema>","inner: T","meta?: M"],"sources":["../lib/auth.ts","../lib/types.ts","../lib/validation.ts","../lib/endpoint/base-endpoint.ts","../lib/logger.ts","../lib/metrics.ts","../lib/http/http-client.ts","../lib/schemas/common.ts"],"sourcesContent":["import type { RequestOptions as ReqOpts } from './types';\n\n/**\n * Extended RequestInit with URL override capability for query-based auth.\n */\nexport interface AuthContext {\n  url: string;\n  init: RequestInit & { __urlOverride?: string };\n  options?: ReqOpts;\n}\n\n/**\n * Interface for authentication providers.\n * Implement this to create custom authentication strategies.\n *\n * @example\n * ```ts\n * class CustomAuth implements AuthProvider {\n *   async apply({ init }) {\n *     init.headers = { ...init.headers, 'X-Custom-Auth': 'token' };\n *   }\n * }\n * ```\n */\nexport interface AuthProvider {\n  /**\n   * Apply authentication to the outgoing request.\n   * Called after SDK headers are assembled, but before request is sent.\n   *\n   * @param req - Request context including URL, init, and options\n   */\n  apply(req: AuthContext): Promise<void> | void;\n}\n\n/**\n * No-op authentication provider (no authentication applied).\n * Use this when you don't need authentication.\n */\nexport class NoAuth implements AuthProvider {\n  async apply() {\n    /* no-op */\n  }\n}\n\n/**\n * API Key authentication provider.\n * Supports both header-based and query parameter-based authentication.\n *\n * @example\n * ```ts\n * // Header-based\n * const auth = new ApiKeyAuth({ header: 'X-API-Key', value: 'secret' });\n *\n * // Query parameter-based\n * const auth = new ApiKeyAuth({ query: 'apiKey', value: 'secret' });\n * ```\n */\nexport class ApiKeyAuth implements AuthProvider {\n  constructor(private opts: { header?: string; query?: string; value: string }) {\n    if (!opts.header && !opts.query) {\n      throw new Error('ApiKeyAuth requires either \"header\" or \"query\" option');\n    }\n    if (opts.header && opts.query) {\n      throw new Error('ApiKeyAuth cannot use both \"header\" and \"query\" options');\n    }\n  }\n  apply({ url, init }: AuthContext) {\n    const value = this.opts.value;\n    if (this.opts.header) {\n      if (init.headers instanceof Headers) {\n        init.headers.set(this.opts.header, value);\n      } else if (Array.isArray(init.headers)) {\n        init.headers.push([this.opts.header, value]);\n      } else {\n        init.headers = { ...init.headers, [this.opts.header]: value };\n      }\n    } else if (this.opts.query) {\n      const u = new URL(url);\n      u.searchParams.set(this.opts.query, value);\n      init.__urlOverride = u.toString();\n    }\n  }\n}\n/**\n * Bearer token authentication provider.\n * Supports both static tokens and dynamic token fetching (e.g., for OAuth2 refresh).\n *\n * @example\n * ```ts\n * // Static token\n * const auth = new BearerTokenAuth(() => 'my-token');\n *\n * // Dynamic token with refresh\n * const auth = new BearerTokenAuth(async () => {\n *   return await refreshAccessToken();\n * });\n * ```\n */\nexport class BearerTokenAuth implements AuthProvider {\n  constructor(private getToken: () => Promise<string> | string) {}\n  async apply({ init }: AuthContext) {\n    const token = await this.getToken();\n    if (!token) {\n      throw new Error('BearerTokenAuth: token is empty or undefined');\n    }\n    const authHeader = `Bearer ${token}`;\n    if (init.headers instanceof Headers) {\n      init.headers.set('Authorization', authHeader);\n    } else if (Array.isArray(init.headers)) {\n      init.headers.push(['Authorization', authHeader]);\n    } else {\n      init.headers = { ...init.headers, Authorization: authHeader };\n    }\n  }\n}\n","import { z, ZodError } from 'zod';\nimport { AuthProvider } from './auth';\nimport { Logger } from './logger';\nimport { MetricsCollector } from './metrics';\n\nexport type Dictionary<T> = Record<string, T>;\n\nexport type FetchLike = (input: string | Request | URL, init?: RequestInit) => Promise<Response>;\n\n/**\n * Map of base URLs for different services.\n * The 'default' key is required and used when no specific key is provided.\n *\n * @example\n * ```ts\n * {\n *   default: 'https://api.example.com',\n *   auth: 'https://auth.example.com',\n *   cdn: 'https://cdn.example.com'\n * }\n * ```\n */\nexport type BaseUrlMap = {\n  default: string;\n} & Record<string, string>;\n\n/**\n * Configuration for retry behavior on failed requests.\n * Implements exponential backoff with optional jitter.\n *\n * @example\n * ```ts\n * {\n *   maxRetries: 3,\n *   baseDelayMs: 1000,\n *   jitter: 0.2,\n *   retryMethods: ['GET', 'HEAD', 'PUT']\n * }\n * ```\n */\nexport type RetryStrategy = {\n  /** Maximum number of retry attempts */\n  maxRetries: number;\n  /** Base delay in milliseconds (will be exponentially increased) */\n  baseDelayMs: number;\n  /** Jitter factor 0..1 to randomize delays and prevent thundering herd */\n  jitter?: number;\n  /** HTTP methods eligible for retry */\n  retryMethods?: (keyof typeof HTTPMethod)[];\n  /** HTTP status codes eligible for retry */\n  retryStatusCodes?: (keyof typeof HTTPStatusCode)[];\n  /** Custom function to determine if a request should be retried */\n  shouldRetry?: (ctx: { attempt: number; error?: unknown; response?: Response }) => boolean;\n};\n\nexport const HTTPMethod = {\n  GET: 'GET',\n  POST: 'POST',\n  PUT: 'PUT',\n  PATCH: 'PATCH',\n  DELETE: 'DELETE',\n  HEAD: 'HEAD',\n  OPTIONS: 'OPTIONS',\n} as const;\n\nexport type HttpMethod = keyof typeof HTTPMethod;\n\nexport const HTTPStatusCode = {\n  // 1xx — Informational\n  CONTINUE: 100,\n  SWITCHING_PROTOCOLS: 101,\n  PROCESSING: 102,\n  EARLY_HINTS: 103,\n\n  // 2xx — Success\n  OK: 200,\n  CREATED: 201,\n  ACCEPTED: 202,\n  NON_AUTHORITATIVE_INFORMATION: 203,\n  NO_CONTENT: 204,\n  RESET_CONTENT: 205,\n  PARTIAL_CONTENT: 206,\n  MULTI_STATUS: 207,\n  ALREADY_REPORTED: 208,\n  IM_USED: 226,\n\n  // 3xx — Redirection\n  MULTIPLE_CHOICES: 300,\n  MOVED_PERMANENTLY: 301,\n  FOUND: 302,\n  SEE_OTHER: 303,\n  NOT_MODIFIED: 304,\n  USE_PROXY: 305,\n  TEMPORARY_REDIRECT: 307,\n  PERMANENT_REDIRECT: 308,\n\n  // 4xx — Client Errors\n  BAD_REQUEST: 400,\n  UNAUTHORIZED: 401,\n  PAYMENT_REQUIRED: 402,\n  FORBIDDEN: 403,\n  NOT_FOUND: 404,\n  METHOD_NOT_ALLOWED: 405,\n  NOT_ACCEPTABLE: 406,\n  PROXY_AUTHENTICATION_REQUIRED: 407,\n  REQUEST_TIMEOUT: 408,\n  CONFLICT: 409,\n  GONE: 410,\n  LENGTH_REQUIRED: 411,\n  PRECONDITION_FAILED: 412,\n  PAYLOAD_TOO_LARGE: 413,\n  URI_TOO_LONG: 414,\n  UNSUPPORTED_MEDIA_TYPE: 415,\n  RANGE_NOT_SATISFIABLE: 416,\n  EXPECTATION_FAILED: 417,\n  IM_A_TEAPOT: 418,\n  MISDIRECTED_REQUEST: 421,\n  UNPROCESSABLE_ENTITY: 422,\n  LOCKED: 423,\n  FAILED_DEPENDENCY: 424,\n  TOO_EARLY: 425,\n  UPGRADE_REQUIRED: 426,\n  PRECONDITION_REQUIRED: 428,\n  TOO_MANY_REQUESTS: 429,\n  REQUEST_HEADER_FIELDS_TOO_LARGE: 431,\n  UNAVAILABLE_FOR_LEGAL_REASONS: 451,\n\n  // 5xx — Server Errors\n  INTERNAL_SERVER_ERROR: 500,\n  NOT_IMPLEMENTED: 501,\n  BAD_GATEWAY: 502,\n  SERVICE_UNAVAILABLE: 503,\n  GATEWAY_TIMEOUT: 504,\n  HTTP_VERSION_NOT_SUPPORTED: 505,\n  VARIANT_ALSO_NEGOTIATES: 506,\n  INSUFFICIENT_STORAGE: 507,\n  LOOP_DETECTED: 508,\n  NOT_EXTENDED: 510,\n  NETWORK_AUTHENTICATION_REQUIRED: 511,\n} as const;\n\nexport type HTTPStatusCode = keyof typeof HTTPStatusCode;\nexport type HTTPStatusCodeNumber = (typeof HTTPStatusCode)[HTTPStatusCode];\n\n/**\n * Hook called after a response is received and parsed.\n * Useful for logging, metrics, or global error handling.\n */\nexport type AfterResponseHook = (ctx: {\n  request: Request;\n  response: Response;\n  parsed?: unknown;\n}) => Promise<void> | void;\n\n/**\n * Hook called before a request is sent.\n * Useful for logging, adding headers, or modifying the request.\n */\nexport type BeforeRequestHook = (ctx: { url: string; init: RequestInit }) => Promise<void> | void;\n\nexport interface Interceptors {\n  /** Hooks executed before each request is sent */\n  beforeRequest?: BeforeRequestHook[];\n  /** Hooks executed after each response is received */\n  afterResponse?: AfterResponseHook[];\n}\n\nexport interface TimeoutOptions {\n  /** Request timeout in milliseconds */\n  requestTimeoutMs?: number;\n}\n\n/**\n * Configuration options for the HTTP client.\n *\n * @example\n * ```ts\n * const options: ClientOptions = {\n *   baseUrls: { default: 'https://api.example.com' },\n *   headers: { 'X-API-Version': '1.0' },\n *   retry: { maxRetries: 3, baseDelayMs: 1000 },\n *   timeout: { requestTimeoutMs: 30000 }\n * }\n * ```\n */\nexport interface ClientOptions {\n  /** Map of base URLs for different services */\n  baseUrls: BaseUrlMap;\n  /** Custom fetch implementation (defaults to globalThis.fetch) */\n  fetch?: FetchLike;\n  /** Default headers applied to all requests */\n  headers?: Record<string, string>;\n  /** Retry strategy configuration */\n  retry?: RetryStrategy;\n  /** Request/response interceptors */\n  interceptors?: Interceptors;\n  /** Timeout configuration */\n  timeout?: TimeoutOptions;\n  /** Authentication provider */\n  auth?: AuthProvider;\n  /** Logger instance */\n  logger?: Logger;\n  /** Metrics collector */\n  metrics?: MetricsCollector;\n  /**\n   * Callback to handle 401 Unauthorized responses.\n   * Return true to retry the request (e.g. after refreshing tokens),\n   * or false to return the 401 response as is.\n   */\n  onUnauthenticated?: (response: Response) => Promise<boolean> | boolean;\n}\n\nexport type SafeParseResult<T> = { success: true; data: T } | { success: false; error: ZodError };\n\n/**\n * Custom error class for API-related errors.\n * Includes HTTP status codes, response details, and validation errors.\n *\n * @example\n * ```ts\n * throw new ApiError('Invalid request', {\n *   status: 400,\n *   details: { field: 'email', message: 'Invalid format' }\n * });\n * ```\n */\nexport class ApiError extends Error {\n  public status?: number;\n  public details?: unknown;\n  public zodError?: ZodError;\n\n  constructor(\n    message: string,\n    options?: { status?: number; cause?: unknown; details?: unknown; zodError?: ZodError }\n  ) {\n    super(message);\n    this.name = 'ApiError';\n    this.status = options?.status;\n    this.details = options?.details;\n    this.cause = options?.cause;\n    this.zodError = options?.zodError;\n\n    // Maintains proper stack trace for where error was thrown\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, ApiError);\n    }\n  }\n\n  /**\n   * Check if this is a validation error (has zodError)\n   */\n  isValidationError(): boolean {\n    return !!this.zodError;\n  }\n\n  /**\n   * Check if this is a client error (4xx status)\n   */\n  isClientError(): boolean {\n    return !!this.status && this.status >= 400 && this.status < 500;\n  }\n\n  /**\n   * Check if this is a server error (5xx status)\n   */\n  isServerError(): boolean {\n    return !!this.status && this.status >= 500;\n  }\n\n  /**\n   * Get a formatted error message with all available details\n   */\n  toJSON() {\n    return {\n      name: this.name,\n      message: this.message,\n      status: this.status,\n      details: this.details,\n      zodError: this.zodError?.issues,\n      stack: this.stack,\n    };\n  }\n}\n\n/**\n * Error thrown when an endpoint receives a response with a status code\n * that has no defined schema in the endpoint configuration.\n */\nexport class SchemaDefinitionError extends Error {\n  constructor(public status: number) {\n    super(`No schema defined for status code ${status}`);\n    this.name = 'SchemaDefinitionError';\n\n    // Maintains proper stack trace\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, SchemaDefinitionError);\n    }\n  }\n}\n\nexport type Paginated<T> = {\n  items: T[];\n  total: number;\n  page: number;\n  pageSize: number;\n};\n\n/**\n * Schema for paginated responses\n */\nexport const PaginationSchema = z.object({\n  items: z.array(z.unknown()),\n  total: z.number().int().nonnegative(),\n  page: z.number().int().nonnegative(),\n  pageSize: z.number().int().positive(),\n});\n\n/**\n * Options that can be passed to individual requests to override defaults.\n *\n * @example\n * ```ts\n * await endpoint.call(data, {\n *   baseUrlKey: 'v2',\n *   headers: { 'X-Custom': 'value' },\n *   query: { filter: 'active' }\n * });\n * ```\n */\nexport type RequestOptions = {\n  /** Override base URL for a single call */\n  baseUrlKey?: keyof BaseUrlMap;\n  /** Additional headers for this call only */\n  headers?: Record<string, string>;\n  /** Abort controller signal for cancellation */\n  signal?: AbortSignal;\n  /** Custom query params */\n  query?: URLSearchParams | Record<string, string | number | boolean | undefined>;\n  /** Skip authentication for this request */\n  skipAuth?: boolean;\n};\n\n/**\n * Converts query parameters to a URL query string.\n * Filters out undefined values automatically.\n *\n * @param q - Query parameters as URLSearchParams or object\n * @returns Query string with leading '?' or empty string\n *\n * @example\n * ```ts\n * toQueryString({ page: 1, filter: 'active' }) // \"?page=1&filter=active\"\n * toQueryString({ optional: undefined }) // \"\"\n * ```\n */\nexport function toQueryString(q?: RequestOptions['query']): string {\n  if (!q) return '';\n  if (q instanceof URLSearchParams) {\n    const s = q.toString();\n    return s ? `?${s}` : '';\n  }\n  const params = new URLSearchParams();\n  Object.entries(q).forEach(([k, v]) => {\n    if (v !== undefined) {\n      params.append(k, String(v));\n    }\n  });\n  const s = params.toString();\n  return s ? `?${s}` : '';\n}\n","import { z } from 'zod';\nimport { ApiError, SafeParseResult } from './types';\n\n/**\n * Safely parse data with a Zod schema without throwing.\n * Returns a result object with success status and data or error.\n *\n * @param schema - Zod schema to validate against\n * @param data - Data to validate\n * @returns Result object with success flag and data/error\n *\n * @example\n * ```ts\n * const result = safeParse(UserSchema, userData);\n * if (result.success) {\n *   console.log(result.data);\n * } else {\n *   console.error(result.error);\n * }\n * ```\n */\nexport function safeParse<T>(schema: z.ZodType, data: unknown): SafeParseResult<T> {\n  const res = schema.safeParse(data);\n  if (res.success) return { success: true, data: res.data as T };\n  return { success: false, error: res.error };\n}\n\n/**\n * Parse data with a Zod schema, throwing an ApiError on validation failure.\n * Use this when you want to fail fast on invalid data.\n *\n * @param schema - Zod schema to validate against\n * @param data - Data to validate\n * @returns Validated and typed data\n * @throws {ApiError} If validation fails\n *\n * @example\n * ```ts\n * try {\n *   const user = parseOrThrow(UserSchema, userData);\n *   console.log(user);\n * } catch (error) {\n *   if (error instanceof ApiError && error.zodError) {\n *     console.error('Validation failed:', error.zodError.issues);\n *   }\n * }\n * ```\n */\nexport function parseOrThrow<T>(schema: z.ZodType, data: unknown): T {\n  const res = schema.safeParse(data);\n  if (!res.success) {\n    throw new ApiError('Response validation failed', { zodError: res.error });\n  }\n  return res.data as T;\n}\n","import { z } from 'zod';\nimport { HttpClient } from '../http/http-client';\nimport { HTTPMethod, SchemaDefinitionError } from '../types';\nimport { parseOrThrow } from '../validation';\n\nexport type EndpointConfig<\n  ResSchema extends z.ZodType | Record<number, z.ZodType>,\n  ReqSchema extends z.ZodType | undefined = undefined,\n  QuerySchema extends z.ZodType | undefined = undefined,\n  PathSchema extends z.ZodType | undefined = undefined,\n> = {\n  method: keyof typeof HTTPMethod;\n  path: string | ((params: z.infer<Exclude<PathSchema, undefined>>) => string);\n  response: ResSchema;\n  request?: ReqSchema;\n  query?: QuerySchema;\n  pathParams?: PathSchema;\n  advanced?: {\n    baseUrlKey?: string;\n    skipAuth?: boolean;\n    skipRequestValidation?: boolean;\n    skipResponseValidation?: boolean;\n  };\n  description?: string;\n};\n\nexport type EndpointCallParams<\n  ReqSchema extends z.ZodType | undefined,\n  QuerySchema extends z.ZodType | undefined,\n  PathSchema extends z.ZodType | undefined,\n> = {\n  data?: ReqSchema extends z.ZodType ? z.infer<ReqSchema> : never;\n  query?: QuerySchema extends z.ZodType ? z.infer<QuerySchema> : never;\n  pathParams?: PathSchema extends z.ZodType ? z.infer<PathSchema> : never;\n  headers?: Record<string, string>;\n  signal?: globalThis.AbortSignal;\n};\n\n// Helper to extract the response type from a schema which might be a single ZodType or a status map\ntype InferResponse<S> = S extends z.ZodType\n  ? z.infer<S>\n  : S extends Record<number, z.ZodType>\n  ? z.infer<S[keyof S]>\n  : never;\n\nexport type EndpointCall<\n  ResSchema extends z.ZodType | Record<number, z.ZodType>,\n  ReqSchema extends z.ZodType | undefined,\n  QuerySchema extends z.ZodType | undefined,\n  PathSchema extends z.ZodType | undefined,\n> = (\n  params: EndpointCallParams<ReqSchema, QuerySchema, PathSchema>\n) => Promise<InferResponse<ResSchema>>;\n\nexport class EndpointImpl<\n  ResSchema extends z.ZodType | Record<number, z.ZodType>,\n  ReqSchema extends z.ZodType | undefined,\n  QuerySchema extends z.ZodType | undefined,\n  PathSchema extends z.ZodType | undefined,\n> {\n  constructor(\n    private client: HttpClient,\n    private config: EndpointConfig<ResSchema, ReqSchema, QuerySchema, PathSchema>\n  ) { }\n\n  async call(\n    params: EndpointCallParams<ReqSchema, QuerySchema, PathSchema>\n  ): Promise<InferResponse<ResSchema>> {\n    const { data, query, pathParams, headers, signal } = params;\n\n    const skipRequestValidation = this.config.advanced?.skipRequestValidation ?? false;\n    const skipResponseValidation = this.config.advanced?.skipResponseValidation ?? false;\n\n    // Validate Request Body\n    if (!skipRequestValidation && this.config.request && data !== undefined) {\n      const parsed = this.config.request.safeParse(data);\n      if (!parsed.success) throw parsed.error;\n    }\n\n    // Validate Query Params\n    if (!skipRequestValidation && this.config.query && query !== undefined) {\n      const parsed = this.config.query.safeParse(query);\n      if (!parsed.success) throw parsed.error;\n    }\n\n    // Validate Path Params\n    if (!skipRequestValidation && this.config.pathParams && pathParams !== undefined) {\n      const parsed = this.config.pathParams.safeParse(pathParams);\n      if (!parsed.success) throw parsed.error;\n    }\n\n    // Check for missing required params\n    if (this.config.request && data === undefined) {\n      throw new Error('Missing required request body (data)');\n    }\n    if (this.config.pathParams && pathParams === undefined) {\n      throw new Error('Missing required path parameters (pathParams)');\n    }\n\n    // Resolve Path\n    let pathStr: string;\n    if (typeof this.config.path === 'function') {\n      if (!pathParams) throw new Error('Path function requires pathParams');\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      pathStr = this.config.path(pathParams as any);\n    } else {\n      pathStr = this.config.path;\n    }\n\n    const { data: responseData, status } = await this.client.request(\n      this.config.method,\n      pathStr,\n      data,\n      {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        query: query as any,\n        headers,\n        baseUrlKey: this.config.advanced?.baseUrlKey,\n        skipAuth: this.config.advanced?.skipAuth,\n        signal,\n      }\n    );\n\n    // Handle Response Validation\n    const schema = this.config.response;\n    if (skipResponseValidation) {\n      return responseData as InferResponse<ResSchema>;\n    }\n\n    if (schema instanceof z.ZodType) {\n      // Single schema for all success codes\n      return parseOrThrow(schema, responseData) as InferResponse<ResSchema>;\n    }\n\n    // Map of status codes\n    const specificSchema = (schema as Record<number, z.ZodType>)[status];\n    if (!specificSchema) {\n      // Fallback or error? For now, rigorous error.\n      throw new SchemaDefinitionError(status);\n    }\n\n    return parseOrThrow(specificSchema, responseData) as InferResponse<ResSchema>;\n  }\n}\n","/**\n * Log levels for structured logging.\n */\nexport enum LogLevel {\n  DEBUG = 'debug',\n  INFO = 'info',\n  WARN = 'warn',\n  ERROR = 'error',\n}\n\n/**\n * Structured log entry with metadata.\n */\nexport interface LogEntry {\n  level: LogLevel;\n  message: string;\n  timestamp: string;\n  context?: Record<string, unknown>;\n  error?: Error;\n}\n\n/**\n * Logger interface for custom logger implementations.\n * Implement this to integrate with your logging infrastructure.\n *\n * @example\n * ```ts\n * class ConsoleLogger implements Logger {\n *   log(entry: LogEntry) {\n *     console.log(JSON.stringify(entry));\n *   }\n * }\n * ```\n */\nexport interface Logger {\n  log(entry: LogEntry): void;\n}\n\n/**\n * Default console logger implementation.\n * Formats log entries as JSON for easy parsing.\n */\nexport class ConsoleLogger implements Logger {\n  constructor(private minLevel: LogLevel = LogLevel.INFO) {}\n\n  log(entry: LogEntry): void {\n    const levels = [LogLevel.DEBUG, LogLevel.INFO, LogLevel.WARN, LogLevel.ERROR];\n    const entryLevelIndex = levels.indexOf(entry.level);\n    const minLevelIndex = levels.indexOf(this.minLevel);\n\n    if (entryLevelIndex < minLevelIndex) return;\n\n    const output = {\n      ...entry,\n      error: entry.error\n        ? {\n            message: entry.error.message,\n            stack: entry.error.stack,\n            name: entry.error.name,\n          }\n        : undefined,\n    };\n\n    switch (entry.level) {\n      case LogLevel.DEBUG:\n        console.debug(JSON.stringify(output));\n        break;\n      case LogLevel.INFO:\n        console.info(JSON.stringify(output));\n        break;\n      case LogLevel.WARN:\n        console.warn(JSON.stringify(output));\n        break;\n      case LogLevel.ERROR:\n        console.error(JSON.stringify(output));\n        break;\n    }\n  }\n}\n\n/**\n * No-op logger that discards all log entries.\n * Use this in production if you don't want any logging.\n */\nexport class NoOpLogger implements Logger {\n  log(_entry: LogEntry): void {\n    // no-op\n  }\n}\n\n/**\n * Utility class for creating structured log entries.\n */\nexport class LoggerUtil {\n  constructor(private logger: Logger) {}\n\n  debug(message: string, context?: Record<string, unknown>): void {\n    this.logger.log({\n      level: LogLevel.DEBUG,\n      message,\n      timestamp: new Date().toISOString(),\n      context,\n    });\n  }\n\n  info(message: string, context?: Record<string, unknown>): void {\n    this.logger.log({\n      level: LogLevel.INFO,\n      message,\n      timestamp: new Date().toISOString(),\n      context,\n    });\n  }\n\n  warn(message: string, context?: Record<string, unknown>): void {\n    this.logger.log({\n      level: LogLevel.WARN,\n      message,\n      timestamp: new Date().toISOString(),\n      context,\n    });\n  }\n\n  error(message: string, error?: Error, context?: Record<string, unknown>): void {\n    this.logger.log({\n      level: LogLevel.ERROR,\n      message,\n      timestamp: new Date().toISOString(),\n      context,\n      error,\n    });\n  }\n}\n","/**\n * Metrics data for HTTP requests.\n */\nexport interface RequestMetrics {\n  method: string;\n  path: string;\n  status?: number;\n  durationMs: number;\n  timestamp: string;\n  success: boolean;\n  error?: string;\n}\n\n/**\n * Interface for metrics collectors.\n * Implement this to integrate with your monitoring infrastructure (DataDog, Prometheus, etc.).\n *\n * @example\n * ```ts\n * class DataDogMetrics implements MetricsCollector {\n *   collect(metrics: RequestMetrics) {\n *     dogstatsd.histogram('http.request.duration', metrics.durationMs, {\n *       method: metrics.method,\n *       status: String(metrics.status)\n *     });\n *   }\n * }\n * ```\n */\nexport interface MetricsCollector {\n  collect(metrics: RequestMetrics): void;\n}\n\n/**\n * No-op metrics collector that discards all metrics.\n */\nexport class NoOpMetricsCollector implements MetricsCollector {\n  collect(_metrics: RequestMetrics): void {\n    // no-op\n  }\n}\n\n/**\n * In-memory metrics collector for testing and development.\n * Stores metrics in memory with configurable retention.\n */\nexport class InMemoryMetricsCollector implements MetricsCollector {\n  private metrics: RequestMetrics[] = [];\n  private readonly maxEntries: number;\n\n  constructor(maxEntries = 1000) {\n    this.maxEntries = maxEntries;\n  }\n\n  collect(metrics: RequestMetrics): void {\n    this.metrics.push(metrics);\n    if (this.metrics.length > this.maxEntries) {\n      this.metrics.shift();\n    }\n  }\n\n  /**\n   * Get all collected metrics.\n   */\n  getMetrics(): RequestMetrics[] {\n    return [...this.metrics];\n  }\n\n  /**\n   * Get metrics summary statistics.\n   */\n  getSummary(): {\n    total: number;\n    successful: number;\n    failed: number;\n    avgDurationMs: number;\n    minDurationMs: number;\n    maxDurationMs: number;\n  } {\n    if (this.metrics.length === 0) {\n      return {\n        total: 0,\n        successful: 0,\n        failed: 0,\n        avgDurationMs: 0,\n        minDurationMs: 0,\n        maxDurationMs: 0,\n      };\n    }\n\n    const successful = this.metrics.filter((m) => m.success).length;\n\n    // Calculate stats in a single pass to avoid stack overflow with spread operator\n    let sum = 0;\n    let min = Infinity;\n    let max = -Infinity;\n\n    for (const m of this.metrics) {\n      const d = m.durationMs;\n      sum += d;\n      if (d < min) min = d;\n      if (d > max) max = d;\n    }\n\n    return {\n      total: this.metrics.length,\n      successful,\n      failed: this.metrics.length - successful,\n      avgDurationMs: sum / this.metrics.length,\n      minDurationMs: min === Infinity ? 0 : min,\n      maxDurationMs: max === -Infinity ? 0 : max,\n    };\n  }\n\n  /**\n   * Clear all collected metrics.\n   */\n  clear(): void {\n    this.metrics = [];\n  }\n}\n\n/**\n * Console-based metrics collector for debugging.\n */\nexport class ConsoleMetricsCollector implements MetricsCollector {\n  collect(metrics: RequestMetrics): void {\n    console.log('[METRICS]', JSON.stringify(metrics));\n  }\n}\n","import { z } from 'zod';\nimport type { AuthProvider } from '../auth';\nimport { NoAuth } from '../auth';\nimport { EndpointCall, EndpointConfig, EndpointImpl } from '../endpoint/base-endpoint';\nimport { LoggerUtil, NoOpLogger } from '../logger';\nimport { MetricsCollector, NoOpMetricsCollector } from '../metrics';\nimport {\n  ApiError,\n  ClientOptions,\n  FetchLike,\n  HTTPMethod,\n  HTTPStatusCode,\n  HTTPStatusCodeNumber,\n  Interceptors,\n  RequestOptions,\n  RetryStrategy,\n  toQueryString,\n} from '../types';\n\n/**\n * HTTP client with built-in retry logic, authentication, and interceptors.\n * Supports multiple base URLs, type-safe requests, and comprehensive error handling.\n *\n * @example\n * ```ts\n * const client = new HttpClient({\n *   baseUrls: { default: 'https://api.example.com' },\n *   headers: { 'Content-Type': 'application/json' },\n *   retry: { maxRetries: 3, baseDelayMs: 1000 },\n *   timeout: { requestTimeoutMs: 30000 }\n * });\n *\n * const { data } = await client.request('GET', '/users', undefined, { query: { page: 1 } });\n * ```\n */\nexport class HttpClient {\n  private fetchImpl: FetchLike;\n  private baseUrls: ClientOptions['baseUrls'];\n  private headers: Record<string, string>;\n  private interceptors: Interceptors;\n  private retry: RetryStrategy;\n  private timeoutMs?: number;\n  private auth: AuthProvider;\n  private logger: LoggerUtil;\n  private metrics: MetricsCollector;\n  private onUnauthenticated?: (response: Response) => Promise<boolean> | boolean;\n\n  /**\n   * Creates a new HTTP client instance.\n   *\n   * @param opts - Client configuration options\n   * @throws {Error} If no fetch implementation is available\n   */\n  constructor(opts: ClientOptions) {\n    this.fetchImpl = opts.fetch ?? (globalThis.fetch?.bind(globalThis) as FetchLike);\n    if (!this.fetchImpl)\n      throw new Error('No fetch implementation found. Pass one via options.fetch.');\n\n    // Validate baseUrls configuration\n    if (!opts.baseUrls || typeof opts.baseUrls !== 'object') {\n      throw new Error('baseUrls must be provided and must be an object');\n    }\n    if (!opts.baseUrls.default) {\n      throw new Error('baseUrls must include a \"default\" key');\n    }\n\n    this.baseUrls = opts.baseUrls;\n    this.headers = opts.headers ?? { 'Content-Type': 'application/json' };\n    this.interceptors = opts.interceptors ?? {};\n    this.retry = opts.retry ?? {\n      maxRetries: 2,\n      baseDelayMs: 250,\n      jitter: 0.2,\n      retryMethods: ['GET', 'HEAD'],\n    };\n\n    // Default retryStatusCodes if not provided\n    if (!this.retry.retryStatusCodes) {\n      this.retry.retryStatusCodes = (\n        Object.keys(HTTPStatusCode) as (keyof typeof HTTPStatusCode)[]\n      ).filter((key) => {\n        const code = HTTPStatusCode[key];\n        return typeof code === 'number' && code >= 500;\n      });\n    }\n\n    // Validate retry configuration\n    if (this.retry.maxRetries < 0) {\n      throw new Error('retry.maxRetries must be non-negative');\n    }\n    if (this.retry.baseDelayMs < 0) {\n      throw new Error('retry.baseDelayMs must be non-negative');\n    }\n    if (this.retry.jitter !== undefined && (this.retry.jitter < 0 || this.retry.jitter > 1)) {\n      throw new Error('retry.jitter must be between 0 and 1');\n    }\n\n    this.timeoutMs = opts.timeout?.requestTimeoutMs;\n    if (this.timeoutMs !== undefined && this.timeoutMs < 0) {\n      throw new Error('timeout.requestTimeoutMs must be non-negative');\n    }\n\n    this.auth = opts['auth'] ?? new NoAuth();\n    this.logger = new LoggerUtil(opts.logger ?? new NoOpLogger());\n    this.metrics = opts.metrics ?? new NoOpMetricsCollector();\n    this.onUnauthenticated = opts.onUnauthenticated;\n  }\n\n  /**\n   * Set or update the authentication provider.\n   *\n   * @param auth - Authentication provider instance\n   * @example\n   * ```ts\n   * client.setAuth(new BearerTokenAuth(() => getToken()));\n   * ```\n   */\n  setAuth(auth: AuthProvider) {\n    this.auth = auth;\n  }\n\n  private resolveBaseUrl(key?: keyof typeof this.baseUrls) {\n    const k: string = (key as string) || 'default';\n    const url = this.baseUrls[k];\n    if (!url) {\n      const availableKeys = Object.keys(this.baseUrls).join(', ');\n      throw new Error(`Unknown baseUrl key: \"${k}\". Available keys: ${availableKeys}`);\n    }\n    return url.replace(/\\/$/, '');\n  }\n\n  /**\n   * Sleep for a specified duration (used for retry backoff).\n   * @private\n   */\n  private sleep(ms: number) {\n    return new Promise((res) => setTimeout(res, ms));\n  }\n\n  /**\n   * Execute a function with retry logic and exponential backoff.\n   * @private\n   */\n  private async withRetry<T>(\n    fn: () => Promise<T>,\n    canRetry: (ctx: { attempt: number; error?: unknown; response?: Response }) => boolean\n  ): Promise<T> {\n    let attempt = 0;\n    const { maxRetries, baseDelayMs, jitter = 0.2 } = this.retry;\n    while (true) {\n      try {\n        return await fn();\n      } catch (err: unknown) {\n        if (attempt >= maxRetries || !canRetry({ attempt, error: err })) throw err;\n        const backoff = baseDelayMs * 2 ** attempt;\n        const j = 1 + (Math.random() * 2 - 1) * jitter;\n        await this.sleep(backoff * j);\n        attempt++;\n      }\n    }\n  }\n\n  /**\n   * Run all registered before-request hooks.\n   * @private\n   */\n  private async runBeforeHooks(url: string, init: RequestInit & { __urlOverride?: string }) {\n    for (const h of this.interceptors.beforeRequest ?? []) {\n      await h({ url, init });\n    }\n  }\n\n  /**\n   * Run all registered after-response hooks.\n   * @private\n   */\n  private async runAfterHooks(req: Request, res: Response, parsed?: unknown) {\n    for (const h of this.interceptors.afterResponse ?? []) {\n      await h({ request: req, response: res, parsed });\n    }\n  }\n\n  /**\n   * Get all configured base URLs.\n   *\n   * @returns Object mapping base URL keys to their resolved URLs\n   */\n  public getBaseUrls() {\n    return this.baseUrls;\n  }\n\n  /**\n   * Get the resolved base URL for a given key.\n   *\n   * @param key - Base URL key (defaults to 'default' if not provided)\n   * @returns Resolved base URL string\n   */\n  public getBaseUrl(key: string) {\n    return this.resolveBaseUrl(key);\n  }\n\n  /**\n   * Make an HTTP request with automatic retry, authentication, and validation.\n   *\n   * @param method - HTTP method (GET, POST, PUT, etc.)\n   * @param path - Request path (will be appended to base URL)\n   * @param body - Request body (will be JSON.stringify'd if Content-Type is json)\n   * @param options - Additional request options (headers, query params, etc.)\n   * @returns Promise resolving to response data and Response object\n   * @throws {ApiError} If request fails or response validation fails\n   *\n   * @example\n   * ```ts\n   * const { data, response } = await client.request('GET', '/users', undefined, {\n   *   query: { page: 1, limit: 10 },\n   *   headers: { 'X-Custom': 'value' }\n   * });\n   * ```\n   */\n  async request<T = unknown>(\n    method: keyof typeof HTTPMethod,\n    path: string,\n    body?: unknown,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    const startTime = Date.now();\n    const base = this.resolveBaseUrl(options?.baseUrlKey);\n    let url = `${base}${path}${toQueryString(options?.query)}`;\n\n    this.logger.debug('HTTP request initiated', {\n      method,\n      path,\n      baseUrlKey: options?.baseUrlKey,\n      hasBody: body !== undefined,\n    });\n\n    const headers = { ...this.headers, ...(options?.headers ?? {}) };\n\n    const controller = new AbortController();\n    const signal = options?.signal ?? controller.signal;\n    const init: RequestInit & { __urlOverride?: string } = {\n      method,\n      headers,\n      body:\n        body != null\n          ? headers['Content-Type']?.includes('json')\n            ? JSON.stringify(body)\n            : String(body)\n          : undefined,\n      signal,\n    };\n\n    if (!options?.skipAuth) {\n      await this.auth.apply({ url, init, options });\n    }\n    if (init.__urlOverride) url = init.__urlOverride;\n    await this.runBeforeHooks(url, init);\n    // Track refresh attempts to prevent infinite loops\n    let refreshAttempted = false;\n\n    const doFetch = async () => {\n      // Loop for potential token refresh retry\n      while (true) {\n        // Apply timeout if configured\n        let timeoutId: NodeJS.Timeout | number | undefined;\n        if (this.timeoutMs && !options?.signal) {\n          timeoutId = setTimeout(() => {\n            const timeoutError = new Error('Request timeout');\n            timeoutError.name = 'TimeoutError';\n            controller.abort(timeoutError);\n          }, this.timeoutMs);\n        }\n\n        try {\n          // Re-apply auth headers if this is a retry\n          if (refreshAttempted) {\n            const freshInit = { ...init };\n            // We need to re-run apply to get new token\n            await this.auth.apply({ url, init: freshInit, options });\n            // Update headers with potentially new token\n            init.headers = freshInit.headers;\n          }\n\n          const req = new Request(url, init);\n\n          const res = await this.fetchImpl(req);\n\n          if (res.status === 401 && this.onUnauthenticated && !refreshAttempted) {\n            const shouldRetry = await this.onUnauthenticated(res.clone() as unknown as Response);\n            if (shouldRetry) {\n              refreshAttempted = true;\n              // Clear timeout before retrying\n              if (timeoutId) clearTimeout(timeoutId);\n              continue;\n            }\n          }\n\n          const status = res.status as HTTPStatusCodeNumber;\n          const contentType = res.headers.get('content-type') || '';\n          const data = contentType.includes('json') ? await res.json() : await res.text();\n          await this.runAfterHooks(new Request(url, init), res, data);\n\n          const duration = Date.now() - startTime;\n          this.logger.info('HTTP request successful', {\n            method,\n            url,\n            status: res.status,\n            durationMs: duration,\n          });\n\n          this.metrics.collect({\n            method,\n            path,\n            status: res.status,\n            durationMs: duration,\n            timestamp: new Date().toISOString(),\n            success: true,\n          });\n\n          return { data: data as T, status: status };\n        } catch (error) {\n          const duration = Date.now() - startTime;\n          this.logger.error('HTTP request failed', error as Error, {\n            method,\n            url,\n            durationMs: duration,\n          });\n\n          this.metrics.collect({\n            method,\n            path,\n            status: error instanceof ApiError ? error.status : undefined,\n            durationMs: duration,\n            timestamp: new Date().toISOString(),\n            success: false,\n            error: error instanceof Error ? error.message : String(error),\n          });\n\n          throw error;\n        } finally {\n          if (timeoutId) clearTimeout(timeoutId);\n        }\n      }\n    };\n\n    const canRetry = ({ error }: { error?: unknown }) => {\n      // Don't retry timeouts or aborts\n      if (error && typeof error === 'object' && 'name' in error) {\n        const errorName = (error as { name?: string }).name;\n        if (errorName === 'AbortError' || errorName === 'TimeoutError') return false;\n      }\n      // Retry on network errors or configured status codes\n      if (error instanceof ApiError && error.status) {\n        const retryCodes = this.retry.retryStatusCodes;\n        if (retryCodes?.some((codeKey) => HTTPStatusCode[codeKey] === error.status)) {\n          return true;\n        }\n      }\n      return false;\n    };\n\n    if (!this.retry.retryMethods?.includes(method)) {\n      return doFetch();\n    }\n\n    return this.withRetry(doFetch, canRetry);\n  }\n\n  /**\n   * Convenience method for GET requests.\n   *\n   * @example\n   * ```ts\n   * const { data } = await client.get('/users', { query: { page: 1 } });\n   * ```\n   */\n  async get<T = unknown>(\n    path: string,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    return this.request<T>('GET', path, undefined, options);\n  }\n\n  /**\n   * Convenience method for POST requests.\n   *\n   * @example\n   * ```ts\n   * const { data } = await client.post('/users', { name: 'John' });\n   * ```\n   */\n  async post<T = unknown>(\n    path: string,\n    body?: unknown,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    return this.request<T>('POST', path, body, options);\n  }\n\n  /**\n   * Convenience method for PUT requests.\n   *\n   * @example\n   * ```ts\n   * const { data } = await client.put('/users/1', { name: 'John Updated' });\n   * ```\n   */\n  async put<T = unknown>(\n    path: string,\n    body?: unknown,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    return this.request<T>('PUT', path, body, options);\n  }\n\n  /**\n   * Convenience method for PATCH requests.\n   *\n   * @example\n   * ```ts\n   * const { data } = await client.patch('/users/1', { name: 'John' });\n   * ```\n   */\n  async patch<T = unknown>(\n    path: string,\n    body?: unknown,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    return this.request<T>('PATCH', path, body, options);\n  }\n\n  /**\n   * Convenience method for DELETE requests.\n   *\n   * @example\n   * ```ts\n   * const { data } = await client.delete('/users/1');\n   * ```\n   */\n  async delete<T = unknown>(\n    path: string,\n    options?: RequestOptions\n  ): Promise<{ data: T; status: HTTPStatusCodeNumber }> {\n    return this.request<T>('DELETE', path, undefined, options);\n  }\n\n  /**\n   * Create a strongly-typed endpoint builder.\n   *\n   * @param config - Endpoint configuration\n   * @returns Endpoint instance\n   */\n  createEndpoint<\n    ResSchema extends z.ZodType | Record<number, z.ZodType>,\n    ReqSchema extends z.ZodType | undefined = undefined,\n    QuerySchema extends z.ZodType | undefined = undefined,\n    PathSchema extends z.ZodType | undefined = undefined,\n  >(\n    config: EndpointConfig<ResSchema, ReqSchema, QuerySchema, PathSchema>\n  ): EndpointCall<ResSchema, ReqSchema, QuerySchema, PathSchema> {\n    const endpoint = new EndpointImpl(this, config);\n    return (params) => endpoint.call(params);\n  }\n}\n","import { z } from 'zod';\n\n/**\n * Common ID type that supports strings, numbers, or UUIDs.\n * Use this for entity identifiers in your schemas.\n *\n * @example\n * ```ts\n * const UserSchema = z.object({ id: Id, name: z.string() });\n * ```\n */\nexport const Id = z.union([\n  z.string().min(1),\n  z.number(),\n  z.uuid({\n    version: 'v4',\n  }),\n]);\nexport type IdType = z.infer<typeof Id>;\n\n/**\n * Common timestamp fields for entities.\n * Use this for database models with creation/update tracking.\n *\n * @example\n * ```ts\n * const UserSchema = z.object({\n *   id: Id,\n *   name: z.string(),\n *   ...Timestamps.shape\n * });\n * ```\n */\nexport const Timestamps = z.object({\n  createdAt: z.iso.datetime(),\n  updatedAt: z.iso.datetime(),\n});\n\n/**\n * Metadata information typically included in API responses.\n * Contains request tracking and debugging information.\n */\nexport const Meta = z.object({\n  timestamp: z.iso.datetime().optional(),\n});\n\n/**\n * Detailed error information for a specific field or path.\n */\nexport const ErrorDetail = z.object({\n  path: z.string().optional(),\n  message: z.string(),\n});\n\n/**\n * Standard API error response schema.\n * Use this for consistent error handling across your API.\n */\nexport const ApiErrorSchema = z.object({\n  code: z.string(),\n  message: z.string(),\n  details: z.array(ErrorDetail).optional(),\n});\n\n/**\n * Generic envelope wrapper for API responses.\n * Provides consistent structure with success flag, data, error, and metadata.\n *\n * @param inner - Zod schema for the response data\n * @returns Envelope schema wrapping the inner schema\n *\n * @example\n * ```ts\n * const UserResponseSchema = Envelope(z.object({ id: Id, name: z.string() }));\n *\n * // Response structure:\n * // {\n * //   success: true,\n * //   data: { id: 1, name: 'John' },\n * //   meta: { timestamp: '...' }\n * // }\n * ```\n */\nexport const Envelope = <T extends z.ZodType, M extends z.ZodType = z.ZodOptional<typeof Meta>>(\n  inner: T,\n  meta?: M\n) => {\n  return z.object({\n    success: z.boolean(),\n    data: inner.optional().nullable(),\n    error: ApiErrorSchema.optional(),\n    meta: (meta !== undefined ? meta : Meta.optional()) as M extends undefined ? z.ZodOptional<typeof Meta> : M,\n  });\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zlient",
-  "version": "2.1.4",
+  "version": "2.1.5",
   "homepage": "https://emirhangumus.github.io/zlient/",
   "author": "Emirhan Gümüş",
   "repository": {