@openapi-qraft/react 1.13.1 → 1.14.0-beta.2

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # @openapi-qraft/react
 
+## 1.14.0-beta.2
+
+## 1.14.0-beta.0
+
 ## 1.13.1
 
 ## 1.13.0

package/dist/cjs/lib/requestFn.cjs

@@ -56,7 +56,21 @@
     }
     return await getResponseBody(clonedResponse);
 }
-function urlSerializer(schema, info) {
+/**
+ * Serializes the given schema and request payload into a URL string.
+ *
+ * This function is implemented according to the URI Template standard
+ * defined in RFC 6570. It supports the expansion of path and query parameters,
+ * correctly handling empty arrays, `null`, and `undefined` values by ignoring
+ * them during the expansion process, as specified by the standard.
+ *
+ * For more information, refer to the official documentation:
+ * https://datatracker.ietf.org/doc/html/rfc6570
+ *
+ * @param schema - The operation schema containing the URL template and method.
+ * @param info - The request payload including baseUrl, path parameters, and query parameters.
+ * @returns The fully constructed URL string.
+ */ function urlSerializer(schema, info) {
     const path = schema.url.replace(/{(.*?)}/g, (substring, group)=>{
         if (info.parameters?.path && Object.prototype.hasOwnProperty.call(info.parameters.path, group)) {
             return encodeURI(String(info.parameters?.path[group]));

package/dist/cjs/lib/requestFn.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"requestFn.cjs","sources":["../../../src/lib/requestFn.ts"],"sourcesContent":["/**\n * This function is used to make a request to a specified endpoint.\n *\n * @template T The expected return type of the request.\n *\n * @param schema The schema of the operation to be performed. It includes the OpenAPI path, HTTP method and media type.\n * @param requestInfo The information required to make the request. It includes parameters, headers, body, etc.\n * @param [options] Optional. Additional options for the request. It includes custom urlSerializer, bodySerializer, and fetch function.\n *\n * @returns {Promise<T>} Returns a promise that resolves with the response of the request.\n *\n * @throws {error: object|string, response: Response} Throws an error if the request fails. The error includes the error message and the response from the server.\n */\nexport async function requestFn<T>(\n  schema: OperationSchema,\n  requestInfo: RequestFnInfo,\n  options?: RequestFnOptions\n): Promise<T> {\n  return baseRequestFn(schema, requestInfo, {\n    urlSerializer,\n    bodySerializer,\n    ...options,\n  });\n}\n\n/**\n * This function is used to make a request to a specified endpoint.\n * It's needed to create a custom `requestFn` with a custom `urlSerializer`\n * and `bodySerializer`, with the tree-shaking of the default `requestFn`\n * and its serializers.\n *\n * @template T The expected return type of the request.\n *\n * @param requestSchema The schema of the operation to be performed. It includes the OpenAPI path, HTTP method and media type.\n * @param requestInfo The information required to make the request. It includes parameters, headers, body, etc.\n * @param options The options for the request. It includes urlSerializer, bodySerializer, and fetch function. The 'urlSerializer' and 'bodySerializer' are required.\n *\n * @returns {Promise<T>} Returns a promise that resolves with the response of the request.\n *\n * @throws {error: object|string, response: Response} Throws an error if the request fails. The error includes the error message and the response from the server.\n */\nexport async function baseRequestFn<T>(\n  requestSchema: OperationSchema,\n  requestInfo: RequestFnInfo,\n  options: WithRequired<RequestFnOptions, 'urlSerializer' | 'bodySerializer'>\n): Promise<T> {\n  const { parameters, headers, body, ...requestInfoRest } = requestInfo;\n\n  const requestBody = options.bodySerializer(requestSchema, requestInfo);\n\n  const baseFetch = options.fetch ?? fetch;\n\n  const response = await baseFetch(\n    options.urlSerializer(requestSchema, requestInfo),\n    {\n      method: requestSchema.method.toUpperCase(),\n      body: requestBody,\n      headers: mergeHeaders(\n        {\n          Accept: 'application/json',\n          'Content-Type': requestSchema.mediaType ?? getBodyContentType(body),\n        },\n        headers,\n        parameters?.header,\n        requestBody instanceof FormData\n          ? // remove `Content-Type` if serialized body is FormData; browser will correctly set Content-Type & boundary expression\n            { 'Content-Type': null }\n          : undefined\n      ),\n      ...requestInfoRest,\n    }\n  );\n\n  // clone response to allow multiple reads\n  const clonedResponse = response.clone();\n\n  if (!response.ok) {\n    throw await getResponseBody(clonedResponse);\n  }\n\n  return (await getResponseBody(clonedResponse)) as T;\n}\n\nexport function urlSerializer(\n  schema: OperationSchema,\n  info: RequestFnPayload\n): string {\n  const path = schema.url.replace(\n    /{(.*?)}/g,\n    (substring: string, group: string) => {\n      if (\n        info.parameters?.path &&\n        Object.prototype.hasOwnProperty.call(info.parameters.path, group)\n      ) {\n        return encodeURI(String(info.parameters?.path[group]));\n      }\n      return substring;\n    }\n  );\n\n  const baseUrl = info.baseUrl ?? '';\n\n  if (info.parameters?.query) {\n    return `${baseUrl}${path}${getQueryString(info.parameters.query)}`;\n  }\n\n  return `${baseUrl}${path}`;\n}\n\nfunction getQueryString(params: Record<string, any>): string {\n  const qs: string[] = [];\n\n  const append = (key: string, value: any) => {\n    qs.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);\n  };\n\n  const process = (key: string, value: any) => {\n    if (typeof value === 'undefined' || value === null) return;\n\n    if (Array.isArray(value)) {\n      value.forEach((v) => {\n        process(key, v);\n      });\n    } else if (typeof value === 'object') {\n      Object.entries(value).forEach(([k, v]) => {\n        process(`${key}[${k}]`, v);\n      });\n    } else {\n      append(key, value);\n    }\n  };\n\n  Object.entries(params).forEach(([key, value]) => {\n    process(key, value);\n  });\n\n  if (qs.length > 0) {\n    return `?${qs.join('&')}`;\n  }\n\n  return '';\n}\n\nexport function mergeHeaders(...allHeaders: (HeadersOptions | undefined)[]) {\n  const headers = new Headers();\n\n  for (const headerSet of allHeaders) {\n    if (!headerSet || typeof headerSet !== 'object') {\n      continue;\n    }\n\n    const headersIterator =\n      headerSet instanceof Headers\n        ? headerSet.entries()\n        : Object.entries(headerSet);\n\n    for (const [headerKey, headerValue] of headersIterator) {\n      if (headerValue === null) {\n        headers.delete(headerKey);\n      } else if (headerValue !== undefined) {\n        headers.set(headerKey, headerValue);\n      }\n    }\n  }\n\n  return headers;\n}\n\nexport function bodySerializer(\n  schema: OperationSchema,\n  info: RequestFnPayload\n) {\n  if (info.body === undefined) return;\n\n  if (\n    schema.method === 'get' ||\n    schema.method === 'head' ||\n    schema.method === 'options'\n  )\n    return;\n\n  if (schema.mediaType?.includes('/form-data'))\n    return getRequestBodyFormData(info);\n\n  if (\n    !schema.mediaType?.includes('/json') &&\n    (typeof info.body === 'string' ||\n      info.body instanceof Blob ||\n      info.body instanceof FormData)\n  ) {\n    return info.body;\n  }\n\n  return JSON.stringify(info.body);\n}\n\nfunction getRequestBodyFormData({\n  body,\n}: Pick<RequestFnPayload, 'body'>): FormData | undefined {\n  if (body instanceof FormData) return body;\n  if (body === null) return;\n\n  if (body instanceof Blob) throw new Error('Blob not supported in form-data');\n  if (body instanceof ArrayBuffer)\n    throw new Error('ArrayBuffer not supported in form-data');\n  if (body instanceof URLSearchParams)\n    throw new Error('URLSearchParams not supported in form-data');\n  if (body instanceof ReadableStream)\n    throw new Error('ReadableStream not supported in form-data');\n  if (typeof body === 'string')\n    throw new Error('String not supported in form-data');\n  if (typeof body !== 'object')\n    throw new Error(`Unsupported body type ${typeof body} in form-data.`);\n\n  const formData = new FormData();\n\n  const process = (key: string, value: any) => {\n    if (typeof value === 'string' || value instanceof Blob) {\n      formData.append(key, value);\n    } else {\n      formData.append(key, JSON.stringify(value));\n    }\n  };\n\n  Object.entries(body)\n    .filter(([_, value]) => typeof value !== 'undefined' && value !== null)\n    .forEach(([key, value]) => {\n      if (Array.isArray(value)) {\n        value.forEach((v) => process(key, v));\n      } else {\n        process(key, value);\n      }\n    });\n\n  return formData;\n}\n\nfunction getBodyContentType(body: RequestFnPayload['body']) {\n  if (!body) return;\n  if (body instanceof Blob) return body.type || 'application/octet-stream';\n  if (typeof body === 'string') return 'text/plain';\n  if (!(body instanceof FormData)) return 'application/json';\n}\n\nasync function getResponseBody<T>(response: Response): Promise<T | undefined> {\n  if (response.status === 204 || response.headers.get('Content-Length') === '0')\n    return undefined;\n\n  const contentType = response.headers.get('Content-Type')?.toLowerCase();\n  const isJSON =\n    contentType?.includes('/json') || contentType?.includes('+json');\n\n  if (isJSON) {\n    // attempt to parse JSON for successful responses, otherwise fail\n    if (response.ok) return response.json();\n\n    const errorFallbackResponse = response.clone(); // clone to allow multiple reads\n\n    return response.json().catch(() => {\n      if (process.env.NODE_ENV === 'development') {\n        console.warn(\n          'Failed to parse response body as JSON. Falling back to .text()'\n        );\n      }\n      // falling back to .text() when necessary for error messages\n      return errorFallbackResponse.text();\n    });\n  }\n\n  return response.text() as Promise<T>;\n}\n\n// To have definitely typed headers without a conversion to stings\nexport type HeadersOptions =\n  | HeadersInit\n  | Record<string, string | number | boolean | null | undefined>;\n\nexport interface OperationSchema {\n  /**\n   * Operation path\n   * @example /user/{id}\n   */\n  readonly url: string; //todo::rename to `path`\n\n  /**\n   * Operation method\n   */\n  readonly method:\n    | 'get'\n    | 'put'\n    | 'post'\n    | 'patch'\n    | 'delete'\n    | 'options'\n    | 'head'\n    | 'trace';\n\n  /**\n   * Media type of the request body\n   * @example application/json\n   */\n  readonly mediaType?: string;\n\n  readonly security?: string[];\n}\n\nexport interface RequestFnPayload {\n  /**\n   * Base URL to use for the request\n   * @example 'https://api.example.com'\n   */\n  baseUrl: string | undefined;\n\n  /**\n   * OpenAPI parameters\n   * @example\n   * ```ts\n   * { path: {id: 1}, query: {search: 'hello'} }\n   * ```\n   */\n  readonly parameters?: {\n    readonly path?: Record<string, any>;\n    readonly header?: Record<string, any>;\n    readonly query?: Record<string, any>;\n  };\n\n  /**\n   * Request body\n   * @example { name: 'John' }\n   */\n  readonly body?: BodyInit | Record<string, unknown> | null;\n\n  /**\n   * Tanstack Query Meta\n   */\n  meta?: Record<string, unknown>;\n\n  /** An AbortSignal to set request's signal. */\n  signal?: AbortSignal | null;\n}\n\nexport interface RequestFnInfo\n  extends RequestFnPayload,\n    Omit<RequestInit, 'headers' | 'method' | 'body' | 'signal'> {\n  /**\n   * Request headers\n   * @example { 'X-Auth': '123' }\n   */\n  readonly headers?: HeadersOptions;\n}\n\nexport interface RequestFnOptions {\n  urlSerializer?: typeof urlSerializer;\n  bodySerializer?: typeof bodySerializer;\n  fetch?: typeof fetch;\n}\n\nexport type RequestFn<T> = typeof requestFn<T>;\n\ntype WithRequired<T, K extends keyof T> = T & {\n  [_ in K]: {};\n};\n"],"names":["requestFn","schema","requestInfo","options","baseRequestFn","urlSerializer","bodySerializer","requestSchema","parameters","headers","body","requestInfoRest","requestBody","baseFetch","fetch","response","method","toUpperCase","mergeHeaders","Accept","mediaType","getBodyContentType","header","FormData","undefined","clonedResponse","clone","ok","getResponseBody","info","path","url","replace","substring","group","Object","prototype","hasOwnProperty","call","encodeURI","String","baseUrl","query","getQueryString","params","qs","append","key","value","push","encodeURIComponent","process","Array","isArray","forEach","v","entries","k","length","join","allHeaders","Headers","headerSet","headersIterator","headerKey","headerValue","delete","set","includes","getRequestBodyFormData","Blob","JSON","stringify","Error","ArrayBuffer","URLSearchParams","ReadableStream","formData","filter","_","type","status","get","contentType","toLowerCase","isJSON","json","errorFallbackResponse","catch","env","NODE_ENV","console","warn","text"],"mappings":"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"}
+{"version":3,"file":"requestFn.cjs","sources":["../../../src/lib/requestFn.ts"],"sourcesContent":["/**\n * This function is used to make a request to a specified endpoint.\n *\n * @template T The expected return type of the request.\n *\n * @param schema The schema of the operation to be performed. It includes the OpenAPI path, HTTP method and media type.\n * @param requestInfo The information required to make the request. It includes parameters, headers, body, etc.\n * @param [options] Optional. Additional options for the request. It includes custom urlSerializer, bodySerializer, and fetch function.\n *\n * @returns {Promise<T>} Returns a promise that resolves with the response of the request.\n *\n * @throws {error: object|string, response: Response} Throws an error if the request fails. The error includes the error message and the response from the server.\n */\nexport async function requestFn<T>(\n  schema: OperationSchema,\n  requestInfo: RequestFnInfo,\n  options?: RequestFnOptions\n): Promise<T> {\n  return baseRequestFn(schema, requestInfo, {\n    urlSerializer,\n    bodySerializer,\n    ...options,\n  });\n}\n\n/**\n * This function is used to make a request to a specified endpoint.\n * It's needed to create a custom `requestFn` with a custom `urlSerializer`\n * and `bodySerializer`, with the tree-shaking of the default `requestFn`\n * and its serializers.\n *\n * @template T The expected return type of the request.\n *\n * @param requestSchema The schema of the operation to be performed. It includes the OpenAPI path, HTTP method and media type.\n * @param requestInfo The information required to make the request. It includes parameters, headers, body, etc.\n * @param options The options for the request. It includes urlSerializer, bodySerializer, and fetch function. The 'urlSerializer' and 'bodySerializer' are required.\n *\n * @returns {Promise<T>} Returns a promise that resolves with the response of the request.\n *\n * @throws {error: object|string, response: Response} Throws an error if the request fails. The error includes the error message and the response from the server.\n */\nexport async function baseRequestFn<T>(\n  requestSchema: OperationSchema,\n  requestInfo: RequestFnInfo,\n  options: WithRequired<RequestFnOptions, 'urlSerializer' | 'bodySerializer'>\n): Promise<T> {\n  const { parameters, headers, body, ...requestInfoRest } = requestInfo;\n\n  const requestBody = options.bodySerializer(requestSchema, requestInfo);\n\n  const baseFetch = options.fetch ?? fetch;\n\n  const response = await baseFetch(\n    options.urlSerializer(requestSchema, requestInfo),\n    {\n      method: requestSchema.method.toUpperCase(),\n      body: requestBody,\n      headers: mergeHeaders(\n        {\n          Accept: 'application/json',\n          'Content-Type': requestSchema.mediaType ?? getBodyContentType(body),\n        },\n        headers,\n        parameters?.header,\n        requestBody instanceof FormData\n          ? // remove `Content-Type` if serialized body is FormData; browser will correctly set Content-Type & boundary expression\n            { 'Content-Type': null }\n          : undefined\n      ),\n      ...requestInfoRest,\n    }\n  );\n\n  // clone response to allow multiple reads\n  const clonedResponse = response.clone();\n\n  if (!response.ok) {\n    throw await getResponseBody(clonedResponse);\n  }\n\n  return (await getResponseBody(clonedResponse)) as T;\n}\n\n/**\n * Serializes the given schema and request payload into a URL string.\n *\n * This function is implemented according to the URI Template standard\n * defined in RFC 6570. It supports the expansion of path and query parameters,\n * correctly handling empty arrays, `null`, and `undefined` values by ignoring\n * them during the expansion process, as specified by the standard.\n *\n * For more information, refer to the official documentation:\n * https://datatracker.ietf.org/doc/html/rfc6570\n *\n * @param schema - The operation schema containing the URL template and method.\n * @param info - The request payload including baseUrl, path parameters, and query parameters.\n * @returns The fully constructed URL string.\n */\nexport function urlSerializer(\n  schema: OperationSchema,\n  info: RequestFnPayload\n): string {\n  const path = schema.url.replace(\n    /{(.*?)}/g,\n    (substring: string, group: string) => {\n      if (\n        info.parameters?.path &&\n        Object.prototype.hasOwnProperty.call(info.parameters.path, group)\n      ) {\n        return encodeURI(String(info.parameters?.path[group]));\n      }\n      return substring;\n    }\n  );\n\n  const baseUrl = info.baseUrl ?? '';\n\n  if (info.parameters?.query) {\n    return `${baseUrl}${path}${getQueryString(info.parameters.query)}`;\n  }\n\n  return `${baseUrl}${path}`;\n}\n\nfunction getQueryString(params: Record<string, any>): string {\n  const qs: string[] = [];\n\n  const append = (key: string, value: any) => {\n    qs.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);\n  };\n\n  const process = (key: string, value: any) => {\n    if (typeof value === 'undefined' || value === null) return;\n\n    if (Array.isArray(value)) {\n      value.forEach((v) => {\n        process(key, v);\n      });\n    } else if (typeof value === 'object') {\n      Object.entries(value).forEach(([k, v]) => {\n        process(`${key}[${k}]`, v);\n      });\n    } else {\n      append(key, value);\n    }\n  };\n\n  Object.entries(params).forEach(([key, value]) => {\n    process(key, value);\n  });\n\n  if (qs.length > 0) {\n    return `?${qs.join('&')}`;\n  }\n\n  return '';\n}\n\nexport function mergeHeaders(...allHeaders: (HeadersOptions | undefined)[]) {\n  const headers = new Headers();\n\n  for (const headerSet of allHeaders) {\n    if (!headerSet || typeof headerSet !== 'object') {\n      continue;\n    }\n\n    const headersIterator =\n      headerSet instanceof Headers\n        ? headerSet.entries()\n        : Object.entries(headerSet);\n\n    for (const [headerKey, headerValue] of headersIterator) {\n      if (headerValue === null) {\n        headers.delete(headerKey);\n      } else if (headerValue !== undefined) {\n        headers.set(headerKey, headerValue);\n      }\n    }\n  }\n\n  return headers;\n}\n\nexport function bodySerializer(\n  schema: OperationSchema,\n  info: RequestFnPayload\n) {\n  if (info.body === undefined) return;\n\n  if (\n    schema.method === 'get' ||\n    schema.method === 'head' ||\n    schema.method === 'options'\n  )\n    return;\n\n  if (schema.mediaType?.includes('/form-data'))\n    return getRequestBodyFormData(info);\n\n  if (\n    !schema.mediaType?.includes('/json') &&\n    (typeof info.body === 'string' ||\n      info.body instanceof Blob ||\n      info.body instanceof FormData)\n  ) {\n    return info.body;\n  }\n\n  return JSON.stringify(info.body);\n}\n\nfunction getRequestBodyFormData({\n  body,\n}: Pick<RequestFnPayload, 'body'>): FormData | undefined {\n  if (body instanceof FormData) return body;\n  if (body === null) return;\n\n  if (body instanceof Blob) throw new Error('Blob not supported in form-data');\n  if (body instanceof ArrayBuffer)\n    throw new Error('ArrayBuffer not supported in form-data');\n  if (body instanceof URLSearchParams)\n    throw new Error('URLSearchParams not supported in form-data');\n  if (body instanceof ReadableStream)\n    throw new Error('ReadableStream not supported in form-data');\n  if (typeof body === 'string')\n    throw new Error('String not supported in form-data');\n  if (typeof body !== 'object')\n    throw new Error(`Unsupported body type ${typeof body} in form-data.`);\n\n  const formData = new FormData();\n\n  const process = (key: string, value: any) => {\n    if (typeof value === 'string' || value instanceof Blob) {\n      formData.append(key, value);\n    } else {\n      formData.append(key, JSON.stringify(value));\n    }\n  };\n\n  Object.entries(body)\n    .filter(([_, value]) => typeof value !== 'undefined' && value !== null)\n    .forEach(([key, value]) => {\n      if (Array.isArray(value)) {\n        value.forEach((v) => process(key, v));\n      } else {\n        process(key, value);\n      }\n    });\n\n  return formData;\n}\n\nfunction getBodyContentType(body: RequestFnPayload['body']) {\n  if (!body) return;\n  if (body instanceof Blob) return body.type || 'application/octet-stream';\n  if (typeof body === 'string') return 'text/plain';\n  if (!(body instanceof FormData)) return 'application/json';\n}\n\nasync function getResponseBody<T>(response: Response): Promise<T | undefined> {\n  if (response.status === 204 || response.headers.get('Content-Length') === '0')\n    return undefined;\n\n  const contentType = response.headers.get('Content-Type')?.toLowerCase();\n  const isJSON =\n    contentType?.includes('/json') || contentType?.includes('+json');\n\n  if (isJSON) {\n    // attempt to parse JSON for successful responses, otherwise fail\n    if (response.ok) return response.json();\n\n    const errorFallbackResponse = response.clone(); // clone to allow multiple reads\n\n    return response.json().catch(() => {\n      if (process.env.NODE_ENV === 'development') {\n        console.warn(\n          'Failed to parse response body as JSON. Falling back to .text()'\n        );\n      }\n      // falling back to .text() when necessary for error messages\n      return errorFallbackResponse.text();\n    });\n  }\n\n  return response.text() as Promise<T>;\n}\n\n// To have definitely typed headers without a conversion to stings\nexport type HeadersOptions =\n  | HeadersInit\n  | Record<string, string | number | boolean | null | undefined>;\n\nexport interface OperationSchema {\n  /**\n   * Operation path\n   * @example /user/{id}\n   */\n  readonly url: string; //todo::rename to `path`\n\n  /**\n   * Operation method\n   */\n  readonly method:\n    | 'get'\n    | 'put'\n    | 'post'\n    | 'patch'\n    | 'delete'\n    | 'options'\n    | 'head'\n    | 'trace';\n\n  /**\n   * Media type of the request body\n   * @example application/json\n   */\n  readonly mediaType?: string;\n\n  readonly security?: string[];\n}\n\nexport interface RequestFnPayload {\n  /**\n   * Base URL to use for the request\n   * @example 'https://api.example.com'\n   */\n  baseUrl: string | undefined;\n\n  /**\n   * OpenAPI parameters\n   * @example\n   * ```ts\n   * { path: {id: 1}, query: {search: 'hello'} }\n   * ```\n   */\n  readonly parameters?: {\n    readonly path?: Record<string, any>;\n    readonly header?: Record<string, any>;\n    readonly query?: Record<string, any>;\n  };\n\n  /**\n   * Request body\n   * @example { name: 'John' }\n   */\n  readonly body?: BodyInit | Record<string, unknown> | null;\n\n  /**\n   * Tanstack Query Meta\n   */\n  meta?: Record<string, unknown>;\n\n  /** An AbortSignal to set request's signal. */\n  signal?: AbortSignal | null;\n}\n\nexport interface RequestFnInfo\n  extends RequestFnPayload,\n    Omit<RequestInit, 'headers' | 'method' | 'body' | 'signal'> {\n  /**\n   * Request headers\n   * @example { 'X-Auth': '123' }\n   */\n  readonly headers?: HeadersOptions;\n}\n\nexport interface RequestFnOptions {\n  urlSerializer?: typeof urlSerializer;\n  bodySerializer?: typeof bodySerializer;\n  fetch?: typeof fetch;\n}\n\nexport type RequestFn<T> = typeof requestFn<T>;\n\ntype WithRequired<T, K extends keyof T> = T & {\n  [_ in K]: {};\n};\n"],"names":["requestFn","schema","requestInfo","options","baseRequestFn","urlSerializer","bodySerializer","requestSchema","parameters","headers","body","requestInfoRest","requestBody","baseFetch","fetch","response","method","toUpperCase","mergeHeaders","Accept","mediaType","getBodyContentType","header","FormData","undefined","clonedResponse","clone","ok","getResponseBody","info","path","url","replace","substring","group","Object","prototype","hasOwnProperty","call","encodeURI","String","baseUrl","query","getQueryString","params","qs","append","key","value","push","encodeURIComponent","process","Array","isArray","forEach","v","entries","k","length","join","allHeaders","Headers","headerSet","headersIterator","headerKey","headerValue","delete","set","includes","getRequestBodyFormData","Blob","JSON","stringify","Error","ArrayBuffer","URLSearchParams","ReadableStream","formData","filter","_","type","status","get","contentType","toLowerCase","isJSON","json","errorFallbackResponse","catch","env","NODE_ENV","console","warn","text"],"mappings":"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"}

package/dist/esm/lib/requestFn.js

@@ -54,7 +54,21 @@
     }
     return await getResponseBody(clonedResponse);
 }
-function urlSerializer(schema, info) {
+/**
+ * Serializes the given schema and request payload into a URL string.
+ *
+ * This function is implemented according to the URI Template standard
+ * defined in RFC 6570. It supports the expansion of path and query parameters,
+ * correctly handling empty arrays, `null`, and `undefined` values by ignoring
+ * them during the expansion process, as specified by the standard.
+ *
+ * For more information, refer to the official documentation:
+ * https://datatracker.ietf.org/doc/html/rfc6570
+ *
+ * @param schema - The operation schema containing the URL template and method.
+ * @param info - The request payload including baseUrl, path parameters, and query parameters.
+ * @returns The fully constructed URL string.
+ */ function urlSerializer(schema, info) {
     const path = schema.url.replace(/{(.*?)}/g, (substring, group)=>{
         if (info.parameters?.path && Object.prototype.hasOwnProperty.call(info.parameters.path, group)) {
             return encodeURI(String(info.parameters?.path[group]));

package/dist/esm/lib/requestFn.js.map

@@ -1 +1 @@
-{"version":3,"file":"requestFn.js","sources":["../../../src/lib/requestFn.ts"],"sourcesContent":["/**\n * This function is used to make a request to a specified endpoint.\n *\n * @template T The expected return type of the request.\n *\n * @param schema The schema of the operation to be performed. It includes the OpenAPI path, HTTP method and media type.\n * @param requestInfo The information required to make the request. It includes parameters, headers, body, etc.\n * @param [options] Optional. Additional options for the request. It includes custom urlSerializer, bodySerializer, and fetch function.\n *\n * @returns {Promise<T>} Returns a promise that resolves with the response of the request.\n *\n * @throws {error: object|string, response: Response} Throws an error if the request fails. The error includes the error message and the response from the server.\n */\nexport async function requestFn<T>(\n  schema: OperationSchema,\n  requestInfo: RequestFnInfo,\n  options?: RequestFnOptions\n): Promise<T> {\n  return baseRequestFn(schema, requestInfo, {\n    urlSerializer,\n    bodySerializer,\n    ...options,\n  });\n}\n\n/**\n * This function is used to make a request to a specified endpoint.\n * It's needed to create a custom `requestFn` with a custom `urlSerializer`\n * and `bodySerializer`, with the tree-shaking of the default `requestFn`\n * and its serializers.\n *\n * @template T The expected return type of the request.\n *\n * @param requestSchema The schema of the operation to be performed. It includes the OpenAPI path, HTTP method and media type.\n * @param requestInfo The information required to make the request. It includes parameters, headers, body, etc.\n * @param options The options for the request. It includes urlSerializer, bodySerializer, and fetch function. The 'urlSerializer' and 'bodySerializer' are required.\n *\n * @returns {Promise<T>} Returns a promise that resolves with the response of the request.\n *\n * @throws {error: object|string, response: Response} Throws an error if the request fails. The error includes the error message and the response from the server.\n */\nexport async function baseRequestFn<T>(\n  requestSchema: OperationSchema,\n  requestInfo: RequestFnInfo,\n  options: WithRequired<RequestFnOptions, 'urlSerializer' | 'bodySerializer'>\n): Promise<T> {\n  const { parameters, headers, body, ...requestInfoRest } = requestInfo;\n\n  const requestBody = options.bodySerializer(requestSchema, requestInfo);\n\n  const baseFetch = options.fetch ?? fetch;\n\n  const response = await baseFetch(\n    options.urlSerializer(requestSchema, requestInfo),\n    {\n      method: requestSchema.method.toUpperCase(),\n      body: requestBody,\n      headers: mergeHeaders(\n        {\n          Accept: 'application/json',\n          'Content-Type': requestSchema.mediaType ?? getBodyContentType(body),\n        },\n        headers,\n        parameters?.header,\n        requestBody instanceof FormData\n          ? // remove `Content-Type` if serialized body is FormData; browser will correctly set Content-Type & boundary expression\n            { 'Content-Type': null }\n          : undefined\n      ),\n      ...requestInfoRest,\n    }\n  );\n\n  // clone response to allow multiple reads\n  const clonedResponse = response.clone();\n\n  if (!response.ok) {\n    throw await getResponseBody(clonedResponse);\n  }\n\n  return (await getResponseBody(clonedResponse)) as T;\n}\n\nexport function urlSerializer(\n  schema: OperationSchema,\n  info: RequestFnPayload\n): string {\n  const path = schema.url.replace(\n    /{(.*?)}/g,\n    (substring: string, group: string) => {\n      if (\n        info.parameters?.path &&\n        Object.prototype.hasOwnProperty.call(info.parameters.path, group)\n      ) {\n        return encodeURI(String(info.parameters?.path[group]));\n      }\n      return substring;\n    }\n  );\n\n  const baseUrl = info.baseUrl ?? '';\n\n  if (info.parameters?.query) {\n    return `${baseUrl}${path}${getQueryString(info.parameters.query)}`;\n  }\n\n  return `${baseUrl}${path}`;\n}\n\nfunction getQueryString(params: Record<string, any>): string {\n  const qs: string[] = [];\n\n  const append = (key: string, value: any) => {\n    qs.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);\n  };\n\n  const process = (key: string, value: any) => {\n    if (typeof value === 'undefined' || value === null) return;\n\n    if (Array.isArray(value)) {\n      value.forEach((v) => {\n        process(key, v);\n      });\n    } else if (typeof value === 'object') {\n      Object.entries(value).forEach(([k, v]) => {\n        process(`${key}[${k}]`, v);\n      });\n    } else {\n      append(key, value);\n    }\n  };\n\n  Object.entries(params).forEach(([key, value]) => {\n    process(key, value);\n  });\n\n  if (qs.length > 0) {\n    return `?${qs.join('&')}`;\n  }\n\n  return '';\n}\n\nexport function mergeHeaders(...allHeaders: (HeadersOptions | undefined)[]) {\n  const headers = new Headers();\n\n  for (const headerSet of allHeaders) {\n    if (!headerSet || typeof headerSet !== 'object') {\n      continue;\n    }\n\n    const headersIterator =\n      headerSet instanceof Headers\n        ? headerSet.entries()\n        : Object.entries(headerSet);\n\n    for (const [headerKey, headerValue] of headersIterator) {\n      if (headerValue === null) {\n        headers.delete(headerKey);\n      } else if (headerValue !== undefined) {\n        headers.set(headerKey, headerValue);\n      }\n    }\n  }\n\n  return headers;\n}\n\nexport function bodySerializer(\n  schema: OperationSchema,\n  info: RequestFnPayload\n) {\n  if (info.body === undefined) return;\n\n  if (\n    schema.method === 'get' ||\n    schema.method === 'head' ||\n    schema.method === 'options'\n  )\n    return;\n\n  if (schema.mediaType?.includes('/form-data'))\n    return getRequestBodyFormData(info);\n\n  if (\n    !schema.mediaType?.includes('/json') &&\n    (typeof info.body === 'string' ||\n      info.body instanceof Blob ||\n      info.body instanceof FormData)\n  ) {\n    return info.body;\n  }\n\n  return JSON.stringify(info.body);\n}\n\nfunction getRequestBodyFormData({\n  body,\n}: Pick<RequestFnPayload, 'body'>): FormData | undefined {\n  if (body instanceof FormData) return body;\n  if (body === null) return;\n\n  if (body instanceof Blob) throw new Error('Blob not supported in form-data');\n  if (body instanceof ArrayBuffer)\n    throw new Error('ArrayBuffer not supported in form-data');\n  if (body instanceof URLSearchParams)\n    throw new Error('URLSearchParams not supported in form-data');\n  if (body instanceof ReadableStream)\n    throw new Error('ReadableStream not supported in form-data');\n  if (typeof body === 'string')\n    throw new Error('String not supported in form-data');\n  if (typeof body !== 'object')\n    throw new Error(`Unsupported body type ${typeof body} in form-data.`);\n\n  const formData = new FormData();\n\n  const process = (key: string, value: any) => {\n    if (typeof value === 'string' || value instanceof Blob) {\n      formData.append(key, value);\n    } else {\n      formData.append(key, JSON.stringify(value));\n    }\n  };\n\n  Object.entries(body)\n    .filter(([_, value]) => typeof value !== 'undefined' && value !== null)\n    .forEach(([key, value]) => {\n      if (Array.isArray(value)) {\n        value.forEach((v) => process(key, v));\n      } else {\n        process(key, value);\n      }\n    });\n\n  return formData;\n}\n\nfunction getBodyContentType(body: RequestFnPayload['body']) {\n  if (!body) return;\n  if (body instanceof Blob) return body.type || 'application/octet-stream';\n  if (typeof body === 'string') return 'text/plain';\n  if (!(body instanceof FormData)) return 'application/json';\n}\n\nasync function getResponseBody<T>(response: Response): Promise<T | undefined> {\n  if (response.status === 204 || response.headers.get('Content-Length') === '0')\n    return undefined;\n\n  const contentType = response.headers.get('Content-Type')?.toLowerCase();\n  const isJSON =\n    contentType?.includes('/json') || contentType?.includes('+json');\n\n  if (isJSON) {\n    // attempt to parse JSON for successful responses, otherwise fail\n    if (response.ok) return response.json();\n\n    const errorFallbackResponse = response.clone(); // clone to allow multiple reads\n\n    return response.json().catch(() => {\n      if (process.env.NODE_ENV === 'development') {\n        console.warn(\n          'Failed to parse response body as JSON. Falling back to .text()'\n        );\n      }\n      // falling back to .text() when necessary for error messages\n      return errorFallbackResponse.text();\n    });\n  }\n\n  return response.text() as Promise<T>;\n}\n\n// To have definitely typed headers without a conversion to stings\nexport type HeadersOptions =\n  | HeadersInit\n  | Record<string, string | number | boolean | null | undefined>;\n\nexport interface OperationSchema {\n  /**\n   * Operation path\n   * @example /user/{id}\n   */\n  readonly url: string; //todo::rename to `path`\n\n  /**\n   * Operation method\n   */\n  readonly method:\n    | 'get'\n    | 'put'\n    | 'post'\n    | 'patch'\n    | 'delete'\n    | 'options'\n    | 'head'\n    | 'trace';\n\n  /**\n   * Media type of the request body\n   * @example application/json\n   */\n  readonly mediaType?: string;\n\n  readonly security?: string[];\n}\n\nexport interface RequestFnPayload {\n  /**\n   * Base URL to use for the request\n   * @example 'https://api.example.com'\n   */\n  baseUrl: string | undefined;\n\n  /**\n   * OpenAPI parameters\n   * @example\n   * ```ts\n   * { path: {id: 1}, query: {search: 'hello'} }\n   * ```\n   */\n  readonly parameters?: {\n    readonly path?: Record<string, any>;\n    readonly header?: Record<string, any>;\n    readonly query?: Record<string, any>;\n  };\n\n  /**\n   * Request body\n   * @example { name: 'John' }\n   */\n  readonly body?: BodyInit | Record<string, unknown> | null;\n\n  /**\n   * Tanstack Query Meta\n   */\n  meta?: Record<string, unknown>;\n\n  /** An AbortSignal to set request's signal. */\n  signal?: AbortSignal | null;\n}\n\nexport interface RequestFnInfo\n  extends RequestFnPayload,\n    Omit<RequestInit, 'headers' | 'method' | 'body' | 'signal'> {\n  /**\n   * Request headers\n   * @example { 'X-Auth': '123' }\n   */\n  readonly headers?: HeadersOptions;\n}\n\nexport interface RequestFnOptions {\n  urlSerializer?: typeof urlSerializer;\n  bodySerializer?: typeof bodySerializer;\n  fetch?: typeof fetch;\n}\n\nexport type RequestFn<T> = typeof requestFn<T>;\n\ntype WithRequired<T, K extends keyof T> = T & {\n  [_ in K]: {};\n};\n"],"names":["requestFn","schema","requestInfo","options","baseRequestFn","urlSerializer","bodySerializer","requestSchema","parameters","headers","body","requestInfoRest","requestBody","baseFetch","fetch","response","method","toUpperCase","mergeHeaders","Accept","mediaType","getBodyContentType","header","FormData","undefined","clonedResponse","clone","ok","getResponseBody","info","path","url","replace","substring","group","Object","prototype","hasOwnProperty","call","encodeURI","String","baseUrl","query","getQueryString","params","qs","append","key","value","push","encodeURIComponent","process","Array","isArray","forEach","v","entries","k","length","join","allHeaders","Headers","headerSet","headersIterator","headerKey","headerValue","delete","set","includes","getRequestBodyFormData","Blob","JSON","stringify","Error","ArrayBuffer","URLSearchParams","ReadableStream","formData","filter","_","type","status","get","contentType","toLowerCase","isJSON","json","errorFallbackResponse","catch","env","NODE_ENV","console","warn","text"],"mappings":"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"}
+{"version":3,"file":"requestFn.js","sources":["../../../src/lib/requestFn.ts"],"sourcesContent":["/**\n * This function is used to make a request to a specified endpoint.\n *\n * @template T The expected return type of the request.\n *\n * @param schema The schema of the operation to be performed. It includes the OpenAPI path, HTTP method and media type.\n * @param requestInfo The information required to make the request. It includes parameters, headers, body, etc.\n * @param [options] Optional. Additional options for the request. It includes custom urlSerializer, bodySerializer, and fetch function.\n *\n * @returns {Promise<T>} Returns a promise that resolves with the response of the request.\n *\n * @throws {error: object|string, response: Response} Throws an error if the request fails. The error includes the error message and the response from the server.\n */\nexport async function requestFn<T>(\n  schema: OperationSchema,\n  requestInfo: RequestFnInfo,\n  options?: RequestFnOptions\n): Promise<T> {\n  return baseRequestFn(schema, requestInfo, {\n    urlSerializer,\n    bodySerializer,\n    ...options,\n  });\n}\n\n/**\n * This function is used to make a request to a specified endpoint.\n * It's needed to create a custom `requestFn` with a custom `urlSerializer`\n * and `bodySerializer`, with the tree-shaking of the default `requestFn`\n * and its serializers.\n *\n * @template T The expected return type of the request.\n *\n * @param requestSchema The schema of the operation to be performed. It includes the OpenAPI path, HTTP method and media type.\n * @param requestInfo The information required to make the request. It includes parameters, headers, body, etc.\n * @param options The options for the request. It includes urlSerializer, bodySerializer, and fetch function. The 'urlSerializer' and 'bodySerializer' are required.\n *\n * @returns {Promise<T>} Returns a promise that resolves with the response of the request.\n *\n * @throws {error: object|string, response: Response} Throws an error if the request fails. The error includes the error message and the response from the server.\n */\nexport async function baseRequestFn<T>(\n  requestSchema: OperationSchema,\n  requestInfo: RequestFnInfo,\n  options: WithRequired<RequestFnOptions, 'urlSerializer' | 'bodySerializer'>\n): Promise<T> {\n  const { parameters, headers, body, ...requestInfoRest } = requestInfo;\n\n  const requestBody = options.bodySerializer(requestSchema, requestInfo);\n\n  const baseFetch = options.fetch ?? fetch;\n\n  const response = await baseFetch(\n    options.urlSerializer(requestSchema, requestInfo),\n    {\n      method: requestSchema.method.toUpperCase(),\n      body: requestBody,\n      headers: mergeHeaders(\n        {\n          Accept: 'application/json',\n          'Content-Type': requestSchema.mediaType ?? getBodyContentType(body),\n        },\n        headers,\n        parameters?.header,\n        requestBody instanceof FormData\n          ? // remove `Content-Type` if serialized body is FormData; browser will correctly set Content-Type & boundary expression\n            { 'Content-Type': null }\n          : undefined\n      ),\n      ...requestInfoRest,\n    }\n  );\n\n  // clone response to allow multiple reads\n  const clonedResponse = response.clone();\n\n  if (!response.ok) {\n    throw await getResponseBody(clonedResponse);\n  }\n\n  return (await getResponseBody(clonedResponse)) as T;\n}\n\n/**\n * Serializes the given schema and request payload into a URL string.\n *\n * This function is implemented according to the URI Template standard\n * defined in RFC 6570. It supports the expansion of path and query parameters,\n * correctly handling empty arrays, `null`, and `undefined` values by ignoring\n * them during the expansion process, as specified by the standard.\n *\n * For more information, refer to the official documentation:\n * https://datatracker.ietf.org/doc/html/rfc6570\n *\n * @param schema - The operation schema containing the URL template and method.\n * @param info - The request payload including baseUrl, path parameters, and query parameters.\n * @returns The fully constructed URL string.\n */\nexport function urlSerializer(\n  schema: OperationSchema,\n  info: RequestFnPayload\n): string {\n  const path = schema.url.replace(\n    /{(.*?)}/g,\n    (substring: string, group: string) => {\n      if (\n        info.parameters?.path &&\n        Object.prototype.hasOwnProperty.call(info.parameters.path, group)\n      ) {\n        return encodeURI(String(info.parameters?.path[group]));\n      }\n      return substring;\n    }\n  );\n\n  const baseUrl = info.baseUrl ?? '';\n\n  if (info.parameters?.query) {\n    return `${baseUrl}${path}${getQueryString(info.parameters.query)}`;\n  }\n\n  return `${baseUrl}${path}`;\n}\n\nfunction getQueryString(params: Record<string, any>): string {\n  const qs: string[] = [];\n\n  const append = (key: string, value: any) => {\n    qs.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);\n  };\n\n  const process = (key: string, value: any) => {\n    if (typeof value === 'undefined' || value === null) return;\n\n    if (Array.isArray(value)) {\n      value.forEach((v) => {\n        process(key, v);\n      });\n    } else if (typeof value === 'object') {\n      Object.entries(value).forEach(([k, v]) => {\n        process(`${key}[${k}]`, v);\n      });\n    } else {\n      append(key, value);\n    }\n  };\n\n  Object.entries(params).forEach(([key, value]) => {\n    process(key, value);\n  });\n\n  if (qs.length > 0) {\n    return `?${qs.join('&')}`;\n  }\n\n  return '';\n}\n\nexport function mergeHeaders(...allHeaders: (HeadersOptions | undefined)[]) {\n  const headers = new Headers();\n\n  for (const headerSet of allHeaders) {\n    if (!headerSet || typeof headerSet !== 'object') {\n      continue;\n    }\n\n    const headersIterator =\n      headerSet instanceof Headers\n        ? headerSet.entries()\n        : Object.entries(headerSet);\n\n    for (const [headerKey, headerValue] of headersIterator) {\n      if (headerValue === null) {\n        headers.delete(headerKey);\n      } else if (headerValue !== undefined) {\n        headers.set(headerKey, headerValue);\n      }\n    }\n  }\n\n  return headers;\n}\n\nexport function bodySerializer(\n  schema: OperationSchema,\n  info: RequestFnPayload\n) {\n  if (info.body === undefined) return;\n\n  if (\n    schema.method === 'get' ||\n    schema.method === 'head' ||\n    schema.method === 'options'\n  )\n    return;\n\n  if (schema.mediaType?.includes('/form-data'))\n    return getRequestBodyFormData(info);\n\n  if (\n    !schema.mediaType?.includes('/json') &&\n    (typeof info.body === 'string' ||\n      info.body instanceof Blob ||\n      info.body instanceof FormData)\n  ) {\n    return info.body;\n  }\n\n  return JSON.stringify(info.body);\n}\n\nfunction getRequestBodyFormData({\n  body,\n}: Pick<RequestFnPayload, 'body'>): FormData | undefined {\n  if (body instanceof FormData) return body;\n  if (body === null) return;\n\n  if (body instanceof Blob) throw new Error('Blob not supported in form-data');\n  if (body instanceof ArrayBuffer)\n    throw new Error('ArrayBuffer not supported in form-data');\n  if (body instanceof URLSearchParams)\n    throw new Error('URLSearchParams not supported in form-data');\n  if (body instanceof ReadableStream)\n    throw new Error('ReadableStream not supported in form-data');\n  if (typeof body === 'string')\n    throw new Error('String not supported in form-data');\n  if (typeof body !== 'object')\n    throw new Error(`Unsupported body type ${typeof body} in form-data.`);\n\n  const formData = new FormData();\n\n  const process = (key: string, value: any) => {\n    if (typeof value === 'string' || value instanceof Blob) {\n      formData.append(key, value);\n    } else {\n      formData.append(key, JSON.stringify(value));\n    }\n  };\n\n  Object.entries(body)\n    .filter(([_, value]) => typeof value !== 'undefined' && value !== null)\n    .forEach(([key, value]) => {\n      if (Array.isArray(value)) {\n        value.forEach((v) => process(key, v));\n      } else {\n        process(key, value);\n      }\n    });\n\n  return formData;\n}\n\nfunction getBodyContentType(body: RequestFnPayload['body']) {\n  if (!body) return;\n  if (body instanceof Blob) return body.type || 'application/octet-stream';\n  if (typeof body === 'string') return 'text/plain';\n  if (!(body instanceof FormData)) return 'application/json';\n}\n\nasync function getResponseBody<T>(response: Response): Promise<T | undefined> {\n  if (response.status === 204 || response.headers.get('Content-Length') === '0')\n    return undefined;\n\n  const contentType = response.headers.get('Content-Type')?.toLowerCase();\n  const isJSON =\n    contentType?.includes('/json') || contentType?.includes('+json');\n\n  if (isJSON) {\n    // attempt to parse JSON for successful responses, otherwise fail\n    if (response.ok) return response.json();\n\n    const errorFallbackResponse = response.clone(); // clone to allow multiple reads\n\n    return response.json().catch(() => {\n      if (process.env.NODE_ENV === 'development') {\n        console.warn(\n          'Failed to parse response body as JSON. Falling back to .text()'\n        );\n      }\n      // falling back to .text() when necessary for error messages\n      return errorFallbackResponse.text();\n    });\n  }\n\n  return response.text() as Promise<T>;\n}\n\n// To have definitely typed headers without a conversion to stings\nexport type HeadersOptions =\n  | HeadersInit\n  | Record<string, string | number | boolean | null | undefined>;\n\nexport interface OperationSchema {\n  /**\n   * Operation path\n   * @example /user/{id}\n   */\n  readonly url: string; //todo::rename to `path`\n\n  /**\n   * Operation method\n   */\n  readonly method:\n    | 'get'\n    | 'put'\n    | 'post'\n    | 'patch'\n    | 'delete'\n    | 'options'\n    | 'head'\n    | 'trace';\n\n  /**\n   * Media type of the request body\n   * @example application/json\n   */\n  readonly mediaType?: string;\n\n  readonly security?: string[];\n}\n\nexport interface RequestFnPayload {\n  /**\n   * Base URL to use for the request\n   * @example 'https://api.example.com'\n   */\n  baseUrl: string | undefined;\n\n  /**\n   * OpenAPI parameters\n   * @example\n   * ```ts\n   * { path: {id: 1}, query: {search: 'hello'} }\n   * ```\n   */\n  readonly parameters?: {\n    readonly path?: Record<string, any>;\n    readonly header?: Record<string, any>;\n    readonly query?: Record<string, any>;\n  };\n\n  /**\n   * Request body\n   * @example { name: 'John' }\n   */\n  readonly body?: BodyInit | Record<string, unknown> | null;\n\n  /**\n   * Tanstack Query Meta\n   */\n  meta?: Record<string, unknown>;\n\n  /** An AbortSignal to set request's signal. */\n  signal?: AbortSignal | null;\n}\n\nexport interface RequestFnInfo\n  extends RequestFnPayload,\n    Omit<RequestInit, 'headers' | 'method' | 'body' | 'signal'> {\n  /**\n   * Request headers\n   * @example { 'X-Auth': '123' }\n   */\n  readonly headers?: HeadersOptions;\n}\n\nexport interface RequestFnOptions {\n  urlSerializer?: typeof urlSerializer;\n  bodySerializer?: typeof bodySerializer;\n  fetch?: typeof fetch;\n}\n\nexport type RequestFn<T> = typeof requestFn<T>;\n\ntype WithRequired<T, K extends keyof T> = T & {\n  [_ in K]: {};\n};\n"],"names":["requestFn","schema","requestInfo","options","baseRequestFn","urlSerializer","bodySerializer","requestSchema","parameters","headers","body","requestInfoRest","requestBody","baseFetch","fetch","response","method","toUpperCase","mergeHeaders","Accept","mediaType","getBodyContentType","header","FormData","undefined","clonedResponse","clone","ok","getResponseBody","info","path","url","replace","substring","group","Object","prototype","hasOwnProperty","call","encodeURI","String","baseUrl","query","getQueryString","params","qs","append","key","value","push","encodeURIComponent","process","Array","isArray","forEach","v","entries","k","length","join","allHeaders","Headers","headerSet","headersIterator","headerKey","headerValue","delete","set","includes","getRequestBodyFormData","Blob","JSON","stringify","Error","ArrayBuffer","URLSearchParams","ReadableStream","formData","filter","_","type","status","get","contentType","toLowerCase","isJSON","json","errorFallbackResponse","catch","env","NODE_ENV","console","warn","text"],"mappings":"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"}

package/dist/types/lib/requestFn.d.ts

@@ -29,6 +29,21 @@ export declare function requestFn<T>(schema: OperationSchema, requestInfo: Reque
  * @throws {error: object|string, response: Response} Throws an error if the request fails. The error includes the error message and the response from the server.
  */
 export declare function baseRequestFn<T>(requestSchema: OperationSchema, requestInfo: RequestFnInfo, options: WithRequired<RequestFnOptions, 'urlSerializer' | 'bodySerializer'>): Promise<T>;
+/**
+ * Serializes the given schema and request payload into a URL string.
+ *
+ * This function is implemented according to the URI Template standard
+ * defined in RFC 6570. It supports the expansion of path and query parameters,
+ * correctly handling empty arrays, `null`, and `undefined` values by ignoring
+ * them during the expansion process, as specified by the standard.
+ *
+ * For more information, refer to the official documentation:
+ * https://datatracker.ietf.org/doc/html/rfc6570
+ *
+ * @param schema - The operation schema containing the URL template and method.
+ * @param info - The request payload including baseUrl, path parameters, and query parameters.
+ * @returns The fully constructed URL string.
+ */
 export declare function urlSerializer(schema: OperationSchema, info: RequestFnPayload): string;
 export declare function mergeHeaders(...allHeaders: (HeadersOptions | undefined)[]): Headers;
 export declare function bodySerializer(schema: OperationSchema, info: RequestFnPayload): string | Blob | FormData | undefined;

package/dist/types/lib/requestFn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"requestFn.d.ts","sourceRoot":"","sources":["../../../src/lib/requestFn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,MAAM,EAAE,eAAe,EACvB,WAAW,EAAE,aAAa,EAC1B,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,CAAC,CAAC,CAMZ;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,aAAa,EAAE,eAAe,EAC9B,WAAW,EAAE,aAAa,EAC1B,OAAO,EAAE,YAAY,CAAC,gBAAgB,EAAE,eAAe,GAAG,gBAAgB,CAAC,GAC1E,OAAO,CAAC,CAAC,CAAC,CAoCZ;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,gBAAgB,GACrB,MAAM,CAqBR;AAoCD,wBAAgB,YAAY,CAAC,GAAG,UAAU,EAAE,CAAC,cAAc,GAAG,SAAS,CAAC,EAAE,WAuBzE;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,gBAAgB,wCAwBvB;AA+ED,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,MAAM,EACX,KAAK,GACL,KAAK,GACL,MAAM,GACN,OAAO,GACP,QAAQ,GACR,SAAS,GACT,MAAM,GACN,OAAO,CAAC;IAEZ;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAE5B;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE;QACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACtC,CAAC;IAEF;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE1D;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,aACf,SAAQ,gBAAgB,EACtB,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC7D;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,EAAE,OAAO,aAAa,CAAC;IACrC,cAAc,CAAC,EAAE,OAAO,cAAc,CAAC;IACvC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;AAE/C,KAAK,YAAY,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,GAAG;KAC3C,CAAC,IAAI,CAAC,GAAG,EAAE;CACb,CAAC"}
+{"version":3,"file":"requestFn.d.ts","sourceRoot":"","sources":["../../../src/lib/requestFn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,MAAM,EAAE,eAAe,EACvB,WAAW,EAAE,aAAa,EAC1B,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,CAAC,CAAC,CAMZ;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,aAAa,EAAE,eAAe,EAC9B,WAAW,EAAE,aAAa,EAC1B,OAAO,EAAE,YAAY,CAAC,gBAAgB,EAAE,eAAe,GAAG,gBAAgB,CAAC,GAC1E,OAAO,CAAC,CAAC,CAAC,CAoCZ;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,gBAAgB,GACrB,MAAM,CAqBR;AAoCD,wBAAgB,YAAY,CAAC,GAAG,UAAU,EAAE,CAAC,cAAc,GAAG,SAAS,CAAC,EAAE,WAuBzE;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,gBAAgB,wCAwBvB;AA+ED,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,MAAM,EACX,KAAK,GACL,KAAK,GACL,MAAM,GACN,OAAO,GACP,QAAQ,GACR,SAAS,GACT,MAAM,GACN,OAAO,CAAC;IAEZ;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAE5B;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE;QACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACtC,CAAC;IAEF;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE1D;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,aACf,SAAQ,gBAAgB,EACtB,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC7D;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,EAAE,OAAO,aAAa,CAAC;IACrC,cAAc,CAAC,EAAE,OAAO,cAAc,CAAC;IACvC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;AAE/C,KAAK,YAAY,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,GAAG;KAC3C,CAAC,IAAI,CAAC,GAAG,EAAE;CACb,CAAC"}

package/dist/types/lib/urlSerializer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=urlSerializer.test.d.ts.map

package/dist/types/lib/urlSerializer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlSerializer.test.d.ts","sourceRoot":"","sources":["../../../src/lib/urlSerializer.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openapi-qraft/react",
-  "version": "1.13.1",
+  "version": "1.14.0-beta.2",
   "description": "API client for React, providing type-safe requests and dynamic Tanstack Query React Hooks via a modular, Proxy-based architecture.",
   "scripts": {
     "build": "NODE_ENV=production rollup --config rollup.config.mjs && tsc --project tsconfig.build.json --emitDeclarationOnly",
@@ -10,14 +10,14 @@
     "typecheck": "tsc --noEmit",
     "lint": "eslint",
     "clean": "rimraf dist/",
-    "codegen": "openapi-qraft --plugin tanstack-query-react --plugin openapi-typescript ../test-fixtures/openapi.json -rm -o src/tests/fixtures/api --openapi-types-file-name openapi.ts --explicit-import-extensions --filter-services '/approval_policies/**,/entities/**,/files/**,!/internal/**' --operation-predefined-parameters '/approval_policies/{approval_policy_id}/**:header.x-monite-entity-id' '/entities/{entity_id}/documents:header.x-monite-version' && yarn _prettify-api",
+    "codegen": "openapi-qraft --plugin tanstack-query-react --plugin openapi-typescript ../test-fixtures/openapi.json -rm -o src/tests/fixtures/api --openapi-types-file-name openapi.ts --explicit-import-extensions --filter-services '/approval_policies/**,/entities/**,/files/**,!/internal/**' --operation-predefined-parameters '/approval_policies/{approval_policy_id}/**:header.x-monite-entity-id' '/entities/{entity_id}/documents:header.x-monite-version' --operation-name-modifier '/files/list:[a-zA-Z]+List ==> findAll' && yarn _prettify-api",
     "_prettify-api": "prettier --write src/tests/fixtures/api/**/*.ts"
   },
   "sideEffects": false,
   "devDependencies": {
-    "@openapi-qraft/cli": "1.13.1",
+    "@openapi-qraft/cli": "1.14.0-beta.2",
     "@openapi-qraft/eslint-config": "1.0.0",
-    "@openapi-qraft/openapi-typescript-plugin": "^1.0.8",
+    "@openapi-qraft/openapi-typescript-plugin": "^1.1.0-beta.2",
     "@openapi-qraft/rollup-config": "1.0.0",
     "@openapi-qraft/test-fixtures": "1.0.0",
     "@tanstack/react-query": "^5.17.3",

package/src/lib/requestFn.ts

@@ -81,6 +81,21 @@ export async function baseRequestFn<T>(
   return (await getResponseBody(clonedResponse)) as T;
 }
 
+/**
+ * Serializes the given schema and request payload into a URL string.
+ *
+ * This function is implemented according to the URI Template standard
+ * defined in RFC 6570. It supports the expansion of path and query parameters,
+ * correctly handling empty arrays, `null`, and `undefined` values by ignoring
+ * them during the expansion process, as specified by the standard.
+ *
+ * For more information, refer to the official documentation:
+ * https://datatracker.ietf.org/doc/html/rfc6570
+ *
+ * @param schema - The operation schema containing the URL template and method.
+ * @param info - The request payload including baseUrl, path parameters, and query parameters.
+ * @returns The fully constructed URL string.
+ */
 export function urlSerializer(
   schema: OperationSchema,
   info: RequestFnPayload

package/src/lib/urlSerializer.test.ts

@@ -0,0 +1,219 @@
+import { describe, expect, it } from 'vitest';
+import { urlSerializer } from './requestFn.js';
+
+describe('urlSerializer', () => {
+  it('should correctly replace path parameters', () => {
+    expect(
+      urlSerializer(
+        { url: '/users/{userId}/posts/{postId}', method: 'get' },
+        {
+          baseUrl: 'https://api.example.com',
+          parameters: { path: { userId: '123', postId: '456' } },
+        }
+      )
+    ).toBe('https://api.example.com/users/123/posts/456');
+  });
+
+  it('should correctly append query parameters', () => {
+    expect(
+      urlSerializer(
+        { url: '/users/{userId}/posts', method: 'get' },
+        {
+          baseUrl: 'https://api.example.com',
+          parameters: {
+            path: { userId: '123' },
+            query: { filter: 'recent', limit: 10 },
+          },
+        }
+      )
+    ).toBe('https://api.example.com/users/123/posts?filter=recent&limit=10');
+  });
+
+  it('should return URL without query parameters if none specified in path', () => {
+    expect(
+      urlSerializer(
+        { url: '/users/{userId}/posts', method: 'get' },
+        {
+          baseUrl: 'https://api.example.com',
+          parameters: { path: { userId: '123', postId: '456' } },
+        }
+      )
+    ).toBe('https://api.example.com/users/123/posts');
+  });
+
+  it('should handle missing baseUrl gracefully', () => {
+    expect(
+      urlSerializer(
+        { url: '/users/{userId}/posts', method: 'get' },
+        // @ts-expect-error - Missing baseUrl fallback
+        {
+          parameters: { path: { userId: '123' } },
+        }
+      )
+    ).toBe('/users/123/posts');
+  });
+
+  it('should encode path parameters correctly', () => {
+    expect(
+      urlSerializer(
+        { url: '/search/{query}', method: 'get' },
+        {
+          baseUrl: 'https://api.example.com',
+          parameters: { path: { query: 'hello world' } },
+        }
+      )
+    ).toBe('https://api.example.com/search/hello%20world');
+  });
+
+  it('should correctly serialize query parameters with null values', () => {
+    expect(
+      urlSerializer(
+        { url: '/users', method: 'get' },
+        {
+          baseUrl: 'https://api.example.com',
+          parameters: { query: { name: null, age: 30 } },
+        }
+      )
+    ).toBe('https://api.example.com/users?age=30');
+  });
+
+  it('should correctly serialize query parameters with undefined values', () => {
+    expect(
+      urlSerializer(
+        { url: '/users', method: 'get' },
+        {
+          baseUrl: 'https://api.example.com',
+          parameters: { query: { name: undefined, age: 30 } },
+        }
+      )
+    ).toBe('https://api.example.com/users?age=30');
+  });
+
+  it('should correctly serialize query parameters with array values', () => {
+    expect(
+      urlSerializer(
+        { url: '/users', method: 'get' },
+        {
+          baseUrl: 'https://api.example.com',
+          parameters: { query: { tags: ['admin', 'user'], age: 30 } },
+        }
+      )
+    ).toBe('https://api.example.com/users?tags=admin&tags=user&age=30');
+  });
+
+  it('should correctly serialize query parameters with some null|undefined in array values', () => {
+    expect(
+      urlSerializer(
+        { url: '/users', method: 'get' },
+        {
+          baseUrl: 'https://api.example.com',
+          parameters: { query: { tags: [null, undefined, 'user'], age: 30 } },
+        }
+      )
+    ).toBe('https://api.example.com/users?tags=user&age=30');
+  });
+
+  it('should correctly serialize query parameters with an empty array', () => {
+    expect(
+      urlSerializer(
+        { url: '/users', method: 'get' },
+        {
+          baseUrl: 'https://api.example.com',
+          parameters: { query: { tags: [], age: 30 } },
+        }
+      )
+    ).toBe('https://api.example.com/users?age=30');
+  });
+
+  it('should correctly serialize query parameters with an object', () => {
+    expect(
+      urlSerializer(
+        { url: '/users', method: 'get' },
+        {
+          baseUrl: 'https://api.example.com',
+          parameters: {
+            query: {
+              tags: {
+                one: 'two',
+              },
+              age: 30,
+            },
+          },
+        }
+      )
+    ).toBe('https://api.example.com/users?tags%5Bone%5D=two&age=30');
+  });
+
+  it('should correctly serialize query parameters with an empty object', () => {
+    expect(
+      urlSerializer(
+        { url: '/users', method: 'get' },
+        {
+          baseUrl: 'https://api.example.com',
+          parameters: {
+            query: {
+              tags: {},
+              age: 30,
+            },
+          },
+        }
+      )
+    ).toBe('https://api.example.com/users?age=30');
+  });
+
+  it('should correctly serialize query parameters with an null|undefined object fields', () => {
+    expect(
+      urlSerializer(
+        { url: '/users', method: 'get' },
+        {
+          baseUrl: 'https://api.example.com',
+          parameters: {
+            query: {
+              tags: {
+                foo: null,
+                bar: undefined,
+              },
+              age: 30,
+            },
+          },
+        }
+      )
+    ).toBe('https://api.example.com/users?age=30');
+  });
+
+  it('should correctly serialize query parameters with nested objects', () => {
+    expect(
+      urlSerializer(
+        { url: '/search', method: 'get' },
+        {
+          baseUrl: 'https://api.example.com',
+          parameters: { query: { filter: { category: 'books', type: null } } },
+        }
+      )
+    ).toBe('https://api.example.com/search?filter%5Bcategory%5D=books');
+  });
+
+  it('should handle null values in path parameters', () => {
+    expect(
+      urlSerializer(
+        { url: '/users/{userId}/posts/{postId}', method: 'get' },
+        {
+          baseUrl: 'https://api.example.com',
+          parameters: { path: { userId: null, postId: '456' } },
+        }
+      )
+    ).toBe('https://api.example.com/users/null/posts/456');
+  });
+
+  it('should handle undefined values in path parameters', () => {
+    expect(
+      urlSerializer(
+        { url: '/users/{userId}/posts/{postId}', method: 'get' },
+        {
+          baseUrl: 'https://api.example.com',
+          parameters: { path: { userId: undefined, postId: '456' } },
+        }
+      )
+    ).toBe('https://api.example.com/users/undefined/posts/456');
+  });
+});