servlink 0.0.0-stage → 1.0.2

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/dist/tunnel.js ADDED
@@ -0,0 +1,490 @@
1
+ /**
2
+ * The slink tunnel: one outbound WebSocket to a relay server, authenticated by Ed25519
3
+ * challenge-response, auto-reconnecting with exponential backoff + full jitter, and
4
+ * multiplexing visitor HTTP requests / WebSockets onto the *locked* local target.
5
+ */
6
+ import http, {} from 'node:http';
7
+ import WebSocket from 'ws';
8
+ import { base64DecodedSize, GuardError, safeMethod, safePath, sanitizeHeaders, targetWsUrl, TokenBucket } from './guard.js';
9
+ import { signChallenge } from './identity.js';
10
+ import { parseRelayFrame, RelayClose } from './protocol.js';
11
+ const HIGH_WATER = 4 * 1024 * 1024;
12
+ const LOW_WATER = 1024 * 1024;
13
+ const CHUNK = 64 * 1024;
14
+ class LocalError extends Error {
15
+ code;
16
+ constructor(message, code) {
17
+ super(message);
18
+ this.code = code;
19
+ }
20
+ }
21
+ function errCode(err) {
22
+ return err?.code;
23
+ }
24
+ export class SlinkTunnel {
25
+ ws = null;
26
+ state = 'connecting';
27
+ attempt = 0;
28
+ stopped = false;
29
+ heartbeat = null;
30
+ reconnectTimer = null;
31
+ awaitingPong = false;
32
+ http = new Map();
33
+ sockets = new Map();
34
+ bucket;
35
+ maxBodyBytes;
36
+ o;
37
+ /** Count of authenticated sessions (observable for tests / status). */
38
+ connections = 0;
39
+ constructor(opts) {
40
+ this.o = {
41
+ localTimeoutMs: 15_000,
42
+ streamIdleMs: 300_000,
43
+ heartbeatMs: 20_000,
44
+ backoffBaseMs: 1_000,
45
+ backoffMaxMs: 30_000,
46
+ maxConcurrent: 128,
47
+ ...opts,
48
+ };
49
+ this.bucket = new TokenBucket(opts.maxRps);
50
+ this.maxBodyBytes = Math.floor(opts.maxBodyMb * 1024 * 1024);
51
+ }
52
+ get currentState() {
53
+ return this.state;
54
+ }
55
+ start() {
56
+ this.stopped = false;
57
+ this.connect();
58
+ }
59
+ stop() {
60
+ this.stopped = true;
61
+ if (this.reconnectTimer)
62
+ clearTimeout(this.reconnectTimer);
63
+ this.stopHeartbeat();
64
+ this.teardownStreams();
65
+ this.ws?.close(1000, 'slink stopping');
66
+ this.setState('stopped');
67
+ }
68
+ // ─── connection lifecycle ─────────────────────────────────────────────────
69
+ setState(state, detail) {
70
+ this.state = state;
71
+ this.o.onState?.(state, detail);
72
+ }
73
+ connect() {
74
+ if (this.stopped)
75
+ return;
76
+ this.setState('connecting', this.o.relay);
77
+ let ws;
78
+ try {
79
+ ws = new WebSocket(this.o.relay, {
80
+ handshakeTimeout: 15_000,
81
+ perMessageDeflate: false,
82
+ // Room for a 50 MB body in base64 (≈ 1.37×) with headroom, while still bounding memory.
83
+ maxPayload: 100 * 1024 * 1024,
84
+ });
85
+ }
86
+ catch (err) {
87
+ this.o.log?.(`invalid relay URL: ${err.message}`);
88
+ this.scheduleReconnect('invalid relay URL');
89
+ return;
90
+ }
91
+ this.ws = ws;
92
+ ws.on('open', () => {
93
+ this.setState('authenticating');
94
+ this.startHeartbeat(ws);
95
+ });
96
+ ws.on('message', (data, isBinary) => {
97
+ if (isBinary)
98
+ return;
99
+ try {
100
+ const frame = parseRelayFrame(data.toString());
101
+ if (!frame) {
102
+ this.o.log?.('dropped malformed relay frame');
103
+ return;
104
+ }
105
+ this.onFrame(frame);
106
+ }
107
+ catch (err) {
108
+ this.o.log?.(`frame handler error: ${err.message}`);
109
+ }
110
+ });
111
+ ws.on('pong', () => {
112
+ this.awaitingPong = false;
113
+ });
114
+ ws.on('error', (err) => this.o.log?.(`tunnel error: ${err.message}`));
115
+ ws.on('close', (code, reasonBuf) => {
116
+ if (this.ws !== ws)
117
+ return;
118
+ this.ws = null;
119
+ this.stopHeartbeat();
120
+ this.teardownStreams();
121
+ const reason = reasonBuf.toString();
122
+ if (this.stopped)
123
+ return;
124
+ if (code === RelayClose.SUPERSEDED) {
125
+ this.o.log?.('another slink connected with this node_id; this one is standing down');
126
+ this.stopped = true;
127
+ this.setState('stopped', 'superseded by another slink using this node_id');
128
+ return;
129
+ }
130
+ const why = code === RelayClose.AUTH_FAILED
131
+ ? `authentication rejected (${reason || 'is this node_id + public key registered with the relay?'})`
132
+ : code === RelayClose.UNBOUND
133
+ ? 'node binding changed on the relay'
134
+ : `closed (${code}${reason ? ` ${reason}` : ''})`;
135
+ this.scheduleReconnect(why);
136
+ });
137
+ }
138
+ scheduleReconnect(why) {
139
+ if (this.stopped)
140
+ return;
141
+ const exp = Math.min(this.o.backoffMaxMs, this.o.backoffBaseMs * 2 ** this.attempt);
142
+ const delay = Math.round(exp / 2 + Math.random() * (exp / 2)); // "equal jitter": never 0, never > cap
143
+ this.attempt++;
144
+ this.setState('reconnecting', `${why}; retrying in ${(delay / 1000).toFixed(1)}s`);
145
+ this.reconnectTimer = setTimeout(() => this.connect(), delay);
146
+ }
147
+ startHeartbeat(ws) {
148
+ this.stopHeartbeat();
149
+ this.awaitingPong = false;
150
+ this.heartbeat = setInterval(() => {
151
+ if (ws.readyState !== WebSocket.OPEN)
152
+ return;
153
+ if (this.awaitingPong) {
154
+ this.o.log?.('relay heartbeat lost; reconnecting');
155
+ ws.terminate();
156
+ return;
157
+ }
158
+ this.awaitingPong = true;
159
+ ws.ping();
160
+ }, this.o.heartbeatMs);
161
+ }
162
+ stopHeartbeat() {
163
+ if (this.heartbeat)
164
+ clearInterval(this.heartbeat);
165
+ this.heartbeat = null;
166
+ }
167
+ teardownStreams() {
168
+ for (const e of this.http.values()) {
169
+ e.cancelled = true;
170
+ e.req?.destroy();
171
+ e.res?.destroy();
172
+ }
173
+ this.http.clear();
174
+ for (const s of this.sockets.values())
175
+ s.terminate();
176
+ this.sockets.clear();
177
+ }
178
+ send(frame) {
179
+ if (this.ws?.readyState === WebSocket.OPEN)
180
+ this.ws.send(JSON.stringify(frame));
181
+ }
182
+ // ─── frame dispatch ───────────────────────────────────────────────────────
183
+ onFrame(f) {
184
+ switch (f.type) {
185
+ case 'challenge':
186
+ this.send({ type: 'auth', node_id: this.o.nodeId, signature: signChallenge(this.o.privateKey, f.nonce) });
187
+ return;
188
+ case 'auth_ok':
189
+ this.attempt = 0;
190
+ this.connections++;
191
+ this.setState('online', f.node_id);
192
+ return;
193
+ case 'auth_error':
194
+ this.o.log?.(`relay rejected authentication: ${f.reason}`);
195
+ return;
196
+ case 'pong':
197
+ return;
198
+ case 'http_request':
199
+ this.handleHttp(f).catch((err) => this.o.log?.(`http handler error: ${err.message}`));
200
+ return;
201
+ case 'http_cancel': {
202
+ const e = this.http.get(f.id);
203
+ if (!e)
204
+ return;
205
+ e.cancelled = true;
206
+ e.req?.destroy();
207
+ e.res?.destroy();
208
+ this.http.delete(f.id);
209
+ return;
210
+ }
211
+ case 'ws_open':
212
+ this.handleWsOpen(f).catch((err) => this.o.log?.(`ws handler error: ${err.message}`));
213
+ return;
214
+ case 'ws_message': {
215
+ const s = this.sockets.get(f.id);
216
+ if (!s || s.readyState !== WebSocket.OPEN)
217
+ return;
218
+ const size = f.binary ? base64DecodedSize(f.data) : Buffer.byteLength(f.data);
219
+ if (size > this.maxBodyBytes)
220
+ return this.closeStream(f.id, 1009, 'message too large');
221
+ if (!this.bucket.take())
222
+ return this.closeStream(f.id, 1008, 'rate limit exceeded');
223
+ s.send(f.binary ? Buffer.from(f.data, 'base64') : f.data);
224
+ return;
225
+ }
226
+ case 'ws_close': {
227
+ const s = this.sockets.get(f.id);
228
+ this.sockets.delete(f.id);
229
+ s?.close();
230
+ return;
231
+ }
232
+ }
233
+ }
234
+ // ─── HTTP ─────────────────────────────────────────────────────────────────
235
+ async handleHttp(f) {
236
+ const started = Date.now();
237
+ const pathForLog = typeof f.path === 'string' ? f.path : '?';
238
+ const log = (status) => this.o.requestLog?.write({ leaseId: f.lease_id, method: f.method, path: pathForLog, status, ms: Date.now() - started });
239
+ const guardReply = (status, message, extra = {}) => {
240
+ this.send({
241
+ type: 'http_response',
242
+ id: f.id,
243
+ status,
244
+ headers: { 'content-type': 'text/plain; charset=utf-8', 'x-servlink-guard': '1', ...extra },
245
+ body: Buffer.from(`${message}\n`).toString('base64'),
246
+ });
247
+ log(status);
248
+ };
249
+ let method;
250
+ let path;
251
+ try {
252
+ method = safeMethod(f.method);
253
+ path = safePath(f.path);
254
+ }
255
+ catch (err) {
256
+ return guardReply(400, err.message);
257
+ }
258
+ if (this.http.size >= this.o.maxConcurrent)
259
+ return guardReply(503, 'slink: too many concurrent requests', { 'retry-after': '1' });
260
+ if (!this.bucket.take())
261
+ return guardReply(429, 'slink: local rate limit exceeded', { 'retry-after': '1' });
262
+ if (f.body && base64DecodedSize(f.body) > this.maxBodyBytes) {
263
+ return guardReply(413, `slink: request body exceeds ${this.o.maxBodyMb} MB`);
264
+ }
265
+ this.o.wake?.touch();
266
+ const headers = sanitizeHeaders(f.headers, this.o.target);
267
+ const body = f.body ? Buffer.from(f.body, 'base64') : undefined;
268
+ if (body)
269
+ headers['content-length'] = String(body.length);
270
+ const entry = { cancelled: false };
271
+ this.http.set(f.id, entry);
272
+ try {
273
+ let status;
274
+ try {
275
+ status = await this.forward(f.id, entry, method, path, headers, body);
276
+ }
277
+ catch (err) {
278
+ if (errCode(err) === 'ECONNREFUSED' && this.o.wake?.canWake && !entry.cancelled) {
279
+ await this.o.wake.ensureAwake();
280
+ status = await this.forward(f.id, entry, method, path, headers, body);
281
+ }
282
+ else
283
+ throw err;
284
+ }
285
+ log(status);
286
+ }
287
+ catch (err) {
288
+ if (entry.cancelled)
289
+ return log('cancelled');
290
+ if (err instanceof LocalError && err.code === 'BODY_TOO_LARGE')
291
+ return guardReply(413, err.message);
292
+ const code = errCode(err) ?? err.code;
293
+ const message = code === 'ECONNREFUSED'
294
+ ? `local service at ${this.o.target.authority} refused the connection`
295
+ : code === 'LOCAL_TIMEOUT'
296
+ ? `local service at ${this.o.target.authority} did not respond within ${this.o.localTimeoutMs / 1000}s`
297
+ : `local service error: ${err.message}`;
298
+ this.send({ type: 'http_error', id: f.id, message });
299
+ log(code === 'LOCAL_TIMEOUT' ? 504 : 502);
300
+ }
301
+ finally {
302
+ this.http.delete(f.id);
303
+ }
304
+ }
305
+ /** One attempt against the local server. Resolves with the status once the response has fully streamed. */
306
+ forward(id, entry, method, path, headers, body) {
307
+ return new Promise((resolve, reject) => {
308
+ let settled = false;
309
+ let responded = false;
310
+ const fail = (err) => {
311
+ if (settled)
312
+ return;
313
+ settled = true;
314
+ clearTimeout(hard);
315
+ reject(err);
316
+ };
317
+ const req = http.request({
318
+ host: this.o.target.host,
319
+ port: this.o.target.port,
320
+ method,
321
+ path,
322
+ headers,
323
+ agent: false,
324
+ setHost: false,
325
+ });
326
+ entry.req = req;
327
+ // Hard limit: connect + response headers within localTimeoutMs.
328
+ const hard = setTimeout(() => {
329
+ if (responded)
330
+ return;
331
+ req.destroy(new LocalError('local timeout', 'LOCAL_TIMEOUT'));
332
+ }, this.o.localTimeoutMs);
333
+ req.on('error', (err) => {
334
+ if (responded)
335
+ return; // mid-stream failures are handled on the response
336
+ fail(err);
337
+ });
338
+ req.on('response', (res) => {
339
+ responded = true;
340
+ clearTimeout(hard);
341
+ entry.res = res;
342
+ if (entry.cancelled) {
343
+ res.destroy();
344
+ return fail(new LocalError('cancelled', 'CANCELLED'));
345
+ }
346
+ const outHeaders = {};
347
+ for (const [k, v] of Object.entries(res.headers))
348
+ if (v !== undefined)
349
+ outHeaders[k] = v;
350
+ this.send({ type: 'http_response_start', id, status: res.statusCode ?? 502, headers: outHeaders });
351
+ res.setTimeout(this.o.streamIdleMs, () => res.destroy(new LocalError('response stream idle', 'STREAM_IDLE')));
352
+ res.on('data', (chunk) => {
353
+ if (entry.cancelled)
354
+ return;
355
+ this.send({ type: 'http_response_chunk', id, data: chunk.toString('base64') });
356
+ this.applyBackpressure(res);
357
+ });
358
+ res.on('end', () => {
359
+ if (!entry.cancelled)
360
+ this.send({ type: 'http_response_end', id });
361
+ if (!settled) {
362
+ settled = true;
363
+ resolve(res.statusCode ?? 502);
364
+ }
365
+ });
366
+ res.on('error', (err) => {
367
+ // Headers already went out: tell the relay the stream broke so it can abort the visitor.
368
+ if (!entry.cancelled)
369
+ this.send({ type: 'http_error', id, message: `local stream error: ${err.message}` });
370
+ if (!settled) {
371
+ settled = true;
372
+ resolve(res.statusCode ?? 502);
373
+ }
374
+ });
375
+ });
376
+ // Streaming body counter: abort the local stream if the cap is crossed.
377
+ if (body && body.length > 0) {
378
+ let sent = 0;
379
+ for (let off = 0; off < body.length; off += CHUNK) {
380
+ const piece = body.subarray(off, off + CHUNK);
381
+ sent += piece.length;
382
+ if (sent > this.maxBodyBytes) {
383
+ req.destroy();
384
+ return fail(new LocalError(`slink: request body exceeds ${this.o.maxBodyMb} MB`, 'BODY_TOO_LARGE'));
385
+ }
386
+ req.write(piece);
387
+ }
388
+ }
389
+ req.end();
390
+ });
391
+ }
392
+ /** Pause the local response while the tunnel socket has too much unsent data. */
393
+ applyBackpressure(res) {
394
+ const ws = this.ws;
395
+ if (!ws || ws.bufferedAmount < HIGH_WATER || res.isPaused())
396
+ return;
397
+ res.pause();
398
+ const check = setInterval(() => {
399
+ if (!this.ws || this.ws !== ws || res.destroyed) {
400
+ clearInterval(check);
401
+ res.destroy();
402
+ return;
403
+ }
404
+ if (ws.bufferedAmount < LOW_WATER) {
405
+ clearInterval(check);
406
+ res.resume();
407
+ }
408
+ }, 20);
409
+ }
410
+ // ─── WebSocket ────────────────────────────────────────────────────────────
411
+ closeStream(id, code, reason) {
412
+ const s = this.sockets.get(id);
413
+ this.sockets.delete(id);
414
+ s?.close(code, reason);
415
+ this.send({ type: 'ws_close', id, code, reason });
416
+ }
417
+ async handleWsOpen(f) {
418
+ const started = Date.now();
419
+ const log = (status) => this.o.requestLog?.write({ leaseId: f.lease_id, method: 'WS', path: f.path, status, ms: Date.now() - started });
420
+ const refuse = (message, status) => {
421
+ this.send({ type: 'ws_error', id: f.id, message });
422
+ log(status);
423
+ };
424
+ let url;
425
+ try {
426
+ url = targetWsUrl(this.o.target, f.path);
427
+ }
428
+ catch (err) {
429
+ return refuse(err.message, 400);
430
+ }
431
+ if (this.sockets.size + this.http.size >= this.o.maxConcurrent)
432
+ return refuse('slink: too many concurrent streams', 503);
433
+ if (!this.bucket.take())
434
+ return refuse('slink: local rate limit exceeded', 429);
435
+ this.o.wake?.touch();
436
+ const protoHeader = f.headers['sec-websocket-protocol'];
437
+ const protocols = (Array.isArray(protoHeader) ? protoHeader.join(',') : (protoHeader ?? ''))
438
+ .split(',')
439
+ .map((p) => p.trim())
440
+ .filter(Boolean);
441
+ const headers = sanitizeHeaders(f.headers, this.o.target, { websocket: true });
442
+ const open = (allowWake) => {
443
+ const up = new WebSocket(url, protocols, {
444
+ headers: headers,
445
+ handshakeTimeout: this.o.localTimeoutMs,
446
+ maxPayload: this.maxBodyBytes,
447
+ perMessageDeflate: false,
448
+ });
449
+ let opened = false;
450
+ this.sockets.set(f.id, up);
451
+ up.on('open', () => {
452
+ opened = true;
453
+ this.send({ type: 'ws_opened', id: f.id });
454
+ log(101);
455
+ });
456
+ up.on('message', (data, isBinary) => {
457
+ const buf = Array.isArray(data) ? Buffer.concat(data) : Buffer.from(data);
458
+ this.send({ type: 'ws_message', id: f.id, binary: isBinary, data: isBinary ? buf.toString('base64') : buf.toString('utf8') });
459
+ });
460
+ up.on('unexpected-response', (_req, res) => {
461
+ this.sockets.delete(f.id);
462
+ refuse(`local server answered the upgrade with HTTP ${res.statusCode}`, res.statusCode ?? 502);
463
+ up.terminate();
464
+ });
465
+ up.on('close', (code, reason) => {
466
+ if (!opened)
467
+ return;
468
+ if (this.sockets.get(f.id) === up) {
469
+ this.sockets.delete(f.id);
470
+ this.send({ type: 'ws_close', id: f.id, code, reason: reason.toString() });
471
+ }
472
+ });
473
+ up.on('error', (err) => {
474
+ if (opened || this.sockets.get(f.id) !== up)
475
+ return;
476
+ this.sockets.delete(f.id);
477
+ if (allowWake && errCode(err) === 'ECONNREFUSED' && this.o.wake?.canWake) {
478
+ this.o.wake
479
+ .ensureAwake()
480
+ .then(() => open(false))
481
+ .catch((wakeErr) => refuse(`wake failed: ${wakeErr.message}`, 502));
482
+ return;
483
+ }
484
+ refuse(`local WebSocket error: ${err.message}`, 502);
485
+ });
486
+ };
487
+ open(true);
488
+ }
489
+ }
490
+ //# sourceMappingURL=tunnel.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tunnel.js","sourceRoot":"","sources":["../src/tunnel.ts"],"names":[],"mappings":"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"}
package/dist/wake.d.ts ADDED
@@ -0,0 +1,32 @@
1
+ import type { Target } from './guard.js';
2
+ export declare function isPortOpen(target: Target, timeoutMs?: number): Promise<boolean>;
3
+ export declare function waitForPort(target: Target, timeoutMs: number, intervalMs?: number): Promise<boolean>;
4
+ export interface WakeOptions {
5
+ target: Target;
6
+ wakeCmd?: string;
7
+ sleepCmd?: string;
8
+ idleMinutes?: number;
9
+ /** How long to wait for the port after running the wake command (spec: 10s). */
10
+ wakeTimeoutMs?: number;
11
+ log?: (msg: string) => void;
12
+ }
13
+ export declare class WakeManager {
14
+ private readonly opts;
15
+ private waking;
16
+ private idleTimer;
17
+ private activeSinceSleep;
18
+ private sleeping;
19
+ /** Number of times the wake command has actually been spawned (observable for tests/status). */
20
+ wakeRuns: number;
21
+ constructor(opts: WakeOptions);
22
+ get canWake(): boolean;
23
+ /** Call on every proxied request: resets the idle-sleep countdown. */
24
+ touch(): void;
25
+ /**
26
+ * Run the wake command once, however many requests hit a refused port at the same time
27
+ * (they all await the same promise), then poll until the port accepts connections.
28
+ */
29
+ ensureAwake(): Promise<void>;
30
+ private sleep;
31
+ stop(): void;
32
+ }