@zap-studio/fetch 0.2.2 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @zap-studio/fetch
 
+## 0.3.1
+
+### Patch Changes
+
+- 9919f63: Add discriminated return types based on `throwOnValidationError` option
+
+  The return type of `$fetch` and `api.*` methods now correctly narrows based on the `throwOnValidationError` option:
+
+  - When `throwOnValidationError: true` (default) or unspecified: returns `Promise<TSchema>` (the validated data directly)
+  - When `throwOnValidationError: false`: returns `Promise<StandardSchemaV1.Result<TSchema>>` (the result object with `value` or `issues`)
+
+  This improves type safety by eliminating the need for manual type narrowing when using the default behavior.
+
+## 0.3.0
+
+### Minor Changes
+
+- 659621c: Add `searchParams` option to `createFetch` to allow factory-level default query/search parameters. Per-request `searchParams` continue to override factory defaults.
+
 ## 0.2.2
 
 ### Patch Changes

package/README.md

@@ -55,179 +55,3 @@ const user = await api.get("https://api.example.com/users/1", UserSchema);
 // user is fully typed and validated! ✨
 console.log(user.name); // TypeScript knows this is a string
 ```
-
-## API
-
-### `api.get(url, schema, options?)`
-
-```typescript
-const user = await api.get("/api/users/1", UserSchema);
-```
-
-### `api.post(url, schema, options?)`
-
-```typescript
-const newUser = await api.post("/api/users", UserSchema, {
-  body: {
-    name: "John Doe",
-    email: "john@example.com",
-  },
-});
-// Automatically stringifies body and sets Content-Type: application/json
-```
-
-### `api.put(url, schema, options?)`
-
-```typescript
-const updated = await api.put("/api/users/1", UserSchema, {
-  body: { name: "Jane Doe" },
-});
-```
-
-### `api.patch(url, schema, options?)`
-
-```typescript
-const patched = await api.patch("/api/users/1", UserSchema, {
-  body: { email: "newemail@example.com" },
-});
-```
-
-### `api.delete(url, schema, options?)`
-
-```typescript
-const deleted = await api.delete("/api/users/1", UserSchema);
-```
-
-> **Note:** The `api.*` methods always require a schema for validation. For raw responses without validation, use `$fetch` directly.
-
-## Advanced Usage
-
-### Using `$fetch` directly
-
-For more control or when you don't need schema validation:
-
-```typescript
-import { $fetch } from "@zap-studio/fetch";
-
-// With schema validation
-const user = await $fetch("https://api.example.com/users/1", UserSchema, {
-  method: "GET",
-  headers: {
-    Authorization: "Bearer token",
-  },
-});
-
-// Without schema - returns raw Response object
-const response = await $fetch("https://api.example.com/users/1", {
-  method: "GET",
-});
-const data = await response.json();
-```
-
-### Factory Pattern with `createFetch`
-
-Create pre-configured fetch instances with base URLs and default headers. Useful for API clients:
-
-```typescript
-import { z } from "zod";
-import { createFetch } from "@zap-studio/fetch";
-
-// Create a configured instance
-const { $fetch, api } = createFetch({
-  baseURL: "https://api.example.com",
-  headers: {
-    Authorization: "Bearer your-token",
-    "X-API-Key": "your-api-key",
-  },
-});
-
-const UserSchema = z.object({
-  id: z.number(),
-  name: z.string(),
-});
-
-// Now use relative paths - baseURL is prepended automatically
-const user = await api.get("/users/1", UserSchema);
-
-// POST with auto-stringified body
-const newUser = await api.post("/users", UserSchema, {
-  body: { name: "John Doe" },
-});
-```
-
-#### Factory Options
-
-| Option                   | Type          | Default | Description                                      |
-| ------------------------ | ------------- | ------- | ------------------------------------------------ |
-| `baseURL`                | `string`      | `""`    | Base URL prepended to relative paths only        |
-| `headers`                | `HeadersInit` | -       | Default headers included in all requests         |
-| `throwOnFetchError`      | `boolean`     | `true`  | Throw `FetchError` on non-2xx responses          |
-| `throwOnValidationError` | `boolean`     | `true`  | Throw `ValidationError` on schema validation failures |
-
-> **Note:** Absolute URLs (starting with `http://`, `https://`, or `//`) are used as-is and ignore the `baseURL`.
-
-#### Multiple API Clients
-
-You can create separate fetch instances for different APIs:
-
-```typescript
-import { createFetch } from "@zap-studio/fetch";
-
-// GitHub API client
-const github = createFetch({
-  baseURL: "https://api.github.com",
-  headers: { Authorization: "Bearer github-token" },
-});
-
-// Your internal API client
-const internal = createFetch({
-  baseURL: "https://internal.example.com/api",
-  headers: { "X-Internal-Key": "secret" },
-});
-
-// Use them independently
-const repo = await github.api.get("/repos/owner/repo", RepoSchema);
-const data = await internal.api.get("/data", DataSchema);
-```
-
-### Error Handling
-
-The package exports specialized error classes for granular error handling:
-
-```typescript
-import { $fetch } from "@zap-studio/fetch";
-import { FetchError, ValidationError } from "@zap-studio/fetch/errors";
-
-try {
-  const user = await api.get("/api/users/1", UserSchema);
-} catch (error) {
-  if (error instanceof FetchError) {
-    console.error(`HTTP ${error.status}: ${error.response.statusText}`);
-  }
-  if (error instanceof ValidationError) {
-    console.error("Validation failed:", error.issues);
-  }
-}
-```
-
-### Flexible Validation
-
-You can choose whether validation errors should throw exceptions:
-
-```typescript
-// Throw on validation error (default)
-const user = await $fetch(url, UserSchema, {
-  throwOnValidationError: true,
-});
-
-// Return validation result without throwing
-const result = await $fetch(url, UserSchema, {
-  throwOnValidationError: false,
-});
-
-if (result.issues) {
-  console.error("Validation failed:", result.issues);
-} else {
-  console.log("Success:", result.value);
-}
-```

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { i as ExtendedRequestInit, n as ApiMethods, r as CreateFetchOptions, t as $Fetch } from "./types-BB4ejGeA.mjs";
+import { i as ExtendedRequestInit, n as ApiMethods, r as CreateFetchOptions, t as $Fetch } from "./types-CvCrPMIR.mjs";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/index.d.ts
@@ -39,7 +39,8 @@ import { StandardSchemaV1 } from "@standard-schema/spec";
 *   console.log("Validated user:", result.value);
 * }
 */
