@zap-studio/fetch 0.4.3 → 0.4.5

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @zap-studio/fetch
 
+## 0.4.5
+
+### Patch Changes
+
+- Updated dependencies [f75b984]
+  - @zap-studio/validation@0.3.0
+
+## 0.4.4
+
+### Patch Changes
+
+- 59a8d71: Fix request body handling for JSON payloads.
+
+  - Accept JSON values (including arrays) in `ExtendedRequestInit.body`
+  - Auto-stringify plain JSON body values regardless of whether a response schema is provided
+  - Set `Content-Type: application/json` only when auto-stringifying and no explicit content type is set
+
 ## 0.4.3
 
 ### Patch Changes

package/dist/constants.d.mts

@@ -1,4 +1,4 @@
-import { a as FetchDefaults } from "./types-CznLOeef.mjs";
+import { FetchDefaults } from "./types.mjs";
 
 //#region src/constants.d.ts
 

package/dist/constants.mjs

@@ -1,3 +1,14 @@
-import { t as GLOBAL_DEFAULTS } from "./constants-CzfCghW-.mjs";
+//#region src/constants.ts
+/**
+* Default options for the global $fetch
+*/
+const GLOBAL_DEFAULTS = {
+	baseURL: "",
+	headers: void 0,
+	throwOnFetchError: true,
+	throwOnValidationError: true
+};
 
-export { GLOBAL_DEFAULTS };
+//#endregion
+export { GLOBAL_DEFAULTS };
+//# sourceMappingURL=constants.mjs.map

package/dist/constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.mjs","names":["GLOBAL_DEFAULTS: FetchDefaults"],"sources":["../src/constants.ts"],"sourcesContent":["import type { FetchDefaults } from \"./types\";\n\n/**\n * Default options for the global $fetch\n */\nexport const GLOBAL_DEFAULTS: FetchDefaults = {\n  baseURL: \"\",\n  headers: undefined,\n  throwOnFetchError: true,\n  throwOnValidationError: true,\n};\n"],"mappings":";;;;AAKA,MAAaA,kBAAiC;CAC5C,SAAS;CACT,SAAS;CACT,mBAAmB;CACnB,wBAAwB;CACzB"}

package/dist/{errors-rk_WqFKR.mjs → errors-DQfwnwmz.mjs}

@@ -15,4 +15,4 @@ var FetchError = class extends Error {
 
 //#endregion
 export { FetchError as t };
-//# sourceMappingURL=errors-rk_WqFKR.mjs.map
+//# sourceMappingURL=errors-DQfwnwmz.mjs.map

package/dist/{errors-rk_WqFKR.mjs.map → errors-DQfwnwmz.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"errors-rk_WqFKR.mjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * Error thrown for HTTP errors (non-2xx responses)\n */\nexport class FetchError extends Error {\n  status: Response[\"status\"];\n  response: Response;\n\n  constructor(message: string, response: Response) {\n    super(message);\n    this.name = \"FetchError\";\n    this.status = response.status;\n    this.response = response;\n  }\n}\n"],"mappings":";;;;AAGA,IAAa,aAAb,cAAgC,MAAM;CACpC;CACA;CAEA,YAAY,SAAiB,UAAoB;AAC/C,QAAM,QAAQ;AACd,OAAK,OAAO;AACZ,OAAK,SAAS,SAAS;AACvB,OAAK,WAAW"}
+{"version":3,"file":"errors-DQfwnwmz.mjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * Error thrown for HTTP errors (non-2xx responses)\n */\nexport class FetchError extends Error {\n  status: Response[\"status\"];\n  response: Response;\n\n  constructor(message: string, response: Response) {\n    super(message);\n    this.name = \"FetchError\";\n    this.status = response.status;\n    this.response = response;\n  }\n}\n"],"mappings":";;;;AAGA,IAAa,aAAb,cAAgC,MAAM;CACpC;CACA;CAEA,YAAY,SAAiB,UAAoB;AAC/C,QAAM,QAAQ;AACd,OAAK,OAAO;AACZ,OAAK,SAAS,SAAS;AACvB,OAAK,WAAW"}

package/dist/errors.mjs

@@ -1,3 +1,3 @@
-import { t as FetchError } from "./errors-rk_WqFKR.mjs";
+import { t as FetchError } from "./errors-DQfwnwmz.mjs";
 
 export { FetchError };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { i as ExtendedRequestInit, n as ApiMethods, r as CreateFetchOptions, t as $Fetch } from "./types-CznLOeef.mjs";
+import { $Fetch, ApiMethods, CreateFetchOptions, ExtendedRequestInit } from "./types.mjs";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/index.d.ts

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { t as GLOBAL_DEFAULTS } from "./constants-CzfCghW-.mjs";
-import { n as fetchInternal, t as createMethod } from "./utils-C1YvgnKM.mjs";
+import { GLOBAL_DEFAULTS } from "./constants.mjs";
+import { createMethod, fetchInternal } from "./utils.mjs";
 import { isStandardSchema } from "@zap-studio/validation";
 
 //#region src/index.ts

package/dist/types.d.mts

