@e-mc/types 0.13.7 → 0.13.8

package/README.md

@@ -1,6 +1,6 @@
 # @e-mc/types
 
-* NodeJS 18.20.5 LTS
+* NodeJS 18.20 LTS
 * ES2022
 
 ## General Usage
@@ -9,7 +9,7 @@
 
 ## Interface
 
-* [View Source](https://www.unpkg.com/@e-mc/types@0.13.7/index.d.ts)
+* [View Source](https://www.unpkg.com/@e-mc/types@0.13.8/index.d.ts)
 
 ```typescript
 import type { LogArguments } from "./lib/logger";
@@ -81,6 +81,7 @@ function supported(major: number, minor: number, lts: boolean): boolean;
 function supported(major: number, minor?: number, patch?: number, lts?: boolean): boolean;
 function importESM(name: string | URL, isDefault: boolean, fromPath?: boolean): Promise<unknown>;
 function importESM(name: string | URL, options?: ImportAttributes, fromPath?: boolean): Promise<unknown>;
+function requireESM(name: string, expect?: string): unknown;
 function purgeMemory(percent?: number): number;
 
 interface LOG_TYPE {
@@ -208,10 +209,10 @@ const IMPORT_MAP: Record<string, string | undefined>;
 
 ## References
 
-- https://www.unpkg.com/@e-mc/types@0.13.7/index.d.ts
-- https://www.unpkg.com/@e-mc/types@0.13.7/lib/logger.d.ts
-- https://www.unpkg.com/@e-mc/types@0.13.7/lib/module.d.ts
-- https://www.unpkg.com/@e-mc/types@0.13.7/lib/node.d.ts
+- https://www.unpkg.com/@e-mc/types@0.13.8/index.d.ts
+- https://www.unpkg.com/@e-mc/types@0.13.8/lib/logger.d.ts
+- https://www.unpkg.com/@e-mc/types@0.13.8/lib/module.d.ts
+- https://www.unpkg.com/@e-mc/types@0.13.8/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.13.7',
+    VERSION = '0.13.8',
     TEMP_DIR = 'tmp',
     CJS = '__cjs__'
 }

package/index.d.ts

@@ -350,6 +350,7 @@ declare namespace types {
     function supported(major: number, minor?: number, patch?: number, lts?: boolean): boolean;
     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 requireESM<T = unknown>(name: string, expect?: string): T;
     function purgeMemory(percent?: number): number;
 }
 

package/index.js

@@ -48,6 +48,7 @@ exports.incrementUUID = incrementUUID;
 exports.hashKey = hashKey;
 exports.supported = supported;
 exports.importESM = importESM;
+exports.requireESM = requireESM;
 const path = require("node:path");
 const fs = require("node:fs");
 const crypto = require("node:crypto");
@@ -57,6 +58,7 @@ const node_url_1 = require("node:url");
 const PATTERN_CHARS = {
     '&': '\\x26',
     '!': '\\x21',
+    '"': '\\x22',
     '#': '\\x23',
     '%': '\\x25',
     ',': '\\x2c',
@@ -102,6 +104,7 @@ let CACHE_COERCED = new WeakSet();
 let LOG_CURRENT = null;
 let SUPPORTED_HASHSINGLE = false;
 let SUPPORTED_IMPORTATTRIBUTES = false;
+let SUPPORTED_REGEXPESCAPE = false;
 let TEMP_DIR = path.join(process.cwd(), "tmp");
 let INCREMENT_COUNT = 65536;
 let INCREMENT_PREFIX = '';
@@ -176,7 +179,7 @@ function fromObject(value, typedArray, structured, shared) {
 function trimQuote(value) {
     value = value.trim();
     const first = value[0];
-    return first === value.at(-1) && (first === '"' || first === "'" || first === "`") ? value.substring(1, value.length - 1) : value;
+    return first === value.at(-1) && (first === '"' || first === "'" || first === "`") ? value.slice(1, -1) : value;
 }
 function checkCipherType(value) {
     switch (value) {
@@ -761,6 +764,9 @@ function hasGlob(value) {
 function escapePattern(value, symbols) {
     switch (typeof value) {
         case 'string': {
+            if (symbols && SUPPORTED_REGEXPESCAPE) {
+                return RegExp.escape(value);
+            }
             let result = '', j = 0;
             for (let i = 0, length = value.length, ch; i < length; ++i) {
                 switch (ch = value[i]) {
@@ -1102,7 +1108,7 @@ function randomString(format, dictionary) {
                 let length = 0, available;
                 if (b.startsWith('[') && b.endsWith(']')) {
                     length = 1;
-                    available = b.substring(1, b.length - 1);
+                    available = b.slice(1, -1);
                 }
                 else {
                     if (isNaN(length = +b)) {
@@ -1260,5 +1266,10 @@ async function importESM(name, isDefault, fromPath) {
     }
     return result;
 }
+function requireESM(name, expect) {
+    const result = require(name);
+    return process.features.require_module && isObject(result) && result.__esModule && 'default' in result && (!expect || typeof result.default === expect) ? result.default : 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);
+SUPPORTED_IMPORTATTRIBUTES = supported(18, 20, true) || supported(20, 10);
+SUPPORTED_REGEXPESCAPE = supported(24);

package/lib/dom.d.ts

@@ -0,0 +1,9 @@
+interface EventListenerOptions {
+    capture?: boolean;
+}
+
+export interface AddEventListenerOptions extends EventListenerOptions {
+    once?: boolean;
+    passive?: boolean;
+    signal?: AbortSignal;
+}

package/lib/index.d.ts

@@ -14,7 +14,7 @@ import type { CommandData, CropData, QualityData, ResizeData, RotateData, Transf
 import type { ExecCommand, LOG_TYPE, LogArguments, LogComponent, LogDate, LogFailOptions, LogMessageOptions, LogOptions, LogProcessOptions, LogState, LogTime, LogType, LogValue, STATUS_TYPE, StatusType } from './logger';
 import type { AsHashOptions, CheckSemVerOptions, CopyDirOptions, CopyDirResult, CopyFileOptions, CreateDirOptions, DeleteFileOptions, DirectoryActionType, FileActionType, FileTypeFormat, GlobDirOptions, MoveFileOptions, PackageVersionOptions, ParseFunctionOptions, PermissionOptions, PermissionType, ProtocolType, ReadBufferOptions, ReadFileCallback, ReadFileOptions, ReadHashOptions, ReadTextOptions, RemoveDirOptions, TempDirOptions, WriteFileOptions } from './module';
 import type { ErrorCode, HighResolutionTime, RequestData, Settings } from './node';
-import type { ApplyOptions, Aria2Options, BufferFormat, DataEncodedResult, DataObjectResult, FormDataPart, HeadersOnCallback, HostConfig, IHttpAdapter, OpenOptions, PostOptions, ProxySettings, PutOptions, RcloneOptions, ReadExpectType, RequestInit, StatusOnCallback } from './request';
+import type { ApplyOptions, Aria2Options, BufferFormat, DataEncodedResult, DataObjectResult, HeadersOnCallback, HostConfig, IHttpAdapter, OpenOptions, PostFileParts as PostFileParts, PostOptions, ProxySettings, PutOptions, RcloneOptions, ReadExpectType, RequestInit, StatusOnCallback } from './request';
 import type { ClientModule, CloudAuthSettings, CloudModule, CloudServiceOptions, CompressModule, CompressSettings, DbCoerceSettings, DbModule, DbSourceOptions, DnsLookupSettings, DocumentComponent, DocumentComponentOption, DocumentModule, HandlerSettings, HttpConnectSettings, HttpMemorySettings, ImageModule, LoggerFormat, LoggerFormatSettings, PoolConfig, RequestModule, RequestSettings, TaskModule, WatchModule } from './settings';
 import type { Command, SpawnResult } from './task';
 import type { IFileGroup, ModifiedPostFinalizeListener, SecureOptions, WatchInitResult } from './watch';
@@ -159,8 +159,8 @@ declare namespace functions {
         executeQuery(item: V, sessionKey: string): Promise<QueryResult>;
         executeQuery(item: V, options?: ExecuteQueryOptions | string): Promise<QueryResult>;
         executeBatchQuery(batch: V[], callback: ErrorQueryCallback, outResult?: BatchQueryResult): Promise<BatchQueryResult>;
-        executeBatchQuery(batch: V[], sessionKey: string, outResult?: BatchQueryResult): Promise<BatchQueryResult>;
-        executeBatchQuery(batch: V[], options?: ExecuteBatchQueryOptions | string, outResult?: BatchQueryResult): Promise<BatchQueryResult>;
+        executeBatchQuery(batch: V[], sessionKey: string | undefined, outResult?: BatchQueryResult): Promise<BatchQueryResult>;
+        executeBatchQuery(batch: V[], options?: ExecuteBatchQueryOptions, outResult?: BatchQueryResult): Promise<BatchQueryResult>;
         processRows(batch: V[], tasks: Promise<QueryResult | null>[], parallel: boolean): Promise<BatchQueryResult>;
         processRows(batch: V[], tasks: Promise<QueryResult | null>[], options?: ProcessRowsOptions | boolean, outResult?: BatchQueryResult): Promise<BatchQueryResult>;
         handleFail(err: unknown, item: V, options?: HandleFailOptions): boolean;
@@ -409,10 +409,10 @@ declare namespace functions {
         put<V extends PutOptions>(uri: string | URL, data: unknown, options: V): Promise<DataObjectResult<V>>;
         put<V extends PutOptions>(uri: string | URL, data: unknown, contentType?: string | V, options?: V): Promise<DataObjectResult<V>>;
         post<V extends { format: undefined; encoding: undefined }>(uri: string | URL, data: unknown, contentType: string): Promise<DataObjectResult<V>>;
-        post<V extends { format: undefined; encoding: undefined }>(uri: string | URL, parts: FormDataPart[]): Promise<DataObjectResult<V>>;
-        post<V extends { format: undefined; encoding: undefined }>(uri: string | URL, form: AnyObject, parts: FormDataPart[]): Promise<DataObjectResult<V>>;
+        post<V extends { format: undefined; encoding: undefined }>(uri: string | URL, parts: PostFileParts): Promise<DataObjectResult<V>>;
+        post<V extends { format: undefined; encoding: undefined }>(uri: string | URL, form: AnyObject, parts: PostFileParts): Promise<DataObjectResult<V>>;
         post<V extends PostOptions>(uri: string | URL, data: unknown, options: V): Promise<DataObjectResult<V>>;
-        post<V extends PostOptions>(uri: string | URL, data: unknown, contentType?: string | FormDataPart[] | V, options?: V): Promise<DataObjectResult<V>>;
+        post<V extends PostOptions>(uri: string | URL, data: unknown, contentType?: string | PostFileParts | V, options?: V): Promise<DataObjectResult<V>>;
         get<V extends OpenOptions & { encoding: BufferEncoding }>(uri: string | URL, options: V): Promise<string>;
         get<V extends BufferFormat>(uri: string | URL, format: V): Promise<object | null>;
         get<V extends OpenOptions, W extends V | BufferFormat>(uri: string | URL, options?: W): Promise<W extends BufferFormat ? object | null : DataEncodedResult<V>>;
@@ -884,11 +884,17 @@ declare namespace functions {
         readBuffer(value: string | URL, cache?: boolean | ReadBufferOptions): Buffer | null;
         resolveMime(data: FileTypeFormat): 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;
+        /** @deprecated class */
+        initCpuUsage(instance?: IModule, thread?: boolean): CpuUsage;
+        /** @deprecated private */
+        getCpuUsage(start: CpuUsage, format: true, thread?: boolean): string;
+        /** @deprecated private */
+        getCpuUsage(start: CpuUsage, format?: boolean, thread?: boolean): number;
+        /** @deprecated private */
         getMemUsage(format: true | "%" | Unit, free?: boolean): string;
+        /** @deprecated private */
         getMemUsage(format?: boolean, free?: boolean): number;
+        /** @deprecated private */
         formatCpuMem(start: CpuUsage, all?: boolean): string;
         getPackageVersion(name: string | [string, string], options?: PackageVersionOptions): string;
         checkSemVer(name: string | [string, string], options: CheckSemVerOptions): boolean;

package/lib/module.d.ts

@@ -57,6 +57,7 @@ export interface CopyFileOptions extends FileSystemOptions {
     overwrite?: boolean;
     createDir?: boolean;
     outSrc?: string;
+    mode?: number;
 }
 
 export interface RemoveDirOptions extends FileSystemOptions {

package/lib/object.d.ts

@@ -34,4 +34,8 @@ interface MinMax<T = number> {
 }
 
 /** @deprecated lib/node **/
-type HighResolutionTime = bigint | [number, number];
+type HighResolutionTime = bigint | [number, number];
+
+interface RegExpConstructor {
+    escape(value: string): string;
+}

package/lib/request.d.ts

@@ -189,7 +189,7 @@ export interface PutOptions extends OpenOptions {
 }
 
 export interface PostOptions extends PutOptions {
-    formData?: FormDataPart | FormDataPart[];
+    formData?: FormDataPart | File | PostFileParts;
 }
 
 export interface FormDataPart {
@@ -271,6 +271,7 @@ export interface AltSvcData {
 export type HttpMethod = "GET" | "POST" | "PUT" | "HEAD" | "DELETE";
 export type BufferFormat = "json" | "yaml" | "json5" | "xml" | "toml";
 export type ReadExpectType = "always" | "string" | "none";
+export type PostFileParts = (File | FormDataPart)[];
 export type DataEncodedResult<T extends { encoding?: BufferEncoding }> = T extends { encoding: BufferEncoding } ? string : Bufferable | null;
 export type DataObjectResult<T extends { format?: unknown; encoding?: BufferEncoding }> = T extends { format: string | PlainObject } ? object | null : DataEncodedResult<T>;
 export type StatusOnCallback = (code: number, headers: IncomingHttpHeaders, url?: URL) => boolean | void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@e-mc/types",
-  "version": "0.13.7",
+  "version": "0.13.8",
   "description": "Type definitions for E-mc.",
   "main": "index.js",
   "types": "index.d.ts",