@unshared/client 0.3.0 → 0.3.2

package/dist/chunks/CfKxYeRr.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"CfKxYeRr.cjs","sources":["../../utils/isObjectLike.ts","../../utils/isFormDataLike.ts","../../utils/toFormData.ts","../../utils/parseRequestBody.ts","../../utils/parseRequestHeaders.ts","../../utils/parseRequestParameters.ts","../../utils/toSearchParams.ts","../../utils/parseRequestQuery.ts","../../utils/parseRequestUrl.ts","../../utils/parseRequest.ts","../../utils/fetch.ts","../../utils/handleResponseStreamJson.ts","../../utils/handleResponse.ts"],"sourcesContent":["import type { ObjectLike } from '@unshared/types'\n\n/**\n * Predicate to check if a value is an object-like value.\n *\n * @param value The value to check.\n * @returns `true` if the value is an object-like value, `false` otherwise.\n * @example isObjectLike({}) // true\n */\nexport function isObjectLike(value: unknown): value is ObjectLike {\n  return typeof value === 'object' && value !== null && value.constructor === Object\n}\n","/**\n * A type that represents a FormData-like object, which is a plain object with\n * nested Blob, File, or FileList values. Or a FormData instance.\n */\nexport type FormDataLike = FormData | Record<string, Blob | File | FileList>\n\n/**\n * Predicate to check if a value is FormData-like, meaning it is a plain object\n * with nested Blob, File, or FileList values.\n *\n * @param value The value to check.\n * @returns `true` if the value is FormData-like, `false` otherwise.\n * @example isFormDataLike({ file: new File(['test'], 'test.txt') }) // true\n */\nexport function isFormDataLike(value: unknown): value is FormDataLike {\n  if (typeof value !== 'object' || value === null) return false\n  if (value instanceof FormData) return true\n  const values = Object.values(value)\n  if (values.length === 0) return false\n  return values.every((x) => {\n    if (x instanceof File) return true\n    if (Array.isArray(x)) return x.every(item => item instanceof File)\n    return x instanceof Blob\n  })\n}\n","import type { FormDataLike } from './isFormDataLike'\n\n/**\n * Casts an object that may contain `Blob`, `File`, or `FileList` values to a `FormData` object.\n *\n * @param object The object to cast to a `FormData` object.\n * @returns The `FormData` object.\n */\nexport function toFormData(object: FormDataLike): FormData {\n  if (object instanceof FormData) return object\n  const formData = new FormData()\n  for (const key in object) {\n    const value = object[key]\n    if (value === undefined) continue\n    if (Array.isArray(value)) {\n      for (const item of value)\n        formData.append(key, item as Blob | string)\n    }\n    else {\n      formData.append(key, value as Blob | string)\n    }\n  }\n  return formData\n}\n","import type { FetchOptions, RequestContext } from './parseRequest'\nimport { isFormDataLike } from './isFormDataLike'\nimport { isObjectLike } from './isObjectLike'\nimport { toFormData } from './toFormData'\n\n/**\n * Parse the request body based on the provided data and options.\n *\n * @param context The request context.\n * @param options The request options.\n */\nexport function parseRequestBody(context: RequestContext, options: FetchOptions): void {\n  const { body } = options\n\n  // --- If the method is `GET`, `HEAD`, or `DELETE`, return early.\n  if (!context.init?.method) return\n  if (['get', 'head', 'delete'].includes(context.init.method ?? 'get')) return\n\n  // --- If no data is provided, return early.\n  if (body === null || body === undefined) return\n\n  // --- If data contains a `File` object, create a FormData object.\n  if (isFormDataLike(body)) {\n    context.init.body = toFormData(body)\n    context.init.headers = context.init.headers ?? {}\n    context.init.headers = { ...context.init.headers, 'Content-Type': 'multipart/form-data' }\n  }\n\n  // --- If the data is a `ReadableStream`, pass it directly to the body.\n  else if (body instanceof ReadableStream) {\n    context.init.body = body\n    context.init.headers = context.init.headers ?? {}\n    context.init.headers = { ...context.init.headers, 'Content-Type': 'application/octet-stream' }\n  }\n\n  // --- If the data is a Blob, pass it directly to the body.\n  else if (body instanceof File) {\n    context.init.body = body.stream()\n    context.init.headers = context.init.headers ?? {}\n    context.init.headers = { ...context.init.headers, 'Content-Type': 'application/octet-stream' }\n  }\n\n  // --- Otherwise, stringify the data and set the content type to JSON.\n  else if (isObjectLike(body)) {\n    context.init.body = JSON.stringify(body)\n    context.init.headers = context.init.headers ?? {}\n    context.init.headers = { ...context.init.headers, 'Content-Type': 'application/json' }\n  }\n\n  // --- For all other data types, set the body directly.\n  else {\n    context.init.body = body as BodyInit\n  }\n}\n","import type { FetchOptions, RequestContext } from './parseRequest'\n\n/**\n * Parse the request headers based on the provided data and options.\n *\n * @param context The request context.\n * @param options The request options.\n * @example\n *\n * // Append the `Content-Type` header to the request.\n * const context = {}\n * parseRequestHeaders(context, { headers: { 'Content-Type': 'application/json' } })\n *\n * // Will mutate the `init` object to include the headers.\n * console.log(context) // => { init: { headers: { 'Content-Type': 'application/json' } } }\n */\nexport function parseRequestHeaders(context: RequestContext, options: FetchOptions): void {\n  const { headers } = options\n\n  // --- Merge the headers with the existing headers.\n  for (const key in headers) {\n    const value = headers[key]\n    if (((typeof value !== 'string' || value.length === 0) && typeof value !== 'number')) continue\n    context.init = context.init ?? {}\n    context.init.headers = context.init.headers ?? {}\n    context.init.headers = { ...context.init.headers, [key]: String(value) }\n  }\n}\n","import type { FetchOptions, RequestContext } from './parseRequest'\n\n/** Regular expression to match path parameters in the URL. */\nconst EXP_PATH_PARAMETER = /:([\\w-]+)|%7B([\\w-]+)%7D/g\n\n/**\n * Parse the request parameters from the request data. This function will mutate the\n * `url` object of the context to include the path parameters based on the provided data.\n *\n * @param context The request context to mutate.\n * @param options The options to pass to the request.\n * @example\n *\n * // Using `express` style path parameters.\n * const context = { url: new URL('https://api.example.com/users/:id') }\n * parseRequestParameters(context, { parameters: { id: 1 } })\n * console.log(context.url.pathname) // 'https://api.example.com/users/1'\n *\n * // Using `OpenAPI` style path parameters.\n * const context = { url: new URL('https://api.example.com/users/{id}') }\n * parseRequestParameters(context, { parameters: { id: 1 } })\n * console.log(context.url.pathname) // 'https://api.example.com/users/1'\n */\nexport function parseRequestParameters(context: RequestContext, options: FetchOptions): void {\n  const { url } = context\n  const { parameters } = options\n\n  // --- Return early if the parameters is not an object.\n  if (typeof parameters !== 'object' || parameters === null) return\n  if (url === undefined) return\n  if (url instanceof URL === false) throw new Error('The `url` must be an instance of `URL`.')\n\n  // --- If the method has a parameter, fill the path with the data.\n  const pathParameters = url.pathname.match(EXP_PATH_PARAMETER)\n  if (!pathParameters) return\n\n  // --- Apply the path parameters to the URL.\n  for (const parameter of pathParameters.values()) {\n    const key = parameter.replaceAll(EXP_PATH_PARAMETER, '$1$2')\n    const value = parameters[key]\n\n    // --- If the parameter is provided, replace the path with the value.\n    if (\n      (typeof value === 'string' && value.length > 0)\n      || (typeof value === 'number' && Number.isFinite(value))\n      || (typeof value === 'boolean')\n    ) {\n      url.pathname = url.pathname.replace(parameter, value.toString())\n      delete parameters[key]\n    }\n  }\n}\n","/* eslint-disable unicorn/prevent-abbreviations */\nimport type { MaybeArray } from '@unshared/types'\n\n/** An object that can be converted to a query string. */\nexport type SearchParamsObject = Record<string, MaybeArray<boolean | number | string> | undefined>\n\n/** The search array format options. */\nexport type SearchArrayFormat = 'brackets' | 'comma' | 'flat' | 'indices' | 'path'\n\n/** Options for the query string conversion. */\nexport interface ToSearchParamsOptions {\n\n  /**\n   * Defines how to handle arrays in the object. There is no standard way to\n   * represent arrays in query strings, so this option allows you to choose\n   * how to handle them. Additionally, you can provide a custom function to\n   * handle it yourself.\n   *\n   * - `brackets` (default): Convert arrays to `key[]=value&key[]=value` format.\n   * - `indices`: Convert arrays to `key[0]=value&key[1]=value` format.\n   * - `comma`: Convert arrays to `key=value1,value2` format.\n   * - `path`: Convert arrays to `key.0=value&key.1=value` format.\n   * - `flat`: Convert arrays to `key=value1&key=value2` format.\n   *\n   * @default 'flat'\n   */\n  format?: SearchArrayFormat\n}\n\n/**\n * Convert object to query string parameters. Converting all values to strings\n * and arrays to `key[0]=value&key[1]=value` format.\n *\n * @param object The object to convert to a query string.\n * @param options The query string options.\n * @returns The `URLSearchParams` object.\n */\nexport function toSearchParams(object: SearchParamsObject, options: ToSearchParamsOptions = {}): URLSearchParams {\n  const { format = 'flat' } = options\n  const search = new URLSearchParams()\n  for (const key in object) {\n    const value = object[key]\n    if (value === undefined) continue\n\n    // --- Convert arrays based on the format.\n    if (Array.isArray(value)) {\n      if (format === 'brackets') for (const v of value) search.append(`${key}[]`, String(v))\n      else if (format === 'indices') for (const [i, v] of value.entries()) search.append(`${key}[${i}]`, String(v))\n      else if (format === 'comma') search.append(key, value.join(','))\n      else if (format === 'path') for (const [i, v] of value.entries()) search.append(`${key}.${i}`, String(v))\n      else if (format === 'flat') for (const v of value) search.append(key, String(v))\n    }\n\n    // --- Convert all values to strings.\n    else { search.append(key, value.toString()) }\n  }\n\n  // --- Return the query string.\n  return search\n}\n","/* eslint-disable unicorn/prevent-abbreviations */\nimport type { FetchOptions, RequestContext } from './parseRequest'\nimport type { SearchParamsObject as SearchParametersObject } from './toSearchParams'\nimport { toSearchParams } from './toSearchParams'\n\n/**\n * Parse the query parameters from the request data. This function will append\n * the query parameters to the URL based on the method and the data provided.\n *\n * @param context The request context to modify.\n * @param options The options to pass to the request.\n */\nexport function parseRequestQuery(context: RequestContext, options: FetchOptions): void {\n  const { url } = context\n  const { query, queryArrayFormat } = options\n\n  // --- Return early if the query is not an object or the URL is not provided.\n  if (url === undefined) return\n  if (url instanceof URL === false) throw new Error('The `url` must be an instance of `URL.')\n  if (typeof query !== 'object' || query === null) return\n\n  // --- Append the `data` to the query parameters if the method does not expect a body.\n  const queryObject: SearchParametersObject = {}\n  for (const key in query) {\n    const value = query[key]\n    if (\n      (typeof value === 'string' && value.length > 0)\n      || (typeof value === 'number' && Number.isFinite(value))\n      || (typeof value === 'boolean')\n      || Array.isArray(value) && value.length > 0 && value.every(v => typeof v === 'string' || typeof v === 'number' || typeof v === 'boolean')\n    ) {\n      queryObject[key] = value\n      delete query[key]\n    }\n  }\n\n  // --- Apply the query parameters to the URL.\n  url.search = toSearchParams(queryObject, { format: queryArrayFormat }).toString()\n}\n","import type { FetchOptions, RequestContext } from './parseRequest'\n\n/** Regular expression to match the request method and URL. */\nconst EXP_REQUEST = /^((?<method>[a-z]+) )?(?<url>[^:]+?:\\/{2}[^/]+)?(?<path>\\/[^\\s?]*)/i\n\n/** Valid HTTP methods. */\nconst METHODS = new Set(['get', 'post', 'put', 'patch', 'delete', 'head', 'options'])\n\n/**\n * Parses the route name to extract the URL and method. It allows the url and method to be\n * provided in the route name, or in the options object. The method will default to 'get'.\n *\n * @param context The request context to mutate.\n * @param route The name of the route to fetch.\n * @param options The options to pass to the request.\n * @example parseRequestUrl('GET /users', { baseUrl: 'https://api.example.com' }, context)\n */\nexport function parseRequestUrl(context: RequestContext, route: string, options: FetchOptions): void {\n  const { method, baseUrl } = options\n\n  // --- Extract the path, method, and base URL from the route name.\n  const match = EXP_REQUEST.exec(route)\n  if (!match?.groups) throw new Error('Could not resolve the `RequestInit` object: Invalid route name.')\n  const routeMethod = method ?? match.groups.method ?? 'get'\n  const routeBaseUrl = baseUrl ?? match.groups.url\n\n  // --- Assert the base URL is provided, either in the options or the route name.\n  if (!routeBaseUrl) throw new Error('Could not resolve the `RequestInit` object: the `baseUrl` is missing.')\n\n  // --- Assert the method is valid.\n  const methodLower = routeMethod.toLowerCase()\n  const methodIsValid = METHODS.has(methodLower)\n  if (!methodIsValid) throw new Error(`Could not resolve the \\`RequestInit\\` object:, the method \\`${routeMethod}\\` is invalid.`)\n\n  // --- Create the url and apply the method.\n  context.init = context.init ?? {}\n  context.init.method = methodLower\n  context.url = new URL(routeBaseUrl)\n\n  // --- Append the path to the URL while making sure there are no double slashes.\n  context.url.pathname += context.url.pathname.endsWith('/') ? match.groups.path.slice(1) : match.groups.path\n}\n","import type { Loose, MaybeLiteral, ObjectLike } from '@unshared/types'\nimport type { UnionMerge } from '@unshared/types'\nimport type { HttpHeader } from '../HttpHeaders'\nimport type { HttpMethod } from '../HttpMethods'\nimport type { SearchArrayFormat } from './toSearchParams'\nimport { isObjectLike } from './isObjectLike'\nimport { parseRequestBody } from './parseRequestBody'\nimport { parseRequestHeaders } from './parseRequestHeaders'\nimport { parseRequestParameters } from './parseRequestParameters'\nimport { parseRequestQuery } from './parseRequestQuery'\nimport { parseRequestUrl } from './parseRequestUrl'\n\n/** The methods to use for the request. */\nexport type FetchMethod = Lowercase<keyof typeof HttpMethod> | Uppercase<keyof typeof HttpMethod>\n\n/** Headers to include in the request. */\nexport type FetchHeaders = Partial<Record<MaybeLiteral<HttpHeader>, number | string>>\n\n/** Options to pass to the request. */\nexport interface FetchOptions<\n  Method extends FetchMethod = FetchMethod,\n  BaseUrl extends string = string,\n  Parameters extends ObjectLike = ObjectLike,\n  Query extends ObjectLike = ObjectLike,\n  Body = unknown,\n  Headers extends ObjectLike = ObjectLike,\n> extends Omit<RequestInit, 'body' | 'headers' | 'method'> {\n\n  /**\n   * The method to use for the request.\n   *\n   * @example 'GET'\n   */\n  method?: Method\n\n  /**\n   * The base URL to use for the request. This URL will be used to resolve the\n   * path and query parameters of the request.\n   *\n   * @example 'https://api.example.com'\n   */\n  baseUrl?: BaseUrl\n\n  /**\n   * The data to include in the request. This data will be used to populate the\n   * query parameters, body, and headers of the request based on the method type.\n   *\n   * @example { id: 1 }\n   */\n  data?: Loose<UnionMerge<Body | Headers | Query>>\n\n  /**\n   * The path parameters to include in the request.\n   */\n  parameters?: Parameters\n\n  /**\n   * The query parameters to include in the request.\n   */\n  query?: Loose<Query>\n\n  /**\n   * The format to use when serializing the query parameters.\n   */\n  queryArrayFormat?: SearchArrayFormat\n\n  /**\n   * The body to include in the request.\n   */\n  body?: Body extends ObjectLike ? Loose<Body> : Body\n\n  /**\n   * The headers to include in the request.\n   */\n  headers?: FetchHeaders & Headers\n}\n\nexport interface RequestContext {\n  url?: URL\n  init?: RequestInit\n}\n\n/**\n * Resolves the request body and/or query parameters based on the method type. This function\n * will mutate the `init` object to include the request body and headers based on the data type.\n *\n * @param route The name of the route to fetch.\n * @param options The options to pass to the request.\n * @returns The URL and the `RequestInit` object.\n */\nexport function parseRequest(route: string, options: FetchOptions = {}): RequestContext {\n  const { data, body, query, parameters, headers, method, baseUrl, queryArrayFormat, ...init } = options\n  const context: RequestContext = { init }\n  const dataObject = isObjectLike(data) ? data : undefined\n\n  // --- Parse the URL and insert the path parameters.\n  parseRequestUrl(context, route, { baseUrl, method })\n  parseRequestParameters(context, { parameters: parameters ?? dataObject })\n\n  // --- Depending on the method, parse the query, body, and headers.\n  const requestMethod = context.init?.method?.toLowerCase() ?? 'get'\n  const requestExpectsBody = ['post', 'put', 'patch'].includes(requestMethod)\n  parseRequestQuery(context, { queryArrayFormat, query: requestExpectsBody ? query : query ?? dataObject })\n  parseRequestBody(context, { body: requestExpectsBody ? body ?? dataObject : undefined })\n  parseRequestHeaders(context, { headers })\n\n  // --- Return the context with the URL and the `RequestInit` object.\n  return context\n}\n","import type { FetchOptions } from './parseRequest'\nimport { parseRequest } from './parseRequest'\n\n/**\n * Fetch a route with the provided options. This function will parse the route and\n * options to create a `Request` object and return the response from the server.\n *\n * @param route The name of the route to fetch.\n * @param options The options to pass to the request.\n * @returns The response from the server.\n * @example fetch('GET /users', { query: { limit: 10 } })\n */\nexport async function fetch(route: string, options?: FetchOptions): Promise<Response>\nexport async function fetch(route: string, options: FetchOptions = {}): Promise<Response> {\n  const { url, init } = parseRequest(route, options)\n  if (!url) throw new Error('Could not parse request URL')\n  return await globalThis.fetch(url, init)\n}\n","import type { Awaitable } from '@unshared/functions/awaitable'\nimport type { RequestOptions } from './request'\nimport { awaitable } from '@unshared/functions/awaitable'\n\nasync function * createResponseStreamJsonIterator(response: Response, options: RequestOptions): AsyncGenerator<unknown, void, unknown> {\n  const { onError, onSuccess, onData, onEnd } = options\n  try {\n    const body = response.body\n    if (body === null) throw new Error('Could not read the response body, it is empty.')\n    const reader = body.getReader()\n    while (true) {\n      const { done, value } = await reader.read()\n      if (done) break\n      const parts = new TextDecoder().decode(value).trim().split('\\0').filter(Boolean)\n\n      // --- For each part, parse as JSON and yield the data.\n      for (const part of parts) {\n        const payload = JSON.parse(part) as unknown\n        if (onData) onData(payload)\n        yield payload\n      }\n    }\n    if (onSuccess) onSuccess(response)\n  }\n  catch (error) {\n    if (onError) onError(error as Error)\n  }\n  finally {\n    if (onEnd) onEnd(response)\n  }\n}\n\n/**\n * Handle a request response where the content type is a stream of JSON objects. This function\n * will parse the JSON objects and yield the data to the caller. If an error occurs, the `onError`\n * callback will be called and the function will return.\n *\n * @param response The response to handle.\n * @param options The options to pass to the request.\n * @returns An awaitable iterator that yields the parsed JSON objects.\n */\nexport function handleResponseStreamJson(response: Response, options: RequestOptions): Awaitable<AsyncIterable<unknown>, unknown[]> {\n  const responseIterator = createResponseStreamJsonIterator(response, options)\n  return awaitable(responseIterator)\n}\n","import type { RequestOptions } from './request'\nimport { handleResponseStreamJson } from './handleResponseStreamJson'\n\n/**\n * Handle a request response. This function will parse the response based on the content type and\n * return the data. If an error occurs, the `onError` callback will be called and the function will\n * throw an error.\n *\n * @param response The response to handle.\n * @param options The options to pass to the request.\n * @returns The parsed data from the response.\n */\nexport async function handleResponse(response: Response, options: RequestOptions = {}): Promise<unknown> {\n  const { onError, onSuccess, onData, onEnd, onFailure } = options\n  const contentType = response.headers.get('Content-Type')\n\n  // --- If the response is not OK, throw an error with the response message.\n  if (!response.ok) {\n    if (onFailure) onFailure(response)\n    if (onEnd) onEnd(response)\n    throw new Error(response.statusText)\n  }\n\n  // --- If the status code is 204, return an empty response early.\n  if (response.status === 204) {\n    if (onSuccess) onSuccess(response)\n    if (onEnd) onEnd(response)\n    return\n  }\n\n  // --- If the response is a text content type, return the text response.\n  if (contentType?.startsWith('text/')) {\n    return await response.text()\n      .then((data) => {\n        if (onData) onData(data)\n        if (onSuccess) onSuccess(response)\n        return data\n      })\n      .catch((error: Error) => {\n        if (onError) onError(error)\n        throw error\n      })\n      .finally(() => {\n        if (onEnd) onEnd(response)\n      })\n  }\n\n  // --- If the response is a application/json, parse the JSON and return it.\n  if (contentType === 'application/json') {\n    return await response.json()\n      .then((data) => {\n        if (onData) onData(data)\n        if (onSuccess) onSuccess(response)\n        return data as unknown\n      })\n      .catch((error: Error) => {\n        if (onError) onError(error)\n        throw error\n      })\n      .finally(() => {\n        if (onEnd) onEnd(response)\n      })\n  }\n\n  // --- If the response is a application/stream+json, return an iterator that parses the JSON.\n  if (contentType === 'application/stream+json')\n    return handleResponseStreamJson(response, options)\n\n  // --- Otherwise, fallback to returning the response body as-is.\n  if (onSuccess) onSuccess(response)\n  if (onEnd) onEnd(response)\n  return response.body\n}\n"],"names":["awaitable"],"mappings":"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"}