@@ -1,2 +1,140 @@
-import { a as FetchDefaults, i as ExtendedRequestInit, n as ApiMethods, o as SearchParams, r as CreateFetchOptions, t as $Fetch } from "./types-CznLOeef.mjs";
-export { $Fetch, ApiMethods, CreateFetchOptions, ExtendedRequestInit, FetchDefaults, SearchParams };
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/types.d.ts
+
+/**
+* Type representing various formats for search parameters
+* that can be used in requests.
+* Can be a URLSearchParams object, a record of string pairs,
+* a query string, or an array of tuples.
+*/
+type SearchParams = URLSearchParams | Record<string, string> | string | [string, string][];
+/**
+* JSON-serializable value used for request bodies.
+*/
+type JsonValue = string | number | boolean | null | JsonValue[] | {
+  [key: string]: JsonValue;
+};
+/**
+* Request body type accepted by the fetch wrapper.
+*/
+type RequestBody = BodyInit | JsonValue;
+/**
+* Base extended request options without throwOnValidationError
+*/
+type BaseExtendedRequestInit = Omit<RequestInit, "body"> & {
+  /**
+  * Request body - can be a BodyInit value or an object that will be JSON-stringified
+  */
+  body?: RequestBody;
+  /**
+  * Per-request query/search params
+  * @default undefined
+  */
+  searchParams?: SearchParams;
+  /**
+  * Whether to throw a FetchError on HTTP errors (non-2xx responses)
+  * @default true
+  */
+  throwOnFetchError?: boolean;
+};
+/**
+* Extended RequestInit type to include custom fetch options
+*/
+type ExtendedRequestInit<TThrowOnValidationError extends boolean | undefined = boolean | undefined> = BaseExtendedRequestInit & {
+  /**
+  * Whether to throw a ValidationError on validation errors
+  * @default true
+  */
+  throwOnValidationError?: TThrowOnValidationError;
+};
+/**
+* Internal defaults used by fetchInternal
+*/
+interface FetchDefaults {
+  /**
+  * Base URL to prepend to all requests
+  * @default ""
+  */
+  baseURL: string;
+  /**
+  * Default headers to include in all requests (can be overridden per request)
+  * @default undefined
+  */
+  headers?: HeadersInit;
+  /**
+  * Default query/search params applied to every request (can be overridden per request)
+  * @default undefined
+  */
+  searchParams?: SearchParams;
+  /**
+  * Whether to throw a `FetchError` on HTTP errors (non-2xx responses)
+  * @default true
+  */
+  throwOnFetchError: boolean;
+  /**
+  * Whether to throw a `ValidationError` on validation errors
+  * @default true
+  */
+  throwOnValidationError: boolean;
+}
+/**
+* Options for creating a custom fetch instance with `createFetch`
+*/
+type CreateFetchOptions = Partial<FetchDefaults>;
+/**
+* Type-safe fetch function with Standard Schema validation support
+*/
+interface $Fetch {
+  /**
+  * Fetch with schema validation and throwOnValidationError: false
+  * @param resource - URL or path to fetch
+  * @param schema - Standard Schema for response validation
+  * @param options - Extended request options with throwOnValidationError: false
+  * @returns Standard Schema Result object with value or issues
+  */
+  <TSchema extends StandardSchemaV1>(resource: string, schema: TSchema, options: ExtendedRequestInit<false>): Promise<StandardSchemaV1.Result<StandardSchemaV1.InferOutput<TSchema>>>;
+  /**
+  * Fetch with schema validation and throwOnValidationError: true or undefined (default)
+  * @param resource - URL or path to fetch
+  * @param schema - Standard Schema for response validation
+  * @param options - Extended request options
+  * @returns Validated data of type TSchema
+  */
+  <TSchema extends StandardSchemaV1>(resource: string, schema: TSchema, options?: ExtendedRequestInit<true | undefined>): Promise<StandardSchemaV1.InferOutput<TSchema>>;
+  /**
+  * Fetch without schema validation
+  * @param resource - URL or path to fetch
+  * @param options - Extended request options
+  * @returns Raw Response object
+  */
+  (resource: string, options?: ExtendedRequestInit): Promise<Response>;
+}
+/**
+* API HTTP method-specific fetch functions
+*/
+interface ApiMethods {
+  /**
+  * DELETE method fetch function
+  */
+  delete: $Fetch;
+  /**
+  * GET method fetch function
+  */
+  get: $Fetch;
+  /**
+  * PATCH method fetch function
+  */
+  patch: $Fetch;
+  /**
+  * POST method fetch function
+  */
+  post: $Fetch;
+  /**
+  * PUT method fetch function
+  */
+  put: $Fetch;
+}
+//#endregion
+export { $Fetch, ApiMethods, CreateFetchOptions, ExtendedRequestInit, FetchDefaults, JsonValue, RequestBody, SearchParams };
+//# sourceMappingURL=types.d.mts.map

package/dist/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;;AAQA;AASA;AAWA;AAAqC;AAKD,KAzBxB,YAAA,GACR,eAwBgC,GAvBhC,MAuBgC,CAAA,MAAA,EAAA,MAAA,CAAA,GAAA,MAAA,GAAA,CAAA,MAAA,EAAA,MAAA,CAAA,EAAA;;;;AASnB,KAzBL,SAAA,GAyBK,MAAA,GAAA,MAAA,GAAA,OAAA,GAAA,IAAA,GApBb,SAoBa,EAAA,GAAA;EAWjB,CAAA,GAAY,EAAA,MAAA,CAAA,EA9BS,SA8BT;AAaZ,CAAA;AA+BA;AAKA;;AAUY,KApFA,WAAA,GAAc,QAoFd,GApFyB,SAoFzB;;;;KA/EP,uBAAA,GAA0B,IAiFD,CAjFM,WAiFN,EAAA,MAAA,CAAA,GAAA;EAAzB;;;EAYS,IAAA,CAAA,EAzFL,WAyFK;EAC4B;;;;EAQmB,YAAA,CAAA,EA7F5C,YA6F4C;EAAR;;AAMrD;;EAQO,iBAAA,CAAA,EAAA,OAAA;CAIE;;;;KApGG,iGAER;;;;;2BAKuB;;;;;UAMV,aAAA;;;;;;;;;;YAUL;;;;;iBAKK;;;;;;;;;;;;;;;KAgBL,kBAAA,GAAqB,QAAQ;;;;UAKxB,MAAA;;;;;;;;mBAQE,4CAEP,kBACC,6BACR,QAAQ,gBAAA,CAAiB,OAAO,gBAAA,CAAiB,YAAY;;;;;;;;mBAS/C,4CAEP,mBACE,wCACT,QAAQ,gBAAA,CAAiB,YAAY;;;;;;;+BAQX,sBAAsB,QAAQ;;;;;UAM5C,UAAA;;;;UAIP;;;;OAIH;;;;SAIE;;;;QAID;;;;OAID"}

package/dist/utils.d.mts

@@ -1,4 +1,4 @@
-import { a as FetchDefaults, i as ExtendedRequestInit, t as $Fetch } from "./types-CznLOeef.mjs";
+import { $Fetch, ExtendedRequestInit, FetchDefaults } from "./types.mjs";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/utils.d.ts

package/dist/utils.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.mts","names":[],"sources":["../src/utils.ts"],"sourcesContent":[],"mappings":";;;;;;;AA0BA;;;;;AAyLA;;;;;;AAwEA;;;AAGG,iBApQa,YAAA,CAoQb,IAAA,EAnQK,WAmQL,GAAA,SAAA,EAAA,QAAA,EAlQS,WAkQT,GAAA,SAAA,CAAA,EAjQA,OAiQA,GAAA,SAAA;;;;iBA3EmB,aAAA,2BAEZ,uCACC,2CACC,gBACT;;;;iBAmEa,4BAA4B,iBACjC,yBAER"}
+{"version":3,"file":"utils.d.mts","names":[],"sources":["../src/utils.ts"],"sourcesContent":[],"mappings":";;;;;;;AA0BA;;;;;AAyLA;;;;;;AAiFA;;;AAGG,iBA7Qa,YAAA,CA6Qb,IAAA,EA5QK,WA4QL,GAAA,SAAA,EAAA,QAAA,EA3QS,WA2QT,GAAA,SAAA,CAAA,EA1QA,OA0QA,GAAA,SAAA;;;;iBApFmB,aAAA,2BAEZ,uCACC,2CACC,gBACT;;;;iBA4Ea,4BAA4B,iBACjC,yBAER"}

package/dist/utils.mjs

@@ -1,3 +1,180 @@
-import { n as fetchInternal, r as mergeHeaders, t as createMethod } from "./utils-C1YvgnKM.mjs";
+import { t as FetchError } from "./errors-DQfwnwmz.mjs";
+import { isStandardSchema, standardValidate } from "@zap-studio/validation";
 
