@stryke/http 0.0.1

package/dist/cookie.d.ts

@@ -0,0 +1,39 @@
+import type { CookieParseOptions, CookieSerializeOptions, SetCookie, SetCookieParseOptions } from "./types";
+/**
+ * Parse an HTTP Cookie header string and returning an object of all cookie
+ * name-value pairs.
+ *
+ * @param strCookie - the string representing a `Cookie` header value
+ * @param options - object containing parsing options
+ * @returns an object with the parsed cookies
+ */
+export declare function parseCookie(strCookie: string, options?: CookieParseOptions): Record<string, string>;
+/**
+ * Parse a [Set-Cookie](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie) header string into an object.
+ *
+ * @param setCookieValue - the string representing a `Set-Cookie` header value
+ * @param options - object containing parsing options
+ * @returns an object with the parsed cookie
+ */
+export declare function parseSetCookie(setCookieValue: string, options?: SetCookieParseOptions): SetCookie;
+/**
+ * Serialize a cookie name-value pair into a `Set-Cookie` header string.
+ *
+ * @param name - the name for the cookie
+ * @param value - value to set the cookie to
+ * @param options - object containing serialization options
+ * @returns a `Set-Cookie` header string
+ *
+ * @throws TypeError when `maxAge` options is invalid
+ */
+export declare function serializeCookie(name: string, value: string, options?: CookieSerializeOptions): string;
+/**
+ * Set-Cookie header field-values are sometimes comma joined in one string. This splits them without choking on commas
+ * that are within a single set-cookie field-value, such as in the Expires portion.
+ *
+ * See https://tools.ietf.org/html/rfc2616#section-4.2
+ *
+ * @param strCookie - The string representing a `Set-Cookie` header value
+ * @returns An array of strings representing individual `Set-Cookie` header values
+ */
+export declare function splitSetCookieString(strCookie: string | string[]): string[];

package/dist/cookie.mjs

@@ -0,0 +1 @@
+import{isDate as h,isFunction as d,isSet as g,isString as p}from"@stryke/types/type-checks";export function parseCookie(r,c){if(!p(r))throw new TypeError("argument str must be a string");const i={},e=c??{},o=e.decode??(t=>t.includes("%")?decodeURIComponent(t):t);let a=0;for(;a<r.length;){const t=r.indexOf("=",a);if(t===-1)break;let n=r.indexOf(";",a);if(n===-1)n=r.length;else if(n<t){a=r.lastIndexOf(";",t-1)+1;continue}const s=r.slice(a,t).trim();if(e?.filter&&!e?.filter(s)){a=n+1;continue}if(i[s]===void 0){let l=r.slice(t+1,n).trim();l.codePointAt(0)===34&&(l=l.slice(1,-1));try{i[s]=o(l)}catch{i[s]=l}}a=n+1}return i}export function parseSetCookie(r,c){const i=(r||"").split(";").filter(s=>p(s)&&!!s.trim()),e=i.shift()||"";let o="",a="";const t=e.split("=");t.length>1?(o=t.shift(),a=t.join("=")):a=e;try{a=c?.decode===!1?a:(c?.decode??decodeURIComponent)(a)}catch{}const n={name:o,value:a};for(const s of i){const l=s.split("="),f=(l.shift()||"").trimStart().toLowerCase(),m=l.join("=");switch(f){case"expires":{n.expires=new Date(m);break}case"max-age":{n.maxAge=Number.parseInt(m,10);break}case"secure":{n.secure=!0;break}case"httponly":{n.httpOnly=!0;break}case"samesite":{n.sameSite=m;break}default:n[f]=m}}return n}const u=/^[\u0009\u0020-\u007E\u0080-\u00FF]+$/;export function serializeCookie(r,c,i){const e=i??{},o=e.encode??encodeURIComponent;if(!d(o))throw new TypeError("option encode is invalid");if(!u.test(r))throw new TypeError("argument name is invalid");const a=o(c);if(a&&!u.test(a))throw new TypeError("argument val is invalid");let t=r+"="+a;if(!g(e.maxAge)){const n=Number(e.maxAge);if(Number.isNaN(n)||!Number.isFinite(n))throw new TypeError("option maxAge is invalid");t+="; Max-Age="+Math.floor(n)}if(e.domain){if(!u.test(e.domain))throw new TypeError("option domain is invalid");t+="; Domain="+e.domain}if(e.path){if(!u.test(e.path))throw new TypeError("option path is invalid");t+="; Path="+e.path}if(e.expires){if(!h(e.expires)||Number.isNaN(e.expires.valueOf()))throw new TypeError("option expires is invalid");t+="; Expires="+e.expires.toUTCString()}if(e.httpOnly&&(t+="; HttpOnly"),e.secure&&(t+="; Secure"),e.priority)switch(p(e.priority)?e.priority.toLowerCase():e.priority){case"low":{t+="; Priority=Low";break}case"medium":{t+="; Priority=Medium";break}case"high":{t+="; Priority=High";break}default:throw new TypeError("option priority is invalid")}if(e.sameSite)switch(p(e.sameSite)?e.sameSite.toLowerCase():e.sameSite){case!0:{t+="; SameSite=Strict";break}case"lax":{t+="; SameSite=Lax";break}case"strict":{t+="; SameSite=Strict";break}case"none":{t+="; SameSite=None";break}default:throw new TypeError("option sameSite is invalid")}return e.partitioned&&(t+="; Partitioned"),t}export function splitSetCookieString(r){if(Array.isArray(r))return r.flatMap(f=>splitSetCookieString(f));if(!p(r))return[];const c=[];let i=0,e,o,a,t,n;const s=()=>{for(;i<r.length&&/\s/.test(r.charAt(i));)i+=1;return i<r.length},l=()=>(o=r.charAt(i),o!=="="&&o!==";"&&o!==",");for(;i<r.length;){for(e=i,n=!1;s();)if(o=r.charAt(i),o===","){for(a=i,i+=1,s(),t=i;i<r.length&&l();)i+=1;i<r.length&&r.charAt(i)==="="?(n=!0,i=t,c.push(r.slice(e,a)),e=i):i=a+1}else i+=1;(!n||i>=r.length)&&c.push(r.slice(e))}return c}

