npm - zlient - Versions diffs - 2.1.8 → 2.1.10 - Mend

zlient 2.1.8 → 2.1.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/dist/http/http-client.d.ts.map +1 -1
package/dist/index.cjs +4 -1
package/dist/index.cjs.map +1 -1
package/dist/index.js +4 -1
package/dist/index.js.map +1 -1
package/dist/types.d.ts +3 -3
package/dist/types.d.ts.map +1 -1
package/package.json +1 -1

package/dist/http/http-client.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../lib/http/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAgB,MAAM,2BAA2B,CAAC;AAGvF,OAAO,EAEL,aAAa,EAEb,UAAU,~~EAEV~~,oBAAoB,EAEpB,cAAc,EAGf,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,iBAAiB,CAAC,CAAqD;IAE/E;;;;;OAKG;gBACS,IAAI,EAAE,aAAa;IAuD/B;;;;;;;;OAQG;IACH,OAAO,CAAC,IAAI,EAAE,YAAY;IAI1B,OAAO,CAAC,cAAc;IAUtB;;;OAGG;IACH,OAAO,CAAC,KAAK;IAIb;;;OAGG;YACW,SAAS;IAmBvB;;;OAGG;YACW,cAAc;IAM5B;;;OAGG;YACW,aAAa;IAM3B;;;;OAIG;IACI,WAAW;IAIlB;;;;;OAKG;IACI,UAAU,CAAC,GAAG,EAAE,MAAM;IAI7B;;;;;;;;;;;;;;;;;OAiBG;IACG,OAAO,CAAC,CAAC,GAAG,OAAO,EACvB,MAAM,EAAE,MAAM,OAAO,UAAU,EAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,oBAAoB,CAAA;KAAE,CAAC;~~IA4JrD~~;;;;;;;OAOG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EACnB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,oBAAoB,CAAA;KAAE,CAAC;IAIrD;;;;;;;OAOG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,oBAAoB,CAAA;KAAE,CAAC;IAIrD;;;;;;;OAOG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EACnB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,oBAAoB,CAAA;KAAE,CAAC;IAIrD;;;;;;;OAOG;IACG,KAAK,CAAC,CAAC,GAAG,OAAO,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,oBAAoB,CAAA;KAAE,CAAC;IAIrD;;;;;;;OAOG;IACG,MAAM,CAAC,CAAC,GAAG,OAAO,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,oBAAoB,CAAA;KAAE,CAAC;IAIrD;;;;;OAKG;IACH,cAAc,CACZ,SAAS,SAAS,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EACvD,SAAS,SAAS,CAAC,CAAC,OAAO,GAAG,SAAS,GAAG,SAAS,EACnD,WAAW,SAAS,CAAC,CAAC,OAAO,GAAG,SAAS,GAAG,SAAS,EACrD,UAAU,SAAS,CAAC,CAAC,OAAO,GAAG,SAAS,GAAG,SAAS,EAEpD,MAAM,EAAE,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,CAAC,GACpE,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,CAAC;CAI/D"}
1	+ {"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../lib/http/http-client.ts"],"names":[],"mappings":"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"}

package/dist/index.cjs CHANGED Viewed

@@ -765,7 +765,10 @@ var HttpClient = class {
 					}
 					const status = res.status;
 					const contentType = res.headers.get("content-type") || "";
