@unshared/client 0.3.0 → 0.3.1

package/dist/chunks/0ZzUT3m_.js

@@ -0,0 +1,46 @@
+const EXP_PATH_PARAMETER = /:([\w-]+)|%7B([\w-]+)%7D/g;
+function parseRequestParameters(context, options) {
+  const { url } = context, { parameters } = options;
+  if (typeof parameters != "object" || parameters === null || url === void 0) return;
+  if (!(url instanceof URL)) throw new Error("The `url` must be an instance of `URL`.");
+  const pathParameters = url.pathname.match(EXP_PATH_PARAMETER);
+  if (pathParameters)
+    for (const parameter of pathParameters.values()) {
+      const key = parameter.replaceAll(EXP_PATH_PARAMETER, "$1$2"), value = parameters[key];
+      (typeof value == "string" && value.length > 0 || typeof value == "number" && Number.isFinite(value) || typeof value == "boolean") && (url.pathname = url.pathname.replace(parameter, value.toString()), delete parameters[key]);
+    }
+}
+function toSearchParams(object, options = {}) {
+  const { format = "flat" } = options, search = new URLSearchParams();
+  for (const key in object) {
+    const value = object[key];
+    if (value !== void 0)
+      if (Array.isArray(value)) {
+        if (format === "brackets") for (const v of value) search.append(`${key}[]`, String(v));
+        else if (format === "indices") for (const [i, v] of value.entries()) search.append(`${key}[${i}]`, String(v));
+        else if (format === "comma") search.append(key, value.join(","));
+        else if (format === "path") for (const [i, v] of value.entries()) search.append(`${key}.${i}`, String(v));
+        else if (format === "flat") for (const v of value) search.append(key, String(v));
+      } else
+        search.append(key, value.toString());
+  }
+  return search;
+}
+function parseRequestQuery(context, options) {
+  const { url } = context, { query, queryArrayFormat } = options;
+  if (url === void 0) return;
+  if (!(url instanceof URL)) throw new Error("The `url` must be an instance of `URL.");
+  if (typeof query != "object" || query === null) return;
+  const queryObject = {};
+  for (const key in query) {
+    const value = query[key];
+    (typeof value == "string" && value.length > 0 || typeof value == "number" && Number.isFinite(value) || typeof value == "boolean" || Array.isArray(value) && value.length > 0 && value.every((v) => typeof v == "string" || typeof v == "number" || typeof v == "boolean")) && (queryObject[key] = value, delete query[key]);
+  }
+  url.search = toSearchParams(queryObject, { format: queryArrayFormat }).toString();
+}
+export {
+  parseRequestQuery as a,
+  parseRequestParameters as p,
+  toSearchParams as t
+};
+//# sourceMappingURL=0ZzUT3m_.js.map

package/dist/chunks/0ZzUT3m_.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"0ZzUT3m_.js","sources":["../../utils/parseRequestParameters.ts","../../utils/toSearchParams.ts","../../utils/parseRequestQuery.ts"],"sourcesContent":["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"],"names":[],"mappings":"AAGA,MAAM,qBAAqB;AAoBX,SAAA,uBAAuB,SAAyB,SAA6B;AAC3F,QAAM,EAAE,IAAI,IAAI,SACV,EAAE,WAAe,IAAA;AAIvB,MADI,OAAO,cAAe,YAAY,eAAe,QACjD,QAAQ,OAAW;AACvB,MAAI,EAAe,eAAA,KAAqB,OAAA,IAAI,MAAM,yCAAyC;AAG3F,QAAM,iBAAiB,IAAI,SAAS,MAAM,kBAAkB;AACvD,MAAA;AAGM,eAAA,aAAa,eAAe,UAAU;AACzC,YAAA,MAAM,UAAU,WAAW,oBAAoB,MAAM,GACrD,QAAQ,WAAW,GAAG;AAG5B,OACG,OAAO,SAAU,YAAY,MAAM,SAAS,KACzC,OAAO,SAAU,YAAY,OAAO,SAAS,KAAK,KAClD,OAAO,SAAU,eAErB,IAAI,WAAW,IAAI,SAAS,QAAQ,WAAW,MAAM,SAAA,CAAU,GAC/D,OAAO,WAAW,GAAG;AAAA,IAAA;AAG3B;ACdO,SAAS,eAAe,QAA4B,UAAiC,IAAqB;AAC/G,QAAM,EAAE,SAAS,OAAA,IAAW,SACtB,SAAS,IAAI,gBAAgB;AACnC,aAAW,OAAO,QAAQ;AAClB,UAAA,QAAQ,OAAO,GAAG;AACxB,QAAI,UAAU;AAGV,UAAA,MAAM,QAAQ,KAAK;AACrB,YAAI,WAAW,WAAuB,YAAA,KAAK,MAAO,QAAO,OAAO,GAAG,GAAG,MAAM,OAAO,CAAC,CAAC;AAAA,iBAC5E,WAAW,UAAW,YAAW,CAAC,GAAG,CAAC,KAAK,MAAM,UAAkB,QAAA,OAAO,GAAG,GAAG,IAAI,CAAC,KAAK,OAAO,CAAC,CAAC;AAAA,iBACnG,WAAW,QAAgB,QAAA,OAAO,KAAK,MAAM,KAAK,GAAG,CAAC;AAAA,iBACtD,WAAW,OAAQ,YAAW,CAAC,GAAG,CAAC,KAAK,MAAM,UAAkB,QAAA,OAAO,GAAG,GAAG,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC;AAAA,iBAC/F,WAAW,OAAQ,YAAW,KAAK,cAAc,OAAO,KAAK,OAAO,CAAC,CAAC;AAAA;AAI1E,eAAO,OAAO,KAAK,MAAM,SAAA,CAAU;AAAA,EAAA;AAIrC,SAAA;AACT;AC/CgB,SAAA,kBAAkB,SAAyB,SAA6B;AACtF,QAAM,EAAE,IAAI,IAAI,SACV,EAAE,OAAO,qBAAqB;AAGpC,MAAI,QAAQ,OAAW;AACvB,MAAI,EAAe,eAAA,KAAqB,OAAA,IAAI,MAAM,wCAAwC;AAC1F,MAAI,OAAO,SAAU,YAAY,UAAU,KAAM;AAGjD,QAAM,cAAsC,CAAC;AAC7C,aAAW,OAAO,OAAO;AACjB,UAAA,QAAQ,MAAM,GAAG;AACvB,KACG,OAAO,SAAU,YAAY,MAAM,SAAS,KACzC,OAAO,SAAU,YAAY,OAAO,SAAS,KAAK,KAClD,OAAO,SAAU,aAClB,MAAM,QAAQ,KAAK,KAAK,MAAM,SAAS,KAAK,MAAM,MAAM,CAAA,MAAK,OAAO,KAAM,YAAY,OAAO,KAAM,YAAY,OAAO,KAAM,SAAS,OAExI,YAAY,GAAG,IAAI,OACnB,OAAO,MAAM,GAAG;AAAA,EAAA;AAKhB,MAAA,SAAS,eAAe,aAAa,EAAE,QAAQ,iBAAiB,CAAC,EAAE,SAAS;AAClF;"}

