@peerbit/canonical-host 0.0.0-e209d2e

package/dist/src/shared-worker.js

@@ -0,0 +1,27 @@
+import { CanonicalHost, PeerbitCanonicalRuntime, } from "./index.js";
+let hostPromise;
+const getHost = async (options) => {
+    if (hostPromise)
+        return hostPromise;
+    const { modules, hostOptions, ...runtimeOptions } = options ?? {};
+    const runtime = new PeerbitCanonicalRuntime(runtimeOptions);
+    const host = new CanonicalHost(runtime, hostOptions);
+    if (modules?.length) {
+        host.registerModules(modules);
+    }
+    hostPromise = Promise.resolve(host);
+    return hostPromise;
+};
+export const installSharedWorkerHost = (options) => {
+    const scope = self;
+    const onConnect = async (e) => {
+        const port = e.ports?.[0];
+        if (!port) {
+            throw new Error("SharedWorker onconnect event missing MessagePort");
+        }
+        const host = await getHost(options);
+        host.attachControlPort(port);
+    };
+    scope.addEventListener("connect", onConnect);
+};
+//# sourceMappingURL=shared-worker.js.map

package/dist/src/shared-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-worker.js","sourceRoot":"","sources":["../../src/shared-worker.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,aAAa,EAIb,uBAAuB,GACvB,MAAM,YAAY,CAAC;AAOpB,IAAI,WAA+C,CAAC;AAEpD,MAAM,OAAO,GAAG,KAAK,EAAE,OAAwC,EAAE,EAAE;IAClE,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IACpC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAClE,MAAM,OAAO,GAAG,IAAI,uBAAuB,CAAC,cAAc,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,IAAI,aAAa,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACrD,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;QACrB,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO,WAAW,CAAC;AACpB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACtC,OAAwC,EACvC,EAAE;IACH,MAAM,KAAK,GAAG,IAA0C,CAAC;IACzD,MAAM,SAAS,GAAG,KAAK,EAAE,CAAe,EAAE,EAAE;QAC3C,MAAM,IAAI,GAAiB,CAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC,CAAC;IACF,KAAK,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAqC,CAAC,CAAC;AAC1E,CAAC,CAAC"}

package/dist/src/window.d.ts

@@ -0,0 +1,22 @@
+import { CanonicalHost, type CanonicalHostOptions, type CanonicalModule, type CanonicalRuntimeOptions } from "./index.js";
+export declare const CANONICAL_WINDOW_CONNECT_OP = "__peerbit_canonical_window_connect__";
+export declare const CANONICAL_WINDOW_READY_KEY = "__peerbit_canonical_window_ready__";
+export type InstallWindowHostOptions = CanonicalRuntimeOptions & {
+    modules?: CanonicalModule[];
+    hostOptions?: CanonicalHostOptions;
+    host?: CanonicalHost;
+    createHost?: () => CanonicalHost | Promise<CanonicalHost>;
+    channel?: string;
+    targetOrigin?: string;
+    allow?: (event: MessageEvent) => boolean;
+    onError?: (error: unknown) => void;
+};
+export type WindowHost = {
+    connect: (childWindow: Window, options?: {
+        origin?: string;
+    }) => void;
+    disconnect: (childWindow: Window) => void;
+    close: () => void;
+};
+export declare const installWindowHost: (options?: InstallWindowHostOptions) => WindowHost;
+//# sourceMappingURL=window.d.ts.map

package/dist/src/window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../../src/window.ts"],"names":[],"mappings":"AACA,OAAO,EACN,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAE5B,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,2BAA2B,yCACD,CAAC;AACxC,eAAO,MAAM,0BAA0B,uCAAuC,CAAC;AAE/E,MAAM,MAAM,wBAAwB,GAAG,uBAAuB,GAAG;IAChE,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;IACzC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACtE,UAAU,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,KAAK,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AAuCF,eAAO,MAAM,iBAAiB,GAC7B,UAAU,wBAAwB,KAChC,UAiGF,CAAC"}

package/dist/src/window.js

