@enkaku/client 0.1.1 → 0.2.1
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/client.d.ts +62 -0
- package/lib/client.d.ts.map +1 -0
- package/lib/client.js +174 -0
- package/lib/constants.d.ts +2 -0
- package/lib/constants.d.ts.map +1 -0
- package/lib/constants.js +1 -0
- package/lib/error.d.ts +10 -0
- package/lib/error.d.ts.map +1 -0
- package/lib/error.js +23 -0
- package/lib/index.d.ts +2 -56
- package/lib/index.d.ts.map +1 -1
- package/lib/index.js +2 -87
- package/package.json +6 -4
package/lib/client.d.ts
ADDED
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
import type { AnyDefinitions, ChannelDefinition, ClientTransportOf, EventDefinition, RequestDefinition, StreamDefinition } from '@enkaku/protocol';
|
|
2
|
+
import { type Disposer } from '@enkaku/util';
|
|
3
|
+
export type InvokeReturn<Result> = {
|
|
4
|
+
abort: (reason?: any) => void;
|
|
5
|
+
id: string;
|
|
6
|
+
result: Promise<Result>;
|
|
7
|
+
};
|
|
8
|
+
export type InvokeStreamReturn<Receive, Result> = InvokeReturn<Result> & {
|
|
9
|
+
receive: ReadableStreamDefaultReader<Receive>;
|
|
10
|
+
};
|
|
11
|
+
export type InvokeChannelReturn<Send, Receive, Result> = InvokeStreamReturn<Receive, Result> & {
|
|
12
|
+
send: (value: Send) => Promise<void>;
|
|
13
|
+
};
|
|
14
|
+
export type EventDefinitionsType<Definitions extends AnyDefinitions, Commands extends keyof Definitions & string = keyof Definitions & string> = {
|
|
15
|
+
[Command in Commands]: Definitions[Command] extends EventDefinition<infer Data> ? {
|
|
16
|
+
Argument: Data extends undefined ? never : Data;
|
|
17
|
+
Return: undefined;
|
|
18
|
+
} : never;
|
|
19
|
+
};
|
|
20
|
+
export type RequestDefinitionsType<Definitions extends AnyDefinitions, Commands extends keyof Definitions & string = keyof Definitions & string> = {
|
|
21
|
+
[Command in Commands]: Definitions[Command] extends RequestDefinition<infer Params, infer Result> ? {
|
|
22
|
+
Argument: Params extends undefined ? never : Params;
|
|
23
|
+
Return: InvokeReturn<Result>;
|
|
24
|
+
} : never;
|
|
25
|
+
};
|
|
26
|
+
export type StreamDefinitionsType<Definitions extends AnyDefinitions, Commands extends keyof Definitions & string = keyof Definitions & string> = {
|
|
27
|
+
[Command in Commands]: Definitions[Command] extends StreamDefinition<infer Params, infer Receive, infer Result> ? {
|
|
28
|
+
Argument: Params extends undefined ? never : Params;
|
|
29
|
+
Receive: Receive;
|
|
30
|
+
Return: InvokeStreamReturn<Receive, Result>;
|
|
31
|
+
} : never;
|
|
32
|
+
};
|
|
33
|
+
export type ChannelDefinitionsType<Definitions extends AnyDefinitions, Commands extends keyof Definitions & string = keyof Definitions & string> = {
|
|
34
|
+
[Command in Commands]: Definitions[Command] extends ChannelDefinition<infer Params, infer Send, infer Receive, infer Result> ? {
|
|
35
|
+
Argument: Params extends undefined ? never : Params;
|
|
36
|
+
Receive: Receive;
|
|
37
|
+
Return: InvokeChannelReturn<Send, Receive, Result>;
|
|
38
|
+
Send: Send;
|
|
39
|
+
} : never;
|
|
40
|
+
};
|
|
41
|
+
export type ClientDefinitionsType<Definitions extends AnyDefinitions> = {
|
|
42
|
+
Channels: ChannelDefinitionsType<Definitions>;
|
|
43
|
+
Events: EventDefinitionsType<Definitions>;
|
|
44
|
+
Requests: RequestDefinitionsType<Definitions>;
|
|
45
|
+
Streams: StreamDefinitionsType<Definitions>;
|
|
46
|
+
};
|
|
47
|
+
export type InvokeArgumentType<Definitions extends AnyDefinitions, Name extends keyof Definitions & string = keyof Definitions & string> = Definitions[Name] extends EventDefinition<infer Data> ? Data : Definitions[Name] extends RequestDefinition<infer Params> ? Params : Definitions[Name] extends StreamDefinition<infer Params> ? Params : Definitions[Name] extends ChannelDefinition<infer Params> ? Params : never;
|
|
48
|
+
export type InvokeReturnType<Definitions extends AnyDefinitions, Name extends keyof Definitions & string> = Definitions[Name] extends EventDefinition<infer Data> ? undefined : Definitions[Name] extends RequestDefinition<infer Params, infer Result> ? InvokeReturn<Result> : Definitions[Name] extends StreamDefinition<infer Params, infer Receive, infer Result> ? InvokeStreamReturn<Receive, Result> : Definitions[Name] extends ChannelDefinition<infer Params, infer Send, infer Receive, infer Result> ? InvokeChannelReturn<Send, Receive, Result> : never;
|
|
49
|
+
export type ClientParams<Definitions extends AnyDefinitions> = {
|
|
50
|
+
transport: ClientTransportOf<Definitions>;
|
|
51
|
+
};
|
|
52
|
+
export declare class Client<Definitions extends AnyDefinitions, ClientDefinitions extends ClientDefinitionsType<Definitions> = ClientDefinitionsType<Definitions>> implements Disposer {
|
|
53
|
+
#private;
|
|
54
|
+
constructor(params: ClientParams<Definitions>);
|
|
55
|
+
get disposed(): Promise<void>;
|
|
56
|
+
dispose(): Promise<void>;
|
|
57
|
+
sendEvent<Command extends keyof ClientDefinitions['Events'] & string, T extends ClientDefinitions['Events'][Command] = ClientDefinitions['Events'][Command]>(command: Command, ...args: T['Argument'] extends never ? [] : [T['Argument']]): Promise<void>;
|
|
58
|
+
request<Command extends keyof ClientDefinitions['Requests'] & string, T extends ClientDefinitions['Requests'][Command] = ClientDefinitions['Requests'][Command]>(command: Command, ...args: T['Argument'] extends never ? [] : [T['Argument']]): Promise<InvokeReturn<T['Return']>>;
|
|
59
|
+
createStream<Command extends keyof ClientDefinitions['Streams'] & string, T extends ClientDefinitions['Streams'][Command] = ClientDefinitions['Streams'][Command]>(command: Command, ...args: T['Argument'] extends never ? [] : [T['Argument']]): Promise<InvokeStreamReturn<T['Receive'], T['Return']>>;
|
|
60
|
+
createChannel<Command extends keyof ClientDefinitions['Channels'] & string, T extends ClientDefinitions['Channels'][Command] = ClientDefinitions['Channels'][Command]>(command: Command, ...args: T['Argument'] extends never ? [] : [T['Argument']]): Promise<InvokeChannelReturn<T['Send'], T['Receive'], T['Return']>>;
|
|
61
|
+
}
|
|
62
|
+
//# sourceMappingURL=client.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
|
package/lib/client.js
ADDED
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
import { createUnsignedToken } from '@enkaku/jwt';
|
|
2
|
+
import { createPipe } from '@enkaku/stream';
|
|
3
|
+
import { defer } from '@enkaku/util';
|
|
4
|
+
import { ABORTED } from './constants.js';
|
|
5
|
+
import { RequestError } from './error.js';
|
|
6
|
+
export class Client {
|
|
7
|
+
#transport;
|
|
8
|
+
#controllers = {};
|
|
9
|
+
constructor(params){
|
|
10
|
+
this.#transport = params.transport;
|
|
11
|
+
// Abort all controllers on disconnect
|
|
12
|
+
this.#transport.disposed.then(()=>{
|
|
13
|
+
for (const controller of Object.values(this.#controllers)){
|
|
14
|
+
controller.abort();
|
|
15
|
+
}
|
|
16
|
+
});
|
|
17
|
+
// Start reading from transport
|
|
18
|
+
this.#read();
|
|
19
|
+
}
|
|
20
|
+
async #read() {
|
|
21
|
+
while(true){
|
|
22
|
+
const next = await this.#transport.read();
|
|
23
|
+
if (next.done) {
|
|
24
|
+
break;
|
|
25
|
+
}
|
|
26
|
+
const msg = next.value;
|
|
27
|
+
const controller = this.#controllers[msg.payload.rid];
|
|
28
|
+
if (controller == null) {
|
|
29
|
+
console.warn(`No controller for request ${msg.payload.rid}`);
|
|
30
|
+
continue;
|
|
31
|
+
}
|
|
32
|
+
switch(msg.payload.typ){
|
|
33
|
+
case 'error':
|
|
34
|
+
void controller.receive?.close();
|
|
35
|
+
controller.result.reject(RequestError.fromPayload(msg.payload));
|
|
36
|
+
delete this.#controllers[msg.payload.rid];
|
|
37
|
+
break;
|
|
38
|
+
case 'receive':
|
|
39
|
+
void controller.receive?.write(msg.payload.val);
|
|
40
|
+
break;
|
|
41
|
+
case 'result':
|
|
42
|
+
void controller.receive?.close();
|
|
43
|
+
controller.result.resolve(msg.payload.val);
|
|
44
|
+
delete this.#controllers[msg.payload.rid];
|
|
45
|
+
break;
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
async #write(payload) {
|
|
50
|
+
await this.#transport.write(createUnsignedToken(payload));
|
|
51
|
+
}
|
|
52
|
+
get disposed() {
|
|
53
|
+
return this.#transport.disposed;
|
|
54
|
+
}
|
|
55
|
+
async dispose() {
|
|
56
|
+
await this.#transport.dispose();
|
|
57
|
+
}
|
|
58
|
+
async sendEvent(command, ...args) {
|
|
59
|
+
const payload = args.length ? {
|
|
60
|
+
typ: 'event',
|
|
61
|
+
cmd: command,
|
|
62
|
+
data: args[0]
|
|
63
|
+
} : {
|
|
64
|
+
typ: 'event',
|
|
65
|
+
cmd: command
|
|
66
|
+
};
|
|
67
|
+
await this.#write(payload);
|
|
68
|
+
}
|
|
69
|
+
async request(command, ...args) {
|
|
70
|
+
const rid = globalThis.crypto.randomUUID();
|
|
71
|
+
const controller = Object.assign(new AbortController(), {
|
|
72
|
+
result: defer()
|
|
73
|
+
});
|
|
74
|
+
this.#controllers[rid] = controller;
|
|
75
|
+
controller.signal.addEventListener('abort', ()=>{
|
|
76
|
+
void this.#write({
|
|
77
|
+
typ: 'abort',
|
|
78
|
+
rid
|
|
79
|
+
});
|
|
80
|
+
controller.result.reject(ABORTED);
|
|
81
|
+
});
|
|
82
|
+
const payload = args.length ? {
|
|
83
|
+
typ: 'request',
|
|
84
|
+
rid,
|
|
85
|
+
cmd: command,
|
|
86
|
+
prm: args[0]
|
|
87
|
+
} : {
|
|
88
|
+
typ: 'request',
|
|
89
|
+
rid,
|
|
90
|
+
cmd: command
|
|
91
|
+
};
|
|
92
|
+
await this.#write(payload);
|
|
93
|
+
return {
|
|
94
|
+
abort: ()=>controller.abort(),
|
|
95
|
+
id: rid,
|
|
96
|
+
result: controller.result.promise
|
|
97
|
+
};
|
|
98
|
+
}
|
|
99
|
+
async createStream(command, ...args) {
|
|
100
|
+
const rid = globalThis.crypto.randomUUID();
|
|
101
|
+
const receive = createPipe();
|
|
102
|
+
const controller = Object.assign(new AbortController(), {
|
|
103
|
+
receive: receive.writable.getWriter(),
|
|
104
|
+
result: defer()
|
|
105
|
+
});
|
|
106
|
+
this.#controllers[rid] = controller;
|
|
107
|
+
controller.signal.addEventListener('abort', ()=>{
|
|
108
|
+
void this.#write({
|
|
109
|
+
typ: 'abort',
|
|
110
|
+
rid
|
|
111
|
+
});
|
|
112
|
+
controller.result.reject(ABORTED);
|
|
113
|
+
});
|
|
114
|
+
const action = args.length ? {
|
|
115
|
+
typ: 'stream',
|
|
116
|
+
rid,
|
|
117
|
+
cmd: command,
|
|
118
|
+
prm: args[0]
|
|
119
|
+
} : {
|
|
120
|
+
typ: 'stream',
|
|
121
|
+
rid,
|
|
122
|
+
cmd: command
|
|
123
|
+
};
|
|
124
|
+
await this.#write(action);
|
|
125
|
+
return {
|
|
126
|
+
abort: ()=>controller.abort(),
|
|
127
|
+
id: rid,
|
|
128
|
+
receive: receive.readable.getReader(),
|
|
129
|
+
result: controller.result.promise
|
|
130
|
+
};
|
|
131
|
+
}
|
|
132
|
+
async createChannel(command, ...args) {
|
|
133
|
+
const rid = globalThis.crypto.randomUUID();
|
|
134
|
+
const receive = createPipe();
|
|
135
|
+
const send = createPipe();
|
|
136
|
+
const controller = Object.assign(new AbortController(), {
|
|
137
|
+
receive: receive.writable.getWriter(),
|
|
138
|
+
result: defer(),
|
|
139
|
+
send: send.writable.getWriter()
|
|
140
|
+
});
|
|
141
|
+
this.#controllers[rid] = controller;
|
|
142
|
+
controller.signal.addEventListener('abort', ()=>{
|
|
143
|
+
void this.#write({
|
|
144
|
+
typ: 'abort',
|
|
145
|
+
rid
|
|
146
|
+
});
|
|
147
|
+
controller.result.reject(ABORTED);
|
|
148
|
+
});
|
|
149
|
+
const payload = args.length ? {
|
|
150
|
+
typ: 'channel',
|
|
151
|
+
rid,
|
|
152
|
+
cmd: command,
|
|
153
|
+
prm: args[0]
|
|
154
|
+
} : {
|
|
155
|
+
typ: 'channel',
|
|
156
|
+
rid,
|
|
157
|
+
cmd: command
|
|
158
|
+
};
|
|
159
|
+
await this.#write(payload);
|
|
160
|
+
return {
|
|
161
|
+
abort: ()=>controller.abort(),
|
|
162
|
+
id: rid,
|
|
163
|
+
receive: receive.readable.getReader(),
|
|
164
|
+
result: controller.result.promise,
|
|
165
|
+
send: async (val)=>{
|
|
166
|
+
await this.#write({
|
|
167
|
+
typ: 'send',
|
|
168
|
+
rid,
|
|
169
|
+
val
|
|
170
|
+
});
|
|
171
|
+
}
|
|
172
|
+
};
|
|
173
|
+
}
|
|
174
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,eAAwB,CAAA"}
|
package/lib/constants.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export const ABORTED = Symbol.for('aborted');
|
package/lib/error.d.ts
ADDED
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { ErrorObject, ErrorReplyPayload } from '@enkaku/protocol';
|
|
2
|
+
export type RequestErrorParams<Code extends string = string, Data extends Record<string, unknown> = Record<string, unknown>> = ErrorOptions & ErrorObject<Code, Data>;
|
|
3
|
+
export declare class RequestError<Code extends string = string, Data extends Record<string, unknown> = Record<string, unknown>> extends Error implements ErrorObject<Code, Data> {
|
|
4
|
+
#private;
|
|
5
|
+
static fromPayload<Code extends string = string, Data extends Record<string, unknown> = Record<string, unknown>>(payload: ErrorReplyPayload<Code, Data>): RequestError<Code, Data>;
|
|
6
|
+
constructor(params: RequestErrorParams<Code, Data>);
|
|
7
|
+
get code(): Code;
|
|
8
|
+
get data(): Data;
|
|
9
|
+
}
|
|
10
|
+
//# sourceMappingURL=error.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEtE,MAAM,MAAM,kBAAkB,CAC5B,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAC5D,YAAY,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;AAE1C,qBAAa,YAAY,CACrB,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEhE,SAAQ,KACR,YAAW,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC;;IAElC,MAAM,CAAC,WAAW,CAChB,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,OAAO,EAAE,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC;gBAWvD,MAAM,EAAE,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC;IAOlD,IAAI,IAAI,IAAI,IAAI,CAEf;IAED,IAAI,IAAI,IAAI,IAAI,CAEf;CACF"}
|
package/lib/error.js
ADDED
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
export class RequestError extends Error {
|
|
2
|
+
static fromPayload(payload) {
|
|
3
|
+
return new RequestError({
|
|
4
|
+
code: payload.code,
|
|
5
|
+
data: payload.data,
|
|
6
|
+
message: payload.msg
|
|
7
|
+
});
|
|
8
|
+
}
|
|
9
|
+
#code;
|
|
10
|
+
#data;
|
|
11
|
+
constructor(params){
|
|
12
|
+
const { code, data, message, ...options } = params;
|
|
13
|
+
super(message, options);
|
|
14
|
+
this.#code = code;
|
|
15
|
+
this.#data = data;
|
|
16
|
+
}
|
|
17
|
+
get code() {
|
|
18
|
+
return this.#code;
|
|
19
|
+
}
|
|
20
|
+
get data() {
|
|
21
|
+
return this.#data;
|
|
22
|
+
}
|
|
23
|
+
}
|
package/lib/index.d.ts
CHANGED
|
@@ -1,57 +1,3 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
export type InvokeReturn<Result> = {
|
|
4
|
-
abort: (reason?: any) => void;
|
|
5
|
-
result: Promise<Result>;
|
|
6
|
-
};
|
|
7
|
-
export type InvokeStreamReturn<Receive, Result> = InvokeReturn<Result> & {
|
|
8
|
-
receive: AsyncIterable<Receive>;
|
|
9
|
-
};
|
|
10
|
-
export type InvokeChannelReturn<Send, Receive, Result> = InvokeStreamReturn<Receive, Result> & {
|
|
11
|
-
send: (value: Send) => Promise<void>;
|
|
12
|
-
};
|
|
13
|
-
export type EventDefinitionsType<Definitions extends AnyActionDefinitions, Names extends keyof Definitions & string = keyof Definitions & string> = {
|
|
14
|
-
[Name in Names]: Definitions[Name] extends EventActionDefinition<infer Data> ? {
|
|
15
|
-
Argument: Data extends undefined ? never : Data;
|
|
16
|
-
Return: undefined;
|
|
17
|
-
} : never;
|
|
18
|
-
};
|
|
19
|
-
export type RequestDefinitionsType<Definitions extends AnyActionDefinitions, Names extends keyof Definitions & string = keyof Definitions & string> = {
|
|
20
|
-
[Name in Names]: Definitions[Name] extends RequestActionDefinition<infer Params, infer Result> ? {
|
|
21
|
-
Argument: Params extends undefined ? never : Params;
|
|
22
|
-
Return: InvokeReturn<Result>;
|
|
23
|
-
} : never;
|
|
24
|
-
};
|
|
25
|
-
export type StreamDefinitionsType<Definitions extends AnyActionDefinitions, Names extends keyof Definitions & string = keyof Definitions & string> = {
|
|
26
|
-
[Name in Names]: Definitions[Name] extends StreamActionDefinition<infer Params, infer Receive, infer Result> ? {
|
|
27
|
-
Argument: Params extends undefined ? never : Params;
|
|
28
|
-
Return: InvokeStreamReturn<Receive, Result>;
|
|
29
|
-
} : never;
|
|
30
|
-
};
|
|
31
|
-
export type ChannelDefinitionsType<Definitions extends AnyActionDefinitions, Names extends keyof Definitions & string = keyof Definitions & string> = {
|
|
32
|
-
[Name in Names]: Definitions[Name] extends ChannelActionDefinition<infer Params, infer Send, infer Receive, infer Result> ? {
|
|
33
|
-
Argument: Params extends undefined ? never : Params;
|
|
34
|
-
Return: InvokeChannelReturn<Send, Receive, Result>;
|
|
35
|
-
} : never;
|
|
36
|
-
};
|
|
37
|
-
export type ClientDefinitionsType<Definitions extends AnyActionDefinitions> = {
|
|
38
|
-
Channels: ChannelDefinitionsType<Definitions>;
|
|
39
|
-
Events: EventDefinitionsType<Definitions>;
|
|
40
|
-
Requests: RequestDefinitionsType<Definitions>;
|
|
41
|
-
Streams: StreamDefinitionsType<Definitions>;
|
|
42
|
-
};
|
|
43
|
-
export type InvokeArgumentType<Definitions extends AnyActionDefinitions, Name extends keyof Definitions & string = keyof Definitions & string> = Definitions[Name] extends EventActionDefinition<infer Data> ? Data : Definitions[Name] extends RequestActionDefinition<infer Params> ? Params : Definitions[Name] extends StreamActionDefinition<infer Params> ? Params : Definitions[Name] extends ChannelActionDefinition<infer Params> ? Params : never;
|
|
44
|
-
export type InvokeReturnType<Definitions extends AnyActionDefinitions, Name extends keyof Definitions & string> = Definitions[Name] extends EventActionDefinition<infer Data> ? undefined : Definitions[Name] extends RequestActionDefinition<infer Params, infer Result> ? InvokeReturn<Result> : Definitions[Name] extends StreamActionDefinition<infer Params, infer Receive, infer Result> ? InvokeStreamReturn<Receive, Result> : Definitions[Name] extends ChannelActionDefinition<infer Params, infer Send, infer Receive, infer Result> ? InvokeChannelReturn<Send, Receive, Result> : never;
|
|
45
|
-
export type ClientParams<Definitions extends AnyActionDefinitions, Meta extends OptionalRecord = undefined> = {
|
|
46
|
-
transport: ClientTransportOf<Definitions, Meta>;
|
|
47
|
-
meta?: Meta;
|
|
48
|
-
};
|
|
49
|
-
export declare class Client<Definitions extends AnyActionDefinitions, Meta extends OptionalRecord, ClientDefinitions extends ClientDefinitionsType<Definitions> = ClientDefinitionsType<Definitions>> implements Disposer {
|
|
50
|
-
#private;
|
|
51
|
-
constructor(params: ClientParams<Definitions, Meta>);
|
|
52
|
-
get disposed(): Promise<void>;
|
|
53
|
-
dispose(): Promise<void>;
|
|
54
|
-
sendEvent<Name extends keyof ClientDefinitions['Events'] & string, T extends ClientDefinitions['Events'][Name] = ClientDefinitions['Events'][Name]>(name: Name, ...args: T['Argument'] extends never ? [] : [T['Argument']]): Promise<void>;
|
|
55
|
-
request<Name extends keyof ClientDefinitions['Requests'] & string, T extends ClientDefinitions['Requests'][Name] = ClientDefinitions['Requests'][Name]>(name: Name, ...args: T['Argument'] extends never ? [] : [T['Argument']]): Promise<T['Return']>;
|
|
56
|
-
}
|
|
1
|
+
export { Client, type ClientParams, type InvokeChannelReturn, type InvokeReturn, type InvokeStreamReturn, } from './client.js';
|
|
2
|
+
export { ABORTED } from './constants.js';
|
|
57
3
|
//# sourceMappingURL=index.d.ts.map
|
package/lib/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA"}
|
package/lib/index.js
CHANGED
|
@@ -1,87 +1,2 @@
|
|
|
1
|
-
|
|
2
|
-
export
|
|
3
|
-
#meta;
|
|
4
|
-
#transport;
|
|
5
|
-
#controllers = {};
|
|
6
|
-
constructor(params){
|
|
7
|
-
this.#meta = params.meta;
|
|
8
|
-
this.#transport = params.transport;
|
|
9
|
-
// Abort all controllers on disconnect
|
|
10
|
-
this.#transport.disposed.then(()=>{
|
|
11
|
-
for (const controller of Object.values(this.#controllers)){
|
|
12
|
-
controller.abort();
|
|
13
|
-
}
|
|
14
|
-
});
|
|
15
|
-
// Start reading from transport
|
|
16
|
-
this.#read();
|
|
17
|
-
}
|
|
18
|
-
async #read() {
|
|
19
|
-
while(true){
|
|
20
|
-
const next = await this.#transport.read();
|
|
21
|
-
if (next.done) {
|
|
22
|
-
break;
|
|
23
|
-
}
|
|
24
|
-
const msg = next.value;
|
|
25
|
-
const controller = this.#controllers[msg.action.id];
|
|
26
|
-
if (controller == null) {
|
|
27
|
-
console.warn(`No controller for action ${msg.action.id}`);
|
|
28
|
-
continue;
|
|
29
|
-
}
|
|
30
|
-
switch(msg.action.type){
|
|
31
|
-
case 'error':
|
|
32
|
-
// TODO: cast to Error instance
|
|
33
|
-
controller.result.reject(msg.action.error);
|
|
34
|
-
delete this.#controllers[msg.action.id];
|
|
35
|
-
break;
|
|
36
|
-
case 'receive':
|
|
37
|
-
break;
|
|
38
|
-
case 'result':
|
|
39
|
-
controller.result.resolve(msg.action.value);
|
|
40
|
-
delete this.#controllers[msg.action.id];
|
|
41
|
-
break;
|
|
42
|
-
}
|
|
43
|
-
}
|
|
44
|
-
}
|
|
45
|
-
async #write(action) {
|
|
46
|
-
await this.#transport.write({
|
|
47
|
-
action,
|
|
48
|
-
meta: this.#meta
|
|
49
|
-
});
|
|
50
|
-
}
|
|
51
|
-
get disposed() {
|
|
52
|
-
return this.#transport.disposed;
|
|
53
|
-
}
|
|
54
|
-
async dispose() {
|
|
55
|
-
await this.#transport.dispose();
|
|
56
|
-
}
|
|
57
|
-
async sendEvent(name, ...args) {
|
|
58
|
-
const action = args.length ? {
|
|
59
|
-
type: 'event',
|
|
60
|
-
name,
|
|
61
|
-
data: args[0]
|
|
62
|
-
} : {
|
|
63
|
-
type: 'event',
|
|
64
|
-
name
|
|
65
|
-
};
|
|
66
|
-
await this.#write(action);
|
|
67
|
-
}
|
|
68
|
-
async request(name, ...args) {
|
|
69
|
-
const id = globalThis.crypto.randomUUID();
|
|
70
|
-
const controller = Object.assign(new AbortController(), {
|
|
71
|
-
result: defer()
|
|
72
|
-
});
|
|
73
|
-
this.#controllers[id] = controller;
|
|
74
|
-
const action = args.length ? {
|
|
75
|
-
type: 'request',
|
|
76
|
-
id,
|
|
77
|
-
name,
|
|
78
|
-
params: args[0]
|
|
79
|
-
} : {
|
|
80
|
-
type: 'request',
|
|
81
|
-
id,
|
|
82
|
-
name
|
|
83
|
-
};
|
|
84
|
-
await this.#write(action);
|
|
85
|
-
return controller.result.promise;
|
|
86
|
-
}
|
|
87
|
-
}
|
|
1
|
+
export { Client } from './client.js';
|
|
2
|
+
export { ABORTED } from './constants.js';
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@enkaku/client",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.1",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"keywords": [],
|
|
6
6
|
"type": "module",
|
|
@@ -14,11 +14,13 @@
|
|
|
14
14
|
],
|
|
15
15
|
"sideEffects": false,
|
|
16
16
|
"dependencies": {
|
|
17
|
-
"@enkaku/
|
|
17
|
+
"@enkaku/jwt": "^0.2.1",
|
|
18
|
+
"@enkaku/util": "^0.2.0",
|
|
19
|
+
"@enkaku/stream": "^0.2.1"
|
|
18
20
|
},
|
|
19
21
|
"devDependencies": {
|
|
20
|
-
"@enkaku/protocol": "^0.1
|
|
21
|
-
"@enkaku/transport": "^0.
|
|
22
|
+
"@enkaku/protocol": "^0.2.1",
|
|
23
|
+
"@enkaku/transport": "^0.2.0"
|
|
22
24
|
},
|
|
23
25
|
"scripts": {
|
|
24
26
|
"build:clean": "del lib",
|