-export { createMethod, fetchInternal, mergeHeaders };
+//#region src/utils.ts
+/**
+* Merges two HeadersInit objects, with the second one taking precedence
+*
+* @example
+* const baseHeaders = { "Authorization": "Bearer token", "Content-Type": "application/json" };
+* const overrideHeaders = { "Content-Type": "application/xml", "X-Custom-Header": "value" };
+*
+* const merged = mergeHeaders(baseHeaders, overrideHeaders);
+*
+* // Resulting headers:
+* // {
+* //   "Authorization": "Bearer token",
+* //   "Content-Type": "application/xml",
+* //   "X-Custom-Header": "value"
+* // }
+*/
+function mergeHeaders(base, override) {
+	if (!(base || override)) return;
+	const merged = new Headers(base);
+	if (override) {
+		const overrideHeaders = new Headers(override);
+		for (const [key, value] of overrideHeaders.entries()) merged.set(key, value);
+	}
+	return merged;
+}
+/**
+* Removes trailing slashes from a string
+*/
+function trimTrailingSlashes(str) {
+	let end = str.length;
+	while (end > 0 && str[end - 1] === "/") end -= 1;
+	return str.slice(0, end);
+}
+/**
+* Removes leading slashes from a string
+*/
+function trimLeadingSlashes(str) {
+	let start = 0;
+	while (start < str.length && str[start] === "/") start += 1;
+	return str.slice(start);
+}
+const ABSOLUTE_URL_PATTERN = /^(?:https?:)?\/\//i;
+/**
+* Checks if a URL is absolute (starts with http://, https://, or //)
+*/
+function isAbsoluteURL(url) {
+	return ABSOLUTE_URL_PATTERN.test(url);
+}
+/**
+* Normalizes search parameters into a URLSearchParams object.
+*/
+function normalizeSearchParams(input) {
+	if (input === void 0 || input === null) return new URLSearchParams();
+	if (input instanceof URLSearchParams) return new URLSearchParams(input);
+	if (typeof input === "string") return new URLSearchParams(input);
+	if (Array.isArray(input)) return new URLSearchParams(input);
+	const params = new URLSearchParams();
+	for (const [k, v] of Object.entries(input)) params.set(k, v);
+	return params;
+}
+/**
+* Parses a URL string into its path, query, and hash components.
+* Handles both absolute URLs (using URL constructor) and relative paths.
+*/
+function parseUrlComponents(url) {
+	if (isAbsoluteURL(url)) try {
+		const parsed = new URL(url);
+		const pathOnly = `${parsed.origin}${parsed.pathname}`;
+		const existingQuery = parsed.search.startsWith("?") ? parsed.search.slice(1) : parsed.search;
+		let hash$1 = parsed.hash;
+		if (hash$1 === "" && url.endsWith("#")) hash$1 = "#";
+		return {
+			pathOnly,
+			existingQuery,
+			hash: hash$1
+		};
+	} catch {}
+	let hash = "";
+	let urlWithoutHash = url;
+	const hashIndex = url.indexOf("#");
+	if (hashIndex !== -1) {
+		hash = url.slice(hashIndex);
+		urlWithoutHash = url.slice(0, hashIndex);
+	}
+	const queryIndex = urlWithoutHash.indexOf("?");
+	if (queryIndex === -1) return {
+		pathOnly: urlWithoutHash,
+		existingQuery: "",
+		hash
+	};
+	return {
+		pathOnly: urlWithoutHash.slice(0, queryIndex),
+		existingQuery: urlWithoutHash.slice(queryIndex + 1),
+		hash
+	};
+}
+/**
+* Builds a URL with merged search parameters from factory defaults,
+* request options, and existing query parameters.
+*
+* This function takes a base URL, factory search parameters,
+* and request search parameters, and combines them into a single URL.
+*
+* Priority (highest to lowest):
+* 1. Request search parameters (highest priority, overwrites all others)
+* 2. Existing query parameters from the URL (overwrites factory defaults)
+* 3. Factory search parameters (lowest priority, overwritten by all others)
+*
+* If no search parameters are provided, the URL will not have a query string.
+* Any trailing hash/fragment is preserved.
+*/
+function buildUrlWithMergedSearchParams(url, factorySearch, requestSearch) {
+	const { pathOnly, existingQuery, hash } = parseUrlComponents(url);
+	if (!(factorySearch ?? requestSearch ?? existingQuery)) return url;
+	const mergedParams = new URLSearchParams();
+	const resourceParams = new URLSearchParams(existingQuery);
+	const factoryParams = normalizeSearchParams(factorySearch);
+	const reqParams = normalizeSearchParams(requestSearch);
+	for (const [k, v] of factoryParams.entries()) mergedParams.set(k, v);
+	for (const [k, v] of resourceParams.entries()) mergedParams.set(k, v);
+	for (const [k, v] of reqParams.entries()) mergedParams.set(k, v);
+	const queryString = mergedParams.toString();
+	if (queryString) return `${pathOnly}?${queryString}${hash}`;
+	return `${pathOnly}${hash}`;
+}
+/**
+* Internal fetch implementation used by both $fetch and createFetch
+*/
+async function fetchInternal(resource, schema, options, defaults) {
+	const { throwOnValidationError = defaults.throwOnValidationError, throwOnFetchError = defaults.throwOnFetchError, headers: requestHeaders, searchParams: requestSearchParams, ...rest } = options || {};
+	const mergedHeaders = mergeHeaders(defaults.headers, requestHeaders);
+	const init = {
+		...rest,
+		headers: mergedHeaders
+	};
+	const isBodyInit = typeof init.body === "string" || init.body instanceof FormData || init.body instanceof URLSearchParams || init.body instanceof Blob || init.body instanceof ArrayBuffer || ArrayBuffer.isView(init.body) || init.body instanceof ReadableStream;
+	if (init.body != null && !isBodyInit) {
+		init.body = JSON.stringify(init.body);
+		const existingHeaders = new Headers(init.headers);
+		if (!existingHeaders.has("Content-Type")) existingHeaders.set("Content-Type", "application/json");
+		init.headers = existingHeaders;
+	}
+	let url;
+	if (isAbsoluteURL(resource)) url = resource;
+	else {
+		const base = trimTrailingSlashes(defaults.baseURL);
+		const path = trimLeadingSlashes(resource);
+		url = base ? `${base}/${path}` : resource;
+	}
+	url = buildUrlWithMergedSearchParams(url, defaults.searchParams, requestSearchParams);
+	const response = await fetch(url, init);
+	if (throwOnFetchError && !response.ok) throw new FetchError(`HTTP ${response.status}: ${response.statusText}`, response);
+	if (schema) {
+		const raw = await response.json();
+		if (throwOnValidationError) return standardValidate(schema, raw, { throwOnError: true });
+		return standardValidate(schema, raw, { throwOnError: false });
+	}
+	return response;
+}
+/**
+* Creates an HTTP method helper bound to a fetch function
+*/
+function createMethod(fetchFn, method) {
+	function methodFetch(resource, schemaOrOptions, optionsOrUndefined) {
+		const [schema, options] = isStandardSchema(schemaOrOptions) ? [schemaOrOptions, optionsOrUndefined] : [void 0, schemaOrOptions];
+		return fetchFn(resource, schema, {
+			...options,
+			method
+		});
+	}
+	return methodFetch;
+}
+
+//#endregion
+export { createMethod, fetchInternal, mergeHeaders };
+//# sourceMappingURL=utils.mjs.map

