@omen.foundation/node-microservice-runtime 0.1.121 → 0.1.123

package/AGENTS.md

@@ -0,0 +1,56 @@
+# Agent instructions: @omen.foundation/node-microservice-runtime
+
+Use this file when implementing or refactoring a **Beamable Node microservice** that depends on `@omen.foundation/node-microservice-runtime`. Prefer facts below over guesses; when unsure, read the installed package source under `dist/` or this repo’s `Microservice/src/`.
+
+## Hard rules
+
+1. **Single `@Microservice`** — Exactly one class per process with `@Microservice('Name')`. Service name must match `package.json` → `beamable.beamoId`.
+2. **`reflect-metadata` first** — `import 'reflect-metadata'` before any file that uses decorators on classes/methods.
+3. **Import order** — Import `@StorageObject` classes **before** services that use storage so registration runs.
+4. **Do not block publish/validate** — When OpenAPI generation or `beamo-node` loads the app without running the network stack, `BEAMABLE_SKIP_RUNTIME=true` is set; `runMicroservice()` becomes a no-op. Do not remove this guard or start long-lived work at module top level without checking that variable.
+5. **Required env for live runtime** — `CID`, `PID`, `HOST` are mandatory for `loadEnvironmentConfig()`. Missing values throw at startup.
+6. **`beam.env` semantics** — Loaded from `cwd` or `/beam/service/`. Injected keys **do not override** existing `process.env` entries.
+7. **No fake APIs** — Only use exports from the package’s public `dist/index` surface (`Microservice`, `Callable`, `ClientCallable`, `ServerCallable`, `AdminCallable`, `ConfigureServices`, `InitializeServices`, `runMicroservice`, `loadEnvironmentConfig`, `StorageObject`, federation types, DI tokens, etc.). Do not invent Beamable HTTP paths or env vars; verify in code or Beamable docs.
+
+## Callable access model
+
+- **`@ClientCallable`** — Authenticated player/client flows (`userId` > 0 expected).
+- **`@ServerCallable`** — Server/trusted routes; still use scopes appropriate to your game.
+- **`@AdminCallable`** — Admin scope defaults.
+- **`@Callable`** — Configure `access`, `route`, `requiredScopes`, `requireAuth` explicitly when you need fine control.
+
+Always use **`RequestContext`** as the first parameter pattern consistent with existing handlers in the project.
+
+## Dependency injection
+
+- Register dependencies in a **`@ConfigureServices` static** method on the microservice class: `builder.addSingletonClass`, `builder.addSingleton`, lifetimes as provided by `DependencyBuilder`.
+- Resolve in handlers via **`ctx.provider.resolve(MyService)`** (or inject via factories registered on the builder).
+- If `tsx` or build pipeline strips `emitDecoratorMetadata`, prefer **factory registration** that manually resolves dependencies (see Example microservice pattern).
+
+## Storage (MongoDB)
+
+- Decorate with **`@StorageObject('StorageName')`**.
+- Provide **`STORAGE_CONNSTR_<StorageName>`** when you need a direct connection string (name normalization matches runtime — use the same spelling as in code).
+- **`MONGODB_MAX_POOL_SIZE`** optional; clamped by runtime.
+
+## Health and hosting
+
+- Default **health HTTP port `6565`** when `HEALTH_PORT` is unset or invalid in container contexts.
+- Production Docker should use **`WORKDIR /beam/service`** and place **`beam.env`** there (or supply equivalent env via the platform).
+
+## Logging / collector
+
+- Runtime starts OpenTelemetry collector setup in the background; pre-baking collector binaries in the image under **`/opt/beam/collectors/`** avoids cold-start delay. See **`ai/RUNTIME_FOR_AI.md`** for Dockerfile snippets.
+
+## CLI
+
+- **`beamo-node validate`** / **`beamo-node publish`** — use project `.env` or `--env-file` so `CID`/`PID`/`HOST`/tokens match the target realm.
+- Binary name: **`beamo-node`** (`package.json` `bin`).
+
+## TypeScript config
+
+- Enable **`experimentalDecorators`** and **`emitDecoratorMetadata`** unless the project standardizes on explicit factory-based DI only.
+
+## Longer reference
+
+See **`ai/RUNTIME_FOR_AI.md`** in this package for Dockerfile examples, `beam.env` priority, Beamable Config keys, and troubleshooting.

package/CLAUDE.md

@@ -0,0 +1,11 @@
+# AI agents (Claude, Codex, Cursor, etc.)
+
+Authoritative usage rules for **`@omen.foundation/node-microservice-runtime`** ship in this package:
+
+1. **`AGENTS.md`** — concise rules (env, decorators, DI, Docker, publish).
+2. **`ai/RUNTIME_FOR_AI.md`** — full reference (startup order, env tables, Dockerfile fragment, troubleshooting).
+3. **`ai/cursor-rule-snippet.md`** — optional text to paste into Cursor `.cursor/rules`.
+
+Human-oriented overview: **`README.md`**.
+
+After `npm install`, these files are under `node_modules/@omen.foundation/node-microservice-runtime/`.

package/README.md

@@ -0,0 +1,174 @@
+# @omen.foundation/node-microservice-runtime
+
+TypeScript/Node.js runtime for **Beamable** microservices: WebSocket gateway integration, dependency injection, OpenAPI generation, MongoDB storage helpers, optional federation, logging (OpenTelemetry / collector), and a **`beamo-node`** CLI for validate/publish workflows.
+
+## Requirements
+
+- **Node.js** `>= 22.14.0` (see `engines` in `package.json`).
+- **ESM** projects: `"type": "module"` in your service `package.json`.
+- **`reflect-metadata`** imported once before any decorated classes load (required for decorators / DI).
+
+## Install
+
+```bash
+npm install @omen.foundation/node-microservice-runtime reflect-metadata
+```
+
+The package ships:
+
+- **Library** — decorators, `runMicroservice()`, DI tokens, storage/federation helpers.
+- **CLI** — `beamo-node` (login, scaffold, validate, publish, …).
+
+## Minimal service shape
+
+1. **`package.json`** — declare the Beamable service id (must match `@Microservice` name):
+
+```json
+{
+  "name": "my-game-service",
+  "type": "module",
+  "main": "dist/main.js",
+  "scripts": {
+    "dev": "tsx --env-file .env src/main.ts",
+    "build": "tsc -p tsconfig.json",
+    "validate": "npx beamo-node validate --env-file .env",
+    "publish": "npx beamo-node publish --env-file .env"
+  },
+  "beamable": {
+    "beamoId": "MyGameService",
+    "projectType": "service"
+  }
+}
+```
+
+2. **Entry file** — load metadata, import the class that carries `@Microservice`, then start:
+
+```ts
+import 'reflect-metadata';
+import './MyGameService.js';
+import { runMicroservice } from '@omen.foundation/node-microservice-runtime';
+
+void runMicroservice();
+```
+
+3. **Service class** — exactly one class decorated with `@Microservice('Name')` (name must match `beamable.beamoId`).
+
+## Decorators and HTTP access
+
+| Decorator | Typical use |
+|-----------|-------------|
+| `@Microservice('ServiceName')` | Registers the service (required, one per process). |
+| `@Callable` | General callable; access via `access` option or use a specialized decorator below. |
+| `@ClientCallable` | Game/client calls; expects authenticated user. |
+| `@ServerCallable` | Trusted server-to-server style routes. |
+| `@AdminCallable` | Admin-scoped routes. |
+| `@ConfigureServices` | Static method receiving `DependencyBuilder` — register singletons, factories. |
+| `@InitializeServices` | Static method receiving scope — run after container is built. |
+| `@SwaggerCategory` / `@SwaggerTags` | OpenAPI grouping. |
+| `@StorageObject('StorageName')` | Registers a named Beamable storage binding (MongoDB). |
+| `@FederatedInventory` | Optional federation hook for inventory-style flows. |
+
+Handlers receive **`RequestContext`** (`userId`, `cid`, `pid`, logger, `provider` for DI resolution, etc.).
+
+## Environment: Beamable vs `beam.env`
+
+### Required for a running service
+
+The runtime calls `loadEnvironmentConfig()`, which **requires**:
+
+- `CID` — customer id  
+- `PID` — project / realm id  
+- `HOST` — WebSocket host (e.g. `wss://api.beamable.com/socket`)  
+- `SECRET` — signing secret (when used by your deployment; local CLI may use tokens instead)
+
+Optional common variables include `REFRESH_TOKEN`, `NAME_PREFIX` / `ROUTING_KEY`, `LOG_LEVEL`, `HEALTH_PORT` (defaults to **6565** when not set or invalid).
+
+### Developer file: `beam.env`
+
+The runtime loads **`beam.env`** (or **`.beam.env`**) from, in order:
+
+1. `process.cwd()/beam.env` or `.beam.env`
+2. `/beam/service/beam.env` or `.beam.env` (typical container layout)
+
+Rules:
+
+- Format: `KEY=value`, `#` comments, optional quotes for values.
+- **Does not override** variables already in `process.env`.
+
+See the published **`beam.env.example`** in this package for a starting template.
+
+### Beamable Config API
+
+Config from the portal can be merged in asynchronously (with a short timeout). Keys are exposed as `BEAM_CONFIG_*`. Details are summarized in **`AGENTS.md`** and **`ai/RUNTIME_FOR_AI.md`**.
+
+### OpenAPI / validate / publish without starting the server
+
+Tools set:
+
+```bash
+BEAMABLE_SKIP_RUNTIME=true
+```
+
+so `runMicroservice()` returns immediately while your module graph still loads for schema generation.
+
+## Docker (production-oriented)
+
+Recommended patterns used in production games:
+
+1. **Working directory** — use **`/beam/service`** so the default `beam.env` search path matches the runtime.
+2. **Copy artifacts** — `dist/`, `package.json`, lockfile, `beam_openApi.json` (if generated), and **`beam.env`** (or inject secrets via orchestrator and skip copying secrets into images where policy forbids it).
+3. **Health checks** — expose the HTTP health port (default **6565**, overridable with `HEALTH_PORT`).
+4. **Collector startup** — pre-installing the Beamable OpenTelemetry collector under **`/opt/beam/collectors/...`** avoids a multi-second download on cold start. See **`ai/RUNTIME_FOR_AI.md`** for an example multi-stage `Dockerfile` fragment.
+
+Your game may use Node 20 images today; the **runtime’s declared engine is Node 22+** — align image version with `engines` before upgrading the dependency.
+
+## CLI: `beamo-node`
+
+Installed as a binary with the package:
+
+```bash
+npx beamo-node --help
+```
+
+Typical project scripts:
+
+```bash
+npx beamo-node validate --env-file .env
+npx beamo-node publish --env-file .env
+```
+
+Login and scaffolding commands create a local profile under `~/.beamo-node/`.
+
+**`beamo-node scaffold <name>`** creates a new project that includes **`AGENTS.md`**, **`CLAUDE.md`**, **`ai/`** (reference docs), **`.cursor/rules/beamable-node-microservice.mdc`**, and a short **`README.md`** pointing at those files.
+
+## TypeScript
+
+Enable decorator metadata in `tsconfig.json`:
+
+```json
+{
+  "compilerOptions": {
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "target": "ES2022"
+  }
+}
+```
+
+## MongoDB / `@StorageObject`
+
+- Decorate a class with `@StorageObject('MyStorage')`.
+- Connection string env var: **`STORAGE_CONNSTR_<MyStorage>`** (see runtime `StorageService` — name is normalized).
+- Optional pool sizing: **`MONGODB_MAX_POOL_SIZE`** (clamped).
+
+Import storage classes **before** services that depend on them so decorators register.
+
+## AI assistants / agents
+
+This package includes **`AGENTS.md`** (short rules), **`CLAUDE.md`** (index for AI tools), and **`ai/RUNTIME_FOR_AI.md`** (deep reference: Dockerfile, env, pitfalls). Point Cursor, Claude Code, Codex, or other tools at those files when generating or refactoring Beamable Node microservices. Optional Cursor rule text lives in **`ai/cursor-rule-snippet.md`**.
+
+## License
+
+MIT

package/ai/RUNTIME_FOR_AI.md

@@ -0,0 +1,145 @@
+# Node Microservice Runtime — reference for AI tools
+
+Companion to **`AGENTS.md`** (rules) and **`README.md`** (human overview). This document is optimized for accuracy and searchability by coding agents.
+
+## Package identity
+
+- **npm**: `@omen.foundation/node-microservice-runtime`
+- **CLI binary**: `beamo-node`
+- **Main export**: ESM `dist/index.js`, CJS `dist/index.cjs` (dual package)
+- **Node**: `engines.node` is `>= 22.14.0`
+
+## Startup sequence (conceptual)
+
+1. `loadDeveloperEnvVarsSync()` reads `beam.env` / `.beam.env` from cwd or `/beam/service/` and fills `process.env` only for keys **not** already set.
+2. `MicroserviceRuntime` constructor validates **at least one** `@Microservice` registration.
+3. Beamable Config fetch runs asynchronously (timeout ~2s); failures are non-fatal.
+4. WebSocket connection to `HOST`, gateway requester, auth, DI container build, health server, route dispatch.
+
+If **`BEAMABLE_SKIP_RUNTIME=true`**, `runMicroservice()` exits before constructing the runtime — used when generating OpenAPI or running validate-only flows.
+
+## Environment variables
+
+### Required for `loadEnvironmentConfig()`
+
+| Variable | Role |
+|----------|------|
+| `CID` | Customer ID |
+| `PID` | Realm / project ID |
+| `HOST` | WebSocket URL (e.g. `wss://api.beamable.com/socket`) |
+
+### Common optional
+
+| Variable | Role |
+|----------|------|
+| `SECRET` | Request signing |
+| `REFRESH_TOKEN` | Token refresh path |
+| `NAME_PREFIX` / `ROUTING_KEY` | Local dev routing; cleared in container when appropriate |
+| `LOG_LEVEL` | Pino level |
+| `HEALTH_PORT` | HTTP health server (default **6565** when unset or ≤0 in practice for deployed images) |
+| `USER_ACCOUNT_ID`, `USER_EMAIL` | Dev / tooling context |
+| `BEAM_INSTANCE_COUNT` | Instance hint |
+| `BEAM_CONFIG_API_PATH` | Override Beamable Config endpoint |
+
+### Beamable Config → env
+
+API values are merged into `process.env` with prefix **`BEAM_CONFIG_`** (details in runtime `env-loader.ts`).
+
+### MongoDB storage
+
+- **`STORAGE_CONNSTR_<StorageName>`** — direct connection string for that `@StorageObject` name.
+- **`MONGODB_MAX_POOL_SIZE`** — pool size clamped between 1 and 100.
+
+## `beam.env` file
+
+- Lines: `KEY=value`, `#` comments.
+- Search paths (first match wins): explicit path (API), `./beam.env`, `./.beam.env`, `/beam/service/beam.env`, `/beam/service/.beam.env`.
+- **Never overwrites** existing `process.env`.
+
+**Production pattern (Omen Wars backend)**:
+
+- Dockerfile **`WORKDIR /beam/service`**
+- **`COPY ... beam.env ./beam.env`**
+- Optionally also load `.env` in dev only via `dotenv` in entry file — keep secrets out of git; use `env.sample` for documentation.
+
+## Entrypoint patterns
+
+### Minimal (example / small services)
+
+```ts
+import 'reflect-metadata';
+import 'dotenv/config';
+import './MyService.js';
+import { runMicroservice } from '@omen.foundation/node-microservice-runtime';
+
+void runMicroservice();
+```
+
+### Larger services (Omen Wars style)
+
+- Guard heavy startup with `BEAMABLE_SKIP_RUNTIME === 'true'`.
+- Explicitly `dotenv.config` for `beam.env` path relative to `dist/` if you need variables **before** custom loggers run (runtime still loads `beam.env` itself for its own logger path).
+- Import **`@StorageObject`** module before the main `@Microservice` module.
+- Call **`void runMicroservice()`** last.
+
+## Docker — recommended production fragment
+
+Multi-stage build: install all deps → `npm run build` → slim runtime image with production `npm install` only.
+
+```dockerfile
+FROM node:22-alpine AS builder
+WORKDIR /build
+COPY package*.json ./
+RUN npm install
+COPY . .
+RUN npm run build
+
+FROM node:22-alpine
+WORKDIR /beam/service
+COPY package*.json ./
+RUN npm install --omit=dev && npm cache clean --force
+
+# Optional but recommended: pre-cache OTel collector to avoid runtime download delay
+RUN mkdir -p /opt/beam/collectors/1.0.1 && \
+    apk add --no-cache wget gzip && \
+    wget https://collectors.beamable.com/version/1.0.1/collector-linux-amd64.gz -O /tmp/collector.gz && \
+    gunzip /tmp/collector.gz && \
+    mv /tmp/collector /opt/beam/collectors/1.0.1/collector-linux-amd64 && \
+    chmod +x /opt/beam/collectors/1.0.1/collector-linux-amd64 && \
+    wget https://collectors.beamable.com/version/1.0.1/clickhouse-config.yaml.gz -O /tmp/config.gz && \
+    gunzip /tmp/config.gz && \
+    mv /tmp/config /opt/beam/collectors/1.0.1/clickhouse-config.yaml && \
+    rm -f /tmp/collector.gz /tmp/config.gz && \
+    apk del wget gzip
+
+COPY --from=builder /build/dist ./dist
+COPY --from=builder /build/beam_openApi.json ./beam_openApi.json
+COPY --from=builder /build/beam.env ./beam.env
+
+EXPOSE 6565
+ENV NODE_ENV=production
+CMD ["node", "dist/main.js"]
+```
+
+Adjust Node major version to match your pinned runtime and `engines`. Older games may still be on Node 20 images — upgrading requires testing.
+
+## OpenAPI and publish
+
+- `beamo-node validate` / `publish` invoke your build and OpenAPI pipeline; they rely on **`BEAMABLE_SKIP_RUNTIME`** so the process does not bind sockets or connect to Beamable as a full runtime.
+- Ensure **`beam_openApi.json`** output path matches `publish-service.mjs` / CLI expectations for your repo (commonly project root).
+
+## Public exports (non-exhaustive)
+
+From `src/index.ts`: decorators (`Microservice`, `Callable`, `ClientCallable`, `ServerCallable`, `AdminCallable`, `SwaggerCategory`, `SwaggerTags`, `ConfigureServices`, `InitializeServices`), types (`EnvironmentConfig`, `RequestContext`, `ServiceDefinition`, …), `BeamableServiceManager`, DI tokens (`LOGGER_TOKEN`, `ENVIRONMENT_CONFIG_TOKEN`, `REQUEST_CONTEXT_TOKEN`, `BEAMABLE_SERVICES_TOKEN`), `loadEnvironmentConfig`, `MicroserviceRuntime`, `runMicroservice`, inventory helpers, `StorageService` / `StorageObject`, federation symbols, collector helpers, `VERSION`.
+
+## Troubleshooting checklist for agents
+
+1. **“No microservices registered”** — Missing `@Microservice` import before `runMicroservice()` or wrong import order.
+2. **Missing CID/PID/HOST** — `.env` not passed to process; Docker missing env; wrong `WORKDIR` so `beam.env` not found **and** no env injected.
+3. **Duplicate route** — Two `@Callable` methods with same `route` string on one service class.
+4. **DI undefined at runtime** — Metadata not emitted; switch to factory `addSingleton` with explicit dependencies.
+5. **Publish hangs** — Side effects at import time (network, Redis, infinite loops). Guard with `BEAMABLE_SKIP_RUNTIME` or move work into `InitializeServices` / `runtime.start` path only.
+
+## Cursor rule file
+
+Use **`beamable-node-microservice.mdc`** in this folder (or the copy under **`.cursor/rules/`** after **`beamo-node scaffold`**). See **`cursor-rule-snippet.md`** for notes.

package/ai/beamable-node-microservice.mdc

