@jamesmddoyle/phantom 0.1.0

package/dist/index.js

@@ -0,0 +1,172 @@
+#!/usr/bin/env node
+import * as net from "node:net";
+import { styleText } from "node:util";
+import crypto from "node:crypto";
+import { isRequestComplete, isWebSocketUpgrade, parseRequest } from "./parser.js";
+import { sendCorsPreflightResponse, sendResponse } from "./responder.js";
+import { handleRouting } from "./router.js";
+import { watchConfig, setConfigPath, reloadRoutes } from "./config.js";
+import { broadcast, encodeWsFrame, handleWebSocketHandshake, startHeartbeat } from "./ws.js";
+import { parseCLI } from "./cli.js";
+import { handleStaticFile } from "./static.js";
+import { readFileSync } from "node:fs";
+const pkg = JSON.parse(readFileSync(new URL("./package.json", import.meta.url), "utf-8"));
+export const VERSION = pkg.version;
+const options = parseCLI();
+setConfigPath(options.config);
+reloadRoutes();
+const PORT = options.port;
+const server = net.createServer();
+const socketManager = {
+    active: new Set(),
+    add(socket) {
+        this.active.add(socket);
+        console.log(styleText("dim", `Client connected. Total active: ${this.active.size}`));
+    },
+    remove(socket) {
+        this.active.delete(socket);
+        console.log(styleText("dim", `Client disconnected. Total active: ${this.active.size}`));
+    },
+    destroyAll() {
+        for (const socket of this.active) {
+            socket.destroy();
+        }
+    },
+};
+export const wsClients = new Map();
+const requestHistory = [];
+server.on("connection", (socket) => {
+    socketManager.add(socket);
+    const socketID = `${socket.remoteAddress}:${socket.remotePort}`;
+    let requestBuffer = Buffer.alloc(0);
+    // listen to raw data
+    socket.on("data", (chunk) => {
+        // if its a websocket connection, ignore the http parser
+        if (wsClients.has(socketID))
+            return;
+        requestBuffer = Buffer.concat([requestBuffer, chunk]);
+        console.log(styleText("blue", `[Parser] Received ${chunk.length} bytes. Total: ${requestBuffer.length}`));
+        if (isRequestComplete(requestBuffer)) {
+            const request = parseRequest(requestBuffer);
+            if (request) {
+                if (request.method === "OPTIONS") {
+                    console.log(styleText("dim", `[CORS] Preflight ${request.path}`));
+                    sendCorsPreflightResponse(socket);
+                    requestBuffer = Buffer.alloc(0);
+                    return;
+                }
+                if (isWebSocketUpgrade(request.headers)) {
+                    console.log(styleText(["magenta", "bold"], "[WebSocket] Handshake successful"));
+                    handleWebSocketHandshake(socket, request);
+                    wsClients.set(socketID, socket);
+                    if (requestHistory.length > 0) {
+                        socket.write(encodeWsFrame(JSON.stringify({
+                            type: "HISTORY",
+                            data: requestHistory,
+                        })));
+                    }
+                }
+                else {
+                    const start = Date.now();
+                    const response = handleRouting(request);
+                    request.params = response.params;
+                    const isAdmin = request.path.startsWith("/_admin/");
+                    let logEntry = null;
+                    if (isAdmin && request.path === "/_admin/clear" && request.method === "POST") {
+                        requestHistory.length = 0;
+                        console.log(styleText("yellow", "[Admin] Request history cleared"));
+                    }
+                    const methodColor = request.method === "GET" ? "blue" : "green";
+                    console.log(styleText("bold", `\n[Router] `) + styleText(methodColor, request.method) + " " + styleText("white", request.path));
+                    if (Object.keys(request.params).length > 0) {
+                        console.log(styleText("dim", "  params:"), request.params);
+                    }
+                    const delay = options.delay ?? response.delay ?? 0;
+                    if (delay > 0) {
+                        console.log(styleText("yellow", `   ↳ delaying response by ${delay}ms`));
+                    }
+                    setTimeout(async () => {
+                        if (socket.destroyed)
+                            return;
+                        if (response.status === 404) {
+                            const staticFile = await handleStaticFile(request.path);
+                            if (staticFile) {
+                                sendResponse(socket, 200, "OK", staticFile.body, staticFile.headers);
+                                return;
+                            }
+                        }
+                        const errorRate = options.errorRate ?? response.errorRate ?? 0;
+                        const shouldError = Math.random() < errorRate;
+                        if (!isAdmin) {
+                            logEntry = {
+                                id: crypto.randomUUID(),
+                                method: request.method,
+                                path: request.path,
+                                timestamp: start,
+                                headers: request.headers,
+                                body: request.body.toString("utf-8"),
+                                status: shouldError ? 500 : response.status,
+                                duration: Date.now() - start,
+                                responseBody: shouldError ? { error: "Artificial failure hit!" } : response.body,
+                            };
+                            requestHistory.push(logEntry);
+                            if (requestHistory.length > 100)
+                                requestHistory.shift();
+                            broadcast(wsClients, logEntry);
+                            console.log(styleText("magenta", `   ↳ broadcasted with ${logEntry.duration}ms latency`));
+                        }
+                        if (shouldError) {
+                            console.log(styleText("red", "   ↳ Artificial failure hit!"));
+                            sendResponse(socket, 500, "Internal Server Error", {
+                                error: "Artificial failure hit!",
+                            });
+                            return;
+                        }
+                        sendResponse(socket, response.status, response.message, response.body, response.headers);
+                    }, delay);
+                }
+                requestBuffer = Buffer.alloc(0);
+            }
+        }
+    });
+    socket.on("close", () => {
+        socketManager.remove(socket);
+        wsClients.delete(socketID);
+    });
+    socket.on("error", (error) => {
+        if ("code" in error && error.code === "ECONNRESET")
+            return;
+        console.error(styleText("red", `Socket error: ${error.message}`));
+        socketManager.remove(socket);
+    });
+});
+watchConfig(() => {
+    broadcast(wsClients, { type: "CONFIG_UPDATED" });
+});
+startHeartbeat(wsClients);
+server.listen(PORT, () => {
+    console.clear();
+    const brand = styleText(["bgCyan", "black", "bold"], " PHANTOM ");
+    const portLabel = styleText("cyan", "port");
+    const envLabel = styleText("cyan", "env");
+    const arrow = styleText("magenta", "→");
+    console.log(`
+  ${brand} ${styleText("dim", `v${VERSION}`)}
+
+  ${portLabel}  ${styleText("bold", PORT.toString())}
+  ${envLabel}  ${styleText("bold", "development")}
+
+  ${arrow} ${styleText("bold", "ready")}
+  `);
+});
+function shutdown() {
+    console.log(styleText("yellow", "\nShutting down Phantom..."));
+    server.close(() => {
+        console.log(styleText("green", "Server stopped"));
+        process.exit(0);
+    });
+    socketManager.destroyAll();
+}
+process.on("SIGINT", shutdown);
+process.on("SIGTERM", shutdown);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}