package/dist/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.mjs","names":["hash","url: string"],"sources":["../src/utils.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { isStandardSchema, standardValidate } from \"@zap-studio/validation\";\nimport { FetchError } from \"./errors\";\nimport type {\n  $Fetch,\n  ExtendedRequestInit,\n  FetchDefaults,\n  SearchParams,\n} from \"./types\";\n\n/**\n * Merges two HeadersInit objects, with the second one taking precedence\n *\n * @example\n * const baseHeaders = { \"Authorization\": \"Bearer token\", \"Content-Type\": \"application/json\" };\n * const overrideHeaders = { \"Content-Type\": \"application/xml\", \"X-Custom-Header\": \"value\" };\n *\n * const merged = mergeHeaders(baseHeaders, overrideHeaders);\n *\n * // Resulting headers:\n * // {\n * //   \"Authorization\": \"Bearer token\",\n * //   \"Content-Type\": \"application/xml\",\n * //   \"X-Custom-Header\": \"value\"\n * // }\n */\nexport function mergeHeaders(\n  base: HeadersInit | undefined,\n  override: HeadersInit | undefined\n): Headers | undefined {\n  if (!(base || override)) {\n    return;\n  }\n\n  const merged = new Headers(base);\n  if (override) {\n    const overrideHeaders = new Headers(override);\n    for (const [key, value] of overrideHeaders.entries()) {\n      merged.set(key, value);\n    }\n  }\n  return merged;\n}\n\n/**\n * Removes trailing slashes from a string\n */\nfunction trimTrailingSlashes(str: string): string {\n  let end = str.length;\n  while (end > 0 && str[end - 1] === \"/\") {\n    end -= 1;\n  }\n  return str.slice(0, end);\n}\n\n/**\n * Removes leading slashes from a string\n */\nfunction trimLeadingSlashes(str: string): string {\n  let start = 0;\n  while (start < str.length && str[start] === \"/\") {\n    start += 1;\n  }\n  return str.slice(start);\n}\n\nconst ABSOLUTE_URL_PATTERN = /^(?:https?:)?\\/\\//i;\n\n/**\n * Checks if a URL is absolute (starts with http://, https://, or //)\n */\nfunction isAbsoluteURL(url: string): boolean {\n  return ABSOLUTE_URL_PATTERN.test(url);\n}\n\n/**\n * Normalizes search parameters into a URLSearchParams object.\n */\nfunction normalizeSearchParams(\n  input: SearchParams | undefined\n): URLSearchParams {\n  if (input === undefined || input === null) {\n    return new URLSearchParams();\n  }\n\n  if (input instanceof URLSearchParams) {\n    return new URLSearchParams(input);\n  }\n\n  if (typeof input === \"string\") {\n    return new URLSearchParams(input);\n  }\n\n  if (Array.isArray(input)) {\n    return new URLSearchParams(input);\n  }\n\n  const params = new URLSearchParams();\n  for (const [k, v] of Object.entries(input)) {\n    params.set(k, v);\n  }\n\n  return params;\n}\n\n/**\n * Parses a URL string into its path, query, and hash components.\n * Handles both absolute URLs (using URL constructor) and relative paths.\n */\nfunction parseUrlComponents(url: string): {\n  pathOnly: string;\n  existingQuery: string;\n  hash: string;\n} {\n  // Try parsing as absolute URL first\n  if (isAbsoluteURL(url)) {\n    try {\n      const parsed = new URL(url);\n      const pathOnly = `${parsed.origin}${parsed.pathname}`;\n      // parsed.search includes the leading \"?\", so strip it\n      const existingQuery = parsed.search.startsWith(\"?\")\n        ? parsed.search.slice(1)\n        : parsed.search;\n      // URL constructor normalizes away empty hash, if original URL had # at end, preserve it\n      let hash = parsed.hash;\n      if (hash === \"\" && url.endsWith(\"#\")) {\n        hash = \"#\";\n      }\n      return { pathOnly, existingQuery, hash };\n    } catch {\n      // Fall through to manual parsing if URL constructor fails\n    }\n  }\n\n  // Manual parsing for relative URLs or if URL constructor failed\n  let hash = \"\";\n  let urlWithoutHash = url;\n  const hashIndex = url.indexOf(\"#\");\n  if (hashIndex !== -1) {\n    hash = url.slice(hashIndex);\n    urlWithoutHash = url.slice(0, hashIndex);\n  }\n\n  // Find the first \"?\" to split path and query\n  const queryIndex = urlWithoutHash.indexOf(\"?\");\n  if (queryIndex === -1) {\n    return { pathOnly: urlWithoutHash, existingQuery: \"\", hash };\n  }\n\n  const pathOnly = urlWithoutHash.slice(0, queryIndex);\n  const existingQuery = urlWithoutHash.slice(queryIndex + 1);\n  return { pathOnly, existingQuery, hash };\n}\n\n/**\n * Builds a URL with merged search parameters from factory defaults,\n * request options, and existing query parameters.\n *\n * This function takes a base URL, factory search parameters,\n * and request search parameters, and combines them into a single URL.\n *\n * Priority (highest to lowest):\n * 1. Request search parameters (highest priority, overwrites all others)\n * 2. Existing query parameters from the URL (overwrites factory defaults)\n * 3. Factory search parameters (lowest priority, overwritten by all others)\n *\n * If no search parameters are provided, the URL will not have a query string.\n * Any trailing hash/fragment is preserved.\n */\nfunction buildUrlWithMergedSearchParams(\n  url: string,\n  factorySearch: FetchDefaults[\"searchParams\"] | undefined,\n  requestSearch: ExtendedRequestInit[\"searchParams\"] | undefined\n): string {\n  const { pathOnly, existingQuery, hash } = parseUrlComponents(url);\n\n  // Early return if no search params to merge\n  const hasSearchParams = factorySearch ?? requestSearch ?? existingQuery;\n  if (!hasSearchParams) {\n    return url;\n  }\n\n  const mergedParams = new URLSearchParams();\n\n  const resourceParams = new URLSearchParams(existingQuery);\n  const factoryParams = normalizeSearchParams(factorySearch);\n  const reqParams = normalizeSearchParams(requestSearch);\n\n  for (const [k, v] of factoryParams.entries()) {\n    mergedParams.set(k, v);\n  }\n\n  for (const [k, v] of resourceParams.entries()) {\n    mergedParams.set(k, v);\n  }\n\n  for (const [k, v] of reqParams.entries()) {\n    mergedParams.set(k, v);\n  }\n\n  const queryString = mergedParams.toString();\n  if (queryString) {\n    return `${pathOnly}?${queryString}${hash}`;\n  }\n\n  return `${pathOnly}${hash}`;\n}\n\n/**\n * Internal fetch implementation used by both $fetch and createFetch\n */\nexport async function fetchInternal(\n  resource: string,\n  schema: StandardSchemaV1 | undefined,\n  options: ExtendedRequestInit | undefined,\n  defaults: FetchDefaults\n): Promise<unknown> {\n  const {\n    throwOnValidationError = defaults.throwOnValidationError,\n    throwOnFetchError = defaults.throwOnFetchError,\n    headers: requestHeaders,\n    searchParams: requestSearchParams,\n    ...rest\n  } = options || {};\n\n  const mergedHeaders = mergeHeaders(defaults.headers, requestHeaders);\n  const init = { ...rest, headers: mergedHeaders } as RequestInit;\n\n  const isBodyInit =\n    typeof init.body === \"string\" ||\n    init.body instanceof FormData ||\n    init.body instanceof URLSearchParams ||\n    init.body instanceof Blob ||\n    init.body instanceof ArrayBuffer ||\n    ArrayBuffer.isView(init.body) ||\n    init.body instanceof ReadableStream;\n\n  // Auto-stringify plain JSON bodies and set default Content-Type\n  if (init.body != null && !isBodyInit) {\n    init.body = JSON.stringify(init.body);\n\n    const existingHeaders = new Headers(init.headers);\n    if (!existingHeaders.has(\"Content-Type\")) {\n      existingHeaders.set(\"Content-Type\", \"application/json\");\n    }\n\n    init.headers = existingHeaders;\n  }\n\n  // For absolute URLs, ignore baseURL entirely\n  let url: string;\n  if (isAbsoluteURL(resource)) {\n    url = resource;\n  } else {\n    // Normalize URL by avoiding double slashes between baseURL and resource\n    const base = trimTrailingSlashes(defaults.baseURL);\n    const path = trimLeadingSlashes(resource);\n    url = base ? `${base}/${path}` : resource;\n  }\n\n  // Merge query/search params\n  url = buildUrlWithMergedSearchParams(\n    url,\n    defaults.searchParams,\n    requestSearchParams\n  );\n\n  const response = await fetch(url, init);\n\n  if (throwOnFetchError && !response.ok) {\n    throw new FetchError(\n      `HTTP ${response.status}: ${response.statusText}`,\n      response\n    );\n  }\n\n  // For json with schema, validate\n  if (schema) {\n    const raw = await response.json();\n    if (throwOnValidationError) {\n      return standardValidate(schema, raw, { throwOnError: true });\n    }\n    return standardValidate(schema, raw, { throwOnError: false });\n  }\n\n  // No validation, return raw response data\n  return response;\n}\n\n/**\n * Creates an HTTP method helper bound to a fetch function\n */\nexport function createMethod<TFetch extends $Fetch>(\n  fetchFn: TFetch,\n  method: string\n): $Fetch {\n  function methodFetch<TSchema extends StandardSchemaV1>(\n    resource: string,\n    schema: TSchema,\n    options: Omit<ExtendedRequestInit<false>, \"method\">\n  ): Promise<StandardSchemaV1.Result<StandardSchemaV1.InferOutput<TSchema>>>;\n\n  function methodFetch<TSchema extends StandardSchemaV1>(\n    resource: string,\n    schema: TSchema,\n    options?: Omit<ExtendedRequestInit<true | undefined>, \"method\">\n  ): Promise<StandardSchemaV1.InferOutput<TSchema>>;\n\n  function methodFetch(\n    resource: string,\n    options?: Omit<ExtendedRequestInit, \"method\">\n  ): Promise<Response>;\n\n  function methodFetch(\n    resource: string,\n    schemaOrOptions?: StandardSchemaV1 | Omit<ExtendedRequestInit, \"method\">,\n    optionsOrUndefined?: Omit<ExtendedRequestInit, \"method\">\n  ): Promise<unknown> {\n    const [schema, options] = isStandardSchema(schemaOrOptions)\n      ? [schemaOrOptions, optionsOrUndefined]\n      : [undefined, schemaOrOptions];\n\n    return (fetchFn as (...args: unknown[]) => Promise<unknown>)(\n      resource,\n      schema,\n      { ...options, method }\n    );\n  }\n\n  return methodFetch;\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zap-studio/fetch",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "type": "module",
   "license": "MIT",
   "private": false,
