working poc

signaling/.gitignore

@@ -0,0 +1,34 @@
+# dependencies (bun install)
+node_modules
+
+# output
+out
+dist
+*.tgz
+
+# code coverage
+coverage
+*.lcov
+
+# logs
+logs
+_.log
+report.[0-9]_.[0-9]_.[0-9]_.[0-9]_.json
+
+# dotenv environment variable files
+.env
+.env.development.local
+.env.test.local
+.env.production.local
+.env.local
+
+# caches
+.eslintcache
+.cache
+*.tsbuildinfo
+
+# IntelliJ based IDEs
+.idea
+
+# Finder (MacOS) folder config
+.DS_Store

signaling/README.md

@@ -0,0 +1 @@
+# signaling

signaling/package-lock.json

@@ -0,0 +1,75 @@
+{
+  "name": "signaling",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "signaling",
+      "dependencies": {
+        "@techniker-me/logger": "^0.0.15"
+      },
+      "devDependencies": {
+        "@types/bun": "latest"
+      },
+      "peerDependencies": {
+        "typescript": "^5"
+      }
+    },
+    "node_modules/@techniker-me/logger": {
+      "version": "0.0.15",
+      "resolved": "https://npm.techniker.me/@techniker-me/logger/-/logger-0.0.15.tgz",
+      "integrity": "sha512-+6aB39lWTO2RDQLse2nZqfTXa7Kp78K7Xy7zobwBQlg01jR4zKmQAMkjQ4iduvnQYEU+1F2k6FDMco2E0mWZ4w==",
+      "dependencies": {
+        "@techniker-me/tools": "2025.0.16"
+      }
+    },
+    "node_modules/@techniker-me/tools": {
+      "version": "2025.0.16",
+      "resolved": "https://npm.techniker.me/@techniker-me/tools/-/tools-2025.0.16.tgz",
+      "integrity": "sha512-Ul2yj1vd4lCO8g7IW2pHkAsdeRVEUMqGpiIvSedCc1joVXEWPbh4GESW83kMHtisjFjjlZIzb3EVlCE0BCiBWQ=="
+    },
+    "node_modules/@types/bun": {
+      "version": "1.3.3",
+      "resolved": "https://npm.techniker.me/@types/bun/-/bun-1.3.3.tgz",
+      "integrity": "sha512-ogrKbJ2X5N0kWLLFKeytG0eHDleBYtngtlbu9cyBKFtNL3cnpDZkNdQj8flVf6WTZUX5ulI9AY1oa7ljhSrp+g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "bun-types": "1.3.3"
+      }
+    },
+    "node_modules/@types/node": {
+      "version": "24.10.1",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "undici-types": "~7.16.0"
+      }
+    },
+    "node_modules/bun-types": {
+      "version": "1.3.3",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/typescript": {
+      "version": "5.9.3",
+      "license": "Apache-2.0",
+      "peer": true,
+      "bin": {
+        "tsc": "bin/tsc",
+        "tsserver": "bin/tsserver"
+      },
+      "engines": {
+        "node": ">=14.17"
+      }
+    },
+    "node_modules/undici-types": {
+      "version": "7.16.0",
+      "dev": true,
+      "license": "MIT"
+    }
+  }
+}

signaling/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "signaling",
+  "module": "src/index.ts",
+  "type": "module",
+  "private": true,
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "@techniker-me/logger": "^0.0.15"
+  }
+}

signaling/src/SignalingServer.ts

@@ -0,0 +1,89 @@
+import type { Server, ServerWebSocket } from "bun";
+import {LoggerFactory, type ILogger} from '@techniker-me/logger';
+import { MessageKindMapping } from "./messaging/MessageKind";
+
+export default class SignalingServer {
+    private readonly _logger: ILogger = LoggerFactory.getLogger('SignalingServer');
+    private readonly _port: number;
+    private readonly _hostname: string;
+    private readonly _development: boolean;
+    private readonly _clients: Set<ServerWebSocket<undefined>> = new Set();
+    
+    constructor(port: number, hostname: string = '0.0.0.0', development: boolean = false) {
+        this._port = port;
+        this._hostname = hostname;
+        this._development = development;
+    }
+
+    get port(): number {
+        return this._port;
+    }
+
+    get hostname(): string {
+        return this._hostname;
+    }
+
+    get development(): boolean {
+        return this._development;
+    }
+
+    get websocket() {
+        return {
+            open: this.handleWebSocketOpen.bind(this),
+            message: this.handleWebSocketMessage.bind(this),
+            close: this.handleWebSocketClose.bind(this),
+            drain: this.handleWebSocketDrain.bind(this),
+            error: this.handleWebSocketError.bind(this),
+            perMessageDeflate: true,
+            maxPayloadLength: 10 * 1024
+        };
+    }
+
+    get fetch() {
+        return (req: Request, server: Server<undefined>) => {
+            this._logger.info(`Fetch request received [${req.url}] from [${server.requestIP(req)?.address}:${server.requestIP(req)?.port}]`);
+            const url = new URL(req.url);
+
+            if (url.pathname.endsWith('/ws')) {
+                this._logger.info('Upgrading to WebSocket');
+                server.upgrade(req)
+
+                return;
+            }
+
+            return new Response('Hello World');
+        };
+    }
+
+    private handleWebSocketOpen(ws: ServerWebSocket<undefined>): void {
+        this._logger.info('WebSocket opened');
+        this._clients.add(ws);
+    }
+
+    private handleWebSocketMessage(ws: ServerWebSocket<undefined>, message: string | Buffer): void {
+        const messageString = typeof message === 'string' ? message : message.toString();
+        const jsonMessage = JSON.parse(messageString);
+        this._logger.info(`WebSocket message received [${MessageKindMapping.convertMessageKindToMessageType(jsonMessage.type)}]`);
+        
+        // Forward message to all other clients (following sequence diagram)
+        // This allows the signaling server to relay offers/answers between caller and callee
+        this._clients.forEach(client => {
+            if (client !== ws && client.readyState === 1) { // 1 = OPEN
+                client.send(messageString);
+            }
+        });
+    }
+
+    private handleWebSocketClose(ws: ServerWebSocket<undefined>): void {
+        this._logger.info('WebSocket closed');
+        this._clients.delete(ws);
+    }
+
+    private handleWebSocketError(ws: ServerWebSocket<undefined>, error: Error): void {
+        this._logger.error('WebSocket error', error);
+    }
+
+    private handleWebSocketDrain(ws: ServerWebSocket<undefined>): void {
+        this._logger.info('WebSocket drained');
+    }
+}

signaling/src/index.ts

@@ -0,0 +1,7 @@
+import SignalingServer from "./SignalingServer";
+
+const signalingServer = new SignalingServer(3000, '0.0.0.0', true);
+
+Bun.serve(signalingServer);
+
+console.log(`Signaling server started on [${signalingServer.hostname}:${signalingServer.port}]`);

signaling/src/messaging

@@ -0,0 +1 @@
+../../frontend-web-vanilla/src/messaging

signaling/tsconfig.json

@@ -0,0 +1,30 @@
+{
+  "compilerOptions": {
+    // Environment setup & latest features
+    "lib": ["ESNext"],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleDetection": "force",
+    "jsx": "react-jsx",
+    "allowJs": true,
+
+    // Bundler mode
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false
+  },
+  "include": ["src"]
+}