package/dist/format-data-uri.cjs

@@ -0,0 +1,8 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.formatDataURI = void 0;
+const formatDataURI = (t, n) => `data:${n};utf8,${encodeURIComponent(t)}`;
+exports.formatDataURI = formatDataURI;

package/dist/format-data-uri.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Creates a data URI from a string of data.
+ *
+ * @param data - The data to convert to a data URI.
+ * @param mime - The MIME type of the data.
+ * @returns The data URI.
+ */
+export declare const formatDataURI: (data: string, mime: string) => string;

package/dist/format-data-uri.mjs

@@ -0,0 +1 @@
+export const formatDataURI=(t,n)=>`data:${n};utf8,${encodeURIComponent(t)}`;

package/dist/index.cjs

@@ -0,0 +1,38 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _cookie = require("./cookie.cjs");
+Object.keys(_cookie).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _cookie[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _cookie[key];
+    }
+  });
+});
+var _formatDataUri = require("./format-data-uri.cjs");
+Object.keys(_formatDataUri).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _formatDataUri[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _formatDataUri[key];
+    }
+  });
+});
+var _urlBuilder = require("./url-builder.cjs");
+Object.keys(_urlBuilder).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _urlBuilder[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _urlBuilder[key];
+    }
+  });
+});

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./cookie";
+export * from "./format-data-uri";
+export * from "./url-builder";

package/dist/index.mjs

@@ -0,0 +1 @@
+export*from"./cookie";export*from"./format-data-uri";export*from"./url-builder";

package/dist/types.cjs

@@ -0,0 +1 @@
+"use strict";

package/dist/types.d.ts

