@omen.foundation/node-microservice-runtime 0.1.0

package/dist/websocket.js

@@ -0,0 +1,139 @@
+import { setTimeout as sleep } from 'node:timers/promises';
+import { EventEmitter } from 'node:events';
+import WebSocket from 'ws';
+export class BeamableWebSocket {
+    logger;
+    url;
+    maxRetries;
+    retryDelayMs;
+    emitter = new EventEmitter();
+    socket = null;
+    isDisposed = false;
+    constructor(options) {
+        this.logger = options.logger.child({ component: 'BeamableWebSocket' });
+        this.url = options.url;
+        this.maxRetries = options.maxRetries ?? 20;
+        this.retryDelayMs = options.retryDelayMs ?? 1000;
+    }
+    on(event, listener) {
+        this.emitter.on(event, listener);
+        return this;
+    }
+    off(event, listener) {
+        this.emitter.off(event, listener);
+        return this;
+    }
+    emit(event, ...args) {
+        this.emitter.emit(event, ...args);
+    }
+    async connect() {
+        let attempt = 0;
+        while (!this.isDisposed) {
+            try {
+                attempt += 1;
+                await this.createSocket();
+                return;
+            }
+            catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                this.logger.warn({ err, attempt }, 'WebSocket connection attempt failed.');
+                if (attempt >= this.maxRetries) {
+                    throw err;
+                }
+                await sleep(this.retryDelayMs * attempt);
+            }
+        }
+        throw new Error('WebSocket disposed before connection could be established.');
+    }
+    async createSocket() {
+        if (this.socket) {
+            this.socket.removeAllListeners();
+            this.socket.terminate();
+            this.socket = null;
+        }
+        return new Promise((resolve, reject) => {
+            const ws = new WebSocket(this.url, {
+                perMessageDeflate: true,
+                handshakeTimeout: 30_000,
+            });
+            const handleOpen = () => {
+                this.logger.info({ url: this.url }, 'WebSocket connected.');
+                this.socket = ws;
+                ws.off('error', handleError);
+                ws.off('close', handlePrematureClose);
+                this.registerSocketHandlers(ws);
+                this.emit('open');
+                resolve();
+            };
+            const handleError = (error) => {
+                ws.off('open', handleOpen);
+                ws.off('close', handlePrematureClose);
+                reject(error);
+            };
+            const handlePrematureClose = (code, reason) => {
+                ws.off('open', handleOpen);
+                ws.off('error', handleError);
+                const err = new Error(`WebSocket closed before open handshake. code=${code} reason=${reason.toString()}`);
+                reject(err);
+            };
+            ws.on('open', handleOpen);
+            ws.on('error', handleError);
+            ws.on('close', handlePrematureClose);
+        });
+    }
+    registerSocketHandlers(ws) {
+        ws.on('message', (data) => {
+            const payload = typeof data === 'string' ? data : data.toString('utf8');
+            this.logger.debug({ payload }, 'WebSocket received frame.');
+            this.emit('message', payload);
+        });
+        ws.on('close', (code, reason) => {
+            this.logger.warn({ code, reason: reason.toString() }, 'WebSocket closed.');
+            this.emit('close', code === 1000);
+            if (!this.isDisposed) {
+                void this.reconnect();
+            }
+        });
+        ws.on('error', (error) => {
+            const err = error instanceof Error ? error : new Error(String(error));
+            this.logger.error({ err }, 'WebSocket error.');
+            this.emit('error', err);
+        });
+    }
+    async reconnect() {
+        this.logger.info('Attempting to reconnect websocket.');
+        let attempt = 0;
+        while (!this.isDisposed) {
+            try {
+                attempt += 1;
+                await this.createSocket();
+                this.emit('open');
+                return;
+            }
+            catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                this.logger.warn({ err, attempt }, 'Retrying websocket connection.');
+                await sleep(this.retryDelayMs * Math.min(attempt, 10));
+            }
+        }
+    }
+    async send(text) {
+        if (!this.socket || this.socket.readyState !== WebSocket.OPEN) {
+            throw new Error('WebSocket is not connected.');
+        }
+        this.logger.debug({ message: text }, 'Sending websocket frame.');
+        this.socket.send(text);
+    }
+    async close() {
+        this.isDisposed = true;
+        if (!this.socket) {
+            return;
+        }
+        const ws = this.socket;
+        if (ws.readyState === WebSocket.CLOSED || ws.readyState === WebSocket.CLOSING) {
+            return;
+        }
+        ws.close(1000, 'shutdown');
+    }
+}
+//# sourceMappingURL=websocket.js.map