@@ -0,0 +1,117 @@
+import { createWindowTransport } from "@peerbit/canonical-transport";
+import { CanonicalHost, PeerbitCanonicalRuntime, } from "./index.js";
+export const CANONICAL_WINDOW_CONNECT_OP = "__peerbit_canonical_window_connect__";
+export const CANONICAL_WINDOW_READY_KEY = "__peerbit_canonical_window_ready__";
+let hostPromise;
+const getHost = async (options) => {
+    if (hostPromise)
+        return hostPromise;
+    const provided = options?.host;
+    const create = options?.createHost;
+    const { modules, hostOptions, ...runtimeOptions } = options ?? {};
+    const host = provided
+        ? provided
+        : create
+            ? await create()
+            : new CanonicalHost(new PeerbitCanonicalRuntime(runtimeOptions), hostOptions);
+    if (modules?.length) {
+        host.registerModules(modules);
+    }
+    hostPromise = Promise.resolve(host);
+    return hostPromise;
+};
+const coerceErrorMessage = (error) => {
+    if (error instanceof Error)
+        return error.message;
+    return String(error?.message ?? error);
+};
+const coerceOrigin = (origin) => {
+    if (typeof origin !== "string")
+        return undefined;
+    if (origin.length === 0 || origin === "null")
+        return undefined;
+    return origin;
+};
+export const installWindowHost = (options) => {
+    const channel = options?.channel ?? "peerbit-canonical";
+    const defaultTargetOrigin = options?.targetOrigin ?? "*";
+    const connections = new Map();
+    const connect = (childWindow, connectOptions) => {
+        if (connections.has(childWindow))
+            return;
+        const targetOrigin = connectOptions?.origin ?? defaultTargetOrigin;
+        const transport = createWindowTransport(childWindow, {
+            channel,
+            source: childWindow,
+            targetOrigin,
+        });
+        getHost(options)
+            .then((host) => {
+            const detach = host.attachControlTransport(transport);
+            connections.set(childWindow, detach);
+        })
+            .catch((error) => {
+            options?.onError?.(error);
+        });
+    };
+    const disconnect = (childWindow) => {
+        const detach = connections.get(childWindow);
+        if (!detach)
+            return;
+        connections.delete(childWindow);
+        detach();
+    };
+    const onMessage = (event) => {
+        if (options?.allow && !options.allow(event)) {
+            return;
+        }
+        const data = event.data;
+        const isConnect = data?.op === CANONICAL_WINDOW_CONNECT_OP ||
+            data?.__peerbit_canonical_window_connect__ === true;
+        if (!isConnect)
+            return;
+        if (data?.channel && String(data.channel) !== channel)
+            return;
+        const source = event.source;
+        if (!source || typeof source.postMessage !== "function") {
+            return;
+        }
+        const requestId = data?.requestId != null ? String(data.requestId) : undefined;
+        const origin = coerceOrigin(event.origin) ?? defaultTargetOrigin;
+        connect(source, { origin });
+        getHost(options)
+            .then(() => {
+            try {
+                source.postMessage({
+                    [CANONICAL_WINDOW_READY_KEY]: true,
+                    channel,
+                    requestId,
+                }, origin === "*" ? "*" : origin);
+            }
+            catch { }
+        })
+            .catch((error) => {
+            options?.onError?.(error);
+            const message = coerceErrorMessage(error);
+            try {
+                source.postMessage({
+                    [CANONICAL_WINDOW_READY_KEY]: false,
+                    channel,
+                    requestId,
+                    error: message,
+                }, origin === "*" ? "*" : origin);
+            }
+            catch { }
+        });
+    };
+    globalThis.addEventListener("message", onMessage);
+    const close = () => {
+        globalThis.removeEventListener("message", onMessage);
+        for (const detach of connections.values()) {
+            detach();
+        }
+        connections.clear();
+    };
+    return { connect, disconnect, close };
+};
+//# sourceMappingURL=window.js.map

package/dist/src/window.js.map

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

