devframe 0.8.2 → 0.9.0-beta.10

package/dist/client/index.mjs

@@ -1,11 +1,9 @@
 import { t as hash } from "../hash-KtDZYXDN.mjs";
 import { colors } from "../utils/colors.mjs";
 import { createEventEmitter } from "../utils/events.mjs";
-import { t as createSharedState } from "../shared-state-6kHolYZy.mjs";
+import { t as createSharedState } from "../shared-state-fRRbRUtD.mjs";
 import { i as structuredCloneStringify, n as structuredCloneParse, t as structuredCloneDeserialize } from "../structured-clone-CgtQ61SA.mjs";
 import { createStreamReader, createStreamSink } from "../utils/streaming-channel.mjs";
-import { promiseWithResolver } from "../utils/promise.mjs";
-import { isQualifiedName, qualifyName } from "../utils/scope.mjs";
 import { defineDiagnostics } from "nostics";
 import { ansiFormatter } from "nostics/formatters/ansi";
 import { withBase, withProtocol } from "ufo";
@@ -18,6 +16,13 @@ const DEVFRAME_CONNECTION_META_FILENAME = "__connection.json";
 * connection from another JavaScript realm.
 */
 const DEVFRAME_CONNECTION_KEY = "__DEVFRAME_CONNECTION__";
+/**
+* Request header carrying the SSE session id on every RPC `POST`. The
+* server mints the id as the stream's first event (`event: session`);
+* the client echoes it here so the POST joins that stream's birpc
+* channel. Mirrors birpc's own SSE helpers for wire compatibility.
+*/
+const DEVFRAME_SSE_SESSION_HEADER = "x-birpc-session";
 const DEVFRAME_RPC_DUMP_MANIFEST_FILENAME = "__rpc-dump/index.json";
 /**
 * Page-URL **fragment** parameter carrying a one-time authentication code (OTP)
@@ -43,16 +48,74 @@ const DEVFRAME_VIEWER_ORIGIN_QUERY_PARAM = "devframe_viewer_origin";
 /** Token that authorizes an external viewer origin registration. */
 const DEVFRAME_VIEWER_ORIGIN_TOKEN_QUERY_PARAM = "devframe_viewer_origin_token";
 //#endregion
-//#region src/utils/diagnostics-reporter.ts
+//#region src/rpc/cache.ts
+/**
+* @experimental API is expected to change.
+*/
+var RpcCacheManager = class {
+	cacheMap = /* @__PURE__ */ new Map();
+	options;
+	keySerializer;
+	constructor(options) {
+		this.options = options;
+		this.keySerializer = options.keySerializer || ((args) => hash(args));
+	}
+	updateOptions(options) {
+		this.options = {
+			...this.options,
+			...options
+		};
+	}
+	cached(m, a) {
+		const methodCache = this.cacheMap.get(m);
+		if (methodCache) return methodCache.get(this.keySerializer(a));
+	}
+	has(m, a) {
+		return this.cacheMap.get(m)?.has(this.keySerializer(a)) ?? false;
+	}
+	apply(req, res) {
+		const methodCache = this.cacheMap.get(req.m) || /* @__PURE__ */ new Map();
+		methodCache.set(this.keySerializer(req.a), res);
+		this.cacheMap.set(req.m, methodCache);
+	}
+	validate(m) {
+		return this.options.functions.includes(m);
+	}
+	clear(fn) {
+		if (fn) this.cacheMap.delete(fn);
+		else this.cacheMap.clear();
+	}
+};
+//#endregion
+//#region src/utils/nostics.ts
 const formatAnsi = ansiFormatter(colors);
+/**
+* The reporter every {@link defineDiagnostics} call below wires in ahead of
+* any caller-supplied ones: prints the diagnostic through devframe's own
+* ANSI colors via `console[method]` (default `'warn'`).
+*/
 function devframeReporter(d, { method = "warn" } = {}) {
 	console[method](formatAnsi(d));
 }
+/**
+* Drop-in replacement for `nostics`'s `defineDiagnostics()` with devframe's
+* ANSI console reporter pre-wired ahead of any `reporters` passed in. Every
+* `diagnostics.ts` in devframe core, `@devframes/hub`, `@devframes/json-render`,
+* and the built-in plugins defines its codes through this instead of
+* `nostics`'s own `defineDiagnostics` — the reporter registration lives
+* here, once, so none of them need to build their own reporter (`colors`,
+* `ansiFormatter`) or take a direct dependency on `nostics` themselves.
+*/
+function defineDiagnostics$1(options) {
+	return defineDiagnostics({
+		...options,
+		reporters: [devframeReporter, ...options.reporters ?? []]
+	});
+}
 //#endregion
 //#region src/rpc/diagnostics.ts
