@zap-studio/fetch 0.4.2 → 0.4.3

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @zap-studio/fetch
 
+## 0.4.3
+
+### Patch Changes
+
+- e4542bb: Refine `standardValidate` typings so the return type depends on the `throwOnError` flag, and update `@zap-studio/fetch` to integrate with the new overloads while preserving its boolean configuration API.
+- Updated dependencies [e4542bb]
+  - @zap-studio/validation@0.2.1
+
 ## 0.4.2
 
 ### Patch Changes

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-lwSqouPn.mjs";
+import { n as fetchInternal, t as createMethod } from "./utils-C1YvgnKM.mjs";
 import { isStandardSchema } from "@zap-studio/validation";
 
 //#region src/index.ts

package/dist/{utils-lwSqouPn.mjs → utils-C1YvgnKM.mjs}

@@ -153,7 +153,11 @@ async function fetchInternal(resource, schema, options, defaults) {
 	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);
+	if (schema) {
+		const raw = await response.json();
+		if (throwOnValidationError) return standardValidate(schema, raw, true);
+		return standardValidate(schema, raw, false);
+	}
 	return response;
 }
 /**
@@ -172,4 +176,4 @@ function createMethod(fetchFn, method) {
 
 //#endregion
 export { fetchInternal as n, mergeHeaders as r, createMethod as t };
-//# sourceMappingURL=utils-lwSqouPn.mjs.map
+//# sourceMappingURL=utils-C1YvgnKM.mjs.map

package/dist/{utils-lwSqouPn.mjs.map → utils-C1YvgnKM.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"utils-lwSqouPn.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    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"],"mappings":"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"}
+{"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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"}

package/dist/utils.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.mts","names":[],"sources":["../src/utils.ts"],"sourcesContent":[],"mappings":";;;;;;;AA0BA;;;;;AAyLA;;;;;;AAqEA;;;AAGG,iBAjQa,YAAA,CAiQb,IAAA,EAhQK,WAgQL,GAAA,SAAA,EAAA,QAAA,EA/PS,WA+PT,GAAA,SAAA,CAAA,EA9PA,OA8PA,GAAA,SAAA;;;;iBAxEmB,aAAA,2BAEZ,uCACC,2CACC,gBACT;;;;iBAgEa,4BAA4B,iBACjC,yBAER"}
+{"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"}

package/dist/utils.mjs

@@ -1,3 +1,3 @@
-import { n as fetchInternal, r as mergeHeaders, t as createMethod } from "./utils-lwSqouPn.mjs";
+import { n as fetchInternal, r as mergeHeaders, t as createMethod } from "./utils-C1YvgnKM.mjs";
 
 export { createMethod, fetchInternal, mergeHeaders };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zap-studio/fetch",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "type": "module",
   "license": "MIT",
   "private": false,
@@ -39,7 +39,7 @@
   ],
   "dependencies": {
     "@standard-schema/spec": "^1.1.0",
-    "@zap-studio/validation": "0.2.0"
+    "@zap-studio/validation": "0.2.1"
   },
   "devDependencies": {
     "@types/node": "^25.0.2",
@@ -51,8 +51,8 @@
     "vitest": "^4.0.15",
     "zod": "^4.2.0",
     "@zap-studio/vitest-config": "0.0.0",
-    "@zap-studio/typescript-config": "0.0.0",
-    "@zap-studio/tsdown-config": "0.0.0"
+    "@zap-studio/tsdown-config": "0.0.0",
+    "@zap-studio/typescript-config": "0.0.0"
   },
   "exports": {
     ".": "./dist/index.mjs",