devframe 0.1.22 → 0.2.1

package/dist/{rpc-CkZuoz-m.mjs → rpc-BlVCyk9W.mjs}

@@ -1,5 +1,6 @@
-import { t as hash } from "./hash-BHZbo80D.mjs";
+import { t as hash } from "./hash-CIBte1yS.mjs";
 import { i as logger } from "./serialization-CwO31axa.mjs";
+import { DEVTOOLS_RPC_DUMP_DIRNAME } from "./constants.mjs";
 //#region src/rpc/cache.ts
 /**
 * @experimental API is expected to change.
@@ -129,7 +130,7 @@ function assertAgentJsonSerializable(fn) {
 	if (fn.agent && fn.jsonSerializable !== true) throw logger.DF0019({ name: fn.name }).throw();
 }
 //#endregion
-//#region ../../../node_modules/.pnpm/yocto-queue@1.2.2/node_modules/yocto-queue/index.js
+//#region ../../node_modules/.pnpm/yocto-queue@1.2.2/node_modules/yocto-queue/index.js
 var Node = class {
 	value;
 	next;
@@ -187,7 +188,7 @@ var Queue = class {
 	}
 };
 //#endregion
-//#region ../../../node_modules/.pnpm/p-limit@7.3.0/node_modules/p-limit/index.js
+//#region ../../node_modules/.pnpm/p-limit@7.3.0/node_modules/p-limit/index.js
 function pLimit(concurrency) {
 	let rejectOnClear = false;
 	if (typeof concurrency === "object") ({concurrency, rejectOnClear = false} = concurrency);
@@ -285,7 +286,60 @@ function validateDefinition(definition) {
 	validateDefinitions([definition]);
 }
 //#endregion
-//#region src/rpc/dumps.ts
+//#region src/rpc/dump/error.ts
+/**
+* Normalize a thrown value into a plain object suitable for storage in
+* a dump record. Preserves `message`, `name`, `cause`, and any own
+* enumerable properties of an `Error` so consumers reading the dump can
+* reconstruct a richer Error than just `{ message, name }`.
+*
+* Non-`Error` throws are wrapped as `{ name: 'Error', message: String(thrown) }`.
+*/
+function serializeDumpError(error) {
+	return serializeWithSeen(error, /* @__PURE__ */ new WeakSet());
+}
+function serializeWithSeen(error, seen) {
+	if (!(error instanceof Error)) return {
+		name: "Error",
+		message: String(error)
+	};
+	if (seen.has(error)) return {
+		name: error.name,
+		message: error.message
+	};
+	seen.add(error);
+	const out = {
+		name: error.name,
+		message: error.message
+	};
+	const cause = error.cause;
+	if (cause !== void 0) out.cause = cause instanceof Error ? serializeWithSeen(cause, seen) : cause;
+	for (const key of Object.keys(error)) {
+		if (key === "name" || key === "message" || key === "cause") continue;
+		out[key] = error[key];
+	}
+	return out;
+}
+/**
+* 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/dump/index.ts
 function getDumpRecordKey(functionName, args) {
 	return `${functionName}---${hash(args)}`;
 }
@@ -374,10 +428,7 @@ async function dumpFunctions(definitions, context, options = {}) {
 			} catch (error) {
 				store.records[recordKey] = {
 					inputs: input,
-					error: {
-						message: error.message,
-						name: error.name
-					}
+					error: serializeDumpError(error)
 				};
 			}
 		});
@@ -409,11 +460,7 @@ function createClientFromDump(store, options = {}) {
 				const recordOrGetter = store.records[recordKey];
 				if (recordOrGetter) {
 					const record = await resolveGetter(recordOrGetter);
-					if (record.error) {
-						const error = new Error(record.error.message);
-						error.name = record.error.name;
-						throw error;
-					}
+					if (record.error) throw reviveDumpError(record.error);
 					if (typeof record.output === "function") return await record.output();
 					return record.output;
 				}
@@ -454,4 +501,81 @@ function getDefinitionsWithDumps(definitions) {
 	return definitions.filter((def) => def.dump !== void 0);
 }
 //#endregion
-export { validateDefinitions as a, getRpcResolvedSetupResult as c, validateDefinition as i, RpcCacheManager as l, dumpFunctions as n, RpcFunctionsCollectorBase as o, getDefinitionsWithDumps as r, getRpcHandler as s, createClientFromDump as t };
+//#region src/rpc/dump/static.ts
+function makeDumpKey(name) {
+	return encodeURIComponent(name.replaceAll(":", "~"));
+}
+function makeStaticPath(name) {
+	return `${DEVTOOLS_RPC_DUMP_DIRNAME}/${makeDumpKey(name)}.static.json`;
+}
+function makeQueryRecordPath(name, hash) {
+	return `${DEVTOOLS_RPC_DUMP_DIRNAME}/${makeDumpKey(name)}.record.${hash}.json`;
+}
+function makeQueryFallbackPath(name) {
+	return `${DEVTOOLS_RPC_DUMP_DIRNAME}/${makeDumpKey(name)}.fallback.json`;
+}
+async function resolveRecord(record) {
+	return typeof record === "function" ? await record() : record;
+}
+async function collectStaticRpcDump(definitions, context) {
+	const manifest = {};
+	const files = {};
+	for (const definition of definitions) {
+		const type = definition.type ?? "query";
+		const serialization = definition.jsonSerializable === true ? "json" : "structured-clone";
+		if (type === "static") {
+			const handler = await getRpcHandler(definition, context);
+			const path = makeStaticPath(definition.name);
+			files[path] = {
+				serialization,
+				fnName: definition.name,
+				data: { output: await Promise.resolve(handler()) }
+			};
+			manifest[definition.name] = {
+				type: "static",
+				path,
+				serialization
+			};
+			continue;
+		}
+		if (type !== "query") continue;
+		const store = await dumpFunctions([definition], context);
+		if (!(definition.name in store.definitions)) continue;
+		const queryEntry = {
+			type: "query",
+			records: {},
+			serialization
+		};
+		const prefix = `${definition.name}---`;
+		for (const [recordKey, recordOrGetter] of Object.entries(store.records)) {
+			if (!recordKey.startsWith(prefix)) continue;
+			const key = recordKey.slice(prefix.length);
+			const record = await resolveRecord(recordOrGetter);
+			if (key === "fallback") {
+				const path = makeQueryFallbackPath(definition.name);
+				files[path] = {
+					serialization,
+					fnName: definition.name,
+					data: record
+				};
+				queryEntry.fallback = path;
+			} else {
+				const path = makeQueryRecordPath(definition.name, key);
+				files[path] = {
+					serialization,
+					fnName: definition.name,
+					data: record
+				};
+				queryEntry.records[key] = path;
+			}
+		}
+		if (!Object.keys(queryEntry.records).length && !queryEntry.fallback) continue;
+		manifest[definition.name] = queryEntry;
+	}
+	return {
+		manifest,
+		files
+	};
+}
+//#endregion
+export { reviveDumpError as a, validateDefinitions as c, getRpcResolvedSetupResult as d, RpcCacheManager as f, getDefinitionsWithDumps as i, RpcFunctionsCollectorBase as l, createClientFromDump as n, serializeDumpError as o, dumpFunctions as r, validateDefinition as s, collectStaticRpcDump as t, getRpcHandler as u };

package/dist/{server-zKEDxgqD.d.mts → server-CgqyJG9m.d.mts}

@@ -1,7 +1,7 @@
-import { Q as DevToolsRpcServerFunctions, Z as DevToolsRpcClientFunctions, y as DevToolsNodeContext } from "./devframe-DulcIxwu.mjs";
+import { U as DevToolsRpcClientFunctions, W as DevToolsRpcServerFunctions, d as DevToolsNodeContext } from "./devframe-BXZUBuy6.mjs";
 import { BirpcGroup } from "birpc";
 import { WebSocketServer } from "ws";
-import { App } from "h3";
+import { H3 } from "h3";
 
 //#region src/node/server.d.ts
 interface StartHttpAndWsOptions {
@@ -13,7 +13,7 @@ interface StartHttpAndWsOptions {
    * when provided, callers can add their own routes (static handlers,
    * auth middleware, etc.) first.
    */
