@e-mc/types 0.10.1 → 0.10.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/lib/compress.d.ts CHANGED
@@ -1,26 +1,26 @@
1
- import type { CompressFormat as ICompressFormat, CompressLevel as ICompressLevel } from './squared';
2
-
3
- import type { LogBaseOptions, LogTime } from './logger';
4
- import type { ThrowsAction } from './module';
5
-
6
- type ResultCallback<T = Null<Buffer | Uint8Array>> = (err: unknown, data?: T, ext?: string) => void;
7
- type ResultData = Null<Buffer | Uint8Array> | string;
8
-
9
- export interface CompressFormat extends ICompressFormat, LogBaseOptions, ReadableOptions {
10
- filename?: string;
11
- mimeType?: string;
12
- startTime?: LogTime;
13
- etag?: string;
14
- outExt?: string;
15
- outFile?: string;
16
- }
17
-
18
- export interface CompressLevel extends ICompressLevel, ReadableOptions {}
19
-
20
- export interface ReadableOptions extends ThrowsAction {}
21
-
22
- export type BufferLike = Buffer | Uint8Array | ArrayBuffer | SharedArrayBuffer | readonly number[];
23
- export type TryFileCompressor = (data: string | Buffer, output: string, config: CompressFormat, callback?: ResultCallback<ResultData>) => Void<Promise<ResultData>>;
24
- export type TryFileCompressorAsync = (data: string | Buffer, output: string, config: CompressFormat) => Promise<ResultData>;
25
- export type BufferResult = Null<Buffer | Uint8Array>;
1
+ import type { CompressFormat as ICompressFormat, CompressLevel as ICompressLevel } from './squared';
2
+
3
+ import type { LogBaseOptions, LogTime } from './logger';
4
+ import type { ThrowsAction } from './module';
5
+
6
+ type ResultCallback<T = Null<Buffer | Uint8Array>> = (err: unknown, data?: T, ext?: string) => void;
7
+ type ResultData = Null<Buffer | Uint8Array> | string;
8
+
9
+ export interface CompressFormat extends ICompressFormat, LogBaseOptions, ReadableOptions {
10
+ filename?: string;
11
+ mimeType?: string;
12
+ startTime?: LogTime;
13
+ etag?: string;
14
+ outExt?: string;
15
+ outFile?: string;
16
+ }
17
+
18
+ export interface CompressLevel extends ICompressLevel, ReadableOptions {}
19
+
20
+ export interface ReadableOptions extends ThrowsAction {}
21
+
22
+ export type BufferLike = Buffer | Uint8Array | ArrayBuffer | SharedArrayBuffer | readonly number[];
23
+ export type TryFileCompressor = (data: string | Buffer, output: string, config: CompressFormat, callback?: ResultCallback<ResultData>) => Void<Promise<ResultData>>;
24
+ export type TryFileCompressorAsync = (data: string | Buffer, output: string, config: CompressFormat) => Promise<ResultData>;
25
+ export type BufferResult = Null<Buffer | Uint8Array>;
26
26
  export type PluginCompressor = FunctionArgs<[CompressFormat['options'], string?], FunctionArgs<[Buffer], Promise<Buffer | Uint8Array>>>;