-					const data = contentType.includes("json") ? await res.json() : await res.text();
+					let data;
+					if (contentType.includes("json")) data = await res.json();
+					else if (contentType.includes("application/octet-stream") || contentType.includes("application/pdf") || contentType.includes("image/") || contentType.includes("video/") || contentType.includes("audio/") || contentType.startsWith("application/zip") || contentType.startsWith("application/x-")) data = await res.blob();
+					else data = await res.text();
 					await this.runAfterHooks(new Request(url, init), res, data);
 					const duration = Date.now() - startTime;
 					this.logger.info("HTTP request successful", {

package/dist/index.cjs.map CHANGED Viewed

	@@ -1 +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","requestBody: BodyInit \| undefined","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 /* Skip retry logic for this request /\n skipRetry?: 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 skipRetry?: 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 skipRetry: this.config.advanced?.skipRetry,\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\n // Handle FormData, Blob, ArrayBuffer: pass through without stringifying\n let requestBody: BodyInit \| undefined;\n if (body != null) {\n if (body instanceof FormData) {\n requestBody = body;\n // Remove Content-Type header so browser can set it with proper boundary\n delete headers['Content-Type'];\n } else if (body instanceof Blob \|\| body instanceof ArrayBuffer) {\n requestBody = body;\n } else if (headers['Content-Type']?.includes('json')) {\n requestBody = JSON.stringify(body);\n } else {\n requestBody = String(body);\n }\n }\n\n const init: RequestInit & { __urlOverride?: string } = {\n method,\n headers,\n body: requestBody,\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 (unless skipAuth is set)\n if (refreshAttempted && !options?.skipAuth) {\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 (options?.skipRetry \|\| !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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"}
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","requestBody: BodyInit \| undefined","timeoutId: NodeJS.Timeout \| number \| undefined","data: any","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?: HTTPStatusCodeKey[];\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 HTTPStatusCodeKey = keyof typeof HTTPStatusCode;\nexport type HTTPStatusCodeNumber = (typeof HTTPStatusCode)[HTTPStatusCodeKey];\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 /* Skip retry logic for this request /\n skipRetry?: 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 skipRetry?: 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 skipRetry: this.config.advanced?.skipRetry,\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 HTTPStatusCodeKey,\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 HTTPStatusCodeKey[]\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\n // Handle FormData, Blob, ArrayBuffer: pass through without stringifying\n let requestBody: BodyInit \| undefined;\n if (body != null) {\n if (body instanceof FormData) {\n requestBody = body;\n // Remove Content-Type header so browser can set it with proper boundary\n delete headers['Content-Type'];\n } else if (body instanceof Blob \|\| body instanceof ArrayBuffer) {\n requestBody = body;\n } else if (headers['Content-Type']?.includes('json')) {\n requestBody = JSON.stringify(body);\n } else {\n requestBody = String(body);\n }\n }\n\n const init: RequestInit & { __urlOverride?: string } = {\n method,\n headers,\n body: requestBody,\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 (unless skipAuth is set)\n if (refreshAttempted && !options?.skipAuth) {\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 \n // Handle different response types appropriately\n let data: any;\n if (contentType.includes('json')) {\n data = await res.json();\n } else if (\n contentType.includes('application/octet-stream') \|\|\n contentType.includes('application/pdf') \|\|\n contentType.includes('image/') \|\|\n contentType.includes('video/') \|\|\n contentType.includes('audio/') \|\|\n contentType.startsWith('application/zip') \|\|\n contentType.startsWith('application/x-')\n ) {\n // Return binary data as Blob for file downloads\n data = await res.blob();\n } else {\n data = await res.text();\n }\n \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 (options?.skipRetry \|\| !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 CHANGED Viewed

@@ -742,7 +742,10 @@ var HttpClient = class {
 					}
 					const status = res.status;
 					const contentType = res.headers.get("content-type") || "";
-					const data = contentType.includes("json") ? await res.json() : await res.text();
+					let data;
+					if (contentType.includes("json")) data = await res.json();
+					else if (contentType.includes("application/octet-stream") || contentType.includes("application/pdf") || contentType.includes("image/") || contentType.includes("video/") || contentType.includes("audio/") || contentType.startsWith("application/zip") || contentType.startsWith("application/x-")) data = await res.blob();
+					else data = await res.text();
 					await this.runAfterHooks(new Request(url, init), res, data);
 					const duration = Date.now() - startTime;
 					this.logger.info("HTTP request successful", {

package/dist/index.js.map CHANGED Viewed

	@@ -1 +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","requestBody: BodyInit \| undefined","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 /* Skip retry logic for this request /\n skipRetry?: 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 skipRetry?: 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 skipRetry: this.config.advanced?.skipRetry,\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\n // Handle FormData, Blob, ArrayBuffer: pass through without stringifying\n let requestBody: BodyInit \| undefined;\n if (body != null) {\n if (body instanceof FormData) {\n requestBody = body;\n // Remove Content-Type header so browser can set it with proper boundary\n delete headers['Content-Type'];\n } else if (body instanceof Blob \|\| body instanceof ArrayBuffer) {\n requestBody = body;\n } else if (headers['Content-Type']?.includes('json')) {\n requestBody = JSON.stringify(body);\n } else {\n requestBody = String(body);\n }\n }\n\n const init: RequestInit & { __urlOverride?: string } = {\n method,\n headers,\n body: requestBody,\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 (unless skipAuth is set)\n if (refreshAttempted && !options?.skipAuth) {\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 (options?.skipRetry \|\| !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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"}
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","requestBody: BodyInit \| undefined","timeoutId: NodeJS.Timeout \| number \| undefined","data: any","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?: HTTPStatusCodeKey[];\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 HTTPStatusCodeKey = keyof typeof HTTPStatusCode;\nexport type HTTPStatusCodeNumber = (typeof HTTPStatusCode)[HTTPStatusCodeKey];\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 /* Skip retry logic for this request /\n skipRetry?: 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 skipRetry?: 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 skipRetry: this.config.advanced?.skipRetry,\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 HTTPStatusCodeKey,\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 HTTPStatusCodeKey[]\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\n // Handle FormData, Blob, ArrayBuffer: pass through without stringifying\n let requestBody: BodyInit \| undefined;\n if (body != null) {\n if (body instanceof FormData) {\n requestBody = body;\n // Remove Content-Type header so browser can set it with proper boundary\n delete headers['Content-Type'];\n } else if (body instanceof Blob \|\| body instanceof ArrayBuffer) {\n requestBody = body;\n } else if (headers['Content-Type']?.includes('json')) {\n requestBody = JSON.stringify(body);\n } else {\n requestBody = String(body);\n }\n }\n\n const init: RequestInit & { __urlOverride?: string } = {\n method,\n headers,\n body: requestBody,\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 (unless skipAuth is set)\n if (refreshAttempted && !options?.skipAuth) {\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 \n // Handle different response types appropriately\n let data: any;\n if (contentType.includes('json')) {\n data = await res.json();\n } else if (\n contentType.includes('application/octet-stream') \|\|\n contentType.includes('application/pdf') \|\|\n contentType.includes('image/') \|\|\n contentType.includes('video/') \|\|\n contentType.includes('audio/') \|\|\n contentType.startsWith('application/zip') \|\|\n contentType.startsWith('application/x-')\n ) {\n // Return binary data as Blob for file downloads\n data = await res.blob();\n } else {\n data = await res.text();\n }\n \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 (options?.skipRetry \|\| !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/types.d.ts CHANGED Viewed

@@ -44,7 +44,7 @@ export type RetryStrategy = {
     /** HTTP methods eligible for retry */
     retryMethods?: (keyof typeof HTTPMethod)[];
     /** HTTP status codes eligible for retry */
-    retryStatusCodes?: (keyof typeof HTTPStatusCode)[];
+    retryStatusCodes?: HTTPStatusCodeKey[];
     /** Custom function to determine if a request should be retried */
     shouldRetry?: (ctx: {
         attempt: number;
@@ -126,8 +126,8 @@ export declare const HTTPStatusCode: {
     readonly NOT_EXTENDED: 510;
     readonly NETWORK_AUTHENTICATION_REQUIRED: 511;
 };
-export type HTTPStatusCode = keyof typeof HTTPStatusCode;
-export type HTTPStatusCodeNumber = (typeof HTTPStatusCode)[HTTPStatusCode];
+export type HTTPStatusCodeKey = keyof typeof HTTPStatusCode;
+export type HTTPStatusCodeNumber = (typeof HTTPStatusCode)[HTTPStatusCodeKey];
 /**
  * Hook called after a response is received and parsed.
  * Useful for logging, metrics, or global error handling.

package/dist/types.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../lib/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AAE9C,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEjG;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3B;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,YAAY,CAAC,EAAE,CAAC,MAAM,OAAO,UAAU,CAAC,EAAE,CAAC;IAC3C,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,~~CAAC~~,~~MAAM,OAAO,cAAc,CAAC,~~EAAE,CAAC;~~IACnD~~,kEAAkE;IAClE,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;KAAE,KAAK,OAAO,CAAC;CAC3F,CAAC;AAEF,eAAO,MAAM,UAAU;;;;;;;;CAQb,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,UAAU,CAAC;AAEjD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwEjB,CAAC;AAEX,MAAM,MAAM,~~cAAc~~,GAAG,MAAM,OAAO,cAAc,CAAC;~~AACzD~~,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,~~cAAc~~,CAAC,CAAC;~~AAE3E~~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"}
1	+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../lib/types.ts"],"names":[],"mappings":"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"}

package/package.json CHANGED Viewed

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