devframe 0.6.0-beta.2 → 0.6.0-beta.3

package/dist/adapters/build.d.mts

@@ -1,4 +1,4 @@
-import { r as DevframeDefinition } from "../devframe-D-gr9sBx.mjs";
+import { r as DevframeDefinition } from "../devframe-DgvncQy2.mjs";
 
 //#region src/adapters/build.d.ts
 interface CreateBuildOptions {

package/dist/adapters/build.mjs

@@ -1,9 +1,9 @@
-import { t as collectStaticRpcDump } from "../dump-DoXkj4ku.mjs";
+import { t as collectStaticRpcDump } from "../dump-D09PZb7T.mjs";
 import { n as colors } from "../diagnostics-reporter-CsIG85Q5.mjs";
 import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_RPC_DUMP_DIRNAME, DEVFRAME_RPC_DUMP_MANIFEST_FILENAME } from "../constants.mjs";
 import { n as strictJsonStringify } from "../serialization-DpLXCy13.mjs";
 import { n as structuredCloneStringify } from "../structured-clone-XpHLZ8nr.mjs";
-import { n as createHostContext, t as createH3DevframeHost } from "../host-h3-C5SZlk03.mjs";
+import { n as createHostContext, t as createH3DevframeHost } from "../host-h3-Dsf-Tgwx.mjs";
 import { n as resolveBasePath } from "../_shared-bWRzeSa0.mjs";
 import { existsSync } from "node:fs";
 import { dirname, resolve } from "pathe";

package/dist/adapters/cli.d.mts

@@ -1,4 +1,4 @@
-import { Ct as CliFlagsSchema, Et as parseCliFlags, Tt as defineCliFlags, r as DevframeDefinition, wt as InferCliFlags } from "../devframe-D-gr9sBx.mjs";
+import { Ct as CliFlagsSchema, Et as parseCliFlags, Tt as defineCliFlags, r as DevframeDefinition, wt as InferCliFlags } from "../devframe-DgvncQy2.mjs";
 import { CAC } from "cac";
 import { H3 } from "h3";
 

package/dist/adapters/cli.mjs

@@ -1,6 +1,6 @@
 import { n as colors } from "../diagnostics-reporter-CsIG85Q5.mjs";
 import { createBuild } from "./build.mjs";
-import { n as resolveDevServerPort, t as createDevServer } from "../dev-BaX8fLH2.mjs";
+import { n as resolveDevServerPort, t as createDevServer } from "../dev-DSxKFn-v.mjs";
 import process from "node:process";
 import cac from "cac";
 import { safeParse } from "valibot";

package/dist/adapters/dev.d.mts

@@ -1,5 +1,5 @@
-import { l as DevframeWsOptions, r as DevframeDefinition } from "../devframe-D-gr9sBx.mjs";
-import { n as StartedServer } from "../server-rX781kz-.mjs";
+import { l as DevframeWsOptions, r as DevframeDefinition } from "../devframe-DgvncQy2.mjs";
+import { n as StartedServer } from "../server-DXPq8q0K.mjs";
 import { H3 } from "h3";
 
 //#region src/adapters/dev.d.ts

package/dist/adapters/dev.mjs

@@ -1,2 +1,2 @@
-import { n as resolveDevServerPort, t as createDevServer } from "../dev-BaX8fLH2.mjs";
+import { n as resolveDevServerPort, t as createDevServer } from "../dev-DSxKFn-v.mjs";
 export { createDevServer, resolveDevServerPort };

package/dist/adapters/embedded.d.mts

