@e-mc/module 0.7.1 → 0.8.1

package/index.js

@@ -9,6 +9,7 @@ const crypto = require("crypto");
 const url = require("url");
 const filetype = require("file-type");
 const mime = require("mime-types");
+const pm = require("picomatch");
 const chalk = require("chalk");
 const stripansi = require("strip-ansi");
 const EventEmitter = require("events");
@@ -74,6 +75,7 @@ const SETTINGS = {
     session_id: 0,
     message: true,
     stack_trace: false,
+    abort: true,
     unknown: true,
     system: true,
     node: true,
@@ -117,6 +119,14 @@ const VALUES = {
     ["broadcast.out" /* KEY_NAME.BROADCAST_OUT */]: null,
     ["logger.level" /* KEY_NAME.LOGGER_LEVEL */]: -1
 };
+const MEMORY_CACHE_DISK = {
+    enabled: false,
+    min_size: Infinity,
+    max_size: 0,
+    expires: Infinity,
+    include: null,
+    exclude: null
+};
 const REGEXP_TORRENT = /^(?:magnet:\?xt=|(?:https?|s?ftp):\/\/[^/][^\n]*?\.(?:torrent|metalink|meta4)(?:\?[^\n]*)?$)/i;
 let LOG_NEWLINE = true;
 let LOG_EMPTYLINE = false;
@@ -302,14 +312,35 @@ function tryRemoveDir(value, empty, recursive) {
     }
     return failed;
 }
+function tryIncrementDir(value, increment) {
+    const baseDir = trimDir(value);
+    let i = 0, outErr;
+    do {
+        try {
+            if (tryCreateDir(value)) {
+                return [value, i];
+            }
+        }
+        catch (err) {
+            if (increment === 0) {
+                outErr = err;
+            }
+        }
+        value = baseDir + '_' + ++i;
+    } while (increment-- > 0);
+    return [outErr, -1];
+}
 function errorObject(message) {
+    if (message instanceof Error) {
+        return message;
+    }
     switch (typeof message) {
         case 'string':
             return new Error(message);
         case 'number':
             return (0, types_1.errorMessage)("Error code" /* ERR_MESSAGE.ERROR_CODE */, message.toString());
         default:
-            return message instanceof Error ? message : new Error(Module.asString(message) || "Unknown" /* ERR_MESSAGE.UNKNOWN */);
+            return new Error(Module.asString(message) || "Unknown" /* ERR_MESSAGE.UNKNOWN */);
     }
 }
 function isFailed(options) {
@@ -321,17 +352,44 @@ function isFailed(options) {
     }
     return false;
 }
+function recurseCause(err, out, visited) {
+    let message;
+    if (visited) {
+        message = SETTINGS.stack_trace && err.stack || err.message;
+    }
+    else {
+        visited = new WeakSet();
+    }
+    visited.add(err);
+    if (err.hasOwnProperty('cause')) { // eslint-disable-line no-prototype-builtins
+        const cause = err.cause;
+        if (cause instanceof Error) {
+            if (message) {
+                out.push(message);
+            }
+            if (!visited.has(cause)) {
+                recurseCause(cause, out, visited);
+            }
+            return;
+        }
+        if ((0, types_1.isString)(cause)) {
+            message = message ? message + ` (${cause})` : cause; // eslint-disable-line @typescript-eslint/restrict-template-expressions
+        }
+    }
+    if (message) {
+        out.push(message);
+    }
+}
 function getErrorMessage(err) {
-    return SETTINGS.stack_trace && err.stack || err.message || err.toString() || "Unknown" /* ERR_MESSAGE.UNKNOWN */;
+    const cause = [];
+    recurseCause(err, cause);
+    return (SETTINGS.stack_trace && err.stack || err.message || err.toString() || "Unknown" /* ERR_MESSAGE.UNKNOWN */) + (cause.length ? cause.map((value, index) => `\n\nCause #${cause.length - index}: ` + value).join('') : '');
 }
 function writeLine(value) {
     PROCESS_STDOUT.write((!LOG_NEWLINE ? '\n' : '') + value + '\n');
     LOG_NEWLINE = true;
     LOG_EMPTYLINE = false;
 }
