@kosmojs/fetch 0.0.0

package/package.json

@@ -0,0 +1,30 @@
+{
+  "type": "module",
+  "name": "@kosmojs/fetch",
+  "version": "0.0.0",
+  "author": "Slee Woo",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "pkg/*"
+  ],
+  "exports": {
+    ".": {
+      "types": "./pkg/src/index.d.ts",
+      "default": "./pkg/index.js"
+    }
+  },
+  "dependencies": {
+    "qs": "^6.14.0"
+  },
+  "devDependencies": {
+    "@types/qs": "^6.14.0",
+    "@kosmojs/config": "^0.0.0"
+  },
+  "scripts": {
+    "build": "esbuilder src/index.ts",
+    "test": "vitest --root ../../.. --project core/fetch"
+  }
+}

package/pkg/index.js

@@ -0,0 +1,125 @@
+// src/index.ts
+import qs from "qs";
+
+// src/defaults.ts
+var defaults_default = {
+  responseMode: "json",
+  get headers() {
+    return {
+      Accept: "application/json",
+      "Content-Type": "application/json"
+    };
+  },
+  stringify: (o) => new URLSearchParams(o).toString(),
+  errorHandler: console.error
+};
+
+// src/index.ts
+var bodylessMethods = ["GET", "DELETE"];
+var index_default = (base, opts) => {
+  const {
+    headers: _headers,
+    responseMode,
+    stringify: stringify2,
+    errorHandler,
+    ...fetchOpts
+    // Remaining options passed directly to fetch
+  } = {
+    ...defaults_default,
+    ...opts
+  };
+  const headers = new Headers({
+    ..._headers instanceof Headers ? Object.fromEntries(_headers.entries()) : _headers
+    // Use as-is if already a plain object
+  });
+  function wrapper(method) {
+    function _wrapper(path, data) {
+      const url = [
+        String(base),
+        ...Array.isArray(path) ? path : ["string", "number"].includes(typeof path) ? [path] : []
+        // No path provided
+      ].join("/");
+      const optedContentType = opts?.headers instanceof Headers ? opts.headers.get("Content-Type") : opts?.headers?.["Content-Type"];
+      if (responseMode !== defaults_default.responseMode && !optedContentType) {
+        const contentType = {
+          text: "text/plain",
+          blob: data instanceof Blob ? data.type : void 0,
+          formData: null,
+          // Let browser set multipart boundary
+          arrayBuffer: null,
+          // No content-type needed
+          raw: void 0
+          // Don't modify
+        }[responseMode];
+        if (contentType === null) {
+          headers.delete("Content-Type");
+        } else if (contentType) {
+          headers.set("Content-Type", contentType);
+        }
+      }
+      let searchParams = "";
+      let body = JSON.stringify({});
+      if (data instanceof Blob || data instanceof FormData || Object.prototype.toString.call(data) === "[object ArrayBuffer]") {
+        body = data;
+      } else if (typeof data === "string") {
+        if (bodylessMethods.includes(method)) {
+          searchParams = data;
+        } else {
+          body = data;
+        }
+      } else if (typeof data === "object") {
+        if (bodylessMethods.includes(method)) {
+          searchParams = stringify2(data);
+        } else {
+          body = JSON.stringify({ ...data });
+        }
+      }
+      const config = {
+        ...fetchOpts,
+        method,
+        headers,
+        // Only include body for non-bodyless methods
+        ...bodylessMethods.includes(method) ? {} : { body }
+      };
+      return fetch([url, searchParams].join("?"), config).then((response) => {
+        return Promise.all([
+          response,
+          responseMode === "raw" ? response : response[responseMode]().catch(() => null)
+          // Parse response body
+        ]);
+      }).then(([response, data2]) => {
+        if (response.ok) {
+          return data2;
+        }
+        const error = new Error(
+          data2?.error || response.statusText
+        );
+        error.response = response;
+        error.body = data2;
+        errorHandler?.(error);
+        throw error;
+      });
+    }
+    return _wrapper;
+  }
+  return {
+    GET: wrapper("GET"),
+    POST: wrapper("POST"),
+    PUT: wrapper("PUT"),
+    PATCH: wrapper("PATCH"),
+    DELETE: wrapper("DELETE")
+  };
+};
+var stringify = (data) => {
+  return qs.stringify(data, {
+    arrayFormat: "brackets",
+    indices: false,
+    encodeValuesOnly: true
+  });
+};
+export {
+  index_default as default,
+  defaults_default as defaults,
+  stringify
+};
+//# sourceMappingURL=index.js.map

