iobroker.bee 0.0.0-stage → 0.2.2

package/build/lib/tunnel.js

@@ -0,0 +1,293 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Mux = exports.TunnelStream = exports.ConsoleReader = exports.CONSOLE = exports.CLOSE = exports.REFUSE_HEADER = exports.MAX_PAYLOAD = exports.WINDOW = exports.FRAME = void 0;
+exports.consoleMessage = consoleMessage;
+exports.resizeMessage = resizeMessage;
+/**
+ * Stream multiplexer of the remote access tunnel.
+ *
+ * This file exists in both repositories: beekeeper-server/src/tunnel.ts and ioBroker.bee/src/lib/tunnel.ts.
+ * Both copies must stay identical; it imports nothing but Node.js.
+ *
+ * One WebSocket between agent and server carries all connections of the browser (admin and vis-2 open
+ * several at once, plus their own WebSocket). Every binary WebSocket message is one frame:
+ *
+ *   type (1 byte) | stream id (4 bytes, big endian) | payload
+ *
+ *   OPEN   server -> agent  new stream; the agent connects it to the local web interface, or starts a shell
+ *                            (console, see CONSOLE)
+ *   DATA   both             bytes of the stream, at most MAX_PAYLOAD
+ *   END    both             no more bytes in this direction (half close)
+ *   RESET  both             abort; payload: reason (UTF-8)
+ *   ACK    both             payload: 4 bytes, number of received bytes passed on
+ *
+ * Flow control per stream: a side sends at most WINDOW bytes the other side has not acknowledged.
+ * A slow browser or a slow local interface stalls only its own stream, not the tunnel, and neither
+ * side buffers more than WINDOW bytes per stream.
+ */
+const node_stream_1 = require("node:stream");
+exports.FRAME = { OPEN: 1, DATA: 2, END: 3, RESET: 4, ACK: 5 };
+exports.WINDOW = 256 * 1024;
+exports.MAX_PAYLOAD = 32 * 1024;
+const ACK_THRESHOLD = 64 * 1024;
+/**
+ * Header of the tunnel request with which the agent refuses a session (URI-encoded reason), e.g. because
+ * the owner does not allow this kind of access. The server answers 403 and ends the session.
+ */
+exports.REFUSE_HEADER = 'x-bee-refused';
+/** WebSocket close codes of the tunnel connection */
+exports.CLOSE = {
+    /** The session ended (operator, expiry, server stop): do not reconnect */
+    ENDED: 4000,
+    /** The agent refuses: the owner does not allow this kind of access */
+    NOT_ALLOWED: 4003,
+    /** The agent finds no local web interface of this kind */
+    NO_TARGET: 4004,
+    /** Another connection of the same session took over */
+    REPLACED: 4009,
+};
+/**
+ * A stream of a console session carries messages instead of raw bytes, because besides the bytes of the
+ * terminal the size of the window travels too:
+ *
+ *   type (1 byte) | length (4 bytes, big endian) | payload
+ *
+ *   DATA    both             bytes of the terminal: input of the browser, output of the shell
+ *   RESIZE  server -> agent  columns (2 bytes) | rows (2 bytes)
+ *   EXIT    agent -> server  the shell ended; payload: exit code or signal (UTF-8)
+ */
+exports.CONSOLE = { DATA: 1, RESIZE: 2, EXIT: 3 };
+const MAX_CONSOLE_MESSAGE = 1024 * 1024;
+function consoleMessage(type, payload = Buffer.alloc(0)) {
+    const buf = Buffer.allocUnsafe(5 + payload.length);
+    buf[0] = type;
+    buf.writeUInt32BE(payload.length, 1);
+    payload.copy(buf, 5);
+    return buf;
+}
+function resizeMessage(cols, rows) {
+    const payload = Buffer.allocUnsafe(4);
+    payload.writeUInt16BE(cols, 0);
+    payload.writeUInt16BE(rows, 2);
+    return consoleMessage(exports.CONSOLE.RESIZE, payload);
+}
+/** Splits the bytes of a console stream into messages */
+class ConsoleReader {
+    onMessage;
+    buf = Buffer.alloc(0);
+    constructor(onMessage) {
+        this.onMessage = onMessage;
+    }
+    /** @returns false if the stream is broken (message too large); then nothing more comes out */
+    push(chunk) {
+        this.buf = this.buf.length ? Buffer.concat([this.buf, chunk]) : chunk;
+        while (this.buf.length >= 5) {
+            const length = this.buf.readUInt32BE(1);
+            if (length > MAX_CONSOLE_MESSAGE) {
+                this.buf = Buffer.alloc(0);
+                return false;
+            }
+            if (this.buf.length < 5 + length) {
+                break;
+            }
+            const type = this.buf[0];
+            const payload = this.buf.subarray(5, 5 + length);
+            this.buf = this.buf.subarray(5 + length);
+            this.onMessage(type, payload);
+        }
+        return true;
+    }
+}
+exports.ConsoleReader = ConsoleReader;
+function frame(type, id, payload) {
+    const buf = Buffer.allocUnsafe(5 + (payload?.length ?? 0));
+    buf[0] = type;
+    buf.writeUInt32BE(id, 1);
+    payload?.copy(buf, 5);
+    return buf;
+}
+/** One connection of the browser inside the tunnel */
+class TunnelStream extends node_stream_1.Duplex {
+    mux;
+    id;
+    /** Bytes this side may still send */
+    credit = exports.WINDOW;
+    /** Write waiting for credit */
+    pending = null;
+    /** Received bytes passed on but not yet acknowledged */
+    unacked = 0;
+    /** The reader did not take everything: acknowledge once it asks for more */
+    paused = false;
+    sentEnd = false;
+    gotEnd = false;
+    gotReset = false;
+    constructor(mux, id) {
+        super({ allowHalfOpen: true });
+        this.mux = mux;
+        this.id = id;
+    }
+    _write(chunk, _encoding, callback) {
+        this.send(chunk, callback);
+    }
+    send(chunk, callback) {
+        while (chunk.length) {
+            const n = Math.min(chunk.length, this.credit, exports.MAX_PAYLOAD);
+            if (n <= 0) {
+                this.pending = { chunk, callback };
+                return;
+            }
+            this.mux.sendFrame(exports.FRAME.DATA, this.id, chunk.subarray(0, n));
+            this.mux.bytesOut += n;
+            this.credit -= n;
+            chunk = chunk.subarray(n);
+        }
+        callback();
+    }
+    _final(callback) {
+        this.sentEnd = true;
+        this.mux.sendFrame(exports.FRAME.END, this.id);
+        callback();
+    }
+    _read() {
+        if (this.paused) {
+            this.paused = false;
+            this.ack(true);
+        }
+    }
+    _destroy(err, callback) {
+        if (!this.gotReset && !(this.sentEnd && this.gotEnd)) {
+            this.mux.sendFrame(exports.FRAME.RESET, this.id, Buffer.from(err?.message || 'closed'));
+        }
+        this.mux.forget(this.id);
+        const pending = this.pending;
+        this.pending = null;
+        pending?.callback(err || new Error('stream closed'));
+        callback(err);
+    }
+    ack(force) {
+        if (this.paused || !this.unacked || this.destroyed || (!force && this.unacked < ACK_THRESHOLD)) {
+            return;
+        }
+        const payload = Buffer.allocUnsafe(4);
+        payload.writeUInt32BE(this.unacked, 0);
+        this.unacked = 0;
+        this.mux.sendFrame(exports.FRAME.ACK, this.id, payload);
+    }
+    /** Frame from the other side, passed on by the Mux */
+    handle(type, payload) {
+        if (type === exports.FRAME.DATA) {
+            if (this.gotEnd) {
+                return;
+            }
+            this.mux.bytesIn += payload.length;
+            this.unacked += payload.length;
+            if (this.push(payload)) {
+                this.ack(false);
+            }
+            else {
+                this.paused = true;
+            }
+        }
+        else if (type === exports.FRAME.END) {
+            this.gotEnd = true;
+            this.push(null);
+        }
+        else if (type === exports.FRAME.ACK && payload.length >= 4) {
+            this.credit += payload.readUInt32BE(0);
+            const pending = this.pending;
+            if (pending) {
+                this.pending = null;
+                this.send(pending.chunk, pending.callback);
+            }
+        }
+        else if (type === exports.FRAME.RESET) {
+            this.gotReset = true;
+            this.destroy(new Error(payload.toString('utf8') || 'reset by the other side'));
+        }
+    }
+}
+exports.TunnelStream = TunnelStream;
+/**
+ * Both ends of the tunnel. `send` puts a frame on the WebSocket; frames from the WebSocket go to
+ * `receive`. Only the server opens streams; the agent gets them through `onStream`.
+ */
+class Mux {
+    send;
+    onStream;
+    streams = new Map();
+    nextId = 1;
+    closed = false;
+    /** Payload bytes received and sent, for the audit log */
+    bytesIn = 0;
+    bytesOut = 0;
+    constructor(send, onStream) {
+        this.send = send;
+        this.onStream = onStream;
+    }
+    get size() {
+        return this.streams.size;
+    }
+    get isClosed() {
+        return this.closed;
+    }
+    open() {
+        if (this.closed) {
+            throw new Error('tunnel closed');
+        }
+        const id = this.nextId;
+        this.nextId = this.nextId >= 0xffffffff ? 1 : this.nextId + 1;
+        const stream = new TunnelStream(this, id);
+        this.streams.set(id, stream);
+        this.sendFrame(exports.FRAME.OPEN, id);
+        return stream;
+    }
+    receive(buf) {
+        if (this.closed || buf.length < 5) {
+            return;
+        }
+        const type = buf[0];
+        const id = buf.readUInt32BE(1);
+        const payload = buf.subarray(5);
+        if (type === exports.FRAME.OPEN) {
+            if (!this.onStream || this.streams.has(id)) {
+                this.sendFrame(exports.FRAME.RESET, id, Buffer.from('refused'));
+                return;
+            }
+            const stream = new TunnelStream(this, id);
+            this.streams.set(id, stream);
+            this.onStream(stream);
+            return;
+        }
+        const stream = this.streams.get(id);
+        if (stream) {
+            stream.handle(type, payload);
+        }
+        else if (type === exports.FRAME.DATA) {
+            // late data for a stream this side already closed
+            this.sendFrame(exports.FRAME.RESET, id, Buffer.from('unknown stream'));
+        }
+    }
+    /** @internal */
+    sendFrame(type, id, payload) {
+        if (!this.closed) {
+            this.send(frame(type, id, payload));
+        }
+    }
+    /** @internal */
+    forget(id) {
+        this.streams.delete(id);
+    }
+    /** The WebSocket is gone: every stream ends with an error */
+    close(reason = 'tunnel closed') {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        for (const stream of [...this.streams.values()]) {
+            stream.destroy(new Error(reason));
+        }
+        this.streams.clear();
+    }
+}
+exports.Mux = Mux;
+//# sourceMappingURL=tunnel.js.map

