@mcp-b/do-runtime 0.6.0 → 0.6.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.6.1
+
+### Patch Changes
+
+- 55bae81: Export the shared in-memory hibernation mirror and browser WebSocket-upgrade adapter so embedders can reuse the reference host behavior instead of copying example shims.
+
 ## 0.6.0
 
 ### Minor Changes

package/README.md

@@ -241,6 +241,12 @@ registry is populated before the constructor, so SDKs can lazily rebuild their
 connection wrappers without another upgrade or connect hook. Closed sockets are
 removed before `webSocketClose` runs.
 
+`HibernationMirror` is the package's in-memory reference implementation. Seed a
+replacement mirror with the prior socket snapshot and auto-response pair, then
+pass that mirror to `ports.hibernation` and its `snapshot()` to `webSockets`.
+Browser hosts can install the remaining Request/Response upgrade accommodation
+from `@mcp-b/do-runtime/browser`; the runtime itself supplies `WebSocketPair`.
+
 `container.quiescence()` reports armed timers, pending `waitUntil` work, input
 lock state, and output-gate breakage without waiting. `drainWaitUntil()` is for
 shutdown and intentionally never settles while a live interval remains armed.

package/dist/browser.js

@@ -0,0 +1,55 @@
+import { o as markWebSocketUsed } from "./chunks/web-socket-W63BdFn5.js";
+//#region src/browser.ts
+var upgradeRequests = /* @__PURE__ */ new WeakSet();
+var installed = false;
+/** Install the Request/Response half of browser-hosted WebSocket upgrades. */
+function installWebSocketUpgradeGlobals() {
+	if (installed) return;
+	installed = true;
+	const NativeRequest = globalThis.Request;
+	class WorkersRequest extends NativeRequest {
+		constructor(input, init) {
+			const upgrade = input instanceof NativeRequest && isWebSocketUpgrade(input);
+			super(input, init);
+			if (upgrade) withWebSocketUpgrade(this);
+		}
+	}
+	globalThis.Request = WorkersRequest;
+	const NativeResponse = globalThis.Response;
+	class WorkersResponse extends NativeResponse {
+		constructor(body, init = {}) {
+			const upgrade = init.status === 101;
+			const { webSocket, ...nativeInit } = init;
+			super(body, upgrade ? {
+				...nativeInit,
+				status: 200
+			} : nativeInit);
+			if (upgrade) Object.defineProperty(this, "status", { value: 101 });
+			if (webSocket !== void 0) {
+				markWebSocketUsed(webSocket);
+				Object.defineProperty(this, "webSocket", { value: webSocket });
+			}
+		}
+	}
+	globalThis.Response = WorkersResponse;
+}
+function upgradeWebSocket(response) {
+	return response.webSocket;
+}
+/** Preserve the upgrade signal across browser `Request.clone()` calls. */
+function withWebSocketUpgrade(request) {
+	if (upgradeRequests.has(request)) return request;
+	upgradeRequests.add(request);
+	const get = request.headers.get.bind(request.headers);
+	Object.defineProperty(request.headers, "get", { value: (name) => name.toLowerCase() === "upgrade" ? "websocket" : get(name) });
+	const clone = request.clone.bind(request);
+	Object.defineProperty(request, "clone", { value: () => withWebSocketUpgrade(clone()) });
+	return request;
+}
+function isWebSocketUpgrade(request) {
+	return upgradeRequests.has(request) || request.headers.get("Upgrade")?.toLowerCase() === "websocket";
+}
+//#endregion
+export { installWebSocketUpgradeGlobals, upgradeWebSocket, withWebSocketUpgrade };
+
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","names":[],"sources":["../src/browser.ts"],"sourcesContent":["import { markWebSocketUsed, type RawWebSocket } from \"./api/web-socket\";\n\nexport type UpgradeWebSocket = EventTarget &\n  RawWebSocket & {\n    accept(): void;\n    readonly readyState: number;\n  };\n\ntype UpgradeResponseInit = Omit<ResponseInit, \"webSocket\"> & {\n  webSocket?: UpgradeWebSocket;\n};\ntype UpgradeResponse = Response & { readonly webSocket?: UpgradeWebSocket };\ntype CloneableRequest = { readonly headers: Headers; clone(): CloneableRequest };\n\nconst upgradeRequests = new WeakSet<CloneableRequest>();\nlet installed = false;\n\n/** Install the Request/Response half of browser-hosted WebSocket upgrades. */\nexport function installWebSocketUpgradeGlobals(): void {\n  if (installed) return;\n  installed = true;\n\n  const NativeRequest = globalThis.Request;\n  class WorkersRequest extends NativeRequest {\n    constructor(input: RequestInfo | URL, init?: RequestInit) {\n      const upgrade = input instanceof NativeRequest && isWebSocketUpgrade(input);\n      super(input, init);\n      if (upgrade) withWebSocketUpgrade(this);\n    }\n  }\n  globalThis.Request = WorkersRequest as typeof Request;\n\n  const NativeResponse = globalThis.Response;\n  class WorkersResponse extends NativeResponse {\n    constructor(body?: BodyInit | null, init: UpgradeResponseInit = {}) {\n      const upgrade = init.status === 101;\n      const { webSocket, ...nativeInit } = init;\n      super(body, upgrade ? { ...nativeInit, status: 200 } : nativeInit);\n      if (upgrade) Object.defineProperty(this, \"status\", { value: 101 });\n      if (webSocket !== undefined) {\n        markWebSocketUsed(webSocket);\n        Object.defineProperty(this, \"webSocket\", { value: webSocket });\n      }\n    }\n  }\n  globalThis.Response = WorkersResponse as typeof Response;\n}\n\nexport function upgradeWebSocket(response: Response): UpgradeWebSocket | undefined {\n  return (response as UpgradeResponse).webSocket;\n}\n\n/** Preserve the upgrade signal across browser `Request.clone()` calls. */\nexport function withWebSocketUpgrade<T extends CloneableRequest>(request: T): T {\n  if (upgradeRequests.has(request)) return request;\n  upgradeRequests.add(request);\n  const get = request.headers.get.bind(request.headers);\n  Object.defineProperty(request.headers, \"get\", {\n    value: (name: string): string | null =>\n      name.toLowerCase() === \"upgrade\" ? \"websocket\" : get(name),\n  });\n  const clone = request.clone.bind(request);\n  Object.defineProperty(request, \"clone\", {\n    value: (): CloneableRequest => withWebSocketUpgrade(clone()),\n  });\n  return request;\n}\n\nfunction isWebSocketUpgrade(request: Request): boolean {\n  return (\n    upgradeRequests.has(request) || request.headers.get(\"Upgrade\")?.toLowerCase() === \"websocket\"\n  );\n}\n"],"mappings":";;AAcA,IAAM,kCAAkB,IAAI,QAA0B;AACtD,IAAI,YAAY;;AAGhB,SAAgB,iCAAuC;CACrD,IAAI,WAAW;CACf,YAAY;CAEZ,MAAM,gBAAgB,WAAW;CACjC,MAAM,uBAAuB,cAAc;EACzC,YAAY,OAA0B,MAAoB;GACxD,MAAM,UAAU,iBAAiB,iBAAiB,mBAAmB,KAAK;GAC1E,MAAM,OAAO,IAAI;GACjB,IAAI,SAAS,qBAAqB,IAAI;EACxC;CACF;CACA,WAAW,UAAU;CAErB,MAAM,iBAAiB,WAAW;CAClC,MAAM,wBAAwB,eAAe;EAC3C,YAAY,MAAwB,OAA4B,CAAC,GAAG;GAClE,MAAM,UAAU,KAAK,WAAW;GAChC,MAAM,EAAE,WAAW,GAAG,eAAe;GACrC,MAAM,MAAM,UAAU;IAAE,GAAG;IAAY,QAAQ;GAAI,IAAI,UAAU;GACjE,IAAI,SAAS,OAAO,eAAe,MAAM,UAAU,EAAE,OAAO,IAAI,CAAC;GACjE,IAAI,cAAc,KAAA,GAAW;IAC3B,kBAAkB,SAAS;IAC3B,OAAO,eAAe,MAAM,aAAa,EAAE,OAAO,UAAU,CAAC;GAC/D;EACF;CACF;CACA,WAAW,WAAW;AACxB;AAEA,SAAgB,iBAAiB,UAAkD;CACjF,OAAQ,SAA6B;AACvC;;AAGA,SAAgB,qBAAiD,SAAe;CAC9E,IAAI,gBAAgB,IAAI,OAAO,GAAG,OAAO;CACzC,gBAAgB,IAAI,OAAO;CAC3B,MAAM,MAAM,QAAQ,QAAQ,IAAI,KAAK,QAAQ,OAAO;CACpD,OAAO,eAAe,QAAQ,SAAS,OAAO,EAC5C,QAAQ,SACN,KAAK,YAAY,MAAM,YAAY,cAAc,IAAI,IAAI,EAC7D,CAAC;CACD,MAAM,QAAQ,QAAQ,MAAM,KAAK,OAAO;CACxC,OAAO,eAAe,SAAS,SAAS,EACtC,aAA+B,qBAAqB,MAAM,CAAC,EAC7D,CAAC;CACD,OAAO;AACT;AAEA,SAAS,mBAAmB,SAA2B;CACrD,OACE,gBAAgB,IAAI,OAAO,KAAK,QAAQ,QAAQ,IAAI,SAAS,CAAC,EAAE,YAAY,MAAM;AAEtF"}