package/dist/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "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"
+  }
+}

package/dist/parser.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Checks if the full HTTP headers have been received.
+ */
+export declare function isHeaderComplete(buffer: Buffer): boolean;
+/**
+ * Splits a raw request buffer into its header string and body buffer.
+ * Returns null if the boundary isn't found.
+ */
+export declare function splitRequest(buffer: Buffer): {
+    headers: string;
+    body: Buffer<ArrayBufferLike>;
+} | null;
+/**
+ * Parses the first line of a HTTP request.
+ */
+export declare function parseRequestLine(headerString: string): {
+    method: string;
+    path: string;
+    version: string;
+} | null;
+/**
+ * Parses HTTP headers into a key-value Record.
+ */
+export declare function parseHeaders(headerString: string): Record<string, string>;
+export interface MockRequest {
+    method: string;
+    path: string;
+    version: string;
+    headers: Record<string, string>;
+    body: Buffer;
+    params: Record<string, string>;
+}
+/**
+ * Parses a raw TCP byte stream into a structured HTTP request object
+ */
+export declare function parseRequest(buffer: Buffer): MockRequest | null;
+/**
+ * Determines if the entire HTTP request has been received.
+ */
+export declare function isRequestComplete(buffer: Buffer): boolean;
+/**
+ * Checks if the request headers indicate a WebSocket upgrade attempt.
+ */
+export declare function isWebSocketUpgrade(headers: Record<string, string>): boolean;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM;;;SAQ1C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM;;;;SAkBpD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,0BAoBhD;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA2B/D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAsBzD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAK3E"}