@@ -39,7 +39,7 @@
   ],
   "dependencies": {
     "@standard-schema/spec": "^1.1.0",
-    "@zap-studio/validation": "0.2.1"
+    "@zap-studio/validation": "0.3.0"
   },
   "devDependencies": {
     "@types/node": "^25.0.2",
@@ -48,7 +48,7 @@
     "tsdown": "^0.18.0",
     "typescript": "^5.9.3",
     "valibot": "^1.2.0",
-    "vitest": "^4.0.15",
+    "vitest": "^4.0.18",
     "zod": "^4.2.0",
     "@zap-studio/vitest-config": "0.0.0",
     "@zap-studio/tsdown-config": "0.0.0",

package/dist/constants-CzfCghW-.mjs

@@ -1,14 +0,0 @@
-//#region src/constants.ts
-/**
-* Default options for the global $fetch
-*/
-const GLOBAL_DEFAULTS = {
-	baseURL: "",
-	headers: void 0,
-	throwOnFetchError: true,
-	throwOnValidationError: true
-};
-
-//#endregion
-export { GLOBAL_DEFAULTS as t };
-//# sourceMappingURL=constants-CzfCghW-.mjs.map

package/dist/constants-CzfCghW-.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants-CzfCghW-.mjs","names":["GLOBAL_DEFAULTS: FetchDefaults"],"sources":["../src/constants.ts"],"sourcesContent":["import type { FetchDefaults } from \"./types\";\n\n/**\n * Default options for the global $fetch\n */\nexport const GLOBAL_DEFAULTS: FetchDefaults = {\n  baseURL: \"\",\n  headers: undefined,\n  throwOnFetchError: true,\n  throwOnValidationError: true,\n};\n"],"mappings":";;;;AAKA,MAAaA,kBAAiC;CAC5C,SAAS;CACT,SAAS;CACT,mBAAmB;CACnB,wBAAwB;CACzB"}

package/dist/types-CznLOeef.d.mts

@@ -1,130 +0,0 @@
-import { StandardSchemaV1 } from "@standard-schema/spec";
-
-//#region src/types.d.ts
-
-/**
-* Type representing various formats for search parameters
-* that can be used in requests.
-* Can be a URLSearchParams object, a record of string pairs,
-* a query string, or an array of tuples.
-*/
-type SearchParams = URLSearchParams | Record<string, string> | string | [string, string][];
-/**
-* Base extended request options without throwOnValidationError
-*/
-type BaseExtendedRequestInit = Omit<RequestInit, "body"> & {
-  /**
-  * Request body - can be a BodyInit value or an object that will be JSON-stringified
-  */
-  body?: BodyInit | Record<string, unknown>;
-  /**
-  * Per-request query/search params
-  * @default undefined
-  */
-  searchParams?: SearchParams;
-  /**
-  * Whether to throw a FetchError on HTTP errors (non-2xx responses)
-  * @default true
-  */
-  throwOnFetchError?: boolean;
-};
-/**
-* Extended RequestInit type to include custom fetch options
-*/
-type ExtendedRequestInit<TThrowOnValidationError extends boolean | undefined = boolean | undefined> = BaseExtendedRequestInit & {
-  /**
-  * Whether to throw a ValidationError on validation errors
-  * @default true
-  */
-  throwOnValidationError?: TThrowOnValidationError;
-};
-/**
-* Internal defaults used by fetchInternal
-*/
-type FetchDefaults = {
-  /**
-  * Base URL to prepend to all requests
-  * @default ""
-  */
-  baseURL: string;
-  /**
-  * Default headers to include in all requests (can be overridden per request)
-  * @default undefined
-  */
-  headers?: HeadersInit;
-  /**
-  * Default query/search params applied to every request (can be overridden per request)
-  * @default undefined
-  */
-  searchParams?: SearchParams;
-  /**
-  * Whether to throw a `FetchError` on HTTP errors (non-2xx responses)
-  * @default true
-  */
-  throwOnFetchError: boolean;
-  /**
-  * Whether to throw a `ValidationError` on validation errors
-  * @default true
-  */
-  throwOnValidationError: boolean;
-};
-/**
-* Options for creating a custom fetch instance with `createFetch`
-*/
-type CreateFetchOptions = Partial<FetchDefaults>;
-/**
-* Type-safe fetch function with Standard Schema validation support
-*/
-type $Fetch = {
-  /**
-  * Fetch with schema validation and throwOnValidationError: false
-  * @param resource - URL or path to fetch
-  * @param schema - Standard Schema for response validation
-  * @param options - Extended request options with throwOnValidationError: false
-  * @returns Standard Schema Result object with value or issues
-  */
-  <TSchema extends StandardSchemaV1>(resource: string, schema: TSchema, options: ExtendedRequestInit<false>): Promise<StandardSchemaV1.Result<StandardSchemaV1.InferOutput<TSchema>>>;
-  /**
-  * Fetch with schema validation and throwOnValidationError: true or undefined (default)
-  * @param resource - URL or path to fetch
-  * @param schema - Standard Schema for response validation
-  * @param options - Extended request options
-  * @returns Validated data of type TSchema
-  */
-  <TSchema extends StandardSchemaV1>(resource: string, schema: TSchema, options?: ExtendedRequestInit<true | undefined>): Promise<StandardSchemaV1.InferOutput<TSchema>>;
-  /**
-  * Fetch without schema validation
-  * @param resource - URL or path to fetch
-  * @param options - Extended request options
-  * @returns Raw Response object
-  */
-  (resource: string, options?: ExtendedRequestInit): Promise<Response>;
-};
-/**
-* API HTTP method-specific fetch functions
-*/
-type ApiMethods = {
-  /**
-  * GET method fetch function
-  */
-  get: $Fetch;
-  /**
-  * POST method fetch function
-  */
-  post: $Fetch;
-  /**
-  * PUT method fetch function
-  */
-  put: $Fetch;
-  /**
-  * DELETE method fetch function
-  */
-  delete: $Fetch;
-  /**
-  * PATCH method fetch function
-  */
-  patch: $Fetch;
-};
-//#endregion
-export { FetchDefaults as a, ExtendedRequestInit as i, ApiMethods as n, SearchParams as o, CreateFetchOptions as r, $Fetch as t };
-//# sourceMappingURL=types-CznLOeef.d.mts.map

