@marifold/core 0.69.0 → 0.71.0

package/dist/workspace/bridge/BridgePeer.js

@@ -0,0 +1,307 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BridgePeer = void 0;
+const ws_1 = __importDefault(require("ws"));
+const ChunkTransfers_1 = require("./ChunkTransfers");
+const workspace_protocol_1 = require("@marifold/workspace-protocol");
+class BridgePeer {
+    options;
+    socket;
+    stopped = false;
+    connected = false;
+    retry;
+    ping;
+    retryMs = 1000;
+    pending = new Map();
+    controls = new Map();
+    seen = new Map();
+    transfers = new ChunkTransfers_1.ChunkTransfers();
+    transferWindow = 1;
+    inflight = new Map();
+    lastPong = Date.now();
+    hostDeviceId;
+    constructor(options) {
+        this.options = options;
+        this.hostDeviceId = options.hostDeviceId;
+    }
+    get online() {
+        return this.connected;
+    }
+    get hostId() {
+        if (!this.hostDeviceId)
+            throw new Error('Bridge is not connected.');
+        return this.hostDeviceId;
+    }
+    start() {
+        this.stopped = false;
+        this.connect();
+    }
+    close() {
+        this.stopped = true;
+        clearTimeout(this.retry);
+        clearInterval(this.ping);
+        this.socket?.close();
+        this.connected = false;
+        for (const p of this.pending.values()) {
+            clearTimeout(p.timer);
+            p.reject(new Error('Workspace connection closed.'));
+        }
+        this.pending.clear();
+        this.transfers.reset();
+        for (const control of this.controls.values())
+            control.reject();
+        this.controls.clear();
+    }
+    async ready(timeoutMs = 10000) {
+        const end = Date.now() + timeoutMs;
+        while (!this.connected && !this.stopped && Date.now() < end)
+            await new Promise((r) => setTimeout(r, 25));
+        if (!this.connected)
+            throw new Error('Workspace bridge is unavailable.');
+    }
+    request(operation, input, recipient = this.hostId, identity = this.options.host, id = (0, workspace_protocol_1.randomId)(), timeoutMs = 120000) {
+        if (this.pending.has(id))
+            return Promise.reject(new Error('Request is already awaiting a response.'));
+        if (!this.connected)
+            return Promise.reject(new Error('Workspace is offline.'));
+        if (this.pending.size >= 32)
+            return Promise.reject(new Error('Too many pending workspace operations.'));
+        if (Buffer.byteLength(JSON.stringify(input ?? null)) > 29 * 1024 * 1024)
+            return Promise.reject(new Error('Workspace request exceeds the transfer limit.'));
+        return new Promise((resolve, reject) => {
+            const request = { type: 'request', id, operation, input };
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error('Workspace request timed out. Its outcome may be unknown; it was not repeated under a new ID.'));
+            }, timeoutMs);
+            this.pending.set(id, { request, recipient, identity, resolve, reject, timer });
+            void this.transmit(recipient, identity, request).catch(() => {
+                /* reconnect resends with the same operation id */
+            });
+        });
+    }
+    revoke(deviceId) {
+        if (!this.connected)
+            return Promise.reject(new Error('Bridge unavailable; revocation will be sent after reconnect.'));
+        const id = (0, workspace_protocol_1.randomId)();
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.controls.delete(id);
+                reject(new Error('Bridge revocation was not acknowledged.'));
+            }, 5000);
+            this.controls.set(id, {
+                resolve: () => {
+                    clearTimeout(timer);
+                    this.controls.delete(id);
+                    resolve();
+                },
+                reject: () => {
+                    clearTimeout(timer);
+                    reject(new Error('Bridge disconnected.'));
+                },
+            });
+            this.socket.send(JSON.stringify({ type: 'revoke', deviceId, id }));
+        });
+    }
+    connect() {
+        if (this.stopped)
+            return;
+        const url = new URL('/v1/connect', this.options.bridgeUrl);
+        url.protocol = url.protocol === 'https:' ? 'wss:' : 'ws:';
+        const socket = new ws_1.default(url, { maxPayload: 512 * 1024, perMessageDeflate: false });
+        this.socket = socket;
+        socket.on('message', (bytes) => {
+            try {
+                void this.receive(JSON.parse(bytes.toString())).catch(() => {
+                    /* invalid peer frames never reach dispatch */
+                });
+            }
+            catch {
+                socket.close(1008, 'Invalid frame');
+            }
+        });
+        socket.on('error', () => undefined);
+        socket.on('close', () => {
+            if (this.socket !== socket)
+                return;
+            this.connected = false;
+            this.transfers.reset();
+            this.options.onStatus?.(false);
+            clearInterval(this.ping);
+            if (!this.stopped) {
+                this.retry = setTimeout(() => this.connect(), this.retryMs + Math.random() * 500);
+                this.retryMs = Math.min(this.retryMs * 2, 15000);
+            }
+        });
+    }
+    async receive(value) {
+        const frame = (0, workspace_protocol_1.record)(value);
+        if (frame.type === 'challenge') {
+            this.socket?.send(JSON.stringify({
+                type: 'auth',
+                workspaceId: this.options.workspaceId,
+                deviceId: this.options.deviceId,
+                certificate: this.options.certificate,
+                identity: (0, workspace_protocol_1.publicIdentity)(this.options.identity),
+                signature: (0, workspace_protocol_1.signText)(this.options.identity, String(frame.nonce)),
+            }));
+            return;
+        }
+        if (frame.type === 'ready') {
+            this.transferWindow = frame.deliveryReplay === 'on-reconnect' ? 4 : 1;
+            this.hostDeviceId = String(frame.hostDeviceId);
+            if (this.options.hostDeviceId && this.hostDeviceId !== this.options.hostDeviceId) {
+                this.close();
+                throw new Error('Host identity changed.');
+            }
+            this.lastPong = Date.now();
+            this.connected = true;
+            this.retryMs = 1000;
+            this.options.onStatus?.(true);
+            this.ping = setInterval(() => {
+                if (Date.now() - this.lastPong > 45000) {
+                    this.socket?.terminate();
+                    return;
+                }
+                if (this.socket?.readyState === ws_1.default.OPEN)
+                    this.socket.send('{"type":"ping"}');
+            }, 15000);
+            for (const p of this.pending.values())
+                void this.transmit(p.recipient, p.identity, p.request).catch(() => undefined);
+            return;
+        }
+        if (frame.type === 'revoked') {
+            this.controls.get(String(frame.id))?.resolve();
+            return;
+        }
+        if (frame.type === 'pong') {
+            this.lastPong = Date.now();
+            return;
+        }
+        if (frame.type !== 'delivery')
+            return;
+        // Acknowledging transport receipt does not assert successful execution. The
+        // sender retains stable request IDs until it receives an application reply.
+        this.socket?.send(JSON.stringify({ type: 'ack', deliveryId: frame.deliveryId }));
+        const packet = (0, workspace_protocol_1.record)(frame.packet);
+        const message = packet.message;
+        const sender = message.header.sender;
+        const certificate = packet.certificate;
+        let identity;
+        if (sender === this.hostDeviceId)
+            identity = this.options.host;
+        else if (certificate) {
+            if (!(0, workspace_protocol_1.validMembership)(certificate, this.options.host) ||
+                certificate.membership.workspaceId !== this.options.workspaceId ||
+                certificate.membership.deviceId !== sender ||
+                this.options.accept?.(certificate) === false)
+                throw new Error('Invalid or revoked sender.');
+            identity = certificate.membership.identity;
+        }
+        else {
+            if (this.options.deviceId !== this.hostDeviceId || !sender.startsWith('pending_'))
+                throw new Error('Unpaired sender.');
+            identity = packet.identity;
+        }
+        const decoded = (0, workspace_protocol_1.record)(await (0, workspace_protocol_1.decryptMessage)(this.options.identity, identity, message, {
+            workspaceId: this.options.workspaceId,
+            recipient: this.options.deviceId,
+        }));
+        if (!certificate &&
+            sender !== this.hostDeviceId &&
+            (decoded.type !== 'request' || decoded.operation !== 'join' || JSON.stringify(decoded).length > 4096))
+            throw new Error('Invalid pairing message.');
+        for (const [id, expiry] of this.seen)
+            if (expiry < Date.now())
+                this.seen.delete(id);
+        if (this.seen.has(message.header.id))
+            return;
+        this.seen.set(message.header.id, message.header.expiresAt);
+        if (decoded.type === 'chunk_ack') {
+            this.transfers.acknowledge(sender, decoded);
+            return;
+        }
+        if (decoded.type === 'chunk') {
+            const { ack, text } = this.transfers.receive(sender, decoded);
+            await this.send(sender, identity, { ...ack, window: this.transferWindow });
+            if (text !== undefined)
+                await this.dispatch((0, workspace_protocol_1.record)(JSON.parse(text)), sender, identity, certificate);
+            return;
+        }
+        await this.dispatch(decoded, sender, identity, certificate);
+    }
+    async dispatch(data, sender, identity, certificate) {
+        if (data.type === 'response') {
+            const pending = this.pending.get(String(data.id));
+            if (!pending || pending.recipient !== sender)
+                return;
+            this.pending.delete(String(data.id));
+            clearTimeout(pending.timer);
+            if (data.ok === true)
+                pending.resolve(data.value);
+            else
+                pending.reject(new Error(typeof data.error === 'string' ? data.error : 'Workspace operation failed.'));
+            return;
+        }
+        if (data.type !== 'request' || typeof data.id !== 'string' || typeof data.operation !== 'string')
+            return;
+        if (!certificate && sender !== this.hostDeviceId && data.operation !== 'join')
+            throw new Error('Pairing required.');
+        const request = data;
+        const key = `${sender}:${request.id}`;
+        const hash = (0, workspace_protocol_1.digest)(JSON.stringify(request));
+        let entry = this.inflight.get(key);
+        if (entry && entry.hash !== hash)
+            throw new Error('Request ID was reused with different input.');
+        if (!entry) {
+            if (this.inflight.size >= 64)
+                throw new Error('Too many in-flight requests.');
+            const job = this.options.onRequest(request, { id: sender, identity, certificate });
+            entry = { hash, job };
+            this.inflight.set(key, entry);
+            void job.finally(() => this.inflight.delete(key)).catch(() => undefined);
+        }
+        let response;
+        try {
+            response = { type: 'response', id: request.id, ok: true, value: await entry.job };
+        }
+        catch (error) {
+            response = {
+                type: 'response',
+                id: request.id,
+                ok: false,
+                error: error instanceof Error ? error.message : 'Workspace operation failed.',
+            };
+        }
+        await this.transmit(sender, identity, response);
+    }
+    async transmit(recipient, identity, value) {
+        const text = JSON.stringify(value);
+        if (Buffer.byteLength(text) < 64000) {
+            await this.send(recipient, identity, value);
+            return;
+        }
+        await this.transfers.transmit(recipient, text, chunk => this.send(recipient, identity, chunk), this.transferWindow);
+    }
+    async send(recipient, identity, value) {
+        if (!this.connected || this.socket?.readyState !== ws_1.default.OPEN)
+            throw new Error('Workspace disconnected.');
+        const socket = this.socket;
+        const message = await (0, workspace_protocol_1.encryptMessage)(this.options.identity, identity, {
+            version: 1,
+            workspaceId: this.options.workspaceId,
+            sender: this.options.deviceId,
+            recipient,
+            id: (0, workspace_protocol_1.randomId)(),
+            expiresAt: Date.now() + workspace_protocol_1.MESSAGE_TTL_MS,
+        }, value);
+        if (this.socket !== socket || socket.readyState !== ws_1.default.OPEN)
+            throw new Error('Workspace disconnected.');
+        socket.send(JSON.stringify({ type: 'send', message }));
+    }
+}
+exports.BridgePeer = BridgePeer;
+//# sourceMappingURL=BridgePeer.js.map

