@e-mc/types 0.10.6 → 0.11.1

package/lib/db.d.ts

@@ -1,6 +1,7 @@
 import type { DataSource, DbDataSource } from './squared';
 
 import type { CacheOptions, IdentifierAction } from './core';
+import type { AuthValue } from './http';
 
 import type { DB_TYPE } from '../index.d';
 
@@ -32,14 +33,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,16 +55,16 @@ 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;
     failed: number;
     poolKey: string;
-    uuidKey: Null<AuthValue>;
+    uuidKey: AuthValue | null;
     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,22 +77,26 @@ 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: string | undefined, ...items: Y[]): X | null;
+    validateKey<X extends IDbPool>(pools: ObjectMap<X>, username: string, uuidKey: unknown): [string, X | null];
+    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?: AuthValue | null): IDbPool<T, U, V, W>;
 }
 
 export interface TimeoutAction {
-    timeout?: NumString;
+    timeout?: number | string;
 }
 
 export type DbSource = "mariadb" | "mongodb" | "mssql" | "mysql" | "oracle" | "postgres" | "redis";
 export type QueryResult = unknown[];
-export type BatchQueryResult = Null<QueryResult>[];
-export type CheckObjectCallback = (item: DataSource, data: unknown) => Null<QueryResult>;
+export type BatchQueryResult = QueryResult | null[];
+export type CheckObjectCallback = (item: DataSource, data: unknown) => QueryResult | null;
 export type ErrorQueryCallback = (err: unknown, item: DbDataSource, commandType?: number) => boolean;
 
 export interface SQL_COMMAND {

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[];
@@ -59,7 +60,7 @@ export interface TransformAction {
 
 export interface TransformResult extends SourceCode {
     type?: string;
-    chunks?: Null<(SourceCode & ChunkFile)[]>;
+    chunks?: Array<SourceCode & ChunkFile> | null;
     sourceFiles?: string[];
 }
 
@@ -69,8 +70,8 @@ export interface TransformOutput extends Partial<LocationUri>, Omit<SourceInput<
     metadata?: unknown;
     external?: PlainObject;
     productionRelease?: boolean;
-    getMainFile?(code?: string, imports?: StringMap): Undef<SourceInput<string>>;
-    getSourceFiles?(imports?: StringMap): Undef<SourceInput>;
+    getMainFile?(code?: string, imports?: StringMap): SourceInput<string> | undefined;
+    getSourceFiles?(imports?: StringMap): SourceInput | undefined;
 }
 
 export interface TransformOptions<T = AnyObject, U = T> extends TransformOutput {
@@ -85,10 +86,11 @@ export interface ITransformSeries<T = AnyObject, U = T> extends IModule, Transfo
     init(instance: IModule, dirname?: string): this;
     close(instance: IModule): void;
     createSourceMap(value: string): SourceMap;
-    getMainFile(code?: string, imports?: StringMap): Undef<SourceInput<string>>;
-    getSourceFiles(imports?: StringMap): Undef<SourceInput>;
+    getMainFile(code?: string, imports?: StringMap): SourceInput<string> | undefined;
+    getSourceFiles(imports?: StringMap): SourceInput | undefined;
     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;
@@ -136,12 +138,12 @@ export interface SourceMap extends SourceCode {
     reset(): void;
     nextMap(name: string, code: string, map: unknown, sourceMappingURL?: string, emptySources?: boolean): boolean;
     set map(value);
-    get map(): Undef<RawSourceMap>;
+    get map(): RawSourceMap | undefined;
 }
 
 export interface SourceMapConstructor {
-    findSourceMap(code?: string, uri?: string): Undef<RawSourceMap>;
-    removeSourceMappingURL(value: string): [string, string?, Null<RawSourceMap>?];
+    findSourceMap(code?: string, uri?: string): RawSourceMap | undefined;
+    removeSourceMappingURL(value: string): [string, string?, (RawSourceMap | null)?];
     isRaw(map: unknown): map is RawSourceMap;
     readonly prototype: SourceMap;
     new(code: string, remove: boolean): SourceMap;
@@ -174,8 +176,8 @@ export interface LintMessage {
 export interface GenerateLintTableOptions extends Partial<LocationUri> {
     leadingText?: string;
     trailingText?: string;
-    errorCount?: number;
-    warningCount?: number;
+    errorCount?: number | [number, number];
+    warningCount?: number | [number, number];
     fatalErrorCount?: number;
     timeStamp?: LogDate;
     ruleWidth?: number;
@@ -188,11 +190,10 @@ export interface CustomizeOptions {
 
 export interface AsSourceFileOptions {
     encoding?: BufferEncoding;
-    persist?: boolean;
     cache?: boolean;
 }
 
-export type Transformer = FunctionType<Undef<Promise<string> | string>>;
+export type Transformer = FunctionType<Promise<string> | string> | undefined;
 export type ConfigOrTransformer = AnyObject | Transformer;
-export type PluginConfig = [string, Undef<ConfigOrTransformer>, Undef<AnyObject>, boolean?] | [];
-export type TransformCallback<T extends IFileManager<U>, U extends ExternalAsset = ExternalAsset> = (this: T, instance: IDocument<T, U>, requireOrDocumentDir?: NodeJS.Require | string) => Void<Promise<void>>;
+export type PluginConfig = [string, ConfigOrTransformer | undefined, AnyObject | undefined, boolean?] | [];
+export type TransformCallback<T extends IFileManager<U>, U extends ExternalAsset = ExternalAsset> = (this: T, instance: IDocument<T, U>, requireOrDocumentDir?: NodeJS.Require | string) => Promise<void >;

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> {
@@ -53,14 +53,14 @@ export interface IHttpDiskCache<T extends ExternalAsset = ExternalAsset> {
 }
 
 export interface IHttpMemoryCache<T extends ExternalAsset = ExternalAsset> extends IHttpDiskCache<T> {
-    toDisk: TupleOf<number>;
+    toDisk: [number, number];
     purge(percent?: number, limit?: number): void;
     withinDisk(value: T | number): boolean;
     clear(uri?: string | URL): void;
 }
 
 export interface HttpDiskCacheAddOptions {
-    buffer?: Null<Bufferable>;
+    buffer?: Bufferable | null;
     contentLength?: number;
 }
 
@@ -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

@@ -1,8 +1,8 @@
-import type { LookupAddress } from 'dns';
-import type { ClientRequest, Agent as HttpAgent, OutgoingHttpHeaders } from 'http';
-import type { Agent as HttpsAgent } from 'https';
-import type { ClientHttp2Stream } from 'http2';
-import type { SecureVersion } from 'tls';
+import type { LookupAddress } from 'node:dns';
+import type { ClientRequest, Agent as HttpAgent, OutgoingHttpHeaders } from 'node:http';
+import type { Agent as HttpsAgent } from 'node:https';
+import type { ClientHttp2Stream } from 'node:http2';
+import type { SecureVersion } from 'node:tls';
 
 export const enum HTTP_STATUS {
     CONTINUE = 100,
@@ -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;
 }
 

package/lib/image.d.ts

@@ -1,44 +1,54 @@
-import type { MimeTypeAction } from './squared';
-
-import type { BroadcastValue, LogTime } from './logger';
-import type { ImageModule } from './settings';
-
-export interface CommandData {
-    resize?: ResizeData;
-    crop?: CropData;
-    rotate?: RotateData;
-    quality?: QualityData;
-    method?: MethodData;
-    opacity?: number;
-}
-
-export interface RotateData {
-    values: number[];
-    color: number;
-}
-
-export interface ResizeData extends Dimension {
-    mode: string;
-    color: number;
-    align: Undef<string>[];
-    algorithm?: string;
-}
-
-export interface CropData extends Point, Dimension {}
-
-export interface QualityData {
-    value: number;
-    nearLossless: number;
-    method: number;
-    preset?: string;
-}
-
-export interface TransformOptions extends MimeTypeAction {
-    tempFile?: boolean;
-    startTime?: LogTime;
-    module?: ImageModule;
-    broadcastId?: BroadcastValue;
-    cache?: boolean;
-}
-
+import type { MimeTypeAction } from './squared';
+
+import type { BroadcastValue, LogTime } from './logger';
+import type { ImageModule } from './settings';
+
+export interface CommandData {
+    resize?: ResizeData | null;
+    crop?: CropData | null;
+    rotate?: RotateData | null;
+    quality?: QualityData | null;
+    method?: MethodData | null;
+    opacity?: number;
+}
+
+export interface RotateData {
+    values: number[];
+    color: number;
+}
+
+export interface ResizeData extends Dimension {
+    mode: string;
+    color: number;
+    align: [string | undefined, string | undefined];
+    algorithm?: string;
+}
+
+export interface CropData extends Point, Dimension {}
+
+export interface QualityData {
+    value: number;
+    nearLossless: number;
+    method: number;
+    preset?: string;
+}
+
+export interface TransformOptions extends MimeTypeAction {
+    tempFile?: boolean;
+    startTime?: LogTime;
+    module?: ImageModule;
+    broadcastId?: BroadcastValue;
+    cache?: boolean;
+}
+
+export interface Point {
+    x: number;
+    y: number;
+}
+
+export interface Dimension {
+    width: number;
+    height: number;
+}
+
 export type MethodData = [string, unknown[]?][];