@unshared/client 0.3.0 → 0.3.2

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/6IxvRpmY.js

@@ -0,0 +1,86 @@
+import { awaitable } from "@unshared/functions";
+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, wsParameters = { url: new URL("about:blank") };
+  return parseConnectUrl(wsParameters, channel, { baseUrl, protocol }), parseRequestParameters(wsParameters, { parameters }), parseRequestQuery(wsParameters, { query }), wsParameters;
+}
+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.
+   *
+   * @returns The WebSocket connection.
+   */
+  async open() {
+    this.webSocket && await this.close();
+    const { url, protocol } = parseConnectOptions(this.channel, this.options);
+    this.webSocket = new WebSocket(url, protocol);
+    const promise = new Promise((resolve, rejects) => {
+      this.webSocket.addEventListener("error", () => rejects(new Error("Failed to open the WebSocket connection")), { once: !0 }), this.webSocket.addEventListener("open", () => {
+        this.options.initialPayload && this.send(this.options.initialPayload), resolve();
+      }, { once: !0 });
+    });
+    return this.options.onOpen && this.on("open", this.options.onOpen, { once: !0 }), this.options.onClose && this.on("close", this.options.onClose, { once: !0 }), 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));
+    }, { once: !0 }), promise.then(() => this);
+  }
+  /**
+   * 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, options) {
+    if (!this.webSocket) throw new Error("WebSocket connection has not been opened yet");
+    const listener = async (event2) => {
+      if (event2.type !== "message") return callback(event2);
+      let data = event2.data;
+      data instanceof Blob && (data = await data.text());
+      try {
+        data = JSON.parse(data);
+      } catch {
+        console.error("Failed to parse the message:", data);
+      }
+      callback(data);
+    };
+    return this.webSocket.addEventListener(event, listener, options), () => 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) {
+  const channel = new WebSocketChannel(route, options);
+  return awaitable(channel, () => channel.open());
+}
+export {
+  WebSocketChannel as W,
+  connect as c,
+  parseConnectOptions as p
+};
+//# sourceMappingURL=6IxvRpmY.js.map

package/dist/chunks/6IxvRpmY.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"6IxvRpmY.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 = any,\n  ServerData extends ObjectLike = any,\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   * 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 wsParameters: WebSocketParameters = { url: new URL('about:blank') }\n  parseConnectUrl(wsParameters, channel, { baseUrl, protocol })\n  parseRequestParameters(wsParameters, { parameters })\n  parseRequestQuery(wsParameters, { query })\n  return wsParameters\n}\n","import type { Awaitable } from '@unshared/functions'\nimport type { ConnectOptions } from './parseConnectOptions'\nimport { awaitable } from '@unshared/functions'\nimport { parseConnectOptions } from './parseConnectOptions'\n\ntype RemoveListener = () => void\n\ntype ClientData<T extends ConnectOptions> =\n  T extends ConnectOptions<any, any, any, infer R, any> ? R : any\n\ntype ServerData<T extends ConnectOptions> =\n  T extends ConnectOptions<any, any, any, any, infer R> ? R : any\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: undefined | WebSocket\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   * @returns The WebSocket connection.\n   */\n  async open(): Promise<this> {\n    if (this.webSocket) await this.close()\n    const { url, protocol } = parseConnectOptions(this.channel, this.options)\n    this.webSocket = new WebSocket(url, protocol)\n\n    // --- Return a promise that resolves when the connection is opened.\n    const promise = new Promise<void>((resolve, rejects) => {\n      this.webSocket!.addEventListener('error', () => rejects(new Error('Failed to open the WebSocket connection')), { once: true })\n      this.webSocket!.addEventListener('open', () => {\n        if (this.options.initialPayload) this.send(this.options.initialPayload as ClientData<T>)\n        resolve()\n      }, { once: true })\n    })\n\n    // --- Add the options' hooks to the WebSocket connection.\n    if (this.options.onOpen) this.on('open', this.options.onOpen, { once: true })\n    if (this.options.onClose) this.on('close', this.options.onClose, { once: true })\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    // --- Handle reconnection when 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    }, { once: true })\n\n    return promise.then(() => this)\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, options?: AddEventListenerOptions): RemoveListener\n  on(event: 'close', callback: (event: CloseEvent) => void, options?: AddEventListenerOptions): RemoveListener\n  on(event: 'error', callback: (event: Event) => void, options?: AddEventListenerOptions): RemoveListener\n  on(event: 'open', callback: (event: Event) => void, options?: AddEventListenerOptions): RemoveListener\n  on(event: string, callback: (data: any) => void, options?: AddEventListenerOptions) {\n    if (!this.webSocket) throw new Error('WebSocket connection has not been opened yet')\n\n    const listener = async(event: CloseEvent | Event | MessageEvent<Blob>): Promise<void> => {\n      if (event.type !== 'message') return callback(event)\n      // @ts-expect-error: `data` exists on the event.\n      let data = event.data as unknown\n      if (data instanceof Blob) data = await data.text()\n      try { data = JSON.parse(data as string) }\n      catch { console.error('Failed to parse the message:', data) }\n      callback(data)\n    }\n\n    /* eslint-disable @typescript-eslint/no-misused-promises */\n    this.webSocket.addEventListener(event, listener, options)\n    return () => this.webSocket!.removeEventListener(event, listener)\n    /* eslint-enable @typescript-eslint/no-misused-promises */\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): Awaitable<WebSocketChannel, WebSocketChannel> {\n  const channel = new WebSocketChannel(route, options)\n  return awaitable(channel, () => channel.open())\n}\n"],"names":["event"],"mappings":"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"}

package/dist/chunks/BMbsYNBd.cjs

@@ -0,0 +1,84 @@
+"use strict";
+var functions = require("@unshared/functions"), parseRequestQuery = require("./CYmaYL5B.cjs");
+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, wsParameters = { url: new URL("about:blank") };
+  return parseConnectUrl(wsParameters, channel, { baseUrl, protocol }), parseRequestQuery.parseRequestParameters(wsParameters, { parameters }), parseRequestQuery.parseRequestQuery(wsParameters, { query }), wsParameters;
+}
+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.
+   *
+   * @returns The WebSocket connection.
+   */
+  async open() {
+    this.webSocket && await this.close();
+    const { url, protocol } = parseConnectOptions(this.channel, this.options);
+    this.webSocket = new WebSocket(url, protocol);
+    const promise = new Promise((resolve, rejects) => {
+      this.webSocket.addEventListener("error", () => rejects(new Error("Failed to open the WebSocket connection")), { once: !0 }), this.webSocket.addEventListener("open", () => {
+        this.options.initialPayload && this.send(this.options.initialPayload), resolve();
+      }, { once: !0 });
+    });
+    return this.options.onOpen && this.on("open", this.options.onOpen, { once: !0 }), this.options.onClose && this.on("close", this.options.onClose, { once: !0 }), 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));
+    }, { once: !0 }), promise.then(() => this);
+  }
+  /**
+   * 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, options) {
+    if (!this.webSocket) throw new Error("WebSocket connection has not been opened yet");
+    const listener = async (event2) => {
+      if (event2.type !== "message") return callback(event2);
+      let data = event2.data;
+      data instanceof Blob && (data = await data.text());
+      try {
+        data = JSON.parse(data);
+      } catch {
+        console.error("Failed to parse the message:", data);
+      }
+      callback(data);
+    };
+    return this.webSocket.addEventListener(event, listener, options), () => 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) {
+  const channel = new WebSocketChannel(route, options);
+  return functions.awaitable(channel, () => channel.open());
+}
+exports.WebSocketChannel = WebSocketChannel;
+exports.connect = connect;
+exports.parseConnectOptions = parseConnectOptions;
+//# sourceMappingURL=BMbsYNBd.cjs.map

package/dist/chunks/BMbsYNBd.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"BMbsYNBd.cjs","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 = any,\n  ServerData extends ObjectLike = any,\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   * 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 wsParameters: WebSocketParameters = { url: new URL('about:blank') }\n  parseConnectUrl(wsParameters, channel, { baseUrl, protocol })\n  parseRequestParameters(wsParameters, { parameters })\n  parseRequestQuery(wsParameters, { query })\n  return wsParameters\n}\n","import type { Awaitable } from '@unshared/functions'\nimport type { ConnectOptions } from './parseConnectOptions'\nimport { awaitable } from '@unshared/functions'\nimport { parseConnectOptions } from './parseConnectOptions'\n\ntype RemoveListener = () => void\n\ntype ClientData<T extends ConnectOptions> =\n  T extends ConnectOptions<any, any, any, infer R, any> ? R : any\n\ntype ServerData<T extends ConnectOptions> =\n  T extends ConnectOptions<any, any, any, any, infer R> ? R : any\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: undefined | WebSocket\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   * @returns The WebSocket connection.\n   */\n  async open(): Promise<this> {\n    if (this.webSocket) await this.close()\n    const { url, protocol } = parseConnectOptions(this.channel, this.options)\n    this.webSocket = new WebSocket(url, protocol)\n\n    // --- Return a promise that resolves when the connection is opened.\n    const promise = new Promise<void>((resolve, rejects) => {\n      this.webSocket!.addEventListener('error', () => rejects(new Error('Failed to open the WebSocket connection')), { once: true })\n      this.webSocket!.addEventListener('open', () => {\n        if (this.options.initialPayload) this.send(this.options.initialPayload as ClientData<T>)\n        resolve()\n      }, { once: true })\n    })\n\n    // --- Add the options' hooks to the WebSocket connection.\n    if (this.options.onOpen) this.on('open', this.options.onOpen, { once: true })\n    if (this.options.onClose) this.on('close', this.options.onClose, { once: true })\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    // --- Handle reconnection when 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    }, { once: true })\n\n    return promise.then(() => this)\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, options?: AddEventListenerOptions): RemoveListener\n  on(event: 'close', callback: (event: CloseEvent) => void, options?: AddEventListenerOptions): RemoveListener\n  on(event: 'error', callback: (event: Event) => void, options?: AddEventListenerOptions): RemoveListener\n  on(event: 'open', callback: (event: Event) => void, options?: AddEventListenerOptions): RemoveListener\n  on(event: string, callback: (data: any) => void, options?: AddEventListenerOptions) {\n    if (!this.webSocket) throw new Error('WebSocket connection has not been opened yet')\n\n    const listener = async(event: CloseEvent | Event | MessageEvent<Blob>): Promise<void> => {\n      if (event.type !== 'message') return callback(event)\n      // @ts-expect-error: `data` exists on the event.\n      let data = event.data as unknown\n      if (data instanceof Blob) data = await data.text()\n      try { data = JSON.parse(data as string) }\n      catch { console.error('Failed to parse the message:', data) }\n      callback(data)\n    }\n\n    /* eslint-disable @typescript-eslint/no-misused-promises */\n    this.webSocket.addEventListener(event, listener, options)\n    return () => this.webSocket!.removeEventListener(event, listener)\n    /* eslint-enable @typescript-eslint/no-misused-promises */\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): Awaitable<WebSocketChannel, WebSocketChannel> {\n  const channel = new WebSocketChannel(route, options)\n  return awaitable(channel, () => channel.open())\n}\n"],"names":["parseRequestParameters","parseRequestQuery","event","awaitable"],"mappings":"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"}

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/Biic1J5b.js.map

@@ -1 +1 @@
-{"version":3,"file":"Biic1J5b.js","sources":["../../openapi/getServerUrl.ts","../../openapi/resolveOperation.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-unsafe-member-access */\n/** Get the base URL of an OpenAPI specification. */\nexport type ServerUrl<T> =\n\n  // --- Handle OpenAPI 2.0 specifications.\n  T extends {\n    host: infer Host extends string\n    basePath?: infer BasePath extends string\n    schemes?: Array<infer Scheme extends string>\n  }\n    ? `${Scheme}://${Host}${BasePath}`\n\n    // --- Handle OpenAPI 3.0 specifications.\n    : T extends { servers: Array<{ url: infer U extends string }> }\n      ? U\n      : string\n\n/**\n * Given an OpenAPI specification, get the first base URL.\n *\n * @param specification The OpenAPI specification.\n * @returns The first base URL.\n * @example getBaseUrl(specification) // 'https://api.example.com/v1'\n */\nexport function getServerUrl<T>(specification: T): ServerUrl<T> {\n\n  // --- Ensure the specification is an object.\n  if (\n    !specification\n    || typeof specification !== 'object'\n    || specification === null)\n    throw new Error('Invalid OpenAPI specification.')\n\n  // --- Handle OpenAPI 3.0 specifications.\n  if (\n    'servers' in specification\n    && Array.isArray(specification.servers)\n    && specification.servers.length > 0\n    && 'url' in specification.servers[0]\n    && typeof specification.servers[0].url === 'string'\n    && specification.servers[0].url.length > 0)\n    return specification.servers[0].url as ServerUrl<T>\n\n  // --- Handle OpenAPI 2.0 specifications.\n  if (\n    'host' in specification\n    && typeof specification.host === 'string') {\n\n    const scheme = (\n      'schemes' in specification\n      && Array.isArray(specification.schemes)\n      && specification.schemes.length > 0\n      && typeof specification.schemes[0] === 'string')\n      ? specification.schemes[0]\n      : 'https'\n\n    const basePath = (\n      'basePath' in specification\n      && typeof specification.basePath === 'string'\n      && specification.basePath.length > 0)\n      ? specification.basePath\n      : '/'\n\n    return `${scheme}://${specification.host}${basePath}` as ServerUrl<T>\n  }\n\n  throw new Error('No base URL found in the OpenAPI specification.')\n}\n","import type { CollectKey, Pretty } from '@unshared/types'\nimport type { OpenAPI } from 'openapi-types'\nimport type { FetchMethod } from '../utils/parseRequest'\n\n/** The HTTP methods supported by OpenAPI. */\nconst methods = ['get', 'put', 'post', 'delete', 'options', 'head', 'patch'] as const\n\n/** Union of all operation IDs in the specification. */\nexport type OperationId<T> =\nT extends { paths: infer P }\n  ? P extends Record<string, infer R>\n    ? R extends Record<string, infer O>\n      ? O extends { operationId: infer N }\n        ? N\n        : string\n      : string\n    : string\n  : string\n\n/** A union of possible Operations types in the specification. */\nexport type Operation = { method: FetchMethod; path: string } & OpenAPI.Operation\n\n/** Find an operation by its operationId in an OpenAPI specification. */\nexport type OperationById<T, U extends OperationId<T>> =\n  T extends { paths: infer P }\n    ? CollectKey<P> extends Record<string, infer R>\n      ? CollectKey<R> extends Record<string, infer O>\n        ? O extends { $key: [infer P extends string, infer M extends string]; operationId: U }\n          ? Pretty<{ method: M; path: P } & Omit<O, '$key'>>\n          : never\n        : never\n      : never\n    : never\n\n/**\n * Given an OpenAPI specification, find an operation by its operationId.\n *\n * @param document The OpenAPI specification document.\n * @param operationId The operationId of the operation to resolve.\n * @returns The resolved operation.\n * @example resolveOperation(document, 'getUser') // { method: 'get', path: '/users/{username}', ... }\n */\nexport function resolveOperation<T, U extends OperationId<T>>(document: T, operationId: U): OperationById<T, U> {\n\n  // --- Validate the specification.\n  if (!document\n    || typeof document !== 'object'\n    || document === null\n    || 'paths' in document === false\n    || typeof document.paths !== 'object'\n    || document.paths === null)\n    throw new Error('Missing paths object in the OpenAPI specification.')\n\n  // --- Search for the operation in the specification's paths.\n  const paths = document.paths as OpenAPI.Document['paths']\n  for (const path in paths) {\n    const route = paths[path]\n    if (typeof route !== 'object' || route === null) continue\n\n    // --- Search in each method for the operation.\n    for (const method of methods) {\n      const operation = route[method]\n      if (method in route === false\n        || typeof operation !== 'object'\n        || operation === null\n        || 'operationId' in operation === false\n        || operation.operationId !== operationId) continue\n\n      // --- Route was found, return the operation.\n      return { ...route[method], method, path } as OperationById<T, U>\n    }\n  }\n\n  // --- Throw an error if the operation was not found.\n  throw new Error(`Operation \"${operationId}\" not found in specification.`)\n}\n"],"names":[],"mappings":"AAwBO,SAAS,aAAgB,eAAgC;AAG9D,MACE,CAAC,iBACE,OAAO,iBAAkB,YACzB,kBAAkB;AACf,UAAA,IAAI,MAAM,gCAAgC;AAGlD,MACE,aAAa,iBACV,MAAM,QAAQ,cAAc,OAAO,KACnC,cAAc,QAAQ,SAAS,KAC/B,SAAS,cAAc,QAAQ,CAAC,KAChC,OAAO,cAAc,QAAQ,CAAC,EAAE,OAAQ,YACxC,cAAc,QAAQ,CAAC,EAAE,IAAI,SAAS;AAClC,WAAA,cAAc,QAAQ,CAAC,EAAE;AAGlC,MACE,UAAU,iBACP,OAAO,cAAc,QAAS,UAAU;AAE3C,UAAM,SACJ,aAAa,iBACV,MAAM,QAAQ,cAAc,OAAO,KACnC,cAAc,QAAQ,SAAS,KAC/B,OAAO,cAAc,QAAQ,CAAC,KAAM,WACrC,cAAc,QAAQ,CAAC,IACvB,SAEE,WACJ,cAAc,iBACX,OAAO,cAAc,YAAa,YAClC,cAAc,SAAS,SAAS,IACjC,cAAc,WACd;AAEJ,WAAO,GAAG,MAAM,MAAM,cAAc,IAAI,GAAG,QAAQ;AAAA,EAAA;AAG/C,QAAA,IAAI,MAAM,iDAAiD;AACnE;AC9DA,MAAM,UAAU,CAAC,OAAO,OAAO,QAAQ,UAAU,WAAW,QAAQ,OAAO;AAqC3D,SAAA,iBAA8C,UAAa,aAAqC;AAG9G,MAAI,CAAC,YACA,OAAO,YAAa,YACpB,aAAa,QACb,EAAW,WAAA,aACX,OAAO,SAAS,SAAU,YAC1B,SAAS,UAAU;AAChB,UAAA,IAAI,MAAM,oDAAoD;AAGtE,QAAM,QAAQ,SAAS;AACvB,aAAW,QAAQ,OAAO;AAClB,UAAA,QAAQ,MAAM,IAAI;AACpB,QAAA,EAAA,OAAO,SAAU,YAAY,UAAU;AAG3C,iBAAW,UAAU,SAAS;AACtB,cAAA,YAAY,MAAM,MAAM;AAC1B,YAAA,EAAA,EAAA,UAAU,UACT,OAAO,aAAc,YACrB,cAAc,QACd,EAAA,iBAAiB,cACjB,UAAU,gBAAgB;AAG/B,iBAAO,EAAE,GAAG,MAAM,MAAM,GAAG,QAAQ,KAAK;AAAA,MAAA;AAAA,EAC1C;AAIF,QAAM,IAAI,MAAM,cAAc,WAAW,+BAA+B;AAC1E;"}
+{"version":3,"file":"Biic1J5b.js","sources":["../../openapi/getServerUrl.ts","../../openapi/resolveOperation.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-unsafe-member-access */\n/** Get the base URL of an OpenAPI specification. */\nexport type ServerUrl<T> =\n\n  // --- Handle OpenAPI 2.0 specifications.\n  T extends {\n    host: infer Host extends string\n    basePath?: infer BasePath extends string\n    schemes?: Array<infer Scheme extends string>\n  }\n    ? `${Scheme}://${Host}${BasePath}`\n\n    // --- Handle OpenAPI 3.0 specifications.\n    : T extends { servers: Array<{ url: infer U extends string }> }\n      ? U\n      : string\n\n/**\n * Given an OpenAPI specification, get the first base URL.\n *\n * @param specification The OpenAPI specification.\n * @returns The first base URL.\n * @example getBaseUrl(specification) // 'https://api.example.com/v1'\n */\nexport function getServerUrl<T>(specification: T): ServerUrl<T> {\n\n  // --- Ensure the specification is an object.\n  if (\n    !specification\n    || typeof specification !== 'object'\n    || specification === null)\n    throw new Error('Invalid OpenAPI specification.')\n\n  // --- Handle OpenAPI 3.0 specifications.\n  if (\n    'servers' in specification\n    && Array.isArray(specification.servers)\n    && specification.servers.length > 0\n    && 'url' in specification.servers[0]\n    && typeof specification.servers[0].url === 'string'\n    && specification.servers[0].url.length > 0)\n    return specification.servers[0].url as ServerUrl<T>\n\n  // --- Handle OpenAPI 2.0 specifications.\n  if (\n    'host' in specification\n    && typeof specification.host === 'string') {\n\n    const scheme = (\n      'schemes' in specification\n      && Array.isArray(specification.schemes)\n      && specification.schemes.length > 0\n      && typeof specification.schemes[0] === 'string')\n      ? specification.schemes[0]\n      : 'https'\n\n    const basePath = (\n      'basePath' in specification\n      && typeof specification.basePath === 'string'\n      && specification.basePath.length > 0)\n      ? specification.basePath\n      : '/'\n\n    return `${scheme}://${specification.host}${basePath}` as ServerUrl<T>\n  }\n\n  throw new Error('No base URL found in the OpenAPI specification.')\n}\n","import type { CollectKey, Pretty } from '@unshared/types'\nimport type { OpenAPI } from 'openapi-types'\nimport type { FetchMethod } from '../utils/parseRequest'\n\n/** The HTTP methods supported by OpenAPI. */\nconst methods = ['get', 'put', 'post', 'delete', 'options', 'head', 'patch'] as const\n\n/** Union of all operation IDs in the specification. */\nexport type OperationId<T> =\nT extends { paths: infer P }\n  ? P extends Record<string, infer R>\n    ? R extends Record<string, infer O>\n      ? O extends { operationId: infer N }\n        ? N\n        : string\n      : string\n    : string\n  : string\n\n/** A union of possible Operations types in the specification. */\nexport type Operation = OpenAPI.Operation & { method: FetchMethod; path: string }\n\n/** Find an operation by its operationId in an OpenAPI specification. */\nexport type OperationById<T, U extends OperationId<T>> =\n  T extends { paths: infer P }\n    ? CollectKey<P> extends Record<string, infer R>\n      ? CollectKey<R> extends Record<string, infer O>\n        ? O extends { $key: [infer P extends string, infer M extends string]; operationId: U }\n          ? Pretty<Omit<O, '$key'> & { method: M; path: P }>\n          : never\n        : never\n      : never\n    : never\n\n/**\n * Given an OpenAPI specification, find an operation by its operationId.\n *\n * @param document The OpenAPI specification document.\n * @param operationId The operationId of the operation to resolve.\n * @returns The resolved operation.\n * @example resolveOperation(document, 'getUser') // { method: 'get', path: '/users/{username}', ... }\n */\nexport function resolveOperation<T, U extends OperationId<T>>(document: T, operationId: U): OperationById<T, U> {\n\n  // --- Validate the specification.\n  if (!document\n    || typeof document !== 'object'\n    || document === null\n    || 'paths' in document === false\n    || typeof document.paths !== 'object'\n    || document.paths === null)\n    throw new Error('Missing paths object in the OpenAPI specification.')\n\n  // --- Search for the operation in the specification's paths.\n  const paths = document.paths as OpenAPI.Document['paths']\n  for (const path in paths) {\n    const route = paths[path]\n    if (typeof route !== 'object' || route === null) continue\n\n    // --- Search in each method for the operation.\n    for (const method of methods) {\n      const operation = route[method]\n      if (method in route === false\n        || typeof operation !== 'object'\n        || operation === null\n        || 'operationId' in operation === false\n        || operation.operationId !== operationId) continue\n\n      // --- Route was found, return the operation.\n      return { ...route[method], method, path } as OperationById<T, U>\n    }\n  }\n\n  // --- Throw an error if the operation was not found.\n  throw new Error(`Operation \"${operationId}\" not found in specification.`)\n}\n"],"names":[],"mappings":"AAwBO,SAAS,aAAgB,eAAgC;AAG9D,MACE,CAAC,iBACE,OAAO,iBAAkB,YACzB,kBAAkB;AACf,UAAA,IAAI,MAAM,gCAAgC;AAGlD,MACE,aAAa,iBACV,MAAM,QAAQ,cAAc,OAAO,KACnC,cAAc,QAAQ,SAAS,KAC/B,SAAS,cAAc,QAAQ,CAAC,KAChC,OAAO,cAAc,QAAQ,CAAC,EAAE,OAAQ,YACxC,cAAc,QAAQ,CAAC,EAAE,IAAI,SAAS;AAClC,WAAA,cAAc,QAAQ,CAAC,EAAE;AAGlC,MACE,UAAU,iBACP,OAAO,cAAc,QAAS,UAAU;AAE3C,UAAM,SACJ,aAAa,iBACV,MAAM,QAAQ,cAAc,OAAO,KACnC,cAAc,QAAQ,SAAS,KAC/B,OAAO,cAAc,QAAQ,CAAC,KAAM,WACrC,cAAc,QAAQ,CAAC,IACvB,SAEE,WACJ,cAAc,iBACX,OAAO,cAAc,YAAa,YAClC,cAAc,SAAS,SAAS,IACjC,cAAc,WACd;AAEJ,WAAO,GAAG,MAAM,MAAM,cAAc,IAAI,GAAG,QAAQ;AAAA,EAAA;AAG/C,QAAA,IAAI,MAAM,iDAAiD;AACnE;AC9DA,MAAM,UAAU,CAAC,OAAO,OAAO,QAAQ,UAAU,WAAW,QAAQ,OAAO;AAqC3D,SAAA,iBAA8C,UAAa,aAAqC;AAG9G,MAAI,CAAC,YACA,OAAO,YAAa,YACpB,aAAa,QACb,EAAW,WAAA,aACX,OAAO,SAAS,SAAU,YAC1B,SAAS,UAAU;AAChB,UAAA,IAAI,MAAM,oDAAoD;AAGtE,QAAM,QAAQ,SAAS;AACvB,aAAW,QAAQ,OAAO;AAClB,UAAA,QAAQ,MAAM,IAAI;AACpB,QAAA,EAAA,OAAO,SAAU,YAAY,UAAU;AAG3C,iBAAW,UAAU,SAAS;AACtB,cAAA,YAAY,MAAM,MAAM;AAC1B,YAAA,EAAA,EAAA,UAAU,UACT,OAAO,aAAc,YACrB,cAAc,QACd,EAAA,iBAAiB,cACjB,UAAU,gBAAgB;AAG/B,iBAAO,EAAE,GAAG,MAAM,MAAM,GAAG,QAAQ,KAAK;AAAA,MAAA;AAAA,EAC1C;AAIF,QAAM,IAAI,MAAM,cAAc,WAAW,+BAA+B;AAC1E;"}

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;;;;"}