@e-mc/module 0.8.11 → 0.8.13

package/LICENSE

@@ -1,7 +1,7 @@
-Copyright 2024 An Pham
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-
+Copyright 2024 An Pham
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,242 +1,242 @@
-# @e-mc/module
-
-* NodeJS 14
-* ES2019
-
-## General Usage
-
-* [Read the Docs](https://e-mc.readthedocs.io)
-
-## Interface
-
-- https://www.unpkg.com/@e-mc/types@0.8.11/lib/index.d.ts
-
-```typescript
-import type { LogStatus } from "./squared";
-
-import type { IHost } from "./index";
-import type { IAbortComponent, IPermission } from "./core";
-import type { LOG_TYPE, STATUS_TYPE, ExecCommand, LogArguments, LogComponent, LogDate, LogFailOptions, LogMessageOptions, LogOptions, LogProcessOptions, LogTime, LogType, LogValue, StatusType } from "./logger";
-import type { AsHashOptions, CheckSemVerOptions, CopyDirOptions, CopyDirResult, CopyFileOptions, CreateDirOptions, DeleteFileOptions, GetTempDirOptions, MoveFileOptions, NormalizeFlags, ParseFunctionOptions, PermissionOptions, ProtocolType, ReadBufferOptions, ReadFileCallback, ReadFileOptions, ReadHashOptions, ReadTextOptions, RemoveDirOptions, WriteFileOptions } from "./module";
-import type { Settings } from "./node";
-
-import type { SpawnOptions } from "child_process";
-import type { BinaryLike } from "crypto";
-import type { FileTypeResult } from "file-type";
-import type { NoParamCallback } from "fs";
-
-import type * as EventEmitter from "events";
-
-type BufferView = Buffer | string | NodeJS.ArrayBufferView;
-type CpuUsage = NodeJS.CpuUsage;
-
-interface IModule extends EventEmitter, IAbortComponent {
-    readonly status: LogStatus<StatusType>[];
-    readonly errors: unknown[];
-    supported(major: number, minor?: number, patch?: number, lts?: boolean): boolean;
-    supports(name: string, value?: boolean): boolean;
-    getTempDir(options: GetTempDirOptions): string;
-    getTempDir(uuidDir: boolean, createDir?: boolean): string;
-    getTempDir(pathname: string, createDir?: boolean): string;
-    getTempDir(uuidDir: boolean, filename: string, createDir?: boolean): string;
-    getTempDir(pathname?: string, filename?: string, createDir?: boolean): string;
-    canRead(uri: string, options?: PermissionOptions): boolean;
-    canWrite(uri: string, options?: PermissionOptions): boolean;
-    readFile(src: string): Buffer | undefined;
-    readFile(src: string, options?: ReadFileOptions): Promise<Buffer | string> | Buffer | string | undefined;
-    readFile(src: string, promises: true): Promise<Buffer | undefined>;
-    readFile(src: string, options: ReadFileOptions, promises: true): Promise<Buffer | string | undefined>;
-    readFile(src: string, callback: ReadFileCallback<Buffer>): Buffer | undefined;
-    readFile(src: string, options: ReadFileOptions, callback: ReadFileCallback<Buffer | string>): Buffer | string | undefined;
-    writeFile(src: string, data: BufferView, options?: WriteFileOptions): boolean;
-    writeFile(src: string, data: BufferView, promises: true): Promise<boolean>;
-    writeFile(src: string, data: BufferView, options: WriteFileOptions, promises: true): Promise<boolean>;
-    writeFile(src: string, data: BufferView, callback: NoParamCallback): void;
-    writeFile(src: string, data: BufferView, options: WriteFileOptions, callback: NoParamCallback): void;
-    deleteFile(src: string, options?: DeleteFileOptions): boolean;
-    deleteFile(src: string, promises: true): Promise<boolean>;
-    deleteFile(src: string, options: DeleteFileOptions, promises: true): Promise<boolean>;
-    deleteFile(src: string, callback: NoParamCallback): void;
-    deleteFile(src: string, options: DeleteFileOptions, callback: NoParamCallback): void;
-    copyFile(src: string, dest: string, options?: CopyFileOptions): boolean;
-    copyFile(src: string, dest: string, promises: true): Promise<boolean>;
-    copyFile(src: string, dest: string, options: CopyFileOptions, promises: true): Promise<boolean>;
-    copyFile(src: string, dest: string, callback: NoParamCallback): void;
-    copyFile(src: string, dest: string, options: CopyFileOptions, callback: NoParamCallback): void;
-    moveFile(src: string, dest: string, options?: MoveFileOptions): boolean;
-    moveFile(src: string, dest: string, promises: true): Promise<boolean>;
-    moveFile(src: string, dest: string, options: MoveFileOptions, promises: true): Promise<boolean>;
-    moveFile(src: string, dest: string, callback: NoParamCallback): void;
-    moveFile(src: string, dest: string, options: MoveFileOptions, callback: NoParamCallback): void;
-    createDir(src: string, options?: CreateDirOptions): boolean;
-    createDir(src: string, promises: true): Promise<boolean>;
-    createDir(src: string, options: CreateDirOptions, promises: true): Promise<boolean>;
-    createDir(src: string, callback: NoParamCallback): void;
-    createDir(src: string, options: CreateDirOptions, callback: NoParamCallback): void;
-    removeDir(src: string, options?: RemoveDirOptions): boolean;
-    removeDir(src: string, promises: true): Promise<boolean>;
-    removeDir(src: string, options: RemoveDirOptions, promises: true): Promise<boolean>;
-    removeDir(src: string, callback: NoParamCallback): void;
-    removeDir(src: string, options: RemoveDirOptions, callback: NoParamCallback): void;
-    allSettled(values: readonly PromiseLike<unknown>[], rejected?: LogValue, options?: LogFailOptions | LogType): Promise<PromiseFulfilledResult<unknown>[]>;
-    formatMessage(type: LogType, title: string, value: LogValue, message?: unknown, options?: LogMessageOptions): void;
-    formatFail(type: LogType, title: string, value: LogValue, message?: unknown, options?: LogFailOptions): void;
-    writeFail(value: LogValue, message?: unknown, options?: LogFailOptions | LogType): void;
-    writeTimeProcess(title: string, value: string, startTime: LogTime, options?: LogProcessOptions): void;
-    writeTimeElapsed(title: string, value: LogValue, startTime: LogTime, options?: LogMessageOptions): void;
-    checkPackage(err: unknown, name: string | undefined, options?: LogFailOptions | LogType): boolean;
-    checkPackage(err: unknown, name: string | undefined, value?: LogValue, options?: LogFailOptions | LogType): boolean;
-    checkFail(message: unknown, options: LogFailOptions): LogArguments | false | undefined;
-    writeLog(component: LogComponent, queue?: boolean): void;
-    writeLog(type: StatusType, value: unknown, options?: LogOptions): void;
-    writeLog(type: StatusType, value: unknown, timeStamp?: LogDate, duration?: number): void;
-    addLog(component: LogComponent, queue?: boolean): void;
-    addLog(type: StatusType, value: unknown, from: string, source?: string): void;
-    addLog(type: StatusType, value: unknown, options?: LogOptions): void;
-    addLog(type: StatusType, value: unknown, timeStamp?: LogDate, from?: string, source?: string): void;
-    addLog(type: StatusType, value: unknown, timeStamp?: LogDate, duration?: number, from?: string, source?: string): void;
-    getLog(...type: StatusType[]): LogStatus<StatusType>[];
-    flushLog(): void;
-    willAbort(value: unknown): boolean;
-    hasOwnPermission(): boolean;
-    isFatal(err?: unknown): boolean;
-    detach(): void;
-    reset(): void;
-    get moduleName(): string;
-    set host(value);
-    get host(): IHost | null;
-    set permission(value);
-    get permission(): IPermission | null;
-    get aborted(): boolean;
-    set abortable(value);
-    get abortable(): boolean;
-    get threadable(): boolean;
-    set sessionId(value);
-    get sessionId(): string;
-    set broadcastId(value);
-    get broadcastId(): string | string[];
-    get logType(): LOG_TYPE;
-    set logLevel(value: number | string);
-    get logLevel(): number;
-    get statusType(): STATUS_TYPE;
-    set tempDir(value);
-    get tempDir(): string;
-
-    /* EventEmitter */
-    on(event: "exec", listener: (command: ExecCommand, options?: SpawnOptions) => void): this;
-    on(event: "error", listener: (err: Error) => void): this;
-    on(event: "file:read", listener: (src: string, data: Buffer | string, options?: ReadFileOptions) => void): this;
-    on(event: "file:write", listener: (src: string, options?: WriteFileOptions) => void): this;
-    on(event: "file:delete", listener: (src: string, options?: DeleteFileOptions) => void): this;
-    on(event: "file:copy", listener: (dest: string, options?: CopyFileOptions) => void): this;
-    on(event: "file:move", listener: (dest: string, options?: MoveFileOptions) => void): this;
-    on(event: "dir:create", listener: (src: string, options?: CreateDirOptions) => void): this;
-    on(event: "dir:remove", listener: (src: string, options?: RemoveDirOptions) => void): this;
-    once(event: "exec", listener: (command: ExecCommand, options?: SpawnOptions) => void): this;
-    once(event: "error", listener: (err: Error) => void): this;
-    once(event: "file:read", listener: (src: string, data: Buffer | string, options?: ReadFileOptions) => void): this;
-    once(event: "file:write", listener: (src: string, options?: WriteFileOptions) => void): this;
-    once(event: "file:delete", listener: (src: string, options?: DeleteFileOptions) => void): this;
-    once(event: "file:copy", listener: (dest: string, options?: CopyFileOptions) => void): this;
-    once(event: "file:move", listener: (dest: string, options?: MoveFileOptions) => void): this;
-    once(event: "dir:create", listener: (src: string, options?: CreateDirOptions) => void): this;
-    once(event: "dir:remove", listener: (src: string, options?: RemoveDirOptions) => void): this;
-    emit(event: "exec", command: ExecCommand, options?: SpawnOptions): boolean;
-    emit(event: "error", err: Error): boolean;
-    emit(event: "file:read", src: string, data: Buffer | string, options?: ReadFileOptions): boolean;
-    emit(event: "file:write", src: string, options?: WriteFileOptions): boolean;
-    emit(event: "file:delete", src: string, options?: DeleteFileOptions): boolean;
-    emit(event: "file:copy", dest: string, options?: CopyFileOptions): boolean;
-    emit(event: "file:move", dest: string, options?: MoveFileOptions): boolean;
-    emit(event: "dir:create", src: string, options?: CreateDirOptions): boolean;
-    emit(event: "dir:remove", src: string, options?: RemoveDirOptions): boolean;
-}
-
-interface ModuleConstructor {
-    PROCESS_TIMEOUT: number;
-    LOG_STYLE_FAIL: LogMessageOptions;
-    LOG_STYLE_SUCCESS: LogMessageOptions;
-    LOG_STYLE_INFO: LogMessageOptions;
-    LOG_STYLE_WARN: LogMessageOptions;
-    LOG_STYLE_NOTICE: LogMessageOptions;
-    LOG_STYLE_REVERSE: LogMessageOptions;
-    readonly VERSION: string;
-    readonly LOG_TYPE: LOG_TYPE;
-    readonly STATUS_TYPE: STATUS_TYPE;
-    readonly MAX_TIMEOUT: number;
-    readonly TEMP_DIR: string;
-    supported(major: number, minor?: number, patch?: number, lts?: boolean): boolean;
-    formatMessage(type: LogType, title: string, value: LogValue, message?: unknown, options?: LogMessageOptions): void;
-    writeFail(value: LogValue, message?: unknown, options?: LogFailOptions | LogType): void;
-    enabled(key: string, username?: string): boolean;
-    parseFunction(value: unknown, options?: ParseFunctionOptions): ((...args: unknown[]) => Promise<unknown> | unknown) | null;
-    parseFunction(value: unknown, absolute: boolean, sync?: boolean): ((...args: unknown[]) => Promise<unknown> | unknown) | null;
-    asString(value: unknown, cacheKey?: boolean | "throws"): string;
-    asHash(data: BinaryLike, options: AsHashOptions): string;
-    asHash(data: BinaryLike, minLength: number): string;
-    asHash(data: BinaryLike, algorithm?: number | string | AsHashOptions, minLength?: number | AsHashOptions): string;
-    readHash(value: string | URL, options?: ReadHashOptions): Promise<string>;
-    toPosix(value: unknown, normalize: boolean): string;
-    toPosix(value: unknown, filename?: string, normalize?: boolean): string;
-    hasLogType(value: LogType): boolean;
-    isURL(value: string, ...exclude: string[]): boolean;
-    isFile(value: string | URL, type?: ProtocolType): boolean;
-    isDir(value: string | URL): boolean;
-    isPath(value: string | URL, type?: "unc" | "unc-exists"): boolean;
-    isPath(value: string | URL, isFile?: boolean): boolean;
-    isErrorCode(err: unknown, ...code: string[]): boolean;
-    fromLocalPath(value: string): string;
-    resolveFile(value: string): string;
-    resolvePath(value: string, base: string | URL): string;
-    joinPath(...values: [...paths: unknown[], normalize: boolean][]): string;
-    joinPath(...values: unknown[]): string;
-    normalizePath(value: unknown, flags?: boolean | NormalizeFlags): string;
-    createDir(value: string | URL, overwrite?: boolean): boolean;
-    removeDir(value: string | URL, sinceCreated: number, recursive?: boolean): boolean;
-    removeDir(value: string | URL, empty?: boolean, recursive?: boolean): boolean;
-    copyDir(src: string | URL, dest: string | URL, options: CopyDirOptions): Promise<CopyDirResult>;
-    copyDir(src: string | URL, dest: string | URL, move?: boolean, recursive?: boolean): Promise<CopyDirResult>;
-    renameFile(src: string | URL, dest: string | URL, throws?: boolean): boolean;
-    streamFile(src: string, cache: boolean): Promise<Buffer | string>;
-    streamFile(src: string, options: ReadBufferOptions): Promise<Buffer | string>;
-    streamFile(src: string, cache?: boolean | ReadBufferOptions, options?: ReadBufferOptions): Promise<Buffer | string>;
-    readText(value: string | URL, cache: boolean): string;
-    readText(value: string | URL, options: ReadTextOptions): Promise<string> | string;
-    readText(value: string | URL, encoding?: BufferEncoding | boolean | ReadTextOptions, cache?: boolean): string;
-    readBuffer(value: string | URL, options: ReadBufferOptions): Promise<Buffer | null> | Buffer | null;
-    readBuffer(value: string | URL, cache?: boolean): Buffer | null;
-    resolveMime(data: string | Buffer | Uint8Array | ArrayBuffer): Promise<FileTypeResult | undefined>;
-    lookupMime(value: string, extension?: boolean): string;
-    initCpuUsage(instance?: IModule): CpuUsage;
-    getCpuUsage(start: CpuUsage, format: true): string;
-    getCpuUsage(start: CpuUsage, format?: boolean): number;
-    getMemUsage(format: true): string;
-    getMemUsage(format?: boolean): number;
-    formatCpuMem(start: CpuUsage, all?: boolean): string;
-    getPackageVersion(name: string | [string, string], startDir: string, baseDir?: string): string;
-    getPackageVersion(name: string | [string, string], unstable?: boolean, startDir?: string, baseDir?: string): string;
-    checkSemVer(name: string | [string, string], options: CheckSemVerOptions): boolean;
-    checkSemVer(name: string | [string, string], min: number | string, max: number | string, options: CheckSemVerOptions): boolean;
-    checkSemVer(name: string | [string, string], min: number | string, max?: number | string, unstable?: boolean, startDir?: string): boolean;
-    sanitizeCmd(value: string): string;
-    sanitizeArgs(value: string, doubleQuote?: boolean): string;
-    sanitizeArgs(values: string[], doubleQuote?: boolean): string[];
-    purgeMemory(percent: number, parent: boolean | number): Promise<number>;
-    purgeMemory(percent?: number, limit?: number, parent?: boolean | number): Promise<number>;
-    canWrite(name: "temp" | "home"): boolean;
-    loadSettings(settings: Settings, password?: string): boolean;
-    readonly prototype: IModule<IHost>;
-    new(): IModule<IHost>;
-}
-```
-
-## References
-
-- https://www.unpkg.com/@e-mc/types@0.8.11/lib/core.d.ts
-- https://www.unpkg.com/@e-mc/types@0.8.11/lib/logger.d.ts
-- https://www.unpkg.com/@e-mc/types@0.8.11/lib/module.d.ts
-- https://www.unpkg.com/@e-mc/types@0.8.11/lib/node.d.ts
-
-## LICENSE
-
+# @e-mc/module
+
+* NodeJS 14
+* ES2019
+
+## General Usage
+
+* [Read the Docs](https://e-mc.readthedocs.io)
+
+## Interface
+
+- https://www.unpkg.com/@e-mc/types@0.8.13/lib/index.d.ts
+
+```typescript
+import type { LogStatus } from "./squared";
+
+import type { IHost } from "./index";
+import type { IAbortComponent, IPermission } from "./core";
+import type { LOG_TYPE, STATUS_TYPE, ExecCommand, LogArguments, LogComponent, LogDate, LogFailOptions, LogMessageOptions, LogOptions, LogProcessOptions, LogTime, LogType, LogValue, StatusType } from "./logger";
+import type { AsHashOptions, CheckSemVerOptions, CopyDirOptions, CopyDirResult, CopyFileOptions, CreateDirOptions, DeleteFileOptions, GetTempDirOptions, MoveFileOptions, NormalizeFlags, ParseFunctionOptions, PermissionOptions, ProtocolType, ReadBufferOptions, ReadFileCallback, ReadFileOptions, ReadHashOptions, ReadTextOptions, RemoveDirOptions, WriteFileOptions } from "./module";
+import type { Settings } from "./node";
+
+import type { SpawnOptions } from "child_process";
+import type { BinaryLike } from "crypto";
+import type { FileTypeResult } from "file-type";
+import type { NoParamCallback } from "fs";
+
+import type * as EventEmitter from "events";
+
+type BufferView = Buffer | string | NodeJS.ArrayBufferView;
+type CpuUsage = NodeJS.CpuUsage;
+
+interface IModule extends EventEmitter, IAbortComponent {
+    readonly status: LogStatus<StatusType>[];
+    readonly errors: unknown[];
+    supported(major: number, minor?: number, patch?: number, lts?: boolean): boolean;
+    supports(name: string, value?: boolean): boolean;
+    getTempDir(options: GetTempDirOptions): string;
+    getTempDir(uuidDir: boolean, createDir?: boolean): string;
+    getTempDir(pathname: string, createDir?: boolean): string;
+    getTempDir(uuidDir: boolean, filename: string, createDir?: boolean): string;
+    getTempDir(pathname?: string, filename?: string, createDir?: boolean): string;
+    canRead(uri: string, options?: PermissionOptions): boolean;
+    canWrite(uri: string, options?: PermissionOptions): boolean;
+    readFile(src: string): Buffer | undefined;
+    readFile(src: string, options?: ReadFileOptions): Promise<Buffer | string> | Buffer | string | undefined;
+    readFile(src: string, promises: true): Promise<Buffer | undefined>;
+    readFile(src: string, options: ReadFileOptions, promises: true): Promise<Buffer | string | undefined>;
+    readFile(src: string, callback: ReadFileCallback<Buffer>): Buffer | undefined;
+    readFile(src: string, options: ReadFileOptions, callback: ReadFileCallback<Buffer | string>): Buffer | string | undefined;
+    writeFile(src: string, data: BufferView, options?: WriteFileOptions): boolean;
+    writeFile(src: string, data: BufferView, promises: true): Promise<boolean>;
+    writeFile(src: string, data: BufferView, options: WriteFileOptions, promises: true): Promise<boolean>;
+    writeFile(src: string, data: BufferView, callback: NoParamCallback): void;
+    writeFile(src: string, data: BufferView, options: WriteFileOptions, callback: NoParamCallback): void;
+    deleteFile(src: string, options?: DeleteFileOptions): boolean;
+    deleteFile(src: string, promises: true): Promise<boolean>;
+    deleteFile(src: string, options: DeleteFileOptions, promises: true): Promise<boolean>;
+    deleteFile(src: string, callback: NoParamCallback): void;
+    deleteFile(src: string, options: DeleteFileOptions, callback: NoParamCallback): void;
+    copyFile(src: string, dest: string, options?: CopyFileOptions): boolean;
+    copyFile(src: string, dest: string, promises: true): Promise<boolean>;
+    copyFile(src: string, dest: string, options: CopyFileOptions, promises: true): Promise<boolean>;
+    copyFile(src: string, dest: string, callback: NoParamCallback): void;
+    copyFile(src: string, dest: string, options: CopyFileOptions, callback: NoParamCallback): void;
+    moveFile(src: string, dest: string, options?: MoveFileOptions): boolean;
+    moveFile(src: string, dest: string, promises: true): Promise<boolean>;
+    moveFile(src: string, dest: string, options: MoveFileOptions, promises: true): Promise<boolean>;
+    moveFile(src: string, dest: string, callback: NoParamCallback): void;
+    moveFile(src: string, dest: string, options: MoveFileOptions, callback: NoParamCallback): void;
+    createDir(src: string, options?: CreateDirOptions): boolean;
+    createDir(src: string, promises: true): Promise<boolean>;
+    createDir(src: string, options: CreateDirOptions, promises: true): Promise<boolean>;
+    createDir(src: string, callback: NoParamCallback): void;
+    createDir(src: string, options: CreateDirOptions, callback: NoParamCallback): void;
+    removeDir(src: string, options?: RemoveDirOptions): boolean;
+    removeDir(src: string, promises: true): Promise<boolean>;
+    removeDir(src: string, options: RemoveDirOptions, promises: true): Promise<boolean>;
+    removeDir(src: string, callback: NoParamCallback): void;
+    removeDir(src: string, options: RemoveDirOptions, callback: NoParamCallback): void;
+    allSettled(values: readonly PromiseLike<unknown>[], rejected?: LogValue, options?: LogFailOptions | LogType): Promise<PromiseFulfilledResult<unknown>[]>;
+    formatMessage(type: LogType, title: string, value: LogValue, message?: unknown, options?: LogMessageOptions): void;
+    formatFail(type: LogType, title: string, value: LogValue, message?: unknown, options?: LogFailOptions): void;
+    writeFail(value: LogValue, message?: unknown, options?: LogFailOptions | LogType): void;
+    writeTimeProcess(title: string, value: string, startTime: LogTime, options?: LogProcessOptions): void;
+    writeTimeElapsed(title: string, value: LogValue, startTime: LogTime, options?: LogMessageOptions): void;
+    checkPackage(err: unknown, name: string | undefined, options?: LogFailOptions | LogType): boolean;
+    checkPackage(err: unknown, name: string | undefined, value?: LogValue, options?: LogFailOptions | LogType): boolean;
+    checkFail(message: unknown, options: LogFailOptions): LogArguments | false | undefined;
+    writeLog(component: LogComponent, queue?: boolean): void;
+    writeLog(type: StatusType, value: unknown, options?: LogOptions): void;
+    writeLog(type: StatusType, value: unknown, timeStamp?: LogDate, duration?: number): void;
+    addLog(component: LogComponent, queue?: boolean): void;
+    addLog(type: StatusType, value: unknown, from: string, source?: string): void;
+    addLog(type: StatusType, value: unknown, options?: LogOptions): void;
+    addLog(type: StatusType, value: unknown, timeStamp?: LogDate, from?: string, source?: string): void;
+    addLog(type: StatusType, value: unknown, timeStamp?: LogDate, duration?: number, from?: string, source?: string): void;
+    getLog(...type: StatusType[]): LogStatus<StatusType>[];
+    flushLog(): void;
+    willAbort(value: unknown): boolean;
+    hasOwnPermission(): boolean;
+    isFatal(err?: unknown): boolean;
+    detach(): void;
+    reset(): void;
+    get moduleName(): string;
+    set host(value);
+    get host(): IHost | null;
+    set permission(value);
+    get permission(): IPermission | null;
+    get aborted(): boolean;
+    set abortable(value);
+    get abortable(): boolean;
+    get threadable(): boolean;
+    set sessionId(value);
+    get sessionId(): string;
+    set broadcastId(value);
+    get broadcastId(): string | string[];
+    get logType(): LOG_TYPE;
+    set logLevel(value: number | string);
+    get logLevel(): number;
+    get statusType(): STATUS_TYPE;
+    set tempDir(value);
+    get tempDir(): string;
+
+    /* EventEmitter */
+    on(event: "exec", listener: (command: ExecCommand, options?: SpawnOptions) => void): this;
+    on(event: "error", listener: (err: Error) => void): this;
+    on(event: "file:read", listener: (src: string, data: Buffer | string, options?: ReadFileOptions) => void): this;
+    on(event: "file:write", listener: (src: string, options?: WriteFileOptions) => void): this;
+    on(event: "file:delete", listener: (src: string, options?: DeleteFileOptions) => void): this;
+    on(event: "file:copy", listener: (dest: string, options?: CopyFileOptions) => void): this;
+    on(event: "file:move", listener: (dest: string, options?: MoveFileOptions) => void): this;
+    on(event: "dir:create", listener: (src: string, options?: CreateDirOptions) => void): this;
+    on(event: "dir:remove", listener: (src: string, options?: RemoveDirOptions) => void): this;
+    once(event: "exec", listener: (command: ExecCommand, options?: SpawnOptions) => void): this;
+    once(event: "error", listener: (err: Error) => void): this;
+    once(event: "file:read", listener: (src: string, data: Buffer | string, options?: ReadFileOptions) => void): this;
+    once(event: "file:write", listener: (src: string, options?: WriteFileOptions) => void): this;
+    once(event: "file:delete", listener: (src: string, options?: DeleteFileOptions) => void): this;
+    once(event: "file:copy", listener: (dest: string, options?: CopyFileOptions) => void): this;
+    once(event: "file:move", listener: (dest: string, options?: MoveFileOptions) => void): this;
+    once(event: "dir:create", listener: (src: string, options?: CreateDirOptions) => void): this;
+    once(event: "dir:remove", listener: (src: string, options?: RemoveDirOptions) => void): this;
+    emit(event: "exec", command: ExecCommand, options?: SpawnOptions): boolean;
+    emit(event: "error", err: Error): boolean;
+    emit(event: "file:read", src: string, data: Buffer | string, options?: ReadFileOptions): boolean;
+    emit(event: "file:write", src: string, options?: WriteFileOptions): boolean;
+    emit(event: "file:delete", src: string, options?: DeleteFileOptions): boolean;
+    emit(event: "file:copy", dest: string, options?: CopyFileOptions): boolean;
+    emit(event: "file:move", dest: string, options?: MoveFileOptions): boolean;
+    emit(event: "dir:create", src: string, options?: CreateDirOptions): boolean;
+    emit(event: "dir:remove", src: string, options?: RemoveDirOptions): boolean;
+}
+
+interface ModuleConstructor {
+    PROCESS_TIMEOUT: number;
+    LOG_STYLE_FAIL: LogMessageOptions;
+    LOG_STYLE_SUCCESS: LogMessageOptions;
+    LOG_STYLE_INFO: LogMessageOptions;
+    LOG_STYLE_WARN: LogMessageOptions;
+    LOG_STYLE_NOTICE: LogMessageOptions;
+    LOG_STYLE_REVERSE: LogMessageOptions;
+    readonly VERSION: string;
+    readonly LOG_TYPE: LOG_TYPE;
+    readonly STATUS_TYPE: STATUS_TYPE;
+    readonly MAX_TIMEOUT: number;
+    readonly TEMP_DIR: string;
+    supported(major: number, minor?: number, patch?: number, lts?: boolean): boolean;
+    formatMessage(type: LogType, title: string, value: LogValue, message?: unknown, options?: LogMessageOptions): void;
+    writeFail(value: LogValue, message?: unknown, options?: LogFailOptions | LogType): void;
+    enabled(key: string, username?: string): boolean;
+    parseFunction(value: unknown, options?: ParseFunctionOptions): ((...args: unknown[]) => Promise<unknown> | unknown) | null;
+    parseFunction(value: unknown, absolute: boolean, sync?: boolean): ((...args: unknown[]) => Promise<unknown> | unknown) | null;
+    asString(value: unknown, cacheKey?: boolean | "throws"): string;
+    asHash(data: BinaryLike, options: AsHashOptions): string;
+    asHash(data: BinaryLike, minLength: number): string;
+    asHash(data: BinaryLike, algorithm?: number | string | AsHashOptions, minLength?: number | AsHashOptions): string;
+    readHash(value: string | URL, options?: ReadHashOptions): Promise<string>;
+    toPosix(value: unknown, normalize: boolean): string;
+    toPosix(value: unknown, filename?: string, normalize?: boolean): string;
+    hasLogType(value: LogType): boolean;
+    isURL(value: string, ...exclude: string[]): boolean;
+    isFile(value: string | URL, type?: ProtocolType): boolean;
+    isDir(value: string | URL): boolean;
+    isPath(value: string | URL, type?: "unc" | "unc-exists"): boolean;
+    isPath(value: string | URL, isFile?: boolean): boolean;
+    isErrorCode(err: unknown, ...code: string[]): boolean;
+    fromLocalPath(value: string): string;
+    resolveFile(value: string): string;
+    resolvePath(value: string, base: string | URL): string;
+    joinPath(...values: [...paths: unknown[], normalize: boolean][]): string;
+    joinPath(...values: unknown[]): string;
+    normalizePath(value: unknown, flags?: boolean | NormalizeFlags): string;
+    createDir(value: string | URL, overwrite?: boolean): boolean;
+    removeDir(value: string | URL, sinceCreated: number, recursive?: boolean): boolean;
+    removeDir(value: string | URL, empty?: boolean, recursive?: boolean): boolean;
+    copyDir(src: string | URL, dest: string | URL, options: CopyDirOptions): Promise<CopyDirResult>;
+    copyDir(src: string | URL, dest: string | URL, move?: boolean, recursive?: boolean): Promise<CopyDirResult>;
+    renameFile(src: string | URL, dest: string | URL, throws?: boolean): boolean;
+    streamFile(src: string, cache: boolean): Promise<Buffer | string>;
+    streamFile(src: string, options: ReadBufferOptions): Promise<Buffer | string>;
+    streamFile(src: string, cache?: boolean | ReadBufferOptions, options?: ReadBufferOptions): Promise<Buffer | string>;
+    readText(value: string | URL, cache: boolean): string;
+    readText(value: string | URL, options: ReadTextOptions): Promise<string> | string;
+    readText(value: string | URL, encoding?: BufferEncoding | boolean | ReadTextOptions, cache?: boolean): string;
+    readBuffer(value: string | URL, options: ReadBufferOptions): Promise<Buffer | null> | Buffer | null;
+    readBuffer(value: string | URL, cache?: boolean): Buffer | null;
+    resolveMime(data: string | Buffer | Uint8Array | ArrayBuffer): Promise<FileTypeResult | undefined>;
+    lookupMime(value: string, extension?: boolean): string;
+    initCpuUsage(instance?: IModule): CpuUsage;
+    getCpuUsage(start: CpuUsage, format: true): string;
+    getCpuUsage(start: CpuUsage, format?: boolean): number;
+    getMemUsage(format: true): string;
+    getMemUsage(format?: boolean): number;
+    formatCpuMem(start: CpuUsage, all?: boolean): string;
+    getPackageVersion(name: string | [string, string], startDir: string, baseDir?: string): string;
+    getPackageVersion(name: string | [string, string], unstable?: boolean, startDir?: string, baseDir?: string): string;
+    checkSemVer(name: string | [string, string], options: CheckSemVerOptions): boolean;
+    checkSemVer(name: string | [string, string], min: number | string, max: number | string, options: CheckSemVerOptions): boolean;
+    checkSemVer(name: string | [string, string], min: number | string, max?: number | string, unstable?: boolean, startDir?: string): boolean;
+    sanitizeCmd(value: string): string;
+    sanitizeArgs(value: string, doubleQuote?: boolean): string;
+    sanitizeArgs(values: string[], doubleQuote?: boolean): string[];
+    purgeMemory(percent: number, parent: boolean | number): Promise<number>;
+    purgeMemory(percent?: number, limit?: number, parent?: boolean | number): Promise<number>;
+    canWrite(name: "temp" | "home"): boolean;
+    loadSettings(settings: Settings, password?: string): boolean;
+    readonly prototype: IModule<IHost>;
+    new(): IModule<IHost>;
+}
+```
+
+## References
+
+- https://www.unpkg.com/@e-mc/types@0.8.13/lib/core.d.ts
+- https://www.unpkg.com/@e-mc/types@0.8.13/lib/logger.d.ts
+- https://www.unpkg.com/@e-mc/types@0.8.13/lib/module.d.ts
+- https://www.unpkg.com/@e-mc/types@0.8.13/lib/node.d.ts
+
+## LICENSE
+
 MIT

package/index.d.ts

@@ -1,5 +1,5 @@
-import type { ModuleConstructor } from '../types/lib';
-
-declare const Module: ModuleConstructor;
-
+import type { ModuleConstructor } from '../types/lib';
+
+declare const Module: ModuleConstructor;
+
 export = Module;

package/index.js

@@ -129,6 +129,25 @@ const MEMORY_CACHE_DISK = {
     exclude: null
 };
 const REGEXP_TORRENT = /^(?:magnet:\?xt=|(?:https?|s?ftp):\/\/[^/][^\n]*?\.(?:torrent|metalink|meta4)(?:\?[^\n]*)?$)/i;
+const RESERVED_SHELL = [
+    'if',
+    'then',
+    'elif',
+    'else',
+    'fi',
+    'time',
+    'for',
+    'in',
+    'until',
+    'while',
+    'do',
+    'done',
+    'case',
+    'esac',
+    'coproc',
+    'select',
+    'function'
+];
 let LOG_NEWLINE = true;
 let LOG_EMPTYLINE = false;
 let TEMP_DIR = path.join(PROCESS_CWD, "tmp");
@@ -220,7 +239,7 @@ function applyStyle(options, style) {
 }
 function checkColorOptions(type, settings, options) {
     var _h, _j, _k, _l;
-    if (typeof settings !== 'object') {
+    if (!(0, types_1.isObject)(settings)) {
         return false;
     }
     let result = false;
@@ -642,14 +661,15 @@ function withinDir(value, base) {
     value = path.normalize(value);
     return (PLATFORM_WIN32 ? value.toLowerCase() : value).startsWith(ensureDir(PLATFORM_WIN32 ? base.toLowerCase() : base));
 }
-function formatPercent(value, precision = 3) {
+function formatPercent(value, precision) {
     if (value <= 0) {
         return '0%';
     }
-    if (value === Math.floor(value)) {
+    if (value === (value | 0)) {
         return value + '00%';
     }
-    return (value * 100).toPrecision(precision) + '%';
+    value *= 100;
+    return value.toPrecision(value < 1 ? 2 : precision) + '%';
 }
 const hideAbort = (err) => err.name === 'AbortError' && SETTINGS.abort === false;
 const asFile = (value) => (0, types_1.isString)(value) ? value.trim() : value instanceof URL && value.protocol === 'file:' ? url.fileURLToPath(value) : '';
@@ -687,7 +707,7 @@ class Module extends EventEmitter {
         this[_f] = new AbortController();
         this[_g] = null;
     }
-    static get VERSION() { return "0.8.11"; }
+    static get VERSION() { return "0.8.13"; }
     static get LOG_TYPE() { return types_1.LOG_TYPE; }
     static get STATUS_TYPE() { return types_1.STATUS_TYPE; }
     static get MAX_TIMEOUT() { return 2147483647; }
@@ -981,10 +1001,14 @@ class Module extends EventEmitter {
                 ({ color: hintColor, bgColor: hintBgColor } = formatHint);
                 hintBold !== null && hintBold !== void 0 ? hintBold : (hintBold = formatHint.bold);
             }
-            value = getValue() + (coloring ? chalk.blackBright('[') + formatColumn(truncateEnd(hint, hintWidth), hintColor, hintBgColor, hintBold) + chalk.blackBright(']') : `[${truncateEnd(hint, hintWidth)}]`);
-        }
-        else if (title) {
             value = getValue();
+            hint = coloring ? chalk.blackBright('[') + formatColumn(truncateEnd(hint, hintWidth), hintColor, hintBgColor, hintBold) + chalk.blackBright(']') : `[${truncateEnd(hint, hintWidth)}]`;
+        }
+        else {
+            if (title) {
+                value = getValue();
+            }
+            hint = '';
         }
         const unit = options.messageUnit ? type & 256 ? options.messageUnit.padStart(options.messageUnitMinWidth || 0) : options.messageUnit : '';
         const getMessage = (m, u) => type & 256 && messageUnitIndent === undefined ? (u + m).trimEnd() : u ? (m + (messageUnitIndent === undefined ? ' ' : '') + u).trimStart() : m;
@@ -1029,19 +1053,19 @@ class Module extends EventEmitter {
                     }
                 }
                 else {
-                    if (!i) {
+                    if (!i && !hint) {
                         v = v.trim();
                     }
                     m = '';
                 }
-                output = (titleIndent !== -1 ? title : title ? formatColumn(title, titleColor || 'green', titleBgColor, (_k = (options.titleBold || formatTitle.bold)) !== null && _k !== void 0 ? _k : false) + chalk.blackBright(':') + ' ' : '') + formatColumn(v, valueColor, valueBgColor, valueBold) + (i ? i : ' ') + m;
+                output = (titleIndent !== -1 ? title : title ? formatColumn(title, titleColor || 'green', titleBgColor, (_k = (options.titleBold || formatTitle.bold)) !== null && _k !== void 0 ? _k : false) + chalk.blackBright(':') + ' ' : '') + formatColumn(v, valueColor, valueBgColor, valueBold) + hint + (i ? i : ' ') + m;
             }
             catch {
             }
         }
         if (!output) {
-            const m = truncateStart(this.asString(message), (_l = options.messageWidth) !== null && _l !== void 0 ? _l : format.message.width);
-            output = (titleIndent !== -1 ? title : title ? title + ': ' : '') + value + (id ? id : ' ') + (m && SETTINGS.message !== false ? (error ? '{' : '(') + getMessage(m, unit) + (error ? '}' : ')') : '');
+            const m = truncateStart(stripansi(this.asString(message)), (_l = options.messageWidth) !== null && _l !== void 0 ? _l : format.message.width);
+            output = (titleIndent !== -1 ? title : title ? title + ': ' : '') + stripansi(value) + stripansi(hint) + (id ? id : ' ') + (m && SETTINGS.message !== false ? (error ? '{' : '(') + getMessage(m, unit) + (error ? '}' : ')') : '');
         }
         if (broadcastId) {
             if (BROADCAST_OUT) {
@@ -1796,7 +1820,7 @@ class Module extends EventEmitter {
                     const usage = user + system;
                     result = usage > 0 ? Math.min(usage / value, 1) * (typeof SETTINGS.process === 'object' && SETTINGS.process.cpu_single_core ? 1 : CPU_CORETOTAL) : 0;
                 }
-                return format ? formatPercent(result) : result;
+                return format ? formatPercent(result, 3) : result;
             }
         }
         return format ? '' : 0;
@@ -1826,7 +1850,7 @@ class Module extends EventEmitter {
                     return (0, types_1.formatSize)(result, { unit });
             }
         }
-        return format ? formatPercent(result / MEM_TOTAL) : result;
+        return format ? formatPercent(result / MEM_TOTAL, 3) : result;
     }
     static formatCpuMem(start, all) {
         let cpu, cpu_bar, cpu_single_core, mem, mem_format;
@@ -1857,7 +1881,7 @@ class Module extends EventEmitter {
                 }
                 const unit = Math.max(bar, 10);
                 const length = Math.floor(usage * unit);
-                const hint = usage === 1 ? "MAX" : usage < 0 ? "N/A" : formatPercent(usage, 2);
+                const hint = usage === 1 ? "MAX" : usage < 0 ? "N/A" : formatPercent(usage, 2).padStart(3);
                 result += chalk[usage >= red ? 'bgRed' : usage >= yellow ? 'bgYellow' : 'bgBlue'].white(':'.repeat(length)) + chalk.bgGrey.white(':'.repeat(unit - length)) + (hint ? chalk.bgWhite.grey(` ${hint} `) : '');
             }
             else if (usage) {
@@ -1867,7 +1891,7 @@ class Module extends EventEmitter {
         if (mem || all) {
             const usage = this.getMemUsage(mem_format || true);
             if (usage) {
-                result += (result ? ' ' : '') + usage + ' MEM';
+                result += (result ? ' ' : '') + usage.padStart(7) + ' MEM';
             }
         }
         return result;
@@ -2111,6 +2135,9 @@ class Module extends EventEmitter {
                                 value = "'" + value.replace(/'/g, "'\\''") + "'";
                             }
                         }
+                        else if (RESERVED_SHELL.includes(value)) {
+                            value = "'" + value + "'";
+                        }
                     }
                 }
                 else if (opt) {
@@ -2457,52 +2484,50 @@ class Module extends EventEmitter {
                 });
             }
         }
