@e-mc/types 0.11.7 → 0.12.0

package/README.md

@@ -1,7 +1,7 @@
 # @e-mc/types
 
-* NodeJS 16 LTS
-* ES2021
+* NodeJS 18
+* ES2022
 
 ## General Usage
 
@@ -9,13 +9,13 @@
 
 ## Interface
 
-* [View Source](https://www.unpkg.com/@e-mc/types@0.11.7/index.d.ts)
+* [View Source](https://www.unpkg.com/@e-mc/types@0.12.0/index.d.ts)
 
 ```typescript
 import type { LogArguments } from "./lib/logger";
 import type { HighResolutionTime } from "./lib/node";
 
-import type { BinaryLike, CipherGCMTypes, Encoding, RandomUUIDOptions } from "node:crypto";
+import type { BinaryLike, CipherGCMTypes, Encoding } from "node:crypto";
 import type { BytesOptions } from "bytes";
 
 function createAbortError(reject: true): Promise<never>;
@@ -32,12 +32,13 @@ function existsFlag(value: unknown): boolean;
 function getLogCurrent(): LogArguments | null;
 function setLogCurrent(value: LogArguments): void;
 function setTempDir(value: string): boolean;
-function getTempDir(): string;
+function getTempDir(...values: string[]): string;
 function isArray(value: unknown): value is unknown[];
 function isObject(value: unknown): value is object;
 function isPlainObject(value: unknown): value is Record<string | number | symbol, unknown>;
 function isString(value: unknown): value is string;
 function isEmpty(value: unknown): boolean;
+function isFunction<T extends Function>(value: unknown, cjs?: boolean): value is T;
 function asFunction(value: unknown, sync?: boolean): ((...args: unknown[]) => unknown) | null;
 function parseTime(value: number | string, start?: number): number;
 function parseExpires(value: number | string, start?: number): number;
@@ -62,10 +63,11 @@ function getEncoding(value: unknown, fallback?: BufferEncoding): BufferEncoding;
 function encryptUTF8(algorithm: CipherGCMTypes, key: BinaryLike, iv: BinaryLike, data: string, encoding?: Encoding): string | undefined;
 function decryptUTF8(algorithm: CipherGCMTypes, key: BinaryLike, iv: BinaryLike, data: string, encoding?: Encoding): string | undefined;
 function hashKey(data: BinaryLike, algorithm?: string, encoding?: BinaryToTextEncoding): string;
-/** @deprecated - crypto.randomUUID */
-function generateUUID(options?: RandomUUIDOptions): string;
 function incrementUUID(restart?: boolean): string;
 function validateUUID(value: unknown): boolean;
+function sanitizeCmd(value: string): string;
+function sanitizeArgs(value: string, doubleQuote?: boolean): string;
+function sanitizeArgs(values: string[], doubleQuote?: boolean): string[];
 function randomString(format: string, dictionary?: string): string;
 function errorValue(value: string, hint?: string): Error;
 function errorMessage(title: number | string, value: string, hint?: string): Error;
@@ -198,10 +200,10 @@ const IMPORT_MAP: Record<string, string | undefined>;
 
 ## References
 
-- https://www.unpkg.com/@e-mc/types@0.11.7/index.d.ts
-- https://www.unpkg.com/@e-mc/types@0.11.7/lib/logger.d.ts
-- https://www.unpkg.com/@e-mc/types@0.11.7/lib/module.d.ts
-- https://www.unpkg.com/@e-mc/types@0.11.7/lib/node.d.ts
+- https://www.unpkg.com/@e-mc/types@0.12.0/index.d.ts
+- https://www.unpkg.com/@e-mc/types@0.12.0/lib/logger.d.ts
+- https://www.unpkg.com/@e-mc/types@0.12.0/lib/module.d.ts
+- https://www.unpkg.com/@e-mc/types@0.12.0/lib/node.d.ts
 
 * https://developer.mozilla.org/en-US/docs/Web/API/DOMException
 * https://www.npmjs.com/package/@types/bytes

package/constant.d.ts

@@ -1,5 +1,5 @@
 export const enum INTERNAL {
-    VERSION = '0.11.7',
+    VERSION = '0.12.0',
     TEMP_DIR = 'tmp',
     CJS = '__cjs__'
 }
@@ -48,6 +48,7 @@ export const enum ERR_MESSAGE {
     FAILED_CHECKSUM = 'Checksum did not match',
     PARAMETERS = 'Invalid parameters',
     FORMAT = 'Invalid format',
+    COMMAND = 'Invalid command',
     CHECKSUM = 'Invalid checksum',
     CONFIG = 'Invalid config',
     RESPONSE = 'Invalid response',
@@ -66,6 +67,9 @@ export const enum ERR_MESSAGE {
     INCOMPLETE = 'Transaction was not completed',
     THREAD = 'Thread limit exceeded',
     THREAD_KILLED = 'Thread was killed',
+    WORKER = 'Worker did not finish',
+    WORKER_TIMEOUT = 'Worker timeout was exceeded',
+    WORKER_FULL = 'Worker queue is full',
     TIMEOUT = 'Timeout was exceeded',
     HANDLED_REJECTION = 'Handled rejection',
     UNSUPPORTED_ACCESS = 'Unsupported access',
@@ -73,6 +77,7 @@ export const enum ERR_MESSAGE {
     UNSUPPORTED_MIME = 'Unsupported MIME',
     UNSUPPORTED_READ = 'Not permitted to read file',
     UNSUPPORTED_WRITE = 'Not permitted to write file',
+    UNSUPPORTED_OVERWRITE = 'Not permitted to overwrite file',
     NOTFOUND_PATH = 'Path not found',
     NOTFOUND_FILE = 'File not found',
     NOTFOUND_BINARY = 'Binary not found',
@@ -315,6 +320,7 @@ export const enum SETTINGS_KEY_NAME {
     TEMP_WRITE = "temp.write",
     PROCESS_PASSWORD = "process.password",
     PROCESS_ENV_APPLY = "process.env.apply",
+    PROCESS_THREAD_WORKER_USERS = "process.thread.worker.users",
     PROCESS_CIPHER_ALGORITHM = "process.cipher.algorithm",
     PERMISSION_PROCESS_EXEC = "permission.process_exec",
     PERMISSION_HOMEREAD = "permission.home_read",

package/index.d.ts

@@ -4,7 +4,7 @@
 import type { LogArguments } from './lib/logger';
 import type { HighResolutionTime } from './lib/node';
 
-import type { BinaryLike, BinaryToTextEncoding, CipherGCMTypes, Encoding, RandomUUIDOptions } from 'node:crypto';
+import type { BinaryLike, BinaryToTextEncoding, CipherGCMTypes, Encoding } from 'node:crypto';
 
 // @ts-ignore
 import type { BytesOptions } from 'bytes';
@@ -140,6 +140,7 @@ declare namespace types {
 
     interface ERR_CODE {
         MODULE_NOT_FOUND: "MODULE_NOT_FOUND";
+        ERR_MODULE_NOT_FOUND: "ERR_MODULE_NOT_FOUND";
     }
 
     const ERR_CODE: {
@@ -272,6 +273,8 @@ declare namespace types {
         mergeArray?: MergeArrayMethod;
         mergeDepth?: number;
         typedArray?: boolean;
+        structured?: boolean;
+        shared?: boolean;
         symbol?: boolean;
         inherited?: boolean;
         nonenumerable?: boolean;
@@ -295,12 +298,13 @@ declare namespace types {
     function getLogCurrent(): LogArguments | null;
     function setLogCurrent(value: LogArguments | null): void;
     function setTempDir(value: string): boolean;
-    function getTempDir(): string;
+    function getTempDir(...values: string[]): string;
     function isArray<T>(value: unknown): value is T[];
-    function isObject<T = object>(value: unknown): value is T;
+    function isObject<T extends object>(value: unknown): value is T;
     function isPlainObject<T = PlainObject>(value: unknown): value is T;
-    function isString(value: unknown): value is string;
+    function isString<T extends string>(value: unknown): value is T;
     function isEmpty(value: unknown): boolean;
+    function isFunction<T extends Function>(value: unknown, cjs?: boolean): value is T;
     function asFunction<U = unknown, V = unknown>(value: unknown, sync?: boolean): FunctionType<U, V> | null;
     function parseTime(value: number | string, start?: number): number;
     function parseExpires(value: number | string, start?: number): number;
@@ -325,11 +329,12 @@ declare namespace types {
     function encryptUTF8(algorithm: CipherGCMTypes, key: BinaryLike, iv: BinaryLike, data: string, encoding?: Encoding): string | undefined;
     function decryptUTF8(algorithm: CipherGCMTypes, key: BinaryLike, iv: BinaryLike, data: string, encoding?: Encoding): string | undefined;
     function hashKey(data: BinaryLike, algorithm?: string, encoding?: BinaryToTextEncoding): string;
-    /** @deprecated - crypto.randomUUID */
-    function generateUUID(options?: RandomUUIDOptions): string;
     function incrementUUID(restart?: boolean): string;
     function validateUUID(value: unknown): boolean;
     function randomString(format: string, dictionary?: string): string;
+    function sanitizeCmd(value: string): string;
+    function sanitizeArgs(value: string, doubleQuote?: boolean): string;
+    function sanitizeArgs(values: string[], doubleQuote?: boolean): string[];
     function errorValue(value: string, hint?: string): Error;
     function errorMessage(title: number | string, value: string, hint?: string): Error;
     function supported(major: number, minor: number, lts: boolean): boolean;

package/index.js

@@ -1,5 +1,5 @@
 "use strict";
-exports.generateUUID = exports.IMPORT_MAP = exports.THRESHOLD = exports.READDIR_SORT = exports.WATCH_EVENT = exports.TRANSFER_TYPE = exports.DB_TRANSACTION = exports.DB_TYPE = exports.FETCH_TYPE = exports.DOWNLOAD_TYPE = exports.ERR_CODE = exports.ASSET_FLAG = exports.FILE_TYPE = exports.STATUS_TYPE = exports.LOG_STATE = exports.LOG_TYPE = void 0;
+exports.IMPORT_MAP = exports.THRESHOLD = exports.READDIR_SORT = exports.WATCH_EVENT = exports.TRANSFER_TYPE = exports.DB_TRANSACTION = exports.DB_TYPE = exports.FETCH_TYPE = exports.DOWNLOAD_TYPE = exports.ERR_CODE = exports.ASSET_FLAG = exports.FILE_TYPE = exports.STATUS_TYPE = exports.LOG_STATE = exports.LOG_TYPE = void 0;
 exports.createAbortError = createAbortError;
 exports.hasBit = hasBit;
 exports.ignoreFlag = ignoreFlag;
@@ -19,6 +19,7 @@ exports.isPlainObject = isPlainObject;
 exports.isObject = isObject;
 exports.isString = isString;
 exports.isEmpty = isEmpty;
+exports.isFunction = isFunction;
 exports.parseTime = parseTime;
 exports.parseExpires = parseExpires;
 exports.formatTime = formatTime;
@@ -37,6 +38,8 @@ exports.encryptUTF8 = encryptUTF8;
 exports.decryptUTF8 = decryptUTF8;
 exports.randomString = randomString;
 exports.validateUUID = validateUUID;
+exports.sanitizeCmd = sanitizeCmd;
+exports.sanitizeArgs = sanitizeArgs;
 exports.errorValue = errorValue;
 exports.errorMessage = errorMessage;
 exports.purgeMemory = purgeMemory;
@@ -49,20 +52,6 @@ const fs = require("node:fs");
 const crypto = require("node:crypto");
 const bytes = require("bytes");
 const node_url_1 = require("node:url");
-class AbortError extends Error {
-    constructor() {
-        super("This operation was aborted");
-        Error.captureStackTrace(this, this.constructor);
-    }
-    set name(value) { }
-    get name() {
-        return 'AbortError';
-    }
-    set code(value) { }
-    get code() {
-        return 20;
-    }
-}
 const PATTERN_CHARS = {
     '&': '\\x26',
     '!': '\\x21',
@@ -79,36 +68,42 @@ const PATTERN_CHARS = {
     '~': '\\x7e'
 };
 const [VER_MAJOR, VER_MINOR, VER_PATCH] = process.version.substring(1).split('.').map(value => +value);
+const PLATFORM_WIN32 = process.platform === 'win32';
 const REGEXP_UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 const REGEXP_FUNCTION = /^(async\s+)?(function(?:\b|\s+)[\w_$]*\s*\(([^)]*)\)\s*\{(.*)\})$/s;
 const REGEXP_FUNCTION_ARROW = /^(async\s+)?(\(([^)]*)\)\s*=>\s*(?:\{(.*)\}|(?!\s|{)((?:(?<!return\s+)(?:"[^"\n]*"|'[^'\n]*'|`[^`]*`|[^\n;"'`]))*;)))$/s;
 const REGEXP_GLOB = /(?<!\\)(?:(?:[^*]|^)\*{1,2}(?:[^*]|$)|\{[^}]+\}|\[[!^][^\]]+\]|[!?*+@]\([^)]+\))/;
 const REGEXP_NATIVE = /^new\s+(Date|RegExp|URL|(?:Weak)?(?:Map|Set))\((.*)\)$/s;
+const REGEXP_CLIESCAPE = /[^\w+-.,/:@]/g;
+const REGEXP_CLIOPTION = /^(-[^\s=]+|--[^-\s=][^\s=]*)(=)?\s*(.*)$/s;
 const ASYNC_FUNCTION = Object.getPrototypeOf(async () => { }).constructor;
+const RESERVED_SHELL = [
+    'if',
+    'then',
+    'elif',
+    'else',
+    'fi',
+    'time',
+    'for',
+    'in',
+    'until',
+    'while',
+    'do',
+    'done',
+    'case',
+    'esac',
+    'coproc',
+    'select',
+    'function'
+];
 let CACHE_COERCED = new WeakSet();
 let LOG_CURRENT = null;
-let SUPPORTED_DOMEXCEPTION = false;
 let SUPPORTED_HASHSINGLE = false;
 let TEMP_DIR = path.join(process.cwd(), "tmp");
 let INCREMENT_COUNT = 65536;
 let INCREMENT_PREFIX = '';
-function fromObject(value, typedArray) {
+function fromObject(value, typedArray, structured, shared) {
     if (isObject(value)) {
-        if (value instanceof Map) {
-            return new Map(value);
-        }
-        if (value instanceof Set) {
-            return new Set(value);
-        }
-        if (value instanceof Date) {
-            return new Date(value);
-        }
-        if (value instanceof RegExp) {
-            return new RegExp(value);
-        }
-        if (value instanceof URL) {
-            return new URL(value);
-        }
         if (typedArray) {
             if (value instanceof Buffer) {
                 return Buffer.from(value);
@@ -147,6 +142,31 @@ function fromObject(value, typedArray) {
                 return BigUint64Array.from(value);
             }
         }
+        if (structured) {
+            try {
+                return structuredClone(value);
+            }
+            catch {
+            }
+        }
+        if (value instanceof Map) {
+            return new Map(value);
+        }
+        if (value instanceof Set) {
+            return new Set(value);
+        }
+        if (value instanceof Date) {
+            return new Date(value);
+        }
+        if (value instanceof RegExp) {
+            return new RegExp(value);
+        }
+        if (value instanceof URL) {
+            return new URL(value);
+        }
+        if (shared === false) {
+            return;
+        }
     }
     return value;
 }
@@ -283,6 +303,14 @@ function parseStringDefault(value) {
         case 'new': {
             const match = REGEXP_NATIVE.exec(value.trimEnd());
             if (match) {
+                try {
+                    const out = eval(match[0]);
+                    if (isObject(out)) {
+                        return out;
+                    }
+                }
+                catch {
+                }
                 try {
                     let text = match[2].trim();
                     switch (match[1]) {
@@ -356,7 +384,7 @@ function checkFlags(value, flags) {
     return typeof value === 'number' && (value & flags) === flags;
 }
 const padStart = (value, char) => value > 9 ? value.toString() : char + value;
-const isFunction = (value) => typeof value === 'function';
+const wrapQuote = (value) => '"' + value.replaceAll('"', '\\"') + '"';
 var LOG_TYPE;
 (function (LOG_TYPE) {
     LOG_TYPE[LOG_TYPE["UNKNOWN"] = 0] = "UNKNOWN";
@@ -419,6 +447,7 @@ var ASSET_FLAG;
 var ERR_CODE;
 (function (ERR_CODE) {
     ERR_CODE["MODULE_NOT_FOUND"] = "MODULE_NOT_FOUND";
+    ERR_CODE["ERR_MODULE_NOT_FOUND"] = "ERR_MODULE_NOT_FOUND";
 })(ERR_CODE || (exports.ERR_CODE = ERR_CODE = {}));
 var DOWNLOAD_TYPE;
 (function (DOWNLOAD_TYPE) {
@@ -476,6 +505,7 @@ var THRESHOLD;
     THRESHOLD[THRESHOLD["FILEMANAGER_INTERVAL"] = 100] = "FILEMANAGER_INTERVAL";
     THRESHOLD[THRESHOLD["WATCH_INTERVAL"] = 500] = "WATCH_INTERVAL";
     THRESHOLD[THRESHOLD["WATCH_CHANGE"] = 100] = "WATCH_CHANGE";
+    THRESHOLD[THRESHOLD["WATCH_RECURSIVE_CHANGE"] = 500] = "WATCH_RECURSIVE_CHANGE";
     THRESHOLD[THRESHOLD["LOGGER_METER_INCREMENT"] = 250] = "LOGGER_METER_INCREMENT";
 })(THRESHOLD || (exports.THRESHOLD = THRESHOLD = {}));
 exports.IMPORT_MAP = {
@@ -496,8 +526,6 @@ exports.IMPORT_MAP = {
     "postgres": "@pi-r/postgres",
     "redis": "@pi-r/redis",
     "@babel/core": "@pi-r/babel",
-    "clean-css": "@pi-r/clean-css",
-    "csso": "@pi-r/csso",
     "eslint": "@pi-r/eslint",
     "html-validate": "@pi-r/html-validate",
     "postcss": "@pi-r/postcss",
@@ -507,15 +535,18 @@ exports.IMPORT_MAP = {
     "sass": "@pi-r/sass",
     "stylelint": "@pi-r/stylelint",
     "terser": "@pi-r/terser",
-    "ibm": "@pi-r/ibm",
-    "minio": "@pi-r/minio",
-    "html-minifier": "@pi-r/html-minifier",
-    "html-minifier-terser": "@pi-r/html-minifier-terser",
-    "svgo": "@pi-r/svgo",
-    "uglify-js": "@pi-r/uglify-js"
+    "ibm": "@pi-r2/ibm",
+    "minio": "@pi-r2/minio",
+    "imagemin": "@pi-r2/imagemin",
+    "clean-css": "@pi-r2/clean-css",
+    "csso": "@pi-r2/csso",
+    "html-minifier": "@pi-r2/html-minifier",
+    "html-minifier-terser": "@pi-r2/html-minifier-terser",
+    "svgo": "@pi-r2/svgo",
+    "uglify-js": "@pi-r2/uglify-js"
 };
 function createAbortError(reject) {
-    const result = SUPPORTED_DOMEXCEPTION ? new DOMException("This operation was aborted", 'AbortError') : new AbortError();
+    const result = new DOMException("This operation was aborted", 'AbortError');
     return (reject ? Promise.reject(result) : result);
 }
 function hasBit(value, flags) {
@@ -551,12 +582,12 @@ function getLogCurrent() {
 function setLogCurrent(value) {
     LOG_CURRENT = value;
 }
-function getTempDir() {
-    return TEMP_DIR;
+function getTempDir(...values) {
+    return values.length > 0 ? path.join(TEMP_DIR, ...values) : TEMP_DIR;
 }
 function setTempDir(value) {
     try {
-        if (path.isAbsolute(value) && fs.statSync(value).isDirectory()) {
+        if (path.isAbsolute(value = path.normalize(value)) && fs.statSync(value).isDirectory()) {
             TEMP_DIR = value;
             return true;
         }
@@ -580,6 +611,9 @@ function isString(value) {
 function isEmpty(value) {
     return value === undefined || value === null || value === '' || Array.isArray(value) && value.length === 0;
 }
+function isFunction(value, cjs = false) {
+    return typeof value === 'function' && (!cjs || Object.hasOwn(value, "__cjs__"));
+}
 function parseTime(value, start = 0) {
     const seconds = +value;
     if (isNaN(seconds) && isString(value)) {
@@ -822,16 +856,17 @@ function cascadeObject(data, query, fallback) {
     return fallback;
 }
 function cloneObject(data, options) {
-    let freezeDepth = -1, mergeDepth = Infinity, target, deep, deepIgnore, mergeArray, typedArray, inherited, nonenumerable, symbol, preserve;
+    let freezeDepth = -1, mergeDepth = Infinity, target, deep, deepIgnore, mergeArray, typedArray, structured, shared, inherited, nonenumerable, symbol, preserve;
     if (options === true) {
         deep = true;
     }
     else if (options instanceof WeakSet) {
         deep = true;
+        structured = true;
         deepIgnore = options;
     }
     else if (options) {
-        ({ target, deep, deepIgnore, mergeArray, typedArray, inherited, nonenumerable, symbol, preserve } = options);
+        ({ target, deep, deepIgnore, mergeArray, typedArray, structured, inherited, nonenumerable, symbol, preserve } = options);
         if (typeof options.freezeDepth === 'number') {
             freezeDepth = options.freezeDepth - 1;
         }
@@ -845,7 +880,7 @@ function cloneObject(data, options) {
     let nested;
     if (deep || freezeDepth > 0) {
         deepIgnore ||= new WeakSet();
-        nested = { deep, deepIgnore, freezeDepth, mergeArray, mergeDepth, typedArray, preserve };
+        nested = { deep, deepIgnore, freezeDepth, mergeArray, mergeDepth, typedArray, structured, preserve };
     }
     if (Array.isArray(data)) {
         deepIgnore?.add(data);
@@ -865,7 +900,7 @@ function cloneObject(data, options) {
         for (let i = 0; i < length; ++i) {
             const value = data[i];
             if (deepIgnore) {
-                target[i] = (Array.isArray(value) || isPlainObject(value)) && !deepIgnore.has(value) ? cloneObject(value, nested) : fromObject(value, typedArray);
+                target[i] = (Array.isArray(value) || isPlainObject(value)) && !deepIgnore.has(value) ? cloneObject(value, nested) : fromObject(value, typedArray, structured, shared);
             }
             else {
                 target[i] = Array.isArray(value) ? value.slice(0) : value;
@@ -881,7 +916,7 @@ function cloneObject(data, options) {
             const value = data[attr];
             let merge;
             if (deepIgnore) {
-                merge = (Array.isArray(value) || isPlainObject(value)) && !deepIgnore.has(value) ? cloneObject(value, nested) : fromObject(value, typedArray);
+                merge = (Array.isArray(value) || isPlainObject(value)) && !deepIgnore.has(value) ? cloneObject(value, nested) : fromObject(value, typedArray, structured, shared);
             }
             else {
                 merge = Array.isArray(value) ? value.slice(0) : value;
@@ -912,7 +947,7 @@ function cloneObject(data, options) {
         }
     }
     else {
-        return deep ? fromObject(data, typedArray) : data;
+        return deep ? fromObject(data, typedArray, structured, false) : data;
     }
     if (freezeDepth >= 0) {
         Object.freeze(target);
@@ -937,7 +972,7 @@ function coerceObject(data, parseString, cache) {
     return recurseObject(data, parseString, new WeakSet(), cache);
 }
 function asFunction(value, sync = true) {
-    if (isFunction(value)) {
+    if (typeof value === 'function') {
         return value;
     }
     let match;
@@ -949,7 +984,7 @@ function asFunction(value, sync = true) {
         }
         try {
             const result = (0, eval)(`(${match[2]})`);
-            if (isFunction(result)) {
+            if (typeof result === 'function') {
                 return result;
             }
         }
@@ -958,13 +993,13 @@ function asFunction(value, sync = true) {
     }
     return null;
 }
-function getEncoding(value, fallback = 'utf-8') {
+function getEncoding(value, fallback) {
     if (typeof value === 'string') {
         switch (value = value.trim().toLowerCase()) {
             case 'utf8':
             case 'utf-8':
             case 'unicode-1-1-utf-8':
-                return 'utf-8';
+                return 'utf8';
             case 'utf16le':
             case 'utf-16le':
             case 'utf16':
@@ -975,7 +1010,7 @@ function getEncoding(value, fallback = 'utf-8') {
             return value;
         }
     }
-    return fallback;
+    return fallback || 'utf8';
 }
 function encryptUTF8(algorithm, key, iv, data, encoding = 'hex') {
     if (checkCipherType(algorithm) && isString(data)) {
@@ -1009,7 +1044,7 @@ function randomString(format, dictionary) {
         if (match) {
             dictionary ||= '0123456789abcdef';
             const result = format.match(/(\d+|[^\d[]+|\[[^\]]+\]|\[)/g)?.reduce((a, b) => {
-                let length, available;
+                let length = 0, available;
                 if (b.startsWith('[') && b.endsWith(']')) {
                     length = 1;
                     available = b.substring(1, b.length - 1);
@@ -1021,7 +1056,7 @@ function randomString(format, dictionary) {
                     available = dictionary;
                 }
                 const upperBound = available.length;
-                if (isFunction(crypto.getRandomValues) && length > 1 && length <= 65536) {
+                if (length > 1 && length <= 65536) {
                     const items = crypto.getRandomValues(new Uint32Array(length));
                     for (let i = 0; i < length; i++) {
                         a += available[items[i] % upperBound];
@@ -1044,6 +1079,60 @@ function randomString(format, dictionary) {
 function validateUUID(value) {
     return typeof value === 'string' && value.length === 36 && REGEXP_UUID.test(value);
 }
+function sanitizeCmd(value) {
+    if (value.includes(' ')) {
+        return PLATFORM_WIN32 ? wrapQuote(value) : value.replaceAll(' ', '\\ ');
+    }
+    return value;
+}
+function sanitizeArgs(values, doubleQuote) {
+    const result = typeof values === 'string' ? [values] : values;
+    for (let i = 0; i < result.length; ++i) {
+        let value = result[i].trim(), leading = '';
+        if (value !== '--') {
+            const opt = REGEXP_CLIOPTION.exec(value);
+            if (opt) {
+                if (!opt[2] && !opt[3]) {
+                    result[i] = opt[1];
+                    continue;
+                }
+                leading = opt[1] + (opt[2] || ' ');
+                value = opt[3];
+            }
+            if (value) {
+                const quoted = /^(["'])(.*)\1$/s.exec(value);
+                if (PLATFORM_WIN32) {
+                    if (quoted) {
+                        if (quoted[1] === '"') {
+                            result[i] = leading + value;
+                            continue;
+                        }
+                        value = quoted[2];
+                    }
+                    if (value.includes(' ')) {
+                        value = wrapQuote(value);
+                    }
+                }
+                else if (!quoted) {
+                    if (REGEXP_CLIESCAPE.test(value)) {
+                        value = doubleQuote ? `"${value.replace(/(?<!\\)"/g, '\\"')}"` : `'${value.replaceAll("'", "'\\''")}'`;
+                    }
+                    else if (RESERVED_SHELL.includes(value)) {
+                        value = `'${value}'`;
+                    }
+                }
+            }
+            else if (opt) {
+                leading = leading.trim();
+                if (!PLATFORM_WIN32 && leading.length > 2 && leading[1] !== '-') {
+                    leading = leading.replace(REGEXP_CLIESCAPE, capture => '\\' + capture);
+                }
+            }
+        }
+        result[i] = leading + value;
+    }
+    return (typeof values === 'string' ? result[0] : result);
+}
 function errorValue(value, hint) {
     return new Error(value + (hint ? ` (${hint})` : ''));
 }
@@ -1102,6 +1191,4 @@ async function importESM(name, isDefault, fromPath) {
     }
     return result;
 }
-exports.generateUUID = crypto.randomUUID.bind(crypto);
-SUPPORTED_DOMEXCEPTION = supported(17);
 SUPPORTED_HASHSINGLE = supported(20, 12, true) || supported(21, 7);

package/lib/compress.d.ts

@@ -1,4 +1,4 @@
-import type { CompressFormat as ICompressFormat, CompressLevel as ICompressLevel } from './squared';
+import type { CompressFormat as ICompressFormat, CompressLevel as ICompressLevel, MimeTypeAction, WorkerAction } from './squared';
 
 import type { LogBaseOptions, LogTime } from './logger';
 import type { ThrowsAction } from './module';
@@ -6,9 +6,8 @@ import type { ThrowsAction } from './module';
 type ResultCallback<T = Buffer | Uint8Array | null> = (err: unknown, data?: T, ext?: string) => void;
 type ResultData = Buffer | Uint8Array | string | null;
 
-export interface CompressFormat extends ICompressFormat, LogBaseOptions, ReadableOptions {
+export interface CompressFormat extends ICompressFormat, LogBaseOptions, ReadableOptions, MimeTypeAction, WorkerAction {
     filename?: string;
-    mimeType?: string;
     startTime?: LogTime;
     etag?: string;
     outExt?: string;
@@ -17,10 +16,12 @@ export interface CompressFormat extends ICompressFormat, LogBaseOptions, Readabl
 
 export interface CompressLevel extends ICompressLevel, ReadableOptions {}
 
+export interface BrotliCompressLevel extends CompressLevel, MimeTypeAction {}
+
 export interface ReadableOptions extends ThrowsAction {}
 
 export type BufferLike = Buffer | Uint8Array | ArrayBuffer | SharedArrayBuffer | readonly number[];
 export type TryFileCompressor = (data: string | Buffer, output: string, config: CompressFormat, callback?: ResultCallback<ResultData>) => Promise<ResultData | void>;
 export type TryFileCompressorAsync = (data: string | Buffer, output: string, config: CompressFormat) => Promise<ResultData>;
 export type BufferResult = Buffer | Uint8Array | null;
-export type PluginCompressor = FunctionArgs<[CompressFormat['options'], string?], FunctionArgs<[Buffer], Promise<Buffer | Uint8Array>>>;
+export type PluginCompressor = FunctionArgs<[CompressFormat["options"], CompressFormat["metadata"]?], FunctionArgs<[Buffer], Promise<Buffer | Uint8Array>>>;