@firekid/hurl 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 hurl contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,405 @@
+# hurl
+
+A modern HTTP client for Node.js and edge runtimes. Zero dependencies. Full TypeScript support. Built to replace `request` and `axios` with a smaller, faster, and more capable alternative.
+
+```bash
+npm install @firekid/hurl
+```
+
+## Purpose
+
+`hurl` solves the problems that `request` left behind when it was deprecated and that `axios` never fully addressed: no edge runtime support, a 35KB bundle, no built-in retry logic, no request deduplication, and no upload progress tracking. `hurl` ships all of these in under 3KB with zero runtime dependencies.
+
+## Core Concepts
+
+Every method on `hurl` returns a `HurlResponse<T>` object. The response always includes the parsed data, status code, headers, a unique request ID, timing information, and a flag indicating whether the response was served from cache.
+
+Defaults are set globally using `hurl.defaults.set()` and apply to every request made on that instance. Isolated instances with their own defaults can be created using `hurl.create()`.
+
+Interceptors run in the order they were registered and can be async. A request interceptor receives the URL and options before the request is sent. A response interceptor receives the full response object. An error interceptor receives a `HurlError` and can either return a modified error or resolve it into a response.
+
+## Installation
+
+```bash
+npm install @firekid/hurl
+yarn add @firekid/hurl
+pnpm add @firekid/hurl
+```
+
+## Quick Start
+
+```ts
+import hurl from '@firekid/hurl'
+
+const res = await hurl.get('https://api.example.com/users')
+
+res.data        // parsed response body
+res.status      // 200
+res.headers     // Record<string, string>
+res.requestId   // unique ID for this request
+res.timing      // { start, end, duration }
+res.fromCache   // boolean
+```
+
+## HTTP Methods
+
+```ts
+hurl.get<T>(url, options?)
+hurl.post<T>(url, body?, options?)
+hurl.put<T>(url, body?, options?)
+hurl.patch<T>(url, body?, options?)
+hurl.delete<T>(url, options?)
+hurl.head(url, options?)
+hurl.options<T>(url, options?)
+hurl.request<T>(url, options?)
+```
+
+## Global Defaults
+
+```ts
+hurl.defaults.set({
+  baseUrl: 'https://api.example.com',
+  headers: { 'x-api-version': '2' },
+  timeout: 10000,
+  retry: 3,
+})
+
+hurl.defaults.get()
+hurl.defaults.reset()
+```
+
+## Request Options
+
+All methods accept a `HurlRequestOptions` object.
+
+```ts
+type HurlRequestOptions = {
+  method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS'
+  headers?: Record<string, string>
+  body?: unknown
+  query?: Record<string, string | number | boolean>
+  timeout?: number
+  retry?: RetryConfig | number
+  auth?: AuthConfig
+  proxy?: ProxyConfig
+  cache?: CacheConfig
+  signal?: AbortSignal
+  followRedirects?: boolean
+  maxRedirects?: number
+  onUploadProgress?: ProgressCallback
+  onDownloadProgress?: ProgressCallback
+  stream?: boolean
+  debug?: boolean
+  requestId?: string
+  deduplicate?: boolean
+}
+```
+
+## Authentication
+
+```ts
+hurl.defaults.set({
+  auth: { type: 'bearer', token: 'my-token' }
+})
+
+hurl.defaults.set({
+  auth: { type: 'basic', username: 'admin', password: 'secret' }
+})
+
+hurl.defaults.set({
+  auth: { type: 'apikey', key: 'x-api-key', value: 'my-key' }
+})
+
+hurl.defaults.set({
+  auth: { type: 'apikey', key: 'token', value: 'my-key', in: 'query' }
+})
+```
+
+## Retry
+
+```ts
+await hurl.get('/users', {
+  retry: 3
+})
+
+await hurl.get('/users', {
+  retry: {
+    count: 3,
+    delay: 300,
+    backoff: 'exponential',
+    on: [500, 502, 503],
+  }
+})
+```
+
+`retry` accepts a number (shorthand for count with exponential backoff) or a full `RetryConfig` object. Retries are not triggered for abort errors. If no `on` array is provided, retries fire on network errors, timeout errors, and any 5xx status.
+
+## Timeout and Abort
+
+```ts
+await hurl.get('/users', { timeout: 5000 })
+
+const controller = new AbortController()
+setTimeout(() => controller.abort(), 3000)
+await hurl.get('/users', { signal: controller.signal })
+```
+
+## Interceptors
+
+```ts
+const remove = hurl.interceptors.request.use((url, options) => {
+  return {
+    url,
+    options: {
+      ...options,
+      headers: { ...options.headers, 'x-trace-id': crypto.randomUUID() },
+    },
+  }
+})
+
+remove()
+
+hurl.interceptors.response.use((response) => {
+  console.log(response.status, response.timing.duration)
+  return response
+})
+
+hurl.interceptors.error.use((error) => {
+  if (error.status === 401) redirectToLogin()
+  return error
+})
+
+hurl.interceptors.request.clear()
+hurl.interceptors.response.clear()
+hurl.interceptors.error.clear()
+```
+
+## File Upload with Progress
+
+```ts
+const form = new FormData()
+form.append('file', file)
+
+await hurl.post('/upload', form, {
+  onUploadProgress: ({ loaded, total, percent }) => {
+    console.log(`${percent}%`)
+  }
+})
+```
+
+## Download Progress
+
+```ts
+await hurl.get('/large-file', {
+  onDownloadProgress: ({ loaded, total, percent }) => {
+    console.log(`${percent}%`)
+  }
+})
+```
+
+## Caching
+
+Caching only applies to GET requests. Responses are stored in memory with a TTL in milliseconds.
+
+```ts
+await hurl.get('/users', {
+  cache: { ttl: 60000 }
+})
+
+await hurl.get('/users', {
+  cache: { ttl: 60000, key: 'all-users' }
+})
+
+await hurl.get('/users', {
+  cache: { ttl: 60000, bypass: true }
+})
+```
+
+## Request Deduplication
+
+When `deduplicate` is true and the same GET URL is called multiple times simultaneously, only one network request is made.
+
+```ts
+const [a, b] = await Promise.all([
+  hurl.get('/users', { deduplicate: true }),
+  hurl.get('/users', { deduplicate: true }),
+])
+```
+
+## Proxy
+
+```ts
+await hurl.get('/users', {
+  proxy: { url: 'http://proxy.example.com:8080' }
+})
+
+await hurl.get('/users', {
+  proxy: {
+    url: 'socks5://proxy.example.com:1080',
+    auth: { username: 'user', password: 'pass' }
+  }
+})
+```
+
+## Parallel Requests
+
+```ts
+const [users, posts] = await hurl.all([
+  hurl.get('/users'),
+  hurl.get('/posts'),
+])
+```
+
+## Isolated Instances
+
+```ts
+const api = hurl.create({
+  baseUrl: 'https://api.example.com',
+  auth: { type: 'bearer', token: 'my-token' },
+  timeout: 5000,
+  retry: 3,
+})
+
+await api.get('/users')
+
+const adminApi = api.extend({
+  headers: { 'x-role': 'admin' }
+})
+```
+
+## Debug Mode
+
+Logs the full request (method, url, headers, body, query, timeout, retry config) and response (status, timing, headers, data) to the console. Errors and retries are also logged.
+
+```ts
+await hurl.get('/users', { debug: true })
+```
+
+## Error Handling
+
+`hurl` throws a `HurlError` on HTTP errors (4xx, 5xx), network failures, timeouts, aborts, and parse failures. It never resolves silently on bad status codes.
+
+```ts
+import hurl, { HurlError } from '@firekid/hurl'
+
+try {
+  await hurl.get('/users')
+} catch (err) {
+  if (err instanceof HurlError) {
+    err.type        // 'HTTP_ERROR' | 'NETWORK_ERROR' | 'TIMEOUT_ERROR' | 'ABORT_ERROR' | 'PARSE_ERROR'
+    err.status      // 404
+    err.statusText  // 'Not Found'
+    err.data        // parsed error response body
+    err.headers     // response headers
+    err.requestId   // same ID as the request
+    err.retries     // number of retries attempted
+  }
+}
+```
+
+## TypeScript
+
+```ts
+type User = { id: number; name: string }
+
+const res = await hurl.get<User[]>('/users')
+res.data
+
+const created = await hurl.post<User>('/users', { name: 'John' })
+created.data.id
+```
+
+## Response Shape
+
+```ts
+type HurlResponse<T> = {
+  data: T
+  status: number
+  statusText: string
+  headers: Record<string, string>
+  requestId: string
+  timing: {
+    start: number
+    end: number
+    duration: number
+  }
+  fromCache: boolean
+}
+```
+
+## Environment Support
+
+`hurl` runs anywhere the Fetch API is available.
+
+- Node.js 18 and above
+- Cloudflare Workers
+- Vercel Edge Functions
+- Deno
+- Bun
+
+Exports both ESM (`import`) and CommonJS (`require`).
+
+## API Reference
+
+### hurl.get(url, options?)
+Sends a GET request. Returns `Promise<HurlResponse<T>>`.
+
+### hurl.post(url, body?, options?)
+Sends a POST request. Body is auto-serialized to JSON if it is a plain object. Returns `Promise<HurlResponse<T>>`.
+
+### hurl.put(url, body?, options?)
+Sends a PUT request. Returns `Promise<HurlResponse<T>>`.
+
+### hurl.patch(url, body?, options?)
+Sends a PATCH request. Returns `Promise<HurlResponse<T>>`.
+
+### hurl.delete(url, options?)
+Sends a DELETE request. Returns `Promise<HurlResponse<T>>`.
+
+### hurl.head(url, options?)
+Sends a HEAD request. Returns `Promise<HurlResponse<void>>`.
+
+### hurl.options(url, options?)
+Sends an OPTIONS request. Returns `Promise<HurlResponse<T>>`.
+
+### hurl.request(url, options?)
+Sends a request with the method specified in options. Defaults to GET. Returns `Promise<HurlResponse<T>>`.
+
+### hurl.all(requests)
+Runs an array of requests in parallel. Returns a promise that resolves when all requests complete. Equivalent to `Promise.all`.
+
+### hurl.create(defaults?)
+Creates a new isolated instance with its own defaults, interceptors, and state. Does not share anything with the parent instance.
+
+### hurl.extend(defaults?)
+Creates a new instance that inherits the current defaults and merges in the provided ones.
+
+### hurl.defaults.set(defaults)
+Sets global defaults for the current instance. Merged into every request.
+
+### hurl.defaults.get()
+Returns the current defaults object.
+
+### hurl.defaults.reset()
+Resets defaults to the values provided when the instance was created.
+
+### hurl.interceptors.request.use(fn)
+Registers a request interceptor. Returns a function that removes the interceptor when called.
+
+### hurl.interceptors.response.use(fn)
+Registers a response interceptor. Returns a function that removes the interceptor when called.
+
+### hurl.interceptors.error.use(fn)
+Registers an error interceptor. Returns a function that removes the interceptor when called.
+
+### clearCache()
+Clears the entire in-memory response cache.
+
+```ts
+import { clearCache } from '@firekid/hurl'
+clearCache()
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,143 @@
+type Method = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+type AuthConfig = {
+    type: 'bearer';
+    token: string;
+} | {
+    type: 'basic';
+    username: string;
+    password: string;
+} | {
+    type: 'apikey';
+    key: string;
+    value: string;
+    in?: 'header' | 'query';
+};
+type ProxyConfig = {
+    url: string;
+    auth?: {
+        username: string;
+        password: string;
+    };
+};
+type RetryConfig = {
+    count: number;
+    delay?: number;
+    backoff?: 'linear' | 'exponential';
+    on?: number[];
+};
+type CacheConfig = {
+    ttl: number;
+    key?: string;
+    bypass?: boolean;
+};
+type ProgressCallback = (e: {
+    loaded: number;
+    total: number;
+    percent: number;
+}) => void;
+type HurlRequestOptions = {
+    method?: Method;
+    headers?: Record<string, string>;
+    body?: unknown;
+    query?: Record<string, string | number | boolean>;
+    timeout?: number;
+    retry?: RetryConfig | number;
+    auth?: AuthConfig;
+    proxy?: ProxyConfig;
+    cache?: CacheConfig;
+    signal?: AbortSignal;
+    followRedirects?: boolean;
+    maxRedirects?: number;
+    onUploadProgress?: ProgressCallback;
+    onDownloadProgress?: ProgressCallback;
+    stream?: boolean;
+    debug?: boolean;
+    requestId?: string;
+    deduplicate?: boolean;
+};
+type HurlDefaults = Omit<HurlRequestOptions, 'body' | 'method'> & {
+    baseUrl?: string;
+};
+type HurlResponse<T = unknown> = {
+    data: T;
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    requestId: string;
+    timing: {
+        start: number;
+        end: number;
+        duration: number;
+    };
+    fromCache: boolean;
+};
+type RequestInterceptor = (url: string, options: HurlRequestOptions) => Promise<{
+    url: string;
+    options: HurlRequestOptions;
+}> | {
+    url: string;
+    options: HurlRequestOptions;
+};
+type ResponseInterceptor<T = unknown> = (response: HurlResponse<T>) => Promise<HurlResponse<T>> | HurlResponse<T>;
+type ErrorInterceptor = (error: HurlError) => Promise<HurlError | HurlResponse> | HurlError | HurlResponse;
+type HurlErrorType = 'HTTP_ERROR' | 'NETWORK_ERROR' | 'TIMEOUT_ERROR' | 'ABORT_ERROR' | 'PARSE_ERROR';
+declare class HurlError extends Error {
+    type: HurlErrorType;
+    status?: number;
+    statusText?: string;
+    data?: unknown;
+    headers?: Record<string, string>;
+    requestId: string;
+    retries: number;
+    constructor(params: {
+        message: string;
+        type: HurlErrorType;
+        status?: number;
+        statusText?: string;
+        data?: unknown;
+        headers?: Record<string, string>;
+        requestId: string;
+        retries?: number;
+    });
+}
+type HurlInstance = {
+    get<T = unknown>(url: string, options?: HurlRequestOptions): Promise<HurlResponse<T>>;
+    post<T = unknown>(url: string, body?: unknown, options?: HurlRequestOptions): Promise<HurlResponse<T>>;
+    put<T = unknown>(url: string, body?: unknown, options?: HurlRequestOptions): Promise<HurlResponse<T>>;
+    patch<T = unknown>(url: string, body?: unknown, options?: HurlRequestOptions): Promise<HurlResponse<T>>;
+    delete<T = unknown>(url: string, options?: HurlRequestOptions): Promise<HurlResponse<T>>;
+    head(url: string, options?: HurlRequestOptions): Promise<HurlResponse<void>>;
+    options<T = unknown>(url: string, options?: HurlRequestOptions): Promise<HurlResponse<T>>;
+    request<T = unknown>(url: string, options?: HurlRequestOptions): Promise<HurlResponse<T>>;
+    all<T extends unknown[]>(requests: {
+        [K in keyof T]: Promise<T[K]>;
+    }): Promise<T>;
+    defaults: {
+        set(d: HurlDefaults): void;
+        get(): HurlDefaults;
+        reset(): void;
+    };
+    interceptors: {
+        request: {
+            use(fn: RequestInterceptor): () => void;
+            clear(): void;
+        };
+        response: {
+            use(fn: ResponseInterceptor): () => void;
+            clear(): void;
+        };
+        error: {
+            use(fn: ErrorInterceptor): () => void;
+            clear(): void;
+        };
+    };
+    create(defaults?: HurlDefaults): HurlInstance;
+    extend(defaults?: HurlDefaults): HurlInstance;
+};
+
+declare function clearCache(): void;
+
+declare function createInstance(initialDefaults?: HurlDefaults): HurlInstance;
+declare const hurl: HurlInstance;
+
+export { type ErrorInterceptor, type HurlDefaults, HurlError, type HurlInstance, type HurlRequestOptions, type HurlResponse, type RequestInterceptor, type ResponseInterceptor, clearCache, createInstance, hurl as default };

package/dist/index.d.ts

@@ -0,0 +1,143 @@
+type Method = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+type AuthConfig = {
+    type: 'bearer';
+    token: string;
+} | {
+    type: 'basic';
+    username: string;
+    password: string;
+} | {
+    type: 'apikey';
+    key: string;
+    value: string;
+    in?: 'header' | 'query';
+};
+type ProxyConfig = {
+    url: string;
+    auth?: {
+        username: string;
+        password: string;
+    };
+};
+type RetryConfig = {
+    count: number;
+    delay?: number;
+    backoff?: 'linear' | 'exponential';
+    on?: number[];
+};
+type CacheConfig = {
+    ttl: number;
+    key?: string;
+    bypass?: boolean;
+};
+type ProgressCallback = (e: {
+    loaded: number;
+    total: number;
+    percent: number;
+}) => void;
+type HurlRequestOptions = {
+    method?: Method;
+    headers?: Record<string, string>;
+    body?: unknown;
+    query?: Record<string, string | number | boolean>;
+    timeout?: number;
+    retry?: RetryConfig | number;
+    auth?: AuthConfig;
+    proxy?: ProxyConfig;
+    cache?: CacheConfig;
+    signal?: AbortSignal;
+    followRedirects?: boolean;
+    maxRedirects?: number;
+    onUploadProgress?: ProgressCallback;
+    onDownloadProgress?: ProgressCallback;
+    stream?: boolean;
+    debug?: boolean;
+    requestId?: string;
+    deduplicate?: boolean;
+};
+type HurlDefaults = Omit<HurlRequestOptions, 'body' | 'method'> & {
+    baseUrl?: string;
+};
+type HurlResponse<T = unknown> = {
+    data: T;
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    requestId: string;
+    timing: {
+        start: number;
+        end: number;
+        duration: number;
+    };
+    fromCache: boolean;
+};
+type RequestInterceptor = (url: string, options: HurlRequestOptions) => Promise<{
+    url: string;
+    options: HurlRequestOptions;
+}> | {
+    url: string;
+    options: HurlRequestOptions;
+};
+type ResponseInterceptor<T = unknown> = (response: HurlResponse<T>) => Promise<HurlResponse<T>> | HurlResponse<T>;
+type ErrorInterceptor = (error: HurlError) => Promise<HurlError | HurlResponse> | HurlError | HurlResponse;
+type HurlErrorType = 'HTTP_ERROR' | 'NETWORK_ERROR' | 'TIMEOUT_ERROR' | 'ABORT_ERROR' | 'PARSE_ERROR';
+declare class HurlError extends Error {
+    type: HurlErrorType;
+    status?: number;
+    statusText?: string;
+    data?: unknown;
+    headers?: Record<string, string>;
+    requestId: string;
+    retries: number;
+    constructor(params: {
+        message: string;
+        type: HurlErrorType;
+        status?: number;
+        statusText?: string;
+        data?: unknown;
+        headers?: Record<string, string>;
+        requestId: string;
+        retries?: number;
+    });
+}
+type HurlInstance = {
+    get<T = unknown>(url: string, options?: HurlRequestOptions): Promise<HurlResponse<T>>;
+    post<T = unknown>(url: string, body?: unknown, options?: HurlRequestOptions): Promise<HurlResponse<T>>;
+    put<T = unknown>(url: string, body?: unknown, options?: HurlRequestOptions): Promise<HurlResponse<T>>;
+    patch<T = unknown>(url: string, body?: unknown, options?: HurlRequestOptions): Promise<HurlResponse<T>>;
+    delete<T = unknown>(url: string, options?: HurlRequestOptions): Promise<HurlResponse<T>>;
+    head(url: string, options?: HurlRequestOptions): Promise<HurlResponse<void>>;
+    options<T = unknown>(url: string, options?: HurlRequestOptions): Promise<HurlResponse<T>>;
+    request<T = unknown>(url: string, options?: HurlRequestOptions): Promise<HurlResponse<T>>;
+    all<T extends unknown[]>(requests: {
+        [K in keyof T]: Promise<T[K]>;
+    }): Promise<T>;
+    defaults: {
+        set(d: HurlDefaults): void;
+        get(): HurlDefaults;
+        reset(): void;
+    };
+    interceptors: {
+        request: {
+            use(fn: RequestInterceptor): () => void;
+            clear(): void;
+        };
+        response: {
+            use(fn: ResponseInterceptor): () => void;
+            clear(): void;
+        };
+        error: {
+            use(fn: ErrorInterceptor): () => void;
+            clear(): void;
+        };
+    };
+    create(defaults?: HurlDefaults): HurlInstance;
+    extend(defaults?: HurlDefaults): HurlInstance;
+};
+
+declare function clearCache(): void;
+
+declare function createInstance(initialDefaults?: HurlDefaults): HurlInstance;
+declare const hurl: HurlInstance;
+
+export { type ErrorInterceptor, type HurlDefaults, HurlError, type HurlInstance, type HurlRequestOptions, type HurlResponse, type RequestInterceptor, type ResponseInterceptor, clearCache, createInstance, hurl as default };

package/dist/index.js

@@ -0,0 +1 @@
+"use strict";var I=Object.defineProperty;var ne=Object.getOwnPropertyDescriptor;var se=Object.getOwnPropertyNames;var oe=Object.prototype.hasOwnProperty;var ue=(e,r)=>{for(var t in r)I(e,t,{get:r[t],enumerable:!0})},ie=(e,r,t,n)=>{if(r&&typeof r=="object"||typeof r=="function")for(let s of se(r))!oe.call(e,s)&&s!==t&&I(e,s,{get:()=>r[s],enumerable:!(n=ne(r,s))||n.enumerable});return e};var le=e=>ie(I({},"__esModule",{value:!0}),e);var Re={};ue(Re,{HurlError:()=>l,clearCache:()=>J,createInstance:()=>O,default:()=>ge});module.exports=le(Re);var l=class extends Error{constructor(r){super(r.message),this.name="HurlError",this.type=r.type,this.status=r.status,this.statusText=r.statusText,this.data=r.data,this.headers=r.headers,this.requestId=r.requestId,this.retries=r.retries??0}};function $(e){return new l({message:`HTTP ${e.status}: ${e.statusText}`,type:"HTTP_ERROR",...e})}function v(e,r){return new l({message:e,type:"NETWORK_ERROR",requestId:r})}function F(e,r){return new l({message:`Request timed out after ${e}ms`,type:"TIMEOUT_ERROR",requestId:r})}function S(e){return new l({message:"Request was aborted",type:"ABORT_ERROR",requestId:e})}function B(e,r){return new l({message:`Failed to parse response: ${e}`,type:"PARSE_ERROR",requestId:r})}async function _(e,r){let t=e.body?.getReader(),n=parseInt(e.headers.get("content-length")??"0",10);if(!t)return e.text();let s=[],i=0;for(;;){let{done:u,value:a}=await t.read();if(u)break;s.push(a),i+=a.length,r({loaded:i,total:n,percent:n>0?Math.round(i/n*100):0})}let c=new Uint8Array(i),o=0;for(let u of s)c.set(u,o),o+=u.length;return new TextDecoder().decode(c)}function P(e){let r={};return e.forEach((t,n)=>{r[n]=t}),r}async function K(e,r,t){let n=e.headers.get("content-type")??"";try{if(t){let s=await _(e,t);return n.includes("application/json")?JSON.parse(s):s}return n.includes("application/json")?await e.json():n.includes("text/")?await e.text():n.includes("application/octet-stream")||n.includes("image/")?await e.arrayBuffer():await e.text()}catch(s){throw B(s.message,r)}}function L(e,r,t,n){let s=Date.now();return{data:e,status:r.status,statusText:r.statusText,headers:P(r.headers),requestId:t,timing:{start:n,end:s,duration:s-n},fromCache:!1}}function M(e,r,t){if(t.type==="bearer"&&(e.Authorization=`Bearer ${t.token}`),t.type==="basic"){let n=btoa(`${t.username}:${t.password}`);e.Authorization=`Basic ${n}`}t.type==="apikey"&&(t.in==="query"?r[t.key]=t.value:e[t.key]=t.value)}function j(e){return e==null?null:typeof e=="number"?{count:e,delay:300,backoff:"exponential"}:e}function N(e,r,t){return t>=r.count||e.type==="ABORT_ERROR"?!1:r.on&&e.status?r.on.includes(e.status):!!(e.type==="NETWORK_ERROR"||e.type==="TIMEOUT_ERROR"||e.status&&e.status>=500)}async function G(e,r){let t=e.delay??300,n=e.backoff==="exponential"?t*Math.pow(2,r):t*(r+1);await new Promise(s=>setTimeout(s,n))}var x=new Map;function k(e,r){return r?.key??e}function W(e){let r=x.get(e);return r?Date.now()>r.expiresAt?(x.delete(e),null):{...r.response,fromCache:!0}:null}function z(e,r,t){x.set(e,{response:r,expiresAt:Date.now()+t.ttl})}function J(){x.clear()}var C=new Map;function Q(e){return C.get(e)??null}function V(e,r){C.set(e,r),r.finally(()=>C.delete(e))}function X(e,r){console.group(`[hurl] \u2192 ${r.method??"GET"} ${e}`),r.headers&&Object.keys(r.headers).length>0&&console.log("headers:",r.headers),r.query&&console.log("query:",r.query),r.body&&console.log("body:",r.body),r.timeout&&console.log("timeout:",r.timeout),r.retry&&console.log("retry:",r.retry),console.groupEnd()}function A(e){let r=e.status>=400?"\u{1F534}":e.status>=300?"\u{1F7E1}":"\u{1F7E2}";console.group(`[hurl] ${r} ${e.status} ${e.statusText} (${e.timing.duration}ms)`),console.log("requestId:",e.requestId),e.fromCache&&console.log("served from cache"),console.log("headers:",e.headers),console.log("data:",e.data),console.groupEnd()}function Y(e){console.group("[hurl] \u{1F534} Error"),console.error(e),console.groupEnd()}function ae(){return Math.random().toString(36).slice(2,10)}function ce(e,r,t){let n;if(r.startsWith("http://")||r.startsWith("https://")){if(e){let i=new URL(e).origin,c=new URL(r).origin;if(i!==c)throw new Error(`Absolute URL "${r}" does not match baseUrl origin "${i}". Pass the full URL without baseUrl, or use a path-relative URL.`)}n=r}else{if(r.startsWith("//"))throw new Error("Protocol-relative URLs are not supported. Use an explicit https:// or http:// scheme.");n=e?`${e.replace(/\/$/,"")}/${r.replace(/^\//,"")}`:r}if(!t||Object.keys(t).length===0)return n;let s=new URLSearchParams;for(let[i,c]of Object.entries(t))s.set(i,String(c));return`${n}?${s.toString()}`}function pe(e,r){let t={...r.headers,...e.headers},n=e.body;return n&&typeof n=="object"&&!(n instanceof FormData)&&!(n instanceof Blob)&&(t["Content-Type"]=t["Content-Type"]??"application/json"),t}function fe(e){if(e!=null)return e instanceof FormData||e instanceof Blob||e instanceof ArrayBuffer||typeof e=="string"?e:JSON.stringify(e)}async function Z(e,r,t){let n=r.requestId??ae(),s=r.method??"GET",i=Date.now(),c=j(r.retry??t.retry),o=r.debug??t.debug??!1,u={...t.query,...r.query},a=pe(r,t),h=r.timeout??t.timeout,H=r.auth??t.auth;H&&M(a,u,H);let R=ce(t.baseUrl??"",e,Object.keys(u).length>0?u:void 0),m=r.cache??t.cache,p=!!m&&!m.bypass&&s==="GET";if(p){let d=k(R,m),T=W(d);if(T)return o&&A(T),T}let y=r.deduplicate??t.deduplicate??!1;if(y&&s==="GET"){let d=Q(R);if(d)return d}o&&X(R,{...r,method:s});let D=async d=>{let T=[],b=null,E=new AbortController;T.push(E),r.signal&&r.signal.addEventListener("abort",()=>E.abort()),h&&(b=setTimeout(()=>E.abort("timeout"),h));try{let f=await fetch(R,{method:s,headers:a,body:fe(r.body),signal:E.signal,redirect:r.followRedirects??!0?"follow":"manual"});b&&clearTimeout(b);let g=await K(f,n,r.onDownloadProgress);if(!f.ok)throw $({status:f.status,statusText:f.statusText,data:g,headers:P(f.headers),requestId:n,retries:d});let w=L(g,f,n,i);return p&&m&&z(k(R,m),w,m),o&&A(w),w}catch(f){b&&clearTimeout(b);let g;if(f instanceof l?g=f:f.name==="AbortError"?g=h&&f.message==="timeout"?F(h,n):S(n):g=v(f.message,n),g.retries=d,c&&N(g,c,d))return o&&console.log(`[hurl] retrying (${d+1}/${c.count})...`),await G(c,d),D(d+1);throw o&&Y(g),g}},U=D(0);return y&&s==="GET"&&V(R,U),U}function q(){let e=[];return{use(r){return e.push(r),()=>{let t=e.indexOf(r);t!==-1&&e.splice(t,1)}},clear(){e.length=0},getAll(){return[...e]}}}async function ee(e,r,t){let n={url:r,options:t};for(let s of e)n=await s(n.url,n.options);return n}async function re(e,r){let t=r;for(let n of e)t=await n(t);return t}async function te(e,r){let t=r;for(let n of e)t instanceof l&&(t=await n(t));return t}function O(e={}){let r={...e},t=q(),n=q(),s=q();async function i(o,u={}){let a=o,h=u,H=t.getAll(),R=n.getAll(),m=s.getAll();if(H.length>0){let p=await ee(H,o,u);a=p.url,h=p.options}try{let p=await Z(a,h,r);return R.length>0?await re(R,p):p}catch(p){if(p instanceof l&&m.length>0){let y=await te(m,p);if(!(y instanceof l))return y;throw y}throw p}}return{request:i,get(o,u){return i(o,{...u,method:"GET"})},post(o,u,a){return i(o,{...a,method:"POST",body:u})},put(o,u,a){return i(o,{...a,method:"PUT",body:u})},patch(o,u,a){return i(o,{...a,method:"PATCH",body:u})},delete(o,u){return i(o,{...u,method:"DELETE"})},head(o,u){return i(o,{...u,method:"HEAD"})},options(o,u){return i(o,{...u,method:"OPTIONS"})},all(o){return Promise.all(o)},defaults:{set(o){r={...r,...o}},get(){return{...r}},reset(){r={...e}}},interceptors:{request:{use:t.use.bind(t),clear:t.clear.bind(t)},response:{use:n.use.bind(n),clear:n.clear.bind(n)},error:{use:s.use.bind(s),clear:s.clear.bind(s)}},create(o){return O({...r,...o})},extend(o){return O({...r,...o})}}}var de=O(),ge=de;0&&(module.exports={HurlError,clearCache,createInstance});

package/dist/index.mjs

@@ -0,0 +1 @@
+var l=class extends Error{constructor(r){super(r.message),this.name="HurlError",this.type=r.type,this.status=r.status,this.statusText=r.statusText,this.data=r.data,this.headers=r.headers,this.requestId=r.requestId,this.retries=r.retries??0}};function U(e){return new l({message:`HTTP ${e.status}: ${e.statusText}`,type:"HTTP_ERROR",...e})}function $(e,r){return new l({message:e,type:"NETWORK_ERROR",requestId:r})}function v(e,r){return new l({message:`Request timed out after ${e}ms`,type:"TIMEOUT_ERROR",requestId:r})}function F(e){return new l({message:"Request was aborted",type:"ABORT_ERROR",requestId:e})}function S(e,r){return new l({message:`Failed to parse response: ${e}`,type:"PARSE_ERROR",requestId:r})}async function B(e,r){let t=e.body?.getReader(),n=parseInt(e.headers.get("content-length")??"0",10);if(!t)return e.text();let o=[],i=0;for(;;){let{done:u,value:a}=await t.read();if(u)break;o.push(a),i+=a.length,r({loaded:i,total:n,percent:n>0?Math.round(i/n*100):0})}let c=new Uint8Array(i),s=0;for(let u of o)c.set(u,s),s+=u.length;return new TextDecoder().decode(c)}function O(e){let r={};return e.forEach((t,n)=>{r[n]=t}),r}async function _(e,r,t){let n=e.headers.get("content-type")??"";try{if(t){let o=await B(e,t);return n.includes("application/json")?JSON.parse(o):o}return n.includes("application/json")?await e.json():n.includes("text/")?await e.text():n.includes("application/octet-stream")||n.includes("image/")?await e.arrayBuffer():await e.text()}catch(o){throw S(o.message,r)}}function K(e,r,t,n){let o=Date.now();return{data:e,status:r.status,statusText:r.statusText,headers:O(r.headers),requestId:t,timing:{start:n,end:o,duration:o-n},fromCache:!1}}function L(e,r,t){if(t.type==="bearer"&&(e.Authorization=`Bearer ${t.token}`),t.type==="basic"){let n=btoa(`${t.username}:${t.password}`);e.Authorization=`Basic ${n}`}t.type==="apikey"&&(t.in==="query"?r[t.key]=t.value:e[t.key]=t.value)}function M(e){return e==null?null:typeof e=="number"?{count:e,delay:300,backoff:"exponential"}:e}function j(e,r,t){return t>=r.count||e.type==="ABORT_ERROR"?!1:r.on&&e.status?r.on.includes(e.status):!!(e.type==="NETWORK_ERROR"||e.type==="TIMEOUT_ERROR"||e.status&&e.status>=500)}async function N(e,r){let t=e.delay??300,n=e.backoff==="exponential"?t*Math.pow(2,r):t*(r+1);await new Promise(o=>setTimeout(o,n))}var x=new Map;function I(e,r){return r?.key??e}function G(e){let r=x.get(e);return r?Date.now()>r.expiresAt?(x.delete(e),null):{...r.response,fromCache:!0}:null}function W(e,r,t){x.set(e,{response:r,expiresAt:Date.now()+t.ttl})}function re(){x.clear()}var P=new Map;function z(e){return P.get(e)??null}function J(e,r){P.set(e,r),r.finally(()=>P.delete(e))}function Q(e,r){console.group(`[hurl] \u2192 ${r.method??"GET"} ${e}`),r.headers&&Object.keys(r.headers).length>0&&console.log("headers:",r.headers),r.query&&console.log("query:",r.query),r.body&&console.log("body:",r.body),r.timeout&&console.log("timeout:",r.timeout),r.retry&&console.log("retry:",r.retry),console.groupEnd()}function k(e){let r=e.status>=400?"\u{1F534}":e.status>=300?"\u{1F7E1}":"\u{1F7E2}";console.group(`[hurl] ${r} ${e.status} ${e.statusText} (${e.timing.duration}ms)`),console.log("requestId:",e.requestId),e.fromCache&&console.log("served from cache"),console.log("headers:",e.headers),console.log("data:",e.data),console.groupEnd()}function V(e){console.group("[hurl] \u{1F534} Error"),console.error(e),console.groupEnd()}function te(){return Math.random().toString(36).slice(2,10)}function ne(e,r,t){let n;if(r.startsWith("http://")||r.startsWith("https://")){if(e){let i=new URL(e).origin,c=new URL(r).origin;if(i!==c)throw new Error(`Absolute URL "${r}" does not match baseUrl origin "${i}". Pass the full URL without baseUrl, or use a path-relative URL.`)}n=r}else{if(r.startsWith("//"))throw new Error("Protocol-relative URLs are not supported. Use an explicit https:// or http:// scheme.");n=e?`${e.replace(/\/$/,"")}/${r.replace(/^\//,"")}`:r}if(!t||Object.keys(t).length===0)return n;let o=new URLSearchParams;for(let[i,c]of Object.entries(t))o.set(i,String(c));return`${n}?${o.toString()}`}function se(e,r){let t={...r.headers,...e.headers},n=e.body;return n&&typeof n=="object"&&!(n instanceof FormData)&&!(n instanceof Blob)&&(t["Content-Type"]=t["Content-Type"]??"application/json"),t}function oe(e){if(e!=null)return e instanceof FormData||e instanceof Blob||e instanceof ArrayBuffer||typeof e=="string"?e:JSON.stringify(e)}async function X(e,r,t){let n=r.requestId??te(),o=r.method??"GET",i=Date.now(),c=M(r.retry??t.retry),s=r.debug??t.debug??!1,u={...t.query,...r.query},a=se(r,t),h=r.timeout??t.timeout,H=r.auth??t.auth;H&&L(a,u,H);let R=ne(t.baseUrl??"",e,Object.keys(u).length>0?u:void 0),m=r.cache??t.cache,p=!!m&&!m.bypass&&o==="GET";if(p){let d=I(R,m),T=G(d);if(T)return s&&k(T),T}let y=r.deduplicate??t.deduplicate??!1;if(y&&o==="GET"){let d=z(R);if(d)return d}s&&Q(R,{...r,method:o});let A=async d=>{let T=[],b=null,E=new AbortController;T.push(E),r.signal&&r.signal.addEventListener("abort",()=>E.abort()),h&&(b=setTimeout(()=>E.abort("timeout"),h));try{let f=await fetch(R,{method:o,headers:a,body:oe(r.body),signal:E.signal,redirect:r.followRedirects??!0?"follow":"manual"});b&&clearTimeout(b);let g=await _(f,n,r.onDownloadProgress);if(!f.ok)throw U({status:f.status,statusText:f.statusText,data:g,headers:O(f.headers),requestId:n,retries:d});let w=K(g,f,n,i);return p&&m&&W(I(R,m),w,m),s&&k(w),w}catch(f){b&&clearTimeout(b);let g;if(f instanceof l?g=f:f.name==="AbortError"?g=h&&f.message==="timeout"?v(h,n):F(n):g=$(f.message,n),g.retries=d,c&&j(g,c,d))return s&&console.log(`[hurl] retrying (${d+1}/${c.count})...`),await N(c,d),A(d+1);throw s&&V(g),g}},D=A(0);return y&&o==="GET"&&J(R,D),D}function q(){let e=[];return{use(r){return e.push(r),()=>{let t=e.indexOf(r);t!==-1&&e.splice(t,1)}},clear(){e.length=0},getAll(){return[...e]}}}async function Y(e,r,t){let n={url:r,options:t};for(let o of e)n=await o(n.url,n.options);return n}async function Z(e,r){let t=r;for(let n of e)t=await n(t);return t}async function ee(e,r){let t=r;for(let n of e)t instanceof l&&(t=await n(t));return t}function C(e={}){let r={...e},t=q(),n=q(),o=q();async function i(s,u={}){let a=s,h=u,H=t.getAll(),R=n.getAll(),m=o.getAll();if(H.length>0){let p=await Y(H,s,u);a=p.url,h=p.options}try{let p=await X(a,h,r);return R.length>0?await Z(R,p):p}catch(p){if(p instanceof l&&m.length>0){let y=await ee(m,p);if(!(y instanceof l))return y;throw y}throw p}}return{request:i,get(s,u){return i(s,{...u,method:"GET"})},post(s,u,a){return i(s,{...a,method:"POST",body:u})},put(s,u,a){return i(s,{...a,method:"PUT",body:u})},patch(s,u,a){return i(s,{...a,method:"PATCH",body:u})},delete(s,u){return i(s,{...u,method:"DELETE"})},head(s,u){return i(s,{...u,method:"HEAD"})},options(s,u){return i(s,{...u,method:"OPTIONS"})},all(s){return Promise.all(s)},defaults:{set(s){r={...r,...s}},get(){return{...r}},reset(){r={...e}}},interceptors:{request:{use:t.use.bind(t),clear:t.clear.bind(t)},response:{use:n.use.bind(n),clear:n.clear.bind(n)},error:{use:o.use.bind(o),clear:o.clear.bind(o)}},create(s){return C({...r,...s})},extend(s){return C({...r,...s})}}}var ue=C(),Qe=ue;export{l as HurlError,re as clearCache,C as createInstance,Qe as default};

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@firekid/hurl",
+  "version": "1.0.0",
+  "description": "The modern HTTP client. Axios DX. Fetch speed. Zero dependencies.",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --minify --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": ["http", "https", "fetch", "axios", "request", "client", "typescript", "edge", "proxy", "retry"],
+  "license": "MIT",
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0",
+    "@types/node": "^20.0.0"
+  }
+}