package/dist/websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.js","sourceRoot":"","sources":["../src/websocket.ts"],"names":[],"mappings":"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","sourcesContent":["import { setTimeout as sleep } from 'node:timers/promises';\r\nimport { EventEmitter } from 'node:events';\r\nimport WebSocket from 'ws';\r\nimport type { Logger } from 'pino';\r\n\r\nexport interface WebSocketOptions {\r\n  logger: Logger;\r\n  url: string;\r\n  maxRetries?: number;\r\n  retryDelayMs?: number;\r\n}\r\n\r\nexport interface WebSocketEvents {\r\n  open: [];\r\n  close: [wasClean: boolean];\r\n  message: [payload: string];\r\n  error: [error: Error];\r\n}\r\n\r\nexport class BeamableWebSocket {\r\n  private readonly logger: Logger;\r\n  private readonly url: string;\r\n  private readonly maxRetries: number;\r\n  private readonly retryDelayMs: number;\r\n  private readonly emitter = new EventEmitter();\r\n\r\n  private socket: WebSocket | null = null;\r\n  private isDisposed = false;\r\n\r\n  constructor(options: WebSocketOptions) {\r\n    this.logger = options.logger.child({ component: 'BeamableWebSocket' });\r\n    this.url = options.url;\r\n    this.maxRetries = options.maxRetries ?? 20;\r\n    this.retryDelayMs = options.retryDelayMs ?? 1000;\r\n  }\r\n\r\n  on(event: string, listener: (...args: unknown[]) => void): this {\r\n    this.emitter.on(event, listener);\r\n    return this;\r\n  }\r\n\r\n  off(event: string, listener: (...args: unknown[]) => void): this {\r\n    this.emitter.off(event, listener);\r\n    return this;\r\n  }\r\n\r\n  private emit<Event extends keyof WebSocketEvents>(event: Event, ...args: WebSocketEvents[Event]): void {\r\n    this.emitter.emit(event, ...args);\r\n  }\r\n\r\n  async connect(): Promise<void> {\r\n    let attempt = 0;\r\n    while (!this.isDisposed) {\r\n      try {\r\n        attempt += 1;\r\n        await this.createSocket();\r\n        return;\r\n      } catch (error) {\r\n        const err = error instanceof Error ? error : new Error(String(error));\r\n        this.logger.warn({ err, attempt }, 'WebSocket connection attempt failed.');\r\n        if (attempt >= this.maxRetries) {\r\n          throw err;\r\n        }\r\n        await sleep(this.retryDelayMs * attempt);\r\n      }\r\n    }\r\n    throw new Error('WebSocket disposed before connection could be established.');\r\n  }\r\n\r\n  private async createSocket(): Promise<void> {\r\n    if (this.socket) {\r\n      this.socket.removeAllListeners();\r\n      this.socket.terminate();\r\n      this.socket = null;\r\n    }\r\n\r\n    return new Promise((resolve, reject) => {\r\n      const ws = new WebSocket(this.url, {\r\n        perMessageDeflate: true,\r\n        handshakeTimeout: 30_000,\r\n      });\r\n\r\n      const handleOpen = () => {\r\n        this.logger.info({ url: this.url }, 'WebSocket connected.');\r\n        this.socket = ws;\r\n        ws.off('error', handleError);\r\n        ws.off('close', handlePrematureClose);\r\n        this.registerSocketHandlers(ws);\r\n        this.emit('open');\r\n        resolve();\r\n      };\r\n\r\n      const handleError = (error: Error) => {\r\n        ws.off('open', handleOpen);\r\n        ws.off('close', handlePrematureClose);\r\n        reject(error);\r\n      };\r\n\r\n      const handlePrematureClose = (code: number, reason: Buffer) => {\r\n        ws.off('open', handleOpen);\r\n        ws.off('error', handleError);\r\n        const err = new Error(`WebSocket closed before open handshake. code=${code} reason=${reason.toString()}`);\r\n        reject(err);\r\n      };\r\n\r\n      ws.on('open', handleOpen);\r\n      ws.on('error', handleError);\r\n      ws.on('close', handlePrematureClose);\r\n    });\r\n  }\r\n\r\n  private registerSocketHandlers(ws: WebSocket): void {\r\n    ws.on('message', (data) => {\r\n      const payload = typeof data === 'string' ? data : data.toString('utf8');\r\n      this.logger.debug({ payload }, 'WebSocket received frame.');\r\n      this.emit('message', payload);\r\n    });\r\n\r\n    ws.on('close', (code, reason) => {\r\n      this.logger.warn({ code, reason: reason.toString() }, 'WebSocket closed.');\r\n      this.emit('close', code === 1000);\r\n      if (!this.isDisposed) {\r\n        void this.reconnect();\r\n      }\r\n    });\r\n\r\n    ws.on('error', (error) => {\r\n      const err = error instanceof Error ? error : new Error(String(error));\r\n      this.logger.error({ err }, 'WebSocket error.');\r\n      this.emit('error', err);\r\n    });\r\n  }\r\n\r\n  private async reconnect(): Promise<void> {\r\n    this.logger.info('Attempting to reconnect websocket.');\r\n    let attempt = 0;\r\n    while (!this.isDisposed) {\r\n      try {\r\n        attempt += 1;\r\n        await this.createSocket();\r\n        this.emit('open');\r\n        return;\r\n      } catch (error) {\r\n        const err = error instanceof Error ? error : new Error(String(error));\r\n        this.logger.warn({ err, attempt }, 'Retrying websocket connection.');\r\n        await sleep(this.retryDelayMs * Math.min(attempt, 10));\r\n      }\r\n    }\r\n  }\r\n\r\n  async send(text: string): Promise<void> {\r\n    if (!this.socket || this.socket.readyState !== WebSocket.OPEN) {\r\n      throw new Error('WebSocket is not connected.');\r\n    }\r\n    this.logger.debug({ message: text }, 'Sending websocket frame.');\r\n    this.socket.send(text);\r\n  }\r\n\r\n  async close(): Promise<void> {\r\n    this.isDisposed = true;\r\n    if (!this.socket) {\r\n      return;\r\n    }\r\n    const ws = this.socket;\r\n    if (ws.readyState === WebSocket.CLOSED || ws.readyState === WebSocket.CLOSING) {\r\n      return;\r\n    }\r\n    ws.close(1000, 'shutdown');\r\n  }\r\n}\r\n"]}

