exacturi 1.0.0

package/LICENSE.md

@@ -0,0 +1,7 @@
+Copyright 2024 Greg Rosenbaum
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,2 @@
+# exacturi
+Library for manipualting URIs.

package/dist/cjs/errors.d.ts

@@ -0,0 +1,11 @@
+export declare class ExactUriError extends Error {
+    name: string;
+}
+export declare function badInputError(input: any, reason: string): ExactUriError;
+export declare function inputMustBeString(input: unknown): ExactUriError;
+export declare function cantSerializeArtificialUrl(url: string): ExactUriError;
+export declare function invalidCharacter(input: string, char: string, reason: string): ExactUriError;
+export declare function portMustBeNumeric(input: string): ExactUriError;
+export declare function inputMustBeUrl(input: string): ExactUriError;
+export declare function cantCompareType(value: unknown): ExactUriError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/cjs/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;IACpC,IAAI,SAAmB;CAC1B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,iBAEvD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,iBAE/C;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,iBAErD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,iBAE3E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,iBAE9C;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,iBAE3C;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,iBAE7C"}

package/dist/cjs/errors.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExactUriError = void 0;
+exports.badInputError = badInputError;
+exports.inputMustBeString = inputMustBeString;
+exports.cantSerializeArtificialUrl = cantSerializeArtificialUrl;
+exports.invalidCharacter = invalidCharacter;
+exports.portMustBeNumeric = portMustBeNumeric;
+exports.inputMustBeUrl = inputMustBeUrl;
+exports.cantCompareType = cantCompareType;
+class ExactUriError extends Error {
+    constructor() {
+        super(...arguments);
+        this.name = "ExactUriError";
+    }
+}
+exports.ExactUriError = ExactUriError;
+function badInputError(input, reason) {
+    return new ExactUriError(`Received bad input ${input}. ${reason}`);
+}
+function inputMustBeString(input) {
+    return badInputError(input, `Input must be a string, but was a ${typeof input}`);
+}
+function cantSerializeArtificialUrl(url) {
+    return new ExactUriError(`This URL is artificial and can't be serialized. Looks like: ${url}`);
+}
+function invalidCharacter(input, char, reason) {
+    return badInputError(input, `The character ${char} was unexpected because ${reason}.`);
+}
+function portMustBeNumeric(input) {
+    return badInputError(input, "Port must be numeric.");
+}
+function inputMustBeUrl(input) {
+    return badInputError(input, "Input failed to parse.");
+}
+function cantCompareType(value) {
+    return new ExactUriError(`Can't compare this URI to a value ${value}`);
+}
+//# sourceMappingURL=errors.js.map

package/dist/cjs/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":";;;AAIA,sCAEC;AAED,8CAEC;AAED,gEAEC;AAED,4CAEC;AAED,8CAEC;AAED,wCAEC;AAED,0CAEC;AA9BD,MAAa,aAAc,SAAQ,KAAK;IAAxC;;QACI,SAAI,GAAG,eAAe,CAAC;IAC3B,CAAC;CAAA;AAFD,sCAEC;AAED,SAAgB,aAAa,CAAC,KAAU,EAAE,MAAc;IACpD,OAAO,IAAI,aAAa,CAAC,sBAAsB,KAAK,KAAK,MAAM,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,SAAgB,iBAAiB,CAAC,KAAc;IAC5C,OAAO,aAAa,CAAC,KAAK,EAAE,qCAAqC,OAAO,KAAK,EAAE,CAAC,CAAC;AACrF,CAAC;AAED,SAAgB,0BAA0B,CAAC,GAAW;IAClD,OAAO,IAAI,aAAa,CAAC,+DAA+D,GAAG,EAAE,CAAC,CAAC;AACnG,CAAC;AAED,SAAgB,gBAAgB,CAAC,KAAa,EAAE,IAAY,EAAE,MAAc;IACxE,OAAO,aAAa,CAAC,KAAK,EAAE,iBAAiB,IAAI,2BAA2B,MAAM,GAAG,CAAC,CAAC;AAC3F,CAAC;AAED,SAAgB,iBAAiB,CAAC,KAAa;IAC3C,OAAO,aAAa,CAAC,KAAK,EAAE,uBAAuB,CAAC,CAAC;AACzD,CAAC;AAED,SAAgB,cAAc,CAAC,KAAa;IACxC,OAAO,aAAa,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC;AAC1D,CAAC;AAED,SAAgB,eAAe,CAAC,KAAc;IAC1C,OAAO,IAAI,aAAa,CAAC,qCAAqC,KAAK,EAAE,CAAC,CAAC;AAC3E,CAAC"}

