dexix-request 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.0] - 2026-07-13
+
+### Added
+
+- **Interceptors.** `dx.interceptors.request.use()` and `dx.interceptors.response.use()`, matching Axios's chaining model — mutate outgoing config, transform resolved data, or recover from a rejected request. Every interceptor returns an id that can be passed to `.eject()`.
+- **Built-in retries.** `retries`, `retryDelay` (fixed or a `(attempt, error) => ms` function), and `retryOn` (custom predicate) on any request or on `dx.create()` defaults. Defaults to exponential backoff on `5xx`, `429`, network failures, and timeouts — no extra package required.
+- **`dx` / `dexix` CLI.** A colorful command-line client bundled with the package (`npx dx get <url>`), supporting headers, query params, JSON bodies (inline or `@file.json`), timeouts, retries, `-i`/`-s` output modes, and colorized JSON output.
+- A friendly, colorized welcome banner on `npm install` (skipped automatically in CI and non-interactive shells).
+
+### Changed
+
+- Internal source is now comment-free; behavior is documented in the README and via descriptive naming instead.
+
 ## [1.0.0] - 2026-07-12
 
 ### Added
@@ -21,3 +34,4 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Zero runtime dependencies. ESM and CommonJS builds, tree-shakeable, under 5KB gzipped.
 - `onRequest` / `onResponse` hooks for logging, auth injection, and observability.
 - Full test suite covering GET, POST, PUT, DELETE, error handling, timeouts, and JSON parsing.
+

package/README.md

@@ -1,22 +1,22 @@
 <div align="center">
 
-<img src="https://raw.githubusercontent.com/dexix-dev/dexix-request/main/.github/logo-placeholder.svg" width="88" height="88" alt="DexiX Request logo" />
+<img src="https://raw.githubusercontent.com/AkbariCodes/DexiX-Request/main/.github/logo-placeholder.svg" width="88" height="88" alt="DexiX Request logo" />
 
 # DexiX Request
 
 **If Axios were redesigned from scratch in 2026.**
 
