@jeniex/utils 1.1.4 → 1.3.0

package/browser/index.cjs

@@ -473,6 +473,114 @@ function customizeConsole(debug = false) {
     };
 }
 
+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;
@@ -506,6 +614,9 @@ 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;

package/browser/index.d.ts

@@ -60,9 +60,9 @@ declare function alert(message?: string): void;
 declare function confirm(message: string): boolean;
 declare function prompt(message: string, _default?: string): string | null;
 
-type Method = 'CONNECT' | 'DELETE' | 'GET' | 'HEAD' | 'OPTIONS' | 'PATCH' | 'POST' | 'PUT' | 'TRACE';
+type Method$1 = 'CONNECT' | 'DELETE' | 'GET' | 'HEAD' | 'OPTIONS' | 'PATCH' | 'POST' | 'PUT' | 'TRACE';
 interface FishXOptions {
-    method?: Method;
+    method?: Method$1;
     anonymous?: boolean;
     headers?: Record<string, string>;
     body?: Blob | FormData | string;
@@ -168,4 +168,39 @@ interface CustomizedConsole {
 
 declare function customizeConsole(debug?: boolean): CustomizedConsole;
 
-export { $, $$, Flag, Fn, Nullable, Prettify, addStyle, alert, asserted, capitalize, checkVPN, checkVPNRandomly, confirm, customizeConsole, fish, fishResponse, fishX, fishXResponse, getOptions, getSearchParam, imageLoad, isBoolean, isFalsy, isFunction, isNotNullish, isNullish, isNumber, isObject, isString, isTruthy, join, noop, padZeros, pageLoad, prompt, remove, removeSearchParams, saveFile, scriptName, setSearchParam, sleep, stringOrThrow, tabURL, toString };
+type Method = 'CONNECT' | 'DELETE' | 'GET' | 'HEAD' | 'OPTIONS' | 'PATCH' | 'POST' | 'PUT' | 'TRACE';
+interface RxOptions {
+    method?: Method;
+    anonymous?: boolean;
+    headers?: Record<string, string>;
+    body?: Blob | FormData | string;
+    timeOut?: number;
+    onProgress?: (response: VMScriptResponseObject<Blob>) => Promise<void> | void;
+}
+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 rx(url: string, options?: RxOptions): RqRequest;
+
+declare function createRequest<TOptions>(transport: Transport<TOptions>, url: string, options?: TOptions): RqRequest;
+
+export { $, $$, Flag, Fn, Nullable, Prettify, addStyle, alert, asserted, capitalize, checkVPN, checkVPNRandomly, confirm, customizeConsole, fish, fishResponse, fishX, fishXResponse, getOptions, getSearchParam, imageLoad, isBoolean, isFalsy, isFunction, isNotNullish, isNullish, isNumber, isObject, isString, isTruthy, join, noop, padZeros, pageLoad, prompt, remove, removeSearchParams, rq, createRequest as rqc, rx, saveFile, scriptName, setSearchParam, sleep, stringOrThrow, tabURL, toString };

package/browser/index.js

@@ -471,4 +471,112 @@ function customizeConsole(debug = false) {
     };
 }
 
-export { $, $$, addStyle, alert, asserted, capitalize, checkVPN, checkVPNRandomly, confirm, customizeConsole, fish, fishResponse, fishX, fishXResponse, getOptions, getSearchParam, imageLoad, isBoolean, isFalsy, isFunction, isNotNullish, isNullish, isNumber, isObject, isString, isTruthy, join, noop, padZeros, pageLoad, prompt, remove, removeSearchParams, saveFile, scriptName, setSearchParam, sleep, stringOrThrow, tabURL, toString };
+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);
+}
+
+export { $, $$, addStyle, alert, asserted, capitalize, checkVPN, checkVPNRandomly, confirm, customizeConsole, fish, fishResponse, fishX, fishXResponse, getOptions, getSearchParam, imageLoad, isBoolean, isFalsy, isFunction, isNotNullish, isNullish, isNumber, isObject, isString, isTruthy, join, noop, padZeros, pageLoad, prompt, remove, removeSearchParams, rq, createRequest as rqc, rx, saveFile, scriptName, setSearchParam, sleep, stringOrThrow, tabURL, toString };