package/pkg/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts", "../src/defaults.ts"],
+  "sourcesContent": ["import qs from \"qs\";\n\nimport defaults from \"./defaults\";\nimport type {\n  FetchMapper,\n  FetchMethod,\n  HTTPError,\n  HTTPMethod,\n  Options,\n} from \"./types\";\n\nexport { defaults };\n\nexport * from \"./types\";\n\n// Supported data types for request body\ntype Data = Record<string, unknown> | FormData | ArrayBuffer | Blob | string;\n\n// Path can be a string, number, or array of these\ntype PathEntry = string | number;\n\n// HTTP methods that typically don't include a request body\nconst bodylessMethods = [\"GET\", \"DELETE\"];\n\n// Main factory function that creates a configured fetch client instance\nexport default (base: string | URL, opts?: Options): FetchMapper => {\n  // Merge provided options with defaults, extracting specific properties\n  const {\n    headers: _headers,\n    responseMode,\n    stringify,\n    errorHandler,\n    ...fetchOpts // Remaining options passed directly to fetch\n  } = {\n    ...defaults,\n    ...opts,\n  };\n\n  // Normalize headers to Headers instance for consistent API\n  const headers = new Headers({\n    ...(_headers instanceof Headers\n      ? Object.fromEntries(_headers.entries()) // Convert Headers to plain object\n      : _headers), // Use as-is if already a plain object\n  });\n\n  // Factory function that creates HTTP method implementations\n  function wrapper(method: HTTPMethod): FetchMethod {\n    // Function overloads for TypeScript type checking\n    // No path, no data\n    function _wrapper<T>(): Promise<T>;\n    // Path without data\n    function _wrapper<T>(path: PathEntry | Array<PathEntry>): Promise<T>;\n    // Path with data\n    function _wrapper<T>(\n      path: PathEntry | Array<PathEntry>,\n      data: Data,\n    ): Promise<T>;\n\n    // Main implementation function\n    function _wrapper<T>(\n      path?: PathEntry | Array<PathEntry>,\n      data?: Data,\n    ): Promise<T> {\n      // Construct URL from base and path segments\n      const url = [\n        String(base),\n        ...(Array.isArray(path)\n          ? path // Use array as-is\n          : [\"string\", \"number\"].includes(typeof path)\n            ? [path] // Wrap single value in array\n            : []), // No path provided\n      ].join(\"/\");\n\n      // Check if content-type was explicitly set in options\n      const optedContentType =\n        opts?.headers instanceof Headers\n          ? opts.headers.get(\"Content-Type\")\n          : opts?.headers?.[\"Content-Type\"];\n\n      // Auto-set Content-Type header based on response mode if not explicitly set\n      if (responseMode !== defaults.responseMode && !optedContentType) {\n        const contentType = {\n          text: \"text/plain\",\n          blob: data instanceof Blob ? data.type : undefined,\n          formData: null, // Let browser set multipart boundary\n          arrayBuffer: null, // No content-type needed\n          raw: undefined, // Don't modify\n        }[responseMode];\n\n        if (contentType === null) {\n          headers.delete(\"Content-Type\");\n        } else if (contentType) {\n          headers.set(\"Content-Type\", contentType);\n        }\n      }\n\n      let searchParams = \"\";\n\n      // Default empty body\n      let body: string | FormData | ArrayBuffer | Blob = JSON.stringify({});\n\n      // Handle different data types for request body\n      if (\n        data instanceof Blob ||\n        data instanceof FormData ||\n        Object.prototype.toString.call(data) === \"[object ArrayBuffer]\"\n      ) {\n        // Use binary data as-is\n        body = data as typeof body;\n      } else if (typeof data === \"string\") {\n        if (bodylessMethods.includes(method)) {\n          // For GET/DELETE, add string data as query params\n          searchParams = data;\n        } else {\n          // For other methods, use as body\n          body = data;\n        }\n      } else if (typeof data === \"object\") {\n        if (bodylessMethods.includes(method)) {\n          // For GET/DELETE, serialize object to query string\n          searchParams = stringify(data as Record<string, string>);\n        } else {\n          // For other methods, serialize as JSON\n          body = JSON.stringify({ ...data });\n        }\n      }\n\n      // Prepare fetch configuration\n      const config: Options & { method: HTTPMethod; body?: typeof body } = {\n        ...fetchOpts,\n        method,\n        headers,\n        // Only include body for non-bodyless methods\n        ...(bodylessMethods.includes(method) ? {} : { body }),\n      };\n\n      // Execute fetch request and process response\n      return fetch([url, searchParams].join(\"?\"), config)\n        .then((response) => {\n          // Return both response and parsed data based on responseMode\n          return Promise.all([\n            response,\n            responseMode === \"raw\"\n              ? response // Return full response object\n              : response[responseMode]().catch(() => null), // Parse response body\n          ]);\n        })\n        .then(([response, data]) => {\n          if (response.ok) {\n            return data; // Return parsed data for successful responses\n          }\n          // Create enhanced error object for HTTP errors\n          const error = new Error(\n            data?.error || response.statusText,\n          ) as HTTPError;\n          error.response = response;\n          error.body = data;\n          errorHandler?.(error); // Call custom error handler if provided\n          throw error;\n        });\n    }\n\n    return _wrapper;\n  }\n\n  // Return object with HTTP method functions\n  return {\n    GET: wrapper(\"GET\"),\n    POST: wrapper(\"POST\"),\n    PUT: wrapper(\"PUT\"),\n    PATCH: wrapper(\"PATCH\"),\n    DELETE: wrapper(\"DELETE\"),\n  };\n};\n\nexport const stringify = (data: Record<string, unknown>) => {\n  return qs.stringify(data, {\n    arrayFormat: \"brackets\",\n    indices: false,\n    encodeValuesOnly: true,\n  });\n};\n", "export default {\n  responseMode: \"json\",\n  get headers() {\n    return {\n      Accept: \"application/json\",\n      \"Content-Type\": \"application/json\",\n    };\n  },\n  stringify: (o) => new URLSearchParams(o as never).toString(),\n  errorHandler: console.error,\n} satisfies import(\"./types\").Defaults;\n"],
+  "mappings": ";AAAA,OAAO,QAAQ;;;ACAf,IAAO,mBAAQ;AAAA,EACb,cAAc;AAAA,EACd,IAAI,UAAU;AACZ,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,gBAAgB;AAAA,IAClB;AAAA,EACF;AAAA,EACA,WAAW,CAAC,MAAM,IAAI,gBAAgB,CAAU,EAAE,SAAS;AAAA,EAC3D,cAAc,QAAQ;AACxB;;;ADYA,IAAM,kBAAkB,CAAC,OAAO,QAAQ;AAGxC,IAAO,gBAAQ,CAAC,MAAoB,SAAgC;AAElE,QAAM;AAAA,IACJ,SAAS;AAAA,IACT;AAAA,IACA,WAAAA;AAAA,IACA;AAAA,IACA,GAAG;AAAA;AAAA,EACL,IAAI;AAAA,IACF,GAAG;AAAA,IACH,GAAG;AAAA,EACL;AAGA,QAAM,UAAU,IAAI,QAAQ;AAAA,IAC1B,GAAI,oBAAoB,UACpB,OAAO,YAAY,SAAS,QAAQ,CAAC,IACrC;AAAA;AAAA,EACN,CAAC;AAGD,WAAS,QAAQ,QAAiC;AAahD,aAAS,SACP,MACA,MACY;AAEZ,YAAM,MAAM;AAAA,QACV,OAAO,IAAI;AAAA,QACX,GAAI,MAAM,QAAQ,IAAI,IAClB,OACA,CAAC,UAAU,QAAQ,EAAE,SAAS,OAAO,IAAI,IACvC,CAAC,IAAI,IACL,CAAC;AAAA;AAAA,MACT,EAAE,KAAK,GAAG;AAGV,YAAM,mBACJ,MAAM,mBAAmB,UACrB,KAAK,QAAQ,IAAI,cAAc,IAC/B,MAAM,UAAU,cAAc;AAGpC,UAAI,iBAAiB,iBAAS,gBAAgB,CAAC,kBAAkB;AAC/D,cAAM,cAAc;AAAA,UAClB,MAAM;AAAA,UACN,MAAM,gBAAgB,OAAO,KAAK,OAAO;AAAA,UACzC,UAAU;AAAA;AAAA,UACV,aAAa;AAAA;AAAA,UACb,KAAK;AAAA;AAAA,QACP,EAAE,YAAY;AAEd,YAAI,gBAAgB,MAAM;AACxB,kBAAQ,OAAO,cAAc;AAAA,QAC/B,WAAW,aAAa;AACtB,kBAAQ,IAAI,gBAAgB,WAAW;AAAA,QACzC;AAAA,MACF;AAEA,UAAI,eAAe;AAGnB,UAAI,OAA+C,KAAK,UAAU,CAAC,CAAC;AAGpE,UACE,gBAAgB,QAChB,gBAAgB,YAChB,OAAO,UAAU,SAAS,KAAK,IAAI,MAAM,wBACzC;AAEA,eAAO;AAAA,MACT,WAAW,OAAO,SAAS,UAAU;AACnC,YAAI,gBAAgB,SAAS,MAAM,GAAG;AAEpC,yBAAe;AAAA,QACjB,OAAO;AAEL,iBAAO;AAAA,QACT;AAAA,MACF,WAAW,OAAO,SAAS,UAAU;AACnC,YAAI,gBAAgB,SAAS,MAAM,GAAG;AAEpC,yBAAeA,WAAU,IAA8B;AAAA,QACzD,OAAO;AAEL,iBAAO,KAAK,UAAU,EAAE,GAAG,KAAK,CAAC;AAAA,QACnC;AAAA,MACF;AAGA,YAAM,SAA+D;AAAA,QACnE,GAAG;AAAA,QACH;AAAA,QACA;AAAA;AAAA,QAEA,GAAI,gBAAgB,SAAS,MAAM,IAAI,CAAC,IAAI,EAAE,KAAK;AAAA,MACrD;AAGA,aAAO,MAAM,CAAC,KAAK,YAAY,EAAE,KAAK,GAAG,GAAG,MAAM,EAC/C,KAAK,CAAC,aAAa;AAElB,eAAO,QAAQ,IAAI;AAAA,UACjB;AAAA,UACA,iBAAiB,QACb,WACA,SAAS,YAAY,EAAE,EAAE,MAAM,MAAM,IAAI;AAAA;AAAA,QAC/C,CAAC;AAAA,MACH,CAAC,EACA,KAAK,CAAC,CAAC,UAAUC,KAAI,MAAM;AAC1B,YAAI,SAAS,IAAI;AACf,iBAAOA;AAAA,QACT;AAEA,cAAM,QAAQ,IAAI;AAAA,UAChBA,OAAM,SAAS,SAAS;AAAA,QAC1B;AACA,cAAM,WAAW;AACjB,cAAM,OAAOA;AACb,uBAAe,KAAK;AACpB,cAAM;AAAA,MACR,CAAC;AAAA,IACL;AAEA,WAAO;AAAA,EACT;AAGA,SAAO;AAAA,IACL,KAAK,QAAQ,KAAK;AAAA,IAClB,MAAM,QAAQ,MAAM;AAAA,IACpB,KAAK,QAAQ,KAAK;AAAA,IAClB,OAAO,QAAQ,OAAO;AAAA,IACtB,QAAQ,QAAQ,QAAQ;AAAA,EAC1B;AACF;AAEO,IAAM,YAAY,CAAC,SAAkC;AAC1D,SAAO,GAAG,UAAU,MAAM;AAAA,IACxB,aAAa;AAAA,IACb,SAAS;AAAA,IACT,kBAAkB;AAAA,EACpB,CAAC;AACH;",
+  "names": ["stringify", "data"]
+}

