@fetchkit/ffetch 5.0.1 → 5.1.0

package/dist/plugins/response-shortcuts.d.cts

@@ -0,0 +1,12 @@
+import { C as ClientPlugin } from '../plugins-DqBQVM4I.cjs';
+
+type ResponseShortcuts = {
+    json: <T = unknown>() => Promise<T>;
+    text: () => Promise<string>;
+    blob: () => Promise<Blob>;
+    arrayBuffer: () => Promise<ArrayBuffer>;
+    formData: () => Promise<FormData>;
+};
+declare function responseShortcutsPlugin(): ClientPlugin<Record<never, never>, ResponseShortcuts>;
+
+export { type ResponseShortcuts, responseShortcutsPlugin };

package/dist/plugins/response-shortcuts.d.ts

@@ -0,0 +1,12 @@
+import { C as ClientPlugin } from '../plugins-DqBQVM4I.js';
+
+type ResponseShortcuts = {
+    json: <T = unknown>() => Promise<T>;
+    text: () => Promise<string>;
+    blob: () => Promise<Blob>;
+    arrayBuffer: () => Promise<ArrayBuffer>;
+    formData: () => Promise<FormData>;
+};
+declare function responseShortcutsPlugin(): ClientPlugin<Record<never, never>, ResponseShortcuts>;
+
+export { type ResponseShortcuts, responseShortcutsPlugin };

package/dist/plugins/response-shortcuts.js

@@ -0,0 +1,66 @@
+// src/plugins/response-shortcuts.ts
+function attachResponseShortcuts(promise) {
+  const decorated = promise;
+  if (decorated.__ffetchResponseShortcutsDecorated__) {
+    return decorated;
+  }
+  Object.defineProperties(decorated, {
+    json: {
+      value: function json() {
+        return this.then((response) => response.json());
+      },
+      writable: false,
+      enumerable: false,
+      configurable: false
+    },
+    text: {
+      value: function text() {
+        return this.then((response) => response.text());
+      },
+      writable: false,
+      enumerable: false,
+      configurable: false
+    },
+    blob: {
+      value: function blob() {
+        return this.then((response) => response.blob());
+      },
+      writable: false,
+      enumerable: false,
+      configurable: false
+    },
+    arrayBuffer: {
+      value: function arrayBuffer() {
+        return this.then((response) => response.arrayBuffer());
+      },
+      writable: false,
+      enumerable: false,
+      configurable: false
+    },
+    formData: {
+      value: function formData() {
+        return this.then((response) => response.formData());
+      },
+      writable: false,
+      enumerable: false,
+      configurable: false
+    },
+    __ffetchResponseShortcutsDecorated__: {
+      value: true,
+      writable: false,
+      enumerable: false,
+      configurable: false
+    }
+  });
+  return decorated;
+}
+function responseShortcutsPlugin() {
+  return {
+    name: "response-shortcuts",
+    decoratePromise: (promise) => attachResponseShortcuts(promise)
+  };
+}
+export {
+  responseShortcutsPlugin
+};
+//# sourceMappingURL=response-shortcuts.js.map