-declare function $fetch<TSchema extends StandardSchemaV1>(resource: string, schema: TSchema, options?: ExtendedRequestInit): Promise<StandardSchemaV1.InferOutput<TSchema> | StandardSchemaV1.Result<StandardSchemaV1.InferOutput<TSchema>>>;
+declare function $fetch<TSchema extends StandardSchemaV1>(resource: string, schema: TSchema, options: ExtendedRequestInit<false>): Promise<StandardSchemaV1.Result<StandardSchemaV1.InferOutput<TSchema>>>;
+declare function $fetch<TSchema extends StandardSchemaV1>(resource: string, schema: TSchema, options?: ExtendedRequestInit<true | undefined>): Promise<StandardSchemaV1.InferOutput<TSchema>>;
 declare function $fetch(resource: string, options?: ExtendedRequestInit): Promise<Response>;
 /**
 * Convenience methods for common HTTP verbs.

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":["api: ApiMethods"],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;AAgDA;;;;;;;;;;;AASA;;;;;AAsCA;AAgCA;;;;;;;;;;;;;;;;;iBA/EsB,uBAAuB,4CAEnC,mBACE,sBACT,QACC,gBAAA,CAAiB,YAAY,WAC7B,gBAAA,CAAiB,OAAO,gBAAA,CAAiB,YAAY;iBAGnC,MAAA,6BAEV,sBACT,QAAQ;;;;;;;;;;;;;;;;;;;;;;cAmCEA,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;iBAgCF,WAAA,kBAA4B;UAClC;OACH"}
+{"version":3,"file":"index.d.mts","names":["api: ApiMethods"],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;AAgDA;;;;;;;;;AAMA;;;;;;;;AAMA;;;;;AAsCA;AAgCA;;;;;;;;;;;iBAlFsB,uBAAuB,4CAEnC,kBACC,6BACR,QAAQ,gBAAA,CAAiB,OAAO,gBAAA,CAAiB,YAAY;iBAE1C,uBAAuB,4CAEnC,mBACE,wCACT,QAAQ,gBAAA,CAAiB,YAAY;iBAElB,MAAA,6BAEV,sBACT,QAAQ;;;;;;;;;;;;;;;;;;;;;;cAmCEA,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;iBAgCF,WAAA,kBAA4B;UAClC;OACH"}

package/dist/index.mjs

@@ -63,10 +63,87 @@ 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, ...rest } = options || {};
+	const { throwOnValidationError = defaults.throwOnValidationError, throwOnFetchError = defaults.throwOnFetchError, headers: requestHeaders, searchParams: requestSearchParams, ...rest } = options || {};
 	const mergedHeaders = mergeHeaders(defaults.headers, requestHeaders);
 	const init = {
 		...rest,
@@ -85,6 +162,7 @@ async function fetchInternal(resource, schema, options, defaults) {
 		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) return standardValidate(schema, await response.json(), throwOnValidationError);
@@ -94,10 +172,14 @@ async function fetchInternal(resource, schema, options, defaults) {
 * Creates an HTTP method helper bound to a fetch function
 */
 function createMethod(fetchFn, method) {
-	return (resource, schema, options) => fetchFn(resource, schema, {
-		...options,
-		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
@@ -162,6 +244,7 @@ function createFetch(factoryOptions = {}) {
 	const defaults = {
 		baseURL: factoryOptions.baseURL ?? "",
 		headers: factoryOptions.headers,
+		searchParams: factoryOptions.searchParams,
 		throwOnFetchError: factoryOptions.throwOnFetchError ?? true,
 		throwOnValidationError: factoryOptions.throwOnValidationError ?? true
 	};

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["GLOBAL_DEFAULTS: FetchDefaults","url: string","api: ApiMethods","defaults: FetchDefaults"],"sources":["../src/internal/constants.ts","../src/internal/utils.ts","../src/index.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","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { FetchError } from \"../errors\";\nimport type { $Fetch, ExtendedRequestInit, FetchDefaults } from \"../types\";\nimport { standardValidate } from \"../validator\";\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 * 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    ...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  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    return standardValidate(schema, raw, throwOnValidationError);\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  return <TSchema extends StandardSchemaV1>(\n    resource: string,\n    schema: TSchema,\n    options?: Omit<ExtendedRequestInit, \"method\">\n  ) => fetchFn(resource, schema, { ...options, method });\n}\n","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { GLOBAL_DEFAULTS } from \"./internal/constants\";\nimport { createMethod, fetchInternal } from \"./internal/utils\";\nimport type {\n  $Fetch,\n  ApiMethods,\n  CreateFetchOptions,\n  ExtendedRequestInit,\n  FetchDefaults,\n} from \"./types\";\nimport { isStandardSchema } from \"./validator\";\n\n/**\n * Type-safe fetch wrapper with Standard Schema validation.\n *\n * - When `throwOnValidationError: true`: validated data of type `TSchema`\n * - When `throwOnValidationError: false`: Standard Schema Result object `{ value?, issues? }`\n * - When `throwOnFetchError: true`: throws `FetchError` on non-ok responses\n *\n * If no schema is provided, returns the raw `Response` object.\n *\n * @throws {FetchError} When `throwOnFetchError: true` and response is not ok\n * @throws {ValidationError} When `throwOnValidationError: true` and validation fails\n *\n * @example\n * import { z } from \"zod\";\n * import { $fetch } from \"@zap-studio/fetch\";\n *\n * const UserSchema = z.object({ id: z.number(), name: z.string() });\n *\n * // Basic usage (schema validation)\n * const user = await $fetch(\"/api/users/1\", UserSchema, { headers: { \"Authorization\": \"Bearer token\" } });\n * console.log(\"Validated user:\", user);\n *\n * // Raw usage (no schema validation and typed Response object)\n * const result = await $fetch(\"/api/data\", { method: \"POST\", body: JSON.stringify({ key: \"value\" }) });\n * const json = await result.json() as ResultType;\n * console.log(\"Raw response data:\", json);\n *\n * // Usage with validation errors returned instead of thrown\n * const result = await $fetch(\"/api/users/1\", UserSchema, { throwOnValidationError: false });\n *\n * if (result.issues) {\n *   console.error(\"Validation errors:\", result.issues);\n * } else {\n *   console.log(\"Validated user:\", result.value);\n * }\n */\nexport async function $fetch<TSchema extends StandardSchemaV1>(\n  resource: string,\n  schema: TSchema,\n  options?: ExtendedRequestInit\n): Promise<\n  | StandardSchemaV1.InferOutput<TSchema>\n  | StandardSchemaV1.Result<StandardSchemaV1.InferOutput<TSchema>>\n>;\n\nexport async function $fetch(\n  resource: string,\n  options?: ExtendedRequestInit\n): Promise<Response>;\n\nexport async function $fetch(\n  resource: string,\n  schemaOrOptions?: StandardSchemaV1 | ExtendedRequestInit,\n  optionsOrUndefined?: ExtendedRequestInit\n): Promise<unknown> {\n  const [schema, options] = isStandardSchema(schemaOrOptions)\n    ? [schemaOrOptions, optionsOrUndefined]\n    : [undefined, schemaOrOptions];\n\n  return await fetchInternal(resource, schema, options, GLOBAL_DEFAULTS);\n}\n\n/**\n * Convenience methods for common HTTP verbs.\n *\n * These methods always require a schema for validation.\n * For raw responses without validation, use `$fetch` directly.\n *\n * @example\n * import { z } from \"zod\";\n * import { api } from \"@zap-studio/fetch\";\n *\n * const PostSchema = z.object({\n *   id: z.number(),\n *   title: z.string(),\n *   content: z.string(),\n * });\n *\n * async function fetchPost(postId: number) {\n *   const post = await api.get(`https://api.example.com/posts/${postId}`, PostSchema);\n *   return post; // post is typed as { id: number; title: string; content: string; }\n * }\n */\nexport const api: ApiMethods = {\n  get: createMethod($fetch, \"GET\"),\n  post: createMethod($fetch, \"POST\"),\n  put: createMethod($fetch, \"PUT\"),\n  patch: createMethod($fetch, \"PATCH\"),\n  delete: createMethod($fetch, \"DELETE\"),\n};\n\n/**\n * Creates a custom fetch instance with pre-configured defaults.\n *\n * Use this factory to create API clients with a base URL, default headers,\n * and other shared configuration. Each instance is independent.\n *\n * @example\n * import { z } from \"zod\";\n * import { createFetch } from \"@zap-studio/fetch\";\n *\n * // Create a configured instance\n * const { $fetch, api } = createFetch({\n *   baseURL: \"https://api.example.com\",\n *   headers: { \"Authorization\": \"Bearer token\" },\n * });\n *\n * const UserSchema = z.object({ id: z.number(), name: z.string() });\n *\n * // Now use relative paths - baseURL is prepended automatically\n * const user = await api.get(\"/users/1\", UserSchema);\n *\n * // Or use $fetch directly\n * const response = await $fetch(\"/users\", UserSchema, { method: \"POST\", body: { name: \"John\" } });\n */\nexport function createFetch(factoryOptions: CreateFetchOptions = {}): {\n  $fetch: $Fetch;\n  api: ApiMethods;\n} {\n  const defaults: FetchDefaults = {\n    baseURL: factoryOptions.baseURL ?? \"\",\n    headers: factoryOptions.headers,\n    throwOnFetchError: factoryOptions.throwOnFetchError ?? true,\n    throwOnValidationError: factoryOptions.throwOnValidationError ?? true,\n  };\n\n  async function customFetch<TSchema extends StandardSchemaV1>(\n    resource: string,\n    schema: TSchema,\n    options?: ExtendedRequestInit\n  ): Promise<\n    | StandardSchemaV1.InferOutput<TSchema>\n    | StandardSchemaV1.Result<StandardSchemaV1.InferOutput<TSchema>>\n  >;\n\n  async function customFetch(\n    resource: string,\n    options?: ExtendedRequestInit\n  ): Promise<Response>;\n\n  async function customFetch(\n    resource: string,\n    schemaOrOptions?: StandardSchemaV1 | ExtendedRequestInit,\n    optionsOrUndefined?: ExtendedRequestInit\n  ): Promise<unknown> {\n    const [schema, options] = isStandardSchema(schemaOrOptions)\n      ? [schemaOrOptions, optionsOrUndefined]\n      : [undefined, schemaOrOptions];\n\n    return await fetchInternal(resource, schema, options, defaults);\n  }\n\n  const customApi = {\n    get: createMethod(customFetch, \"GET\"),\n    post: createMethod(customFetch, \"POST\"),\n    put: createMethod(customFetch, \"PUT\"),\n    patch: createMethod(customFetch, \"PATCH\"),\n    delete: createMethod(customFetch, \"DELETE\"),\n  };\n\n  return {\n    $fetch: customFetch,\n    api: customApi,\n  };\n}\n"],"mappings":";;;;;;;AAKA,MAAaA,kBAAiC;CAC5C,SAAS;CACT,SAAS;CACT,mBAAmB;CACnB,wBAAwB;CACzB;;;;;;;;;;;;;;;;;;;;ACWD,SAAgB,aACd,MACA,UACqB;AACrB,KAAI,EAAE,QAAQ,UACZ;CAGF,MAAM,SAAS,IAAI,QAAQ,KAAK;AAChC,KAAI,UAAU;EACZ,MAAM,kBAAkB,IAAI,QAAQ,SAAS;AAC7C,OAAK,MAAM,CAAC,KAAK,UAAU,gBAAgB,SAAS,CAClD,QAAO,IAAI,KAAK,MAAM;;AAG1B,QAAO;;;;;AAMT,SAAS,oBAAoB,KAAqB;CAChD,IAAI,MAAM,IAAI;AACd,QAAO,MAAM,KAAK,IAAI,MAAM,OAAO,IACjC,QAAO;AAET,QAAO,IAAI,MAAM,GAAG,IAAI;;;;;AAM1B,SAAS,mBAAmB,KAAqB;CAC/C,IAAI,QAAQ;AACZ,QAAO,QAAQ,IAAI,UAAU,IAAI,WAAW,IAC1C,UAAS;AAEX,QAAO,IAAI,MAAM,MAAM;;AAGzB,MAAM,uBAAuB;;;;AAK7B,SAAS,cAAc,KAAsB;AAC3C,QAAO,qBAAqB,KAAK,IAAI;;;;;AAMvC,eAAsB,cACpB,UACA,QACA,SACA,UACkB;CAClB,MAAM,EACJ,yBAAyB,SAAS,wBAClC,oBAAoB,SAAS,mBAC7B,SAAS,gBACT,GAAG,SACD,WAAW,EAAE;CAEjB,MAAM,gBAAgB,aAAa,SAAS,SAAS,eAAe;CACpE,MAAM,OAAO;EAAE,GAAG;EAAM,SAAS;EAAe;AAGhD,KAAI,UAAU,KAAK,MAAM;AACvB,OAAK,OAAO,KAAK,UAAU,KAAK,KAAK;EAErC,MAAM,kBAAkB,IAAI,QAAQ,KAAK,QAAQ;AACjD,MAAI,CAAC,gBAAgB,IAAI,eAAe,CACtC,iBAAgB,IAAI,gBAAgB,mBAAmB;AAGzD,OAAK,UAAU;;CAIjB,IAAIC;AACJ,KAAI,cAAc,SAAS,CACzB,OAAM;MACD;EAEL,MAAM,OAAO,oBAAoB,SAAS,QAAQ;EAClD,MAAM,OAAO,mBAAmB,SAAS;AACzC,QAAM,OAAO,GAAG,KAAK,GAAG,SAAS;;CAGnC,MAAM,WAAW,MAAM,MAAM,KAAK,KAAK;AAEvC,KAAI,qBAAqB,CAAC,SAAS,GACjC,OAAM,IAAI,WACR,QAAQ,SAAS,OAAO,IAAI,SAAS,cACrC,SACD;AAIH,KAAI,OAEF,QAAO,iBAAiB,QADZ,MAAM,SAAS,MAAM,EACI,uBAAuB;AAI9D,QAAO;;;;;AAMT,SAAgB,aACd,SACA,QACQ;AACR,SACE,UACA,QACA,YACG,QAAQ,UAAU,QAAQ;EAAE,GAAG;EAAS;EAAQ,CAAC;;;;;AChFxD,eAAsB,OACpB,UACA,iBACA,oBACkB;CAClB,MAAM,CAAC,QAAQ,WAAW,iBAAiB,gBAAgB,GACvD,CAAC,iBAAiB,mBAAmB,GACrC,CAAC,QAAW,gBAAgB;AAEhC,QAAO,MAAM,cAAc,UAAU,QAAQ,SAAS,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;AAwBxE,MAAaC,MAAkB;CAC7B,KAAK,aAAa,QAAQ,MAAM;CAChC,MAAM,aAAa,QAAQ,OAAO;CAClC,KAAK,aAAa,QAAQ,MAAM;CAChC,OAAO,aAAa,QAAQ,QAAQ;CACpC,QAAQ,aAAa,QAAQ,SAAS;CACvC;;;;;;;;;;;;;;;;;;;;;;;;;AA0BD,SAAgB,YAAY,iBAAqC,EAAE,EAGjE;CACA,MAAMC,WAA0B;EAC9B,SAAS,eAAe,WAAW;EACnC,SAAS,eAAe;EACxB,mBAAmB,eAAe,qBAAqB;EACvD,wBAAwB,eAAe,0BAA0B;EAClE;CAgBD,eAAe,YACb,UACA,iBACA,oBACkB;EAClB,MAAM,CAAC,QAAQ,WAAW,iBAAiB,gBAAgB,GACvD,CAAC,iBAAiB,mBAAmB,GACrC,CAAC,QAAW,gBAAgB;AAEhC,SAAO,MAAM,cAAc,UAAU,QAAQ,SAAS,SAAS;;AAWjE,QAAO;EACL,QAAQ;EACR,KAVgB;GAChB,KAAK,aAAa,aAAa,MAAM;GACrC,MAAM,aAAa,aAAa,OAAO;GACvC,KAAK,aAAa,aAAa,MAAM;GACrC,OAAO,aAAa,aAAa,QAAQ;GACzC,QAAQ,aAAa,aAAa,SAAS;GAC5C;EAKA"}
+{"version":3,"file":"index.mjs","names":["GLOBAL_DEFAULTS: FetchDefaults","hash","url: string","api: ApiMethods","defaults: FetchDefaults"],"sources":["../src/internal/constants.ts","../src/internal/utils.ts","../src/index.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","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { FetchError } from \"../errors\";\nimport type {\n  $Fetch,\n  ExtendedRequestInit,\n  FetchDefaults,\n  SearchParams,\n} from \"../types\";\nimport { isStandardSchema, standardValidate } from \"../validator\";\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    return standardValidate(schema, raw, throwOnValidationError);\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","import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { GLOBAL_DEFAULTS } from \"./internal/constants\";\nimport { createMethod, fetchInternal } from \"./internal/utils\";\nimport type {\n  $Fetch,\n  ApiMethods,\n  CreateFetchOptions,\n  ExtendedRequestInit,\n  FetchDefaults,\n} from \"./types\";\nimport { isStandardSchema } from \"./validator\";\n\n/**\n * Type-safe fetch wrapper with Standard Schema validation.\n *\n * - When `throwOnValidationError: true`: validated data of type `TSchema`\n * - When `throwOnValidationError: false`: Standard Schema Result object `{ value?, issues? }`\n * - When `throwOnFetchError: true`: throws `FetchError` on non-ok responses\n *\n * If no schema is provided, returns the raw `Response` object.\n *\n * @throws {FetchError} When `throwOnFetchError: true` and response is not ok\n * @throws {ValidationError} When `throwOnValidationError: true` and validation fails\n *\n * @example\n * import { z } from \"zod\";\n * import { $fetch } from \"@zap-studio/fetch\";\n *\n * const UserSchema = z.object({ id: z.number(), name: z.string() });\n *\n * // Basic usage (schema validation)\n * const user = await $fetch(\"/api/users/1\", UserSchema, { headers: { \"Authorization\": \"Bearer token\" } });\n * console.log(\"Validated user:\", user);\n *\n * // Raw usage (no schema validation and typed Response object)\n * const result = await $fetch(\"/api/data\", { method: \"POST\", body: JSON.stringify({ key: \"value\" }) });\n * const json = await result.json() as ResultType;\n * console.log(\"Raw response data:\", json);\n *\n * // Usage with validation errors returned instead of thrown\n * const result = await $fetch(\"/api/users/1\", UserSchema, { throwOnValidationError: false });\n *\n * if (result.issues) {\n *   console.error(\"Validation errors:\", result.issues);\n * } else {\n *   console.log(\"Validated user:\", result.value);\n * }\n */\nexport async function $fetch<TSchema extends StandardSchemaV1>(\n  resource: string,\n  schema: TSchema,\n  options: ExtendedRequestInit<false>\n): Promise<StandardSchemaV1.Result<StandardSchemaV1.InferOutput<TSchema>>>;\n\nexport async function $fetch<TSchema extends StandardSchemaV1>(\n  resource: string,\n  schema: TSchema,\n  options?: ExtendedRequestInit<true | undefined>\n): Promise<StandardSchemaV1.InferOutput<TSchema>>;\n\nexport async function $fetch(\n  resource: string,\n  options?: ExtendedRequestInit\n): Promise<Response>;\n\nexport async function $fetch(\n  resource: string,\n  schemaOrOptions?: StandardSchemaV1 | ExtendedRequestInit,\n  optionsOrUndefined?: ExtendedRequestInit\n): Promise<unknown> {\n  const [schema, options] = isStandardSchema(schemaOrOptions)\n    ? [schemaOrOptions, optionsOrUndefined]\n    : [undefined, schemaOrOptions];\n\n  return await fetchInternal(resource, schema, options, GLOBAL_DEFAULTS);\n}\n\n/**\n * Convenience methods for common HTTP verbs.\n *\n * These methods always require a schema for validation.\n * For raw responses without validation, use `$fetch` directly.\n *\n * @example\n * import { z } from \"zod\";\n * import { api } from \"@zap-studio/fetch\";\n *\n * const PostSchema = z.object({\n *   id: z.number(),\n *   title: z.string(),\n *   content: z.string(),\n * });\n *\n * async function fetchPost(postId: number) {\n *   const post = await api.get(`https://api.example.com/posts/${postId}`, PostSchema);\n *   return post; // post is typed as { id: number; title: string; content: string; }\n * }\n */\nexport const api: ApiMethods = {\n  get: createMethod($fetch, \"GET\"),\n  post: createMethod($fetch, \"POST\"),\n  put: createMethod($fetch, \"PUT\"),\n  patch: createMethod($fetch, \"PATCH\"),\n  delete: createMethod($fetch, \"DELETE\"),\n};\n\n/**\n * Creates a custom fetch instance with pre-configured defaults.\n *\n * Use this factory to create API clients with a base URL, default headers,\n * and other shared configuration. Each instance is independent.\n *\n * @example\n * import { z } from \"zod\";\n * import { createFetch } from \"@zap-studio/fetch\";\n *\n * // Create a configured instance\n * const { $fetch, api } = createFetch({\n *   baseURL: \"https://api.example.com\",\n *   headers: { \"Authorization\": \"Bearer token\" },\n * });\n *\n * const UserSchema = z.object({ id: z.number(), name: z.string() });\n *\n * // Now use relative paths - baseURL is prepended automatically\n * const user = await api.get(\"/users/1\", UserSchema);\n *\n * // Or use $fetch directly\n * const response = await $fetch(\"/users\", UserSchema, { method: \"POST\", body: { name: \"John\" } });\n */\nexport function createFetch(factoryOptions: CreateFetchOptions = {}): {\n  $fetch: $Fetch;\n  api: ApiMethods;\n} {\n  const defaults: FetchDefaults = {\n    baseURL: factoryOptions.baseURL ?? \"\",\n    headers: factoryOptions.headers,\n    searchParams: factoryOptions.searchParams,\n    throwOnFetchError: factoryOptions.throwOnFetchError ?? true,\n    throwOnValidationError: factoryOptions.throwOnValidationError ?? true,\n  };\n\n  async function customFetch<TSchema extends StandardSchemaV1>(\n    resource: string,\n    schema: TSchema,\n    options: ExtendedRequestInit<false>\n  ): Promise<StandardSchemaV1.Result<StandardSchemaV1.InferOutput<TSchema>>>;\n\n  async function customFetch<TSchema extends StandardSchemaV1>(\n    resource: string,\n    schema: TSchema,\n    options?: ExtendedRequestInit<true | undefined>\n  ): Promise<StandardSchemaV1.InferOutput<TSchema>>;\n\n  async function customFetch(\n    resource: string,\n    options?: ExtendedRequestInit\n  ): Promise<Response>;\n\n  async function customFetch(\n    resource: string,\n    schemaOrOptions?: StandardSchemaV1 | ExtendedRequestInit,\n    optionsOrUndefined?: ExtendedRequestInit\n  ): Promise<unknown> {\n    const [schema, options] = isStandardSchema(schemaOrOptions)\n      ? [schemaOrOptions, optionsOrUndefined]\n      : [undefined, schemaOrOptions];\n\n    return await fetchInternal(resource, schema, options, defaults);\n  }\n\n  const customApi = {\n    get: createMethod(customFetch, \"GET\"),\n    post: createMethod(customFetch, \"POST\"),\n    put: createMethod(customFetch, \"PUT\"),\n    patch: createMethod(customFetch, \"PATCH\"),\n    delete: createMethod(customFetch, \"DELETE\"),\n  };\n\n  return {\n    $fetch: customFetch,\n    api: customApi,\n  };\n}\n"],"mappings":"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"}

package/dist/{types-BB4ejGeA.d.mts → types-CvCrPMIR.d.mts}

@@ -3,23 +3,40 @@ import { StandardSchemaV1 } from "@standard-schema/spec";
 //#region src/types.d.ts
 
 /**
-* Extended RequestInit type to include custom fetch options
+* 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 ExtendedRequestInit = Omit<RequestInit, "body"> & {
+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?: boolean;
+  throwOnValidationError?: TThrowOnValidationError;
 };
 /**
 * Internal defaults used by fetchInternal
@@ -31,10 +48,15 @@ type FetchDefaults = {
   */
   baseURL: string;
   /**
-  * Default headers to include in all requests
+  * 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
   */
-  headers: HeadersInit | undefined;
+  searchParams?: SearchParams;
   /**
   * Whether to throw a `FetchError` on HTTP errors (non-2xx responses)
   * @default true
@@ -55,13 +77,21 @@ type CreateFetchOptions = Partial<FetchDefaults>;
 */
 type $Fetch = {
   /**
-  * Fetch with schema validation
+  * 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 or Standard Schema Result based on throwOnValidationError option
+  * @returns Validated data of type TSchema
   */
-  <TSchema extends StandardSchemaV1>(resource: string, schema: TSchema, options?: ExtendedRequestInit): Promise<StandardSchemaV1.InferOutput<TSchema> | StandardSchemaV1.Result<StandardSchemaV1.InferOutput<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
@@ -96,5 +126,5 @@ type ApiMethods = {
   patch: $Fetch;
 };
 //#endregion
-export { FetchDefaults as a, ExtendedRequestInit as i, ApiMethods as n, CreateFetchOptions as r, $Fetch as t };
-//# sourceMappingURL=types-BB4ejGeA.d.mts.map
+export { FetchDefaults as a, ExtendedRequestInit as i, ApiMethods as n, SearchParams as o, CreateFetchOptions as r, $Fetch as t };
+//# sourceMappingURL=types-CvCrPMIR.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types-CvCrPMIR.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/types.d.mts

@@ -1,2 +1,2 @@
-import { a as FetchDefaults, i as ExtendedRequestInit, n as ApiMethods, r as CreateFetchOptions, t as $Fetch } from "./types-BB4ejGeA.mjs";
-export { $Fetch, ApiMethods, CreateFetchOptions, ExtendedRequestInit, FetchDefaults };
+import { a as FetchDefaults, i as ExtendedRequestInit, n as ApiMethods, o as SearchParams, r as CreateFetchOptions, t as $Fetch } from "./types-CvCrPMIR.mjs";
+export { $Fetch, ApiMethods, CreateFetchOptions, ExtendedRequestInit, FetchDefaults, SearchParams };

package/dist/validator.mjs

@@ -1,4 +1,3 @@
-import "./errors-DKxnbFHZ.mjs";
 import { n as standardValidate, t as isStandardSchema } from "./validator-BGjWrM4d.mjs";
 
 export { isStandardSchema, standardValidate };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zap-studio/fetch",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "type": "module",
   "license": "MIT",
   "private": false,
@@ -17,13 +17,13 @@
   },
   "devDependencies": {
     "@types/node": "^24.10.1",
-    "@vitest/coverage-v8": "^4.0.14",
-    "arktype": "^2.1.27",
+    "@vitest/coverage-v8": "^4.0.15",
+    "arktype": "^2.1.28",
     "jsdom": "^27.2.0",
-    "tsdown": "^0.17.0-beta.4",
+    "tsdown": "0.17.0-beta.6",
     "typescript": "^5.9.3",
     "valibot": "^1.2.0",
-    "vitest": "^4.0.14",
+    "vitest": "^4.0.15",
     "zod": "^4.1.13",
     "@zap-studio/tsdown-config": "0.0.0",
     "@zap-studio/typescript-config": "0.0.0",

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

@@ -1 +0,0 @@
-{"version":3,"file":"types-BB4ejGeA.d.mts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;;AAKA;AAAuC,KAA3B,mBAAA,GAAsB,IAAK,CAAA,WAAA,EAAA,MAAA,CAAA,GAAA;EAAL;;;EAId,IAAA,CAAA,EAAX,QAAW,GAAA,MAAA,CAAA,MAAA,EAAA,OAAA,CAAA;EAgBpB;AA0BA;AAKA;;EAUY,iBAAA,CAAA,EAAA,OAAA;EACE;;;;EAGgB,sBAAiB,CAAA,EAAA,OAAA;CAAzC;;;;AAS+C,KAtDzC,aAAA,GAsDyC;EAAA;AAMrD;;;EAYO,OAAA,EAAA,MAAA;EAIG;;;;WAlEC;;;;;;;;;;;;;;;KAgBC,kBAAA,GAAqB,QAAQ;;;;KAK7B,MAAA;;;;;;;;mBAQO,4CAEP,mBACE,sBACT,QACC,gBAAA,CAAiB,YAAY,WAC7B,gBAAA,CAAiB,OAAO,gBAAA,CAAiB,YAAY;;;;;;;+BAS5B,sBAAsB,QAAQ;;;;;KAMjD,UAAA;;;;OAIL;;;;QAIC;;;;OAID;;;;UAIG;;;;SAID"}