@zthun/webigail-url 5.0.3 → 5.0.6

package/dist/index.js

@@ -1,721 +1,655 @@
-import { keyBy, last, sortBy, trim, trimEnd, trimStart } from 'lodash-es';
-import URLParse from 'url-parse';
-
-/* cspell:disable */ /**
- * Application mime types.
- */ var ZMimeTypeApplication = /*#__PURE__*/ function(ZMimeTypeApplication) {
-    /**
-   * JSON data.
-   */ ZMimeTypeApplication["JSON"] = "application/json";
-    /**
-   * The unknown type.
-   *
-   * Used for raw byte data.
-   */ ZMimeTypeApplication["OctetStream"] = "application/octet-stream";
-    /**
-   * Compressed zip stream.
-   */ ZMimeTypeApplication["Zip"] = "application/zip";
-    return ZMimeTypeApplication;
+import { keyBy, last, sortBy, trim, trimEnd, trimStart } from "lodash-es";
+import URLParse from "url-parse";
+//#region src/mime/mime-type-application.mts
+/**
+* Application mime types.
+*/ var ZMimeTypeApplication = /* @__PURE__ */ function(ZMimeTypeApplication) {
+	/**
+	* JSON data.
+	*/ ZMimeTypeApplication["JSON"] = "application/json";
+	/**
+	* The unknown type.
+	*
+	* Used for raw byte data.
+	*/ ZMimeTypeApplication["OctetStream"] = "application/octet-stream";
+	/**
+	* Compressed zip stream.
+	*/ ZMimeTypeApplication["Zip"] = "application/zip";
+	return ZMimeTypeApplication;
 }({});
-
-/* cspell:disable */ /**
- * Mime types for images.
- */ var ZMimeTypeImage = /*#__PURE__*/ function(ZMimeTypeImage) {
-    /**
-   * Good choice for lossless animation sequences (GIF is less performant). AVIF and
-   * WebP have better performance but less broad browser support.
-   */ ZMimeTypeImage["APNG"] = "image/apng";
-    /**
-   * Good choice for both images and animated images due to high performance and
-   * royalty free image format. It offers much better compression than PNG or JPEG
-   * with support for higher color depths, animated frames, transparency etc.
-   *
-   * Note that when using AVIF, you should include fallbacks to formats with
-   * better browser support (i.e. using the <picture> element).
-   */ ZMimeTypeImage["AVIF"] = "image/avif";
-    /**
-   * Good choice for simple images and animations. Prefer PNG for lossless and
-   * indexed still images, and consider WebP, AVIF or APNG for animation sequences.
-   */ ZMimeTypeImage["GIF"] = "image/gif";
-    /**
-   * Good choice for lossy compression of still images (currently the most popular). Prefer
-   * PNG when more precise reproduction of the image is required, or WebP/AVIF if both better
-   * reproduction and higher compression are required.
-   */ ZMimeTypeImage["JPEG"] = "image/jpeg";
-    /**
-   * PNG is preferred over JPEG for more precise reproduction of source images, or when
-   * transparency is needed. WebP/AVIF provide even better compression and reproduction,
-   * but browser support is more limited.
-   */ ZMimeTypeImage["PNG"] = "image/png";
-    /**
-   * Vector image format; ideal for user interface elements, icons, diagrams, etc., that
-   * must be drawn accurately at different sizes.
-   */ ZMimeTypeImage["SVG"] = "image/svg+xml";
-    /**
-   * Excellent choice for both images and animated images. WebP offers much better compression
-   * than PNG or JPEG with support for higher color depths, animated frames, transparency etc.
-   * AVIF offers slightly better compression, but is not quite as well-supported in browsers
-   * and does not support progressive rendering.
-   */ ZMimeTypeImage["WebP"] = "image/webp";
-    return ZMimeTypeImage;
+//#endregion
+//#region src/mime/mime-type-image.mts
+/**
+* Mime types for images.
+*/ var ZMimeTypeImage = /* @__PURE__ */ function(ZMimeTypeImage) {
+	/**
+	* Good choice for lossless animation sequences (GIF is less performant). AVIF and
+	* WebP have better performance but less broad browser support.
+	*/ ZMimeTypeImage["APNG"] = "image/apng";
+	/**
+	* Good choice for both images and animated images due to high performance and
+	* royalty free image format. It offers much better compression than PNG or JPEG
+	* with support for higher color depths, animated frames, transparency etc.
+	*
+	* Note that when using AVIF, you should include fallbacks to formats with
+	* better browser support (i.e. using the <picture> element).
+	*/ ZMimeTypeImage["AVIF"] = "image/avif";
+	/**
+	* Good choice for simple images and animations. Prefer PNG for lossless and
+	* indexed still images, and consider WebP, AVIF or APNG for animation sequences.
+	*/ ZMimeTypeImage["GIF"] = "image/gif";
+	/**
+	* Good choice for lossy compression of still images (currently the most popular). Prefer
+	* PNG when more precise reproduction of the image is required, or WebP/AVIF if both better
+	* reproduction and higher compression are required.
+	*/ ZMimeTypeImage["JPEG"] = "image/jpeg";
+	/**
+	* PNG is preferred over JPEG for more precise reproduction of source images, or when
+	* transparency is needed. WebP/AVIF provide even better compression and reproduction,
+	* but browser support is more limited.
+	*/ ZMimeTypeImage["PNG"] = "image/png";
+	/**
+	* Vector image format; ideal for user interface elements, icons, diagrams, etc., that
+	* must be drawn accurately at different sizes.
+	*/ ZMimeTypeImage["SVG"] = "image/svg+xml";
+	/**
+	* Excellent choice for both images and animated images. WebP offers much better compression
+	* than PNG or JPEG with support for higher color depths, animated frames, transparency etc.
+	* AVIF offers slightly better compression, but is not quite as well-supported in browsers
+	* and does not support progressive rendering.
+	*/ ZMimeTypeImage["WebP"] = "image/webp";
+	return ZMimeTypeImage;
 }({});
-
-/* cspell:disable */ /**
- * Mime types for text based data.
- */ var ZMimeTypeText = /*#__PURE__*/ function(ZMimeTypeText) {
-    /**
-   * Style files used in html documents must be sent as
-   * css.
-   */ ZMimeTypeText["CSS"] = "text/css";
-    /**
-   * Comma separated values.
-   */ ZMimeTypeText["CSV"] = "text/csv";
-    /**
-   * JavaScript.
-   */ ZMimeTypeText["EcmaScript"] = "text/ecmascript";
-    /**
-   * Hyper Text Markup Language.  Markup language for
-   * web pages.
-   */ ZMimeTypeText["HTML"] = "text/html";
-    /**
-   * JavaScript.
-   */ ZMimeTypeText["JavaScript"] = "text/javascript";
-    /**
-   * Plain (basic) text.
-   */ ZMimeTypeText["Plain"] = "text/plain";
-    /**
-   * Xtreme Markup Language.
-   *
-   * Superset of HTML.  Bulky, but can
-   * represent anything.
-   */ ZMimeTypeText["XML"] = "text/xml";
-    return ZMimeTypeText;
+//#endregion
+//#region src/mime/mime-type-text.mts
+/**
+* Mime types for text based data.
+*/ var ZMimeTypeText = /* @__PURE__ */ function(ZMimeTypeText) {
+	/**
+	* Style files used in html documents must be sent as
+	* css.
+	*/ ZMimeTypeText["CSS"] = "text/css";
+	/**
+	* Comma separated values.
+	*/ ZMimeTypeText["CSV"] = "text/csv";
+	/**
+	* JavaScript.
+	*/ ZMimeTypeText["EcmaScript"] = "text/ecmascript";
+	/**
+	* Hyper Text Markup Language.  Markup language for
+	* web pages.
+	*/ ZMimeTypeText["HTML"] = "text/html";
+	/**
+	* JavaScript.
+	*/ ZMimeTypeText["JavaScript"] = "text/javascript";
+	/**
+	* Plain (basic) text.
+	*/ ZMimeTypeText["Plain"] = "text/plain";
+	/**
+	* Xtreme Markup Language.
+	*
+	* Superset of HTML.  Bulky, but can
+	* represent anything.
+	*/ ZMimeTypeText["XML"] = "text/xml";
+	return ZMimeTypeText;
 }({});
-
+//#endregion
+//#region src/mime/mime-type.mts
 /**
- * A mapping of supported mime types.
- */ const ZSupportedMimeTypes = Object.freeze({
-    ...{
-        "": "text/plain;charset=ASCII"
-    },
-    ...keyBy(Object.values(ZMimeTypeApplication)),
-    ...keyBy(Object.values(ZMimeTypeText)),
-    ...keyBy(Object.values(ZMimeTypeImage))
+* A mapping of supported mime types.
+*/ var ZSupportedMimeTypes = Object.freeze({
+	"": "text/plain;charset=ASCII",
+	...keyBy(Object.values(ZMimeTypeApplication)),
+	...keyBy(Object.values(ZMimeTypeText)),
+	...keyBy(Object.values(ZMimeTypeImage))
 });
-
-function _define_property$1(obj, key, value) {
-    if (key in obj) {
-        Object.defineProperty(obj, key, {
-            value: value,
-            enumerable: true,
-            configurable: true,
-            writable: true
-        });
-    } else {
-        obj[key] = value;
-    }
-    return obj;
-}
+//#endregion
+//#region src/data/data-url.mts
 /**
- * Represents an object that is helpful in building a data url with support
- * for data encoding.
- */ class ZDataUrlBuilder {
-    /**
-   * Parses an existing data url and sets all properties.
-   *
-   * @param url -
-   *        The url to parse.
-   *
-   * @returns
-   *        This object.
-   */ parse(url) {
-        this._data = {
-            mimeType: "",
-            encoding: "utf8",
-            buffer: new Uint8Array([])
-        };
-        if (!url.startsWith("data:")) {
-            return this;
-        }
-        url = url.substring(5);
-        const parts = url.split(",");
-        if (parts.length < 2) {
-            return this;
-        }
-        const [mimeType, ...bodyParts] = parts;
-        let [type, ...params] = mimeType.split(";");
-        const isBase64 = last(params) === "base64";
-        this._data.encoding = isBase64 ? "base64" : "utf8";
-        if (isBase64) {
-            params.pop();
-        }
-        if (!Object.hasOwnProperty.call(ZSupportedMimeTypes, type)) {
-            type = ZMimeTypeApplication.OctetStream;
-            params = [];
-        }
-        type = [
-            type,
-            ...params
-        ].join(";");
-        this._data.mimeType = type;
-        // Commas can be in the body.  Type this into chrome and you can
-        // see that chrome actually parses it:  data:text/plain,cat,,,
-        // We will support this here, but we're going to properly encode it.
-        let body = bodyParts.join("%2C");
-        if (isBase64) {
-            try {
-                body = atob(body);
-            } catch  {
-                body = "";
-            }
-        } else {
-            body = decodeURIComponent(body);
-        }
-        this._data.buffer = new TextEncoder().encode(body);
-        return this;
-    }
-    /**
-   * Sets the mime type.
-   *
-   * @param type -
-   *        The mime type.
-   *
-   * @returns
-   *        This object.
-   */ mimeType(type) {
-        this._data.mimeType = type;
-        return this;
-    }
-    /**
-   * Sets the data buffer.
-   *
-   * @param data -
-   *        The data to set.  If you pass a raw string, then the input encoding
-   *        is expected to be utf8.
-   * @returns
-   *        This object.
-   */ buffer(data) {
-        this._data.buffer = typeof data === "string" ? new TextEncoder().encode(data) : data;
-        return this;
-    }
-    /**
-   * Sets the output encoding.
-   *
-   * If you output encode the data as utf8, then it will be properly
-   * escaped.
-   *
-   * @param encoding -
-   *        The output encoding.
-   *
-   * @returns
-   *        This object.
-   */ encode(encoding) {
-        this._data.encoding = encoding;
-        return this;
-    }
-    /**
-   * Builds the url string and returns it.
-   *
-   * @returns The url string.
-   */ build() {
-        const protocol = "data";
-        const modifier = this._data.encoding === "base64" ? ";base64" : "";
-        let raw = new TextDecoder("utf8").decode(this._data.buffer);
-        if (this._data.encoding === "utf8") {
-            raw = encodeURIComponent(raw);
-            // Note ! should be encoded as %21, but for uri's..it's not because
-            // it's actually valid, but some servers don't accept ! as a character
-            // and it must be encoded.  Just fix it here.
-            raw = raw.split("!").join("%21");
-        }
-        if (this._data.encoding === "base64") {
-            raw = btoa(raw);
-        }
-        return `${protocol}:${this._data.mimeType}${modifier},${raw}`;
-    }
-    /**
-   * Gets the current information about the url being built.
-   *
-   * @returns The current information about the url being built.
-   */ info() {
-        const other = {
-            ...this._data
-        };
-        other.buffer = this._data.buffer.slice();
-        return other;
-    }
-    /**
-   * Initializes a new instance of this object.
-   */ constructor(){
-        /**
-   * The representation of the data url object.
-   */ _define_property$1(this, "_data", void 0);
-        this._data = {
-            mimeType: "",
-            encoding: "utf8",
-            buffer: new Uint8Array([])
-        };
-    }
-}
-
-function _define_property(obj, key, value) {
-    if (key in obj) {
-        Object.defineProperty(obj, key, {
-            value: value,
-            enumerable: true,
-            configurable: true,
-            writable: true
-        });
-    } else {
-        obj[key] = value;
-    }
-    return obj;
-}
+* Represents an object that is helpful in building a data url with support
+* for data encoding.
+*/ var ZDataUrlBuilder = class {
+	/**
+	* The representation of the data url object.
+	*/ _data;
+	/**
+	* Initializes a new instance of this object.
+	*/ constructor() {
+		this._data = {
+			mimeType: "",
+			encoding: "utf8",
+			buffer: new Uint8Array([])
+		};
+	}
+	/**
+	* Parses an existing data url and sets all properties.
+	*
+	* @param url -
+	*        The url to parse.
+	*
+	* @returns
+	*        This object.
+	*/ parse(url) {
+		this._data = {
+			mimeType: "",
+			encoding: "utf8",
+			buffer: new Uint8Array([])
+		};
+		if (!url.startsWith("data:")) return this;
+		url = url.substring(5);
+		const parts = url.split(",");
+		if (parts.length < 2) return this;
+		const [mimeType, ...bodyParts] = parts;
+		let [type, ...params] = mimeType.split(";");
+		const isBase64 = last(params) === "base64";
+		this._data.encoding = isBase64 ? "base64" : "utf8";
+		if (isBase64) params.pop();
+		if (!Object.hasOwnProperty.call(ZSupportedMimeTypes, type)) {
+			type = ZMimeTypeApplication.OctetStream;
+			params = [];
+		}
+		type = [type, ...params].join(";");
+		this._data.mimeType = type;
+		let body = bodyParts.join("%2C");
+		if (isBase64) try {
+			body = atob(body);
+		} catch {
+			body = "";
+		}
+		else body = decodeURIComponent(body);
+		this._data.buffer = new TextEncoder().encode(body);
+		return this;
+	}
+	/**
+	* Sets the mime type.
+	*
+	* @param type -
+	*        The mime type.
+	*
+	* @returns
+	*        This object.
+	*/ mimeType(type) {
+		this._data.mimeType = type;
+		return this;
+	}
+	/**
+	* Sets the data buffer.
+	*
+	* @param data -
+	*        The data to set.  If you pass a raw string, then the input encoding
+	*        is expected to be utf8.
+	* @returns
+	*        This object.
+	*/ buffer(data) {
+		this._data.buffer = typeof data === "string" ? new TextEncoder().encode(data) : data;
+		return this;
+	}
+	/**
+	* Sets the output encoding.
+	*
+	* If you output encode the data as utf8, then it will be properly
+	* escaped.
+	*
+	* @param encoding -
+	*        The output encoding.
+	*
+	* @returns
+	*        This object.
+	*/ encode(encoding) {
+		this._data.encoding = encoding;
+		return this;
+	}
+	/**
+	* Builds the url string and returns it.
+	*
+	* @returns The url string.
+	*/ build() {
+		const protocol = "data";
+		const modifier = this._data.encoding === "base64" ? ";base64" : "";
+		let raw = new TextDecoder("utf8").decode(this._data.buffer);
+		if (this._data.encoding === "utf8") {
+			raw = encodeURIComponent(raw);
+			raw = raw.split("!").join("%21");
+		}
+		if (this._data.encoding === "base64") raw = btoa(raw);
+		return `${protocol}:${this._data.mimeType}${modifier},${raw}`;
+	}
+	/**
+	* Gets the current information about the url being built.
+	*
+	* @returns The current information about the url being built.
+	*/ info() {
+		const other = { ...this._data };
+		other.buffer = this._data.buffer.slice();
+		return other;
+	}
+};
+//#endregion
+//#region src/url/url.mts
 /**
- * The api to target for YouTube.
- */ var ZYouTubeApi = /*#__PURE__*/ function(ZYouTubeApi) {
-    /**
-   * An embedded video link.
-   */ ZYouTubeApi["Embed"] = "embed";
-    /**
-   * A watch video link.
-   */ ZYouTubeApi["Watch"] = "watch";
-    return ZYouTubeApi;
+* The api to target for YouTube.
+*/ var ZYouTubeApi = /* @__PURE__ */ function(ZYouTubeApi) {
+	/**
+	* An embedded video link.
+	*/ ZYouTubeApi["Embed"] = "embed";
+	/**
+	* A watch video link.
+	*/ ZYouTubeApi["Watch"] = "watch";
+	return ZYouTubeApi;
 }({});
 /**
- * Represents an object that is helpful in building a url.
- */ class ZUrlBuilder {
-    /**
-   * Gets whether the given protocols default port is port.
-   *
-   * The main purpose of this method is to determine if a url requires
-   * a port section.  Therefore, there are some special behaviors which may
-   * not be obvious:
-   *
-   * 1.  If the port is falsy then this method returns true.
-   * 2.  If the port is NaN, then this method returns true.
-   * 3.  If the port is a string that evaluates to 0, then this method returns true.
-   * 4.  If port is less than 0, then this method returns true.
-   *
-   * @param protocol -
-   *        The protocol to check.
-   * @param port -
-   *        The port to compare.
-   *
-   * @returns
-   *        True if the default port for protocol is port.
-   */ static defaults(protocol, port) {
-        const numericPort = +port;
-        if (isNaN(numericPort) || numericPort < 1) {
-            return true;
-        }
-        return ZUrlBuilder.ProtocolPorts[protocol] === +port;
-    }
-    /**
-   * Fills the information from the current location data.
-   *
-   * @param loc -
-   *        The optional location object to populate with.
-   *
-   * @returns
-   *        This object.
-   */ location(loc) {
-        this.protocol(loc.protocol).hostname(loc.hostname).hash(loc.hash).path(loc.pathname).port(+loc.port);
-        let search = loc.search;
-        if (search.startsWith("?")) {
-            search = search.slice(1);
-            const pairs = search.split("&");
-            pairs.map((pair)=>pair.split("=")).forEach((matrix)=>this.param(matrix[0], matrix[1]));
-        }
-        return this;
-    }
-    /**
-   * Fills the information for an api path call.
-   *
-   * This is a combination of location, hash with an empty string, and an
-   * append of the basePath.
-   *
-   * @param loc -
-   *        The optional location object to populate with.
-   * @param basePath -
-   *        The basePath for the api.  Generally, it's best to
-   *        just keep this as api and have your server accept
-   *        this path.
-   *
-   * @returns
-   *        This object.
-   */ api(loc, basePath = "api") {
-        return this.location(loc).hash("").path(basePath);
-    }
-    /**
-   * Parses an existing url and sets all properties.
-   *
-   * If you give this a path without the protocol and hostname, then it will
-   * automatically append the protocol and host of the browser window if it
-   * exists.
-   *
-   * This method sets all the properties so if you need to modify the url before
-   * parsing it, it is best to always call this method first.
-   *
-   * @param url -
-   *        The url to parse.
-   *
-   * @returns
-   *        This object.
-   */ parse(url) {
-        const current = new URLParse(url, true);
-        this.protocol(current.protocol).username(current.username).password(current.password).hostname(current.hostname).hash(current.hash).path(current.pathname).port(current.port ? +current.port : undefined);
-        Object.keys(current.query).forEach((key)=>this.param(key, current.query[key]));
-        return this;
-    }
-    /**
-   * Sets the url for a user gravatar.
-   *
-   * @param hash -
-   *        The md5 email hash.
-   * @param size -
-   *        The dimensional size of the gravatar image.
-   *
-   * @returns
-   *        This object.
-   */ gravatar(hash, size) {
-        let current = this.parse(ZUrlBuilder.UrlGravatar);
-        current = hash ? current.append(hash) : current;
-        current = size ? current.param("s", String(size)) : current;
-        return current;
-    }
-    /**
-   * Sets the url target to something on YouTube.
-   *
-   * @param api -
-   *        The supported api.
-   * @param id -
-   *        The id of the video.  If api is set,
-   *        then this parameter is required.
-   *
-   * @returns
-   *        The url for YouTube.  If you set the api and
-   *        id, then the url will be targeted to a specific video,
-   *        otherwise, the base domain url of YouTube will be returned.
-   */ youTube(api, id) {
-        let current = this.parse(ZUrlBuilder.UrlYouTube);
-        current = api ? current.path(`${api}/${id}`) : current;
-        // The watch api is a little bizarre that they don't actually
-        // use the same format as their other apis.  So we will handle this here.
-        if (api === "watch") {
-            current = current.path(api).param("v", id);
-        }
-        return current;
-    }
-    /**
-   * Sets the protocol.
-   *
-   * @param protocol -
-   *        The protocol.
-   *
-   * @returns
-   *        This object.
-   */ protocol(protocol) {
-        this._url.protocol = protocol;
-        return this;
-    }
-    /**
-   * Sets the user name.
-   *
-   * Used for things like ssh and ftp.
-   *
-   * @param user -
-   *        The username
-   *
-   * @returns
-   *        This object.
-   */ username(user) {
-        this._url.username = user;
-        return this;
-    }
-    /**
-   * Sets the password.
-   *
-   * This is only valid if the username is set.
-   *
-   * @param pwd -
-   *        The user password.
-   *
-   * @returns
-   *        This object.
-   */ password(pwd) {
-        this._url.password = pwd;
-        return this;
-    }
-    /**
-   * Sets the host name.
-   *
-   * This sets the entire hostname as the root domain.  This
-   * will blow away any subdomains added, so it's best to
-   * call this method first.
-   *
-   * @param host -
-   *        The hostname.
-   *
-   * @returns
-   *        This object.
-   */ hostname(host) {
-        this._url.hostname = host;
-        return this;
-    }
-    /**
-   * Adds a subdomain in front of the hostname.
-   *
-   * If a hostname was never set, then domain becomes the hostname.
-   *
-   * @param domain -
-   *        The domain to append.
-   *
-   * @returns
-   *        This object.
-   */ subdomain(domain) {
-        this._url.hostname = this._url.hostname ? `${domain}.${this._url.hostname}` : domain;
-        return this;
-    }
-    /**
-   * Removes a subdomain from the current domain.
-   *
-   * @returns
-   *        This object.
-   */ popSubdomain() {
-        const parts = this._url.hostname.split(".");
-        parts.splice(0, 1);
-        this._url.hostname = parts.join(".");
-        return this;
-    }
-    /**
-   * Sets the port.
-   *
-   * @param port -
-   *        The port.
-   *
-   * @returns
-   *        This object.
-   */ port(port) {
-        this._url.port = port;
-        return this;
-    }
-    /**
-   * Removes all existing path segments and restarts the path.
-   *
-   * @param path -
-   *        The starting path.
-   *
-   * @returns
-   *        This object.
-   */ path(path) {
-        this._url.path = [
-            path
-        ];
-        return this;
-    }
-    /**
-   * Appends a path segment.
-   *
-   * @param path -
-   *        The segment to append.
-   *
-   * @returns
-   *        This object.
-   */ append(path) {
-        this._url.path.push(path);
-        return this;
-    }
-    /**
-   * Sets the hash section.
-   *
-   * @param hash -
-   *        The hash section.
-   *
-   * @returns
-   *        This object.
-   */ hash(hash) {
-        this._url.hash = hash;
-        return this;
-    }
-    /**
-   * Adds a search parameter.
-   *
-   * This version assumes that value is not null.
-   *
-   * @param key -
-   *        The parameter key.
-   * @param val -
-   *        The parameter value.
-   *
-   * @returns
-   *        This object.
-   */ param(key, val) {
-        this._url.params.push({
-            key,
-            val
-        });
-        return this;
-    }
-    /**
-   * Removes all duplicate params and adds one with the key to the value.
-   *
-   * @param key -
-   *        The parameter key that can have only one.
-   * @param val -
-   *        The parameter value.  If this is falsy, then
-   *        the key is deleted.
-   */ onlyParam(key, val) {
-        this._url.params = this._url.params.filter((p)=>p.key !== key);
-        return val ? this.param(key, val) : this;
-    }
-    /**
-   * Adds a page param.
-   *
-   * @param page -
-   *        The page param to add.  If this null, undefined,
-   *        or less than 1, then any page param is deleted.
-   *
-   * @returns
-   *        This object.
-   */ page(page) {
-        return this.onlyParam("page", page == null || page < 1 ? undefined : String(page));
-    }
-    /**
-   * Adds a size param.
-   *
-   * @param size -
-   *        The size param to add.  If this is null, undefined,
-   *        or less than 0, then any size param is deleted.
-   *
-   * @returns
-   *        This object.
-   */ size(size) {
-        return this.onlyParam("size", size == null || size < 0 ? undefined : String(size));
-    }
-    /**
-   * Adds a search param.
-   *
-   * @param search -
-   *        The search param to add.  If this is null, undefined,
-   *        or empty, then any search param is deleted.
-   *
-   * @returns
-   *        This object.
-   */ search(search) {
-        return this.onlyParam("search", search || undefined);
-    }
-    /**
-   * Adds a filter param.
-   *
-   * @param filter -
-   *        The filter param to add.  If this is null, undefined,
-   *        or empty, then any filter param is deleted.
-   *
-   * @returns
-   *        This object.
-   */ filter(filter) {
-        return this.onlyParam("filter", filter || undefined);
-    }
-    /**
-   * Adds a sort param.
-   *
-   * @param sort -
-   *        The sort param to add.  If this is null, undefined,
-   *        or empty, then any filter param is deleted.
-   *
-   * @returns
-   *        This object.
-   */ sort(sort) {
-        return this.onlyParam("sort", sort || undefined);
-    }
-    /**
-   * Builds the url string and returns it.
-   *
-   * @returns
-   *        The url string.
-   */ build() {
-        const search = sortBy(this._url.params, (p)=>p.key).map((param)=>`${param.key}=${encodeURIComponent(param.val)}`).join("&");
-        const user = trim(this._url.username);
-        const password = trim(this._url.password);
-        let protocol = trim(this._url.protocol);
-        let host = trim(this._url.hostname);
-        let port = String(this._url.port);
-        let hash = trim(this._url.hash);
-        let path = this._url.path.map((segment)=>trim(segment, "/")).join("/");
-        let credentials = "";
-        protocol = trimEnd(protocol, "/:");
-        host = trim(host, "/");
-        hash = trimStart(hash, "#");
-        path = trim(path, "/");
-        if (ZUrlBuilder.defaults(protocol, port)) {
-            port = "";
-        } else {
-            port = `:${port}`;
-        }
-        if (user) {
-            credentials = password ? `${user}:${password}@` : `${user}@`;
-        }
-        let url = `${protocol}://${credentials}${host}${port}`;
-        if (path) {
-            url = `${url}/${path}`;
-        }
-        if (search) {
-            url = `${url}/?${search}`;
-        }
-        if (hash) {
-            url = `${url}#${hash}`;
-        }
-        return url;
-    }
-    /**
-   * Gets the current information about the uri being built.
-   *
-   * @returns The current uri information.
-   */ info() {
-        return JSON.parse(JSON.stringify(this._url));
-    }
-    /**
-   * Initializes a new instance of this object.
-   *
-   * @param protocol -
-   *        The protocol to use.
-   * @param hostname -
-   *        The hostname to connect with.
-   */ constructor(protocol = "http", hostname = "localhost"){
-        /**
-   * The representation of the url object.
-   */ _define_property(this, "_url", void 0);
-        this._url = {
-            protocol,
-            hostname,
-            path: [
-                "/"
-            ],
-            hash: "",
-            params: []
-        };
-    }
-}
-/**
-   * The url to the gravatar api.
-   */ _define_property(ZUrlBuilder, "UrlGravatar", "https://s.gravatar.com/avatar");
-/**
-   * The url to youtube.
-   *
-   * This is mostly used to embed videos.
-   */ _define_property(ZUrlBuilder, "UrlYouTube", "https://www.youtube.com");
-/**
-   * A mapping between protocol and default port.
-   */ _define_property(ZUrlBuilder, "ProtocolPorts", {
-    http: 80,
-    https: 443,
-    ftp: 21,
-    sftp: 22,
-    ssh: 22,
-    smtp: 25,
-    smb: 445
-});
-
+* Represents an object that is helpful in building a url.
+*/ var ZUrlBuilder = class ZUrlBuilder {
+	/**
+	* The url to the gravatar api.
+	*/ static UrlGravatar = "https://s.gravatar.com/avatar";
+	/**
+	* The url to youtube.
+	*
+	* This is mostly used to embed videos.
+	*/ static UrlYouTube = "https://www.youtube.com";
+	/**
+	* A mapping between protocol and default port.
+	*/ static ProtocolPorts = {
+		http: 80,
+		https: 443,
+		ftp: 21,
+		sftp: 22,
+		ssh: 22,
+		smtp: 25,
+		smb: 445
+	};
+	/**
+	* Gets whether the given protocols default port is port.
+	*
+	* The main purpose of this method is to determine if a url requires
+	* a port section.  Therefore, there are some special behaviors which may
+	* not be obvious:
+	*
+	* 1.  If the port is falsy then this method returns true.
+	* 2.  If the port is NaN, then this method returns true.
+	* 3.  If the port is a string that evaluates to 0, then this method returns true.
+	* 4.  If port is less than 0, then this method returns true.
+	*
+	* @param protocol -
+	*        The protocol to check.
+	* @param port -
+	*        The port to compare.
+	*
+	* @returns
+	*        True if the default port for protocol is port.
+	*/ static defaults(protocol, port) {
+		const numericPort = +port;
+		if (isNaN(numericPort) || numericPort < 1) return true;
+		return ZUrlBuilder.ProtocolPorts[protocol] === +port;
+	}
+	/**
+	* The representation of the url object.
+	*/ _url;
+	/**
+	* Initializes a new instance of this object.
+	*
+	* @param protocol -
+	*        The protocol to use.
+	* @param hostname -
+	*        The hostname to connect with.
+	*/ constructor(protocol = "http", hostname = "localhost") {
+		this._url = {
+			protocol,
+			hostname,
+			path: ["/"],
+			hash: "",
+			params: []
+		};
+	}
+	/**
+	* Fills the information from the current location data.
+	*
+	* @param loc -
+	*        The optional location object to populate with.
+	*
+	* @returns
+	*        This object.
+	*/ location(loc) {
+		this.protocol(loc.protocol).hostname(loc.hostname).hash(loc.hash).path(loc.pathname).port(+loc.port);
+		let search = loc.search;
+		if (search.startsWith("?")) {
+			search = search.slice(1);
+			search.split("&").map((pair) => pair.split("=")).forEach((matrix) => this.param(matrix[0], matrix[1]));
+		}
+		return this;
+	}
+	/**
+	* Fills the information for an api path call.
+	*
+	* This is a combination of location, hash with an empty string, and an
+	* append of the basePath.
+	*
+	* @param loc -
+	*        The optional location object to populate with.
+	* @param basePath -
+	*        The basePath for the api.  Generally, it's best to
+	*        just keep this as api and have your server accept
+	*        this path.
+	*
+	* @returns
+	*        This object.
+	*/ api(loc, basePath = "api") {
+		return this.location(loc).hash("").path(basePath);
+	}
+	/**
+	* Parses an existing url and sets all properties.
+	*
+	* If you give this a path without the protocol and hostname, then it will
+	* automatically append the protocol and host of the browser window if it
+	* exists.
+	*
+	* This method sets all the properties so if you need to modify the url before
+	* parsing it, it is best to always call this method first.
+	*
+	* @param url -
+	*        The url to parse.
+	*
+	* @returns
+	*        This object.
+	*/ parse(url) {
+		const current = new URLParse(url, true);
+		this.protocol(current.protocol).username(current.username).password(current.password).hostname(current.hostname).hash(current.hash).path(current.pathname).port(current.port ? +current.port : void 0);
+		Object.keys(current.query).forEach((key) => this.param(key, current.query[key]));
+		return this;
+	}
+	/**
+	* Sets the url for a user gravatar.
+	*
+	* @param hash -
+	*        The md5 email hash.
+	* @param size -
+	*        The dimensional size of the gravatar image.
+	*
+	* @returns
+	*        This object.
+	*/ gravatar(hash, size) {
+		let current = this.parse(ZUrlBuilder.UrlGravatar);
+		current = hash ? current.append(hash) : current;
+		current = size ? current.param("s", String(size)) : current;
+		return current;
+	}
+	/**
+	* Sets the url target to something on YouTube.
+	*
+	* @param api -
+	*        The supported api.
+	* @param id -
+	*        The id of the video.  If api is set,
+	*        then this parameter is required.
+	*
+	* @returns
+	*        The url for YouTube.  If you set the api and
+	*        id, then the url will be targeted to a specific video,
+	*        otherwise, the base domain url of YouTube will be returned.
+	*/ youTube(api, id) {
+		let current = this.parse(ZUrlBuilder.UrlYouTube);
+		current = api ? current.path(`${api}/${id}`) : current;
+		if (api === "watch") current = current.path(api).param("v", id);
+		return current;
+	}
+	/**
+	* Sets the protocol.
+	*
+	* @param protocol -
+	*        The protocol.
+	*
+	* @returns
+	*        This object.
+	*/ protocol(protocol) {
+		this._url.protocol = protocol;
+		return this;
+	}
+	/**
+	* Sets the user name.
+	*
+	* Used for things like ssh and ftp.
+	*
+	* @param user -
+	*        The username
+	*
+	* @returns
+	*        This object.
+	*/ username(user) {
+		this._url.username = user;
+		return this;
+	}
+	/**
+	* Sets the password.
+	*
+	* This is only valid if the username is set.
+	*
+	* @param pwd -
+	*        The user password.
+	*
+	* @returns
+	*        This object.
+	*/ password(pwd) {
+		this._url.password = pwd;
+		return this;
+	}
+	/**
+	* Sets the host name.
+	*
+	* This sets the entire hostname as the root domain.  This
+	* will blow away any subdomains added, so it's best to
+	* call this method first.
+	*
+	* @param host -
+	*        The hostname.
+	*
+	* @returns
+	*        This object.
+	*/ hostname(host) {
+		this._url.hostname = host;
+		return this;
+	}
+	/**
+	* Adds a subdomain in front of the hostname.
+	*
+	* If a hostname was never set, then domain becomes the hostname.
+	*
+	* @param domain -
+	*        The domain to append.
+	*
+	* @returns
+	*        This object.
+	*/ subdomain(domain) {
+		this._url.hostname = this._url.hostname ? `${domain}.${this._url.hostname}` : domain;
+		return this;
+	}
+	/**
+	* Removes a subdomain from the current domain.
+	*
+	* @returns
+	*        This object.
+	*/ popSubdomain() {
+		const parts = this._url.hostname.split(".");
+		parts.splice(0, 1);
+		this._url.hostname = parts.join(".");
+		return this;
+	}
+	/**
+	* Sets the port.
+	*
+	* @param port -
+	*        The port.
+	*
+	* @returns
+	*        This object.
+	*/ port(port) {
+		this._url.port = port;
+		return this;
+	}
+	/**
+	* Removes all existing path segments and restarts the path.
+	*
+	* @param path -
+	*        The starting path.
+	*
+	* @returns
+	*        This object.
+	*/ path(path) {
+		this._url.path = [path];
+		return this;
+	}
+	/**
+	* Appends a path segment.
+	*
+	* @param path -
+	*        The segment to append.
+	*
+	* @returns
+	*        This object.
+	*/ append(path) {
+		this._url.path.push(path);
+		return this;
+	}
+	/**
+	* Sets the hash section.
+	*
+	* @param hash -
+	*        The hash section.
+	*
+	* @returns
+	*        This object.
+	*/ hash(hash) {
+		this._url.hash = hash;
+		return this;
+	}
+	/**
+	* Adds a search parameter.
+	*
+	* This version assumes that value is not null.
+	*
+	* @param key -
+	*        The parameter key.
+	* @param val -
+	*        The parameter value.
+	*
+	* @returns
+	*        This object.
+	*/ param(key, val) {
+		this._url.params.push({
+			key,
+			val
+		});
+		return this;
+	}
+	/**
+	* Removes all duplicate params and adds one with the key to the value.
+	*
+	* @param key -
+	*        The parameter key that can have only one.
+	* @param val -
+	*        The parameter value.  If this is falsy, then
+	*        the key is deleted.
+	*/ onlyParam(key, val) {
+		this._url.params = this._url.params.filter((p) => p.key !== key);
+		return val ? this.param(key, val) : this;
+	}
+	/**
+	* Adds a page param.
+	*
+	* @param page -
+	*        The page param to add.  If this null, undefined,
+	*        or less than 1, then any page param is deleted.
+	*
+	* @returns
+	*        This object.
+	*/ page(page) {
+		return this.onlyParam("page", page == null || page < 1 ? void 0 : String(page));
+	}
+	/**
+	* Adds a size param.
+	*
+	* @param size -
+	*        The size param to add.  If this is null, undefined,
+	*        or less than 0, then any size param is deleted.
+	*
+	* @returns
+	*        This object.
+	*/ size(size) {
+		return this.onlyParam("size", size == null || size < 0 ? void 0 : String(size));
+	}
+	/**
+	* Adds a search param.
+	*
+	* @param search -
+	*        The search param to add.  If this is null, undefined,
+	*        or empty, then any search param is deleted.
+	*
+	* @returns
+	*        This object.
+	*/ search(search) {
+		return this.onlyParam("search", search || void 0);
+	}
+	/**
+	* Adds a filter param.
+	*
+	* @param filter -
+	*        The filter param to add.  If this is null, undefined,
+	*        or empty, then any filter param is deleted.
+	*
+	* @returns
+	*        This object.
+	*/ filter(filter) {
+		return this.onlyParam("filter", filter || void 0);
+	}
+	/**
+	* Adds a sort param.
+	*
+	* @param sort -
+	*        The sort param to add.  If this is null, undefined,
+	*        or empty, then any filter param is deleted.
+	*
+	* @returns
+	*        This object.
+	*/ sort(sort) {
+		return this.onlyParam("sort", sort || void 0);
+	}
+	/**
+	* Builds the url string and returns it.
+	*
+	* @returns
+	*        The url string.
+	*/ build() {
+		const search = sortBy(this._url.params, (p) => p.key).map((param) => `${param.key}=${encodeURIComponent(param.val)}`).join("&");
+		const user = trim(this._url.username);
+		const password = trim(this._url.password);
+		let protocol = trim(this._url.protocol);
+		let host = trim(this._url.hostname);
+		let port = String(this._url.port);
+		let hash = trim(this._url.hash);
+		let path = this._url.path.map((segment) => trim(segment, "/")).join("/");
+		let credentials = "";
+		protocol = trimEnd(protocol, "/:");
+		host = trim(host, "/");
+		hash = trimStart(hash, "#");
+		path = trim(path, "/");
+		if (ZUrlBuilder.defaults(protocol, port)) port = "";
+		else port = `:${port}`;
+		if (user) credentials = password ? `${user}:${password}@` : `${user}@`;
+		let url = `${protocol}://${credentials}${host}${port}`;
+		if (path) url = `${url}/${path}`;
+		if (search) url = `${url}/?${search}`;
+		if (hash) url = `${url}#${hash}`;
+		return url;
+	}
+	/**
+	* Gets the current information about the uri being built.
+	*
+	* @returns The current uri information.
+	*/ info() {
+		return JSON.parse(JSON.stringify(this._url));
+	}
+};
+//#endregion
 export { ZDataUrlBuilder, ZMimeTypeApplication, ZMimeTypeImage, ZMimeTypeText, ZSupportedMimeTypes, ZUrlBuilder, ZYouTubeApi };
-//# sourceMappingURL=index.js.map
+
+//# sourceMappingURL=index.js.map