package/dist/types-CznLOeef.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types-CznLOeef.d.mts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;;AAQA;AAEI;;;AAWK,KAbG,YAAA,GACR,eAYK,GAXL,MAWK,CAAA,MAAA,EAAA,MAAA,CAAA,GAAA,MAAA,GAAA,CAAA,MAAA,EAAA,MAAA,CAAA,EAAA;;;;AAgBT,KApBK,uBAAA,GAA0B,IAoBnB,CApBwB,WAoBxB,EAAA,MAAA,CAAA,GAAA;EAaZ;AA+BA;AAKA;EAQmB,IAAA,CAAA,EAzEV,QAyEU,GAzEC,MAyED,CAAA,MAAA,EAAA,OAAA,CAAA;EAEP;;;;EAEC,YAAA,CAAA,EAxEI,YAwEa;EAAzB;;;;EAaqC,iBAAA,CAAA,EAAA,OAAA;CAA7B;;;;AAQwC,KAlFzC,mBAkFyC,CAAA,gCAAA,OAAA,GAAA,SAAA,GAAA,OAAA,GAAA,SAAA,CAAA,GAhFjD,uBAgFiD,GAAA;EAAA;AAMrD;;;EAYO,sBAAA,CAAA,EA7FoB,uBA6FpB;CAIG;;;;KA3FE,aAAA;;;;;;;;;;YAUA;;;;;iBAKK;;;;;;;;;;;;;;;KAgBL,kBAAA,GAAqB,QAAQ;;;;KAK7B,MAAA;;;;;;;;mBAQO,4CAEP,kBACC,6BACR,QAAQ,gBAAA,CAAiB,OAAO,gBAAA,CAAiB,YAAY;;;;;;;;mBAS/C,4CAEP,mBACE,wCACT,QAAQ,gBAAA,CAAiB,YAAY;;;;;;;+BAQX,sBAAsB,QAAQ;;;;;KAMjD,UAAA;;;;OAIL;;;;QAIC;;;;OAID;;;;UAIG;;;;SAID"}

package/dist/utils-C1YvgnKM.mjs