package/dist/chunks/D51s1VII.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"D51s1VII.js","sources":["../../utils/isObjectLike.ts","../../utils/isFormDataLike.ts","../../utils/toFormData.ts","../../utils/parseRequestBody.ts","../../utils/parseRequestHeaders.ts","../../utils/parseRequestParameters.ts","../../utils/toSearchParams.ts","../../utils/parseRequestQuery.ts","../../utils/parseRequestUrl.ts","../../utils/parseRequest.ts","../../utils/fetch.ts","../../utils/handleResponseStreamJson.ts","../../utils/handleResponse.ts"],"sourcesContent":["import type { ObjectLike } from '@unshared/types'\n\n/**\n * Predicate to check if a value is an object-like value.\n *\n * @param value The value to check.\n * @returns `true` if the value is an object-like value, `false` otherwise.\n * @example isObjectLike({}) // true\n */\nexport function isObjectLike(value: unknown): value is ObjectLike {\n  return typeof value === 'object' && value !== null && value.constructor === Object\n}\n","/**\n * A type that represents a FormData-like object, which is a plain object with\n * nested Blob, File, or FileList values. Or a FormData instance.\n */\nexport type FormDataLike = FormData | Record<string, Blob | File | FileList>\n\n/**\n * Predicate to check if a value is FormData-like, meaning it is a plain object\n * with nested Blob, File, or FileList values.\n *\n * @param value The value to check.\n * @returns `true` if the value is FormData-like, `false` otherwise.\n * @example isFormDataLike({ file: new File(['test'], 'test.txt') }) // true\n */\nexport function isFormDataLike(value: unknown): value is FormDataLike {\n  if (typeof value !== 'object' || value === null) return false\n  if (value instanceof FormData) return true\n  const values = Object.values(value)\n  if (values.length === 0) return false\n  return values.every((x) => {\n    if (x instanceof File) return true\n    if (Array.isArray(x)) return x.every(item => item instanceof File)\n    return x instanceof Blob\n  })\n}\n","import type { FormDataLike } from './isFormDataLike'\n\n/**\n * Casts an object that may contain `Blob`, `File`, or `FileList` values to a `FormData` object.\n *\n * @param object The object to cast to a `FormData` object.\n * @returns The `FormData` object.\n */\nexport function toFormData(object: FormDataLike): FormData {\n  if (object instanceof FormData) return object\n  const formData = new FormData()\n  for (const key in object) {\n    const value = object[key]\n    if (value === undefined) continue\n    if (Array.isArray(value)) {\n      for (const item of value)\n        formData.append(key, item as Blob | string)\n    }\n    else {\n      formData.append(key, value as Blob | string)\n    }\n  }\n  return formData\n}\n","import type { FetchOptions, RequestContext } from './parseRequest'\nimport { isFormDataLike } from './isFormDataLike'\nimport { isObjectLike } from './isObjectLike'\nimport { toFormData } from './toFormData'\n\n/**\n * Parse the request body based on the provided data and options.\n *\n * @param context The request context.\n * @param options The request options.\n */\nexport function parseRequestBody(context: RequestContext, options: FetchOptions): void {\n  const { body } = options\n\n  // --- If the method is `GET`, `HEAD`, or `DELETE`, return early.\n  if (!context.init?.method) return\n  if (['get', 'head', 'delete'].includes(context.init.method ?? 'get')) return\n\n  // --- If no data is provided, return early.\n  if (body === null || body === undefined) return\n\n  // --- If data contains a `File` object, create a FormData object.\n  if (isFormDataLike(body)) {\n    context.init.body = toFormData(body)\n    context.init.headers = context.init.headers ?? {}\n    context.init.headers = { ...context.init.headers, 'Content-Type': 'multipart/form-data' }\n  }\n\n  // --- If the data is a `ReadableStream`, pass it directly to the body.\n  else if (body instanceof ReadableStream) {\n    context.init.body = body\n    context.init.headers = context.init.headers ?? {}\n    context.init.headers = { ...context.init.headers, 'Content-Type': 'application/octet-stream' }\n  }\n\n  // --- If the data is a Blob, pass it directly to the body.\n  else if (body instanceof File) {\n    context.init.body = body.stream()\n    context.init.headers = context.init.headers ?? {}\n    context.init.headers = { ...context.init.headers, 'Content-Type': 'application/octet-stream' }\n  }\n\n  // --- Otherwise, stringify the data and set the content type to JSON.\n  else if (isObjectLike(body)) {\n    context.init.body = JSON.stringify(body)\n    context.init.headers = context.init.headers ?? {}\n    context.init.headers = { ...context.init.headers, 'Content-Type': 'application/json' }\n  }\n\n  // --- For all other data types, set the body directly.\n  else {\n    context.init.body = body as BodyInit\n  }\n}\n","import type { FetchOptions, RequestContext } from './parseRequest'\n\n/**\n * Parse the request headers based on the provided data and options.\n *\n * @param context The request context.\n * @param options The request options.\n * @example\n *\n * // Append the `Content-Type` header to the request.\n * const context = {}\n * parseRequestHeaders(context, { headers: { 'Content-Type': 'application/json' } })\n *\n * // Will mutate the `init` object to include the headers.\n * console.log(context) // => { init: { headers: { 'Content-Type': 'application/json' } } }\n */\nexport function parseRequestHeaders(context: RequestContext, options: FetchOptions): void {\n  const { headers } = options\n\n  // --- Merge the headers with the existing headers.\n  for (const key in headers) {\n    const value = headers[key]\n    if (((typeof value !== 'string' || value.length === 0) && typeof value !== 'number')) continue\n    context.init = context.init ?? {}\n    context.init.headers = context.init.headers ?? {}\n    context.init.headers = { ...context.init.headers, [key]: String(value) }\n  }\n}\n","import type { FetchOptions, RequestContext } from './parseRequest'\n\n/** Regular expression to match path parameters in the URL. */\nconst EXP_PATH_PARAMETER = /:([\\w-]+)|%7B([\\w-]+)%7D/g\n\n/**\n * Parse the request parameters from the request data. This function will mutate the\n * `url` object of the context to include the path parameters based on the provided data.\n *\n * @param context The request context to mutate.\n * @param options The options to pass to the request.\n * @example\n *\n * // Using `express` style path parameters.\n * const context = { url: new URL('https://api.example.com/users/:id') }\n * parseRequestParameters(context, { parameters: { id: 1 } })\n * console.log(context.url.pathname) // 'https://api.example.com/users/1'\n *\n * // Using `OpenAPI` style path parameters.\n * const context = { url: new URL('https://api.example.com/users/{id}') }\n * parseRequestParameters(context, { parameters: { id: 1 } })\n * console.log(context.url.pathname) // 'https://api.example.com/users/1'\n */\nexport function parseRequestParameters(context: RequestContext, options: FetchOptions): void {\n  const { url } = context\n  const { parameters } = options\n\n  // --- Return early if the parameters is not an object.\n  if (typeof parameters !== 'object' || parameters === null) return\n  if (url === undefined) return\n  if (url instanceof URL === false) throw new Error('The `url` must be an instance of `URL`.')\n\n  // --- If the method has a parameter, fill the path with the data.\n  const pathParameters = url.pathname.match(EXP_PATH_PARAMETER)\n  if (!pathParameters) return\n\n  // --- Apply the path parameters to the URL.\n  for (const parameter of pathParameters.values()) {\n    const key = parameter.replaceAll(EXP_PATH_PARAMETER, '$1$2')\n    const value = parameters[key]\n\n    // --- If the parameter is provided, replace the path with the value.\n    if (\n      (typeof value === 'string' && value.length > 0)\n      || (typeof value === 'number' && Number.isFinite(value))\n      || (typeof value === 'boolean')\n    ) {\n      url.pathname = url.pathname.replace(parameter, value.toString())\n      delete parameters[key]\n    }\n  }\n}\n","/* eslint-disable unicorn/prevent-abbreviations */\nimport type { MaybeArray } from '@unshared/types'\n\n/** An object that can be converted to a query string. */\nexport type SearchParamsObject = Record<string, MaybeArray<boolean | number | string> | undefined>\n\n/** The search array format options. */\nexport type SearchArrayFormat = 'brackets' | 'comma' | 'flat' | 'indices' | 'path'\n\n/** Options for the query string conversion. */\nexport interface ToSearchParamsOptions {\n\n  /**\n   * Defines how to handle arrays in the object. There is no standard way to\n   * represent arrays in query strings, so this option allows you to choose\n   * how to handle them. Additionally, you can provide a custom function to\n   * handle it yourself.\n   *\n   * - `brackets` (default): Convert arrays to `key[]=value&key[]=value` format.\n   * - `indices`: Convert arrays to `key[0]=value&key[1]=value` format.\n   * - `comma`: Convert arrays to `key=value1,value2` format.\n   * - `path`: Convert arrays to `key.0=value&key.1=value` format.\n   * - `flat`: Convert arrays to `key=value1&key=value2` format.\n   *\n   * @default 'flat'\n   */\n  format?: SearchArrayFormat\n}\n\n/**\n * Convert object to query string parameters. Converting all values to strings\n * and arrays to `key[0]=value&key[1]=value` format.\n *\n * @param object The object to convert to a query string.\n * @param options The query string options.\n * @returns The `URLSearchParams` object.\n */\nexport function toSearchParams(object: SearchParamsObject, options: ToSearchParamsOptions = {}): URLSearchParams {\n  const { format = 'flat' } = options\n  const search = new URLSearchParams()\n  for (const key in object) {\n    const value = object[key]\n    if (value === undefined) continue\n\n    // --- Convert arrays based on the format.\n    if (Array.isArray(value)) {\n      if (format === 'brackets') for (const v of value) search.append(`${key}[]`, String(v))\n      else if (format === 'indices') for (const [i, v] of value.entries()) search.append(`${key}[${i}]`, String(v))\n      else if (format === 'comma') search.append(key, value.join(','))\n      else if (format === 'path') for (const [i, v] of value.entries()) search.append(`${key}.${i}`, String(v))\n      else if (format === 'flat') for (const v of value) search.append(key, String(v))\n    }\n\n    // --- Convert all values to strings.\n    else { search.append(key, value.toString()) }\n  }\n\n  // --- Return the query string.\n  return search\n}\n","/* eslint-disable unicorn/prevent-abbreviations */\nimport type { FetchOptions, RequestContext } from './parseRequest'\nimport type { SearchParamsObject as SearchParametersObject } from './toSearchParams'\nimport { toSearchParams } from './toSearchParams'\n\n/**\n * Parse the query parameters from the request data. This function will append\n * the query parameters to the URL based on the method and the data provided.\n *\n * @param context The request context to modify.\n * @param options The options to pass to the request.\n */\nexport function parseRequestQuery(context: RequestContext, options: FetchOptions): void {\n  const { url } = context\n  const { query, queryArrayFormat } = options\n\n  // --- Return early if the query is not an object or the URL is not provided.\n  if (url === undefined) return\n  if (url instanceof URL === false) throw new Error('The `url` must be an instance of `URL.')\n  if (typeof query !== 'object' || query === null) return\n\n  // --- Append the `data` to the query parameters if the method does not expect a body.\n  const queryObject: SearchParametersObject = {}\n  for (const key in query) {\n    const value = query[key]\n    if (\n      (typeof value === 'string' && value.length > 0)\n      || (typeof value === 'number' && Number.isFinite(value))\n      || (typeof value === 'boolean')\n      || Array.isArray(value) && value.length > 0 && value.every(v => typeof v === 'string' || typeof v === 'number' || typeof v === 'boolean')\n    ) {\n      queryObject[key] = value\n      delete query[key]\n    }\n  }\n\n  // --- Apply the query parameters to the URL.\n  url.search = toSearchParams(queryObject, { format: queryArrayFormat }).toString()\n}\n","import type { FetchOptions, RequestContext } from './parseRequest'\n\n/** Regular expression to match the request method and URL. */\nconst EXP_REQUEST = /^((?<method>[a-z]+) )?(?<url>[^:]+?:\\/{2}[^/]+)?(?<path>\\/[^\\s?]*)/i\n\n/** Valid HTTP methods. */\nconst METHODS = new Set(['get', 'post', 'put', 'patch', 'delete', 'head', 'options'])\n\n/**\n * Parses the route name to extract the URL and method. It allows the url and method to be\n * provided in the route name, or in the options object. The method will default to 'get'.\n *\n * @param context The request context to mutate.\n * @param route The name of the route to fetch.\n * @param options The options to pass to the request.\n * @example parseRequestUrl('GET /users', { baseUrl: 'https://api.example.com' }, context)\n */\nexport function parseRequestUrl(context: RequestContext, route: string, options: FetchOptions): void {\n  const { method, baseUrl } = options\n\n  // --- Extract the path, method, and base URL from the route name.\n  const match = EXP_REQUEST.exec(route)\n  if (!match?.groups) throw new Error('Could not resolve the `RequestInit` object: Invalid route name.')\n  const routeMethod = method ?? match.groups.method ?? 'get'\n  const routeBaseUrl = baseUrl ?? match.groups.url\n\n  // --- Assert the base URL is provided, either in the options or the route name.\n  if (!routeBaseUrl) throw new Error('Could not resolve the `RequestInit` object: the `baseUrl` is missing.')\n\n  // --- Assert the method is valid.\n  const methodLower = routeMethod.toLowerCase()\n  const methodIsValid = METHODS.has(methodLower)\n  if (!methodIsValid) throw new Error(`Could not resolve the \\`RequestInit\\` object:, the method \\`${routeMethod}\\` is invalid.`)\n\n  // --- Create the url and apply the method.\n  context.init = context.init ?? {}\n  context.init.method = methodLower\n  context.url = new URL(routeBaseUrl)\n\n  // --- Append the path to the URL while making sure there are no double slashes.\n  context.url.pathname += context.url.pathname.endsWith('/') ? match.groups.path.slice(1) : match.groups.path\n}\n","import type { Loose, MaybeLiteral, ObjectLike } from '@unshared/types'\nimport type { UnionMerge } from '@unshared/types'\nimport type { HttpHeader } from '../HttpHeaders'\nimport type { HttpMethod } from '../HttpMethods'\nimport type { SearchArrayFormat } from './toSearchParams'\nimport { isObjectLike } from './isObjectLike'\nimport { parseRequestBody } from './parseRequestBody'\nimport { parseRequestHeaders } from './parseRequestHeaders'\nimport { parseRequestParameters } from './parseRequestParameters'\nimport { parseRequestQuery } from './parseRequestQuery'\nimport { parseRequestUrl } from './parseRequestUrl'\n\n/** The methods to use for the request. */\nexport type FetchMethod = Lowercase<keyof typeof HttpMethod> | Uppercase<keyof typeof HttpMethod>\n\n/** Headers to include in the request. */\nexport type FetchHeaders = Partial<Record<MaybeLiteral<HttpHeader>, number | string>>\n\n/** Options to pass to the request. */\nexport interface FetchOptions<\n  Method extends FetchMethod = FetchMethod,\n  BaseUrl extends string = string,\n  Parameters extends ObjectLike = ObjectLike,\n  Query extends ObjectLike = ObjectLike,\n  Body = unknown,\n  Headers extends ObjectLike = ObjectLike,\n> extends Omit<RequestInit, 'body' | 'headers' | 'method'> {\n\n  /**\n   * The method to use for the request.\n   *\n   * @example 'GET'\n   */\n  method?: Method\n\n  /**\n   * The base URL to use for the request. This URL will be used to resolve the\n   * path and query parameters of the request.\n   *\n   * @example 'https://api.example.com'\n   */\n  baseUrl?: BaseUrl\n\n  /**\n   * The data to include in the request. This data will be used to populate the\n   * query parameters, body, and headers of the request based on the method type.\n   *\n   * @example { id: 1 }\n   */\n  data?: Loose<UnionMerge<Body | Headers | Query>>\n\n  /**\n   * The path parameters to include in the request.\n   */\n  parameters?: Parameters\n\n  /**\n   * The query parameters to include in the request.\n   */\n  query?: Loose<Query>\n\n  /**\n   * The format to use when serializing the query parameters.\n   */\n  queryArrayFormat?: SearchArrayFormat\n\n  /**\n   * The body to include in the request.\n   */\n  body?: Body extends ObjectLike ? Loose<Body> : Body\n\n  /**\n   * The headers to include in the request.\n   */\n  headers?: FetchHeaders & Headers\n}\n\nexport interface RequestContext {\n  url?: URL\n  init?: RequestInit\n}\n\n/**\n * Resolves the request body and/or query parameters based on the method type. This function\n * will mutate the `init` object to include the request body and headers based on the data type.\n *\n * @param route The name of the route to fetch.\n * @param options The options to pass to the request.\n * @returns The URL and the `RequestInit` object.\n */\nexport function parseRequest(route: string, options: FetchOptions = {}): RequestContext {\n  const { data, body, query, parameters, headers, method, baseUrl, queryArrayFormat, ...init } = options\n  const context: RequestContext = { init }\n  const dataObject = isObjectLike(data) ? data : undefined\n\n  // --- Parse the URL and insert the path parameters.\n  parseRequestUrl(context, route, { baseUrl, method })\n  parseRequestParameters(context, { parameters: parameters ?? dataObject })\n\n  // --- Depending on the method, parse the query, body, and headers.\n  const requestMethod = context.init?.method?.toLowerCase() ?? 'get'\n  const requestExpectsBody = ['post', 'put', 'patch'].includes(requestMethod)\n  parseRequestQuery(context, { queryArrayFormat, query: requestExpectsBody ? query : query ?? dataObject })\n  parseRequestBody(context, { body: requestExpectsBody ? body ?? dataObject : undefined })\n  parseRequestHeaders(context, { headers })\n\n  // --- Return the context with the URL and the `RequestInit` object.\n  return context\n}\n","import type { FetchOptions } from './parseRequest'\nimport { parseRequest } from './parseRequest'\n\n/**\n * Fetch a route with the provided options. This function will parse the route and\n * options to create a `Request` object and return the response from the server.\n *\n * @param route The name of the route to fetch.\n * @param options The options to pass to the request.\n * @returns The response from the server.\n * @example fetch('GET /users', { query: { limit: 10 } })\n */\nexport async function fetch(route: string, options?: FetchOptions): Promise<Response>\nexport async function fetch(route: string, options: FetchOptions = {}): Promise<Response> {\n  const { url, init } = parseRequest(route, options)\n  if (!url) throw new Error('Could not parse request URL')\n  return await globalThis.fetch(url, init)\n}\n","import type { Awaitable } from '@unshared/functions/awaitable'\nimport type { RequestOptions } from './request'\nimport { awaitable } from '@unshared/functions/awaitable'\n\nasync function * createResponseStreamJsonIterator(response: Response, options: RequestOptions): AsyncGenerator<unknown, void, unknown> {\n  const { onError, onSuccess, onData, onEnd } = options\n  try {\n    const body = response.body\n    if (body === null) throw new Error('Could not read the response body, it is empty.')\n    const reader = body.getReader()\n    while (true) {\n      const { done, value } = await reader.read()\n      if (done) break\n      const parts = new TextDecoder().decode(value).trim().split('\\0').filter(Boolean)\n\n      // --- For each part, parse as JSON and yield the data.\n      for (const part of parts) {\n        const payload = JSON.parse(part) as unknown\n        if (onData) onData(payload)\n        yield payload\n      }\n    }\n    if (onSuccess) onSuccess(response)\n  }\n  catch (error) {\n    if (onError) onError(error as Error)\n  }\n  finally {\n    if (onEnd) onEnd(response)\n  }\n}\n\n/**\n * Handle a request response where the content type is a stream of JSON objects. This function\n * will parse the JSON objects and yield the data to the caller. If an error occurs, the `onError`\n * callback will be called and the function will return.\n *\n * @param response The response to handle.\n * @param options The options to pass to the request.\n * @returns An awaitable iterator that yields the parsed JSON objects.\n */\nexport function handleResponseStreamJson(response: Response, options: RequestOptions): Awaitable<AsyncIterable<unknown>, unknown[]> {\n  const responseIterator = createResponseStreamJsonIterator(response, options)\n  return awaitable(responseIterator)\n}\n","import type { RequestOptions } from './request'\nimport { handleResponseStreamJson } from './handleResponseStreamJson'\n\n/**\n * Handle a request response. This function will parse the response based on the content type and\n * return the data. If an error occurs, the `onError` callback will be called and the function will\n * throw an error.\n *\n * @param response The response to handle.\n * @param options The options to pass to the request.\n * @returns The parsed data from the response.\n */\nexport async function handleResponse(response: Response, options: RequestOptions = {}): Promise<unknown> {\n  const { onError, onSuccess, onData, onEnd, onFailure } = options\n  const contentType = response.headers.get('Content-Type')\n\n  // --- If the response is not OK, throw an error with the response message.\n  if (!response.ok) {\n    if (onFailure) onFailure(response)\n    if (onEnd) onEnd(response)\n    throw new Error(response.statusText)\n  }\n\n  // --- If the status code is 204, return an empty response early.\n  if (response.status === 204) {\n    if (onSuccess) onSuccess(response)\n    if (onEnd) onEnd(response)\n    return\n  }\n\n  // --- If the response is a text content type, return the text response.\n  if (contentType?.startsWith('text/')) {\n    return await response.text()\n      .then((data) => {\n        if (onData) onData(data)\n        if (onSuccess) onSuccess(response)\n        return data\n      })\n      .catch((error: Error) => {\n        if (onError) onError(error)\n        throw error\n      })\n      .finally(() => {\n        if (onEnd) onEnd(response)\n      })\n  }\n\n  // --- If the response is a application/json, parse the JSON and return it.\n  if (contentType === 'application/json') {\n    return await response.json()\n      .then((data) => {\n        if (onData) onData(data)\n        if (onSuccess) onSuccess(response)\n        return data as unknown\n      })\n      .catch((error: Error) => {\n        if (onError) onError(error)\n        throw error\n      })\n      .finally(() => {\n        if (onEnd) onEnd(response)\n      })\n  }\n\n  // --- If the response is a application/stream+json, return an iterator that parses the JSON.\n  if (contentType === 'application/stream+json')\n    return handleResponseStreamJson(response, options)\n\n  // --- Otherwise, fallback to returning the response body as-is.\n  if (onSuccess) onSuccess(response)\n  if (onEnd) onEnd(response)\n  return response.body\n}\n"],"names":[],"mappings":"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"}