package/dist/plugins/response-shortcuts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/plugins/response-shortcuts.ts"],"sourcesContent":["import type { ClientPlugin } from '../plugins.js'\r\n\r\nexport type ResponseShortcuts = {\r\n  json: <T = unknown>() => Promise<T>\r\n  text: () => Promise<string>\r\n  blob: () => Promise<Blob>\r\n  arrayBuffer: () => Promise<ArrayBuffer>\r\n  formData: () => Promise<FormData>\r\n}\r\n\r\ntype ResponseShortcutsPromise = Promise<Response> & ResponseShortcuts\r\n\r\ntype DecoratedPromise = ResponseShortcutsPromise & {\r\n  __ffetchResponseShortcutsDecorated__?: true\r\n}\r\n\r\nfunction attachResponseShortcuts(\r\n  promise: Promise<Response>\r\n): ResponseShortcutsPromise {\r\n  const decorated = promise as DecoratedPromise\r\n\r\n  if (decorated.__ffetchResponseShortcutsDecorated__) {\r\n    return decorated\r\n  }\r\n\r\n  Object.defineProperties(decorated, {\r\n    json: {\r\n      value: function json<T = unknown>(this: Promise<Response>) {\r\n        return this.then((response) => response.json() as Promise<T>)\r\n      },\r\n      writable: false,\r\n      enumerable: false,\r\n      configurable: false,\r\n    },\r\n    text: {\r\n      value: function text(this: Promise<Response>) {\r\n        return this.then((response) => response.text())\r\n      },\r\n      writable: false,\r\n      enumerable: false,\r\n      configurable: false,\r\n    },\r\n    blob: {\r\n      value: function blob(this: Promise<Response>) {\r\n        return this.then((response) => response.blob())\r\n      },\r\n      writable: false,\r\n      enumerable: false,\r\n      configurable: false,\r\n    },\r\n    arrayBuffer: {\r\n      value: function arrayBuffer(this: Promise<Response>) {\r\n        return this.then((response) => response.arrayBuffer())\r\n      },\r\n      writable: false,\r\n      enumerable: false,\r\n      configurable: false,\r\n    },\r\n    formData: {\r\n      value: function formData(this: Promise<Response>) {\r\n        return this.then((response) => response.formData())\r\n      },\r\n      writable: false,\r\n      enumerable: false,\r\n      configurable: false,\r\n    },\r\n    __ffetchResponseShortcutsDecorated__: {\r\n      value: true,\r\n      writable: false,\r\n      enumerable: false,\r\n      configurable: false,\r\n    },\r\n  })\r\n\r\n  return decorated\r\n}\r\n\r\nexport function responseShortcutsPlugin(): ClientPlugin<\r\n  Record<never, never>,\r\n  ResponseShortcuts\r\n> {\r\n  return {\r\n    name: 'response-shortcuts',\r\n    decoratePromise: (promise) => attachResponseShortcuts(promise),\r\n  }\r\n}\r\n"],"mappings":";AAgBA,SAAS,wBACP,SAC0B;AAC1B,QAAM,YAAY;AAElB,MAAI,UAAU,sCAAsC;AAClD,WAAO;AAAA,EACT;AAEA,SAAO,iBAAiB,WAAW;AAAA,IACjC,MAAM;AAAA,MACJ,OAAO,SAAS,OAA2C;AACzD,eAAO,KAAK,KAAK,CAAC,aAAa,SAAS,KAAK,CAAe;AAAA,MAC9D;AAAA,MACA,UAAU;AAAA,MACV,YAAY;AAAA,MACZ,cAAc;AAAA,IAChB;AAAA,IACA,MAAM;AAAA,MACJ,OAAO,SAAS,OAA8B;AAC5C,eAAO,KAAK,KAAK,CAAC,aAAa,SAAS,KAAK,CAAC;AAAA,MAChD;AAAA,MACA,UAAU;AAAA,MACV,YAAY;AAAA,MACZ,cAAc;AAAA,IAChB;AAAA,IACA,MAAM;AAAA,MACJ,OAAO,SAAS,OAA8B;AAC5C,eAAO,KAAK,KAAK,CAAC,aAAa,SAAS,KAAK,CAAC;AAAA,MAChD;AAAA,MACA,UAAU;AAAA,MACV,YAAY;AAAA,MACZ,cAAc;AAAA,IAChB;AAAA,IACA,aAAa;AAAA,MACX,OAAO,SAAS,cAAqC;AACnD,eAAO,KAAK,KAAK,CAAC,aAAa,SAAS,YAAY,CAAC;AAAA,MACvD;AAAA,MACA,UAAU;AAAA,MACV,YAAY;AAAA,MACZ,cAAc;AAAA,IAChB;AAAA,IACA,UAAU;AAAA,MACR,OAAO,SAAS,WAAkC;AAChD,eAAO,KAAK,KAAK,CAAC,aAAa,SAAS,SAAS,CAAC;AAAA,MACpD;AAAA,MACA,UAAU;AAAA,MACV,YAAY;AAAA,MACZ,cAAc;AAAA,IAChB;AAAA,IACA,sCAAsC;AAAA,MACpC,OAAO;AAAA,MACP,UAAU;AAAA,MACV,YAAY;AAAA,MACZ,cAAc;AAAA,IAChB;AAAA,EACF,CAAC;AAED,SAAO;AACT;AAEO,SAAS,0BAGd;AACA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,iBAAiB,CAAC,YAAY,wBAAwB,OAAO;AAAA,EAC/D;AACF;","names":[]}