-const diagnostics = defineDiagnostics({
+const diagnostics = defineDiagnostics$1({
 	docsBase: "https://devfra.me/errors",
-	reporters: [devframeReporter],
 	codes: {
 		DF0019: {
 			why: (p) => `RPC function "${p.name}" has \`agent\` set but \`jsonSerializable\` is not \`true\` — MCP requires JSON-serializable data.`,
@@ -87,26 +150,6 @@ const diagnostics = defineDiagnostics({
 	}
 });
 //#endregion
-//#region src/rpc/dump/error.ts
-/**
-* Inverse of {@link serializeDumpError}: rebuild a thrown `Error` from
-* the plain object stored in a dump record. Preserves `cause`, restores
-* the original `name`, and re-attaches any custom own properties.
-*/
-function reviveDumpError(stored) {
-	const cause = stored.cause instanceof Error ? stored.cause : isPlainErrorShape(stored.cause) ? reviveDumpError(stored.cause) : stored.cause;
-	const error = cause !== void 0 ? new Error(stored.message, { cause }) : new Error(stored.message);
-	error.name = stored.name;
-	for (const key of Object.keys(stored)) {
-		if (key === "name" || key === "message" || key === "cause") continue;
-		error[key] = stored[key];
-	}
-	return error;
-}
-function isPlainErrorShape(value) {
-	return typeof value === "object" && value !== null && typeof value.message === "string" && typeof value.name === "string";
-}
-//#endregion
 //#region src/rpc/validate-io.ts
 /**
 * Run a single [Standard Schema](https://standardschema.dev) validator,
@@ -215,45 +258,6 @@ async function getRpcHandler(definition, context) {
 	return validating;
 }
 //#endregion
-//#region src/rpc/cache.ts
-/**
-* @experimental API is expected to change.
-*/
-var RpcCacheManager = class {
-	cacheMap = /* @__PURE__ */ new Map();
-	options;
-	keySerializer;
-	constructor(options) {
-		this.options = options;
-		this.keySerializer = options.keySerializer || ((args) => hash(args));
-	}
-	updateOptions(options) {
-		this.options = {
-			...this.options,
-			...options
-		};
-	}
-	cached(m, a) {
-		const methodCache = this.cacheMap.get(m);
-		if (methodCache) return methodCache.get(this.keySerializer(a));
-	}
-	has(m, a) {
-		return this.cacheMap.get(m)?.has(this.keySerializer(a)) ?? false;
-	}
-	apply(req, res) {
-		const methodCache = this.cacheMap.get(req.m) || /* @__PURE__ */ new Map();
-		methodCache.set(this.keySerializer(req.a), res);
-		this.cacheMap.set(req.m, methodCache);
-	}
-	validate(m) {
-		return this.options.functions.includes(m);
-	}
-	clear(fn) {
-		if (fn) this.cacheMap.delete(fn);
-		else this.cacheMap.clear();
-	}
-};
-//#endregion
 //#region src/rpc/collector.ts
 var RpcFunctionsCollectorBase = class {
 	context;
@@ -706,112 +710,590 @@ function createRpcSharedStateClientHost(rpc) {
 	};
 }
 //#endregion
-//#region src/client/static-rpc.ts
-function isStaticEntry(value) {
-	return typeof value === "object" && value !== null && value.type === "static" && typeof value.path === "string";
-}
-function isQueryEntry(value) {
-	return typeof value === "object" && value !== null && value.type === "query" && typeof value.records === "object" && value.records !== null;
-}
-function isRecord(value) {
-	return typeof value === "object" && value !== null && ("output" in value || "error" in value);
-}
-function resolveRecordOutput(record) {
-	if (record.error) throw reviveDumpError(record.error);
-	return record.output;
-}
-function hasMeaningfulArgs(args) {
-	return args.some((arg) => arg !== null && arg !== void 0);
-}
-function unwrapEnvelope(raw) {
-	if (raw !== null && typeof raw === "object" && "serialization" in raw && "data" in raw) return raw.data;
-	return raw;
+//#region src/rpc/wire-codec.ts
+const EMPTY_WIRE_DEFS = /* @__PURE__ */ new Map();
+/**
+* Build the per-connection wire codec every live transport (WS server, WS
+* client, SSE server, SSE client) shares: per-method dispatch between strict
+* JSON (methods declared `jsonSerializable: true`) and `s:`-prefixed
+* structured-clone (everything else, including all error envelopes), with a
+* request-id → method map so a response independently picks the same
+* encoder as its request. One codec per connection — request-id spaces
+* don't collide across connections.
+*
+* @internal
+*/
+function createRpcWireCodec(definitions = EMPTY_WIRE_DEFS) {
+	const pendingRequestMethods = /* @__PURE__ */ new Map();
+	return {
+		serialize: (msg) => {
+			let method;
+			if (msg.t === "q") method = msg.m;
+			else {
+				method = pendingRequestMethods.get(msg.i);
+				pendingRequestMethods.delete(msg.i);
+			}
+			if (!(msg.t === "s" && "e" in msg) && !!method && definitions.get(method)?.jsonSerializable === true) return strictJsonStringify(msg, method ?? "");
+			return `s:${structuredCloneStringify(msg)}`;
+		},
+		deserialize: (raw) => {
+			const msg = raw.startsWith("s:") ? structuredCloneParse(raw.slice(2)) : JSON.parse(raw);
+			if (msg.t === "q" && msg.i && msg.m) pendingRequestMethods.set(msg.i, msg.m);
+			return msg;
+		}
+	};
 }
-function createStaticRpcCaller(manifest, fetchJson) {
-	const staticCache = /* @__PURE__ */ new Map();
-	const queryRecordCache = /* @__PURE__ */ new Map();
-	function reviveIfStructuredClone(value, serialization) {
-		if (serialization === "structured-clone" && Array.isArray(value)) return structuredCloneDeserialize(value);
-		return value;
-	}
-	function decode(raw, serialization) {
-		return reviveIfStructuredClone(unwrapEnvelope(raw), serialization);
-	}
-	async function loadStatic(entry) {
-		if (!staticCache.has(entry.path)) staticCache.set(entry.path, fetchJson(entry.path).then((raw) => decode(raw, entry.serialization)));
-		const data = await staticCache.get(entry.path);
-		if (isRecord(data)) return resolveRecordOutput(data);
-		return data;
+//#endregion
+//#region src/rpc/transports/sse-client.ts
+function NOOP$1() {}
+/**
+* Build a birpc `ChannelOptions` object backed by an SSE stream (server →
+* client) and HTTP `POST` (client → server) — the WebSocket-free counterpart
+* to `createWsRpcChannel`, wire-compatible with `attachSseRpcTransport`.
+*
+* The stream is consumed via `fetch` streaming (not `EventSource`), so it
+* works in browsers and server runtimes alike. The server's first frame
+* (`event: session`) carries the session id; every `POST` echoes it in the
+* `x-birpc-session` header. A response to a client-initiated request comes
+* back in the `POST`'s own body and is re-injected into the channel; a
+* dropped stream terminates the channel — there is no reconnect, matching
+* the WS channel's closed-is-done semantics.
+*/
+function createSseRpcChannel(options) {
+	const { onConnected = NOOP$1, onError = NOOP$1, onDisconnected = NOOP$1, definitions, fetch: fetchImpl = globalThis.fetch.bind(globalThis) } = options;
+	let url = options.url;
+	if (options.authToken) url = `${url}${url.includes("?") ? "&" : "?"}${DEVFRAME_AUTH_TOKEN_QUERY_PARAM}=${encodeURIComponent(options.authToken)}`;
+	const codec = createRpcWireCodec(definitions);
+	const abort = new AbortController();
+	let closed = false;
+	let onMessage;
+	let activeReader;
+	let resolveSession;
+	let rejectSession;
+	const sessionReady = new Promise((resolve, reject) => {
+		resolveSession = resolve;
+		rejectSession = reject;
+	});
+	sessionReady.catch(() => {});
+	function fail(error) {
+		if (closed) return;
+		closed = true;
+		rejectSession(error);
+		onError(error);
+		onDisconnected();
 	}
-	async function loadQueryRecord(path, serialization) {
-		if (!queryRecordCache.has(path)) queryRecordCache.set(path, fetchJson(path).then((raw) => decode(raw, serialization)));
-		return await queryRecordCache.get(path);
+	function end() {
+		if (closed) return;
+		closed = true;
+		rejectSession(/* @__PURE__ */ new Error("Devframe SSE stream closed"));
+		onDisconnected();
 	}
-	async function call(functionName, args) {
-		if (!(functionName in manifest)) throw new Error(`[devframe-rpc] Function "${functionName}" not found in dump store`);
-		const entry = manifest[functionName];
-		if (isStaticEntry(entry)) {
-			if (hasMeaningfulArgs(args)) throw new Error(`[devframe-rpc] No dump match for "${functionName}" with args: ${JSON.stringify(args)}`);
-			return await loadStatic(entry);
+	function dispatch(event, data) {
+		if (event === "session") {
+			resolveSession(data);
+			onConnected();
+			return;
 		}
-		if (isQueryEntry(entry)) {
-			const argsHash = hash(args);
-			const recordPath = entry.records[argsHash];
-			if (recordPath) return resolveRecordOutput(await loadQueryRecord(recordPath, entry.serialization));
-			if (entry.fallback) return resolveRecordOutput(await loadQueryRecord(entry.fallback, entry.serialization));
-			throw new Error(`[devframe-rpc] No dump match for "${functionName}" with args: ${JSON.stringify(args)}`);
+		onMessage?.(data);
+	}
+	/** Parse the SSE byte stream frame by frame and dispatch each event. */
+	async function consume(stream) {
+		const reader = stream.getReader();
+		activeReader = reader;
+		const decoder = new TextDecoder();
+		let buffer = "";
+		for (;;) {
+			const { done, value } = await reader.read();
+			if (done) break;
+			buffer += decoder.decode(value, { stream: true });
+			for (;;) {
+				const boundary = buffer.search(/\n\n|\r\n\r\n/);
+				if (boundary < 0) break;
+				const frame = buffer.slice(0, boundary);
+				buffer = buffer.slice(boundary + (buffer[boundary] === "\r" ? 4 : 2));
+				let event = "message";
+				const data = [];
+				for (const rawLine of frame.split(/\r?\n/)) {
+					if (rawLine.startsWith(":")) continue;
+					if (rawLine.startsWith("event:")) event = rawLine.slice(6).trimStart();
+					else if (rawLine.startsWith("data:")) data.push(rawLine.slice(5).replace(/^ /, ""));
+				}
+				if (data.length > 0) dispatch(event, data.join("\n"));
+			}
 		}
-		if (!hasMeaningfulArgs(args)) return entry;
-		throw new Error(`[devframe-rpc] No dump match for "${functionName}" with args: ${JSON.stringify(args)}`);
+		end();
 	}
+	(async () => {
+		try {
+			const response = await fetchImpl(url, {
+				headers: { accept: "text/event-stream" },
+				signal: abort.signal
+			});
+			if (!response.ok || !response.body) throw new Error(`Devframe SSE stream request failed: ${response.status}`);
+			await consume(response.body);
+		} catch (error) {
+			if (abort.signal.aborted) {
+				end();
+				return;
+			}
+			fail(error instanceof Error ? error : new Error(String(error)));
+		}
+	})();
 	return {
-		call: async (functionName, args) => await call(functionName, args),
-		callOptional: async (functionName, args) => {
-			if (!(functionName in manifest)) return void 0;
-			return await call(functionName, args);
+		close: () => {
+			closed = true;
+			abort.abort();
+			activeReader?.cancel().catch(() => {});
 		},
-		callEvent: async (_functionName, _args) => {}
+		on: (handler) => {
+			onMessage = handler;
+		},
+		post: async (data) => {
+			let sessionId;
+			try {
+				sessionId = await sessionReady;
+			} catch {
+				return;
+			}
+			if (closed) {
+				onError(/* @__PURE__ */ new Error("Devframe SSE channel is closed; message dropped"));
+				return;
+			}
+			try {
+				const response = await fetchImpl(url, {
+					method: "POST",
+					headers: {
+						"content-type": "text/plain; charset=utf-8",
+						[DEVFRAME_SSE_SESSION_HEADER]: sessionId
+					},
+					body: data
+				});
+				if (response.status === 200) {
+					const body = await response.text();
+					if (body) onMessage?.(body);
+					return;
+				}
+				if (!response.ok) throw new Error(`Devframe SSE POST failed: ${response.status}`);
+			} catch (error) {
+				onError(error instanceof Error ? error : new Error(String(error)));
+			}
+		},
+		serialize: codec.serialize,
+		deserialize: codec.deserialize
 	};
 }
 //#endregion
-//#region src/client/rpc-static.ts
-async function createStaticRpcClientMode(options) {
-	const staticCaller = createStaticRpcCaller(await options.fetchJsonFromBases(DEVFRAME_RPC_DUMP_MANIFEST_FILENAME), options.fetchJsonFromBases);
+//#region src/rpc/client.ts
+function createRpcClient(functions, options) {
+	const { channel, rpcOptions = {} } = options;
+	return createBirpc(functions, {
+		...channel,
+		timeout: -1,
+		...rpcOptions,
+		proxify: false
+	});
+}
+//#endregion
+//#region src/utils/promise.ts
+function promiseWithResolver() {
+	let resolve;
+	let reject;
 	return {
-		isTrusted: true,
-		status: "connected",
-		connectionError: null,
-		requestTrust: async () => true,
-		requestTrustWithToken: async () => true,
-		requestTrustWithCode: async () => null,
-		ensureTrusted: async () => true,
-		call: (...args) => staticCaller.call(args[0], args.slice(1)),
-		callEvent: (...args) => staticCaller.callEvent(args[0], args.slice(1)),
-		callOptional: (...args) => staticCaller.callOptional(args[0], args.slice(1))
+		promise: new Promise((_resolve, _reject) => {
+			resolve = _resolve;
+			reject = _reject;
+		}),
+		resolve,
+		reject
 	};
 }
 //#endregion
-//#region src/client/rpc-streaming.ts
-const STREAM_KEY_SEPARATOR = "";
-function streamKey(channel, id) {
-	return `${channel}${STREAM_KEY_SEPARATOR}${id}`;
-}
+//#region src/client/rpc-live.ts
 /**
-* Client-side streaming host. Mirrors `createRpcSharedStateClientHost`:
-* registers the two `:chunk` / `:end` event handlers once, then per-stream
-* state lives in a `Map<streamKey, StreamReader>`.
+* The transport-independent half of a live RPC client mode — connection
+* status, pending-call guarding, and the trust handshake — shared by the
+* WebSocket and SSE modes. Each transport supplies only its channel.
 */
-function createRpcStreamingClientHost(rpc) {
-	const readers = /* @__PURE__ */ new Map();
-	const uploads = /* @__PURE__ */ new Map();
-	rpc.client.register({
-		name: "devframe:streaming:chunk",
-		type: "event",
-		handler(channel, id, seq, chunk) {
-			readers.get(streamKey(channel, id))?._push(seq, chunk);
-		}
-	});
-	rpc.client.register({
+function createLiveRpcClientMode(options) {
+	const { transport, authToken, connectionMeta, events, clientRpc, rpcOptions = {}, callTimeout = 0 } = options;
+	let isTrusted = false;
+	let status = "connecting";
+	let connectionError = null;
+	const trustedPromise = promiseWithResolver();
+	function setStatus(next, error = null) {
+		if (error) connectionError = error;
+		else if (next === "connected") connectionError = null;
+		if (next === status) return;
+		const previous = status;
+		status = next;
+		events.emit("connection:status", next, previous);
+	}
+	const pending = /* @__PURE__ */ new Set();
+	function rejectAllPending(error) {
+		for (const entry of [...pending]) entry.reject(error);
+	}
+	function terminalError() {
+		if (status === "disconnected" || status === "error") return new DevframeConnectionError("connection", "[devframe] Not connected to the devframe server", { cause: connectionError ?? void 0 });
+		if (status === "unauthorized") return new DevframeConnectionError("auth", "[devframe] Not authorized by the devframe server", { cause: connectionError ?? void 0 });
+		return null;
+	}
+	/**
+	* Wrap an in-flight call promise so it settles on server response, on an
+	* optional wall-clock timeout, or when the connection drops — never hangs.
+	*/
+	function guardCall(promise, method) {
+		return new Promise((resolve, reject) => {
+			let settled = false;
+			let timer;
+			const entry = { reject(error) {
+				if (settled) return;
+				finish();
+				events.emit("rpc:error", error, method);
+				reject(error);
+			} };
+			function finish() {
+				settled = true;
+				pending.delete(entry);
+				if (timer) clearTimeout(timer);
+			}
+			pending.add(entry);
+			if (callTimeout > 0) timer = setTimeout(() => {
+				entry.reject(new DevframeConnectionError("timeout", `[devframe] RPC call "${method}" timed out after ${callTimeout}ms`));
+			}, callTimeout);
+			promise.then((value) => {
+				if (settled) return;
+				finish();
+				resolve(value);
+			}, (error) => {
+				if (settled) return;
+				finish();
+				const err = error instanceof Error ? error : new Error(String(error));
+				events.emit("rpc:error", err, method);
+				reject(err);
+			});
+		});
+	}
+	const definitions = /* @__PURE__ */ new Map();
+	for (const name of connectionMeta.jsonSerializableMethods ?? []) definitions.set(name, { jsonSerializable: true });
+	const channel = options.createChannel({
+		definitions,
+		onError(error) {
+			setStatus("error", error);
+			events.emit("connection:error", error);
+			rejectAllPending(new DevframeConnectionError("connection", "[devframe] Connection to the devframe server failed", { cause: error }));
+		},
+		onDisconnected() {
+			if (status !== "error") setStatus("disconnected");
+			rejectAllPending(new DevframeConnectionError("connection", "[devframe] Disconnected from the devframe server", { cause: connectionError ?? void 0 }));
+		}
+	});
+	const serverRpc = createRpcClient(clientRpc.functions, {
+		channel,
+		rpcOptions
+	});
+	clientRpc.register({
+		name: "devframe:auth:revoked",
+		type: "event",
+		handler: () => {
+			isTrusted = false;
+			const authError = new DevframeConnectionError("auth", "[devframe] The devframe server revoked this client's trust");
+			setStatus("unauthorized", authError);
+			events.emit("connection:error", authError);
+			rejectAllPending(authError);
+			events.emit("rpc:is-trusted:updated", false);
+		}
+	});
+	let currentAuthToken = authToken;
+	async function requestTrustWithToken(token) {
+		currentAuthToken = token;
+		const result = await serverRpc.$call("anonymous:devframe:auth", {
+			authToken: token,
+			ua: navigator.userAgent,
+			origin: location.origin
+		});
+		isTrusted = result.isTrusted;
+		if (isTrusted) {
+			trustedPromise.resolve(true);
+			setStatus("connected");
+		} else {
+			const authError = new DevframeConnectionError("auth", "[devframe] The devframe server refused this client's credentials");
+			setStatus("unauthorized", authError);
+			events.emit("connection:error", authError);
+		}
+		events.emit("rpc:is-trusted:updated", isTrusted);
+		return result.isTrusted;
+	}
+	async function requestTrustWithCode(code) {
+		const token = (await serverRpc.$call("anonymous:devframe:auth:exchange", {
+			code,
+			ua: navigator.userAgent,
+			origin: location.origin
+		}))?.authToken ?? null;
+		if (token) {
+			currentAuthToken = token;
+			isTrusted = true;
+			trustedPromise.resolve(true);
+			setStatus("connected");
+			events.emit("rpc:is-trusted:updated", true);
+		}
+		return token;
+	}
+	async function requestTrust() {
+		if (isTrusted) return true;
+		return requestTrustWithToken(currentAuthToken ?? "");
+	}
+	async function ensureTrusted(timeout = 6e4) {
+		if (isTrusted) trustedPromise.resolve(true);
+		if (timeout <= 0) return trustedPromise.promise;
+		let clear = () => {};
+		await Promise.race([trustedPromise.promise.then(clear), new Promise((resolve, reject) => {
+			const id = setTimeout(() => {
+				reject(/* @__PURE__ */ new Error("[devframe] Timeout waiting for rpc to be trusted"));
+			}, timeout);
+			clear = () => clearTimeout(id);
+		})]);
+		return isTrusted;
+	}
+	return {
+		transport,
+		get isTrusted() {
+			return isTrusted;
+		},
+		get status() {
+			return status;
+		},
+		get connectionError() {
+			return connectionError;
+		},
+		requestTrust,
+		requestTrustWithToken,
+		requestTrustWithCode,
+		ensureTrusted,
+		call: (...args) => {
+			const method = String(args[0]);
+			const failFast = terminalError();
+			if (failFast) {
+				events.emit("rpc:error", failFast, method);
+				return Promise.reject(failFast);
+			}
+			return guardCall(serverRpc.$call(...args), method);
+		},
+		callEvent: (...args) => {
+			const failFast = terminalError();
+			if (failFast) {
+				events.emit("rpc:error", failFast, String(args[0]));
+				return;
+			}
+			return serverRpc.$callEvent(...args);
+		},
+		callOptional: (...args) => {
+			const method = String(args[0]);
+			const failFast = terminalError();
+			if (failFast) {
+				events.emit("rpc:error", failFast, method);
+				return Promise.reject(failFast);
+			}
+			return guardCall(serverRpc.$callOptional(...args), method);
+		},
+		close: () => {
+			channel.close();
+		}
+	};
+}
+//#endregion
+//#region src/client/rpc-sse.ts
+/**
+* Resolve a {@link ConnectionMeta.sse} descriptor into a concrete
+* `http(s)://` URL, with the same proxy-safe rules as `resolveWsUrl`: the
+* object / relative-path forms resolve against where `__connection.json`
+* was loaded (the client trusts its own location, never a server-baked
+* hostname), while an explicit `port`/`host` (or a full `http(s)://` URL
+* string) opts into a cross-origin endpoint.
+*/
+function resolveSseUrl(sse, metaBaseUrl, loc) {
+	const base = (() => {
+		try {
+			return new URL(metaBaseUrl, loc.href);
+		} catch {
+			return new URL(loc.href);
+		}
+	})();
+	if (sse && typeof sse === "object") {
+		if (sse.host != null || sse.port != null) {
+			const host = sse.host ?? `${base.hostname}:${sse.port}`;
+			return new URL(sse.path ?? "/", `${base.protocol}//${host}`).href;
+		}
+		return new URL(sse.path ?? "", base).href;
+	}
+	const str = sse ?? "";
+	if (/^https?:\/\//i.test(str)) return str;
+	return new URL(str, base).href;
+}
+/**
+* The SSE-backed live client mode — picked by `connectDevframe` when the
+* server advertises SSE as its primary transport (`backend: 'sse'`) or when
+* the caller pins `transport: 'sse'`. Same status machine, call guarding,
+* and trust handshake as the WebSocket mode, over `createSseRpcChannel`.
+*/
+function createSseRpcClientMode(options) {
+	const { authToken, connectionMeta, metaBaseUrl, events, clientRpc, rpcOptions = {}, sseOptions = {}, callTimeout = 0 } = options;
+	const url = resolveSseUrl(connectionMeta.sse, metaBaseUrl ?? "./", location);
+	return createLiveRpcClientMode({
+		transport: "sse",
+		authToken,
+		connectionMeta,
+		events,
+		clientRpc,
+		rpcOptions,
+		callTimeout,
+		createChannel: (handlers) => createSseRpcChannel({
+			url,
+			authToken,
+			definitions: handlers.definitions,
+			...sseOptions,
+			onConnected() {
+				sseOptions.onConnected?.();
+			},
+			onError(error) {
+				handlers.onError(error);
+				sseOptions.onError?.(error);
+			},
+			onDisconnected() {
+				handlers.onDisconnected();
+				sseOptions.onDisconnected?.();
+			}
+		})
+	});
+}
+//#endregion
+//#region src/rpc/dump/error.ts
+/**
+* Inverse of {@link serializeDumpError}: rebuild a thrown `Error` from
+* the plain object stored in a dump record. Preserves `cause`, restores
+* the original `name`, and re-attaches any custom own properties.
+*/
+function reviveDumpError(stored) {
+	const cause = stored.cause instanceof Error ? stored.cause : isPlainErrorShape(stored.cause) ? reviveDumpError(stored.cause) : stored.cause;
+	const error = cause !== void 0 ? new Error(stored.message, { cause }) : new Error(stored.message);
+	error.name = stored.name;
+	for (const key of Object.keys(stored)) {
+		if (key === "name" || key === "message" || key === "cause") continue;
+		error[key] = stored[key];
+	}
+	return error;
+}
+function isPlainErrorShape(value) {
+	return typeof value === "object" && value !== null && typeof value.message === "string" && typeof value.name === "string";
+}
+//#endregion
+//#region src/client/static-rpc.ts
+function isStaticEntry(value) {
+	return typeof value === "object" && value !== null && value.type === "static" && typeof value.path === "string";
+}
+function isQueryEntry(value) {
+	return typeof value === "object" && value !== null && value.type === "query" && typeof value.records === "object" && value.records !== null;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && ("output" in value || "error" in value);
+}
+function resolveRecordOutput(record) {
+	if (record.error) throw reviveDumpError(record.error);
+	return record.output;
+}
+function hasMeaningfulArgs(args) {
+	return args.some((arg) => arg !== null && arg !== void 0);
+}
+function unwrapEnvelope(raw) {
+	if (raw !== null && typeof raw === "object" && "serialization" in raw && "data" in raw) return raw.data;
+	return raw;
+}
+function createStaticRpcCaller(manifest, fetchJson) {
+	const staticCache = /* @__PURE__ */ new Map();
+	const queryRecordCache = /* @__PURE__ */ new Map();
+	function reviveIfStructuredClone(value, serialization) {
+		if (serialization === "structured-clone" && Array.isArray(value)) return structuredCloneDeserialize(value);
+		return value;
+	}
+	function decode(raw, serialization) {
+		return reviveIfStructuredClone(unwrapEnvelope(raw), serialization);
+	}
+	async function loadStatic(entry) {
+		if (!staticCache.has(entry.path)) staticCache.set(entry.path, fetchJson(entry.path).then((raw) => decode(raw, entry.serialization)));
+		const data = await staticCache.get(entry.path);
+		if (isRecord(data)) return resolveRecordOutput(data);
+		return data;
+	}
+	async function loadQueryRecord(path, serialization) {
+		if (!queryRecordCache.has(path)) queryRecordCache.set(path, fetchJson(path).then((raw) => decode(raw, serialization)));
+		return await queryRecordCache.get(path);
+	}
+	async function call(functionName, args) {
+		if (!(functionName in manifest)) throw new Error(`[devframe-rpc] Function "${functionName}" not found in dump store`);
+		const entry = manifest[functionName];
+		if (isStaticEntry(entry)) {
+			if (hasMeaningfulArgs(args)) throw new Error(`[devframe-rpc] No dump match for "${functionName}" with args: ${JSON.stringify(args)}`);
+			return await loadStatic(entry);
+		}
+		if (isQueryEntry(entry)) {
+			const argsHash = hash(args);
+			const recordPath = entry.records[argsHash];
+			if (recordPath) return resolveRecordOutput(await loadQueryRecord(recordPath, entry.serialization));
+			if (entry.fallback) return resolveRecordOutput(await loadQueryRecord(entry.fallback, entry.serialization));
+			throw new Error(`[devframe-rpc] No dump match for "${functionName}" with args: ${JSON.stringify(args)}`);
+		}
+		if (!hasMeaningfulArgs(args)) return entry;
+		throw new Error(`[devframe-rpc] No dump match for "${functionName}" with args: ${JSON.stringify(args)}`);
+	}
+	return {
+		call: async (functionName, args) => await call(functionName, args),
+		callOptional: async (functionName, args) => {
+			if (!(functionName in manifest)) return void 0;
+			return await call(functionName, args);
+		},
+		callEvent: async (_functionName, _args) => {}
+	};
+}
+//#endregion
+//#region src/client/rpc-static.ts
+async function createStaticRpcClientMode(options) {
+	const staticCaller = createStaticRpcCaller(await options.fetchJsonFromBases(DEVFRAME_RPC_DUMP_MANIFEST_FILENAME), options.fetchJsonFromBases);
+	return {
+		transport: "static",
+		isTrusted: true,
+		status: "connected",
+		connectionError: null,
+		requestTrust: async () => true,
+		requestTrustWithToken: async () => true,
+		requestTrustWithCode: async () => null,
+		ensureTrusted: async () => true,
+		call: (...args) => staticCaller.call(args[0], args.slice(1)),
+		callEvent: (...args) => staticCaller.callEvent(args[0], args.slice(1)),
+		callOptional: (...args) => staticCaller.callOptional(args[0], args.slice(1)),
+		close: () => {}
+	};
+}
+//#endregion
+//#region src/client/rpc-streaming.ts
+const STREAM_KEY_SEPARATOR = "";
+function streamKey(channel, id) {
+	return `${channel}${STREAM_KEY_SEPARATOR}${id}`;
+}
+/**
+* Client-side streaming host. Mirrors `createRpcSharedStateClientHost`:
+* registers the two `:chunk` / `:end` event handlers once, then per-stream
+* state lives in a `Map<streamKey, StreamReader>`.
+*/
+function createRpcStreamingClientHost(rpc) {
+	const readers = /* @__PURE__ */ new Map();
+	const uploads = /* @__PURE__ */ new Map();
+	rpc.client.register({
+		name: "devframe:streaming:chunk",
+		type: "event",
+		handler(channel, id, seq, chunk) {
+			readers.get(streamKey(channel, id))?._push(seq, chunk);
+		}
+	});
+	rpc.client.register({
 		name: "devframe:streaming:end",
 		type: "event",
 		handler(channel, id, error) {
@@ -881,26 +1363,15 @@ function createRpcStreamingClientHost(rpc) {
 		});
 		sink.events.on("end", (error) => {
 			rpc.callEvent("devframe:streaming:upload-end", channel, id, error);
-			uploads.delete(key);
-		});
-		uploads.set(key, sink);
-		return sink;
-	}
-	return {
-		subscribe,
-		upload
-	};
-}
-//#endregion
-//#region src/rpc/client.ts
-function createRpcClient(functions, options) {
-	const { channel, rpcOptions = {} } = options;
-	return createBirpc(functions, {
-		...channel,
-		timeout: -1,
-		...rpcOptions,
-		proxify: false
-	});
+			uploads.delete(key);
+		});
+		uploads.set(key, sink);
+		return sink;
+	}
+	return {
+		subscribe,
+		upload
+	};
 }
 //#endregion
 //#region src/rpc/transports/ws-client.ts
@@ -909,6 +1380,9 @@ const EMPTY_DEFS = /* @__PURE__ */ new Map();
 /**
 * Build a birpc `ChannelOptions` object backed by a browser `WebSocket`.
 * Pass the result straight to `createRpcClient`'s `channel` option.
+*
+* Also returns `close()`, closing the underlying socket — mirroring the server transport's
+* existing `WsRpcTransport.close()`. `birpc`'s own `ChannelOptions` has no teardown of its own.
 */
 function createWsRpcChannel(options) {
 	let url = options.url;
@@ -925,8 +1399,11 @@ function createWsRpcChannel(options) {
 	ws.addEventListener("close", (e) => {
 		onDisconnected(e);
 	});
-	const pendingRequestMethods = /* @__PURE__ */ new Map();
+	const codec = createRpcWireCodec(definitions);
 	return {
+		close: () => {
+			ws.close();
+		},
 		on: (handler) => {
 			ws.addEventListener("message", (e) => {
 				handler(e.data);
@@ -953,1183 +1430,8 @@ function createWsRpcChannel(options) {
 			}
 			onError(/* @__PURE__ */ new Error("Devframe WebSocket is not open; message dropped"));
 		},
-		serialize: (msg) => {
-			let method;
-			if (msg.t === "q") method = msg.m;
-			else {
-				method = pendingRequestMethods.get(msg.i);
-				pendingRequestMethods.delete(msg.i);
-			}
-			if (!(msg.t === "s" && "e" in msg) && !!method && definitions.get(method)?.jsonSerializable === true) return strictJsonStringify(msg, method ?? "");
-			return `s:${structuredCloneStringify(msg)}`;
-		},
-		deserialize: (raw) => {
-			const msg = raw.startsWith("s:") ? structuredCloneParse(raw.slice(2)) : JSON.parse(raw);
-			if (msg.t === "q" && msg.i && msg.m) pendingRequestMethods.set(msg.i, msg.m);
-			return msg;
-		}
-	};
-}
-//#endregion
-//#region ../../node_modules/.pnpm/ua-parser-modern@0.1.1/node_modules/ua-parser-modern/dist/index.mjs
-const EMPTY = "";
-const UNKNOWN = "?";
-const MAJOR = "major";
-const MODEL = "model";
-const NAME = "name";
-const TYPE = "type";
-const VENDOR = "vendor";
-const VERSION = "version";
-const ARCHITECTURE = "architecture";
-const CONSOLE = "console";
-const MOBILE = "mobile";
-const TABLET = "tablet";
-const SMARTTV = "smarttv";
-const WEARABLE = "wearable";
-const EMBEDDED = "embedded";
-const UA_MAX_LENGTH = 500;
-const AMAZON = "Amazon";
-const APPLE = "Apple";
-const ASUS = "ASUS";
-const BLACKBERRY = "BlackBerry";
-const BROWSER_LABEL = "Browser";
-const CHROME = "Chrome";
-const EDGE = "Edge";
-const FIREFOX = "Firefox";
-const GOOGLE = "Google";
-const HUAWEI = "Huawei";
-const LG = "LG";
-const MICROSOFT = "Microsoft";
-const MOTOROLA = "Motorola";
-const OPERA = "Opera";
-const SAMSUNG = "Samsung";
-const SHARP = "Sharp";
-const SONY = "Sony";
-const XIAOMI = "Xiaomi";
-const ZEBRA = "Zebra";
-const FACEBOOK = "Facebook";
-const CHROMIUM_OS = "Chromium OS";
-const MAC_OS = "Mac OS";
-function extend(regexes, extensions = {}) {
-	const mergedRegexes = {};
-	for (const key of Object.keys(regexes)) {
-		const extension = extensions[key];
-		if (extension && extension.length % 2 === 0) mergedRegexes[key] = [...extension, ...regexes[key]];
-		else mergedRegexes[key] = regexes[key];
-	}
-	return mergedRegexes;
-}
-function enumerize(arr) {
-	const enums = {};
-	for (let i = 0; i < arr.length; i++) enums[arr[i].toUpperCase()] = arr[i];
-	return enums;
-}
-function lowerize(str) {
-	return str.toLowerCase();
-}
-function has(str1, str2) {
-	return typeof str1 === "string" ? lowerize(str2).includes(lowerize(str1)) : false;
-}
-function majorize(version) {
-	return typeof version === "string" ? version.replace(/[^\d.]/g, EMPTY).split(".")[0] : void 0;
-}
-function trim(str, len) {
-	const result = str.replace(/^\s+/, EMPTY);
-	return typeof len === "undefined" ? result : result.substring(0, len);
-}
-function rgxMapper(ua, arrays, augment) {
-	const result = augment ?? {};
-	for (let i = 0; i < arrays.length; i += 2) {
-		const regex = arrays[i];
-		const props = arrays[i + 1];
-		for (let j = 0; j < regex.length; j++) {
-			const matcher = regex[j];
-			if (!matcher) break;
-			const matches = matcher.exec(ua);
-			if (!matches) continue;
-			for (let p = 0; p < props.length; p++) {
-				const match = matches[p + 1];
-				const q = props[p];
-				if (Array.isArray(q)) {
-					const key = q[0];
-					const length = q.length;
-					if (length === 2) {
-						const value = q[1];
-						if (typeof value === "function") result[key] = value(match, void 0, result);
-						else result[key] = value;
-					} else if (length === 3) {
-						const arg1 = q[1];
-						const arg2 = q[2];
-						if (typeof arg1 === "function" && !("exec" in arg1) && !("test" in arg1)) result[key] = match ? arg1(match, arg2, result) : void 0;
-						else result[key] = match ? match.replace(arg1, arg2) : void 0;
-					} else if (length === 4) result[key] = match ? q[3](match.replace(q[1], q[2]), void 0, result) : void 0;
-				} else result[q] = match || void 0;
-			}
-			return result;
-		}
-	}
-	return result;
-}
-function strMapper(str, map) {
-	for (const i in map) {
-		const value = map[i];
-		if (Array.isArray(value) && value.length > 0) {
-			for (let j = 0; j < value.length; j++) if (has(value[j], str)) return i === UNKNOWN ? void 0 : i;
-		} else if (has(value, str)) return i === UNKNOWN ? void 0 : i;
-	}
-	return str;
-}
-const oldSafariMap = {
-	"1.0": "/8",
-	"1.2": "/1",
-	"1.3": "/3",
-	"2.0": "/412",
-	"2.0.2": "/416",
-	"2.0.3": "/417",
-	"2.0.4": "/419",
-	"?": "/"
-};
-const windowsVersionMap = {
-	"ME": "4.90",
-	"NT 3.11": "NT3.51",
-	"NT 4.0": "NT4.0",
-	"2000": "NT 5.0",
-	"XP": ["NT 5.1", "NT 5.2"],
-	"Vista": "NT 6.0",
-	"7": "NT 6.1",
-	"8": "NT 6.2",
-	"8.1": "NT 6.3",
-	"10": ["NT 6.4", "NT 10.0"],
-	"RT": "ARM"
-};
-const regexes = {
-	browser: [
-		[/\b(?:crmo|crios)\/([\w.]+)/i],
-		[VERSION, [NAME, "Chrome"]],
-		[/edg(?:e|ios|a)?\/([\w.]+)/i],
-		[VERSION, [NAME, "Edge"]],
-		[
-			/(opera mini)\/([-\w.]+)/i,
-			/(opera [mobileta]{3,6})\b.+version\/([-\w.]+)/i,
-			/(opera)(?:.+version\/|[/ ]+)([\w.]+)/i
-		],
-		[NAME, VERSION],
-		[/opios[/ ]+([\w.]+)/i],
-		[VERSION, [NAME, `${OPERA} Mini`]],
-		[/\bop(?:rg)?x\/([\w.]+)/i],
-		[VERSION, [NAME, `${OPERA} GX`]],
-		[/\bopr\/([\w.]+)/i],
-		[VERSION, [NAME, OPERA]],
-		[/\bb[ai]*d(?:uhd|[ub]*[aekoprswx]{5,6})[/ ]?([\w.]+)/i],
-		[VERSION, [NAME, "Baidu"]],
-		[
-			/(kindle)\/([\w.]+)/i,
-			/(lunascape|maxthon|netfront|jasmine|blazer)[/ ]?([\w.]*)/i,
-			/(avant|iemobile|slim)\s?(?:browser)?[/ ]?([\w.]*)/i,
-			/(?:ms|\()(ie) ([\w.]+)/i,
-			/(flock|rockmelt|midori|epiphany|silk|skyfire|bolt|iron|vivaldi|iridium|phantomjs|bowser|quark|qupzilla|falkon|rekonq|puffin|brave|whale(?!.+naver)|qqbrowserlite|qq|duckduckgo)\/([-\w.]+)/i,
-			/(heytap|ovi)browser\/([\d.]+)/i,
-			/(weibo)__([\d.]+)/i
-		],
-		[NAME, VERSION],
-		[/\bddg\/([\w.]+)/i],
-		[VERSION, [NAME, "DuckDuckGo"]],
-		[/(?:\buc? ?browser|juc.+ucweb)[/ ]?([\w.]+)/i],
-		[VERSION, [NAME, `UC${BROWSER_LABEL}`]],
-		[
-			/microm.+\bqbcore\/([\w.]+)/i,
-			/\bqbcore\/([\w.]+).+microm/i,
-			/micromessenger\/([\w.]+)/i
-		],
-		[VERSION, [NAME, "WeChat"]],
-		[/konqueror\/([\w.]+)/i],
-		[VERSION, [NAME, "Konqueror"]],
-		[/trident.+rv[: ]([\w.]{1,9})\b.+like gecko/i],
-		[VERSION, [NAME, "IE"]],
-		[/ya(?:search)?browser\/([\w.]+)/i],
-		[VERSION, [NAME, "Yandex"]],
-		[/slbrowser\/([\w.]+)/i],
-		[VERSION, [NAME, `Smart Lenovo ${BROWSER_LABEL}`]],
-		[/(avast|avg)\/([\w.]+)/i],
-		[[
-			NAME,
-			/(.+)/,
-			`$1 Secure ${BROWSER_LABEL}`
-		], VERSION],
-		[/\bfocus\/([\w.]+)/i],
-		[VERSION, [NAME, `${FIREFOX} Focus`]],
-		[/\bopt\/([\w.]+)/i],
-		[VERSION, [NAME, `${OPERA} Touch`]],
-		[/coc_coc\w+\/([\w.]+)/i],
-		[VERSION, [NAME, "Coc Coc"]],
-		[/dolfin\/([\w.]+)/i],
-		[VERSION, [NAME, "Dolphin"]],
-		[/coast\/([\w.]+)/i],
-		[VERSION, [NAME, `${OPERA} Coast`]],
-		[/miuibrowser\/([\w.]+)/i],
-		[VERSION, [NAME, `MIUI ${BROWSER_LABEL}`]],
-		[/fxios\/([-\w.]+)/i],
-		[VERSION, [NAME, FIREFOX]],
-		[/\bqihu|(qi?ho{0,2}|360)browser/i],
-		[[NAME, `360 ${BROWSER_LABEL}`]],
-		[/(oculus|sailfish|huawei|vivo)browser\/([\w.]+)/i],
-		[[
-			NAME,
-			/(.+)/,
-			`$1 ${BROWSER_LABEL}`
-		], VERSION],
-		[/samsungbrowser\/([\w.]+)/i],
-		[VERSION, [NAME, `${SAMSUNG} Internet`]],
-		[/(comodo_dragon)\/([\w.]+)/i],
-		[[
-			NAME,
-			/_/g,
-			" "
-		], VERSION],
-		[/metasr[/ ]?([\d.]+)/i],
-		[VERSION, [NAME, "Sogou Explorer"]],
-		[/(sogou)mo\w+\/([\d.]+)/i],
-		[[NAME, "Sogou Mobile"], VERSION],
-		[
-			/(electron)\/([\w.]+) safari/i,
-			/(tesla)(?: qtcarbrowser|\/(20\d\d\.[-\w.]+))/i,
-			/m?(qqbrowser|2345Explorer)[/ ]?([\w.]+)/i
-		],
-		[NAME, VERSION],
-		[/(lbbrowser)/i, /\[(linkedin)app\]/i],
-		[NAME],
-		[/((?:fban\/fbios|fb_iab\/fb4a)(?!.+fbav)|;fbav\/([\w.]+);)/i],
-		[[NAME, FACEBOOK], VERSION],
-		[
-			/(Klarna)\/([\w.]+)/i,
-			/(kakao(?:talk|story))[/ ]([\w.]+)/i,
-			/(naver)\(.*?(\d+\.[\w.]+).*\)/i,
-			/safari (line)\/([\w.]+)/i,
-			/\b(line)\/([\w.]+)\/iab/i,
-			/(alipay)client\/([\w.]+)/i,
-			/(twitter)(?:and| f.+e\/([\w.]+))/i,
-			/(chromium|instagram|snapchat)[/ ]([-\w.]+)/i
-		],
-		[NAME, VERSION],
-		[/\bgsa\/([\w.]+) .*safari\//i],
-		[VERSION, [NAME, "GSA"]],
-		[/musical_ly(?:.+app_?version\/|_)([\w.]+)/i],
-		[VERSION, [NAME, "TikTok"]],
-		[/headlesschrome(?:\/([\w.]+)| )/i],
-		[VERSION, [NAME, `${CHROME} Headless`]],
-		[/ wv\).+(chrome)\/([\w.]+)/i],
-		[[NAME, `${CHROME} WebView`], VERSION],
-		[/droid.+ version\/([\w.]+)\b.+(?:mobile safari|safari)/i],
-		[VERSION, [NAME, `Android ${BROWSER_LABEL}`]],
-		[/(chrome|omniweb|arora|[tizenoka]{5} ?browser)\/v?([\w.]+)/i],
-		[NAME, VERSION],
-		[/version\/([\w.,]+) .*mobile\/\w+ (safari)/i],
-		[VERSION, [NAME, "Mobile Safari"]],
-		[/version\/([\w(.|,)]+) .*(mobile ?safari|safari)/i],
-		[VERSION, NAME],
-		[/webkit.+?(mobile ?safari|safari)(\/[\w.]+)/i],
-		[NAME, [
-			VERSION,
-			strMapper,
-			oldSafariMap
-		]],
-		[/(webkit|khtml)\/([\w.]+)/i],
-		[NAME, VERSION],
-		[/(navigator|netscape\d?)\/([-\w.]+)/i],
-		[[NAME, "Netscape"], VERSION],
-		[/mobile vr; rv:([\w.]+)\).+firefox/i],
-		[VERSION, [NAME, `${FIREFOX} Reality`]],
-		[
-			/ekiohf.+(flow)\/([\w.]+)/i,
-			/(swiftfox)/i,
-			/(icedragon|iceweasel|camino|chimera|fennec|maemo browser|minimo|conkeror|klar)[/ ]?([\w.+]+)/i,
-			/(seamonkey|k-meleon|icecat|iceape|firebird|phoenix|palemoon|basilisk|waterfox)\/([-\w.]+)$/i,
-			/(firefox)\/([\w.]+)/i,
-			/(mozilla)\/([\w.]+) .+rv:.+gecko\/\d+/i,
-			/(polaris|lynx|dillo|icab|doris|amaya|w3m|netsurf|sleipnir|obigo|mosaic|(?:go|ice|up)[. ]?browser)[-/ ]?v?([\w.]+)/i,
-			/(links) \(([\w.]+)/i,
-			/panasonic;(viera)/i
-		],
-		[NAME, VERSION],
-		[/(cobalt)\/([\w.]+)/i],
-		[NAME, [
-			VERSION,
-			/master.|lts./,
-			""
-		]]
-	],
-	cpu: [
-		[/(amd|x(?:(?:86|64)[-_])?|wow|win)64[;)]/i],
-		[[ARCHITECTURE, "amd64"]],
-		[/(ia32(?=;))/i],
-		[[ARCHITECTURE, lowerize]],
-		[/((?:i[346]|x)86)[;)]/i],
-		[[ARCHITECTURE, "ia32"]],
-		[/\b(aarch64|arm(v?8e?l?|_?64))\b/i],
-		[[ARCHITECTURE, "arm64"]],
-		[/\b(arm(?:v[67])?ht?n?[fl]p?)\b/i],
-		[[ARCHITECTURE, "armhf"]],
-		[/windows (ce|mobile); ppc;/i],
-		[[ARCHITECTURE, "arm"]],
-		[/((?:ppc|powerpc)(?:64)?)(?: mac|;|\))/i],
-		[[
-			ARCHITECTURE,
-			/ower/,
-			EMPTY,
-			lowerize
-		]],
-		[/(sun4\w)[;)]/i],
-		[[ARCHITECTURE, "sparc"]],
-		[/(avr32|ia64(?=;)|68k(?=\))|\barm(?=v(?:[1-7]|[5-7]1)l?|;|eabi)|(?=atmel )avr|(?:irix|mips|sparc)(?:64)?\b|pa-risc)/i],
-		[[ARCHITECTURE, lowerize]]
-	],
-	device: [
-		[/\b(sch-i[89]0\d|shw-m380s|sm-[ptx]\w{2,4}|gt-[pn]\d{2,4}|sgh-t8[56]9|nexus 10)/i],
-		[
-			MODEL,
-			[VENDOR, SAMSUNG],
-			[TYPE, TABLET]
-		],
-		[
-			/\b((?:s[cgp]h|gt|sm)-\w+|sc[g-]?\d+a?|galaxy nexus)/i,
-			/samsung[- ]([-\w]+)/i,
-			/sec-(sgh\w+)/i
-		],
-		[
-			MODEL,
-			[VENDOR, SAMSUNG],
-			[TYPE, MOBILE]
-		],
-		[/(?:\/|\()(ip(?:hone|od)[\w, ]*)(?:\/|;)/i],
-		[
-			MODEL,
-			[VENDOR, APPLE],
-			[TYPE, MOBILE]
-		],
-		[
-			/\((ipad);[-\w),; ]+apple/i,
-			/applecoremedia\/[\w.]+ \((ipad)/i,
-			/\b(ipad)\d\d?,\d\d?[;\]].+ios/i
-		],
-		[
-			MODEL,
-			[VENDOR, APPLE],
-			[TYPE, TABLET]
-		],
-		[/(macintosh);/i],
-		[MODEL, [VENDOR, APPLE]],
-		[/\b(sh-?[altvz]?\d\d[a-ekm]?)/i],
-		[
-			MODEL,
-			[VENDOR, SHARP],
-			[TYPE, MOBILE]
-		],
-		[/\b((?:ag[rs][23]?|bah2?|sht?|btv)-a?[lw]\d{2})\b(?!.+d\/s)/i],
-		[
-			MODEL,
-			[VENDOR, HUAWEI],
-			[TYPE, TABLET]
-		],
-		[/(?:huawei|honor)([-\w ]+)[;)]/i, /\b(nexus 6p|\w{2,4}e?-[atu]?[ln][\dx][0-359c][adn]?)\b(?!.+d\/s)/i],
-		[
-			MODEL,
-			[VENDOR, HUAWEI],
-			[TYPE, MOBILE]
-		],
-		[
-			/\b(poco[\w ]+|m2\d{3}j\d\d[a-z]{2})(?: bui|\))/i,
-			/\b; (\w+) build\/hm\1/i,
-			/\b(hm[-_ ]?note?[_ ]?(?:\d\w)?) bui/i,
-			/\b(redmi[\-_ ]?[\w ]+)(?: bui|\))/i,
-			/oid[^)]+; (m?[12][0-389][01]\w{3,6}[c-y])( bui|; wv|\))/i,
-			/\b(mi[-_ ]?(?:a\d|one|one[_ ]plus|note lte|max|cc)?[_ ]?\d?\w?[_ ]?(?:plus|se|lite)?)(?: bui|\))/i
-		],
-		[
-			[
-				MODEL,
-				/_/g,
-				" "
-			],
-			[VENDOR, XIAOMI],
-			[TYPE, MOBILE]
-		],
-		[/oid[^)]+; (2\d{4}(283|rpbf)[cgl])( bui|\))/i, /\b(mi[-_ ]?pad[\w ]+)(?: bui|\))/i],
-		[
-			[
-				MODEL,
-				/_/g,
-				" "
-			],
-			[VENDOR, XIAOMI],
-			[TYPE, TABLET]
-		],
-		[/; (\w+) bui.+ oppo/i, /\b(cph[12]\d{3}|p(?:af|c[al]|d\w|e[ar])[mt]\d0|x9007|a101op)\b/i],
-		[
-			MODEL,
-			[VENDOR, "OPPO"],
-			[TYPE, MOBILE]
-		],
-		[/\b(opd2\d{3}a?) bui/i],
-		[
-			MODEL,
-			[VENDOR, "OPPO"],
-			[TYPE, TABLET]
-		],
-		[/vivo (\w+)(?: bui|\))/i, /\b(v[12]\d{3}\w?[at])(?: bui|;)/i],
-		[
-			MODEL,
-			[VENDOR, "Vivo"],
-			[TYPE, MOBILE]
-		],
-		[/\b(rmx[1-3]\d{3})(?: bui|;|\))/i],
-		[
-			MODEL,
-			[VENDOR, "Realme"],
-			[TYPE, MOBILE]
-		],
-		[
-			/\b(milestone|droid(?:[2-4x]| (?:bionic|x2|pro|razr))?:?( 4g)?)\b[\w ]+build\//i,
-			/\bmot(?:orola)?[- ](\w*)/i,
-			/((?:moto[\w() ]+|xt\d{3,4}|nexus 6)(?= bui|\)))/i
-		],
-		[
-			MODEL,
-			[VENDOR, MOTOROLA],
-			[TYPE, MOBILE]
-		],
-		[/\b(mz60\d|xoom[2 ]{0,2}) build\//i],
-		[
-			MODEL,
-			[VENDOR, MOTOROLA],
-			[TYPE, TABLET]
-		],
-		[/((?=lg)?[vl]k-?\d{3}) bui| 3\.[-\w; ]{10}lg?-([06cv9]{3,4})/i],
-		[
-			MODEL,
-			[VENDOR, LG],
-			[TYPE, TABLET]
-		],
-		[
-			/(lm(?:-?f100[nv]?|-[\w.]+)(?= bui|\))|nexus [45])/i,
-			/\blg[-e;/ ]+((?!browser|netcast|android tv)\w+)/i,
-			/\blg-?(\w+) bui/i
-		],
-		[
-			MODEL,
-			[VENDOR, LG],
-			[TYPE, MOBILE]
-		],
-		[/(ideatab[-\w ]+)/i, /lenovo ?(s[56]000[-\w]+|tab[\w ]+|yt[-\w]{6}|tb[-\w]{6})/i],
-		[
-			MODEL,
-			[VENDOR, "Lenovo"],
-			[TYPE, TABLET]
-		],
-		[/(?:maemo|nokia).*(n900|lumia \d+)/i, /nokia[-_ ]?([-\w.]*)/i],
-		[
-			[
-				MODEL,
-				/_/g,
-				" "
-			],
-			[VENDOR, "Nokia"],
-			[TYPE, MOBILE]
-		],
-		[/(pixel c)\b/i],
-		[
-			MODEL,
-			[VENDOR, GOOGLE],
-			[TYPE, TABLET]
-		],
-		[/droid.+; (pixel[\daxl ]{0,6})(?: bui|\))/i],
-		[
-			MODEL,
-			[VENDOR, GOOGLE],
-			[TYPE, MOBILE]
-		],
-		[/droid.+ (a?\d[0-2]{2}so|[c-g]\d{4}|so[-gl]\w+|xq-a\w[4-7][12])(?= bui|\).+chrome\/(?![1-6]?\d\.))/i],
-		[
-			MODEL,
-			[VENDOR, SONY],
-			[TYPE, MOBILE]
-		],
-		[/sony tablet [ps]/i, /\b(?:sony)?sgp\w+(?: bui|\))/i],
-		[
-			[MODEL, "Xperia Tablet"],
-			[VENDOR, SONY],
-			[TYPE, TABLET]
-		],
-		[/ (kb2005|in20[12]5|be20[12][59])\b/i, /(?:one)?(?:plus)? (a\d0\d\d)(?: b|\))/i],
-		[
-			MODEL,
-			[VENDOR, "OnePlus"],
-			[TYPE, MOBILE]
-		],
-		[
-			/(alexa)webm/i,
-			/(kf[a-z]{2}wi|aeo[c-r]{2})( bui|\))/i,
-			/(kf[a-z]+)( bui|\)).+silk\//i
-		],
-		[
-			MODEL,
-			[VENDOR, AMAZON],
-			[TYPE, TABLET]
-		],
-		[/((?:sd|kf)[0349hijor-uw]+)( bui|\)).+silk\//i],
-		[
-			[
-				MODEL,
-				/(.+)/g,
-				"Fire Phone $1"
-			],
-			[VENDOR, AMAZON],
-			[TYPE, MOBILE]
-		],
-		[/(playbook);[-\w),; ]+(rim)/i],
-		[
-			MODEL,
-			VENDOR,
-			[TYPE, TABLET]
-		],
-		[/\b((?:bb[a-f]|st[hv])100-\d)/i, /\(bb10; (\w+)/i],
-		[
-			MODEL,
-			[VENDOR, BLACKBERRY],
-			[TYPE, MOBILE]
-		],
-		[/(?:\b|asus_)(transfo[prime ]{4,10} \w+|eeepc|slider \w+|nexus 7|padfone|p00[cj])/i],
-		[
-			MODEL,
-			[VENDOR, ASUS],
-			[TYPE, TABLET]
-		],
-		[/ (z[bes]6[027][012][km][ls]|zenfone \d\w?)\b/i],
-		[
-			MODEL,
-			[VENDOR, ASUS],
-			[TYPE, MOBILE]
-		],
-		[/(nexus 9)/i],
-		[
-			MODEL,
-			[VENDOR, "HTC"],
-			[TYPE, TABLET]
-		],
-		[
-			/(htc)[-;_ ]{1,2}([\w ]+(?=\)| bui)|\w+)/i,
-			/(zte)[- ]([\w ]+?)(?: bui|\/|\))/i,
-			/(alcatel|geeksphone|nexian|panasonic(?!;|\.)|sony(?!-bra))[-_ ]?([-\w]*)/i
-		],
-		[
-			VENDOR,
-			[
-				MODEL,
-				/_/g,
-				" "
-			],
-			[TYPE, MOBILE]
-		],
-		[/droid.+; ([ab][1-7]-?[0178a]\d\d?)/i],
-		[
-			MODEL,
-			[VENDOR, "Acer"],
-			[TYPE, TABLET]
-		],
-		[/droid.+; (m[1-5] note) bui/i, /\bmz-([-\w]{2,})/i],
-		[
-			MODEL,
-			[VENDOR, "Meizu"],
-			[TYPE, MOBILE]
-		],
-		[/; ((?:power )?armor[\w ]{0,8})(?: bui|\))/i],
-		[
-			MODEL,
-			[VENDOR, "Ulefone"],
-			[TYPE, MOBILE]
-		],
-		[
-			/(blackberry|benq|palm(?=-)|sonyericsson|acer|asus|dell|meizu|motorola|polytron|infinix|tecno)[-_ ]?([-\w]*)/i,
-			/(hp) ([\w ]+\w)/i,
-			/(asus)-?(\w+)/i,
-			/(microsoft); (lumia[\w ]+)/i,
-			/(lenovo)[-_ ]?([-\w]+)/i,
-			/(jolla)/i,
-			/(oppo) ?([\w ]+) bui/i
-		],
-		[
-			VENDOR,
-			MODEL,
-			[TYPE, MOBILE]
-		],
-		[
-			/(kobo)\s(ereader|touch)/i,
-			/(archos) (gamepad2?)/i,
-			/(hp).+(touchpad(?!.+tablet)|tablet)/i,
-			/(kindle)\/([\w.]+)/i,
-			/(nook)[\w ]+build\/(\w+)/i,
-			/(dell) (strea[kpr\d ]*[\dko])/i,
-			/(le[- ]+pan)[- ]+(\w{1,9}) bui/i,
-			/(trinity)[- ]*(t\d{3}) bui/i,
-			/(gigaset)[- ]+(q\w{1,9}) bui/i,
-			/(vodafone) ([\w ]+)(?:\)| bui)/i
-		],
-		[
-			VENDOR,
-			MODEL,
-			[TYPE, TABLET]
-		],
-		[/(surface duo)/i],
-		[
-			MODEL,
-			[VENDOR, MICROSOFT],
-			[TYPE, TABLET]
-		],
-		[/droid [\d.]+; (fp\du?)(?: b|\))/i],
-		[
-			MODEL,
-			[VENDOR, "Fairphone"],
-			[TYPE, MOBILE]
-		],
-		[/(u304aa)/i],
-		[
-			MODEL,
-			[VENDOR, "AT&T"],
-			[TYPE, MOBILE]
-		],
-		[/\bsie-(\w*)/i],
-		[
-			MODEL,
-			[VENDOR, "Siemens"],
-			[TYPE, MOBILE]
-		],
-		[/\b(rct\w+) b/i],
-		[
-			MODEL,
-			[VENDOR, "RCA"],
-			[TYPE, TABLET]
-		],
-		[/\b(venue[\d ]{2,7}) b/i],
-		[
-			MODEL,
-			[VENDOR, "Dell"],
-			[TYPE, TABLET]
-		],
-		[/\b(q(?:mv|ta)\w+) b/i],
-		[
-			MODEL,
-			[VENDOR, "Verizon"],
-			[TYPE, TABLET]
-		],
-		[/\b(?:barnes[& ]+noble |bn[rt])([\w+ ]*) b/i],
-		[
-			MODEL,
-			[VENDOR, "Barnes & Noble"],
-			[TYPE, TABLET]
-		],
-		[/\b(tm\d{3}\w+) b/i],
-		[
-			MODEL,
-			[VENDOR, "NuVision"],
-			[TYPE, TABLET]
-		],
-		[/\b(k88) b/i],
-		[
-			MODEL,
-			[VENDOR, "ZTE"],
-			[TYPE, TABLET]
-		],
-		[/\b(nx\d{3}j) b/i],
-		[
-			MODEL,
-			[VENDOR, "ZTE"],
-			[TYPE, MOBILE]
-		],
-		[/\b(gen\d{3}) b.+49h/i],
-		[
-			MODEL,
-			[VENDOR, "Swiss"],
-			[TYPE, MOBILE]
-		],
-		[/\b(zur\d{3}) b/i],
-		[
-			MODEL,
-			[VENDOR, "Swiss"],
-			[TYPE, TABLET]
-		],
-		[/\b((zeki)?tb.*\b) b/i],
-		[
-			MODEL,
-			[VENDOR, "Zeki"],
-			[TYPE, TABLET]
-		],
-		[/\b([yr]\d{2}) b/i, /\b(dragon[- ]+touch |dt)(\w{5}) b/i],
-		[
-			[VENDOR, "Dragon Touch"],
-			MODEL,
-			[TYPE, TABLET]
-		],
-		[/\b(ns-?\w{0,9}) b/i],
-		[
-			MODEL,
-			[VENDOR, "Insignia"],
-			[TYPE, TABLET]
-		],
-		[/\b((nxa|next)-?\w{0,9}) b/i],
-		[
-			MODEL,
-			[VENDOR, "NextBook"],
-			[TYPE, TABLET]
-		],
-		[/\b(xtreme_)?(v(1[045]|2[015]|[3469]0|7[05])) b/i],
-		[
-			[VENDOR, "Voice"],
-			MODEL,
-			[TYPE, MOBILE]
-		],
-		[/\b(lvtel-)?(v1[12]) b/i],
-		[
-			[VENDOR, "LvTel"],
-			MODEL,
-			[TYPE, MOBILE]
-		],
-		[/\b(ph-1) /i],
-		[
-			MODEL,
-			[VENDOR, "Essential"],
-			[TYPE, MOBILE]
-		],
-		[/\b(v(100md|700na|7011|917g).*\b) b/i],
-		[
-			MODEL,
-			[VENDOR, "Envizen"],
-			[TYPE, TABLET]
-		],
-		[/\b(trio[-\w. ]+) b/i],
-		[
-			MODEL,
-			[VENDOR, "MachSpeed"],
-			[TYPE, TABLET]
-		],
-		[/\btu_(1491) b/i],
-		[
-			MODEL,
-			[VENDOR, "Rotor"],
-			[TYPE, TABLET]
-		],
-		[/(shield[\w ]+) b/i],
-		[
-			MODEL,
-			[VENDOR, "Nvidia"],
-			[TYPE, TABLET]
-		],
-		[/(sprint) (\w+)/i],
-		[
-			VENDOR,
-			MODEL,
-			[TYPE, MOBILE]
-		],
-		[/(kin\.[onetw]{3})/i],
-		[
-			[
-				MODEL,
-				/\./g,
-				" "
-			],
-			[VENDOR, MICROSOFT],
-			[TYPE, MOBILE]
-		],
-		[/droid.+; (cc6666?|et5[16]|mc[239][23]x?|vc8[03]x?)\)/i],
-		[
-			MODEL,
-			[VENDOR, ZEBRA],
-			[TYPE, TABLET]
-		],
-		[/droid.+; (ec30|ps20|tc[2-8]\d[kx])\)/i],
-		[
-			MODEL,
-			[VENDOR, ZEBRA],
-			[TYPE, MOBILE]
-		],
-		[/smart-tv.+(samsung)/i],
-		[VENDOR, [TYPE, SMARTTV]],
-		[/hbbtv.+maple;(\d+)/i],
-		[
-			[
-				MODEL,
-				/^/,
-				"SmartTV"
-			],
-			[VENDOR, SAMSUNG],
-			[TYPE, SMARTTV]
-		],
-		[/(nux; netcast.+smarttv|lg (netcast\.tv-201\d|android tv))/i],
-		[[VENDOR, LG], [TYPE, SMARTTV]],
-		[/(apple) ?tv/i],
-		[
-			VENDOR,
-			[MODEL, `${APPLE} TV`],
-			[TYPE, SMARTTV]
-		],
-		[/crkey/i],
-		[
-			[MODEL, `${CHROME}cast`],
-			[VENDOR, GOOGLE],
-			[TYPE, SMARTTV]
-		],
-		[/droid.+aft(\w+)( bui|\))/i],
-		[
-			MODEL,
-			[VENDOR, AMAZON],
-			[TYPE, SMARTTV]
-		],
-		[/\(dtv[);].+(aquos)/i, /(aquos-tv[\w ]+)\)/i],
-		[
-			MODEL,
-			[VENDOR, SHARP],
-			[TYPE, SMARTTV]
-		],
-		[/(bravia[\w ]+)( bui|\))/i],
-		[
-			MODEL,
-			[VENDOR, SONY],
-			[TYPE, SMARTTV]
-		],
-		[/(mitv-\w{5}) bui/i],
-		[
-			MODEL,
-			[VENDOR, XIAOMI],
-			[TYPE, SMARTTV]
-		],
-		[/Hbbtv.*(technisat) (.*);/i],
-		[
-			VENDOR,
-			MODEL,
-			[TYPE, SMARTTV]
-		],
-		[/\b(roku)[\dx]*[)/]((?:dvp-)?[\d.]*)/i, /hbbtv\/\d+\.\d+\.\d+ +\([\w+ ]*; *(\w[^;]*);([^;]*)/i],
-		[
-			[VENDOR, trim],
-			[MODEL, trim],
-			[TYPE, SMARTTV]
-		],
-		[/\b(android tv|smart[- ]?tv|opera tv|tv; rv:)\b/i],
-		[[TYPE, SMARTTV]],
-		[/(ouya)/i, /(nintendo) ([wids3utch]+)/i],
-		[
-			VENDOR,
-			MODEL,
-			[TYPE, CONSOLE]
-		],
-		[/droid.+; (shield) bui/i],
-		[
-			MODEL,
-			[VENDOR, "Nvidia"],
-			[TYPE, CONSOLE]
-		],
-		[/(playstation [345portablevi]+)/i],
-		[
-			MODEL,
-			[VENDOR, SONY],
-			[TYPE, CONSOLE]
-		],
-		[/\b(xbox(?: one)?(?!; xbox))[); ]/i],
-		[
-			MODEL,
-			[VENDOR, MICROSOFT],
-			[TYPE, CONSOLE]
-		],
-		[/((pebble))app/i],
-		[
-			VENDOR,
-			MODEL,
-			[TYPE, WEARABLE]
-		],
-		[/(watch)(?: ?os[,/]|\d,\d\/)[\d.]+/i],
-		[
-			MODEL,
-			[VENDOR, APPLE],
-			[TYPE, WEARABLE]
-		],
-		[/droid.+; (glass) \d/i],
-		[
-			MODEL,
-			[VENDOR, GOOGLE],
-			[TYPE, WEARABLE]
-		],
-		[/droid.+; (wt63?0{2,3})\)/i],
-		[
-			MODEL,
-			[VENDOR, ZEBRA],
-			[TYPE, WEARABLE]
-		],
-		[/(quest( \d| pro)?)/i],
-		[
-			MODEL,
-			[VENDOR, FACEBOOK],
-			[TYPE, WEARABLE]
-		],
-		[/(tesla)(?: qtcarbrowser|\/[-\w.]+)/i],
-		[VENDOR, [TYPE, EMBEDDED]],
-		[/(aeobc)\b/i],
-		[
-			MODEL,
-			[VENDOR, AMAZON],
-			[TYPE, EMBEDDED]
-		],
-		[/droid .+?; ([^;]+?)(?: bui|; wv\)|\) applew).+? mobile safari/i],
-		[MODEL, [TYPE, MOBILE]],
-		[/droid .+?; ([^;]+?)(?: bui|\) applew).+?(?! mobile) safari/i],
-		[MODEL, [TYPE, TABLET]],
-		[/\b((tablet|tab)[;/]|focus\/\d(?!.+mobile))/i],
-		[[TYPE, TABLET]],
-		[/(phone|mobile(?:[;/]| [ \w/.]*safari)|pda(?=.+windows ce))/i],
-		[[TYPE, MOBILE]],
-		[/(android[-\w. ]{0,9});.+buil/i],
-		[MODEL, [VENDOR, "Generic"]]
-	],
-	engine: [
-		[/windows.+ edge\/([\w.]+)/i],
-		[VERSION, [NAME, `${EDGE}HTML`]],
-		[/webkit\/537\.36.+chrome\/(?!27)([\w.]+)/i],
-		[VERSION, [NAME, "Blink"]],
-		[
-			/(presto)\/([\w.]+)/i,
-			/(webkit|trident|netfront|netsurf|amaya|lynx|w3m|goanna)\/([\w.]+)/i,
-			/ekioh(flow)\/([\w.]+)/i,
-			/(khtml|tasman|links)[/ ]\(?([\w.]+)/i,
-			/(icab)[/ ]([23]\.[\d.]+)/i,
-			/\b(libweb)/i
-		],
-		[NAME, VERSION],
-		[/rv:([\w.]{1,9})\b.+(gecko)/i],
-		[VERSION, NAME]
-	],
-	os: [
-		[/microsoft (windows) (vista|xp)/i],
-		[NAME, VERSION],
-		[/(windows (?:phone(?: os)?|mobile))[/ ]?([.\w ]*)/i],
-		[NAME, [
-			VERSION,
-			strMapper,
-			windowsVersionMap
-		]],
-		[
-			/windows nt 6\.2; (arm)/i,
-			/windows[/ ]?([ntce\d. ]+\w)(?!.+xbox)/i,
-			/(?:win(?=[39n])|win 9x )([nt\d.]+)/i
-		],
-		[[
-			VERSION,
-			strMapper,
-			windowsVersionMap
-		], [NAME, "Windows"]],
-		[
-			/ip[honead]{2,4}\b(?:.*os (\w+) like mac|; opera)/i,
-			/(?:ios;fbsv\/|iphone.+ios[/ ])([\d.]+)/i,
-			/cfnetwork\/.+darwin/i
-		],
-		[[
-			VERSION,
-			/_/g,
-			"."
-		], [NAME, "iOS"]],
-		[/(mac os x) ?([\w. ]*)/i, /(macintosh|mac_powerpc\b)(?!.+haiku)/i],
-		[[NAME, MAC_OS], [
-			VERSION,
-			/_/g,
-			"."
-		]],
-		[/droid ([\w.]+)\b.+(android[- ]x86|harmonyos)/i],
-		[VERSION, NAME],
-		[
-			/(android|webos|qnx|bada|rim tablet os|maemo|meego|sailfish)[-/ ]?([\w.]*)/i,
-			/(blackberry)\w*\/([\w.]*)/i,
-			/(tizen|kaios)[/ ]([\w.]+)/i,
-			/\((series40);/i
-		],
-		[NAME, VERSION],
-		[/\(bb(10);/i],
-		[VERSION, [NAME, BLACKBERRY]],
-		[/(?:symbian ?os|symbos|s60(?=;)|series60)[-/ ]?([\w.]*)/i],
-		[VERSION, [NAME, "Symbian"]],
-		[/mozilla\/[\d.]+ \((?:mobile|tablet|tv|mobile; [\w ]+); rv:.+ gecko\/([\w.]+)/i],
-		[VERSION, [NAME, `${FIREFOX} OS`]],
-		[/web0s;.+rt(tv)/i, /\b(?:hp)?wos(?:browser)?\/([\w.]+)/i],
-		[VERSION, [NAME, "webOS"]],
-		[/watch(?: ?os[,/]|\d,\d\/)([\d.]+)/i],
-		[VERSION, [NAME, "watchOS"]],
-		[/crkey\/([\d.]+)/i],
-		[VERSION, [NAME, `${CHROME}cast`]],
-		[/(cros) \w+(?:\)| ([\w.]+)\b)/i],
-		[[NAME, CHROMIUM_OS], VERSION],
-		[
-			/panasonic;(viera)/i,
-			/(netrange)mmh/i,
-			/(nettv)\/(\d+\.[\w.]+)/i,
-			/(nintendo|playstation) ([wids345portablevuch]+)/i,
-			/(xbox); +xbox ([^);]+)/i,
-			/\b(joli|palm)\b ?(?:os)?\/?([\w.]*)/i,
-			/(mint)[/() ]?(\w*)/i,
-			/(mageia|vectorlinux)[; ]/i,
-			/([kxln]?ubuntu|debian|suse|opensuse|gentoo|arch(?= linux)|slackware|fedora|mandriva|centos|pclinuxos|red ?hat|zenwalk|linpus|raspbian|plan 9|minix|risc os|contiki|deepin|manjaro|elementary os|sabayon|linspire)(?: gnu\/linux)?(?: enterprise)?(?:[- ]linux)?(?:-gnu)?[-/ ]?(?!chrom|package)([-\w.]*)/i,
-			/(hurd|linux) ?([\w.]*)/i,
-			/(gnu) ?([\w.]*)/i,
-			/\b([-e-hrntopcs]{0,5}bsd|dragonfly)[/ ]?(?!amd|[ix346]{1,2}86)([\w.]*)/i,
-			/(haiku) (\w+)/i
-		],
-		[NAME, VERSION],
-		[/(sunos) ?([\w.]*)/i],
-		[[NAME, "Solaris"], VERSION],
-		[
-			/((?:open)?solaris)[-/ ]?([\w.]*)/i,
-			/(aix) ((\d)(?=[.) ])[\w.])*/i,
-			/\b(beos|os\/2|amigaos|morphos|openvms|fuchsia|hp-ux|serenityos)/i,
-			/(unix) ?([\w.]*)/i
-		],
-		[NAME, VERSION]
-	]
-};
-function isExtensionsInput(input) {
-	return typeof input === "object" && input !== null;
-}
-Object.freeze(enumerize([
-	NAME,
-	VERSION,
-	MAJOR
-]));
-Object.freeze(enumerize([ARCHITECTURE]));
-Object.freeze(enumerize([
-	MODEL,
-	VENDOR,
-	TYPE,
-	CONSOLE,
-	MOBILE,
-	SMARTTV,
-	TABLET,
-	WEARABLE,
-	EMBEDDED
-]));
-Object.freeze(enumerize([NAME, VERSION]));
-Object.freeze(enumerize([NAME, VERSION]));
-function getRuntimeNavigator() {
-	if (typeof window === "undefined" || !window.navigator) return void 0;
-	return window.navigator;
-}
-function normalizeUA(ua) {
-	return ua.length > UA_MAX_LENGTH ? trim(ua, UA_MAX_LENGTH) : ua;
-}
-function createDefaultParserContext(uastring) {
-	if (typeof uastring === "string") return {
-		ua: normalizeUA(uastring),
-		isSelfNavigator: false,
-		navigator: void 0,
-		userAgentData: void 0,
-		regexMap: regexes
-	};
-	const navigator = getRuntimeNavigator();
-	const ua = normalizeUA(navigator && navigator.userAgent ? navigator.userAgent : EMPTY);
-	return {
-		ua,
-		isSelfNavigator: Boolean(navigator && navigator.userAgent === ua),
-		navigator,
-		userAgentData: navigator?.userAgentData,
-		regexMap: regexes
-	};
-}
-function createParserContext(uastringOrExtensions, extensions) {
-	if (!extensions && !isExtensionsInput(uastringOrExtensions)) return createDefaultParserContext(uastringOrExtensions);
-	const navigator = getRuntimeNavigator();
-	const uastring = isExtensionsInput(uastringOrExtensions) ? void 0 : uastringOrExtensions;
-	const resolvedExtensions = isExtensionsInput(uastringOrExtensions) ? uastringOrExtensions : extensions;
-	const ua = normalizeUA(uastring || (navigator && navigator.userAgent ? navigator.userAgent : EMPTY));
-	const userAgentData = navigator?.userAgentData;
-	return {
-		ua,
-		isSelfNavigator: Boolean(navigator && navigator.userAgent === ua),
-		navigator,
-		userAgentData,
-		regexMap: resolvedExtensions ? extend(regexes, resolvedExtensions) : regexes
-	};
-}
-function parseBrowserFromContext(context) {
-	const browser = {
-		name: void 0,
-		version: void 0,
-		major: void 0
-	};
-	rgxMapper(context.ua, context.regexMap.browser, browser);
-	browser.major = majorize(browser.version);
-	if (context.isSelfNavigator && context.navigator?.brave && typeof context.navigator.brave.isBrave === "function") browser.name = "Brave";
-	return browser;
-}
-function parseCPUFromContext(context) {
-	const cpu = { architecture: void 0 };
-	rgxMapper(context.ua, context.regexMap.cpu, cpu);
-	return cpu;
-}
-function parseDeviceFromContext(context) {
-	const device = {
-		vendor: void 0,
-		model: void 0,
-		type: void 0
-	};
-	rgxMapper(context.ua, context.regexMap.device, device);
-	if (context.isSelfNavigator && !device.type && context.userAgentData?.mobile) device.type = MOBILE;
-	if (context.isSelfNavigator && device.model === "Macintosh" && context.navigator && typeof context.navigator.standalone !== "undefined" && context.navigator.maxTouchPoints && context.navigator.maxTouchPoints > 2) {
-		device.model = "iPad";
-		device.type = TABLET;
-	}
-	return device;
-}
-function parseEngineFromContext(context) {
-	const engine = {
-		name: void 0,
-		version: void 0
-	};
-	rgxMapper(context.ua, context.regexMap.engine, engine);
-	return engine;
-}
-function parseOSFromContext(context) {
-	const os = {
-		name: void 0,
-		version: void 0
-	};
-	rgxMapper(context.ua, context.regexMap.os, os);
-	if (context.isSelfNavigator && !os.name && context.userAgentData?.platform && context.userAgentData.platform !== "Unknown") os.name = context.userAgentData.platform.replace(/chrome os/i, CHROMIUM_OS).replace(/macos/i, MAC_OS);
-	return os;
-}
-function parseUA(uastringOrExtensions, extensions) {
-	let context;
-	let browserCache;
-	let engineCache;
-	let osCache;
-	let deviceCache;
-	let cpuCache;
-	const getContext = () => context ||= createParserContext(uastringOrExtensions, extensions);
-	return {
-		get ua() {
-			return getContext().ua;
-		},
-		get browser() {
-			browserCache ||= parseBrowserFromContext(getContext());
-			return browserCache;
-		},
-		get engine() {
-			engineCache ||= parseEngineFromContext(getContext());
-			return engineCache;
-		},
-		get os() {
-			osCache ||= parseOSFromContext(getContext());
-			return osCache;
-		},
-		get device() {
-			deviceCache ||= parseDeviceFromContext(getContext());
-			return deviceCache;
-		},
-		get cpu() {
-			cpuCache ||= parseCPUFromContext(getContext());
-			return cpuCache;
-		}
+		serialize: codec.serialize,
+		deserialize: codec.deserialize
 	};
 }
 //#endregion