package/lib/core.d.ts CHANGED
@@ -1,196 +1,196 @@
1
- import type { DataSource, RequestBase } from './squared';
2
-
3
- import type { IExternalConfig, IExternalFunction, IHost, IModule, ModuleConstructor } from './index';
4
- import type { QueryResult, TimeoutAction } from './db';
5
- import type { Settings } from './node';
6
- import type { ClientDbSettings, ClientModule, DbCacheValue, DbCoerceSettings, DbSourceOptions } from './settings';
7
-
8
- export interface IdentifierAction {
9
- uuidKey?: string;
10
- }
11
-
12
- export interface AddEventListenerOptions {
13
- capture?: boolean;
14
- once?: boolean;
15
- passive?: boolean;
16
- signal?: AbortSignal;
17
- }
18
-
19
- export interface IClient<T extends IHost, U extends ClientModule, V extends FunctionType<any, any> = FunctionType> extends IModule<T>, IExternalConfig<U, U extends ClientModule<infer W> ? W : unknown>, IExternalFunction<V> {
20
- init(...args: unknown[]): this;
21
- getUserSettings<X>(): Null<X>;
22
- set cacheDir(value: string);
23
- get cacheDir(): string;
24
- }
25
-
26
- export interface ClientConstructor<T extends IHost = IHost, U extends ClientModule = ClientModule> extends ModuleConstructor {
27
- readonly prototype: IClient<T, U>;
28
- new(module?: U): IClient<T, U>;
29
- }
30
-
31
- export interface IClientDb<T extends IHost, U extends ClientModule<ClientDbSettings>, V extends DataSource = DataSource, W extends DbSourceOptions = DbSourceOptions, X extends DbCoerceSettings = DbCoerceSettings> extends IClient<T, U> {
32
- database: V[];
33
- cacheExpires: number;
34
- add(item: V, state?: number): void;
35
- hasCache(source: string, sessionKey?: string): boolean;
36
- hasCoerce(source: string, component: keyof DbCoerceSettings, uuidKey: Undef<string>): boolean;
37
- hasCoerce(source: string, component: keyof DbCoerceSettings, credential?: unknown): boolean;
38
- getQueryResult(source: string, credential: unknown, queryString: string, renewCache: boolean): Undef<QueryResult>;
39
- getQueryResult(source: string, credential: unknown, queryString: string, sessionKey?: string, renewCache?: boolean): Undef<QueryResult>;
40
- getQueryResult(source: string, credential: unknown, queryString: string, options?: CacheOptions | string, renewCache?: boolean): Undef<QueryResult>;
41
- setQueryResult(source: string, credential: unknown, queryString: string, result: unknown, sessionKey?: string): QueryResult;
42
- setQueryResult(source: string, credential: unknown, queryString: string, result: unknown, options?: CacheOptions | string): QueryResult;
43
- getCacheResult(source: string, credential: unknown, queryString: string, cacheValue: CacheOptions, ignoreCache?: IntBool | FirstOf<number, number>): Undef<QueryResult>;
44
- applyState(items: ArrayOf<V>, value: number, as?: boolean): void;
45
- commit(items?: V[]): Promise<boolean>;
46
- valueOfKey(credential: unknown, name: keyof W, component?: keyof X): unknown;
47
- settingsOf(source: string, name: keyof W, component?: keyof X): unknown;
48
- settingsKey(uuidKey: string, name: keyof W, component?: keyof X): unknown;
49
- get pending(): V[];
50
- get committed(): V[];
51
- get failed(): V[];
52
- }
53
-
54
- export interface ClientDbConstructor<T extends IHost = IHost, U extends ClientModule = ClientModule, V extends DataSource = DataSource> extends ClientConstructor<T, U> {
55
- STORE_RESULT_PARTITION_SIZE: number;
56
- STORE_RESULT_PARTITION_MULT: number;
57
- readonly TRANSACTION_ACTIVE: number;
58
- readonly TRANSACTION_PARTIAL: number;
59
- readonly TRANSACTION_COMMIT: number;
60
- readonly TRANSACTION_TERMINATE: number;
61
- readonly TRANSACTION_ABORT: number;
62
- readonly TRANSACTION_FAIL: number;
63
- loadSettings(settings: Pick<Settings, "process" | "memory">, password?: string): boolean;
64
- getTimeout(value: Undef<number | string | TimeoutAction>): number;
65
- convertTime(value: number | string): number;
66
- findResult(source: string, credential: unknown, queryString: string, timeout: number, sessionKey?: string | boolean, renewCache?: boolean): Undef<QueryResult>;
67
- storeResult(source: string, credential: unknown, queryString: string, result: QueryResult, options: StoreResultOptions): QueryResult;
68
- storeResult(source: string, credential: unknown, queryString: string, result: QueryResult, sessionKey: string, sessionExpires: number): QueryResult;
69
- storeResult(source: string, credential: unknown, queryString: string, result: QueryResult, cache: DbCacheValue): QueryResult;
70
- storeResult(source: string, credential: unknown, queryString: string, result: QueryResult, cache: Undef<DbCacheValue>, options: StoreResultOptions): QueryResult;
71
- purgeResult(prefix?: string): Promise<number>;
72
- extractUUID(credential: unknown): string;
73
- setPoolConfig(value: unknown): void;
74
- getPoolConfig(source: string): unknown;
75
- keyOfResult(source: string, credential: unknown, uuidOnly?: boolean): string;
76
- readonly prototype: IClientDb<T, U, V>;
77
- new(module?: U, database?: V[]): IClientDb<T, U, V>;
78
- }
79
-
80
- export interface IAbortComponent extends AbortController {
81
- reset(): void;
82
- get aborted(): boolean;
83
- }
84
-
85
- export interface AbortComponentConstructor {
86
- attach(instance: IAbortComponent, signal: AbortSignal, options?: AddEventListenerOptions): void;
87
- detach(instance: IAbortComponent, signal: AbortSignal): void;
88
- readonly prototype: IAbortComponent;
89
- new(): IAbortComponent;
90
- }
91
-
92
- export interface IPermission {
93
- setDiskRead(pathname?: ArrayOf<string>, enabled?: boolean): void;
94
- setDiskWrite(pathname?: ArrayOf<string>, enabled?: boolean): void;
95
- setUNCRead(pathname?: ArrayOf<string>, enabled?: boolean): void;
96
- setUNCWrite(pathname?: ArrayOf<string>, enabled?: boolean): void;
97
- getDiskRead(): ArrayOf<string>;
98
- getDiskWrite(): ArrayOf<string>;
99
- getUNCRead(): ArrayOf<string>;
100
- getUNCWrite(): ArrayOf<string>;
101
- hasDiskRead(pathname: string): boolean;
102
- hasDiskWrite(pathname: string): boolean;
103
- hasUNCRead(pathname: string): boolean;
104
- hasUNCWrite(pathname: string): boolean;
105
- get diskRead(): boolean;
106
- get diskWrite(): boolean;
107
- get uncRead(): boolean;
108
- get uncWrite(): boolean;
109
- }
110
-
111
- export interface PermissionConstructor {
112
- create(settings: PermittedDirectories, freeze?: boolean): Null<IPermission>;
113
- create(settings: PermittedDirectories, parent: Null<IPermission>, freeze?: boolean): Null<IPermission>;
114
- validate(settings: unknown): settings is PermittedDirectories;
115
- clone(permission: IPermission, freeze?: boolean): IPermission;
116
- match(pathname: string, pattern: ArrayOf<string>): boolean;
117
- toPosix(value: unknown): ArrayOf<string>;
118
- readonly prototype: IPermission;
119
- new(freeze?: boolean): IPermission;
120
- }
121
-
122
- export interface PermissionReadWrite<T = boolean> {
123
- disk_read?: T;
124
- disk_write?: T;
125
- unc_read?: T;
126
- unc_write?: T;
127
- }
128
-
129
- export interface PermissionAction {
130
- permission?: PermittedDirectories;
131
- }
132
-
133
- export interface HostInitConfig<T extends HostInitLog = HostInitLog> extends PlainObject, RequestBase<T> {
134
- username?: string;
135
- ignoreModules?: string[];
136
- }
137
-
138
- export interface HostInitLog {
139
- enabled?: boolean;
140
- level?: number | string;
141
- exclude?: ArrayOf<string>;
142
- useColor?: boolean;
143
- silent?: boolean;
144
- showProgress?: boolean;
145
- }
146
-
147
- export interface PermittedDirectories extends PermissionReadWrite<ArrayOf<string>> {
148
- inherit?: boolean;
149
- }
150
-
151
- export interface StoreResultOptions {
152
- cache?: DbCacheValue;
153
- cacheDir?: string;
154
- sessionKey?: string;
155
- sessionExpires?: number;
156
- }
157
-
158
- export interface CacheOptions {
159
- value?: DbCacheValue;
160
- renewCache?: boolean;
161
- exclusiveOf?: FirstOf<number, number>;
162
- sessionKey?: string;
163
- }
164
-
165
- export interface ThreadInfo {
166
- pid: number;
167
- startTime: number;
168
- username?: string;
169
- sessionId?: string;
170
- broadcastId?: ArrayOf<string>;
171
- }
172
-
173
- export interface ThreadCountStat {
174
- count: number;
175
- pending: number;
176
- opened?: number;
177
- closed?: number;
178
- queued?: number;
179
- rejected?: number;
180
- killed?: number;
181
- startTime?: number;
182
- previousTime?: number;
183
- max?: number;
184
- admin?: ThreadInfo[];
185
- }
186
-
187
- export interface JoinQueueOptions {
188
- args?: unknown[];
189
- reject?: boolean;
190
- }
191
-
192
- export interface ResumeThreadOptions {
193
- args: unknown[];
194
- startTime: number;
195
- aborted?: boolean;
1
+ import type { DataSource, RequestBase } from './squared';
2
+
3
+ import type { IExternalConfig, IExternalFunction, IHost, IModule, ModuleConstructor } from './index';
4
+ import type { QueryResult, TimeoutAction } from './db';
5
+ import type { Settings } from './node';
6
+ import type { ClientDbSettings, ClientModule, DbCacheValue, DbCoerceSettings, DbSourceOptions } from './settings';
7
+
8
+ export interface IdentifierAction {
9
+ uuidKey?: string;
10
+ }
11
+
12
+ export interface AddEventListenerOptions {
13
+ capture?: boolean;
14
+ once?: boolean;
15
+ passive?: boolean;
16
+ signal?: AbortSignal;
17
+ }
18
+
19
+ export interface IClient<T extends IHost, U extends ClientModule, V extends FunctionType<any, any> = FunctionType> extends IModule<T>, IExternalConfig<U, U extends ClientModule<infer W> ? W : unknown>, IExternalFunction<V> {
20
+ init(...args: unknown[]): this;
21
+ getUserSettings<X>(): Null<X>;
22
+ set cacheDir(value: string);
23
+ get cacheDir(): string;
24
+ }
25
+
26
+ export interface ClientConstructor<T extends IHost = IHost, U extends ClientModule = ClientModule> extends ModuleConstructor {
27
+ readonly prototype: IClient<T, U>;
28
+ new(module?: U): IClient<T, U>;
29
+ }
30
+
31
+ export interface IClientDb<T extends IHost, U extends ClientModule<ClientDbSettings>, V extends DataSource = DataSource, W extends DbSourceOptions = DbSourceOptions, X extends DbCoerceSettings = DbCoerceSettings> extends IClient<T, U> {
32
+ database: V[];
33
+ cacheExpires: number;
34
+ add(item: V, state?: number): void;
35
+ hasCache(source: string, sessionKey?: string): boolean;
36
+ hasCoerce(source: string, component: keyof DbCoerceSettings, uuidKey: Undef<string>): boolean;
37
+ hasCoerce(source: string, component: keyof DbCoerceSettings, credential?: unknown): boolean;
38
+ getQueryResult(source: string, credential: unknown, queryString: string, renewCache: boolean): Undef<QueryResult>;
39
+ getQueryResult(source: string, credential: unknown, queryString: string, sessionKey?: string, renewCache?: boolean): Undef<QueryResult>;
40
+ getQueryResult(source: string, credential: unknown, queryString: string, options?: CacheOptions | string, renewCache?: boolean): Undef<QueryResult>;
41
+ setQueryResult(source: string, credential: unknown, queryString: string, result: unknown, sessionKey?: string): QueryResult;
42
+ setQueryResult(source: string, credential: unknown, queryString: string, result: unknown, options?: CacheOptions | string): QueryResult;
43
+ getCacheResult(source: string, credential: unknown, queryString: string, cacheValue: CacheOptions, ignoreCache?: IntBool | FirstOf<number, number>): Undef<QueryResult>;
44
+ applyState(items: ArrayOf<V>, value: number, as?: boolean): void;
45
+ commit(items?: V[]): Promise<boolean>;
46
+ valueOfKey(credential: unknown, name: keyof W, component?: keyof X): unknown;
47
+ settingsOf(source: string, name: keyof W, component?: keyof X): unknown;
48
+ settingsKey(uuidKey: string, name: keyof W, component?: keyof X): unknown;
49
+ get pending(): V[];
50
+ get committed(): V[];
51
+ get failed(): V[];
52
+ }
53
+
54
+ export interface ClientDbConstructor<T extends IHost = IHost, U extends ClientModule = ClientModule, V extends DataSource = DataSource> extends ClientConstructor<T, U> {
55
+ STORE_RESULT_PARTITION_SIZE: number;
56
+ STORE_RESULT_PARTITION_MULT: number;
57
+ readonly TRANSACTION_ACTIVE: number;
58
+ readonly TRANSACTION_PARTIAL: number;
59
+ readonly TRANSACTION_COMMIT: number;
60
+ readonly TRANSACTION_TERMINATE: number;
61
+ readonly TRANSACTION_ABORT: number;
62
+ readonly TRANSACTION_FAIL: number;
63
+ loadSettings(settings: Pick<Settings, "process" | "memory">, password?: string): boolean;
64
+ getTimeout(value: Undef<number | string | TimeoutAction>): number;
65
+ convertTime(value: number | string): number;
66
+ findResult(source: string, credential: unknown, queryString: string, timeout: number, sessionKey?: string | boolean, renewCache?: boolean): Undef<QueryResult>;
67
+ storeResult(source: string, credential: unknown, queryString: string, result: QueryResult, options: StoreResultOptions): QueryResult;
68
+ storeResult(source: string, credential: unknown, queryString: string, result: QueryResult, sessionKey: string, sessionExpires: number): QueryResult;
69
+ storeResult(source: string, credential: unknown, queryString: string, result: QueryResult, cache: DbCacheValue): QueryResult;
70
+ storeResult(source: string, credential: unknown, queryString: string, result: QueryResult, cache: Undef<DbCacheValue>, options: StoreResultOptions): QueryResult;
71
+ purgeResult(prefix?: string): Promise<number>;
72
+ extractUUID(credential: unknown): string;
73
+ setPoolConfig(value: unknown): void;
74
+ getPoolConfig(source: string): unknown;
75
+ keyOfResult(source: string, credential: unknown, uuidOnly?: boolean): string;
76
+ readonly prototype: IClientDb<T, U, V>;
77
+ new(module?: U, database?: V[]): IClientDb<T, U, V>;
78
+ }
79
+
80
+ export interface IAbortComponent extends AbortController {
81
+ reset(): void;
82
+ get aborted(): boolean;
83
+ }
84
+
85
+ export interface AbortComponentConstructor {
86
+ attach(instance: IAbortComponent, signal: AbortSignal, options?: AddEventListenerOptions): void;
87
+ detach(instance: IAbortComponent, signal: AbortSignal): void;
88
+ readonly prototype: IAbortComponent;
89
+ new(): IAbortComponent;
90
+ }
91
+
92
+ export interface IPermission {
93
+ setDiskRead(pathname?: ArrayOf<string>, enabled?: boolean): void;
94
+ setDiskWrite(pathname?: ArrayOf<string>, enabled?: boolean): void;
95
+ setUNCRead(pathname?: ArrayOf<string>, enabled?: boolean): void;
96
+ setUNCWrite(pathname?: ArrayOf<string>, enabled?: boolean): void;
97
+ getDiskRead(): ArrayOf<string>;
98
+ getDiskWrite(): ArrayOf<string>;
99
+ getUNCRead(): ArrayOf<string>;
100
+ getUNCWrite(): ArrayOf<string>;
101
+ hasDiskRead(pathname: string): boolean;
102
+ hasDiskWrite(pathname: string): boolean;
103
+ hasUNCRead(pathname: string): boolean;
104
+ hasUNCWrite(pathname: string): boolean;
105
+ get diskRead(): boolean;
106
+ get diskWrite(): boolean;
107
+ get uncRead(): boolean;
108
+ get uncWrite(): boolean;
109
+ }
110
+
111
+ export interface PermissionConstructor {
112
+ create(settings: PermittedDirectories, freeze?: boolean): Null<IPermission>;
113
+ create(settings: PermittedDirectories, parent: Null<IPermission>, freeze?: boolean): Null<IPermission>;
114
+ validate(settings: unknown): settings is PermittedDirectories;
115
+ clone(permission: IPermission, freeze?: boolean): IPermission;
116
+ match(pathname: string, pattern: ArrayOf<string>): boolean;
117
+ toPosix(value: unknown): ArrayOf<string>;
118
+ readonly prototype: IPermission;
119
+ new(freeze?: boolean): IPermission;
120
+ }
121
+
122
+ export interface PermissionReadWrite<T = boolean> {
123
+ disk_read?: T;
124
+ disk_write?: T;
125
+ unc_read?: T;
126
+ unc_write?: T;
127
+ }
128
+
129
+ export interface PermissionAction {
130
+ permission?: PermittedDirectories;
131
+ }
132
+
133
+ export interface HostInitConfig<T extends HostInitLog = HostInitLog> extends PlainObject, RequestBase<T> {
134
+ username?: string;
135
+ ignoreModules?: string[];
136
+ }
137
+
138
+ export interface HostInitLog {
139
+ enabled?: boolean;
140
+ level?: number | string;
141
+ exclude?: ArrayOf<string>;
142
+ useColor?: boolean;
143
+ silent?: boolean;
144
+ showProgress?: boolean;
145
+ }
146
+
147
+ export interface PermittedDirectories extends PermissionReadWrite<ArrayOf<string>> {
148
+ inherit?: boolean;
149
+ }
150
+
151
+ export interface StoreResultOptions {
152
+ cache?: DbCacheValue;
153
+ cacheDir?: string;
154
+ sessionKey?: string;
155
+ sessionExpires?: number;
156
+ }
157
+
158
+ export interface CacheOptions {
159
+ value?: DbCacheValue;
160
+ renewCache?: boolean;
161
+ exclusiveOf?: FirstOf<number, number>;
162
+ sessionKey?: string;
163
+ }
164
+
165
+ export interface ThreadInfo {
166
+ pid: number;
167
+ startTime: number;
168
+ username?: string;
169
+ sessionId?: string;
170
+ broadcastId?: ArrayOf<string>;
171
+ }
172
+
173
+ export interface ThreadCountStat {
174
+ count: number;
175
+ pending: number;
176
+ opened?: number;
177
+ closed?: number;
178
+ queued?: number;
179
+ rejected?: number;
180
+ killed?: number;
181
+ startTime?: number;
182
+ previousTime?: number;
183
+ max?: number;
184
+ admin?: ThreadInfo[];
185
+ }
186
+
187
+ export interface JoinQueueOptions {
188
+ args?: unknown[];
189
+ reject?: boolean;
190
+ }
191
+
192
+ export interface ResumeThreadOptions {
193
+ args: unknown[];
194
+ startTime: number;
195
+ aborted?: boolean;
196
196
  }