@e-mc/types 0.12.3 → 0.12.5

package/README.md

@@ -9,7 +9,7 @@
 
 ## Interface
 
-* [View Source](https://www.unpkg.com/@e-mc/types@0.12.2/index.d.ts)
+* [View Source](https://www.unpkg.com/@e-mc/types@0.12.5/index.d.ts)
 
 ```typescript
 import type { LogArguments } from "./lib/logger";
@@ -32,6 +32,7 @@ function existsFlag(value: unknown): boolean;
 function getLogCurrent(): LogArguments | null;
 function setLogCurrent(value: LogArguments): void;
 function setTempDir(value: string): boolean;
+function getTempDir(create: true, prefix?: string): string;
 function getTempDir(...values: string[]): string;
 function isArray(value: unknown): value is unknown[];
 function isObject(value: unknown): value is object;
@@ -73,7 +74,8 @@ function errorValue(value: string, hint?: string): Error;
 function errorMessage(title: number | string, value: string, hint?: string): Error;
 function supported(major: number, minor: number, lts: boolean): boolean;
 function supported(major: number, minor?: number, patch?: number, lts?: boolean): boolean;
-function importESM<T = unknown>(name: string, isDefault?: boolean, fromPath?: boolean): Promise<T>;
+function importESM(name: string | URL, isDefault: boolean, fromPath?: boolean): Promise<unknown>;
+function importESM(name: string | URL, options?: ImportAttributes, fromPath?: boolean): Promise<unknown>;
 function purgeMemory(percent?: number): number;
 
 interface LOG_TYPE {
@@ -136,6 +138,7 @@ interface ACTION_FLAG {
 
 interface ERR_CODE {
     MODULE_NOT_FOUND: "MODULE_NOT_FOUND";
+    ERR_MODULE_NOT_FOUND: "ERR_MODULE_NOT_FOUND";
 }
 
 interface DOWNLOAD_TYPE {
@@ -200,10 +203,10 @@ const IMPORT_MAP: Record<string, string | undefined>;
 
 ## References
 
-- https://www.unpkg.com/@e-mc/types@0.12.2/index.d.ts
-- https://www.unpkg.com/@e-mc/types@0.12.2/lib/logger.d.ts
-- https://www.unpkg.com/@e-mc/types@0.12.2/lib/module.d.ts
-- https://www.unpkg.com/@e-mc/types@0.12.2/lib/node.d.ts
+- https://www.unpkg.com/@e-mc/types@0.12.5/index.d.ts
+- https://www.unpkg.com/@e-mc/types@0.12.5/lib/logger.d.ts
+- https://www.unpkg.com/@e-mc/types@0.12.5/lib/module.d.ts
+- https://www.unpkg.com/@e-mc/types@0.12.5/lib/node.d.ts
 
 * https://developer.mozilla.org/en-US/docs/Web/API/DOMException
 * https://www.npmjs.com/package/@types/bytes

package/constant.d.ts

@@ -1,5 +1,5 @@
 export const enum INTERNAL {
-    VERSION = '0.12.3',
+    VERSION = '0.12.5',
     TEMP_DIR = 'tmp',
     CJS = '__cjs__'
 }
@@ -301,6 +301,17 @@ export const enum LOG_STATE {
     STDERR
 }
 
+export const enum STATUS_TYPE {
+    UNKNOWN,
+    FATAL,
+    ERROR,
+    WARN,
+    INFO,
+    DEBUG,
+    ASSERT,
+    TRACE
+}
+
 export const enum READDIR_SORT {
     FILE,
     DIRECTORY,

package/index.d.ts

@@ -281,6 +281,7 @@ declare namespace types {
         preserve?: boolean;
     }
 
+    type ImportAttributes = { with: { type: "json" } };
     type MergeArrayMethod = "concat" | "concat-pre" | "includes" | "unshift" | "push" | "flat" | "join" | "slice" | "reverse" | ["flat", number] | ["join", string] | ["slice", number, number?];
     type WatchEventValue = WATCH_EVENT[keyof WATCH_EVENT];
 
@@ -298,6 +299,7 @@ declare namespace types {
     function getLogCurrent(): LogArguments | null;
     function setLogCurrent(value: LogArguments | null): void;
     function setTempDir(value: string): boolean;
+    function getTempDir(create: true, prefix?: string): string;
     function getTempDir(...values: string[]): string;
     function isArray<T>(value: unknown): value is T[];
     function isObject<T extends object>(value: unknown): value is T;
@@ -339,7 +341,8 @@ declare namespace types {
     function errorMessage(title: number | string, value: string, hint?: string): Error;
     function supported(major: number, minor: number, lts: boolean): boolean;
     function supported(major: number, minor?: number, patch?: number, lts?: boolean): boolean;
-    function importESM<T = unknown>(name: string, isDefault?: boolean, fromPath?: boolean): Promise<T>;
+    function importESM<T = unknown>(name: string | URL, isDefault: boolean, fromPath?: boolean): Promise<T>;
+    function importESM<T = unknown>(name: string | URL, options?: ImportAttributes, fromPath?: boolean): Promise<T>;
     function purgeMemory(percent?: number): number;
 }
 

package/index.js

@@ -51,6 +51,7 @@ const path = require("node:path");
 const fs = require("node:fs");
 const crypto = require("node:crypto");
 const bytes = require("bytes");
+const node_os_1 = require("node:os");
 const node_url_1 = require("node:url");
 const PATTERN_CHARS = {
     '&': '\\x26',
@@ -99,6 +100,7 @@ const RESERVED_SHELL = [
 let CACHE_COERCED = new WeakSet();
 let LOG_CURRENT = null;
 let SUPPORTED_HASHSINGLE = false;
+let SUPPORTED_IMPORTATTRIBUTES = false;
 let TEMP_DIR = path.join(process.cwd(), "tmp");
 let INCREMENT_COUNT = 65536;
 let INCREMENT_PREFIX = '';
@@ -583,7 +585,13 @@ function setLogCurrent(value) {
     LOG_CURRENT = value;
 }
 function getTempDir(...values) {
-    return values.length > 0 ? path.join(TEMP_DIR, ...values) : TEMP_DIR;
+    if (values.length === 0) {
+        return TEMP_DIR;
+    }
+    if (typeof values[0] === 'boolean' && values.shift()) {
+        return fs.mkdtempSync(isString(values[0]) ? path.join((0, node_os_1.tmpdir)(), values[0]) : (0, node_os_1.tmpdir)() + path.sep);
+    }
+    return path.join(TEMP_DIR, ...values);
 }
 function setTempDir(value) {
     try {
@@ -998,7 +1006,6 @@ function getEncoding(value, fallback) {
         switch (value = value.trim().toLowerCase()) {
             case 'utf8':
             case 'utf-8':
-            case 'unicode-1-1-utf-8':
                 return 'utf8';
             case 'utf16le':
             case 'utf-16le':
@@ -1182,10 +1189,21 @@ function supported(major, minor = 0, patch = 0, lts = false) {
     return !lts;
 }
 async function importESM(name, isDefault, fromPath) {
-    if (fromPath && path.isAbsolute(name)) {
+    let options;
+    if (name instanceof URL) {
+        name = (0, node_url_1.fileURLToPath)(name);
+    }
+    else if (fromPath && path.isAbsolute(name)) {
         name = (0, node_url_1.pathToFileURL)(name).toString();
     }
-    const result = import(name);
+    if (isObject(isDefault)) {
+        options = isDefault;
+        if (!SUPPORTED_IMPORTATTRIBUTES && options.with?.type === 'json') {
+            return JSON.parse(fs.readFileSync(name, 'utf8'));
+        }
+        isDefault = true;
+    }
+    const result = import(name, options);
     if (isDefault) {
         const out = await result;
         if (isObject(out) && 'default' in out) {
@@ -1195,3 +1213,4 @@ async function importESM(name, isDefault, fromPath) {
     return result;
 }
 SUPPORTED_HASHSINGLE = supported(20, 12, true) || supported(21, 7);
+SUPPORTED_IMPORTATTRIBUTES = supported(18, 20, 5, true) || supported(20, 18, 3, true) || supported(22, 12, true) || supported(23, 1);

package/lib/core.d.ts

@@ -6,7 +6,7 @@ import type { StatusType } from '@e-mc/types/lib/logger';
 import type { Settings } from './node';
 import type { ClientDbSettings, ClientModule, DbCacheValue, DbCoerceSettings, DbSourceOptions } from './settings';
 
-import type { TransferListItem, Worker, WorkerOptions } from 'node:worker_threads';
+import type { Transferable, Worker, WorkerOptions } from 'node:worker_threads';
 
 import type * as EventEmitter from 'node:events';
 
@@ -108,9 +108,9 @@ export interface WorkerGroupConstructor {
 
 export interface IWorkerChannel<T = unknown> extends EventEmitter, Iterable<Worker>, WorkerInfo {
     [Symbol.iterator](): IteratorObject<Worker, BuiltinIteratorReturn>;
-    sendObject(data: unknown, transferList?: TransferListItem[], callback?: WorkerChannelResponse<T>, ...returnArgs: unknown[]): Worker;
+    sendObject(data: unknown, transferList?: Transferable[], callback?: WorkerChannelResponse<T>, ...returnArgs: unknown[]): Worker;
     sendBuffer(data: Buffer, shared?: boolean, callback?: WorkerChannelResponse<T>, ...returnArgs: unknown[]): Worker | null;
-    send(data: unknown, transferList?: TransferListItem[]): Promise<T>;
+    send(data: unknown, transferList?: Transferable[]): Promise<T>;
     drop(count?: number): number;
     join(group: IWorkerGroup, label?: string): void;
     quit(): void;
@@ -141,13 +141,13 @@ export interface IWorkerChannel<T = unknown> extends EventEmitter, Iterable<Work
     on(event: "online", listener: () => void): this;
     on(event: "message", listener: (value: any) => void): this;
     on(event: "data", listener: (data: T) => void): this;
-    on(event: "pass", listener: (data: unknown, transferList: TransferListItem[] | undefined) => void): this;
+    on(event: "pass", listener: (data: unknown, transferList: Transferable[] | undefined) => void): this;
     once(event: "error" | "messageerror" | "abort", listener: (err: Error) => void): this;
     once(event: "exit", listener: (exitCode: number) => void): this;
     once(event: "online", listener: () => void): this;
     once(event: "message", listener: (value: any) => void): this;
     once(event: "data", listener: (data: T) => void): this;
-    once(event: "pass", listener: (data: unknown, transferList: TransferListItem[] | undefined) => void): this;
+    once(event: "pass", listener: (data: unknown, transferList: Transferable[] | undefined) => void): this;
 }
 
 export interface WorkerChannelConstructor<T = unknown> {

package/lib/index.d.ts

@@ -28,6 +28,8 @@ import type { Readable, Writable } from 'node:stream';
 import type { SecureContextOptions } from 'node:tls';
 import type { BrotliCompress, BrotliOptions, Gzip, ZlibOptions } from 'node:zlib';
 // @ts-ignore
+import type { Unit } from 'bytes';
+// @ts-ignore
 import type { FileTypeResult } from 'file-type';
 
 import type * as EventEmitter from 'node:events';
@@ -816,8 +818,8 @@ declare namespace functions {
         initCpuUsage(instance?: IModule): CpuUsage;
         getCpuUsage(start: CpuUsage, format: true): string;
         getCpuUsage(start: CpuUsage, format?: boolean): number;
-        getMemUsage(format: true): string;
-        getMemUsage(format?: boolean): number;
+        getMemUsage(format: true | "%" | Unit, free?: boolean): string;
+        getMemUsage(format?: boolean, free?: boolean): number;
         formatCpuMem(start: CpuUsage, all?: boolean): string;
         getPackageVersion(name: string | [string, string], options?: PackageVersionOptions): string;
         /** @deprecated */

package/lib/request.d.ts

@@ -143,6 +143,7 @@ export interface OpenOptions extends KeepAliveAction, SilentAction, EncodingActi
     pipeTo?: string | Writable;
     postData?: unknown;
     connected?: ((headers: IncomingHttpHeaders) => boolean | void);
+    trailers?: (headers: IncomingHttpHeaders) => void;
     statusMessage?: string;
     progressId?: number | string;
     outFormat?: { out: BufferFormat; parser?: PlainObject };

package/lib/settings.d.ts

@@ -272,7 +272,7 @@ export interface DbCoerceSettings<T = boolean> {
 export interface PurgeBase<T = number | string> extends MinMax {
     enabled?: boolean;
     percent?: T;
-    limit?: number;
+    limit?: T;
 }
 
 export interface PurgeComponent extends PurgeBase {
@@ -461,6 +461,7 @@ export interface LoggerProcessSettings extends LoggerColor {
     cpu_single_core?: boolean;
     mem?: boolean;
     mem_format?: "%" | Unit;
+    mem_free?: boolean;
 }
 
 export interface LoggerFormatColor {

package/lib/task.d.ts

@@ -1,10 +1,10 @@
-export interface Command<T = unknown> extends PlainObject {
-    task: string;
-    origDir: string;
-    data: T;
-}
-
-export interface SpawnResult {
-    added?: string[];
-    deleted?: string[];
+export interface Command<T = unknown> extends PlainObject {
+    task: string;
+    origDir: string;
+    data: T;
+}
+
+export interface SpawnResult {
+    added?: string[];
+    deleted?: string[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@e-mc/types",
-  "version": "0.12.3",
+  "version": "0.12.5",
   "description": "Type definitions for E-mc.",
   "main": "index.js",
   "types": "index.d.ts",
@@ -13,8 +13,7 @@
     "directory": "src/types"
   },
   "keywords": [
-    "squared",
-    "squared-functions"
+    "squared"
   ],
   "author": "An Pham <anpham6@gmail.com>",
   "license": "BSD-3-Clause",