@aries0d0f/fetch-worker 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 aries0d0f
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,158 @@
+# fetch-worker
+
+[![CI](https://github.com/aries0d0f/fetch-worker/actions/workflows/ci.yml/badge.svg)](https://github.com/aries0d0f/fetch-worker/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/%40aries0d0f%2Ffetch-worker?logo=npm)](https://www.npmjs.com/package/@aries0d0f/fetch-worker)
+[![GitHub Packages](https://img.shields.io/badge/package-GitHub%20Packages-blue?logo=github)](https://github.com/aries0d0f/fetch-worker/pkgs/npm/fetch-worker)
+[![license](https://img.shields.io/github/license/aries0d0f/fetch-worker.svg)](./LICENSE)
+
+An axios-style HTTP client built entirely on native `fetch` — with requests run
+on a dedicated Web Worker thread, in parallel with your main thread, via
+[comlink](https://github.com/GoogleChromeLabs/comlink). TypeScript-first from
+the ground up: every method, response, and error shape is fully typed and
+generic over your payloads.
+
+- **Axios-style ergonomics, zero axios** — `http.get/post/put/patch/delete`,
+  typed generics, structured error rejections, and abortable requests — all on
+  top of the platform's own `fetch`, with no polyfills or XHR fallback.
+- **Runs in parallel with your app** — request/response handling, JSON/YAML
+  parsing, and error normalization all happen on a separate Web Worker thread,
+  so they proceed alongside your main thread instead of contending with
+  rendering and user input for the same event loop.
+- **TypeScript-first** — request bodies, response payloads, and error shapes
+  are generic and inferred end-to-end; there's no `any` in the public API.
+- **Same API everywhere** — the client detects its environment at import time.
+  In a browser it spins up a worker automatically; in Node or during SSR
+  (no `Worker` global) it calls `fetch` directly on the current thread instead.
+- **No bundler lock-in** — the worker is loaded via the portable
+  `new URL('./worker.js', import.meta.url)` pattern, which Vite, Webpack 5+,
+  and native ESM all understand. No `?worker` suffix or plugin required.
+- **Small surface area** — two real dependencies: `comlink` (the worker RPC
+  transport) and `js-yaml` (for the `.yaml()` response helper).
+
+## Install
+
+This package is published to both [npmjs.org](https://www.npmjs.com/package/@aries0d0f/fetch-worker)
+and [GitHub Packages](https://github.com/aries0d0f/fetch-worker/pkgs/npm/fetch-worker).
+
+From npmjs.org, no extra setup is needed:
+
+```sh
+bun add @aries0d0f/fetch-worker
+# or: npm install @aries0d0f/fetch-worker / pnpm add @aries0d0f/fetch-worker
+```
+
+To install from GitHub Packages instead, note that it requires authentication
+even for public packages, so point your package manager at the registry with
+a token that has `read:packages` scope first.
+
+Add to `.npmrc` in your project (or `~/.npmrc` globally):
+
+```ini
+@aries0d0f:registry=https://npm.pkg.github.com
+//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}
+```
+
+Then install as usual with the commands above.
+
+## Usage
+
+```ts
+import http from '@aries0d0f/fetch-worker';
+
+const res = await http.get<{ id: number; name: string }>('/api/users/1');
+const user = await res.json();
+
+await http.post('/api/users', { name: 'Ada' });
+```
+
+### Aborting a request
+
+Pass `controllable: true` to get back the in-flight request alongside its
+`AbortController`:
+
+```ts
+const { request, controller } = await http.get('/api/slow', { controllable: true });
+
+setTimeout(() => controller.abort(), 1000);
+
+const res = await request;
+```
+
+### Response helpers
+
+Every response exposes the usual `fetch` `Response` members (`status`, `ok`,
+`text()`, `blob()`, `arrayBuffer()`, ...) plus:
+
+- `res.json<T>()` — parse the body as JSON
+- `res.yaml<T>()` — parse the body as YAML
+- `res.headers` — a `Headers`-like object whose accessors (`get`, `has`,
+  `entries`, `keys`, `values`) return Promises, since `Headers` instances
+  themselves can't cross the worker boundary
+
+### Error handling
+
+A non-2xx response rejects with a plain object rather than throwing:
+
+```ts
+try {
+  await http.get('/api/missing');
+} catch (err) {
+  // err: { ok, status, statusText, url, headers, error: { title, status, detail } }
+}
+```
+
+### Skipping the worker
+
+Import the core client directly to always run on the current thread (useful
+in tests, or when you deliberately don't want a worker):
+
+```ts
+import { http } from '@aries0d0f/fetch-worker/core';
+```
+
+### Framework-reactive values
+
+If you pass a reactive object (e.g. a Vue `ref`/`reactive` value) as a request
+body or options, it's unwrapped to its plain, cloneable form before being sent
+across the worker boundary — no extra step required on your end.
+
+## API
+
+| Method                            | Signature                                      |
+| --------------------------------- | ---------------------------------------------- |
+| `http.get(url, options?)`         | `GET` request                                  |
+| `http.head(url, options?)`        | `HEAD` request                                 |
+| `http.post(url, body, options?)`  | `POST` request                                 |
+| `http.put(url, body, options?)`   | `PUT` request                                  |
+| `http.patch(url, body, options?)` | `PATCH` request                                |
+| `http.delete(url, options?)`      | `DELETE` request                               |
+| `http.request(method, url, ...)`  | Low-level entry point used by all of the above |
+
+`options` extends `RequestInit` (minus `headers`/`body`/`signal`, which are
+handled specially) with one addition: `controllable?: boolean`.
+
+## Why a worker?
+
+Parsing large JSON/YAML payloads, and the general bookkeeping `fetch` does
+around headers/body streams, all run on whichever thread calls it. Moving that
+work onto a dedicated worker thread lets it run in parallel with your main
+thread instead of on it — keeping the main thread free for rendering and user
+input, particularly useful in UI-heavy apps making frequent or large requests.
+
+## Development
+
+```sh
+bun install
+bun run build       # bundle with tsup (ESM output + .d.ts)
+bun run test        # vitest + msw
+bun run lint         # eslint
+bun run typecheck    # tsc --noEmit
+```
+
+This repo uses [Changesets](https://github.com/changesets/changesets) for
+versioning. Run `bun run changeset` alongside your PR to describe the change;
+CI opens a "Version Packages" PR and publishes to GitHub Packages on merge.
+
+## License
+
+[MIT](./LICENSE)

package/dist/core.d.ts

@@ -0,0 +1,70 @@
+type _Response = Response;
+type _Error = Error;
+/**
+ * A structured-clone-safe stand-in for the `Headers` API.
+ *
+ * `Headers` instances cannot cross a worker `postMessage` boundary, so responses
+ * expose this instead. It mirrors the read side of `Headers` (`get`, `has`,
+ * `entries`, `keys`, `values`, `forEach`) but every accessor returns a `Promise`
+ * so it also works correctly when proxied across a worker via comlink.
+ */
+declare class SerializableHeaders {
+    private headers;
+    constructor(headers: Headers | Record<string, string>);
+    get(name: string): Promise<string | null>;
+    has(name: string): Promise<boolean>;
+    entries(): Promise<IterableIterator<[string, string]>>;
+    keys(): Promise<IterableIterator<string>>;
+    values(): Promise<IterableIterator<string>>;
+    forEach(callback: (value: string, key: string) => void): void;
+}
+declare namespace HTTP {
+    type Method = 'HEAD' | 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    type Response<T> = Omit<_Response, 'json' | 'headers'> & {
+        json(): Promise<T>;
+        yaml(): Promise<T>;
+        headers: SerializableHeaders;
+    };
+    type Operator = typeof http;
+    type Options<Controllable extends boolean> = Omit<RequestInit, 'headers' | 'body' | 'signal'> & {
+        controllable?: Controllable;
+        headers?: HeadersInit;
+    };
+    type Payload<Context, Controllable extends boolean> = Controllable extends true ? Promise<{
+        request: Promise<HTTP.Response<Context>>;
+        controller: HTTP.Controller;
+    }> : Promise<HTTP.Response<Context>>;
+    type Exception = Pick<_Response, 'ok' | 'redirected' | 'status' | 'statusText' | 'type' | 'url'> & {
+        headers: Record<string, string>;
+        error: Error;
+    };
+    type Error = {
+        title: string;
+        status: number;
+        detail: string;
+        error?: _Error;
+    };
+    type Controller = AbortController;
+}
+/**
+ * The core HTTP operator: a thin, typed wrapper around native `fetch`.
+ *
+ * This module has no worker/comlink transport wiring of its own — it is safe to
+ * import directly on the main thread, in Node/SSR, or inside a worker. The
+ * worker transport built on top of this lives in `fetch-worker/worker` and the
+ * environment-aware client lives in `fetch-worker` (the package root).
+ */
+declare const http: {
+    request: {
+        <Context, Controllable extends boolean, Method = "HEAD" | "GET" | "DELETE">(method: Method, url: string, args_0: HTTP.Options<Controllable> | undefined): HTTP.Payload<Context, Controllable>;
+        <Context, Payload, Controllable extends boolean, Method = "POST" | "PUT" | "PATCH">(method: Method, url: string, args_0: Payload, args_1: HTTP.Options<Controllable> | undefined): HTTP.Payload<Context, Controllable>;
+    };
+    head: <Context, Controllable extends boolean = false>(url: string, options?: HTTP.Options<Controllable>) => HTTP.Payload<Context, Controllable>;
+    get: <Context, Controllable extends boolean = false>(url: string, options?: HTTP.Options<Controllable>) => HTTP.Payload<Context, Controllable>;
+    post: <Context, Payload, Controllable extends boolean = false>(url: string, body: Payload, options?: HTTP.Options<Controllable>) => HTTP.Payload<Context, Controllable>;
+    put: <Context, Payload, Controllable extends boolean = false>(url: string, body: Payload, options?: HTTP.Options<Controllable>) => HTTP.Payload<Context, Controllable>;
+    delete: <Controllable extends boolean = false>(url: string, options?: HTTP.Options<Controllable>) => HTTP.Payload<void, Controllable>;
+    patch: <Context, Payload, Controllable extends boolean = false>(url: string, body: Payload, options?: HTTP.Options<Controllable>) => HTTP.Payload<Context, Controllable>;
+};
+
+export { HTTP, http };

package/dist/core.js

@@ -0,0 +1,125 @@
+// src/core.ts
+import { proxy } from "comlink";
+import { load } from "js-yaml";
+var SerializableHeaders = class {
+  headers;
+  constructor(headers) {
+    if (headers instanceof Headers) {
+      this.headers = Object.fromEntries(
+        Array.from(headers.entries()).map(([key, value]) => [key.toLowerCase(), value])
+      );
+    } else {
+      this.headers = Object.fromEntries(
+        Object.entries(headers).map(([key, value]) => [key.toLowerCase(), value])
+      );
+    }
+  }
+  get(name) {
+    return Promise.resolve(this.headers[name.toLowerCase()] ?? null);
+  }
+  has(name) {
+    return Promise.resolve(name.toLowerCase() in this.headers);
+  }
+  entries() {
+    return Promise.resolve(Object.entries(this.headers)[Symbol.iterator]());
+  }
+  keys() {
+    return Promise.resolve(Object.keys(this.headers)[Symbol.iterator]());
+  }
+  values() {
+    return Promise.resolve(Object.values(this.headers)[Symbol.iterator]());
+  }
+  forEach(callback) {
+    Object.entries(this.headers).forEach(([key, value]) => callback(value, key));
+  }
+};
+var defaultOptions = {
+  credentials: "same-origin",
+  cache: "default",
+  headers: {
+    "Content-Type": "application/json"
+  }
+};
+var requestHandler = (method, url, ...args) => {
+  const body = ["HEAD", "GET", "DELETE"].includes(method) ? null : args[0];
+  const options = ["HEAD", "GET", "DELETE"].includes(method) ? args[0] : args[1];
+  const controller = new AbortController();
+  const { signal } = controller;
+  const isFileListBody = body?.__proto__?.[Symbol.toStringTag] === "FileList";
+  const request = fetch(url, {
+    method,
+    ...body ? {
+      body: isFileListBody ? [...body].reduce((payload, file) => {
+        payload.append("file", file, `${file.webkitRelativePath || file.name}`);
+        return payload;
+      }, new FormData()) : typeof body === "object" ? JSON.stringify(body) : String(body)
+    } : null,
+    ...defaultOptions,
+    ...options,
+    headers: isFileListBody ? new Headers(options?.headers) : new Headers({ ...defaultOptions.headers, ...options?.headers }),
+    signal
+  }).then(async (res) => {
+    if (!res.ok) {
+      let error;
+      try {
+        error = await res.clone().json();
+      } catch (err) {
+        error = {
+          title: `${res.status === 401 ? "" : "Unknown Error: "}${res.statusText}`,
+          status: res.status,
+          detail: await res.clone().text() ?? String(err),
+          error: new Error(await res.clone().text() ?? String(err))
+        };
+      }
+      return Promise.reject({
+        ok: res.ok,
+        redirected: res.redirected,
+        status: res.status,
+        statusText: res.statusText,
+        type: res.type,
+        url: res.url,
+        headers: Object.fromEntries(res.headers.entries()),
+        error
+      });
+    }
+    return res.clone();
+  }).then(async (res) => {
+    const rawBody = await res.clone().text();
+    const headers = new SerializableHeaders(res.headers);
+    const response = {
+      body: res.body,
+      clone: res.clone,
+      bodyUsed: res.bodyUsed,
+      arrayBuffer: () => Promise.resolve(res.arrayBuffer()),
+      bytes: () => Promise.resolve(res.bytes()),
+      blob: () => Promise.resolve(res.blob()),
+      formData: () => Promise.resolve(res.formData()),
+      text: () => Promise.resolve(rawBody),
+      ok: res.ok,
+      redirected: res.redirected,
+      status: res.status,
+      statusText: res.statusText,
+      type: res.type,
+      url: res.url,
+      headers,
+      // Convenience methods that simply return the already-parsed data
+      json: async () => Promise.resolve(JSON.parse(rawBody)),
+      yaml: async () => Promise.resolve(load(rawBody))
+    };
+    return proxy(response);
+  });
+  return options?.controllable ? proxy({ request, controller }) : request;
+};
+var http = {
+  request: requestHandler,
+  head: (url, options) => requestHandler("HEAD", url, options),
+  get: (url, options) => requestHandler("GET", url, options),
+  post: (url, body, options) => requestHandler("POST", url, body, options),
+  put: (url, body, options) => requestHandler("PUT", url, body, options),
+  delete: (url, options) => requestHandler("DELETE", url, options),
+  patch: (url, body, options) => requestHandler("PATCH", url, body, options)
+};
+export {
+  http
+};
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core.ts"],"sourcesContent":["/// <reference lib=\"webworker\" />\n\nimport { proxy } from 'comlink';\nimport { load } from 'js-yaml';\n\ntype _Response = Response;\ntype _Error = Error;\n\n/**\n * A structured-clone-safe stand-in for the `Headers` API.\n *\n * `Headers` instances cannot cross a worker `postMessage` boundary, so responses\n * expose this instead. It mirrors the read side of `Headers` (`get`, `has`,\n * `entries`, `keys`, `values`, `forEach`) but every accessor returns a `Promise`\n * so it also works correctly when proxied across a worker via comlink.\n */\nclass SerializableHeaders {\n  private headers: Record<string, string>;\n\n  constructor(headers: Headers | Record<string, string>) {\n    if (headers instanceof Headers) {\n      this.headers = Object.fromEntries(\n        Array.from(headers.entries()).map(([key, value]) => [key.toLowerCase(), value])\n      );\n    } else {\n      this.headers = Object.fromEntries(\n        Object.entries(headers).map(([key, value]) => [key.toLowerCase(), value])\n      );\n    }\n  }\n\n  get(name: string): Promise<string | null> {\n    return Promise.resolve(this.headers[name.toLowerCase()] ?? null);\n  }\n\n  has(name: string): Promise<boolean> {\n    return Promise.resolve(name.toLowerCase() in this.headers);\n  }\n\n  entries(): Promise<IterableIterator<[string, string]>> {\n    return Promise.resolve(Object.entries(this.headers)[Symbol.iterator]());\n  }\n\n  keys(): Promise<IterableIterator<string>> {\n    return Promise.resolve(Object.keys(this.headers)[Symbol.iterator]());\n  }\n\n  values(): Promise<IterableIterator<string>> {\n    return Promise.resolve(Object.values(this.headers)[Symbol.iterator]());\n  }\n\n  forEach(callback: (value: string, key: string) => void): void {\n    Object.entries(this.headers).forEach(([key, value]) => callback(value, key));\n  }\n}\n\nexport namespace HTTP {\n  export type Method = 'HEAD' | 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';\n  export type Response<T> = Omit<_Response, 'json' | 'headers'> & {\n    json(): Promise<T>;\n    yaml(): Promise<T>;\n    headers: SerializableHeaders;\n  };\n  export type Operator = typeof http;\n  export type Options<Controllable extends boolean> = Omit<\n    RequestInit,\n    'headers' | 'body' | 'signal'\n  > & {\n    controllable?: Controllable;\n    headers?: HeadersInit;\n  };\n  export type Payload<Context, Controllable extends boolean> = Controllable extends true\n    ? Promise<{\n        request: Promise<HTTP.Response<Context>>;\n        controller: HTTP.Controller;\n      }>\n    : Promise<HTTP.Response<Context>>;\n  export type Exception = Pick<\n    _Response,\n    'ok' | 'redirected' | 'status' | 'statusText' | 'type' | 'url'\n  > & {\n    headers: Record<string, string>;\n    error: Error;\n  };\n  export type Error = {\n    title: string;\n    status: number;\n    detail: string;\n    error?: _Error;\n  };\n  export type Controller = AbortController;\n}\n\nconst defaultOptions: HTTP.Options<false> = {\n  credentials: 'same-origin',\n  cache: 'default',\n  headers: {\n    'Content-Type': 'application/json'\n  }\n};\n\nconst requestHandler: {\n  <Context, Controllable extends boolean, Method = Extract<HTTP.Method, 'HEAD' | 'GET' | 'DELETE'>>(\n    method: Method,\n    url: string,\n    ...args: [HTTP.Options<Controllable> | undefined]\n  ): HTTP.Payload<Context, Controllable>;\n  <\n    Context,\n    Payload,\n    Controllable extends boolean,\n    Method = Exclude<HTTP.Method, 'HEAD' | 'GET' | 'DELETE'>\n  >(\n    method: Method,\n    url: string,\n    ...args: [Payload, HTTP.Options<Controllable> | undefined]\n  ): HTTP.Payload<Context, Controllable>;\n} = <Context, Payload, Controllable extends boolean, Method = HTTP.Method>(\n  method: HTTP.Method,\n  url: string,\n  ...args: Method extends 'HEAD' | 'GET' | 'DELETE'\n    ? [HTTP.Options<Controllable> | undefined]\n    : [Payload, HTTP.Options<Controllable> | undefined]\n) => {\n  const body = (['HEAD', 'GET', 'DELETE'].includes(method) ? null : args[0]) as Payload;\n  const options = (\n    ['HEAD', 'GET', 'DELETE'].includes(method) ? args[0] : args[1]\n  ) as HTTP.Options<Controllable>;\n\n  const controller = new AbortController();\n  const { signal } = controller;\n  // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n  // @ts-ignore: FileList is not defined in the global scope\n  // ? NOTE: FileList JSDOM type cannot work with MSW request mocker, use workaround to do instance type check via prototype chain\n  // ? This is equal to `body instanceof FileList`\n  const isFileListBody = body?.__proto__?.[Symbol.toStringTag] === 'FileList';\n\n  const request = fetch(url, {\n    method,\n    ...(body\n      ? {\n          body: isFileListBody\n            ? [...(body as unknown as FileList)].reduce((payload, file) => {\n                payload.append('file', file, `${file.webkitRelativePath || file.name}`);\n                return payload;\n              }, new FormData())\n            : typeof body === 'object'\n              ? JSON.stringify(body)\n              : String(body)\n        }\n      : null),\n    ...defaultOptions,\n    ...options,\n    headers: isFileListBody\n      ? new Headers(options?.headers)\n      : new Headers({ ...defaultOptions.headers, ...options?.headers }),\n    signal\n  })\n    .then(async (res: Omit<HTTP.Response<Context>, 'yaml' | 'headers'> & { headers: Headers }) => {\n      if (!res.ok) {\n        let error: HTTP.Error;\n\n        try {\n          error = await res.clone().json();\n        } catch (err) {\n          error = {\n            title: `${res.status === 401 ? '' : 'Unknown Error: '}${res.statusText}`,\n            status: res.status,\n            detail: (await res.clone().text()) ?? String(err),\n            error: new Error((await res.clone().text()) ?? String(err))\n          };\n        }\n\n        return Promise.reject({\n          ok: res.ok,\n          redirected: res.redirected,\n          status: res.status,\n          statusText: res.statusText,\n          type: res.type,\n          url: res.url,\n          headers: Object.fromEntries(res.headers.entries()),\n          error\n        } satisfies HTTP.Exception);\n      }\n\n      return res.clone();\n    })\n    .then(async (res: _Response) => {\n      const rawBody = await res.clone().text();\n      // Create a serializable headers object for cross-worker transfer\n      const headers = new SerializableHeaders(res.headers);\n\n      // Return a plain object with response metadata and parsed data\n      // Include convenience methods for backward compatibility\n      // Use proxy() to ensure methods are callable across worker boundary\n      const response: HTTP.Response<Context> = {\n        body: res.body,\n        clone: res.clone,\n        bodyUsed: res.bodyUsed,\n        arrayBuffer: () => Promise.resolve(res.arrayBuffer()),\n        bytes: () => Promise.resolve(res.bytes()),\n        blob: () => Promise.resolve(res.blob()),\n        formData: () => Promise.resolve(res.formData()),\n        text: () => Promise.resolve(rawBody),\n        ok: res.ok,\n        redirected: res.redirected,\n        status: res.status,\n        statusText: res.statusText,\n        type: res.type,\n        url: res.url,\n        headers,\n        // Convenience methods that simply return the already-parsed data\n        json: async () => Promise.resolve(JSON.parse(rawBody) as Context),\n        yaml: async () => Promise.resolve(load(rawBody) as Context)\n      };\n\n      return proxy(response);\n    });\n\n  return options?.controllable\n    ? proxy({ request, controller } as unknown as HTTP.Payload<Context, true>) // Comlink will convert proxied to a Promise\n    : (request satisfies HTTP.Payload<Context, false>);\n};\n\n/**\n * The core HTTP operator: a thin, typed wrapper around native `fetch`.\n *\n * This module has no worker/comlink transport wiring of its own — it is safe to\n * import directly on the main thread, in Node/SSR, or inside a worker. The\n * worker transport built on top of this lives in `fetch-worker/worker` and the\n * environment-aware client lives in `fetch-worker` (the package root).\n */\nexport const http = {\n  request: requestHandler,\n  head: <Context, Controllable extends boolean = false>(\n    url: string,\n    options?: HTTP.Options<Controllable>\n  ) => requestHandler<Context, Controllable, 'HEAD'>('HEAD', url, options),\n  get: <Context, Controllable extends boolean = false>(\n    url: string,\n    options?: HTTP.Options<Controllable>\n  ) => requestHandler<Context, Controllable, 'GET'>('GET', url, options),\n  post: <Context, Payload, Controllable extends boolean = false>(\n    url: string,\n    body: Payload,\n    options?: HTTP.Options<Controllable>\n  ) => requestHandler<Context, Payload, Controllable, 'POST'>('POST', url, body, options),\n  put: <Context, Payload, Controllable extends boolean = false>(\n    url: string,\n    body: Payload,\n    options?: HTTP.Options<Controllable>\n  ) => requestHandler<Context, Payload, Controllable, 'PUT'>('PUT', url, body, options),\n  delete: <Controllable extends boolean = false>(\n    url: string,\n    options?: HTTP.Options<Controllable>\n  ) => requestHandler<void, Controllable, 'DELETE'>('DELETE', url, options),\n  patch: <Context, Payload, Controllable extends boolean = false>(\n    url: string,\n    body: Payload,\n    options?: HTTP.Options<Controllable>\n  ) => requestHandler<Context, Payload, Controllable, 'PATCH'>('PATCH', url, body, options)\n};\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import { HTTP } from './core.js';
+export { http as core } from './core.js';
+
+/**
+ * Normalizes a value so it is safely transferable via `postMessage`'s
+ * structured clone algorithm: strips reactive Proxy wrappers (Vue, and
+ * anything else that follows the same `__v_raw` convention) and converts
+ * `Headers` instances to plain objects.
+ */
+declare const toCloneable: <T>(value: T) => T;
+/**
+ * The environment-aware HTTP client.
+ *
+ * In any environment with a `Worker` global (browsers), requests are
+ * transparently offloaded to a Web Worker via comlink. In environments without
+ * one (Node, SSR), it falls back to calling `fetch` directly on the current
+ * thread — same API either way.
+ */
+declare const http: HTTP.Operator;
+
+export { HTTP, http as default, toCloneable };

package/dist/index.js

@@ -0,0 +1,178 @@
+// src/index.ts
+import { wrap } from "comlink";
+
+// src/core.ts
+import { proxy } from "comlink";
+import { load } from "js-yaml";
+var SerializableHeaders = class {
+  headers;
+  constructor(headers) {
+    if (headers instanceof Headers) {
+      this.headers = Object.fromEntries(
+        Array.from(headers.entries()).map(([key, value]) => [key.toLowerCase(), value])
+      );
+    } else {
+      this.headers = Object.fromEntries(
+        Object.entries(headers).map(([key, value]) => [key.toLowerCase(), value])
+      );
+    }
+  }
+  get(name) {
+    return Promise.resolve(this.headers[name.toLowerCase()] ?? null);
+  }
+  has(name) {
+    return Promise.resolve(name.toLowerCase() in this.headers);
+  }
+  entries() {
+    return Promise.resolve(Object.entries(this.headers)[Symbol.iterator]());
+  }
+  keys() {
+    return Promise.resolve(Object.keys(this.headers)[Symbol.iterator]());
+  }
+  values() {
+    return Promise.resolve(Object.values(this.headers)[Symbol.iterator]());
+  }
+  forEach(callback) {
+    Object.entries(this.headers).forEach(([key, value]) => callback(value, key));
+  }
+};
+var defaultOptions = {
+  credentials: "same-origin",
+  cache: "default",
+  headers: {
+    "Content-Type": "application/json"
+  }
+};
+var requestHandler = (method, url, ...args) => {
+  const body = ["HEAD", "GET", "DELETE"].includes(method) ? null : args[0];
+  const options = ["HEAD", "GET", "DELETE"].includes(method) ? args[0] : args[1];
+  const controller = new AbortController();
+  const { signal } = controller;
+  const isFileListBody = body?.__proto__?.[Symbol.toStringTag] === "FileList";
+  const request = fetch(url, {
+    method,
+    ...body ? {
+      body: isFileListBody ? [...body].reduce((payload, file) => {
+        payload.append("file", file, `${file.webkitRelativePath || file.name}`);
+        return payload;
+      }, new FormData()) : typeof body === "object" ? JSON.stringify(body) : String(body)
+    } : null,
+    ...defaultOptions,
+    ...options,
+    headers: isFileListBody ? new Headers(options?.headers) : new Headers({ ...defaultOptions.headers, ...options?.headers }),
+    signal
+  }).then(async (res) => {
+    if (!res.ok) {
+      let error;
+      try {
+        error = await res.clone().json();
+      } catch (err) {
+        error = {
+          title: `${res.status === 401 ? "" : "Unknown Error: "}${res.statusText}`,
+          status: res.status,
+          detail: await res.clone().text() ?? String(err),
+          error: new Error(await res.clone().text() ?? String(err))
+        };
+      }
+      return Promise.reject({
+        ok: res.ok,
+        redirected: res.redirected,
+        status: res.status,
+        statusText: res.statusText,
+        type: res.type,
+        url: res.url,
+        headers: Object.fromEntries(res.headers.entries()),
+        error
+      });
+    }
+    return res.clone();
+  }).then(async (res) => {
+    const rawBody = await res.clone().text();
+    const headers = new SerializableHeaders(res.headers);
+    const response = {
+      body: res.body,
+      clone: res.clone,
+      bodyUsed: res.bodyUsed,
+      arrayBuffer: () => Promise.resolve(res.arrayBuffer()),
+      bytes: () => Promise.resolve(res.bytes()),
+      blob: () => Promise.resolve(res.blob()),
+      formData: () => Promise.resolve(res.formData()),
+      text: () => Promise.resolve(rawBody),
+      ok: res.ok,
+      redirected: res.redirected,
+      status: res.status,
+      statusText: res.statusText,
+      type: res.type,
+      url: res.url,
+      headers,
+      // Convenience methods that simply return the already-parsed data
+      json: async () => Promise.resolve(JSON.parse(rawBody)),
+      yaml: async () => Promise.resolve(load(rawBody))
+    };
+    return proxy(response);
+  });
+  return options?.controllable ? proxy({ request, controller }) : request;
+};
+var http = {
+  request: requestHandler,
+  head: (url, options) => requestHandler("HEAD", url, options),
+  get: (url, options) => requestHandler("GET", url, options),
+  post: (url, body, options) => requestHandler("POST", url, body, options),
+  put: (url, body, options) => requestHandler("PUT", url, body, options),
+  delete: (url, options) => requestHandler("DELETE", url, options),
+  patch: (url, body, options) => requestHandler("PATCH", url, body, options)
+};
+
+// src/index.ts
+var unwrapReactive = (value) => {
+  const raw = value?.__v_raw;
+  return raw !== void 0 ? raw : value;
+};
+var toCloneable = (value) => {
+  if (value === null || value === void 0 || typeof value !== "object") return value;
+  const raw = unwrapReactive(value);
+  if (raw?.__proto__?.[Symbol.toStringTag] === "FileList") return raw;
+  if (raw instanceof Headers) {
+    return Object.fromEntries(raw.entries());
+  }
+  if (raw instanceof Date || raw instanceof RegExp || raw instanceof ArrayBuffer || ArrayBuffer.isView(raw)) {
+    return raw;
+  }
+  if (Array.isArray(raw)) {
+    return raw.map(toCloneable);
+  }
+  const result = {};
+  for (const key of Object.keys(raw)) {
+    result[key] = toCloneable(raw[key]);
+  }
+  return result;
+};
+var createWorkerClient = () => {
+  const worker = wrap(
+    new Worker(new URL("./worker.js", import.meta.url), { type: "module" })
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  );
+  return {
+    // request() has overloaded signatures; method (index 0) and url (index 1)
+    // are strings and don't need normalization.
+    request: ((...args) => worker.request(
+      args[0],
+      args[1],
+      ...args.slice(2).map(toCloneable)
+    )),
+    head: (url, options) => worker.head(url, toCloneable(options)),
+    get: (url, options) => worker.get(url, toCloneable(options)),
+    post: (url, body, options) => worker.post(url, toCloneable(body), toCloneable(options)),
+    put: (url, body, options) => worker.put(url, toCloneable(body), toCloneable(options)),
+    delete: (url, options) => worker.delete(url, toCloneable(options)),
+    patch: (url, body, options) => worker.patch(url, toCloneable(body), toCloneable(options))
+  };
+};
+var http2 = typeof Worker === "undefined" ? http : createWorkerClient();
+var src_default = http2;
+export {
+  http as core,
+  src_default as default,
+  toCloneable
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/core.ts"],"sourcesContent":["import { wrap } from 'comlink';\n\nimport { http as core } from './core';\n\nimport type { HTTP } from './core';\n\n/**\n * Duck-types Vue 3's reactive Proxy marker instead of importing `vue` as a hard\n * dependency. Vue exposes this same check publicly as `toRaw()`; reading the\n * `__v_raw` marker directly gets identical behavior without requiring\n * consumers who aren't using Vue to install it.\n */\nconst unwrapReactive = <T>(value: T): T => {\n  const raw = (value as { __v_raw?: T })?.__v_raw;\n  return raw !== undefined ? raw : value;\n};\n\n/**\n * Normalizes a value so it is safely transferable via `postMessage`'s\n * structured clone algorithm: strips reactive Proxy wrappers (Vue, and\n * anything else that follows the same `__v_raw` convention) and converts\n * `Headers` instances to plain objects.\n */\nconst toCloneable = <T>(value: T): T => {\n  if (value === null || value === undefined || typeof value !== 'object') return value;\n\n  const raw = unwrapReactive(value as object) as T;\n\n  // FileList: not structured-cloneable; passed through (the worker handles it via FormData)\n  // Uses __proto__ pattern to match core.ts's FileList detection for JSDOM compatibility\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  if ((raw as any)?.__proto__?.[Symbol.toStringTag] === 'FileList') return raw;\n\n  // Headers: never structured-cloneable; convert to plain Record<string, string>\n  if (raw instanceof Headers) {\n    return Object.fromEntries((raw as Headers).entries()) as unknown as T;\n  }\n\n  // Structured-cloneable built-ins: pass through without modification\n  if (\n    raw instanceof Date ||\n    raw instanceof RegExp ||\n    raw instanceof ArrayBuffer ||\n    ArrayBuffer.isView(raw)\n  ) {\n    return raw;\n  }\n\n  // Array: recursively normalize each element\n  if (Array.isArray(raw)) {\n    return (raw as unknown[]).map(toCloneable) as unknown as T;\n  }\n\n  // Plain object: copy own enumerable keys, recursively normalizing values\n  const result: Record<string, unknown> = {};\n  for (const key of Object.keys(raw as object)) {\n    result[key] = toCloneable((raw as Record<string, unknown>)[key]);\n  }\n  return result as unknown as T;\n};\n\nconst createWorkerClient = (): HTTP.Operator => {\n  // `new URL('./worker.js', import.meta.url)` is the portable worker-bundling\n  // pattern understood by Vite, Webpack 5+, and native ESM — no bundler-specific\n  // import syntax (e.g. Vite's `?worker`) required.\n  const worker = wrap<HTTP.Operator>(\n    new Worker(new URL('./worker.js', import.meta.url), { type: 'module' })\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ) as any;\n\n  return {\n    // request() has overloaded signatures; method (index 0) and url (index 1)\n    // are strings and don't need normalization.\n    request: ((...args: [string, string, ...unknown[]]) =>\n      worker.request(\n        args[0],\n        args[1],\n        ...args.slice(2).map(toCloneable)\n      )) as unknown as HTTP.Operator['request'],\n    head: (url: string, options?: HTTP.Options<boolean>) => worker.head(url, toCloneable(options)),\n    get: (url: string, options?: HTTP.Options<boolean>) => worker.get(url, toCloneable(options)),\n    post: (url: string, body: unknown, options?: HTTP.Options<boolean>) =>\n      worker.post(url, toCloneable(body), toCloneable(options)),\n    put: (url: string, body: unknown, options?: HTTP.Options<boolean>) =>\n      worker.put(url, toCloneable(body), toCloneable(options)),\n    delete: (url: string, options?: HTTP.Options<boolean>) =>\n      worker.delete(url, toCloneable(options)),\n    patch: (url: string, body: unknown, options?: HTTP.Options<boolean>) =>\n      worker.patch(url, toCloneable(body), toCloneable(options))\n  } as unknown as HTTP.Operator;\n};\n\n/**\n * The environment-aware HTTP client.\n *\n * In any environment with a `Worker` global (browsers), requests are\n * transparently offloaded to a Web Worker via comlink. In environments without\n * one (Node, SSR), it falls back to calling `fetch` directly on the current\n * thread — same API either way.\n */\nconst http: HTTP.Operator = typeof Worker === 'undefined' ? core : createWorkerClient();\n\nexport default http;\nexport { core, toCloneable };\nexport type { HTTP };\n","/// <reference lib=\"webworker\" />\n\nimport { proxy } from 'comlink';\nimport { load } from 'js-yaml';\n\ntype _Response = Response;\ntype _Error = Error;\n\n/**\n * A structured-clone-safe stand-in for the `Headers` API.\n *\n * `Headers` instances cannot cross a worker `postMessage` boundary, so responses\n * expose this instead. It mirrors the read side of `Headers` (`get`, `has`,\n * `entries`, `keys`, `values`, `forEach`) but every accessor returns a `Promise`\n * so it also works correctly when proxied across a worker via comlink.\n */\nclass SerializableHeaders {\n  private headers: Record<string, string>;\n\n  constructor(headers: Headers | Record<string, string>) {\n    if (headers instanceof Headers) {\n      this.headers = Object.fromEntries(\n        Array.from(headers.entries()).map(([key, value]) => [key.toLowerCase(), value])\n      );\n    } else {\n      this.headers = Object.fromEntries(\n        Object.entries(headers).map(([key, value]) => [key.toLowerCase(), value])\n      );\n    }\n  }\n\n  get(name: string): Promise<string | null> {\n    return Promise.resolve(this.headers[name.toLowerCase()] ?? null);\n  }\n\n  has(name: string): Promise<boolean> {\n    return Promise.resolve(name.toLowerCase() in this.headers);\n  }\n\n  entries(): Promise<IterableIterator<[string, string]>> {\n    return Promise.resolve(Object.entries(this.headers)[Symbol.iterator]());\n  }\n\n  keys(): Promise<IterableIterator<string>> {\n    return Promise.resolve(Object.keys(this.headers)[Symbol.iterator]());\n  }\n\n  values(): Promise<IterableIterator<string>> {\n    return Promise.resolve(Object.values(this.headers)[Symbol.iterator]());\n  }\n\n  forEach(callback: (value: string, key: string) => void): void {\n    Object.entries(this.headers).forEach(([key, value]) => callback(value, key));\n  }\n}\n\nexport namespace HTTP {\n  export type Method = 'HEAD' | 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';\n  export type Response<T> = Omit<_Response, 'json' | 'headers'> & {\n    json(): Promise<T>;\n    yaml(): Promise<T>;\n    headers: SerializableHeaders;\n  };\n  export type Operator = typeof http;\n  export type Options<Controllable extends boolean> = Omit<\n    RequestInit,\n    'headers' | 'body' | 'signal'\n  > & {\n    controllable?: Controllable;\n    headers?: HeadersInit;\n  };\n  export type Payload<Context, Controllable extends boolean> = Controllable extends true\n    ? Promise<{\n        request: Promise<HTTP.Response<Context>>;\n        controller: HTTP.Controller;\n      }>\n    : Promise<HTTP.Response<Context>>;\n  export type Exception = Pick<\n    _Response,\n    'ok' | 'redirected' | 'status' | 'statusText' | 'type' | 'url'\n  > & {\n    headers: Record<string, string>;\n    error: Error;\n  };\n  export type Error = {\n    title: string;\n    status: number;\n    detail: string;\n    error?: _Error;\n  };\n  export type Controller = AbortController;\n}\n\nconst defaultOptions: HTTP.Options<false> = {\n  credentials: 'same-origin',\n  cache: 'default',\n  headers: {\n    'Content-Type': 'application/json'\n  }\n};\n\nconst requestHandler: {\n  <Context, Controllable extends boolean, Method = Extract<HTTP.Method, 'HEAD' | 'GET' | 'DELETE'>>(\n    method: Method,\n    url: string,\n    ...args: [HTTP.Options<Controllable> | undefined]\n  ): HTTP.Payload<Context, Controllable>;\n  <\n    Context,\n    Payload,\n    Controllable extends boolean,\n    Method = Exclude<HTTP.Method, 'HEAD' | 'GET' | 'DELETE'>\n  >(\n    method: Method,\n    url: string,\n    ...args: [Payload, HTTP.Options<Controllable> | undefined]\n  ): HTTP.Payload<Context, Controllable>;\n} = <Context, Payload, Controllable extends boolean, Method = HTTP.Method>(\n  method: HTTP.Method,\n  url: string,\n  ...args: Method extends 'HEAD' | 'GET' | 'DELETE'\n    ? [HTTP.Options<Controllable> | undefined]\n    : [Payload, HTTP.Options<Controllable> | undefined]\n) => {\n  const body = (['HEAD', 'GET', 'DELETE'].includes(method) ? null : args[0]) as Payload;\n  const options = (\n    ['HEAD', 'GET', 'DELETE'].includes(method) ? args[0] : args[1]\n  ) as HTTP.Options<Controllable>;\n\n  const controller = new AbortController();\n  const { signal } = controller;\n  // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n  // @ts-ignore: FileList is not defined in the global scope\n  // ? NOTE: FileList JSDOM type cannot work with MSW request mocker, use workaround to do instance type check via prototype chain\n  // ? This is equal to `body instanceof FileList`\n  const isFileListBody = body?.__proto__?.[Symbol.toStringTag] === 'FileList';\n\n  const request = fetch(url, {\n    method,\n    ...(body\n      ? {\n          body: isFileListBody\n            ? [...(body as unknown as FileList)].reduce((payload, file) => {\n                payload.append('file', file, `${file.webkitRelativePath || file.name}`);\n                return payload;\n              }, new FormData())\n            : typeof body === 'object'\n              ? JSON.stringify(body)\n              : String(body)\n        }\n      : null),\n    ...defaultOptions,\n    ...options,\n    headers: isFileListBody\n      ? new Headers(options?.headers)\n      : new Headers({ ...defaultOptions.headers, ...options?.headers }),\n    signal\n  })\n    .then(async (res: Omit<HTTP.Response<Context>, 'yaml' | 'headers'> & { headers: Headers }) => {\n      if (!res.ok) {\n        let error: HTTP.Error;\n\n        try {\n          error = await res.clone().json();\n        } catch (err) {\n          error = {\n            title: `${res.status === 401 ? '' : 'Unknown Error: '}${res.statusText}`,\n            status: res.status,\n            detail: (await res.clone().text()) ?? String(err),\n            error: new Error((await res.clone().text()) ?? String(err))\n          };\n        }\n\n        return Promise.reject({\n          ok: res.ok,\n          redirected: res.redirected,\n          status: res.status,\n          statusText: res.statusText,\n          type: res.type,\n          url: res.url,\n          headers: Object.fromEntries(res.headers.entries()),\n          error\n        } satisfies HTTP.Exception);\n      }\n\n      return res.clone();\n    })\n    .then(async (res: _Response) => {\n      const rawBody = await res.clone().text();\n      // Create a serializable headers object for cross-worker transfer\n      const headers = new SerializableHeaders(res.headers);\n\n      // Return a plain object with response metadata and parsed data\n      // Include convenience methods for backward compatibility\n      // Use proxy() to ensure methods are callable across worker boundary\n      const response: HTTP.Response<Context> = {\n        body: res.body,\n        clone: res.clone,\n        bodyUsed: res.bodyUsed,\n        arrayBuffer: () => Promise.resolve(res.arrayBuffer()),\n        bytes: () => Promise.resolve(res.bytes()),\n        blob: () => Promise.resolve(res.blob()),\n        formData: () => Promise.resolve(res.formData()),\n        text: () => Promise.resolve(rawBody),\n        ok: res.ok,\n        redirected: res.redirected,\n        status: res.status,\n        statusText: res.statusText,\n        type: res.type,\n        url: res.url,\n        headers,\n        // Convenience methods that simply return the already-parsed data\n        json: async () => Promise.resolve(JSON.parse(rawBody) as Context),\n        yaml: async () => Promise.resolve(load(rawBody) as Context)\n      };\n\n      return proxy(response);\n    });\n\n  return options?.controllable\n    ? proxy({ request, controller } as unknown as HTTP.Payload<Context, true>) // Comlink will convert proxied to a Promise\n    : (request satisfies HTTP.Payload<Context, false>);\n};\n\n/**\n * The core HTTP operator: a thin, typed wrapper around native `fetch`.\n *\n * This module has no worker/comlink transport wiring of its own — it is safe to\n * import directly on the main thread, in Node/SSR, or inside a worker. The\n * worker transport built on top of this lives in `fetch-worker/worker` and the\n * environment-aware client lives in `fetch-worker` (the package root).\n */\nexport const http = {\n  request: requestHandler,\n  head: <Context, Controllable extends boolean = false>(\n    url: string,\n    options?: HTTP.Options<Controllable>\n  ) => requestHandler<Context, Controllable, 'HEAD'>('HEAD', url, options),\n  get: <Context, Controllable extends boolean = false>(\n    url: string,\n    options?: HTTP.Options<Controllable>\n  ) => requestHandler<Context, Controllable, 'GET'>('GET', url, options),\n  post: <Context, Payload, Controllable extends boolean = false>(\n    url: string,\n    body: Payload,\n    options?: HTTP.Options<Controllable>\n  ) => requestHandler<Context, Payload, Controllable, 'POST'>('POST', url, body, options),\n  put: <Context, Payload, Controllable extends boolean = false>(\n    url: string,\n    body: Payload,\n    options?: HTTP.Options<Controllable>\n  ) => requestHandler<Context, Payload, Controllable, 'PUT'>('PUT', url, body, options),\n  delete: <Controllable extends boolean = false>(\n    url: string,\n    options?: HTTP.Options<Controllable>\n  ) => requestHandler<void, Controllable, 'DELETE'>('DELETE', url, options),\n  patch: <Context, Payload, Controllable extends boolean = false>(\n    url: string,\n    body: Payload,\n    options?: HTTP.Options<Controllable>\n  ) => requestHandler<Context, Payload, Controllable, 'PATCH'>('PATCH', url, body, options)\n};\n"],"mappings":"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","names":["http"]}

package/dist/worker.d.ts

@@ -0,0 +1,3 @@
+declare const _default: null;
+
+export { _default as default };

package/dist/worker.js

@@ -0,0 +1,133 @@
+// src/worker.ts
+import { expose } from "comlink";
+
+// src/core.ts
+import { proxy } from "comlink";
+import { load } from "js-yaml";
+var SerializableHeaders = class {
+  headers;
+  constructor(headers) {
+    if (headers instanceof Headers) {
+      this.headers = Object.fromEntries(
+        Array.from(headers.entries()).map(([key, value]) => [key.toLowerCase(), value])
+      );
+    } else {
+      this.headers = Object.fromEntries(
+        Object.entries(headers).map(([key, value]) => [key.toLowerCase(), value])
+      );
+    }
+  }
+  get(name) {
+    return Promise.resolve(this.headers[name.toLowerCase()] ?? null);
+  }
+  has(name) {
+    return Promise.resolve(name.toLowerCase() in this.headers);
+  }
+  entries() {
+    return Promise.resolve(Object.entries(this.headers)[Symbol.iterator]());
+  }
+  keys() {
+    return Promise.resolve(Object.keys(this.headers)[Symbol.iterator]());
+  }
+  values() {
+    return Promise.resolve(Object.values(this.headers)[Symbol.iterator]());
+  }
+  forEach(callback) {
+    Object.entries(this.headers).forEach(([key, value]) => callback(value, key));
+  }
+};
+var defaultOptions = {
+  credentials: "same-origin",
+  cache: "default",
+  headers: {
+    "Content-Type": "application/json"
+  }
+};
+var requestHandler = (method, url, ...args) => {
+  const body = ["HEAD", "GET", "DELETE"].includes(method) ? null : args[0];
+  const options = ["HEAD", "GET", "DELETE"].includes(method) ? args[0] : args[1];
+  const controller = new AbortController();
+  const { signal } = controller;
+  const isFileListBody = body?.__proto__?.[Symbol.toStringTag] === "FileList";
+  const request = fetch(url, {
+    method,
+    ...body ? {
+      body: isFileListBody ? [...body].reduce((payload, file) => {
+        payload.append("file", file, `${file.webkitRelativePath || file.name}`);
+        return payload;
+      }, new FormData()) : typeof body === "object" ? JSON.stringify(body) : String(body)
+    } : null,
+    ...defaultOptions,
+    ...options,
+    headers: isFileListBody ? new Headers(options?.headers) : new Headers({ ...defaultOptions.headers, ...options?.headers }),
+    signal
+  }).then(async (res) => {
+    if (!res.ok) {
+      let error;
+      try {
+        error = await res.clone().json();
+      } catch (err) {
+        error = {
+          title: `${res.status === 401 ? "" : "Unknown Error: "}${res.statusText}`,
+          status: res.status,
+          detail: await res.clone().text() ?? String(err),
+          error: new Error(await res.clone().text() ?? String(err))
+        };
+      }
+      return Promise.reject({
+        ok: res.ok,
+        redirected: res.redirected,
+        status: res.status,
+        statusText: res.statusText,
+        type: res.type,
+        url: res.url,
+        headers: Object.fromEntries(res.headers.entries()),
+        error
+      });
+    }
+    return res.clone();
+  }).then(async (res) => {
+    const rawBody = await res.clone().text();
+    const headers = new SerializableHeaders(res.headers);
+    const response = {
+      body: res.body,
+      clone: res.clone,
+      bodyUsed: res.bodyUsed,
+      arrayBuffer: () => Promise.resolve(res.arrayBuffer()),
+      bytes: () => Promise.resolve(res.bytes()),
+      blob: () => Promise.resolve(res.blob()),
+      formData: () => Promise.resolve(res.formData()),
+      text: () => Promise.resolve(rawBody),
+      ok: res.ok,
+      redirected: res.redirected,
+      status: res.status,
+      statusText: res.statusText,
+      type: res.type,
+      url: res.url,
+      headers,
+      // Convenience methods that simply return the already-parsed data
+      json: async () => Promise.resolve(JSON.parse(rawBody)),
+      yaml: async () => Promise.resolve(load(rawBody))
+    };
+    return proxy(response);
+  });
+  return options?.controllable ? proxy({ request, controller }) : request;
+};
+var http = {
+  request: requestHandler,
+  head: (url, options) => requestHandler("HEAD", url, options),
+  get: (url, options) => requestHandler("GET", url, options),
+  post: (url, body, options) => requestHandler("POST", url, body, options),
+  put: (url, body, options) => requestHandler("PUT", url, body, options),
+  delete: (url, options) => requestHandler("DELETE", url, options),
+  patch: (url, body, options) => requestHandler("PATCH", url, body, options)
+};
+
+// src/worker.ts
+var self = globalThis;
+expose(http, self);
+var worker_default = null;
+export {
+  worker_default as default
+};
+//# sourceMappingURL=worker.js.map

package/dist/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/worker.ts","../src/core.ts"],"sourcesContent":["/// <reference lib=\"webworker\" />\n\nimport { expose } from 'comlink';\n\nimport { http } from './core';\n\nconst self: WorkerGlobalScope & typeof globalThis = globalThis as any;\n\nexpose(http, self);\n\nexport default null;\n","/// <reference lib=\"webworker\" />\n\nimport { proxy } from 'comlink';\nimport { load } from 'js-yaml';\n\ntype _Response = Response;\ntype _Error = Error;\n\n/**\n * A structured-clone-safe stand-in for the `Headers` API.\n *\n * `Headers` instances cannot cross a worker `postMessage` boundary, so responses\n * expose this instead. It mirrors the read side of `Headers` (`get`, `has`,\n * `entries`, `keys`, `values`, `forEach`) but every accessor returns a `Promise`\n * so it also works correctly when proxied across a worker via comlink.\n */\nclass SerializableHeaders {\n  private headers: Record<string, string>;\n\n  constructor(headers: Headers | Record<string, string>) {\n    if (headers instanceof Headers) {\n      this.headers = Object.fromEntries(\n        Array.from(headers.entries()).map(([key, value]) => [key.toLowerCase(), value])\n      );\n    } else {\n      this.headers = Object.fromEntries(\n        Object.entries(headers).map(([key, value]) => [key.toLowerCase(), value])\n      );\n    }\n  }\n\n  get(name: string): Promise<string | null> {\n    return Promise.resolve(this.headers[name.toLowerCase()] ?? null);\n  }\n\n  has(name: string): Promise<boolean> {\n    return Promise.resolve(name.toLowerCase() in this.headers);\n  }\n\n  entries(): Promise<IterableIterator<[string, string]>> {\n    return Promise.resolve(Object.entries(this.headers)[Symbol.iterator]());\n  }\n\n  keys(): Promise<IterableIterator<string>> {\n    return Promise.resolve(Object.keys(this.headers)[Symbol.iterator]());\n  }\n\n  values(): Promise<IterableIterator<string>> {\n    return Promise.resolve(Object.values(this.headers)[Symbol.iterator]());\n  }\n\n  forEach(callback: (value: string, key: string) => void): void {\n    Object.entries(this.headers).forEach(([key, value]) => callback(value, key));\n  }\n}\n\nexport namespace HTTP {\n  export type Method = 'HEAD' | 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';\n  export type Response<T> = Omit<_Response, 'json' | 'headers'> & {\n    json(): Promise<T>;\n    yaml(): Promise<T>;\n    headers: SerializableHeaders;\n  };\n  export type Operator = typeof http;\n  export type Options<Controllable extends boolean> = Omit<\n    RequestInit,\n    'headers' | 'body' | 'signal'\n  > & {\n    controllable?: Controllable;\n    headers?: HeadersInit;\n  };\n  export type Payload<Context, Controllable extends boolean> = Controllable extends true\n    ? Promise<{\n        request: Promise<HTTP.Response<Context>>;\n        controller: HTTP.Controller;\n      }>\n    : Promise<HTTP.Response<Context>>;\n  export type Exception = Pick<\n    _Response,\n    'ok' | 'redirected' | 'status' | 'statusText' | 'type' | 'url'\n  > & {\n    headers: Record<string, string>;\n    error: Error;\n  };\n  export type Error = {\n    title: string;\n    status: number;\n    detail: string;\n    error?: _Error;\n  };\n  export type Controller = AbortController;\n}\n\nconst defaultOptions: HTTP.Options<false> = {\n  credentials: 'same-origin',\n  cache: 'default',\n  headers: {\n    'Content-Type': 'application/json'\n  }\n};\n\nconst requestHandler: {\n  <Context, Controllable extends boolean, Method = Extract<HTTP.Method, 'HEAD' | 'GET' | 'DELETE'>>(\n    method: Method,\n    url: string,\n    ...args: [HTTP.Options<Controllable> | undefined]\n  ): HTTP.Payload<Context, Controllable>;\n  <\n    Context,\n    Payload,\n    Controllable extends boolean,\n    Method = Exclude<HTTP.Method, 'HEAD' | 'GET' | 'DELETE'>\n  >(\n    method: Method,\n    url: string,\n    ...args: [Payload, HTTP.Options<Controllable> | undefined]\n  ): HTTP.Payload<Context, Controllable>;\n} = <Context, Payload, Controllable extends boolean, Method = HTTP.Method>(\n  method: HTTP.Method,\n  url: string,\n  ...args: Method extends 'HEAD' | 'GET' | 'DELETE'\n    ? [HTTP.Options<Controllable> | undefined]\n    : [Payload, HTTP.Options<Controllable> | undefined]\n) => {\n  const body = (['HEAD', 'GET', 'DELETE'].includes(method) ? null : args[0]) as Payload;\n  const options = (\n    ['HEAD', 'GET', 'DELETE'].includes(method) ? args[0] : args[1]\n  ) as HTTP.Options<Controllable>;\n\n  const controller = new AbortController();\n  const { signal } = controller;\n  // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n  // @ts-ignore: FileList is not defined in the global scope\n  // ? NOTE: FileList JSDOM type cannot work with MSW request mocker, use workaround to do instance type check via prototype chain\n  // ? This is equal to `body instanceof FileList`\n  const isFileListBody = body?.__proto__?.[Symbol.toStringTag] === 'FileList';\n\n  const request = fetch(url, {\n    method,\n    ...(body\n      ? {\n          body: isFileListBody\n            ? [...(body as unknown as FileList)].reduce((payload, file) => {\n                payload.append('file', file, `${file.webkitRelativePath || file.name}`);\n                return payload;\n              }, new FormData())\n            : typeof body === 'object'\n              ? JSON.stringify(body)\n              : String(body)\n        }\n      : null),\n    ...defaultOptions,\n    ...options,\n    headers: isFileListBody\n      ? new Headers(options?.headers)\n      : new Headers({ ...defaultOptions.headers, ...options?.headers }),\n    signal\n  })\n    .then(async (res: Omit<HTTP.Response<Context>, 'yaml' | 'headers'> & { headers: Headers }) => {\n      if (!res.ok) {\n        let error: HTTP.Error;\n\n        try {\n          error = await res.clone().json();\n        } catch (err) {\n          error = {\n            title: `${res.status === 401 ? '' : 'Unknown Error: '}${res.statusText}`,\n            status: res.status,\n            detail: (await res.clone().text()) ?? String(err),\n            error: new Error((await res.clone().text()) ?? String(err))\n          };\n        }\n\n        return Promise.reject({\n          ok: res.ok,\n          redirected: res.redirected,\n          status: res.status,\n          statusText: res.statusText,\n          type: res.type,\n          url: res.url,\n          headers: Object.fromEntries(res.headers.entries()),\n          error\n        } satisfies HTTP.Exception);\n      }\n\n      return res.clone();\n    })\n    .then(async (res: _Response) => {\n      const rawBody = await res.clone().text();\n      // Create a serializable headers object for cross-worker transfer\n      const headers = new SerializableHeaders(res.headers);\n\n      // Return a plain object with response metadata and parsed data\n      // Include convenience methods for backward compatibility\n      // Use proxy() to ensure methods are callable across worker boundary\n      const response: HTTP.Response<Context> = {\n        body: res.body,\n        clone: res.clone,\n        bodyUsed: res.bodyUsed,\n        arrayBuffer: () => Promise.resolve(res.arrayBuffer()),\n        bytes: () => Promise.resolve(res.bytes()),\n        blob: () => Promise.resolve(res.blob()),\n        formData: () => Promise.resolve(res.formData()),\n        text: () => Promise.resolve(rawBody),\n        ok: res.ok,\n        redirected: res.redirected,\n        status: res.status,\n        statusText: res.statusText,\n        type: res.type,\n        url: res.url,\n        headers,\n        // Convenience methods that simply return the already-parsed data\n        json: async () => Promise.resolve(JSON.parse(rawBody) as Context),\n        yaml: async () => Promise.resolve(load(rawBody) as Context)\n      };\n\n      return proxy(response);\n    });\n\n  return options?.controllable\n    ? proxy({ request, controller } as unknown as HTTP.Payload<Context, true>) // Comlink will convert proxied to a Promise\n    : (request satisfies HTTP.Payload<Context, false>);\n};\n\n/**\n * The core HTTP operator: a thin, typed wrapper around native `fetch`.\n *\n * This module has no worker/comlink transport wiring of its own — it is safe to\n * import directly on the main thread, in Node/SSR, or inside a worker. The\n * worker transport built on top of this lives in `fetch-worker/worker` and the\n * environment-aware client lives in `fetch-worker` (the package root).\n */\nexport const http = {\n  request: requestHandler,\n  head: <Context, Controllable extends boolean = false>(\n    url: string,\n    options?: HTTP.Options<Controllable>\n  ) => requestHandler<Context, Controllable, 'HEAD'>('HEAD', url, options),\n  get: <Context, Controllable extends boolean = false>(\n    url: string,\n    options?: HTTP.Options<Controllable>\n  ) => requestHandler<Context, Controllable, 'GET'>('GET', url, options),\n  post: <Context, Payload, Controllable extends boolean = false>(\n    url: string,\n    body: Payload,\n    options?: HTTP.Options<Controllable>\n  ) => requestHandler<Context, Payload, Controllable, 'POST'>('POST', url, body, options),\n  put: <Context, Payload, Controllable extends boolean = false>(\n    url: string,\n    body: Payload,\n    options?: HTTP.Options<Controllable>\n  ) => requestHandler<Context, Payload, Controllable, 'PUT'>('PUT', url, body, options),\n  delete: <Controllable extends boolean = false>(\n    url: string,\n    options?: HTTP.Options<Controllable>\n  ) => requestHandler<void, Controllable, 'DELETE'>('DELETE', url, options),\n  patch: <Context, Payload, Controllable extends boolean = false>(\n    url: string,\n    body: Payload,\n    options?: HTTP.Options<Controllable>\n  ) => requestHandler<Context, Payload, Controllable, 'PATCH'>('PATCH', url, body, options)\n};\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@aries0d0f/fetch-worker",
+  "version": "0.1.1",
+  "description": "Native fetch, offloaded to a Web Worker — a tiny, dependency-light HTTP client with a comlink-powered worker transport and automatic main-thread fallback.",
+  "keywords": [
+    "fetch",
+    "http",
+    "web-worker",
+    "worker",
+    "comlink",
+    "http-client"
+  ],
+  "license": "MIT",
+  "author": "aries0d0f",
+  "homepage": "https://github.com/aries0d0f/fetch-worker#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aries0d0f/fetch-worker.git"
+  },
+  "bugs": {
+    "url": "https://github.com/aries0d0f/fetch-worker/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "import": "./dist/core.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "bun@1.3.14",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "typecheck": "tsc --noEmit",
+    "changeset": "changeset",
+    "release": "bun run build && changeset publish",
+    "prepublishOnly": "bun run build"
+  },
+  "dependencies": {
+    "comlink": "^4.4.2",
+    "js-yaml": "^4.1.0"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.29.7",
+    "@eslint/js": "^9.38.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^24.10.1",
+    "@vitest/coverage-v8": "^5.0.0",
+    "eslint": "^9.38.0",
+    "eslint-config-prettier": "^10.1.8",
+    "msw": "^2.11.6",
+    "prettier": "^3.6.2",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.46.4",
+    "vitest": "^5.0.0"
+  }
+}