@fetchkit/ffetch 5.1.0 → 5.2.0

package/README.md

@@ -67,6 +67,7 @@ ffetch uses a plugin architecture for optional features, so you only include wha
 - **Deduplication plugin (optional, prebuilt)** – automatic deduping of in-flight identical requests
 - **Request shortcuts plugin (optional, prebuilt)** – call `client.get(url)` / `.post()` / `.put()` / `.patch()` / `.delete()` directly on the client
 - **Response shortcuts plugin (optional, prebuilt)** – call `client(url).json()` / `.text()` / `.blob()` directly on the request promise
+- **Download progress plugin (optional, prebuilt)** – stream download progress callbacks with bytes transferred and percentage
 
 **Built-in error classes:** `TimeoutError`, `RetryLimitError`, `CircuitOpenError`, `HttpError`, `NetworkError`, `AbortError`
 
@@ -78,6 +79,7 @@ All plugins are tree-shakeable — import only what you use.
 - **circuitPlugin (optional)**: fail fast after repeated failures.
 - **requestShortcutsPlugin (optional)**: HTTP method shortcuts on the client (`.get()` / `.post()` / `.put()` / `.patch()` / `.delete()` / `.head()` / `.options()`).
 - **responseShortcutsPlugin (optional)**: use `client(url).json()` / `.text()` / `.blob()` style parsing.
+- **downloadProgressPlugin (optional)**: stream download progress via `onProgress(progress, chunk)` callback.
 
 ## What Problems Does ffetch Solve?
 

package/dist/plugins/download-progress.cjs

