@e-mc/types 0.12.4 → 0.12.6

package/README.md

@@ -9,7 +9,7 @@
 
 ## Interface
 
-* [View Source](https://www.unpkg.com/@e-mc/types@0.12.4/index.d.ts)
+* [View Source](https://www.unpkg.com/@e-mc/types@0.12.6/index.d.ts)
 
 ```typescript
 import type { LogArguments } from "./lib/logger";
@@ -74,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 {
@@ -137,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 {
@@ -201,10 +203,10 @@ const IMPORT_MAP: Record<string, string | undefined>;
 
 ## References
 
-- https://www.unpkg.com/@e-mc/types@0.12.4/index.d.ts
-- https://www.unpkg.com/@e-mc/types@0.12.4/lib/logger.d.ts
-- https://www.unpkg.com/@e-mc/types@0.12.4/lib/module.d.ts
-- https://www.unpkg.com/@e-mc/types@0.12.4/lib/node.d.ts
+- https://www.unpkg.com/@e-mc/types@0.12.6/index.d.ts
+- https://www.unpkg.com/@e-mc/types@0.12.6/lib/logger.d.ts
+- https://www.unpkg.com/@e-mc/types@0.12.6/lib/module.d.ts
+- https://www.unpkg.com/@e-mc/types@0.12.6/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.4',
+    VERSION = '0.12.6',
     TEMP_DIR = 'tmp',
     CJS = '__cjs__'
 }
@@ -78,6 +78,7 @@ export const enum ERR_MESSAGE {
     UNSUPPORTED_READ = 'Not permitted to read file',
     UNSUPPORTED_WRITE = 'Not permitted to write file',
     UNSUPPORTED_OVERWRITE = 'Not permitted to overwrite file',
+    UNSUPPORTED_PATH = 'Not permitted to set absolute path',
     NOTFOUND_PATH = 'Path not found',
     NOTFOUND_FILE = 'File not found',
     NOTFOUND_BINARY = 'Binary not found',

package/index.d.ts

@@ -145,6 +145,7 @@ declare namespace types {
 
     const ERR_CODE: {
         MODULE_NOT_FOUND: string;
+        ERR_MODULE_NOT_FOUND: string;
     };
 
     interface DOWNLOAD_TYPE {
@@ -281,6 +282,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];
 
@@ -340,7 +342,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

@@ -100,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 = '';
@@ -1188,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) {
@@ -1201,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

@@ -822,15 +822,9 @@ declare namespace functions {
         getMemUsage(format?: boolean, free?: boolean): number;
         formatCpuMem(start: CpuUsage, all?: boolean): string;
         getPackageVersion(name: string | [string, string], options?: PackageVersionOptions): string;
-        /** @deprecated */
-        getPackageVersion(name: string | [string, string], startDir: string, baseDir?: string): string;
-        /** @deprecated */
-        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): boolean;
         checkSemVer(name: string | [string, string], min: number | string, max: number | string, options?: Omit<CheckSemVerOptions, "min" | "max" | "equals">): boolean;
-        /** @deprecated */
-        checkSemVer(name: string | [string, string], min: number | string, max?: number | string, unstable?: boolean, startDir?: string): boolean;
         /** @deprecated @e-mc/types */
         sanitizeCmd(value: string, ...args: unknown[]): string;
         /** @deprecated @e-mc/types */

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 {

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.4",
+  "version": "0.12.6",
   "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",