@@ -0,0 +1,193 @@
+import type { ParsedURL } from "ufo";
+export type StormURL = ParsedURL & {
+    __typename: "StormURL";
+    query: Record<string, any>;
+    username?: string;
+    password?: string;
+    hostname?: string;
+    port?: string;
+};
+/**
+ * Additional serialization options
+ */
+export interface CookieSerializeOptions {
+    /**
+     * Specifies the value for the {@link https://tools.ietf.org/html/rfc6265#section-5.2.3 | Domain Set-Cookie attribute}. By default, no
+     * domain is set, and most clients will consider the cookie to apply to only
+     * the current domain.
+     */
+    domain?: string | undefined;
+    /**
+     * Specifies a function that will be used to encode a cookie's value. Since
+     * value of a cookie has a limited character set (and must be a simple
+     * string), this function can be used to encode a value into a string suited
+     * for a cookie's value.
+     *
+     * The default function is the global `encodeURIComponent`, which will
+     * encode a JavaScript string into UTF-8 byte sequences and then URL-encode
+     * any that fall outside of the cookie range.
+     */
+    encode?(value: string): string;
+    /**
+     * Specifies the `Date` object to be the value for the {@link https://tools.ietf.org/html/rfc6265#section-5.2.1 | `Expires` `Set-Cookie` attribute}. By default,
+     * no expiration is set, and most clients will consider this a "non-persistent cookie" and will delete
+     * it on a condition like exiting a web browser application.
+     *
+     * *Note* the {@link https://tools.ietf.org/html/rfc6265#section-5.3 | cookie storage model specification}
+     * states that if both `expires` and `maxAge` are set, then `maxAge` takes precedence, but it is
+     * possible not all clients by obey this, so if both are set, they should
+     * point to the same date and time.
+     */
+    expires?: Date | undefined;
+    /**
+     * Specifies the boolean value for the {@link https://tools.ietf.org/html/rfc6265#section-5.2.6 | `HttpOnly` `Set-Cookie` attribute}.
+     * When truthy, the `HttpOnly` attribute is set, otherwise it is not. By
+     * default, the `HttpOnly` attribute is not set.
+     *
+     * *Note* be careful when setting this to true, as compliant clients will
+     * not allow client-side JavaScript to see the cookie in `document.cookie`.
+     */
+    httpOnly?: boolean | undefined;
+    /**
+     * Specifies the number (in seconds) to be the value for the `Max-Age`
+     * `Set-Cookie` attribute. The given number will be converted to an integer
+     * by rounding down. By default, no maximum age is set.
+     *
+     * *Note* the {@link https://tools.ietf.org/html/rfc6265#section-5.3 | cookie storage model specification}
+     * states that if both `expires` and `maxAge` are set, then `maxAge` takes precedence, but it is
+     * possible not all clients by obey this, so if both are set, they should
+     * point to the same date and time.
+     */
+    maxAge?: number | undefined;
+    /**
+     * Specifies the value for the {@link https://tools.ietf.org/html/rfc6265#section-5.2.4|`Path` `Set-Cookie` attribute}.
+     * By default, the path is considered the "default path".
+     */
+    path?: string | undefined;
+    /**
+     * Specifies the `string` to be the value for the [`Priority` `Set-Cookie` attribute][rfc-west-cookie-priority-00-4.1].
+     *
+     * - `'low'` will set the `Priority` attribute to `Low`.
+     * - `'medium'` will set the `Priority` attribute to `Medium`, the default priority when not set.
+     * - `'high'` will set the `Priority` attribute to `High`.
+     *
+     * More information about the different priority levels can be found in
+     * [the specification][rfc-west-cookie-priority-00-4.1].
+     *
+     * **note** This is an attribute that has not yet been fully standardized, and may change in the future.
+     * This also means many clients may ignore this attribute until they understand it.
+     */
+    priority?: "low" | "medium" | "high" | undefined;
+    /**
+     * Specifies the boolean or string to be the value for the {@link https://tools.ietf.org/html/draft-ietf-httpbis-rfc6265bis-03#section-4.1.2.7|`SameSite` `Set-Cookie` attribute}.
+     *
+     * - `true` will set the `SameSite` attribute to `Strict` for strict same
+     * site enforcement.
+     * - `false` will not set the `SameSite` attribute.
+     * - `'lax'` will set the `SameSite` attribute to Lax for lax same site
+     * enforcement.
+     * - `'strict'` will set the `SameSite` attribute to Strict for strict same
+     * site enforcement.
+     *  - `'none'` will set the SameSite attribute to None for an explicit
+     *  cross-site cookie.
+     *
+     * More information about the different enforcement levels can be found in {@link https://tools.ietf.org/html/draft-ietf-httpbis-rfc6265bis-03#section-4.1.2.7|the specification}.
+     *
+     * *note* This is an attribute that has not yet been fully standardized, and may change in the future. This also means many clients may ignore this attribute until they understand it.
+     */
+    sameSite?: true | false | "lax" | "strict" | "none" | undefined;
+    /**
+     * Specifies the boolean value for the {@link https://tools.ietf.org/html/rfc6265#section-5.2.5 | `Secure` `Set-Cookie` attribute}. When truthy, the
+     * `Secure` attribute is set, otherwise it is not. By default, the `Secure` attribute is not set.
+     *
+     * *Note* be careful when setting this to `true`, as compliant clients will
+     * not send the cookie back to the server in the future if the browser does
+     * not have an HTTPS connection.
+     */
+    secure?: boolean | undefined;
+    /**
+     * Specifies the `boolean` value for the [`Partitioned` `Set-Cookie`](https://datatracker.ietf.org/doc/html/draft-cutler-httpbis-partitioned-cookies#section-2.1)
+     * attribute. When truthy, the `Partitioned` attribute is set, otherwise it is not. By default, the
+     * `Partitioned` attribute is not set.
+     *
+     * **note** This is an attribute that has not yet been fully standardized, and may change in the future.
+     * This also means many clients may ignore this attribute until they understand it.
+     *
+     * More information can be found in the [proposal](https://github.com/privacycg/CHIPS).
+     */
+    partitioned?: boolean;
+}
+/**
+ * Additional parsing options
+ */
+export interface CookieParseOptions {
+    /**
+     * Specifies a function that will be used to decode a cookie's value. Since
+     * the value of a cookie has a limited character set (and must be a simple
+     * string), this function can be used to decode a previously-encoded cookie
+     * value into a JavaScript string or other object.
+     *
+     * The default function is the global `decodeURIComponent`, which will decode
+     * any URL-encoded sequences into their byte representations.
+     *
+     * *Note* if an error is thrown from this function, the original, non-decoded
+     * cookie value will be returned as the cookie's value.
+     */
+    decode?(value: string): string;
+    /**
+     * Custom function to filter parsing specific keys.
+     */
+    filter?(key: string): boolean;
+}
+export interface SetCookieParseOptions {
+    /**
+     * Custom decode function to use on cookie values.
+     *
+     * By default, `decodeURIComponent` is used.
+     *
+     * **Note:** If decoding fails, the original (undecoded) value will be used
+     */
+    decode?: false | ((value: string) => string);
+}
+export interface SetCookie {
+    /**
+     * Cookie name
+     */
+    name: string;
+    /**
+     * Cookie value
+     */
+    value: string;
+    /**
+     * Cookie path
+     */
+    path?: string | undefined;
+    /**
+     * Absolute expiration date for the cookie
+     */
+    expires?: Date | undefined;
+    /**
+     * Relative max age of the cookie in seconds from when the client receives it (integer or undefined)
+     *
+     * Note: when using with express's res.cookie() method, multiply maxAge by 1000 to convert to milliseconds
+     */
+    maxAge?: number | undefined;
+    /**
+     * Domain for the cookie,
+     * May begin with "." to indicate the named domain or any subdomain of it
+     */
+    domain?: string | undefined;
+    /**
+     * Indicates that this cookie should only be sent over HTTPs
+     */
+    secure?: boolean | undefined;
+    /**
+     * Indicates that this cookie should not be accessible to client-side JavaScript
+     */
+    httpOnly?: boolean | undefined;
+    /**
+     * Indicates a cookie ought not to be sent along with cross-site requests
+     */
+    sameSite?: true | false | "lax" | "strict" | "none" | undefined;
+    [key: string]: unknown;
+}