@@ -2176,204 +1478,47 @@ function resolveWsUrl(websocket, metaBaseUrl, loc) {
 }
 function createWsRpcClientMode(options) {
 	const { authToken, connectionMeta, metaBaseUrl, events, clientRpc, rpcOptions = {}, wsOptions = {}, callTimeout = 0 } = options;
-	let isTrusted = false;
-	let status = "connecting";
-	let connectionError = null;
-	const trustedPromise = promiseWithResolver();
 	const url = resolveWsUrl(connectionMeta.websocket, metaBaseUrl ?? "./", location);
-	function setStatus(next, error = null) {
-		if (error) connectionError = error;
-		else if (next === "connected") connectionError = null;
-		if (next === status) return;
-		const previous = status;
-		status = next;
-		events.emit("connection:status", next, previous);
-	}
-	const pending = /* @__PURE__ */ new Set();
-	function rejectAllPending(error) {
-		for (const entry of [...pending]) entry.reject(error);
-	}
-	function terminalError() {
-		if (status === "disconnected" || status === "error") return new DevframeConnectionError("connection", "[devframe] Not connected to the devframe server", { cause: connectionError ?? void 0 });
-		if (status === "unauthorized") return new DevframeConnectionError("auth", "[devframe] Not authorized by the devframe server", { cause: connectionError ?? void 0 });
-		return null;
-	}
-	/**
-	* Wrap an in-flight call promise so it settles on server response, on an
-	* optional wall-clock timeout, or when the connection drops — never hangs.
-	*/
-	function guardCall(promise, method) {
-		return new Promise((resolve, reject) => {
-			let settled = false;
-			let timer;
-			const entry = { reject(error) {
-				if (settled) return;
-				finish();
-				events.emit("rpc:error", error, method);
-				reject(error);
-			} };
-			function finish() {
-				settled = true;
-				pending.delete(entry);
-				if (timer) clearTimeout(timer);
-			}
-			pending.add(entry);
-			if (callTimeout > 0) timer = setTimeout(() => {
-				entry.reject(new DevframeConnectionError("timeout", `[devframe] RPC call "${method}" timed out after ${callTimeout}ms`));
-			}, callTimeout);
-			promise.then((value) => {
-				if (settled) return;
-				finish();
-				resolve(value);
-			}, (error) => {
-				if (settled) return;
-				finish();
-				const err = error instanceof Error ? error : new Error(String(error));
-				events.emit("rpc:error", err, method);
-				reject(err);
-			});
-		});
-	}
-	const definitions = /* @__PURE__ */ new Map();
-	for (const name of connectionMeta.jsonSerializableMethods ?? []) definitions.set(name, { jsonSerializable: true });
-	const serverRpc = createRpcClient(clientRpc.functions, {
-		channel: createWsRpcChannel({
+	return createLiveRpcClientMode({
+		transport: "websocket",
+		authToken,
+		connectionMeta,
+		events,
+		clientRpc,
+		rpcOptions,
+		callTimeout,
+		createChannel: (handlers) => createWsRpcChannel({
 			url,
 			authToken,
-			definitions,
+			definitions: handlers.definitions,
 			...wsOptions,
 			onConnected(event) {
 				wsOptions.onConnected?.(event);
 			},
 			onError(error) {
-				setStatus("error", error);
-				events.emit("connection:error", error);
-				rejectAllPending(new DevframeConnectionError("connection", "[devframe] Connection to the devframe server failed", { cause: error }));
+				handlers.onError(error);
 				wsOptions.onError?.(error);
 			},
 			onDisconnected(event) {
-				if (status !== "error") setStatus("disconnected");
-				rejectAllPending(new DevframeConnectionError("connection", "[devframe] Disconnected from the devframe server", { cause: connectionError ?? void 0 }));
+				handlers.onDisconnected();
 				wsOptions.onDisconnected?.(event);
 			}
-		}),
-		rpcOptions
-	});
-	clientRpc.register({
-		name: "devframe:auth:revoked",
-		type: "event",
-		handler: () => {
-			isTrusted = false;
-			const authError = new DevframeConnectionError("auth", "[devframe] The devframe server revoked this client's trust");
-			setStatus("unauthorized", authError);
-			events.emit("connection:error", authError);
-			rejectAllPending(authError);
-			events.emit("rpc:is-trusted:updated", false);
-		}
+		})
 	});
-	let currentAuthToken = authToken;
-	function describeUA() {
-		const info = parseUA(navigator.userAgent);
-		return [
-			info.browser.name,
-			info.browser.version,
-			"|",
-			info.os.name,
-			info.os.version,
-			info.device.type
-		].filter((i) => i).join(" ");
-	}
-	async function requestTrustWithToken(token) {
-		currentAuthToken = token;
-		const result = await serverRpc.$call("anonymous:devframe:auth", {
-			authToken: token,
-			ua: describeUA(),
-			origin: location.origin
-		});
-		isTrusted = result.isTrusted;
-		if (isTrusted) {
-			trustedPromise.resolve(true);
-			setStatus("connected");
-		} else {
-			const authError = new DevframeConnectionError("auth", "[devframe] The devframe server refused this client's credentials");
-			setStatus("unauthorized", authError);
-			events.emit("connection:error", authError);
-		}
-		events.emit("rpc:is-trusted:updated", isTrusted);
-		return result.isTrusted;
-	}
-	async function requestTrustWithCode(code) {
-		const token = (await serverRpc.$call("anonymous:devframe:auth:exchange", {
-			code,
-			ua: describeUA(),
-			origin: location.origin
-		}))?.authToken ?? null;
-		if (token) {
-			currentAuthToken = token;
-			isTrusted = true;
-			trustedPromise.resolve(true);
-			setStatus("connected");
-			events.emit("rpc:is-trusted:updated", true);
-		}
-		return token;
-	}
-	async function requestTrust() {
-		if (isTrusted) return true;
-		return requestTrustWithToken(currentAuthToken ?? "");
-	}
-	async function ensureTrusted(timeout = 6e4) {
-		if (isTrusted) trustedPromise.resolve(true);
-		if (timeout <= 0) return trustedPromise.promise;
-		let clear = () => {};
-		await Promise.race([trustedPromise.promise.then(clear), new Promise((resolve, reject) => {
-			const id = setTimeout(() => {
-				reject(/* @__PURE__ */ new Error("[devframe] Timeout waiting for rpc to be trusted"));
-			}, timeout);
-			clear = () => clearTimeout(id);
-		})]);
-		return isTrusted;
-	}
-	return {
-		get isTrusted() {
-			return isTrusted;
-		},
-		get status() {
-			return status;
-		},
-		get connectionError() {
-			return connectionError;
-		},
-		requestTrust,
-		requestTrustWithToken,
-		requestTrustWithCode,
-		ensureTrusted,
-		call: (...args) => {
-			const method = String(args[0]);
-			const failFast = terminalError();
-			if (failFast) {
-				events.emit("rpc:error", failFast, method);
-				return Promise.reject(failFast);
-			}
-			return guardCall(serverRpc.$call(...args), method);
-		},
-		callEvent: (...args) => {
-			const failFast = terminalError();
-			if (failFast) {
-				events.emit("rpc:error", failFast, String(args[0]));
-				return;
-			}
-			return serverRpc.$callEvent(...args);
-		},
-		callOptional: (...args) => {
-			const method = String(args[0]);
-			const failFast = terminalError();
-			if (failFast) {
-				events.emit("rpc:error", failFast, method);
-				return Promise.reject(failFast);
-			}
-			return guardCall(serverRpc.$callOptional(...args), method);
-		}
-	};
+}
+//#endregion
+//#region src/utils/scope.ts
+/** Whether a name is already namespaced (contains a `:` separator). */
+function isQualifiedName(name) {
+	return name.includes(":");
+}
+/**
+* Prefix a bare name with `<namespace>:`. Names that already contain a
+* `:` are returned unchanged, so callers can reference another scope's
+* ids explicitly (e.g. `ctx.rpc.call('other-plugin:fn')`).
+*/
+function qualifyName(namespace, name) {
+	return isQualifiedName(name) ? name : `${namespace}:${name}`;
 }
 //#endregion
 //#region src/client/settings.ts
@@ -2451,6 +1596,30 @@ function createScopedClientContext(rpc, namespace) {
 }
 //#endregion
 //#region src/client/rpc.ts
+/**
+* Resolve the requested `transport` option against what the server
+* advertises. `'auto'` trusts the advertisement — the server's declared
+* primary (`backend`), preferring the WebSocket when both endpoints are
+* present; an explicit `'websocket'` / `'sse'` pins that transport and
+* throws when the server doesn't advertise it.
+*/
+function resolveClientTransport(requested, meta) {
+	if (meta.backend === "static") return "static";
+	const hasWebsocket = meta.websocket !== void 0;
+	const hasSse = meta.sse !== void 0;
+	if (requested === "websocket") {
+		if (!hasWebsocket) throw new Error("[devframe] transport: 'websocket' was requested, but this server does not advertise a WebSocket endpoint");
+		return "websocket";
+	}
+	if (requested === "sse") {
+		if (!hasSse) throw new Error("[devframe] transport: 'sse' was requested, but this server does not advertise an SSE endpoint");
+		return "sse";
+	}
+	if (meta.backend === "sse" && hasSse) return "sse";
+	if (hasWebsocket) return "websocket";
+	if (hasSse) return "sse";
+	throw new Error("[devframe] This server advertises no RPC transport (backend \"none\") — nothing to connect to. Enable the WebSocket or SSE endpoint on the server, or use its static/MCP surfaces instead.");
+}
 async function getDevframeRpcClient(options = {}) {
 	const { baseURL = "./", rpcOptions = {}, cacheOptions = false } = options;
 	const events = createEventEmitter();
@@ -2480,7 +1649,7 @@ async function getDevframeRpcClient(options = {}) {
 		}
 		throw new Error(`Failed to load ${path} from ${candidates.join(", ")}`, { cause: errors });
 	}
-	const mode = connectionMeta.backend === "static" ? await createStaticRpcClientMode({ fetchJsonFromBases }) : createWsRpcClientMode({
+	const liveModeOptions = {
 		authToken,
 		connectionMeta,
 		metaBaseUrl,
@@ -2497,7 +1666,14 @@ async function getDevframeRpcClient(options = {}) {
 					cacheManager.apply(req, res);
 				} else await next(req);
 			}
-		},
+		}
+	};
+	const transport = resolveClientTransport(options.transport ?? "auto", connectionMeta);
+	const mode = transport === "static" ? await createStaticRpcClientMode({ fetchJsonFromBases }) : transport === "sse" ? createSseRpcClientMode({
+		...liveModeOptions,
+		sseOptions: options.sseOptions
+	}) : createWsRpcClientMode({
+		...liveModeOptions,
 		wsOptions: options.wsOptions
 	});
 	let authChannel;
@@ -2523,6 +1699,9 @@ async function getDevframeRpcClient(options = {}) {
 		get connectionError() {
 			return mode.connectionError;
 		},
+		get transport() {
+			return mode.transport ?? transport;
+		},
 		get connection() {
 			return connection;
 		},
@@ -2560,7 +1739,8 @@ async function getDevframeRpcClient(options = {}) {
 		sharedState: void 0,
 		streaming: void 0,
 		cacheManager,
-		scope: void 0
+		scope: void 0,
+		close: () => mode.close?.()
 	};
 	rpc.sharedState = createRpcSharedStateClientHost(rpc);
 	rpc.streaming = createRpcStreamingClientHost(rpc);
@@ -2614,4 +1794,4 @@ async function getDevframeRpcClient(options = {}) {
 //#region src/client/index.ts
 const connectDevframe = getDevframeRpcClient;
 //#endregion
-export { DevframeConnectionError, authenticateWithUrlOtp, connectDevframe, consumeOtpFromUrl, createClientSettings, createRpcStreamingClientHost, createScopedClientContext, getDevframeConnection, getDevframeRpcClient, isCallableStatus, readOtpFromUrl, registerDevframeViewerOrigin, resolveWsUrl, setupDevframeConnection };
+export { DevframeConnectionError, authenticateWithUrlOtp, connectDevframe, consumeOtpFromUrl, createClientSettings, createRpcStreamingClientHost, createScopedClientContext, getDevframeConnection, getDevframeRpcClient, isCallableStatus, readOtpFromUrl, registerDevframeViewerOrigin, resolveClientTransport, resolveSseUrl, resolveWsUrl, setupDevframeConnection };