@e-mc/types 0.13.9 → 0.14.0

package/README.md

@@ -1,6 +1,6 @@
 # @e-mc/types
 
-* NodeJS 18.20 LTS
+* NodeJS 20 (Minimum 18)
 * ES2022
 
 ## General Usage
@@ -9,7 +9,7 @@
 
 ## Interface
 
-* [View Source](https://www.unpkg.com/@e-mc/types@0.13.9/index.d.ts)
+* [View Source](https://www.unpkg.com/@e-mc/types@0.14.0/index.d.ts)
 
 ```typescript
 import type { LogArguments } from "./lib/logger";
@@ -31,7 +31,7 @@ function mainFlag(value: unknown): boolean;
 function existsFlag(value: unknown): boolean;
 function getLogCurrent(): LogArguments | null;
 function setLogCurrent(value: LogArguments): void;
-function setTempDir(value: string): boolean;
+function setTempDir(value: string, lock?: boolean): boolean;
 function getTempDir(create: true, prefix?: string): string;
 function getTempDir(...values: string[]): string;
 function isArray(value: unknown): value is unknown[];
@@ -39,9 +39,12 @@ function isObject(value: unknown): value is object;
 function isPlainObject(value: unknown): value is Record<string | number | symbol, unknown>;
 function isString(value: unknown): value is string;
 function isEmpty(value: unknown): boolean;
-function isFunction(value: unknown, cjs?: boolean): value is Function;
+function isFunction(value: unknown, cjs: boolean): value is Function;
+function isFunction(value: unknown, type?: string): value is Function;
+function isError(err: unknown, ...name: string[]): err is Error;
 function isErrorCode(err: unknown, ...code: unknown[]): err is Required<ErrorCode>;
 function asFunction(value: unknown, sync?: boolean): ((...args: unknown[]) => unknown) | null;
+function asExt(value: string): string;
 function parseTime(value: number | string, epoch: true): number;
 function parseTime(value: number | string, negative: false): number;
 function parseTime(value: number | string, start?: number): number;
@@ -53,6 +56,7 @@ function convertTime(value: number | string): number;
 function convertTime(value: HighResolutionTime, format: true): string;
 function convertTime(value: HighResolutionTime, format?: boolean): number;
 function hasGlob(value: string): boolean;
+/** @deprecated RegExp.escape */
 function escapePattern(value: unknown, symbols?: boolean): string;
 function renameExt(value: string, ext: string, when?: string): string;
 function formatSize(value: string): number;
@@ -60,8 +64,7 @@ function formatSize(value: number, options?: BytesOptions): string;
 function alignSize(value: unknown, kb?: number, factor?: number): number;
 function cascadeObject(data: object, query: string, fallback?: unknown): unknown;
 function cloneObject(data: unknown, deep: boolean): unknown;
-/** @deprecated WeakMap<object> */
-function cloneObject<T>(data: T, deepIgnore: WeakSet<object> | WeakMap<object, object>): T;
+function cloneObject<T>(data: T, deepIgnore: WeakMap<object, object>): T;
 function cloneObject(data: unknown, options?: CloneObjectOptions<unknown>): unknown;
 function coerceObject(data: unknown, cache: boolean): unknown;
 function coerceObject(data: unknown, parseString?: (...args: [string]) => unknown, cache?: boolean): unknown;
@@ -74,6 +77,7 @@ function validateUUID(value: unknown): boolean;
 function sanitizeCmd(value: string, ...args: unknown[]): string;
 function sanitizeArgs(value: string, doubleQuote?: boolean): string;
 function sanitizeArgs(values: string[], doubleQuote?: boolean): string[];
+/** @deprecated crypto.randomUUID */
 function randomString(format: string, dictionary?: string): string;
 function errorValue(value: string, hint?: string): Error;
 function errorMessage(title: number | string, value: string, hint?: string): Error;
@@ -209,14 +213,15 @@ const IMPORT_MAP: Record<string, string | undefined>;
 
 ## References
 
-- https://www.unpkg.com/@e-mc/types@0.13.9/index.d.ts
-- https://www.unpkg.com/@e-mc/types@0.13.9/lib/logger.d.ts
-- https://www.unpkg.com/@e-mc/types@0.13.9/lib/module.d.ts
-- https://www.unpkg.com/@e-mc/types@0.13.9/lib/node.d.ts
+- https://www.unpkg.com/@e-mc/types@0.14.0/index.d.ts
+- https://www.unpkg.com/@e-mc/types@0.14.0/lib/logger.d.ts
+- https://www.unpkg.com/@e-mc/types@0.14.0/lib/node.d.ts
 
-* https://developer.mozilla.org/en-US/docs/Web/API/DOMException
+* https://www.npmjs.com/package/@types/node
 * https://www.npmjs.com/package/@types/bytes
 
+* https://developer.mozilla.org/en-US/docs/Web/API/DOMException
+
 ## LICENSE
 
 BSD 3-Clause

package/constant.d.ts

@@ -1,7 +1,8 @@
 export const enum INTERNAL {
-    VERSION = '0.13.9',
+    VERSION = '0.14.0',
     TEMP_DIR = 'tmp',
-    CJS = '__cjs__'
+    CJS = '__cjs__',
+    FUNCTION_TYPE = '__type__'
 }
 
 export const enum VAL_MESSAGE {
@@ -80,6 +81,7 @@ export const enum ERR_MESSAGE {
     UNSUPPORTED_WRITE = 'Not permitted to write file',
     UNSUPPORTED_OVERWRITE = 'Not permitted to overwrite file',
     UNSUPPORTED_PATH = 'Not permitted to set absolute path',
+    UNSUPPORTED_PROCESS = 'Not implemented by runtime application',
     NOTFOUND_PATH = 'Path not found',
     NOTFOUND_FILE = 'File not found',
     NOTFOUND_BINARY = 'Binary not found',
@@ -296,7 +298,8 @@ export const enum LOG_TYPE {
     PERMISSION = 8192,
     TIMEOUT = 16384,
     STDOUT = 32768,
-    DB = 65536
+    DB = 65536,
+    USER = 131072
 }
 
 export const enum LOG_STATE {

package/index.d.ts

@@ -29,6 +29,7 @@ declare namespace types {
         TIMEOUT: 16384;
         STDOUT: 32768;
         DB: 65536;
+        USER: 131072;
     }
 
     const LOG_TYPE: {
@@ -50,6 +51,7 @@ declare namespace types {
         TIMEOUT: 16384;
         STDOUT: 32768;
         DB: 65536;
+        USER: 131072;
     };
 
     interface LOG_STATE {
@@ -269,8 +271,7 @@ declare namespace types {
     interface CloneObjectOptions<T = unknown> {
         target?: T;
         deep?: boolean;
-        /** @deprecated WeakSet<object> */
-        deepIgnore?: WeakSet<object> | WeakMap<object, object>;
+        deepIgnore?: WeakMap<object, object>;
         freezeDepth?: number | boolean;
         mergeArray?: MergeArrayMethod;
         mergeDepth?: number;
@@ -300,7 +301,7 @@ declare namespace types {
     function existsFlag(value: unknown): boolean;
     function getLogCurrent(): LogArguments | null;
     function setLogCurrent(value: LogArguments | null): void;
-    function setTempDir(value: string): boolean;
+    function setTempDir(value: string, lock?: boolean): boolean;
     function getTempDir(create: true, prefix?: string): string;
     function getTempDir(...values: string[]): string;
     function isArray<T>(value: unknown): value is T[];
@@ -308,9 +309,12 @@ declare namespace types {
     function isPlainObject<T = PlainObject>(value: unknown): value is T;
     function isString<T extends string>(value: unknown): value is T;
     function isEmpty(value: unknown): boolean;
-    function isFunction<T extends Function>(value: unknown, cjs?: boolean): value is T;
+    function isFunction<T extends Function>(value: unknown, cjs: boolean): value is T;
+    function isFunction<T extends Function>(value: unknown, type?: string): value is T;
+    function isError<T extends Error>(err: unknown, ...name: string[]): err is T;
     function isErrorCode<T extends unknown[]>(err: unknown, ...code: T): err is Required<ErrorCode<T[number]>>;
     function asFunction<U = unknown, V = unknown>(value: unknown, sync?: boolean): FunctionType<U, V> | null;
+    function asExt(value: string): string;
     function parseTime(value: number | string, epoch: true): number;
     function parseTime(value: number | string, negative: false): number;
     function parseTime(value: number | string, start?: number): number;
@@ -322,6 +326,7 @@ declare namespace types {
     function convertTime(value: HighResolutionTime, format: true): string;
     function convertTime(value: HighResolutionTime, format?: boolean): number;
     function hasGlob(value: string): boolean;
+    /** @deprecated RegExp.escape */
     function escapePattern(value: unknown, symbols?: boolean): string;
     function renameExt(value: string, ext: string, when?: string): string;
     function formatSize(value: string): number;
@@ -329,17 +334,18 @@ declare namespace types {
     function alignSize(value: unknown, kb?: number, factor?: number): number;
     function cascadeObject<T = unknown>(data: object, query: string, fallback?: unknown): T;
     function cloneObject<T>(data: T, deep: boolean): T;
-    /** @deprecated WeakMap<object> */
-    function cloneObject<T>(data: T, deepIgnore: WeakSet<object> | WeakMap<object, object>): T;
+    function cloneObject<T>(data: T, deepIgnore: WeakMap<object, object>): T;
     function cloneObject<T, U>(data: T, options?: CloneObjectOptions<U>): T;
     function coerceObject<T = unknown>(data: T, cache: boolean): T;
     function coerceObject<T = unknown>(data: T, parseString?: FunctionArgs<[string]>, cache?: boolean): T;
     function getEncoding(value: unknown, fallback?: BufferEncoding): BufferEncoding;
+    function getAlgorithm(value: unknown, fallback?: string): string | undefined;
     function encryptUTF8(algorithm: CipherGCMTypes, key: BinaryLike, iv: BinaryLike, data: string, encoding?: Encoding): string | undefined;
     function decryptUTF8(algorithm: CipherGCMTypes, key: BinaryLike, iv: BinaryLike, data: string, encoding?: Encoding): string | undefined;
     function hashKey(data: BinaryLike, algorithm?: string, encoding?: BinaryToTextEncoding): string;
     function incrementUUID(restart?: boolean): string;
     function validateUUID(value: unknown): boolean;
+    /** @deprecated crypto.randomUUID */
     function randomString(format: string, dictionary?: string): string;
     function sanitizeCmd(value: string, ...args: unknown[]): string;
     function sanitizeArgs(value: string, doubleQuote?: boolean): string;