package/dist/chunks/{D51s1VII.js → BUeqbyph.js}

@@ -1,3 +1,4 @@
+import { p as parseRequestParameters, a as parseRequestQuery } from "./0ZzUT3m_.js";
 import { awaitable } from "@unshared/functions/awaitable";
 function isObjectLike(value) {
   return typeof value == "object" && value !== null && value.constructor === Object;
@@ -33,46 +34,6 @@ function parseRequestHeaders(context, options) {
     (typeof value != "string" || value.length === 0) && typeof value != "number" || (context.init = context.init ?? {}, context.init.headers = context.init.headers ?? {}, context.init.headers = { ...context.init.headers, [key]: String(value) });
   }
 }
-const EXP_PATH_PARAMETER = /:([\w-]+)|%7B([\w-]+)%7D/g;
-function parseRequestParameters(context, options) {
-  const { url } = context, { parameters } = options;
-  if (typeof parameters != "object" || parameters === null || url === void 0) return;
-  if (!(url instanceof URL)) throw new Error("The `url` must be an instance of `URL`.");
-  const pathParameters = url.pathname.match(EXP_PATH_PARAMETER);
-  if (pathParameters)
-    for (const parameter of pathParameters.values()) {
-      const key = parameter.replaceAll(EXP_PATH_PARAMETER, "$1$2"), value = parameters[key];
-      (typeof value == "string" && value.length > 0 || typeof value == "number" && Number.isFinite(value) || typeof value == "boolean") && (url.pathname = url.pathname.replace(parameter, value.toString()), delete parameters[key]);
-    }
-}
-function toSearchParams(object, options = {}) {
-  const { format = "flat" } = options, search = new URLSearchParams();
-  for (const key in object) {
-    const value = object[key];
-    if (value !== void 0)
-      if (Array.isArray(value)) {
-        if (format === "brackets") for (const v of value) search.append(`${key}[]`, String(v));
-        else if (format === "indices") for (const [i, v] of value.entries()) search.append(`${key}[${i}]`, String(v));
-        else if (format === "comma") search.append(key, value.join(","));
-        else if (format === "path") for (const [i, v] of value.entries()) search.append(`${key}.${i}`, String(v));
-        else if (format === "flat") for (const v of value) search.append(key, String(v));
-      } else
-        search.append(key, value.toString());
-  }
-  return search;
-}
-function parseRequestQuery(context, options) {
-  const { url } = context, { query, queryArrayFormat } = options;
-  if (url === void 0) return;
-  if (!(url instanceof URL)) throw new Error("The `url` must be an instance of `URL.");
-  if (typeof query != "object" || query === null) return;
-  const queryObject = {};
-  for (const key in query) {
-    const value = query[key];
-    (typeof value == "string" && value.length > 0 || typeof value == "number" && Number.isFinite(value) || typeof value == "boolean" || Array.isArray(value) && value.length > 0 && value.every((v) => typeof v == "string" || typeof v == "number" || typeof v == "boolean")) && (queryObject[key] = value, delete query[key]);
-  }
-  url.search = toSearchParams(queryObject, { format: queryArrayFormat }).toString();
-}
 const EXP_REQUEST = /^((?<method>[a-z]+) )?(?<url>[^:]+?:\/{2}[^/]+)?(?<path>\/[^\s?]*)/i, METHODS = /* @__PURE__ */ new Set(["get", "post", "put", "patch", "delete", "head", "options"]);
 function parseRequestUrl(context, route, options) {
   const { method, baseUrl } = options, match = EXP_REQUEST.exec(route);
@@ -143,14 +104,11 @@ export {
   isObjectLike as b,
   parseRequestBody as c,
   parseRequestHeaders as d,
-  parseRequestParameters as e,
+  parseRequestUrl as e,
   fetch as f,
-  parseRequestQuery as g,
   handleResponse as h,
   isFormDataLike as i,
-  parseRequestUrl as j,
-  toSearchParams as k,
   parseRequest as p,
   toFormData as t
 };
-//# sourceMappingURL=D51s1VII.js.map
+//# sourceMappingURL=BUeqbyph.js.map

package/dist/chunks/BUeqbyph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BUeqbyph.js","sources":["../../utils/isObjectLike.ts","../../utils/isFormDataLike.ts","../../utils/toFormData.ts","../../utils/parseRequestBody.ts","../../utils/parseRequestHeaders.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 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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"}

package/dist/chunks/{B92aAMq0.d.ts → CO11DuYE.d.ts}

@@ -141,4 +141,4 @@ interface RequestOptions<Method extends FetchMethod = FetchMethod, BaseUrl exten
  */
 declare function request(route: string, options?: RequestOptions): Promise<unknown>;
 
-export { type FetchMethod as F, type RequestContext as R, type SearchParamsObject as S, type ToSearchParamsOptions as T, type FetchHeaders as a, type FetchOptions as b, type RequestOptions as c, type SearchArrayFormat as d, parseRequest as p, request as r, toSearchParams as t };
+export { type FetchMethod as F, type RequestOptions as R, type SearchParamsObject as S, type ToSearchParamsOptions as T, type FetchOptions as a, type RequestContext as b, type FetchHeaders as c, type SearchArrayFormat as d, parseRequest as p, request as r, toSearchParams as t };

package/dist/chunks/CYmaYL5B.cjs

@@ -0,0 +1,45 @@
+"use strict";
+const EXP_PATH_PARAMETER = /:([\w-]+)|%7B([\w-]+)%7D/g;
+function parseRequestParameters(context, options) {
+  const { url } = context, { parameters } = options;
+  if (typeof parameters != "object" || parameters === null || url === void 0) return;
+  if (!(url instanceof URL)) throw new Error("The `url` must be an instance of `URL`.");
+  const pathParameters = url.pathname.match(EXP_PATH_PARAMETER);
+  if (pathParameters)
+    for (const parameter of pathParameters.values()) {
+      const key = parameter.replaceAll(EXP_PATH_PARAMETER, "$1$2"), value = parameters[key];
+      (typeof value == "string" && value.length > 0 || typeof value == "number" && Number.isFinite(value) || typeof value == "boolean") && (url.pathname = url.pathname.replace(parameter, value.toString()), delete parameters[key]);
+    }
+}
+function toSearchParams(object, options = {}) {
+  const { format = "flat" } = options, search = new URLSearchParams();
+  for (const key in object) {
+    const value = object[key];
+    if (value !== void 0)
+      if (Array.isArray(value)) {
+        if (format === "brackets") for (const v of value) search.append(`${key}[]`, String(v));
+        else if (format === "indices") for (const [i, v] of value.entries()) search.append(`${key}[${i}]`, String(v));
+        else if (format === "comma") search.append(key, value.join(","));
+        else if (format === "path") for (const [i, v] of value.entries()) search.append(`${key}.${i}`, String(v));
+        else if (format === "flat") for (const v of value) search.append(key, String(v));
+      } else
+        search.append(key, value.toString());
+  }
+  return search;
+}
+function parseRequestQuery(context, options) {
+  const { url } = context, { query, queryArrayFormat } = options;
+  if (url === void 0) return;
+  if (!(url instanceof URL)) throw new Error("The `url` must be an instance of `URL.");
+  if (typeof query != "object" || query === null) return;
+  const queryObject = {};
+  for (const key in query) {
+    const value = query[key];
+    (typeof value == "string" && value.length > 0 || typeof value == "number" && Number.isFinite(value) || typeof value == "boolean" || Array.isArray(value) && value.length > 0 && value.every((v) => typeof v == "string" || typeof v == "number" || typeof v == "boolean")) && (queryObject[key] = value, delete query[key]);
+  }
+  url.search = toSearchParams(queryObject, { format: queryArrayFormat }).toString();
+}
+exports.parseRequestParameters = parseRequestParameters;
+exports.parseRequestQuery = parseRequestQuery;
+exports.toSearchParams = toSearchParams;
+//# sourceMappingURL=CYmaYL5B.cjs.map

package/dist/chunks/CYmaYL5B.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CYmaYL5B.cjs","sources":["../../utils/parseRequestParameters.ts","../../utils/toSearchParams.ts","../../utils/parseRequestQuery.ts"],"sourcesContent":["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"],"names":[],"mappings":";AAGA,MAAM,qBAAqB;AAoBX,SAAA,uBAAuB,SAAyB,SAA6B;AAC3F,QAAM,EAAE,IAAI,IAAI,SACV,EAAE,WAAe,IAAA;AAIvB,MADI,OAAO,cAAe,YAAY,eAAe,QACjD,QAAQ,OAAW;AACvB,MAAI,EAAe,eAAA,KAAqB,OAAA,IAAI,MAAM,yCAAyC;AAG3F,QAAM,iBAAiB,IAAI,SAAS,MAAM,kBAAkB;AACvD,MAAA;AAGM,eAAA,aAAa,eAAe,UAAU;AACzC,YAAA,MAAM,UAAU,WAAW,oBAAoB,MAAM,GACrD,QAAQ,WAAW,GAAG;AAG5B,OACG,OAAO,SAAU,YAAY,MAAM,SAAS,KACzC,OAAO,SAAU,YAAY,OAAO,SAAS,KAAK,KAClD,OAAO,SAAU,eAErB,IAAI,WAAW,IAAI,SAAS,QAAQ,WAAW,MAAM,SAAA,CAAU,GAC/D,OAAO,WAAW,GAAG;AAAA,IAAA;AAG3B;ACdO,SAAS,eAAe,QAA4B,UAAiC,IAAqB;AAC/G,QAAM,EAAE,SAAS,OAAA,IAAW,SACtB,SAAS,IAAI,gBAAgB;AACnC,aAAW,OAAO,QAAQ;AAClB,UAAA,QAAQ,OAAO,GAAG;AACxB,QAAI,UAAU;AAGV,UAAA,MAAM,QAAQ,KAAK;AACrB,YAAI,WAAW,WAAuB,YAAA,KAAK,MAAO,QAAO,OAAO,GAAG,GAAG,MAAM,OAAO,CAAC,CAAC;AAAA,iBAC5E,WAAW,UAAW,YAAW,CAAC,GAAG,CAAC,KAAK,MAAM,UAAkB,QAAA,OAAO,GAAG,GAAG,IAAI,CAAC,KAAK,OAAO,CAAC,CAAC;AAAA,iBACnG,WAAW,QAAgB,QAAA,OAAO,KAAK,MAAM,KAAK,GAAG,CAAC;AAAA,iBACtD,WAAW,OAAQ,YAAW,CAAC,GAAG,CAAC,KAAK,MAAM,UAAkB,QAAA,OAAO,GAAG,GAAG,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC;AAAA,iBAC/F,WAAW,OAAQ,YAAW,KAAK,cAAc,OAAO,KAAK,OAAO,CAAC,CAAC;AAAA;AAI1E,eAAO,OAAO,KAAK,MAAM,SAAA,CAAU;AAAA,EAAA;AAIrC,SAAA;AACT;AC/CgB,SAAA,kBAAkB,SAAyB,SAA6B;AACtF,QAAM,EAAE,IAAI,IAAI,SACV,EAAE,OAAO,qBAAqB;AAGpC,MAAI,QAAQ,OAAW;AACvB,MAAI,EAAe,eAAA,KAAqB,OAAA,IAAI,MAAM,wCAAwC;AAC1F,MAAI,OAAO,SAAU,YAAY,UAAU,KAAM;AAGjD,QAAM,cAAsC,CAAC;AAC7C,aAAW,OAAO,OAAO;AACjB,UAAA,QAAQ,MAAM,GAAG;AACvB,KACG,OAAO,SAAU,YAAY,MAAM,SAAS,KACzC,OAAO,SAAU,YAAY,OAAO,SAAS,KAAK,KAClD,OAAO,SAAU,aAClB,MAAM,QAAQ,KAAK,KAAK,MAAM,SAAS,KAAK,MAAM,MAAM,CAAA,MAAK,OAAO,KAAM,YAAY,OAAO,KAAM,YAAY,OAAO,KAAM,SAAS,OAExI,YAAY,GAAG,IAAI,OACnB,OAAO,MAAM,GAAG;AAAA,EAAA;AAKhB,MAAA,SAAS,eAAe,aAAa,EAAE,QAAQ,iBAAiB,CAAC,EAAE,SAAS;AAClF;;;;"}

package/dist/chunks/{CfKxYeRr.cjs → Cayg8606.cjs}

@@ -1,5 +1,5 @@
 "use strict";
-var awaitable = require("@unshared/functions/awaitable");
+var parseRequestQuery = require("./CYmaYL5B.cjs"), awaitable = require("@unshared/functions/awaitable");
 function isObjectLike(value) {
   return typeof value == "object" && value !== null && value.constructor === Object;
 }
@@ -34,46 +34,6 @@ function parseRequestHeaders(context, options) {
     (typeof value != "string" || value.length === 0) && typeof value != "number" || (context.init = context.init ?? {}, context.init.headers = context.init.headers ?? {}, context.init.headers = { ...context.init.headers, [key]: String(value) });
   }
 }
