@cloudnux/local-cloud-provider 0.7.0 → 0.10.0

package/dist/websocket-plugin/index.d.ts

@@ -0,0 +1,43 @@
+import { FastifyPluginOptions, FastifyPluginAsync } from 'fastify';
+import { WebSocket } from 'ws';
+
+type WebSocketEvent = "connect" | "disconnect" | "message";
+interface WebSocketConnection {
+    connectionId: string;
+    socket: WebSocket;
+    path: string;
+    connectedAt: Date;
+}
+type WebSocketEventHandler = (connectionId: string, event: WebSocketEvent, data?: any) => Promise<any>;
+interface WebSocketRouteHandler {
+    path: string;
+    event: WebSocketEvent;
+    route?: string;
+    handler: WebSocketEventHandler;
+}
+interface WebSocketConfig {
+    routeKeyField: string;
+}
+interface WebSocketPluginOptions extends FastifyPluginOptions {
+    prefix?: string;
+    config?: Partial<WebSocketConfig>;
+}
+interface WebSocketManager {
+    registerHandler(handler: WebSocketRouteHandler): void;
+    getConnections(path?: string): WebSocketConnection[];
+    sendToClient(connectionId: string, data: any): Promise<void>;
+}
+interface WebSocketDecoratorOptions {
+    connections: Map<string, WebSocketConnection>;
+    handlers: WebSocketRouteHandler[];
+    config: WebSocketConfig;
+}
+declare module 'fastify' {
+    interface FastifyInstance {
+        websockets: WebSocketManager;
+    }
+}
+
+declare const websocketsPlugin: FastifyPluginAsync<WebSocketPluginOptions>;
+
+export { type WebSocketConfig, type WebSocketConnection, type WebSocketDecoratorOptions, type WebSocketEvent, type WebSocketEventHandler, type WebSocketManager, type WebSocketPluginOptions, type WebSocketRouteHandler, websocketsPlugin };

package/dist/websocket-plugin/index.js

@@ -0,0 +1,96 @@
+// src/websocket-plugin/plugin.ts
+import crypto from "crypto";
+import fsPlugin from "fastify-plugin";
+import websocketPlugin from "@fastify/websocket";
+var DEFAULT_CONFIG = {
+  routeKeyField: "action"
+};
+function mergeConfig(defaults, overrides) {
+  return { ...defaults, ...overrides };
+}
+var websocketsPlugin = fsPlugin(async (app, options) => {
+  const config = mergeConfig(DEFAULT_CONFIG, options.config);
+  const connections = /* @__PURE__ */ new Map();
+  const handlers = [];
+  const registeredPaths = /* @__PURE__ */ new Set();
+  await app.register(websocketPlugin);
+  function ensureRouteForPath(path) {
+    if (registeredPaths.has(path)) return;
+    registeredPaths.add(path);
+    app.get(path, { websocket: true }, (socket) => {
+      const connectionId = crypto.randomUUID();
+      const connection = {
+        connectionId,
+        socket,
+        path,
+        connectedAt: /* @__PURE__ */ new Date()
+      };
+      connections.set(connectionId, connection);
+      const pathHandlers = () => handlers.filter((h) => h.path === path);
+      const connectHandlers = pathHandlers().filter((h) => h.event === "connect");
+      for (const h of connectHandlers) {
+        h.handler(connectionId, "connect").catch(() => {
+        });
+      }
+      socket.on("message", (raw) => {
+        const data = raw.toString();
+        const currentHandlers = pathHandlers();
+        const routeKey = typeof data === "object" && data !== null ? data[config.routeKeyField] : void 0;
+        let matched = false;
+        if (routeKey) {
+          const routeHandlers = currentHandlers.filter(
+            (h) => h.event === "message" && h.route === routeKey
+          );
+          for (const h of routeHandlers) {
+            matched = true;
+            h.handler(connectionId, "message", data).catch(() => {
+            });
+          }
+        }
+        if (!matched) {
+          const defaultHandlers = currentHandlers.filter(
+            (h) => h.event === "message" && !h.route
+          );
+          for (const h of defaultHandlers) {
+            h.handler(connectionId, "message", data).catch(() => {
+            });
+          }
+        }
+      });
+      socket.on("close", () => {
+        const disconnectHandlers = pathHandlers().filter((h) => h.event === "disconnect");
+        for (const h of disconnectHandlers) {
+          h.handler(connectionId, "disconnect").catch(() => {
+          });
+        }
+        connections.delete(connectionId);
+      });
+    });
+  }
+  const manager = {
+    registerHandler(handler) {
+      handlers.push(handler);
+      ensureRouteForPath(handler.path);
+    },
+    getConnections(path) {
+      const allConnections = Array.from(connections.values());
+      if (path) {
+        return allConnections.filter((c) => c.path === path);
+      }
+      return allConnections;
+    },
+    async sendToClient(connectionId, data) {
+      const connection = connections.get(connectionId);
+      if (!connection) {
+        throw new Error(`WebSocket connection ${connectionId} not found`);
+      }
+      const payload = typeof data === "string" ? data : JSON.stringify(data);
+      connection.socket.send(payload);
+    }
+  };
+  app.decorate("websockets", manager);
+});
+export {
+  websocketsPlugin
+};
+//# sourceMappingURL=index.js.map