package/dist/parser.js

@@ -0,0 +1,143 @@
+/**
+ * Checks if the full HTTP headers have been received.
+ */
+export function isHeaderComplete(buffer) {
+    return buffer.includes("\r\n\r\n");
+}
+/**
+ * Splits a raw request buffer into its header string and body buffer.
+ * Returns null if the boundary isn't found.
+ */
+export function splitRequest(buffer) {
+    const boundaryIndex = buffer.indexOf("\r\n\r\n");
+    if (boundaryIndex === -1)
+        return null;
+    const headers = buffer.subarray(0, boundaryIndex).toString("utf-8");
+    const body = buffer.subarray(boundaryIndex + 4);
+    return { headers, body };
+}
+/**
+ * Parses the first line of a HTTP request.
+ */
+export function parseRequestLine(headerString) {
+    const first = headerString.split("\r\n")[0];
+    if (!first)
+        return null;
+    const parts = first.split(" ");
+    if (parts.length !== 3)
+        return null;
+    const [method, path, version] = parts;
+    if (!method || !path || !version) {
+        return null;
+    }
+    return {
+        method: method.toUpperCase(),
+        path,
+        version,
+    };
+}
+/**
+ * Parses HTTP headers into a key-value Record.
+ */
+export function parseHeaders(headerString) {
+    const headers = {};
+    const lines = headerString.split("\r\n");
+    // skip first line
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (!line)
+            continue;
+        const colonIndex = line.indexOf(":");
+        if (colonIndex === -1)
+            continue;
+        const key = line.slice(0, colonIndex).trim().toLowerCase();
+        const value = line.slice(colonIndex + 1).trim();
+        if (key) {
+            headers[key] = value;
+        }
+    }
+    return headers;
+}
+/**
+ * Parses a raw TCP byte stream into a structured HTTP request object
+ */
+export function parseRequest(buffer) {
+    const parts = splitRequest(buffer);
+    if (!parts)
+        return null;
+    const requestLine = parseRequestLine(parts.headers);
+    if (!requestLine)
+        return null;
+    const headers = parseHeaders(parts.headers);
+    const transferEncoding = headers["transfer-encoding"]?.toLowerCase();
+    let body = parts.body;
+    if (transferEncoding === "chunked") {
+        body = decodeChunkedBody(parts.body);
+    }
+    else if (headers["content-length"]) {
+        const expectedLength = parseInt(headers["content-length"], 10);
+        body = parts.body.subarray(0, expectedLength);
+    }
+    return {
+        method: requestLine.method || "UNKNOWN",
+        path: requestLine.path,
+        version: requestLine.version,
+        headers,
+        body,
+        params: {},
+    };
+}
+/**
+ * Determines if the entire HTTP request has been received.
+ */
+export function isRequestComplete(buffer) {
+    if (!isHeaderComplete(buffer))
+        return false;
+    const parts = splitRequest(buffer);
+    if (!parts)
+        return false;
+    const headers = parseHeaders(parts.headers);
+    const transferEncoding = headers["transfer-encoding"]?.toLowerCase();
+    const contentLength = headers["content-length"];
+    if (transferEncoding === "chunked") {
+        // A chunked stream ends with "0\r\n\r\n"
+        return parts.body.toString("utf-8").endsWith("0\r\n\r\n");
+    }
+    // if no content-length header, assume no body
+    if (contentLength) {
+        const expectedLength = parseInt(contentLength, 10);
+        return parts.body.length >= expectedLength;
+    }
+    return true;
+}
+/**
+ * Checks if the request headers indicate a WebSocket upgrade attempt.
+ */
+export function isWebSocketUpgrade(headers) {
+    const upgrade = headers["upgrade"]?.toLowerCase();
+    const connection = headers["connection"]?.toLowerCase();
+    return upgrade === "websocket" && connection?.includes("upgrade") === true;
+}
+function decodeChunkedBody(buffer) {
+    let offset = 0;
+    const chunks = [];
+    while (offset < buffer.length) {
+        const lineEnd = buffer.indexOf("\r\n", offset);
+        if (lineEnd === -1)
+            break;
+        const sizeLine = buffer.subarray(offset, lineEnd).toString("utf-8");
+        const sizeString = sizeLine.split(";")[0] || "";
+        const size = parseInt(sizeString, 16);
+        if (isNaN(size))
+            break;
+        if (size === 0)
+            break;
+        // the actual data starts 2 bytes AFTER the size line (skipping the \r\n).
+        const chunkStart = lineEnd + 2;
+        const chunkEnd = chunkStart + size;
+        chunks.push(buffer.subarray(chunkStart, chunkEnd));
+        offset = chunkEnd + 2;
+    }
+    return Buffer.concat(chunks);
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACjD,IAAI,aAAa,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtC,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;IAEhD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,YAAoB;IACnD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC;IAEtC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE;QAC5B,IAAI;QACJ,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,YAAoB;IAC/C,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAEzC,kBAAkB;IAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,UAAU,KAAK,CAAC,CAAC;YAAE,SAAS;QAEhC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEhD,IAAI,GAAG,EAAE,CAAC;YACR,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAWD;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAE9B,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,CAAC,EAAE,WAAW,EAAE,CAAC;IAErE,IAAI,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IAEtB,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACnC,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;SAAM,IAAI,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACrC,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/D,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IAChD,CAAC;IAED,OAAO;QACL,MAAM,EAAE,WAAW,CAAC,MAAM,IAAI,SAAS;QACvC,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,OAAO;QACP,IAAI;QACJ,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAE5C,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEzB,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,CAAC,EAAE,WAAW,EAAE,CAAC;IACrE,MAAM,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEhD,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACnC,yCAAyC;QACzC,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC5D,CAAC;IAED,8CAA8C;IAC9C,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,cAAc,GAAG,QAAQ,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QACnD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,cAAc,CAAC;IAC7C,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA+B;IAChE,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAClD,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAExD,OAAO,OAAO,KAAK,WAAW,IAAI,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;AAC7E,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAc;IACvC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,OAAO,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/C,IAAI,OAAO,KAAK,CAAC,CAAC;YAAE,MAAM;QAE1B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACpE,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAEtC,IAAI,KAAK,CAAC,IAAI,CAAC;YAAE,MAAM;QACvB,IAAI,IAAI,KAAK,CAAC;YAAE,MAAM;QAEtB,0EAA0E;QAC1E,MAAM,UAAU,GAAG,OAAO,GAAG,CAAC,CAAC;QAC/B,MAAM,QAAQ,GAAG,UAAU,GAAG,IAAI,CAAC;QAEnC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;QACnD,MAAM,GAAG,QAAQ,GAAG,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/responder.d.ts

@@ -0,0 +1,14 @@
+import { Socket } from "node:net";
+/**
+ * Sends a 204 No Content CORS preflight response.
+ */
+export declare function sendCorsPreflightResponse(socket: Socket): void;
+/**
+ * Sends a basic HTTP response to the client.
+ */
+export declare function sendResponse(socket: Socket, status: number, message: string, body: any, headers?: Record<string, string>): void;
+/**
+ * Builds a valid HTTP response as a Buffer.
+ */
+export declare function buildResponse(status: number, message: string, body: any, customHeaders?: Record<string, string>): Buffer;
+//# sourceMappingURL=responder.d.ts.map

package/dist/responder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responder.d.ts","sourceRoot":"","sources":["../responder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,QAkBvD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,QAI5H;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,aAAa,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,MAAM,CAyB5H"}

package/dist/responder.js

@@ -0,0 +1,54 @@
+import { Socket } from "node:net";
+/**
+ * Sends a 204 No Content CORS preflight response.
+ */
+export function sendCorsPreflightResponse(socket) {
+    const date = new Date().toUTCString();
+    const response = [
+        "HTTP/1.1 204 No Content",
+        `Date: ${date}`,
+        `Server: Phantom/0.0.0`,
+        `Access-Control-Allow-Origin: *`,
+        `Access-Control-Allow-Methods: GET, POST, PUT, PATCH, DELETE, OPTIONS`,
+        `Access-Control-Allow-Headers: Content-Type`,
+        `Access-Control-Max-Age: 86400`,
+        `Content-Length: 0`,
+        `Connection: close`,
+        "",
+        "",
+    ].join("\r\n");
+    socket.write(response);
+    socket.end();
+}
+/**
+ * Sends a basic HTTP response to the client.
+ */
+export function sendResponse(socket, status, message, body, headers = {}) {
+    const response = buildResponse(status, message, body, headers);
+    socket.write(response);
+    socket.end();
+}
+/**
+ * Builds a valid HTTP response as a Buffer.
+ */
+export function buildResponse(status, message, body, customHeaders = {}) {
+    const isBuffer = Buffer.isBuffer(body);
+    const bodyBuffer = isBuffer ? body : Buffer.from(typeof body === "object" ? JSON.stringify(body) : String(body));
+    const bodyLength = bodyBuffer.length;
+    const date = new Date().toUTCString();
+    const lines = [`HTTP/1.1 ${status} ${message}`];
+    lines.push(`Date: ${date}`);
+    lines.push(`Server: Phantom/0.0.0`);
+    lines.push(`Content-Length: ${bodyLength}`);
+    lines.push(`Access-Control-Allow-Origin: *`);
+    lines.push(`Connection: close`);
+    Object.entries(customHeaders).forEach(([key, value]) => {
+        lines.push(`${key}: ${value}`);
+    });
+    if (!customHeaders["Content-Type"] && !customHeaders["content-type"]) {
+        lines.push(`Content-Type: ${isBuffer ? "application/octet-stream" : "application/json"}`);
+    }
+    const headerString = lines.join("\r\n") + "\r\n\r\n";
+    return Buffer.concat([Buffer.from(headerString), bodyBuffer]);
+}
+//# sourceMappingURL=responder.js.map

package/dist/responder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responder.js","sourceRoot":"","sources":["../responder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAc;IACtD,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG;QACf,yBAAyB;QACzB,SAAS,IAAI,EAAE;QACf,uBAAuB;QACvB,gCAAgC;QAChC,sEAAsE;QACtE,4CAA4C;QAC5C,+BAA+B;QAC/B,mBAAmB;QACnB,mBAAmB;QACnB,EAAE;QACF,EAAE;KACH,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEf,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvB,MAAM,CAAC,GAAG,EAAE,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,MAAc,EAAE,OAAe,EAAE,IAAS,EAAE,UAAkC,EAAE;IAC3H,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/D,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvB,MAAM,CAAC,GAAG,EAAE,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,OAAe,EAAE,IAAS,EAAE,gBAAwC,EAAE;IAClH,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAEjH,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAEtC,MAAM,KAAK,GAAG,CAAC,YAAY,MAAM,IAAI,OAAO,EAAE,CAAC,CAAC;IAEhD,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,mBAAmB,UAAU,EAAE,CAAC,CAAC;IAC5C,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAC7C,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAEhC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACrD,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,EAAE,CAAC;QACrE,KAAK,CAAC,IAAI,CAAC,iBAAiB,QAAQ,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC;IACrD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/router.d.ts

@@ -0,0 +1,13 @@
+import { type RouteConfig } from "./config.ts";
+import type { MockRequest } from "./parser.ts";
+export interface MockResponse {
+    status: number;
+    message: string;
+    body: any;
+    params: Record<string, string>;
+    delay?: number;
+    errorRate?: number;
+    headers?: Record<string, string>;
+}
+export declare function handleRouting(request: MockRequest, customRoutes?: RouteConfig[]): MockResponse;
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,GAAG,CAAC;IACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,WAAW,EAAE,GAAG,YAAY,CA4C9F"}

package/dist/router.js

@@ -0,0 +1,61 @@
+import { getActiveRoutes, writeRoutes } from "./config.js";
+import { VERSION } from "./index.js";
+export function handleRouting(request, customRoutes) {
+    if (request.path === "/_admin/version" && request.method === "GET") {
+        return { status: 200, message: "OK", body: { version: VERSION }, params: {} };
+    }
+    if (request.path === "/_admin/routes" && request.method === "GET") {
+        return { status: 200, message: "OK", body: getActiveRoutes(), params: {} };
+    }
+    if (request.path === "/_admin/routes" && request.method === "PUT") {
+        const routes = JSON.parse(request.body.toString("utf-8"));
+        writeRoutes(routes);
+        return { status: 200, message: "OK", body: { success: true }, params: {} };
+    }
+    if (request.path === "/_admin/clear" && request.method === "POST") {
+        return { status: 200, message: "OK", body: { success: true }, params: {} };
+    }
+    const routes = customRoutes || getActiveRoutes();
+    for (const route of routes) {
+        if (route.enabled === false)
+            continue;
+        const params = matchPath(route.path, request.path);
+        if (params) {
+            return {
+                status: route.status,
+                message: "OK",
+                body: route.body,
+                params,
+                delay: route.delay,
+                errorRate: route.errorRate,
+                headers: route.headers || {},
+            };
+        }
+    }
+    return {
+        status: 404,
+        message: "Not Found",
+        body: { error: `Route ${request.path} not found` },
+        params: {},
+    };
+}
+/**
+ * Matches a request path against a pattern like /users/:id.
+ */
+function matchPath(pattern, actualPath) {
+    const paramNames = [];
+    const regexPath = pattern.replace(/:([a-zA-Z0-9_]+)/g, (_, name) => {
+        paramNames.push(name);
+        return "([^/]+)";
+    });
+    const regex = new RegExp(`^${regexPath}$`);
+    const match = actualPath.split("?")[0]?.match(regex);
+    if (!match)
+        return null;
+    const params = {};
+    paramNames.forEach((name, i) => {
+        params[name] = decodeURIComponent(match[i + 1] || "");
+    });
+    return params;
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../router.ts"],"names":[],"mappings":"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"}

package/dist/static.d.ts

@@ -0,0 +1,7 @@
+export declare function handleStaticFile(requestPath: string): Promise<{
+    body: NonSharedBuffer;
+    headers: {
+        "Content-Type": string;
+    };
+} | null>;
+//# sourceMappingURL=static.d.ts.map

package/dist/static.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../static.ts"],"names":[],"mappings":"AAgBA,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM;;;;;UAuBzD"}

package/dist/static.js

@@ -0,0 +1,39 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+const MIME_TYPES = {
+    ".html": "text/html",
+    ".js": "application/javascript",
+    ".css": "text/css",
+    ".svg": "image/svg+xml",
+    ".png": "image/png",
+    ".ico": "image/x-icon",
+    ".json": "application/json",
+};
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+export async function handleStaticFile(requestPath) {
+    let cleanPath = requestPath.split("?")[0] || "/";
+    if (cleanPath === "/")
+        cleanPath = "/index.html";
+    const buildDir = path.join(__dirname, "dashboard-ui");
+    let filePath = path.join(buildDir, cleanPath);
+    try {
+        const content = await fs.readFile(filePath);
+        const ext = path.extname(filePath);
+        return {
+            body: content,
+            headers: { "Content-Type": MIME_TYPES[ext] || "application/octet-stream" },
+        };
+    }
+    catch {
+        // SPA fallback, if file not found, try index.html
+        try {
+            const indexContent = await fs.readFile(path.join(buildDir, "index.html"));
+            return { body: indexContent, headers: { "Content-Type": "text/html" } };
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=static.js.map

package/dist/static.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.js","sourceRoot":"","sources":["../static.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAA2B;IACzC,OAAO,EAAE,WAAW;IACpB,KAAK,EAAE,wBAAwB;IAC/B,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,cAAc;IACtB,OAAO,EAAE,kBAAkB;CAC5B,CAAC;AAEF,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,WAAmB;IACxD,IAAI,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;IACjD,IAAI,SAAS,KAAK,GAAG;QAAE,SAAS,GAAG,aAAa,CAAC;IAEjD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IACtD,IAAI,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAE9C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO;YACL,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,EAAE,cAAc,EAAE,UAAU,CAAC,GAAG,CAAC,IAAI,0BAA0B,EAAE;SAC3E,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;QAClD,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;YAC1E,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,EAAE,CAAC;QAC1E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC"}