-  app?: App;
+  app?: H3;
   /**
    * When `false`, the RPC server is started without a trust handshake.
    * Intended for single-user localhost tools where an auth round-trip
@@ -33,14 +33,14 @@ interface StartHttpAndWsOptions {
   onReady?: (info: {
     origin: string;
     port: number;
-    app: App;
+    app: H3;
   }) => void | Promise<void>;
 }
 interface StartedServer {
   /** Listening origin, e.g. `http://localhost:9999`. */
   origin: string;
   port: number;
-  app: App;
+  app: H3;
   wss: WebSocketServer;
   rpcGroup: BirpcGroup<DevToolsRpcClientFunctions, DevToolsRpcServerFunctions, false>;
   close: () => Promise<void>;

package/dist/{server-ma8-ZVyX.mjs → server-G1ymmN3_.mjs}

@@ -3,7 +3,7 @@ import { attachWsRpcTransport } from "./rpc/transports/ws-server.mjs";
 import { WebSocketServer } from "ws";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { createServer } from "node:http";
-import { createApp, toNodeListener } from "h3";
+import { H3, toNodeHandler } from "h3";
 //#region src/node/server.ts
 /**
 * Compose an h3 + WebSocket server for a devframe context. The RPC
@@ -13,8 +13,8 @@ import { createApp, toNodeListener } from "h3";
 async function startHttpAndWs(options) {
 	const { context, port } = options;
 	const bindHost = options.host ?? "localhost";
-	const app = options.app ?? createApp();
-	const httpServer = createServer(toNodeListener(app));
+	const app = options.app ?? new H3();
+	const httpServer = createServer(toNodeHandler(app));
 	const wss = new WebSocketServer({ server: httpServer });
 	const rpcHost = context.rpc;
 	const asyncStorage = new AsyncLocalStorage();

package/dist/{shared-state-DCDs0e7y.mjs → shared-state-q9-1EOSX.mjs}

@@ -1,6 +1,6 @@
 import { createEventEmitter } from "./utils/events.mjs";
 import { nanoid } from "./utils/nanoid.mjs";
-//#region ../../../node_modules/.pnpm/immer@11.1.8/node_modules/immer/dist/immer.mjs
+//#region ../../node_modules/.pnpm/immer@11.1.8/node_modules/immer/dist/immer.mjs
 var NOTHING = Symbol.for("immer-nothing");
 var DRAFTABLE = Symbol.for("immer-draftable");
 var DRAFT_STATE = Symbol.for("immer-state");

package/dist/{storage-CNC38eU-.mjs → storage-BaLJK6e_.mjs}

@@ -1,8 +1,8 @@
-import { n as logger } from "./diagnostics-BFhNNmST.mjs";
-import { t as createSharedState } from "./shared-state-DCDs0e7y.mjs";
+import { n as logger } from "./diagnostics-Cg9ycFIM.mjs";
+import { t as createSharedState } from "./shared-state-q9-1EOSX.mjs";
 import fs from "node:fs";
 import { dirname } from "pathe";
-//#region ../../../node_modules/.pnpm/perfect-debounce@2.1.0/node_modules/perfect-debounce/dist/index.mjs
+//#region ../../node_modules/.pnpm/perfect-debounce@2.1.0/node_modules/perfect-debounce/dist/index.mjs
 const DEBOUNCE_DEFAULTS = { trailing: true };
 /**
 Debounce functions

package/dist/{structured-clone-DcDc2Dds.mjs → structured-clone-CD2l4fI3.mjs}

@@ -1,4 +1,4 @@
-//#region ../../../node_modules/.pnpm/structured-clone-es@2.0.0/node_modules/structured-clone-es/dist/index.mjs
+//#region ../../node_modules/.pnpm/structured-clone-es@2.0.0/node_modules/structured-clone-es/dist/index.mjs
 const env = typeof self === "object" ? self : globalThis;
 function deserializer($, _) {
 	const as = (out, index) => {

package/dist/{transports-BnCs4rj9.mjs → transports-BLwT342H.mjs}

@@ -1,5 +1,5 @@
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-//#region src/node/mcp/transports.ts
+//#region src/adapters/mcp/transports.ts
 /**
 * Start the MCP server on stdio. Returns a stop function.
 * @internal

package/dist/types/index.d.mts

@@ -1,4 +1,4 @@
-import { $ as DevToolsRpcSharedStates, C as RpcSharedStateGetOptions, D as RpcStreamingHost, E as RpcStreamingChannelOptions, J as EntriesToObject, Q as DevToolsRpcServerFunctions, S as RpcFunctionsHost, T as RpcStreamingChannel, X as Thenable, Y as PartialWithoutId, Z as DevToolsRpcClientFunctions, _ as ConnectionMeta, a as DevframeRuntime, at as AgentManifest, b as DevToolsNodeRpcSession, c as DevtoolBrowserContext, ct as AgentResourceInput, d as DevtoolDeploymentKind, dt as DevToolsAgentHost, et as DevToolsHost, f as DevtoolRuntime, ft as DevToolsAgentHostEvents, g as defineDevtool, h as defineDevframe, ht as EventsMap, i as DevframeDeploymentKind, it as AgentHandle, l as DevtoolCliOptions, lt as AgentTool, m as DevtoolSpaOptions, mt as EventUnsubscribe, n as DevframeCliOptions, nt as DevToolsDiagnosticsHost, o as DevframeSetupInfo, ot as AgentResource, p as DevtoolSetupInfo, pt as EventEmitter, q as DevToolsViewHost, r as DevframeDefinition, rt as DevToolsDiagnosticsLogger, s as DevframeSpaOptions, st as AgentResourceContent, t as DevframeBrowserContext, tt as DevToolsDiagnosticsDefinition, u as DevtoolDefinition, ut as AgentToolInput, v as DevToolsCapabilities, w as RpcSharedStateHost, x as RpcBroadcastOptions, y as DevToolsNodeContext } from "../devframe-DulcIxwu.mjs";
-import { m as RpcFunctionAgentOptions } from "../types-4rdUEi2R.mjs";
-import { t as DevToolsNodeRpcSessionMeta } from "../ws-server-DjvlwLuM.mjs";
-export { AgentHandle, AgentManifest, AgentResource, AgentResourceContent, AgentResourceInput, AgentTool, AgentToolInput, ConnectionMeta, DevToolsAgentHost, DevToolsAgentHostEvents, DevToolsCapabilities, DevToolsDiagnosticsDefinition, DevToolsDiagnosticsHost, DevToolsDiagnosticsLogger, DevToolsHost, DevToolsNodeContext, DevToolsNodeRpcSession, DevToolsNodeRpcSessionMeta, DevToolsRpcClientFunctions, DevToolsRpcServerFunctions, DevToolsRpcSharedStates, DevToolsViewHost, DevframeBrowserContext, DevframeCliOptions, DevframeDefinition, DevframeDeploymentKind, DevframeRuntime, DevframeSetupInfo, DevframeSpaOptions, DevtoolBrowserContext, DevtoolCliOptions, DevtoolDefinition, DevtoolDeploymentKind, DevtoolRuntime, DevtoolSetupInfo, DevtoolSpaOptions, EntriesToObject, EventEmitter, EventUnsubscribe, EventsMap, PartialWithoutId, RpcBroadcastOptions, RpcFunctionAgentOptions, RpcFunctionsHost, RpcSharedStateGetOptions, RpcSharedStateHost, RpcStreamingChannel, RpcStreamingChannelOptions, RpcStreamingHost, Thenable, defineDevframe, defineDevtool };
+import { $ as AgentResourceContent, B as EntriesToObject, G as DevToolsRpcSharedStates, H as Thenable, J as DevToolsDiagnosticsHost, K as DevToolsHost, Q as AgentResource, U as DevToolsRpcClientFunctions, V as PartialWithoutId, W as DevToolsRpcServerFunctions, X as AgentHandle, Y as DevToolsDiagnosticsLogger, Z as AgentManifest, _ as RpcStreamingChannel, a as DevframeRuntime, at as EventEmitter, c as defineDevframe, d as DevToolsNodeContext, et as AgentResourceInput, f as DevToolsNodeRpcSession, g as RpcSharedStateHost, h as RpcSharedStateGetOptions, i as DevframeDeploymentKind, it as DevToolsAgentHostEvents, l as ConnectionMeta, m as RpcFunctionsHost, n as DevframeCliOptions, nt as AgentToolInput, o as DevframeSetupInfo, ot as EventUnsubscribe, p as RpcBroadcastOptions, q as DevToolsDiagnosticsDefinition, r as DevframeDefinition, rt as DevToolsAgentHost, s as DevframeSpaOptions, st as EventsMap, t as DevframeBrowserContext, tt as AgentTool, u as DevToolsCapabilities, v as RpcStreamingChannelOptions, y as RpcStreamingHost, z as DevToolsViewHost } from "../devframe-BXZUBuy6.mjs";
+import { h as RpcFunctionAgentOptions } from "../types-ip8THGH1.mjs";
+import { t as DevToolsNodeRpcSessionMeta } from "../ws-server-kW8RZXTw.mjs";
+export { AgentHandle, AgentManifest, AgentResource, AgentResourceContent, AgentResourceInput, AgentTool, AgentToolInput, ConnectionMeta, DevToolsAgentHost, DevToolsAgentHostEvents, DevToolsCapabilities, DevToolsDiagnosticsDefinition, DevToolsDiagnosticsHost, DevToolsDiagnosticsLogger, DevToolsHost, DevToolsNodeContext, DevToolsNodeRpcSession, DevToolsNodeRpcSessionMeta, DevToolsRpcClientFunctions, DevToolsRpcServerFunctions, DevToolsRpcSharedStates, DevToolsViewHost, DevframeBrowserContext, DevframeCliOptions, DevframeDefinition, DevframeDeploymentKind, DevframeRuntime, DevframeSetupInfo, DevframeSpaOptions, EntriesToObject, EventEmitter, EventUnsubscribe, EventsMap, PartialWithoutId, RpcBroadcastOptions, RpcFunctionAgentOptions, RpcFunctionsHost, RpcSharedStateGetOptions, RpcSharedStateHost, RpcStreamingChannel, RpcStreamingChannelOptions, RpcStreamingHost, Thenable, defineDevframe };

package/dist/types/index.mjs

@@ -2,14 +2,5 @@
 function defineDevframe(d) {
 	return d;
 }
-let warnedDefineDevtool = false;
-/** @deprecated Use `defineDevframe`. */
-function defineDevtool(d) {
-	if (!warnedDefineDevtool) {
-		warnedDefineDevtool = true;
-		console.warn("[devframe] `defineDevtool` is deprecated; use `defineDevframe` instead.");
-	}
-	return d;
-}
 //#endregion