package/pkg/src/defaults.d.ts

@@ -0,0 +1,13 @@
+declare const _default: {
+    responseMode: "json";
+    readonly headers: {
+        Accept: string;
+        "Content-Type": string;
+    };
+    stringify: (o: Record<string, unknown>) => string;
+    errorHandler: {
+        (...data: any[]): void;
+        (message?: any, ...optionalParams: any[]): void;
+    };
+};
+export default _default;

package/pkg/src/index.d.ts

@@ -0,0 +1,7 @@
+import defaults from "./defaults";
+import type { FetchMapper, Options } from "./types";
+export { defaults };
+export * from "./types";
+declare const _default: (base: string | URL, opts?: Options) => FetchMapper;
+export default _default;
+export declare const stringify: (data: Record<string, unknown>) => string;

package/pkg/src/types.d.ts

@@ -0,0 +1,15 @@
+export interface Defaults {
+    responseMode: ResponseMode;
+    headers: Record<string, string> | Headers;
+    stringify: (d: Record<string, unknown>) => string;
+    errorHandler: (e: unknown) => void;
+}
+export type HTTPMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+export type ResponseMode = "json" | "text" | "blob" | "formData" | "arrayBuffer" | "raw";
+export type Options = Partial<Defaults> & Pick<RequestInit, "cache" | "credentials" | "headers" | "integrity" | "keepalive" | "mode" | "redirect" | "referrer" | "referrerPolicy" | "signal" | "window">;
+export type FetchMethod = <T = unknown>(...a: Array<unknown>) => Promise<T>;
+export type FetchMapper = Record<HTTPMethod, FetchMethod>;
+export interface HTTPError<T extends object = object> extends Error {
+    body: T;
+    response: Response;
+}

package/pkg/test/fetch.test.d.ts

@@ -0,0 +1 @@
+export {};

package/pkg/test/mocks.d.ts

@@ -0,0 +1 @@
+export declare const server: import("msw/node").SetupServerApi;

package/pkg/test/setup.d.ts

@@ -0,0 +1 @@
+export {};