package/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "@peerbit/canonical-host",
+  "version": "0.0.0-e209d2e",
+  "description": "Peerbit canonical runtime host implementation (worker/server)",
+  "author": "dao.xyz",
+  "license": "MIT",
+  "sideEffects": false,
+  "type": "module",
+  "types": "./dist/src/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "*": [
+        "*",
+        "dist/*",
+        "dist/src/*",
+        "dist/src/*/index"
+      ],
+      "src/*": [
+        "*",
+        "dist/*",
+        "dist/src/*",
+        "dist/src/*/index"
+      ]
+    }
+  },
+  "files": [
+    "src",
+    "dist",
+    "!dist/test",
+    "!**/*.tsbuildinfo"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    },
+    "./shared-worker": {
+      "types": "./dist/src/shared-worker.d.ts",
+      "import": "./dist/src/shared-worker.js"
+    },
+    "./service-worker": {
+      "types": "./dist/src/service-worker.d.ts",
+      "import": "./dist/src/service-worker.js"
+    },
+    "./window": {
+      "types": "./dist/src/window.d.ts",
+      "import": "./dist/src/window.js"
+    }
+  },
+  "eslintConfig": {
+    "extends": "peerbit",
+    "parserOptions": {
+      "project": true,
+      "sourceType": "module"
+    },
+    "ignorePatterns": [
+      "!.aegir.js",
+      "test/ts-use",
+      "*.d.ts"
+    ]
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dao-xyz/peerbit"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@dao-xyz/borsh": "^6.0.0",
+    "@libp2p/peer-id": "^6.0.1",
+    "@peerbit/canonical-transport": "0.0.0-e209d2e",
+    "@peerbit/crypto": "2.4.1-e209d2e",
+    "peerbit": "4.4.14-e209d2e"
+  },
+  "devDependencies": {
+    "@peerbit/canonical-client": "0.0.0-e209d2e"
+  },
+  "localMaintainers": [
+    "dao.xyz"
+  ],
+  "keywords": [
+    "peerbit",
+    "rpc",
+    "canonical",
+    "worker",
+    "sharedworker"
+  ],
+  "scripts": {
+    "clean": "aegir clean",
+    "build": "aegir build --no-bundle",
+    "test": "aegir test --target node",
+    "lint": "aegir lint"
+  }
+}

package/src/index.ts