-const EXP_PATH_PARAMETER = /:([\w-]+)|%7B([\w-]+)%7D/g;
-function parseRequestParameters(context, options) {
-  const { url } = context, { parameters } = options;
-  if (typeof parameters != "object" || parameters === null || url === void 0) return;
-  if (!(url instanceof URL)) throw new Error("The `url` must be an instance of `URL`.");
-  const pathParameters = url.pathname.match(EXP_PATH_PARAMETER);
-  if (pathParameters)
-    for (const parameter of pathParameters.values()) {
-      const key = parameter.replaceAll(EXP_PATH_PARAMETER, "$1$2"), value = parameters[key];
-      (typeof value == "string" && value.length > 0 || typeof value == "number" && Number.isFinite(value) || typeof value == "boolean") && (url.pathname = url.pathname.replace(parameter, value.toString()), delete parameters[key]);
-    }
-}
-function toSearchParams(object, options = {}) {
-  const { format = "flat" } = options, search = new URLSearchParams();
-  for (const key in object) {
-    const value = object[key];
-    if (value !== void 0)
-      if (Array.isArray(value)) {
-        if (format === "brackets") for (const v of value) search.append(`${key}[]`, String(v));
-        else if (format === "indices") for (const [i, v] of value.entries()) search.append(`${key}[${i}]`, String(v));
-        else if (format === "comma") search.append(key, value.join(","));
-        else if (format === "path") for (const [i, v] of value.entries()) search.append(`${key}.${i}`, String(v));
-        else if (format === "flat") for (const v of value) search.append(key, String(v));
-      } else
-        search.append(key, value.toString());
-  }
-  return search;
-}
-function parseRequestQuery(context, options) {
-  const { url } = context, { query, queryArrayFormat } = options;
-  if (url === void 0) return;
-  if (!(url instanceof URL)) throw new Error("The `url` must be an instance of `URL.");
-  if (typeof query != "object" || query === null) return;
-  const queryObject = {};
-  for (const key in query) {
-    const value = query[key];
-    (typeof value == "string" && value.length > 0 || typeof value == "number" && Number.isFinite(value) || typeof value == "boolean" || Array.isArray(value) && value.length > 0 && value.every((v) => typeof v == "string" || typeof v == "number" || typeof v == "boolean")) && (queryObject[key] = value, delete query[key]);
-  }
-  url.search = toSearchParams(queryObject, { format: queryArrayFormat }).toString();
-}
 const EXP_REQUEST = /^((?<method>[a-z]+) )?(?<url>[^:]+?:\/{2}[^/]+)?(?<path>\/[^\s?]*)/i, METHODS = /* @__PURE__ */ new Set(["get", "post", "put", "patch", "delete", "head", "options"]);
 function parseRequestUrl(context, route, options) {
   const { method, baseUrl } = options, match = EXP_REQUEST.exec(route);
@@ -86,9 +46,9 @@ function parseRequestUrl(context, route, options) {
 }
 function parseRequest(route, options = {}) {
   const { data, body, query, parameters, headers, method, baseUrl, queryArrayFormat, ...init } = options, context = { init }, dataObject = isObjectLike(data) ? data : void 0;
-  parseRequestUrl(context, route, { baseUrl, method }), parseRequestParameters(context, { parameters: parameters ?? dataObject });
+  parseRequestUrl(context, route, { baseUrl, method }), parseRequestQuery.parseRequestParameters(context, { parameters: parameters ?? dataObject });
   const requestMethod = context.init?.method?.toLowerCase() ?? "get", requestExpectsBody = ["post", "put", "patch"].includes(requestMethod);
-  return parseRequestQuery(context, { queryArrayFormat, query: requestExpectsBody ? query : query ?? dataObject }), parseRequestBody(context, { body: requestExpectsBody ? body ?? dataObject : void 0 }), parseRequestHeaders(context, { headers }), context;
+  return parseRequestQuery.parseRequestQuery(context, { queryArrayFormat, query: requestExpectsBody ? query : query ?? dataObject }), parseRequestBody(context, { body: requestExpectsBody ? body ?? dataObject : void 0 }), parseRequestHeaders(context, { headers }), context;
 }
 async function fetch(route, options = {}) {
   const { url, init } = parseRequest(route, options);
@@ -147,9 +107,6 @@ exports.isObjectLike = isObjectLike;
 exports.parseRequest = parseRequest;
 exports.parseRequestBody = parseRequestBody;
 exports.parseRequestHeaders = parseRequestHeaders;
-exports.parseRequestParameters = parseRequestParameters;
-exports.parseRequestQuery = parseRequestQuery;
 exports.parseRequestUrl = parseRequestUrl;
 exports.toFormData = toFormData;
-exports.toSearchParams = toSearchParams;
-//# sourceMappingURL=CfKxYeRr.cjs.map
+//# sourceMappingURL=Cayg8606.cjs.map

package/dist/chunks/Cayg8606.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cayg8606.cjs","sources":["../../utils/isObjectLike.ts","../../utils/isFormDataLike.ts","../../utils/toFormData.ts","../../utils/parseRequestBody.ts","../../utils/parseRequestHeaders.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 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":["parseRequestParameters","parseRequestQuery","awaitable"],"mappings":"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"}

package/dist/chunks/{lMH6B5BV.js → DJJsADWD.js}

@@ -1,4 +1,4 @@
-import { f as fetch, h as handleResponse } from "./D51s1VII.js";
+import { f as fetch, h as handleResponse } from "./BUeqbyph.js";
 async function request(route, options = {}) {
   const response = await fetch(route, options);
   return await handleResponse(response, options);
@@ -6,4 +6,4 @@ async function request(route, options = {}) {
 export {
   request as r
 };
-//# sourceMappingURL=lMH6B5BV.js.map
+//# sourceMappingURL=DJJsADWD.js.map

package/dist/chunks/{lMH6B5BV.js.map → DJJsADWD.js.map}

@@ -1 +1 @@
-{"version":3,"file":"lMH6B5BV.js","sources":["../../utils/request.ts"],"sourcesContent":["import type { ObjectLike } from '@unshared/types'\nimport type { FetchMethod, FetchOptions } from './parseRequest'\nimport { fetch } from './fetch'\nimport { handleResponse } from './handleResponse'\n\nexport interface RequestOptions<\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  Data = any,\n  Response = globalThis.Response,\n> extends\n  FetchOptions<Method, BaseUrl, Parameters, Query, Body, Headers> {\n\n  /**\n   * The callback that is called when an error occurs during the request.\n   */\n  onError?: (error: Error) => any\n\n  /**\n   * The callback that is called when data is received from the request. This callback\n   * will be called for each chunk of data that is received from the request.\n   */\n  onData?: (data: Data) => any\n\n  /**\n   * The callback that is called when the request is successful. This callback will be\n   * called after the request is complete and all data has been received.\n   */\n  onSuccess?: (response: Response) => any\n\n  /**\n   * The callback that is called when the status code is not OK. This callback will be called\n   * after the request is complete and before the data is consumed.\n   */\n  onFailure?: (response: Response) => any\n\n  /**\n   * The callback that is called when the request is complete. This callback will be called\n   * after the request is complete and all data has been received.\n   */\n  onEnd?: (response: Response) => any\n}\n\n/**\n * Fetch a route from the API and return the data. If the client was instantiated with an\n * application, the route name will be inferred from the application routes. Otherwise, you\n * can pass the route name as a string.\n *\n * @param route The name of the route to fetch.\n * @param options The options to pass to the request.\n * @returns The data from the API.\n * @example\n * // Declare the application type.\n * type App = Application<[ModuleProduct]>\n *\n * // Create a type-safe client for the application.\n * const request = createClient<App>()\n *\n * // Fetch the data from the API.\n * const data = request('GET /api/product/:id', { data: { id: '1' } })\n */\nexport async function request(route: string, options?: RequestOptions): Promise<unknown>\nexport async function request(route: string, options: RequestOptions = {}): Promise<unknown> {\n  const response = await fetch(route, options)\n  return await handleResponse(response, options)\n}\n"],"names":[],"mappings":";AAkEA,eAAsB,QAAQ,OAAe,UAA0B,IAAsB;AAC3F,QAAM,WAAW,MAAM,MAAM,OAAO,OAAO;AACpC,SAAA,MAAM,eAAe,UAAU,OAAO;AAC/C;"}
+{"version":3,"file":"DJJsADWD.js","sources":["../../utils/request.ts"],"sourcesContent":["import type { ObjectLike } from '@unshared/types'\nimport type { FetchMethod, FetchOptions } from './parseRequest'\nimport { fetch } from './fetch'\nimport { handleResponse } from './handleResponse'\n\nexport interface RequestOptions<\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  Data = any,\n  Response = globalThis.Response,\n> extends\n  FetchOptions<Method, BaseUrl, Parameters, Query, Body, Headers> {\n\n  /**\n   * The callback that is called when an error occurs during the request.\n   */\n  onError?: (error: Error) => any\n\n  /**\n   * The callback that is called when data is received from the request. This callback\n   * will be called for each chunk of data that is received from the request.\n   */\n  onData?: (data: Data) => any\n\n  /**\n   * The callback that is called when the request is successful. This callback will be\n   * called after the request is complete and all data has been received.\n   */\n  onSuccess?: (response: Response) => any\n\n  /**\n   * The callback that is called when the status code is not OK. This callback will be called\n   * after the request is complete and before the data is consumed.\n   */\n  onFailure?: (response: Response) => any\n\n  /**\n   * The callback that is called when the request is complete. This callback will be called\n   * after the request is complete and all data has been received.\n   */\n  onEnd?: (response: Response) => any\n}\n\n/**\n * Fetch a route from the API and return the data. If the client was instantiated with an\n * application, the route name will be inferred from the application routes. Otherwise, you\n * can pass the route name as a string.\n *\n * @param route The name of the route to fetch.\n * @param options The options to pass to the request.\n * @returns The data from the API.\n * @example\n * // Declare the application type.\n * type App = Application<[ModuleProduct]>\n *\n * // Create a type-safe client for the application.\n * const request = createClient<App>()\n *\n * // Fetch the data from the API.\n * const data = request('GET /api/product/:id', { data: { id: '1' } })\n */\nexport async function request(route: string, options?: RequestOptions): Promise<unknown>\nexport async function request(route: string, options: RequestOptions = {}): Promise<unknown> {\n  const response = await fetch(route, options)\n  return await handleResponse(response, options)\n}\n"],"names":[],"mappings":";AAkEA,eAAsB,QAAQ,OAAe,UAA0B,IAAsB;AAC3F,QAAM,WAAW,MAAM,MAAM,OAAO,OAAO;AACpC,SAAA,MAAM,eAAe,UAAU,OAAO;AAC/C;"}

package/dist/chunks/{CjU0376e.d.ts → DOZHjge0.d.ts}

@@ -1,5 +1,5 @@
 import { Loose, UnionMerge, Override, Pretty, CollectKey, MaybeLiteral, StringSplit } from '@unshared/types';
-import { F as FetchMethod, c as RequestOptions } from './B92aAMq0.js';
+import { F as FetchMethod, R as RequestOptions } from './CO11DuYE.js';
 import { OpenAPI } from 'openapi-types';
 
 /** Get the base URL of an OpenAPI specification. */
@@ -190,24 +190,19 @@ type OperationById<T, U extends OperationId<T>> = T extends {
  */
 declare function resolveOperation<T, U extends OperationId<T>>(document: T, operationId: U): OperationById<T, U>;
 
-/** The options to pass to the request. */
-type OperationOptions<T, V extends Operation> = T extends {
+interface OpenAPIV2Like {
     swagger: string;
-} ? RequestOptions<FetchMethod, MaybeLiteral<ServerUrl<T>>, OpenAPIV2.RequestParameters<V>, OpenAPIV2.RequestQuery<V>, OpenAPIV2.RequestBody<V>, OpenAPIV2.RequestHeaders<V>, OpenAPIV2.ResponseBody<V>, Response> : T extends {
+}
+interface OpenAPIV3Like {
     openapi: string;
-} ? RequestOptions<FetchMethod, MaybeLiteral<ServerUrl<T>>, OpenAPIV2.RequestParameters<V>, OpenAPIV3.RequestQuery<V> & OpenAPIV3.ServerQuery<T>, OpenAPIV3.RequestBody<V>, OpenAPIV2.RequestHeaders<V>, OpenAPIV3.ResponseBody<V>, Response> : RequestOptions;
+}
+type OpenAPILike = OpenAPIV2Like | OpenAPIV3Like;
+/** The options to pass to the request. */
+type OperationOptions<T, V extends Operation> = T extends OpenAPIV2Like ? RequestOptions<never, MaybeLiteral<ServerUrl<T>>, OpenAPIV2.RequestParameters<V>, OpenAPIV2.RequestQuery<V>, OpenAPIV2.RequestBody<V>, OpenAPIV2.RequestHeaders<V>, OpenAPIV2.ResponseBody<V>> : T extends OpenAPIV3Like ? RequestOptions<never, MaybeLiteral<ServerUrl<T>>, OpenAPIV2.RequestParameters<V>, OpenAPIV3.RequestQuery<V> & OpenAPIV3.ServerQuery<T>, OpenAPIV3.RequestBody<V>, OpenAPIV2.RequestHeaders<V>, OpenAPIV3.ResponseBody<V>> : RequestOptions;
 /** The response data from the operation. */
-type OperationResult<T, V extends Operation> = T extends {
-    swagger: string;
-} ? OpenAPIV2.ResponseBody<V> : T extends {
-    openapi: string;
-} ? OpenAPIV3.ResponseBody<V> : unknown;
+type OperationResult<T, V extends Operation> = T extends OpenAPIV2Like ? OpenAPIV2.ResponseBody<V> : T extends OpenAPIV3Like ? OpenAPIV3.ResponseBody<V> : unknown;
 /** The `Response` object from the operation. */
-type OperationResponse<T, V extends Operation> = T extends {
-    swagger: string;
-} ? OpenAPIV2.Response<V> : T extends {
-    openapi: string;
-} ? OpenAPIV3.Response<V> : globalThis.Response;
+type OperationResponse<T, V extends Operation> = T extends OpenAPIV2Like ? OpenAPIV2.Response<V> : T extends OpenAPIV3Like ? OpenAPIV3.Response<V> : globalThis.Response;
 /** Union of all operation route names in the specification. */
 type OperationRoute<T> = T extends {
     paths: infer P;
@@ -222,8 +217,8 @@ type OperationByRoute<T, U extends OperationRoute<T>> = StringSplit<U, ' '> exte
     path: P;
 } & O> : never : never : never : never;
 /** The `ClientRoutes` inferred from the OpenAPI specification. */
-type OpenAPIRoutes<T> = {
+type OpenAPIOptionsMap<T> = {
     [K in OperationRoute<T>]: OperationOptions<T, OperationByRoute<T, K>>;
 };
 
-export { OpenAPIV2 as O, type ServerUrl as S, OpenAPIV3 as a, type OperationId as b, type Operation as c, type OperationById as d, type OperationOptions as e, type OperationResult as f, getServerUrl as g, type OperationResponse as h, type OperationRoute as i, type OperationByRoute as j, type OpenAPIRoutes as k, resolveOperation as r };
+export { type OpenAPILike as O, type ServerUrl as S, type OpenAPIOptionsMap as a, type OperationId as b, type OperationById as c, type OperationOptions as d, type OperationResult as e, OpenAPIV3 as f, getServerUrl as g, OpenAPIV2 as h, type Operation as i, type OpenAPIV2Like as j, type OpenAPIV3Like as k, type OperationResponse as l, type OperationRoute as m, type OperationByRoute as n, resolveOperation as r };

package/dist/chunks/Du56lBvc.js

@@ -0,0 +1,75 @@
+import { p as parseRequestParameters, a as parseRequestQuery } from "./0ZzUT3m_.js";
+const EXP_CONNECTION_CHANNEL = /^((?<protocol>[a-z]+) )?(?<url>[^:]+?:\/{2}[^/]+)?(?<path>\/[^\s?]*)/i, PROTOCOLS = /* @__PURE__ */ new Set(["ws", "wss"]);
+function parseConnectUrl(parameters, channel, options) {
+  const { baseUrl, protocol } = options, match = EXP_CONNECTION_CHANNEL.exec(channel);
+  if (!match?.groups) throw new Error("Could not resolve the `RequestInit` object: Invalid route name.");
+  const routeProtocol = protocol ?? match.groups.protocol ?? "ws", routeBaseUrl = baseUrl ?? match.groups.url;
+  if (!routeBaseUrl) throw new Error("Could not resolve the `RequestInit` object: the `baseUrl` is missing.");
+  const protocolLower = routeProtocol.toLowerCase();
+  if (!PROTOCOLS.has(protocolLower)) throw new Error(`Could not resolve the \`RequestInit\` object:, the method \`${routeProtocol}\` is invalid.`);
+  parameters.url = new URL(routeBaseUrl), parameters.url.pathname += parameters.url.pathname.endsWith("/") ? match.groups.path.slice(1) : match.groups.path, parameters.protocol = protocolLower;
+}
+function parseConnectOptions(channel, options) {
+  const { baseUrl, protocol, data, parameters = data, query = data } = options, context = { url: new URL("about:blank") };
+  return parseConnectUrl(context, channel, { baseUrl, protocol }), parseRequestParameters(context, { parameters }), parseRequestQuery(context, { query }), context;
+}
+class WebSocketChannel {
+  constructor(channel, options) {
+    this.channel = channel, this.options = options;
+  }
+  /** The WebSocket connection to the server. */
+  webSocket;
+  /**
+   * Open a new WebSocket connection to the server. The connection will be opened with the given
+   * URL and protocols. If the connection is already open, the connection will be closed before
+   * opening a new connection. Also add the event listeners that were passed in the options.
+   */
+  async open() {
+    this.webSocket && await this.close();
+    const { url, protocol } = parseConnectOptions(this.channel, this.options);
+    return this.webSocket = new WebSocket(url, protocol), this.options.onOpen && this.on("open", this.options.onOpen), this.options.onClose && this.on("close", this.options.onClose), this.options.onError && this.on("error", this.options.onError), this.options.onMessage && this.on("message", (message) => this.options.onMessage(message)), this.webSocket.addEventListener("close", (event) => {
+      event.code !== 1e3 && this.options.autoReconnect && (this.options.reconnectLimit && event.wasClean || setTimeout(() => void this.open(), this.options.reconnectDelay ?? 0));
+    }), new Promise((resolve, rejects) => {
+      this.webSocket.addEventListener("open", () => resolve()), this.webSocket.addEventListener("error", () => rejects(new Error("Failed to open the WebSocket connection")));
+    });
+  }
+  /**
+   * Send a payload to the server. The payload will be serialized to JSON before sending.
+   *
+   * @param payload The data to send to the server.
+   */
+  send(payload) {
+    if (!this.webSocket) throw new Error("WebSocket connection is not open");
+    const json = JSON.stringify(payload);
+    this.webSocket.send(json);
+  }
+  on(event, callback) {
+    if (!this.webSocket) throw new Error("WebSocket connection has not been opened yet");
+    const listener = (event2) => {
+      let data = event2.data;
+      try {
+        data = JSON.parse(data);
+      } catch {
+      }
+      callback(data);
+    };
+    return this.webSocket.addEventListener(event, listener), () => this.webSocket.removeEventListener(event, listener);
+  }
+  /**
+   * Close the WebSocket connection to the server. The connection will not be able to send or receive
+   * messages after it is closed.
+   */
+  async close() {
+    if (!this.webSocket) throw new Error("WebSocket connection has not been opened yet");
+    this.webSocket.readyState !== WebSocket.CLOSED && this.webSocket.readyState !== WebSocket.CLOSING && (this.webSocket.close(1e3, "Client closed the connection"), await new Promise((resolve) => this.webSocket.addEventListener("close", () => resolve())));
+  }
+}
+function connect(route, options) {
+  return new WebSocketChannel(route, options);
+}
+export {
+  WebSocketChannel as W,
+  connect as c,
+  parseConnectOptions as p
+};
+//# sourceMappingURL=Du56lBvc.js.map

package/dist/chunks/Du56lBvc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Du56lBvc.js","sources":["../../websocket/parseConnectOptions.ts","../../websocket/connect.ts"],"sourcesContent":["import type { Loose, ObjectLike, UnionMerge } from '@unshared/types'\nimport { parseRequestParameters } from '../utils/parseRequestParameters'\nimport { parseRequestQuery } from '../utils/parseRequestQuery'\n\n/** Regular expression to match the request method and URL. */\nconst EXP_CONNECTION_CHANNEL = /^((?<protocol>[a-z]+) )?(?<url>[^:]+?:\\/{2}[^/]+)?(?<path>\\/[^\\s?]*)/i\n\n/** Valid WebSocket protocols. */\nconst PROTOCOLS = new Set(['ws', 'wss'])\n\n/** The protocols to use for the connection. */\nexport type ConnectProtocol = 'WS' | 'WSS'\n\n/** Options to pass to the `createChannel` function. */\nexport interface ConnectOptions<\n  BaseUrl extends string = string,\n  Query extends ObjectLike = ObjectLike,\n  Parameters extends ObjectLike = ObjectLike,\n  ClientData extends ObjectLike = ObjectLike,\n  ServerData extends ObjectLike = ObjectLike,\n> {\n\n  /** The protocol to use when connecting to the server. */\n  protocol?: Lowercase<ConnectProtocol> | Uppercase<ConnectProtocol>\n\n  /** The base URL to connect to. */\n  baseUrl?: BaseUrl\n\n  /**\n   * The path parameters to use when connecting to the server. These parameters will be used to\n   * fill in the path parameters of the connection URL.\n   *\n   * @example { id: 1 }\n   */\n  parameters?: Parameters\n\n  /**\n   * The query parameters to use when connecting to the server. These parameters will be used to\n   * fill in the query parameters of the connection URL.\n   *\n   * @example { limit: 10, offset: 0 }\n   */\n  query?: Loose<Query>\n\n  /**\n   * The data to send when creating the connection. Namely, the path parameters\n   * to use when connecting to the server.\n   *\n   * @example\n   *\n   * // Create a new connection to `http://localhost:8080/users/1`.\n   * connect('GET /users/:id', {\n   *   data: { id: 1 },\n   *   baseUrl: 'http://localhost:8080'\n   * })\n   */\n  data?: UnionMerge<Loose<Query> | Parameters>\n\n  /**\n   * The payload to send when creating the connection. Namely, the initial message\n   * to send to the server when the connection is established.\n   */\n  initialPayload?: Loose<ClientData>\n\n  /**\n   * Automatically open the connection when it is created. If `true`, the connection\n   * will automatically open when it is created. If `false`, the connection will not\n   * open when it is created.\n   *\n   * @default false\n   */\n  autoOpen?: boolean\n\n  /**\n   * Weather to reconnect the connection when it is closed unexpectedly. If `true`,\n   * the connection will automatically reconnect when it is closed. If `false`, the\n   * connection will not reconnect when it is closed.\n   *\n   * @default false\n   */\n  autoReconnect?: boolean\n\n  /**\n   * The delay in milliseconds to wait before reconnecting the connection. This delay\n   * will be used to wait before reconnecting the connection after it is closed.\n   *\n   * @default 0\n   */\n  reconnectDelay?: number\n\n  /**\n   * The maximum number of times to reconnect the connection before giving up. This\n   * number will be used to determine when to stop trying to reconnect the connection.\n   *\n   * @default 3\n   */\n  reconnectLimit?: number\n\n  /**\n   * The function to call when the connection is opened. This function will be called\n   * when the connection is successfully opened or reconnected.\n   */\n  onOpen?: (event: Event) => void\n\n  /**\n   * The function to call when the connection is closed with an error. This function will\n   * be called when the connection is closed unexpectedly with an error.\n   */\n  onError?: (event: Event) => void\n\n  /**\n   * The function to call when the connection is closed. This function will be called\n   * when the connection is closed unexpectedly or when the connection is closed manually.\n   */\n  onClose?: (event: CloseEvent) => void\n\n  /**\n   * The function to call when a message is received from the server. This function will\n   * be called when a message is received from the server.\n   */\n  onMessage?: (data: ServerData) => void\n}\n\nexport interface WebSocketParameters {\n  url: URL\n  protocol?: 'ws' | 'wss'\n}\n\nfunction parseConnectUrl(parameters: WebSocketParameters, channel: string, options: ConnectOptions): void {\n  const { baseUrl, protocol } = options\n\n  // --- Extract the path, method, and base URL from the route name.\n  const match = EXP_CONNECTION_CHANNEL.exec(channel)\n  if (!match?.groups) throw new Error('Could not resolve the `RequestInit` object: Invalid route name.')\n  const routeProtocol = protocol ?? match.groups.protocol ?? 'ws'\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 protocolLower = routeProtocol.toLowerCase()\n  const protocolIsValid = PROTOCOLS.has(protocolLower)\n  if (!protocolIsValid) throw new Error(`Could not resolve the \\`RequestInit\\` object:, the method \\`${routeProtocol}\\` is invalid.`)\n\n  // --- Create the url and apply the method.\n  parameters.url = new URL(routeBaseUrl)\n  parameters.url.pathname += parameters.url.pathname.endsWith('/') ? match.groups.path.slice(1) : match.groups.path\n  parameters.protocol = protocolLower as 'ws' | 'wss'\n}\n\nexport function parseConnectOptions(channel: string, options: ConnectOptions): WebSocketParameters {\n  const { baseUrl, protocol, data, parameters = data, query = data } = options\n  const context: WebSocketParameters = { url: new URL('about:blank') }\n  parseConnectUrl(context, channel, { baseUrl, protocol })\n  parseRequestParameters(context, { parameters })\n  parseRequestQuery(context, { query })\n  return context\n}\n","import type { ObjectLike } from '@unshared/types'\nimport type { ConnectOptions } from './parseConnectOptions'\nimport { parseConnectOptions } from './parseConnectOptions'\n\ntype RemoveListener = () => void\n\ntype ClientData<T extends ConnectOptions> =\n  T extends ConnectOptions<any, any, any, infer R extends ObjectLike, any> ? R : ObjectLike\n\ntype ServerData<T extends ConnectOptions> =\n  T extends ConnectOptions<any, any, any, any, infer R extends ObjectLike> ? R : ObjectLike\n\nexport class WebSocketChannel<T extends ConnectOptions = ConnectOptions> {\n  constructor(public channel: string, public options: T) {}\n\n  /** The WebSocket connection to the server. */\n  public webSocket: WebSocket | undefined\n\n  /**\n   * Open a new WebSocket connection to the server. The connection will be opened with the given\n   * URL and protocols. If the connection is already open, the connection will be closed before\n   * opening a new connection. Also add the event listeners that were passed in the options.\n   */\n  async open() {\n    if (this.webSocket) await this.close()\n    const { url, protocol } = parseConnectOptions(this.channel, this.options)\n    this.webSocket = new WebSocket(url, protocol)\n    if (this.options.onOpen) this.on('open', this.options.onOpen)\n    if (this.options.onClose) this.on('close', this.options.onClose)\n    if (this.options.onError) this.on('error', this.options.onError)\n    if (this.options.onMessage) this.on('message', message => this.options.onMessage!(message))\n\n    // --- Reconnect to the server if the connection is closed unexpectedly.\n    this.webSocket.addEventListener('close', (event) => {\n      if (event.code === 1000) return\n      if (!this.options.autoReconnect) return\n      if (this.options.reconnectLimit && event.wasClean) return\n      setTimeout(() => void this.open(), this.options.reconnectDelay ?? 0)\n    })\n\n    // --- Return a promise that resolves when the connection is opened.\n    return new Promise<void>((resolve, rejects) => {\n      this.webSocket!.addEventListener('open', () => resolve())\n      this.webSocket!.addEventListener('error', () => rejects(new Error('Failed to open the WebSocket connection')))\n    })\n  }\n\n  /**\n   * Send a payload to the server. The payload will be serialized to JSON before sending.\n   *\n   * @param payload The data to send to the server.\n   */\n  send(payload: ClientData<T>) {\n    if (!this.webSocket) throw new Error('WebSocket connection is not open')\n    const json = JSON.stringify(payload)\n    this.webSocket.send(json)\n  }\n\n  /**\n   * Listen for events from the server. The event will be deserialized from JSON before calling the callback.\n   *\n   * @param event The event to listen for.\n   * @param callback The callback to call when the event is received.\n   * @returns A function to remove the event listener.\n   */\n  on(event: 'message', callback: (data: ServerData<T>) => void): RemoveListener\n  on(event: 'close', callback: (event: CloseEvent) => void): RemoveListener\n  on(event: 'error', callback: (event: Event) => void): RemoveListener\n  on(event: 'open', callback: (event: Event) => void): RemoveListener\n  on(event: string, callback: (data: any) => void) {\n    if (!this.webSocket) throw new Error('WebSocket connection has not been opened yet')\n\n    const listener = (event: CloseEvent | Event | MessageEvent<any>) => {\n      // @ts-expect-error: `data` exists on the event.\n      let data = event.data as unknown\n      try { data = JSON.parse(data as string) }\n      catch { /* Ignore the error. */ }\n      callback(data as T)\n    }\n\n    this.webSocket.addEventListener(event, listener)\n    return () => this.webSocket!.removeEventListener(event, listener)\n  }\n\n  /**\n   * Close the WebSocket connection to the server. The connection will not be able to send or receive\n   * messages after it is closed.\n   */\n  async close() {\n    if (!this.webSocket) throw new Error('WebSocket connection has not been opened yet')\n    if (this.webSocket.readyState === WebSocket.CLOSED) return\n    if (this.webSocket.readyState === WebSocket.CLOSING) return\n    this.webSocket.close(1000, 'Client closed the connection')\n    await new Promise<void>(resolve => this.webSocket!.addEventListener('close', () => resolve()))\n  }\n}\n\n/**\n * Create a new WebSocket connection to the server with the given path. The connection will\n * automatically reconnect if the connection is closed unexpectedly.\n *\n * @param route The name of the route to connect to.\n * @param options The options to pass to the connection.\n * @returns The WebSocket connection.\n */\nexport function connect(route: string, options: ConnectOptions): WebSocketChannel {\n  return new WebSocketChannel(route, options)\n}\n"],"names":["event"],"mappings":"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"}

package/dist/chunks/{iA98-4f5.cjs → Du_W5H6e.cjs}

@@ -1,8 +1,8 @@
 "use strict";
-var handleResponse = require("./CfKxYeRr.cjs");
+var handleResponse = require("./Cayg8606.cjs");
 async function request(route, options = {}) {
   const response = await handleResponse.fetch(route, options);
   return await handleResponse.handleResponse(response, options);
 }
 exports.request = request;
-//# sourceMappingURL=iA98-4f5.cjs.map
+//# sourceMappingURL=Du_W5H6e.cjs.map