@morojs/moro 1.7.29 → 1.8.0

package/dist/core/utilities/package-utils.js

@@ -1,7 +1,8 @@
 // Package and Module Resolution Utilities
 // ESM-compatible helpers for detecting and resolving optional dependencies
 import { createRequire } from 'module';
-import { join } from 'path';
+import { dirname, join } from 'path';
+import { existsSync, realpathSync } from 'fs';
 import { pathToFileURL } from 'url';
 /**
  * Check if a package is available in the user's node_modules
@@ -55,6 +56,202 @@ export function resolveUserPackage(packageName) {
 export function createUserRequire() {
     return createRequire(join(process.cwd(), 'package.json'));
 }
+// ---------------------------------------------------------------------------
+// Native HTTP engine loading
+// ---------------------------------------------------------------------------
+/**
+ * Package names probed for the native HTTP engine, in priority order.
+ * '@morojs/engine' is Moro's own engine (installed as an optionalDependency of
+ * the framework); 'uWebSockets.js' is honored as a legacy user-installed peer.
+ */
+export const NATIVE_ENGINE_PACKAGES = ['@morojs/engine', 'uWebSockets.js'];
+const FRAMEWORK_PACKAGE_NAME = '@morojs/moro';
+const NO_CAPABILITIES = {
+    limits: false,
+    tls: false,
+    http2: false,
+    wsDeflate: false,
+};
+const capabilitiesCache = new WeakMap();
+/**
+ * Feature-detect a loaded engine module. Reads probe().capabilities when the
+ * engine exposes it (>= 1.1.0); otherwise everything is false so the framework
+ * passes only the options an older engine understood. uWS-style modules (no
+ * probe/serve) report all-false — their SSL/limits go through the uWS-specific
+ * paths, not these flags.
+ */
+export function getEngineCapabilities(module) {
+    const surface = module?.default || module;
+    if (!surface || typeof surface !== 'object')
+        return NO_CAPABILITIES;
+    const cached = capabilitiesCache.get(surface);
+    if (cached)
+        return cached;
+    let caps = NO_CAPABILITIES;
+    try {
+        if (typeof surface.probe === 'function') {
+            const probe = surface.probe();
+            const c = probe?.capabilities;
+            if (c && typeof c === 'object') {
+                caps = {
+                    limits: c.limits === true,
+                    tls: c.tls === true,
+                    http2: c.http2 === true,
+                    wsDeflate: c.wsDeflate === true,
+                };
+            }
+        }
+    }
+    catch {
+        caps = NO_CAPABILITIES;
+    }
+    capabilitiesCache.set(surface, caps);
+    return caps;
+}
+// undefined = never attempted, null = attempted and failed
+let cachedEngine;
+let engineLoadErrors = [];
+/**
+ * Locate the installed framework package directory so the engine (a dependency
+ * of moro, not of the user's app) resolves under strict layouts like pnpm's.
+ * Walks up from cwd looking for node_modules/@morojs/moro, resolving symlinks
+ * so pnpm's store-linked layout anchors requires next to moro's own deps.
+ * Inside the framework repo itself (tests, examples) cwd is the framework dir.
+ */
+function findFrameworkAnchor() {
+    try {
+        const cwdPackageJson = join(process.cwd(), 'package.json');
+        if (existsSync(cwdPackageJson)) {
+            const require = createRequire(cwdPackageJson);
+            const name = require(cwdPackageJson)?.name;
+            if (name === FRAMEWORK_PACKAGE_NAME) {
+                return require;
+            }
+        }
+    }
+    catch {
+        // fall through to the node_modules walk
+    }
+    let dir = process.cwd();
+    for (;;) {
+        const packageJson = join(dir, 'node_modules', '@morojs', 'moro', 'package.json');
+        try {
+            if (existsSync(packageJson)) {
+                return createRequire(join(realpathSync(dirname(packageJson)), 'package.json'));
+            }
+        }
+        catch {
+            // unreadable/broken link - keep walking up
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+/**
+ * Synchronously load the native HTTP engine, trying '@morojs/engine' first and
+ * falling back to a user-installed 'uWebSockets.js'. Loading is require-based
+ * (both packages are CJS at their core - .node addon loading is require-based),
+ * so the instance is shared with any later import() via the CJS module cache.
+ *
+ * The default call is memoized: the engine either loads once per process or it
+ * doesn't. Failure details are retained for logging via
+ * getNativeEngineLoadErrors().
+ *
+ * @param options.candidates - Override the probed package names (testing).
+ *   When provided, the call bypasses the cache.
+ * @returns The loaded engine and its source package, or null if none loads
+ */
+export function loadNativeEngine(options) {
+    const useCache = !options?.candidates;
+    if (useCache && cachedEngine !== undefined) {
+        if (options?.collectErrors && !cachedEngine) {
+            options.collectErrors.push(...engineLoadErrors);
+        }
+        return cachedEngine;
+    }
+    const candidates = options?.candidates ?? NATIVE_ENGINE_PACKAGES;
+    const errors = [];
+    let result = null;
+    const frameworkRequire = findFrameworkAnchor();
+    const userRequire = createUserRequire();
+    for (const candidate of candidates) {
+        // Moro's own engine lives in moro's dependencies (framework anchor first);
+        // the legacy uWS peer dep lives in the user's node_modules (cwd first).
+        const anchors = candidate === 'uWebSockets.js'
+            ? [userRequire, frameworkRequire]
+            : [frameworkRequire, userRequire];
+        for (const anchor of anchors) {
+            if (!anchor)
+                continue;
+            try {
+                const module = anchor(candidate);
+                // Capability check: the HTTP server needs either a uWS-style App()
+                // factory or the Moro-shaped engine surface (serve()/respond()).
+                // A package that loads but can't serve (e.g. a pre-M1 @morojs/engine
+                // that only exposes probe()) must not shadow a usable alternative.
+                const surface = module?.default || module;
+                const uwsStyle = typeof surface?.App === 'function';
+                const moroStyle = !uwsStyle &&
+                    typeof surface?.serve === 'function' &&
+                    typeof surface?.respond === 'function';
+                if (!uwsStyle && !moroStyle) {
+                    errors.push(`${candidate}: loaded but provides neither App() nor serve()/respond() - not a usable HTTP engine`);
+                    continue;
+                }
+                let version;
+                try {
+                    // May be blocked by the package's exports map - version is optional
+                    version = anchor(`${candidate}/package.json`)?.version;
+                }
+                catch {
+                    version = undefined;
+                }
+                result = {
+                    module,
+                    source: candidate,
+                    version,
+                    capabilities: moroStyle ? getEngineCapabilities(module) : NO_CAPABILITIES,
+                };
+                break;
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message.split('\n')[0] : String(error);
+                errors.push(`${candidate}: ${message}`);
+            }
+        }
+        if (result)
+            break;
+    }
+    // Candidate-override probes (e.g. the clustering worker's uWS-only check)
+    // must not clobber the diagnostics of the real default load, which
+    // framework startup logging reads via getNativeEngineLoadErrors().
+    if (useCache) {
+        engineLoadErrors = result ? [] : [...new Set(errors)];
+        cachedEngine = result;
+    }
+    // Hand this specific call's failure detail back to a caller that asked for it,
+    // regardless of caching (so 'moro'/'uws' fallback reasons are precise).
+    if (options?.collectErrors && !result) {
+        options.collectErrors.push(...new Set(errors));
+    }
+    return result;
+}
+/**
+ * Failure details from the most recent unsuccessful loadNativeEngine() call,
+ * one entry per package/anchor attempt. Empty after a successful load.
+ */
+export function getNativeEngineLoadErrors() {
+    return engineLoadErrors;
+}
+/**
+ * Clear the memoized engine load result. Testing only.
+ */
+export function resetNativeEngineLoaderForTesting() {
+    cachedEngine = undefined;
+    engineLoadErrors = [];
+}
 /**
  * Convert a file path to a file URL for ESM dynamic imports
  * This is required on Windows where absolute paths like C:\path\to\module

package/dist/core/utilities/package-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"package-utils.js","sourceRoot":"","sources":["../../../src/core/utilities/package-utils.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,2EAA2E;AAE3E,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACpD,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;QACvE,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACpD,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;IACvE,OAAO,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,0EAA0E;IAC1E,IACE,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC;QAC9B,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC;QAC9B,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,EAC/B,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,qDAAqD;IACrD,MAAM,wBAAwB,GAAG,kBAAkB,CAAC;IACpD,MAAM,iBAAiB,GAAG,wBAAwB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAElE,qDAAqD;IACrD,MAAM,cAAc,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAEhD,oDAAoD;IACpD,MAAM,YAAY,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAEjD,sCAAsC;IACtC,IAAI,iBAAiB,IAAI,cAAc,IAAI,YAAY,EAAE,CAAC;QACxD,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;IACtC,CAAC;IAED,2DAA2D;IAC3D,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"package-utils.js","sourceRoot":"","sources":["../../../src/core/utilities/package-utils.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -8,7 +8,7 @@ export type { RuntimeType, RuntimeAdapter, RuntimeConfig, RuntimeHttpResponse, }
 export { NodeRuntimeAdapter, VercelEdgeAdapter, AWSLambdaAdapter, CloudflareWorkersAdapter, createRuntimeAdapter, createNodeHandler, createEdgeHandler, createLambdaHandler, createWorkerHandler, } from './core/runtime/index.js';
 export type { LambdaEvent, LambdaContext, LambdaResponse, } from './core/runtime/aws-lambda-adapter.js';
 export type { WorkersEnv, WorkersContext } from './core/runtime/cloudflare-workers-adapter.js';
-export { MoroHttpServer, UWebSocketsHttpServer } from './core/http/index.js';
+export { MoroHttpServer, UWebSocketsHttpServer, MoroEngineServer } from './core/http/index.js';
 export { builtInMiddleware, simpleMiddleware } from './core/middleware/built-in/index.js';
 export { WebSocketManager, ServiceRegistry } from './core/networking/index.js';
 export type { ServiceInfo, ServiceDiscoveryOptions } from './core/networking/service-discovery.js';

package/dist/index.js

@@ -6,7 +6,7 @@ export { createAuthMiddleware, MoroJSAuth } from './core/auth/morojs-adapter.js'
 export { auth, providers, twoFactor, organization, anonymous, accountLinking, rateLimit, bearerToken, } from './core/middleware/built-in/auth/index.js';
 export { NodeRuntimeAdapter, VercelEdgeAdapter, AWSLambdaAdapter, CloudflareWorkersAdapter, createRuntimeAdapter, createNodeHandler, createEdgeHandler, createLambdaHandler, createWorkerHandler, } from './core/runtime/index.js';
 // Core exports
-export { MoroHttpServer, UWebSocketsHttpServer } from './core/http/index.js';
+export { MoroHttpServer, UWebSocketsHttpServer, MoroEngineServer } from './core/http/index.js';
 export { builtInMiddleware, simpleMiddleware } from './core/middleware/built-in/index.js';
 // Networking System
 export { WebSocketManager, ServiceRegistry } from './core/networking/index.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,EACL,IAAI,EACJ,IAAI,IAAI,QAAQ,EAChB,SAAS,EACT,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,MAAM,EACN,UAAU,GACX,MAAM,WAAW,CAAC;AAwBnB,qCAAqC;AACrC,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEjF,uCAAuC;AACvC,OAAO,EACL,IAAI,EACJ,SAAS,EACT,SAAS,EACT,YAAY,EACZ,SAAS,EACT,cAAc,EACd,SAAS,EACT,WAAW,GACZ,MAAM,0CAA0C,CAAC;AAkBlD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AAUjC,eAAe;AACf,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC/F,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAE1F,oBAAoB;AACpB,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG/E,iCAAiC;AACjC,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,SAAS,EACT,WAAW,EACX,cAAc,EACd,WAAW,EACX,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB;AACjB,wDAAwD;AACxD,QAAQ,EACR,eAAe,GAChB,MAAM,2BAA2B,CAAC;AAUnC,eAAe;AACf,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAYtD,gBAAgB;AAChB,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEvE,8BAA8B;AAC9B,OAAO,EACL,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,MAAM,EACN,cAAc,EACd,CAAC,EACD,qBAAqB,EACrB,eAAe,GAChB,MAAM,4BAA4B,CAAC;AAmBpC,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,IAAI,eAAe,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEhG,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,6BAA6B,GAC9B,MAAM,yBAAyB,CAAC;AAcjC,8BAA8B;AAC9B,OAAO,EACL,eAAe,EACf,SAAS,EACT,kBAAkB,GACnB,MAAM,qCAAqC,CAAC;AAE7C,6BAA6B;AAC7B,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAa7F,uBAAuB;AACvB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,yBAAyB,EACzB,iCAAiC,GAClC,MAAM,sBAAsB,CAAC;AAG9B,0BAA0B;AAC1B,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,UAAU,EACV,aAAa,EACb,YAAY,EACZ,SAAS,EACT,cAAc,EACd,MAAM,EACN,cAAc,GACf,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,WAAW,GACZ,MAAM,wBAAwB,CAAC;AA6BhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AAEjF,wEAAwE;AACxE,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,+CAA+C,CAAC;AAEvD,aAAa;AACb,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,EACZ,SAAS,EACT,SAAS,GACV,MAAM,sBAAsB,CAAC;AAmB9B,oBAAoB;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAG/D,eAAe;AACf,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,kDAAkD,CAAC;AAEpF,gFAAgF;AAChF,mEAAmE;AACnE,0EAA0E;AAC1E,OAAO,EAAE,YAAY,EAAE,YAAY,IAAI,MAAM,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAanG,WAAW;AACX,cAAc,oDAAoD,CAAC;AACnE,cAAc,kDAAkD,CAAC;AACjE,cAAc,mCAAmC,CAAC;AAqClD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE9D,kBAAkB;AAClB,OAAO,EACL,QAAQ,EACR,qBAAqB,EACrB,eAAe,EACf,wBAAwB,EACxB,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAoB9B,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,aAAa,GACd,MAAM,+BAA+B,CAAC"}

package/dist/moro.d.ts

@@ -214,6 +214,8 @@ export declare class Moro extends EventEmitter {
     private pathToRegex;
     get events(): MoroEventBus;
     get core(): MoroCore;
+    get engine(): ReturnType<MoroCore['getServerKind']>;
+    getServerKind(): ReturnType<MoroCore['getServerKind']>;
     getContainer(): import("./index.js").Container;
     forceCleanup(): void;
     private addRoute;

package/dist/moro.js

@@ -767,8 +767,11 @@ export class Moro extends EventEmitter {
         const startServer = () => {
             const actualCallback = () => {
                 const displayHost = host || 'localhost';
+                const serverKind = this.engine;
                 this.logger.info('Moro Server Started', 'Server');
                 this.logger.info(`Runtime: ${this.runtimeType}`, 'Server');
+                this.logger.info(`HTTP engine: ${serverKind.server}` +
+                    (serverKind.enginePackage ? ` (${serverKind.enginePackage})` : ''), 'Server');
                 this.logger.info(`HTTP API: http://${displayHost}:${port}`, 'Server');
                 if (this.config.websocket.enabled) {
                     this.logger.info(`WebSocket: ws://${displayHost}:${port}`, 'Server');
@@ -781,7 +784,11 @@ export class Moro extends EventEmitter {
                     // Log performance stats
                     this.unifiedRouter.logPerformanceStats();
                 }
-                this.eventBus.emit('server:started', { port, runtime: this.runtimeType });
+                this.eventBus.emit('server:started', {
+                    port,
+                    runtime: this.runtimeType,
+                    engine: serverKind,
+                });
                 // Start job scheduler after server starts
                 this.startJobScheduler().catch(err => {
                     this.logger.error(`Failed to start job scheduler: ${String(err)}`);
@@ -813,20 +820,30 @@ export class Moro extends EventEmitter {
             this.ensureAutoDiscoveryComplete().then(() => this.ensureRoutesLoaded()),
             this.processQueuedWebSocketRegistrations(),
         ])
-            .then(() => {
-            startServer();
-        })
-            .catch(error => {
+            .then(() => startServer(), initError => {
+            // Initialization (auto-discovery / WebSocket setup) failed — this is
+            // NOT the listen() call. Handle it here so a subsequent listen()
+            // failure can't be misdiagnosed as an init failure and retried.
             this.logger.error('Initialization failed during server start', 'Framework', {
-                error: error instanceof Error ? error.message : String(error),
+                error: initError instanceof Error ? initError.message : String(initError),
             });
-            // For auto-discovery failures, start server anyway
-            // For WebSocket failures with queued registrations, error will propagate
-            if (error instanceof Error &&
-                error.message.includes('WebSocket features require a WebSocket adapter')) {
-                throw error;
+            // WebSocket-adapter misconfiguration is fatal; propagate it.
+            if (initError instanceof Error &&
+                initError.message.includes('WebSocket features require a WebSocket adapter')) {
+                throw initError;
             }
+            // A non-fatal init issue (e.g. auto-discovery) — start the server anyway.
             startServer();
+        })
+            .catch(error => {
+            // startServer()/listen() failed — e.g. EADDRINUSE thrown synchronously
+            // by the native engine. Retrying would fail identically, so surface it
+            // via the 'error' event (Node's server convention) instead of retrying
+            // into an unhandled rejection. With no 'error' listener, EventEmitter
+            // rethrows — the desired visible crash for a fatal bind failure.
+            const message = error instanceof Error ? error.message : String(error);
+            this.logger.error(`Failed to start server on port ${port}: ${message}`, 'Framework');
+            this.emit('error', error);
         });
     }
     // Public method to manually initialize auto-discovery
@@ -1113,6 +1130,15 @@ export class Moro extends EventEmitter {
     get core() {
         return this.coreFramework;
     }
+    // Which HTTP server actually booted (engine/node/http2), the package
+    // backing a native engine, and the fallback reason when one was requested
+    // but the Node server booted instead. Stable surface for logs/tests/benchmarks.
+    get engine() {
+        return this.coreFramework.getServerKind();
+    }
+    getServerKind() {
+        return this.coreFramework.getServerKind();
+    }
     // Public API for accessing the DI container
     getContainer() {
         return this.coreFramework.getContainer();
@@ -1278,7 +1304,7 @@ export class Moro extends EventEmitter {
                     }
                     // Rate limiting middleware
                     if (route.rateLimit) {
-                        const clientId = req.ip || req.connection.remoteAddress || 'unknown';
+                        const clientId = req.ip || req.connection?.remoteAddress || 'unknown';
                         const key = `${route.method}:${route.path}:${clientId}`;
                         if (!this.checkRateLimit(key, route.rateLimit)) {
                             res.status(429).json({
@@ -1720,33 +1746,49 @@ export class Moro extends EventEmitter {
                     port,
                     runtime: this.runtimeType,
                     worker: process.pid,
+                    engine: this.engine,
                 });
             };
             // Ensure WebSocket setup is complete before starting worker
-            this.processQueuedWebSocketRegistrations()
-                .then(() => {
+            const startWorkerListening = () => {
                 if (host) {
                     this.coreFramework.listen(port, host, workerCallback);
                 }
                 else {
                     this.coreFramework.listen(port, workerCallback);
                 }
-            })
+            };
+            this.processQueuedWebSocketRegistrations()
+                .then(startWorkerListening)
                 .catch(error => {
+                const message = error instanceof Error ? error.message : String(error);
+                const code = error?.code;
+                // listen() itself failed (EADDRINUSE etc.): retrying is guaranteed to
+                // fail again and would surface as an unhandled rejection crash-loop.
+                // Log fatally and exit so the cluster primary sees a clean death.
+                // Prefer the code the native/Node servers set; fall back to message.
+                if (code === 'EADDRINUSE' ||
+                    code === 'EACCES' ||
+                    /EADDRINUSE|failed to bind/i.test(message)) {
+                    this.logger.error(`Worker ${process.pid} could not bind port ${port}: ${message}`, 'Worker');
+                    process.exit(1);
+                }
                 this.logger.error('WebSocket initialization failed in worker', 'Worker', {
-                    error: error instanceof Error ? error.message : String(error),
+                    error: message,
                 });
                 // For WebSocket failures with queued registrations, error will propagate
                 if (error instanceof Error &&
                     error.message.includes('WebSocket features require a WebSocket adapter')) {
                     throw error;
                 }
-                // Start anyway for other errors
-                if (host) {
-                    this.coreFramework.listen(port, host, workerCallback);
+                // WebSocket setup failed but the HTTP server can still serve: start
+                // anyway, and surface (not swallow) a listen failure from this path.
+                try {
+                    startWorkerListening();
                 }
-                else {
-                    this.coreFramework.listen(port, workerCallback);
+                catch (listenError) {
+                    this.logger.error(`Worker ${process.pid} failed to start: ${listenError instanceof Error ? listenError.message : String(listenError)}`, 'Worker');
+                    process.exit(1);
                 }
             });
         }