typetify 2.2.0 → 4.0.1

package/dist/http/index.d.mts

@@ -0,0 +1,301 @@
+/**
+ * HTTP request options.
+ */
+interface RequestOptions extends Omit<RequestInit, 'body'> {
+    baseUrl?: string;
+    timeout?: number;
+    params?: Record<string, string | number | boolean | undefined>;
+    body?: unknown;
+}
+/**
+ * HTTP response with typed data.
+ */
+interface HttpResponse<T> {
+    data: T;
+    status: number;
+    statusText: string;
+    headers: Headers;
+    ok: boolean;
+}
+/**
+ * HTTP error with response details.
+ */
+declare class HttpError extends Error {
+    status: number;
+    statusText: string;
+    response?: unknown | undefined;
+    constructor(message: string, status: number, statusText: string, response?: unknown | undefined);
+}
+/**
+ * Builds URL with query parameters.
+ *
+ * @example
+ * buildUrl('https://api.example.com/users', { page: 1, limit: 10 });
+ * // => 'https://api.example.com/users?page=1&limit=10'
+ */
+declare function buildUrl(url: string, params?: Record<string, string | number | boolean | undefined>): string;
+/**
+ * Makes an HTTP request with timeout and error handling.
+ *
+ * @example
+ * const response = await request<User>('https://api.example.com/users/1');
+ * console.log(response.data); // User object
+ *
+ * @example
+ * // POST request
+ * const response = await request<User>('https://api.example.com/users', {
+ *   method: 'POST',
+ *   body: { name: 'John', email: 'john@example.com' }
+ * });
+ */
+declare function request<T>(url: string, options?: RequestOptions): Promise<HttpResponse<T>>;
+/**
+ * Makes a GET request.
+ *
+ * @example
+ * const users = await get<User[]>('https://api.example.com/users');
+ *
+ * @example
+ * // With query parameters
+ * const users = await get<User[]>('https://api.example.com/users', {
+ *   params: { page: 1, limit: 10 }
+ * });
+ */
+declare function get<T>(url: string, options?: Omit<RequestOptions, 'method' | 'body'>): Promise<HttpResponse<T>>;
+/**
+ * Makes a POST request.
+ *
+ * @example
+ * const user = await post<User>('https://api.example.com/users', {
+ *   body: { name: 'John', email: 'john@example.com' }
+ * });
+ */
+declare function post<T>(url: string, options?: RequestOptions): Promise<HttpResponse<T>>;
+/**
+ * Makes a PUT request.
+ *
+ * @example
+ * const user = await put<User>('https://api.example.com/users/1', {
+ *   body: { name: 'John Updated' }
+ * });
+ */
+declare function put<T>(url: string, options?: RequestOptions): Promise<HttpResponse<T>>;
+/**
+ * Makes a PATCH request.
+ *
+ * @example
+ * const user = await patch<User>('https://api.example.com/users/1', {
+ *   body: { name: 'John Updated' }
+ * });
+ */
+declare function patch<T>(url: string, options?: RequestOptions): Promise<HttpResponse<T>>;
+/**
+ * Makes a DELETE request.
+ *
+ * @example
+ * await del('https://api.example.com/users/1');
+ */
+declare function del<T = void>(url: string, options?: Omit<RequestOptions, 'body'>): Promise<HttpResponse<T>>;
+
+/**
+ * HTTP client configuration.
+ */
+interface HttpClientConfig {
+    baseUrl: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+    interceptors?: {
+        request?: (options: RequestOptions) => RequestOptions | Promise<RequestOptions>;
+        response?: <T>(response: HttpResponse<T>) => HttpResponse<T> | Promise<HttpResponse<T>>;
+        error?: (error: Error) => Error | Promise<Error>;
+    };
+}
+/**
+ * HTTP client instance.
+ */
+interface HttpClient {
+    get: <T>(url: string, options?: Omit<RequestOptions, 'method' | 'body'>) => Promise<HttpResponse<T>>;
+    post: <T>(url: string, options?: RequestOptions) => Promise<HttpResponse<T>>;
+    put: <T>(url: string, options?: RequestOptions) => Promise<HttpResponse<T>>;
+    patch: <T>(url: string, options?: RequestOptions) => Promise<HttpResponse<T>>;
+    delete: <T = void>(url: string, options?: Omit<RequestOptions, 'body'>) => Promise<HttpResponse<T>>;
+    request: <T>(url: string, options?: RequestOptions) => Promise<HttpResponse<T>>;
+}
+/**
+ * Creates an HTTP client with base configuration.
+ *
+ * @example
+ * const api = createHttpClient({
+ *   baseUrl: 'https://api.example.com',
+ *   timeout: 5000,
+ *   headers: {
+ *     'Authorization': 'Bearer token123'
+ *   }
+ * });
+ *
+ * // All requests use the base configuration
+ * const users = await api.get<User[]>('/users');
+ * const user = await api.post<User>('/users', { body: { name: 'John' } });
+ *
+ * @example
+ * // With interceptors
+ * const api = createHttpClient({
+ *   baseUrl: 'https://api.example.com',
+ *   interceptors: {
+ *     request: (options) => {
+ *       options.headers = {
+ *         ...options.headers,
+ *         'X-Request-Id': crypto.randomUUID()
+ *       };
+ *       return options;
+ *     },
+ *     response: (response) => {
+ *       console.log('Response:', response.status);
+ *       return response;
+ *     },
+ *     error: (error) => {
+ *       console.error('Request failed:', error);
+ *       return error;
+ *     }
+ *   }
+ * });
+ */
+declare function createHttpClient(config: HttpClientConfig): HttpClient;
+
+/**
+ * Retry configuration options.
+ */
+interface RetryOptions {
+    maxRetries?: number;
+    delay?: number;
+    backoff?: 'linear' | 'exponential';
+    retryOn?: (error: Error, attempt: number) => boolean;
+}
+/**
+ * Makes an HTTP request with automatic retry on failure.
+ *
+ * @example
+ * // Basic retry with defaults (3 retries, 1s delay)
+ * const response = await requestWithRetry<User>('https://api.example.com/users/1');
+ *
+ * @example
+ * // Custom retry configuration
+ * const response = await requestWithRetry<User>('https://api.example.com/users/1', {
+ *   maxRetries: 5,
+ *   delay: 2000,
+ *   backoff: 'exponential'
+ * });
+ *
+ * @example
+ * // Custom retry condition
+ * const response = await requestWithRetry<User>('https://api.example.com/users/1', {
+ *   retryOn: (error, attempt) => {
+ *     if (error instanceof HttpError && error.status === 429) {
+ *       return attempt < 5; // Retry rate limiting up to 5 times
+ *     }
+ *     return false;
+ *   }
+ * });
+ */
+declare function requestWithRetry<T>(url: string, options?: RequestOptions & RetryOptions): Promise<HttpResponse<T>>;
+/**
+ * Creates a retry wrapper for any async function.
+ *
+ * @example
+ * const fetchWithRetry = withRetry(async (id: string) => {
+ *   const response = await fetch(`/api/users/${id}`);
+ *   return response.json();
+ * }, { maxRetries: 3 });
+ *
+ * const user = await fetchWithRetry('123');
+ */
+declare function withRetry<T extends (...args: unknown[]) => Promise<unknown>>(fn: T, options?: RetryOptions): T;
+
+/**
+ * Common HTTP headers.
+ */
+declare const HttpHeaders: {
+    readonly ContentType: "Content-Type";
+    readonly Accept: "Accept";
+    readonly Authorization: "Authorization";
+    readonly CacheControl: "Cache-Control";
+    readonly UserAgent: "User-Agent";
+    readonly AcceptLanguage: "Accept-Language";
+    readonly ContentLength: "Content-Length";
+    readonly XRequestId: "X-Request-Id";
+    readonly XForwardedFor: "X-Forwarded-For";
+    readonly XRealIp: "X-Real-IP";
+};
+/**
+ * Common content types.
+ */
+declare const ContentTypes: {
+    readonly JSON: "application/json";
+    readonly FormData: "multipart/form-data";
+    readonly FormUrlEncoded: "application/x-www-form-urlencoded";
+    readonly Text: "text/plain";
+    readonly HTML: "text/html";
+    readonly XML: "application/xml";
+    readonly Binary: "application/octet-stream";
+};
+/**
+ * Parses authorization header.
+ *
+ * @example
+ * parseAuthHeader('Bearer token123');
+ * // => { type: 'Bearer', credentials: 'token123' }
+ *
+ * @example
+ * parseAuthHeader('Basic dXNlcjpwYXNz');
+ * // => { type: 'Basic', credentials: 'dXNlcjpwYXNz' }
+ */
+declare function parseAuthHeader(header: string | null): {
+    type: string;
+    credentials: string;
+} | null;
+/**
+ * Creates a Bearer authorization header.
+ *
+ * @example
+ * bearerAuth('token123');
+ * // => 'Bearer token123'
+ */
+declare function bearerAuth(token: string): string;
+/**
+ * Creates a Basic authorization header.
+ *
+ * @example
+ * basicAuth('user', 'password');
+ * // => 'Basic dXNlcjpwYXNzd29yZA=='
+ */
+declare function basicAuth(username: string, password: string): string;
+/**
+ * Parses cookies from a Cookie header string.
+ *
+ * @example
+ * parseCookieHeader('session=abc123; user=john');
+ * // => { session: 'abc123', user: 'john' }
+ */
+declare function parseCookieHeader(header: string): Record<string, string>;
+/**
+ * Builds a Cookie header string from an object.
+ *
+ * @example
+ * buildCookieHeader({ session: 'abc123', user: 'john' });
+ * // => 'session=abc123; user=john'
+ */
+declare function buildCookieHeader(cookies: Record<string, string>): string;
+/**
+ * Merges multiple header objects.
+ *
+ * @example
+ * mergeHeaders(
+ *   { 'Content-Type': 'application/json' },
+ *   { 'Authorization': 'Bearer token' },
+ *   { 'X-Custom': 'value' }
+ * );
+ * // => { 'Content-Type': 'application/json', 'Authorization': 'Bearer token', 'X-Custom': 'value' }
+ */
+declare function mergeHeaders(...headerObjects: (Record<string, string> | undefined)[]): Record<string, string>;
+
+export { ContentTypes, type HttpClient, type HttpClientConfig, HttpError, HttpHeaders, type HttpResponse, type RequestOptions, type RetryOptions, basicAuth, bearerAuth, buildCookieHeader, buildUrl, createHttpClient, del, get, mergeHeaders, parseAuthHeader, parseCookieHeader, patch, post, put, request, requestWithRetry, withRetry };