package/build/lib/tunnel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel.js","sourceRoot":"","sources":["../../src/lib/tunnel.ts"],"names":[],"mappings":"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"}

package/build/lib/util.js

@@ -0,0 +1,102 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.encodePayload = encodePayload;
+exports.decodePayload = decodePayload;
+exports.compareVersions = compareVersions;
+exports.flatten = flatten;
+exports.diffFlat = diffFlat;
+exports.writeJsonAtomic = writeJsonAtomic;
+exports.readJson = readJson;
+exports.inWindow = inWindow;
+exports.sleep = sleep;
+const node_zlib_1 = require("node:zlib");
+const promises_1 = require("node:fs/promises");
+const semver_1 = __importDefault(require("semver"));
+function encodePayload(obj) {
+    return (0, node_zlib_1.gzipSync)(Buffer.from(JSON.stringify(obj)));
+}
+function decodePayload(buf) {
+    if (buf.length > 2 && buf[0] === 0x1f && buf[1] === 0x8b) {
+        buf = (0, node_zlib_1.gunzipSync)(buf);
+    }
+    return JSON.parse(buf.toString('utf8'));
+}
+/**
+ * Compares two versions. Non-semver strings are compared lexically.
+ *
+ * @returns negative if a < b, 0 if equal, positive if a > b
+ */
+function compareVersions(a, b) {
+    const va = semver_1.default.valid(a) ?? semver_1.default.coerce(a)?.version;
+    const vb = semver_1.default.valid(b) ?? semver_1.default.coerce(b)?.version;
+    if (va && vb) {
+        return semver_1.default.compare(va, vb);
+    }
+    return a.localeCompare(b);
+}
+function escapeKey(key) {
+    return key.replace(/~/g, '~0').replace(/\//g, '~1');
+}
+/** Flattens an object to JSON pointer paths (same format as the server) */
+function flatten(obj, prefix = '', out = {}) {
+    if (obj !== null && typeof obj === 'object' && !Array.isArray(obj) && Object.keys(obj).length) {
+        for (const [k, v] of Object.entries(obj)) {
+            flatten(v, `${prefix}/${escapeKey(k)}`, out);
+        }
+    }
+    else {
+        out[prefix] = obj;
+    }
+    return out;
+}
+function diffFlat(prev, next) {
+    const set = {};
+    const unset = [];
+    for (const [k, v] of Object.entries(next)) {
+        if (!(k in prev) || JSON.stringify(prev[k]) !== JSON.stringify(v)) {
+            set[k] = v;
+        }
+    }
+    for (const k of Object.keys(prev)) {
+        if (!(k in next)) {
+            unset.push(k);
+        }
+    }
+    return { set, unset };
+}
+/** Writes JSON atomically (temp file + rename), so a power loss never leaves half a file */
+async function writeJsonAtomic(file, data) {
+    const tmp = `${file}.tmp`;
+    await (0, promises_1.writeFile)(tmp, JSON.stringify(data, null, 2), { mode: 0o600 });
+    await (0, promises_1.rename)(tmp, file);
+}
+async function readJson(file) {
+    try {
+        return JSON.parse(await (0, promises_1.readFile)(file, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** "HH:MM" -> minutes since midnight */
+function minutes(hhmm) {
+    const m = /^(\d{1,2}):(\d{2})$/.exec((hhmm || '').trim());
+    return m ? parseInt(m[1], 10) * 60 + parseInt(m[2], 10) : null;
+}
+/** True if `date` lies in the daily window [start, end). Windows may span midnight (22:00-05:00). */
+function inWindow(date, start, end) {
+    const s = minutes(start);
+    const e = minutes(end);
+    if (s === null || e === null || s === e) {
+        return true;
+    }
+    const now = date.getHours() * 60 + date.getMinutes();
+    return s < e ? now >= s && now < e : now >= s || now < e;
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=util.js.map

package/build/lib/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/lib/util.ts"],"names":[],"mappings":"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"}