@@ -0,0 +1,27 @@
+---
+description: Beamable Node microservices using @omen.foundation/node-microservice-runtime
+globs: "**/*.{ts,tsx,mjs,cjs,json}"
+alwaysApply: false
+---
+
+# Beamable Node microservice (Omen Foundation runtime)
+
+When editing this microservice’s Beamable Node code:
+
+1. Use **`@omen.foundation/node-microservice-runtime`** public APIs only; verify exports in `node_modules/@omen.foundation/node-microservice-runtime/dist/index.d.ts` or the package **README.md** / **AGENTS.md** (root of this repo) / **`ai/RUNTIME_FOR_AI.md`**.
+
+2. **One** class with **`@Microservice('Name')`**; name matches **`package.json` → `beamable.beamoId`**.
+
+3. Start **`main.ts`** with **`import 'reflect-metadata'`**; import **`@StorageObject`** modules before the main service module.
+
+4. End with **`void runMicroservice()`** from the runtime. Respect **`BEAMABLE_SKIP_RUNTIME=true`** — no long-lived work at top level.
+
+5. **Env**: runtime requires **`CID`**, **`PID`**, **`HOST`**. **`beam.env`** in **`/beam/service/`** or cwd; does not override existing **`process.env`**.
+
+6. **Docker**: prefer **`WORKDIR /beam/service`**, copy **`beam.env`**, expose health port (**6565** default).
+
+7. **MongoDB**: **`STORAGE_CONNSTR_<StorageName>`** for **`@StorageObject('StorageName')`**.
+
+8. Use **`beamo-node validate`** / **`publish`** with **`--env-file`** matching the target realm.
+
+For full detail, read **`AGENTS.md`** and **`ai/RUNTIME_FOR_AI.md`** in this project (scaffolded from the runtime package).

package/ai/cursor-rule-snippet.md

@@ -0,0 +1,8 @@
+# Cursor rule for Beamable Node microservices
+
+**Canonical file:** `ai/beamable-node-microservice.mdc` in this package (same content).
+
+- **`beamo-node scaffold`** copies it to **`.cursor/rules/beamable-node-microservice.mdc`** in the new project.
+- To add the rule manually, copy **`ai/beamable-node-microservice.mdc`** into your repo’s **`.cursor/rules/`**.
+
+Adjust `globs` and `alwaysApply` in that file if the microservice lives inside a monorepo.

package/beam.env.example

@@ -0,0 +1,24 @@
+# Beamable Microservice Environment Variables
+# 
+# This file defines developer-specific environment variables that will be
+# loaded into the container at runtime.
+#
+# These variables take priority over Beamable Config values but will NOT
+# overwrite existing process.env values.
+#
+# Format: KEY=value (one per line)
+# Comments start with #
+# Empty lines are ignored
+
+# Example: BetterStack Logging Configuration
+BEAM_BETTERSTACK_ENABLED=true
+BEAM_BETTERSTACK_TOKEN=your-token-here
+
+# Example: Custom configuration
+MY_API_KEY=your-api-key-here
+MY_FEATURE_FLAG=true
+
+# Example: Service-specific settings
+LOG_LEVEL=debug
+MAX_CONNECTIONS=100
+

package/dist/cli/commands/scaffold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/scaffold.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkElE"}
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/scaffold.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmElE"}

package/dist/cli/commands/scaffold.js

@@ -3,6 +3,7 @@
  */
 import fs from 'node:fs/promises';
 import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { toPascalCase, toKebabCase, validateServiceName } from '../utils/name-utils.js';
 import { fetchLatestRuntimeVersion } from '../utils/version-utils.js';
 import { promptInput } from '../utils/prompt-utils.js';