-export { defineDevframe, defineDevtool };
+export { defineDevframe };

package/dist/{types-4rdUEi2R.d.mts → types-ip8THGH1.d.mts}

@@ -94,6 +94,25 @@ interface RpcFunctionSetupResult<ARGS extends any[], RETURN = void> {
 type RpcArgsSchema = readonly GenericSchema[];
 /** Valibot schema for validating function return value */
 type RpcReturnSchema = GenericSchema;
+/**
+ * Serialized representation of a thrown value in a dump record.
+ *
+ * Errors are stored as plain objects so they round-trip through both the
+ * strict-JSON and structured-clone codecs. `message` and `name` are always
+ * present; `cause` and any own enumerable properties of the original
+ * `Error` are preserved on a best-effort basis. Non-`Error` throws are
+ * normalized to `{ name: 'Error', message: String(thrown) }`.
+ */
+interface RpcDumpRecordError {
+  /** Error message (mirrors `Error.message`). */
+  message: string;
+  /** Error type name (e.g., "Error", "TypeError"). */
+  name: string;
+  /** `Error.cause`, recursively serialized when it is itself an `Error`. */
+  cause?: unknown;
+  /** Own enumerable properties of the original error (excluding `message`/`name`/`cause`). */
+  [key: string]: unknown;
+}
 /**
  * Single record in a dump store with pre-computed results.
  */
@@ -103,10 +122,7 @@ interface RpcDumpRecord<ARGS extends any[] = any[], RETURN = any> {
   /** Result (value or lazy function) */
   output?: RETURN;
   /** Error if execution failed */
-  error?: {
-    /** Error message */message: string; /** Error type name (e.g., "Error", "TypeError") */
-    name: string;
-  };
+  error?: RpcDumpRecordError;
 }
 /**
  * Defines argument combinations to pre-compute for a function.
@@ -270,4 +286,4 @@ type RpcDefinitionsFilter<T extends readonly RpcFunctionDefinitionAny[], Type ex
   type: Type;
 } ? T[K] : never };
 //#endregion
-export { RpcReturnSchema as C, RpcFunctionsCollector as S, RpcFunctionDefinitionAnyWithContext as _, RpcDefinitionsFilter as a, RpcFunctionSetupResult as b, RpcDumpClientOptions as c, RpcDumpGetter as d, RpcDumpRecord as f, RpcFunctionDefinitionAny as g, RpcFunctionDefinition as h, RpcArgsSchema as i, RpcDumpCollectionOptions as l, RpcFunctionAgentOptions as m, BirpcReturn$1 as n, RpcDefinitionsToFunctions as o, RpcDumpStore as p, EntriesToObject as r, RpcDump as s, BirpcFn as t, RpcDumpDefinition as u, RpcFunctionDefinitionBase as v, Thenable as w, RpcFunctionType as x, RpcFunctionDefinitionToFunction as y };
+export { RpcFunctionsCollector as C, RpcFunctionType as S, Thenable as T, RpcFunctionDefinitionAny as _, RpcDefinitionsFilter as a, RpcFunctionDefinitionToFunction as b, RpcDumpClientOptions as c, RpcDumpGetter as d, RpcDumpRecord as f, RpcFunctionDefinition as g, RpcFunctionAgentOptions as h, RpcArgsSchema as i, RpcDumpCollectionOptions as l, RpcDumpStore as m, BirpcReturn$1 as n, RpcDefinitionsToFunctions as o, RpcDumpRecordError as p, EntriesToObject as r, RpcDump as s, BirpcFn as t, RpcDumpDefinition as u, RpcFunctionDefinitionAnyWithContext as v, RpcReturnSchema as w, RpcFunctionSetupResult as x, RpcFunctionDefinitionBase as y };

package/dist/utils/colors.mjs

@@ -1,2 +1,2 @@
-import { t as colors } from "../colors-Bl4W18Mh.mjs";
+import { t as colors } from "../colors-DS7k8ljB.mjs";
 export { colors };

package/dist/utils/events.d.mts

@@ -1,4 +1,4 @@
-import { ht as EventsMap, pt as EventEmitter } from "../devframe-DulcIxwu.mjs";
+import { at as EventEmitter, st as EventsMap } from "../devframe-BXZUBuy6.mjs";
 
 //#region src/utils/events.d.ts
 /**

package/dist/utils/hash.mjs

@@ -1,2 +1,2 @@
-import { t as hash } from "../hash-BHZbo80D.mjs";
+import { t as hash } from "../hash-CIBte1yS.mjs";
 export { hash };

package/dist/utils/human-id.mjs

@@ -1,2 +1,2 @@
-import { t as humanId } from "../human-id-adtUWQLr.mjs";
+import { t as humanId } from "../human-id-mPh1HcFO.mjs";
 export { humanId };

package/dist/utils/launch-editor.mjs

@@ -1,2 +1,2 @@
-import { t as launchEditor } from "../launch-editor-KA_21J1T.mjs";
+import { t as launchEditor } from "../launch-editor-1dAC7Uk5.mjs";
 export { launchEditor };

package/dist/utils/open.mjs

@@ -1,2 +1,2 @@
-import { t as open } from "../open-DmFp0qZA.mjs";
+import { t as open } from "../open-CWL4Zasd.mjs";
 export { open };

package/dist/utils/serve-static.d.mts

@@ -1,5 +1,5 @@
 import { IncomingMessage, ServerResponse } from "node:http";
-import { EventHandler, EventHandlerRequest } from "h3";
+import { EventHandler, H3 } from "h3";
 
 //#region src/utils/serve-static.d.ts
 interface ServeStaticOptions {
@@ -17,7 +17,17 @@ interface ServeStaticOptions {
  * file extension falls back to `<dir>/index.html` so client-side routing
  * works.
  */
-declare function serveStaticHandler(dir: string, options?: ServeStaticOptions): EventHandler<EventHandlerRequest>;
+declare function serveStaticHandler(dir: string, options?: ServeStaticOptions): EventHandler;
+/**
+ * Mount {@link serveStaticHandler} on an h3 app at `base`, handling the
+ * route pattern and prefix-stripping required by h3 v2.
+ *
+ * h3 v2's `app.use(base, handler)` only matches the exact `base` path and
+ * does not strip the prefix from `event.url.pathname`. Static serving
+ * needs both subpath matching (`/base/**`) and the URL stripped so the
+ * file resolver sees paths relative to `dir` — this helper bundles both.
+ */
+declare function mountStaticHandler(app: H3, base: string, dir: string, options?: ServeStaticOptions): void;
 /**
  * Connect/Express-style Node middleware variant of {@link serveStaticHandler}.
  *
@@ -27,4 +37,4 @@ declare function serveStaticHandler(dir: string, options?: ServeStaticOptions):
  */
 declare function serveStaticNodeMiddleware(dir: string, options?: ServeStaticOptions): (req: IncomingMessage, res: ServerResponse, next?: (err?: Error) => void) => void;
 //#endregion
-export { ServeStaticOptions, serveStaticHandler, serveStaticNodeMiddleware };
+export { ServeStaticOptions, mountStaticHandler, serveStaticHandler, serveStaticNodeMiddleware };

package/dist/utils/serve-static.mjs

@@ -1,7 +1,8 @@
 import { createReadStream } from "node:fs";
 import { extname, join, normalize, resolve, sep } from "pathe";
-import { defineEventHandler, sendStream, setResponseHeader, setResponseStatus } from "h3";
+import { defineHandler, withBase } from "h3";
 import { stat } from "node:fs/promises";
+import { Readable } from "node:stream";
 import { lookup } from "mrmime";
 //#region src/utils/serve-static.ts
 const HTML_EXTENSIONS = [".html", ".htm"];
@@ -55,11 +56,16 @@ function contentTypeFor(abs) {
 	if (type === "text/html") return "text/html; charset=utf-8";
 	return type;
 }
-function setStaticHeaders(res, file) {
-	res.setHeader("Content-Type", contentTypeFor(file.abs));
-	res.setHeader("Content-Length", file.size);
-	res.setHeader("Last-Modified", file.mtime.toUTCString());
-	res.setHeader("Cache-Control", "no-store");
+function staticHeadersFor(file) {
+	return {
+		"Content-Type": contentTypeFor(file.abs),
+		"Content-Length": String(file.size),
+		"Last-Modified": file.mtime.toUTCString(),
+		"Cache-Control": "no-store"
+	};
+}
+function applyStaticHeadersToNode(res, file) {
+	for (const [k, v] of Object.entries(staticHeadersFor(file))) res.setHeader(k, v);
 }
 function normalizeOptions(options) {
 	return {
@@ -79,27 +85,42 @@ function normalizeOptions(options) {
 function serveStaticHandler(dir, options) {
 	const absDir = resolve(dir);
 	const opts = normalizeOptions(options);
-	return defineEventHandler(async (event) => {
-		const method = event.node.req.method;
+	return defineHandler(async (event) => {
+		const method = event.req.method;
 		if (method !== "GET" && method !== "HEAD") {
-			setResponseStatus(event, 405);
-			setResponseHeader(event, "Allow", "GET, HEAD");
+			event.res.status = 405;
+			event.res.headers.set("Allow", "GET, HEAD");
 			return "";
 		}
-		const file = await resolveTarget(absDir, event.node.req.url ?? "/", opts.indexNames, opts.single);
+		const file = await resolveTarget(absDir, event.url.pathname, opts.indexNames, opts.single);
 		if (!file) {
-			setResponseStatus(event, 404);
-			return "";
-		}
-		setStaticHeaders(event.node.res, file);
-		if (method === "HEAD") {
-			event.node.res.end();
+			event.res.status = 404;
 			return "";
 		}
-		return sendStream(event, createReadStream(file.abs));
+		for (const [k, v] of Object.entries(staticHeadersFor(file))) event.res.headers.set(k, v);
+		if (method === "HEAD") return "";
+		return Readable.toWeb(createReadStream(file.abs));
 	});
 }
 /**
+* Mount {@link serveStaticHandler} on an h3 app at `base`, handling the
+* route pattern and prefix-stripping required by h3 v2.
+*
+* h3 v2's `app.use(base, handler)` only matches the exact `base` path and
+* does not strip the prefix from `event.url.pathname`. Static serving
+* needs both subpath matching (`/base/**`) and the URL stripped so the
+* file resolver sees paths relative to `dir` — this helper bundles both.
+*/
+function mountStaticHandler(app, base, dir, options) {
+	const trimmed = base.replace(/\/$/, "");
+	const handler = serveStaticHandler(dir, options);
+	if (trimmed === "") {
+		app.use("/**", handler);
+		return;
+	}
+	app.use(`${trimmed}/**`, withBase(trimmed, handler));
+}
+/**
 * Connect/Express-style Node middleware variant of {@link serveStaticHandler}.
 *
 * Use when mounting onto `viteServer.middlewares.use(base, …)` or any other
@@ -132,7 +153,7 @@ function serveStaticNodeMiddleware(dir, options) {
 				res.end();
 				return;
 			}
-			setStaticHeaders(res, file);
+			applyStaticHeadersToNode(res, file);
 			if (method === "HEAD") {
 				res.end();
 				return;
@@ -149,4 +170,4 @@ function serveStaticNodeMiddleware(dir, options) {
 	};
 }
 //#endregion
-export { serveStaticHandler, serveStaticNodeMiddleware };
+export { mountStaticHandler, serveStaticHandler, serveStaticNodeMiddleware };

package/dist/utils/shared-state.d.mts

@@ -1,2 +1,2 @@
-import { B as ImmutableObject, G as SharedStatePatch, H as SharedState, K as createSharedState, L as Immutable, R as ImmutableArray, U as SharedStateEvents, V as ImmutableSet, W as SharedStateOptions, z as ImmutableMap } from "../devframe-DulcIxwu.mjs";
+import { A as ImmutableArray, F as SharedStateEvents, I as SharedStateOptions, L as SharedStatePatch, M as ImmutableObject, N as ImmutableSet, P as SharedState, R as createSharedState, j as ImmutableMap, k as Immutable } from "../devframe-BXZUBuy6.mjs";
 export { Immutable, ImmutableArray, ImmutableMap, ImmutableObject, ImmutableSet, SharedState, SharedStateEvents, SharedStateOptions, SharedStatePatch, createSharedState };

package/dist/utils/shared-state.mjs

@@ -1,2 +1,2 @@
-import { t as createSharedState } from "../shared-state-DCDs0e7y.mjs";
+import { t as createSharedState } from "../shared-state-q9-1EOSX.mjs";
 export { createSharedState };

package/dist/utils/streaming-channel.d.mts

@@ -1,2 +1,2 @@
-import { A as CreateStreamSinkOptions, F as createStreamReader, I as createStreamSink, M as StreamReader, N as StreamSink, O as BufferedChunk, P as StreamSinkEvents, j as StreamErrorPayload, k as CreateStreamReaderOptions } from "../devframe-DulcIxwu.mjs";
+import { C as StreamErrorPayload, D as createStreamReader, E as StreamSinkEvents, O as createStreamSink, S as CreateStreamSinkOptions, T as StreamSink, b as BufferedChunk, w as StreamReader, x as CreateStreamReaderOptions } from "../devframe-BXZUBuy6.mjs";
 export { BufferedChunk, CreateStreamReaderOptions, CreateStreamSinkOptions, StreamErrorPayload, StreamReader, StreamSink, StreamSinkEvents, createStreamReader, createStreamSink };

package/dist/utils/structured-clone.mjs

@@ -1,2 +1,2 @@
-import { i as structuredCloneStringify, n as structuredCloneParse, r as structuredCloneSerialize, t as structuredCloneDeserialize } from "../structured-clone-DcDc2Dds.mjs";
+import { i as structuredCloneStringify, n as structuredCloneParse, r as structuredCloneSerialize, t as structuredCloneDeserialize } from "../structured-clone-CD2l4fI3.mjs";
 export { structuredCloneDeserialize, structuredCloneParse, structuredCloneSerialize, structuredCloneStringify };

package/dist/utils/when.d.mts

@@ -1,4 +1,4 @@
-//#region ../../../node_modules/.pnpm/whenexpr@0.1.2/node_modules/whenexpr/dist/index.d.mts
+//#region ../../node_modules/.pnpm/whenexpr@0.1.2/node_modules/whenexpr/dist/index.d.mts
 //#region src/paths.d.ts
 /**
  * Union of valid context paths for `T` — both flat keys (`keyof T`) and

package/dist/utils/when.mjs

@@ -1,4 +1,4 @@
-//#region ../../../node_modules/.pnpm/whenexpr@0.1.2/node_modules/whenexpr/dist/index.mjs
+//#region ../../node_modules/.pnpm/whenexpr@0.1.2/node_modules/whenexpr/dist/index.mjs
 const OPS = [
 	"===",
 	"!==",

package/dist/{ws-client-Bavoya6-.d.mts → ws-client-DFUf-xgm.d.mts}

@@ -1,4 +1,4 @@
-import { g as RpcFunctionDefinitionAny } from "./types-4rdUEi2R.mjs";
+import { _ as RpcFunctionDefinitionAny } from "./types-ip8THGH1.mjs";
 import { ChannelOptions } from "birpc";
 
 //#region src/rpc/transports/ws-client.d.ts

package/dist/{ws-server-DjvlwLuM.d.mts → ws-server-kW8RZXTw.d.mts}

@@ -1,4 +1,4 @@
-import { g as RpcFunctionDefinitionAny } from "./types-4rdUEi2R.mjs";
+import { _ as RpcFunctionDefinitionAny } from "./types-ip8THGH1.mjs";
 import { BirpcGroup, ChannelOptions } from "birpc";
 import { ServerOptions } from "node:https";
 import { WebSocket, WebSocketServer } from "ws";