@@ -0,0 +1,394 @@
+import { deserialize, serialize } from "@dao-xyz/borsh";
+import { peerIdFromString } from "@libp2p/peer-id";
+import {
+	CanonicalBootstrapRequest,
+	CanonicalConnection,
+	CanonicalControlRequest,
+	CanonicalControlResponse,
+	CanonicalLoadProgramRequest,
+	CanonicalSignRequest,
+	createMessagePortTransport as createControlTransport,
+} from "@peerbit/canonical-transport";
+import type {
+	CanonicalChannel,
+	CanonicalTransport,
+} from "@peerbit/canonical-transport";
+import { PreHash } from "@peerbit/crypto";
+import { type CreateInstanceOptions, Peerbit } from "peerbit";
+
+export type { CanonicalChannel };
+export {
+	createRpcTransport as createMessagePortTransport,
+	type CanonicalRpcTransport,
+} from "@peerbit/canonical-transport";
+
+export type CanonicalRuntimeOptions = {
+	directory?: string;
+	peerOptions?: CreateInstanceOptions;
+};
+
+export type CanonicalContext = {
+	peer: () => Promise<Peerbit>;
+	peerId: () => Promise<string>;
+	startPeer?: () => Promise<void>;
+	stopPeer?: () => Promise<void>;
+};
+
+export type CanonicalHostOptions = {
+	idleTimeoutMs?: number;
+	idleCheckIntervalMs?: number;
+};
+
+export type CanonicalModule = {
+	name: string;
+	open: (
+		ctx: CanonicalContext,
+		channel: CanonicalChannel,
+		payload: Uint8Array,
+	) => void | Promise<void>;
+};
+
+export class PeerbitCanonicalRuntime implements CanonicalContext {
+	private _peer?: Peerbit;
+
+	constructor(readonly options: CanonicalRuntimeOptions = {}) {}
+
+	async peer(): Promise<Peerbit> {
+		if (this._peer) return this._peer;
+		const peerOptions = this.options.peerOptions ?? {};
+		const directory = this.options.directory ?? peerOptions.directory;
+		this._peer = await Peerbit.create({ ...peerOptions, directory });
+		await this._peer.start();
+		return this._peer;
+	}
+
+	async startPeer(): Promise<void> {
+		const peer = await this.peer();
+		await peer.start();
+	}
+
+	async stopPeer(): Promise<void> {
+		if (!this._peer) return;
+		await this._peer.stop();
+		this._peer = undefined;
+	}
+
+	async peerId(): Promise<string> {
+		return (await this.peer()).peerId.toString();
+	}
+}
+
+const asUint8Array = (payload: any): Uint8Array => {
+	if (payload instanceof Uint8Array) return payload;
+	if (payload instanceof ArrayBuffer) return new Uint8Array(payload);
+	throw new Error("Expected Uint8Array payload");
+};
+
+export class CanonicalHost {
+	private readonly modules = new Map<string, CanonicalModule>();
+	private nextChannelId = 1;
+
+	constructor(
+		readonly ctx: CanonicalContext,
+		readonly options: CanonicalHostOptions = {},
+	) {}
+
+	registerModule(module: CanonicalModule): void {
+		this.modules.set(module.name, module);
+	}
+
+	registerModules(modules: CanonicalModule[]): void {
+		for (const m of modules) this.registerModule(m);
+	}
+
+	attachControlPort(port: MessagePort): () => void {
+		return this.attachControlTransport(createControlTransport(port));
+	}
+
+	attachControlTransport(transport: CanonicalTransport): () => void {
+		const connection = new CanonicalConnection(transport);
+		let lastSeen = Date.now();
+		const offActivity = connection.onActivity(() => {
+			lastSeen = Date.now();
+		});
+		const unsubscribe = connection.onControl((frame) => {
+			if (frame instanceof CanonicalControlRequest) {
+				void this.handleControlRequest(connection, frame);
+			}
+		});
+		let idleTimer: ReturnType<typeof setInterval> | undefined;
+		const idleTimeoutMs = this.options.idleTimeoutMs;
+		const idleIntervalMs =
+			this.options.idleCheckIntervalMs ??
+			Math.max(1000, Math.min(10_000, Math.floor((idleTimeoutMs ?? 0) / 2)));
+		let closed = false;
+
+		const close = () => {
+			if (closed) return;
+			closed = true;
+			offActivity();
+			unsubscribe();
+			if (idleTimer) clearInterval(idleTimer);
+			connection.close();
+		};
+
+		if (idleTimeoutMs && idleTimeoutMs > 0) {
+			idleTimer = setInterval(() => {
+				if (Date.now() - lastSeen > idleTimeoutMs) {
+					close();
+				}
+			}, idleIntervalMs);
+		}
+
+		return close;
+	}
+
+	private sendResponse(
+		connection: CanonicalConnection,
+		response: CanonicalControlResponse,
+	) {
+		connection.sendControl(response);
+	}
+
+	private async handleControlRequest(
+		connection: CanonicalConnection,
+		request: CanonicalControlRequest,
+	): Promise<void> {
+		const id = request.id;
+		try {
+			if (request.op === "peerId") {
+				const peerId = await this.ctx.peerId();
+				this.sendResponse(
+					connection,
+					new CanonicalControlResponse({ id, ok: true, peerId }),
+				);
+				return;
+			}
+
+			if (request.op === "peerInfo") {
+				const peer = await this.ctx.peer();
+				const peerId = await this.ctx.peerId();
+				const publicKey = peer.identity.publicKey.bytes;
+				const strings = peer.getMultiaddrs().map((x) => x.toString());
+				this.sendResponse(
+					connection,
+					new CanonicalControlResponse({
+						id,
+						ok: true,
+						peerId,
+						payload: publicKey,
+						strings,
+					}),
+				);
+				return;
+			}
+
+			if (request.op === "dial") {
+				const address = String(request.name ?? "");
+				if (!address) {
+					throw new Error("Canonical dial requires request.name to be set");
+				}
+				const peer = await this.ctx.peer();
+				await peer.dial(address);
+				this.sendResponse(
+					connection,
+					new CanonicalControlResponse({ id, ok: true }),
+				);
+				return;
+			}
+
+			if (request.op === "start") {
+				if (typeof (this.ctx as any).startPeer === "function") {
+					await (this.ctx as any).startPeer();
+				} else {
+					const peer = await this.ctx.peer();
+					await peer.start();
+				}
+				this.sendResponse(
+					connection,
+					new CanonicalControlResponse({ id, ok: true }),
+				);
+				return;
+			}
+
+			if (request.op === "stop") {
+				if (typeof (this.ctx as any).stopPeer === "function") {
+					await (this.ctx as any).stopPeer();
+				} else {
+					const peer = await this.ctx.peer();
+					await peer.stop();
+				}
+				this.sendResponse(
+					connection,
+					new CanonicalControlResponse({ id, ok: true }),
+				);
+				return;
+			}
+
+			if (request.op === "bootstrap") {
+				let addresses: string[] | undefined;
+				if (request.payload) {
+					const parsed = deserialize(
+						request.payload,
+						CanonicalBootstrapRequest,
+					) as CanonicalBootstrapRequest;
+					addresses = parsed.addresses?.length ? parsed.addresses : undefined;
+				}
+				const peer = await this.ctx.peer();
+				await peer.bootstrap(addresses);
+				this.sendResponse(
+					connection,
+					new CanonicalControlResponse({ id, ok: true }),
+				);
+				return;
+			}
+
+			if (request.op === "loadProgram") {
+				const address = String(request.name ?? "");
+				if (!address) {
+					throw new Error(
+						"Canonical loadProgram requires request.name to be set",
+					);
+				}
+				let timeoutMs: number | undefined;
+				if (request.payload) {
+					const parsed = deserialize(
+						request.payload,
+						CanonicalLoadProgramRequest,
+					) as CanonicalLoadProgramRequest;
+					timeoutMs = parsed.timeoutMs;
+				}
+
+				const peer = await this.ctx.peer();
+				const bytes = await peer.services.blocks.get(address, {
+					remote: { timeout: timeoutMs },
+				});
+				if (!bytes) {
+					this.sendResponse(
+						connection,
+						new CanonicalControlResponse({
+							id,
+							ok: false,
+							error: "Program not found",
+						}),
+					);
+					return;
+				}
+
+				this.sendResponse(
+					connection,
+					new CanonicalControlResponse({ id, ok: true, payload: bytes }),
+				);
+				return;
+			}
+
+			if (request.op === "hangUp") {
+				const address = String(request.name ?? "");
+				if (!address) {
+					throw new Error("Canonical hangUp requires request.name to be set");
+				}
+				const peer = await this.ctx.peer();
+				try {
+					await peer.hangUp(address);
+				} catch (e) {
+					try {
+						await peer.hangUp(peerIdFromString(address));
+					} catch {
+						throw e;
+					}
+				}
+				this.sendResponse(
+					connection,
+					new CanonicalControlResponse({ id, ok: true }),
+				);
+				return;
+			}
+
+			if (request.op === "sign") {
+				if (!request.payload) {
+					throw new Error("Canonical sign requires request.payload to be set");
+				}
+				const signRequest = deserialize(
+					request.payload,
+					CanonicalSignRequest,
+				) as CanonicalSignRequest;
+				const peer = await this.ctx.peer();
+				const prehash =
+					signRequest.prehash != null
+						? (signRequest.prehash as PreHash)
+						: PreHash.NONE;
+				const signature = await peer.identity.sign(signRequest.data, prehash);
+				this.sendResponse(
+					connection,
+					new CanonicalControlResponse({
+						id,
+						ok: true,
+						payload: serialize(signature),
+					}),
+				);
+				return;
+			}
+
+			if (request.op === "ping") {
+				this.sendResponse(
+					connection,
+					new CanonicalControlResponse({ id, ok: true }),
+				);
+				return;
+			}
+
+			if (request.op === "open") {
+				const name = String(request.name ?? "");
+				const mod = this.modules.get(name);
+				if (!mod) {
+					this.sendResponse(
+						connection,
+						new CanonicalControlResponse({
+							id,
+							ok: false,
+							error: `Unknown module '${name}'`,
+						}),
+					);
+					return;
+				}
+
+				const payload =
+					request.payload != null
+						? asUint8Array(request.payload)
+						: new Uint8Array();
+				const channelId = this.nextChannelId++;
+				const channel = connection.createChannel(channelId);
+				try {
+					await mod.open(this.ctx, channel, payload);
+				} catch (e: any) {
+					connection.releaseChannel(channelId);
+					throw e;
+				}
+
+				this.sendResponse(
+					connection,
+					new CanonicalControlResponse({ id, ok: true, channelId }),
+				);
+				return;
+			}
+
+			this.sendResponse(
+				connection,
+				new CanonicalControlResponse({
+					id,
+					ok: false,
+					error: `Unknown op '${String(request.op)}'`,
+				}),
+			);
+		} catch (e: any) {
+			this.sendResponse(
+				connection,
+				new CanonicalControlResponse({
+					id,
+					ok: false,
+					error: String(e?.message || e),
+				}),
+			);
+		}
+	}
+}