@@ -1,179 +0,0 @@
-import { t as FetchError } from "./errors-rk_WqFKR.mjs";
-import { isStandardSchema, standardValidate } from "@zap-studio/validation";
-
-//#region src/utils.ts
-/**
-* Merges two HeadersInit objects, with the second one taking precedence
-*
-* @example
-* const baseHeaders = { "Authorization": "Bearer token", "Content-Type": "application/json" };
-* const overrideHeaders = { "Content-Type": "application/xml", "X-Custom-Header": "value" };
-*
-* const merged = mergeHeaders(baseHeaders, overrideHeaders);
-*
-* // Resulting headers:
-* // {
-* //   "Authorization": "Bearer token",
-* //   "Content-Type": "application/xml",
-* //   "X-Custom-Header": "value"
-* // }
-*/
-function mergeHeaders(base, override) {
-	if (!(base || override)) return;
-	const merged = new Headers(base);
-	if (override) {
-		const overrideHeaders = new Headers(override);
-		for (const [key, value] of overrideHeaders.entries()) merged.set(key, value);
-	}
-	return merged;
-}
-/**
-* Removes trailing slashes from a string
-*/
-function trimTrailingSlashes(str) {
-	let end = str.length;
-	while (end > 0 && str[end - 1] === "/") end -= 1;
-	return str.slice(0, end);
-}
-/**
-* Removes leading slashes from a string
-*/
-function trimLeadingSlashes(str) {
-	let start = 0;
-	while (start < str.length && str[start] === "/") start += 1;
-	return str.slice(start);
-}
-const ABSOLUTE_URL_PATTERN = /^(?:https?:)?\/\//i;
-/**
-* Checks if a URL is absolute (starts with http://, https://, or //)
-*/
-function isAbsoluteURL(url) {
-	return ABSOLUTE_URL_PATTERN.test(url);
-}
-/**
-* Normalizes search parameters into a URLSearchParams object.
-*/
-function normalizeSearchParams(input) {
-	if (input === void 0 || input === null) return new URLSearchParams();
-	if (input instanceof URLSearchParams) return new URLSearchParams(input);
-	if (typeof input === "string") return new URLSearchParams(input);
-	if (Array.isArray(input)) return new URLSearchParams(input);
-	const params = new URLSearchParams();
-	for (const [k, v] of Object.entries(input)) params.set(k, v);
-	return params;
-}
-/**
-* Parses a URL string into its path, query, and hash components.
-* Handles both absolute URLs (using URL constructor) and relative paths.
-*/
-function parseUrlComponents(url) {
-	if (isAbsoluteURL(url)) try {
-		const parsed = new URL(url);
-		const pathOnly = `${parsed.origin}${parsed.pathname}`;
-		const existingQuery = parsed.search.startsWith("?") ? parsed.search.slice(1) : parsed.search;
-		let hash$1 = parsed.hash;
-		if (hash$1 === "" && url.endsWith("#")) hash$1 = "#";
-		return {
-			pathOnly,
-			existingQuery,
-			hash: hash$1
-		};
-	} catch {}
-	let hash = "";
-	let urlWithoutHash = url;
-	const hashIndex = url.indexOf("#");
-	if (hashIndex !== -1) {
-		hash = url.slice(hashIndex);
-		urlWithoutHash = url.slice(0, hashIndex);
-	}
-	const queryIndex = urlWithoutHash.indexOf("?");
-	if (queryIndex === -1) return {
-		pathOnly: urlWithoutHash,
-		existingQuery: "",
-		hash
-	};
-	return {
-		pathOnly: urlWithoutHash.slice(0, queryIndex),
-		existingQuery: urlWithoutHash.slice(queryIndex + 1),
-		hash
-	};
-}
-/**
-* Builds a URL with merged search parameters from factory defaults,
-* request options, and existing query parameters.
-*
-* This function takes a base URL, factory search parameters,
-* and request search parameters, and combines them into a single URL.
-*
-* Priority (highest to lowest):
-* 1. Request search parameters (highest priority, overwrites all others)
-* 2. Existing query parameters from the URL (overwrites factory defaults)
-* 3. Factory search parameters (lowest priority, overwritten by all others)
-*
-* If no search parameters are provided, the URL will not have a query string.
-* Any trailing hash/fragment is preserved.
-*/
-function buildUrlWithMergedSearchParams(url, factorySearch, requestSearch) {
-	const { pathOnly, existingQuery, hash } = parseUrlComponents(url);
-	if (!(factorySearch ?? requestSearch ?? existingQuery)) return url;
-	const mergedParams = new URLSearchParams();
-	const resourceParams = new URLSearchParams(existingQuery);
-	const factoryParams = normalizeSearchParams(factorySearch);
-	const reqParams = normalizeSearchParams(requestSearch);
-	for (const [k, v] of factoryParams.entries()) mergedParams.set(k, v);
-	for (const [k, v] of resourceParams.entries()) mergedParams.set(k, v);
-	for (const [k, v] of reqParams.entries()) mergedParams.set(k, v);
-	const queryString = mergedParams.toString();
-	if (queryString) return `${pathOnly}?${queryString}${hash}`;
-	return `${pathOnly}${hash}`;
-}
-/**
-* Internal fetch implementation used by both $fetch and createFetch
-*/
-async function fetchInternal(resource, schema, options, defaults) {
-	const { throwOnValidationError = defaults.throwOnValidationError, throwOnFetchError = defaults.throwOnFetchError, headers: requestHeaders, searchParams: requestSearchParams, ...rest } = options || {};
-	const mergedHeaders = mergeHeaders(defaults.headers, requestHeaders);
-	const init = {
-		...rest,
-		headers: mergedHeaders
-	};
-	if (schema && init.body) {
-		init.body = JSON.stringify(init.body);
-		const existingHeaders = new Headers(init.headers);
-		if (!existingHeaders.has("Content-Type")) existingHeaders.set("Content-Type", "application/json");
-		init.headers = existingHeaders;
-	}
-	let url;
-	if (isAbsoluteURL(resource)) url = resource;
-	else {
-		const base = trimTrailingSlashes(defaults.baseURL);
-		const path = trimLeadingSlashes(resource);
-		url = base ? `${base}/${path}` : resource;
-	}
-	url = buildUrlWithMergedSearchParams(url, defaults.searchParams, requestSearchParams);
-	const response = await fetch(url, init);
-	if (throwOnFetchError && !response.ok) throw new FetchError(`HTTP ${response.status}: ${response.statusText}`, response);
-	if (schema) {
-		const raw = await response.json();
-		if (throwOnValidationError) return standardValidate(schema, raw, true);
-		return standardValidate(schema, raw, false);
-	}
-	return response;
-}
-/**
-* Creates an HTTP method helper bound to a fetch function
-*/
-function createMethod(fetchFn, method) {
-	function methodFetch(resource, schemaOrOptions, optionsOrUndefined) {
-		const [schema, options] = isStandardSchema(schemaOrOptions) ? [schemaOrOptions, optionsOrUndefined] : [void 0, schemaOrOptions];
-		return fetchFn(resource, schema, {
-			...options,
-			method
-		});
-	}
-	return methodFetch;
-}
-
-//#endregion
-export { fetchInternal as n, mergeHeaders as r, createMethod as t };
-//# sourceMappingURL=utils-C1YvgnKM.mjs.map