-function errorPermission(value) {
-    return (0, types_1.errorValue)("Unsupported access" /* ERR_MESSAGE.UNSUPPORTED_ACCESS */, value);
-}
 function parseFileArgs(options = {}, callback) {
     let promises;
     if (typeof options === 'boolean') {
@@ -378,16 +436,40 @@ function getTimeStamp(options, include) {
 }
 function getCacheItem(map, key) {
     const item = map.get(key);
-    if (item) {
-        item[0] = Date.now();
-        return item[1];
+    if (!item) {
+        return;
     }
+    const current = Date.now();
+    if (item[0] + MEMORY_CACHE_DISK.expires >= current) {
+        --CACHE_TOTAL;
+        map.delete(key);
+        return;
+    }
+    item[0] = current;
+    return item[1];
 }
-function addCacheItem(map, key, data) {
-    if (!map.has(key)) {
-        ++CACHE_TOTAL;
+function addCacheItem(map, key, data, cache) {
+    const length = Buffer.byteLength(data);
+    if (length < MEMORY_CACHE_DISK.min_size || length > MEMORY_CACHE_DISK.max_size) {
+        return;
+    }
+    key = Module.toPosix(key, true);
+    if (!cache) {
+        if (MEMORY_CACHE_DISK.include) {
+            if (!MEMORY_CACHE_DISK.include.some(value => pm.isMatch(key, value, { nocase: PLATFORM_WIN32, matchBase: value.startsWith('*') }))) {
+                return;
+            }
+        }
+        else {
+            cache = true;
+        }
+    }
+    if (!(cache && MEMORY_CACHE_DISK.exclude?.some(value => pm.isMatch(key, value, { nocase: PLATFORM_WIN32, matchBase: value.startsWith('*') })))) {
+        if (!map.has(key)) {
+            ++CACHE_TOTAL;
+        }
+        map.set(key, [Date.now(), data]);
     }
-    map.set(key, [Date.now(), data]);
 }
 function checkFunction(value) {
     if (typeof value === 'function') {
@@ -399,9 +481,7 @@ function checkFunction(value) {
 function encryptMessage(data, cipher, algorithm) {
     var _h;
     if (cipher?.key && cipher.iv) {
-        if (!algorithm) {
-            algorithm = cipher.algorithm || 'aes-256-gcm';
-        }
+        algorithm || (algorithm = cipher.algorithm || 'aes-256-gcm');
         const result = (0, types_1.encryptUTF8)(algorithm, cipher.key, cipher.iv, data);
         if (result) {
             VALUES[_h = "process.cipher.algorithm" /* KEY_NAME.PROCESS_CIPHER_ALGORITHM */] || (VALUES[_h] = algorithm);
@@ -475,9 +555,7 @@ function hasFileSystem(type, value, options, ignoreExists, overwrite) {
     return result;
 }
 function applyLogId(options) {
-    if (options.sessionId === undefined) {
-        options.sessionId = this.sessionId;
-    }
+    options.sessionId ?? (options.sessionId = this.sessionId);
     let value = options.broadcastId;
     if (value === undefined) {
         if (value = this.broadcastId) {
@@ -507,35 +585,20 @@ function formatPercent(value, precision = 3) {
     }
     return (value * 100).toPrecision(precision) + '%';
 }
-function tryIncrementDir(value, increment) {
-    const baseDir = trimDir(value);
-    let i = 0, outErr;
-    do {
-        try {
-            if (tryCreateDir(value)) {
-                return [value, i];
-            }
-        }
-        catch (err) {
-            if (increment === 0) {
-                outErr = err;
-            }
-        }
-        value = baseDir + '_' + ++i;
-    } while (increment-- > 0);
-    return [outErr, -1];
-}
+const hideAbort = (err) => err.name === 'AbortError' && SETTINGS.abort === false;
 const asFile = (value) => value instanceof URL ? value.protocol === 'file:' ? url.fileURLToPath(value) : '' : value;
 const wrapQuote = (value) => '"' + value.replace(/"/g, '\\"') + '"';
 const isFunction = (value) => typeof value === 'function';
 const isFileURL = (value) => /^file:\/\//i.test(value);
-const errorDirectory = (value) => (0, types_1.errorValue)("Path is not a directory" /* ERR_MESSAGE.NOT_DIRECTORY */, value);
 const sanitizePath = (value) => (0, types_1.isString)(value) ? path.resolve(value.trim()) : '';
-const ensureDir = (value) => value[value.length - 1] !== path.sep ? value + path.sep : value;
-const trimDir = (value) => value[value.length - 1] === path.sep ? value.substring(0, value.length - 1) : value;
+const ensureDir = (value) => value.endsWith(path.sep) ? value : value + path.sep;
+const trimDir = (value) => value.endsWith(path.sep) ? value.substring(0, value.length - 1) : value;
 const getExtension = (value) => path.extname(value).toLowerCase().substring(1);
 const hasString = (item, value) => (0, types_1.isString)(value) && (item === value || Array.isArray(item) && item.includes(value));
 const getCpuTimes = () => os.cpus().reduce((a, b) => a + b.times.user + b.times.sys, 0) * 1000 /* TIME.S */;
+const autoMemoryCache = () => MEMORY_CACHE_DISK.enabled && MEMORY_CACHE_DISK.max_size > 0;
+const errorDirectory = (value) => (0, types_1.errorValue)("Path is not a directory" /* ERR_MESSAGE.NOT_DIRECTORY */, value);
+const errorPermission = (value) => (0, types_1.errorValue)("Unsupported access" /* ERR_MESSAGE.UNSUPPORTED_ACCESS */, value);
 class Module extends EventEmitter {
     constructor() {
         super(...arguments);
@@ -558,7 +621,7 @@ class Module extends EventEmitter {
         this[_f] = new AbortController();
         this[_g] = null;
     }
-    static get VERSION() { return "0.7.1" /* INTERNAL.VERSION */; }
+    static get VERSION() { return "0.8.1" /* INTERNAL.VERSION */; }
     static get LOG_TYPE() { return types_1.LOG_TYPE; }
     static get STATUS_TYPE() { return types_1.STATUS_TYPE; }
     static get MAX_TIMEOUT() { return 2147483647; }
@@ -586,6 +649,8 @@ class Module extends EventEmitter {
             }
             case "temp.dir" /* KEY_NAME.TEMP_DIR */:
                 return VALUES[key] !== "tmp" /* INTERNAL.TEMP_DIR */;
+            case "memory.settings.cache_disk" /* KEY_NAME.MEMORY_SETTINGS_CACHE_DISK */:
+                return MEMORY_CACHE_DISK.enabled;
             case "node.require.npm" /* KEY_NAME.NODE_REQUIRE_NPM */:
             case "node.require.inline" /* KEY_NAME.NODE_REQUIRE_INLINE */:
             case "node.process.cpu_usage" /* KEY_NAME.NODE_PROCESS_CPUUSAGE */:
@@ -637,6 +702,10 @@ class Module extends EventEmitter {
         return true;
     }
     static formatMessage(type, title, value, message, options = {}) {
+        const error = !!message && message instanceof Error;
+        if (error && hideAbort(message)) {
+            return;
+        }
         if (options.type) {
             type |= options.type;
         }
@@ -675,14 +744,13 @@ class Module extends EventEmitter {
         const formatValue = format.value;
         const id = sessionId && SETTINGS.session_id ? ' ' + sessionId.padStart(SETTINGS.session_id, '0') + ' ' : '';
         const titleIndent = options.titleIndent ? typeof options.titleIndent === 'number' ? Math.max(options.titleIndent, 0) : 0 : -1;
-        let output, error, hint, valueWidth = Math.max(formatValue.width - (id ? SETTINGS.session_id + 1 : 0), 1), titleJustify = options.titleJustify || ((type & 512 /* LOG_VALUE.FAIL */) || options.failed ? 'center' : formatTitle.justify);
+        let output, hint, valueWidth = Math.max(formatValue.width - (id ? SETTINGS.session_id + 1 : 0), 1), titleJustify = options.titleJustify || ((type & 512 /* LOG_VALUE.FAIL */) || options.failed ? 'center' : formatTitle.justify);
         if (Array.isArray(value)) {
             hint = value[1] ?? '';
             value = value[0];
         }
-        if (message && message instanceof Error) {
+        if (error) {
             message = getErrorMessage(message);
-            error = true;
         }
         if (messageUnitIndent) {
             let indentChar;
@@ -724,7 +792,7 @@ class Module extends EventEmitter {
                         indent = match[1];
                         if (bgAltColor) {
                             try {
-                                indent = (bgAltColor[0] === '#' ? chalk.bgHex(bgAltColor) : chalk[bgAltColor])(indent);
+                                indent = (bgAltColor.startsWith('#') ? chalk.bgHex(bgAltColor) : chalk[bgAltColor])(indent);
                             }
                             catch {
                             }
@@ -747,10 +815,10 @@ class Module extends EventEmitter {
                 try {
                     let current = bold ? chalk.bold : chalk;
                     if (typeof color === 'string' && color.length > 1) {
-                        current = color[0] === '#' ? current.hex(color) : current[color];
+                        current = color.startsWith('#') ? current.hex(color) : current[color];
                     }
                     if (typeof bgColor === 'string' && bgColor.length > 1) {
-                        current = bgColor[0] === '#' ? current.bgHex(bgColor) : current[bgColor];
+                        current = bgColor.startsWith('#') ? current.bgHex(bgColor) : current[bgColor];
                     }
                     return indent + current(content);
                 }
@@ -1110,11 +1178,15 @@ class Module extends EventEmitter {
         }
     }
     static async readHash(value, options = {}) {
-        const { algorithm = "sha256" /* HASH_OUTPUT.ALGORITHM */, digest = "hex" /* HASH_OUTPUT.DIGEST */, minStreamSize = 0, chunkSize = 2097152000 /* HASH_OUTPUT.CHUNK_SIZE */ } = options;
-        const hash = crypto.createHash(algorithm);
+        const { algorithm, digest, chunkSize = 2097152000 /* HASH_OUTPUT.CHUNK_SIZE */ } = options;
+        const hash = crypto.createHash(algorithm || "sha256" /* HASH_OUTPUT.ALGORITHM */);
         try {
+            let minStreamSize = options.minStreamSize || 0;
+            if ((0, types_1.isString)(minStreamSize)) {
+                minStreamSize = (0, types_1.formatSize)(minStreamSize);
+            }
             if (fs.statSync(value).size <= Math.min(minStreamSize > 0 ? minStreamSize : Infinity, 2097152000 /* HASH_OUTPUT.CHUNK_SIZE */)) {
-                return hash.update(fs.readFileSync(value)).digest(digest);
+                return hash.update(fs.readFileSync(value)).digest(digest || "hex" /* HASH_OUTPUT.DIGEST */);
             }
         }
         catch (err) {
@@ -1122,7 +1194,7 @@ class Module extends EventEmitter {
                 throw err;
             }
         }
-        const readable = fs.createReadStream(value);
+        const readable = fs.createReadStream(value, { signal: options.signal });
         const chunks = [];
         let length = 0;
         for await (const chunk of readable) {
@@ -1138,7 +1210,7 @@ class Module extends EventEmitter {
         if (chunks.length) {
             hash.update(Buffer.concat(chunks));
         }
-        return hash.digest(digest);
+        return hash.digest(digest || "hex" /* HASH_OUTPUT.DIGEST */);
     }
     static toPosix(value, filename, normalize) {
         if (typeof filename === 'boolean') {
@@ -1291,7 +1363,7 @@ class Module extends EventEmitter {
         let result = paths[0] || '';
         for (let i = 1; i < paths.length; ++i) {
             const trailing = paths[i];
-            result += (trailing[0] !== '/' && result[result.length - 1] !== '/' ? '/' : '') + trailing;
+            result += (!trailing.startsWith('/') && !result.endsWith('/') ? '/' : '') + trailing;
         }
         return result;
     }
@@ -1383,7 +1455,7 @@ class Module extends EventEmitter {
         }
         return false;
     }
-    static copyDir(src, dest, move, recursive = true) {
+    static async copyDir(src, dest, move, recursive = true) {
         const srcOut = sanitizePath(asFile(src));
         if (!srcOut || !this.isDir(srcOut)) {
             return Promise.reject(errorDirectory(asFile(src) || "Unknown" /* ERR_MESSAGE.UNKNOWN */));
@@ -1539,21 +1611,64 @@ class Module extends EventEmitter {
         }
         return false;
     }
+    static async streamFile(src, cache, options) {
+        if ((0, types_1.isObject)(cache)) {
+            options = cache;
+        }
+        let minStreamSize = 0, encoding, signal;
+        if (options) {
+            ({ minStreamSize = 0, encoding, signal, cache } = options);
+        }
+        return new Promise(async (resolve) => {
+            if ((0, types_1.isString)(minStreamSize)) {
+                minStreamSize = (0, types_1.formatSize)(minStreamSize);
+            }
+            const fileSize = fs.statSync(src).size;
+            let data;
+            if (fileSize >= minStreamSize || fileSize >= 2097152000 /* HASH_OUTPUT.CHUNK_SIZE */) {
+                const readable = fs.createReadStream(src, { signal });
+                const chunks = [];
+                for await (const chunk of readable) {
+                    chunks.push(Buffer.from(chunk));
+                }
+                data = Buffer.concat(chunks);
+                if (encoding) {
+                    data = data.toString(encoding);
+                }
+            }
+            else {
+                data = fs.readFileSync(src, encoding);
+            }
+            if (cache || cache !== false && autoMemoryCache()) {
+                addCacheItem(encoding ? CACHE_READTEXT : CACHE_READBUFFER, src, data, cache);
+            }
+            resolve(data);
+        });
+    }
     static readText(value, encoding, cache) {
+        let minStreamSize, options;
         if (typeof encoding === 'boolean') {
             cache = encoding;
             encoding = undefined;
         }
+        else if ((0, types_1.isObject)(encoding)) {
+            options = encoding;
+            ({ minStreamSize, encoding, cache } = options);
+        }
         const src = sanitizePath(asFile(value));
         if (src && this.isPath(src, true)) {
             let result;
             if (cache && (result = getCacheItem(CACHE_READTEXT, src))) {
-                return result;
+                return (minStreamSize !== undefined ? Promise.resolve(result) : result);
+            }
+            encoding = (0, types_1.getEncoding)(encoding);
+            if (minStreamSize !== undefined) {
+                return this.streamFile(src, options);
             }
             try {
-                result = fs.readFileSync(value, (0, types_1.getEncoding)(encoding));
-                if (cache && result) {
-                    addCacheItem(CACHE_READTEXT, src, result);
+                result = fs.readFileSync(value, encoding);
+                if (result && (cache || cache !== false && autoMemoryCache())) {
+                    addCacheItem(CACHE_READTEXT, src, result, cache);
                 }
                 return result;
             }
@@ -1561,19 +1676,27 @@ class Module extends EventEmitter {
                 this.writeFail(["Unable to read file" /* ERR_MESSAGE.READ_FILE */, path.basename(src)], err, 32 /* LOG_VALUE.FILE */);
             }
         }
-        return '';
+        return (minStreamSize !== undefined ? Promise.resolve('') : '');
     }
     static readBuffer(value, cache) {
+        let minStreamSize, options;
+        if ((0, types_1.isObject)(cache)) {
+            options = cache;
+            ({ minStreamSize, cache } = options);
+        }
         const src = sanitizePath(asFile(value));
         if (src && this.isPath(src, true)) {
             let result;
             if (cache && (result = getCacheItem(CACHE_READBUFFER, src))) {
-                return result;
+                return (minStreamSize !== undefined ? Promise.resolve(result) : result);
+            }
+            if (minStreamSize !== undefined) {
+                return this.streamFile(src, options);
             }
             try {
                 result = fs.readFileSync(value);
-                if (cache && result) {
-                    addCacheItem(CACHE_READBUFFER, src, result);
+                if (result && (cache || cache !== false && autoMemoryCache())) {
+                    addCacheItem(CACHE_READBUFFER, src, result, cache);
                 }
                 return result;
             }
@@ -1581,9 +1704,9 @@ class Module extends EventEmitter {
                 this.writeFail(["Unable to read file" /* ERR_MESSAGE.READ_FILE */, path.basename(src)], err, 32 /* LOG_VALUE.FILE */);
             }
         }
-        return null;
+        return (minStreamSize !== undefined ? Promise.resolve(null) : null);
     }
-    static resolveMime(data) {
+    static async resolveMime(data) {
         return typeof data === 'string' ? filetype.fromFile(data) : filetype.fromBuffer(data);
     }
     static lookupMime(value, extension) {
@@ -1869,7 +1992,7 @@ class Module extends EventEmitter {
         return true;
     }
     static sanitizeCmd(value) {
-        if (value.indexOf(' ') !== -1) {
+        if (value.includes(' ')) {
             return PLATFORM_WIN32 ? wrapQuote(value) : value.replace(/[ ]/g, '\\ ');
         }
         return value;
@@ -1900,7 +2023,7 @@ class Module extends EventEmitter {
                             }
                             value = quoted[2];
                         }
-                        if (value.indexOf(' ') !== -1) {
+                        if (value.includes(' ')) {
                             value = wrapQuote(value);
                         }
                     }
@@ -1935,7 +2058,7 @@ class Module extends EventEmitter {
         }
         return (typeof values === 'string' ? result[0] : result);
     }
-    static purgeMemory(percent = 1, limit = 0) {
+    static async purgeMemory(percent = 1, limit = 0) {
         if (typeof limit === 'boolean') {
             limit = 0;
         }
@@ -1954,9 +2077,15 @@ class Module extends EventEmitter {
             }
             else if (percent > 0) {
                 const stored = [];
+                const current = Date.now();
                 for (const map of [CACHE_READTEXT, CACHE_READBUFFER, CACHE_READCJS]) {
                     for (const [key, value] of map) {
-                        stored.push([map, key, value[0]]);
+                        if (value[0] + MEMORY_CACHE_DISK.expires >= current) {
+                            map.delete(key);
+                        }
+                        else {
+                            stored.push([map, key, value[0]]);
+                        }
                     }
                 }
                 stored.sort((a, b) => a[2] - b[2]);
@@ -1968,7 +2097,7 @@ class Module extends EventEmitter {
                 CACHE_TOTAL = stored.length - result;
             }
         }
-        return Promise.resolve(result);
+        return result;
     }
     static canWrite(name) {
         switch (name) {
@@ -2046,11 +2175,44 @@ class Module extends EventEmitter {
                 VALUES[_h = "process.password" /* KEY_NAME.PROCESS_PASSWORD */] || (VALUES[_h] = encryptMessage(pwd, cipher));
             }
         }
-        if (memory && (0, types_1.isPlainObject)(memory.settings)) {
-            const users = memory.settings.users;
+        if ((0, types_1.isPlainObject)(memory?.settings)) {
+            const { users, cache_disk } = memory.settings;
             if (typeof users === 'boolean' || Array.isArray(users)) {
                 VALUES["memory.settings.users" /* KEY_NAME.MEMORY_SETTINGS_USERS */] = users;
             }
+            if ((0, types_1.isPlainObject)(cache_disk)) {
+                let { enabled, min_size, max_size, expires, include, exclude } = cache_disk;
+                MEMORY_CACHE_DISK.enabled = enabled === true;
+                if (min_size !== undefined) {
+                    if ((0, types_1.isString)(min_size)) {
+                        min_size = (0, types_1.formatSize)(min_size);
+                    }
+                    else if (min_size > 0) {
+                        min_size *= 1024;
+                    }
+                    MEMORY_CACHE_DISK.min_size = min_size > 0 ? min_size : Infinity;
+                }
+                if (max_size !== undefined) {
+                    if ((0, types_1.isString)(max_size)) {
+                        max_size = (0, types_1.formatSize)(max_size);
+                    }
+                    else if (max_size > 0) {
+                        max_size *= 1024;
+                    }
+                    MEMORY_CACHE_DISK.max_size = max_size > 0 ? max_size : 0;
+                }
+                if (expires !== undefined && (expires = (0, types_1.parseExpires)(expires)) > 0) {
+                    MEMORY_CACHE_DISK.expires = expires;
+                }
+                MEMORY_CACHE_DISK.include = null;
+                MEMORY_CACHE_DISK.exclude = null;
+                if ((0, types_1.isArray)(include)) {
+                    MEMORY_CACHE_DISK.include = include.map(value => this.toPosix(value, true));
+                }
+                else if ((0, types_1.isArray)(exclude)) {
+                    MEMORY_CACHE_DISK.exclude = exclude.map(value => this.toPosix(value, true));
+                }
+            }
         }
         if ((0, types_1.isPlainObject)(logger)) {
             const { enabled, level, production, broadcast, stack_trace } = logger;
@@ -2176,11 +2338,13 @@ class Module extends EventEmitter {
                         }
                         break;
                     }
-                    default:
-                        if (attr in SETTINGS) {
-                            SETTINGS[attr] = logger[attr];
+                    default: {
+                        const value = logger[attr];
+                        if (attr in SETTINGS && value !== undefined) {
+                            SETTINGS[attr] = value;
                         }
                         break;
+                    }
                 }
             }
             if (broadcast?.out) {
@@ -2190,7 +2354,7 @@ class Module extends EventEmitter {
                 Error.stackTraceLimit = +stack_trace;
             }
         }
-        if (error) {
+        if ((0, types_1.isPlainObject)(error)) {
             if (error.out) {
                 VALUES["error.out" /* KEY_NAME.ERROR_OUT */] = this.parseFunction(error.out, { external: true, absolute: true });
             }
@@ -2198,7 +2362,7 @@ class Module extends EventEmitter {
                 VALUES["error.fatal" /* KEY_NAME.ERROR_FATAL */] = error.fatal;
             }
         }
-        if (permission && Array.isArray(permission.process_exec)) {
+        if (Array.isArray(permission?.process_exec)) {
             VALUES["permission.process_exec" /* KEY_NAME.PERMISSION_PROCESS_EXEC */] = permission.process_exec.filter(item => typeof item === 'string' || (0, types_1.isObject)(item) && typeof item.command === 'string').map(exec => {
                 if (typeof exec === 'string') {
                     return exec.trim();
@@ -2211,12 +2375,11 @@ class Module extends EventEmitter {
             });
         }
         {
-            let dir = settings.temp_dir, write;
+            let dir = settings.temp_dir, write, modified;
             if ((0, types_1.isPlainObject)(temp)) {
                 dir || (dir = temp.dir);
                 write = temp.write;
             }
-            let modified;
             if ((0, types_1.isString)(dir) && path.isAbsolute(dir = path.normalize(dir).replace(/[\\/]$/, ''))) {
                 if (withinDir(dir, PROCESS_CWD)) {
                     dir = dir.substring(ensureDir(PROCESS_CWD).length);
@@ -2311,7 +2474,7 @@ class Module extends EventEmitter {
             result = output;
         }
         if (filename) {
-            const trailing = (filename[0] === '.' ? (0, types_1.generateUUID)() : '') + filename;
+            const trailing = (filename.startsWith('.') ? (0, types_1.generateUUID)() : '') + filename;
             if (result) {
                 return path.join(result, trailing);
             }
@@ -2365,12 +2528,12 @@ class Module extends EventEmitter {
         let promises, outSrc;
         [options, promises, callback] = parseFileArgs(options, callback);
         if (outSrc = hasFileSystem.call(this, 0 /* FILE_SYSTEM.READ */, src, options)) {
-            const { requireExt, cache } = options;
+            let { requireExt, minStreamSize, cache } = options;
             const encoding = options.encoding && (0, types_1.getEncoding)(options.encoding);
             const setCache = (data, cjs) => {
                 if (data) {
-                    if (cache) {
-                        addCacheItem(cjs ? CACHE_READCJS : encoding ? CACHE_READTEXT : CACHE_READBUFFER, outSrc, data);
+                    if (cache || cache !== false && autoMemoryCache()) {
+                        addCacheItem(cjs ? CACHE_READCJS : encoding ? CACHE_READTEXT : CACHE_READBUFFER, outSrc, data, cache);
                     }
                     this.emit('file:read', outSrc, data, options);
                 }
@@ -2393,6 +2556,31 @@ class Module extends EventEmitter {
             if (cache) {
                 result || (result = (encoding ? getCacheItem(CACHE_READTEXT, outSrc) : getCacheItem(CACHE_READBUFFER, outSrc)));
             }
+            try {
+                if ((0, types_1.isString)(minStreamSize)) {
+                    minStreamSize = (0, types_1.formatSize)(minStreamSize);
+                }
+                if (typeof minStreamSize === 'number' || promises && fs.statSync(outSrc).size >= 2097152000 /* HASH_OUTPUT.CHUNK_SIZE */) {
+                    if (result) {
+                        return Promise.resolve(result);
+                    }
+                    if (promises || fs.statSync(outSrc).size >= Math.min(minStreamSize || Infinity, 2097152000 /* HASH_OUTPUT.CHUNK_SIZE */)) {
+                        return new Promise(async (resolve) => {
+                            const readable = fs.createReadStream(outSrc, { signal: this.signal });
+                            const chunks = [];
+                            for await (const chunk of readable) {
+                                chunks.push(Buffer.from(chunk));
+                            }
+                            const data = Buffer.concat(chunks);
+                            resolve((encoding ? data.toString(encoding) : data));
+                        });
+                    }
+                    promises = true;
+                }
+            }
+            catch {
+                promises = true;
+            }
             if (promises) {
                 if (result) {
                     return Promise.resolve(result);
@@ -2783,7 +2971,7 @@ class Module extends EventEmitter {
         }
         return false;
     }
-    allSettled(tasks, rejected, options) {
+    async allSettled(tasks, rejected, options) {
         rejected || (rejected = "Unknown" /* ERR_MESSAGE.UNKNOWN */);
         return Promise.allSettled(tasks).then(result => {
             const items = [];
@@ -3004,7 +3192,7 @@ class Module extends EventEmitter {
             }
         }
         if (message) {
-            if (this._logEnabled) {
+            if (this._logEnabled && !(message instanceof Error && hideAbort(message))) {
                 if (fatal) {
                     const timeStamp = Date.now();
                     this.addLog(types_1.STATUS_TYPE.FATAL, message, timeStamp, options.startTime && getTimeOffset(options.startTime, timeStamp));
@@ -3221,9 +3409,9 @@ class Module extends EventEmitter {
         }
         this._host = null;
     }
-    abort() {
+    abort(reason) {
         if (!this.aborted) {
-            this[kAbortHandler].abort();
+            this[kAbortHandler].abort(reason);
         }
     }
     willAbort(value) {
@@ -3250,14 +3438,14 @@ class Module extends EventEmitter {
         const aborting = this._hostEvents.includes('abort');
         if (value.aborted) {
             if (aborting) {
-                this.abort();
+                this.abort(new Error("Aborted by host" /* ERR_MESSAGE.ABORTED_HOST */));
             }
         }
         else if (!value.subProcesses.has(this)) {
             this.abortable = value.willAbort(this);
             value.modules.add(this);
             if (aborting) {
-                value.signal.addEventListener('abort', this[kAbortEvent] = () => this.abort(), { once: true });
+                value.signal.addEventListener('abort', this[kAbortEvent] = () => this.abort(new Error("Aborted by host" /* ERR_MESSAGE.ABORTED_HOST */)), { once: true });
             }
         }
     }

package/lib-v4.js

@@ -97,7 +97,7 @@ function isPathUNC(value) {
     return index_1.default.isPath(value, 'unc');
 }
 exports.isPathUNC = isPathUNC;
-function readFileSafe(value, encoding, cache) {
+async function readFileSafe(value, encoding, cache) {
     return encoding === 'buffer' ? index_1.default.readBuffer(value, cache) : index_1.default.readText(value, encoding, cache);
 }
 exports.readFileSafe = readFileSafe;
@@ -135,7 +135,7 @@ function getFunctions(values, absolute, sync = true, outFailed) {
     return result;
 }
 exports.getFunctions = getFunctions;
-function allSettled(tasks, rejected, options) {
+async function allSettled(tasks, rejected, options) {
     if (rejected) {
         return Promise.allSettled(tasks).then(result => {
             const items = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@e-mc/module",
-  "version": "0.7.1",
+  "version": "0.8.1",
   "description": "Module base class for E-mc.",
   "main": "index.js",
   "types": "index.d.ts",
@@ -20,12 +20,13 @@
   "license": "BSD 3-Clause",
   "homepage": "https://github.com/anpham6/e-mc#readme",
   "dependencies": {
-    "@e-mc/types": "0.7.1",
+    "@e-mc/types": "0.8.1",
     "abort-controller": "^3.0.0",
     "chalk": "4.1.2",
     "event-target-shim": "^5.0.1",
     "file-type": "16.5.4",
     "mime-types": "^2.1.35",
+    "picomatch": "^3.0.1",
     "strip-ansi": "6.0.1"
   }
 }