@@ -1,4 +1,4 @@
-import { m as DevframeNodeContext, r as DevframeDefinition } from "../devframe-D-gr9sBx.mjs";
+import { m as DevframeNodeContext, r as DevframeDefinition } from "../devframe-DgvncQy2.mjs";
 
 //#region src/adapters/embedded.d.ts
 interface CreateEmbeddedOptions {

package/dist/adapters/mcp.d.mts

@@ -1,4 +1,4 @@
-import { r as DevframeDefinition } from "../devframe-D-gr9sBx.mjs";
+import { r as DevframeDefinition } from "../devframe-DgvncQy2.mjs";
 //#region src/adapters/mcp/build-server.d.ts
 interface CreateMcpServerOptions {
   /**

package/dist/adapters/mcp.mjs

@@ -1,8 +1,8 @@
-import { a as diagnostics } from "../storage-l2ezeend.mjs";
-import { n as createHostContext } from "../host-h3-C5SZlk03.mjs";
+import { a as diagnostics } from "../storage-yrUZaiib.mjs";
+import { n as createHostContext } from "../host-h3-Dsf-Tgwx.mjs";
 import { join } from "pathe";
-import { homedir } from "node:os";
 import process from "node:process";
+import { homedir } from "node:os";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import { toJsonSchema } from "@valibot/to-json-schema";

package/dist/client/index.d.mts

@@ -1,6 +1,6 @@
-import { $ as ScopedServerFunctions, D as StreamReader, J as DevframeSettings, L as SharedState, O as StreamSink, bt as EventEmitter, d as ConnectionMeta, et as ScopedSharedStates, it as DevframeRpcServerFunctions, rt as DevframeRpcClientFunctions, tt as SettingsForNamespace, v as RpcSharedStateGetOptions, y as RpcSharedStateHost } from "../devframe-D-gr9sBx.mjs";
+import { $ as ScopedServerFunctions, D as StreamReader, J as DevframeSettings, L as SharedState, O as StreamSink, bt as EventEmitter, d as ConnectionMeta, et as ScopedSharedStates, it as DevframeRpcServerFunctions, rt as DevframeRpcClientFunctions, tt as SettingsForNamespace, v as RpcSharedStateGetOptions, y as RpcSharedStateHost } from "../devframe-DgvncQy2.mjs";
 import { _ as RpcFunctionDefinition, w as RpcFunctionsCollector } from "../types-DZEx4ffs.mjs";
-import { C as RpcCacheManager, w as RpcCacheOptions } from "../index-CxaPKDXX.mjs";
+import { C as RpcCacheManager, w as RpcCacheOptions } from "../index-Dy6GFDRf.mjs";
 import { t as WsRpcChannelOptions } from "../ws-client-D0z0pOhn.mjs";
 import { BirpcOptions, BirpcReturn } from "birpc";
 

package/dist/client/index.mjs

@@ -1,7 +1,7 @@
-import { t as hash } from "../hash-DFc5WwhO.mjs";
+import { t as hash } from "../hash-PAfnyu2k.mjs";
 import { colors } from "../utils/colors.mjs";
 import { createEventEmitter } from "../utils/events.mjs";
-import { t as createSharedState } from "../shared-state-D4PPieA0.mjs";
+import { t as createSharedState } from "../shared-state-QtMas0NG.mjs";
 import { i as structuredCloneStringify, n as structuredCloneParse, t as structuredCloneDeserialize } from "../structured-clone-CeZOHvkd.mjs";
 import { createStreamReader, createStreamSink } from "../utils/streaming-channel.mjs";
 import { promiseWithResolver } from "../utils/promise.mjs";
@@ -21,6 +21,14 @@ const DEVFRAME_RPC_DUMP_MANIFEST_FILENAME = "__rpc-dump/index.json";
 * `consumeOtpFromUrl` client utilities (or `connectDevframe`'s `otpParam`).
 */
 const DEVFRAME_OTP_URL_PARAM = "devframe_otp";
+/**
+* WS upgrade-URL query parameter carrying a previously-issued bearer token.
+* Set by `createWsRpcChannel` (browser transport) whenever `authToken` is
+* passed; read at connect time by a host's connect-time trust hook (see
+* `recipes/interactive-auth`'s `onConnect`) so a returning client can be
+* trusted before its own `anonymous:devframe:auth` handshake call arrives.
+*/
+const DEVFRAME_AUTH_TOKEN_QUERY_PARAM = "devframe_auth_token";
 //#endregion
 //#region src/utils/diagnostics-reporter.ts
 const formatAnsi = ansiFormatter(colors);
@@ -83,14 +91,24 @@ async function getRpcResolvedSetupResult(definition, context) {
 	if (!definition.setup) return {};
 	if (typeof context === "object" && context !== null) {
 		definition.__cache ??= /* @__PURE__ */ new WeakMap();
-		let promise = definition.__cache.get(context);
+		const cache = definition.__cache;
+		let promise = cache.get(context);
 		if (!promise) {
 			promise = Promise.resolve(definition.setup(context));
-			definition.__cache.set(context, promise);
+			promise.catch(() => {
+				if (cache.get(context) === promise) cache.delete(context);
+			});
+			cache.set(context, promise);
 		}
 		return await promise;
 	}
-	definition.__promise ??= Promise.resolve(definition.setup(context));
+	if (!definition.__promise) {
+		const promise = Promise.resolve(definition.setup(context));
+		promise.catch(() => {
+			if (definition.__promise === promise) definition.__promise = void 0;
+		});
+		definition.__promise = promise;
+	}
 	return await definition.__promise;
 }
 async function getRpcHandler(definition, context) {
@@ -122,6 +140,9 @@ var RpcCacheManager = class {
 		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);
@@ -398,8 +419,12 @@ function createRpcSharedStateClientHost(rpc) {
 			return new Promise((resolve) => {
 				if (!rpc.isTrusted) {
 					resolve(state);
+					let initialized = false;
 					rpc.events.on("rpc:is-trusted:updated", (isTrusted) => {
-						if (isTrusted) initSharedState();
+						if (isTrusted && !initialized) {
+							initialized = true;
+							initSharedState();
+						}
 					});
 				} else initSharedState().then(resolve);
 			});
@@ -611,14 +636,15 @@ const EMPTY_DEFS = /* @__PURE__ */ new Map();
 */
 function createWsRpcChannel(options) {
 	let url = options.url;
-	if (options.authToken) url = `${url}?devframe_auth_token=${encodeURIComponent(options.authToken)}`;
+	if (options.authToken) url = `${url}?${DEVFRAME_AUTH_TOKEN_QUERY_PARAM}=${encodeURIComponent(options.authToken)}`;
 	const ws = new WebSocket(url);
 	const { onConnected = NOOP, onError = NOOP, onDisconnected = NOOP, definitions = EMPTY_DEFS } = options;
 	ws.addEventListener("open", (e) => {
 		onConnected(e);
 	});
 	ws.addEventListener("error", (e) => {
-		onError(e instanceof Error ? e : new Error(e.type));
+		const _e = e instanceof Error ? e : new Error(e.type);
+		onError(_e);
 	});
 	ws.addEventListener("close", (e) => {
 		onDisconnected(e);
@@ -631,14 +657,25 @@ function createWsRpcChannel(options) {
 			});
 		},
 		post: (data) => {
-			if (ws.readyState === WebSocket.OPEN) ws.send(data);
-			else {
-				function handler() {
-					ws.send(data);
-					ws.removeEventListener("open", handler);
+			if (ws.readyState === WebSocket.OPEN) {
+				ws.send(data);
+				return;
+			}
+			if (ws.readyState === WebSocket.CONNECTING) {
+				const onOpen = () => {
+					cleanup();
+					if (ws.readyState === WebSocket.OPEN) ws.send(data);
+				};
+				const onClose = () => cleanup();
+				function cleanup() {
+					ws.removeEventListener("open", onOpen);
+					ws.removeEventListener("close", onClose);
 				}
-				ws.addEventListener("open", handler);
+				ws.addEventListener("open", onOpen);
+				ws.addEventListener("close", onClose);
+				return;
 			}
+			onError(/* @__PURE__ */ new Error("Devframe WebSocket is not open; message dropped"));
 		},
 		serialize: (msg) => {
 			let method;
@@ -1899,7 +1936,7 @@ function createWsRpcClientMode(options) {
 	}
 	async function requestTrustWithToken(token) {
 		currentAuthToken = token;
-		const result = await serverRpc.$call("devframe:anonymous:auth", {
+		const result = await serverRpc.$call("anonymous:devframe:auth", {
 			authToken: token,
 			ua: describeUA(),
 			origin: location.origin
@@ -1910,7 +1947,7 @@ function createWsRpcClientMode(options) {
 		return result.isTrusted;
 	}
 	async function requestTrustWithCode(code) {
-		const token = (await serverRpc.$call("devframe:auth:exchange", {
+		const token = (await serverRpc.$call("anonymous:devframe:auth:exchange", {
 			code,
 			ua: describeUA(),
 			origin: location.origin
@@ -2124,12 +2161,9 @@ async function getDevframeRpcClient(options = {}) {
 			async onRequest(req, next, resolve) {
 				await rpcOptions.onRequest?.call(this, req, next, resolve);
 				if (cacheOptions && cacheManager?.validate(req.m)) {
-					const cached = cacheManager.cached(req.m, req.a);
-					if (cached) return resolve(cached);
-					else {
-						const res = await next(req);
-						cacheManager?.apply(req, res);
-					}
+					if (cacheManager.has(req.m, req.a)) return resolve(cacheManager.cached(req.m, req.a));
+					const res = await next(req);
+					cacheManager.apply(req, res);
 				} else await next(req);
 			}
 		},

package/dist/constants.d.mts

@@ -29,5 +29,28 @@ declare const REMOTE_CONNECTION_KEY = "devframe-remote-connection";
  * `consumeOtpFromUrl` client utilities (or `connectDevframe`'s `otpParam`).
  */
 declare const DEVFRAME_OTP_URL_PARAM = "devframe_otp";
+/**
+ * WS upgrade-URL query parameter carrying a previously-issued bearer token.
+ * Set by `createWsRpcChannel` (browser transport) whenever `authToken` is
+ * passed; read at connect time by a host's connect-time trust hook (see
+ * `recipes/interactive-auth`'s `onConnect`) so a returning client can be
+ * trusted before its own `anonymous:devframe:auth` handshake call arrives.
+ */
+declare const DEVFRAME_AUTH_TOKEN_QUERY_PARAM = "devframe_auth_token";
+/**
+ * Prefix that marks an RPC method as callable before a connection is
+ * trusted. This is the *only* rule the pre-trust gate applies — there is no
+ * per-method allowlist. Any handshake method a host adapter needs to reach
+ * before authentication must be named `anonymous:<rest>` (e.g.
+ * `anonymous:devframe:auth`).
+ */
+declare const ANONYMOUS_RPC_PREFIX = "anonymous:";
+/**
+ * Whether `name` is callable before a connection is trusted, i.e. it starts
+ * with {@link ANONYMOUS_RPC_PREFIX}. Used by the resolver gate in
+ * `startHttpAndWs` (via an `authorize` function) and by host adapters that
+ * implement their own transport.
+ */
+declare function isAnonymousRpcMethod(name: string): boolean;
 //#endregion
-export { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DIRNAME, DEVFRAME_DOCK_IMPORTS_FILENAME, DEVFRAME_DOCK_IMPORTS_VIRTUAL_ID, DEVFRAME_MOUNT_PATH, DEVFRAME_MOUNT_PATH_NO_TRAILING_SLASH, DEVFRAME_OTP_URL_PARAM, DEVFRAME_RPC_DUMP_DIRNAME, DEVFRAME_RPC_DUMP_MANIFEST_FILENAME, DEVFRAME_WS_ROUTE, REMOTE_CONNECTION_KEY };
+export { ANONYMOUS_RPC_PREFIX, DEVFRAME_AUTH_TOKEN_QUERY_PARAM, DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DIRNAME, DEVFRAME_DOCK_IMPORTS_FILENAME, DEVFRAME_DOCK_IMPORTS_VIRTUAL_ID, DEVFRAME_MOUNT_PATH, DEVFRAME_MOUNT_PATH_NO_TRAILING_SLASH, DEVFRAME_OTP_URL_PARAM, DEVFRAME_RPC_DUMP_DIRNAME, DEVFRAME_RPC_DUMP_MANIFEST_FILENAME, DEVFRAME_WS_ROUTE, REMOTE_CONNECTION_KEY, isAnonymousRpcMethod };

package/dist/constants.mjs

@@ -29,5 +29,30 @@ const REMOTE_CONNECTION_KEY = "devframe-remote-connection";
 * `consumeOtpFromUrl` client utilities (or `connectDevframe`'s `otpParam`).
 */
 const DEVFRAME_OTP_URL_PARAM = "devframe_otp";
+/**
+* WS upgrade-URL query parameter carrying a previously-issued bearer token.
+* Set by `createWsRpcChannel` (browser transport) whenever `authToken` is
+* passed; read at connect time by a host's connect-time trust hook (see
+* `recipes/interactive-auth`'s `onConnect`) so a returning client can be
+* trusted before its own `anonymous:devframe:auth` handshake call arrives.
+*/
+const DEVFRAME_AUTH_TOKEN_QUERY_PARAM = "devframe_auth_token";
+/**
+* Prefix that marks an RPC method as callable before a connection is
+* trusted. This is the *only* rule the pre-trust gate applies — there is no
+* per-method allowlist. Any handshake method a host adapter needs to reach
+* before authentication must be named `anonymous:<rest>` (e.g.
+* `anonymous:devframe:auth`).
+*/
+const ANONYMOUS_RPC_PREFIX = "anonymous:";
+/**
+* Whether `name` is callable before a connection is trusted, i.e. it starts
+* with {@link ANONYMOUS_RPC_PREFIX}. Used by the resolver gate in
+* `startHttpAndWs` (via an `authorize` function) and by host adapters that
+* implement their own transport.
+*/
+function isAnonymousRpcMethod(name) {
+	return name.startsWith(ANONYMOUS_RPC_PREFIX);
+}
 //#endregion
-export { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DIRNAME, DEVFRAME_DOCK_IMPORTS_FILENAME, DEVFRAME_DOCK_IMPORTS_VIRTUAL_ID, DEVFRAME_MOUNT_PATH, DEVFRAME_MOUNT_PATH_NO_TRAILING_SLASH, DEVFRAME_OTP_URL_PARAM, DEVFRAME_RPC_DUMP_DIRNAME, DEVFRAME_RPC_DUMP_MANIFEST_FILENAME, DEVFRAME_WS_ROUTE, REMOTE_CONNECTION_KEY };
+export { ANONYMOUS_RPC_PREFIX, DEVFRAME_AUTH_TOKEN_QUERY_PARAM, DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DIRNAME, DEVFRAME_DOCK_IMPORTS_FILENAME, DEVFRAME_DOCK_IMPORTS_VIRTUAL_ID, DEVFRAME_MOUNT_PATH, DEVFRAME_MOUNT_PATH_NO_TRAILING_SLASH, DEVFRAME_OTP_URL_PARAM, DEVFRAME_RPC_DUMP_DIRNAME, DEVFRAME_RPC_DUMP_MANIFEST_FILENAME, DEVFRAME_WS_ROUTE, REMOTE_CONNECTION_KEY, isAnonymousRpcMethod };

package/dist/{context-BEVByy_Z.d.mts → context-B_I9fMBc.d.mts}

@@ -1,4 +1,4 @@
-import { L as SharedState, m as DevframeNodeContext } from "./devframe-D-gr9sBx.mjs";
+import { L as SharedState, m as DevframeNodeContext } from "./devframe-DgvncQy2.mjs";
 
 //#region src/node/hub-internals/context.d.ts
 interface InternalAnonymousAuthStorage {

package/dist/{context-3x_bgBgZ.mjs → context-CKJheEtf.mjs}

@@ -1,5 +1,5 @@
-import { t as createStorage } from "./storage-l2ezeend.mjs";
-import { i as randomToken, n as revokeAuthToken, t as revokeActiveConnectionsForToken } from "./revoke-ENfxWkFK.mjs";
+import { t as createStorage } from "./storage-yrUZaiib.mjs";
+import { i as randomToken, n as revokeAuthToken, t as revokeActiveConnectionsForToken } from "./revoke-BtQDKTp7.mjs";
 import { join } from "pathe";
 //#region src/node/hub-internals/context.ts
 const internalContextMap = /* @__PURE__ */ new WeakMap();

package/dist/{dev-BaX8fLH2.mjs → dev-DSxKFn-v.mjs}

@@ -1,12 +1,12 @@
 import { DEVFRAME_CONNECTION_META_FILENAME } from "./constants.mjs";
-import { n as createHostContext, t as createH3DevframeHost } from "./host-h3-C5SZlk03.mjs";
-import { t as startHttpAndWs } from "./server-Dl6TU5LE.mjs";
+import { n as createHostContext, t as createH3DevframeHost } from "./host-h3-Dsf-Tgwx.mjs";
+import { t as startHttpAndWs } from "./server-BdN41ckC.mjs";
 import { n as resolveBasePath, t as normalizeBasePath } from "./_shared-bWRzeSa0.mjs";
-import { t as open } from "./open-Dusa2Zzd.mjs";
+import { t as open } from "./open-Deb5xmIT.mjs";
 import { mountStaticHandler } from "./utils/serve-static.mjs";
 import { resolve } from "pathe";
-import { networkInterfaces } from "node:os";
 import process$1 from "node:process";
+import { networkInterfaces } from "node:os";
 import { H3 } from "h3";
 import { createServer } from "node:net";
 import { joinURL, withBase as withBase$1, withLeadingSlash, withoutLeadingSlash } from "ufo";

package/dist/{devframe-D-gr9sBx.d.mts → devframe-DgvncQy2.d.mts}

@@ -1,5 +1,5 @@
 import { _ as RpcFunctionDefinition } from "./types-DZEx4ffs.mjs";
-import { S as RpcFunctionsCollectorBase } from "./index-CxaPKDXX.mjs";
+import { S as RpcFunctionsCollectorBase } from "./index-Dy6GFDRf.mjs";
 import { t as DevframeNodeRpcSessionMeta } from "./ws-server-Bc2wBHl-.mjs";
 import { CAC } from "cac";
 import { GenericSchema, InferOutput } from "valibot";
@@ -471,9 +471,13 @@ interface DevframeRpcServerFunctions {
    * by the host adapter (e.g. Vite DevTools); the standalone server registers
    * an auto-trust noop when `auth: false`.
    *
+   * Named with the `anonymous:` prefix (see `isAnonymousRpcMethod`) so it is
+   * reachable before the connection is trusted — this is the *only* rule the
+   * pre-trust gate applies, no per-method allowlist.
+   *
    * @internal
    */
-  'devframe:anonymous:auth': (params: {
+  'anonymous:devframe:auth': (params: {
     authToken: string;
     ua: string;
     origin: string;
@@ -485,15 +489,27 @@ interface DevframeRpcServerFunctions {
    * node-issued bearer token, returning the token on success or `null`. The
    * handler is provided by the host adapter on top of `exchangeTempAuthCode`.
    *
+   * Named with the `anonymous:` prefix (see `isAnonymousRpcMethod`) so it is
+   * reachable before the connection is trusted.
+   *
    * @internal
    */
-  'devframe:auth:exchange': (params: {
+  'anonymous:devframe:auth:exchange': (params: {
     code: string;
     ua: string;
     origin: string;
   }) => Promise<{
     authToken: string | null;
   }>;
+  /**
+   * Self-revoke: the caller asks the server to revoke its own bearer token
+   * (if any) and drop to untrusted. Requires an already-trusted caller, so
+   * unlike the two handshake methods above it does **not** carry the
+   * `anonymous:` prefix. Registered by `recipes/interactive-auth`.
+   *
+   * @internal
+   */
+  'devframe:auth:revoke': () => Promise<void>;
   /**
    * Subscribe a client to a shared-state key. Wired by
    * `RpcSharedStateHost`; do not register manually.

package/dist/{dump-DoXkj4ku.mjs → dump-D09PZb7T.mjs}

@@ -5,7 +5,7 @@ import { createHash } from "node:crypto";
 function serialize(o) {
 	return typeof o == "string" ? `'${o}'` : new c().serialize(o);
 }
-const c = /* @__PURE__ */ function() {
+const c = /*@__PURE__*/ function() {
 	class o {
 		#t = /* @__PURE__ */ new Map();
 		compare(t, r) {
@@ -501,14 +501,24 @@ async function getRpcResolvedSetupResult(definition, context) {
 	if (!definition.setup) return {};
 	if (typeof context === "object" && context !== null) {
 		definition.__cache ??= /* @__PURE__ */ new WeakMap();
-		let promise = definition.__cache.get(context);
+		const cache = definition.__cache;
+		let promise = cache.get(context);
 		if (!promise) {
 			promise = Promise.resolve(definition.setup(context));
-			definition.__cache.set(context, promise);
+			promise.catch(() => {
+				if (cache.get(context) === promise) cache.delete(context);
+			});
+			cache.set(context, promise);
 		}
 		return await promise;
 	}
-	definition.__promise ??= Promise.resolve(definition.setup(context));
+	if (!definition.__promise) {
+		const promise = Promise.resolve(definition.setup(context));
+		promise.catch(() => {
+			if (definition.__promise === promise) definition.__promise = void 0;
+		});
+		definition.__promise = promise;
+	}
 	return await definition.__promise;
 }
 async function getRpcHandler(definition, context) {

package/dist/{hash-DFc5WwhO.mjs → hash-PAfnyu2k.mjs}

@@ -2,7 +2,7 @@
 function serialize(o) {
 	return typeof o == "string" ? `'${o}'` : new c().serialize(o);
 }
-const c = /* @__PURE__ */ function() {
+const c = /*@__PURE__*/ function() {
 	class o {
 		#t = /* @__PURE__ */ new Map();
 		compare(t, r) {

package/dist/helpers/vite.d.mts

@@ -1,4 +1,4 @@
-import { r as DevframeDefinition } from "../devframe-D-gr9sBx.mjs";
+import { r as DevframeDefinition } from "../devframe-DgvncQy2.mjs";
 
 //#region src/helpers/vite.d.ts
 interface ViteDevBridgeOptions {

package/dist/helpers/vite.mjs

@@ -1,8 +1,8 @@
 import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_WS_ROUTE } from "../constants.mjs";
-import { a as diagnostics } from "../storage-l2ezeend.mjs";
+import { a as diagnostics } from "../storage-yrUZaiib.mjs";
 import { n as resolveBasePath, t as normalizeBasePath } from "../_shared-bWRzeSa0.mjs";
 import { serveStaticNodeMiddleware } from "../utils/serve-static.mjs";
-import { n as resolveDevServerPort, t as createDevServer } from "../dev-BaX8fLH2.mjs";
+import { n as resolveDevServerPort, t as createDevServer } from "../dev-DSxKFn-v.mjs";
 import { resolve } from "pathe";
 //#region src/helpers/vite.ts
 /**

package/dist/{host-h3-C5SZlk03.mjs → host-h3-Dsf-Tgwx.mjs}

@@ -2,14 +2,14 @@ import { t as devframeReporter } from "./diagnostics-reporter-CsIG85Q5.mjs";
 import { t as diagnostics } from "./diagnostics-BXwBQmoN.mjs";
 import { RpcFunctionsCollectorBase } from "./rpc/index.mjs";
 import { defineRpcFunction } from "./index.mjs";
-import { a as diagnostics$1, i as createEventEmitter, n as createSharedState, r as nanoid, t as createStorage } from "./storage-l2ezeend.mjs";
+import { a as diagnostics$1, i as createEventEmitter, n as createSharedState, r as nanoid, t as createStorage } from "./storage-yrUZaiib.mjs";
 import { defineDiagnostics } from "nostics";
 import { isatty } from "node:tty";
 import { formatWithOptions, inspect } from "node:util";
 import { existsSync } from "node:fs";
 import { join } from "pathe";
-import { homedir } from "node:os";
 import process$1 from "node:process";
+import { homedir } from "node:os";
 //#region src/node/host-agent.ts
 /**
 * Framework-neutral host aggregating the agent-exposed surface of a
@@ -203,11 +203,18 @@ var DevframeDiagnosticsHost = class {
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/obug@2.1.1/node_modules/obug/dist/core.js
+//#region ../../node_modules/.pnpm/obug@2.1.3/node_modules/obug/dist/core.js
+/**
+* Coerce `value`.
+*/
 function coerce(value) {
 	if (value instanceof Error) return value.stack || value.message;
 	return value;
 }
+/**
+* Selects a color for a debug namespace
+* @return An ANSI color code for the given namespace
+*/
 function selectColor(colors, namespace) {
 	let hash = 0;
 	for (let i = 0; i < namespace.length; i++) {
@@ -216,6 +223,10 @@ function selectColor(colors, namespace) {
 	}
 	return colors[Math.abs(hash) % colors.length];
 }
+/**
+* Checks if the given string matches a namespace template, honoring
+* asterisks as wildcards.
+*/
 function matchesTemplate(search, template) {
 	let searchIndex = 0;
 	let templateIndex = 0;
@@ -270,8 +281,8 @@ function createDebug$1(namespace, options) {
 		options.formatArgs.call(debug, diff, args);
 		debug.log(...args);
 	};
-	debug.extend = function(namespace$1, delimiter = ":") {
-		return createDebug$1(this.namespace + delimiter + namespace$1, {
+	debug.extend = function(namespace, delimiter = ":") {
+		return createDebug$1(this.namespace + delimiter + namespace, {
 			useColors: this.useColors,
 			color: this.color,
 			formatArgs: this.formatArgs,
@@ -302,21 +313,24 @@ function createDebug$1(namespace, options) {
 }
 let names = [];
 let skips = [];
-function enable(namespaces$1) {
-	globalNamespaces = namespaces$1;
+function enable(namespaces) {
+	globalNamespaces = namespaces;
 	names = [];
 	skips = [];
 	const split = globalNamespaces.trim().replace(/\s+/g, ",").split(",").filter(Boolean);
 	for (const ns of split) if (ns[0] === "-") skips.push(ns.slice(1));
 	else names.push(ns);
 }
+/**
+* Returns true if the given mode name is enabled, false otherwise.
+*/
 function enabled(name) {
 	for (const skip of skips) if (matchesTemplate(name, skip)) return false;
 	for (const ns of names) if (matchesTemplate(name, ns)) return true;
 	return false;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/obug@2.1.1/node_modules/obug/dist/node.js
+//#region ../../node_modules/.pnpm/obug@2.1.3/node_modules/obug/dist/node.js
 const colors = process.stderr.getColorDepth && process.stderr.getColorDepth() > 2 ? [
 	20,
 	21,
@@ -412,7 +426,10 @@ const inspectOpts = Object.keys(process.env).filter((key) => /^debug_/i.test(key
 	else value = Number(value);
 	obj[prop] = value;
 	return obj;
-}, {});
+}, Object.create(null));
+/**
+* Is stdout a TTY? Colored output is enabled when `true`.
+*/
 function useColors() {
 	return "colors" in inspectOpts ? Boolean(inspectOpts.colors) : isatty(process.stderr.fd);
 }
@@ -420,9 +437,12 @@ function getDate() {
 	if (inspectOpts.hideDate) return "";
 	return `${(/* @__PURE__ */ new Date()).toISOString()} `;
 }
+/**
+* Adds ANSI color escape codes if enabled.
+*/
 function formatArgs(diff, args) {
-	const { namespace: name, useColors: useColors$1 } = this;
-	if (useColors$1) {
+	const { namespace: name, useColors } = this;
+	if (useColors) {
 		const c = this.color;
 		const colorCode = `\u001B[3${c < 8 ? c : `8;5;${c}`}`;
 		const prefix = `  ${colorCode};1m${name} \u001B[0m`;
@@ -437,10 +457,16 @@ const defaultOptions = {
 	useColors: useColors(),
 	formatArgs,
 	formatters: {
+		/**
+		* Map %o to `util.inspect()`, all on a single line.
+		*/
 		o(v) {
 			this.inspectOpts.colors = this.useColors;
 			return inspect(v, this.inspectOpts).split("\n").map((str) => str.trim()).join(" ");
 		},
+		/**
+		* Map %O to `util.inspect()`, allowing multiple lines if needed.
+		*/
 		O(v) {
 			this.inspectOpts.colors = this.useColors;
 			return inspect(v, this.inspectOpts);