@e-mc/types 0.8.7 → 0.9.0

package/LICENSE

@@ -1,11 +1,11 @@
-Copyright 2024 An Pham
-
-Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
-
-1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
-
-2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
-
-3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
-
+Copyright 2024 An Pham
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -1,6 +1,6 @@
 # @e-mc/types
 
-* NodeJS 14
+* NodeJS 14/16
 * ES2020
 
 ## General Usage
@@ -9,7 +9,7 @@
 
 ## Interface
 
-- https://www.unpkg.com/@e-mc/types@0.8.7/index.d.ts
+* [View Source](https://www.unpkg.com/@e-mc/types@0.9.0/index.d.ts)
 
 ```typescript
 import type { LogArguments } from "./lib/logger";
@@ -17,7 +17,9 @@ import type { CloneObjectOptions } from "./lib/module";
 
 import type { BytesOptions } from "bytes";
 import type { BinaryLike, CipherGCMTypes, Encoding } from "crypto";
+import type { HighResolutionTime } from "perf_hooks";
 
+function createAbortError(reject: true): Promise<never>;
 function createAbortError(): Error;
 function hasBit(value: unknown, flags: number): boolean;
 function ignoreFlag(value: unknown): boolean;
@@ -162,6 +164,12 @@ interface DB_TRANSACTION {
     CACHE: 128;
 }
 
+interface TRANSFER_TYPE {
+    DISK: 1;
+    STREAM: 2;
+    CHUNK: 4;
+}
+
 interface WATCH_EVENT {
     MODIFIED: "modified";
     BROADCAST: "broadcast";
@@ -184,10 +192,26 @@ interface THRESHOLD {
 const IMPORT_MAP: Record<string, string | undefined>;
 ```
 
+## NodeJS 14 LTS
+
+Any optional fail safe dependencies were removed as of `E-mc 0.9`. The code itself will still be *ES2020* and will continue to work equivalently when self-installing these dependencies:
+
+### Under 15.4 + 16.0
+
+```sh
+npm i abort-controller event-target-shim
+```
+
+### Under 14.17 + 15.6
+
+```sh
+  npm i uuid
+```
+
 ## References
 
-- https://www.unpkg.com/@e-mc/types@0.8.7/lib/logger.d.ts
-- https://www.unpkg.com/@e-mc/types@0.8.7/lib/module.d.ts
+- https://www.unpkg.com/@e-mc/types@0.9.0/lib/logger.d.ts
+- https://www.unpkg.com/@e-mc/types@0.9.0/lib/module.d.ts
 
 * https://nodejs.org/api/perf_hooks.html
 * https://www.npmjs.com/package/@types/bytes

package/constant.d.ts

@@ -1,5 +1,5 @@
 export const enum INTERNAL {
-    VERSION = '0.8.7',
+    VERSION = '0.9.0',
     TEMP_DIR = 'tmp',
     CJS = '__cjs__'
 }
@@ -47,11 +47,16 @@ export const enum ERR_MESSAGE {
     PARAMETERS = 'Invalid parameters',
     FORMAT = 'Invalid format',
     CHECKSUM = 'Invalid checksum',
+    RESPONSE = 'Invalid response',
+    SIZE = 'Size limit was exceeded',
     ERROR_CODE = 'Error code',
+    PERMISSION = 'Operation not permitted',
     EXEC_PERMISSION = 'Exec command not permitted',
     NOT_CACHEABLE = 'Not able to cache',
     NOT_COPYABLE = 'Not able to copy file',
     NOT_DIRECTORY = 'Path is not a directory',
+    NOT_ABSOLUTE = 'Path is not absolute',
+    NOT_READABLE = 'Not able to read buffer',
     CANCELLED = 'Transaction was cancelled',
     INCOMPLETE = 'Transaction was not completed',
     THREAD = 'Thread limit exceeded',
@@ -62,6 +67,7 @@ export const enum ERR_MESSAGE {
     UNSUPPORTED_MIME = 'Unsupported MIME',
     UNSUPPORTED_READ = 'Not permitted to read file',
     UNSUPPORTED_WRITE = 'Not permitted to write file',
+    NOTFOUND_PATH = 'Path not found',
     NOTFOUND_FILE = 'File not found',
     NOTFOUND_BINARY = 'Binary not found',
     NOTFOUND_PACKAGE = 'Package not found',
@@ -161,7 +167,10 @@ export const enum ERR_IMAGE {
 }
 
 export const enum ERR_HTTP {
-    HEADERS = 'Unable to process headers'
+    HEADERS = 'Unable to process headers',
+    ETAG = 'ETag not supported',
+    DOWNLOAD_SUCCESS = 'No files were successfully downloaded',
+    MULTIPART_ATTACH = 'No files were attached'
 }
 
 export const enum DB_TRANSACTION {
@@ -175,6 +184,12 @@ export const enum DB_TRANSACTION {
     CACHE = 128
 }
 
+export const enum TRANSFER_TYPE {
+    DISK = 1,
+    STREAM = 2,
+    CHUNK = 4
+}
+
 export const enum TIME {
     Y = 1000 * 60 * 60 * 24 * 7 * 52,
     M = 1000 * 60 * 60 * 24 * 30,
@@ -247,6 +262,12 @@ export const enum LOG_TYPE {
     DB = 65536
 }
 
+export const enum LOG_STATE {
+    STDIN = 0,
+    STDOUT = 1,
+    STDERR = 2
+}
+
 export const enum READDIR_SORT {
     FILE = 0,
     DIRECTORY = 1,

package/index.d.ts

@@ -56,6 +56,18 @@ declare namespace types {
         DB: 65536;
     };
 
+    interface LOG_STATE {
+        STDIN: 0;
+        STDOUT: 1;
+        STDERR: 2;
+    }
+
+    const LOG_STATE: {
+        STDIN: 0;
+        STDOUT: 1;
+        STDERR: 2;
+    };
+
     interface STATUS_TYPE {
         UNKNOWN: 0;
         FATAL: 1;
@@ -202,6 +214,18 @@ declare namespace types {
         CACHE: 128;
     };
 
+    interface TRANSFER_TYPE {
+        DISK: 1;
+        STREAM: 2;
+        CHUNK: 4;
+    }
+
+    const TRANSFER_TYPE: {
+        DISK: 1;
+        STREAM: 2;
+        CHUNK: 4;
+    };
+
     interface WATCH_EVENT {
         MODIFIED: "modified";
         BROADCAST: "broadcast";
@@ -244,6 +268,7 @@ declare namespace types {
 
     type WatchEventValue = WATCH_EVENT[keyof WATCH_EVENT];
 
+    function createAbortError(reject: true): Promise<never>;
     function createAbortError(): AbortError;
     function hasBit(value: unknown, flags: number): boolean;
     function ignoreFlag(value: unknown): boolean;

package/index.js

@@ -1,11 +1,9 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.errorMessage = exports.errorValue = exports.validateUUID = exports.randomString = exports.decryptUTF8 = exports.encryptUTF8 = exports.getEncoding = exports.asFunction = exports.coerceObject = exports.cloneObject = exports.cascadeObject = exports.formatSize = exports.renameExt = exports.escapePattern = exports.hasGlob = exports.convertTime = exports.formatTime = exports.parseExpires = exports.parseTime = exports.isEmpty = exports.isString = exports.isObject = exports.isPlainObject = exports.isArray = exports.setTempDir = exports.getTempDir = exports.setLogCurrent = exports.getLogCurrent = exports.existsFlag = exports.mainFlag = exports.processFlag = exports.modifiedFlag = exports.watchFlag = exports.usingFlag = exports.cloneFlag = exports.ignoreFlag = exports.hasBit = exports.createAbortError = exports.THRESHOLD = exports.IMPORT_MAP = exports.WATCH_EVENT = 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_TYPE = void 0;
-exports.generateUUID = exports.purgeMemory = void 0;
+exports.randomString = exports.decryptUTF8 = exports.encryptUTF8 = exports.getEncoding = exports.asFunction = exports.coerceObject = exports.cloneObject = exports.cascadeObject = exports.alignSize = exports.formatSize = exports.renameExt = exports.escapePattern = exports.hasGlob = exports.convertTime = exports.formatTime = exports.parseExpires = exports.parseTime = exports.isEmpty = exports.isString = exports.isObject = exports.isPlainObject = exports.isArray = exports.setTempDir = exports.getTempDir = exports.setLogCurrent = exports.getLogCurrent = exports.existsFlag = exports.mainFlag = exports.processFlag = exports.modifiedFlag = exports.watchFlag = exports.usingFlag = exports.cloneFlag = exports.ignoreFlag = exports.hasBit = exports.createAbortError = 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_TYPE = void 0;
+exports.generateUUID = exports.incrementUUID = exports.purgeMemory = exports.errorMessage = exports.errorValue = exports.validateUUID = void 0;
 const path = require("path");
 const fs = require("fs");
 const crypto = require("crypto");
-const uuid = require("uuid");
 const bytes = require("bytes");
 class AbortError extends Error {
     constructor() {
@@ -15,11 +13,15 @@ class AbortError extends Error {
     }
 }
 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\s]*)\})$/;
+const REGEXP_FUNCTION = /^(async\s+)?(function(?:\b|\s+)[\w_$]*\s*\(([^)]*)\)\s*\{([\S\s]*)\})$/;
+const REGEXP_FUNCTION_ARROW = /^(async\s+)?(\(([^)]*)\)\s*=>\s*(?:\{([\S\s]*)\}|(?!\s|{)((?:(?<!return\s+)(?:"[^"\n]*"|'[^'\n]*'|`[^`]*`|[^\n;"'`]))*;)))$/;
+const REGEXP_GLOB = /(?<!\\)(?:(?:[^*]|^)\*{1,2}(?:[^*]|$)|\{[^}]+\}|\[[!^][^\]]+\]|[!?*+@]\([^)]+\))/;
 const ASYNC_FUNCTION = Object.getPrototypeOf(async () => { }).constructor;
 let CACHE_COERCED = new WeakSet();
 let LOG_CURRENT = null;
 let TEMP_DIR = path.join(process.cwd(), "tmp");
+let INCREMENT_COUNT = 65536;
+let INCREMENT_PREFIX = '';
 function fromObject(value, typedArray) {
     if (isObject(value)) {
         if (value instanceof Map) {
@@ -234,6 +236,12 @@ var DB_TRANSACTION;
     DB_TRANSACTION[DB_TRANSACTION["AUTH"] = 64] = "AUTH";
     DB_TRANSACTION[DB_TRANSACTION["CACHE"] = 128] = "CACHE";
 })(DB_TRANSACTION || (exports.DB_TRANSACTION = DB_TRANSACTION = {}));
+var TRANSFER_TYPE;
+(function (TRANSFER_TYPE) {
+    TRANSFER_TYPE[TRANSFER_TYPE["DISK"] = 1] = "DISK";
+    TRANSFER_TYPE[TRANSFER_TYPE["STREAM"] = 2] = "STREAM";
+    TRANSFER_TYPE[TRANSFER_TYPE["CHUNK"] = 4] = "CHUNK";
+})(TRANSFER_TYPE || (exports.TRANSFER_TYPE = TRANSFER_TYPE = {}));
 var WATCH_EVENT;
 (function (WATCH_EVENT) {
     WATCH_EVENT["MODIFIED"] = "modified";
@@ -241,6 +249,18 @@ var WATCH_EVENT;
     WATCH_EVENT["CLOSE"] = "close";
     WATCH_EVENT["ERROR"] = "error";
 })(WATCH_EVENT || (exports.WATCH_EVENT = WATCH_EVENT = {}));
+var READDIR_SORT;
+(function (READDIR_SORT) {
+    READDIR_SORT[READDIR_SORT["FILE"] = 0] = "FILE";
+    READDIR_SORT[READDIR_SORT["DIRECTORY"] = 1] = "DIRECTORY";
+    READDIR_SORT[READDIR_SORT["DESCENDING"] = 2] = "DESCENDING";
+})(READDIR_SORT || (exports.READDIR_SORT = READDIR_SORT = {}));
+var THRESHOLD;
+(function (THRESHOLD) {
+    THRESHOLD[THRESHOLD["FILEMANAGER_INTERVAL"] = 100] = "FILEMANAGER_INTERVAL";
+    THRESHOLD[THRESHOLD["WATCH_INTERVAL"] = 500] = "WATCH_INTERVAL";
+    THRESHOLD[THRESHOLD["WATCH_CHANGE"] = 100] = "WATCH_CHANGE";
+})(THRESHOLD || (exports.THRESHOLD = THRESHOLD = {}));
 var IMPORT_MAP;
 (function (IMPORT_MAP) {
     IMPORT_MAP["@squared-functions/cloud"] = "@e-mc/cloud";
@@ -321,14 +341,9 @@ var IMPORT_MAP;
     IMPORT_MAP["@squared-functions/document/packages/terser"] = "@pi-r/terser";
     IMPORT_MAP["@squared-functions/document/packages/uglify-js"] = "@pi-r/uglify-js";
 })(IMPORT_MAP || (exports.IMPORT_MAP = IMPORT_MAP = {}));
-var THRESHOLD;
-(function (THRESHOLD) {
-    THRESHOLD[THRESHOLD["FILEMANAGER_INTERVAL"] = 100] = "FILEMANAGER_INTERVAL";
-    THRESHOLD[THRESHOLD["WATCH_INTERVAL"] = 500] = "WATCH_INTERVAL";
-    THRESHOLD[THRESHOLD["WATCH_CHANGE"] = 100] = "WATCH_CHANGE";
-})(THRESHOLD || (exports.THRESHOLD = THRESHOLD = {}));
-function createAbortError() {
-    return new AbortError();
+function createAbortError(reject) {
+    const result = new AbortError();
+    return (reject ? Promise.reject(result) : result);
 }
 exports.createAbortError = createAbortError;
 function hasBit(value, flags) {
@@ -396,7 +411,7 @@ function isArray(value) {
 }
 exports.isArray = isArray;
 function isPlainObject(value) {
-    return value && typeof value === 'object' ? value.constructor === Object || Object.getPrototypeOf(value) === null : false;
+    return typeof value === 'object' && value !== null && (value.constructor === Object || Object.getPrototypeOf(value) === null);
 }
 exports.isPlainObject = isPlainObject;
 function isObject(value) {
@@ -414,9 +429,8 @@ exports.isEmpty = isEmpty;
 function parseTime(value, start = 0) {
     const seconds = +value;
     if (isNaN(seconds) && isString(value)) {
-        const pattern = /\b([\d.]+)\s*(y|M|w|d|h|ms?|s)\b/g;
-        let result = 0, match = null;
-        while (match = pattern.exec(value.toLowerCase())) {
+        let result = 0;
+        for (const match of value.toLowerCase().matchAll(/\b([\d.]+)\s*(y|M|w|d|h|ms?|s)\b/g)) {
             const n = +match[1];
             if (isNaN(n)) {
                 continue;
@@ -476,13 +490,13 @@ function formatTime(value, elapsed, char = ' ') {
     if (value < 1000) {
         return value + 'ms';
     }
-    const h = Math.floor(value / 3600000);
-    if (h > 0) {
+    if (value >= 3600000) {
+        const h = Math.floor(value / 3600000);
         value -= h * 3600000;
         result.push(h + 'h');
     }
-    const m = Math.floor(value / 60000);
-    if (m > 0) {
+    if (value >= 60000) {
+        const m = Math.floor(value / 60000);
         value -= m * 60000;
         result.push(m + 'm');
     }
@@ -493,15 +507,19 @@ function formatTime(value, elapsed, char = ' ') {
 }
 exports.formatTime = formatTime;
 function convertTime(value, format) {
+    let result;
     if (Array.isArray(value)) {
-        const result = Math.ceil((value[0] * 1000000000 + value[1]) / 1000000);
-        return format ? formatTime(result) : result;
+        const time = Math.ceil((value[0] * 1000000000 + value[1]) / 1000000);
+        result = format ? formatTime(time) : time;
     }
-    return parseTime(value);
+    else {
+        result = parseTime(value);
+    }
+    return result;
 }
 exports.convertTime = convertTime;
 function hasGlob(value) {
-    return /(?<!\\)(?:(?:[^*]|^)\*{1,2}(?:[^*]|$)|\{[^}]+\}|\[[!^][^\]]+\]|[!?*+@]\([^)]+\))/.test(value);
+    return REGEXP_GLOB.test(value);
 }
 exports.hasGlob = hasGlob;
 function escapePattern(value, lookBehind) {
@@ -563,11 +581,46 @@ function renameExt(value, ext, when) {
 }
 exports.renameExt = renameExt;
 function formatSize(value, options) {
-    return (typeof value === 'number' ? bytes(value, options) : bytes(value));
+    let result;
+    if (typeof value === 'number') {
+        result = bytes(value, options) || ('0' + (options?.unitSeparator || '') + 'B');
+    }
+    else {
+        result = bytes(value) || 0;
+    }
+    return result;
 }
 exports.formatSize = formatSize;
+function alignSize(value, kb = 0, factor = 0) {
+    if (value === undefined) {
+        return NaN;
+    }
+    let result = 0;
+    switch (typeof value) {
+        case 'number':
+            if (value < 0) {
+                return NaN;
+            }
+            result = Math.ceil(factor > 0 ? value * Math.pow(1024, factor) : value);
+            break;
+        case 'string':
+            result = formatSize(value);
+            if (result < 0) {
+                return NaN;
+            }
+            break;
+        default:
+            return NaN;
+    }
+    if (kb > 0) {
+        kb = Math.ceil(kb) * 1024;
+        return Math.ceil(result / kb) * kb;
+    }
+    return result;
+}
+exports.alignSize = alignSize;
 function cascadeObject(data, query, fallback) {
-    if (isObject(data) && isString(query)) {
+    if (isObject(data)) {
         const names = query.trim().split(/(?<!\\)\./).map(item => item.includes('.') ? item.replace(/\\(?=\.)/g, '') : item);
         for (let i = 0, length = names.length, match, current = data; i < length; ++i) {
             if (!(match = /^(.+?)(?:\[(.+)\])?$/.exec(names[i]))) {
@@ -700,16 +753,16 @@ function coerceObject(data, parseString, cache) {
     }
     if (!parseString) {
         parseString = (value) => {
-            if (value.length > 8) {
-                switch (value.substring(0, 3)) {
-                    case 'new': {
-                        const match = /^new\s+(Date|RegExp|URL|Map|WeakMap|Set|WeakSet)\(([\S\s]*)\)$/.exec(value.trimEnd());
-                        if (!match) {
-                            break;
-                        }
+            if (value.length <= 8) {
+                return null;
+            }
+            switch (value.substring(0, 3)) {
+                case 'new': {
+                    const match = /^new\s+(Date|RegExp|URL|Map|WeakMap|Set|WeakSet)\(([\S\s]*)\)$/.exec(value.trimEnd());
+                    if (match) {
                         try {
                             const removeQuotes = (content) => content.trim().replace(/^["']/g, '').replace(/["']$/g, '').trim();
-                            const errorCreate = () => errorValue('Invalid parameters', match[2].trim());
+                            const errorCreate = () => errorValue("Invalid parameters", match[2].trim());
                             switch (match[1]) {
                                 case 'Date':
                                     return new Date(match[2].replace(/["']/g, '').trim());
@@ -746,39 +799,39 @@ function coerceObject(data, parseString, cache) {
                         catch {
                             return undefined;
                         }
-                        break;
                     }
-                    case 'asy':
-                        if (value.substring(3, 5) === 'nc') {
-                            return asFunction(value);
-                        }
-                        break;
-                    case 'fun':
-                        if (value.substring(3, 8) === 'ction') {
-                            return asFunction(value);
-                        }
-                        break;
-                    case 'Num':
-                        switch (value) {
-                            case 'Number.EPSILON':
-                                return Number.EPSILON;
-                            case 'Number.MAX_SAFE_INTEGER':
-                                return Number.MAX_SAFE_INTEGER;
-                            case 'Number.MAX_VALUE':
-                                return Number.MAX_VALUE;
-                            case 'Number.MIN_SAFE_INTEGER':
-                                return Number.MIN_SAFE_INTEGER;
-                            case 'Number.MIN_VALUE':
-                                return Number.MIN_VALUE;
-                            case 'Number.NaN':
-                                return Number.NaN;
-                            case 'Number.NEGATIVE_INFINITY':
-                                return Number.NEGATIVE_INFINITY;
-                            case 'Number.POSITIVE_INFINITY':
-                                return Number.POSITIVE_INFINITY;
-                        }
-                        break;
+                    break;
                 }
+                case 'asy':
+                    if (value.substring(3, 5) === 'nc') {
+                        return asFunction(value);
+                    }
+                    break;
+                case 'fun':
+                    if (value.substring(3, 8) === 'ction') {
+                        return asFunction(value);
+                    }
+                    break;
+                case 'Num':
+                    switch (value) {
+                        case 'Number.EPSILON':
+                            return Number.EPSILON;
+                        case 'Number.MAX_SAFE_INTEGER':
+                            return Number.MAX_SAFE_INTEGER;
+                        case 'Number.MAX_VALUE':
+                            return Number.MAX_VALUE;
+                        case 'Number.MIN_SAFE_INTEGER':
+                            return Number.MIN_SAFE_INTEGER;
+                        case 'Number.MIN_VALUE':
+                            return Number.MIN_VALUE;
+                        case 'Number.NaN':
+                            return Number.NaN;
+                        case 'Number.NEGATIVE_INFINITY':
+                            return Number.NEGATIVE_INFINITY;
+                        case 'Number.POSITIVE_INFINITY':
+                            return Number.POSITIVE_INFINITY;
+                    }
+                    break;
             }
             return null;
         };
@@ -797,10 +850,10 @@ function asFunction(value, sync = true) {
         return value;
     }
     let match;
-    if (isString(value) && (match = REGEXP_FUNCTION.exec(value = value.trim()))) {
+    if (isString(value) && (match = REGEXP_FUNCTION.exec(value = value.trim()) || REGEXP_FUNCTION_ARROW.exec(value))) {
         if (!sync || match[1]) {
-            const args = match[4].trim().split(/\s*,\s*/);
-            args.push(match[5]);
+            const args = match[3].trim().split(/\s*,\s*/);
+            args.push(match[4] || (match[5] && (match[5] = 'return ' + match[5])));
             return new ASYNC_FUNCTION(...args);
         }
         try {
@@ -816,7 +869,22 @@ function asFunction(value, sync = true) {
 }
 exports.asFunction = asFunction;
 function getEncoding(value, fallback = 'utf-8') {
-    return typeof value === 'string' && Buffer.isEncoding(value = value.trim().toLowerCase()) ? value : fallback;
+    if (typeof value === 'string') {
+        switch (value = value.trim().toLowerCase()) {
+            case 'utf8':
+            case 'utf-8':
+            case 'utf16le':
+                return value;
+            case 'utf-16le':
+            case 'utf16':
+            case 'utf-16':
+                return 'utf16le';
+        }
+        if (Buffer.isEncoding(value)) {
+            return value;
+        }
+    }
+    return fallback;
 }
 exports.getEncoding = getEncoding;
 function encryptUTF8(algorithm, key, iv, data, encoding = 'hex') {
@@ -845,40 +913,35 @@ function randomString(format, dictionary) {
     if (format !== '8-4-4-4-12' || dictionary) {
         const match = format.match(/(\d+|[^\d]+)/g);
         if (match) {
-            try {
-                dictionary || (dictionary = '0123456789abcdef');
-                const result = format.match(/(\d+|[^\d[]+|\[[^\]]+\]|\[)/g).reduce((a, b) => {
-                    let length, available;
-                    if (b.startsWith('[') && b.endsWith(']')) {
-                        length = 1;
-                        available = b.substring(1, b.length - 1);
+            dictionary || (dictionary = '0123456789abcdef');
+            const result = format.match(/(\d+|[^\d[]+|\[[^\]]+\]|\[)/g)?.reduce((a, b) => {
+                let length, available;
+                if (b.startsWith('[') && b.endsWith(']')) {
+                    length = 1;
+                    available = b.substring(1, b.length - 1);
+                }
+                else {
+                    if (isNaN(length = +b)) {
+                        return a + b;
                     }
-                    else {
-                        length = +b;
-                        available = dictionary;
+                    available = dictionary;
+                }
+                const upperBound = available.length;
+                if (isFunction(crypto.getRandomValues) && length > 1 && length <= 65536) {
+                    const items = crypto.getRandomValues(new Uint32Array(length));
+                    for (let i = 0; i < length; i++) {
+                        a += available[items[i] % upperBound];
                     }
-                    if (!isNaN(length)) {
-                        const j = available.length;
-                        if (isFunction(crypto.getRandomValues) && length > 1) {
-                            const items = crypto.getRandomValues(new Uint32Array(length));
-                            for (let i = 0; i < length; i++) {
-                                a += available[items[i] % j];
-                            }
-                        }
-                        else {
-                            for (let i = 0; i < length; ++i) {
-                                a += available[Math.floor(Math.random() * j)];
-                            }
-                        }
-                        return a;
+                }
+                else {
+                    for (let i = 0; i < length; ++i) {
+                        a += available[Math.floor(Math.random() * upperBound)];
                     }
-                    return a + b;
-                }, '');
-                if (result) {
-                    return result;
                 }
-            }
-            catch {
+                return a;
+            }, '');
+            if (result) {
+                return result;
             }
         }
     }
@@ -901,4 +964,12 @@ function purgeMemory(percent) {
     CACHE_COERCED = new WeakSet();
 }
 exports.purgeMemory = purgeMemory;
-exports.generateUUID = typeof crypto.randomUUID === 'function' ? crypto.randomUUID.bind(crypto) : uuid.v4;
+function incrementUUID(restart) {
+    if (restart || INCREMENT_COUNT === 65536) {
+        INCREMENT_COUNT = 0;
+        INCREMENT_PREFIX = (0, exports.generateUUID)().substring(0, 33);
+    }
+    return INCREMENT_PREFIX + (INCREMENT_COUNT++).toString(16).padStart(4, '0');
+}
+exports.incrementUUID = incrementUUID;
+exports.generateUUID = typeof crypto.randomUUID === 'function' ? crypto.randomUUID.bind(crypto) : require('uuid').v4;

package/lib/asset.d.ts

@@ -58,7 +58,7 @@ export interface ExternalAsset extends FileAsset, BundleAction, BinaryAction, St
     id?: number;
     url?: URL;
     socketPath?: string;
-    buffer?: Buffer;
+    buffer?: Null<Buffer>;
     localUri?: string;
     fetchType?: FetchType;
     sourceUTF8?: string;
@@ -72,4 +72,6 @@ export interface ExternalAsset extends FileAsset, BundleAction, BinaryAction, St
     lastModified?: string;
     contentLength?: number;
     invalid?: boolean;
-}
+}
+
+export type HashAlgorithm = "md5" | "sha1" | "sha256" | "sha224" | "sha384" | "sha512";