package/dist/cjs/exacturi.d.ts

@@ -0,0 +1,91 @@
+import { ExactUri_Parts, ExactUri_PathKey, ExactUri_Protocol } from "./parts.js";
+/**
+ * Represents a URI and allows performing operations and inspecting it.
+ *
+ * This class is immutable.
+ */
+export declare class ExactUri {
+    private _protocol;
+    private _hostname;
+    private _path;
+    private _query;
+    private _hash;
+    private _parsed;
+    private _port;
+    constructor(_protocol: ExactUri_Protocol | undefined, _hostname: string | undefined, _path: string, _query: string | undefined, _hash: string | undefined, _parsed: string | undefined, _port: string | undefined);
+    static is(other: unknown): other is ExactUri;
+    segments(): string[];
+    segments(overwrite: string[]): ExactUri;
+    merge(other: string): ExactUri;
+    merge(other: ExactUri): ExactUri;
+    pick(...keys: ExactUri_PathKey[]): ExactUri;
+    parts(): ExactUri_Parts;
+    parts(overwrite: Partial<ExactUri_Parts>): ExactUri;
+    part(key: ExactUri_PathKey): string | undefined;
+    part(key: ExactUri_PathKey, value: string | undefined): ExactUri;
+    address(address: string | undefined | null): ExactUri;
+    address(): string | undefined;
+    resource(resource: string | undefined | null): ExactUri;
+    resource(): string | undefined;
+    origin(origin: string | undefined | null): ExactUri;
+    origin(): string | undefined;
+    segment(index: number): string;
+    segment(index: number, value: string): ExactUri;
+    path(): string;
+    path(path: string | undefined | null): ExactUri;
+    port(): number | undefined;
+    port(raw: true): string | undefined;
+    port(port: number | undefined | string | null): ExactUri;
+    protocol(): ExactUri_Protocol | undefined;
+    protocol(proto: ExactUri_Protocol | null | undefined): ExactUri;
+    host(): string | undefined;
+    host(host: string | undefined | null): ExactUri;
+    hostname(): string | undefined;
+    hostname(hostname: string | undefined | null): ExactUri;
+    query(): string | undefined;
+    query(query: string | null | undefined): ExactUri;
+    hash(): string;
+    hash(hash: string | null | undefined): ExactUri;
+    private _noCopyClone;
+    get isWeb(): boolean;
+    /**
+     * Gets a clone of this instance.
+     */
+    clone(): ExactUri;
+    static empty(): ExactUri;
+    static parse(input: null | undefined): ExactUri;
+    static parse(input: string | ExactUri | Partial<ExactUri_Parts>): ExactUri;
+    /**
+     * Checks if this URI (CHILD) matches another URI (PARENT). The parent can be a string,
+     * an {@link ExactUri}, or an object describing the parts of a URI -- an {@link ExactUri_Parts}.
+     *
+     * CHILD is considered to be a child of PARENT if:
+     * 1. If PARENT has a protocol, it must equal CHILD protocol.
+     * 2. If PARENT has a hostname, it must be a parent of CHILD's hostname.
+     * 3. If PARENT has a port, it must equal CHILD's port.
+     * 4. If PARENT has a path, it must be a parent of CHILD's path.
+     * 5. If PARENT has a query, it must equal CHILD's query.
+     * 6. If PARENT has a hash, it must equal CHILD's hash.
+     * @param parent The parent URI to check against.
+     */
+    matches(parent: Partial<ExactUri_Parts> | ExactUri | string): boolean;
+    /**
+     * Checks if this URI equals another URI, which can be given as a string, an
+     * {@link ExactUri}, or an object describing the parts of a URI -- an {@link ExactUri_Parts}.
+     * @param other The other URI to check against.
+     */
+    equal(other: string | ExactUri | Partial<ExactUri_Parts>): boolean;
+    get isArtificial(): boolean;
+    /**
+     * Does this URL have a non-web protocol?
+     */
+    get isNonWeb(): boolean;
+    /**
+     * Gets the full URI.
+     */
+    get href(): string;
+    private _print;
+    get [Symbol.toStringTag](): string;
+    toString(): string;
+}
+//# sourceMappingURL=exacturi.d.ts.map

