dexix-request 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+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.0.0] - 2026-07-12
+
+### Added
+
+- Initial public release of DexiX Request.
+- Callable instance API: `dx(url)`, `dx.get`, `dx.post`, `dx.put`, `dx.patch`, `dx.delete`, `dx.head`, `dx.options`.
+- `dx.create()` for scoped instances with `baseURL`, default `headers`, and other defaults.
+- Automatic JSON parsing of response bodies — no more `response.json()`.
+- Automatic JSON serialization of plain object and array request bodies.
+- Native support for `FormData`, `Blob`, `URLSearchParams`, `ArrayBuffer`, typed arrays, and `ReadableStream` bodies.
+- Built-in request `timeout`, composable with a user-supplied `AbortSignal`.
+- Custom error classes: `NetworkError`, `TimeoutError`, `HTTPError`, `ParseError`, all extending a shared `DexiXError` base with `status`, `headers`, `url`, `request`, and `response`.
+- Full TypeScript generics: `dx.get<T>()`, `dx.post<T>()`, etc., with zero use of `any` in the public API.
+- 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/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DexiX 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,328 @@
+<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" />
+
+# 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.
+
+[![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)
+[![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)
+
+</div>
+
+---
+
+## Installation
+
+```bash
+npm install dexix-request
+```
+
+```bash
+pnpm add dexix-request
+```
+
+```bash
+yarn add dexix-request
+```
+
+No peer dependencies. No polyfills required in any environment that has `fetch` (all evergreen browsers, and Node.js 20+).
+
+## 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" },
+});
+
+const profile = await api("/me");
+```
+
+That's it. No `response.json()`. No `axios.create()` boilerplate. No config objects three levels deep.
+
+## Features
+
+- ✅ **Extremely simple API** — call the instance directly, or use `.get` / `.post` / `.put` / `.patch` / `.delete` / `.head` / `.options`
+- ✅ **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
+- ✅ **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
+
+## Examples
+
+### JavaScript
+
+```js
+import dx from "dexix-request";
+
+const todos = await dx.get("https://api.example.com/todos", {
+  query: { userId: 1 },
+});
+
+const created = await dx.post("https://api.example.com/todos", {
+  title: "Ship DexiX Request",
+  completed: false,
+});
+```
+
+### TypeScript
+
+```ts
+import dx from "dexix-request";
+
+interface Todo {
+  id: number;
+  title: string;
+  completed: boolean;
+}
+
+const todos = await dx.get<Todo[]>("https://api.example.com/todos");
+const todo = await dx.post<Todo>("https://api.example.com/todos", {
+  title: "Ship DexiX Request",
+  completed: false,
+});
+```
+
+### React
+
+```tsx
+import { useEffect, useState } from "react";
+import dx, { HTTPError } from "dexix-request";
+
+function useUser(id: number) {
+  const [user, setUser] = useState<User | null>(null);
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    const controller = new AbortController();
+
+    dx.get<User>(`/users/${id}`, { signal: controller.signal })
+      .then(setUser)
+      .catch((err) => {
+        if (err instanceof HTTPError && err.status === 404) {
+          setError("User not found");
+        }
+      });
+
+    return () => controller.abort();
+  }, [id]);
+
+  return { user, error };
+}
+```
+
+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).
+
+## API Reference
+
+### `dx(url, config?)`
+
+Performs a `GET` request and resolves with the parsed response body. Equivalent to `dx.get(url, config)`.
+
+### `dx.get<T>(url, config?)`
+
+### `dx.post<T>(url, body?, config?)`
+
+### `dx.put<T>(url, body?, config?)`
+
+### `dx.patch<T>(url, body?, config?)`
+
+### `dx.delete<T>(url, config?)`
+
+### `dx.head(url, config?)`
+
+### `dx.options<T>(url, config?)`
+
+Every method returns a `Promise<T>` that resolves with the already-parsed response body, or rejects with a [DexiX error](#error-handling).
+
+### `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.
+
+```ts
+const api = dx.create({
+  baseURL: "https://api.example.com",
+  headers: { "X-App": "my-app" },
+  timeout: 10_000,
+});
+```
+
+### `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.       |
+
+## Error Handling
+
+DexiX Request never throws a bare `Error`. Every failure is one of four typed classes, all extending `DexiXError`:
+
+```ts
+import dx, { NetworkError, TimeoutError, HTTPError, ParseError } from "dexix-request";
+
+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);
+  }
+}
+```
+
+Every DexiX error carries:
+
+- `message` — human-readable description
+- `status` — HTTP status code, when a response was received
+- `headers` — response `Headers`, when a response was received
+- `url` — the fully-resolved request URL
+- `request` — `{ url, method, headers, body }` describing what was sent
+- `response` — `{ data, status, statusText, headers, url }`, when available
+
+## Why DexiX Request
+
+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.
+
+- No dependencies to audit or update.
+- No custom body-parsing logic to trust — you get real `Headers`, real `Request`, real `Response` under the hood.
+- No configuration required to get sensible behavior; every option is there for when you need to override it, not because you have to set it.
+
+## Comparison with Axios
+
+| | DexiX Request | Axios |
+| --- | --- | --- |
+| Dependencies | 0 | 0 (as of v1, but larger internal surface) |
+| Bundle size (gzip) | ~2KB | ~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 |
+| 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 |
+| Instance creation | `dx.create(config)` | `axios.create(config)` |
+
+DexiX Request intentionally supports fewer legacy environments in exchange for a smaller, simpler, more predictable core. If you need to support Node.js < 18 or Internet Explorer, Axios remains the better fit.
+
+## 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
+
+Have an idea? [Open an issue](https://github.com/dexix-dev/dexix-request/issues).
+
+## Browser Support
+
+All browsers with `fetch`, `AbortController`, and `URLSearchParams` support — effectively every browser released since 2017 (Chrome 66+, Firefox 60+, Safari 12+, Edge 79+). DexiX Request does not include or require any polyfills.
+
+## Performance
+
+- **Bundle size:** ~2KB gzipped, well under the 5KB target
+- **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
+
+## Developer Experience
+
+- Every public function is documented with JSDoc, so your editor shows real descriptions, not just type signatures.
+- 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.
+
+## Contributing
+
+Contributions are welcome. To get started:
+
+```bash
+git clone https://github.com/dexix-dev/dexix-request.git
+cd dexix-request/packages/request
+npm install
+npm run test
+```
+
+Please open an issue before starting work on a large change, and make sure `npm run typecheck` and `npm run test` both pass before opening a pull request.
+
+## FAQ
+
+**Does DexiX Request work in Node.js?**
+Yes — Node.js 20+ ships a global `fetch` implementation, so DexiX Request works with no extra setup.
+
+**Does it support CommonJS?**
+Yes. The published package includes both ESM (`dist/index.js`) and CommonJS (`dist/index.cjs`) builds, selected automatically via `package.json#exports`.
+
+**Can I use it with Next.js Server Components / Route Handlers?**
+Yes — DexiX Request is just `fetch` under the hood, so it works anywhere `fetch` is available, including the Edge Runtime.
+
+**How do I send `multipart/form-data`?**
+Pass a `FormData` instance as the body — DexiX Request passes it through untouched so the platform can set the correct multipart boundary.
+
+```ts
+const form = new FormData();
+form.append("file", file);
+await dx.post("/upload", form);
+```
+
+**How do I cancel a request?**
+Pass an `AbortSignal` via `signal`, or set a `timeout` — both work together.
+
+```ts
+const controller = new AbortController();
+dx.get("/slow", { signal: controller.signal });
+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.
+
+## License
+
+[MIT](./LICENSE) © DexiX Contributors

package/dist/index.cjs

@@ -0,0 +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
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/DexiXError.ts","../src/errors/HTTPError.ts","../src/errors/NetworkError.ts","../src/errors/TimeoutError.ts","../src/utils/buildURL.ts","../src/utils/mergeHeaders.ts","../src/utils/mergeConfig.ts","../src/utils/isPlainObject.ts","../src/utils/serializeBody.ts","../src/errors/ParseError.ts","../src/utils/parseResponse.ts","../src/utils/combineSignals.ts","../src/core/dispatch.ts","../src/core/instance.ts","../src/index.ts"],"names":["DexiXError","message","request","response","HTTPError","NetworkError","cause","TimeoutError","timeout","isAbsoluteURL","url","joinURL","baseURL","trimmedBase","trimmedPath","appendQuery","query","path","existingSearch","params","key","value","item","search","buildURL","joined","mergeHeaders","sources","result","source","mergeConfig","parent","child","isPlainObject","prototype","isNativeBodyType","serializeBody","body","ParseError","EMPTY_STATUS_CODES","inferResponseType","contentType","parseResponse","responseType","type","text","failedResponse","combineSignals","userSignal","controller","timedOut","timer","onUserAbort","cancel","dispatch","config","headers","requestInfo","signal","didTimeout","init","errorResponse","defaults","method","resolved","requestWithBody","createInstance","instance","dx","index_default"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { DexiXRequestInfo, DexiXResponse } from \"../types/index.js\";\n\n/**\n * Base class for every error thrown by DexiX Request.\n * All DexiX errors carry the originating request and, when available,\n * the response that was received.\n */\nexport class DexiXError extends Error {\n  /** The request that caused this error. */\n  public readonly request: DexiXRequestInfo;\n  /** The response received, if any (absent for network/timeout errors). */\n  public readonly response?: DexiXResponse;\n  /** HTTP status code, if a response was received. */\n  public readonly status?: number;\n  /** Response headers, if a response was received. */\n  public readonly headers?: Headers;\n  /** The request URL. */\n  public readonly url: string;\n\n  public constructor(\n    message: string,\n    request: DexiXRequestInfo,\n    response?: DexiXResponse,\n  ) {\n    super(message);\n    this.name = \"DexiXError\";\n    this.request = request;\n    this.response = response;\n    this.status = response?.status;\n    this.headers = response?.headers;\n    this.url = request.url;\n\n    // Restore the correct prototype chain when compiled down to ES5-style\n    // targets (not an issue at ES2022, but harmless and defensive).\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n","import { DexiXError } from \"./DexiXError.js\";\nimport type { DexiXRequestInfo, DexiXResponse } from \"../types/index.js\";\n\n/**\n * Thrown when the server responds with a non-2xx status code.\n * Always carries the full `response`, including any parsed body DexiX\n * Request was able to extract before raising the error.\n */\nexport class HTTPError extends DexiXError {\n  public constructor(request: DexiXRequestInfo, response: DexiXResponse) {\n    super(\n      `Request failed with status ${response.status} (${response.statusText}) for ${request.url}`,\n      request,\n      response,\n    );\n    this.name = \"HTTPError\";\n  }\n}\n","import { DexiXError } from \"./DexiXError.js\";\nimport type { DexiXRequestInfo } from \"../types/index.js\";\n\n/**\n * Thrown when the request could not be completed because of a network\n * failure (DNS resolution failure, connection refused, offline, CORS\n * rejection, etc). No response was ever received.\n */\nexport class NetworkError extends DexiXError {\n  public constructor(message: string, request: DexiXRequestInfo, cause?: unknown) {\n    super(message || \"Network request failed\", request);\n    this.name = \"NetworkError\";\n    if (cause !== undefined) {\n      this.cause = cause;\n    }\n  }\n}\n","import { DexiXError } from \"./DexiXError.js\";\nimport type { DexiXRequestInfo } from \"../types/index.js\";\n\n/**\n * Thrown when a request exceeds its configured `timeout` before a\n * response is received.\n */\nexport class TimeoutError extends DexiXError {\n  /** The timeout duration, in milliseconds, that was exceeded. */\n  public readonly timeout: number;\n\n  public constructor(request: DexiXRequestInfo, timeout: number) {\n    super(`Request to ${request.url} timed out after ${timeout}ms`, request);\n    this.name = \"TimeoutError\";\n    this.timeout = timeout;\n  }\n}\n","import type { QueryParams } from \"../types/index.js\";\n\n/**\n * Detects absolute URLs (has a scheme like `https://`, `http://`, or is\n * protocol-relative `//host`).\n */\nfunction isAbsoluteURL(url: string): boolean {\n  return /^([a-z][a-z\\d+\\-.]*:)?\\/\\//i.test(url);\n}\n\n/**\n * Joins a base URL and a relative path without producing double slashes\n * or dropping a needed one.\n */\nfunction joinURL(baseURL: string, url: string): string {\n  if (!baseURL) return url;\n  if (isAbsoluteURL(url)) return url;\n\n  const trimmedBase = baseURL.endsWith(\"/\") ? baseURL.slice(0, -1) : baseURL;\n  const trimmedPath = url.startsWith(\"/\") ? url : `/${url}`;\n  return `${trimmedBase}${trimmedPath}`;\n}\n\n/**\n * Appends query parameters to a URL, preserving any existing search\n * string already present on the URL. Array values become repeated keys.\n * `null`/`undefined` values are omitted entirely.\n */\nfunction appendQuery(url: string, query?: QueryParams): string {\n  if (!query || Object.keys(query).length === 0) {\n    return url;\n  }\n\n  const [path, existingSearch = \"\"] = url.split(\"?\");\n  const params = new URLSearchParams(existingSearch);\n\n  for (const [key, value] of Object.entries(query)) {\n    if (value === null || value === undefined) continue;\n\n    if (Array.isArray(value)) {\n      for (const item of value) {\n        params.append(key, String(item));\n      }\n    } else {\n      params.append(key, String(value));\n    }\n  }\n\n  const search = params.toString();\n  return search ? `${path}?${search}` : (path as string);\n}\n\n/**\n * Builds the final request URL from a base URL, a relative or absolute\n * URL, and an optional set of query parameters.\n */\nexport function buildURL(baseURL: string | undefined, url: string, query?: QueryParams): string {\n  const joined = joinURL(baseURL ?? \"\", url);\n  return appendQuery(joined, query);\n}\n","import type { HeadersInput } from \"../types/index.js\";\n\n/**\n * Merges any number of header sources into a single `Headers` instance.\n * Later sources override earlier ones for the same (case-insensitive) key.\n * A value of `undefined` in a plain-object source removes that header.\n */\nexport function mergeHeaders(...sources: Array<HeadersInput | undefined>): Headers {\n  const result = new Headers();\n\n  for (const source of sources) {\n    if (!source) continue;\n\n    if (source instanceof Headers) {\n      source.forEach((value, key) => {\n        result.set(key, value);\n      });\n      continue;\n    }\n\n    if (Array.isArray(source)) {\n      for (const [key, value] of source) {\n        result.set(key, value);\n      }\n      continue;\n    }\n\n    for (const [key, value] of Object.entries(source)) {\n      if (value === undefined) {\n        result.delete(key);\n      } else {\n        result.set(key, value);\n      }\n    }\n  }\n\n  return result;\n}\n","import { mergeHeaders } from \"./mergeHeaders.js\";\nimport type { RequestConfig } from \"../types/index.js\";\n\n/**\n * Merges a child `RequestConfig` on top of a parent one. Headers and\n * query params are merged (child wins per-key); every other field is\n * simply overridden by the child when present.\n */\nexport function mergeConfig(parent: RequestConfig, child: RequestConfig): RequestConfig {\n  return {\n    ...parent,\n    ...child,\n    headers: mergeHeaders(parent.headers, child.headers),\n    query: { ...parent.query, ...child.query },\n  };\n}\n","/**\n * Returns `true` for plain JavaScript objects (object literals, or objects\n * with `Object.prototype` / `null` as their prototype). Returns `false`\n * for arrays, class instances, `FormData`, `Blob`, `File`, `URLSearchParams`,\n * `ReadableStream`, `Date`, `Map`, `Set`, and primitives.\n */\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (typeof value !== \"object\" || value === null) {\n    return false;\n  }\n\n  const prototype = Object.getPrototypeOf(value) as unknown;\n  return prototype === Object.prototype || prototype === null;\n}\n","import { isPlainObject } from \"./isPlainObject.js\";\nimport type { RequestBody } from \"../types/index.js\";\n\n/**\n * Result of serializing a request body: the value ready to hand to\n * `fetch`, and an optional `Content-Type` to apply when one wasn't\n * already set by the caller.\n */\nexport interface SerializedBody {\n  body: BodyInit | null | undefined;\n  contentType?: string;\n}\n\n/**\n * Determines whether a value is already a \"native\" body type that\n * `fetch` understands natively and should be passed through untouched.\n */\nfunction isNativeBodyType(value: unknown): value is BodyInit {\n  return (\n    typeof value === \"string\" ||\n    value instanceof FormData ||\n    value instanceof Blob ||\n    value instanceof URLSearchParams ||\n    value instanceof ArrayBuffer ||\n    ArrayBuffer.isView(value) ||\n    value instanceof ReadableStream\n  );\n}\n\n/**\n * Serializes a DexiX request body. Plain objects and arrays are\n * JSON-serialized automatically; every other supported `BodyInit` type is\n * passed through untouched so the caller retains full control when\n * needed (e.g. uploading a `FormData` or streaming a `ReadableStream`).\n */\nexport function serializeBody(body: RequestBody): SerializedBody {\n  if (body === null || body === undefined) {\n    return { body: undefined };\n  }\n\n  if (isNativeBodyType(body)) {\n    // FormData sets its own multipart boundary; let the platform handle it.\n    if (body instanceof FormData) {\n      return { body };\n    }\n    if (body instanceof URLSearchParams) {\n      return { body, contentType: \"application/x-www-form-urlencoded;charset=UTF-8\" };\n    }\n    if (typeof body === \"string\") {\n      return { body, contentType: \"text/plain;charset=UTF-8\" };\n    }\n    return { body };\n  }\n\n  if (isPlainObject(body) || Array.isArray(body)) {\n    return {\n      body: JSON.stringify(body),\n      contentType: \"application/json;charset=UTF-8\",\n    };\n  }\n\n  // Fallback: best-effort JSON serialization for other serializable values.\n  return {\n    body: JSON.stringify(body),\n    contentType: \"application/json;charset=UTF-8\",\n  };\n}\n","import { DexiXError } from \"./DexiXError.js\";\nimport type { DexiXRequestInfo, DexiXResponse } from \"../types/index.js\";\n\n/**\n * Thrown when a response body could not be parsed according to the\n * requested (or inferred) `responseType`, e.g. invalid JSON.\n */\nexport class ParseError extends DexiXError {\n  public constructor(request: DexiXRequestInfo, response: DexiXResponse, cause?: unknown) {\n    super(`Failed to parse response body from ${request.url}`, request, response);\n    this.name = \"ParseError\";\n    if (cause !== undefined) {\n      this.cause = cause;\n    }\n  }\n}\n","import { ParseError } from \"../errors/ParseError.js\";\nimport type { DexiXRequestInfo, DexiXResponse, ResponseType } from \"../types/index.js\";\n\nconst EMPTY_STATUS_CODES = new Set([204, 205, 304]);\n\n/**\n * Infers the best response type from the `Content-Type` header when the\n * caller didn't explicitly request one.\n */\nfunction inferResponseType(response: Response): ResponseType {\n  const contentType = response.headers.get(\"content-type\") ?? \"\";\n\n  if (contentType.includes(\"application/json\") || contentType.includes(\"+json\")) {\n    return \"json\";\n  }\n  if (contentType.startsWith(\"text/\")) {\n    return \"text\";\n  }\n  return \"json\";\n}\n\n/**\n * Parses a `Response` body according to `responseType` (or an inferred\n * type based on `Content-Type`), returning the parsed value. Throws\n * `ParseError` if parsing fails.\n */\nexport async function parseResponse<T>(\n  response: Response,\n  request: DexiXRequestInfo,\n  responseType?: ResponseType,\n): Promise<T> {\n  if (request.method === \"HEAD\" || EMPTY_STATUS_CODES.has(response.status)) {\n    return undefined as T;\n  }\n\n  const type = responseType ?? inferResponseType(response);\n\n  try {\n    switch (type) {\n      case \"json\": {\n        const text = await response.text();\n        if (text.length === 0) {\n          return undefined as T;\n        }\n        return JSON.parse(text) as T;\n      }\n      case \"text\":\n        return (await response.text()) as unknown as T;\n      case \"blob\":\n        return (await response.blob()) as unknown as T;\n      case \"arrayBuffer\":\n        return (await response.arrayBuffer()) as unknown as T;\n      case \"stream\":\n        return response.body as unknown as T;\n      default:\n        return (await response.text()) as unknown as T;\n    }\n  } catch (cause) {\n    const failedResponse: DexiXResponse = {\n      data: undefined,\n      status: response.status,\n      statusText: response.statusText,\n      headers: response.headers,\n      url: response.url || request.url,\n    };\n    throw new ParseError(request, failedResponse, cause);\n  }\n}\n","/**\n * Combines an optional user-provided `AbortSignal` with an internal\n * timeout, producing a single signal that aborts when either source\n * aborts. Returns the combined signal along with a `cancel()` function\n * that must be called once the request settles to clear the timer, and\n * a `didTimeout()` predicate to distinguish a timeout abort from a\n * user-initiated abort.\n */\nexport function combineSignals(\n  userSignal: AbortSignal | undefined,\n  timeout: number | undefined,\n): {\n  signal: AbortSignal | undefined;\n  cancel: () => void;\n  didTimeout: () => boolean;\n} {\n  if (!timeout || timeout <= 0) {\n    return {\n      signal: userSignal,\n      cancel: () => {},\n      didTimeout: () => false,\n    };\n  }\n\n  const controller = new AbortController();\n  let timedOut = false;\n\n  const timer = setTimeout(() => {\n    timedOut = true;\n    controller.abort();\n  }, timeout);\n\n  const onUserAbort = () => controller.abort();\n  userSignal?.addEventListener(\"abort\", onUserAbort, { once: true });\n\n  const cancel = () => {\n    clearTimeout(timer);\n    userSignal?.removeEventListener(\"abort\", onUserAbort);\n  };\n\n  return {\n    signal: controller.signal,\n    cancel,\n    didTimeout: () => timedOut,\n  };\n}\n","import { HTTPError } from \"../errors/HTTPError.js\";\nimport { NetworkError } from \"../errors/NetworkError.js\";\nimport { TimeoutError } from \"../errors/TimeoutError.js\";\nimport { buildURL, combineSignals, mergeHeaders, parseResponse, serializeBody } from \"../utils/index.js\";\nimport type { DexiXRequestInfo, DexiXResponse, ResolvedRequestConfig } from \"../types/index.js\";\n\n/**\n * Executes a single HTTP request described by a fully-resolved config.\n * This is the single point in the library that calls `fetch`.\n *\n * @internal\n */\nexport async function dispatch<T>(config: ResolvedRequestConfig): Promise<T> {\n  const { body, contentType } = serializeBody(config.body);\n\n  const headers = mergeHeaders(\n    contentType ? { \"content-type\": contentType } : undefined,\n    config.headers,\n  );\n\n  const url = buildURL(config.baseURL, config.url, config.query);\n\n  const requestInfo: DexiXRequestInfo = {\n    url,\n    method: config.method,\n    headers,\n    body: config.body,\n  };\n\n  const { signal, cancel, didTimeout } = combineSignals(config.signal, config.timeout);\n\n  const init: RequestInit = {\n    method: config.method,\n    headers,\n    body: config.method === \"GET\" || config.method === \"HEAD\" ? undefined : body,\n    signal,\n    credentials: config.credentials,\n    cache: config.cache,\n    redirect: config.redirect,\n    referrerPolicy: config.referrerPolicy,\n    mode: config.mode,\n  };\n\n  const request = new Request(url, init);\n\n  if (config.onRequest) {\n    await config.onRequest(request);\n  }\n\n  let response: Response;\n\n  try {\n    response = await fetch(request);\n  } catch (cause) {\n    cancel();\n\n    if (cause instanceof DOMException && cause.name === \"AbortError\") {\n      if (didTimeout()) {\n        throw new TimeoutError(requestInfo, config.timeout ?? 0);\n      }\n      throw cause;\n    }\n\n    throw new NetworkError(\n      cause instanceof Error ? cause.message : \"Network request failed\",\n      requestInfo,\n      cause,\n    );\n  }\n\n  cancel();\n\n  if (config.onResponse) {\n    await config.onResponse(response);\n  }\n\n  if (!response.ok) {\n    const data = await parseResponse<unknown>(response, requestInfo, config.responseType).catch(\n      () => undefined,\n    );\n\n    const errorResponse: DexiXResponse = {\n      data,\n      status: response.status,\n      statusText: response.statusText,\n      headers: response.headers,\n      url: response.url || url,\n    };\n\n    throw new HTTPError(requestInfo, errorResponse);\n  }\n\n  return parseResponse<T>(response, requestInfo, config.responseType);\n}\n","import { dispatch } from \"./dispatch.js\";\nimport { mergeConfig } from \"../utils/index.js\";\nimport type {\n  DexiXInstance,\n  HttpMethod,\n  RequestBody,\n  RequestConfig,\n  ResolvedRequestConfig,\n} from \"../types/index.js\";\n\nfunction request<T>(\n  defaults: RequestConfig,\n  method: HttpMethod,\n  url: string,\n  config?: RequestConfig,\n): Promise<T> {\n  const resolved: ResolvedRequestConfig = {\n    ...mergeConfig(defaults, config ?? {}),\n    method,\n    url,\n  };\n\n  return dispatch<T>(resolved);\n}\n\nfunction requestWithBody<T>(\n  defaults: RequestConfig,\n  method: HttpMethod,\n  url: string,\n  body?: RequestBody,\n  config?: RequestConfig,\n): Promise<T> {\n  return request<T>(defaults, method, url, { ...config, body: body ?? config?.body });\n}\n\n/**\n * Creates a new DexiX Request instance. Calling the instance directly\n * performs a GET request; method-specific helpers (`get`, `post`, `put`,\n * `patch`, `delete`, `head`, `options`) are attached for convenience.\n */\nexport function createInstance(defaults: RequestConfig = {}): DexiXInstance {\n  const instance = (<T>(url: string, config?: RequestConfig): Promise<T> =>\n    request<T>(defaults, \"GET\", url, config)) as DexiXInstance;\n\n  instance.get = (url, config) => request(defaults, \"GET\", url, config);\n  instance.post = (url, body, config) => requestWithBody(defaults, \"POST\", url, body, config);\n  instance.put = (url, body, config) => requestWithBody(defaults, \"PUT\", url, body, config);\n  instance.patch = (url, body, config) => requestWithBody(defaults, \"PATCH\", url, body, config);\n  instance.delete = (url, config) => request(defaults, \"DELETE\", url, config);\n  instance.head = (url, config) => request(defaults, \"HEAD\", url, config);\n  instance.options = (url, config) => request(defaults, \"OPTIONS\", url, config);\n\n  Object.defineProperty(instance, \"defaults\", {\n    value: defaults,\n    writable: false,\n    enumerable: true,\n  });\n\n  instance.create = (config?: RequestConfig) => createInstance(mergeConfig(defaults, config ?? {}));\n\n  return instance;\n}\n","import { createInstance } from \"./core/index.js\";\nimport type { DexiXInstance } from \"./types/index.js\";\n\nexport type {\n  DexiXInstance,\n  RequestConfig,\n  HttpMethod,\n  QueryParams,\n  RequestBody,\n  HeadersInput,\n  ResponseType,\n  DexiXResponse,\n  DexiXRequestInfo,\n} from \"./types/index.js\";\n\nexport { DexiXError, NetworkError, TimeoutError, HTTPError, ParseError } from \"./errors/index.js\";\n\n/**\n * The default DexiX Request instance.\n *\n * @example\n * ```ts\n * import dx from \"dexix-request\";\n *\n * const users = await dx(\"/users\");\n * const user = await dx.get<User>(\"/users/1\");\n * await dx.post(\"/posts\", { title: \"Hello\" });\n * ```\n */\nconst dx: DexiXInstance = createInstance();\n\nexport { createInstance };\nexport default dx;\n"]}

package/dist/index.d.cts

@@ -0,0 +1,184 @@
+/**
+ * HTTP methods supported by DexiX Request.
+ */
+type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+/**
+ * Plain object of query parameters. Array values are serialized as
+ * repeated keys (e.g. `{ tag: ["a", "b"] }` -> `?tag=a&tag=b`).
+ */
+type QueryParams = Record<string, string | number | boolean | null | undefined | Array<string | number | boolean>>;
+/**
+ * Anything that can be sent as a request body.
+ * Plain objects and arrays are automatically JSON-serialized.
+ */
+type RequestBody = BodyInit | Record<string, unknown> | unknown[] | null | undefined;
+/**
+ * Headers accepted by DexiX Request. Accepts a plain object, a `Headers`
+ * instance, or an array of key/value pairs (same as the `HeadersInit` type).
+ */
+type HeadersInput = HeadersInit | Record<string, string | undefined>;
+/**
+ * Response type hint. DexiX Request defaults to `"json"` and falls back
+ * gracefully when the response has no JSON body.
+ */
+type ResponseType = "json" | "text" | "blob" | "arrayBuffer" | "stream";
+/**
+ * Configuration accepted by every request call, and by `dx.create()`.
+ */
+interface RequestConfig {
+    /** Base URL prepended to every relative request URL. */
+    baseURL?: string;
+    /** Headers merged into every request. */
+    headers?: HeadersInput;
+    /** Query parameters appended to the URL's search string. */
+    query?: QueryParams;
+    /** Request body. Objects/arrays are JSON-serialized automatically. */
+    body?: RequestBody;
+    /** Timeout in milliseconds. `0` or `undefined` disables the timeout. */
+    timeout?: number;
+    /** An `AbortSignal` to cancel the request. Composable with `timeout`. */
+    signal?: AbortSignal;
+    /** How to parse the response body. Defaults to `"json"`. */
+    responseType?: ResponseType;
+    /** Credentials mode, forwarded to `fetch`. */
+    credentials?: RequestCredentials;
+    /** Cache mode, forwarded to `fetch`. */
+    cache?: RequestCache;
+    /** Redirect mode, forwarded to `fetch`. */
+    redirect?: RequestRedirect;
+    /** Referrer policy, forwarded to `fetch`. */
+    referrerPolicy?: ReferrerPolicy;
+    /** Mode, forwarded to `fetch`. */
+    mode?: RequestMode;
+    /**
+     * Called once per request with the fully-resolved `Request` before it is
+     * sent. Useful for logging or attaching auth tokens dynamically.
+     */
+    onRequest?: (request: Request) => void | Promise<void>;
+    /**
+     * Called once per request with the raw `Response`, before the body is
+     * parsed.
+     */
+    onResponse?: (response: Response) => void | Promise<void>;
+}
+/**
+ * Metadata attached to every DexiX error, describing the request that
+ * produced it.
+ */
+interface DexiXRequestInfo {
+    url: string;
+    method: HttpMethod;
+    headers: Headers;
+    body?: RequestBody;
+}
+/**
+ * The shape of a successful DexiX Request response before unwrapping.
+ * Consumers normally never see this directly, since `dx()` resolves to
+ * the parsed body, but it's available via `HTTPError.response`.
+ */
+interface DexiXResponse<T = unknown> {
+    data: T;
+    status: number;
+    statusText: string;
+    headers: Headers;
+    url: string;
+}
+/**
+ * A callable DexiX Request instance. Calling it directly performs a GET
+ * request. Method-specific helpers are attached for convenience.
+ */
+interface DexiXInstance {
+    <T = unknown>(url: string, config?: RequestConfig): Promise<T>;
+    get<T = unknown>(url: string, config?: RequestConfig): Promise<T>;
+    post<T = unknown>(url: string, body?: RequestBody, config?: RequestConfig): Promise<T>;
+    put<T = unknown>(url: string, body?: RequestBody, config?: RequestConfig): Promise<T>;
+    patch<T = unknown>(url: string, body?: RequestBody, config?: RequestConfig): Promise<T>;
+    delete<T = unknown>(url: string, config?: RequestConfig): Promise<T>;
+    head(url: string, config?: RequestConfig): Promise<void>;
+    options<T = unknown>(url: string, config?: RequestConfig): Promise<T>;
+    /** The base configuration this instance was created with. */
+    readonly defaults: RequestConfig;
+    /**
+     * Create a new, independent DexiX Request instance. Config is merged
+     * with the parent instance's defaults (child config wins).
+     */
+    create(config?: RequestConfig): DexiXInstance;
+}
+
+/**
+ * Creates a new DexiX Request instance. Calling the instance directly
+ * performs a GET request; method-specific helpers (`get`, `post`, `put`,
+ * `patch`, `delete`, `head`, `options`) are attached for convenience.
+ */
+declare function createInstance(defaults?: RequestConfig): DexiXInstance;
+
+/**
+ * Base class for every error thrown by DexiX Request.
+ * All DexiX errors carry the originating request and, when available,
+ * the response that was received.
+ */
+declare class DexiXError extends Error {
+    /** The request that caused this error. */
+    readonly request: DexiXRequestInfo;
+    /** The response received, if any (absent for network/timeout errors). */
+    readonly response?: DexiXResponse;
+    /** HTTP status code, if a response was received. */
+    readonly status?: number;
+    /** Response headers, if a response was received. */
+    readonly headers?: Headers;
+    /** The request URL. */
+    readonly url: string;
+    constructor(message: string, request: DexiXRequestInfo, response?: DexiXResponse);
+}
+
+/**
+ * Thrown when the request could not be completed because of a network
+ * failure (DNS resolution failure, connection refused, offline, CORS
+ * rejection, etc). No response was ever received.
+ */
+declare class NetworkError extends DexiXError {
+    constructor(message: string, request: DexiXRequestInfo, cause?: unknown);
+}
+
+/**
+ * Thrown when a request exceeds its configured `timeout` before a
+ * response is received.
+ */
+declare class TimeoutError extends DexiXError {
+    /** The timeout duration, in milliseconds, that was exceeded. */
+    readonly timeout: number;
+    constructor(request: DexiXRequestInfo, timeout: number);
+}
+
+/**
+ * Thrown when the server responds with a non-2xx status code.
+ * Always carries the full `response`, including any parsed body DexiX
+ * Request was able to extract before raising the error.
+ */
+declare class HTTPError extends DexiXError {
+    constructor(request: DexiXRequestInfo, response: DexiXResponse);
+}
+
+/**
+ * Thrown when a response body could not be parsed according to the
+ * requested (or inferred) `responseType`, e.g. invalid JSON.
+ */
+declare class ParseError extends DexiXError {
+    constructor(request: DexiXRequestInfo, response: DexiXResponse, cause?: unknown);
+}
+
+/**
+ * The default DexiX Request instance.
+ *
+ * @example
+ * ```ts
+ * import dx from "dexix-request";
+ *
+ * const users = await dx("/users");
+ * const user = await dx.get<User>("/users/1");
+ * await dx.post("/posts", { title: "Hello" });
+ * ```
+ */
+declare const dx: DexiXInstance;
+
+export { DexiXError, type DexiXInstance, type DexiXRequestInfo, type DexiXResponse, HTTPError, type HeadersInput, type HttpMethod, NetworkError, ParseError, type QueryParams, type RequestBody, type RequestConfig, type ResponseType, TimeoutError, createInstance, dx as default };

package/dist/index.d.ts

@@ -0,0 +1,184 @@
+/**
+ * HTTP methods supported by DexiX Request.
+ */
+type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+/**
+ * Plain object of query parameters. Array values are serialized as
+ * repeated keys (e.g. `{ tag: ["a", "b"] }` -> `?tag=a&tag=b`).
+ */
+type QueryParams = Record<string, string | number | boolean | null | undefined | Array<string | number | boolean>>;
+/**
+ * Anything that can be sent as a request body.
+ * Plain objects and arrays are automatically JSON-serialized.
+ */
+type RequestBody = BodyInit | Record<string, unknown> | unknown[] | null | undefined;
+/**
+ * Headers accepted by DexiX Request. Accepts a plain object, a `Headers`
+ * instance, or an array of key/value pairs (same as the `HeadersInit` type).
+ */
+type HeadersInput = HeadersInit | Record<string, string | undefined>;
+/**
+ * Response type hint. DexiX Request defaults to `"json"` and falls back
+ * gracefully when the response has no JSON body.
+ */
+type ResponseType = "json" | "text" | "blob" | "arrayBuffer" | "stream";
+/**
+ * Configuration accepted by every request call, and by `dx.create()`.
+ */
+interface RequestConfig {
+    /** Base URL prepended to every relative request URL. */
+    baseURL?: string;
+    /** Headers merged into every request. */
+    headers?: HeadersInput;
+    /** Query parameters appended to the URL's search string. */
+    query?: QueryParams;
+    /** Request body. Objects/arrays are JSON-serialized automatically. */
+    body?: RequestBody;
+    /** Timeout in milliseconds. `0` or `undefined` disables the timeout. */
+    timeout?: number;
+    /** An `AbortSignal` to cancel the request. Composable with `timeout`. */
+    signal?: AbortSignal;
+    /** How to parse the response body. Defaults to `"json"`. */
+    responseType?: ResponseType;
+    /** Credentials mode, forwarded to `fetch`. */
+    credentials?: RequestCredentials;
+    /** Cache mode, forwarded to `fetch`. */
+    cache?: RequestCache;
+    /** Redirect mode, forwarded to `fetch`. */
+    redirect?: RequestRedirect;
+    /** Referrer policy, forwarded to `fetch`. */
+    referrerPolicy?: ReferrerPolicy;
+    /** Mode, forwarded to `fetch`. */
+    mode?: RequestMode;
+    /**
+     * Called once per request with the fully-resolved `Request` before it is
+     * sent. Useful for logging or attaching auth tokens dynamically.
+     */
+    onRequest?: (request: Request) => void | Promise<void>;
+    /**
+     * Called once per request with the raw `Response`, before the body is
+     * parsed.
+     */
+    onResponse?: (response: Response) => void | Promise<void>;
+}
+/**
+ * Metadata attached to every DexiX error, describing the request that
+ * produced it.
+ */
+interface DexiXRequestInfo {
+    url: string;
+    method: HttpMethod;
+    headers: Headers;
+    body?: RequestBody;
+}
+/**
+ * The shape of a successful DexiX Request response before unwrapping.
+ * Consumers normally never see this directly, since `dx()` resolves to
+ * the parsed body, but it's available via `HTTPError.response`.
+ */
+interface DexiXResponse<T = unknown> {
+    data: T;
+    status: number;
+    statusText: string;
+    headers: Headers;
+    url: string;
+}
+/**
+ * A callable DexiX Request instance. Calling it directly performs a GET
+ * request. Method-specific helpers are attached for convenience.
+ */
+interface DexiXInstance {
+    <T = unknown>(url: string, config?: RequestConfig): Promise<T>;
+    get<T = unknown>(url: string, config?: RequestConfig): Promise<T>;
+    post<T = unknown>(url: string, body?: RequestBody, config?: RequestConfig): Promise<T>;
+    put<T = unknown>(url: string, body?: RequestBody, config?: RequestConfig): Promise<T>;
+    patch<T = unknown>(url: string, body?: RequestBody, config?: RequestConfig): Promise<T>;
+    delete<T = unknown>(url: string, config?: RequestConfig): Promise<T>;
+    head(url: string, config?: RequestConfig): Promise<void>;
+    options<T = unknown>(url: string, config?: RequestConfig): Promise<T>;
+    /** The base configuration this instance was created with. */
+    readonly defaults: RequestConfig;
+    /**
+     * Create a new, independent DexiX Request instance. Config is merged
+     * with the parent instance's defaults (child config wins).
+     */
+    create(config?: RequestConfig): DexiXInstance;
+}
+
+/**
+ * Creates a new DexiX Request instance. Calling the instance directly
+ * performs a GET request; method-specific helpers (`get`, `post`, `put`,
+ * `patch`, `delete`, `head`, `options`) are attached for convenience.
+ */
+declare function createInstance(defaults?: RequestConfig): DexiXInstance;
+
+/**
+ * Base class for every error thrown by DexiX Request.
+ * All DexiX errors carry the originating request and, when available,
+ * the response that was received.
+ */
+declare class DexiXError extends Error {
+    /** The request that caused this error. */
+    readonly request: DexiXRequestInfo;
+    /** The response received, if any (absent for network/timeout errors). */
+    readonly response?: DexiXResponse;
+    /** HTTP status code, if a response was received. */
+    readonly status?: number;
+    /** Response headers, if a response was received. */
+    readonly headers?: Headers;
+    /** The request URL. */
+    readonly url: string;
+    constructor(message: string, request: DexiXRequestInfo, response?: DexiXResponse);
+}
+
+/**
+ * Thrown when the request could not be completed because of a network
+ * failure (DNS resolution failure, connection refused, offline, CORS
+ * rejection, etc). No response was ever received.
+ */
+declare class NetworkError extends DexiXError {
+    constructor(message: string, request: DexiXRequestInfo, cause?: unknown);
+}
+
+/**
+ * Thrown when a request exceeds its configured `timeout` before a
+ * response is received.
+ */
+declare class TimeoutError extends DexiXError {
+    /** The timeout duration, in milliseconds, that was exceeded. */
+    readonly timeout: number;
+    constructor(request: DexiXRequestInfo, timeout: number);
+}
+
+/**
+ * Thrown when the server responds with a non-2xx status code.
+ * Always carries the full `response`, including any parsed body DexiX
+ * Request was able to extract before raising the error.
+ */
+declare class HTTPError extends DexiXError {
+    constructor(request: DexiXRequestInfo, response: DexiXResponse);
+}
+
+/**
+ * Thrown when a response body could not be parsed according to the
+ * requested (or inferred) `responseType`, e.g. invalid JSON.
+ */
+declare class ParseError extends DexiXError {
+    constructor(request: DexiXRequestInfo, response: DexiXResponse, cause?: unknown);
+}
+
+/**
+ * The default DexiX Request instance.
+ *
+ * @example
+ * ```ts
+ * import dx from "dexix-request";
+ *
+ * const users = await dx("/users");
+ * const user = await dx.get<User>("/users/1");
+ * await dx.post("/posts", { title: "Hello" });
+ * ```
+ */
+declare const dx: DexiXInstance;
+
+export { DexiXError, type DexiXInstance, type DexiXRequestInfo, type DexiXResponse, HTTPError, type HeadersInput, type HttpMethod, NetworkError, ParseError, type QueryParams, type RequestBody, type RequestConfig, type ResponseType, TimeoutError, createInstance, dx as default };

package/dist/index.js

@@ -0,0 +1,3 @@
+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;
+export{i as DexiXError,c as HTTPError,d as NetworkError,x as ParseError,m as TimeoutError,T as createInstance,Ee as default};//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/DexiXError.ts","../src/errors/HTTPError.ts","../src/errors/NetworkError.ts","../src/errors/TimeoutError.ts","../src/utils/buildURL.ts","../src/utils/mergeHeaders.ts","../src/utils/mergeConfig.ts","../src/utils/isPlainObject.ts","../src/utils/serializeBody.ts","../src/errors/ParseError.ts","../src/utils/parseResponse.ts","../src/utils/combineSignals.ts","../src/core/dispatch.ts","../src/core/instance.ts","../src/index.ts"],"names":["DexiXError","message","request","response","HTTPError","NetworkError","cause","TimeoutError","timeout","isAbsoluteURL","url","joinURL","baseURL","trimmedBase","trimmedPath","appendQuery","query","path","existingSearch","params","key","value","item","search","buildURL","joined","mergeHeaders","sources","result","source","mergeConfig","parent","child","isPlainObject","prototype","isNativeBodyType","serializeBody","body","ParseError","EMPTY_STATUS_CODES","inferResponseType","contentType","parseResponse","responseType","type","text","failedResponse","combineSignals","userSignal","controller","timedOut","timer","onUserAbort","cancel","dispatch","config","headers","requestInfo","signal","didTimeout","init","errorResponse","defaults","method","resolved","requestWithBody","createInstance","instance","dx","index_default"],"mappings":"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","file":"index.js","sourcesContent":["import type { DexiXRequestInfo, DexiXResponse } from \"../types/index.js\";\n\n/**\n * Base class for every error thrown by DexiX Request.\n * All DexiX errors carry the originating request and, when available,\n * the response that was received.\n */\nexport class DexiXError extends Error {\n  /** The request that caused this error. */\n  public readonly request: DexiXRequestInfo;\n  /** The response received, if any (absent for network/timeout errors). */\n  public readonly response?: DexiXResponse;\n  /** HTTP status code, if a response was received. */\n  public readonly status?: number;\n  /** Response headers, if a response was received. */\n  public readonly headers?: Headers;\n  /** The request URL. */\n  public readonly url: string;\n\n  public constructor(\n    message: string,\n    request: DexiXRequestInfo,\n    response?: DexiXResponse,\n  ) {\n    super(message);\n    this.name = \"DexiXError\";\n    this.request = request;\n    this.response = response;\n    this.status = response?.status;\n    this.headers = response?.headers;\n    this.url = request.url;\n\n    // Restore the correct prototype chain when compiled down to ES5-style\n    // targets (not an issue at ES2022, but harmless and defensive).\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n","import { DexiXError } from \"./DexiXError.js\";\nimport type { DexiXRequestInfo, DexiXResponse } from \"../types/index.js\";\n\n/**\n * Thrown when the server responds with a non-2xx status code.\n * Always carries the full `response`, including any parsed body DexiX\n * Request was able to extract before raising the error.\n */\nexport class HTTPError extends DexiXError {\n  public constructor(request: DexiXRequestInfo, response: DexiXResponse) {\n    super(\n      `Request failed with status ${response.status} (${response.statusText}) for ${request.url}`,\n      request,\n      response,\n    );\n    this.name = \"HTTPError\";\n  }\n}\n","import { DexiXError } from \"./DexiXError.js\";\nimport type { DexiXRequestInfo } from \"../types/index.js\";\n\n/**\n * Thrown when the request could not be completed because of a network\n * failure (DNS resolution failure, connection refused, offline, CORS\n * rejection, etc). No response was ever received.\n */\nexport class NetworkError extends DexiXError {\n  public constructor(message: string, request: DexiXRequestInfo, cause?: unknown) {\n    super(message || \"Network request failed\", request);\n    this.name = \"NetworkError\";\n    if (cause !== undefined) {\n      this.cause = cause;\n    }\n  }\n}\n","import { DexiXError } from \"./DexiXError.js\";\nimport type { DexiXRequestInfo } from \"../types/index.js\";\n\n/**\n * Thrown when a request exceeds its configured `timeout` before a\n * response is received.\n */\nexport class TimeoutError extends DexiXError {\n  /** The timeout duration, in milliseconds, that was exceeded. */\n  public readonly timeout: number;\n\n  public constructor(request: DexiXRequestInfo, timeout: number) {\n    super(`Request to ${request.url} timed out after ${timeout}ms`, request);\n    this.name = \"TimeoutError\";\n    this.timeout = timeout;\n  }\n}\n","import type { QueryParams } from \"../types/index.js\";\n\n/**\n * Detects absolute URLs (has a scheme like `https://`, `http://`, or is\n * protocol-relative `//host`).\n */\nfunction isAbsoluteURL(url: string): boolean {\n  return /^([a-z][a-z\\d+\\-.]*:)?\\/\\//i.test(url);\n}\n\n/**\n * Joins a base URL and a relative path without producing double slashes\n * or dropping a needed one.\n */\nfunction joinURL(baseURL: string, url: string): string {\n  if (!baseURL) return url;\n  if (isAbsoluteURL(url)) return url;\n\n  const trimmedBase = baseURL.endsWith(\"/\") ? baseURL.slice(0, -1) : baseURL;\n  const trimmedPath = url.startsWith(\"/\") ? url : `/${url}`;\n  return `${trimmedBase}${trimmedPath}`;\n}\n\n/**\n * Appends query parameters to a URL, preserving any existing search\n * string already present on the URL. Array values become repeated keys.\n * `null`/`undefined` values are omitted entirely.\n */\nfunction appendQuery(url: string, query?: QueryParams): string {\n  if (!query || Object.keys(query).length === 0) {\n    return url;\n  }\n\n  const [path, existingSearch = \"\"] = url.split(\"?\");\n  const params = new URLSearchParams(existingSearch);\n\n  for (const [key, value] of Object.entries(query)) {\n    if (value === null || value === undefined) continue;\n\n    if (Array.isArray(value)) {\n      for (const item of value) {\n        params.append(key, String(item));\n      }\n    } else {\n      params.append(key, String(value));\n    }\n  }\n\n  const search = params.toString();\n  return search ? `${path}?${search}` : (path as string);\n}\n\n/**\n * Builds the final request URL from a base URL, a relative or absolute\n * URL, and an optional set of query parameters.\n */\nexport function buildURL(baseURL: string | undefined, url: string, query?: QueryParams): string {\n  const joined = joinURL(baseURL ?? \"\", url);\n  return appendQuery(joined, query);\n}\n","import type { HeadersInput } from \"../types/index.js\";\n\n/**\n * Merges any number of header sources into a single `Headers` instance.\n * Later sources override earlier ones for the same (case-insensitive) key.\n * A value of `undefined` in a plain-object source removes that header.\n */\nexport function mergeHeaders(...sources: Array<HeadersInput | undefined>): Headers {\n  const result = new Headers();\n\n  for (const source of sources) {\n    if (!source) continue;\n\n    if (source instanceof Headers) {\n      source.forEach((value, key) => {\n        result.set(key, value);\n      });\n      continue;\n    }\n\n    if (Array.isArray(source)) {\n      for (const [key, value] of source) {\n        result.set(key, value);\n      }\n      continue;\n    }\n\n    for (const [key, value] of Object.entries(source)) {\n      if (value === undefined) {\n        result.delete(key);\n      } else {\n        result.set(key, value);\n      }\n    }\n  }\n\n  return result;\n}\n","import { mergeHeaders } from \"./mergeHeaders.js\";\nimport type { RequestConfig } from \"../types/index.js\";\n\n/**\n * Merges a child `RequestConfig` on top of a parent one. Headers and\n * query params are merged (child wins per-key); every other field is\n * simply overridden by the child when present.\n */\nexport function mergeConfig(parent: RequestConfig, child: RequestConfig): RequestConfig {\n  return {\n    ...parent,\n    ...child,\n    headers: mergeHeaders(parent.headers, child.headers),\n    query: { ...parent.query, ...child.query },\n  };\n}\n","/**\n * Returns `true` for plain JavaScript objects (object literals, or objects\n * with `Object.prototype` / `null` as their prototype). Returns `false`\n * for arrays, class instances, `FormData`, `Blob`, `File`, `URLSearchParams`,\n * `ReadableStream`, `Date`, `Map`, `Set`, and primitives.\n */\nexport function isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (typeof value !== \"object\" || value === null) {\n    return false;\n  }\n\n  const prototype = Object.getPrototypeOf(value) as unknown;\n  return prototype === Object.prototype || prototype === null;\n}\n","import { isPlainObject } from \"./isPlainObject.js\";\nimport type { RequestBody } from \"../types/index.js\";\n\n/**\n * Result of serializing a request body: the value ready to hand to\n * `fetch`, and an optional `Content-Type` to apply when one wasn't\n * already set by the caller.\n */\nexport interface SerializedBody {\n  body: BodyInit | null | undefined;\n  contentType?: string;\n}\n\n/**\n * Determines whether a value is already a \"native\" body type that\n * `fetch` understands natively and should be passed through untouched.\n */\nfunction isNativeBodyType(value: unknown): value is BodyInit {\n  return (\n    typeof value === \"string\" ||\n    value instanceof FormData ||\n    value instanceof Blob ||\n    value instanceof URLSearchParams ||\n    value instanceof ArrayBuffer ||\n    ArrayBuffer.isView(value) ||\n    value instanceof ReadableStream\n  );\n}\n\n/**\n * Serializes a DexiX request body. Plain objects and arrays are\n * JSON-serialized automatically; every other supported `BodyInit` type is\n * passed through untouched so the caller retains full control when\n * needed (e.g. uploading a `FormData` or streaming a `ReadableStream`).\n */\nexport function serializeBody(body: RequestBody): SerializedBody {\n  if (body === null || body === undefined) {\n    return { body: undefined };\n  }\n\n  if (isNativeBodyType(body)) {\n    // FormData sets its own multipart boundary; let the platform handle it.\n    if (body instanceof FormData) {\n      return { body };\n    }\n    if (body instanceof URLSearchParams) {\n      return { body, contentType: \"application/x-www-form-urlencoded;charset=UTF-8\" };\n    }\n    if (typeof body === \"string\") {\n      return { body, contentType: \"text/plain;charset=UTF-8\" };\n    }\n    return { body };\n  }\n\n  if (isPlainObject(body) || Array.isArray(body)) {\n    return {\n      body: JSON.stringify(body),\n      contentType: \"application/json;charset=UTF-8\",\n    };\n  }\n\n  // Fallback: best-effort JSON serialization for other serializable values.\n  return {\n    body: JSON.stringify(body),\n    contentType: \"application/json;charset=UTF-8\",\n  };\n}\n","import { DexiXError } from \"./DexiXError.js\";\nimport type { DexiXRequestInfo, DexiXResponse } from \"../types/index.js\";\n\n/**\n * Thrown when a response body could not be parsed according to the\n * requested (or inferred) `responseType`, e.g. invalid JSON.\n */\nexport class ParseError extends DexiXError {\n  public constructor(request: DexiXRequestInfo, response: DexiXResponse, cause?: unknown) {\n    super(`Failed to parse response body from ${request.url}`, request, response);\n    this.name = \"ParseError\";\n    if (cause !== undefined) {\n      this.cause = cause;\n    }\n  }\n}\n","import { ParseError } from \"../errors/ParseError.js\";\nimport type { DexiXRequestInfo, DexiXResponse, ResponseType } from \"../types/index.js\";\n\nconst EMPTY_STATUS_CODES = new Set([204, 205, 304]);\n\n/**\n * Infers the best response type from the `Content-Type` header when the\n * caller didn't explicitly request one.\n */\nfunction inferResponseType(response: Response): ResponseType {\n  const contentType = response.headers.get(\"content-type\") ?? \"\";\n\n  if (contentType.includes(\"application/json\") || contentType.includes(\"+json\")) {\n    return \"json\";\n  }\n  if (contentType.startsWith(\"text/\")) {\n    return \"text\";\n  }\n  return \"json\";\n}\n\n/**\n * Parses a `Response` body according to `responseType` (or an inferred\n * type based on `Content-Type`), returning the parsed value. Throws\n * `ParseError` if parsing fails.\n */\nexport async function parseResponse<T>(\n  response: Response,\n  request: DexiXRequestInfo,\n  responseType?: ResponseType,\n): Promise<T> {\n  if (request.method === \"HEAD\" || EMPTY_STATUS_CODES.has(response.status)) {\n    return undefined as T;\n  }\n\n  const type = responseType ?? inferResponseType(response);\n\n  try {\n    switch (type) {\n      case \"json\": {\n        const text = await response.text();\n        if (text.length === 0) {\n          return undefined as T;\n        }\n        return JSON.parse(text) as T;\n      }\n      case \"text\":\n        return (await response.text()) as unknown as T;\n      case \"blob\":\n        return (await response.blob()) as unknown as T;\n      case \"arrayBuffer\":\n        return (await response.arrayBuffer()) as unknown as T;\n      case \"stream\":\n        return response.body as unknown as T;\n      default:\n        return (await response.text()) as unknown as T;\n    }\n  } catch (cause) {\n    const failedResponse: DexiXResponse = {\n      data: undefined,\n      status: response.status,\n      statusText: response.statusText,\n      headers: response.headers,\n      url: response.url || request.url,\n    };\n    throw new ParseError(request, failedResponse, cause);\n  }\n}\n","/**\n * Combines an optional user-provided `AbortSignal` with an internal\n * timeout, producing a single signal that aborts when either source\n * aborts. Returns the combined signal along with a `cancel()` function\n * that must be called once the request settles to clear the timer, and\n * a `didTimeout()` predicate to distinguish a timeout abort from a\n * user-initiated abort.\n */\nexport function combineSignals(\n  userSignal: AbortSignal | undefined,\n  timeout: number | undefined,\n): {\n  signal: AbortSignal | undefined;\n  cancel: () => void;\n  didTimeout: () => boolean;\n} {\n  if (!timeout || timeout <= 0) {\n    return {\n      signal: userSignal,\n      cancel: () => {},\n      didTimeout: () => false,\n    };\n  }\n\n  const controller = new AbortController();\n  let timedOut = false;\n\n  const timer = setTimeout(() => {\n    timedOut = true;\n    controller.abort();\n  }, timeout);\n\n  const onUserAbort = () => controller.abort();\n  userSignal?.addEventListener(\"abort\", onUserAbort, { once: true });\n\n  const cancel = () => {\n    clearTimeout(timer);\n    userSignal?.removeEventListener(\"abort\", onUserAbort);\n  };\n\n  return {\n    signal: controller.signal,\n    cancel,\n    didTimeout: () => timedOut,\n  };\n}\n","import { HTTPError } from \"../errors/HTTPError.js\";\nimport { NetworkError } from \"../errors/NetworkError.js\";\nimport { TimeoutError } from \"../errors/TimeoutError.js\";\nimport { buildURL, combineSignals, mergeHeaders, parseResponse, serializeBody } from \"../utils/index.js\";\nimport type { DexiXRequestInfo, DexiXResponse, ResolvedRequestConfig } from \"../types/index.js\";\n\n/**\n * Executes a single HTTP request described by a fully-resolved config.\n * This is the single point in the library that calls `fetch`.\n *\n * @internal\n */\nexport async function dispatch<T>(config: ResolvedRequestConfig): Promise<T> {\n  const { body, contentType } = serializeBody(config.body);\n\n  const headers = mergeHeaders(\n    contentType ? { \"content-type\": contentType } : undefined,\n    config.headers,\n  );\n\n  const url = buildURL(config.baseURL, config.url, config.query);\n\n  const requestInfo: DexiXRequestInfo = {\n    url,\n    method: config.method,\n    headers,\n    body: config.body,\n  };\n\n  const { signal, cancel, didTimeout } = combineSignals(config.signal, config.timeout);\n\n  const init: RequestInit = {\n    method: config.method,\n    headers,\n    body: config.method === \"GET\" || config.method === \"HEAD\" ? undefined : body,\n    signal,\n    credentials: config.credentials,\n    cache: config.cache,\n    redirect: config.redirect,\n    referrerPolicy: config.referrerPolicy,\n    mode: config.mode,\n  };\n\n  const request = new Request(url, init);\n\n  if (config.onRequest) {\n    await config.onRequest(request);\n  }\n\n  let response: Response;\n\n  try {\n    response = await fetch(request);\n  } catch (cause) {\n    cancel();\n\n    if (cause instanceof DOMException && cause.name === \"AbortError\") {\n      if (didTimeout()) {\n        throw new TimeoutError(requestInfo, config.timeout ?? 0);\n      }\n      throw cause;\n    }\n\n    throw new NetworkError(\n      cause instanceof Error ? cause.message : \"Network request failed\",\n      requestInfo,\n      cause,\n    );\n  }\n\n  cancel();\n\n  if (config.onResponse) {\n    await config.onResponse(response);\n  }\n\n  if (!response.ok) {\n    const data = await parseResponse<unknown>(response, requestInfo, config.responseType).catch(\n      () => undefined,\n    );\n\n    const errorResponse: DexiXResponse = {\n      data,\n      status: response.status,\n      statusText: response.statusText,\n      headers: response.headers,\n      url: response.url || url,\n    };\n\n    throw new HTTPError(requestInfo, errorResponse);\n  }\n\n  return parseResponse<T>(response, requestInfo, config.responseType);\n}\n","import { dispatch } from \"./dispatch.js\";\nimport { mergeConfig } from \"../utils/index.js\";\nimport type {\n  DexiXInstance,\n  HttpMethod,\n  RequestBody,\n  RequestConfig,\n  ResolvedRequestConfig,\n} from \"../types/index.js\";\n\nfunction request<T>(\n  defaults: RequestConfig,\n  method: HttpMethod,\n  url: string,\n  config?: RequestConfig,\n): Promise<T> {\n  const resolved: ResolvedRequestConfig = {\n    ...mergeConfig(defaults, config ?? {}),\n    method,\n    url,\n  };\n\n  return dispatch<T>(resolved);\n}\n\nfunction requestWithBody<T>(\n  defaults: RequestConfig,\n  method: HttpMethod,\n  url: string,\n  body?: RequestBody,\n  config?: RequestConfig,\n): Promise<T> {\n  return request<T>(defaults, method, url, { ...config, body: body ?? config?.body });\n}\n\n/**\n * Creates a new DexiX Request instance. Calling the instance directly\n * performs a GET request; method-specific helpers (`get`, `post`, `put`,\n * `patch`, `delete`, `head`, `options`) are attached for convenience.\n */\nexport function createInstance(defaults: RequestConfig = {}): DexiXInstance {\n  const instance = (<T>(url: string, config?: RequestConfig): Promise<T> =>\n    request<T>(defaults, \"GET\", url, config)) as DexiXInstance;\n\n  instance.get = (url, config) => request(defaults, \"GET\", url, config);\n  instance.post = (url, body, config) => requestWithBody(defaults, \"POST\", url, body, config);\n  instance.put = (url, body, config) => requestWithBody(defaults, \"PUT\", url, body, config);\n  instance.patch = (url, body, config) => requestWithBody(defaults, \"PATCH\", url, body, config);\n  instance.delete = (url, config) => request(defaults, \"DELETE\", url, config);\n  instance.head = (url, config) => request(defaults, \"HEAD\", url, config);\n  instance.options = (url, config) => request(defaults, \"OPTIONS\", url, config);\n\n  Object.defineProperty(instance, \"defaults\", {\n    value: defaults,\n    writable: false,\n    enumerable: true,\n  });\n\n  instance.create = (config?: RequestConfig) => createInstance(mergeConfig(defaults, config ?? {}));\n\n  return instance;\n}\n","import { createInstance } from \"./core/index.js\";\nimport type { DexiXInstance } from \"./types/index.js\";\n\nexport type {\n  DexiXInstance,\n  RequestConfig,\n  HttpMethod,\n  QueryParams,\n  RequestBody,\n  HeadersInput,\n  ResponseType,\n  DexiXResponse,\n  DexiXRequestInfo,\n} from \"./types/index.js\";\n\nexport { DexiXError, NetworkError, TimeoutError, HTTPError, ParseError } from \"./errors/index.js\";\n\n/**\n * The default DexiX Request instance.\n *\n * @example\n * ```ts\n * import dx from \"dexix-request\";\n *\n * const users = await dx(\"/users\");\n * const user = await dx.get<User>(\"/users/1\");\n * await dx.post(\"/posts\", { title: \"Hello\" });\n * ```\n */\nconst dx: DexiXInstance = createInstance();\n\nexport { createInstance };\nexport default dx;\n"]}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "dexix-request",
+  "version": "1.0.0",
+  "description": "A tiny, modern, zero-dependency HTTP client for JavaScript and TypeScript. Built for the browser, Node.js, and React.",
+  "keywords": [
+    "http",
+    "http-client",
+    "fetch",
+    "request",
+    "api",
+    "typescript",
+    "axios-alternative",
+    "react",
+    "node"
+  ],
+  "homepage": "https://github.com/AkbariCodes/DexiX-Request/#readme",
+  "bugs": {
+  "url": "https://github.com/AkbariCodes/DexiX-Request/issues"
+},
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AkbariCodes/DexiX-Request.git"
+  },
+  "license": "MIT",
+  "author": "DexiX Contributors",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^2.0.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}