package/dist/workspace/bridge/BridgePeer.js.map

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

package/dist/workspace/bridge/ChunkTransfers.d.ts

@@ -0,0 +1,19 @@
+type Send = (value: unknown) => Promise<void>;
+/** Bounded bulk traffic shares the connection without holding up ordinary messages. */
+export declare class ChunkTransfers {
+    private assemblies;
+    private acknowledgments;
+    private slots;
+    private active;
+    private generation;
+    reset(): void;
+    acknowledge(sender: string, frame: Record<string, unknown>): void;
+    receive(sender: string, frame: Record<string, unknown>): {
+        ack: Record<string, unknown>;
+        text?: string;
+    };
+    transmit(recipient: string, text: string, send: Send, relayWindow?: number): Promise<void>;
+    private sendChunk;
+}
+export {};
+//# sourceMappingURL=ChunkTransfers.d.ts.map

package/dist/workspace/bridge/ChunkTransfers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChunkTransfers.d.ts","sourceRoot":"","sources":["../../../src/workspace/bridge/ChunkTransfers.ts"],"names":[],"mappings":"AAkBA,KAAK,IAAI,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9C,uFAAuF;AACvF,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,eAAe,CAAqC;IAC5D,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,UAAU,CAAK;IAEvB,KAAK,IAAI,IAAI,CAKZ;IAED,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAGhE;IAED,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAiCvG;IAEK,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB/F;YAEa,SAAS;CAgCxB"}

