make-service 3.1.0 → 4.0.1

package/README.md

@@ -6,7 +6,7 @@
 
 A type-safe thin wrapper around the `fetch` API to better interact with external APIs.
 
-It adds a set of little features and allows you to parse responses with [zod](https://github.com/colinhacks/zod).
+It adds a set of little features and allows you to parse responses with [standard-schema libraries](https://standardschema.dev).
 
 ## Features
 - 🤩 Type-safe return of `response.json()` and `response.text()`. Defaults to `unknown` instead of `any`.
@@ -37,6 +37,7 @@ const users = await response.json(usersSchema);
   - [makeService](#makeservice)
     - [Type-checking the response body](#type-checking-the-response-body)
     - [Runtime type-checking and parsing the response body](#runtime-type-checking-and-parsing-the-response-body)
+      - [Dealing with parsing errors](#dealing-with-parsing-errors)
     - [Supported HTTP Verbs](#supported-http-verbs)
     - [Headers](#headers)
       - [Passing a function as `headers`](#passing-a-function-as-headers)
@@ -52,13 +53,14 @@ const users = await response.json(usersSchema);
   - [makeFetcher](#makefetcher)
   - [enhancedFetch](#enhancedfetch)
   - [typedResponse](#typedresponse)
-- [Transform the Payload](#transform-the-payload)
+- [Transform the payload](#transform-the-payload)
 - [Other available primitives](#other-available-primitives)
   - [addQueryToURL](#addquerytourl)
   - [ensureStringBody](#ensurestringbody)
   - [makeGetApiURL](#makegetapiurl)
   - [mergeHeaders](#mergeheaders)
   - [replaceURLParams](#replaceurlparams)
+- [Contributors](#contributors)
 - [Acknowledgements](#acknowledgements)
 
 # Installation
@@ -119,8 +121,8 @@ const content = await response.text<`${string}@${string}`>()
 ```
 
 ### Runtime type-checking and parsing the response body
-Its [`typedResponse`](#typedresponse) can also be parsed with a zod schema. Here follows a little more complex example:
 
+Its [`typedResponse`](#typedresponse) can also be parsed with a standard schema parser. Here follows a little more complex example with Zod:
 ```ts
 const response = await service.get("/users")
 const json = await response.json(
@@ -142,6 +144,20 @@ const content = await response.text(z.string().email())
 ```
 You can transform any `Response` in a `TypedResponse` like that by using the [`typedResponse`](#typedresponse) function.
 
+#### Dealing with parsing errors
+If the response body does not match the given schema, it will throw a **ParseResponseError** which will have a message carrying all the parsing issues and its messages. You can catch it to inspect the issues:
+
+```ts
+try {
+  const response = await service.get("/users")
+  return await response.json(userSchema)
+} catch(error) {
+  if (error instanceof ParseResponseError) {
+    console.log(error.issues)
+  }
+}
+```
+
 ### Supported HTTP Verbs
 Other than the `get` it also accepts more HTTP verbs:
 ```ts
@@ -210,8 +226,8 @@ Note: Don't forget headers are case insensitive.
 const headers = new Headers({ 'Content-Type': 'application/json' })
 Object.fromEntries(headers) // equals to: { 'content-type': 'application/json' }
 ```
-All the features above are done by using the [`mergeHeaders`](#mergeheaders) function internally.
 
+All the features above are done by using the [`mergeHeaders`](#mergeheaders) function internally.
 
 ### Base URL
 The service function can receive a `string` or `URL` as base `url` and it will be able to merge them correctly with the given path:
@@ -231,16 +247,28 @@ You can use the [`makeGetApiUrl`](#makegetapiurl) method to do that kind of URL
 `makeService` can also receive `requestTransformer` and `responseTransformer` as options that will be applied to all requests.
 
 #### Request transformers
-You can transform the request in any way you want, like:
+You can transform the request in any way you want passing a transformer function as a parameter. This will be applied to all requests for that service.
+A useful example is to implement a global request timeout for all endpoints of a service:
 
 ```ts
-const service = makeService('https://example.com/api', {
-  requestTransformer: (request) => ({ ...request, query: { admin: 'true' } }),
-})
+function timeoutRequestIn30Seconds(
+  request: EnhancedRequestInit<string>,
+): EnhancedRequestInit<string> {
+  const terminator = new AbortController()
+  terminator.signal.throwIfAborted()
+  setTimeout(() => terminator.abort(), 30000)
+
+  return {
+    ...request,
+    signal: terminator.signal,
+  }
+}
+
+const service = makeService('https://example.com/api', { requestTransformer: timeoutRequestIn30Seconds })
 
 const response = await service.get("/users")
 
-// It will call "https://example.com/api/users?admin=true"
+// It will call "https://example.com/api/users" aborting (and throwing an exception) if it takes more than 30 seconds.
 ```
 
 Please note that the `headers` option will be applied _after_ the request transformer runs. If you're using a request transformer, we recommend adding custom headers inside your transformer instead of using both options.
@@ -415,7 +443,7 @@ The `trace` function can also return a `Promise<void>` in order to send traces t
 
 ## typedResponse
 
-A type-safe wrapper around the `Response` object. It adds a `json` and `text` method that will parse the response with a given zod schema. If you don't provide a schema, it will return `unknown` instead of `any`, then you can also give it a generic to type cast the result.
+A type-safe wrapper around the `Response` object. It adds a `json` and `text` method that will parse the response with a given standard schema library. If you don't provide a schema, it will return `unknown` instead of `any`, then you can also give it a generic to type cast the result.
 
 ```ts
 import { typedResponse } from 'make-service'
@@ -449,11 +477,11 @@ import { deepCamelKeys, deepKebabKeys } from 'string-ts'
 
 const service = makeService("https://example.com/api")
 const response = service.get("/users")
-const users = await response.json(
+const json = await response.json(
   z
     .array(z.object({ "first-name": z.string(), contact: z.object({ "home-address": z.string() }) }))
-    .transform(deepCamelKeys)
 )
+const users = deepCamelKeys(json)
 console.log(users)
 //          ^? { firstName: string, contact: { homeAddress: string } }[]
 
@@ -468,7 +496,7 @@ This little library has plenty of other useful functions that you can use to bui
 ## addQueryToURL
 It receives a URL instance or URL string and an object-like query and returns a new URL with the query appended to it.
 
-It will preserve the original query if it exists and will also preserve the type of the given URL.
+It will preserve the original query if it exists and will also preserve the type of the given URL. When a `URL` object is provided, the original instance is left untouched and a new one is returned.
 
 ```ts
 import { addQueryToURL } from 'make-service'
@@ -482,17 +510,17 @@ addQueryToURL(
 )
 // https://example.com/api/users?role=admin&page=2
 
-addQueryToURL(
-  new URL("https://example.com/api/users"),
-  { page: "2" },
-)
+const url = new URL("https://example.com/api/users")
+addQueryToURL(url, { page: "2" })
 // https://example.com/api/users?page=2
+url.toString()
+// 'https://example.com/api/users'
 
-addQueryToURL(
-  new URL("https://example.com/api/users?role=admin"),
-  { page: "2" },
-)
+const urlWithRole = new URL("https://example.com/api/users?role=admin")
+addQueryToURL(urlWithRole, { page: "2" })
 // https://example.com/api/users?role=admin&page=2
+urlWithRole.toString()
+// 'https://example.com/api/users?role=admin'
 ```
 
 ## ensureStringBody
@@ -592,9 +620,9 @@ The params will be **strongly-typed** which means they will be validated against
   <tbody>
     <tr>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/gustavoguichard"><img src="https://avatars.githubusercontent.com/u/566971?v=4?s=100" width="100px;" alt="Guga Guichard"/><br /><sub><b>Guga Guichard</b></sub></a><br /><a href="#code-gustavoguichard" title="Code">💻</a> <a href="#projectManagement-gustavoguichard" title="Project Management">📆</a> <a href="#promotion-gustavoguichard" title="Promotion">📣</a> <a href="#maintenance-gustavoguichard" title="Maintenance">🚧</a> <a href="#doc-gustavoguichard" title="Documentation">📖</a> <a href="#bug-gustavoguichard" title="Bug reports">🐛</a> <a href="#infra-gustavoguichard" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a> <a href="#question-gustavoguichard" title="Answering Questions">💬</a> <a href="#research-gustavoguichard" title="Research">🔬</a> <a href="#review-gustavoguichard" title="Reviewed Pull Requests">👀</a> <a href="#ideas-gustavoguichard" title="Ideas, Planning, & Feedback">🤔</a> <a href="#example-gustavoguichard" title="Examples">💡</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://www.linkedin.com/in/danielweinmann"><img src="https://avatars.githubusercontent.com/u/204765?v=4?s=100" width="100px;" alt="Daniel Weinmann"/><br /><sub><b>Daniel Weinmann</b></sub></a><br /><a href="#code-danielweinmann" title="Code">💻</a> <a href="#promotion-danielweinmann" title="Promotion">📣</a> <a href="#ideas-danielweinmann" title="Ideas, Planning, & Feedback">🤔</a> <a href="#doc-danielweinmann" title="Documentation">📖</a> <a href="#bug-danielweinmann" title="Bug reports">🐛</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://www.linkedin.com/in/danielweinmann"><img src="https://avatars.githubusercontent.com/u/204765?v=4?s=100" width="100px;" alt="Daniel Weinmann"/><br /><sub><b>Daniel Weinmann</b></sub></a><br /><a href="#code-danielweinmann" title="Code">💻</a> <a href="#promotion-danielweinmann" title="Promotion">📣</a> <a href="#ideas-danielweinmann" title="Ideas, Planning, & Feedback">🤔</a> <a href="#doc-danielweinmann" title="Documentation">📖</a> <a href="#bug-danielweinmann" title="Bug reports">🐛</a> <a href="#review-danielweinmann" title="Reviewed Pull Requests">👀</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://luca.md"><img src="https://avatars.githubusercontent.com/u/1881266?v=4?s=100" width="100px;" alt="Andrei Luca"/><br /><sub><b>Andrei Luca</b></sub></a><br /><a href="#doc-iamandrewluca" title="Documentation">📖</a> <a href="#code-iamandrewluca" title="Code">💻</a> <a href="#promotion-iamandrewluca" title="Promotion">📣</a> <a href="#maintenance-iamandrewluca" title="Maintenance">🚧</a> <a href="#bug-iamandrewluca" title="Bug reports">🐛</a> <a href="#ideas-iamandrewluca" title="Ideas, Planning, & Feedback">🤔</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://github.com/diogob"><img src="https://avatars.githubusercontent.com/u/20662?v=4?s=100" width="100px;" alt="Diogo Biazus"/><br /><sub><b>Diogo Biazus</b></sub></a><br /><a href="#code-diogob" title="Code">💻</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/diogob"><img src="https://avatars.githubusercontent.com/u/20662?v=4?s=100" width="100px;" alt="Diogo Biazus"/><br /><sub><b>Diogo Biazus</b></sub></a><br /><a href="#code-diogob" title="Code">💻</a> <a href="#doc-diogob" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/garusis"><img src="https://avatars.githubusercontent.com/u/15615652?v=4?s=100" width="100px;" alt="Marcos Javier Alvarez Maestre"/><br /><sub><b>Marcos Javier Alvarez Maestre</b></sub></a><br /><a href="#code-garusis" title="Code">💻</a> <a href="#bug-garusis" title="Bug reports">🐛</a></td>
     </tr>
   </tbody>

package/dist/index.d.mts

@@ -1,8 +1,7 @@
+import { StandardSchemaV1 } from '@standard-schema/spec';
+
 declare const HTTP_METHODS: readonly ["GET", "POST", "PUT", "DELETE", "PATCH", "OPTIONS", "HEAD", "CONNECT"];
 
-type Schema<T> = {
-    parse: (d: unknown) => T;
-};
 type JSONValue = string | number | boolean | Date | {
     [x: string]: JSONValue | undefined | null;
 } | Array<JSONValue | undefined | null>;
@@ -11,7 +10,7 @@ type TypedResponse = Omit<Response, 'json' | 'text'> & {
     json: TypedResponseJson;
     text: TypedResponseText;
 };
-type PathParams<T> = T extends string ? ExtractPathParams<T> extends Record<string, unknown> ? ExtractPathParams<T> : Record<string, string> : Record<string, string>;
+type PathParams<T> = T extends string ? ExtractPathParams<T> extends Record<string, unknown> ? ExtractPathParams<T> : Record<string, string | number> : Record<string, string | number>;
 type EnhancedRequestInit<T = string> = Omit<RequestInit, 'body' | 'method'> & {
     method?: HTTPMethod | Lowercase<HTTPMethod>;
     body?: JSONValue | BodyInit | null;
@@ -28,17 +27,17 @@ type BaseOptions = {
     responseTransformer?: ResponseTransformer;
 };
 type HTTPMethod = (typeof HTTP_METHODS)[number];
-type TypedResponseJson = <T = unknown>(schema?: Schema<T>) => Promise<T>;
-type TypedResponseText = <T extends string = string>(schema?: Schema<T>) => Promise<T>;
+type TypedResponseJson = <Input = unknown, Output = Input>(schema?: StandardSchemaV1<Input, Output>) => Promise<Output>;
+type TypedResponseText = <Input extends string = string, Output = Input>(schema?: StandardSchemaV1<Input, Output>) => Promise<Output>;
 type GetJson = (response: Response) => TypedResponseJson;
 type GetText = (response: Response) => TypedResponseText;
 type Prettify<T> = {
     [K in keyof T]: T[K];
 } & {};
 type ExtractPathParams<T extends string> = T extends `${infer _}:${infer Param}/${infer Rest}` ? Prettify<Omit<{
-    [K in Param]: string;
+    [K in Param]: string | number;
 } & ExtractPathParams<Rest>, ''>> : T extends `${infer _}:${infer Param}` ? {
-    [K in Param]: string;
+    [K in Param]: string | number;
 } : {};
 
 /**
@@ -140,5 +139,12 @@ declare function replaceURLParams<T extends string | URL>(url: T, params: PathPa
  * @returns the type of the value
  */
 declare function typeOf(t: unknown): "array" | "arraybuffer" | "bigint" | "blob" | "boolean" | "formdata" | "function" | "null" | "number" | "object" | "readablestream" | "string" | "symbol" | "undefined" | "url" | "urlsearchparams";
+/**
+ * Error thrown when the response cannot be parsed.
+ */
+declare class ParseResponseError extends Error {
+    issues: readonly StandardSchemaV1.Issue[];
+    constructor(message: string, issues: readonly StandardSchemaV1.Issue[]);
+}
 
-export { type BaseOptions, type EnhancedRequestInit, type GetJson, type GetText, type HTTPMethod, type JSONValue, type PathParams, type RequestTransformer, type ResponseTransformer, type Schema, type SearchParams, type ServiceRequestInit, type TypedResponse, type TypedResponseJson, type TypedResponseText, addQueryToURL, enhancedFetch, ensureStringBody, makeFetcher, makeGetApiURL, makeService, mergeHeaders, replaceURLParams, typeOf, typedResponse };
+export { type BaseOptions, type EnhancedRequestInit, type GetJson, type GetText, type HTTPMethod, type JSONValue, ParseResponseError, type PathParams, type RequestTransformer, type ResponseTransformer, type SearchParams, type ServiceRequestInit, type TypedResponse, type TypedResponseJson, type TypedResponseText, addQueryToURL, enhancedFetch, ensureStringBody, makeFetcher, makeGetApiURL, makeService, mergeHeaders, replaceURLParams, typeOf, typedResponse };

package/dist/index.d.ts

@@ -1,8 +1,7 @@
+import { StandardSchemaV1 } from '@standard-schema/spec';
+
 declare const HTTP_METHODS: readonly ["GET", "POST", "PUT", "DELETE", "PATCH", "OPTIONS", "HEAD", "CONNECT"];
 
-type Schema<T> = {
-    parse: (d: unknown) => T;
-};
 type JSONValue = string | number | boolean | Date | {
     [x: string]: JSONValue | undefined | null;
 } | Array<JSONValue | undefined | null>;
@@ -11,7 +10,7 @@ type TypedResponse = Omit<Response, 'json' | 'text'> & {
     json: TypedResponseJson;
     text: TypedResponseText;
 };
-type PathParams<T> = T extends string ? ExtractPathParams<T> extends Record<string, unknown> ? ExtractPathParams<T> : Record<string, string> : Record<string, string>;
+type PathParams<T> = T extends string ? ExtractPathParams<T> extends Record<string, unknown> ? ExtractPathParams<T> : Record<string, string | number> : Record<string, string | number>;
 type EnhancedRequestInit<T = string> = Omit<RequestInit, 'body' | 'method'> & {
     method?: HTTPMethod | Lowercase<HTTPMethod>;
     body?: JSONValue | BodyInit | null;
@@ -28,17 +27,17 @@ type BaseOptions = {
     responseTransformer?: ResponseTransformer;
 };
 type HTTPMethod = (typeof HTTP_METHODS)[number];
-type TypedResponseJson = <T = unknown>(schema?: Schema<T>) => Promise<T>;
-type TypedResponseText = <T extends string = string>(schema?: Schema<T>) => Promise<T>;
+type TypedResponseJson = <Input = unknown, Output = Input>(schema?: StandardSchemaV1<Input, Output>) => Promise<Output>;
+type TypedResponseText = <Input extends string = string, Output = Input>(schema?: StandardSchemaV1<Input, Output>) => Promise<Output>;
 type GetJson = (response: Response) => TypedResponseJson;
 type GetText = (response: Response) => TypedResponseText;
 type Prettify<T> = {
     [K in keyof T]: T[K];
 } & {};
 type ExtractPathParams<T extends string> = T extends `${infer _}:${infer Param}/${infer Rest}` ? Prettify<Omit<{
-    [K in Param]: string;
+    [K in Param]: string | number;
 } & ExtractPathParams<Rest>, ''>> : T extends `${infer _}:${infer Param}` ? {
-    [K in Param]: string;
+    [K in Param]: string | number;
 } : {};
 
 /**
@@ -140,5 +139,12 @@ declare function replaceURLParams<T extends string | URL>(url: T, params: PathPa
  * @returns the type of the value
  */
 declare function typeOf(t: unknown): "array" | "arraybuffer" | "bigint" | "blob" | "boolean" | "formdata" | "function" | "null" | "number" | "object" | "readablestream" | "string" | "symbol" | "undefined" | "url" | "urlsearchparams";
+/**
+ * Error thrown when the response cannot be parsed.
+ */
+declare class ParseResponseError extends Error {
+    issues: readonly StandardSchemaV1.Issue[];
+    constructor(message: string, issues: readonly StandardSchemaV1.Issue[]);
+}
 
-export { type BaseOptions, type EnhancedRequestInit, type GetJson, type GetText, type HTTPMethod, type JSONValue, type PathParams, type RequestTransformer, type ResponseTransformer, type Schema, type SearchParams, type ServiceRequestInit, type TypedResponse, type TypedResponseJson, type TypedResponseText, addQueryToURL, enhancedFetch, ensureStringBody, makeFetcher, makeGetApiURL, makeService, mergeHeaders, replaceURLParams, typeOf, typedResponse };
+export { type BaseOptions, type EnhancedRequestInit, type GetJson, type GetText, type HTTPMethod, type JSONValue, ParseResponseError, type PathParams, type RequestTransformer, type ResponseTransformer, type SearchParams, type ServiceRequestInit, type TypedResponse, type TypedResponseJson, type TypedResponseText, addQueryToURL, enhancedFetch, ensureStringBody, makeFetcher, makeGetApiURL, makeService, mergeHeaders, replaceURLParams, typeOf, typedResponse };

package/dist/index.js

@@ -18,8 +18,9 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
-var src_exports = {};
-__export(src_exports, {
+var index_exports = {};
+__export(index_exports, {
+  ParseResponseError: () => ParseResponseError,
   addQueryToURL: () => addQueryToURL,
   enhancedFetch: () => enhancedFetch,
   ensureStringBody: () => ensureStringBody,
@@ -31,7 +32,7 @@ __export(src_exports, {
   typeOf: () => typeOf,
   typedResponse: () => typedResponse
 });
-module.exports = __toCommonJS(src_exports);
+module.exports = __toCommonJS(index_exports);
 
 // src/constants.ts
 var HTTP_METHODS = [
@@ -46,16 +47,6 @@ var HTTP_METHODS = [
   // 'TRACE', it has no support in most browsers yet
 ];
 
-// src/internals.ts
-var getJson = (response) => async (schema) => {
-  const json = await response.json();
-  return schema ? schema.parse(json) : json;
-};
-var getText = (response) => async (schema) => {
-  const text = await response.text();
-  return schema ? schema.parse(text) : text;
-};
-
 // src/primitives.ts
 function addQueryToURL(url, searchParams) {
   if (!searchParams) return url;
@@ -64,9 +55,11 @@ function addQueryToURL(url, searchParams) {
     return `${url}${separator}${new URLSearchParams(searchParams)}`;
   }
   if (searchParams && url instanceof URL) {
+    const result = new URL(url.toString());
     for (const [key, value] of new URLSearchParams(searchParams).entries()) {
-      url.searchParams.set(key, value);
+      result.searchParams.set(key, value);
     }
+    return result;
   }
   return url;
 }
@@ -83,7 +76,7 @@ function makeGetApiURL(baseURL) {
   };
 }
 function mergeHeaders(...entries) {
-  const result = /* @__PURE__ */ new Map();
+  const result = new Headers();
   for (const entry of entries) {
     const headers = new Headers(entry);
     for (const [key, value] of headers.entries()) {
@@ -94,19 +87,53 @@ function mergeHeaders(...entries) {
       }
     }
   }
-  return new Headers(Array.from(result.entries()));
+  return result;
 }
 function replaceURLParams(url, params) {
   if (!params) return url;
   let urlString = String(url);
-  Object.entries(params).forEach(([key, value]) => {
+  for (const [key, value] of Object.entries(params)) {
     urlString = urlString.replace(new RegExp(`:${key}($|/)`), `${value}$1`);
-  });
+  }
   return url instanceof URL ? new URL(urlString) : urlString;
 }
 function typeOf(t) {
   return Object.prototype.toString.call(t).replace(/^\[object (.+)\]$/, "$1").toLowerCase();
 }
+var ParseResponseError = class extends Error {
+  constructor(message, issues) {
+    super(JSON.stringify({ message, issues }, null, 2));
+    this.issues = issues;
+    this.name = "ParseResponseError";
+    this.issues = issues;
+  }
+};
+
+// src/internals.ts
+var getJson = (response) => async (schema) => {
+  const json = await response.json();
+  if (!schema) return json;
+  const result = await schema["~standard"].validate(json);
+  if (result.issues) {
+    throw new ParseResponseError(
+      "Failed to parse response.json",
+      result.issues
+    );
+  }
+  return result.value;
+};
+var getText = (response) => async (schema) => {
+  const text = await response.text();
+  if (!schema) return text;
+  const result = await schema["~standard"].validate(text);
+  if (result.issues) {
+    throw new ParseResponseError(
+      "Failed to parse response.text",
+      result.issues
+    );
+  }
+  return result.value;
+};
 
 // src/api.ts
 var identity = (value) => value;
@@ -170,6 +197,7 @@ function makeService(baseURL, baseOptions) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ParseResponseError,
   addQueryToURL,
   enhancedFetch,
   ensureStringBody,

package/dist/index.mjs

@@ -11,16 +11,6 @@ var HTTP_METHODS = [
   // 'TRACE', it has no support in most browsers yet
 ];
 
-// src/internals.ts
-var getJson = (response) => async (schema) => {
-  const json = await response.json();
-  return schema ? schema.parse(json) : json;
-};
-var getText = (response) => async (schema) => {
-  const text = await response.text();
-  return schema ? schema.parse(text) : text;
-};
-
 // src/primitives.ts
 function addQueryToURL(url, searchParams) {
   if (!searchParams) return url;
@@ -29,9 +19,11 @@ function addQueryToURL(url, searchParams) {
     return `${url}${separator}${new URLSearchParams(searchParams)}`;
   }
   if (searchParams && url instanceof URL) {
+    const result = new URL(url.toString());
     for (const [key, value] of new URLSearchParams(searchParams).entries()) {
-      url.searchParams.set(key, value);
+      result.searchParams.set(key, value);
     }
+    return result;
   }
   return url;
 }
@@ -48,7 +40,7 @@ function makeGetApiURL(baseURL) {
   };
 }
 function mergeHeaders(...entries) {
-  const result = /* @__PURE__ */ new Map();
+  const result = new Headers();
   for (const entry of entries) {
     const headers = new Headers(entry);
     for (const [key, value] of headers.entries()) {
@@ -59,19 +51,53 @@ function mergeHeaders(...entries) {
       }
     }
   }
-  return new Headers(Array.from(result.entries()));
+  return result;
 }
 function replaceURLParams(url, params) {
   if (!params) return url;
   let urlString = String(url);
-  Object.entries(params).forEach(([key, value]) => {
+  for (const [key, value] of Object.entries(params)) {
     urlString = urlString.replace(new RegExp(`:${key}($|/)`), `${value}$1`);
-  });
+  }
   return url instanceof URL ? new URL(urlString) : urlString;
 }
 function typeOf(t) {
   return Object.prototype.toString.call(t).replace(/^\[object (.+)\]$/, "$1").toLowerCase();
 }
+var ParseResponseError = class extends Error {
+  constructor(message, issues) {
+    super(JSON.stringify({ message, issues }, null, 2));
+    this.issues = issues;
+    this.name = "ParseResponseError";
+    this.issues = issues;
+  }
+};
+
+// src/internals.ts
+var getJson = (response) => async (schema) => {
+  const json = await response.json();
+  if (!schema) return json;
+  const result = await schema["~standard"].validate(json);
+  if (result.issues) {
+    throw new ParseResponseError(
+      "Failed to parse response.json",
+      result.issues
+    );
+  }
+  return result.value;
+};
+var getText = (response) => async (schema) => {
+  const text = await response.text();
+  if (!schema) return text;
+  const result = await schema["~standard"].validate(text);
+  if (result.issues) {
+    throw new ParseResponseError(
+      "Failed to parse response.text",
+      result.issues
+    );
+  }
+  return result.value;
+};
 
 // src/api.ts
 var identity = (value) => value;
@@ -134,6 +160,7 @@ function makeService(baseURL, baseOptions) {
   return service;
 }
 export {
+  ParseResponseError,
   addQueryToURL,
   enhancedFetch,
   ensureStringBody,

package/package.json

@@ -1,31 +1,47 @@
 {
   "name": "make-service",
-  "version": "3.1.0",
+  "version": "4.0.1",
   "description": "Some utilities to extend the 'fetch' API to better interact with external APIs.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "keywords": [
+    "fetch",
+    "api",
+    "wrapper",
+    "service",
+    "typescript"
+  ],
   "author": "Gustavo Guichard <@gugaguichard>",
   "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
   "scripts": {
     "build": "tsup ./src/index.ts --format esm,cjs --dts",
     "dev": "tsup ./src/index.ts --format esm,cjs --watch --dts",
-    "lint": "eslint --config eslint.config.mjs .",
+    "lint": "node_modules/.bin/biome check --write --error-on-warnings",
     "tsc": "tsc --noEmit",
     "test": "vitest run"
   },
   "devDependencies": {
-    "@types/node": "^22.1.0",
-    "@typescript-eslint/eslint-plugin": "^8.0.0",
-    "@typescript-eslint/parser": "^8.0.0",
-    "eslint": "^9.8.0",
-    "jsdom": "^24.1.1",
-    "prettier": "latest",
-    "string-ts": "^2.2.0",
-    "tsup": "^8.2.4",
-    "typescript": "^5.5.4",
+    "@biomejs/biome": "^2.0.0",
+    "@standard-schema/spec": "^1.0.0",
+    "@types/node": "^24.0.3",
+    "arktype": "^2.1.20",
+    "jsdom": "^26.1.0",
+    "string-ts": "^2.2.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3",
     "vitest": "latest",
-    "zod": "latest"
+    "zod": "3.25.67"
   },
   "files": [
     "README.md",