package/node/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var fs = require('node:fs');
 var fsp = require('node:fs/promises');
+var fs = require('node:fs');
 var path = require('node:path');
 
 function noop() { }
@@ -134,6 +134,64 @@ function capitalize(sentence) {
     return capitalizeWord(sentence);
 }
 
+async function exists(path) {
+    try {
+        await fsp.access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+
+async function existsFile(path) {
+    try {
+        const stats = await fsp.stat(path);
+        return stats.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+
+function existsFileSync(path) {
+    try {
+        return fs.statSync(path).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+
+async function existsFolder(path) {
+    try {
+        const stats = await fsp.stat(path);
+        return stats.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+
+function existsFolderSync(path) {
+    try {
+        return fs.statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+
+function existsSync(path) {
+    try {
+        fs.accessSync(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+
 /**
  * Lists the files that are present in the provided folder path.
  * @throws an error if the provided folder path does not exist.
@@ -244,8 +302,85 @@ async function readJSON(filePath, withComments = false) {
     return JSON.parse(stringJSON);
 }
 
+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);
+}
+
 exports.asserted = asserted;
 exports.capitalize = capitalize;
+exports.exists = exists;
+exports.existsFile = existsFile;
+exports.existsFileSync = existsFileSync;
+exports.existsFolder = existsFolder;
+exports.existsFolderSync = existsFolderSync;
+exports.existsSync = existsSync;
 exports.isBoolean = isBoolean;
 exports.isFalsy = isFalsy;
 exports.isFunction = isFunction;
@@ -264,6 +399,8 @@ exports.padZeros = padZeros;
 exports.readJSON = readJSON;
 exports.remove = remove;
 exports.removeFiles = removeFiles;
+exports.rq = rq;
+exports.rqc = createRequest;
 exports.sleep = sleep;
 exports.stringOrThrow = stringOrThrow;
 exports.toString = toString;

package/node/index.d.ts

@@ -56,6 +56,18 @@ 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;
@@ -110,4 +122,28 @@ declare function removeFiles({ folderPath, filter }: RemoveFilesOpt): Promise<vo
 
 declare function readJSON<T = object>(filePath: string, withComments?: boolean): Promise<T>;
 
-export { Fn, Nullable, Prettify, asserted, capitalize, isBoolean, isFalsy, isFunction, isNotNullish, isNullish, isNumber, isObject, isString, isTruthy, join, listFiles, listFolders, listFoldersSync, noop, padZeros, readJSON, remove, removeFiles, sleep, stringOrThrow, toString };
+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, asserted, 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, stringOrThrow, toString };

package/node/index.js

@@ -1,5 +1,5 @@
-import fs from 'node:fs';
-import fsp from 'node:fs/promises';
+import fsp, { access, stat } from 'node:fs/promises';
+import fs, { statSync, accessSync } from 'node:fs';
 import path from 'node:path';
 
 function noop() { }
@@ -132,6 +132,64 @@ function capitalize(sentence) {
     return capitalizeWord(sentence);
 }
 
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+
+async function existsFile(path) {
+    try {
+        const stats = await stat(path);
+        return stats.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+
+function existsFileSync(path) {
+    try {
+        return statSync(path).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+
+async function existsFolder(path) {
+    try {
+        const stats = await stat(path);
+        return stats.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+
+function existsFolderSync(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+
+function existsSync(path) {
+    try {
+        accessSync(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+
 /**
  * Lists the files that are present in the provided folder path.
  * @throws an error if the provided folder path does not exist.
@@ -242,4 +300,75 @@ async function readJSON(filePath, withComments = false) {
     return JSON.parse(stringJSON);
 }
 
-export { asserted, capitalize, isBoolean, isFalsy, isFunction, isNotNullish, isNullish, isNumber, isObject, isString, isTruthy, join, listFiles, listFolders, listFoldersSync, noop, padZeros, readJSON, remove, removeFiles, sleep, stringOrThrow, toString };
+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);
+}
+
+export { asserted, 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, stringOrThrow, toString };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jeniex/utils",
-  "version": "1.1.4",
+  "version": "1.3.0",
   "author": "JenieX",
   "homepage": "https://github.com/JenieX/utils",
   "type": "module",