@e-mc/types 0.10.5 → 0.10.7

package/README.md

@@ -9,7 +9,7 @@
 
 ## Interface
 
-* [View Source](https://www.unpkg.com/@e-mc/types@0.10.5/index.d.ts)
+* [View Source](https://www.unpkg.com/@e-mc/types@0.10.7/index.d.ts)
 
 ```typescript
 import type { LogArguments } from "./lib/logger";
@@ -68,6 +68,7 @@ function validateUUID(value: unknown): boolean;
 function randomString(format: string, dictionary?: string): string;
 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 purgeMemory(percent?: number): number;
@@ -196,10 +197,10 @@ const IMPORT_MAP: Record<string, string | undefined>;
 
 ## References
 
-- https://www.unpkg.com/@e-mc/types@0.10.5/index.d.ts
-- https://www.unpkg.com/@e-mc/types@0.10.5/lib/logger.d.ts
-- https://www.unpkg.com/@e-mc/types@0.10.5/lib/module.d.ts
-- https://www.unpkg.com/@e-mc/types@0.10.5/lib/object.d.ts
+- https://www.unpkg.com/@e-mc/types@0.10.7/index.d.ts
+- https://www.unpkg.com/@e-mc/types@0.10.7/lib/logger.d.ts
+- https://www.unpkg.com/@e-mc/types@0.10.7/lib/module.d.ts
+- https://www.unpkg.com/@e-mc/types@0.10.7/lib/object.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.9.15',
+    VERSION = '0.10.7',
     TEMP_DIR = 'tmp',
     CJS = '__cjs__'
 }
@@ -8,6 +8,7 @@ export const enum VAL_MESSAGE {
     SUCCESS = 'Success',
     COMPLETED = 'Completed',
     CHECKSUM = 'Checksum matched',
+    MODIFIED_FILE = 'File modified',
     MODIFIED_DIRECTORY = 'Directory was modified',
     COMMIT_TRANSACTION = 'Transactions were committed'
 }
@@ -38,18 +39,22 @@ export const enum ERR_MESSAGE {
     FAIL = 'FAIL!',
     WARN = 'WARN!',
     ABORTED = 'Aborted',
+    EXPIRED = 'Expired',
     ABORTED_HOST = 'Aborted by host',
     ABORTED_CLIENT = 'Aborted by client',
     ABORTED_PROCESS = 'Aborted by process',
-    ABORTED_OPERATION = 'The operation was aborted',
+    ABORTED_OPERATION = 'This operation was aborted',
     FAILED = 'Failed',
     FAILED_CHECKSUM = 'Checksum did not match',
     PARAMETERS = 'Invalid parameters',
     FORMAT = 'Invalid format',
     CHECKSUM = 'Invalid checksum',
+    CONFIG = 'Invalid config',
     RESPONSE = 'Invalid response',
+    FUNCTION = 'Invalid function',
     SIZE = 'Size limit was exceeded',
     ERROR_CODE = 'Error code',
+    BUSY_RESOURCE = 'Resource already in use',
     PERMISSION = 'Operation not permitted',
     EXEC_PERMISSION = 'Exec command not permitted',
     NOT_CACHEABLE = 'Not able to cache',
@@ -64,6 +69,7 @@ export const enum ERR_MESSAGE {
     TIMEOUT = 'Timeout was exceeded',
     HANDLED_REJECTION = 'Handled rejection',
     UNSUPPORTED_ACCESS = 'Unsupported access',
+    UNSUPPORTED_PROTOCOL = 'Unsupported protocol',
     UNSUPPORTED_MIME = 'Unsupported MIME',
     UNSUPPORTED_READ = 'Not permitted to read file',
     UNSUPPORTED_WRITE = 'Not permitted to write file',
@@ -72,6 +78,7 @@ export const enum ERR_MESSAGE {
     NOTFOUND_BINARY = 'Binary not found',
     NOTFOUND_PACKAGE = 'Package not found',
     NOTFOUND_MIME = 'MIME not found',
+    NOTFOUND_TLS = 'TLS/SSL key and cert not found',
     INSTALL = 'Install required?',
     INLINE_METHOD = 'Unable to parse inline method',
     INLINE_OBJECT = 'Unable to parse inline object',
@@ -118,6 +125,7 @@ export const enum ERR_DB {
     TABLE = 'Missing database table',
     QUERY = 'Missing database query',
     CONNECTION = 'Missing connection string',
+    TLS = 'Missing TLS/SSL credentials',
     CLIENT = 'Unable to configure client',
     EXEC_QUERY = 'Unable to execute query',
     FILTER_QUERY = 'Unable to filter results',
@@ -159,6 +167,10 @@ export const enum ERR_CLOUD {
     METADATA_FAIL = 'Metadata failed'
 }
 
+export const enum ERR_COMPRESS {
+    API_KEY = 'Missing API key'
+}
+
 export const enum ERR_IMAGE {
     ROTATE = 'Unable to rotate image',
     FINALIZE = 'Unable to finalize image',
@@ -168,7 +180,16 @@ export const enum ERR_IMAGE {
 
 export const enum ERR_HTTP {
     HEADERS = 'Unable to process headers',
+    FORMAT = 'Unable to parse URI response',
+    SERVER_WEBSOCKET = 'Unable to create WebSocket server',
     ETAG = 'ETag not supported',
+    REQUEST = 'Invalid HTTP request',
+    TIMEOUT = 'HTTP request timeout',
+    TIMEOUT_CONNECTION = 'HTTP connection timeout',
+    DATA_RECEIVED = 'No data received',
+    REDIRECT_LIMIT = 'Exceeded redirect limit',
+    REDIRECT_FOLLOW = 'Follow redirect was disabled',
+    REDIRECT_MISSING = 'Missing redirect location',
     DOWNLOAD_SUCCESS = 'No files were successfully downloaded',
     MULTIPART_ATTACH = 'No files were attached'
 }
@@ -229,6 +250,14 @@ export const enum PACKAGE_NAME {
     WATCH_FILEGROUP = '@e-mc/watch/filegroup'
 }
 
+export const enum MIME_TYPE {
+    MULTIPART = 'multipart/form-data',
+    URLENCODED = 'application/x-www-form-urlencoded',
+    JSON = 'application/json',
+    TEXT = 'text/plain',
+    OCTET_STREAM = 'application/octet-stream'
+}
+
 export const enum ASSET_FLAG {
     NONE = 0,
     IGNORE = 1,
@@ -263,15 +292,15 @@ export const enum LOG_TYPE {
 }
 
 export const enum LOG_STATE {
-    STDIN = 0,
-    STDOUT = 1,
-    STDERR = 2
+    STDIN,
+    STDOUT,
+    STDERR
 }
 
 export const enum READDIR_SORT {
-    FILE = 0,
-    DIRECTORY = 1,
-    DESCENDING = 2
+    FILE,
+    DIRECTORY,
+    DESCENDING
 }
 
 export const enum SETTINGS_KEY_NAME {

package/index.d.ts

@@ -1,18 +1,14 @@
+/// <reference lib="dom" />
 /// <reference path="./lib/type.d.ts" />
 /// <reference path="./lib/object.d.ts" />
 
 import type { LogArguments } from './lib/logger';
-import type { CloneObjectOptions } from './lib/module';
 
-import type { BinaryLike, CipherGCMTypes, Encoding } from 'crypto';
+import type { BinaryLike, BinaryToTextEncoding, CipherGCMTypes, Encoding, RandomUUIDOptions } from 'crypto';
 
 // @ts-ignore
 import type { BytesOptions } from 'bytes';
 
-declare class AbortError extends Error {
-    code: string;
-}
-
 declare namespace types {
     interface LOG_TYPE {
         UNKNOWN: 0;
@@ -266,10 +262,24 @@ declare namespace types {
 
     const IMPORT_MAP: StringMap;
 
+    interface CloneObjectOptions<T = unknown> {
+        target?: T;
+        deep?: boolean;
+        deepIgnore?: WeakSet<object>;
+        mergeArray?: MergeArrayMethod;
+        mergeDepth?: number;
+        typedArray?: boolean;
+        symbol?: boolean;
+        inherited?: boolean;
+        nonenumerable?: boolean;
+        preserve?: boolean;
+    }
+
+    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];
 
     function createAbortError(reject: true): Promise<never>;
-    function createAbortError(): AbortError;
+    function createAbortError(): DOMException;
     function hasBit(value: unknown, flags: number): boolean;
     function ignoreFlag(value: unknown): boolean;
     function cloneFlag(value: unknown): boolean;
@@ -280,7 +290,7 @@ declare namespace types {
     function mainFlag(value: unknown): boolean;
     function existsFlag(value: unknown): boolean;
     function getLogCurrent(): Null<LogArguments>;
-    function setLogCurrent(value: LogArguments): void;
+    function setLogCurrent(value: Null<LogArguments>): void;
     function setTempDir(value: string): boolean;
     function getTempDir(): string;
     function isArray<T>(value: unknown): value is T[];
@@ -289,11 +299,11 @@ declare namespace types {
     function isString(value: unknown): value is string;
     function isEmpty(value: unknown): boolean;
     function asFunction<U = unknown, V = unknown>(value: unknown, sync?: boolean): Null<FunctionType<U, V>>;
-    function parseTime(value: NumString, start?: number): number;
-    function parseExpires(value: NumString, start?: number): number;
+    function parseTime(value: number | string, start?: number): number;
+    function parseExpires(value: number | string, start?: number): number;
     function formatTime(value: number, char: string): string;
     function formatTime(value: number, elapsed?: boolean, char?: string): string;
-    function convertTime(value: NumString): number;
+    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;
@@ -311,13 +321,17 @@ declare namespace types {
     function getEncoding(value: unknown, fallback?: BufferEncoding): BufferEncoding;
     function encryptUTF8(algorithm: CipherGCMTypes, key: BinaryLike, iv: BinaryLike, data: string, encoding?: Encoding): Undef<string>;
     function decryptUTF8(algorithm: CipherGCMTypes, key: BinaryLike, iv: BinaryLike, data: string, encoding?: Encoding): Undef<string>;
-    /** @deprecated crypto.randomUUID */
-    function generateUUID(): string;
+    function hashKey(data: BinaryLike, algorithm?: string, encoding?: BinaryToTextEncoding): string;
+    /** @deprecated - crypto.randomUUID */
+    function generateUUID(options?: RandomUUIDOptions): string;
     function incrementUUID(restart?: boolean): string;
     function validateUUID(value: unknown): boolean;
     function randomString(format: string, dictionary?: string): string;
     function errorValue(value: string, hint?: string): Error;
-    function errorMessage(title: NumString, 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 purgeMemory(percent?: number): number;
 }
 

package/index.js

@@ -91,6 +91,9 @@ function fromObject(value, typedArray) {
         if (value instanceof RegExp) {
             return new RegExp(value);
         }
+        if (value instanceof URL) {
+            return new URL(value);
+        }
         if (typedArray) {
             if (value instanceof Buffer) {
                 return Buffer.from(value);
@@ -1076,10 +1079,12 @@ function errorValue(value, hint) {
     return new Error(value + (hint ? ` (${hint})` : ''));
 }
 function errorMessage(title, value, hint) {
-    return new Error((title !== '' ? title + ': ' : '') + value + (hint ? ` (${hint})` : ''));
+    return new Error((isString(title) || typeof title === 'number' ? title + ': ' : '') + value + (hint ? ` (${hint})` : ''));
 }
 function purgeMemory(percent) {
     CACHE_COERCED = new WeakSet();
+    INCREMENT_COUNT = 65536;
+    LOG_CURRENT = null;
 }
 function incrementUUID(restart) {
     if (restart || INCREMENT_COUNT === 65536) {
@@ -1096,10 +1101,14 @@ function hashKey(data, algorithm = 'md5', encoding = 'base64') {
         return crypto.randomUUID();
     }
 }
-function supported(major, minor = 0, patch = 0, lts) {
+function supported(major, minor = 0, patch = 0, lts = false) {
     if (VER_MAJOR < major) {
         return false;
     }
+    if (typeof patch === 'boolean') {
+        lts = patch;
+        patch = 0;
+    }
     if (VER_MAJOR === major) {
         if (VER_MINOR < minor) {
             return false;

package/lib/asset.d.ts

@@ -15,7 +15,7 @@ export interface BinaryAction {
 }
 
 export interface StreamAction {
-    minStreamSize?: NumString;
+    minStreamSize?: number | string;
 }
 
 export interface FileData<T extends ExternalAsset> extends MimeTypeAction {
@@ -74,4 +74,4 @@ export interface ExternalAsset extends FileAsset, BundleAction, BinaryAction, St
     invalid?: boolean;
 }
 
-export type HashAlgorithm = "md5" | "sha1" | "sha256" | "sha224" | "sha384" | "sha512";
+export type HashAlgorithm = "md5" | "sha1" | "sha256" | "sha224" | "sha384" | "sha512" | "ripemd" | "ripemd-160";

package/lib/cloud.d.ts

@@ -43,7 +43,7 @@ export interface CloudStorageAdmin<T = unknown, U = string, V = unknown, W = unk
 export interface CloudStorageAction<T = unknown, U = string, V = unknown, W = unknown, X = unknown, Y = unknown> extends Partial<LocationUri>, StreamAction {
     active?: boolean;
     overwrite?: boolean;
-    chunkSize?: NumString;
+    chunkSize?: number | string;
     chunkLimit?: number;
     flags?: number;
     admin?: CloudStorageAdmin<T, U, V, W, X, Y>;

package/lib/compat-v4.d.ts

@@ -1,12 +1,13 @@
 import type { CloudConstructor, FileManagerConstructor, ICloud, IFileManager, IHost, IModule, ModuleConstructor, WatchConstructor } from './index';
 
+import type { CloneObjectOptions } from '../index.d';
 import type { ExternalAsset } from './asset';
 import type { CacheOptions } from './core';
 import type { QueryResult } from './db';
 import type { ITransformSeries, OutV3, TransformSeriesConstructor } from './document';
 import type { IHttpMemoryCache } from './filemanager';
 import type { HttpAgentSettings, HttpProtocolVersion, HttpRequestClient, InternetProtocolVersion } from './http';
-import type { CloneObjectOptions, GetFunctionsOptions } from './module';
+import type { ParseFunctionOptions } from './module';
 import type { LogFailOptions, LogType, LogValue } from './logger';
 import type { HostConfig, OpenOptions, ProxySettings } from './request';
 import type { DbCoerceSettings, DnsLookupSettings, HttpMemorySettings, HttpSettings } from './settings';
@@ -17,6 +18,10 @@ import type { Readable, Writable } from 'stream';
 
 type CpuUsage = NodeJS.CpuUsage;
 
+export interface GetFunctionsOptions extends ParseFunctionOptions {
+    outFailed?: string[];
+}
+
 export interface IModuleLibV4 {
     isString(value: unknown): value is string;
     isObject<T = object>(value: unknown): value is T;
@@ -30,12 +35,12 @@ export interface IModuleLibV4 {
     isFileHTTP(value: string | URL): boolean;
     isFileUNC(value: string | URL): boolean;
     isPathUNC(value: string | URL): boolean;
-    toTimeMs(hrtime: HighResolutionTime, format?: boolean): NumString;
+    toTimeMs(hrtime: HighResolutionTime, format?: boolean): number | string;
     renameExt(value: string, ext: string, when?: string): string;
     existsSafe(value: string, isFile?: boolean): boolean;
     readFileSafe(value: string, encoding: BufferEncoding | "buffer", cache?: boolean): Null<Bufferable>;
     getFunctions<T extends FunctionType>(values: unknown[], absolute?: boolean | GetFunctionsOptions, sync?: boolean, outFailed?: string[]): T[];
-    formatSize(value: NumString, options?: PlainObject): NumString;
+    formatSize(value: number | string, options?: PlainObject): number | string;
     hasSameStat(src: string, dest: string, keepEmpty?: boolean): boolean;
     hasSize(value: string, keepEmpty?: boolean): boolean;
     getSize(value: string, diskUsed?: boolean): number;
@@ -62,7 +67,7 @@ export interface IFileManagerCompatV4<T extends ExternalAsset = ExternalAsset> e
     httpProxy: Null<ProxySettings>;
     acceptEncoding: boolean;
     keepAliveTimeout: number;
-    addDns(hostname: string, address: string, family?: NumString): void;
+    addDns(hostname: string, address: string, family?: number | string): void;
     lookupDns(hostname: string): LookupFunction;
     getHttpProxy(uri: string, localhost?: boolean): Null<ProxySettings>;
     getHttpHeaders(uri: string): Undef<OutgoingHttpHeaders>;
@@ -75,7 +80,7 @@ export interface IFileManagerCompatV4<T extends ExternalAsset = ExternalAsset> e
 }
 
 export interface FileManagerCompatV4Constructor<T extends ExternalAsset = ExternalAsset> extends FileManagerConstructor<T> {
-    fromHttpStatusCode(value: NumString): string;
+    fromHttpStatusCode(value: number | string): string;
     resetHttpHost(version?: HttpProtocolVersion): void;
     defineHttpBuffer(options: HttpMemorySettings): void;
     defineHttpSettings(options: HttpSettings): void;
@@ -105,7 +110,7 @@ export interface WatchCompatV4Constructor<T extends IFileManager<U>, U extends E
     readTLSKey(value: string, cache?: boolean): string;
     readTLSCert(value: string, cache?: boolean): string;
     isCert(value: string): boolean;
-    parseExpires(value: NumString, start?: number): number;
+    parseExpires(value: number | string, start?: number): number;
 }
 
 export interface ITransformSeriesCompatV4<T = AnyObject, U = T> extends ITransformSeries<T, U>, PropertyAction<OutV3, "out"> {}

package/lib/compress.d.ts

@@ -1,25 +1,26 @@
-import type { CompressFormat as ICompressFormat } from './squared';
+import type { CompressFormat as ICompressFormat, CompressLevel as ICompressLevel } from './squared';
 
 import type { LogBaseOptions, LogTime } from './logger';
+import type { ThrowsAction } from './module';
 
 type ResultCallback<T = Null<Buffer | Uint8Array>> = (err: unknown, data?: T, ext?: string) => void;
 type ResultData = Null<Buffer | Uint8Array> | string;
 
-export interface CompressFormat extends ICompressFormat, LogBaseOptions {
+export interface CompressFormat extends ICompressFormat, LogBaseOptions, ReadableOptions {
     filename?: string;
+    mimeType?: string;
     startTime?: LogTime;
     etag?: string;
-    proxyUrl?: string | ((uri: string) => Undef<string>);
     outExt?: string;
     outFile?: string;
 }
 
-export interface Woff {
-    toWoff(this: void, data: BufferLike): Buffer;
-    toSfnt(this: void, data: BufferLike): Buffer;
-}
+export interface CompressLevel extends ICompressLevel, ReadableOptions {}
+
+export interface ReadableOptions extends ThrowsAction {}
 
 export type BufferLike = Buffer | Uint8Array | ArrayBuffer | SharedArrayBuffer | readonly number[];
 export type TryFileCompressor = (data: string | Buffer, output: string, config: CompressFormat, callback?: ResultCallback<ResultData>) => Void<Promise<ResultData>>;
 export type TryFileCompressorAsync = (data: string | Buffer, output: string, config: CompressFormat) => Promise<ResultData>;
-export type BufferResult = Null<Buffer | Uint8Array>;
+export type BufferResult = Null<Buffer | Uint8Array>;
+export type PluginCompressor = FunctionArgs<[CompressFormat['options'], string?], FunctionArgs<[Buffer], Promise<Buffer | Uint8Array>>>;

package/lib/core.d.ts

@@ -1,5 +1,3 @@
-/* eslint @typescript-eslint/no-explicit-any: "off" */
-
 import type { DataSource, RequestBase } from './squared';
 
 import type { IExternalConfig, IExternalFunction, IHost, IModule, ModuleConstructor } from './index';
@@ -42,6 +40,7 @@ export interface IClientDb<T extends IHost, U extends ClientModule<ClientDbSetti
     getQueryResult(source: string, credential: unknown, queryString: string, options?: CacheOptions | string, renewCache?: boolean): Undef<QueryResult>;
     setQueryResult(source: string, credential: unknown, queryString: string, result: unknown, sessionKey?: string): QueryResult;
     setQueryResult(source: string, credential: unknown, queryString: string, result: unknown, options?: CacheOptions | string): QueryResult;
+    getCacheResult(source: string, credential: unknown, queryString: string, cacheValue: CacheOptions, ignoreCache?: IntBool | FirstOf<number, number>): Undef<QueryResult>;
     applyState(items: ArrayOf<V>, value: number, as?: boolean): void;
     commit(items?: V[]): Promise<boolean>;
     valueOfKey(credential: unknown, name: keyof W, component?: keyof X): unknown;
@@ -62,8 +61,8 @@ export interface ClientDbConstructor<T extends IHost = IHost, U extends ClientMo
     readonly TRANSACTION_ABORT: number;
     readonly TRANSACTION_FAIL: number;
     loadSettings(settings: Pick<Settings, "process" | "memory">, password?: string): boolean;
-    getTimeout(value: Undef<NumString | TimeoutAction>): number;
-    convertTime(value: NumString): number;
+    getTimeout(value: Undef<number | string | TimeoutAction>): number;
+    convertTime(value: number | string): number;
     findResult(source: string, credential: unknown, queryString: string, timeout: number, sessionKey?: string | boolean, renewCache?: boolean): Undef<QueryResult>;
     storeResult(source: string, credential: unknown, queryString: string, result: QueryResult, options: StoreResultOptions): QueryResult;
     storeResult(source: string, credential: unknown, queryString: string, result: QueryResult, sessionKey: string, sessionExpires: number): QueryResult;
@@ -131,16 +130,17 @@ export interface PermissionAction {
     permission?: PermittedDirectories;
 }
 
-export interface HostInitConfig extends PlainObject, RequestBase<HostInitLog> {
+export interface HostInitConfig<T extends HostInitLog = HostInitLog> extends PlainObject, RequestBase<T> {
     username?: string;
     ignoreModules?: string[];
 }
 
 export interface HostInitLog {
     enabled?: boolean;
-    level?: NumString;
+    level?: number | string;
     exclude?: ArrayOf<string>;
     useColor?: boolean;
+    silent?: boolean;
     showProgress?: boolean;
 }
 
@@ -158,7 +158,7 @@ export interface StoreResultOptions {
 export interface CacheOptions {
     value?: DbCacheValue;
     renewCache?: boolean;
-    exclusiveOf?: [number, number?, number?];
+    exclusiveOf?: FirstOf<number, number>;
     sessionKey?: string;
 }
 

package/lib/db.d.ts

@@ -32,14 +32,12 @@ export interface ProcessRowsOptions {
     parallel?: boolean;
 }
 
-export interface DbConnection {
+export interface DbConnection extends Required<AuthValue> {
+    protocol: string;
     hostname: string;
-    password: string;
-    pathname: string;
     port: string;
-    protocol: string;
+    pathname: string;
     search: string;
-    username: string;
     database: string;
 }
 
@@ -56,7 +54,7 @@ export interface ServerAuth<T = number> extends AuthValue, IdentifierAction {
     database?: string;
 }
 
-export interface IDbPool<T extends DbDataSource = DbDataSource, U = unknown, V = unknown> {
+export interface IDbPool<T extends DbDataSource = DbDataSource, U = unknown, V = unknown, W = unknown> {
     client: U;
     lastAccessed: number;
     success: number;
@@ -65,7 +63,7 @@ export interface IDbPool<T extends DbDataSource = DbDataSource, U = unknown, V =
     uuidKey: Null<AuthValue>;
     add(item: T, uuidKey?: string): this;
     has(item: T): boolean;
-    getConnection(): Promise<V>;
+    getConnection(credential?: W): Promise<V>;
     remove(): void;
     detach(force?: boolean): Promise<void>;
     close(): Promise<void>;
@@ -78,16 +76,20 @@ export interface IDbPool<T extends DbDataSource = DbDataSource, U = unknown, V =
     set parent(value: ObjectMap<IDbPool<T>>);
 }
 
-export interface DbPoolConstructor<T extends DbDataSource = DbDataSource, U = unknown, V = unknown> {
-    findKey<W extends IDbPool, X extends DbDataSource>(pools: ObjectMap<W>, uuidKey: unknown, poolKey: Undef<string>, ...items: X[]): Null<W>;
-    validateKey<W extends IDbPool>(pools: ObjectMap<W>, username: string, uuidKey: unknown): [string, Null<W>];
-    checkTimeout<W extends IDbPool>(pools: ObjectMap<W>, value: number, limit?: number): Promise<number>;
-    readonly prototype: IDbPool<T, U, V>;
-    new(pool: U, poolKey: string, uuidKey?: Null<AuthValue>): IDbPool<T, U, V>;
+export interface DbPoolConstructor<T extends DbDataSource = DbDataSource, U = unknown, V = unknown, W = unknown> {
+    CACHE_UNUSED: readonly string[];
+    asString(credential: unknown): string;
+    sanitize(credential: unknown): unknown;
+    removeUUIDKey<X>(credential: X & IdentifierAction): X;
+    findKey<X extends IDbPool, Y extends DbDataSource>(pools: ObjectMap<X>, uuidKey: unknown, poolKey: Undef<string>, ...items: Y[]): Null<X>;
+    validateKey<X extends IDbPool>(pools: ObjectMap<X>, username: string, uuidKey: unknown): [string, Null<X>];
+    checkTimeout<X extends IDbPool>(pools: ObjectMap<X>, value: number, limit?: number): Promise<number>;
+    readonly prototype: IDbPool<T, U, V, W>;
+    new(pool: U, poolKey: string, uuidKey?: Null<AuthValue>): IDbPool<T, U, V, W>;
 }
 
 export interface TimeoutAction {
-    timeout?: NumString;
+    timeout?: number | string;
 }
 
 export type DbSource = "mariadb" | "mongodb" | "mssql" | "mysql" | "oracle" | "postgres" | "redis";

package/lib/document.d.ts

@@ -7,6 +7,7 @@ import type { LogComponent, LogDate } from './logger';
 import type { DocumentTransform } from './settings';
 
 export interface DocumentAsset extends ExternalAsset, StorageAction<CloudStorage> {
+    inlineFilename?: string;
     initialValue?: InitialValue & { inlineFilename?: string };
 }
 
@@ -15,7 +16,7 @@ export interface StartOfSourceMap {
     sourceRoot?: string;
 }
 
-export interface RawSourceMap<T = NumString> extends StartOfSourceMap {
+export interface RawSourceMap<T = number | string> extends StartOfSourceMap {
     version: T;
     sources: string[];
     names: string[];
@@ -88,7 +89,8 @@ export interface ITransformSeries<T = AnyObject, U = T> extends IModule, Transfo
     getMainFile(code?: string, imports?: StringMap): Undef<SourceInput<string>>;
     getSourceFiles(imports?: StringMap): Undef<SourceInput>;
     toBaseConfig(all?: boolean): T;
-    upgrade<V = unknown>(context: V, dirname?: string, name?: string): V;
+    upgrade<V = unknown>(context: V, dirname?: string, pkgname?: string): V;
+    upgradeESM<V = unknown>(context: V, dirname?: string, pkgname?: string): Promise<V>;
     set code(value);
     get code(): string;
     get out(): IOut;
@@ -174,8 +176,8 @@ export interface LintMessage {
 export interface GenerateLintTableOptions extends Partial<LocationUri> {
     leadingText?: string;
     trailingText?: string;
-    errorCount?: number;
-    warningCount?: number;
+    errorCount?: number | TupleOf<number>;
+    warningCount?: number | TupleOf<number>;
     fatalErrorCount?: number;
     timeStamp?: LogDate;
     ruleWidth?: number;

package/lib/filemanager.d.ts

@@ -10,13 +10,13 @@ import type { RequestInit } from './request';
 import type { FETCH_TYPE } from '../index.d';
 
 export const enum FINALIZE_STATE {
-    READY = 0,
-    COMMIT = 1,
-    END = 2,
-    RESTART = 3,
-    QUEUED = 4,
-    RESTARTED = 5,
-    ABORTED = 6
+    READY,
+    COMMIT,
+    END,
+    RESTART,
+    QUEUED,
+    RESTARTED,
+    ABORTED
 }
 
 export const enum INCREMENTAL {
@@ -26,8 +26,8 @@ export const enum INCREMENTAL {
     EXISTS = 'exists'
 }
 
-export interface RequestData<T extends ExternalAsset = ExternalAsset> extends IRequestData<T>, RequestInit {
-    timeout?: ObjectMap<NumString>;
+export interface RequestData<T extends ExternalAsset = ExternalAsset, U extends HostInitLog = HostInitLog> extends IRequestData<T, U>, RequestInit {
+    timeout?: ObjectMap<number | string>;
 }
 
 export interface InstallData<T extends IModule = IModule, U extends ModuleConstructor = ModuleConstructor> {
@@ -99,6 +99,7 @@ export interface DeleteFileAddendum {
 export interface HostInitLog extends IHostInitLog {
     useNumeric: boolean;
     showSize?: boolean;
+    showDiff?: string[];
 }
 
 export interface FindAssetOptions<T extends ExternalAsset = ExternalAsset> {

package/lib/http.d.ts

@@ -93,10 +93,11 @@ export interface SecureConfig<T = string, U = T> {
     key?: U;
     cert?: T;
     passphrase?: U;
+    ciphers?: string;
     version?: SecureVersion;
 }
 
-export interface ServerPort<T = NumString> {
+export interface ServerPort<T = number | string> {
     port?: T;
 }