@e-mc/module 0.8.13 → 0.8.15

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.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
-
+# @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.15/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, digest: unknown): string;
+    asHash(data: BinaryLike, algorithm?: NumString | AsHashOptions, digest?: unknown): 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.15/lib/core.d.ts
+- https://www.unpkg.com/@e-mc/types@0.8.15/lib/logger.d.ts
+- https://www.unpkg.com/@e-mc/types@0.8.15/lib/module.d.ts
+- https://www.unpkg.com/@e-mc/types@0.8.15/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

@@ -554,7 +554,7 @@ function addCacheItem(map, key, data, cache) {
 }
 function checkFunction(value) {
     if (typeof value === 'function') {
-        Object.defineProperty(value, "__cjs__", { value: true });
+        Object.defineProperty(value, "__cjs__", { value: true, writable: false, enumerable: false });
         return value;
     }
     return null;
@@ -657,9 +657,16 @@ function applyLogId(options) {
     }
     return options;
 }
-function withinDir(value, base) {
+function withinDir(value, base, override = false) {
     value = path.normalize(value);
-    return (PLATFORM_WIN32 ? value.toLowerCase() : value).startsWith(ensureDir(PLATFORM_WIN32 ? base.toLowerCase() : base));
+    if (PLATFORM_WIN32) {
+        value = value.toLowerCase();
+        base = ensureDir(base.toLowerCase());
+    }
+    else {
+        base = ensureDir(base);
+    }
+    return value.startsWith(base) && (value !== base || override);
 }
 function formatPercent(value, precision) {
     if (value <= 0) {
@@ -707,7 +714,7 @@ class Module extends EventEmitter {
         this[_f] = new AbortController();
         this[_g] = null;
     }
-    static get VERSION() { return "0.8.13"; }
+    static get VERSION() { return "0.8.15"; }
     static get LOG_TYPE() { return types_1.LOG_TYPE; }
     static get STATUS_TYPE() { return types_1.STATUS_TYPE; }
     static get MAX_TIMEOUT() { return 2147483647; }
@@ -1224,40 +1231,34 @@ class Module extends EventEmitter {
         }
         return cacheKey ? (0, types_1.generateUUID)() : '';
     }
-    static asHash(data, algorithm, minLength = 0) {
-        if (!algorithm && !minLength) {
+    static asHash(data, algorithm, digest) {
+        if (!algorithm && !digest) {
             return crypto.createHash("sha256").update(data).digest("hex");
         }
-        let options, digest;
-        if (typeof minLength !== 'number') {
-            options = minLength;
-            minLength = 0;
-        }
-        if (typeof algorithm === 'number') {
-            minLength = algorithm;
-            algorithm = undefined;
-        }
-        else if ((0, types_1.isObject)(algorithm)) {
-            options = algorithm;
-            algorithm = undefined;
-        }
-        if (options) {
-            options = { ...options };
-            if ('minLength' in options) {
-                minLength = options.minLength;
-                delete options.minLength;
-            }
+        let options;
+        if ((0, types_1.isObject)(algorithm)) {
+            options = { ...algorithm };
             if ('algorithm' in options) {
                 algorithm = options.algorithm;
                 delete options.algorithm;
             }
+            else {
+                algorithm = undefined;
+            }
             if ('digest' in options) {
                 digest = options.digest;
                 delete options.digest;
             }
+            else {
+                digest = undefined;
+            }
+        }
+        else if ((0, types_1.isObject)(digest)) {
+            options = digest;
+            digest = undefined;
         }
-        if (minLength > 0 && typeof data === 'string' && data.length > minLength) {
-            return data;
+        else if (typeof digest !== 'string') {
+            digest = undefined;
         }
         try {
             return crypto.createHash(algorithm || "sha256", options).update(data).digest(digest || "hex");
@@ -2609,7 +2610,7 @@ class Module extends EventEmitter {
         if (permission && (Module.isFile(uri, 'unc') ? permission.hasUNCRead(path.normalize(uri)) || ownPermissionOnly && !permission.getUNCRead() : path.isAbsolute(uri = path.resolve(uri)) && (permission.hasDiskRead(uri) || ownPermissionOnly && !permission.getDiskRead()))) {
             return true;
         }
-        return VALUES["permission.home_read"] && withinDir(uri, OS_HOMEDIR);
+        return VALUES["permission.home_read"] && withinDir(uri, OS_HOMEDIR, true);
     }
     canWrite(uri, options) {
         let permission = this.permission, ownPermissionOnly = false;
@@ -2630,7 +2631,7 @@ class Module extends EventEmitter {
         if (permission && (Module.isFile(uri, 'unc') ? permission.hasUNCWrite(path.normalize(uri)) || ownPermissionOnly && !permission.getUNCWrite() : path.isAbsolute(uri = path.resolve(uri)) && (permission.hasDiskWrite(uri) || ownPermissionOnly && !permission.getDiskWrite()))) {
             return true;
         }
-        return VALUES["temp.write"] && withinDir(uri, TEMP_DIR) || VALUES["permission.home_write"] && withinDir(uri, OS_HOMEDIR);
+        return VALUES["temp.write"] && withinDir(uri, TEMP_DIR, true) || VALUES["permission.home_write"] && withinDir(uri, OS_HOMEDIR, true);
     }
     readFile(src, options = {}, callback) {
         let promises, outSrc;

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.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"
-  }
-}
+{
+  "name": "@e-mc/module",
+  "version": "0.8.15",
+  "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.15",
+    "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"
+  }
+}