@scirexs/fetchy 0.7.0 → 0.8.2

package/README.md

@@ -4,12 +4,13 @@
 [![JSR](https://img.shields.io/jsr/v/%40scirexs/fetchy)](https://jsr.io/@scirexs/fetchy)
 [![license](https://img.shields.io/github/license/scirexs/fetchy)](https://github.com/scirexs/fetchy/blob/main/LICENSE)
 
-A lightweight, type-safe fetch wrapper with built-in retry logic, timeout handling, and automatic body parsing. Works in Deno, Node.js, and modern browsers.
+A lightweight thin fetch wrapper with built-in retry logic, timeout handling, and automatic body parsing. Works in Deno, Node.js, and modern browsers.
 
 ## Features
 
-- **Lightweight** - Bundle size is ~5KB uncompressed, ~2KB gzipped, zero dependencies
 - **Simple API** - Drop-in replacement for native fetch with enhanced capabilities
+- **Lightweight** - Bundle size is ~5KB uncompressed, ~2KB gzipped, zero dependencies
+- **Native Fetch Compatible** - Thin abstraction layer, easy migration back to native fetch
 - **Promise-like Interface** - Chain parsing methods directly on fetch results
 - **Timeout Support** - Configurable request timeouts with automatic cancellation
 - **Retry Logic** - Exponential backoff with Retry-After header support
@@ -30,7 +31,7 @@ deno add jsr:@scirexs/fetchy
 
 ## Quick Start
 ```ts
-import { fetchy, sfetchy, Fetchy, fy } from "@scirexs/fetchy";
+import { fetchy, sfetchy, fy } from "@scirexs/fetchy";
 
 // Simple GET request with automatic JSON parsing
 const user = await fetchy("https://api.example.com/user/1").json<User>();
@@ -105,10 +106,10 @@ Same as `fetchy()`.
 
 - `text()` → `Promise<string | null>` - Safe text parsing (returns null on error)
 - `json<T>()` → `Promise<T | null>` - Safe JSON parsing (returns null on error)
-- `bytes()` → `Promise<Uint8Array | null>` - Safe bytes parsing
-- `blob()` → `Promise<Blob | null>` - Safe blob parsing
-- `arrayBuffer()` → `Promise<ArrayBuffer | null>` - Safe buffer parsing
-- `formData()` → `Promise<FormData | null>` - Safe form data parsing
+- `bytes()` → `Promise<Uint8Array | null>` - Safe bytes parsing (returns null on error)
+- `blob()` → `Promise<Blob | null>` - Safe blob parsing (returns null on error)
+- `arrayBuffer()` → `Promise<ArrayBuffer | null>` - Safe buffer parsing (returns null on error)
+- `formData()` → `Promise<FormData | null>` - Safe form data parsing (returns null on error)
 
 #### Example
 ```ts
@@ -127,51 +128,46 @@ if (data !== null) {
 }
 ```
 
-### `Fetchy` Class
+### `fy(options?)`
 
-A fluent HTTP client class that provides instance methods.
-
-#### Constructor
-```ts
-const client = new Fetchy(options?: FetchyOptions);
-```
+Creates a fluent HTTP client with pre-configured options that provides HTTP method shortcuts.
 
-#### Instance Methods
+#### Client Methods
 ```ts
-const client = new Fetchy(options);
+const client = fy(options);
 
 // Main fetch method
-await client.fetch(url?)      // Returns FetchyResponse
+await client.fetch(url?, options?)    // Returns FetchyResponse
 
 // HTTP method shortcuts
-await client.get(url?)        // GET request, returns FetchyResponse
-await client.post(url?)       // POST request, returns FetchyResponse
-await client.put(url?)        // PUT request, returns FetchyResponse
-await client.patch(url?)      // PATCH request, returns FetchyResponse
-await client.delete(url?)     // DELETE request, returns FetchyResponse
-await client.head(url?)       // HEAD request, returns Promise<Response>
+await client.get(url?, options?)      // GET request, returns FetchyResponse
+await client.post(url?, options?)     // POST request, returns FetchyResponse
+await client.put(url?, options?)      // PUT request, returns FetchyResponse
+await client.patch(url?, options?)    // PATCH request, returns FetchyResponse
+await client.delete(url?, options?)   // DELETE request, returns FetchyResponse
+await client.head(url?, options?)     // HEAD request, returns Promise<Response>
 
 // Safe mode methods
-await client.safe(url?)       // Returns FetchySafeResponse
-await client.sget(url?)       // Safe GET, returns FetchySafeResponse
-await client.spost(url?)      // Safe POST, returns FetchySafeResponse
-await client.sput(url?)       // Safe PUT, returns FetchySafeResponse
-await client.spatch(url?)     // Safe PATCH, returns FetchySafeResponse
-await client.sdelete(url?)    // Safe DELETE, returns FetchySafeResponse
-await client.shead(url?)      // Safe HEAD, returns Promise<Response | null>
+await client.sfetch(url?, options?)   // Returns FetchySafeResponse
+await client.sget(url?, options?)     // Safe GET, returns FetchySafeResponse
+await client.spost(url?, options?)    // Safe POST, returns FetchySafeResponse
+await client.sput(url?, options?)     // Safe PUT, returns FetchySafeResponse
+await client.spatch(url?, options?)   // Safe PATCH, returns FetchySafeResponse
+await client.sdelete(url?, options?)  // Safe DELETE, returns FetchySafeResponse
+await client.shead(url?, options?)    // Safe HEAD, returns Promise<Response | null>
 ```
 
 All methods can be chained with parsing methods:
 ```ts
 await client.get("/users").json<User[]>();
 await client.post("/create").json<Result>();
-await client.safe("/data").text();
+await client.sfetch("/data").text();
 ```
 
 #### Example
 ```ts
 // Instance usage - reuse configuration
-const client = new Fetchy({
+const client = fy({
   base: "https://api.example.com",
   bearer: "token123",
   timeout: 10,
@@ -193,24 +189,23 @@ if (data !== null) {
 }
 ```
 
-### `fy(options?)` Function
+### `setFetchy(options)`
 
-Shorthand for creating a new `Fetchy` instance.
-```ts
-const client = fy({
-  base: "https://api.example.com",
-  bearer: "token"
-});
+Sets global default options for all fetchy instances.
 
-const user = await client.get("/user").json<User>();
-```
-
-Equivalent to:
+#### Example
 ```ts
-const client = new Fetchy({
-  base: "https://api.example.com",
-  bearer: "token"
+import { setFetchy, fetchy } from "@scirexs/fetchy";
+
+// Set global defaults
+setFetchy({
+  timeout: 30,
+  retry: { maxAttempts: 5 },
+  bearer: "global-token"
 });
+
+// All subsequent requests use these defaults
+await fetchy("https://api.example.com/data");
 ```
 
 ## Configuration
@@ -329,7 +324,7 @@ if (response === null) {
 }
 
 // Safe parsing methods - return null on error
-const data = await fetchy("https://api.example.com/data").json<Data>();
+const data = await sfetchy("https://api.example.com/data").json<Data>();
 if (data !== null) {
   // Process data
 }
@@ -348,6 +343,19 @@ if (!response.ok) {
 }
 ```
 
+## Compatibility with Native Fetch
+
+Designed for easy migration back to native `fetch` if needed, minimizing maintenance risk.
+```ts
+// If this library is discontinued, simply delete these declarations
+// to fall back to native fetch with minimal code changes.
+// import { fetchy as fetch, setFetchy } from "@scirexs/fetchy";
+// setFetchy({ native: true });
+
+const options: RequestInit = { method: "POST", body: "hello" };
+const response = await fetch("https://api.example.com/data", options);
+```
+
 ## Usage Examples
 
 ### Basic Requests
@@ -562,10 +570,10 @@ const data = await fetchy("https://api.example.com/rate-limited", {
   retry: {
     maxAttempts: 5,
     interval: 1,  // Minimum interval if header not present
-    respectHeaders: ["retry-after", "ratelimit-reset"]
+    respectHeaders: ["retry-after", "ratelimit-reset", "x-rateLimit-reset", "x-my-retry-after"]
   }
 }).json();
-// If response has "Retry-After: 10", will wait 10 seconds before retry
+// If response has "X-My-Retry-After: 10", will wait 10 seconds before retry
 ```
 
 ### Type-Safe API Responses
@@ -598,73 +606,6 @@ if (result !== null && result.success) {
 }
 ```
 
-## Best Practices
-
-### 1. Use Base URL for API Clients
-```ts
-const api = fy({
-  base: "https://api.example.com",
-  bearer: process.env.API_TOKEN,
-  timeout: 10
-});
-
-// All requests are relative to base
-await api.get("/users").json();
-await api.post("/posts", { body: data }).json();
-```
-
-### 2. Choose Safe vs. Throwing Behavior
-```ts
-// For critical operations: use regular methods (throws on error)
-try {
-  const result = await fetchy(url).json();
-  // Process result
-} catch (error) {
-  // Handle error explicitly
-}
-
-// For optional data: use safe methods (returns null)
-const data = await fetchy(url).sjson();
-if (data !== null) {
-  // Process data
-}
-// Continue regardless of result
-```
-
-### 3. Configure Retry for Resilience
-```ts
-// Aggressive retry for critical operations
-const result = await fetchy(url, {
-  retry: {
-    maxAttempts: 5,
-    interval: 2,
-    maxInterval: 30,
-    retryOnTimeout: true
-  }
-}).json();
-
-// No retry for operations that must be fast
-const data = await fetchy(url, {
-  retry: false,
-  timeout: 2
-}).json();
-```
-
-### 4. Use Method Shortcuts for Clarity
-```ts
-const api = fy({ base: "https://api.example.com" });
-
-// Clear and concise
-await api.get("/users").json();
-await api.post("/users", { body: newUser }).json();
-await api.delete("/users/123");
-
-// Instead of
-await api.fetch("/users", { method: "GET" }).json();
-await api.fetch("/users", { method: "POST", body: newUser }).json();
-await api.fetch("/users/123", { method: "DELETE" });
-```
-
 ## License
 
 MIT

package/esm/main.js

@@ -1 +1 @@
-export{M as Fetchy,o as fetchy,B as fy,O as HTTPStatusError,s as sfetchy};const d="GET",y="HEAD",h="POST",b="PUT",_="PATCH",g="DELETE",T="Accept",E="Content-Type",w="application/json",a={a:15,b:0,c:3,d:30,e:3,f:!0,g:!1,h:[500,502,503,504,408,429],i:["retry-after","ratelimit-reset","x-ratelimit-reset"],j:!1},v=[h,_,"CONNECT"],N=["text","json","bytes","blob","arrayBuffer","formData"];class O extends Error{status;response;constructor(e){super(`${e.status} ${e.url}`),this.name="HTTPStatusError",this.status=e.status,this.response=e}}class M{url;base;body;timeout;retry;bearer;jitter;native;cache;credentials;headers;integrity;keepalive;method;mode;redirect;referrer;referrerPolicy;signal;constructor(e){Object.assign(this,e)}fetch(e,n){return o(e,i(this,n))}get(e,n){return o(e,i(this,n,d))}head(e,n){return o(e,i(this,n,y))}post(e,n){return o(e,i(this,n,h))}put(e,n){return o(e,i(this,n,b))}patch(e,n){return o(e,i(this,n,_))}delete(e,n){return o(e,i(this,n,g))}safe(e,n){return s(e,i(this,n))}sget(e,n){return s(e,i(this,n,d))}shead(e,n){return s(e,i(this,n,y))}spost(e,n){return s(e,i(this,n,h))}sput(e,n){return s(e,i(this,n,b))}spatch(e,n){return s(e,i(this,n,_))}sdelete(e,n){return s(e,i(this,n,g))}}function B(t){return new M(t)}function s(t,e){try{return j(t,e,!0)}catch{return null}}function o(t,e){return j(t,e)}function j(t,e,n=!1){const r=L(F(t,e)),u=p(t,e),f=z(u,t,e);return Z(r,u,f,n)}function i(t,e,n){return{...t,...e,method:n}}function I(t){return typeof t=="string"}function U(t){return typeof t=="number"}function R(t){return typeof t=="boolean"}function P(t){return t instanceof ReadableStream}function l(t){return t instanceof Request}function k(t){return!!(t&&typeof t=="object"&&Object.getPrototypeOf(t)===Object.prototype)}function m(t,e){return(e??-1)>=0?e:t}function F(t,e){return l(t)||(t||(t=e?.url??""),l(t))?t:new Request(URL.parse(t,e?.base)??"")}function L(t,e){if(!P(e?.body))return t;const n=[d,y].includes(t.method)?h:t.method;return new Request(t,{method:n,body:e.body})}function p(t,e){const{method:n,body:r,timeout:u,retry:f,bearer:c,native:it,jitter:at,headers:ut,signal:ct,...D}=e??{};return{headers:J(e,l(t)?t.headers:null),method:n?n.toUpperCase():l(t)?t.method:r==null?d:h,...q(r),...D}}function q(t){return P(t)?null:{body:S(t)?JSON.stringify(t):t}}function S(t){return!!(U(t)||R(t)||Array.isArray(t)||k(t))}function J(t,e){const n=new Headers(t?.headers);if(H(T,n,e)&&n.set(T,`${w}, text/plain`),H(E,n,e)){const r=$(t?.body);r&&n.set(E,r)}return t?.bearer&&n.set("Authorization",`Bearer ${t.bearer}`),n}function H(t,e,n){return!e.has(t)&&!n?.has(t)}function $(t){return S(t)?w:G(t)?"":"application/octet-stream"}function G(t){return t==null||I(t)||t instanceof FormData||t instanceof URLSearchParams||!!(t instanceof Blob&&t.type)}function W(t,e){return R(e)?{...a,e:1}:{e:Math.max(m(a.e,e?.maxAttempts),1),c:Math.max(m(a.c,e?.interval),.01),d:Math.max(m(a.d,e?.maxInterval),1),f:e?.retryOnTimeout??a.f,g:e?.idempotentOnly?v.includes(t.method??""):!1,h:e?.statusCodes??a.h,i:e?.respectHeaders??a.i}}function z(t,e,n){return{...W(t,n?.retry),a:m(a.a,n?.timeout),b:m(a.b,n?.jitter),j:n?.native??a.j,k:x(l(e)?e.signal:null,n?.signal)}}function x(t,e){if(!(!t&&!e))return t&&e?AbortSignal.any([t,e]):t||(e??void 0)}function Y(t){return t.a<=0?t.k:x(AbortSignal.timeout(t.a*1e3),t.k)}async function A(t,e=!1){if(t<=0)return;const n=Math.trunc((e?Math.random():1)*t*1e3);await new Promise(r=>setTimeout(r,n))}function K(t){return t>=400||t<100}async function C(t,e,n){if(e.g||t>=e.e-1)return!1;if(n instanceof Response){if(e.j||!e.h.includes(n.status))return!1;const r=Q(t,e,n.headers);return r>e.d?!1:(await A(r),!0)}else return n instanceof Error&&n.name=="TimeoutError"&&e.f}function Q(t,e,n){return e.i.some(r=>n.has(r))?V(e,n)??e.c:Math.min(e.c*2**t,e.d)}function V(t,e){for(const n of t.i){const r=X(e.get(n)?.trim());if(!Number.isNaN(r))return Math.max(r,t.c)}}function X(t){if(!t)return NaN;const e=Number.parseInt(t,10);return Number.isNaN(e)?Math.ceil((new Date(t).getTime()-Date.now())/1e3):e}function Z(t,e,n,r=!1){const u=nt(t,e,n,r);return tt(u,r)}function tt(t,e){return Object.assign(t,Object.fromEntries([...e?N.map(n=>[n,()=>t.then(r=>r[n]()).catch(()=>null)]):N.map(n=>[n,()=>t.then(r=>r[n]())])]))}function et(t){let e;return async n=>{n&&await e?.body?.cancel();const r=e??t;return n||(e=e?e.clone():t.clone()),r}}async function nt(t,e,n,r){const u=et(t);for(let f=0;f<n.e;f++)try{const c=await rt(await u(),e,n);if(await C(f,n,c))continue;if(K(c.status)&&!n.j)throw new O(c);return c}catch(c){if(await C(f,n,c))continue;if(r)return null;throw c}finally{await u(!0)}throw new Error}async function rt(t,e,n){return await A(n.b,!0),await fetch(t,{...e,signal:Y(n)})}
+export{y as fetchy,E as fy,m as HTTPStatusError,x as setFetchy,d as sfetchy};const u={a:15,b:0,c:3,d:30,e:3,f:!0,g:!1,h:[500,502,503,504,408,429],i:["retry-after","ratelimit-reset","x-ratelimit-reset"],j:!1},N=["POST","PATCH","CONNECT"],h=["text","json","bytes","blob","arrayBuffer","formData"],S=["fetch","get","head","post","put","patch","delete"];let l={};class m extends Error{status;response;constructor(t){super(`${t.status} ${t.url}`),this.name="HTTPStatusError",this.status=t.status,this.response=t}}function E(e){const t=Object.assign({},e);return R(t),R(t,!0),t}function d(e,t){return _(e,t,!0)}function y(e,t){return _(e,t)}function x(e){l=e}function _(e,t,n=!1){t=o(l,t);const r=H(e,t),a=v(r,e,t);return z(G(e,r,a,n),n)}function o(e,t,n){return{...e,...t,...n&&{method:n}}}function A(e){return typeof e=="string"}function M(e){return typeof e=="number"}function b(e){return typeof e=="boolean"}function f(e){return e instanceof Request}function C(e){return!!(e&&typeof e=="object"&&Object.getPrototypeOf(e)===Object.prototype)}function s(e,t){return(t??-1)>=0?t:e}function H(e,t){const{method:n,body:r,timeout:a,retry:c,bearer:i,native:Y,jitter:K,headers:Q,signal:V,...j}=t??{};return{headers:D(t,f(e)?e.headers:null),method:n?n.toUpperCase():f(e)?e.method:r==null?"GET":"POST",...P(r),...j}}function P(e){return e instanceof ReadableStream?null:{body:g(e)?JSON.stringify(e):e}}function g(e){return!!(M(e)||b(e)||Array.isArray(e)||C(e))}function D(e,t){const n=new Headers(e?.headers);if(!n.has("Accept")&&!t?.has("Accept")&&n.set("Accept","application/json, text/plain"),!n.has("Content-Type")&&!t?.has("Content-Type")){const r=B(e?.body);r&&n.set("Content-Type",r)}return e?.bearer&&n.set("Authorization",`Bearer ${e.bearer}`),n}function B(e){return g(e)?"application/json":e==null||A(e)||e instanceof FormData||e instanceof URLSearchParams||e instanceof Blob&&e.type?"":"application/octet-stream"}function F(e,t){return b(t)?{...u,e:1}:{e:Math.max(s(u.e,t?.maxAttempts),1),c:Math.max(s(u.c,t?.interval),.01),d:Math.max(s(u.d,t?.maxInterval),1),f:t?.retryOnTimeout??u.f,g:t?.idempotentOnly?N.includes(e.method??""):!1,h:t?.statusCodes??u.h,i:t?.respectHeaders??u.i}}function v(e,t,n){return{...F(e,n?.retry),a:s(u.a,n?.timeout),b:s(u.b,n?.jitter),j:n?.native??u.j,k:w(f(t)?t.signal:null,n?.signal),l:n?.url,m:n?.base,n:n?.body}}function w(e,t){if(!(!e&&!t))return e&&t?AbortSignal.any([e,t]):e||(t??void 0)}function I(e){return e.a<=0?e.k:w(AbortSignal.timeout(e.a*1e3),e.k)}async function T(e,t=!1){if(e<=0)return;const n=Math.trunc((t?Math.random():1)*e*1e3);await new Promise(r=>setTimeout(r,n))}async function O(e,t,n,r){if(t.g||e>=t.e-1||!r)return!1;if(n instanceof Response){if(t.j||!t.h.includes(n.status))return!1;const a=k(e,t,n.headers);return a>t.d?!1:(await T(a),!0)}else return n instanceof Error&&n.name=="TimeoutError"&&t.f}function k(e,t,n){return t.i.some(r=>n.has(r))?U(t,n)??t.c:Math.min(t.c*2**e,t.d)}function U(e,t){for(const n of e.i){const r=q(t.get(n)?.trim());if(!Number.isNaN(r))return Math.max(r,e.c)}}function q(e){if(!e)return NaN;const t=Number.parseInt(e,10);return Number.isNaN(t)?Math.ceil((new Date(e).getTime()-Date.now())/1e3):t}function J(e,t){if(!(t.n instanceof ReadableStream))return e;const n=["GET","HEAD"].includes(e.method)?"POST":e.method;return new Request(e,{method:n,body:t.n})}function L(e,t){return f(t)||(t||(t=e?.l??""),f(t))?t:new Request(URL.parse(t,e?.m)??"")}function $(e){let t;return async n=>{n&&await t?.body?.cancel();const r=t??e;return n||(t=t?t.clone():e.clone()),r}}async function G(e,t,n,r){let a;for(let c=0;c<n.e;c++)try{c===0&&(a=$(J(L(n,e),n)));const i=await W(await a(),t,n);if(await O(c,n,i,a))continue;if((i.status>=400||i.status<100)&&!n.j)throw new m(i);return i}catch(i){if(await O(c,n,i,a))continue;if(r)return null;throw i}finally{await a?.(!0)}throw new Error}async function W(e,t,n){return await T(n.b,!0),await fetch(e,{...t,signal:I(n)})}function z(e,t){return Object.assign(e,Object.fromEntries([...t?h.map(n=>[n,()=>e.then(r=>r[n]()).catch(()=>null)]):h.map(n=>[n,()=>e.then(r=>r[n]())])]))}function R(e,t){for(const n of S){const r=(t?"s":"")+n;e[r]=function(a,c){const i=n==="fetch"?o(this,c):o(this,c,n);return t?d(a,i):y(a,i)}}}

package/esm/mod.js

@@ -2,4 +2,4 @@
  * Exports main functions and types for external.
  * @module
  */
-export { Fetchy, fetchy, fy, HTTPStatusError, sfetchy } from "./main.js";
+export { fetchy, fy, HTTPStatusError, setFetchy, sfetchy } from "./main.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scirexs/fetchy",
-  "version": "0.7.0",
+  "version": "0.8.2",
   "description": "A lightweight fetch wrapper.",
   "keywords": [
     "fetch",

package/types/main.d.ts

@@ -1,11 +1,7 @@
-export { _assignToPromise, _buildOption, _cloneRequestF, _correctNumber, _createRequest, _DEFAULT, _fetchWithJitter, _fetchWithRetry, _findRetryHeader, _getBody, _getContentType, _getHeaders, _getNextInterval, _getOptions, _getRequestInit, _getRetryOption, _handleByNative, _includeStream, _isBool, _isHttpError, _isJSONObject, _isNoHeader, _isNumber, _isPlain, _isRequest, _isStream, _isString, _main, _makeFetchyResponse, _mergeSignals, _METHODS, _NO_IDEM, _parseRetryHeader, _shouldRetry, _wait, _withTimeout, Fetchy, fetchy, fy, HTTPStatusError, sfetchy, };
-import type { FetchyBody, FetchyOptions, FetchyResponse, FetchySafeResponse, RetryOptions } from "./types.js";
+export { _buildOption, _cloneRequestF, _correctNumber, _createRequest, _DEFAULT, _fetchWithJitter, _fetchWithRetry, _findRetryHeader, _genMethods, _getBody, _getContentType, _getHeaders, _getNextInterval, _getOptions, _getRequestInit, _getRetryOption, _includeStream, _isBool, _isJSONObject, _isNumber, _isPlain, _isRequest, _isString, _main, _makeFetchyResponse, _mergeSignals, _parseRetryHeader, _shouldRetry, _wait, _withTimeout, fetchy, fy, HTTPStatusError, setFetchy, sfetchy, };
+import type { Fetchy, FetchyBody, FetchyOptions, FetchyResponse, FetchySafeResponse, RetryOptions } from "./types.js";
 /** Default configuration values for fetchy. */
 declare const _DEFAULT: Options;
-/** HTTP methods that do not have idempotency. */
-declare const _NO_IDEM: string[];
-/** Additional methods for Promise-like interface. */
-declare const _METHODS: readonly ["text", "json", "bytes", "blob", "arrayBuffer", "formData"];
 /** Internal normalized options used throughout the fetch process. */
 interface Options {
     ztimeout: number;
@@ -19,6 +15,9 @@ interface Options {
     zrespects: string[];
     znative: boolean;
     zsignal?: AbortSignal;
+    zurl?: string | URL | Request;
+    zbase?: string | URL;
+    zbody?: FetchyBody;
 }
 /** URL argument type for fetchy functions. */
 type InputArg = string | URL | Request | null;
@@ -46,108 +45,11 @@ declare class HTTPStatusError extends Error {
     constructor(resp: Response);
 }
 /**
- * A fluent HTTP client class that provides both instance and static methods for making HTTP requests.
+ * A fluent HTTP client that provides methods for making HTTP requests.
  * Supports features like timeout, retry with exponential backoff, automatic header management, and response parsing.
  *
- * @example
- * ```ts
- * // Instance usage - reuse configuration
- * const client = new Fetchy({
- *   bearer: "token123",
- *   timeout: 10,
- *   retry: { maxAttempts: 3 }
- * });
- * const user = await client.get("https://api.example.com/user").json<User>();
- * const posts = await client.get("https://api.example.com/posts").json<Post[]>();
- *
- * // Safe mode - returns null on error instead of throwing
- * const result = await client.safe("https://api.example.com/data").json<Data>();
- * if (result !== null) {
- *   // Handle successful response
- * }
- * ```
- */
-declare class Fetchy implements FetchyOptions {
-    /** Request URL. Used when calling methods with null as URL argument. */
-    url?: string | URL | Request;
-    /**
-     * Base URL prepended to the request URL.
-     * Only used when the URL argument is a string or URL (not when it's a Request object).
-     */
-    base?: string | URL;
-    /** Request body content. Automatically serializes JSON objects. */
-    body?: FetchyBody;
-    /** Request timeout in seconds. Default is 15 seconds. */
-    timeout?: number;
-    /** Retry configuration. Set to false to disable retry functionality. */
-    retry?: false | RetryOptions;
-    /** Bearer token for Authorization header. Automatically adds "Bearer " prefix. */
-    bearer?: string;
-    /**
-     * Maximum jitter delay in seconds applied before each request (including retries).
-     * Adds randomness (0 to specified value) to prevent thundering herd.
-     */
-    jitter?: number;
-    /** If true, does not throw error on HTTP error status, behaving like native fetch. */
-    native?: boolean;
-    /** Property of RequestInit. */
-    cache?: RequestCache;
-    /** Property of RequestInit. */
-    credentials?: RequestCredentials;
-    /** Property of RequestInit. */
-    headers?: HeadersInit;
-    /** Property of RequestInit. */
-    integrity?: string;
-    /** Property of RequestInit. */
-    keepalive?: boolean;
-    /** Property of RequestInit. */
-    method?: string;
-    /** Property of RequestInit. */
-    mode?: RequestMode;
-    /** Property of RequestInit. */
-    redirect?: RequestRedirect;
-    /** Property of RequestInit. */
-    referrer?: string;
-    /** Property of RequestInit. */
-    referrerPolicy?: ReferrerPolicy;
-    /** Property of RequestInit. */
-    signal?: AbortSignal | null;
-    constructor(options?: FetchyOptions);
-    /** Calls fetchy with instance options. */
-    fetch(url?: string | URL | Request | null, options?: FetchyOptions): FetchyResponse;
-    /** Calls fetchy as GET request with instance options. */
-    get(url?: string | URL | Request | null, options?: FetchyOptions): FetchyResponse;
-    /** Calls fetchy as HEAD request with instance options. */
-    head(url?: string | URL | Request | null, options?: FetchyOptions): Promise<Response>;
-    /** Calls fetchy as POST request with instance options. */
-    post(url?: string | URL | Request | null, options?: FetchyOptions): FetchyResponse;
-    /** Calls fetchy as PUT request with instance options. */
-    put(url?: string | URL | Request | null, options?: FetchyOptions): FetchyResponse;
-    /** Calls fetchy as PATCH request with instance options. */
-    patch(url?: string | URL | Request | null, options?: FetchyOptions): FetchyResponse;
-    /** Calls fetchy as DELETE request with instance options. */
-    delete(url?: string | URL | Request | null, options?: FetchyOptions): FetchyResponse;
-    /** Calls sfetchy with instance options. Returns null on error. */
-    safe(url?: string | URL | Request | null, options?: FetchyOptions): FetchySafeResponse | null;
-    /** Calls sfetchy as GET request with instance options. Returns null on error. */
-    sget(url?: string | URL | Request | null, options?: FetchyOptions): FetchySafeResponse | null;
-    /** Calls sfetchy as HEAD request with instance options. Returns null on error. */
-    shead(url?: string | URL | Request | null, options?: FetchyOptions): Promise<Response | null> | null;
-    /** Calls sfetchy as POST request with instance options. Returns null on error. */
-    spost(url?: string | URL | Request | null, options?: FetchyOptions): FetchySafeResponse | null;
-    /** Calls sfetchy as PUT request with instance options. Returns null on error. */
-    sput(url?: string | URL | Request | null, options?: FetchyOptions): FetchySafeResponse | null;
-    /** Calls sfetchy as PATCH request with instance options. Returns null on error. */
-    spatch(url?: string | URL | Request | null, options?: FetchyOptions): FetchySafeResponse | null;
-    /** Calls sfetchy as DELETE request with instance options. Returns null on error. */
-    sdelete(url?: string | URL | Request | null, options?: FetchyOptions): FetchySafeResponse | null;
-}
-/**
- * Creates a new Fetchy instance with the specified options.
- * Shorthand for `new Fetchy(options)`.
- *
  * @param options - Configuration options to apply to all requests made with this instance.
- * @returns A new Fetchy instance.
+ * @returns An object that has Fetchy interface.
  *
  * @example
  * ```ts
@@ -161,6 +63,12 @@ declare class Fetchy implements FetchyOptions {
  *
  * const user = await client.get("/user").json<User>();
  * const posts = await client.get("/posts").json<Post[]>();
+ *
+ * // Safe mode - returns null on error instead of throwing
+ * const result = await client.sfetch("https://api.example.com/data").json<Data>();
+ * if (result !== null) {
+ *   // Handle successful response
+ * }
  * ```
  */
 declare function fy(options?: FetchyOptions): Fetchy;
@@ -204,7 +112,7 @@ declare function fy(options?: FetchyOptions): Fetchy;
  * }
  * ```
  */
-declare function sfetchy(url?: string | URL | Request | null, options?: FetchyOptions): FetchySafeResponse | null;
+declare function sfetchy(url?: string | URL | Request | null, options?: FetchyOptions): FetchySafeResponse;
 /**
  * Performs an HTTP request with enhanced features like timeout, retry, and automatic header management.
  * Throws errors on failure unless configured otherwise via the `native` option.
@@ -229,7 +137,7 @@ declare function sfetchy(url?: string | URL | Request | null, options?: FetchyOp
  *
  * // POST request with JSON body and authentication
  * const result = await fetchy("https://api.example.com/create", {
- *   method: MPOST,
+ *   method: "POST",
  *   body: { name: "John", age: 30 },
  *   bearer: "your-token-here"
  * }).json();
@@ -253,6 +161,28 @@ declare function sfetchy(url?: string | URL | Request | null, options?: FetchyOp
  * ```
  */
 declare function fetchy(url?: string | URL | Request | null, options?: FetchyOptions): FetchyResponse;
+/**
+ * Sets global default options for all fetchy instances.
+ * These options will be merged with instance-specific options, with instance options taking precedence.
+ *
+ * @param options - Default configuration options to apply globally.
+ *
+ * @example
+ * ```ts
+ * import { setFetchy, fetchy } from "@scirexs/fetchy";
+ *
+ * // Set global defaults
+ * setFetchy({
+ *   timeout: 30,
+ *   retry: { maxAttempts: 5 },
+ *   bearer: "global-token"
+ * });
+ *
+ * // All subsequent requests use these defaults
+ * await fetchy("https://api.example.com/data");
+ * ```
+ */
+declare function setFetchy(options: FetchyOptions): void;
 /** Main procedure for fetchy and sfetchy. @internal */
 declare function _main(url: InputArg | undefined, options: FetchyOptions | undefined, safe?: undefined): FetchyResponse;
 declare function _main(url: InputArg | undefined, options: FetchyOptions | undefined, safe: true): FetchySafeResponse;
@@ -264,18 +194,12 @@ declare function _isString(v: unknown): v is string;
 declare function _isNumber(v: unknown): v is number;
 /** Type guard: checks if value is a boolean. @internal */
 declare function _isBool(v: unknown): v is boolean;
-/** Type guard: checks if value is a ReadableStream. @internal */
-declare function _isStream(v: unknown): v is ReadableStream;
 /** Type guard: checks if value is a Request. @internal */
 declare function _isRequest(v: unknown): v is Request;
 /** Type guard: checks if value is a plain object (not array, null, or other object types). @internal */
 declare function _isPlain(v: unknown): v is object;
 /** Corrects a number to be non-negative, using default if invalid. @internal */
 declare function _correctNumber(dflt: number, num?: number): number;
-/** Creates Request object from various input types. @internal */
-declare function _createRequest(url?: InputArg, options?: FetchyOptions): Request;
-/** Creates new Request with ReadableStream body if present in options. @internal */
-declare function _includeStream(req: Request, options?: FetchyOptions): Request;
 /** Converts FetchyOptions to standard RequestInit format. @internal */
 declare function _getRequestInit(url?: InputArg, options?: FetchyOptions): RequestInit;
 /** Converts FetchyBody to standard BodyInit format. @internal */
@@ -284,12 +208,8 @@ declare function _getBody(body?: FetchyBody): Record<string, BodyInit> | null;
 declare function _isJSONObject(arg?: FetchyBody): boolean;
 /** Constructs request headers with automatic Content-Type and Authorization. @internal */
 declare function _getHeaders(options?: FetchyOptions, reqHeaders?: Headers | null): Headers;
-/** Checks if header is absent in both option headers and request headers. @internal */
-declare function _isNoHeader(name: string, optionHeader: Headers, reqHeaders?: Headers | null): boolean;
 /** Determines Content-Type header based on body type. @internal */
 declare function _getContentType(body?: FetchyBody): string;
-/** Checks if Content-Type should be handled by native fetch. @internal */
-declare function _handleByNative(body?: FetchyBody): boolean;
 /** Extracts retry-related options with defaults. @internal */
 declare function _getRetryOption(init: RequestInit, options?: RetryOptions | false): InternalRetry;
 /** Converts FetchyOptions to internal Options format with validated values. @internal */
@@ -300,24 +220,25 @@ declare function _mergeSignals(s1?: AbortSignal | null, s2?: AbortSignal | null)
 declare function _withTimeout(opts: Options): AbortSignal | undefined;
 /** Waits for specified seconds with optional randomization. @internal */
 declare function _wait(sec: number, random?: boolean): Promise<void>;
-/** Checks if HTTP status code indicates an error. @internal */
-declare function _isHttpError(stat: number): boolean;
 /** Determines whether to retry based on conditions and waits before next attempt. @internal */
-declare function _shouldRetry(count: number, opts: Options, r: Response | unknown): Promise<boolean>;
+declare function _shouldRetry(count: number, opts: Options, r: Response | unknown, fn?: unknown): Promise<boolean>;
 /** Calculates next retry interval using exponential backoff or response headers. @internal */
 declare function _getNextInterval(count: number, opts: Options, headers: Headers): number;
 /** Finds and parses retry timing from response headers. @internal */
 declare function _findRetryHeader(opts: Options, headers: Headers): number | undefined;
 /** Parses retry header value to seconds. @internal */
 declare function _parseRetryHeader(value?: string | null): number;
-/** Fetch with retry and creates promise-like object. @internal */
-declare function _makeFetchyResponse(req: Request, init: RequestInit, opts: Options, safe?: boolean): FetchyResponse | FetchySafeResponse;
-/** Creates promise-like object with convenience parsing methods. @internal */
-declare function _assignToPromise(resp: Promise<Response | null>, safe: boolean): FetchyResponse | FetchySafeResponse;
+/** Creates new Request with ReadableStream body if present in options. @internal */
+declare function _includeStream(req: Request, opts: Options): Request;
+/** Creates Request object from various input types. @internal */
+declare function _createRequest(opts: Options, url?: InputArg): Request;
 /** Creates request cloning function with abort handling. @internal */
 declare function _cloneRequestF(req: Request): (cancel?: boolean) => Promise<Request>;
 /** Executes fetch with retry logic and exponential backoff. @internal */
-declare function _fetchWithRetry(req: Request, init: RequestInit, opts: Options, safe: boolean): Promise<Response | null>;
+declare function _fetchWithRetry(url: InputArg | undefined, init: RequestInit, opts: Options, safe: boolean): Promise<Response | null>;
 /** Executes fetch with initial jitter delay. @internal */
 declare function _fetchWithJitter(req: Request, init: RequestInit, opts: Options): Promise<Response>;
+/** Creates promise-like object with convenience parsing methods. @internal */
+declare function _makeFetchyResponse(resp: Promise<Response | null>, safe: boolean): FetchyResponse | FetchySafeResponse;
+declare function _genMethods(obj: object, safe?: boolean): void;
 //# sourceMappingURL=main.d.ts.map

package/types/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,cAAc,EACd,QAAQ,EACR,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACR,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,eAAe,EACf,eAAe,EACf,cAAc,EACd,OAAO,EACP,YAAY,EACZ,aAAa,EACb,WAAW,EACX,SAAS,EACT,QAAQ,EACR,UAAU,EACV,SAAS,EACT,SAAS,EACT,KAAK,EACL,mBAAmB,EACnB,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,iBAAiB,EACjB,YAAY,EACZ,KAAK,EACL,YAAY,EACZ,MAAM,EACN,MAAM,EACN,EAAE,EACF,eAAe,EACf,OAAO,GACR,CAAC;AAEF,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAY9G,+CAA+C;AAC/C,QAAA,MAAM,QAAQ,EAAE,OAWN,CAAC;AACX,iDAAiD;AACjD,QAAA,MAAM,QAAQ,UAA6B,CAAC;AAC5C,qDAAqD;AACrD,QAAA,MAAM,QAAQ,uEAAwE,CAAC;AAGvF,qEAAqE;AACrE,UAAU,OAAO;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AACD,8CAA8C;AAC9C,KAAK,QAAQ,GAAG,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,CAAC;AAC9C,kEAAkE;AAClE,KAAK,aAAa,GAAG,IAAI,CACvB,OAAO,EACP,WAAW,GAAG,cAAc,GAAG,cAAc,GAAG,YAAY,GAAG,eAAe,GAAG,cAAc,GAAG,WAAW,CAC9G,CAAC;AAGF;;;;;;;;;;;;;;;GAeG;AACH,cAAM,eAAgB,SAAQ,KAAK;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;gBACP,IAAI,EAAE,QAAQ;CAM3B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,cAAM,MAAO,YAAW,aAAa;IACnC,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC;IAC7B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IACpB,mEAAmE;IACnE,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,KAAK,CAAC,EAAE,KAAK,GAAG,YAAY,CAAC;IAC7B,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,+BAA+B;IAC/B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,+BAA+B;IAC/B,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;gBAEhB,OAAO,CAAC,EAAE,aAAa;IAGnC,0CAA0C;IAC1C,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc;IAGnF,yDAAyD;IACzD,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc;IAGjF,0DAA0D;IAC1D,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC;IAGrF,0DAA0D;IAC1D,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc;IAGlF,yDAAyD;IACzD,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc;IAGjF,2DAA2D;IAC3D,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc;IAGnF,4DAA4D;IAC5D,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc;IAGpF,kEAAkE;IAClE,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,kBAAkB,GAAG,IAAI;IAG7F,iFAAiF;IACjF,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,kBAAkB,GAAG,IAAI;IAG7F,kFAAkF;IAClF,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,IAAI;IAGpG,kFAAkF;IAClF,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,kBAAkB,GAAG,IAAI;IAG9F,iFAAiF;IACjF,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,kBAAkB,GAAG,IAAI;IAG7F,mFAAmF;IACnF,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,kBAAkB,GAAG,IAAI;IAG/F,oFAAoF;IACpF,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,kBAAkB,GAAG,IAAI;CAGjG;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,iBAAS,EAAE,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAE3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,iBAAS,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,kBAAkB,GAAG,IAAI,CAMxG;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,iBAAS,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc,CAE5F;AAED,uDAAuD;AACvD,iBAAS,KAAK,CAAC,GAAG,EAAE,QAAQ,GAAG,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,SAAS,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,cAAc,CAAC;AAChH,iBAAS,KAAK,CAAC,GAAG,EAAE,QAAQ,GAAG,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,SAAS,EAAE,IAAI,EAAE,IAAI,GAAG,kBAAkB,CAAC;AAS9G,4FAA4F;AAC5F,iBAAS,YAAY,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,CAEnG;AACD,yDAAyD;AACzD,iBAAS,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAE1C;AACD,yDAAyD;AACzD,iBAAS,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAE1C;AACD,0DAA0D;AAC1D,iBAAS,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,OAAO,CAEzC;AACD,iEAAiE;AACjE,iBAAS,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,cAAc,CAElD;AACD,0DAA0D;AAC1D,iBAAS,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,OAAO,CAE5C;AACD,wGAAwG;AACxG,iBAAS,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAEzC;AACD,gFAAgF;AAChF,iBAAS,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1D;AACD,iEAAiE;AACjE,iBAAS,cAAc,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAKxE;AACD,oFAAoF;AACpF,iBAAS,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAItE;AACD,uEAAuE;AACvE,iBAAS,eAAe,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,WAAW,CAQ7E;AACD,iEAAiE;AACjE,iBAAS,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,IAAI,CAEpE;AACD,6EAA6E;AAC7E,iBAAS,aAAa,CAAC,GAAG,CAAC,EAAE,UAAU,GAAG,OAAO,CAEhD;AACD,0FAA0F;AAC1F,iBAAS,WAAW,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CASlF;AACD,uFAAuF;AACvF,iBAAS,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAE9F;AACD,mEAAmE;AACnE,iBAAS,eAAe,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,MAAM,CAGlD;AACD,0EAA0E;AAC1E,iBAAS,eAAe,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAGnD;AACD,8DAA8D;AAC9D,iBAAS,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,KAAK,GAAG,aAAa,CAWzF;AACD,yFAAyF;AACzF,iBAAS,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAQxF;AACD,uDAAuD;AACvD,iBAAS,aAAa,CAAC,EAAE,CAAC,EAAE,WAAW,GAAG,IAAI,EAAE,EAAE,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,WAAW,GAAG,SAAS,CAGhG;AACD,wEAAwE;AACxE,iBAAS,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAG5D;AACD,yEAAyE;AACzE,iBAAe,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAe,iBAIxD;AACD,+DAA+D;AAC/D,iBAAS,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE3C;AACD,+FAA+F;AAC/F,iBAAe,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAajG;AACD,8FAA8F;AAC9F,iBAAS,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAIhF;AACD,qEAAqE;AACrE,iBAAS,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAK7E;AACD,sDAAsD;AACtD,iBAAS,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAKxD;AACD,kEAAkE;AAClE,iBAAS,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAE,OAAe,GAAG,cAAc,GAAG,kBAAkB,CAGvI;AACD,8EAA8E;AAC9E,iBAAS,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,kBAAkB,CAa5G;AACD,sEAAsE;AACtE,iBAAS,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAS5E;AACD,yEAAyE;AACzE,iBAAe,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAiBtH;AACD,0DAA0D;AAC1D,iBAAe,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAGjG"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"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"}

package/types/mod.d.ts

@@ -2,6 +2,6 @@
  * Exports main functions and types for external.
  * @module
  */
-export { Fetchy, fetchy, fy, HTTPStatusError, sfetchy } from "./main.js";
+export { fetchy, fy, HTTPStatusError, setFetchy, sfetchy } from "./main.js";
 export type { FetchyBody, FetchyOptions, FetchyResponse, FetchySafeResponse, JSONValue, RetryOptions } from "./types.js";
 //# sourceMappingURL=mod.d.ts.map

package/types/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,kBAAkB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,eAAe,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC5E,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,kBAAkB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/types/types.d.ts

@@ -170,4 +170,165 @@ export interface FetchySafeResponse extends Promise<Response | null> {
     /** Parses response body safety as FormData. */
     formData: () => Promise<FormData | null>;
 }
+/**
+ * Fluent HTTP client interface with pre-configured options.
+ * Created by `fy()` function, this interface allows method chaining and provides
+ * both standard and safe (error-suppressing) variants of HTTP methods.
+ *
+ * All methods inherit the options specified when creating the Fetchy instance,
+ * which can be overridden by passing additional options to individual method calls.
+ *
+ * @example
+ * ```ts
+ * import { fy } from "@scirexs/fetchy";
+ *
+ * // Create client with base configuration
+ * const api = fy({
+ *   base: "https://api.example.com",
+ *   bearer: "token123",
+ *   timeout: 10,
+ *   retry: { maxAttempts: 3 }
+ * });
+ *
+ * // Use standard methods (throw on error)
+ * const user = await api.get("/user").json<User>();
+ * const result = await api.post("/data", { body: { key: "value" } }).json();
+ *
+ * // Use safe methods (return null on error)
+ * const posts = await api.sget("/posts").json<Post[]>();
+ * if (posts === null) {
+ *   console.log("Failed to fetch posts");
+ * }
+ *
+ * // Override instance options
+ * const data = await api.get("/important", {
+ *   timeout: 30,
+ *   retry: { maxAttempts: 5 }
+ * }).json();
+ * ```
+ */
+export interface Fetchy extends FetchyOptions {
+    /**
+     * Performs HTTP request with instance options.
+     * Equivalent to calling `fetchy()` with pre-configured options.
+     *
+     * @param url - Request URL (uses instance `url` if omitted).
+     * @param options - Additional options to merge with instance options.
+     * @returns Promise-like response object with parsing methods.
+     */
+    fetch(url?: string | URL | Request | null, options?: FetchyOptions): FetchyResponse;
+    /**
+     * Performs GET request with instance options.
+     *
+     * @param url - Request URL (uses instance `url` if omitted).
+     * @param options - Additional options to merge with instance options.
+     * @returns Promise-like response object with parsing methods.
+     */
+    get(url?: string | URL | Request | null, options?: FetchyOptions): FetchyResponse;
+    /**
+     * Performs HEAD request with instance options.
+     * HEAD requests only retrieve headers without response body.
+     *
+     * @param url - Request URL (uses instance `url` if omitted).
+     * @param options - Additional options to merge with instance options.
+     * @returns Promise resolving to Response object.
+     */
+    head(url?: string | URL | Request | null, options?: FetchyOptions): Promise<Response>;
+    /**
+     * Performs POST request with instance options.
+     *
+     * @param url - Request URL (uses instance `url` if omitted).
+     * @param options - Additional options to merge with instance options (typically includes `body`).
+     * @returns Promise-like response object with parsing methods.
+     */
+    post(url?: string | URL | Request | null, options?: FetchyOptions): FetchyResponse;
+    /**
+     * Performs PUT request with instance options.
+     *
+     * @param url - Request URL (uses instance `url` if omitted).
+     * @param options - Additional options to merge with instance options (typically includes `body`).
+     * @returns Promise-like response object with parsing methods.
+     */
+    put(url?: string | URL | Request | null, options?: FetchyOptions): FetchyResponse;
+    /**
+     * Performs PATCH request with instance options.
+     *
+     * @param url - Request URL (uses instance `url` if omitted).
+     * @param options - Additional options to merge with instance options (typically includes `body`).
+     * @returns Promise-like response object with parsing methods.
+     */
+    patch(url?: string | URL | Request | null, options?: FetchyOptions): FetchyResponse;
+    /**
+     * Performs DELETE request with instance options.
+     *
+     * @param url - Request URL (uses instance `url` if omitted).
+     * @param options - Additional options to merge with instance options.
+     * @returns Promise-like response object with parsing methods.
+     */
+    delete(url?: string | URL | Request | null, options?: FetchyOptions): FetchyResponse;
+    /**
+     * Performs HTTP request in safe mode with instance options.
+     * Returns `null` on any error instead of throwing.
+     * Equivalent to calling `sfetchy()` with pre-configured options.
+     *
+     * @param url - Request URL (uses instance `url` if omitted).
+     * @param options - Additional options to merge with instance options.
+     * @returns Promise-like response object that resolves to Response or null.
+     */
+    sfetch(url?: string | URL | Request | null, options?: FetchyOptions): FetchySafeResponse;
+    /**
+     * Performs GET request in safe mode with instance options.
+     * Returns `null` on any error instead of throwing.
+     *
+     * @param url - Request URL (uses instance `url` if omitted).
+     * @param options - Additional options to merge with instance options.
+     * @returns Promise-like response object that resolves to Response or null.
+     */
+    sget(url?: string | URL | Request | null, options?: FetchyOptions): FetchySafeResponse;
+    /**
+     * Performs HEAD request in safe mode with instance options.
+     * Returns `null` on any error instead of throwing.
+     *
+     * @param url - Request URL (uses instance `url` if omitted).
+     * @param options - Additional options to merge with instance options.
+     * @returns Promise resolving to Response or null.
+     */
+    shead(url?: string | URL | Request | null, options?: FetchyOptions): Promise<Response | null>;
+    /**
+     * Performs POST request in safe mode with instance options.
+     * Returns `null` on any error instead of throwing.
+     *
+     * @param url - Request URL (uses instance `url` if omitted).
+     * @param options - Additional options to merge with instance options (typically includes `body`).
+     * @returns Promise-like response object that resolves to Response or null.
+     */
+    spost(url?: string | URL | Request | null, options?: FetchyOptions): FetchySafeResponse;
+    /**
+     * Performs PUT request in safe mode with instance options.
+     * Returns `null` on any error instead of throwing.
+     *
+     * @param url - Request URL (uses instance `url` if omitted).
+     * @param options - Additional options to merge with instance options (typically includes `body`).
+     * @returns Promise-like response object that resolves to Response or null.
+     */
+    sput(url?: string | URL | Request | null, options?: FetchyOptions): FetchySafeResponse;
+    /**
+     * Performs PATCH request in safe mode with instance options.
+     * Returns `null` on any error instead of throwing.
+     *
+     * @param url - Request URL (uses instance `url` if omitted).
+     * @param options - Additional options to merge with instance options (typically includes `body`).
+     * @returns Promise-like response object that resolves to Response or null.
+     */
+    spatch(url?: string | URL | Request | null, options?: FetchyOptions): FetchySafeResponse;
+    /**
+     * Performs DELETE request in safe mode with instance options.
+     * Returns `null` on any error instead of throwing.
+     *
+     * @param url - Request URL (uses instance `url` if omitted).
+     * @param options - Additional options to merge with instance options.
+     * @returns Promise-like response object that resolves to Response or null.
+     */
+    sdelete(url?: string | URL | Request | null, options?: FetchyOptions): FetchySafeResponse;
+}
 //# sourceMappingURL=types.d.ts.map

package/types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}