@jeniex/utils 1.4.0 → 1.4.2

package/browser/index.js

@@ -242,9 +242,9 @@ function capitalize(sentence) {
     return capitalizeWord(sentence);
 }
 
-const scriptName = GM.info.script.name;
+const scriptName = typeof GM === 'undefined' ? '' : GM.info.script.name;
 /** The initial tab URL on the script run. */
-const tabURL = window.location.href;
+const tabURL = typeof window === 'undefined' ? '' : window.location.href;
 
 function alert(message) {
     if (message === undefined) {

package/node/index.cts

@@ -0,0 +1,254 @@
+/**
+ * Joins an array's items or do nothing if it is joined already.
+ *
+ * @category Array
+ */
+declare function join(object: string[] | string, separator?: string): string;
+
+/**
+ * Removes an item from an array by mutating it.
+ * @throws an error if the object to be removed does not exist inside the array.
+ *
+ * @category Array
+ */
+declare function remove<T>(array: T[], object: T): void;
+
+declare function noop(): void;
+declare function toString(object: unknown): string;
+
+/**
+ * Asserts that an object is neither `null` nor `undefined`.
+ *
+ * If the object is `null` or `undefined`, a `TypeError` is thrown.
+ * Otherwise, TypeScript narrows the object to `T`.
+ *
+ * @template T The type of the object.
+ *
+ * @param object The object to validate.
+ *
+ * @throws {TypeError} If the object is `null` or `undefined`.
+ *
+ * @example
+ * const object: string | undefined = Math.random() < 0.5 ? undefined : 'Hello';
+ *
+ * assert(object);
+ *
+ * // `object` is now typed as `string`.
+ * console.log(object.length);
+ */
+declare function assert<T>(object: T | null | undefined): asserts object is T;
+/**
+ * Asserts that an object satisfies the given type guard.
+ *
+ * If the type guard returns `false`, a `TypeError` is thrown.
+ * Otherwise, TypeScript narrows the object to the type accepted by
+ * the type guard.
+ *
+ * @template T The type checked by the type guard.
+ *
+ * @param object The object to validate.
+ * @param guard A type guard used to validate the object.
+ *
+ * @throws {TypeError} If the object does not satisfy the type guard.
+ *
+ * @example
+ * const object: number | string = Math.random() < 0.5 ? 1 : 'Hello';
+ *
+ * assertType(object, isNumber);
+ *
+ * // `object` is now typed as `number`.
+ * console.log(object.toFixed(2));
+ *
+ * @example
+ * const object: unknown = 'hello';
+ *
+ * assertType(object, isString);
+ *
+ * // `object` is now typed as `string`.
+ * console.log(object.toUpperCase());
+ */
+declare function assertType<T>(object: unknown, guard: (object: unknown) => object is T): asserts object is T;
+/**
+ * Asserts that an object is neither `null` nor `undefined` and returns it.
+ *
+ * If the object is `null` or `undefined`, a `TypeError` is thrown.
+ * Otherwise, the object is returned with its type narrowed to `T`.
+ *
+ * @template T The type of the object.
+ *
+ * @param object The object to validate.
+ *
+ * @returns The validated object, narrowed to `T`.
+ *
+ * @throws {TypeError} If the object is `null` or `undefined`.
+ *
+ * @example
+ * const object: string | undefined = Math.random() < 0.5 ? undefined : 'Hello';
+ *
+ * const string = asserted(object);
+ *
+ * // `object` is now typed as `string`.
+ * console.log(string.length);
+ */
+declare function asserted<T>(object: T | null | undefined): T;
+/**
+ * Asserts that an object satisfies the given type guard and returns it
+ * with the narrowed type.
+ *
+ * If the type guard returns `false`, a `TypeError` is thrown.
+ *
+ * @template T The type checked by the type guard.
+ *
+ * @param object The object to validate.
+ * @param guard A type guard used to validate the object.
+ *
+ * @returns The validated object, narrowed to `T`.
+ *
+ * @throws {TypeError} If the object does not satisfy the type guard.
+ *
+ * @example
+ * const object: number | string = Math.random() < 0.5 ? 1 : 'Hello';
+ *
+ * const number = assertedType(object, isNumber);
+ *
+ * // `number` is typed as `number`.
+ * console.log(number.toFixed(2));
+ *
+ * @example
+ * const object: unknown = 'hello';
+ *
+ * const text = assertedType(object, isString);
+ *
+ * // `text` is typed as `string`.
+ * console.log(text.toUpperCase());
+ */
+declare function assertedType<T>(object: unknown, guard: (object: unknown) => object is T): T;
+declare function isTruthy<T>(object: T): object is Exclude<T, '' | 0 | false | null | undefined>;
+declare function isFalsy(object: unknown): object is '' | 0 | false | null | undefined;
+declare function isNullish(object: unknown): object is null | undefined;
+declare function isNotNullish<T>(object: T): object is Exclude<T, null | undefined>;
+
+declare function isString(object: unknown): object is string;
+declare function isNumber(object: unknown): object is number;
+declare function isBoolean(object: unknown): object is boolean;
+declare function isObject(object: unknown): object is object;
+declare function isFunction<T extends Function>(object: unknown): object is T;
+
+/**
+ * A wrapper around `setTimeout`.
+ *
+ * @category Promise
+ */
+declare function sleep(milliSeconds: number): Promise<void>;
+
+/**
+ * Adds leading zeros to a number.
+ *
+ * @category String
+ */
+declare function padZeros(number: number, length: number): string;
+
+/**
+ * capitalizes a word or a sentence.
+ *
+ * @category String
+ */
+declare function capitalize(sentence: string): string;
+
+type Nullable<T> = T | null | undefined;
+type Fn<T = void, U = any> = (param?: U) => T;
+type Prettify<T> = {
+    [KeyType in keyof T]: T[KeyType];
+} & {};
+
+declare function exists(path: string): Promise<boolean>;
+
+declare function existsFile(path: string): Promise<boolean>;
+
+declare function existsFileSync(path: string): boolean;
+
+declare function existsFolder(path: string): Promise<boolean>;
+
+declare function existsFolderSync(path: string): boolean;
+
+declare function existsSync(path: string): boolean;
+
+interface ListBaseOpt {
+    /** The absolute path of the target folder. */
+    folderPath: string;
+    getFullPath?: boolean;
+}
+interface ListFoldersOpt extends ListBaseOpt {
+}
+interface ListFilesOpt extends ListBaseOpt {
+    /**
+     * If provided, only files with these extensions will be processed.
+     *
+     * @example
+     * ['.css', '.html'];
+     */
+    filter?: string[];
+}
+interface RemoveFilesOpt extends Omit<ListFilesOpt, 'getFullPath'> {
+}
+
+/**
+ * Lists the files that are present in the provided folder path.
+ * @throws an error if the provided folder path does not exist.
+ *
+ * @category File-System
+ */
+declare function listFiles({ folderPath, getFullPath, filter }: ListFilesOpt): Promise<string[]>;
+
+/**
+ * Lists the folders that are present in the provided folder path.
+ * @throws an error if the provided folder path does not exist.
+ *
+ * @category File-System
+ */
+declare function listFolders({ folderPath, getFullPath }: ListFoldersOpt): Promise<string[]>;
+
+/**
+ * Lists the folders that are present in the provided folder path.
+ * @throws an error if the provided folder path does not exist.
+ *
+ * @category File-System
+ */
+declare function listFoldersSync({ folderPath, getFullPath }: ListFoldersOpt): string[];
+
+/**
+ * Removes the files that are present in the provided folder path.
+ * @throws an error if the provided folder path does not exist.
+ * @throws an error if the files are outside or at the root of the project folder.
+ *
+ * @category File-System
+ */
+declare function removeFiles({ folderPath, filter }: RemoveFilesOpt): Promise<void>;
+
+declare function readJSON<T = object>(filePath: string, withComments?: boolean): Promise<T>;
+
+interface RqRequest {
+    response: () => Promise<Response>;
+    blob: () => Promise<Blob>;
+    buffer: () => Promise<ArrayBuffer>;
+    json: <T = unknown>() => Promise<T>;
+    text: () => Promise<string>;
+    document: () => Promise<Document>;
+    multi: <T = unknown>(types: ResponseType[]) => Promise<Responses<T>>;
+}
+type Transport<TOptions = unknown> = (url: string, options?: TOptions) => Promise<Response>;
+type ResponseType = 'blob' | 'buffer' | 'document' | 'json' | 'text';
+interface Responses<T> {
+    response?: Response;
+    blob?: Blob;
+    buffer?: ArrayBuffer;
+    json?: T;
+    text?: string;
+    document?: Document;
+}
+
+declare function rq(url: string, options?: RequestInit): RqRequest;
+
+declare function createRequest<TOptions>(transport: Transport<TOptions>, url: string, options?: TOptions): RqRequest;
+
+export { Fn, Nullable, Prettify, assert, assertType, asserted, assertedType, capitalize, exists, existsFile, existsFileSync, existsFolder, existsFolderSync, existsSync, isBoolean, isFalsy, isFunction, isNotNullish, isNullish, isNumber, isObject, isString, isTruthy, join, listFiles, listFolders, listFoldersSync, noop, padZeros, readJSON, remove, removeFiles, rq, createRequest as rqc, sleep, toString };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jeniex/utils",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "author": "JenieX",
   "homepage": "https://github.com/JenieX/utils",
   "type": "module",
@@ -10,13 +10,17 @@
   "exports": {
     "./browser": {
       "types": "./browser/index.d.ts",
-      "import": "./browser/index.js",
-      "require": "./browser/index.cjs"
+      "import": "./browser/index.js"
     },
     "./node": {
-      "types": "./node/index.d.ts",
-      "import": "./node/index.js",
-      "require": "./node/index.cjs"
+      "import": {
+        "types": "./node/index.d.ts",
+        "default": "./node/index.js"
+      },
+      "require": {
+        "types": "./node/index.d.cts",
+        "default": "./node/index.cjs"
+      }
     },
     "./node/inquirer": {
       "types": "./node/inquirer/index.d.ts",

package/browser/index.cjs

@@ -1,742 +0,0 @@
-'use strict';
-
-function noop() { }
-function toString(object) {
-    return Object.prototype.toString.call(object);
-}
-
-function isString(object) {
-    return typeof object === 'string';
-}
-function isNumber(object) {
-    return typeof object === 'number';
-}
-function isBoolean(object) {
-    return typeof object === 'boolean';
-}
-function isObject(object) {
-    return toString(object) === '[object Object]';
-}
-// eslint-disable-next-line @typescript-eslint/ban-types
-function isFunction(object) {
-    return typeof object === 'function';
-}
-
-/**
- * Joins an array's items or do nothing if it is joined already.
- *
- * @category Array
- */
-function join(object, separator = ',') {
-    if (isString(object)) {
-        return object;
-    }
-    return object.join(separator);
-}
-
-/**
- * Removes an item from an array by mutating it.
- * @throws an error if the object to be removed does not exist inside the array.
- *
- * @category Array
- */
-function remove(array, object) {
-    const index = array.indexOf(object);
-    if (index === -1) {
-        throw new Error('Provided value does not exist inside the array.');
-    }
-    array.splice(index, 1);
-}
-
-/**
- * Asserts that an object is neither `null` nor `undefined`.
- *
- * If the object is `null` or `undefined`, a `TypeError` is thrown.
- * Otherwise, TypeScript narrows the object to `T`.
- *
- * @template T The type of the object.
- *
- * @param object The object to validate.
- *
- * @throws {TypeError} If the object is `null` or `undefined`.
- *
- * @example
- * const object: string | undefined = Math.random() < 0.5 ? undefined : 'Hello';
- *
- * assert(object);
- *
- * // `object` is now typed as `string`.
- * console.log(object.length);
- */
-function assert(object) {
-    if (object === null || object === undefined) {
-        throw new TypeError('object is either null or undefined');
-    }
-}
-/**
- * Asserts that an object satisfies the given type guard.
- *
- * If the type guard returns `false`, a `TypeError` is thrown.
- * Otherwise, TypeScript narrows the object to the type accepted by
- * the type guard.
- *
- * @template T The type checked by the type guard.
- *
- * @param object The object to validate.
- * @param guard A type guard used to validate the object.
- *
- * @throws {TypeError} If the object does not satisfy the type guard.
- *
- * @example
- * const object: number | string = Math.random() < 0.5 ? 1 : 'Hello';
- *
- * assertType(object, isNumber);
- *
- * // `object` is now typed as `number`.
- * console.log(object.toFixed(2));
- *
- * @example
- * const object: unknown = 'hello';
- *
- * assertType(object, isString);
- *
- * // `object` is now typed as `string`.
- * console.log(object.toUpperCase());
- */
-function assertType(object, guard) {
-    if (!guard(object)) {
-        throw new TypeError('object has an invalid type');
-    }
-}
-/**
- * Asserts that an object is neither `null` nor `undefined` and returns it.
- *
- * If the object is `null` or `undefined`, a `TypeError` is thrown.
- * Otherwise, the object is returned with its type narrowed to `T`.
- *
- * @template T The type of the object.
- *
- * @param object The object to validate.
- *
- * @returns The validated object, narrowed to `T`.
- *
- * @throws {TypeError} If the object is `null` or `undefined`.
- *
- * @example
- * const object: string | undefined = Math.random() < 0.5 ? undefined : 'Hello';
- *
- * const string = asserted(object);
- *
- * // `object` is now typed as `string`.
- * console.log(string.length);
- */
-function asserted(object) {
-    if (object === null || object === undefined) {
-        throw new TypeError('object is either null or undefined');
-    }
-    return object;
-}
-/**
- * Asserts that an object satisfies the given type guard and returns it
- * with the narrowed type.
- *
- * If the type guard returns `false`, a `TypeError` is thrown.
- *
- * @template T The type checked by the type guard.
- *
- * @param object The object to validate.
- * @param guard A type guard used to validate the object.
- *
- * @returns The validated object, narrowed to `T`.
- *
- * @throws {TypeError} If the object does not satisfy the type guard.
- *
- * @example
- * const object: number | string = Math.random() < 0.5 ? 1 : 'Hello';
- *
- * const number = assertedType(object, isNumber);
- *
- * // `number` is typed as `number`.
- * console.log(number.toFixed(2));
- *
- * @example
- * const object: unknown = 'hello';
- *
- * const text = assertedType(object, isString);
- *
- * // `text` is typed as `string`.
- * console.log(text.toUpperCase());
- */
-function assertedType(object, guard) {
-    if (!guard(object)) {
-        throw new TypeError('object has an invalid type');
-    }
-    return object;
-}
-function isTruthy(object) {
-    return Boolean(object) === true;
-}
-function isFalsy(object) {
-    return Boolean(object) === false;
-}
-function isNullish(object) {
-    return object === null || object === undefined;
-}
-function isNotNullish(object) {
-    return object !== null && object !== undefined;
-}
-
-/**
- * A wrapper around `setTimeout`.
- *
- * @category Promise
- */
-async function sleep(milliSeconds) {
-    return new Promise((resolve) => {
-        setTimeout(resolve, milliSeconds);
-    });
-}
-
-/**
- * Adds leading zeros to a number.
- *
- * @category String
- */
-function padZeros(number, length) {
-    if (Math.abs(number).toString().length > length) {
-        throw new Error('Provided length can not be less than the digits of the number.');
-    }
-    if (number < 0) {
-        throw new Error('Provided number must be greater than zero.');
-    }
-    const padded = '0'.repeat(length - 1) + number;
-    if (number < 10) {
-        return padded;
-    }
-    return padded.slice(-length);
-}
-
-const lowercaseWords = new Set([
-    'a', 'an', 'the',
-    'and', 'but', 'for', 'nor', 'or', 'so', 'yet',
-    'about', 'across', 'after', 'along', 'among', 'around', 'as', 'at', 'before', 'between', 'by', 'during', 'in', 'into', 'of', 'on', 'over', 'since', 'through', 'throughout', 'to', 'under', 'with', 'within',
-    'away', 'back', 'down', 'far', 'off', 'on', 'out', 'up',
-    'he', 'her', 'him', 'his', 'it', 'its', 'me', 'my', 'our', 'she', 'their', 'them', 'they', 'us', 'we', 'you', 'your',
-]);
-function capitalizeWord(word) {
-    return word[0].toUpperCase() + word.slice(1).toLowerCase();
-}
-/**
- * capitalizes a word or a sentence.
- *
- * @category String
- */
-function capitalize(sentence) {
-    if (sentence.includes(' ')) {
-        return sentence.split(' ').map((word, index) => {
-            const lowercaseWord = word.toLowerCase();
-            if (index > 0 && lowercaseWords.has(lowercaseWord)) {
-                return lowercaseWord;
-            }
-            return capitalizeWord(word);
-        }).join(' ');
-    }
-    return capitalizeWord(sentence);
-}
-
-const scriptName = GM.info.script.name;
-/** The initial tab URL on the script run. */
-const tabURL = window.location.href;
-
-function alert(message) {
-    if (message === undefined) {
-        window.alert(`[ ${scriptName} ]`);
-        return;
-    }
-    window.alert(`[ ${scriptName} ]\n\n${message}`);
-}
-function confirm(message) {
-    return window.confirm(`[ ${scriptName} ]\n\n${message}`);
-}
-function prompt(message, _default) {
-    return window.prompt(`[ ${scriptName} ]\n\n${message}`, _default);
-}
-
-async function fishResponse(url, options) {
-    const response = await fetch(url, options);
-    if (!response.ok && !response.url.startsWith('file:///')) {
-        throw new Error(`Request to ${response.url} ended with ${response.status} status.`);
-    }
-    return response;
-}
-
-// Note: to set the 'cookie' header, you have to set 'anonymous' to true.
-async function fishXResponse(url, fishOptions) {
-    const { method, anonymous, headers, body, timeOut, onProgress } = fishOptions ?? {};
-    return new Promise((resolve, reject) => {
-        GM.xmlHttpRequest({
-            url,
-            method: method ?? 'GET',
-            headers,
-            anonymous,
-            data: body,
-            responseType: 'blob',
-            timeout: timeOut,
-            onprogress: onProgress,
-            onload({ response, statusText, status, finalUrl }) {
-                const isFileURL = finalUrl.startsWith('file:///');
-                const ok = status >= 200 && status < 300;
-                if (!ok && !isFileURL) {
-                    reject(new Error(`Request to ${url} ended with ${status} status.`));
-                    return;
-                }
-                const properResponse = new Response(response, {
-                    statusText,
-                    status: isFileURL ? 200 : status,
-                });
-                Object.defineProperty(properResponse, 'url', { value: finalUrl });
-                resolve(properResponse);
-            },
-            onerror({ status }) {
-                reject(new Error(`Request to ${url} ended with ${status} status.`));
-            },
-        });
-    });
-}
-
-async function fishBlob(url, options, x) {
-    const response = await (x ? fishXResponse : fishResponse)(url, options);
-    return response.blob();
-}
-
-async function fishBuffer(url, options, x) {
-    const response = await (x ? fishXResponse : fishResponse)(url, options);
-    return response.arrayBuffer();
-}
-
-async function fishDocument(url, options, x) {
-    const response = await (x ? fishXResponse : fishResponse)(url, options);
-    const responseText = await response.text();
-    const parser = new DOMParser();
-    return parser.parseFromString(responseText, 'text/html');
-}
-
-async function fishJSON(url, options, x) {
-    const response = await (x ? fishXResponse : fishResponse)(url, options);
-    return response.json();
-}
-
-async function fishText(url, options, x) {
-    const response = await (x ? fishXResponse : fishResponse)(url, options);
-    return response.text();
-}
-
-// https://httpbin.org/anything
-const fish = {
-    blob: async (url, options) => fishBlob(url, options),
-    buffer: async (url, options) => fishBuffer(url, options),
-    document: async (url, options) => fishDocument(url, options),
-    JSON: async (url, options) => fishJSON(url, options),
-    text: async (url, options) => fishText(url, options),
-};
-const fishX = {
-    blob: async (url, options) => fishBlob(url, options, true),
-    buffer: async (url, options) => fishBuffer(url, options, true),
-    document: async (url, options) => fishDocument(url, options, true),
-    JSON: async (url, options) => fishJSON(url, options, true),
-    text: async (url, options) => fishText(url, options, true),
-};
-
-function $(selectors, parent) {
-    const element = (parent ?? document).querySelector(join(selectors));
-    if (element === null) {
-        throw new Error(`Could not find the element with the selector ${selectors}`);
-    }
-    return element;
-}
-function $$(selectors, parent) {
-    const elements = (parent ?? document).querySelectorAll(join(selectors));
-    if (elements.length === 0) {
-        throw new Error(`Could not find any element with the selector ${selectors}`);
-    }
-    return elements;
-}
-
-/**
- * @param key The name of the param in the search query.
- * @param fullURL If provided, it will be our target, otherwise it is the current location.
- */
-function getSearchParam(key, fullURL) {
-    const { searchParams } = new URL(fullURL ?? window.location.href);
-    const value = searchParams.get(key);
-    if (value === null) {
-        return undefined;
-    }
-    return value;
-}
-/**
- *
- * @param key The name of the param that is to be in the search query.
- * @param value Its value.
- * @param fullURL If provided, it will be our target, otherwise it is the current location.
- */
-function setSearchParam(key, value, fullURL) {
-    const updatedURL = [];
-    const { origin, pathname, search, hash } = new URL(fullURL ?? window.location.href);
-    const searchParams = new URLSearchParams(search);
-    searchParams.set(key, value);
-    updatedURL.push(origin, pathname, '?', searchParams.toString());
-    if (hash !== '') {
-        updatedURL.push(hash);
-    }
-    return updatedURL.join('');
-}
-/**
- * @param keys The names of the param in the search query.
- * @param fullURL If provided, it will be our target, otherwise it is the current location.
- */
-function removeSearchParams(keys, fullURL) {
-    const updatedURL = [];
-    const { origin, pathname, search, hash } = new URL(fullURL ?? window.location.href);
-    const searchParams = new URLSearchParams(search);
-    for (const key of keys) {
-        searchParams.delete(key);
-    }
-    updatedURL.push(origin, pathname);
-    if (searchParams.toString() !== '') {
-        updatedURL.push('?', searchParams.toString());
-    }
-    if (hash !== '') {
-        updatedURL.push(hash);
-    }
-    return updatedURL.join('');
-}
-
-/**
- * Checks if the VPN is active by accessing the router address.
- * Tested on Opera browser build-in VPN only.
- */
-async function checkVPN() {
-    let pass = false;
-    try {
-        await fishXResponse('http://192.168.1.1/index.html', { method: 'HEAD' });
-    }
-    catch (exception) {
-        if (exception.message.includes('ended with 0 status')) {
-            pass = true;
-        }
-    }
-    if (pass === false) {
-        throw new Error('VPN is not enabled!');
-    }
-}
-async function checkVPNRandomly() {
-    // a 1/10 chance to check.
-    if (Math.floor(Math.random() * 10) === 0) {
-        await checkVPN();
-        console.log('%cPass check for VPN!', 'color: #04da79');
-    }
-}
-
-function addStyle(css, parent = document.documentElement) {
-    const style = document.createElement('style');
-    style.setAttribute('type', 'text/css');
-    style.textContent = css;
-    parent.append(style);
-    return style;
-}
-
-/**
- * Waits for image to fully load or throws an error if it fails.
- */
-async function imageLoad(img) {
-    return new Promise((resolve, reject) => {
-        if (img.complete) {
-            resolve();
-            return;
-        }
-        let onLoad;
-        let onError;
-        const removeListeners = () => {
-            img.removeEventListener('load', onLoad);
-            img.removeEventListener('error', onError);
-        };
-        onLoad = () => {
-            removeListeners();
-            resolve();
-        };
-        onError = () => {
-            removeListeners();
-            reject(new Error('Image failed to load'));
-        };
-        img.addEventListener('load', onLoad);
-        img.addEventListener('error', onError);
-    });
-}
-
-/**
- * Waits for the page to load.
- * @param completely Whether or not to wait for resources to load as well.
- */
-async function pageLoad(completely) {
-    return new Promise((resolve) => {
-        if (document.readyState === 'complete') {
-            resolve();
-            return;
-        }
-        if (completely === true) {
-            window.addEventListener('load', () => resolve());
-            return;
-        }
-        document.addEventListener('DOMContentLoaded', () => resolve());
-    });
-}
-
-function saveFile(blob, fileName) {
-    const blobURL = URL.createObjectURL(blob);
-    const link = document.createElement('a');
-    link.href = blobURL;
-    link.download = fileName;
-    link.dispatchEvent(new MouseEvent('click'));
-    window.setTimeout(() => window.URL.revokeObjectURL(blobURL), 1000);
-}
-
-function createFlagMessage(flag) {
-    const { message: messageHeader, values, type } = flag;
-    let message = messageHeader;
-    if (values !== undefined) {
-        message += `\n\n${values.join(' | ')}`;
-    }
-    if (type === 'number' && flag.range !== undefined) {
-        message += '\n';
-        const [min, max] = flag.range;
-        if (min !== undefined) {
-            message += `\nMinimum: ${min}`;
-        }
-        if (max !== undefined) {
-            message += `\nMaximum: ${max}`;
-        }
-    }
-    return message;
-}
-
-function validateFlagValue(flag, promptValue) {
-    const { type, name, values } = flag;
-    if (promptValue === null || promptValue === '') {
-        throw new Error(`You did not provide a value for "${name}" option.`);
-    }
-    switch (type) {
-        case 'boolean': {
-            if (promptValue !== 'yes' && promptValue !== 'no') {
-                throw new Error(`Invalid value for "${name}" option!`);
-            }
-            return promptValue === 'yes';
-        }
-        case 'string': {
-            if (values !== undefined && !values.includes(promptValue)) {
-                throw new Error(`Provided value for "${name}" option is not in the list.`);
-            }
-            return promptValue;
-        }
-        case 'number': {
-            const promptValueAsNumber = Number(promptValue);
-            if (Number.isNaN(promptValueAsNumber)) {
-                throw new TypeError(`You need to provide a number for "${name}" option!`);
-            }
-            if (values !== undefined && !values.includes(promptValueAsNumber)) {
-                throw new Error(`Provided value for "${name}" option is not in the list.`);
-            }
-            const [min, max] = flag.range ?? [];
-            if (min !== undefined && promptValueAsNumber < min) {
-                throw new Error(`Provided value for "${name}" option is less than the minimum.`);
-            }
-            if (max !== undefined && promptValueAsNumber > max) {
-                throw new Error(`Provided value for "${name}" option is greater than the maximum.`);
-            }
-            return promptValueAsNumber;
-        }
-        default: {
-            throw new Error(`Unsupported flag type for "${name}" option.`);
-        }
-    }
-}
-
-function processFlag(flag) {
-    const message = createFlagMessage(flag);
-    const promptValue = prompt(message, flag.default?.toString());
-    return [flag.name, validateFlagValue(flag, promptValue)];
-}
-async function getOptions(flags) {
-    const options = {};
-    for (const flag of flags) {
-        const [name, value] = processFlag(flag);
-        options[name] = value;
-        await sleep(300);
-    }
-    return options;
-}
-
-function customizeConsole(debug = false) {
-    const base = window.console;
-    const logId = `[${scriptName}]:`;
-    return {
-        log: base.log.bind(base, logId),
-        warn: base.warn.bind(base, logId),
-        error: base.error.bind(base, logId),
-        debug: debug ? base.log.bind(base, logId) : noop,
-    };
-}
-
-function createRequest(transport, url, options) {
-    const getResponse = async () => {
-        return transport(url, options);
-    };
-    return {
-        response: async () => {
-            return getResponse();
-        },
-        blob: async () => {
-            const response = await getResponse();
-            return response.blob();
-        },
-        buffer: async () => {
-            const response = await getResponse();
-            return response.arrayBuffer();
-        },
-        json: async () => {
-            const response = await getResponse();
-            return response.json();
-        },
-        text: async () => {
-            const response = await getResponse();
-            return response.text();
-        },
-        document: async () => {
-            const response = await getResponse();
-            const responseText = await response.text();
-            const parser = new DOMParser();
-            return parser.parseFromString(responseText, 'text/html');
-        },
-        multi: async (types) => {
-            const response = await getResponse();
-            const responses = { response };
-            if (types.includes('blob')) {
-                responses.blob = await response.clone().blob();
-            }
-            if (types.includes('buffer')) {
-                responses.buffer = await response.clone().arrayBuffer();
-            }
-            if (types.includes('json')) {
-                responses.json = (await response.clone().json());
-            }
-            if (types.includes('text')) {
-                responses.text = await response.clone().text();
-            }
-            if (types.includes('document')) {
-                const responseText = await response.clone().text();
-                const parser = new DOMParser();
-                responses.document = parser.parseFromString(responseText, 'text/html');
-            }
-            return responses;
-        },
-    };
-}
-
-function isFileURL(url) {
-    return url.startsWith('file:///');
-}
-
-async function fetchTransport(url, options) {
-    const response = await fetch(url, options);
-    if (!response.ok && !isFileURL(response.url)) {
-        throw new Error(`Request to ${response.url} ended with ${response.status} status.`);
-    }
-    return response;
-}
-
-function rq(url, options) {
-    return createRequest(fetchTransport, url, options);
-}
-
-async function gmTransport(url, options) {
-    const { method, anonymous, headers, body, timeOut, onProgress } = options ?? {};
-    return new Promise((resolve, reject) => {
-        GM.xmlHttpRequest({
-            url,
-            method: method ?? 'GET',
-            headers,
-            /** Note: To manually set the 'cookie' header, you have to set 'anonymous' to true. */
-            anonymous,
-            data: body,
-            responseType: 'blob',
-            timeout: timeOut,
-            onprogress: onProgress,
-            onload({ response, statusText, status, finalUrl }) {
-                const ok = status >= 200 && status < 300;
-                if (!ok && !isFileURL(finalUrl)) {
-                    reject(new Error(`Request to ${url} ended with ${status} status.`));
-                    return;
-                }
-                const properResponse = new Response(response, {
-                    statusText,
-                    status: isFileURL(finalUrl) ? 200 : status,
-                });
-                Object.defineProperty(properResponse, 'url', { value: finalUrl });
-                resolve(properResponse);
-            },
-            onerror({ status }) {
-                reject(new Error(`Request to ${url} ended with ${status} status.`));
-            },
-        });
-    });
-}
-
-function rx(url, options) {
-    return createRequest(gmTransport, url, options);
-}
-
-exports.$ = $;
-exports.$$ = $$;
-exports.addStyle = addStyle;
-exports.alert = alert;
-exports.assert = assert;
-exports.assertType = assertType;
-exports.asserted = asserted;
-exports.assertedType = assertedType;
-exports.capitalize = capitalize;
-exports.checkVPN = checkVPN;
-exports.checkVPNRandomly = checkVPNRandomly;
-exports.confirm = confirm;
-exports.customizeConsole = customizeConsole;
-exports.fish = fish;
-exports.fishResponse = fishResponse;
-exports.fishX = fishX;
-exports.fishXResponse = fishXResponse;
-exports.getOptions = getOptions;
-exports.getSearchParam = getSearchParam;
-exports.imageLoad = imageLoad;
-exports.isBoolean = isBoolean;
-exports.isFalsy = isFalsy;
-exports.isFunction = isFunction;
-exports.isNotNullish = isNotNullish;
-exports.isNullish = isNullish;
-exports.isNumber = isNumber;
-exports.isObject = isObject;
-exports.isString = isString;
-exports.isTruthy = isTruthy;
-exports.join = join;
-exports.noop = noop;
-exports.padZeros = padZeros;
-exports.pageLoad = pageLoad;
-exports.prompt = prompt;
-exports.remove = remove;
-exports.removeSearchParams = removeSearchParams;
-exports.rq = rq;
-exports.rqc = createRequest;
-exports.rx = rx;
-exports.saveFile = saveFile;
-exports.scriptName = scriptName;
-exports.setSearchParam = setSearchParam;
-exports.sleep = sleep;
-exports.tabURL = tabURL;
-exports.toString = toString;