introduce abstraction for websocket

package.json

@@ -48,6 +48,7 @@
     "@types/node": "^22.2.0",
     "@types/randombytes": "^2.0.3",
     "@types/react": "^18.3.3",
+    "@types/ws": "^8.5.12",
     "@typescript-eslint/typescript-estree": "^8.0.1",
     "@vitest/browser": "^2.0.5",
     "@vitest/coverage-v8": "^2.0.5",
@@ -93,7 +94,8 @@
     "prolly-trees": "^1.0.4",
     "randombytes": "^2.1.0",
     "react": "^18.3.1",
-    "uuidv7": "^1.0.0"
+    "uuidv7": "^1.0.0",
+    "ws": "^8.18.0"
   },
   "bundle-phobia": {
     "max-size": "390kB",

src/runtime/node-sys-container.ts

@@ -5,6 +5,7 @@ import * as path from "path";
 import * as os from "os";
 import * as url from "url";
 import { toArrayBuffer } from "./gateways/file/utils.js";
+import WebSocket from "ws";
 
 export async function createNodeSysContainer(): Promise<NodeMap> {
   // const nodePath = "node:path";
@@ -30,5 +31,8 @@ export async function createNodeSysContainer(): Promise<NodeMap> {
       return toArrayBuffer(rs);
     },
     writefile: fs.writeFile as NodeMap["writefile"],
+    websocket: () => {
+      return WebSocket;
+    },
   };
 }

src/runtime/sys-container.ts

@@ -22,6 +22,7 @@
   join: (...args: string[]) => string;
   dirname: (path: string) => string;
   homedir: () => string;
+  websocket: () => any;
   // fileURLToPath: (url: string | URL) => string;
   // assert: (condition: unknown, message?: string | Error) => void;
 }
@@ -90,6 +91,7 @@
     unlink: () => Promise.reject(new Error("SysContainer:unlink is not available in seeded state")),
     writefile: () => Promise.reject(new Error("SysContainer:writefile is not available in seeded state")),
     stat: () => Promise.reject(new Error("SysContainer:stat is not available in seeded state")),
+    websocket: () => Promise.reject(new Error("SysContainer:websocket is not available in seeded state")),
   };
 
   // readonly id = uuidv4();
@@ -190,6 +192,11 @@
     return throwFalsy(this.freight).homedir();
   };
 
+  websocket = () => {
+    this.logSeeded("websocket");
+    return throwFalsy(this.freight).websocket();
+  };
+
   logSeeded(method: string) {
     if (this.freight.state === "seeded") {
       const err = new Error();