@@ -0,0 +1,59 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/plugins/download-progress.ts
+var download_progress_exports = {};
+__export(download_progress_exports, {
+  downloadProgressPlugin: () => downloadProgressPlugin
+});
+module.exports = __toCommonJS(download_progress_exports);
+function downloadProgressPlugin(onProgress) {
+  return {
+    name: "downloadProgress",
+    wrapDispatch: (next) => async (ctx) => {
+      const response = await next(ctx);
+      if (!response.body) {
+        return response;
+      }
+      const contentLength = response.headers.get("content-length");
+      const totalBytes = contentLength ? parseInt(contentLength, 10) : 0;
+      let transferredBytes = 0;
+      const stream = response.body.pipeThrough(
+        new TransformStream({
+          transform(chunk, controller) {
+            transferredBytes += chunk.byteLength;
+            const percent = totalBytes > 0 ? transferredBytes / totalBytes : 0;
+            onProgress({ percent, transferredBytes, totalBytes }, chunk);
+            controller.enqueue(chunk);
+          }
+        })
+      );
+      return new Response(stream, {
+        status: response.status,
+        statusText: response.statusText,
+        headers: response.headers
+      });
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  downloadProgressPlugin
+});
+//# sourceMappingURL=download-progress.cjs.map

package/dist/plugins/download-progress.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/plugins/download-progress.ts"],"sourcesContent":["import type { ClientPlugin } from '../plugins.js'\n\nexport type DownloadProgressEvent = {\n  percent: number\n  transferredBytes: number\n  totalBytes: number\n}\n\nexport type DownloadProgressCallback = (\n  progress: DownloadProgressEvent,\n  chunk: Uint8Array\n) => void\n\nexport function downloadProgressPlugin(\n  onProgress: DownloadProgressCallback\n): ClientPlugin {\n  return {\n    name: 'downloadProgress',\n    wrapDispatch: (next) => async (ctx) => {\n      const response = await next(ctx)\n\n      if (!response.body) {\n        return response\n      }\n\n      const contentLength = response.headers.get('content-length')\n      const totalBytes = contentLength ? parseInt(contentLength, 10) : 0\n      let transferredBytes = 0\n\n      const stream = response.body.pipeThrough(\n        new TransformStream<Uint8Array, Uint8Array>({\n          transform(chunk, controller) {\n            transferredBytes += chunk.byteLength\n            const percent = totalBytes > 0 ? transferredBytes / totalBytes : 0\n            onProgress({ percent, transferredBytes, totalBytes }, chunk)\n            controller.enqueue(chunk)\n          },\n        })\n      )\n\n      return new Response(stream, {\n        status: response.status,\n        statusText: response.statusText,\n        headers: response.headers,\n      })\n    },\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAaO,SAAS,uBACd,YACc;AACd,SAAO;AAAA,IACL,MAAM;AAAA,IACN,cAAc,CAAC,SAAS,OAAO,QAAQ;AACrC,YAAM,WAAW,MAAM,KAAK,GAAG;AAE/B,UAAI,CAAC,SAAS,MAAM;AAClB,eAAO;AAAA,MACT;AAEA,YAAM,gBAAgB,SAAS,QAAQ,IAAI,gBAAgB;AAC3D,YAAM,aAAa,gBAAgB,SAAS,eAAe,EAAE,IAAI;AACjE,UAAI,mBAAmB;AAEvB,YAAM,SAAS,SAAS,KAAK;AAAA,QAC3B,IAAI,gBAAwC;AAAA,UAC1C,UAAU,OAAO,YAAY;AAC3B,gCAAoB,MAAM;AAC1B,kBAAM,UAAU,aAAa,IAAI,mBAAmB,aAAa;AACjE,uBAAW,EAAE,SAAS,kBAAkB,WAAW,GAAG,KAAK;AAC3D,uBAAW,QAAQ,KAAK;AAAA,UAC1B;AAAA,QACF,CAAC;AAAA,MACH;AAEA,aAAO,IAAI,SAAS,QAAQ;AAAA,QAC1B,QAAQ,SAAS;AAAA,QACjB,YAAY,SAAS;AAAA,QACrB,SAAS,SAAS;AAAA,MACpB,CAAC;AAAA,IACH;AAAA,EACF;AACF;","names":[]}

package/dist/plugins/download-progress.d.cts

@@ -0,0 +1,11 @@
+import { C as ClientPlugin } from '../plugins-DqBQVM4I.cjs';
+
+type DownloadProgressEvent = {
+    percent: number;
+    transferredBytes: number;
+    totalBytes: number;
+};
+type DownloadProgressCallback = (progress: DownloadProgressEvent, chunk: Uint8Array) => void;
+declare function downloadProgressPlugin(onProgress: DownloadProgressCallback): ClientPlugin;
+
+export { type DownloadProgressCallback, type DownloadProgressEvent, downloadProgressPlugin };

package/dist/plugins/download-progress.d.ts

@@ -0,0 +1,11 @@
+import { C as ClientPlugin } from '../plugins-DqBQVM4I.js';
+
+type DownloadProgressEvent = {
+    percent: number;
+    transferredBytes: number;
+    totalBytes: number;
+};
+type DownloadProgressCallback = (progress: DownloadProgressEvent, chunk: Uint8Array) => void;
+declare function downloadProgressPlugin(onProgress: DownloadProgressCallback): ClientPlugin;
+
+export { type DownloadProgressCallback, type DownloadProgressEvent, downloadProgressPlugin };

package/dist/plugins/download-progress.js

@@ -0,0 +1,34 @@
+// src/plugins/download-progress.ts
+function downloadProgressPlugin(onProgress) {
+  return {
+    name: "downloadProgress",
+    wrapDispatch: (next) => async (ctx) => {
+      const response = await next(ctx);
+      if (!response.body) {
+        return response;
+      }
+      const contentLength = response.headers.get("content-length");
+      const totalBytes = contentLength ? parseInt(contentLength, 10) : 0;
+      let transferredBytes = 0;
+      const stream = response.body.pipeThrough(
+        new TransformStream({
+          transform(chunk, controller) {
+            transferredBytes += chunk.byteLength;
+            const percent = totalBytes > 0 ? transferredBytes / totalBytes : 0;
+            onProgress({ percent, transferredBytes, totalBytes }, chunk);
+            controller.enqueue(chunk);
+          }
+        })
+      );
+      return new Response(stream, {
+        status: response.status,
+        statusText: response.statusText,
+        headers: response.headers
+      });
+    }
+  };
+}
+export {
+  downloadProgressPlugin
+};
+//# sourceMappingURL=download-progress.js.map

package/dist/plugins/download-progress.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/plugins/download-progress.ts"],"sourcesContent":["import type { ClientPlugin } from '../plugins.js'\n\nexport type DownloadProgressEvent = {\n  percent: number\n  transferredBytes: number\n  totalBytes: number\n}\n\nexport type DownloadProgressCallback = (\n  progress: DownloadProgressEvent,\n  chunk: Uint8Array\n) => void\n\nexport function downloadProgressPlugin(\n  onProgress: DownloadProgressCallback\n): ClientPlugin {\n  return {\n    name: 'downloadProgress',\n    wrapDispatch: (next) => async (ctx) => {\n      const response = await next(ctx)\n\n      if (!response.body) {\n        return response\n      }\n\n      const contentLength = response.headers.get('content-length')\n      const totalBytes = contentLength ? parseInt(contentLength, 10) : 0\n      let transferredBytes = 0\n\n      const stream = response.body.pipeThrough(\n        new TransformStream<Uint8Array, Uint8Array>({\n          transform(chunk, controller) {\n            transferredBytes += chunk.byteLength\n            const percent = totalBytes > 0 ? transferredBytes / totalBytes : 0\n            onProgress({ percent, transferredBytes, totalBytes }, chunk)\n            controller.enqueue(chunk)\n          },\n        })\n      )\n\n      return new Response(stream, {\n        status: response.status,\n        statusText: response.statusText,\n        headers: response.headers,\n      })\n    },\n  }\n}\n"],"mappings":";AAaO,SAAS,uBACd,YACc;AACd,SAAO;AAAA,IACL,MAAM;AAAA,IACN,cAAc,CAAC,SAAS,OAAO,QAAQ;AACrC,YAAM,WAAW,MAAM,KAAK,GAAG;AAE/B,UAAI,CAAC,SAAS,MAAM;AAClB,eAAO;AAAA,MACT;AAEA,YAAM,gBAAgB,SAAS,QAAQ,IAAI,gBAAgB;AAC3D,YAAM,aAAa,gBAAgB,SAAS,eAAe,EAAE,IAAI;AACjE,UAAI,mBAAmB;AAEvB,YAAM,SAAS,SAAS,KAAK;AAAA,QAC3B,IAAI,gBAAwC;AAAA,UAC1C,UAAU,OAAO,YAAY;AAC3B,gCAAoB,MAAM;AAC1B,kBAAM,UAAU,aAAa,IAAI,mBAAmB,aAAa;AACjE,uBAAW,EAAE,SAAS,kBAAkB,WAAW,GAAG,KAAK;AAC3D,uBAAW,QAAQ,KAAK;AAAA,UAC1B;AAAA,QACF,CAAC;AAAA,MACH;AAEA,aAAO,IAAI,SAAS,QAAQ;AAAA,QAC1B,QAAQ,SAAS;AAAA,QACjB,YAAY,SAAS;AAAA,QACrB,SAAS,SAAS;AAAA,MACpB,CAAC;AAAA,IACH;AAAA,EACF;AACF;","names":[]}

package/dist/plugins/response-shortcuts.cjs

@@ -23,9 +23,10 @@ __export(response_shortcuts_exports, {
   responseShortcutsPlugin: () => responseShortcutsPlugin
 });
 module.exports = __toCommonJS(response_shortcuts_exports);
+var DECORATED = Symbol("ffetch.responseShortcutsDecorated");
 function attachResponseShortcuts(promise) {
   const decorated = promise;
-  if (decorated.__ffetchResponseShortcutsDecorated__) {
+  if (decorated[DECORATED]) {
     return decorated;
   }
   Object.defineProperties(decorated, {
@@ -69,7 +70,7 @@ function attachResponseShortcuts(promise) {
       enumerable: false,
       configurable: false
     },
-    __ffetchResponseShortcutsDecorated__: {
+    [DECORATED]: {
       value: true,
       writable: false,
       enumerable: false,

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

@@ -1 +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":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;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":[]}
+{"version":3,"sources":["../../src/plugins/response-shortcuts.ts"],"sourcesContent":["import type { ClientPlugin } from '../plugins.js'\n\nexport type ResponseShortcuts = {\n  json: <T = unknown>() => Promise<T>\n  text: () => Promise<string>\n  blob: () => Promise<Blob>\n  arrayBuffer: () => Promise<ArrayBuffer>\n  formData: () => Promise<FormData>\n}\n\ntype ResponseShortcutsPromise = Promise<Response> & ResponseShortcuts\n\nconst DECORATED = Symbol('ffetch.responseShortcutsDecorated')\n\ntype DecoratedPromise = ResponseShortcutsPromise & {\n  [DECORATED]?: true\n}\n\nfunction attachResponseShortcuts(\n  promise: Promise<Response>\n): ResponseShortcutsPromise {\n  const decorated = promise as DecoratedPromise\n\n  if (decorated[DECORATED]) {\n    return decorated\n  }\n\n  Object.defineProperties(decorated, {\n    json: {\n      value: function json<T = unknown>(this: Promise<Response>) {\n        return this.then((response) => response.json() as Promise<T>)\n      },\n      writable: false,\n      enumerable: false,\n      configurable: false,\n    },\n    text: {\n      value: function text(this: Promise<Response>) {\n        return this.then((response) => response.text())\n      },\n      writable: false,\n      enumerable: false,\n      configurable: false,\n    },\n    blob: {\n      value: function blob(this: Promise<Response>) {\n        return this.then((response) => response.blob())\n      },\n      writable: false,\n      enumerable: false,\n      configurable: false,\n    },\n    arrayBuffer: {\n      value: function arrayBuffer(this: Promise<Response>) {\n        return this.then((response) => response.arrayBuffer())\n      },\n      writable: false,\n      enumerable: false,\n      configurable: false,\n    },\n    formData: {\n      value: function formData(this: Promise<Response>) {\n        return this.then((response) => response.formData())\n      },\n      writable: false,\n      enumerable: false,\n      configurable: false,\n    },\n    [DECORATED]: {\n      value: true,\n      writable: false,\n      enumerable: false,\n      configurable: false,\n    },\n  })\n\n  return decorated\n}\n\nexport function responseShortcutsPlugin(): ClientPlugin<\n  Record<never, never>,\n  ResponseShortcuts\n> {\n  return {\n    name: 'response-shortcuts',\n    decoratePromise: (promise) => attachResponseShortcuts(promise),\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAYA,IAAM,YAAY,OAAO,mCAAmC;AAM5D,SAAS,wBACP,SAC0B;AAC1B,QAAM,YAAY;AAElB,MAAI,UAAU,SAAS,GAAG;AACxB,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,CAAC,SAAS,GAAG;AAAA,MACX,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/response-shortcuts.js

@@ -1,7 +1,8 @@
 // src/plugins/response-shortcuts.ts
+var DECORATED = Symbol("ffetch.responseShortcutsDecorated");
 function attachResponseShortcuts(promise) {
   const decorated = promise;
-  if (decorated.__ffetchResponseShortcutsDecorated__) {
+  if (decorated[DECORATED]) {
     return decorated;
   }
   Object.defineProperties(decorated, {
@@ -45,7 +46,7 @@ function attachResponseShortcuts(promise) {
       enumerable: false,
       configurable: false
     },
-    __ffetchResponseShortcutsDecorated__: {
+    [DECORATED]: {
       value: true,
       writable: false,
       enumerable: false,

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

@@ -1 +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":[]}
+{"version":3,"sources":["../../src/plugins/response-shortcuts.ts"],"sourcesContent":["import type { ClientPlugin } from '../plugins.js'\n\nexport type ResponseShortcuts = {\n  json: <T = unknown>() => Promise<T>\n  text: () => Promise<string>\n  blob: () => Promise<Blob>\n  arrayBuffer: () => Promise<ArrayBuffer>\n  formData: () => Promise<FormData>\n}\n\ntype ResponseShortcutsPromise = Promise<Response> & ResponseShortcuts\n\nconst DECORATED = Symbol('ffetch.responseShortcutsDecorated')\n\ntype DecoratedPromise = ResponseShortcutsPromise & {\n  [DECORATED]?: true\n}\n\nfunction attachResponseShortcuts(\n  promise: Promise<Response>\n): ResponseShortcutsPromise {\n  const decorated = promise as DecoratedPromise\n\n  if (decorated[DECORATED]) {\n    return decorated\n  }\n\n  Object.defineProperties(decorated, {\n    json: {\n      value: function json<T = unknown>(this: Promise<Response>) {\n        return this.then((response) => response.json() as Promise<T>)\n      },\n      writable: false,\n      enumerable: false,\n      configurable: false,\n    },\n    text: {\n      value: function text(this: Promise<Response>) {\n        return this.then((response) => response.text())\n      },\n      writable: false,\n      enumerable: false,\n      configurable: false,\n    },\n    blob: {\n      value: function blob(this: Promise<Response>) {\n        return this.then((response) => response.blob())\n      },\n      writable: false,\n      enumerable: false,\n      configurable: false,\n    },\n    arrayBuffer: {\n      value: function arrayBuffer(this: Promise<Response>) {\n        return this.then((response) => response.arrayBuffer())\n      },\n      writable: false,\n      enumerable: false,\n      configurable: false,\n    },\n    formData: {\n      value: function formData(this: Promise<Response>) {\n        return this.then((response) => response.formData())\n      },\n      writable: false,\n      enumerable: false,\n      configurable: false,\n    },\n    [DECORATED]: {\n      value: true,\n      writable: false,\n      enumerable: false,\n      configurable: false,\n    },\n  })\n\n  return decorated\n}\n\nexport function responseShortcutsPlugin(): ClientPlugin<\n  Record<never, never>,\n  ResponseShortcuts\n> {\n  return {\n    name: 'response-shortcuts',\n    decoratePromise: (promise) => attachResponseShortcuts(promise),\n  }\n}\n"],"mappings":";AAYA,IAAM,YAAY,OAAO,mCAAmC;AAM5D,SAAS,wBACP,SAC0B;AAC1B,QAAM,YAAY;AAElB,MAAI,UAAU,SAAS,GAAG;AACxB,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,CAAC,SAAS,GAAG;AAAA,MACX,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/package.json

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