package/env.sample

@@ -0,0 +1,13 @@
+# Beamable credentials
+CID=1890069218625633
+PID=DE_1934633364747296
+HOST=wss://portal.beamable.com/socket
+SECRET=6a24a8a1-f9f1-4e4a-b487-a446896f9b9f
+# Alternatively, you can use a refresh token instead of SECRET
+# REFRESH_TOKEN=
+
+# Optional developer settings
+NAME_PREFIX=
+LOG_LEVEL=info
+WATCH_TOKEN=false
+BEAM_INSTANCE_COUNT=1

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@omen.foundation/node-microservice-runtime",
+  "version": "0.1.0",
+  "description": "Beamable microservice runtime for Node.js/TypeScript services.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "bin": {
+    "beamo-node": "./dist/cli/index.js"
+  },
+  "scripts": {
+    "clean": "rimraf dist dist-cjs",
+    "build": "npm run clean && tsc -p tsconfig.build.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json && node ./scripts/prepare-cjs.mjs",
+    "compile": "npm run build && npm run build:cjs",
+    "dev": "tsx --env-file .env src/dev.ts",
+    "start": "node dist/index.js"
+  },
+  "engines": {
+    "node": ">=22.14.0"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "beamable-sdk": "^0.6.0",
+    "dotenv": "^16.4.7",
+    "eventemitter3": "^5.0.1",
+    "keytar": "^7.9.0",
+    "mongodb": "^6.10.0",
+    "pino": "^9.0.0",
+    "reflect-metadata": "^0.2.1",
+    "tar-stream": "^2.2.0",
+    "undici": "^6.19.6",
+    "ws": "^8.17.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.30",
+    "@types/ws": "^8.5.10",
+    "rimraf": "^5.0.5",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.19.2",
+    "typescript": "^5.4.5"
+  }
+}

package/scripts/generate-openapi.mjs

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { pathToFileURL, fileURLToPath } from 'node:url';
+import dotenv from 'dotenv';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+function parseArgs(argv) {
+  const args = {
+    entry: 'dist/main.js',
+    output: 'beam_openApi.json',
+    envFile: undefined,
+    cid: undefined,
+    pid: undefined,
+    host: undefined,
+    namePrefix: undefined,
+    service: undefined,
+  };
+
+  const queue = [...argv];
+  while (queue.length > 0) {
+    const current = queue.shift();
+    switch (current) {
+      case '--entry':
+        args.entry = queue.shift();
+        break;
+      case '--output':
+        args.output = queue.shift();
+        break;
+      case '--env-file':
+        args.envFile = queue.shift();
+        break;
+      case '--cid':
+        args.cid = queue.shift();
+        break;
+      case '--pid':
+        args.pid = queue.shift();
+        break;
+      case '--host':
+        args.host = queue.shift();
+        break;
+      case '--routing-key':
+      case '--name-prefix':
+        args.namePrefix = queue.shift();
+        break;
+      case '--service':
+        args.service = queue.shift();
+        break;
+      default:
+        throw new Error(`Unknown argument: ${current}`);
+    }
+  }
+
+  return args;
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+
+  if (args.envFile) {
+    const envPath = path.resolve(args.envFile);
+    dotenv.config({ path: envPath });
+  }
+
+  if (args.cid) {
+    process.env.CID = args.cid;
+  }
+  if (args.pid) {
+    process.env.PID = args.pid;
+  }
+  if (args.host) {
+    process.env.HOST = args.host;
+  }
+  if (args.namePrefix) {
+    process.env.NAME_PREFIX = args.namePrefix;
+  }
+
+  process.env.BEAMABLE_SKIP_RUNTIME = 'true';
+
+  const entryPath = path.resolve(args.entry);
+  const outputPath = path.resolve(args.output);
+
+  const runtimeEntry = path.resolve(__dirname, '../dist/runtime.js');
+  try {
+    await fs.access(runtimeEntry);
+  } catch (error) {
+    throw new Error('Runtime distribution not found. Run "npm run compile" in @omen.foundation/node-microservice-runtime.');
+  }
+
+  await import(pathToFileURL(entryPath).href);
+
+  const { generateOpenApiDocumentForRegisteredServices } = await import(pathToFileURL(runtimeEntry).href);
+
+  const document = generateOpenApiDocumentForRegisteredServices(
+    {
+      cid: process.env.CID,
+      pid: process.env.PID,
+      host: process.env.HOST,
+      routingKey: process.env.NAME_PREFIX,
+    },
+    { serviceName: args.service },
+  );
+
+  await fs.writeFile(outputPath, `${JSON.stringify(document, null, 2)}\n`, 'utf8');
+
+  console.log(`OpenAPI documentation generated at ${outputPath}`);
+}
+
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : error);
+  process.exit(1);
+});