@@ -60,6 +61,7 @@ export async function handleScaffold(args) {
     console.log(`  3. Copy .env.sample to .env and configure your Beamable credentials`);
     console.log(`  4. (Optional) Copy beam.env.example to beam.env for custom environment variables`);
     console.log(`  5. npm run dev`);
+    console.log(`\nAI assistant docs were copied: AGENTS.md, CLAUDE.md, ai/, .cursor/rules/beamable-node-microservice.mdc`);
 }
 /**
  * Generates the complete project structure.
@@ -70,6 +72,8 @@ async function generateProjectStructure(targetDir, options) {
     await fs.mkdir(path.join(targetDir, 'src'), { recursive: true });
     await fs.mkdir(path.join(targetDir, 'src', 'services'), { recursive: true });
     await fs.mkdir(path.join(targetDir, 'dist'), { recursive: true });
+    // Copy AI assistant docs and Cursor rule from the installed runtime package
+    await copyAiAssistantArtifacts(getRuntimePackageRoot(), targetDir);
     // Generate files
     await fs.writeFile(path.join(targetDir, 'package.json'), generatePackageJson(options));
     await fs.writeFile(path.join(targetDir, 'tsconfig.json'), generateTsConfig());
@@ -79,6 +83,65 @@ async function generateProjectStructure(targetDir, options) {
     await fs.writeFile(path.join(targetDir, 'src', 'main.ts'), generateMainTs(options));
     await fs.writeFile(path.join(targetDir, 'src', `${toPascalCase(options.serviceName)}Service.ts`), generateServiceTs(options));
     await fs.writeFile(path.join(targetDir, 'src', 'services', 'example-domain-service.ts'), generateDomainServiceTs());
+    await fs.writeFile(path.join(targetDir, 'README.md'), generateProjectReadme(options));
+}
+/**
+ * Directory containing package.json for @omen.foundation/node-microservice-runtime
+ * (dist/cli/commands/*.js → ../../../).
+ */
+function getRuntimePackageRoot() {
+    return path.join(path.dirname(fileURLToPath(import.meta.url)), '..', '..', '..');
+}
+/**
+ * Copies AGENTS.md, CLAUDE.md, ai/*.md, and the Cursor rule into the scaffolded project.
+ */
+async function copyAiAssistantArtifacts(runtimeRoot, targetDir) {
+    const copies = [
+        { relFrom: 'AGENTS.md', relTo: 'AGENTS.md' },
+        { relFrom: 'CLAUDE.md', relTo: 'CLAUDE.md' },
+        { relFrom: path.join('ai', 'RUNTIME_FOR_AI.md'), relTo: path.join('ai', 'RUNTIME_FOR_AI.md') },
+        { relFrom: path.join('ai', 'cursor-rule-snippet.md'), relTo: path.join('ai', 'cursor-rule-snippet.md') },
+        {
+            relFrom: path.join('ai', 'beamable-node-microservice.mdc'),
+            relTo: path.join('.cursor', 'rules', 'beamable-node-microservice.mdc'),
+        },
+    ];
+    for (const { relFrom, relTo } of copies) {
+        const src = path.join(runtimeRoot, relFrom);
+        const dest = path.join(targetDir, relTo);
+        await fs.mkdir(path.dirname(dest), { recursive: true });
+        const content = await fs.readFile(src, 'utf-8');
+        await fs.writeFile(dest, content, 'utf-8');
+    }
+}
+/**
+ * Short project README; AI docs are copied alongside from the runtime package.
+ */
+function generateProjectReadme(options) {
+    const title = options.displayName ?? options.serviceName;
+    return `# ${title}
+
+Beamable Node microservice scaffolded with **\`beamo-node scaffold\`**.
+
+## Documentation in this project
+
+| Path | Purpose |
+|------|---------|
+| **AGENTS.md** | Rules for AI coding agents (Cursor, Claude, Codex, …) |
+| **CLAUDE.md** | Index pointing at the AI docs below |
+| **ai/RUNTIME_FOR_AI.md** | Full runtime reference (env, Docker, troubleshooting) |
+| **ai/cursor-rule-snippet.md** | Notes on the Cursor rule file |
+| **.cursor/rules/beamable-node-microservice.mdc** | Cursor rule (tune \`globs\` if this service lives in a monorepo) |
+
+After **\`npm install\`**, the same topics are also under **\`node_modules/@omen.foundation/node-microservice-runtime/\`**.
+
+## Scripts
+
+- **\`npm run dev\`** — local development
+- **\`npm run validate\`** / **\`npm run publish\`** — Beamable CLI (\`beamo-node\`)
+
+Configure **\`.env\`** from **\`.env.sample\`** and optionally **\`beam.env\`** from **\`beam.env.example\`**.
+`;
 }
 /**
  * Generates package.json content.
@@ -103,6 +166,7 @@ function generatePackageJson(options) {
             '@omen.foundation/node-microservice-runtime': `^${options.runtimeVersion}`,
             dotenv: '^16.4.7',
             mongodb: '^6.10.0',
+            'reflect-metadata': '^0.2.2',
         },
         devDependencies: {
             '@types/node': '^20.11.30',
@@ -215,7 +279,8 @@ beam.env
  */
 function generateMainTs(options) {
     const serviceNamePascal = toPascalCase(options.serviceName);
-    return `import 'dotenv/config';
+    return `import 'reflect-metadata';
+import 'dotenv/config';
 import './${serviceNamePascal}Service.js';
 import { runMicroservice } from '@omen.foundation/node-microservice-runtime';
 

package/dist/cli/commands/scaffold.js.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../../src/cli/commands/scaffold.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * Command handler for scaffolding new microservice projects.\r\n */\r\n\r\nimport fs from 'node:fs/promises';\r\nimport path from 'node:path';\r\nimport { toPascalCase, toKebabCase, validateServiceName } from '../utils/name-utils.js';\r\nimport { fetchLatestRuntimeVersion } from '../utils/version-utils.js';\r\nimport { promptInput } from '../utils/prompt-utils.js';\r\n\r\ninterface ScaffoldOptions {\r\n  serviceName: string;\r\n  displayName?: string;\r\n  beamoId?: string;\r\n  runtimeVersion: string;\r\n}\r\n\r\n/**\r\n * Handles the scaffold command.\r\n */\r\nexport async function handleScaffold(args: string[]): Promise<void> {\r\n  let serviceName = args[0];\r\n\r\n  // Interactive prompt for service name if not provided\r\n  if (!serviceName) {\r\n    serviceName = await promptInput('Enter microservice name (alphanumeric and underscores only)');\r\n  }\r\n\r\n  // Validate service name\r\n  if (!serviceName || !validateServiceName(serviceName)) {\r\n    throw new Error(\r\n      `Invalid microservice name \"${serviceName}\". Only alphanumeric and underscore characters are allowed.`,\r\n    );\r\n  }\r\n\r\n  // Fetch latest runtime version\r\n  console.log('Fetching latest runtime version...');\r\n  const runtimeVersion = await fetchLatestRuntimeVersion();\r\n  console.log(`Using @omen.foundation/node-microservice-runtime version ${runtimeVersion}`);\r\n\r\n  // Prompt for optional values\r\n  const displayName = await promptInput('Enter display name for the service (optional)', serviceName);\r\n  const beamoId = await promptInput('Enter Beamable Beamo ID (optional, defaults to service name)', serviceName);\r\n\r\n  // Validate beamoId\r\n  if (beamoId && !validateServiceName(beamoId)) {\r\n    throw new Error(\r\n      `Invalid Beamo ID \"${beamoId}\". Only alphanumeric and underscore characters are allowed.`,\r\n    );\r\n  }\r\n\r\n  const options: ScaffoldOptions = {\r\n    serviceName,\r\n    displayName: displayName || serviceName,\r\n    beamoId: beamoId || serviceName,\r\n    runtimeVersion,\r\n  };\r\n\r\n  // Check if directory already exists\r\n  const targetDir = path.resolve(process.cwd(), serviceName);\r\n  try {\r\n    await fs.access(targetDir);\r\n    const overwrite = await promptInput(\r\n      `Directory \"${serviceName}\" already exists. Overwrite? (y/n)`,\r\n      'n',\r\n    );\r\n    if (overwrite.toLowerCase() !== 'y' && overwrite.toLowerCase() !== 'yes') {\r\n      console.log('Scaffold cancelled.');\r\n      return;\r\n    }\r\n    // Remove existing directory\r\n    await fs.rm(targetDir, { recursive: true, force: true });\r\n  } catch {\r\n    // Directory doesn't exist, that's fine\r\n  }\r\n\r\n  // Generate project structure\r\n  await generateProjectStructure(targetDir, options);\r\n\r\n  console.log(`\\n✅ Successfully scaffolded microservice \"${serviceName}\"!`);\r\n  console.log(`\\nNext steps:`);\r\n  console.log(`  1. cd ${serviceName}`);\r\n  console.log(`  2. npm install`);\r\n  console.log(`  3. Copy .env.sample to .env and configure your Beamable credentials`);\r\n  console.log(`  4. (Optional) Copy beam.env.example to beam.env for custom environment variables`);\r\n  console.log(`  5. npm run dev`);\r\n}\r\n\r\n/**\r\n * Generates the complete project structure.\r\n */\r\nasync function generateProjectStructure(targetDir: string, options: ScaffoldOptions): Promise<void> {\r\n  // Create directories\r\n  await fs.mkdir(targetDir, { recursive: true });\r\n  await fs.mkdir(path.join(targetDir, 'src'), { recursive: true });\r\n  await fs.mkdir(path.join(targetDir, 'src', 'services'), { recursive: true });\r\n  await fs.mkdir(path.join(targetDir, 'dist'), { recursive: true });\r\n\r\n  // Generate files\r\n  await fs.writeFile(path.join(targetDir, 'package.json'), generatePackageJson(options));\r\n  await fs.writeFile(path.join(targetDir, 'tsconfig.json'), generateTsConfig());\r\n  await fs.writeFile(path.join(targetDir, '.env.sample'), generateEnvSample());\r\n  await fs.writeFile(path.join(targetDir, 'beam.env.example'), generateBeamEnvExample());\r\n  await fs.writeFile(path.join(targetDir, '.gitignore'), generateGitIgnore());\r\n  await fs.writeFile(path.join(targetDir, 'src', 'main.ts'), generateMainTs(options));\r\n  await fs.writeFile(\r\n    path.join(targetDir, 'src', `${toPascalCase(options.serviceName)}Service.ts`),\r\n    generateServiceTs(options),\r\n  );\r\n  await fs.writeFile(\r\n    path.join(targetDir, 'src', 'services', 'example-domain-service.ts'),\r\n    generateDomainServiceTs(),\r\n  );\r\n}\r\n\r\n/**\r\n * Generates package.json content.\r\n */\r\nfunction generatePackageJson(options: ScaffoldOptions): string {\r\n  const serviceNameKebab = toKebabCase(options.serviceName);\r\n  const packageName = `@beamable/${serviceNameKebab}-node-microservice`;\r\n\r\n  return JSON.stringify(\r\n    {\r\n      name: packageName,\r\n      version: '0.1.0',\r\n      private: true,\r\n      type: 'module',\r\n      main: 'dist/main.js',\r\n      types: 'dist/main.d.ts',\r\n      scripts: {\r\n        dev: 'tsx --env-file .env src/main.ts',\r\n        build: 'tsc -p tsconfig.json',\r\n        validate: 'npx beamo-node validate --env-file .env',\r\n        publish: 'npx beamo-node publish --env-file .env',\r\n      },\r\n      dependencies: {\r\n        '@omen.foundation/node-microservice-runtime': `^${options.runtimeVersion}`,\r\n        dotenv: '^16.4.7',\r\n        mongodb: '^6.10.0',\r\n      },\r\n      devDependencies: {\r\n        '@types/node': '^20.11.30',\r\n        'pino-pretty': '^13.0.0',\r\n        tsx: '^4.19.2',\r\n        typescript: '^5.4.5',\r\n      },\r\n      beamable: {\r\n        beamoId: options.beamoId,\r\n        projectType: 'service',\r\n      },\r\n    },\r\n    null,\r\n    2,\r\n  );\r\n}\r\n\r\n/**\r\n * Generates tsconfig.json content.\r\n * Includes all necessary compiler options directly to avoid dependency on base config.\r\n */\r\nfunction generateTsConfig(): string {\r\n  return JSON.stringify(\r\n    {\r\n      compilerOptions: {\r\n        target: 'ES2022',\r\n        module: 'NodeNext',\r\n        moduleResolution: 'NodeNext',\r\n        esModuleInterop: true,\r\n        forceConsistentCasingInFileNames: true,\r\n        strict: true,\r\n        skipLibCheck: false,\r\n        noImplicitOverride: true,\r\n        noUnusedLocals: true,\r\n        noUnusedParameters: true,\r\n        resolveJsonModule: true,\r\n        sourceMap: true,\r\n        inlineSources: true,\r\n        experimentalDecorators: true,\r\n        emitDecoratorMetadata: true,\r\n        types: ['node'],\r\n        outDir: 'dist',\r\n        rootDir: 'src',\r\n        declaration: true,\r\n        declarationMap: true,\r\n      },\r\n      include: ['src/**/*.ts'],\r\n      exclude: ['dist', 'node_modules'],\r\n    },\r\n    null,\r\n    2,\r\n  );\r\n}\r\n\r\n/**\r\n * Generates .env.sample content.\r\n */\r\nfunction generateEnvSample(): string {\r\n  return `# Beamable Authentication & Configuration\r\n# This file is for Beamable-specific credentials (CID, PID, SECRET, etc.)\r\n# For custom environment variables, use beam.env instead (see beam.env.example)\r\n\r\nCID=\r\nPID=\r\nHOST=wss://api.beamable.com/socket\r\nSECRET=\r\nNAME_PREFIX=\r\nLOG_LEVEL=info\r\nBEAMABLE_TOKEN=\r\nBEAMABLE_API_HOST=https://api.beamable.com\r\nBEAMABLE_GAME_PID=\r\n`;\r\n}\r\n\r\n/**\r\n * Generates beam.env.example content.\r\n */\r\nfunction generateBeamEnvExample(): string {\r\n  return `# Beamable Microservice Environment Variables\r\n# \r\n# This file defines developer-specific environment variables that will be\r\n# loaded into the container at runtime.\r\n#\r\n# These variables take priority over Beamable Config values but will NOT\r\n# overwrite existing process.env values.\r\n#\r\n# Format: KEY=value (one per line)\r\n# Comments start with #\r\n# Empty lines are ignored\r\n\r\n# Example: BetterStack Logging Configuration\r\n# BEAM_BETTERSTACK_ENABLED=true\r\n# BEAM_BETTERSTACK_TOKEN=your-token-here\r\n\r\n# Example: Custom configuration\r\n# MY_API_KEY=your-api-key-here\r\n# MY_FEATURE_FLAG=true\r\n\r\n# Example: Service-specific settings\r\n# LOG_LEVEL=debug\r\n# MAX_CONNECTIONS=100\r\n`;\r\n}\r\n\r\n/**\r\n * Generates .gitignore content.\r\n */\r\nfunction generateGitIgnore(): string {\r\n  return `node_modules/\r\ndist/\r\n.env\r\n.env.local\r\nbeam.env\r\n.beam.env\r\n*.log\r\n.DS_Store\r\n`;\r\n}\r\n\r\n/**\r\n * Generates main.ts content.\r\n */\r\nfunction generateMainTs(options: ScaffoldOptions): string {\r\n  const serviceNamePascal = toPascalCase(options.serviceName);\r\n  return `import 'dotenv/config';\r\nimport './${serviceNamePascal}Service.js';\r\nimport { runMicroservice } from '@omen.foundation/node-microservice-runtime';\r\n\r\nvoid runMicroservice();\r\n`;\r\n}\r\n\r\n/**\r\n * Generates the main service class file.\r\n */\r\nfunction generateServiceTs(options: ScaffoldOptions): string {\r\n  const serviceNamePascal = toPascalCase(options.serviceName);\r\n  return `import {\r\n  Microservice,\r\n  Callable,\r\n  ClientCallable,\r\n  ServerCallable,\r\n  SwaggerCategory,\r\n  ConfigureServices,\r\n  type DependencyBuilder,\r\n  type RequestContext,\r\n} from '@omen.foundation/node-microservice-runtime';\r\nimport { ExampleDomainService } from './services/example-domain-service.js';\r\n\r\n@Microservice('${options.serviceName}')\r\nexport class ${serviceNamePascal}Service {\r\n  @ConfigureServices\r\n  static register(builder: DependencyBuilder): void {\r\n    builder.addSingletonClass(ExampleDomainService);\r\n  }\r\n\r\n  /**\r\n   * Example of a public Callable endpoint.\r\n   * No authentication required.\r\n   */\r\n  @Callable({ route: 'isTwo' })\r\n  @SwaggerCategory('Examples')\r\n  async isTwo(_ctx: RequestContext): Promise<boolean> {\r\n    return 1 + 1 === 2;\r\n  }\r\n\r\n  /**\r\n   * Example of a ClientCallable endpoint.\r\n   * Requires user authentication (client scope).\r\n   */\r\n  @ClientCallable({ route: 'isThree' })\r\n  @SwaggerCategory('Examples')\r\n  async isThree(_ctx: RequestContext): Promise<boolean> {\r\n    return 1 + 2 === 3;\r\n  }\r\n\r\n  /**\r\n   * Example of a ServerCallable endpoint.\r\n   * Requires server authentication (server scope).\r\n   */\r\n  @ServerCallable({ route: 'isFour' })\r\n  @SwaggerCategory('Examples')\r\n  async isFour(_ctx: RequestContext): Promise<boolean> {\r\n    return 2 + 2 === 4;\r\n  }\r\n}\r\n`;\r\n}\r\n\r\n/**\r\n * Generates example domain service content.\r\n */\r\nfunction generateDomainServiceTs(): string {\r\n  return `import type { RequestContext } from '@omen.foundation/node-microservice-runtime';\r\n\r\nexport class ExampleDomainService {\r\n  greet(userId: number): string {\r\n    return \\`Hello from Node microservices, user \\${userId}!\\`;\r\n  }\r\n\r\n  async getServiceInfo(_ctx: RequestContext): Promise<{ service: string; version: string }> {\r\n    return {\r\n      service: 'ExampleDomainService',\r\n      version: '1.0.0',\r\n    };\r\n  }\r\n}\r\n`;\r\n}\r\n\r\n"]}
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../../src/cli/commands/scaffold.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AASvD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAc;IACjD,IAAI,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAE1B,sDAAsD;IACtD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,WAAW,GAAG,MAAM,WAAW,CAAC,6DAA6D,CAAC,CAAC;IACjG,CAAC;IAED,wBAAwB;IACxB,IAAI,CAAC,WAAW,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CACb,8BAA8B,WAAW,6DAA6D,CACvG,CAAC;IACJ,CAAC;IAED,+BAA+B;IAC/B,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;IAClD,MAAM,cAAc,GAAG,MAAM,yBAAyB,EAAE,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,4DAA4D,cAAc,EAAE,CAAC,CAAC;IAE1F,6BAA6B;IAC7B,MAAM,WAAW,GAAG,MAAM,WAAW,CAAC,+CAA+C,EAAE,WAAW,CAAC,CAAC;IACpG,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,8DAA8D,EAAE,WAAW,CAAC,CAAC;IAE/G,mBAAmB;IACnB,IAAI,OAAO,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACb,qBAAqB,OAAO,6DAA6D,CAC1F,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAoB;QAC/B,WAAW;QACX,WAAW,EAAE,WAAW,IAAI,WAAW;QACvC,OAAO,EAAE,OAAO,IAAI,WAAW;QAC/B,cAAc;KACf,CAAC;IAEF,oCAAoC;IACpC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC,CAAC;IAC3D,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC3B,MAAM,SAAS,GAAG,MAAM,WAAW,CACjC,cAAc,WAAW,oCAAoC,EAC7D,GAAG,CACJ,CAAC;QACF,IAAI,SAAS,CAAC,WAAW,EAAE,KAAK,GAAG,IAAI,SAAS,CAAC,WAAW,EAAE,KAAK,KAAK,EAAE,CAAC;YACzE,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;YACnC,OAAO;QACT,CAAC;QACD,4BAA4B;QAC5B,MAAM,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,uCAAuC;IACzC,CAAC;IAED,6BAA6B;IAC7B,MAAM,wBAAwB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAEnD,OAAO,CAAC,GAAG,CAAC,6CAA6C,WAAW,IAAI,CAAC,CAAC;IAC1E,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAC7B,OAAO,CAAC,GAAG,CAAC,WAAW,WAAW,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,CAAC,oFAAoF,CAAC,CAAC;IAClG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,0GAA0G,CAAC,CAAC;AAC1H,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,wBAAwB,CAAC,SAAiB,EAAE,OAAwB;IACjF,qBAAqB;IACrB,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7E,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAElE,4EAA4E;IAC5E,MAAM,wBAAwB,CAAC,qBAAqB,EAAE,EAAE,SAAS,CAAC,CAAC;IAEnE,iBAAiB;IACjB,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;IACvF,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAC9E,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC7E,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,EAAE,sBAAsB,EAAE,CAAC,CAAC;IACvF,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC5E,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IACpF,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,EAC7E,iBAAiB,CAAC,OAAO,CAAC,CAC3B,CAAC;IACF,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,2BAA2B,CAAC,EACpE,uBAAuB,EAAE,CAC1B,CAAC;IACF,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;AACxF,CAAC;AAED;;;GAGG;AACH,SAAS,qBAAqB;IAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACnF,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,wBAAwB,CAAC,WAAmB,EAAE,SAAiB;IAC5E,MAAM,MAAM,GAA8C;QACxD,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE;QAC5C,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE;QAC5C,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,EAAE;QAC9F,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,wBAAwB,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,wBAAwB,CAAC,EAAE;QACxG;YACE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,gCAAgC,CAAC;YAC1D,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,gCAAgC,CAAC;SACvE;KACF,CAAC;IAEF,KAAK,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,MAAM,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACzC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,OAAwB;IACrD,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IACzD,OAAO,KAAK,KAAK;;;;;;;;;;;;;;;;;;;;;;CAsBlB,CAAC;AACF,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,OAAwB;IACnD,MAAM,gBAAgB,GAAG,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,aAAa,gBAAgB,oBAAoB,CAAC;IAEtE,OAAO,IAAI,CAAC,SAAS,CACnB;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,gBAAgB;QACvB,OAAO,EAAE;YACP,GAAG,EAAE,iCAAiC;YACtC,KAAK,EAAE,sBAAsB;YAC7B,QAAQ,EAAE,yCAAyC;YACnD,OAAO,EAAE,wCAAwC;SAClD;QACD,YAAY,EAAE;YACZ,4CAA4C,EAAE,IAAI,OAAO,CAAC,cAAc,EAAE;YAC1E,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,SAAS;YAClB,kBAAkB,EAAE,QAAQ;SAC7B;QACD,eAAe,EAAE;YACf,aAAa,EAAE,WAAW;YAC1B,aAAa,EAAE,SAAS;YACxB,GAAG,EAAE,SAAS;YACd,UAAU,EAAE,QAAQ;SACrB;QACD,QAAQ,EAAE;YACR,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,WAAW,EAAE,SAAS;SACvB;KACF,EACD,IAAI,EACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB;IACvB,OAAO,IAAI,CAAC,SAAS,CACnB;QACE,eAAe,EAAE;YACf,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,UAAU;YAClB,gBAAgB,EAAE,UAAU;YAC5B,eAAe,EAAE,IAAI;YACrB,gCAAgC,EAAE,IAAI;YACtC,MAAM,EAAE,IAAI;YACZ,YAAY,EAAE,KAAK;YACnB,kBAAkB,EAAE,IAAI;YACxB,cAAc,EAAE,IAAI;YACpB,kBAAkB,EAAE,IAAI;YACxB,iBAAiB,EAAE,IAAI;YACvB,SAAS,EAAE,IAAI;YACf,aAAa,EAAE,IAAI;YACnB,sBAAsB,EAAE,IAAI;YAC5B,qBAAqB,EAAE,IAAI;YAC3B,KAAK,EAAE,CAAC,MAAM,CAAC;YACf,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,IAAI;YACjB,cAAc,EAAE,IAAI;SACrB;QACD,OAAO,EAAE,CAAC,aAAa,CAAC;QACxB,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC;KAClC,EACD,IAAI,EACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB;IACxB,OAAO;;;;;;;;;;;;;CAaR,CAAC;AACF,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB;IAC7B,OAAO;;;;;;;;;;;;;;;;;;;;;;;CAuBR,CAAC;AACF,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB;IACxB,OAAO;;;;;;;;CAQR,CAAC;AACF,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,OAAwB;IAC9C,MAAM,iBAAiB,GAAG,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5D,OAAO;;YAEG,iBAAiB;;;;CAI5B,CAAC;AACF,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,OAAwB;IACjD,MAAM,iBAAiB,GAAG,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5D,OAAO;;;;;;;;;;;;iBAYQ,OAAO,CAAC,WAAW;eACrB,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoC/B,CAAC;AACF,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB;IAC9B,OAAO;;;;;;;;;;;;;;CAcR,CAAC;AACF,CAAC","sourcesContent":["/**\r\n * Command handler for scaffolding new microservice projects.\r\n */\r\n\r\nimport fs from 'node:fs/promises';\r\nimport path from 'node:path';\r\nimport { fileURLToPath } from 'node:url';\r\nimport { toPascalCase, toKebabCase, validateServiceName } from '../utils/name-utils.js';\r\nimport { fetchLatestRuntimeVersion } from '../utils/version-utils.js';\r\nimport { promptInput } from '../utils/prompt-utils.js';\r\n\r\ninterface ScaffoldOptions {\r\n  serviceName: string;\r\n  displayName?: string;\r\n  beamoId?: string;\r\n  runtimeVersion: string;\r\n}\r\n\r\n/**\r\n * Handles the scaffold command.\r\n */\r\nexport async function handleScaffold(args: string[]): Promise<void> {\r\n  let serviceName = args[0];\r\n\r\n  // Interactive prompt for service name if not provided\r\n  if (!serviceName) {\r\n    serviceName = await promptInput('Enter microservice name (alphanumeric and underscores only)');\r\n  }\r\n\r\n  // Validate service name\r\n  if (!serviceName || !validateServiceName(serviceName)) {\r\n    throw new Error(\r\n      `Invalid microservice name \"${serviceName}\". Only alphanumeric and underscore characters are allowed.`,\r\n    );\r\n  }\r\n\r\n  // Fetch latest runtime version\r\n  console.log('Fetching latest runtime version...');\r\n  const runtimeVersion = await fetchLatestRuntimeVersion();\r\n  console.log(`Using @omen.foundation/node-microservice-runtime version ${runtimeVersion}`);\r\n\r\n  // Prompt for optional values\r\n  const displayName = await promptInput('Enter display name for the service (optional)', serviceName);\r\n  const beamoId = await promptInput('Enter Beamable Beamo ID (optional, defaults to service name)', serviceName);\r\n\r\n  // Validate beamoId\r\n  if (beamoId && !validateServiceName(beamoId)) {\r\n    throw new Error(\r\n      `Invalid Beamo ID \"${beamoId}\". Only alphanumeric and underscore characters are allowed.`,\r\n    );\r\n  }\r\n\r\n  const options: ScaffoldOptions = {\r\n    serviceName,\r\n    displayName: displayName || serviceName,\r\n    beamoId: beamoId || serviceName,\r\n    runtimeVersion,\r\n  };\r\n\r\n  // Check if directory already exists\r\n  const targetDir = path.resolve(process.cwd(), serviceName);\r\n  try {\r\n    await fs.access(targetDir);\r\n    const overwrite = await promptInput(\r\n      `Directory \"${serviceName}\" already exists. Overwrite? (y/n)`,\r\n      'n',\r\n    );\r\n    if (overwrite.toLowerCase() !== 'y' && overwrite.toLowerCase() !== 'yes') {\r\n      console.log('Scaffold cancelled.');\r\n      return;\r\n    }\r\n    // Remove existing directory\r\n    await fs.rm(targetDir, { recursive: true, force: true });\r\n  } catch {\r\n    // Directory doesn't exist, that's fine\r\n  }\r\n\r\n  // Generate project structure\r\n  await generateProjectStructure(targetDir, options);\r\n\r\n  console.log(`\\n✅ Successfully scaffolded microservice \"${serviceName}\"!`);\r\n  console.log(`\\nNext steps:`);\r\n  console.log(`  1. cd ${serviceName}`);\r\n  console.log(`  2. npm install`);\r\n  console.log(`  3. Copy .env.sample to .env and configure your Beamable credentials`);\r\n  console.log(`  4. (Optional) Copy beam.env.example to beam.env for custom environment variables`);\r\n  console.log(`  5. npm run dev`);\r\n  console.log(`\\nAI assistant docs were copied: AGENTS.md, CLAUDE.md, ai/, .cursor/rules/beamable-node-microservice.mdc`);\r\n}\r\n\r\n/**\r\n * Generates the complete project structure.\r\n */\r\nasync function generateProjectStructure(targetDir: string, options: ScaffoldOptions): Promise<void> {\r\n  // Create directories\r\n  await fs.mkdir(targetDir, { recursive: true });\r\n  await fs.mkdir(path.join(targetDir, 'src'), { recursive: true });\r\n  await fs.mkdir(path.join(targetDir, 'src', 'services'), { recursive: true });\r\n  await fs.mkdir(path.join(targetDir, 'dist'), { recursive: true });\r\n\r\n  // Copy AI assistant docs and Cursor rule from the installed runtime package\r\n  await copyAiAssistantArtifacts(getRuntimePackageRoot(), targetDir);\r\n\r\n  // Generate files\r\n  await fs.writeFile(path.join(targetDir, 'package.json'), generatePackageJson(options));\r\n  await fs.writeFile(path.join(targetDir, 'tsconfig.json'), generateTsConfig());\r\n  await fs.writeFile(path.join(targetDir, '.env.sample'), generateEnvSample());\r\n  await fs.writeFile(path.join(targetDir, 'beam.env.example'), generateBeamEnvExample());\r\n  await fs.writeFile(path.join(targetDir, '.gitignore'), generateGitIgnore());\r\n  await fs.writeFile(path.join(targetDir, 'src', 'main.ts'), generateMainTs(options));\r\n  await fs.writeFile(\r\n    path.join(targetDir, 'src', `${toPascalCase(options.serviceName)}Service.ts`),\r\n    generateServiceTs(options),\r\n  );\r\n  await fs.writeFile(\r\n    path.join(targetDir, 'src', 'services', 'example-domain-service.ts'),\r\n    generateDomainServiceTs(),\r\n  );\r\n  await fs.writeFile(path.join(targetDir, 'README.md'), generateProjectReadme(options));\r\n}\r\n\r\n/**\r\n * Directory containing package.json for @omen.foundation/node-microservice-runtime\r\n * (dist/cli/commands/*.js → ../../../).\r\n */\r\nfunction getRuntimePackageRoot(): string {\r\n  return path.join(path.dirname(fileURLToPath(import.meta.url)), '..', '..', '..');\r\n}\r\n\r\n/**\r\n * Copies AGENTS.md, CLAUDE.md, ai/*.md, and the Cursor rule into the scaffolded project.\r\n */\r\nasync function copyAiAssistantArtifacts(runtimeRoot: string, targetDir: string): Promise<void> {\r\n  const copies: Array<{ relFrom: string; relTo: string }> = [\r\n    { relFrom: 'AGENTS.md', relTo: 'AGENTS.md' },\r\n    { relFrom: 'CLAUDE.md', relTo: 'CLAUDE.md' },\r\n    { relFrom: path.join('ai', 'RUNTIME_FOR_AI.md'), relTo: path.join('ai', 'RUNTIME_FOR_AI.md') },\r\n    { relFrom: path.join('ai', 'cursor-rule-snippet.md'), relTo: path.join('ai', 'cursor-rule-snippet.md') },\r\n    {\r\n      relFrom: path.join('ai', 'beamable-node-microservice.mdc'),\r\n      relTo: path.join('.cursor', 'rules', 'beamable-node-microservice.mdc'),\r\n    },\r\n  ];\r\n\r\n  for (const { relFrom, relTo } of copies) {\r\n    const src = path.join(runtimeRoot, relFrom);\r\n    const dest = path.join(targetDir, relTo);\r\n    await fs.mkdir(path.dirname(dest), { recursive: true });\r\n    const content = await fs.readFile(src, 'utf-8');\r\n    await fs.writeFile(dest, content, 'utf-8');\r\n  }\r\n}\r\n\r\n/**\r\n * Short project README; AI docs are copied alongside from the runtime package.\r\n */\r\nfunction generateProjectReadme(options: ScaffoldOptions): string {\r\n  const title = options.displayName ?? options.serviceName;\r\n  return `# ${title}\r\n\r\nBeamable Node microservice scaffolded with **\\`beamo-node scaffold\\`**.\r\n\r\n## Documentation in this project\r\n\r\n| Path | Purpose |\r\n|------|---------|\r\n| **AGENTS.md** | Rules for AI coding agents (Cursor, Claude, Codex, …) |\r\n| **CLAUDE.md** | Index pointing at the AI docs below |\r\n| **ai/RUNTIME_FOR_AI.md** | Full runtime reference (env, Docker, troubleshooting) |\r\n| **ai/cursor-rule-snippet.md** | Notes on the Cursor rule file |\r\n| **.cursor/rules/beamable-node-microservice.mdc** | Cursor rule (tune \\`globs\\` if this service lives in a monorepo) |\r\n\r\nAfter **\\`npm install\\`**, the same topics are also under **\\`node_modules/@omen.foundation/node-microservice-runtime/\\`**.\r\n\r\n## Scripts\r\n\r\n- **\\`npm run dev\\`** — local development\r\n- **\\`npm run validate\\`** / **\\`npm run publish\\`** — Beamable CLI (\\`beamo-node\\`)\r\n\r\nConfigure **\\`.env\\`** from **\\`.env.sample\\`** and optionally **\\`beam.env\\`** from **\\`beam.env.example\\`**.\r\n`;\r\n}\r\n\r\n/**\r\n * Generates package.json content.\r\n */\r\nfunction generatePackageJson(options: ScaffoldOptions): string {\r\n  const serviceNameKebab = toKebabCase(options.serviceName);\r\n  const packageName = `@beamable/${serviceNameKebab}-node-microservice`;\r\n\r\n  return JSON.stringify(\r\n    {\r\n      name: packageName,\r\n      version: '0.1.0',\r\n      private: true,\r\n      type: 'module',\r\n      main: 'dist/main.js',\r\n      types: 'dist/main.d.ts',\r\n      scripts: {\r\n        dev: 'tsx --env-file .env src/main.ts',\r\n        build: 'tsc -p tsconfig.json',\r\n        validate: 'npx beamo-node validate --env-file .env',\r\n        publish: 'npx beamo-node publish --env-file .env',\r\n      },\r\n      dependencies: {\r\n        '@omen.foundation/node-microservice-runtime': `^${options.runtimeVersion}`,\r\n        dotenv: '^16.4.7',\r\n        mongodb: '^6.10.0',\r\n        'reflect-metadata': '^0.2.2',\r\n      },\r\n      devDependencies: {\r\n        '@types/node': '^20.11.30',\r\n        'pino-pretty': '^13.0.0',\r\n        tsx: '^4.19.2',\r\n        typescript: '^5.4.5',\r\n      },\r\n      beamable: {\r\n        beamoId: options.beamoId,\r\n        projectType: 'service',\r\n      },\r\n    },\r\n    null,\r\n    2,\r\n  );\r\n}\r\n\r\n/**\r\n * Generates tsconfig.json content.\r\n * Includes all necessary compiler options directly to avoid dependency on base config.\r\n */\r\nfunction generateTsConfig(): string {\r\n  return JSON.stringify(\r\n    {\r\n      compilerOptions: {\r\n        target: 'ES2022',\r\n        module: 'NodeNext',\r\n        moduleResolution: 'NodeNext',\r\n        esModuleInterop: true,\r\n        forceConsistentCasingInFileNames: true,\r\n        strict: true,\r\n        skipLibCheck: false,\r\n        noImplicitOverride: true,\r\n        noUnusedLocals: true,\r\n        noUnusedParameters: true,\r\n        resolveJsonModule: true,\r\n        sourceMap: true,\r\n        inlineSources: true,\r\n        experimentalDecorators: true,\r\n        emitDecoratorMetadata: true,\r\n        types: ['node'],\r\n        outDir: 'dist',\r\n        rootDir: 'src',\r\n        declaration: true,\r\n        declarationMap: true,\r\n      },\r\n      include: ['src/**/*.ts'],\r\n      exclude: ['dist', 'node_modules'],\r\n    },\r\n    null,\r\n    2,\r\n  );\r\n}\r\n\r\n/**\r\n * Generates .env.sample content.\r\n */\r\nfunction generateEnvSample(): string {\r\n  return `# Beamable Authentication & Configuration\r\n# This file is for Beamable-specific credentials (CID, PID, SECRET, etc.)\r\n# For custom environment variables, use beam.env instead (see beam.env.example)\r\n\r\nCID=\r\nPID=\r\nHOST=wss://api.beamable.com/socket\r\nSECRET=\r\nNAME_PREFIX=\r\nLOG_LEVEL=info\r\nBEAMABLE_TOKEN=\r\nBEAMABLE_API_HOST=https://api.beamable.com\r\nBEAMABLE_GAME_PID=\r\n`;\r\n}\r\n\r\n/**\r\n * Generates beam.env.example content.\r\n */\r\nfunction generateBeamEnvExample(): string {\r\n  return `# Beamable Microservice Environment Variables\r\n# \r\n# This file defines developer-specific environment variables that will be\r\n# loaded into the container at runtime.\r\n#\r\n# These variables take priority over Beamable Config values but will NOT\r\n# overwrite existing process.env values.\r\n#\r\n# Format: KEY=value (one per line)\r\n# Comments start with #\r\n# Empty lines are ignored\r\n\r\n# Example: BetterStack Logging Configuration\r\n# BEAM_BETTERSTACK_ENABLED=true\r\n# BEAM_BETTERSTACK_TOKEN=your-token-here\r\n\r\n# Example: Custom configuration\r\n# MY_API_KEY=your-api-key-here\r\n# MY_FEATURE_FLAG=true\r\n\r\n# Example: Service-specific settings\r\n# LOG_LEVEL=debug\r\n# MAX_CONNECTIONS=100\r\n`;\r\n}\r\n\r\n/**\r\n * Generates .gitignore content.\r\n */\r\nfunction generateGitIgnore(): string {\r\n  return `node_modules/\r\ndist/\r\n.env\r\n.env.local\r\nbeam.env\r\n.beam.env\r\n*.log\r\n.DS_Store\r\n`;\r\n}\r\n\r\n/**\r\n * Generates main.ts content.\r\n */\r\nfunction generateMainTs(options: ScaffoldOptions): string {\r\n  const serviceNamePascal = toPascalCase(options.serviceName);\r\n  return `import 'reflect-metadata';\r\nimport 'dotenv/config';\r\nimport './${serviceNamePascal}Service.js';\r\nimport { runMicroservice } from '@omen.foundation/node-microservice-runtime';\r\n\r\nvoid runMicroservice();\r\n`;\r\n}\r\n\r\n/**\r\n * Generates the main service class file.\r\n */\r\nfunction generateServiceTs(options: ScaffoldOptions): string {\r\n  const serviceNamePascal = toPascalCase(options.serviceName);\r\n  return `import {\r\n  Microservice,\r\n  Callable,\r\n  ClientCallable,\r\n  ServerCallable,\r\n  SwaggerCategory,\r\n  ConfigureServices,\r\n  type DependencyBuilder,\r\n  type RequestContext,\r\n} from '@omen.foundation/node-microservice-runtime';\r\nimport { ExampleDomainService } from './services/example-domain-service.js';\r\n\r\n@Microservice('${options.serviceName}')\r\nexport class ${serviceNamePascal}Service {\r\n  @ConfigureServices\r\n  static register(builder: DependencyBuilder): void {\r\n    builder.addSingletonClass(ExampleDomainService);\r\n  }\r\n\r\n  /**\r\n   * Example of a public Callable endpoint.\r\n   * No authentication required.\r\n   */\r\n  @Callable({ route: 'isTwo' })\r\n  @SwaggerCategory('Examples')\r\n  async isTwo(_ctx: RequestContext): Promise<boolean> {\r\n    return 1 + 1 === 2;\r\n  }\r\n\r\n  /**\r\n   * Example of a ClientCallable endpoint.\r\n   * Requires user authentication (client scope).\r\n   */\r\n  @ClientCallable({ route: 'isThree' })\r\n  @SwaggerCategory('Examples')\r\n  async isThree(_ctx: RequestContext): Promise<boolean> {\r\n    return 1 + 2 === 3;\r\n  }\r\n\r\n  /**\r\n   * Example of a ServerCallable endpoint.\r\n   * Requires server authentication (server scope).\r\n   */\r\n  @ServerCallable({ route: 'isFour' })\r\n  @SwaggerCategory('Examples')\r\n  async isFour(_ctx: RequestContext): Promise<boolean> {\r\n    return 2 + 2 === 4;\r\n  }\r\n}\r\n`;\r\n}\r\n\r\n/**\r\n * Generates example domain service content.\r\n */\r\nfunction generateDomainServiceTs(): string {\r\n  return `import type { RequestContext } from '@omen.foundation/node-microservice-runtime';\r\n\r\nexport class ExampleDomainService {\r\n  greet(userId: number): string {\r\n    return \\`Hello from Node microservices, user \\${userId}!\\`;\r\n  }\r\n\r\n  async getServiceInfo(_ctx: RequestContext): Promise<{ service: string; version: string }> {\r\n    return {\r\n      service: 'ExampleDomainService',\r\n      version: '1.0.0',\r\n    };\r\n  }\r\n}\r\n`;\r\n}\r\n\r\n"]}

package/dist/runtime.cjs

@@ -311,14 +311,21 @@ class MicroserviceRuntime {
         }
         catch (error) {
             const err = error instanceof Error ? error : new Error(String(error));
-            this.logger.error({ err, envelope }, 'Failed to handle websocket event.');
+            const safeErrorName = (err.name && String(err.name).trim()) || 'Error';
+            const safeMessage = (err.message && String(err.message).trim()) ||
+                (error == null
+                    ? 'Unknown error (null/undefined)'
+                    : error instanceof Error
+                        ? '(empty Error.message)'
+                        : String(error));
+            this.logger.error({ err, envelope, responseError: safeErrorName, responseMessage: safeMessage }, 'Failed to handle websocket event.');
             const status = this.resolveErrorStatus(err);
             const response = {
                 id: envelope.id,
                 status,
                 body: {
-                    error: err.name,
-                    message: err.message,
+                    error: safeErrorName,
+                    message: safeMessage,
                 },
             };
             await this.requester.sendResponse(response);

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,iBAAiB,EAOlB,MAAM,YAAY,CAAC;AA4BpB,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAuB;IAClD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;IACxD,OAAO,CAAC,iBAAiB,CAAC,CAAS;IACnC,OAAO,CAAC,OAAO,CAAkB;IACjC,yGAAyG;IACzG,OAAO,CAAC,wBAAwB,CAAkB;gBAEtC,GAAG,CAAC,EAAE,iBAAiB;IA2H7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuEtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAUjB,sBAAsB;YA2CtB,qBAAqB;IAanC;;;OAGG;YACW,4BAA4B;YA2F5B,4BAA4B;YAqB5B,WAAW;IA2CzB,OAAO,CAAC,gBAAgB;IAuFxB,OAAO,CAAC,kBAAkB;IAW1B;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;YA+BV,QAAQ;IAwDtB,OAAO,CAAC,wBAAwB;YA8BlB,mBAAmB;YAiBnB,sBAAsB;YAStB,wBAAwB;YAsBxB,mBAAmB;IA6GjC,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,gBAAgB;YA+BV,6BAA6B;IAiC3C,OAAO,CAAC,kBAAkB;IAO1B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;CAI5B;AA+GD,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAoDrD;AAED,UAAU,sBAAsB;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,4CAA4C,CAC1D,SAAS,GAAE,OAAO,CAAC,iBAAiB,CAAM,EAC1C,OAAO,GAAE,sBAA2B,GACnC,OAAO,CA6BT"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,iBAAiB,EAOlB,MAAM,YAAY,CAAC;AA4BpB,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAuB;IAClD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;IACxD,OAAO,CAAC,iBAAiB,CAAC,CAAS;IACnC,OAAO,CAAC,OAAO,CAAkB;IACjC,yGAAyG;IACzG,OAAO,CAAC,wBAAwB,CAAkB;gBAEtC,GAAG,CAAC,EAAE,iBAAiB;IA2H7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuEtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAUjB,sBAAsB;YA2CtB,qBAAqB;IAanC;;;OAGG;YACW,4BAA4B;YA2F5B,4BAA4B;YAqB5B,WAAW;IAuDzB,OAAO,CAAC,gBAAgB;IAuFxB,OAAO,CAAC,kBAAkB;IAW1B;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;YA+BV,QAAQ;IAwDtB,OAAO,CAAC,wBAAwB;YA8BlB,mBAAmB;YAiBnB,sBAAsB;YAStB,wBAAwB;YAsBxB,mBAAmB;IA6GjC,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,gBAAgB;YA+BV,6BAA6B;IAiC3C,OAAO,CAAC,kBAAkB;IAO1B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;CAI5B;AA+GD,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAoDrD;AAED,UAAU,sBAAsB;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,4CAA4C,CAC1D,SAAS,GAAE,OAAO,CAAC,iBAAiB,CAAM,EAC1C,OAAO,GAAE,sBAA2B,GACnC,OAAO,CA6BT"}

package/dist/runtime.js

@@ -393,14 +393,22 @@ export class MicroserviceRuntime {
         }
         catch (error) {
             const err = error instanceof Error ? error : new Error(String(error));
-            this.logger.error({ err, envelope }, 'Failed to handle websocket event.');
+            // Never return empty error/message to the gateway — some clients show a blank 500 when both are "".
+            const safeErrorName = (err.name && String(err.name).trim()) || 'Error';
+            const safeMessage = (err.message && String(err.message).trim()) ||
+                (error == null
+                    ? 'Unknown error (null/undefined)'
+                    : error instanceof Error
+                        ? '(empty Error.message)'
+                        : String(error));
+            this.logger.error({ err, envelope, responseError: safeErrorName, responseMessage: safeMessage }, 'Failed to handle websocket event.');
             const status = this.resolveErrorStatus(err);
             const response = {
                 id: envelope.id,
                 status,
                 body: {
-                    error: err.name,
-                    message: err.message,
+                    error: safeErrorName,
+                    message: safeMessage,
                 },
             };
             await this.requester.sendResponse(response);

package/dist/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { BeamableWebSocket } from './websocket.js';\nimport { GatewayRequester } from './requester.js';\nimport { AuthManager } from './auth.js';\nimport { createLogger } from './logger.js';\nimport { loadEnvironmentConfig } from './env.js';\nimport { loadAndInjectEnvironmentVariables, loadDeveloperEnvVarsSync } from './env-loader.js';\nimport { startCollectorAndWaitForReady } from './collector-manager.js';\nimport pino from 'pino';\n// Removed deasync - using non-blocking async pattern instead\nimport { listRegisteredServices, getServiceOptions, getConfigureServicesHandlers, getInitializeServicesHandlers } from './decorators.js';\nimport { generateOpenApiDocument } from './docs.js';\nimport { VERSION } from './index.js';\nimport { DiscoveryBroadcaster } from './discovery.js';\nimport { BeamableRuntimeError, MissingScopesError, UnauthorizedUserError, UnknownRouteError } from './errors.js';\nimport type {\n  EnvironmentConfig,\n  RequestContext,\n  ServiceDefinition,\n  ServiceCallableMetadata,\n  GatewayResponse,\n  WebsocketEventEnvelope,\n  ServiceAccess,\n} from './types.js';\nimport type { Logger } from 'pino';\nimport { BeamableServiceManager } from './services.js';\nimport { StorageService } from './storage.js';\nimport {\n  DependencyBuilder,\n  LOGGER_TOKEN,\n  ENVIRONMENT_CONFIG_TOKEN,\n  REQUEST_CONTEXT_TOKEN,\n  BEAMABLE_SERVICES_TOKEN,\n  ServiceProvider,\n  MutableDependencyScope,\n} from './dependency.js';\nimport { hostToHttpUrl, hostToPortalUrl } from './utils/urls.js';\nimport { FederationRegistry, getFederationComponents, getFederatedInventoryMetadata } from './federation.js';\nimport type { FederatedRequestContext } from './federation.js';\nimport { createServer, type Server } from 'node:http';\n\ninterface ServiceInstance {\n  definition: ServiceDefinition;\n  instance: Record<string, unknown>;\n  configureHandlers: ReturnType<typeof getConfigureServicesHandlers>;\n  initializeHandlers: ReturnType<typeof getInitializeServicesHandlers>;\n  provider?: ServiceProvider;\n  logger: Logger;\n  federationRegistry: FederationRegistry;\n}\n\nexport class MicroserviceRuntime {\n  private readonly env: EnvironmentConfig;\n  private logger: Logger; // Mutable to allow upgrading from console logger to structured logger when collector is ready\n  private readonly services: ServiceInstance[];\n  private readonly webSocket: BeamableWebSocket;\n  private readonly requester: GatewayRequester;\n  private readonly authManager: AuthManager;\n  private readonly discovery?: DiscoveryBroadcaster;\n  private readonly microServiceId = randomUUID();\n  private readonly serviceManager: BeamableServiceManager;\n  private healthCheckServer?: Server;\n  private isReady: boolean = false;\n  /** False until DI container is built; traffic is rejected with 503 while isReady may already be true. */\n  private dependencyProvidersReady: boolean = false;\n\n  constructor(env?: EnvironmentConfig) {\n    this.env = env ?? loadEnvironmentConfig();\n    const envConfig = this.env; // Capture for async IIFE to satisfy TypeScript\n    \n    // STEP 1: Load developer-defined environment variables SYNCHRONOUSLY before logger creation\n    // This ensures BetterStack and other env vars are available when the logger initializes\n    loadDeveloperEnvVarsSync();\n    \n    // STEP 2: Create minimal console logger for startup messages (before collector setup)\n    // This ensures we have logging available immediately, even before collector is ready\n    const startupLogger = pino({\n      name: 'beamable-runtime-startup',\n      level: 'info',\n    }, process.stdout);\n    // Display runtime version at startup (VERSION is imported synchronously at top of file)\n    startupLogger.info(`Starting Beamable Node microservice runtime (version: ${VERSION}).`);\n    \n    // STEP 2.5: Load Beamable Config asynchronously (in background, non-blocking)\n    // Developer-defined vars are already loaded synchronously above\n    // Beamable Config is fetched via API with a 2-second timeout\n    (async () => {\n      try {\n        startupLogger.info('Loading Beamable Config environment variables...');\n        await loadAndInjectEnvironmentVariables(envConfig, undefined, true, 2000);\n        startupLogger.info('Beamable Config loading completed');\n      } catch (error) {\n        startupLogger.warn(`Beamable Config loading completed with warnings: ${error instanceof Error ? error.message : String(error)}`);\n      }\n    })();\n    \n    // STEP 2: Get registered services to extract service name\n    const registered = listRegisteredServices();\n    if (registered.length === 0) {\n      throw new Error('No microservices registered. Use the @Microservice decorator to register at least one class.');\n    }\n    \n    // Use the first service's name for the main logger (for CloudWatch filtering and ClickHouse compatibility)\n    const primaryService = registered[0];\n    const qualifiedServiceName = `micro_${primaryService.qualifiedName}`;\n    \n    // STEP 3: Create logger immediately (non-blocking pattern, matching C#)\n    // Start with minimal console logger, upgrade to structured logger when collector is ready\n    // This allows the service to start immediately without blocking\n    startupLogger.info('Setting up OpenTelemetry collector in background (non-blocking)...');\n    \n    // Create logger immediately with console output (no OTLP yet)\n    // This ensures we have logging available right away\n    this.logger = createLogger(this.env, {\n      name: 'beamable-node-microservice',\n      serviceName: primaryService.name,\n      qualifiedServiceName: qualifiedServiceName,\n      // No otlpEndpoint - will use console logger initially\n    });\n    \n    // STEP 4: Start collector setup in background (non-blocking)\n    // When collector is ready, upgrade logger to structured logger with OTLP\n    // This matches C# pattern: collector starts in background, service starts immediately\n    startCollectorAndWaitForReady(this.env)\n      .then((endpoint) => {\n        if (endpoint) {\n          // Collector is ready - upgrade to structured logger with OTLP support\n          this.logger.info(`Collector ready at ${endpoint}, upgrading to structured logger for Portal logs...`);\n          this.logger = createLogger(this.env, {\n            name: 'beamable-node-microservice',\n            serviceName: primaryService.name,\n            qualifiedServiceName: qualifiedServiceName,\n            otlpEndpoint: endpoint, // Collector is ready, Portal logs will now work\n          });\n          this.logger.info('Portal logs enabled - structured logs will now appear in Beamable Portal');\n        } else {\n          this.logger.warn('Collector setup completed but no endpoint was returned. Continuing with console logs. Portal logs will not be available.');\n        }\n      })\n      .catch((error) => {\n        const errorMsg = error instanceof Error ? error.message : String(error);\n        this.logger.error(`Failed to setup collector: ${errorMsg}. Continuing with console logs. Portal logs will not be available.`);\n        // Service continues to work with console logger - graceful degradation\n      });\n    \n    // Continue immediately - don't wait for collector!\n    // Service can start accepting requests right away\n    // Collector setup happens in background, logger upgrades automatically when ready\n    this.serviceManager = new BeamableServiceManager(this.env, this.logger);\n\n    this.services = registered.map((definition) => {\n      const instance = new definition.ctor() as Record<string, unknown>;\n      const configureHandlers = getConfigureServicesHandlers(definition.ctor);\n      const initializeHandlers = getInitializeServicesHandlers(definition.ctor);\n      const logger = this.logger.child({ service: definition.name });\n      const federationRegistry = new FederationRegistry(logger);\n      const decoratedFederations = getFederationComponents(definition.ctor);\n      for (const component of decoratedFederations) {\n        federationRegistry.register(component);\n      }\n      const inventoryMetadata = getFederatedInventoryMetadata(definition.ctor);\n      if (inventoryMetadata.length > 0) {\n        federationRegistry.registerInventoryHandlers(instance, inventoryMetadata);\n      }\n      this.serviceManager.registerFederationRegistry(definition.name, federationRegistry);\n      return { definition, instance, configureHandlers, initializeHandlers, logger, federationRegistry };\n    });\n\n    const socketUrl = this.env.host.endsWith('/socket') ? this.env.host : `${this.env.host}/socket`;\n    this.webSocket = new BeamableWebSocket({ url: socketUrl, logger: this.logger });\n    this.webSocket.on('message', (payload) => {\n      this.logger.debug({ payload }, 'Runtime observed websocket frame.');\n    });\n    this.requester = new GatewayRequester(this.webSocket, this.logger);\n    this.authManager = new AuthManager(this.env, this.requester);\n    this.requester.on('event', (envelope) => this.handleEvent(envelope));\n\n    // Discovery broadcaster only runs in local development (not in containers)\n    // This allows the portal to detect that the service is running locally\n    if (!isRunningInContainer() && this.services.length > 0) {\n      this.discovery = new DiscoveryBroadcaster({\n        env: this.env,\n        serviceName: this.services[0].definition.name,\n        routingKey: this.env.routingKey,\n        logger: this.logger.child({ component: 'DiscoveryBroadcaster' }),\n      });\n    }\n  }\n\n  async start(): Promise<void> {\n    // Immediate console output for container logs (before logger is ready)\n    debugLog('[BEAMABLE-NODE] MicroserviceRuntime.start() called');\n    debugLog(`[BEAMABLE-NODE] Service count: ${this.services.length}`);\n    \n    this.printHelpfulUrls(this.services[0]);\n    this.logger.info('Starting Beamable Node microservice runtime.');\n    \n    // Start health check server FIRST - this is critical for container health checks\n    // Even if startup fails, the health check server must be running so we can debug\n    debugLog('[BEAMABLE-NODE] Starting health check server...');\n    await this.startHealthCheckServer();\n    debugLog('[BEAMABLE-NODE] Health check server started');\n    \n    try {\n      this.logger.info('Connecting to Beamable gateway...');\n      await this.webSocket.connect();\n      await new Promise((resolve) => setTimeout(resolve, 250));\n      \n      this.logger.info('Authenticating with Beamable...');\n      await this.authManager.authenticate();\n      \n      this.logger.info('Initializing Beamable SDK services...');\n      // Pass service name to initialize so routing key can be configured for service-level requests\n      const primaryServiceName = this.services[0]?.definition.name;\n      await this.serviceManager.initialize(primaryServiceName);\n\n      this.dependencyProvidersReady = false;\n\n      // Register with gateway before building the app DI graph so GET /health can go 200 while\n      // ConfigureServices/build still run (large graphs no longer block Portal probes).\n      this.logger.info('Registering basic service provider with gateway...');\n      await this.registerBasicServiceProvider();\n\n      this.isReady = true;\n      this.logger.info('Beamable microservice runtime is ready to accept traffic.');\n\n      this.logger.info('Initializing dependency providers...');\n      await this.initializeDependencyProviders();\n      this.dependencyProvidersReady = true;\n\n      this.logger.info('Registering event provider with gateway...');\n      await this.registerEventServiceProvider();\n\n      this.logger.info('Starting discovery broadcaster...');\n      await this.discovery?.start();\n    } catch (error) {\n      // Log the error with full context but don't crash - health check server is running\n      // This allows the container to stay alive so we can debug the issue\n      // Debug output for local development only (in containers, logger handles this)\n      debugLog('[BEAMABLE-NODE] FATAL ERROR during startup:');\n      debugLog(`[BEAMABLE-NODE] Error message: ${error instanceof Error ? error.message : String(error)}`);\n      debugLog(`[BEAMABLE-NODE] Error stack: ${error instanceof Error ? error.stack : 'No stack trace'}`);\n      debugLog(`[BEAMABLE-NODE] isReady: ${this.isReady}`);\n      \n      this.logger.error(\n        { \n          err: error,\n          errorMessage: error instanceof Error ? error.message : String(error),\n          errorStack: error instanceof Error ? error.stack : undefined,\n          isReady: this.isReady,\n        },\n        'Failed to fully initialize microservice runtime. Health check will continue to return 503 until initialization completes.'\n      );\n      // DON'T re-throw - keep process alive so health check can show 503\n      // This allows us to see the error in logs\n      this.isReady = false;\n      this.dependencyProvidersReady = false;\n    }\n  }\n\n  async shutdown(): Promise<void> {\n    this.logger.info('Shutting down microservice runtime.');\n    this.isReady = false; // Mark as not ready during shutdown\n    this.dependencyProvidersReady = false;\n    this.discovery?.stop();\n    await this.stopHealthCheckServer();\n    this.requester.dispose();\n    await this.webSocket.close();\n  }\n\n  private async startHealthCheckServer(): Promise<void> {\n    // For deployed services, always start health check server (required for container health checks)\n    // For local development, only start if healthPort is explicitly set\n    // IMPORTANT: Always default to 6565 if HEALTH_PORT env var is not set, as this is the standard port\n    const healthPort = this.env.healthPort || 6565;\n    \n    // Always start health check server if we have a valid port\n    // The container orchestrator expects this endpoint to be available\n    if (!healthPort || healthPort === 0) {\n      // Health check server not needed (local development without explicit port)\n      this.logger.debug('Health check server skipped (no healthPort set)');\n      return;\n    }\n\n    this.healthCheckServer = createServer((req, res) => {\n      if (req.url === '/health' && req.method === 'GET') {\n        // Only return success if service is fully ready (registered and accepting traffic)\n        if (this.isReady) {\n          res.writeHead(200, { 'Content-Type': 'text/plain' });\n          res.end('responsive');\n        } else {\n          // Service is still starting up\n          res.writeHead(503, { 'Content-Type': 'text/plain' });\n          res.end('Service Unavailable');\n        }\n      } else {\n        res.writeHead(404, { 'Content-Type': 'text/plain' });\n        res.end('Not Found');\n      }\n    });\n\n    return new Promise((resolve, reject) => {\n      this.healthCheckServer!.listen(healthPort, '0.0.0.0', () => {\n        this.logger.info({ port: healthPort }, 'Health check server started on port');\n        resolve();\n      });\n      this.healthCheckServer!.on('error', (err) => {\n        this.logger.error({ err, port: healthPort }, 'Failed to start health check server');\n        reject(err);\n      });\n    });\n  }\n\n  private async stopHealthCheckServer(): Promise<void> {\n    if (!this.healthCheckServer) {\n      return;\n    }\n\n    return new Promise((resolve) => {\n      this.healthCheckServer!.close(() => {\n        this.logger.info('Health check server stopped');\n        resolve();\n      });\n    });\n  }\n\n  /**\n   * POST basic provider to gateway. In start(), isReady is set immediately after this succeeds,\n   * before dependency providers are built; traffic is gated until dependencyProvidersReady.\n   */\n  private async registerBasicServiceProvider(): Promise<void> {\n    const primary = this.services[0]?.definition;\n    if (!primary) {\n      throw new Error('Unexpected missing service definition during registration.');\n    }\n    // Match C# exactly: use qualifiedName (preserves case) for name field.\n    // The gateway lowercases service names when creating bindings, but uses the original case\n    // from the registration request when constructing routing key lookups.\n    // This ensures the routing key format matches what the gateway expects.\n    // The gateway's binding lookup behavior:\n    // - Gateway error shows: \"No binding found for service ...micro_examplenodeservice.basic\"\n    // - This means the gateway lowercases the service name for binding storage/lookup\n    // - Portal sends requests with mixed case in URL and routing key header\n    // - The gateway lowercases the URL path for binding lookup, which should work\n    // - But we need to register with the format the gateway expects for the binding key\n    // - The gateway constructs binding key as: {cid}.{pid}.{lowercaseServiceName}.{type}\n    // - So we register with lowercase to match what the gateway stores in the binding\n    // - The portal will still send mixed case, and the gateway will lowercase it for lookup\n    // Register with mixed-case qualifiedName to match C# behavior\n    // The gateway will lowercase the service name when creating the binding key,\n    // but the registration request should use the original case (as C# does)\n    // This ensures the service name in the registration matches what the portal expects\n    // Register with mixed-case qualifiedName to match C# behavior\n    // The gateway's ServiceIdentity.fullNameNoType lowercases the service name when creating bindings,\n    // but the registration request should use the original case (as C# does)\n    // This ensures the service name in the registration matches what the portal expects\n    const isDeployed = isRunningInContainer();\n    \n    // For deployed services, routingKey should be null/undefined (None in Scala)\n    // For local dev, routingKey should be the actual routing key string\n    // The backend expects Option[String] = None for deployed services\n    // Note: microServiceId is not part of SocketSessionProviderRegisterRequest, so we don't include it\n    // All fields except 'type' are Option[T] in Scala, so undefined fields will be omitted from JSON\n    // This matches C# behavior where null/None fields are not serialized\n    const request: Record<string, unknown> = {\n      type: 'basic',\n      name: primary.qualifiedName, // Use mixed-case as C# does - gateway handles lowercasing for binding storage\n      beamoName: primary.name,\n    };\n    \n    // Only include routingKey and startedById if they have values (for local dev)\n    // For deployed services, these should be omitted (undefined) to match None in Scala\n    if (!isDeployed && this.env.routingKey) {\n      request.routingKey = this.env.routingKey;\n    }\n    if (!isDeployed && this.env.accountId) {\n      request.startedById = this.env.accountId;\n    }\n\n    // Log registration request to match C# behavior exactly\n    // Also log the actual JSON that will be sent (undefined fields will be omitted)\n    const serializedRequest = JSON.stringify(request);\n    this.logger.debug(\n      {\n        request: {\n          type: request.type,\n          name: request.name,\n          beamoName: request.beamoName,\n          routingKey: request.routingKey,\n          startedById: request.startedById,\n        },\n        serializedJson: serializedRequest,\n        isDeployed,\n      },\n      'Registering service provider with gateway.',\n    );\n\n    try {\n      await this.requester.request('post', 'gateway/provider', request);\n      this.logger.info({ serviceName: primary.qualifiedName }, 'Service provider registered successfully.');\n      // Former 2s deployed-only await blocked isReady and Portal \"Deploying\"; gateway still runs\n      // binding setup asynchronously — health can go green while that finishes.\n      if (isDeployed) {\n        this.logger.debug(\n          'Gateway binding setup continues asynchronously (no blocking sleep before health readiness).',\n        );\n      }\n    } catch (error) {\n      this.logger.error(\n        {\n          err: error,\n          request,\n          serviceName: primary.qualifiedName,\n          errorMessage: error instanceof Error ? error.message : String(error),\n        },\n        'Failed to register service provider with gateway. This will prevent the service from receiving requests.'\n      );\n      throw error; // Re-throw so startup fails and we can see the error\n    }\n  }\n\n  private async registerEventServiceProvider(): Promise<void> {\n    const primary = this.services[0]?.definition;\n    if (!primary) {\n      return;\n    }\n    const options = getServiceOptions(primary.ctor) ?? {};\n    if (options.disableAllBeamableEvents) {\n      this.logger.info('Beamable events disabled by configuration.');\n      return;\n    }\n    const eventRequest = {\n      type: 'event',\n      evtWhitelist: ['content.manifest', 'realm.config', 'logging.context'],\n    };\n    try {\n      await this.requester.request('post', 'gateway/provider', eventRequest);\n    } catch (error) {\n      this.logger.warn({ err: error }, 'Failed to register event provider. Continuing without events.');\n    }\n  }\n\n  private async handleEvent(envelope: WebsocketEventEnvelope): Promise<void> {\n    try {\n      if (!envelope.path) {\n        this.logger.debug({ envelope }, 'Ignoring websocket event without path.');\n        return;\n      }\n\n      if (envelope.path.startsWith('event/')) {\n        await this.requester.acknowledge(envelope.id);\n        return;\n      }\n\n      // Avoid dispatch with an empty DI scope while ConfigureServices/build is still running.\n      if (!this.dependencyProvidersReady) {\n        await this.requester.sendResponse({\n          id: envelope.id,\n          status: 503,\n          body: {\n            error: 'ServiceUnavailable',\n            message: 'Microservice dependency providers are still initializing.',\n          },\n        });\n        return;\n      }\n\n      const context = this.toRequestContext(envelope);\n      await this.dispatch(context);\n    } catch (error) {\n      const err = error instanceof Error ? error : new Error(String(error));\n      this.logger.error({ err, envelope }, 'Failed to handle websocket event.');\n      const status = this.resolveErrorStatus(err);\n      const response: GatewayResponse = {\n        id: envelope.id,\n        status,\n        body: {\n          error: err.name,\n          message: err.message,\n        },\n      };\n      await this.requester.sendResponse(response);\n    }\n  }\n\n  private toRequestContext(envelope: WebsocketEventEnvelope): RequestContext {\n    const path = envelope.path ?? '';\n    const method = envelope.method ?? 'post';\n    const userId = typeof envelope.from === 'number' ? envelope.from : 0;\n    const headers = envelope.headers ?? {};\n    \n    // Parse query parameters from path (e.g., /service/route?param1=value1&param2=value2)\n    const [pathWithoutQuery, queryString] = path.split('?', 2);\n    const query = this.parseQueryString(queryString ?? '');\n    \n    // Extract scopes from envelope.scopes array\n    // Note: X-DE-SCOPE header contains CID.PID, not scope values\n    // The gateway sends scopes in envelope.scopes array\n    // For admin endpoints, the gateway may not send scopes in the envelope,\n    // so we infer admin scope from the path if it's an admin route\n    const envelopeScopes = envelope.scopes ?? [];\n    let scopes = normalizeScopes(envelopeScopes);\n    \n    // If this is an admin endpoint and no scopes are provided, infer admin scope\n    // The gateway may not always send scopes for admin routes\n    const pathLower = pathWithoutQuery.toLowerCase();\n    if (pathLower.includes('/admin/') && scopes.size === 0) {\n      scopes = normalizeScopes(['admin']);\n    }\n\n    let body: Record<string, unknown> | undefined;\n    if (envelope.body && typeof envelope.body === 'string') {\n      try {\n        body = JSON.parse(envelope.body) as Record<string, unknown>;\n      } catch (error) {\n        this.logger.warn({ err: error, raw: envelope.body }, 'Failed to parse body string.');\n      }\n    } else if (envelope.body && typeof envelope.body === 'object') {\n      body = envelope.body as Record<string, unknown>;\n    }\n\n    let payload: unknown;\n    if (body && typeof body === 'object' && 'payload' in body) {\n      const rawPayload = (body as Record<string, unknown>).payload;\n      if (typeof rawPayload === 'string') {\n        try {\n          payload = JSON.parse(rawPayload) as unknown[];\n        } catch (error) {\n          this.logger.warn({ err: error }, 'Failed to parse payload JSON.');\n          payload = rawPayload;\n        }\n      } else {\n        payload = rawPayload;\n      }\n    }\n\n    const targetService = this.findServiceForPath(pathWithoutQuery);\n    const services = this.serviceManager.createFacade(userId, scopes, targetService?.definition.name);\n    const provider = this.createRequestScope(pathWithoutQuery, targetService);\n\n    const context: RequestContext = {\n      id: envelope.id,\n      path,\n      method,\n      status: envelope.status ?? 0,\n      userId,\n      payload,\n      body,\n      query,\n      scopes,\n      headers,\n      cid: this.env.cid,\n      pid: this.env.pid,\n      services,\n      throwIfCancelled: () => {},\n      isCancelled: () => false,\n      hasScopes: (...requiredScopes: string[]) => requiredScopes.every((scope) => scopeSetHas(scopes, scope)),\n      requireScopes: (...requiredScopes: string[]) => {\n        const missingScopes = requiredScopes.filter((scope) => !scopeSetHas(scopes, scope));\n        if (missingScopes.length > 0) {\n          throw new MissingScopesError(missingScopes);\n        }\n      },\n      provider,\n    };\n\n    provider.setInstance(REQUEST_CONTEXT_TOKEN, context);\n    provider.setInstance(BEAMABLE_SERVICES_TOKEN, services);\n\n    return context;\n  }\n\n  private findServiceForPath(path: string): ServiceInstance | undefined {\n    // Gateway sends paths with lowercase service names, so we need case-insensitive matching\n    // Match by comparing lowercase versions to handle gateway's lowercase path format\n    // Note: path should already have query string stripped before calling this method\n    const pathLower = path.toLowerCase();\n    return this.services.find((service) => {\n      const qualifiedNameLower = service.definition.qualifiedName.toLowerCase();\n      return pathLower.startsWith(`${qualifiedNameLower}/`);\n    });\n  }\n\n  /**\n   * Parses a query string into a record of parameter names to values.\n   * Handles multiple values for the same parameter name by storing them as an array.\n   * @param queryString The query string (without the leading '?')\n   * @returns A record mapping parameter names to their values (single string or array of strings)\n   */\n  private parseQueryString(queryString: string): Record<string, string | string[]> {\n    if (!queryString || queryString.trim().length === 0) {\n      return {};\n    }\n\n    const params: Record<string, string | string[]> = {};\n    const pairs = queryString.split('&');\n\n    for (const pair of pairs) {\n      const [key, value = ''] = pair.split('=', 2);\n      if (key) {\n        const decodedKey = decodeURIComponent(key);\n        const decodedValue = decodeURIComponent(value);\n\n        // If the key already exists, convert to array or append to existing array\n        if (decodedKey in params) {\n          const existing = params[decodedKey];\n          if (Array.isArray(existing)) {\n            existing.push(decodedValue);\n          } else {\n            params[decodedKey] = [existing, decodedValue];\n          }\n        } else {\n          params[decodedKey] = decodedValue;\n        }\n      }\n    }\n\n    return params;\n  }\n\n  private async dispatch(ctx: RequestContext): Promise<void> {\n    // Extract path without query string for routing\n    const pathWithoutQuery = this.getPathWithoutQuery(ctx.path);\n    const service = this.findServiceForPath(pathWithoutQuery);\n    if (!service) {\n      throw new UnknownRouteError(ctx.path);\n    }\n\n    if (await this.tryHandleFederationRoute(ctx, service)) {\n      return;\n    }\n\n    if (await this.tryHandleAdminRoute(ctx, service)) {\n      return;\n    }\n\n    // Extract route from path - handle case-insensitive path matching\n    const pathLower = pathWithoutQuery.toLowerCase();\n    const qualifiedNameLower = service.definition.qualifiedName.toLowerCase();\n    const route = pathLower.substring(qualifiedNameLower.length + 1);\n    const metadata = service.definition.callables.get(route);\n    if (!metadata) {\n      throw new UnknownRouteError(ctx.path);\n    }\n\n    // For server and admin access, allow userId: 0 if the appropriate scope is present\n    // For client access, always require userId > 0\n    if (metadata.requireAuth && ctx.userId <= 0) {\n      if (metadata.access === 'server' && scopeSetHas(ctx.scopes, 'server')) {\n        // Server callables with server scope don't need a user ID\n      } else if (metadata.access === 'admin' && scopeSetHas(ctx.scopes, 'admin')) {\n        // Admin callables with admin scope don't need a user ID\n      } else {\n        throw new UnauthorizedUserError(route);\n      }\n    }\n\n    enforceAccess(metadata.access, ctx);\n\n    if (metadata.requiredScopes.length > 0) {\n      const missing = metadata.requiredScopes.filter((scope) => !scopeSetHas(ctx.scopes, scope));\n      if (missing.length > 0) {\n        throw new MissingScopesError(missing);\n      }\n    }\n\n    const handler = service.instance[metadata.displayName];\n    if (typeof handler !== 'function') {\n      throw new Error(`Callable ${metadata.displayName} is not a function on service ${service.definition.name}.`);\n    }\n\n    const args = this.buildInvocationArguments(handler as (...args: unknown[]) => unknown, ctx);\n    const result = await Promise.resolve((handler as (...args: unknown[]) => unknown).apply(service.instance, args));\n    await this.sendSuccessResponse(ctx, metadata, result);\n  }\n\n  private buildInvocationArguments(\n    handler: (...args: unknown[]) => unknown,\n    ctx: RequestContext,\n  ): unknown[] {\n    const payload = Array.isArray(ctx.payload)\n      ? ctx.payload\n      : typeof ctx.payload === 'string'\n      ? [ctx.payload]\n      : ctx.payload === undefined\n      ? []\n      : [ctx.payload];\n\n    const expectedParams = handler.length;\n\n    // Determine if RequestContext should be passed as the first argument\n    // Strategy: If handler expects more parameters than payload provides,\n    //           assume the first parameter is RequestContext\n    // This covers common cases:\n    // - handler(ctx: RequestContext) with empty payload -> expectedParams=1, payload.length=0 -> include ctx\n    // - handler(ctx: RequestContext, param: string) with payload=['value'] -> expectedParams=2, payload.length=1 -> include ctx\n    // - handler(param: string) with payload=['value'] -> expectedParams=1, payload.length=1 -> don't include ctx\n    if (expectedParams > payload.length) {\n      return [ctx, ...payload];\n    }\n\n    // If handler expects exactly the same number of parameters as payload,\n    // don't include ctx (handler doesn't expect it)\n    return payload;\n  }\n\n  private async sendSuccessResponse(ctx: RequestContext, metadata: ServiceCallableMetadata, result: unknown): Promise<void> {\n    let body: unknown;\n    if (metadata.useLegacySerialization) {\n      const serialized = typeof result === 'string' ? result : JSON.stringify(result ?? null);\n      body = { payload: serialized };\n    } else {\n      body = result ?? null;\n    }\n\n    const response: GatewayResponse = {\n      id: ctx.id,\n      status: 200,\n      body,\n    };\n    await this.requester.sendResponse(response);\n  }\n\n  private async sendFederationResponse(ctx: RequestContext, result: unknown): Promise<void> {\n    const response: GatewayResponse = {\n      id: ctx.id,\n      status: 200,\n      body: result ?? null,\n    };\n    await this.requester.sendResponse(response);\n  }\n\n  private async tryHandleFederationRoute(ctx: RequestContext, service: ServiceInstance): Promise<boolean> {\n    // Gateway sends paths with lowercase service names, so we need case-insensitive matching\n    // Extract path without query string for routing\n    const pathWithoutQuery = this.getPathWithoutQuery(ctx.path);\n    const pathLower = pathWithoutQuery.toLowerCase();\n    const qualifiedNameLower = service.definition.qualifiedName.toLowerCase();\n    const prefixLower = `${qualifiedNameLower}/`;\n    if (!pathLower.startsWith(prefixLower)) {\n      return false;\n    }\n    // Extract relative path - use lowercase length since gateway sends lowercase paths\n    const relativePath = pathWithoutQuery.substring(qualifiedNameLower.length + 1);\n    const handler = service.federationRegistry.resolve(relativePath);\n    if (!handler) {\n      return false;\n    }\n\n    const result = await handler.invoke(ctx as FederatedRequestContext);\n    await this.sendFederationResponse(ctx, result);\n    return true;\n  }\n\n  private async tryHandleAdminRoute(ctx: RequestContext, service: ServiceInstance): Promise<boolean> {\n    // Gateway sends paths with lowercase service names, so we need case-insensitive matching\n    // Check if path starts with the admin prefix (case-insensitive)\n    // Extract path without query string for routing\n    const pathWithoutQuery = this.getPathWithoutQuery(ctx.path);\n    const pathLower = pathWithoutQuery.toLowerCase();\n    const adminPrefixLower = `${service.definition.qualifiedName.toLowerCase()}/admin/`;\n    if (!pathLower.startsWith(adminPrefixLower)) {\n      return false;\n    }\n\n    const options = getServiceOptions(service.definition.ctor) ?? {};\n\n    const action = pathLower.substring(adminPrefixLower.length);\n    const requiresAdmin = action === 'metadata' || action === 'docs';\n    if (requiresAdmin && !scopeSetHas(ctx.scopes, 'admin')) {\n      // For portal requests to admin endpoints, the gateway may not send scopes\n      // The X-DE-SCOPE header contains CID.PID, not scope values\n      // If this is a portal request (has X-DE-SCOPE header), grant admin scope\n      const hasPortalHeader = ctx.headers['X-DE-SCOPE'] || ctx.headers['x-de-scope'];\n      if (hasPortalHeader) {\n        // Grant admin scope for portal requests to admin endpoints\n        ctx.scopes.add('admin');\n      } else {\n        throw new MissingScopesError(['admin']);\n      }\n    }\n\n    switch (action) {\n      case 'health':\n      case 'healthcheck':\n        await this.requester.sendResponse({ id: ctx.id, status: 200, body: 'responsive' });\n        return true;\n      case 'metadata':\n      case 'docs':\n        break;\n      default:\n        if (!scopeSetHas(ctx.scopes, 'admin')) {\n          throw new MissingScopesError(['admin']);\n        }\n        throw new UnknownRouteError(ctx.path);\n    }\n\n    if (action === 'metadata') {\n      const federatedComponents = service.federationRegistry\n        .list()\n        .map((component) => ({\n          federationNamespace: component.federationNamespace,\n          federationType: component.federationType,\n        }));\n\n      await this.requester.sendResponse({\n        id: ctx.id,\n        status: 200,\n        body: {\n          serviceName: service.definition.name,\n          sdkVersion: this.env.sdkVersionExecution,\n          sdkBaseBuildVersion: this.env.sdkVersionExecution,\n          sdkExecutionVersion: this.env.sdkVersionExecution,\n          useLegacySerialization: Boolean(options.useLegacySerialization),\n          disableAllBeamableEvents: Boolean(options.disableAllBeamableEvents),\n          enableEagerContentLoading: false,\n          instanceId: this.microServiceId,\n          routingKey: this.env.routingKey ?? '',\n          federatedComponents,\n        },\n      });\n      return true;\n    }\n\n    if (action === 'docs') {\n      try {\n        const document = generateOpenApiDocument(\n          {\n            qualifiedName: service.definition.qualifiedName,\n            name: service.definition.name,\n            callables: Array.from(service.definition.callables.values()).map((callable) => ({\n              name: callable.displayName,\n              route: callable.route,\n              metadata: callable,\n              handler: typeof service.instance[callable.displayName] === 'function'\n                ? (service.instance[callable.displayName] as (...args: unknown[]) => unknown)\n                : undefined,\n            })),\n          },\n          this.env,\n          VERSION,\n        );\n\n        // Ensure document is valid (not empty)\n        if (!document || Object.keys(document).length === 0) {\n          this.logger.warn({ serviceName: service.definition.name }, 'Generated OpenAPI document is empty');\n        }\n\n        await this.requester.sendResponse({\n          id: ctx.id,\n          status: 200,\n          body: document,\n        });\n        return true;\n      } catch (error) {\n        this.logger.error({ err: error, serviceName: service.definition.name }, 'Failed to generate or send docs');\n        throw error;\n      }\n    }\n\n    return false;\n  }\n\n  private resolveErrorStatus(error: Error): number {\n    if (error instanceof UnauthorizedUserError) {\n      return 401;\n    }\n    if (error instanceof MissingScopesError) {\n      return 403;\n    }\n    if (error instanceof UnknownRouteError) {\n      return 404;\n    }\n    if (error instanceof BeamableRuntimeError) {\n      return 500;\n    }\n    return 500;\n  }\n\n  private printHelpfulUrls(service?: ServiceInstance): void {\n    if (!service) {\n      return;\n    }\n\n    // Only print helpful URLs when IS_LOCAL=1 is set\n    // In deployed containers, we want only JSON logs for proper log collection\n    if (process.env.IS_LOCAL !== '1' && process.env.IS_LOCAL !== 'true') {\n      return;\n    }\n\n    const docsUrl = buildDocsPortalUrl(this.env, service.definition);\n    const endpointBase = buildPostmanBaseUrl(this.env, service.definition);\n\n    const green = (text: string) => `\\x1b[32m${text}\\x1b[0m`;\n    const yellow = (text: string) => `\\x1b[33m${text}\\x1b[0m`;\n\n    const bannerLines = [\n      '',\n      yellow('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'),\n      ` ${green('Beamable Node microservice ready:')} ${green(service.definition.name)}`,\n      yellow(' Quick shortcuts'),\n      `   ${yellow('Docs:')}      ${docsUrl}`,\n      `   ${yellow('Endpoint:')} ${endpointBase}`,\n      yellow('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'),\n      '',\n    ];\n\n    process.stdout.write(`${bannerLines.join('\\n')}`);\n  }\n\n  private async initializeDependencyProviders(): Promise<void> {\n    // Get StorageService from service manager (it's initialized during serviceManager.initialize())\n    const storageService = this.serviceManager.getStorageService();\n    \n    for (const service of this.services) {\n      const builder = new DependencyBuilder();\n      builder.tryAddSingletonInstance(LOGGER_TOKEN, service.logger);\n      builder.tryAddSingletonInstance(ENVIRONMENT_CONFIG_TOKEN, this.env);\n      builder.tryAddSingletonInstance(BeamableServiceManager, this.serviceManager);\n      builder.tryAddSingletonInstance(StorageService, storageService);\n      builder.tryAddSingletonInstance(service.definition.ctor, service.instance);\n      builder.tryAddSingletonInstance(FederationRegistry, service.federationRegistry);\n\n      for (const handler of service.configureHandlers) {\n        await handler(builder);\n      }\n\n      const provider = builder.build();\n      service.provider = provider;\n\n      for (const handler of service.initializeHandlers) {\n        await handler(provider);\n      }\n\n      Object.defineProperty(service.instance, 'provider', {\n        value: provider,\n        enumerable: false,\n        configurable: false,\n        writable: false,\n      });\n    }\n  }\n\n  private createRequestScope(path: string, service?: ServiceInstance): MutableDependencyScope {\n    // Path should already have query string stripped before calling this method\n    const targetService = service ?? this.findServiceForPath(path);\n    const provider = targetService?.provider ?? new DependencyBuilder().build();\n    return provider.createScope();\n  }\n\n  /**\n   * Extracts the path portion without the query string.\n   * @param path The full path potentially containing a query string\n   * @returns The path without the query string\n   */\n  private getPathWithoutQuery(path: string): string {\n    const [pathWithoutQuery] = path.split('?', 2);\n    return pathWithoutQuery;\n  }\n}\n\nfunction enforceAccess(access: ServiceAccess, ctx: RequestContext): void {\n  switch (access) {\n    case 'client':\n      if (ctx.userId <= 0) {\n        throw new UnauthorizedUserError(ctx.path);\n      }\n      break;\n    case 'server':\n      if (!scopeSetHas(ctx.scopes, 'server')) {\n        throw new MissingScopesError(['server']);\n      }\n      break;\n    case 'admin':\n      if (!scopeSetHas(ctx.scopes, 'admin')) {\n        throw new MissingScopesError(['admin']);\n      }\n      break;\n    default:\n      break;\n  }\n}\n\n/**\n * Conditionally output to console.error only when running locally (not in container).\n * In containers, we want only Pino JSON logs to stdout for proper log collection.\n */\nfunction debugLog(...args: unknown[]): void {\n  // Only output debug logs when IS_LOCAL=1 is set\n  if (process.env.IS_LOCAL === '1' || process.env.IS_LOCAL === 'true') {\n    console.error(...args);\n  }\n}\n\n/**\n * Determines if we're running in a deployed container.\n * Used for service registration logic (routing key handling, discovery broadcaster, etc.)\n * \n * Note: For log formatting, use IS_LOCAL env var instead.\n */\nfunction isRunningInContainer(): boolean {\n  // Check for Docker container\n  try {\n    const fs = require('fs');\n    if (fs.existsSync('/.dockerenv')) {\n      return true;\n    }\n  } catch {\n    // fs might not be available\n  }\n  \n  // Check for Docker container hostname pattern (12 hex chars)\n  const hostname = process.env.HOSTNAME || '';\n  if (hostname && /^[a-f0-9]{12}$/i.test(hostname)) {\n    return true;\n  }\n  \n  // Explicit container indicators\n  if (\n    process.env.DOTNET_RUNNING_IN_CONTAINER === 'true' ||\n    process.env.CONTAINER === 'beamable' ||\n    !!process.env.ECS_CONTAINER_METADATA_URI ||\n    !!process.env.KUBERNETES_SERVICE_HOST\n  ) {\n    return true;\n  }\n  \n  // Default: assume local development\n  return false;\n}\n\nfunction normalizeScopes(scopes: Array<unknown>): Set<string> {\n  const normalized = new Set<string>();\n  for (const scope of scopes) {\n    if (typeof scope !== 'string' || scope.trim().length === 0) {\n      continue;\n    }\n    normalized.add(scope.trim().toLowerCase());\n  }\n  return normalized;\n}\n\nfunction scopeSetHas(scopes: Set<string>, scope: string): boolean {\n  const normalized = scope.trim().toLowerCase();\n  if (normalized.length === 0) {\n    return false;\n  }\n  return scopes.has('*') || scopes.has(normalized);\n}\n\nfunction buildPostmanBaseUrl(env: EnvironmentConfig, service: ServiceDefinition): string {\n  const httpHost = hostToHttpUrl(env.host);\n  const routingKeyPart = env.routingKey ? env.routingKey : '';\n  return `${httpHost}/basic/${env.cid}.${env.pid}.${routingKeyPart}${service.qualifiedName}/`;\n}\n\nfunction buildDocsPortalUrl(env: EnvironmentConfig, service: ServiceDefinition): string {\n  const portalHost = hostToPortalUrl(hostToHttpUrl(env.host));\n  const queryParams: Record<string, string> = { srcTool: 'node-runtime' };\n  if (env.routingKey) {\n    queryParams.routingKey = env.routingKey;\n  }\n  const query = new URLSearchParams(queryParams);\n  if (env.refreshToken) {\n    query.set('refresh_token', env.refreshToken);\n  }\n  const beamoId = service.name;\n  return `${portalHost}/${env.cid}/games/${env.pid}/realms/${env.pid}/microservices/micro_${beamoId}/docs?${query.toString()}`;\n}\n\nexport async function runMicroservice(): Promise<void> {\n  // Immediate console output to verify process is starting (local dev only)\n  // In containers, we rely on Pino logger for all output\n  debugLog('[BEAMABLE-NODE] Starting microservice...');\n  debugLog(`[BEAMABLE-NODE] Node version: ${process.version}`);\n  debugLog(`[BEAMABLE-NODE] Working directory: ${process.cwd()}`);\n  debugLog(`[BEAMABLE-NODE] Environment: ${JSON.stringify({\n    NODE_ENV: process.env.NODE_ENV,\n    CID: process.env.CID ? 'SET' : 'NOT SET',\n    PID: process.env.PID ? 'SET' : 'NOT SET',\n    HOST: process.env.HOST ? 'SET' : 'NOT SET',\n    SECRET: process.env.SECRET ? 'SET' : 'NOT SET',\n  })}`);\n  if (process.env.BEAMABLE_SKIP_RUNTIME === 'true') {\n    return;\n  }\n  const runtime = new MicroserviceRuntime();\n  \n  // Handle uncaught errors - log them but don't crash immediately\n  // This allows the health check server to keep running so we can debug\n  // In containers, errors will be logged by the logger in the runtime\n  // Locally, use console.error for visibility\n  process.on('uncaughtException', (error) => {\n    // In containers, the logger will handle this; locally, show in console\n    debugLog('Uncaught Exception:', error);\n    // Don't exit - let the health check server keep running\n  });\n  \n  process.on('unhandledRejection', (reason, promise) => {\n    // In containers, the logger will handle this; locally, show in console\n    debugLog('Unhandled Rejection at:', promise, 'reason:', reason);\n    // Don't exit - let the health check server keep running\n  });\n  \n  try {\n    await runtime.start();\n  } catch (error) {\n    // Log the error but don't exit - health check server is running\n    // This allows the container to stay alive so we can see what went wrong\n    // In containers, the logger already logged it in start(); locally, also use console.error\n    debugLog('Failed to start microservice runtime:', error);\n    // Keep the process alive so health check can continue\n    // The health check will return 503 until isReady is true\n  }\n  \n  const shutdownSignals: NodeJS.Signals[] = ['SIGTERM', 'SIGINT'];\n  shutdownSignals.forEach((signal) => {\n    process.once(signal, async () => {\n      await runtime.shutdown();\n      process.exit(0);\n    });\n  });\n}\n\ninterface GenerateOpenApiOptions {\n  serviceName?: string;\n}\n\nexport function generateOpenApiDocumentForRegisteredServices(\n  overrides: Partial<EnvironmentConfig> = {},\n  options: GenerateOpenApiOptions = {},\n): unknown {\n  const services = listRegisteredServices();\n  if (services.length === 0) {\n    throw new Error('No microservices registered. Import your service module before generating documentation.');\n  }\n\n  const baseEnv = buildEnvironmentConfig(overrides);\n  const primary = options.serviceName\n    ? services.find((svc) => svc.name === options.serviceName || svc.qualifiedName === options.serviceName)\n    : services[0];\n\n  if (!primary) {\n    throw new Error(`No registered microservice matched '${options.serviceName}'.`);\n  }\n\n  return generateOpenApiDocument(\n    {\n      qualifiedName: primary.qualifiedName,\n      name: primary.name,\n      callables: Array.from(primary.callables.entries()).map(([displayName, metadata]) => ({\n        name: displayName,\n        route: metadata.route,\n        metadata,\n        handler: undefined,\n      })),\n    },\n    baseEnv,\n    VERSION,\n  );\n}\n\nfunction buildEnvironmentConfig(overrides: Partial<EnvironmentConfig>): EnvironmentConfig {\n  const merged: Partial<EnvironmentConfig> = { ...overrides };\n\n  const ensure = (key: keyof EnvironmentConfig, fallbackEnv?: string) => {\n    if (merged[key] !== undefined) {\n      return;\n    }\n    if (fallbackEnv && process.env[fallbackEnv]) {\n      merged[key] = process.env[fallbackEnv] as never;\n    }\n  };\n\n  ensure('cid', 'CID');\n  ensure('pid', 'PID');\n  ensure('host', 'HOST');\n  ensure('secret', 'SECRET');\n  ensure('refreshToken', 'REFRESH_TOKEN');\n  // Routing key is optional for deployed services (in containers)\n  // It will be resolved to empty string if not provided and running in container\n  if (!merged.routingKey && !isRunningInContainer()) {\n    ensure('routingKey', 'NAME_PREFIX');\n  }\n\n  if (!merged.cid || !merged.pid || !merged.host) {\n    throw new Error('CID, PID, and HOST are required to generate documentation.');\n  }\n\n  const base = loadEnvironmentConfig();\n\n  return {\n    ...base,\n    ...merged,\n    routingKey: merged.routingKey ?? base.routingKey,\n  };\n}\n"]}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { BeamableWebSocket } from './websocket.js';\nimport { GatewayRequester } from './requester.js';\nimport { AuthManager } from './auth.js';\nimport { createLogger } from './logger.js';\nimport { loadEnvironmentConfig } from './env.js';\nimport { loadAndInjectEnvironmentVariables, loadDeveloperEnvVarsSync } from './env-loader.js';\nimport { startCollectorAndWaitForReady } from './collector-manager.js';\nimport pino from 'pino';\n// Removed deasync - using non-blocking async pattern instead\nimport { listRegisteredServices, getServiceOptions, getConfigureServicesHandlers, getInitializeServicesHandlers } from './decorators.js';\nimport { generateOpenApiDocument } from './docs.js';\nimport { VERSION } from './index.js';\nimport { DiscoveryBroadcaster } from './discovery.js';\nimport { BeamableRuntimeError, MissingScopesError, UnauthorizedUserError, UnknownRouteError } from './errors.js';\nimport type {\n  EnvironmentConfig,\n  RequestContext,\n  ServiceDefinition,\n  ServiceCallableMetadata,\n  GatewayResponse,\n  WebsocketEventEnvelope,\n  ServiceAccess,\n} from './types.js';\nimport type { Logger } from 'pino';\nimport { BeamableServiceManager } from './services.js';\nimport { StorageService } from './storage.js';\nimport {\n  DependencyBuilder,\n  LOGGER_TOKEN,\n  ENVIRONMENT_CONFIG_TOKEN,\n  REQUEST_CONTEXT_TOKEN,\n  BEAMABLE_SERVICES_TOKEN,\n  ServiceProvider,\n  MutableDependencyScope,\n} from './dependency.js';\nimport { hostToHttpUrl, hostToPortalUrl } from './utils/urls.js';\nimport { FederationRegistry, getFederationComponents, getFederatedInventoryMetadata } from './federation.js';\nimport type { FederatedRequestContext } from './federation.js';\nimport { createServer, type Server } from 'node:http';\n\ninterface ServiceInstance {\n  definition: ServiceDefinition;\n  instance: Record<string, unknown>;\n  configureHandlers: ReturnType<typeof getConfigureServicesHandlers>;\n  initializeHandlers: ReturnType<typeof getInitializeServicesHandlers>;\n  provider?: ServiceProvider;\n  logger: Logger;\n  federationRegistry: FederationRegistry;\n}\n\nexport class MicroserviceRuntime {\n  private readonly env: EnvironmentConfig;\n  private logger: Logger; // Mutable to allow upgrading from console logger to structured logger when collector is ready\n  private readonly services: ServiceInstance[];\n  private readonly webSocket: BeamableWebSocket;\n  private readonly requester: GatewayRequester;\n  private readonly authManager: AuthManager;\n  private readonly discovery?: DiscoveryBroadcaster;\n  private readonly microServiceId = randomUUID();\n  private readonly serviceManager: BeamableServiceManager;\n  private healthCheckServer?: Server;\n  private isReady: boolean = false;\n  /** False until DI container is built; traffic is rejected with 503 while isReady may already be true. */\n  private dependencyProvidersReady: boolean = false;\n\n  constructor(env?: EnvironmentConfig) {\n    this.env = env ?? loadEnvironmentConfig();\n    const envConfig = this.env; // Capture for async IIFE to satisfy TypeScript\n    \n    // STEP 1: Load developer-defined environment variables SYNCHRONOUSLY before logger creation\n    // This ensures BetterStack and other env vars are available when the logger initializes\n    loadDeveloperEnvVarsSync();\n    \n    // STEP 2: Create minimal console logger for startup messages (before collector setup)\n    // This ensures we have logging available immediately, even before collector is ready\n    const startupLogger = pino({\n      name: 'beamable-runtime-startup',\n      level: 'info',\n    }, process.stdout);\n    // Display runtime version at startup (VERSION is imported synchronously at top of file)\n    startupLogger.info(`Starting Beamable Node microservice runtime (version: ${VERSION}).`);\n    \n    // STEP 2.5: Load Beamable Config asynchronously (in background, non-blocking)\n    // Developer-defined vars are already loaded synchronously above\n    // Beamable Config is fetched via API with a 2-second timeout\n    (async () => {\n      try {\n        startupLogger.info('Loading Beamable Config environment variables...');\n        await loadAndInjectEnvironmentVariables(envConfig, undefined, true, 2000);\n        startupLogger.info('Beamable Config loading completed');\n      } catch (error) {\n        startupLogger.warn(`Beamable Config loading completed with warnings: ${error instanceof Error ? error.message : String(error)}`);\n      }\n    })();\n    \n    // STEP 2: Get registered services to extract service name\n    const registered = listRegisteredServices();\n    if (registered.length === 0) {\n      throw new Error('No microservices registered. Use the @Microservice decorator to register at least one class.');\n    }\n    \n    // Use the first service's name for the main logger (for CloudWatch filtering and ClickHouse compatibility)\n    const primaryService = registered[0];\n    const qualifiedServiceName = `micro_${primaryService.qualifiedName}`;\n    \n    // STEP 3: Create logger immediately (non-blocking pattern, matching C#)\n    // Start with minimal console logger, upgrade to structured logger when collector is ready\n    // This allows the service to start immediately without blocking\n    startupLogger.info('Setting up OpenTelemetry collector in background (non-blocking)...');\n    \n    // Create logger immediately with console output (no OTLP yet)\n    // This ensures we have logging available right away\n    this.logger = createLogger(this.env, {\n      name: 'beamable-node-microservice',\n      serviceName: primaryService.name,\n      qualifiedServiceName: qualifiedServiceName,\n      // No otlpEndpoint - will use console logger initially\n    });\n    \n    // STEP 4: Start collector setup in background (non-blocking)\n    // When collector is ready, upgrade logger to structured logger with OTLP\n    // This matches C# pattern: collector starts in background, service starts immediately\n    startCollectorAndWaitForReady(this.env)\n      .then((endpoint) => {\n        if (endpoint) {\n          // Collector is ready - upgrade to structured logger with OTLP support\n          this.logger.info(`Collector ready at ${endpoint}, upgrading to structured logger for Portal logs...`);\n          this.logger = createLogger(this.env, {\n            name: 'beamable-node-microservice',\n            serviceName: primaryService.name,\n            qualifiedServiceName: qualifiedServiceName,\n            otlpEndpoint: endpoint, // Collector is ready, Portal logs will now work\n          });\n          this.logger.info('Portal logs enabled - structured logs will now appear in Beamable Portal');\n        } else {\n          this.logger.warn('Collector setup completed but no endpoint was returned. Continuing with console logs. Portal logs will not be available.');\n        }\n      })\n      .catch((error) => {\n        const errorMsg = error instanceof Error ? error.message : String(error);\n        this.logger.error(`Failed to setup collector: ${errorMsg}. Continuing with console logs. Portal logs will not be available.`);\n        // Service continues to work with console logger - graceful degradation\n      });\n    \n    // Continue immediately - don't wait for collector!\n    // Service can start accepting requests right away\n    // Collector setup happens in background, logger upgrades automatically when ready\n    this.serviceManager = new BeamableServiceManager(this.env, this.logger);\n\n    this.services = registered.map((definition) => {\n      const instance = new definition.ctor() as Record<string, unknown>;\n      const configureHandlers = getConfigureServicesHandlers(definition.ctor);\n      const initializeHandlers = getInitializeServicesHandlers(definition.ctor);\n      const logger = this.logger.child({ service: definition.name });\n      const federationRegistry = new FederationRegistry(logger);\n      const decoratedFederations = getFederationComponents(definition.ctor);\n      for (const component of decoratedFederations) {\n        federationRegistry.register(component);\n      }\n      const inventoryMetadata = getFederatedInventoryMetadata(definition.ctor);\n      if (inventoryMetadata.length > 0) {\n        federationRegistry.registerInventoryHandlers(instance, inventoryMetadata);\n      }\n      this.serviceManager.registerFederationRegistry(definition.name, federationRegistry);\n      return { definition, instance, configureHandlers, initializeHandlers, logger, federationRegistry };\n    });\n\n    const socketUrl = this.env.host.endsWith('/socket') ? this.env.host : `${this.env.host}/socket`;\n    this.webSocket = new BeamableWebSocket({ url: socketUrl, logger: this.logger });\n    this.webSocket.on('message', (payload) => {\n      this.logger.debug({ payload }, 'Runtime observed websocket frame.');\n    });\n    this.requester = new GatewayRequester(this.webSocket, this.logger);\n    this.authManager = new AuthManager(this.env, this.requester);\n    this.requester.on('event', (envelope) => this.handleEvent(envelope));\n\n    // Discovery broadcaster only runs in local development (not in containers)\n    // This allows the portal to detect that the service is running locally\n    if (!isRunningInContainer() && this.services.length > 0) {\n      this.discovery = new DiscoveryBroadcaster({\n        env: this.env,\n        serviceName: this.services[0].definition.name,\n        routingKey: this.env.routingKey,\n        logger: this.logger.child({ component: 'DiscoveryBroadcaster' }),\n      });\n    }\n  }\n\n  async start(): Promise<void> {\n    // Immediate console output for container logs (before logger is ready)\n    debugLog('[BEAMABLE-NODE] MicroserviceRuntime.start() called');\n    debugLog(`[BEAMABLE-NODE] Service count: ${this.services.length}`);\n    \n    this.printHelpfulUrls(this.services[0]);\n    this.logger.info('Starting Beamable Node microservice runtime.');\n    \n    // Start health check server FIRST - this is critical for container health checks\n    // Even if startup fails, the health check server must be running so we can debug\n    debugLog('[BEAMABLE-NODE] Starting health check server...');\n    await this.startHealthCheckServer();\n    debugLog('[BEAMABLE-NODE] Health check server started');\n    \n    try {\n      this.logger.info('Connecting to Beamable gateway...');\n      await this.webSocket.connect();\n      await new Promise((resolve) => setTimeout(resolve, 250));\n      \n      this.logger.info('Authenticating with Beamable...');\n      await this.authManager.authenticate();\n      \n      this.logger.info('Initializing Beamable SDK services...');\n      // Pass service name to initialize so routing key can be configured for service-level requests\n      const primaryServiceName = this.services[0]?.definition.name;\n      await this.serviceManager.initialize(primaryServiceName);\n\n      this.dependencyProvidersReady = false;\n\n      // Register with gateway before building the app DI graph so GET /health can go 200 while\n      // ConfigureServices/build still run (large graphs no longer block Portal probes).\n      this.logger.info('Registering basic service provider with gateway...');\n      await this.registerBasicServiceProvider();\n\n      this.isReady = true;\n      this.logger.info('Beamable microservice runtime is ready to accept traffic.');\n\n      this.logger.info('Initializing dependency providers...');\n      await this.initializeDependencyProviders();\n      this.dependencyProvidersReady = true;\n\n      this.logger.info('Registering event provider with gateway...');\n      await this.registerEventServiceProvider();\n\n      this.logger.info('Starting discovery broadcaster...');\n      await this.discovery?.start();\n    } catch (error) {\n      // Log the error with full context but don't crash - health check server is running\n      // This allows the container to stay alive so we can debug the issue\n      // Debug output for local development only (in containers, logger handles this)\n      debugLog('[BEAMABLE-NODE] FATAL ERROR during startup:');\n      debugLog(`[BEAMABLE-NODE] Error message: ${error instanceof Error ? error.message : String(error)}`);\n      debugLog(`[BEAMABLE-NODE] Error stack: ${error instanceof Error ? error.stack : 'No stack trace'}`);\n      debugLog(`[BEAMABLE-NODE] isReady: ${this.isReady}`);\n      \n      this.logger.error(\n        { \n          err: error,\n          errorMessage: error instanceof Error ? error.message : String(error),\n          errorStack: error instanceof Error ? error.stack : undefined,\n          isReady: this.isReady,\n        },\n        'Failed to fully initialize microservice runtime. Health check will continue to return 503 until initialization completes.'\n      );\n      // DON'T re-throw - keep process alive so health check can show 503\n      // This allows us to see the error in logs\n      this.isReady = false;\n      this.dependencyProvidersReady = false;\n    }\n  }\n\n  async shutdown(): Promise<void> {\n    this.logger.info('Shutting down microservice runtime.');\n    this.isReady = false; // Mark as not ready during shutdown\n    this.dependencyProvidersReady = false;\n    this.discovery?.stop();\n    await this.stopHealthCheckServer();\n    this.requester.dispose();\n    await this.webSocket.close();\n  }\n\n  private async startHealthCheckServer(): Promise<void> {\n    // For deployed services, always start health check server (required for container health checks)\n    // For local development, only start if healthPort is explicitly set\n    // IMPORTANT: Always default to 6565 if HEALTH_PORT env var is not set, as this is the standard port\n    const healthPort = this.env.healthPort || 6565;\n    \n    // Always start health check server if we have a valid port\n    // The container orchestrator expects this endpoint to be available\n    if (!healthPort || healthPort === 0) {\n      // Health check server not needed (local development without explicit port)\n      this.logger.debug('Health check server skipped (no healthPort set)');\n      return;\n    }\n\n    this.healthCheckServer = createServer((req, res) => {\n      if (req.url === '/health' && req.method === 'GET') {\n        // Only return success if service is fully ready (registered and accepting traffic)\n        if (this.isReady) {\n          res.writeHead(200, { 'Content-Type': 'text/plain' });\n          res.end('responsive');\n        } else {\n          // Service is still starting up\n          res.writeHead(503, { 'Content-Type': 'text/plain' });\n          res.end('Service Unavailable');\n        }\n      } else {\n        res.writeHead(404, { 'Content-Type': 'text/plain' });\n        res.end('Not Found');\n      }\n    });\n\n    return new Promise((resolve, reject) => {\n      this.healthCheckServer!.listen(healthPort, '0.0.0.0', () => {\n        this.logger.info({ port: healthPort }, 'Health check server started on port');\n        resolve();\n      });\n      this.healthCheckServer!.on('error', (err) => {\n        this.logger.error({ err, port: healthPort }, 'Failed to start health check server');\n        reject(err);\n      });\n    });\n  }\n\n  private async stopHealthCheckServer(): Promise<void> {\n    if (!this.healthCheckServer) {\n      return;\n    }\n\n    return new Promise((resolve) => {\n      this.healthCheckServer!.close(() => {\n        this.logger.info('Health check server stopped');\n        resolve();\n      });\n    });\n  }\n\n  /**\n   * POST basic provider to gateway. In start(), isReady is set immediately after this succeeds,\n   * before dependency providers are built; traffic is gated until dependencyProvidersReady.\n   */\n  private async registerBasicServiceProvider(): Promise<void> {\n    const primary = this.services[0]?.definition;\n    if (!primary) {\n      throw new Error('Unexpected missing service definition during registration.');\n    }\n    // Match C# exactly: use qualifiedName (preserves case) for name field.\n    // The gateway lowercases service names when creating bindings, but uses the original case\n    // from the registration request when constructing routing key lookups.\n    // This ensures the routing key format matches what the gateway expects.\n    // The gateway's binding lookup behavior:\n    // - Gateway error shows: \"No binding found for service ...micro_examplenodeservice.basic\"\n    // - This means the gateway lowercases the service name for binding storage/lookup\n    // - Portal sends requests with mixed case in URL and routing key header\n    // - The gateway lowercases the URL path for binding lookup, which should work\n    // - But we need to register with the format the gateway expects for the binding key\n    // - The gateway constructs binding key as: {cid}.{pid}.{lowercaseServiceName}.{type}\n    // - So we register with lowercase to match what the gateway stores in the binding\n    // - The portal will still send mixed case, and the gateway will lowercase it for lookup\n    // Register with mixed-case qualifiedName to match C# behavior\n    // The gateway will lowercase the service name when creating the binding key,\n    // but the registration request should use the original case (as C# does)\n    // This ensures the service name in the registration matches what the portal expects\n    // Register with mixed-case qualifiedName to match C# behavior\n    // The gateway's ServiceIdentity.fullNameNoType lowercases the service name when creating bindings,\n    // but the registration request should use the original case (as C# does)\n    // This ensures the service name in the registration matches what the portal expects\n    const isDeployed = isRunningInContainer();\n    \n    // For deployed services, routingKey should be null/undefined (None in Scala)\n    // For local dev, routingKey should be the actual routing key string\n    // The backend expects Option[String] = None for deployed services\n    // Note: microServiceId is not part of SocketSessionProviderRegisterRequest, so we don't include it\n    // All fields except 'type' are Option[T] in Scala, so undefined fields will be omitted from JSON\n    // This matches C# behavior where null/None fields are not serialized\n    const request: Record<string, unknown> = {\n      type: 'basic',\n      name: primary.qualifiedName, // Use mixed-case as C# does - gateway handles lowercasing for binding storage\n      beamoName: primary.name,\n    };\n    \n    // Only include routingKey and startedById if they have values (for local dev)\n    // For deployed services, these should be omitted (undefined) to match None in Scala\n    if (!isDeployed && this.env.routingKey) {\n      request.routingKey = this.env.routingKey;\n    }\n    if (!isDeployed && this.env.accountId) {\n      request.startedById = this.env.accountId;\n    }\n\n    // Log registration request to match C# behavior exactly\n    // Also log the actual JSON that will be sent (undefined fields will be omitted)\n    const serializedRequest = JSON.stringify(request);\n    this.logger.debug(\n      {\n        request: {\n          type: request.type,\n          name: request.name,\n          beamoName: request.beamoName,\n          routingKey: request.routingKey,\n          startedById: request.startedById,\n        },\n        serializedJson: serializedRequest,\n        isDeployed,\n      },\n      'Registering service provider with gateway.',\n    );\n\n    try {\n      await this.requester.request('post', 'gateway/provider', request);\n      this.logger.info({ serviceName: primary.qualifiedName }, 'Service provider registered successfully.');\n      // Former 2s deployed-only await blocked isReady and Portal \"Deploying\"; gateway still runs\n      // binding setup asynchronously — health can go green while that finishes.\n      if (isDeployed) {\n        this.logger.debug(\n          'Gateway binding setup continues asynchronously (no blocking sleep before health readiness).',\n        );\n      }\n    } catch (error) {\n      this.logger.error(\n        {\n          err: error,\n          request,\n          serviceName: primary.qualifiedName,\n          errorMessage: error instanceof Error ? error.message : String(error),\n        },\n        'Failed to register service provider with gateway. This will prevent the service from receiving requests.'\n      );\n      throw error; // Re-throw so startup fails and we can see the error\n    }\n  }\n\n  private async registerEventServiceProvider(): Promise<void> {\n    const primary = this.services[0]?.definition;\n    if (!primary) {\n      return;\n    }\n    const options = getServiceOptions(primary.ctor) ?? {};\n    if (options.disableAllBeamableEvents) {\n      this.logger.info('Beamable events disabled by configuration.');\n      return;\n    }\n    const eventRequest = {\n      type: 'event',\n      evtWhitelist: ['content.manifest', 'realm.config', 'logging.context'],\n    };\n    try {\n      await this.requester.request('post', 'gateway/provider', eventRequest);\n    } catch (error) {\n      this.logger.warn({ err: error }, 'Failed to register event provider. Continuing without events.');\n    }\n  }\n\n  private async handleEvent(envelope: WebsocketEventEnvelope): Promise<void> {\n    try {\n      if (!envelope.path) {\n        this.logger.debug({ envelope }, 'Ignoring websocket event without path.');\n        return;\n      }\n\n      if (envelope.path.startsWith('event/')) {\n        await this.requester.acknowledge(envelope.id);\n        return;\n      }\n\n      // Avoid dispatch with an empty DI scope while ConfigureServices/build is still running.\n      if (!this.dependencyProvidersReady) {\n        await this.requester.sendResponse({\n          id: envelope.id,\n          status: 503,\n          body: {\n            error: 'ServiceUnavailable',\n            message: 'Microservice dependency providers are still initializing.',\n          },\n        });\n        return;\n      }\n\n      const context = this.toRequestContext(envelope);\n      await this.dispatch(context);\n    } catch (error) {\n      const err = error instanceof Error ? error : new Error(String(error));\n      // Never return empty error/message to the gateway — some clients show a blank 500 when both are \"\".\n      const safeErrorName = (err.name && String(err.name).trim()) || 'Error';\n      const safeMessage =\n        (err.message && String(err.message).trim()) ||\n        (error == null\n          ? 'Unknown error (null/undefined)'\n          : error instanceof Error\n            ? '(empty Error.message)'\n            : String(error));\n      this.logger.error(\n        { err, envelope, responseError: safeErrorName, responseMessage: safeMessage },\n        'Failed to handle websocket event.',\n      );\n      const status = this.resolveErrorStatus(err);\n      const response: GatewayResponse = {\n        id: envelope.id,\n        status,\n        body: {\n          error: safeErrorName,\n          message: safeMessage,\n        },\n      };\n      await this.requester.sendResponse(response);\n    }\n  }\n\n  private toRequestContext(envelope: WebsocketEventEnvelope): RequestContext {\n    const path = envelope.path ?? '';\n    const method = envelope.method ?? 'post';\n    const userId = typeof envelope.from === 'number' ? envelope.from : 0;\n    const headers = envelope.headers ?? {};\n    \n    // Parse query parameters from path (e.g., /service/route?param1=value1&param2=value2)\n    const [pathWithoutQuery, queryString] = path.split('?', 2);\n    const query = this.parseQueryString(queryString ?? '');\n    \n    // Extract scopes from envelope.scopes array\n    // Note: X-DE-SCOPE header contains CID.PID, not scope values\n    // The gateway sends scopes in envelope.scopes array\n    // For admin endpoints, the gateway may not send scopes in the envelope,\n    // so we infer admin scope from the path if it's an admin route\n    const envelopeScopes = envelope.scopes ?? [];\n    let scopes = normalizeScopes(envelopeScopes);\n    \n    // If this is an admin endpoint and no scopes are provided, infer admin scope\n    // The gateway may not always send scopes for admin routes\n    const pathLower = pathWithoutQuery.toLowerCase();\n    if (pathLower.includes('/admin/') && scopes.size === 0) {\n      scopes = normalizeScopes(['admin']);\n    }\n\n    let body: Record<string, unknown> | undefined;\n    if (envelope.body && typeof envelope.body === 'string') {\n      try {\n        body = JSON.parse(envelope.body) as Record<string, unknown>;\n      } catch (error) {\n        this.logger.warn({ err: error, raw: envelope.body }, 'Failed to parse body string.');\n      }\n    } else if (envelope.body && typeof envelope.body === 'object') {\n      body = envelope.body as Record<string, unknown>;\n    }\n\n    let payload: unknown;\n    if (body && typeof body === 'object' && 'payload' in body) {\n      const rawPayload = (body as Record<string, unknown>).payload;\n      if (typeof rawPayload === 'string') {\n        try {\n          payload = JSON.parse(rawPayload) as unknown[];\n        } catch (error) {\n          this.logger.warn({ err: error }, 'Failed to parse payload JSON.');\n          payload = rawPayload;\n        }\n      } else {\n        payload = rawPayload;\n      }\n    }\n\n    const targetService = this.findServiceForPath(pathWithoutQuery);\n    const services = this.serviceManager.createFacade(userId, scopes, targetService?.definition.name);\n    const provider = this.createRequestScope(pathWithoutQuery, targetService);\n\n    const context: RequestContext = {\n      id: envelope.id,\n      path,\n      method,\n      status: envelope.status ?? 0,\n      userId,\n      payload,\n      body,\n      query,\n      scopes,\n      headers,\n      cid: this.env.cid,\n      pid: this.env.pid,\n      services,\n      throwIfCancelled: () => {},\n      isCancelled: () => false,\n      hasScopes: (...requiredScopes: string[]) => requiredScopes.every((scope) => scopeSetHas(scopes, scope)),\n      requireScopes: (...requiredScopes: string[]) => {\n        const missingScopes = requiredScopes.filter((scope) => !scopeSetHas(scopes, scope));\n        if (missingScopes.length > 0) {\n          throw new MissingScopesError(missingScopes);\n        }\n      },\n      provider,\n    };\n\n    provider.setInstance(REQUEST_CONTEXT_TOKEN, context);\n    provider.setInstance(BEAMABLE_SERVICES_TOKEN, services);\n\n    return context;\n  }\n\n  private findServiceForPath(path: string): ServiceInstance | undefined {\n    // Gateway sends paths with lowercase service names, so we need case-insensitive matching\n    // Match by comparing lowercase versions to handle gateway's lowercase path format\n    // Note: path should already have query string stripped before calling this method\n    const pathLower = path.toLowerCase();\n    return this.services.find((service) => {\n      const qualifiedNameLower = service.definition.qualifiedName.toLowerCase();\n      return pathLower.startsWith(`${qualifiedNameLower}/`);\n    });\n  }\n\n  /**\n   * Parses a query string into a record of parameter names to values.\n   * Handles multiple values for the same parameter name by storing them as an array.\n   * @param queryString The query string (without the leading '?')\n   * @returns A record mapping parameter names to their values (single string or array of strings)\n   */\n  private parseQueryString(queryString: string): Record<string, string | string[]> {\n    if (!queryString || queryString.trim().length === 0) {\n      return {};\n    }\n\n    const params: Record<string, string | string[]> = {};\n    const pairs = queryString.split('&');\n\n    for (const pair of pairs) {\n      const [key, value = ''] = pair.split('=', 2);\n      if (key) {\n        const decodedKey = decodeURIComponent(key);\n        const decodedValue = decodeURIComponent(value);\n\n        // If the key already exists, convert to array or append to existing array\n        if (decodedKey in params) {\n          const existing = params[decodedKey];\n          if (Array.isArray(existing)) {\n            existing.push(decodedValue);\n          } else {\n            params[decodedKey] = [existing, decodedValue];\n          }\n        } else {\n          params[decodedKey] = decodedValue;\n        }\n      }\n    }\n\n    return params;\n  }\n\n  private async dispatch(ctx: RequestContext): Promise<void> {\n    // Extract path without query string for routing\n    const pathWithoutQuery = this.getPathWithoutQuery(ctx.path);\n    const service = this.findServiceForPath(pathWithoutQuery);\n    if (!service) {\n      throw new UnknownRouteError(ctx.path);\n    }\n\n    if (await this.tryHandleFederationRoute(ctx, service)) {\n      return;\n    }\n\n    if (await this.tryHandleAdminRoute(ctx, service)) {\n      return;\n    }\n\n    // Extract route from path - handle case-insensitive path matching\n    const pathLower = pathWithoutQuery.toLowerCase();\n    const qualifiedNameLower = service.definition.qualifiedName.toLowerCase();\n    const route = pathLower.substring(qualifiedNameLower.length + 1);\n    const metadata = service.definition.callables.get(route);\n    if (!metadata) {\n      throw new UnknownRouteError(ctx.path);\n    }\n\n    // For server and admin access, allow userId: 0 if the appropriate scope is present\n    // For client access, always require userId > 0\n    if (metadata.requireAuth && ctx.userId <= 0) {\n      if (metadata.access === 'server' && scopeSetHas(ctx.scopes, 'server')) {\n        // Server callables with server scope don't need a user ID\n      } else if (metadata.access === 'admin' && scopeSetHas(ctx.scopes, 'admin')) {\n        // Admin callables with admin scope don't need a user ID\n      } else {\n        throw new UnauthorizedUserError(route);\n      }\n    }\n\n    enforceAccess(metadata.access, ctx);\n\n    if (metadata.requiredScopes.length > 0) {\n      const missing = metadata.requiredScopes.filter((scope) => !scopeSetHas(ctx.scopes, scope));\n      if (missing.length > 0) {\n        throw new MissingScopesError(missing);\n      }\n    }\n\n    const handler = service.instance[metadata.displayName];\n    if (typeof handler !== 'function') {\n      throw new Error(`Callable ${metadata.displayName} is not a function on service ${service.definition.name}.`);\n    }\n\n    const args = this.buildInvocationArguments(handler as (...args: unknown[]) => unknown, ctx);\n    const result = await Promise.resolve((handler as (...args: unknown[]) => unknown).apply(service.instance, args));\n    await this.sendSuccessResponse(ctx, metadata, result);\n  }\n\n  private buildInvocationArguments(\n    handler: (...args: unknown[]) => unknown,\n    ctx: RequestContext,\n  ): unknown[] {\n    const payload = Array.isArray(ctx.payload)\n      ? ctx.payload\n      : typeof ctx.payload === 'string'\n      ? [ctx.payload]\n      : ctx.payload === undefined\n      ? []\n      : [ctx.payload];\n\n    const expectedParams = handler.length;\n\n    // Determine if RequestContext should be passed as the first argument\n    // Strategy: If handler expects more parameters than payload provides,\n    //           assume the first parameter is RequestContext\n    // This covers common cases:\n    // - handler(ctx: RequestContext) with empty payload -> expectedParams=1, payload.length=0 -> include ctx\n    // - handler(ctx: RequestContext, param: string) with payload=['value'] -> expectedParams=2, payload.length=1 -> include ctx\n    // - handler(param: string) with payload=['value'] -> expectedParams=1, payload.length=1 -> don't include ctx\n    if (expectedParams > payload.length) {\n      return [ctx, ...payload];\n    }\n\n    // If handler expects exactly the same number of parameters as payload,\n    // don't include ctx (handler doesn't expect it)\n    return payload;\n  }\n\n  private async sendSuccessResponse(ctx: RequestContext, metadata: ServiceCallableMetadata, result: unknown): Promise<void> {\n    let body: unknown;\n    if (metadata.useLegacySerialization) {\n      const serialized = typeof result === 'string' ? result : JSON.stringify(result ?? null);\n      body = { payload: serialized };\n    } else {\n      body = result ?? null;\n    }\n\n    const response: GatewayResponse = {\n      id: ctx.id,\n      status: 200,\n      body,\n    };\n    await this.requester.sendResponse(response);\n  }\n\n  private async sendFederationResponse(ctx: RequestContext, result: unknown): Promise<void> {\n    const response: GatewayResponse = {\n      id: ctx.id,\n      status: 200,\n      body: result ?? null,\n    };\n    await this.requester.sendResponse(response);\n  }\n\n  private async tryHandleFederationRoute(ctx: RequestContext, service: ServiceInstance): Promise<boolean> {\n    // Gateway sends paths with lowercase service names, so we need case-insensitive matching\n    // Extract path without query string for routing\n    const pathWithoutQuery = this.getPathWithoutQuery(ctx.path);\n    const pathLower = pathWithoutQuery.toLowerCase();\n    const qualifiedNameLower = service.definition.qualifiedName.toLowerCase();\n    const prefixLower = `${qualifiedNameLower}/`;\n    if (!pathLower.startsWith(prefixLower)) {\n      return false;\n    }\n    // Extract relative path - use lowercase length since gateway sends lowercase paths\n    const relativePath = pathWithoutQuery.substring(qualifiedNameLower.length + 1);\n    const handler = service.federationRegistry.resolve(relativePath);\n    if (!handler) {\n      return false;\n    }\n\n    const result = await handler.invoke(ctx as FederatedRequestContext);\n    await this.sendFederationResponse(ctx, result);\n    return true;\n  }\n\n  private async tryHandleAdminRoute(ctx: RequestContext, service: ServiceInstance): Promise<boolean> {\n    // Gateway sends paths with lowercase service names, so we need case-insensitive matching\n    // Check if path starts with the admin prefix (case-insensitive)\n    // Extract path without query string for routing\n    const pathWithoutQuery = this.getPathWithoutQuery(ctx.path);\n    const pathLower = pathWithoutQuery.toLowerCase();\n    const adminPrefixLower = `${service.definition.qualifiedName.toLowerCase()}/admin/`;\n    if (!pathLower.startsWith(adminPrefixLower)) {\n      return false;\n    }\n\n    const options = getServiceOptions(service.definition.ctor) ?? {};\n\n    const action = pathLower.substring(adminPrefixLower.length);\n    const requiresAdmin = action === 'metadata' || action === 'docs';\n    if (requiresAdmin && !scopeSetHas(ctx.scopes, 'admin')) {\n      // For portal requests to admin endpoints, the gateway may not send scopes\n      // The X-DE-SCOPE header contains CID.PID, not scope values\n      // If this is a portal request (has X-DE-SCOPE header), grant admin scope\n      const hasPortalHeader = ctx.headers['X-DE-SCOPE'] || ctx.headers['x-de-scope'];\n      if (hasPortalHeader) {\n        // Grant admin scope for portal requests to admin endpoints\n        ctx.scopes.add('admin');\n      } else {\n        throw new MissingScopesError(['admin']);\n      }\n    }\n\n    switch (action) {\n      case 'health':\n      case 'healthcheck':\n        await this.requester.sendResponse({ id: ctx.id, status: 200, body: 'responsive' });\n        return true;\n      case 'metadata':\n      case 'docs':\n        break;\n      default:\n        if (!scopeSetHas(ctx.scopes, 'admin')) {\n          throw new MissingScopesError(['admin']);\n        }\n        throw new UnknownRouteError(ctx.path);\n    }\n\n    if (action === 'metadata') {\n      const federatedComponents = service.federationRegistry\n        .list()\n        .map((component) => ({\n          federationNamespace: component.federationNamespace,\n          federationType: component.federationType,\n        }));\n\n      await this.requester.sendResponse({\n        id: ctx.id,\n        status: 200,\n        body: {\n          serviceName: service.definition.name,\n          sdkVersion: this.env.sdkVersionExecution,\n          sdkBaseBuildVersion: this.env.sdkVersionExecution,\n          sdkExecutionVersion: this.env.sdkVersionExecution,\n          useLegacySerialization: Boolean(options.useLegacySerialization),\n          disableAllBeamableEvents: Boolean(options.disableAllBeamableEvents),\n          enableEagerContentLoading: false,\n          instanceId: this.microServiceId,\n          routingKey: this.env.routingKey ?? '',\n          federatedComponents,\n        },\n      });\n      return true;\n    }\n\n    if (action === 'docs') {\n      try {\n        const document = generateOpenApiDocument(\n          {\n            qualifiedName: service.definition.qualifiedName,\n            name: service.definition.name,\n            callables: Array.from(service.definition.callables.values()).map((callable) => ({\n              name: callable.displayName,\n              route: callable.route,\n              metadata: callable,\n              handler: typeof service.instance[callable.displayName] === 'function'\n                ? (service.instance[callable.displayName] as (...args: unknown[]) => unknown)\n                : undefined,\n            })),\n          },\n          this.env,\n          VERSION,\n        );\n\n        // Ensure document is valid (not empty)\n        if (!document || Object.keys(document).length === 0) {\n          this.logger.warn({ serviceName: service.definition.name }, 'Generated OpenAPI document is empty');\n        }\n\n        await this.requester.sendResponse({\n          id: ctx.id,\n          status: 200,\n          body: document,\n        });\n        return true;\n      } catch (error) {\n        this.logger.error({ err: error, serviceName: service.definition.name }, 'Failed to generate or send docs');\n        throw error;\n      }\n    }\n\n    return false;\n  }\n\n  private resolveErrorStatus(error: Error): number {\n    if (error instanceof UnauthorizedUserError) {\n      return 401;\n    }\n    if (error instanceof MissingScopesError) {\n      return 403;\n    }\n    if (error instanceof UnknownRouteError) {\n      return 404;\n    }\n    if (error instanceof BeamableRuntimeError) {\n      return 500;\n    }\n    return 500;\n  }\n\n  private printHelpfulUrls(service?: ServiceInstance): void {\n    if (!service) {\n      return;\n    }\n\n    // Only print helpful URLs when IS_LOCAL=1 is set\n    // In deployed containers, we want only JSON logs for proper log collection\n    if (process.env.IS_LOCAL !== '1' && process.env.IS_LOCAL !== 'true') {\n      return;\n    }\n\n    const docsUrl = buildDocsPortalUrl(this.env, service.definition);\n    const endpointBase = buildPostmanBaseUrl(this.env, service.definition);\n\n    const green = (text: string) => `\\x1b[32m${text}\\x1b[0m`;\n    const yellow = (text: string) => `\\x1b[33m${text}\\x1b[0m`;\n\n    const bannerLines = [\n      '',\n      yellow('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'),\n      ` ${green('Beamable Node microservice ready:')} ${green(service.definition.name)}`,\n      yellow(' Quick shortcuts'),\n      `   ${yellow('Docs:')}      ${docsUrl}`,\n      `   ${yellow('Endpoint:')} ${endpointBase}`,\n      yellow('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'),\n      '',\n    ];\n\n    process.stdout.write(`${bannerLines.join('\\n')}`);\n  }\n\n  private async initializeDependencyProviders(): Promise<void> {\n    // Get StorageService from service manager (it's initialized during serviceManager.initialize())\n    const storageService = this.serviceManager.getStorageService();\n    \n    for (const service of this.services) {\n      const builder = new DependencyBuilder();\n      builder.tryAddSingletonInstance(LOGGER_TOKEN, service.logger);\n      builder.tryAddSingletonInstance(ENVIRONMENT_CONFIG_TOKEN, this.env);\n      builder.tryAddSingletonInstance(BeamableServiceManager, this.serviceManager);\n      builder.tryAddSingletonInstance(StorageService, storageService);\n      builder.tryAddSingletonInstance(service.definition.ctor, service.instance);\n      builder.tryAddSingletonInstance(FederationRegistry, service.federationRegistry);\n\n      for (const handler of service.configureHandlers) {\n        await handler(builder);\n      }\n\n      const provider = builder.build();\n      service.provider = provider;\n\n      for (const handler of service.initializeHandlers) {\n        await handler(provider);\n      }\n\n      Object.defineProperty(service.instance, 'provider', {\n        value: provider,\n        enumerable: false,\n        configurable: false,\n        writable: false,\n      });\n    }\n  }\n\n  private createRequestScope(path: string, service?: ServiceInstance): MutableDependencyScope {\n    // Path should already have query string stripped before calling this method\n    const targetService = service ?? this.findServiceForPath(path);\n    const provider = targetService?.provider ?? new DependencyBuilder().build();\n    return provider.createScope();\n  }\n\n  /**\n   * Extracts the path portion without the query string.\n   * @param path The full path potentially containing a query string\n   * @returns The path without the query string\n   */\n  private getPathWithoutQuery(path: string): string {\n    const [pathWithoutQuery] = path.split('?', 2);\n    return pathWithoutQuery;\n  }\n}\n\nfunction enforceAccess(access: ServiceAccess, ctx: RequestContext): void {\n  switch (access) {\n    case 'client':\n      if (ctx.userId <= 0) {\n        throw new UnauthorizedUserError(ctx.path);\n      }\n      break;\n    case 'server':\n      if (!scopeSetHas(ctx.scopes, 'server')) {\n        throw new MissingScopesError(['server']);\n      }\n      break;\n    case 'admin':\n      if (!scopeSetHas(ctx.scopes, 'admin')) {\n        throw new MissingScopesError(['admin']);\n      }\n      break;\n    default:\n      break;\n  }\n}\n\n/**\n * Conditionally output to console.error only when running locally (not in container).\n * In containers, we want only Pino JSON logs to stdout for proper log collection.\n */\nfunction debugLog(...args: unknown[]): void {\n  // Only output debug logs when IS_LOCAL=1 is set\n  if (process.env.IS_LOCAL === '1' || process.env.IS_LOCAL === 'true') {\n    console.error(...args);\n  }\n}\n\n/**\n * Determines if we're running in a deployed container.\n * Used for service registration logic (routing key handling, discovery broadcaster, etc.)\n * \n * Note: For log formatting, use IS_LOCAL env var instead.\n */\nfunction isRunningInContainer(): boolean {\n  // Check for Docker container\n  try {\n    const fs = require('fs');\n    if (fs.existsSync('/.dockerenv')) {\n      return true;\n    }\n  } catch {\n    // fs might not be available\n  }\n  \n  // Check for Docker container hostname pattern (12 hex chars)\n  const hostname = process.env.HOSTNAME || '';\n  if (hostname && /^[a-f0-9]{12}$/i.test(hostname)) {\n    return true;\n  }\n  \n  // Explicit container indicators\n  if (\n    process.env.DOTNET_RUNNING_IN_CONTAINER === 'true' ||\n    process.env.CONTAINER === 'beamable' ||\n    !!process.env.ECS_CONTAINER_METADATA_URI ||\n    !!process.env.KUBERNETES_SERVICE_HOST\n  ) {\n    return true;\n  }\n  \n  // Default: assume local development\n  return false;\n}\n\nfunction normalizeScopes(scopes: Array<unknown>): Set<string> {\n  const normalized = new Set<string>();\n  for (const scope of scopes) {\n    if (typeof scope !== 'string' || scope.trim().length === 0) {\n      continue;\n    }\n    normalized.add(scope.trim().toLowerCase());\n  }\n  return normalized;\n}\n\nfunction scopeSetHas(scopes: Set<string>, scope: string): boolean {\n  const normalized = scope.trim().toLowerCase();\n  if (normalized.length === 0) {\n    return false;\n  }\n  return scopes.has('*') || scopes.has(normalized);\n}\n\nfunction buildPostmanBaseUrl(env: EnvironmentConfig, service: ServiceDefinition): string {\n  const httpHost = hostToHttpUrl(env.host);\n  const routingKeyPart = env.routingKey ? env.routingKey : '';\n  return `${httpHost}/basic/${env.cid}.${env.pid}.${routingKeyPart}${service.qualifiedName}/`;\n}\n\nfunction buildDocsPortalUrl(env: EnvironmentConfig, service: ServiceDefinition): string {\n  const portalHost = hostToPortalUrl(hostToHttpUrl(env.host));\n  const queryParams: Record<string, string> = { srcTool: 'node-runtime' };\n  if (env.routingKey) {\n    queryParams.routingKey = env.routingKey;\n  }\n  const query = new URLSearchParams(queryParams);\n  if (env.refreshToken) {\n    query.set('refresh_token', env.refreshToken);\n  }\n  const beamoId = service.name;\n  return `${portalHost}/${env.cid}/games/${env.pid}/realms/${env.pid}/microservices/micro_${beamoId}/docs?${query.toString()}`;\n}\n\nexport async function runMicroservice(): Promise<void> {\n  // Immediate console output to verify process is starting (local dev only)\n  // In containers, we rely on Pino logger for all output\n  debugLog('[BEAMABLE-NODE] Starting microservice...');\n  debugLog(`[BEAMABLE-NODE] Node version: ${process.version}`);\n  debugLog(`[BEAMABLE-NODE] Working directory: ${process.cwd()}`);\n  debugLog(`[BEAMABLE-NODE] Environment: ${JSON.stringify({\n    NODE_ENV: process.env.NODE_ENV,\n    CID: process.env.CID ? 'SET' : 'NOT SET',\n    PID: process.env.PID ? 'SET' : 'NOT SET',\n    HOST: process.env.HOST ? 'SET' : 'NOT SET',\n    SECRET: process.env.SECRET ? 'SET' : 'NOT SET',\n  })}`);\n  if (process.env.BEAMABLE_SKIP_RUNTIME === 'true') {\n    return;\n  }\n  const runtime = new MicroserviceRuntime();\n  \n  // Handle uncaught errors - log them but don't crash immediately\n  // This allows the health check server to keep running so we can debug\n  // In containers, errors will be logged by the logger in the runtime\n  // Locally, use console.error for visibility\n  process.on('uncaughtException', (error) => {\n    // In containers, the logger will handle this; locally, show in console\n    debugLog('Uncaught Exception:', error);\n    // Don't exit - let the health check server keep running\n  });\n  \n  process.on('unhandledRejection', (reason, promise) => {\n    // In containers, the logger will handle this; locally, show in console\n    debugLog('Unhandled Rejection at:', promise, 'reason:', reason);\n    // Don't exit - let the health check server keep running\n  });\n  \n  try {\n    await runtime.start();\n  } catch (error) {\n    // Log the error but don't exit - health check server is running\n    // This allows the container to stay alive so we can see what went wrong\n    // In containers, the logger already logged it in start(); locally, also use console.error\n    debugLog('Failed to start microservice runtime:', error);\n    // Keep the process alive so health check can continue\n    // The health check will return 503 until isReady is true\n  }\n  \n  const shutdownSignals: NodeJS.Signals[] = ['SIGTERM', 'SIGINT'];\n  shutdownSignals.forEach((signal) => {\n    process.once(signal, async () => {\n      await runtime.shutdown();\n      process.exit(0);\n    });\n  });\n}\n\ninterface GenerateOpenApiOptions {\n  serviceName?: string;\n}\n\nexport function generateOpenApiDocumentForRegisteredServices(\n  overrides: Partial<EnvironmentConfig> = {},\n  options: GenerateOpenApiOptions = {},\n): unknown {\n  const services = listRegisteredServices();\n  if (services.length === 0) {\n    throw new Error('No microservices registered. Import your service module before generating documentation.');\n  }\n\n  const baseEnv = buildEnvironmentConfig(overrides);\n  const primary = options.serviceName\n    ? services.find((svc) => svc.name === options.serviceName || svc.qualifiedName === options.serviceName)\n    : services[0];\n\n  if (!primary) {\n    throw new Error(`No registered microservice matched '${options.serviceName}'.`);\n  }\n\n  return generateOpenApiDocument(\n    {\n      qualifiedName: primary.qualifiedName,\n      name: primary.name,\n      callables: Array.from(primary.callables.entries()).map(([displayName, metadata]) => ({\n        name: displayName,\n        route: metadata.route,\n        metadata,\n        handler: undefined,\n      })),\n    },\n    baseEnv,\n    VERSION,\n  );\n}\n\nfunction buildEnvironmentConfig(overrides: Partial<EnvironmentConfig>): EnvironmentConfig {\n  const merged: Partial<EnvironmentConfig> = { ...overrides };\n\n  const ensure = (key: keyof EnvironmentConfig, fallbackEnv?: string) => {\n    if (merged[key] !== undefined) {\n      return;\n    }\n    if (fallbackEnv && process.env[fallbackEnv]) {\n      merged[key] = process.env[fallbackEnv] as never;\n    }\n  };\n\n  ensure('cid', 'CID');\n  ensure('pid', 'PID');\n  ensure('host', 'HOST');\n  ensure('secret', 'SECRET');\n  ensure('refreshToken', 'REFRESH_TOKEN');\n  // Routing key is optional for deployed services (in containers)\n  // It will be resolved to empty string if not provided and running in container\n  if (!merged.routingKey && !isRunningInContainer()) {\n    ensure('routingKey', 'NAME_PREFIX');\n  }\n\n  if (!merged.cid || !merged.pid || !merged.host) {\n    throw new Error('CID, PID, and HOST are required to generate documentation.');\n  }\n\n  const base = loadEnvironmentConfig();\n\n  return {\n    ...base,\n    ...merged,\n    routingKey: merged.routingKey ?? base.routingKey,\n  };\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omen.foundation/node-microservice-runtime",
-  "version": "0.1.121",
+  "version": "0.1.123",
   "description": "Beamable microservice runtime for Node.js/TypeScript services.",
   "type": "module",
   "main": "dist/index.js",
@@ -16,14 +16,18 @@
   },
   "files": [
     "dist",
-    "scripts"
+    "scripts",
+    "README.md",
+    "CLAUDE.md",
+    "AGENTS.md",
+    "beam.env.example",
+    "ai"
   ],
   "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",
-    "prepublishOnly": "npm run compile",
     "dev": "tsx --env-file .env src/dev.ts",
     "start": "node dist/index.js"
   },