package/dist/http/index.d.ts

@@ -0,0 +1,301 @@
+/**
+ * HTTP request options.
+ */
+interface RequestOptions extends Omit<RequestInit, 'body'> {
+    baseUrl?: string;
+    timeout?: number;
+    params?: Record<string, string | number | boolean | undefined>;
+    body?: unknown;
+}
+/**
+ * HTTP response with typed data.
+ */
+interface HttpResponse<T> {
+    data: T;
+    status: number;
+    statusText: string;
+    headers: Headers;
+    ok: boolean;
+}
+/**
+ * HTTP error with response details.
+ */
+declare class HttpError extends Error {
+    status: number;
+    statusText: string;
+    response?: unknown | undefined;
+    constructor(message: string, status: number, statusText: string, response?: unknown | undefined);
+}
+/**
+ * Builds URL with query parameters.
+ *
+ * @example
+ * buildUrl('https://api.example.com/users', { page: 1, limit: 10 });
+ * // => 'https://api.example.com/users?page=1&limit=10'
+ */
+declare function buildUrl(url: string, params?: Record<string, string | number | boolean | undefined>): string;
+/**
+ * Makes an HTTP request with timeout and error handling.
+ *
+ * @example
+ * const response = await request<User>('https://api.example.com/users/1');
+ * console.log(response.data); // User object
+ *
+ * @example
+ * // POST request
+ * const response = await request<User>('https://api.example.com/users', {
+ *   method: 'POST',
+ *   body: { name: 'John', email: 'john@example.com' }
+ * });
+ */
+declare function request<T>(url: string, options?: RequestOptions): Promise<HttpResponse<T>>;
+/**
+ * Makes a GET request.
+ *
+ * @example
+ * const users = await get<User[]>('https://api.example.com/users');
+ *
+ * @example
+ * // With query parameters
+ * const users = await get<User[]>('https://api.example.com/users', {
+ *   params: { page: 1, limit: 10 }
+ * });
+ */
+declare function get<T>(url: string, options?: Omit<RequestOptions, 'method' | 'body'>): Promise<HttpResponse<T>>;
+/**
+ * Makes a POST request.
+ *
+ * @example
+ * const user = await post<User>('https://api.example.com/users', {
+ *   body: { name: 'John', email: 'john@example.com' }
+ * });
+ */
+declare function post<T>(url: string, options?: RequestOptions): Promise<HttpResponse<T>>;
+/**
+ * Makes a PUT request.
+ *
+ * @example
+ * const user = await put<User>('https://api.example.com/users/1', {
+ *   body: { name: 'John Updated' }
+ * });
+ */
+declare function put<T>(url: string, options?: RequestOptions): Promise<HttpResponse<T>>;
+/**
+ * Makes a PATCH request.
+ *
+ * @example
+ * const user = await patch<User>('https://api.example.com/users/1', {
+ *   body: { name: 'John Updated' }
+ * });
+ */
+declare function patch<T>(url: string, options?: RequestOptions): Promise<HttpResponse<T>>;
+/**
+ * Makes a DELETE request.
+ *
+ * @example
+ * await del('https://api.example.com/users/1');
+ */
+declare function del<T = void>(url: string, options?: Omit<RequestOptions, 'body'>): Promise<HttpResponse<T>>;
+
+/**
+ * HTTP client configuration.
+ */
+interface HttpClientConfig {
+    baseUrl: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+    interceptors?: {
+        request?: (options: RequestOptions) => RequestOptions | Promise<RequestOptions>;
+        response?: <T>(response: HttpResponse<T>) => HttpResponse<T> | Promise<HttpResponse<T>>;
+        error?: (error: Error) => Error | Promise<Error>;
+    };
+}
+/**
+ * HTTP client instance.
+ */
+interface HttpClient {
+    get: <T>(url: string, options?: Omit<RequestOptions, 'method' | 'body'>) => Promise<HttpResponse<T>>;
+    post: <T>(url: string, options?: RequestOptions) => Promise<HttpResponse<T>>;
+    put: <T>(url: string, options?: RequestOptions) => Promise<HttpResponse<T>>;
+    patch: <T>(url: string, options?: RequestOptions) => Promise<HttpResponse<T>>;
+    delete: <T = void>(url: string, options?: Omit<RequestOptions, 'body'>) => Promise<HttpResponse<T>>;
+    request: <T>(url: string, options?: RequestOptions) => Promise<HttpResponse<T>>;
+}
+/**
+ * Creates an HTTP client with base configuration.
+ *
+ * @example
+ * const api = createHttpClient({
+ *   baseUrl: 'https://api.example.com',
+ *   timeout: 5000,
+ *   headers: {
+ *     'Authorization': 'Bearer token123'
+ *   }
+ * });
+ *
+ * // All requests use the base configuration
+ * const users = await api.get<User[]>('/users');
+ * const user = await api.post<User>('/users', { body: { name: 'John' } });
+ *
+ * @example
+ * // With interceptors
+ * const api = createHttpClient({
+ *   baseUrl: 'https://api.example.com',
+ *   interceptors: {
+ *     request: (options) => {
+ *       options.headers = {
+ *         ...options.headers,
+ *         'X-Request-Id': crypto.randomUUID()
+ *       };
+ *       return options;
+ *     },
+ *     response: (response) => {
+ *       console.log('Response:', response.status);
+ *       return response;
+ *     },
+ *     error: (error) => {
+ *       console.error('Request failed:', error);
+ *       return error;
+ *     }
+ *   }
+ * });
+ */
+declare function createHttpClient(config: HttpClientConfig): HttpClient;
+
+/**
+ * Retry configuration options.
+ */
+interface RetryOptions {
+    maxRetries?: number;
+    delay?: number;
+    backoff?: 'linear' | 'exponential';
+    retryOn?: (error: Error, attempt: number) => boolean;
+}
+/**
+ * Makes an HTTP request with automatic retry on failure.
+ *
+ * @example
+ * // Basic retry with defaults (3 retries, 1s delay)
+ * const response = await requestWithRetry<User>('https://api.example.com/users/1');
+ *
+ * @example
+ * // Custom retry configuration
+ * const response = await requestWithRetry<User>('https://api.example.com/users/1', {
+ *   maxRetries: 5,
+ *   delay: 2000,
+ *   backoff: 'exponential'
+ * });
+ *
+ * @example
+ * // Custom retry condition
+ * const response = await requestWithRetry<User>('https://api.example.com/users/1', {
+ *   retryOn: (error, attempt) => {
+ *     if (error instanceof HttpError && error.status === 429) {
+ *       return attempt < 5; // Retry rate limiting up to 5 times
+ *     }
+ *     return false;
+ *   }
+ * });
+ */
+declare function requestWithRetry<T>(url: string, options?: RequestOptions & RetryOptions): Promise<HttpResponse<T>>;
+/**
+ * Creates a retry wrapper for any async function.
+ *
+ * @example
+ * const fetchWithRetry = withRetry(async (id: string) => {
+ *   const response = await fetch(`/api/users/${id}`);
+ *   return response.json();
+ * }, { maxRetries: 3 });
+ *
+ * const user = await fetchWithRetry('123');
+ */
+declare function withRetry<T extends (...args: unknown[]) => Promise<unknown>>(fn: T, options?: RetryOptions): T;
+
+/**
+ * Common HTTP headers.
+ */
+declare const HttpHeaders: {
+    readonly ContentType: "Content-Type";
+    readonly Accept: "Accept";
+    readonly Authorization: "Authorization";
+    readonly CacheControl: "Cache-Control";
+    readonly UserAgent: "User-Agent";
+    readonly AcceptLanguage: "Accept-Language";
+    readonly ContentLength: "Content-Length";
+    readonly XRequestId: "X-Request-Id";
+    readonly XForwardedFor: "X-Forwarded-For";
+    readonly XRealIp: "X-Real-IP";
+};
+/**
+ * Common content types.
+ */
+declare const ContentTypes: {
+    readonly JSON: "application/json";
+    readonly FormData: "multipart/form-data";
+    readonly FormUrlEncoded: "application/x-www-form-urlencoded";
+    readonly Text: "text/plain";
+    readonly HTML: "text/html";
+    readonly XML: "application/xml";
+    readonly Binary: "application/octet-stream";
+};
+/**
+ * Parses authorization header.
+ *
+ * @example
+ * parseAuthHeader('Bearer token123');
+ * // => { type: 'Bearer', credentials: 'token123' }
+ *
+ * @example
+ * parseAuthHeader('Basic dXNlcjpwYXNz');
+ * // => { type: 'Basic', credentials: 'dXNlcjpwYXNz' }
+ */
+declare function parseAuthHeader(header: string | null): {
+    type: string;
+    credentials: string;
+} | null;
+/**
+ * Creates a Bearer authorization header.
+ *
+ * @example
+ * bearerAuth('token123');
+ * // => 'Bearer token123'
+ */
+declare function bearerAuth(token: string): string;
+/**
+ * Creates a Basic authorization header.
+ *
+ * @example
+ * basicAuth('user', 'password');
+ * // => 'Basic dXNlcjpwYXNzd29yZA=='
+ */
+declare function basicAuth(username: string, password: string): string;
+/**
+ * Parses cookies from a Cookie header string.
+ *
+ * @example
+ * parseCookieHeader('session=abc123; user=john');
+ * // => { session: 'abc123', user: 'john' }
+ */
+declare function parseCookieHeader(header: string): Record<string, string>;
+/**
+ * Builds a Cookie header string from an object.
+ *
+ * @example
+ * buildCookieHeader({ session: 'abc123', user: 'john' });
+ * // => 'session=abc123; user=john'
+ */
+declare function buildCookieHeader(cookies: Record<string, string>): string;
+/**
+ * Merges multiple header objects.
+ *
+ * @example
+ * mergeHeaders(
+ *   { 'Content-Type': 'application/json' },
+ *   { 'Authorization': 'Bearer token' },
+ *   { 'X-Custom': 'value' }
+ * );
+ * // => { 'Content-Type': 'application/json', 'Authorization': 'Bearer token', 'X-Custom': 'value' }
+ */
+declare function mergeHeaders(...headerObjects: (Record<string, string> | undefined)[]): Record<string, string>;
+
+export { ContentTypes, type HttpClient, type HttpClientConfig, HttpError, HttpHeaders, type HttpResponse, type RequestOptions, type RetryOptions, basicAuth, bearerAuth, buildCookieHeader, buildUrl, createHttpClient, del, get, mergeHeaders, parseAuthHeader, parseCookieHeader, patch, post, put, request, requestWithRetry, withRetry };