package/scripts/lib/cli-utils.mjs

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+
+import { spawn } from 'node:child_process';
+
+export function runCommand(
+  command,
+  args,
+  { cwd = process.cwd(), env = process.env, stdio = 'inherit', capture = false, shell, silent = false } = {},
+) {
+  return new Promise((resolve, reject) => {
+    const stdioOption = capture ? 'pipe' : (silent ? 'ignore' : stdio);
+    const child = spawn(command, args, {
+      cwd,
+      env,
+      stdio: stdioOption,
+      shell: shell ?? (process.platform === 'win32'),
+    });
+
+    const stdoutChunks = [];
+    const stderrChunks = [];
+
+    if (capture) {
+      child.stdout?.on('data', (chunk) => stdoutChunks.push(chunk));
+      child.stderr?.on('data', (chunk) => stderrChunks.push(chunk));
+    }
+
+    child.on('error', (error) => {
+      reject(error);
+    });
+
+    child.on('exit', (code, signal) => {
+      if (code === 0) {
+        resolve({
+          code,
+          signal,
+          stdout: capture ? Buffer.concat(stdoutChunks).toString('utf8').trim() : undefined,
+          stderr: capture ? Buffer.concat(stderrChunks).toString('utf8').trim() : undefined,
+        });
+      } else {
+        const error = new Error(`Command failed: ${command} ${args.join(' ')}`);
+        error.code = code;
+        error.signal = signal;
+        if (capture) {
+          error.stdout = Buffer.concat(stdoutChunks).toString('utf8');
+          error.stderr = Buffer.concat(stderrChunks).toString('utf8');
+        }
+        reject(error);
+      }
+    });
+  });
+}
+
+export function parseBooleanEnv(value, fallback = false) {
+  if (value === undefined) {
+    return fallback;
+  }
+  return ['1', 'true', 'yes', 'on'].includes(value.toString().trim().toLowerCase());
+}

package/scripts/prepare-cjs.mjs

@@ -0,0 +1,44 @@
+import { mkdir, readdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+
+async function ensureDir(path) {
+  await mkdir(path, { recursive: true });
+}
+
+async function copyCjsFiles() {
+  const srcRoot = join(process.cwd(), 'dist-cjs');
+  const dstRoot = join(process.cwd(), 'dist');
+
+  await ensureDir(dstRoot);
+
+  const stack = [''];
+  while (stack.length > 0) {
+    const current = stack.pop();
+    const srcDir = join(srcRoot, current);
+    const entries = await readdir(srcDir, { withFileTypes: true });
+    for (const entry of entries) {
+      const relativePath = join(current, entry.name);
+      if (entry.isDirectory()) {
+        stack.push(relativePath);
+        continue;
+      }
+
+      if (!entry.name.endsWith('.js')) {
+        continue;
+      }
+
+      const sourceFile = join(srcRoot, relativePath);
+      const destFile = join(dstRoot, current, entry.name.replace(/\.js$/, '.cjs'));
+      await ensureDir(dirname(destFile));
+      const contents = await readFile(sourceFile);
+      await writeFile(destFile, contents);
+    }
+  }
+
+  await rm(srcRoot, { recursive: true, force: true });
+}
+
+copyCjsFiles().catch((error) => {
+  console.error('Failed to prepare CommonJS artifacts:', error);
+  process.exitCode = 1;
+});