-        {
-            let dir = settings.temp_dir, write, modified;
-            if ((0, types_1.isPlainObject)(temp)) {
-                dir || (dir = temp.dir);
-                write = temp.write;
-            }
-            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);
-                }
-                else {
-                    this.formatMessage(1, 'WARN', 'Temp directory can only be relative', dir, { ...this.LOG_STYLE_WARN, newline: true });
-                    dir = undefined;
-                }
-            }
-            if (!(0, types_1.isString)(dir)) {
-                dir = VALUES["temp.dir"];
+        let dir = settings.temp_dir, write, modified;
+        if ((0, types_1.isPlainObject)(temp)) {
+            dir || (dir = temp.dir);
+            write = temp.write;
+        }
+        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);
             }
-            if (typeof write === 'boolean') {
-                modified = VALUES["temp.write"] !== write;
-                VALUES["temp.write"] = write;
+            else {
+                this.formatMessage(1, 'WARN', 'Temp directory can only be relative', dir, { ...this.LOG_STYLE_WARN, newline: true });
+                dir = undefined;
             }
-            do {
-                const [output, index] = tryIncrementDir(path.join(PROCESS_CWD, dir), 5);
-                if ((0, types_1.isString)(output)) {
-                    if (index > 0) {
-                        dir = trimDir(dir) + '_' + index;
-                    }
-                    if (dir !== VALUES["temp.dir"]) {
-                        VALUES["temp.dir"] = dir;
-                        modified = true;
-                    }
-                    (0, types_1.setTempDir)(TEMP_DIR = output);
-                    break;
+        }
+        if (!(0, types_1.isString)(dir)) {
+            dir = VALUES["temp.dir"];
+        }
+        if (typeof write === 'boolean') {
+            modified = VALUES["temp.write"] !== write;
+            VALUES["temp.write"] = write;
+        }
+        do {
+            const [output, index] = tryIncrementDir(path.join(PROCESS_CWD, dir), 5);
+            if ((0, types_1.isString)(output)) {
+                if (index > 0) {
+                    dir = trimDir(dir) + '_' + index;
                 }
-                if (output instanceof Error) {
-                    this.writeFail(["Unable to create temp directory", dir], output, 32);
+                if (dir !== VALUES["temp.dir"]) {
+                    VALUES["temp.dir"] = dir;
+                    modified = true;
                 }
-            } while ((dir !== "tmp") && (dir = "tmp"));
-            if (modified) {
-                this.formatMessage(1, 'TEMP', ["Directory was modified", dir], TEMP_DIR + (VALUES["temp.write"] ? ' - writeable' : ''), { ...this.LOG_STYLE_NOTICE, newline: true });
+                (0, types_1.setTempDir)(TEMP_DIR = output);
+                break;
             }
-            settings.temp_dir = dir;
-            if ((0, types_1.isPlainObject)(temp)) {
-                temp.dir = dir;
+            if (output instanceof Error) {
+                this.writeFail(["Unable to create temp directory", dir], output, 32);
             }
+        } while ((dir !== "tmp") && (dir = "tmp"));
+        if (modified) {
+            this.formatMessage(1, 'TEMP', ["Directory was modified", dir], TEMP_DIR + (VALUES["temp.write"] ? ' - writeable' : ''), { ...this.LOG_STYLE_NOTICE, newline: true });
+        }
+        settings.temp_dir = dir;
+        if ((0, types_1.isPlainObject)(temp)) {
+            temp.dir = dir;
         }
         return true;
     }

package/lib-v4.d.ts

@@ -1,5 +1,5 @@
-import type { IModuleLibV4 } from '../types/lib/compat-v4';
-
-declare const LibV4: IModuleLibV4;
-
+import type { IModuleLibV4 } from '../types/lib/compat-v4';
+
+declare const LibV4: IModuleLibV4;
+
 export = LibV4;

package/package.json

@@ -1,33 +1,33 @@
-{
-  "name": "@e-mc/module",
-  "version": "0.8.11",
-  "description": "Module base class for E-mc.",
-  "main": "index.js",
-  "types": "index.d.ts",
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/anpham6/e-mc.git",
-    "directory": "src/module"
-  },
-  "keywords": [
-    "squared",
-    "squared-functions"
-  ],
-  "author": "An Pham <anpham6@gmail.com>",
-  "license": "MIT",
-  "homepage": "https://github.com/anpham6/e-mc#readme",
-  "dependencies": {
-    "@e-mc/types": "0.8.11",
-    "abort-controller": "^3.0.0",
-    "chalk": "4.1.2",
-    "event-target-shim": "^5.0.1",
-    "file-type": "16.5.4",
-    "js-yaml": "^4.1.0",
-    "mime-types": "^2.1.35",
-    "picomatch": "^3.0.1",
-    "strip-ansi": "6.0.1"
-  }
-}
+{
+  "name": "@e-mc/module",
+  "version": "0.8.13",
+  "description": "Module base class for E-mc.",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anpham6/e-mc.git",
+    "directory": "src/module"
+  },
+  "keywords": [
+    "squared",
+    "squared-functions"
+  ],
+  "author": "An Pham <anpham6@gmail.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/anpham6/e-mc#readme",
+  "dependencies": {
+    "@e-mc/types": "0.8.13",
+    "abort-controller": "^3.0.0",
+    "chalk": "4.1.2",
+    "event-target-shim": "^5.0.1",
+    "file-type": "16.5.4",
+    "js-yaml": "^4.1.0",
+    "mime-types": "^2.1.35",
+    "picomatch": "^3.0.1",
+    "strip-ansi": "6.0.1"
+  }
+}