package/dist/url-builder.cjs

@@ -0,0 +1,96 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.StormURLBuilder = void 0;
+var _stormJson = require("@stryke/json/storm-json");
+var _isString = require("@stryke/types/type-checks/is-string");
+var _ufo = require("ufo");
+class StormURLBuilder {
+  #t;
+  static create(t, r) {
+    return new StormURLBuilder(t, r);
+  }
+  constructor(t, r) {
+    const s = r?.decode ?? !0,
+      o = (0, _isString.isString)(t) ? s ? (0, _ufo.parseURL)((0, _ufo.decode)(t)) : (0, _ufo.parseURL)(t) : t;
+    this.#t = {
+      __typename: "StormURL",
+      query: {},
+      ...o
+    }, this.#t.host && this.withHost(this.#t.host), this.#t.auth && this.withAuth(this.#t.auth);
+  }
+  get _url() {
+    return this.#t;
+  }
+  withProtocol(t) {
+    return this.#t.protocol = t, this;
+  }
+  withHostname(t) {
+    return this.#t.hostname = t, this;
+  }
+  withPort(t) {
+    return this.#t.port = String(t), this;
+  }
+  withUsername(t) {
+    return this.#t.username = t, this;
+  }
+  withPassword(t) {
+    return this.#t.password = t, this;
+  }
+  withHost(t) {
+    if ((0, _isString.isString)(t)) {
+      this.#t.host = t;
+      const r = (0, _ufo.parseAuth)(t);
+      this.#t.username = r.username, this.#t.password = r.password;
+    } else this.#t.hostname = t.hostname, this.#t.port = t.port, this.#t.auth = `${t.hostname}${t.port ? `:${t.port}` : ""}`;
+    return this;
+  }
+  withPath(t) {
+    const r = (0, _ufo.parsePath)(t);
+    return this.#t = {
+      ...this.#t,
+      ...r
+    }, this;
+  }
+  withHash(t) {
+    return this.#t.hash = t, this;
+  }
+  withAuth(t) {
+    if ((0, _isString.isString)(t)) {
+      this.#t.auth = t;
+      const r = (0, _ufo.parseAuth)(t);
+      this.#t.username = r.username, this.#t.password = r.password;
+    } else this.#t.username = t.username, this.#t.password = t.password, this.#t.auth = `${t.username}:${t.password}`;
+    return this;
+  }
+  withQuery(t) {
+    return this.#t.query = {}, this.addQueryParam(t), this;
+  }
+  addQueryParam(t) {
+    if ((0, _isString.isString)(t)) {
+      const r = (0, _ufo.parseQuery)(t);
+      for (const s in Object.entries(r)) s[0] && (this.#t.query[s[0]] = this.parseQueryParamValue(s[1]));
+    } else if (Array.isArray(t) && t.length === 2) this.#t.query[t[0]] = this.parseQueryParamValue(t[1]);else for (const r in Object.entries(t)) r[0] && (this.#t.query[r[0]] = this.parseQueryParamValue(r[1]));
+    return this;
+  }
+  build() {
+    return this.#t;
+  }
+  toString() {
+    return (0, _ufo.cleanDoubleSlashes)((0, _ufo.stringifyParsedURL)(this.#t));
+  }
+  toEncoded() {
+    return (0, _ufo.encode)(this.toString());
+  }
+  parseQueryParamValue(t) {
+    if (Array.isArray(t)) {
+      const r = [];
+      for (const s in t) r.push(this.parseQueryParamValue(s));
+      return r;
+    }
+    return _stormJson.StormJSON.parse(t);
+  }
+}
+exports.StormURLBuilder = StormURLBuilder;

package/dist/url-builder.d.ts

@@ -0,0 +1,138 @@
+import { type ParsedAuth, type ParsedHost } from "ufo";
+import type { StormURL } from "./types";
+export type StormURLBuilderOptions = {
+    /**
+     * Should the URL be decoded
+     *
+     * @defaultValue `true`
+     */
+    decode: boolean;
+};
+/**
+ * A class used to build URLs
+ *
+ * @remarks
+ * This class is used to build URLs with a fluent API.
+ *
+ * The [UFO](https://github.com/unjs/ufo) library is used under the hood to parse and stringify URLs.
+ *
+ * @class StormURLBuilder
+ */
+export declare class StormURLBuilder {
+    #private;
+    /**
+     * Create a new URL builder
+     *
+     * @param url - The URL to build
+     * @param options - The options for the URL builder
+     * @returns The URL builder
+     */
+    static create(url: string | StormURL, options?: StormURLBuilderOptions): StormURLBuilder;
+    /**
+     * Create a new URL builder
+     */
+    protected constructor(url: string | StormURL, options?: StormURLBuilderOptions);
+    get _url(): StormURL;
+    /**
+     * Set the protocol of the URL
+     *
+     * @param protocol - The protocol to set
+     * @returns The URL builder
+     */
+    withProtocol(protocol: string): StormURLBuilder;
+    /**
+     * Set the hostname of the URL
+     *
+     * @param hostname - The hostname to set
+     * @returns The URL builder
+     */
+    withHostname(hostname: string): StormURLBuilder;
+    /**
+     * Set the port of the URL
+     *
+     * @param port - The port to set
+     * @returns The URL builder
+     */
+    withPort(port: number): StormURLBuilder;
+    /**
+     * Set the username of the URL
+     *
+     * @param username - The username to set
+     * @returns The URL builder
+     */
+    withUsername(username: string): StormURLBuilder;
+    /**
+     * Set the password of the URL
+     *
+     * @param password - The password to set
+     * @returns The URL builder
+     */
+    withPassword(password: string): StormURLBuilder;
+    /**
+     * Set the pathname of the URL
+     *
+     * @param pathname - The pathname to set
+     * @returns The URL builder
+     */
+    withHost(host: string | ParsedHost): StormURLBuilder;
+    /**
+     * Set the path of the URL
+     *
+     * @param path - The path to set
+     * @returns The URL builder
+     */
+    withPath(path: string): StormURLBuilder;
+    /**
+     * Set the hash of the URL
+     *
+     * @param hash - The hash to set
+     * @returns The URL builder
+     */
+    withHash(hash: string): StormURLBuilder;
+    /**
+     * Set the auth of the URL
+     *
+     * @param auth - The auth to set
+     * @returns The URL builder
+     */
+    withAuth(auth: string | ParsedAuth): StormURLBuilder;
+    /**
+     * Set the query of the URL
+     *
+     * @param query - The query to set
+     * @returns The URL builder
+     */
+    withQuery(query: string | [string, any] | Record<string, any>): StormURLBuilder;
+    /**
+     * Add a query parameter to the URL
+     *
+     * @param query - The query parameter to add
+     * @returns The URL builder
+     */
+    addQueryParam(query: string | [string, any] | Record<string, any>): StormURLBuilder;
+    /**
+     * Returns the built URL
+     *
+     * @returns The built URL
+     */
+    build(): StormURL;
+    /**
+     * Returns the string representation of the URL
+     *
+     * @returns The string representation of the URL
+     */
+    toString(): string;
+    /**
+     * Returns the encoded string representation of the URL
+     *
+     * @returns The encoded string representation of the URL
+     */
+    toEncoded(): string;
+    /**
+     * Parse a query parameter value
+     *
+     * @param value - The value to parse
+     * @returns The parsed value
+     */
+    private parseQueryParamValue;
+}

package/dist/url-builder.mjs

@@ -0,0 +1 @@
+import{StormJSON as a}from"@stryke/json/storm-json";import{isString as i}from"@stryke/types/type-checks/is-string";import{cleanDoubleSlashes as u,decode as h,encode as p,parseAuth as e,parsePath as d,parseQuery as m,parseURL as n,stringifyParsedURL as c}from"ufo";export class StormURLBuilder{#t;static create(t,r){return new StormURLBuilder(t,r)}constructor(t,r){const s=r?.decode??!0,o=i(t)?s?n(h(t)):n(t):t;this.#t={__typename:"StormURL",query:{},...o},this.#t.host&&this.withHost(this.#t.host),this.#t.auth&&this.withAuth(this.#t.auth)}get _url(){return this.#t}withProtocol(t){return this.#t.protocol=t,this}withHostname(t){return this.#t.hostname=t,this}withPort(t){return this.#t.port=String(t),this}withUsername(t){return this.#t.username=t,this}withPassword(t){return this.#t.password=t,this}withHost(t){if(i(t)){this.#t.host=t;const r=e(t);this.#t.username=r.username,this.#t.password=r.password}else this.#t.hostname=t.hostname,this.#t.port=t.port,this.#t.auth=`${t.hostname}${t.port?`:${t.port}`:""}`;return this}withPath(t){const r=d(t);return this.#t={...this.#t,...r},this}withHash(t){return this.#t.hash=t,this}withAuth(t){if(i(t)){this.#t.auth=t;const r=e(t);this.#t.username=r.username,this.#t.password=r.password}else this.#t.username=t.username,this.#t.password=t.password,this.#t.auth=`${t.username}:${t.password}`;return this}withQuery(t){return this.#t.query={},this.addQueryParam(t),this}addQueryParam(t){if(i(t)){const r=m(t);for(const s in Object.entries(r))s[0]&&(this.#t.query[s[0]]=this.parseQueryParamValue(s[1]))}else if(Array.isArray(t)&&t.length===2)this.#t.query[t[0]]=this.parseQueryParamValue(t[1]);else for(const r in Object.entries(t))r[0]&&(this.#t.query[r[0]]=this.parseQueryParamValue(r[1]));return this}build(){return this.#t}toString(){return u(c(this.#t))}toEncoded(){return p(this.toString())}parseQueryParamValue(t){if(Array.isArray(t)){const r=[];for(const s in t)r.push(this.parseQueryParamValue(s));return r}return a.parse(t)}}