package/dist/utils-C1YvgnKM.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils-C1YvgnKM.mjs","names":["hash","url: string"],"sources":["../src/utils.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { isStandardSchema, standardValidate } from \"@zap-studio/validation\";\nimport { FetchError } from \"./errors\";\nimport type {\n  $Fetch,\n  ExtendedRequestInit,\n  FetchDefaults,\n  SearchParams,\n} from \"./types\";\n\n/**\n * Merges two HeadersInit objects, with the second one taking precedence\n *\n * @example\n * const baseHeaders = { \"Authorization\": \"Bearer token\", \"Content-Type\": \"application/json\" };\n * const overrideHeaders = { \"Content-Type\": \"application/xml\", \"X-Custom-Header\": \"value\" };\n *\n * const merged = mergeHeaders(baseHeaders, overrideHeaders);\n *\n * // Resulting headers:\n * // {\n * //   \"Authorization\": \"Bearer token\",\n * //   \"Content-Type\": \"application/xml\",\n * //   \"X-Custom-Header\": \"value\"\n * // }\n */\nexport function mergeHeaders(\n  base: HeadersInit | undefined,\n  override: HeadersInit | undefined\n): Headers | undefined {\n  if (!(base || override)) {\n    return;\n  }\n\n  const merged = new Headers(base);\n  if (override) {\n    const overrideHeaders = new Headers(override);\n    for (const [key, value] of overrideHeaders.entries()) {\n      merged.set(key, value);\n    }\n  }\n  return merged;\n}\n\n/**\n * Removes trailing slashes from a string\n */\nfunction trimTrailingSlashes(str: string): string {\n  let end = str.length;\n  while (end > 0 && str[end - 1] === \"/\") {\n    end -= 1;\n  }\n  return str.slice(0, end);\n}\n\n/**\n * Removes leading slashes from a string\n */\nfunction trimLeadingSlashes(str: string): string {\n  let start = 0;\n  while (start < str.length && str[start] === \"/\") {\n    start += 1;\n  }\n  return str.slice(start);\n}\n\nconst ABSOLUTE_URL_PATTERN = /^(?:https?:)?\\/\\//i;\n\n/**\n * Checks if a URL is absolute (starts with http://, https://, or //)\n */\nfunction isAbsoluteURL(url: string): boolean {\n  return ABSOLUTE_URL_PATTERN.test(url);\n}\n\n/**\n * Normalizes search parameters into a URLSearchParams object.\n */\nfunction normalizeSearchParams(\n  input: SearchParams | undefined\n): URLSearchParams {\n  if (input === undefined || input === null) {\n    return new URLSearchParams();\n  }\n\n  if (input instanceof URLSearchParams) {\n    return new URLSearchParams(input);\n  }\n\n  if (typeof input === \"string\") {\n    return new URLSearchParams(input);\n  }\n\n  if (Array.isArray(input)) {\n    return new URLSearchParams(input);\n  }\n\n  const params = new URLSearchParams();\n  for (const [k, v] of Object.entries(input)) {\n    params.set(k, v);\n  }\n\n  return params;\n}\n\n/**\n * Parses a URL string into its path, query, and hash components.\n * Handles both absolute URLs (using URL constructor) and relative paths.\n */\nfunction parseUrlComponents(url: string): {\n  pathOnly: string;\n  existingQuery: string;\n  hash: string;\n} {\n  // Try parsing as absolute URL first\n  if (isAbsoluteURL(url)) {\n    try {\n      const parsed = new URL(url);\n      const pathOnly = `${parsed.origin}${parsed.pathname}`;\n      // parsed.search includes the leading \"?\", so strip it\n      const existingQuery = parsed.search.startsWith(\"?\")\n        ? parsed.search.slice(1)\n        : parsed.search;\n      // URL constructor normalizes away empty hash, if original URL had # at end, preserve it\n      let hash = parsed.hash;\n      if (hash === \"\" && url.endsWith(\"#\")) {\n        hash = \"#\";\n      }\n      return { pathOnly, existingQuery, hash };\n    } catch {\n      // Fall through to manual parsing if URL constructor fails\n    }\n  }\n\n  // Manual parsing for relative URLs or if URL constructor failed\n  let hash = \"\";\n  let urlWithoutHash = url;\n  const hashIndex = url.indexOf(\"#\");\n  if (hashIndex !== -1) {\n    hash = url.slice(hashIndex);\n    urlWithoutHash = url.slice(0, hashIndex);\n  }\n\n  // Find the first \"?\" to split path and query\n  const queryIndex = urlWithoutHash.indexOf(\"?\");\n  if (queryIndex === -1) {\n    return { pathOnly: urlWithoutHash, existingQuery: \"\", hash };\n  }\n\n  const pathOnly = urlWithoutHash.slice(0, queryIndex);\n  const existingQuery = urlWithoutHash.slice(queryIndex + 1);\n  return { pathOnly, existingQuery, hash };\n}\n\n/**\n * Builds a URL with merged search parameters from factory defaults,\n * request options, and existing query parameters.\n *\n * This function takes a base URL, factory search parameters,\n * and request search parameters, and combines them into a single URL.\n *\n * Priority (highest to lowest):\n * 1. Request search parameters (highest priority, overwrites all others)\n * 2. Existing query parameters from the URL (overwrites factory defaults)\n * 3. Factory search parameters (lowest priority, overwritten by all others)\n *\n * If no search parameters are provided, the URL will not have a query string.\n * Any trailing hash/fragment is preserved.\n */\nfunction buildUrlWithMergedSearchParams(\n  url: string,\n  factorySearch: FetchDefaults[\"searchParams\"] | undefined,\n  requestSearch: ExtendedRequestInit[\"searchParams\"] | undefined\n): string {\n  const { pathOnly, existingQuery, hash } = parseUrlComponents(url);\n\n  // Early return if no search params to merge\n  const hasSearchParams = factorySearch ?? requestSearch ?? existingQuery;\n  if (!hasSearchParams) {\n    return url;\n  }\n\n  const mergedParams = new URLSearchParams();\n\n  const resourceParams = new URLSearchParams(existingQuery);\n  const factoryParams = normalizeSearchParams(factorySearch);\n  const reqParams = normalizeSearchParams(requestSearch);\n\n  for (const [k, v] of factoryParams.entries()) {\n    mergedParams.set(k, v);\n  }\n\n  for (const [k, v] of resourceParams.entries()) {\n    mergedParams.set(k, v);\n  }\n\n  for (const [k, v] of reqParams.entries()) {\n    mergedParams.set(k, v);\n  }\n\n  const queryString = mergedParams.toString();\n  if (queryString) {\n    return `${pathOnly}?${queryString}${hash}`;\n  }\n\n  return `${pathOnly}${hash}`;\n}\n\n/**\n * Internal fetch implementation used by both $fetch and createFetch\n */\nexport async function fetchInternal(\n  resource: string,\n  schema: StandardSchemaV1 | undefined,\n  options: ExtendedRequestInit | undefined,\n  defaults: FetchDefaults\n): Promise<unknown> {\n  const {\n    throwOnValidationError = defaults.throwOnValidationError,\n    throwOnFetchError = defaults.throwOnFetchError,\n    headers: requestHeaders,\n    searchParams: requestSearchParams,\n    ...rest\n  } = options || {};\n\n  const mergedHeaders = mergeHeaders(defaults.headers, requestHeaders);\n  const init = { ...rest, headers: mergedHeaders } as RequestInit;\n\n  // Auto-stringify body and set default Content-Type if we have a schema\n  if (schema && init.body) {\n    init.body = JSON.stringify(init.body);\n\n    const existingHeaders = new Headers(init.headers);\n    if (!existingHeaders.has(\"Content-Type\")) {\n      existingHeaders.set(\"Content-Type\", \"application/json\");\n    }\n\n    init.headers = existingHeaders;\n  }\n\n  // For absolute URLs, ignore baseURL entirely\n  let url: string;\n  if (isAbsoluteURL(resource)) {\n    url = resource;\n  } else {\n    // Normalize URL by avoiding double slashes between baseURL and resource\n    const base = trimTrailingSlashes(defaults.baseURL);\n    const path = trimLeadingSlashes(resource);\n    url = base ? `${base}/${path}` : resource;\n  }\n\n  // Merge query/search params\n  url = buildUrlWithMergedSearchParams(\n    url,\n    defaults.searchParams,\n    requestSearchParams\n  );\n\n  const response = await fetch(url, init);\n\n  if (throwOnFetchError && !response.ok) {\n    throw new FetchError(\n      `HTTP ${response.status}: ${response.statusText}`,\n      response\n    );\n  }\n\n  // For json with schema, validate\n  if (schema) {\n    const raw = await response.json();\n    if (throwOnValidationError) {\n      return standardValidate(schema, raw, true);\n    }\n    return standardValidate(schema, raw, false);\n  }\n\n  // No validation, return raw response data\n  return response;\n}\n\n/**\n * Creates an HTTP method helper bound to a fetch function\n */\nexport function createMethod<TFetch extends $Fetch>(\n  fetchFn: TFetch,\n  method: string\n): $Fetch {\n  function methodFetch<TSchema extends StandardSchemaV1>(\n    resource: string,\n    schema: TSchema,\n    options: Omit<ExtendedRequestInit<false>, \"method\">\n  ): Promise<StandardSchemaV1.Result<StandardSchemaV1.InferOutput<TSchema>>>;\n\n  function methodFetch<TSchema extends StandardSchemaV1>(\n    resource: string,\n    schema: TSchema,\n    options?: Omit<ExtendedRequestInit<true | undefined>, \"method\">\n  ): Promise<StandardSchemaV1.InferOutput<TSchema>>;\n\n  function methodFetch(\n    resource: string,\n    options?: Omit<ExtendedRequestInit, \"method\">\n  ): Promise<Response>;\n\n  function methodFetch(\n    resource: string,\n    schemaOrOptions?: StandardSchemaV1 | Omit<ExtendedRequestInit, \"method\">,\n    optionsOrUndefined?: Omit<ExtendedRequestInit, \"method\">\n  ): Promise<unknown> {\n    const [schema, options] = isStandardSchema(schemaOrOptions)\n      ? [schemaOrOptions, optionsOrUndefined]\n      : [undefined, schemaOrOptions];\n\n    return (fetchFn as (...args: unknown[]) => Promise<unknown>)(\n      resource,\n      schema,\n      { ...options, method }\n    );\n  }\n\n  return methodFetch;\n}\n"],"mappings":"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"}