package/dist/cjs/exacturi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exacturi.d.ts","sourceRoot":"","sources":["../../src/exacturi.ts"],"names":[],"mappings":"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"}

package/dist/cjs/exacturi.js

@@ -0,0 +1,332 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExactUri = void 0;
+const errors_js_1 = require("./errors.js");
+const utils_js_1 = require("./utils.js");
+/**
+ * Represents a URI and allows performing operations and inspecting it.
+ *
+ * This class is immutable.
+ */
+class ExactUri {
+    // Lots of params needed here
+    // eslint-disable-next-line max-params
+    constructor(_protocol, _hostname, _path, _query, _hash, _parsed, _port) {
+        this._protocol = _protocol;
+        this._hostname = _hostname;
+        this._path = _path;
+        this._query = _query;
+        this._hash = _hash;
+        this._parsed = _parsed;
+        this._port = _port;
+    }
+    static is(other) {
+        return !!(other && typeof other === "object" && other.constructor === ExactUri);
+    }
+    segments(overwrite) {
+        if (arguments.length === 0) {
+            return this._path.split("/");
+        }
+        const clone = this._noCopyClone();
+        clone._path = overwrite.join("/");
+        return clone;
+    }
+    merge(other) {
+        if (typeof other === "string") {
+            return this.merge(ExactUri.parse(other));
+        }
+        return this.parts({
+            hash: other._hash || this._hash,
+            hostname: other._hostname || this._hostname,
+            path: other._path || this._path,
+            port: other._port || this._port,
+            protocol: other._protocol || this._protocol,
+            query: other._query || this._query
+        });
+    }
+    pick(...keys) {
+        let result = ExactUri.empty();
+        for (const key of keys) {
+            result = result.part(key, this.part(key));
+        }
+        return result;
+    }
+    parts(overwrite) {
+        if (arguments.length === 0) {
+            return {
+                protocol: this._protocol,
+                hostname: this._hostname,
+                port: this._port,
+                path: this._path,
+                query: this._query,
+                hash: this._hash
+            };
+        }
+        if (!overwrite) {
+            return this;
+        }
+        const clone = this._noCopyClone();
+        clone._protocol = "protocol" in overwrite ? overwrite.protocol : clone._protocol;
+        clone._hostname = "hostname" in overwrite ? overwrite.hostname : clone._hostname;
+        clone._port = "port" in overwrite ? overwrite.port : clone._port;
+        clone._path = "path" in overwrite ? overwrite.path : clone._path;
+        clone._query = "query" in overwrite ? overwrite.query : clone._query;
+        clone._hash = "hash" in overwrite ? overwrite.hash : clone._hash;
+        return clone;
+    }
+    part(key, value) {
+        if (arguments.length === 1) {
+            const result = this[key]();
+            return result != null ? String(result) : undefined;
+        }
+        return this[key](value);
+    }
+    address(address) {
+        if (arguments.length === 1) {
+            const parsed = ExactUri.parse(address);
+            return parsed.parts({
+                protocol: this._protocol
+            });
+        }
+        return this.parts({
+            protocol: undefined
+        }).href;
+    }
+    resource(resource) {
+        if (arguments.length === 1) {
+            const parsed = ExactUri.parse(resource);
+            return parsed.parts({
+                protocol: this._protocol,
+                hostname: this._hostname,
+                port: this._port
+            });
+        }
+        return this.parts({
+            protocol: undefined,
+            hostname: undefined,
+            port: undefined
+        }).href;
+    }
+    origin(origin) {
+        if (arguments.length === 1) {
+            const parsed = ExactUri.parse(origin);
+            return this.parts({
+                protocol: parsed._protocol,
+                hostname: parsed._hostname,
+                port: parsed._port
+            });
+        }
+        const parts = this.parts();
+        return (ExactUri.empty().parts({
+            protocol: parts.protocol,
+            hostname: parts.hostname,
+            port: parts.port
+        }).href || undefined);
+    }
+    segment(index, value) {
+        if (arguments.length === 0) {
+            throw new errors_js_1.ExactUriError(`You must provide an index.`);
+        }
+        if (arguments.length === 1) {
+            return this._path.split("/")[index];
+        }
+        const segments = this.segments();
+        segments[index] = value;
+        return this.segments(segments);
+    }
+    path(path) {
+        if (arguments.length === 0) {
+            return this._path;
+        }
+        const clone = this._noCopyClone();
+        clone._path = path ?? "";
+        return clone;
+    }
+    port(port) {
+        if (arguments.length === 0) {
+            return this._port != null ? Number(this._port) : undefined;
+        }
+        if (port === true) {
+            return this._port;
+        }
+        const clone = this._noCopyClone();
+        clone._port = port != null ? String(port) : undefined;
+        return clone;
+    }
+    protocol(proto) {
+        if (arguments.length === 0) {
+            return this._protocol;
+        }
+        const clone = this._noCopyClone();
+        clone._protocol = proto ?? undefined;
+        return clone;
+    }
+    host(host) {
+        if (arguments.length === 0) {
+            return (ExactUri.empty().hostname(this._hostname).port(this._port).href.slice(2) ||
+                undefined);
+        }
+        if (host == null) {
+            return this.hostname(null).port(null);
+        }
+        const parsed = ExactUri.parse(`//${host}`);
+        return this.hostname(parsed._hostname).port(parsed._port);
+    }
+    hostname(hostname) {
+        if (arguments.length === 0) {
+            return this._hostname;
+        }
+        const clone = this._noCopyClone();
+        clone._hostname = hostname ?? undefined;
+        return clone;
+    }
+    query(query) {
+        if (arguments.length === 0) {
+            return this._query;
+        }
+        const clone = this._noCopyClone();
+        clone._query = query ?? undefined;
+        return clone;
+    }
+    hash(hash) {
+        if (arguments.length === 0) {
+            return this._hash;
+        }
+        const clone = this._noCopyClone();
+        clone._hash = hash ?? undefined;
+        return clone;
+    }
+    _noCopyClone() {
+        return new ExactUri(this._protocol, this._hostname, this._path, this._query, this._hash, this._parsed, this._port);
+    }
+    // Does this URL have a web protocol?
+    get isWeb() {
+        return !!this._protocol && webProtocols.has(this._protocol);
+    }
+    /**
+     * Gets a clone of this instance.
+     */
+    clone() {
+        return new ExactUri(this._protocol, this._hostname, this._path, this._query, this._hash, this._parsed, this._port);
+    }
+    static empty() {
+        return new ExactUri(undefined, undefined, "", undefined, undefined, undefined, undefined);
+    }
+    static parse(input) {
+        if (input == null) {
+            return ExactUri.empty();
+        }
+        if (input instanceof ExactUri) {
+            return input;
+        }
+        if (typeof input === "object") {
+            return ExactUri.empty().parts(input);
+        }
+        if (typeof input !== "string") {
+            throw (0, errors_js_1.inputMustBeString)(input);
+        }
+        const r = urlRegexp.exec(input);
+        if (!r) {
+            throw (0, errors_js_1.inputMustBeUrl)(input);
+        }
+        const [, proto, hostname, port, path, query, fragment] = r;
+        if (port != null && (Number.isNaN(+port) || port === "")) {
+            throw (0, errors_js_1.portMustBeNumeric)(input);
+        }
+        return new ExactUri(proto?.trim(), hostname?.trim(), path?.trim() ?? "", query?.trim(), fragment?.trim(), input, port);
+    }
+    /**
+     * Checks if this URI (CHILD) matches another URI (PARENT). The parent can be a string,
+     * an {@link ExactUri}, or an object describing the parts of a URI -- an {@link ExactUri_Parts}.
+     *
+     * CHILD is considered to be a child of PARENT if:
+     * 1. If PARENT has a protocol, it must equal CHILD protocol.
+     * 2. If PARENT has a hostname, it must be a parent of CHILD's hostname.
+     * 3. If PARENT has a port, it must equal CHILD's port.
+     * 4. If PARENT has a path, it must be a parent of CHILD's path.
+     * 5. If PARENT has a query, it must equal CHILD's query.
+     * 6. If PARENT has a hash, it must equal CHILD's hash.
+     * @param parent The parent URI to check against.
+     */
+    matches(parent) {
+        parent = ExactUri.parse(parent);
+        if (parent._protocol && parent._protocol !== this._protocol) {
+            return false;
+        }
+        if (parent._hostname && !(0, utils_js_1.hostnameContains)(this._hostname, parent._hostname)) {
+            return false;
+        }
+        if (parent._port && parent._port !== this._port) {
+            return false;
+        }
+        if (parent._query && parent._query !== this._query) {
+            return false;
+        }
+        if (parent._hash && parent._hash !== this._hash) {
+            return false;
+        }
+        const parentSegments = parent.segments();
+        const childSegments = this.segments();
+        for (let i = 0; i < parentSegments.length; i++) {
+            if (parentSegments[i] !== childSegments[i]) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Checks if this URI equals another URI, which can be given as a string, an
+     * {@link ExactUri}, or an object describing the parts of a URI -- an {@link ExactUri_Parts}.
+     * @param other The other URI to check against.
+     */
+    equal(other) {
+        if (this === other) {
+            return true;
+        }
+        other = ExactUri.parse(other);
+        const myParts = this.parts();
+        const otherParts = other.parts();
+        for (const key of ["protocol", "hostname", "port", "path", "query", "hash"]) {
+            if (myParts[key] !== otherParts[key]) {
+                return false;
+            }
+        }
+        return true;
+    }
+    // An artificial URI is one that can't have been parsed from a string due to an invalid combination of components.
+    get isArtificial() {
+        return !ExactUri.parse(this._print()).equal(this);
+    }
+    /**
+     * Does this URL have a non-web protocol?
+     */
+    get isNonWeb() {
+        return !!this._protocol && !webProtocols.has(this._protocol);
+    }
+    /**
+     * Gets the full URI.
+     */
+    get href() {
+        return this._print();
+    }
+    _print() {
+        let { _protocol, _hostname, _query, _hash } = this;
+        const { _port } = this;
+        _protocol = _protocol != null ? `${_protocol}:` : _protocol;
+        _hostname = _hostname != null ? `//${_hostname}` : "";
+        _query = _query != null ? `?${_query}` : "";
+        _hash = _hash != null ? `#${_hash}` : "";
+        const strPort = _port != null ? `:${_port}` : "";
+        return [_protocol, _hostname, strPort, this._path, _query, _hash].join("");
+    }
+    get [Symbol.toStringTag]() {
+        return this.href;
+    }
+    toString() {
+        return this.href;
+    }
+}
+exports.ExactUri = ExactUri;
+const urlRegexp = /^(?:([a-zA-Z][A-Za-z\d+-.]*):)?(?:\/\/([^/?#:]*)(?::([^/?#]*))?)?([^?#]*)?(?:\?([^#]*))?(?:#(.*))?$/;
+const webProtocols = new Set(["http", "ws", "https", "wss"]);
+//# sourceMappingURL=exacturi.js.map

package/dist/cjs/exacturi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exacturi.js","sourceRoot":"","sources":["../../src/exacturi.ts"],"names":[],"mappings":"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"}

package/dist/cjs/index.d.ts

@@ -0,0 +1,29 @@
+import { ExactUri } from "./exacturi.js";
+import { ExactUri_Parts } from "./parts.js";
+export { ExactUri } from "./exacturi.js";
+/**
+ * Creates an empty ExactUri object.
+ */
+export declare function exacturi(): ExactUri;
+/**
+ * Creates an ExactUri object from an {@link ExactUri_Parts} describing the parts of the URI.
+ * @param parts The parts of the URI.
+ */
+export declare function exacturi(parts: Partial<ExactUri_Parts>): ExactUri;
+/**
+ * Returns the same ExactUri object that was passed in.
+ * @param uri
+ */
+export declare function exacturi(uri: ExactUri): ExactUri;
+/**
+ * Parses a string into an ExactUri object.
+ * @param uri The string to parse.
+ */
+export declare function exacturi(uri: string): ExactUri;
+/**
+ * Returns true if the given value is an ExactUri object.
+ * @param uri The value to check.
+ */
+export declare function isExactUri(uri: unknown): uri is ExactUri;
+export { ExactUri_Protocol } from "./parts.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,wBAAgB,QAAQ,IAAI,QAAQ,CAAC;AACrC;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,QAAQ,CAAC;AACnE;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,QAAQ,CAAC;AAClD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC;AAKhD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,QAAQ,CAExD;AACD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExactUri = void 0;
+exports.exacturi = exacturi;
+exports.isExactUri = isExactUri;
+const exacturi_js_1 = require("./exacturi.js");
+var exacturi_js_2 = require("./exacturi.js");
+Object.defineProperty(exports, "ExactUri", { enumerable: true, get: function () { return exacturi_js_2.ExactUri; } });
+function exacturi(uri) {
+    return exacturi_js_1.ExactUri.parse(uri);
+}
+/**
+ * Returns true if the given value is an ExactUri object.
+ * @param uri The value to check.
+ */
+function isExactUri(uri) {
+    return exacturi_js_1.ExactUri.is(uri);
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAyBA,4BAEC;AAMD,gCAEC;AAnCD,+CAAyC;AAIzC,6CAAyC;AAAhC,uGAAA,QAAQ,OAAA;AAqBjB,SAAgB,QAAQ,CAAC,GAAiD;IACtE,OAAO,sBAAQ,CAAC,KAAK,CAAC,GAAU,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,SAAgB,UAAU,CAAC,GAAY;IACnC,OAAO,sBAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC"}

package/dist/cjs/parts.d.ts

@@ -0,0 +1,15 @@
+export type ExactUri_Protocol = "http" | "https" | "ws" | "wss" | "about" | "chrome" | "chrome-extension" | "data" | "blob" | "javascript" | "file" | "ftp" | string;
+export type ExactUri_CompoundNames = "host" | "origin" | "resource" | "address";
+export type ExactUri_PathKey = keyof ExactUri_Parts | ExactUri_CompoundNames;
+/**
+ * Describes the parts of a URI.
+ */
+export interface ExactUri_Parts {
+    protocol?: ExactUri_Protocol;
+    hostname?: string;
+    port?: string;
+    path: string;
+    query?: string;
+    hash?: string;
+}
+//# sourceMappingURL=parts.d.ts.map

package/dist/cjs/parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parts.d.ts","sourceRoot":"","sources":["../../src/parts.ts"],"names":[],"mappings":"AACA,MAAM,MAAM,iBAAiB,GACvB,MAAM,GACN,OAAO,GACP,IAAI,GACJ,KAAK,GACL,OAAO,GACP,QAAQ,GACR,kBAAkB,GAClB,MAAM,GACN,MAAM,GACN,YAAY,GACZ,MAAM,GACN,KAAK,GACL,MAAM,CAAC;AACb,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAChF,MAAM,MAAM,gBAAgB,GAAG,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/cjs/parts.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=parts.js.map

package/dist/cjs/parts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parts.js","sourceRoot":"","sources":["../../src/parts.ts"],"names":[],"mappings":""}