package/dist/{plugins-9qcU31nU.d.cts → plugins-DqBQVM4I.d.cts}

@@ -1,8 +1,11 @@
 type PluginState = Record<string, unknown>;
 type PluginExtensionBase = Record<PropertyKey, unknown>;
+type PluginRequestPromiseExtensionBase = Record<PropertyKey, unknown>;
 type UnionToIntersection<U> = (U extends unknown ? (arg: U) => void : never) extends (arg: infer I) => void ? I : never;
 type PluginExtensionOf<P> = P extends ClientPlugin<infer TExtension> ? TExtension : Record<never, never>;
+type PluginRequestPromiseExtensionOf<P> = P extends ClientPlugin<PluginExtensionBase, infer TRequestPromiseExtension> ? TRequestPromiseExtension : Record<never, never>;
 type PluginExtensions<TPlugins extends readonly ClientPlugin<PluginExtensionBase>[]> = Extract<UnionToIntersection<PluginExtensionOf<TPlugins[number]>>, object>;
+type PluginRequestPromiseExtensions<TPlugins extends readonly ClientPlugin<PluginExtensionBase, PluginRequestPromiseExtensionBase>[]> = Extract<UnionToIntersection<PluginRequestPromiseExtensionOf<TPlugins[number]>>, object>;
 type PluginSetupContext<TExtension extends PluginExtensionBase = Record<never, never>> = {
     defineExtension: <K extends keyof TExtension>(key: K, descriptor: {
         value: TExtension[K];
@@ -44,15 +47,16 @@ type PluginRequestContext = {
     metadata: PluginRequestMetadata;
 };
 type PluginDispatch = (ctx: PluginRequestContext) => Promise<Response>;
-type ClientPlugin<TExtension extends PluginExtensionBase = Record<never, never>> = {
+type ClientPlugin<TExtension extends PluginExtensionBase = Record<never, never>, TRequestPromiseExtension extends PluginRequestPromiseExtensionBase = Record<never, never>> = {
     name: string;
     order?: number;
     setup?: (ctx: PluginSetupContext<TExtension>) => void;
     preRequest?: (ctx: PluginRequestContext) => void | Promise<void>;
     wrapDispatch?: (next: PluginDispatch) => PluginDispatch;
+    decoratePromise?: (promise: Promise<Response>) => Promise<Response> & TRequestPromiseExtension;
     onSuccess?: (ctx: PluginRequestContext, response: Response) => void | Promise<void>;
     onError?: (ctx: PluginRequestContext, error: unknown) => void | Promise<void>;
     onFinally?: (ctx: PluginRequestContext) => void | Promise<void>;
 };
 
-export type { ClientPlugin as C, PluginExtensionBase as P, PluginExtensions as a, PluginRequestContext as b, PluginDispatch as c, PluginSetupContext as d };
+export type { ClientPlugin as C, PluginExtensionBase as P, PluginRequestPromiseExtensionBase as a, PluginExtensions as b, PluginRequestPromiseExtensions as c, PluginRequestContext as d, PluginDispatch as e, PluginSetupContext as f };

package/dist/{plugins-9qcU31nU.d.ts → plugins-DqBQVM4I.d.ts}

@@ -1,8 +1,11 @@
 type PluginState = Record<string, unknown>;
 type PluginExtensionBase = Record<PropertyKey, unknown>;
+type PluginRequestPromiseExtensionBase = Record<PropertyKey, unknown>;
 type UnionToIntersection<U> = (U extends unknown ? (arg: U) => void : never) extends (arg: infer I) => void ? I : never;
 type PluginExtensionOf<P> = P extends ClientPlugin<infer TExtension> ? TExtension : Record<never, never>;
+type PluginRequestPromiseExtensionOf<P> = P extends ClientPlugin<PluginExtensionBase, infer TRequestPromiseExtension> ? TRequestPromiseExtension : Record<never, never>;
 type PluginExtensions<TPlugins extends readonly ClientPlugin<PluginExtensionBase>[]> = Extract<UnionToIntersection<PluginExtensionOf<TPlugins[number]>>, object>;
+type PluginRequestPromiseExtensions<TPlugins extends readonly ClientPlugin<PluginExtensionBase, PluginRequestPromiseExtensionBase>[]> = Extract<UnionToIntersection<PluginRequestPromiseExtensionOf<TPlugins[number]>>, object>;
 type PluginSetupContext<TExtension extends PluginExtensionBase = Record<never, never>> = {
     defineExtension: <K extends keyof TExtension>(key: K, descriptor: {
         value: TExtension[K];
@@ -44,15 +47,16 @@ type PluginRequestContext = {
     metadata: PluginRequestMetadata;
 };
 type PluginDispatch = (ctx: PluginRequestContext) => Promise<Response>;
-type ClientPlugin<TExtension extends PluginExtensionBase = Record<never, never>> = {
+type ClientPlugin<TExtension extends PluginExtensionBase = Record<never, never>, TRequestPromiseExtension extends PluginRequestPromiseExtensionBase = Record<never, never>> = {
     name: string;
     order?: number;
     setup?: (ctx: PluginSetupContext<TExtension>) => void;
     preRequest?: (ctx: PluginRequestContext) => void | Promise<void>;
     wrapDispatch?: (next: PluginDispatch) => PluginDispatch;
+    decoratePromise?: (promise: Promise<Response>) => Promise<Response> & TRequestPromiseExtension;
     onSuccess?: (ctx: PluginRequestContext, response: Response) => void | Promise<void>;
     onError?: (ctx: PluginRequestContext, error: unknown) => void | Promise<void>;
     onFinally?: (ctx: PluginRequestContext) => void | Promise<void>;
 };
 
-export type { ClientPlugin as C, PluginExtensionBase as P, PluginExtensions as a, PluginRequestContext as b, PluginDispatch as c, PluginSetupContext as d };
+export type { ClientPlugin as C, PluginExtensionBase as P, PluginRequestPromiseExtensionBase as a, PluginExtensions as b, PluginRequestPromiseExtensions as c, PluginRequestContext as d, PluginDispatch as e, PluginSetupContext as f };

package/dist/types-DbmivXba.d.cts

@@ -0,0 +1,48 @@
+import { C as ClientPlugin, P as PluginExtensionBase, a as PluginRequestPromiseExtensionBase } from './plugins-DqBQVM4I.cjs';
+
+type Hooks = {
+    before?: (req: Request) => void | Promise<void>;
+    after?: (req: Request, res: Response) => void | Promise<void>;
+    onError?: (req: Request, err: unknown) => void | Promise<void>;
+    onRetry?: (req: Request, attempt: number, err?: unknown, res?: Response) => void | Promise<void>;
+    onTimeout?: (req: Request) => void | Promise<void>;
+    onAbort?: (req: Request) => void | Promise<void>;
+    onComplete?: (req: Request, res?: Response, err?: unknown) => void | Promise<void>;
+    transformRequest?: (req: Request) => Request | Promise<Request>;
+    transformResponse?: (res: Response, req: Request) => Response | Promise<Response>;
+};
+
+interface RetryContext {
+    attempt: number;
+    request: Request;
+    response?: Response;
+    error?: unknown;
+}
+interface CoreClientOptions {
+    timeout?: number;
+    retries?: number;
+    retryDelay?: number | ((ctx: RetryContext) => number);
+    shouldRetry?: (ctx: RetryContext) => boolean;
+    throwOnHttpError?: boolean;
+    hooks?: Hooks;
+    fetchHandler?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+}
+interface FFetchOptions<TPlugins extends readonly ClientPlugin<PluginExtensionBase, PluginRequestPromiseExtensionBase>[] = readonly ClientPlugin<PluginExtensionBase, PluginRequestPromiseExtensionBase>[]> extends CoreClientOptions {
+    plugins?: TPlugins;
+}
+type FFetchRequestOptions = CoreClientOptions;
+type FFetchRequestPromise<TRequestPromiseExtensions extends object = Record<never, never>> = Promise<Response> & TRequestPromiseExtensions;
+type FFetch<TExtensions extends object = Record<never, never>, TRequestPromiseExtensions extends object = Record<never, never>> = {
+    (input: RequestInfo | URL, init?: FFetchRequestInit): FFetchRequestPromise<TRequestPromiseExtensions>;
+    pendingRequests: PendingRequest[];
+    abortAll: () => void;
+} & TExtensions;
+interface FFetchRequestInit extends RequestInit, FFetchRequestOptions {
+}
+type PendingRequest = {
+    promise: Promise<Response>;
+    request: Request;
+    controller: AbortController;
+};
+
+export type { FFetchOptions as F, Hooks as H, FFetch as a, FFetchRequestInit as b };

package/dist/types-DpHoyvhy.d.ts

@@ -0,0 +1,48 @@
+import { C as ClientPlugin, P as PluginExtensionBase, a as PluginRequestPromiseExtensionBase } from './plugins-DqBQVM4I.js';
+
+type Hooks = {
+    before?: (req: Request) => void | Promise<void>;
+    after?: (req: Request, res: Response) => void | Promise<void>;
+    onError?: (req: Request, err: unknown) => void | Promise<void>;
+    onRetry?: (req: Request, attempt: number, err?: unknown, res?: Response) => void | Promise<void>;
+    onTimeout?: (req: Request) => void | Promise<void>;
+    onAbort?: (req: Request) => void | Promise<void>;
+    onComplete?: (req: Request, res?: Response, err?: unknown) => void | Promise<void>;
+    transformRequest?: (req: Request) => Request | Promise<Request>;
+    transformResponse?: (res: Response, req: Request) => Response | Promise<Response>;
+};
+
+interface RetryContext {
+    attempt: number;
+    request: Request;
+    response?: Response;
+    error?: unknown;
+}
+interface CoreClientOptions {
+    timeout?: number;
+    retries?: number;
+    retryDelay?: number | ((ctx: RetryContext) => number);
+    shouldRetry?: (ctx: RetryContext) => boolean;
+    throwOnHttpError?: boolean;
+    hooks?: Hooks;
+    fetchHandler?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+}
+interface FFetchOptions<TPlugins extends readonly ClientPlugin<PluginExtensionBase, PluginRequestPromiseExtensionBase>[] = readonly ClientPlugin<PluginExtensionBase, PluginRequestPromiseExtensionBase>[]> extends CoreClientOptions {
+    plugins?: TPlugins;
+}
+type FFetchRequestOptions = CoreClientOptions;
+type FFetchRequestPromise<TRequestPromiseExtensions extends object = Record<never, never>> = Promise<Response> & TRequestPromiseExtensions;
+type FFetch<TExtensions extends object = Record<never, never>, TRequestPromiseExtensions extends object = Record<never, never>> = {
+    (input: RequestInfo | URL, init?: FFetchRequestInit): FFetchRequestPromise<TRequestPromiseExtensions>;
+    pendingRequests: PendingRequest[];
+    abortAll: () => void;
+} & TExtensions;
+interface FFetchRequestInit extends RequestInit, FFetchRequestOptions {
+}
+type PendingRequest = {
+    promise: Promise<Response>;
+    request: Request;
+    controller: AbortController;
+};
+
+export type { FFetchOptions as F, Hooks as H, FFetch as a, FFetchRequestInit as b };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fetchkit/ffetch",
-  "version": "5.0.1",
+  "version": "5.1.0",
   "description": "Fetch wrapper with configurable timeouts, retries, and TypeScript-first DX",
   "keywords": [
     "fetch",
@@ -36,6 +36,16 @@
       "types": "./dist/plugins/circuit.d.ts",
       "import": "./dist/plugins/circuit.js",
       "require": "./dist/plugins/circuit.cjs"
+    },
+    "./plugins/response-shortcuts": {
+      "types": "./dist/plugins/response-shortcuts.d.ts",
+      "import": "./dist/plugins/response-shortcuts.js",
+      "require": "./dist/plugins/response-shortcuts.cjs"
+    },
+    "./plugins/request-shortcuts": {
+      "types": "./dist/plugins/request-shortcuts.d.ts",
+      "import": "./dist/plugins/request-shortcuts.js",
+      "require": "./dist/plugins/request-shortcuts.cjs"
     }
   },
   "files": [