@api-client/core 0.9.25 → 0.10.0

package/build/cjs/src/lib/parsers/UrlEncoder.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UrlEncoder = void 0;
+/* eslint-disable @typescript-eslint/ban-ts-comment */
+class UrlEncoder {
+    /**
+     * Returns a string where all characters that are not valid for a URL
+     * component have been escaped. The escaping of a character is done by
+     * converting it into its UTF-8 encoding and then encoding each of the
+     * resulting bytes as a %xx hexadecimal escape sequence.
+     * <p>
+     * Note: this method will convert any the space character into its escape
+     * short form, '+' rather than %20. It should therefore only be used for
+     * query-string parts.
+     *
+     * <p>
+     * The following character sets are <em>not</em> escaped by this method:
+     * <ul>
+     * <li>ASCII digits or letters</li>
+     * <li>ASCII punctuation characters:
+     *
+     * <pre>- _ . ! ~ * ' ( )</pre>
+     * </li>
+     * </ul>
+     * </p>
+     *
+     * <p>
+     * Notice that this method <em>does</em> encode the URL component delimiter
+     * characters:<blockquote>
+     *
+     * <pre>
+     * ; / ? : &amp; = + $ , #
+     * </pre>
+     *
+     * </blockquote>
+     * </p>
+     *
+     * @param str A string containing invalid URL characters
+     * @param replacePlus When set it replaces `%20` with `+`.
+     * @returns a string with all invalid URL characters escaped
+     */
+    static encodeQueryString(str, replacePlus) {
+        if (!str) {
+            return str;
+        }
+        // normalize
+        let result = str.toString().replace(/\r?\n/g, "\r\n");
+        // encode
+        result = encodeURIComponent(result);
+        if (replacePlus) {
+            // replace "%20" with "+" when needed
+            result = result.replace(/%20/g, "+");
+        }
+        return result;
+    }
+    /**
+     * Returns a string where all URL component escape sequences have been
+     * converted back to their original character representations.
+     *
+     * Note: this method will convert the space character escape short form, '+',
+     * into a space. It should therefore only be used for query-string parts.
+     *
+     * @param str A string containing encoded URL component sequences
+     * @param replacePlus When set it replaces `+` with `%20`.
+     * @returns string with no encoded URL component encoded sequences
+     */
+    static decodeQueryString(str, replacePlus) {
+        if (!str) {
+            return str;
+        }
+        let result = str;
+        if (replacePlus) {
+            result = str.replace(/\+/g, "%20");
+        }
+        return decodeURIComponent(result);
+    }
+    static strictEncode(str) {
+        if (!str) {
+            return str;
+        }
+        const escaped = {
+            '!': '%21',
+            "'": '%27',
+            '(': '%28',
+            ')': '%29',
+        };
+        return encodeURIComponent(str).replace(/\*/g, '%2A')
+            // @ts-ignore
+            .replace(/[!'()*]/g, (c) => escaped[c]);
+    }
+    /**
+     * For URI templates encodes the URL string without encoding the reserved characters.
+     */
+    static encodeReserved(str) {
+        if (!str) {
+            return str;
+        }
+        const expression = /%(21|23|24|26|27|28|29|2A|2B|2C|2F|3A|3B|3D|3F|40|5B|5D)/ig;
+        const map = {
+            // gen-delims
+            '%3A': ':',
+            '%2F': '/',
+            '%3F': '?',
+            '%23': '#',
+            '%5B': '[',
+            '%5D': ']',
+            '%40': '@',
+            // sub-delims
+            '%21': '!',
+            '%24': '$',
+            '%26': '&',
+            '%27': '\'',
+            '%28': '(',
+            '%29': ')',
+            '%2A': '*',
+            '%2B': '+',
+            '%2C': ',',
+            '%3B': ';',
+            '%3D': '='
+        };
+        let result = UrlEncoder.strictEncode(str);
+        // @ts-ignore
+        result = result.replace(expression, (c) => map[c]);
+        return result;
+    }
+}
+exports.UrlEncoder = UrlEncoder;
+//# sourceMappingURL=UrlEncoder.js.map

package/build/cjs/src/lib/parsers/UrlEncoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UrlEncoder.js","sourceRoot":"","sources":["../../../../../src/lib/parsers/UrlEncoder.ts"],"names":[],"mappings":";;;AAAA,sDAAsD;AACtD,MAAa,UAAU;IACrB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,MAAM,CAAC,iBAAiB,CAAC,GAAW,EAAE,WAAqB;QACzD,IAAI,CAAC,GAAG,EAAE;YACR,OAAO,GAAG,CAAC;SACZ;QACD,YAAY;QACZ,IAAI,MAAM,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACtD,SAAS;QACT,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,WAAW,EAAE;YACf,qCAAqC;YACrC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;SACtC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,iBAAiB,CAAC,GAAW,EAAE,WAAqB;QACzD,IAAI,CAAC,GAAG,EAAE;YACR,OAAO,GAAG,CAAC;SACZ;QACD,IAAI,MAAM,GAAG,GAAG,CAAC;QACjB,IAAI,WAAW,EAAE;YACf,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;SACpC;QACD,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,GAAW;QAC7B,IAAI,CAAC,GAAG,EAAE;YACR,OAAO,GAAG,CAAC;SACZ;QACD,MAAM,OAAO,GAAG;YACd,GAAG,EAAE,KAAK;YACV,GAAG,EAAE,KAAK;YACV,GAAG,EAAE,KAAK;YACV,GAAG,EAAE,KAAK;SACX,CAAC;QACF,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;YACpD,aAAa;aACZ,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAE,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,GAAW;QAC/B,IAAI,CAAC,GAAG,EAAE;YACR,OAAO,GAAG,CAAC;SACZ;QACD,MAAM,UAAU,GAAG,4DAA4D,CAAC;QAChF,MAAM,GAAG,GAAG;YACV,aAAa;YACb,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,GAAG;YACV,aAAa;YACb,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,GAAG;SACX,CAAC;QACF,IAAI,MAAM,GAAG,UAAU,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QAC1C,aAAa;QACb,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA5HD,gCA4HC"}

package/build/cjs/src/lib/parsers/UrlParser.js

@@ -0,0 +1,193 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UrlParser = void 0;
+const UrlValueParser_js_1 = require("./UrlValueParser.js");
+/**
+ * A class to parse URL string.
+ */
+class UrlParser extends UrlValueParser_js_1.UrlValueParser {
+    /**
+     * @param value The URL value
+     */
+    constructor(value, opts) {
+        super(opts);
+        this.value = value;
+    }
+    /**
+     * Returns protocol value in format `protocol` + ':'
+     *
+     * @return The value of the protocol or `undefined` if the value is not set
+     */
+    get protocol() {
+        return this.__data.protocol;
+    }
+    /**
+     * Sets value of the `protocol`
+     *
+     * @param value Protocol value.
+     */
+    set protocol(value) {
+        this.__data.protocol = value;
+    }
+    /**
+     * It reads the authority part of the URL value. It doesn't parses it
+     * to host, port and credentials parts.
+     *
+     * @return The value of the host or `undefined` if the value is not set
+     */
+    get host() {
+        return this.__data.host;
+    }
+    /**
+     * Sets value of the `host`
+     *
+     * @param value Host value.
+     */
+    set host(value) {
+        this.__data.host = value;
+    }
+    /**
+     * Returns path part of the URL.
+     *
+     * @returns The value of the path or `undefined` if the value not set
+     */
+    get path() {
+        return this.__data.path || '/';
+    }
+    /**
+     * Sets value of the `path`
+     *
+     * @param value Path value.
+     */
+    set path(value) {
+        this.__data.path = value;
+    }
+    /**
+     * Returns anchor part of the URL.
+     *
+     * @returns The value of the anchor or `undefined` if the value not set
+     */
+    get anchor() {
+        return this.__data.anchor;
+    }
+    /**
+     * Sets value of the `anchor`
+     *
+     * @param value The anchor value.
+     */
+    set anchor(value) {
+        this.__data.anchor = value;
+    }
+    /**
+     * Returns search part of the URL.
+     *
+     * @returns the value of the search or `undefined` if the value not set
+     */
+    get search() {
+        return this.__data.search;
+    }
+    /**
+     * Sets value of the `search`
+     *
+     * @param value Search value.
+     */
+    set search(value) {
+        this.__data.search = value;
+    }
+    /**
+     * The URL value. It is the same as calling `toString()`.
+     *
+     * @return The URL value for current configuration.
+     */
+    get value() {
+        return this.toString();
+    }
+    /**
+     * Sets value of the URL.
+     * It parses the url and sets properties.
+     *
+     * @param value The URL value.
+     */
+    set value(value) {
+        this.protocol = this._parseProtocol(value);
+        this.host = this._parseHost(value);
+        this.path = this._parsePath(value);
+        this.anchor = this._parseAnchor(value);
+        this.search = this._parseSearch(value);
+    }
+    /**
+     * Returns an array of search params.
+     *
+     * @returns The list of search params. Each item contains an
+     * array where the first item is the name of the parameter and the second item is the
+     * value.
+     */
+    get searchParams() {
+        return this._parseSearchParams(this.search);
+    }
+    /**
+     * Sets the value of `search` and `searchParams`.
+     *
+     * @param value Search params list.
+     */
+    set searchParams(value) {
+        if (!value || !value.length) {
+            this.search = undefined;
+            return;
+        }
+        this.search = value.map((item) => {
+            let itemValue = item[1];
+            if (!item[0] && !itemValue) {
+                return '';
+            }
+            if (itemValue === undefined) {
+                itemValue = '';
+            }
+            else if (typeof itemValue !== 'string') {
+                itemValue = String(itemValue);
+            }
+            return `${item[0]}=${itemValue}`;
+        })
+            .join(this.opts.queryDelimiter);
+    }
+    /**
+     * Returns the URL for current settings.
+     *
+     * @return The URL value.
+     */
+    toString() {
+        let result = '';
+        if (this.protocol) {
+            result += this.protocol;
+            result += '//';
+        }
+        if (this.host) {
+            result += this.host;
+        }
+        if (this.path) {
+            if (this.path === '/' && !this.host && !this.search && !this.anchor) {
+                // ???
+            }
+            else {
+                if (this.path[0] !== '/') {
+                    result += '/';
+                }
+                result += this.path;
+            }
+        }
+        else if (this.search || this.anchor) {
+            result += '/';
+        }
+        if (this.search) {
+            const p = this.searchParams;
+            this.searchParams = p;
+            result += `?${this.search}`;
+        }
+        if (this.anchor) {
+            result += `#${this.anchor}`;
+        }
+        return result;
+    }
+}
+exports.UrlParser = UrlParser;
+//# sourceMappingURL=UrlParser.js.map

package/build/cjs/src/lib/parsers/UrlParser.js.map

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