package/dist/workspace/bridge/ChunkTransfers.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChunkTransfers = void 0;
+const workspace_protocol_1 = require("@marifold/workspace-protocol");
+const CHUNK_SIZE = 96000;
+const WINDOW = 4;
+const PEER_WINDOW = 8;
+const TRANSFER_LIMIT = 40 * 1024 * 1024;
+/** Bounded bulk traffic shares the connection without holding up ordinary messages. */
+class ChunkTransfers {
+    assemblies = new Map();
+    acknowledgments = new Map();
+    slots = [];
+    active = 0;
+    generation = 0;
+    reset() {
+        this.generation++;
+        this.assemblies.clear();
+        for (const ack of this.acknowledgments.values())
+            ack.reject();
+        this.acknowledgments.clear();
+    }
+    acknowledge(sender, frame) {
+        const ack = this.acknowledgments.get(`${frame.transfer}:${frame.index}`);
+        if (ack?.recipient === sender)
+            ack.accept(frame.window === WINDOW ? WINDOW : 1);
+    }
+    receive(sender, frame) {
+        const transfer = (0, workspace_protocol_1.identifier)(frame.transfer);
+        const index = frame.index;
+        if (typeof index !== 'number' || !Number.isSafeInteger(index) || index < 0 || index >= 1024 ||
+            typeof frame.data !== 'string' || frame.data.length === 0 || frame.data.length > 128000 ||
+            typeof frame.last !== 'boolean')
+            throw new Error('Invalid transfer chunk.');
+        const key = `${sender}:${transfer}`;
+        for (const [id, item] of this.assemblies)
+            if (item.expires < Date.now())
+                this.assemblies.delete(id);
+        let item = this.assemblies.get(key);
+        if (!item) {
+            if (this.assemblies.size >= 16 || index !== 0)
+                throw new Error('Invalid transfer.');
+            item = { parts: [], next: 0, bytes: 0, expires: Date.now() + 60000 };
+            this.assemblies.set(key, item);
+        }
+        // Chunk zero negotiates the window before the sender pipelines further chunks.
+        if (index >= item.next + WINDOW || item.parts[index] !== undefined ||
+            (item.last !== undefined && index > item.last) ||
+            (frame.last && (item.last !== undefined || item.parts.length > index + 1)))
+            throw new Error('Out-of-order transfer.');
+        item.parts[index] = frame.data;
+        item.bytes += frame.data.length;
+        item.expires = Date.now() + 60000;
+        if (frame.last)
+            item.last = index;
+        if (item.bytes > TRANSFER_LIMIT ||
+            [...this.assemblies.values()].reduce((total, entry) => total + entry.bytes, 0) > 64 * 1024 * 1024) {
+            this.assemblies.delete(key);
+            throw new Error('Transfer limit exceeded.');
+        }
+        while (item.parts[item.next] !== undefined)
+            item.next++;
+        const ack = { type: 'chunk_ack', transfer, index, window: WINDOW };
+        if (item.last === undefined || item.next !== item.last + 1)
+            return { ack };
+        this.assemblies.delete(key);
+        return { ack, text: Buffer.from(item.parts.join(''), 'base64').toString('utf8') };
+    }
+    async transmit(recipient, text, send, relayWindow = WINDOW) {
+        const encoded = Buffer.from(text).toString('base64');
+        if (encoded.length > TRANSFER_LIMIT)
+            throw new Error('Transfer exceeds limit.');
+        const transfer = (0, workspace_protocol_1.randomId)();
+        const generation = this.generation;
+        const chunkSize = relayWindow === WINDOW ? CHUNK_SIZE : 48000;
+        const chunk = (index) => this.sendChunk(recipient, {
+            type: 'chunk', transfer, index,
+            data: encoded.slice(index * chunkSize, (index + 1) * chunkSize),
+            last: (index + 1) * chunkSize >= encoded.length,
+        }, send, generation);
+        // Old receivers omit window and continue to receive one chunk at a time.
+        const window = Math.min(await chunk(0), relayWindow);
+        const count = Math.ceil(encoded.length / chunkSize);
+        for (let index = 1; index < count; index += window) {
+            await Promise.all(Array.from({ length: Math.min(window, count - index) }, (_, offset) => chunk(index + offset)));
+        }
+    }
+    async sendChunk(recipient, frame, send, generation) {
+        if (this.active >= PEER_WINDOW)
+            await new Promise(resolve => this.slots.push(resolve));
+        else
+            this.active++;
+        try {
+            if (generation !== this.generation)
+                throw new Error('Transfer disconnected.');
+            return await new Promise((resolve, reject) => {
+                const key = `${frame.transfer}:${frame.index}`;
+                const finish = (error, window = 1) => {
+                    clearTimeout(timer);
+                    this.acknowledgments.delete(key);
+                    if (error)
+                        reject(error);
+                    else
+                        resolve(window);
+                };
+                const timer = setTimeout(() => finish(new Error('Transfer acknowledgment timed out.')), 15000);
+                this.acknowledgments.set(key, {
+                    recipient,
+                    accept: window => finish(undefined, window),
+                    reject: () => finish(new Error('Transfer disconnected.')),
+                });
+                void send(frame).catch(error => finish(error));
+            });
+        }
+        finally {
+            const resume = this.slots.shift();
+            if (resume)
+                resume();
+            else
+                this.active--;
+        }
+    }
+}
+exports.ChunkTransfers = ChunkTransfers;
+//# sourceMappingURL=ChunkTransfers.js.map

package/dist/workspace/bridge/ChunkTransfers.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marifold/core",
-  "version": "0.69.0",
+  "version": "0.71.0",
   "description": "Core runtime for Marifold",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -12,17 +12,21 @@
     "better-sqlite3": "^13.0.1",
     "croner": "^10.0.1",
     "duck-duck-scrape": "^2.2.7",
+    "parse5": "^8.0.1",
     "sharp": "^0.35.3",
     "smol-toml": "^1.7.0",
     "typescript-compiler": "npm:typescript@^6.0.2",
     "undici": "^7.28.0",
-    "yaml": "^2.9.0"
+    "yaml": "^2.9.0",
+    "ws": "^8.18.3",
+    "@marifold/workspace-protocol": "0.71.0"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^24.13.3",
     "typescript": "^7.0.2",
-    "vitest": "^4.1.10"
+    "vitest": "^4.1.10",
+    "@types/ws": "^8.18.1"
   },
   "engines": {
     "node": ">=24.0.0 <25"