@tinyactors/node 0.2.0 → 0.3.0

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/node/index.js DELETED
@@ -1,44 +0,0 @@
1
- 'use strict';
2
- /**
3
- * tinyactors for Node.js — the xstate-style API (bindings/shared/core.mjs)
4
- * over the native addon written against the N-API C API (src/addon.c).
5
- */
6
- const path = require('path');
7
- const { createRuntime } = require('../shared/core.mjs');
8
-
9
- /* The addon: an override, then this tree's build (mise run node:build),
10
- * then the platform package an install of @tinyactors/node brings
11
- * (@tinyactors/node-<platform>-<arch>, an optional dependency npm, pnpm and
12
- * Bun install only where it matches). The platform package is tried last,
13
- * so its error is the one an install without a matching addon reports. */
14
- function loadNative() {
15
- const candidates = [
16
- process.env.TINYACTORS_NATIVE,
17
- path.join(__dirname, 'build', 'tinyactors.node'),
18
- `@tinyactors/node-${process.platform}-${process.arch}`,
19
- ].filter(Boolean);
20
- let lastError;
21
- for (const p of candidates) {
22
- try {
23
- return require(p);
24
- } catch (e) {
25
- lastError = e;
26
- }
27
- }
28
- throw lastError;
29
- }
30
-
31
- const platform = {
32
- now: () => performance.now(),
33
- defer: (fn) => setImmediate(fn),
34
- cancelDefer: (h) => clearImmediate(h),
35
- setTimer: (fn, ms) => setTimeout(fn, ms),
36
- clearTimer: (h) => clearTimeout(h),
37
- log: (...args) => console.log(...args),
38
- };
39
-
40
- /* links in Node also over WebSocket servers ({ server, path } or { port })
41
- * and TCP ({ tcp }): transports.js */
42
- const api = require('./transports').withNodeTransports(createRuntime({ native: loadNative(), platform }));
43
-
44
- module.exports = api;
@@ -1,60 +0,0 @@
1
- 'use strict';
2
- /**
3
- * Node.js transports for links, added to createLink/serveLinks of both the
4
- * addon (index.js) and the wasm binding in Node (../web/node.mjs):
5
- *
6
- * serveLinks(system, { port | server, path }) WebSocket (ws.js)
7
- * serveLinks(system, { tcp: { port, host } }) TCP, length-prefixed frames
8
- * createLink(system, { tcp: { host, port } }) TCP client
9
- *
10
- * Any other byte stream (a child process's stdio, a serial port) goes through
11
- * the runtime-independent `transport` / `accept` options: core.mjs frames
12
- * streams itself (docs/protocol.md, "Framing").
13
- */
14
- const net = require('net');
15
- const { webSocketSource } = require('./ws');
16
-
17
- /* accepted TCP connections for serveLinks({ accept }) */
18
- function tcpSource({ port = 0, host } = {}) {
19
- const server = net.createServer();
20
- const sockets = new Set();
21
- server.listen(port, host);
22
- return {
23
- get port() {
24
- const a = server.address();
25
- return a && typeof a === 'object' ? a.port : undefined;
26
- },
27
- accept(onConnection) {
28
- server.on('connection', (socket) => {
29
- socket.setNoDelay(true);
30
- sockets.add(socket);
31
- socket.on('close', () => sockets.delete(socket));
32
- onConnection(socket);
33
- });
34
- return () =>
35
- new Promise((resolve) => {
36
- for (const s of sockets) s.destroy();
37
- server.close(() => resolve());
38
- });
39
- },
40
- };
41
- }
42
-
43
- function withNodeTransports(api) {
44
- const serveAny = api.serveLinks;
45
- const linkAny = api.createLink;
46
- api.serveLinks = function serveLinks(system, options = {}) {
47
- if (options.accept) return serveAny(system, options);
48
- const source = options.tcp ? tcpSource(options.tcp) : webSocketSource(options);
49
- const served = serveAny(system, { ...options, accept: source.accept });
50
- return Object.defineProperty(served, 'port', { get: () => source.port, enumerable: true });
51
- };
52
- api.createLink = function createLink(system, options = {}) {
53
- if (!options.tcp) return linkAny(system, options);
54
- const { host = '127.0.0.1', port } = options.tcp;
55
- return linkAny(system, { ...options, transport: () => net.connect({ host, port }).setNoDelay(true) });
56
- };
57
- return api;
58
- }
59
-
60
- module.exports = { withNodeTransports, tcpSource };
package/node/ws.js DELETED
@@ -1,152 +0,0 @@
1
- 'use strict';
2
- /**
3
- * A minimal WebSocket server (RFC 6455) for links: text frames, ping/pong,
4
- * close, fragmentation, no extensions. Each accepted connection is a
5
- * WebSocket-like object { send, close, onopen, onmessage, onclose } — the
6
- * transport serveLinks() expects. No dependencies.
7
- */
8
- const crypto = require('crypto');
9
- const http = require('http');
10
-
11
- const GUID = '258EAFA5-E914-47DA-95CA-C5AB0DC85B11';
12
-
13
- function frame(opcode, payload) {
14
- const n = payload.length;
15
- const head = n < 126 ? Buffer.alloc(2) : n < 65536 ? Buffer.alloc(4) : Buffer.alloc(10);
16
- head[0] = 0x80 | opcode;
17
- if (n < 126) head[1] = n;
18
- else if (n < 65536) {
19
- head[1] = 126;
20
- head.writeUInt16BE(n, 2);
21
- } else {
22
- head[1] = 127;
23
- head.writeBigUInt64BE(BigInt(n), 2);
24
- }
25
- return Buffer.concat([head, payload]);
26
- }
27
-
28
- function accept(socket, head) {
29
- const conn = { onopen: null, onmessage: null, onclose: null, onerror: null, readyState: 1 };
30
- let buf = head && head.length ? Buffer.from(head) : Buffer.alloc(0);
31
- let parts = [];
32
- let closed = false;
33
- const finish = () => {
34
- if (closed) return;
35
- closed = true;
36
- conn.readyState = 3;
37
- if (conn.onclose) conn.onclose({});
38
- };
39
- conn.send = (text) => {
40
- if (!closed) socket.write(frame(0x1, Buffer.from(String(text))));
41
- };
42
- conn.close = () => {
43
- if (closed) return;
44
- try {
45
- socket.end(frame(0x8, Buffer.alloc(0)));
46
- } catch {}
47
- finish();
48
- };
49
- function parse() {
50
- for (;;) {
51
- if (buf.length < 2) return;
52
- const fin = (buf[0] & 0x80) !== 0;
53
- const op = buf[0] & 0x0f;
54
- const masked = (buf[1] & 0x80) !== 0;
55
- let len = buf[1] & 0x7f;
56
- let off = 2;
57
- if (len === 126) {
58
- if (buf.length < 4) return;
59
- len = buf.readUInt16BE(2);
60
- off = 4;
61
- } else if (len === 127) {
62
- if (buf.length < 10) return;
63
- len = Number(buf.readBigUInt64BE(2));
64
- off = 10;
65
- }
66
- const maskOff = off;
67
- if (masked) off += 4;
68
- if (buf.length < off + len) return;
69
- let payload = buf.subarray(off, off + len);
70
- if (masked) {
71
- payload = Buffer.from(payload);
72
- for (let i = 0; i < payload.length; i++) payload[i] ^= buf[maskOff + (i & 3)];
73
- }
74
- buf = buf.subarray(off + len);
75
- if (op === 0x8) return conn.close();
76
- if (op === 0x9) {
77
- socket.write(frame(0xa, payload));
78
- continue;
79
- }
80
- if (op === 0xa) continue;
81
- parts.push(payload);
82
- if (fin) {
83
- const data = Buffer.concat(parts).toString('utf8');
84
- parts = [];
85
- if (conn.onmessage) conn.onmessage({ data });
86
- }
87
- }
88
- }
89
- socket.on('data', (d) => {
90
- buf = buf.length ? Buffer.concat([buf, d]) : d;
91
- parse();
92
- });
93
- socket.on('close', finish);
94
- socket.on('error', finish);
95
- socket.setNoDelay(true);
96
- if (buf.length) setImmediate(parse);
97
- return conn;
98
- }
99
-
100
- /**
101
- * Accept WebSocket upgrades on `server` (or a new server on `port`) at `path`.
102
- * Returns { accept(onConnection) -> stop, port } for serveLinks().
103
- */
104
- function webSocketSource({ server, port, path = '/link' } = {}) {
105
- let own = null;
106
- if (!server) {
107
- own = http.createServer((req, res) => {
108
- res.writeHead(426, { 'content-type': 'text/plain' });
109
- res.end('links only\n');
110
- });
111
- own.listen(port || 0);
112
- server = own;
113
- }
114
- let handler = null;
115
- const source = {
116
- server,
117
- get port() {
118
- const a = server.address();
119
- return a && typeof a === 'object' ? a.port : undefined;
120
- },
121
- accept(onConnection) {
122
- handler = (req, socket, head) => {
123
- const url = new URL(req.url, 'http://x');
124
- if (url.pathname !== path) return; /* someone else's upgrade */
125
- const key = req.headers['sec-websocket-key'];
126
- if (!key || String(req.headers.upgrade).toLowerCase() !== 'websocket') {
127
- socket.end('HTTP/1.1 400 Bad Request\r\n\r\n');
128
- return;
129
- }
130
- const acceptKey = crypto.createHash('sha1').update(key + GUID).digest('base64');
131
- socket.write(
132
- 'HTTP/1.1 101 Switching Protocols\r\nUpgrade: websocket\r\nConnection: Upgrade\r\n' +
133
- `Sec-WebSocket-Accept: ${acceptKey}\r\n\r\n`,
134
- );
135
- onConnection(accept(socket, head));
136
- };
137
- server.on('upgrade', handler);
138
- return () =>
139
- new Promise((resolve) => {
140
- server.off('upgrade', handler);
141
- if (own) {
142
- if (own.closeAllConnections) own.closeAllConnections();
143
- own.close(() => resolve());
144
- }
145
- else resolve();
146
- });
147
- },
148
- };
149
- return source;
150
- }
151
-
152
- module.exports = { webSocketSource };