@jamesmddoyle/phantom 0.1.0

package/dist/ws.d.ts

@@ -0,0 +1,16 @@
+import type { Socket } from "node:net";
+import type { MockRequest } from "./parser.ts";
+export declare function handleWebSocketHandshake(socket: Socket, request: MockRequest): void;
+/**
+ * Wraps a string in a WebSocket text frame (RFC 6455).
+ */
+export declare function encodeWsFrame(dataString: string): Buffer;
+/**
+ * Broadcasts a message to all connected WebSocket clients.
+ */
+export declare function broadcast(clients: Map<string, Socket>, message: any): void;
+/**
+ * Starts a heartbeat interval to keep WebSocket connections alive.
+ */
+export declare function startHeartbeat(clients: Map<string, Socket>): void;
+//# sourceMappingURL=ws.d.ts.map

package/dist/ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../ws.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,QAyB5E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAuBxD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,QAKnE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,QAM1D"}

package/dist/ws.js

@@ -0,0 +1,68 @@
+import { createHash } from "node:crypto";
+export function handleWebSocketHandshake(socket, request) {
+    const key = request.headers["sec-websocket-key"];
+    if (!key) {
+        socket.write("HTTP/1.1 400 Bad Request\r\n\r\n");
+        socket.destroy();
+        return;
+    }
+    const MAGIC_STRING = "258EAFA5-E914-47DA-95CA-C5AB0DC85B11";
+    const acceptKey = createHash("sha1")
+        .update(key + MAGIC_STRING)
+        .digest("base64");
+    const response = [
+        "HTTP/1.1 101 Switching Protocols",
+        "Upgrade: websocket",
+        "Connection: Upgrade",
+        `Sec-WebSocket-Accept: ${acceptKey}`,
+        "", // Empty line boundary
+        "",
+    ].join("\r\n");
+    socket.write(response);
+}
+/**
+ * Wraps a string in a WebSocket text frame (RFC 6455).
+ */
+export function encodeWsFrame(dataString) {
+    const payload = Buffer.from(dataString, "utf-8");
+    const length = payload.length;
+    let header;
+    if (length <= 125) {
+        header = Buffer.alloc(2);
+        header[0] = 0x81; // 10000001
+        header[1] = length;
+    }
+    else if (length <= 65535) {
+        header = Buffer.alloc(4);
+        header[0] = 0x81;
+        header[1] = 126;
+        header.writeUInt16BE(length, 2);
+    }
+    else {
+        header = Buffer.alloc(10);
+        header[0] = 0x81;
+        header[1] = 127;
+        header.writeBigUInt64BE(BigInt(length), 2);
+    }
+    return Buffer.concat([header, payload]);
+}
+/**
+ * Broadcasts a message to all connected WebSocket clients.
+ */
+export function broadcast(clients, message) {
+    const frame = encodeWsFrame(JSON.stringify(message));
+    for (const socket of clients.values()) {
+        socket.write(frame);
+    }
+}
+/**
+ * Starts a heartbeat interval to keep WebSocket connections alive.
+ */
+export function startHeartbeat(clients) {
+    setInterval(() => {
+        if (clients.size === 0)
+            return;
+        broadcast(clients, { type: "PING", timestamp: Date.now() });
+    }, 30000);
+}
+//# sourceMappingURL=ws.js.map

package/dist/ws.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.js","sourceRoot":"","sources":["../ws.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,wBAAwB,CAAC,MAAc,EAAE,OAAoB;IAC3E,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEjD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACjD,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG,sCAAsC,CAAC;IAE5D,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC;SACjC,MAAM,CAAC,GAAG,GAAG,YAAY,CAAC;SAC1B,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEpB,MAAM,QAAQ,GAAG;QACf,kCAAkC;QAClC,oBAAoB;QACpB,qBAAqB;QACrB,yBAAyB,SAAS,EAAE;QACpC,EAAE,EAAE,sBAAsB;QAC1B,EAAE;KACH,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEf,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAE9B,IAAI,MAAc,CAAC;IAEnB,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;QAClB,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,WAAW;QAC7B,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;IACrB,CAAC;SAAM,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QAC3B,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QACjB,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QAChB,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1B,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QACjB,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QAChB,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,OAA4B,EAAE,OAAY;IAClE,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACrD,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAA4B;IACzD,WAAW,CAAC,GAAG,EAAE;QACf,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAE/B,SAAS,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC9D,CAAC,EAAE,KAAK,CAAC,CAAC;AACZ,CAAC"}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@jamesmddoyle/phantom",
+  "version": "0.1.0",
+  "description": "API mocker and traffic inspector with a built-in dashboard.",
+  "author": "James Doyle",
+  "license": "MIT",
+  "bin": {
+    "phantom": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "scripts": {
+    "build": "tsc && cp package.json ./dist/ && cp -r ../dashboard/build ./dist/dashboard-ui",
+    "dev": "node --watch --experimental-strip-types index.ts",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "dependencies": {
+    "cac": "^7.0.0"
+  }
+}