-A tiny, modern, zero-dependency HTTP client for JavaScript and TypeScript — for the browser, Node.js, and React.
+A tiny, zero-dependency HTTP client for JavaScript and TypeScript — with interceptors, built-in retries, and a CLI you'll actually enjoy typing into. For the browser, Node.js, and React.
 
 [![npm version](https://img.shields.io/npm/v/dexix-request.svg?color=blue)](https://www.npmjs.com/package/dexix-request)
 [![npm downloads](https://img.shields.io/npm/dm/dexix-request.svg)](https://www.npmjs.com/package/dexix-request)
 [![bundle size](https://img.shields.io/bundlephobia/minzip/dexix-request)](https://bundlephobia.com/package/dexix-request)
-[![CI](https://github.com/dexix-dev/dexix-request/actions/workflows/ci.yml/badge.svg)](https://github.com/dexix-dev/dexix-request/actions/workflows/ci.yml)
+[![CI](https://github.com/AkbariCodes/DexiX-Request/actions/workflows/ci.yml/badge.svg)](https://github.com/AkbariCodes/DexiX-Request/actions/workflows/ci.yml)
 [![types](https://img.shields.io/npm/types/dexix-request.svg)](https://www.npmjs.com/package/dexix-request)
 [![license](https://img.shields.io/npm/l/dexix-request.svg)](./LICENSE)
 [![zero dependencies](https://img.shields.io/badge/dependencies-0-brightgreen)](./package.json)
 
-[Quick Start](#quick-start) · [Features](#features) · [API Reference](#api-reference) · [Why DexiX](#why-dexix-request) · [Comparison](#comparison-with-axios) · [FAQ](#faq)
+[Quick Start](#quick-start) · [CLI](#cli) · [Interceptors](#interceptors) · [Retries](#retries) · [API Reference](#api-reference) · [Comparison](#comparison-with-axios) · [FAQ](#faq)
 
 </div>
 
@@ -36,24 +36,21 @@ pnpm add dexix-request
 yarn add dexix-request
 ```
 
-No peer dependencies. No polyfills required in any environment that has `fetch` (all evergreen browsers, and Node.js 20+).
+No peer dependencies. No polyfills required in any environment that has `fetch` (all evergreen browsers, and Node.js 20+). Installing it also gives you a `dx` command in your terminal — see [CLI](#cli).
 
 ## Quick Start
 
 ```ts
 import dx from "dexix-request";
 
-// Calling the instance directly performs a GET request.
 const users = await dx("/users");
 
-// Method helpers for everything else.
 const user = await dx.get<User>("/users/1");
 
 await dx.post("/posts", {
   title: "Hello DexiX",
 });
 
-// Scoped instances for talking to a specific API.
 const api = dx.create({
   baseURL: "https://api.example.com",
   headers: { Authorization: "Bearer token" },
@@ -67,15 +64,56 @@ That's it. No `response.json()`. No `axios.create()` boilerplate. No config obje
 ## Features
 
 - ✅ **Extremely simple API** — call the instance directly, or use `.get` / `.post` / `.put` / `.patch` / `.delete` / `.head` / `.options`
+- ✅ **Interceptor chains** — `dx.interceptors.request.use()` and `dx.interceptors.response.use()`, with recovery on rejection
+- ✅ **Built-in retries** — exponential backoff on `5xx`/`429`/network failures, fully configurable, no extra package
+- ✅ **A real CLI** — `dx get https://api.example.com` from your terminal, colorized, zero setup
 - ✅ **Automatic JSON** — request bodies are serialized and response bodies are parsed for you
 - ✅ **Zero dependencies** — nothing to audit, nothing to update, nothing to break
-- ✅ **Tiny** — ~2KB gzipped, tree-shakeable, side-effect free
+- ✅ **Tiny** — ~2.6KB gzipped, tree-shakeable, side-effect free
 - ✅ **Modern TypeScript** — full generics, strict types, no `any` in the public API
 - ✅ **Built on the platform** — `fetch`, `AbortController`, `URLSearchParams`, `ReadableStream`, `FormData` — nothing reinvented
 - ✅ **Composable timeouts** — `timeout` and a caller-supplied `AbortSignal` work together, not against each other
 - ✅ **Rich errors** — `NetworkError`, `TimeoutError`, `HTTPError`, and `ParseError`, each carrying the request and response
 - ✅ **Works everywhere** — browser, Node.js 20+, React, Next.js, Vite, ESM, and CommonJS
 
+## CLI
+
+Every install of `dexix-request` ships a command-line client — no separate install, no `curl` flag-soup to remember.
+
+```bash
+dx get https://api.example.com/users
+dx post https://api.example.com/users -d '{"name":"Ada"}'
+dx get https://api.example.com/users -H "authorization: Bearer xyz" -i
+npx dx get https://api.example.com/users        # without installing globally
+```
+
+```
+$ dx get api.example.com/users -q limit=2 -i
+200 OK · 84ms
+content-type: application/json
+...
+
+{
+  "id": 1,
+  "name": "Ada Lovelace"
+}
+```
+
+| Flag | Description |
+| --- | --- |
+| `-H, --header <k:v>` | Add a request header (repeatable) |
+| `-d, --data <json>` | Request body; use `@file.json` to read from a file |
+| `-q, --query <k=v>` | Add a query parameter (repeatable) |
+| `-t, --timeout <ms>` | Abort the request after N milliseconds |
+| `-i, --include` | Print response status and headers |
+| `-o, --output <file>` | Write the response body to a file |
+| `-s, --silent` | Print only the response body |
+| `--retries <n>` | Retry failed requests up to `n` times |
+| `--no-color` | Disable colored output |
+| `-v, --version` / `-h, --help` | Print version / usage |
+
+The CLI is a thin, dependency-free script (`bin/dexix.mjs`) — it doesn't pull in `chalk`, `commander`, or anything else. Same philosophy as the library: built on what the platform already gives you. It's also why installing the package with `npm install` greets you with a small welcome banner instead of silence.
+
 ## Examples
 
 ### JavaScript
@@ -141,6 +179,49 @@ function useUser(id: number) {
 
 More complete examples live in [`examples/`](./examples): [Node.js](./examples/node.mjs), [browser](./examples/browser.js), [React](./examples/react-example.tsx), and [TypeScript](./examples/typescript-example.ts).
 
+## Interceptors
+
+Attach behavior to every request or response an instance makes — auth injection, logging, response reshaping, or error recovery.
+
+```ts
+import dx, { HTTPError } from "dexix-request";
+
+dx.interceptors.request.use((config) => ({
+  ...config,
+  headers: { ...config.headers, Authorization: `Bearer ${getToken()}` },
+}));
+
+dx.interceptors.response.use(
+  (data) => data,
+  async (error) => {
+    if (error instanceof HTTPError && error.status === 401) {
+      await refreshToken();
+      return dx(error.request.url);
+    }
+    throw error;
+  },
+);
+
+const id = dx.interceptors.request.use((config) => config);
+dx.interceptors.request.eject(id);
+```
+
+Request interceptors receive and return a `ResolvedRequestConfig`. Response interceptors receive and return the resolved value (or, in the rejection handler, the thrown error — return a value to recover, or re-throw to propagate). Interceptors are per-instance, so `dx.create()` gives you an isolated chain.
+
+## Retries
+
+Flaky networks and cold-starting APIs are normal. DexiX Request retries them for you, with sane defaults and full control when you need it.
+
+```ts
+await dx.get("/orders", {
+  retries: 3,
+  retryDelay: (attempt) => attempt * 500,
+  retryOn: (error) => error instanceof HTTPError && error.status >= 500,
+});
+```
+
+By default, `retries` is `0` (no surprises), and when you do set it, failures are retried with exponential backoff (`250ms, 500ms, 1000ms, ...` capped at 8s) on `5xx` responses, `429`, `NetworkError`, and `TimeoutError`. Set `retryOn` to fully replace that logic.
+
 ## API Reference
 
 ### `dx(url, config?)`
@@ -165,30 +246,38 @@ Every method returns a `Promise<T>` that resolves with the already-parsed respon
 
 ### `dx.create(config?)`
 
-Creates a new, independent instance with its own defaults. Config passed to individual requests is merged on top of (and overrides) the instance's defaults.
+Creates a new, independent instance with its own defaults and its own interceptor chains. Config passed to individual requests is merged on top of (and overrides) the instance's defaults.
 
 ```ts
 const api = dx.create({
   baseURL: "https://api.example.com",
   headers: { "X-App": "my-app" },
   timeout: 10_000,
+  retries: 2,
 });
 ```
 
+### `dx.interceptors.request` / `dx.interceptors.response`
+
+`DexiXInterceptorManager` with `.use(onFulfilled, onRejected?)`, `.eject(id)`, and `.clear()`. See [Interceptors](#interceptors).
+
 ### `RequestConfig`
 
-| Option          | Type                                    | Description                                                     |
-| --------------- | ---------------------------------------- | ----------------------------------------------------------------|
-| `baseURL`       | `string`                                 | Prepended to relative URLs.                                     |
-| `headers`       | `HeadersInit \| Record<string, string>`  | Merged with instance defaults; per-request wins.                |
-| `query`         | `Record<string, ...>`                    | Serialized into the URL's query string. Arrays become repeated keys. |
-| `body`          | `BodyInit \| object \| unknown[]`        | Plain objects/arrays are JSON-serialized automatically.         |
-| `timeout`       | `number`                                 | Milliseconds before the request is aborted with `TimeoutError`. |
-| `signal`        | `AbortSignal`                            | Composed with the internal timeout signal.                      |
-| `responseType`  | `"json" \| "text" \| "blob" \| "arrayBuffer" \| "stream"` | Overrides automatic response parsing.      |
-| `credentials`, `cache`, `redirect`, `referrerPolicy`, `mode` | — | Forwarded straight to `fetch`.             |
-| `onRequest`     | `(request: Request) => void`             | Called with the final `Request` before it's sent.                |
-| `onResponse`    | `(response: Response) => void`           | Called with the raw `Response` before the body is parsed.       |
+| Option | Type | Description |
+| --- | --- | --- |
+| `baseURL` | `string` | Prepended to relative URLs. |
+| `headers` | `HeadersInit \| Record<string, string>` | Merged with instance defaults; per-request wins. |
+| `query` | `Record<string, ...>` | Serialized into the URL's query string. Arrays become repeated keys. |
+| `body` | `BodyInit \| object \| unknown[]` | Plain objects/arrays are JSON-serialized automatically. |
+| `timeout` | `number` | Milliseconds before the request is aborted with `TimeoutError`. |
+| `signal` | `AbortSignal` | Composed with the internal timeout signal. |
+| `retries` | `number` | Number of retry attempts after the first failure. Default `0`. |
+| `retryDelay` | `number \| (attempt, error) => number` | Delay before each retry. Default exponential backoff. |
+| `retryOn` | `(error, attempt) => boolean` | Overrides which errors are retried. |
+| `responseType` | `"json" \| "text" \| "blob" \| "arrayBuffer" \| "stream"` | Overrides automatic response parsing. |
+| `credentials`, `cache`, `redirect`, `referrerPolicy`, `mode` | — | Forwarded straight to `fetch`. |
+| `onRequest` | `(request: Request) => void` | Called with the final `Request` before it's sent. |
+| `onResponse` | `(response: Response) => void` | Called with the raw `Response` before the body is parsed. |
 
 ## Error Handling
 
@@ -201,16 +290,12 @@ try {
   await dx.get("/users/1");
 } catch (error) {
   if (error instanceof HTTPError) {
-    // Server responded with a non-2xx status.
     console.error(error.status, error.response?.data);
   } else if (error instanceof TimeoutError) {
-    // Request exceeded `timeout`.
     console.error(`Timed out after ${error.timeout}ms`);
   } else if (error instanceof NetworkError) {
-    // The request never reached a server (offline, DNS, CORS, etc).
     console.error(error.message);
   } else if (error instanceof ParseError) {
-    // A response body couldn't be parsed as JSON/text/etc.
     console.error(error.message);
   }
 }
@@ -229,7 +314,7 @@ Every DexiX error carries:
 
 Most HTTP clients fall into one of two camps: a thin `fetch` wrapper that still makes you write `response.json()` everywhere, or a heavyweight library carrying years of legacy API surface and a dependency tree of its own.
 
-DexiX Request is neither. It's built directly on the platform primitives that already ship in every modern runtime — `fetch`, `AbortController`, `Headers`, `URLSearchParams`, `FormData`, `ReadableStream` — and adds exactly one thing on top: an API that gets out of your way.
+DexiX Request is neither. It's built directly on the platform primitives that already ship in every modern runtime — `fetch`, `AbortController`, `Headers`, `URLSearchParams`, `FormData`, `ReadableStream` — and adds exactly what a modern client needs on top: interceptors, retries, and a CLI, without a single dependency.
 
 - No dependencies to audit or update.
 - No custom body-parsing logic to trust — you get real `Headers`, real `Request`, real `Response` under the hood.
@@ -240,10 +325,12 @@ DexiX Request is neither. It's built directly on the platform primitives that al
 | | DexiX Request | Axios |
 | --- | --- | --- |
 | Dependencies | 0 | 0 (as of v1, but larger internal surface) |
-| Bundle size (gzip) | ~2KB | ~13KB |
+| Bundle size (gzip) | ~2.6KB | ~13KB |
 | Transport | `fetch` | `XMLHttpRequest` (browser) / `http` (Node) |
 | TypeScript | Written in TS, strict, no `any` | Typed via bundled `.d.ts`, some `any` |
-| Interceptors | `onRequest` / `onResponse` hooks | Interceptor chain |
+| Interceptors | Request/response chains with rejection recovery | Interceptor chain |
+| Built-in retries | Yes, configurable backoff | No (requires `axios-retry`) |
+| CLI included | Yes (`dx`) | No |
 | Cancellation | Native `AbortSignal`, composable with `timeout` | Native `AbortSignal` (v1+) or legacy `CancelToken` |
 | Default body parsing | Automatic JSON | Automatic JSON |
 | Node.js support | 20+ (uses global `fetch`) | Broad, including legacy Node |
@@ -253,13 +340,12 @@ DexiX Request intentionally supports fewer legacy environments in exchange for a
 
 ## Roadmap
 
-- [ ] Request/response interceptor chains (beyond `onRequest`/`onResponse`)
-- [ ] Built-in retry with configurable backoff
 - [ ] Upload/download progress events
 - [ ] Automatic request deduplication
 - [ ] Optional plugin for schema validation (Zod/Valibot) on responses
+- [ ] CLI: `--jq`-style response filtering
 
-Have an idea? [Open an issue](https://github.com/dexix-dev/dexix-request/issues).
+Have an idea? [Open an issue](https://github.com/AkbariCodes/DexiX-Request/issues).
 
 ## Browser Support
 
@@ -267,24 +353,25 @@ All browsers with `fetch`, `AbortController`, and `URLSearchParams` support —
 
 ## Performance
 
-- **Bundle size:** ~2KB gzipped, well under the 5KB target
+- **Bundle size:** ~2.6KB gzipped
 - **Zero dependencies:** nothing extra ships in your `node_modules` or your bundle
 - **Tree-shakeable:** unused exports (individual error classes, `createInstance`) are dropped by any modern bundler
-- **Minimal allocations:** a single `Headers` merge and a single `Request` construction per call — no intermediate wrapper objects
+- **Minimal allocations:** a single `Headers` merge and a single `Request` construction per attempt — no intermediate wrapper objects
 
 ## Developer Experience
 
-- Every public function is documented with JSDoc, so your editor shows real descriptions, not just type signatures.
+- Fully typed public API — every method, config option, and error class is a real TypeScript type your editor can autocomplete against.
 - Errors are specific and typed, so `catch` blocks can branch with `instanceof` instead of parsing error strings.
-- `dx.create()` returns a fully independent instance — no shared mutable state, no surprises across modules.
+- `dx.create()` returns a fully independent instance — its own defaults, its own interceptor chains, no shared mutable state.
+- The source itself is intentionally comment-free: behavior lives in small, clearly named functions rather than prose next to the code, and this README is the source of truth for *why*.
 
 ## Contributing
 
 Contributions are welcome. To get started:
 
 ```bash
-git clone https://github.com/dexix-dev/dexix-request.git
-cd dexix-request/packages/request
+git clone https://github.com/AkbariCodes/DexiX-Request.git
+cd DexiX-Request
 npm install
 npm run test
 ```
@@ -321,7 +408,10 @@ controller.abort();
 ```
 
 **Does DexiX Request retry failed requests automatically?**
-Not yet — automatic retry with backoff is on the [roadmap](#roadmap). Today, wrap a call in your own retry logic if needed.
+Only if you ask it to — set `retries` on a request or on `dx.create()` defaults. See [Retries](#retries).
+
+**Does installing this package run arbitrary code on my machine?**
+The `postinstall` script only prints a colored welcome message to your terminal — no network calls, no file writes outside your terminal's stdout. It skips itself entirely in CI or any non-interactive shell.
 
 ## License
 

package/bin/dexix.mjs

@@ -0,0 +1,279 @@
+#!/usr/bin/env node
+
+const COLOR = process.stdout.isTTY && !process.env.NO_COLOR;
+
+const c = {
+  reset: (s) => (COLOR ? `\x1b[0m${s}\x1b[0m` : s),
+  bold: (s) => (COLOR ? `\x1b[1m${s}\x1b[0m` : s),
+  dim: (s) => (COLOR ? `\x1b[2m${s}\x1b[0m` : s),
+  red: (s) => (COLOR ? `\x1b[31m${s}\x1b[0m` : s),
+  green: (s) => (COLOR ? `\x1b[32m${s}\x1b[0m` : s),
+  yellow: (s) => (COLOR ? `\x1b[33m${s}\x1b[0m` : s),
+  blue: (s) => (COLOR ? `\x1b[34m${s}\x1b[0m` : s),
+  magenta: (s) => (COLOR ? `\x1b[35m${s}\x1b[0m` : s),
+  cyan: (s) => (COLOR ? `\x1b[36m${s}\x1b[0m` : s),
+  gray: (s) => (COLOR ? `\x1b[90m${s}\x1b[0m` : s),
+};
+
+const METHODS = new Set(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]);
+const VERSION = "1.1.0";
+
+function printHelp() {
+  console.log(`
+${c.bold(c.cyan("DexiX"))} ${c.dim(`v${VERSION}`)} — a tiny, fast HTTP client for your terminal
+
+${c.bold("Usage")}
+  ${c.green("dx")} ${c.yellow("<method>")} ${c.magenta("<url>")} [options]
+  ${c.green("dx")} ${c.magenta("<url>")}                  ${c.dim("(defaults to GET)")}
+
+${c.bold("Methods")}
+  get, post, put, patch, delete, head, options
+
+${c.bold("Options")}
+  -H, --header <k:v>     Add a request header ${c.dim("(repeatable)")}
+  -d, --data <json>      Request body. Use ${c.cyan("@file.json")} to read from a file
+  -q, --query <k=v>      Add a query parameter ${c.dim("(repeatable)")}
+  -t, --timeout <ms>     Abort the request after N milliseconds
+  -i, --include          Print response status and headers
+  -o, --output <file>    Write the response body to a file
+  -s, --silent           Print only the response body
+      --retries <n>      Retry failed requests up to n times
+      --no-color         Disable colored output
+  -v, --version          Print the CLI version
+  -h, --help             Show this help message
+
+${c.bold("Examples")}
+  ${c.gray("$")} dx get https://api.example.com/users
+  ${c.gray("$")} dx post https://api.example.com/users -d '{"name":"Ada"}'
+  ${c.gray("$")} dx https://api.example.com/users -H "authorization: Bearer xyz" -i
+`);
+}
+
+function parseArgs(argv) {
+  const args = [...argv];
+  let method = "GET";
+  let url;
+
+  if (args.length && METHODS.has(String(args[0]).toUpperCase())) {
+    method = args.shift().toUpperCase();
+  }
+
+  const options = {
+    headers: {},
+    query: {},
+    data: undefined,
+    timeout: undefined,
+    include: false,
+    silent: false,
+    output: undefined,
+    retries: 0,
+  };
+
+  while (args.length) {
+    const token = args.shift();
+
+    if (!url && !token.startsWith("-")) {
+      url = token;
+      continue;
+    }
+
+    switch (token) {
+      case "-H":
+      case "--header": {
+        const value = args.shift() ?? "";
+        const index = value.indexOf(":");
+        if (index !== -1) {
+          options.headers[value.slice(0, index).trim()] = value.slice(index + 1).trim();
+        }
+        break;
+      }
+      case "-d":
+      case "--data":
+        options.data = args.shift();
+        break;
+      case "-q":
+      case "--query": {
+        const value = args.shift() ?? "";
+        const index = value.indexOf("=");
+        if (index !== -1) {
+          options.query[value.slice(0, index)] = value.slice(index + 1);
+        }
+        break;
+      }
+      case "-t":
+      case "--timeout":
+        options.timeout = Number(args.shift());
+        break;
+      case "-i":
+      case "--include":
+        options.include = true;
+        break;
+      case "-s":
+      case "--silent":
+        options.silent = true;
+        break;
+      case "-o":
+      case "--output":
+        options.output = args.shift();
+        break;
+      case "--retries":
+        options.retries = Number(args.shift());
+        break;
+      case "--no-color":
+        break;
+      case "-h":
+      case "--help":
+        printHelp();
+        process.exit(0);
+        break;
+      case "-v":
+      case "--version":
+        console.log(VERSION);
+        process.exit(0);
+        break;
+      default:
+        break;
+    }
+  }
+
+  return { method, url, options };
+}
+
+async function readBody(data) {
+  if (!data) return undefined;
+
+  if (data.startsWith("@")) {
+    const { readFile } = await import("node:fs/promises");
+    const raw = await readFile(data.slice(1), "utf8");
+    try {
+      return JSON.parse(raw);
+    } catch {
+      return raw;
+    }
+  }
+
+  try {
+    return JSON.parse(data);
+  } catch {
+    return data;
+  }
+}
+
+function buildURL(rawURL, query) {
+  const url = new URL(rawURL);
+  for (const [key, value] of Object.entries(query)) {
+    url.searchParams.append(key, value);
+  }
+  return url.toString();
+}
+
+function statusColor(status) {
+  if (status >= 500) return c.red;
+  if (status >= 400) return c.yellow;
+  if (status >= 300) return c.cyan;
+  if (status >= 200) return c.green;
+  return c.gray;
+}
+
+function colorizeJSON(json) {
+  if (!COLOR) return json;
+  return json
+    .replace(/"([^"]+)":/g, (_, key) => `${c.cyan(`"${key}"`)}:`)
+    .replace(/: "([^"]*)"/g, (_, value) => `: ${c.green(`"${value}"`)}`)
+    .replace(/: (-?\d+\.?\d*)/g, (_, value) => `: ${c.yellow(value)}`)
+    .replace(/: (true|false)/g, (_, value) => `: ${c.magenta(value)}`)
+    .replace(/: (null)/g, (_, value) => `: ${c.gray(value)}`);
+}
+
+const spinnerFrames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+
+function startSpinner(label) {
+  if (!COLOR) return () => {};
+  let frame = 0;
+  const timer = setInterval(() => {
+    process.stderr.write(`\r${c.cyan(spinnerFrames[frame % spinnerFrames.length])} ${label}`);
+    frame += 1;
+  }, 80);
+  return () => {
+    clearInterval(timer);
+    process.stderr.write(`\r${" ".repeat(label.length + 4)}\r`);
+  };
+}
+
+async function main() {
+  const { method, url, options } = parseArgs(process.argv.slice(2));
+
+  if (!url) {
+    printHelp();
+    process.exit(1);
+  }
+
+  const requestURL = buildURL(url, options.query);
+  const body = await readBody(options.data);
+  const stopSpinner = options.silent ? () => {} : startSpinner(`${method} ${requestURL}`);
+  const startedAt = Date.now();
+
+  const init = {
+    method,
+    headers: { "content-type": "application/json", ...options.headers },
+    signal: options.timeout ? AbortSignal.timeout(options.timeout) : undefined,
+  };
+
+  if (body !== undefined && method !== "GET" && method !== "HEAD") {
+    init.body = typeof body === "string" ? body : JSON.stringify(body);
+  }
+
+  let response;
+  let attempts = 0;
+
+  while (true) {
+    attempts += 1;
+    try {
+      response = await fetch(requestURL, init);
+      if (!response.ok && attempts <= options.retries && response.status >= 500) {
+        continue;
+      }
+      break;
+    } catch (error) {
+      if (attempts <= options.retries) continue;
+      stopSpinner();
+      console.error(c.red(`✖ ${error instanceof Error ? error.message : String(error)}`));
+      process.exit(1);
+    }
+  }
+
+  stopSpinner();
+
+  const elapsed = Date.now() - startedAt;
+  const contentType = response.headers.get("content-type") ?? "";
+  const isJSON = contentType.includes("json");
+  const text = await response.text();
+
+  if (!options.silent) {
+    const color = statusColor(response.status);
+    console.error(
+      `${color(c.bold(String(response.status)))} ${c.dim(response.statusText)} ${c.gray(`· ${elapsed}ms`)}`,
+    );
+  }
+
+  if (options.include && !options.silent) {
+    response.headers.forEach((value, key) => {
+      console.error(`${c.gray(key)}: ${value}`);
+    });
+    console.error("");
+  }
+
+  const output = isJSON && text ? JSON.stringify(JSON.parse(text), null, 2) : text;
+
+  if (options.output) {
+    const { writeFile } = await import("node:fs/promises");
+    await writeFile(options.output, output);
+    if (!options.silent) console.error(c.dim(`saved to ${options.output}`));
+  } else {
+    console.log(isJSON ? colorizeJSON(output) : output);
+  }
+
+  process.exit(response.ok ? 0 : 1);
+}
+
+main();

package/dist/index.cjs

@@ -1,3 +1,3 @@
-'use strict';Object.defineProperty(exports,'__esModule',{value:true});var i=class extends Error{request;response;status;headers;url;constructor(t,r,n){super(t),this.name="DexiXError",this.request=r,this.response=n,this.status=n?.status,this.headers=n?.headers,this.url=r.url,Object.setPrototypeOf(this,new.target.prototype);}};var c=class extends i{constructor(t,r){super(`Request failed with status ${r.status} (${r.statusText}) for ${t.url}`,t,r),this.name="HTTPError";}};var d=class extends i{constructor(t,r,n){super(t||"Network request failed",r),this.name="NetworkError",n!==void 0&&(this.cause=n);}};var m=class extends i{timeout;constructor(t,r){super(`Request to ${t.url} timed out after ${r}ms`,t),this.name="TimeoutError",this.timeout=r;}};function C(e){return /^([a-z][a-z\d+\-.]*:)?\/\//i.test(e)}function k(e,t){if(!e||C(t))return t;let r=e.endsWith("/")?e.slice(0,-1):e,n=t.startsWith("/")?t:`/${t}`;return `${r}${n}`}function H(e,t){if(!t||Object.keys(t).length===0)return e;let[r,n=""]=e.split("?"),o=new URLSearchParams(n);for(let[f,u]of Object.entries(t))if(u!=null)if(Array.isArray(u))for(let b of u)o.append(f,String(b));else o.append(f,String(u));let s=o.toString();return s?`${r}?${s}`:r}function q(e,t,r){let n=k(e??"",t);return H(n,r)}function l(...e){let t=new Headers;for(let r of e)if(r){if(r instanceof Headers){r.forEach((n,o)=>{t.set(o,n);});continue}if(Array.isArray(r)){for(let[n,o]of r)t.set(n,o);continue}for(let[n,o]of Object.entries(r))o===void 0?t.delete(n):t.set(n,o);}return t}function R(e,t){return {...e,...t,headers:l(e.headers,t.headers),query:{...e.query,...t.query}}}function E(e){if(typeof e!="object"||e===null)return  false;let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}function S(e){return typeof e=="string"||e instanceof FormData||e instanceof Blob||e instanceof URLSearchParams||e instanceof ArrayBuffer||ArrayBuffer.isView(e)||e instanceof ReadableStream}function w(e){return e==null?{body:void 0}:S(e)?e instanceof FormData?{body:e}:e instanceof URLSearchParams?{body:e,contentType:"application/x-www-form-urlencoded;charset=UTF-8"}:typeof e=="string"?{body:e,contentType:"text/plain;charset=UTF-8"}:{body:e}:E(e)||Array.isArray(e)?{body:JSON.stringify(e),contentType:"application/json;charset=UTF-8"}:{body:JSON.stringify(e),contentType:"application/json;charset=UTF-8"}}var x=class extends i{constructor(t,r,n){super(`Failed to parse response body from ${t.url}`,t,r),this.name="ParseError",n!==void 0&&(this.cause=n);}};var O=new Set([204,205,304]);function A(e){let t=e.headers.get("content-type")??"";return t.includes("application/json")||t.includes("+json")?"json":t.startsWith("text/")?"text":"json"}async function h(e,t,r){if(t.method==="HEAD"||O.has(e.status))return;let n=r??A(e);try{switch(n){case "json":{let o=await e.text();return o.length===0?void 0:JSON.parse(o)}case "text":return await e.text();case "blob":return await e.blob();case "arrayBuffer":return await e.arrayBuffer();case "stream":return e.body;default:return await e.text()}}catch(o){let s={data:void 0,status:e.status,statusText:e.statusText,headers:e.headers,url:e.url||t.url};throw new x(t,s,o)}}function D(e,t){if(!t||t<=0)return {signal:e,cancel:()=>{},didTimeout:()=>false};let r=new AbortController,n=false,o=setTimeout(()=>{n=true,r.abort();},t),s=()=>r.abort();e?.addEventListener("abort",s,{once:true});let f=()=>{clearTimeout(o),e?.removeEventListener("abort",s);};return {signal:r.signal,cancel:f,didTimeout:()=>n}}async function j(e){let{body:t,contentType:r}=w(e.body),n=l(r?{"content-type":r}:void 0,e.headers),o=q(e.baseURL,e.url,e.query),s={url:o,method:e.method,headers:n,body:e.body},{signal:f,cancel:u,didTimeout:b}=D(e.signal,e.timeout),I={method:e.method,headers:n,body:e.method==="GET"||e.method==="HEAD"?void 0:t,signal:f,credentials:e.credentials,cache:e.cache,redirect:e.redirect,referrerPolicy:e.referrerPolicy,mode:e.mode},X=new Request(o,I);e.onRequest&&await e.onRequest(X);let a;try{a=await fetch(X);}catch(p){throw u(),p instanceof DOMException&&p.name==="AbortError"?b()?new m(s,e.timeout??0):p:new d(p instanceof Error?p.message:"Network request failed",s,p)}if(u(),e.onResponse&&await e.onResponse(a),!a.ok){let P={data:await h(a,s,e.responseType).catch(()=>{}),status:a.status,statusText:a.statusText,headers:a.headers,url:a.url||o};throw new c(s,P)}return h(a,s,e.responseType)}function y(e,t,r,n){let o={...R(e,n??{}),method:t,url:r};return j(o)}function g(e,t,r,n,o){return y(e,t,r,{...o,body:n??o?.body})}function T(e={}){let t=((r,n)=>y(e,"GET",r,n));return t.get=(r,n)=>y(e,"GET",r,n),t.post=(r,n,o)=>g(e,"POST",r,n,o),t.put=(r,n,o)=>g(e,"PUT",r,n,o),t.patch=(r,n,o)=>g(e,"PATCH",r,n,o),t.delete=(r,n)=>y(e,"DELETE",r,n),t.head=(r,n)=>y(e,"HEAD",r,n),t.options=(r,n)=>y(e,"OPTIONS",r,n),Object.defineProperty(t,"defaults",{value:e,writable:false,enumerable:true}),t.create=r=>T(R(e,r??{})),t}var B=T();var Ee=B;
-exports.DexiXError=i;exports.HTTPError=c;exports.NetworkError=d;exports.ParseError=x;exports.TimeoutError=m;exports.createInstance=T;exports.default=Ee;//# sourceMappingURL=index.cjs.map
+'use strict';Object.defineProperty(exports,'__esModule',{value:true});var u=class extends Error{request;response;status;headers;url;constructor(t,r,n){super(t),this.name="DexiXError",this.request=r,this.response=n,this.status=n?.status,this.headers=n?.headers,this.url=r.url,Object.setPrototypeOf(this,new.target.prototype);}};var d=class extends u{constructor(t,r){super(`Request failed with status ${r.status} (${r.statusText}) for ${t.url}`,t,r),this.name="HTTPError";}};var l=class extends u{constructor(t,r,n){super(t||"Network request failed",r),this.name="NetworkError",n!==void 0&&(this.cause=n);}};var m=class extends u{timeout;constructor(t,r){super(`Request to ${t.url} timed out after ${r}ms`,t),this.name="TimeoutError",this.timeout=r;}};function k(e){return /^([a-z][a-z\d+\-.]*:)?\/\//i.test(e)}function H(e,t){if(!e||k(t))return t;let r=e.endsWith("/")?e.slice(0,-1):e,n=t.startsWith("/")?t:`/${t}`;return `${r}${n}`}function O(e,t){if(!t||Object.keys(t).length===0)return e;let[r,n=""]=e.split("?"),s=new URLSearchParams(n);for(let[o,i]of Object.entries(t))if(i!=null)if(Array.isArray(i))for(let c of i)s.append(o,String(c));else s.append(o,String(i));let a=s.toString();return a?`${r}?${a}`:r}function q(e,t,r){let n=H(e??"",t);return O(n,r)}function R(...e){let t=new Headers;for(let r of e)if(r){if(r instanceof Headers){r.forEach((n,s)=>{t.set(s,n);});continue}if(Array.isArray(r)){for(let[n,s]of r)t.set(n,s);continue}for(let[n,s]of Object.entries(r))s===void 0?t.delete(n):t.set(n,s);}return t}function T(e,t){return {...e,...t,headers:R(e.headers,t.headers),query:{...e.query,...t.query}}}function X(e){if(typeof e!="object"||e===null)return  false;let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}function A(e){return typeof e=="string"||e instanceof FormData||e instanceof Blob||e instanceof URLSearchParams||e instanceof ArrayBuffer||ArrayBuffer.isView(e)||e instanceof ReadableStream}function I(e){return e==null?{body:void 0}:A(e)?e instanceof FormData?{body:e}:e instanceof URLSearchParams?{body:e,contentType:"application/x-www-form-urlencoded;charset=UTF-8"}:typeof e=="string"?{body:e,contentType:"text/plain;charset=UTF-8"}:{body:e}:X(e)||Array.isArray(e)?{body:JSON.stringify(e),contentType:"application/json;charset=UTF-8"}:{body:JSON.stringify(e),contentType:"application/json;charset=UTF-8"}}var y=class extends u{constructor(t,r,n){super(`Failed to parse response body from ${t.url}`,t,r),this.name="ParseError",n!==void 0&&(this.cause=n);}};var S=new Set([204,205,304]);function v(e){let t=e.headers.get("content-type")??"";return t.includes("application/json")||t.includes("+json")?"json":t.startsWith("text/")?"text":"json"}async function w(e,t,r){if(t.method==="HEAD"||S.has(e.status))return;let n=r??v(e);try{switch(n){case "json":{let s=await e.text();return s.length===0?void 0:JSON.parse(s)}case "text":return await e.text();case "blob":return await e.blob();case "arrayBuffer":return await e.arrayBuffer();case "stream":return e.body;default:return await e.text()}}catch(s){let a={data:void 0,status:e.status,statusText:e.statusText,headers:e.headers,url:e.url||t.url};throw new y(t,a,s)}}function g(e,t){if(!t||t<=0)return {signal:e,cancel:()=>{},didTimeout:()=>false};let r=new AbortController,n=false,s=setTimeout(()=>{n=true,r.abort();},t),a=()=>r.abort();e?.addEventListener("abort",a,{once:true});let o=()=>{clearTimeout(s),e?.removeEventListener("abort",a);};return {signal:r.signal,cancel:o,didTimeout:()=>n}}async function B(e){let{body:t,contentType:r}=I(e.body),n=R(r?{"content-type":r}:void 0,e.headers),s=q(e.baseURL,e.url,e.query),a={url:s,method:e.method,headers:n,body:e.body},{signal:o,cancel:i,didTimeout:c}=g(e.signal,e.timeout),E={method:e.method,headers:n,body:e.method==="GET"||e.method==="HEAD"?void 0:t,signal:o,credentials:e.credentials,cache:e.cache,redirect:e.redirect,referrerPolicy:e.referrerPolicy,mode:e.mode},j=new Request(s,E);e.onRequest&&await e.onRequest(j);let p;try{p=await fetch(j);}catch(f){throw i(),f instanceof DOMException&&f.name==="AbortError"?c()?new m(a,e.timeout??0):f:new l(f instanceof Error?f.message:"Network request failed",a,f)}if(i(),e.onResponse&&await e.onResponse(p),!p.ok){let C={data:await w(p,a,e.responseType).catch(()=>{}),status:p.status,statusText:p.statusText,headers:p.headers,url:p.url||s};throw new d(a,C)}return w(p,a,e.responseType)}function U(e){return new Promise(t=>setTimeout(t,e))}function M(e){return Math.min(250*2**e,8e3)}function $(e){return e instanceof d?e.status!==void 0&&(e.status>=500||e.status===429):e instanceof l||e instanceof m}async function P(e){let t=e.retries??0,r=e.retryDelay??M,n=e.retryOn??$;for(let s=0;;s++)try{return await B(e)}catch(a){if(!(s<t&&n(a,s)))throw a;let i=typeof r=="function"?r(s,a):r;i>0&&await U(i);}}var h=class{handlers=[];use(t,r){return this.handlers.push({fulfilled:t,rejected:r}),this.handlers.length-1}eject(t){this.handlers[t]&&(this.handlers[t]=null);}clear(){this.handlers=[];}list(){return this.handlers.filter(t=>t!==null)}};async function F(e,t){let r=t;for(let n of e.list())try{r=await n.fulfilled(r);}catch(s){if(!n.rejected)throw s;r=await n.rejected(s);}return r}async function N(e,t){let r,n,s=false;try{r=await t;}catch(a){s=true,n=a;}for(let a of e.list()){if(s){if(!a.rejected)continue;try{r=await a.rejected(n),s=!1;}catch(o){n=o;}continue}r=await a.fulfilled(r);}if(s)throw n;return r}function x(e,t,r,n,s){let a={...T(e,s??{}),method:r,url:n},o=(async()=>{let i=await F(t.request,a);return P(i)})();return N(t.response,o)}function D(e,t,r,n,s,a){return x(e,t,r,n,{...a,body:s??a?.body})}function b(e={}){let t=new h,r=new h,n={request:t,response:r},s=((o,i)=>x(e,n,"GET",o,i));return s.get=(o,i)=>x(e,n,"GET",o,i),s.post=(o,i,c)=>D(e,n,"POST",o,i,c),s.put=(o,i,c)=>D(e,n,"PUT",o,i,c),s.patch=(o,i,c)=>D(e,n,"PATCH",o,i,c),s.delete=(o,i)=>x(e,n,"DELETE",o,i),s.head=(o,i)=>x(e,n,"HEAD",o,i),s.options=(o,i)=>x(e,n,"OPTIONS",o,i),Object.defineProperty(s,"defaults",{value:e,writable:false,enumerable:true}),Object.defineProperty(s,"interceptors",{value:{request:{use:(o,i)=>t.use(o,i),eject:o=>t.eject(o),clear:()=>t.clear()},response:{use:(o,i)=>r.use(o,i),eject:o=>r.eject(o),clear:()=>r.clear()}},writable:false,enumerable:true}),s.create=o=>b(T(e,o??{})),s}var L=b();var Se=L;
+exports.DexiXError=u;exports.HTTPError=d;exports.NetworkError=l;exports.ParseError=y;exports.TimeoutError=m;exports.createInstance=b;exports.default=Se;//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map