package/dist/websocket-plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/websocket-plugin/plugin.ts"],"sourcesContent":["import crypto from \"node:crypto\";\n\nimport { FastifyInstance, FastifyPluginAsync } from \"fastify\";\nimport fsPlugin from \"fastify-plugin\";\nimport websocketPlugin from \"@fastify/websocket\";\n\nimport {\n    WebSocketPluginOptions,\n    WebSocketConfig,\n    WebSocketConnection,\n    WebSocketRouteHandler,\n} from \"./types\";\n\nconst DEFAULT_CONFIG: WebSocketConfig = {\n    routeKeyField: \"action\",\n};\n\nfunction mergeConfig(\n    defaults: WebSocketConfig,\n    overrides?: Partial<WebSocketConfig>\n): WebSocketConfig {\n    return { ...defaults, ...overrides };\n}\n\nexport const websocketsPlugin: FastifyPluginAsync<WebSocketPluginOptions> =\n    fsPlugin(async (\n        app: FastifyInstance,\n        options: WebSocketPluginOptions\n    ) => {\n        const config = mergeConfig(DEFAULT_CONFIG, options.config);\n        const connections = new Map<string, WebSocketConnection>();\n        const handlers: WebSocketRouteHandler[] = [];\n        const registeredPaths = new Set<string>();\n\n        // Register @fastify/websocket\n        await app.register(websocketPlugin);\n\n        // Register WebSocket route for a path when first handler uses it\n        function ensureRouteForPath(path: string) {\n            if (registeredPaths.has(path)) return;\n            registeredPaths.add(path);\n\n            app.get(path, { websocket: true }, (socket) => {\n                const connectionId = crypto.randomUUID();\n                const connection: WebSocketConnection = {\n                    connectionId,\n                    socket,\n                    path,\n                    connectedAt: new Date(),\n                };\n                connections.set(connectionId, connection);\n\n                // Filter handlers for this path at runtime so late-registered handlers are included\n                const pathHandlers = () => handlers.filter(h => h.path === path);\n\n                // Fire connect handlers\n                const connectHandlers = pathHandlers().filter(h => h.event === \"connect\");\n                for (const h of connectHandlers) {\n                    h.handler(connectionId, \"connect\").catch(() => { });\n                }\n\n                // Handle incoming messages\n                socket.on(\"message\", (raw) => {\n                    const data = raw.toString();\n\n                    const currentHandlers = pathHandlers();\n\n                    // Try to match a specific route handler\n                    const routeKey = typeof data === \"object\" && data !== null\n                        ? data[config.routeKeyField]\n                        : undefined;\n\n                    let matched = false;\n                    if (routeKey) {\n                        const routeHandlers = currentHandlers.filter(\n                            h => h.event === \"message\" && h.route === routeKey\n                        );\n                        for (const h of routeHandlers) {\n                            matched = true;\n                            h.handler(connectionId, \"message\", data).catch(() => { });\n                        }\n                    }\n\n                    // Fall back to default message handlers (no route)\n                    if (!matched) {\n                        const defaultHandlers = currentHandlers.filter(\n                            h => h.event === \"message\" && !h.route\n                        );\n                        for (const h of defaultHandlers) {\n                            h.handler(connectionId, \"message\", data).catch(() => { });\n                        }\n                    }\n                });\n\n                // Handle disconnect\n                socket.on(\"close\", () => {\n                    const disconnectHandlers = pathHandlers().filter(h => h.event === \"disconnect\");\n                    for (const h of disconnectHandlers) {\n                        h.handler(connectionId, \"disconnect\").catch(() => { });\n                    }\n                    connections.delete(connectionId);\n                });\n            });\n        }\n\n        // Create manager with eager route registration\n        const manager = {\n            registerHandler(handler: WebSocketRouteHandler) {\n                handlers.push(handler);\n                ensureRouteForPath(handler.path);\n            },\n            getConnections(path?: string): WebSocketConnection[] {\n                const allConnections = Array.from(connections.values());\n                if (path) {\n                    return allConnections.filter(c => c.path === path);\n                }\n                return allConnections;\n            },\n            async sendToClient(connectionId: string, data: any): Promise<void> {\n                const connection = connections.get(connectionId);\n                if (!connection) {\n                    throw new Error(`WebSocket connection ${connectionId} not found`);\n                }\n                const payload = typeof data === \"string\" ? data : JSON.stringify(data);\n                connection.socket.send(payload);\n            },\n        };\n\n        app.decorate('websockets', manager);\n    });\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudnux/local-cloud-provider",
-  "version": "0.7.0",
+  "version": "0.10.0",
   "description": "CloudNux local development cloud provider implementation",
   "license": "MIT",
   "type": "module",
@@ -22,6 +22,10 @@
     "./dev-console-plugin": {
       "types": "./dist/dev-console-plugin/index.d.ts",
       "import": "./dist/dev-console-plugin/index.js"
+    },
+    "./websocket-plugin": {
+      "types": "./dist/websocket-plugin/index.d.ts",
+      "import": "./dist/websocket-plugin/index.js"
     }
   },
   "files": [
@@ -47,19 +51,22 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@cloudnux/core-cloud-provider": "0.5.0",
+    "@cloudnux/core-cloud-provider": "0.10.0",
     "@fastify/cors": "^11.1.0",
     "@fastify/static": "^8.0.0",
+    "@fastify/websocket": "^11.0.1",
     "axios": "1.9.0",
     "chalk": "^5.4.1",
     "cron-parser": "^4.9.0",
     "fastify": "^5.2.1",
     "fastify-plugin": "^5.0.1",
+    "fastify-print-routes": "^5.0.1",
     "fastify-raw-body": "^5.0.0",
     "log-symbols": "^7.0.1"
   },
   "devDependencies": {
     "@types/node": "^24.10.1",
+    "@types/ws": "^8.18.1",
     "@vitest/coverage-v8": "^4.0.14",
     "vitest": "^4.0.14"
   },
@@ -67,4 +74,4 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   }
-}
+}