package/dist/http/index.js

@@ -0,0 +1 @@
+'use strict';var chunkXKTDG6LH_js=require('../chunk-XKTDG6LH.js');require('../chunk-WOT6VMZA.js');Object.defineProperty(exports,"ContentTypes",{enumerable:true,get:function(){return chunkXKTDG6LH_js.m}});Object.defineProperty(exports,"HttpError",{enumerable:true,get:function(){return chunkXKTDG6LH_js.a}});Object.defineProperty(exports,"HttpHeaders",{enumerable:true,get:function(){return chunkXKTDG6LH_js.l}});Object.defineProperty(exports,"basicAuth",{enumerable:true,get:function(){return chunkXKTDG6LH_js.p}});Object.defineProperty(exports,"bearerAuth",{enumerable:true,get:function(){return chunkXKTDG6LH_js.o}});Object.defineProperty(exports,"buildCookieHeader",{enumerable:true,get:function(){return chunkXKTDG6LH_js.r}});Object.defineProperty(exports,"buildUrl",{enumerable:true,get:function(){return chunkXKTDG6LH_js.b}});Object.defineProperty(exports,"createHttpClient",{enumerable:true,get:function(){return chunkXKTDG6LH_js.i}});Object.defineProperty(exports,"del",{enumerable:true,get:function(){return chunkXKTDG6LH_js.h}});Object.defineProperty(exports,"get",{enumerable:true,get:function(){return chunkXKTDG6LH_js.d}});Object.defineProperty(exports,"mergeHeaders",{enumerable:true,get:function(){return chunkXKTDG6LH_js.s}});Object.defineProperty(exports,"parseAuthHeader",{enumerable:true,get:function(){return chunkXKTDG6LH_js.n}});Object.defineProperty(exports,"parseCookieHeader",{enumerable:true,get:function(){return chunkXKTDG6LH_js.q}});Object.defineProperty(exports,"patch",{enumerable:true,get:function(){return chunkXKTDG6LH_js.g}});Object.defineProperty(exports,"post",{enumerable:true,get:function(){return chunkXKTDG6LH_js.e}});Object.defineProperty(exports,"put",{enumerable:true,get:function(){return chunkXKTDG6LH_js.f}});Object.defineProperty(exports,"request",{enumerable:true,get:function(){return chunkXKTDG6LH_js.c}});Object.defineProperty(exports,"requestWithRetry",{enumerable:true,get:function(){return chunkXKTDG6LH_js.j}});Object.defineProperty(exports,"withRetry",{enumerable:true,get:function(){return chunkXKTDG6LH_js.k}});

package/dist/http/index.mjs

@@ -0,0 +1 @@
+export{m as ContentTypes,a as HttpError,l as HttpHeaders,p as basicAuth,o as bearerAuth,r as buildCookieHeader,b as buildUrl,i as createHttpClient,h as del,d as get,s as mergeHeaders,n as parseAuthHeader,q as parseCookieHeader,g as patch,e as post,f as put,c as request,j as requestWithRetry,k as withRetry}from'../chunk-MCQFAXUX.mjs';import'../chunk-JZXLCA2E.mjs';