mcp-server-framework 1.0.0

package/build/server/server-instance.js

@@ -0,0 +1,615 @@
+/**
+ * MCP Server Instance
+ *
+ * The central framework object. Runtime implementation of the ServerInstance
+ * interface. Manages the MCP server lifecycle including transport selection,
+ * session management, signal handling, and graceful shutdown.
+ *
+ * Each connected client gets its own McpSession (1:1 per MCP SDK spec).
+ * Session creation is delegated to McpSessionFactory (SRP).
+ * Cancellation and progress are handled natively by the SDK.
+ *
+ * This class is created by McpServerBuilder and should not be
+ * instantiated directly by application code.
+ *
+ * @module server/server-instance
+ */
+import { isHttpTransport } from "./server-options.js";
+import { mapServerOptionsToOverrides } from "./option-overrides.js";
+import { startStdioTransport } from "./transport/stdio-transport.js";
+import { SessionManagerImpl } from "./session/index.js";
+import { Logger, logger as frameworkLogger, configureLogger } from "../logger/index.js";
+import { initializeTelemetry, shutdownTelemetry } from "../telemetry/index.js";
+import { DEFAULT_SHUTDOWN_CONFIG } from "./lifecycle.js";
+import { applyConfigOverrides, getFrameworkConfig, flushStartupWarnings, setConfigLogger } from "../config/index.js";
+import { isFullOAuthProvider } from "./auth/types.js";
+// ============================================================================
+// Constants
+// ============================================================================
+const LOG_COMPONENT = "server-runtime";
+const DEFAULT_SIGNALS = ["SIGINT", "SIGTERM"];
+const RuntimeLogMessages = {
+    SERVER_STARTING: "Server starting...",
+    SERVER_STARTED: "Server started: %s v%s (%s mode)",
+    SERVER_START_FAILED: "Server start failed: %s",
+    SERVER_STOPPING: "Server stopping...",
+    SERVER_STOPPED: "Server stopped",
+    SERVER_ALREADY_RUNNING: "Server is already running.",
+    SHUTDOWN_SIGNAL: "Received shutdown signal: %s",
+    SHUTDOWN_FORCED: "Forcing server shutdown after timeout",
+    SHUTDOWN_ALREADY: "Shutdown already in progress",
+    // State transitions
+    STATE_TRANSITION: "Server state: %s → %s",
+    // Telemetry
+    TELEMETRY_INIT: "OpenTelemetry initialized",
+    TELEMETRY_SKIPPED: "OpenTelemetry disabled — skipping initialization",
+    TELEMETRY_SHUTDOWN: "OpenTelemetry shut down",
+    // Lifecycle hooks
+    LIFECYCLE_HOOK_ERROR: "Lifecycle hook %s failed: %s",
+    // Transport
+    TRANSPORT_STARTING: "Starting %s transport...",
+    STATELESS_MODE: "Stateless mode active — sessions are per-request. Per-request features (progress, logging, abort) work normally. Cross-request features (cancellation, sampling, elicitation, roots, GET SSE) are unavailable by design.",
+    STATELESS_EVENT_STORE_IGNORED: "eventStore is set but has no effect in stateless mode — events are not persisted without sessions.",
+    STATELESS_SSE_IGNORED: "legacySseEnabled is set but has no effect in stateless mode — SSE requires persistent sessions.",
+    // Partial cleanup
+    PARTIAL_CLEANUP: "Cleaning up partially initialized resources after start failure",
+    // Auth
+    AUTH_OAUTH_ENABLED: "OAuth authentication enabled (issuer: %s)",
+    AUTH_BEARER_ENABLED: "Bearer token authentication enabled (custom verifier)",
+    AUTH_STDIO_WARNING: "Auth configuration ignored in stdio mode — stdio does not support authentication",
+    AUTH_NO_TRUST_PROXY: "Auth is enabled without trust proxy — client IP detection may be inaccurate behind a reverse proxy",
+    AUTH_PROVIDER_DISPOSED: "Auth provider disposed",
+    // Shutdown cleanup
+    SHUTDOWN_STEP_FAILED: "Shutdown step %s failed: %s",
+    // Process error handlers
+    UNHANDLED_REJECTION: "Unhandled promise rejection — initiating graceful shutdown: %s",
+    UNCAUGHT_EXCEPTION: "Uncaught exception — initiating graceful shutdown: %s",
+    SHUTDOWN_FAILED: "Graceful shutdown failed: %s",
+};
+const logger = frameworkLogger.child({ component: LOG_COMPONENT });
+// ============================================================================
+// Server Instance Implementation
+// ============================================================================
+/**
+ * The central MCP server framework object.
+ *
+ * Manages the MCP server lifecycle including:
+ * - Multi-session support (one McpSession per client in HTTP mode)
+ * - Transport selection (stdio/http/https)
+ * - Signal handling with graceful shutdown
+ *
+ * Session creation is delegated to {@link McpSessionFactory}.
+ *
+ * @internal Created by McpServerBuilder — do not instantiate directly.
+ */
+export class McpServerInstance {
+    options;
+    sessionFactory;
+    serverState = "created";
+    /** Whether telemetry has been initialized */
+    telemetryInitialized = false;
+    /** Resolved transport mode, cached at construction time */
+    transportMode;
+    /** Unified session manager — single source of truth for all sessions */
+    sessionManager;
+    /** Transport handle for shutdown and info queries */
+    transportHandle;
+    /** Stored signal handler references for cleanup on stop/restart */
+    signalHandlers = [];
+    /** Stored process error handler references for cleanup on stop/restart */
+    processErrorHandlers = [];
+    /** Guard against concurrent shutdown from multiple error sources */
+    shutdownInProgress = false;
+    constructor(options, sessionFactory) {
+        this.options = options;
+        this.sessionFactory = sessionFactory;
+        this.transportMode = options.transport.mode;
+        logger.debug(RuntimeLogMessages.STATE_TRANSITION, "(none)", "created");
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // ServerInstance Interface
+    // ─────────────────────────────────────────────────────────────────────────
+    get name() {
+        return this.options.name;
+    }
+    get version() {
+        return this.options.version;
+    }
+    get isRunning() {
+        return this.serverState === "running";
+    }
+    /**
+     * Notify all connected MCP clients that the tool list has changed.
+     *
+     * Call this when external connection state changes affect tool availability.
+     * Delegates to the unified SessionManager which handles all transport types.
+     */
+    notifyToolListChanged() {
+        this.sessionManager?.broadcastToolListChanged();
+    }
+    /**
+     * Notify all connected MCP clients that the resource list has changed.
+     */
+    notifyResourceListChanged() {
+        this.sessionManager?.broadcastResourceListChanged();
+    }
+    /**
+     * Notify all connected MCP clients that the prompt list has changed.
+     */
+    notifyPromptListChanged() {
+        this.sessionManager?.broadcastPromptListChanged();
+    }
+    /**
+     * Notify subscribed MCP clients that a specific resource has been updated.
+     * Only sessions that subscribed to the given URI receive the notification.
+     */
+    notifyResourceUpdated(uri) {
+        this.sessionManager?.broadcastResourceUpdated(uri);
+    }
+    /**
+     * Initialize OpenTelemetry before starting the server.
+     *
+     * OTEL auto-instrumentation must be initialized before any HTTP/Express
+     * modules are loaded to properly instrument them. Call this as early
+     * as possible. No-op if telemetry is disabled or already initialized.
+     */
+    async initTelemetry() {
+        if (this.telemetryInitialized) {
+            return;
+        }
+        if (!this.options.telemetryEnabled) {
+            logger.debug(RuntimeLogMessages.TELEMETRY_SKIPPED);
+            return;
+        }
+        await initializeTelemetry(this.options.onBeforeTelemetryInit);
+        this.telemetryInitialized = true;
+        logger.debug(RuntimeLogMessages.TELEMETRY_INIT);
+    }
+    async start() {
+        if (this.serverState === "running" || this.serverState === "starting") {
+            logger.warn(RuntimeLogMessages.SERVER_ALREADY_RUNNING);
+            return;
+        }
+        this.transitionState("starting");
+        logger.info(RuntimeLogMessages.SERVER_STARTING);
+        // Register signal handlers FIRST so that SIGINT/SIGTERM during any
+        // async startup step (telemetry init, transport bind) triggers
+        // graceful shutdown instead of a hard process exit.
+        this.setupSignalHandlers();
+        try {
+            // Bridge programmatic options → framework config cache
+            // Must happen FIRST so onStarting() hooks can use the final config
+            // (e.g., API credentials from config file).
+            this.applyProgrammaticOverrides();
+            // Bridge config file values → logger (must run after config resolution)
+            this.applyLoggerConfig();
+            // Inject logger into config module (breaks config→logger dependency)
+            setConfigLogger(frameworkLogger.child({ component: "config" }));
+            // Replay startup warnings through the now-configured logger
+            flushStartupWarnings((msg) => logger.warn(msg));
+            // Initialize telemetry BEFORE lifecycle hooks so that consumer
+            // API calls in onStarting() are already instrumented (DD-018).
+            await this.initTelemetry();
+            await this.invokeLifecycleHook("onStarting", () => this.options.lifecycle?.onStarting?.());
+            logger.debug(RuntimeLogMessages.TRANSPORT_STARTING, this.transportMode);
+            const sessionFactory = () => this.sessionFactory.create();
+            this.sessionManager = this.createSessionManager();
+            this.transportHandle = await this.startTransport(sessionFactory, this.sessionManager);
+            // Log stateless mode warning after transport is started
+            if (isHttpTransport(this.options.transport) && this.options.transport.stateless) {
+                logger.warn(RuntimeLogMessages.STATELESS_MODE);
+                // Warn about ineffective config combinations
+                if (this.options.transport.eventStore) {
+                    logger.warn(RuntimeLogMessages.STATELESS_EVENT_STORE_IGNORED);
+                }
+                if (this.options.transport.legacySseEnabled) {
+                    logger.warn(RuntimeLogMessages.STATELESS_SSE_IGNORED);
+                }
+            }
+            // Log auth configuration
+            this.logAuthConfiguration();
+            this.transitionState("running");
+            await this.invokeLifecycleHook("onStarted", () => this.options.lifecycle?.onStarted?.());
+            logger.debug(RuntimeLogMessages.SERVER_STARTED, this.options.name, this.options.version, this.transportMode);
+        }
+        catch (error) {
+            this.transitionState("error");
+            const err = error instanceof Error ? error : new Error(String(error));
+            logger.error(RuntimeLogMessages.SERVER_START_FAILED, err.message);
+            // Remove signal handlers so they don't trigger on a failed server
+            this.removeSignalHandlers();
+            // Cleanup partially initialized resources — each step individually
+            // guarded (error isolation), mirroring the pattern used in stop().
+            if (this.sessionManager || this.transportHandle || this.telemetryInitialized) {
+                logger.debug(RuntimeLogMessages.PARTIAL_CLEANUP);
+            }
+            if (this.sessionManager) {
+                this.sessionManager.dispose();
+                this.sessionManager = undefined;
+            }
+            if (this.transportHandle) {
+                await this.transportHandle.shutdown();
+                this.transportHandle = undefined;
+            }
+            if (this.telemetryInitialized) {
+                await shutdownTelemetry();
+                this.telemetryInitialized = false;
+            }
+            await this.invokeLifecycleHook("onError", () => this.options.lifecycle?.onError?.(err));
+            throw err;
+        }
+    }
+    /**
+     * Gracefully stop the server.
+     *
+     * Performs cleanup in order: sessions → transport → auth → logger → telemetry.
+     * Each step is individually guarded (error isolation) so that a failure
+     * in one step does not prevent the remaining steps from running.
+     * Idempotent — calling `stop()` on an already stopped server is a no-op.
+     */
+    async stop() {
+        if (this.serverState === "stopping" || this.serverState === "stopped") {
+            logger.debug(RuntimeLogMessages.SHUTDOWN_ALREADY);
+            return;
+        }
+        this.transitionState("stopping");
+        logger.info(RuntimeLogMessages.SERVER_STOPPING);
+        this.removeSignalHandlers();
+        await this.invokeLifecycleHook("onStopping", () => this.options.lifecycle?.onStopping?.());
+        // Each cleanup step is individually guarded so that a failure in one
+        // step does not prevent the remaining steps from running (error isolation).
+        try {
+            if (this.sessionManager) {
+                await this.sessionManager.closeAll();
+                this.sessionManager.dispose();
+            }
+        }
+        catch (error) {
+            logger.warn(RuntimeLogMessages.SHUTDOWN_STEP_FAILED, "sessions", error instanceof Error ? error.message : String(error));
+        }
+        try {
+            if (this.transportHandle) {
+                await this.transportHandle.shutdown();
+            }
+        }
+        catch (error) {
+            logger.warn(RuntimeLogMessages.SHUTDOWN_STEP_FAILED, "transport", error instanceof Error ? error.message : String(error));
+        }
+        try {
+            await this.disposeAuthProvider();
+        }
+        catch (error) {
+            logger.warn(RuntimeLogMessages.SHUTDOWN_STEP_FAILED, "auth-provider", error instanceof Error ? error.message : String(error));
+        }
+        try {
+            if (this.options.telemetryEnabled) {
+                await shutdownTelemetry();
+                logger.debug(RuntimeLogMessages.TELEMETRY_SHUTDOWN);
+            }
+        }
+        catch (error) {
+            logger.warn(RuntimeLogMessages.SHUTDOWN_STEP_FAILED, "telemetry", error instanceof Error ? error.message : String(error));
+        }
+        try {
+            await Logger.closeStreams();
+        }
+        catch (error) {
+            logger.warn(RuntimeLogMessages.SHUTDOWN_STEP_FAILED, "logger", error instanceof Error ? error.message : String(error));
+        }
+        this.transitionState("stopped");
+        await this.invokeLifecycleHook("onStopped", () => this.options.lifecycle?.onStopped?.());
+        logger.info(RuntimeLogMessages.SERVER_STOPPED);
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Initialization Helpers
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Create the unified SessionManager.
+     *
+     * For stdio mode: single session, no cleanup/keepalive cycles.
+     * For HTTP modes: default config from environment/constants.
+     */
+    createSessionManager() {
+        const lifecycle = this.options.lifecycle;
+        const sessionLifecycle = lifecycle?.onClientConnected || lifecycle?.onClientDisconnected
+            ? {
+                onClientConnected: lifecycle.onClientConnected,
+                onClientDisconnected: lifecycle.onClientDisconnected,
+            }
+            : undefined;
+        // Stdio: single session, no background tasks.
+        // HTTP: merge programmatic session options with lifecycle hooks.
+        if (this.transportMode === "stdio") {
+            return new SessionManagerImpl({
+                cleanupIntervalMs: 0,
+                keepAliveIntervalMs: 0,
+                maxSessions: 1,
+                lifecycle: sessionLifecycle,
+            });
+        }
+        const sessionConfig = this.options.session;
+        return new SessionManagerImpl({
+            ...sessionConfig,
+            lifecycle: sessionLifecycle,
+        });
+    }
+    /**
+     * Bridges config file / env values into the logger configuration.
+     *
+     * The logger has its own `globalLoggerConfig` (default: info) which is
+     * intentionally decoupled from the framework config (DD-006). This method
+     * acts as the explicit bridge — reading resolved config values and
+     * forwarding them to `configureLogger()`.
+     */
+    applyLoggerConfig() {
+        const config = getFrameworkConfig();
+        configureLogger({
+            LOG_LEVEL: config.LOG_LEVEL,
+            LOG_FORMAT: config.LOG_FORMAT,
+            LOG_DIR: config.LOG_DIR,
+            LOG_MAX_FILE_SIZE: config.LOG_MAX_FILE_SIZE,
+            LOG_MAX_FILES: config.LOG_MAX_FILES,
+            LOG_RETENTION_DAYS: config.LOG_RETENTION_DAYS,
+            LOG_TIMESTAMP: config.LOG_TIMESTAMP,
+            LOG_COMPONENT: config.LOG_COMPONENT,
+            MCP_TRANSPORT: config.MCP_TRANSPORT,
+            SERVER_NAME: this.options.name,
+            SERVER_VERSION: this.options.version,
+        });
+    }
+    /**
+     * Bridges programmatic `createServer()` options into the framework
+     * config cache so that all downstream modules (telemetry, SSE router,
+     * rate limiter, health endpoint, etc.) see consistent configuration.
+     *
+     * Bridges:
+     * - `options.version` → `config.VERSION` (fixes `service_version="unknown"`)
+     * - `options.name` → `config.OTEL_SERVICE_NAME` (default, unless env/config file overrides)
+     * - Transport HTTP options → corresponding config keys
+     *
+     * Environment variables remain the default — programmatic options override them.
+     */
+    applyProgrammaticOverrides() {
+        const overrides = mapServerOptionsToOverrides(this.options, getFrameworkConfig());
+        if (Object.keys(overrides).length > 0) {
+            applyConfigOverrides(overrides);
+        }
+    }
+    /**
+     * Start the appropriate transport for the configured mode.
+     *
+     * For HTTP/HTTPS: dynamically loads Express modules (after OTEL init),
+     * creates Express app with full middleware stack, then starts the HTTP server.
+     * For stdio: creates a single session connected to stdin/stdout.
+     *
+     * @lazy-transport Express/HTTP modules are loaded via dynamic `import()` so
+     * that OTEL instrumentation initializes before Express is imported.
+     * See DD-006 for the established lazy-import pattern and DD-018 for
+     * the Express lazy-loading rationale.
+     */
+    async startTransport(sessionFactory, sessionManager) {
+        const transport = this.options.transport;
+        if (isHttpTransport(transport)) {
+            // @lazy-transport — Express loaded after OTEL init (see method JSDoc)
+            const [{ createExpressApp }, { startHttpTransport }, { resolveTrustProxy }] = await Promise.all([
+                import("./http/index.js"),
+                import("./http/http-transport.js"),
+                import("./middleware/trust-proxy.js"),
+            ]);
+            // Resolve trust proxy from config (merges env, config file, programmatic)
+            const resolvedConfig = getFrameworkConfig();
+            const trustProxy = await resolveTrustProxy(resolvedConfig.MCP_TRUST_PROXY);
+            const resolvedJsonResponse = resolvedConfig.MCP_JSON_RESPONSE;
+            const app = createExpressApp(sessionFactory, sessionManager, {
+                stateless: transport.stateless,
+                eventStore: transport.eventStore,
+                enableJsonResponse: resolvedJsonResponse,
+                health: this.options.health,
+                auth: this.options.auth,
+                trustProxy,
+                corsOrigin: resolvedConfig.MCP_CORS_ORIGIN,
+                corsCredentials: resolvedConfig.MCP_CORS_CREDENTIALS,
+                helmetHsts: resolvedConfig.MCP_HELMET_HSTS,
+                helmetCsp: resolvedConfig.MCP_HELMET_CSP,
+                helmetFrameOptions: resolvedConfig.MCP_HELMET_FRAME_OPTIONS,
+                bodyLimit: resolvedConfig.MCP_BODY_SIZE_LIMIT,
+            });
+            return startHttpTransport(app, { transport });
+        }
+        return startStdioTransport(sessionFactory, sessionManager);
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Signal Handling
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Register process signal handlers for graceful shutdown.
+     *
+     * Uses `process.once()` for each signal. Handler references are stored
+     * so they can be removed in `stop()` to prevent accumulation when the
+     * server is restarted within the same process.
+     */
+    setupSignalHandlers() {
+        // Clean up any leftover handlers from a previous start() cycle
+        this.removeSignalHandlers();
+        const shutdownConfig = {
+            ...DEFAULT_SHUTDOWN_CONFIG,
+            ...this.options.shutdown,
+        };
+        const signals = shutdownConfig.signals ?? DEFAULT_SIGNALS;
+        for (const signal of signals) {
+            const handler = () => {
+                logger.info(RuntimeLogMessages.SHUTDOWN_SIGNAL, signal);
+                void this.gracefulStop(shutdownConfig)
+                    .then(() => {
+                    process.exit(0);
+                })
+                    .catch((err) => {
+                    const reason = err instanceof Error ? err.message : String(err);
+                    logger.error(RuntimeLogMessages.SHUTDOWN_FAILED, reason);
+                    process.exit(1);
+                });
+            };
+            this.signalHandlers.push({ signal, handler });
+            process.once(signal, handler);
+        }
+        // Register process error handlers for unhandled rejections and exceptions.
+        // These ensure a graceful shutdown instead of a hard crash.
+        this.setupProcessErrorHandlers(shutdownConfig);
+    }
+    /**
+     * Register handlers for unhandled promise rejections and uncaught exceptions.
+     *
+     * Both trigger a graceful shutdown followed by `process.exit(1)`. A guard
+     * prevents concurrent shutdown attempts when multiple errors arrive or
+     * a signal arrives simultaneously.
+     */
+    setupProcessErrorHandlers(shutdownConfig) {
+        const shutdownOnError = (logMessage, error) => {
+            if (this.shutdownInProgress)
+                return;
+            this.shutdownInProgress = true;
+            const reason = error instanceof Error ? error.message : String(error);
+            logger.error(logMessage, reason);
+            void this.gracefulStop(shutdownConfig).finally(() => {
+                process.exit(1);
+            });
+        };
+        const rejectionHandler = (reason) => {
+            shutdownOnError(RuntimeLogMessages.UNHANDLED_REJECTION, reason);
+        };
+        const exceptionHandler = (error) => {
+            shutdownOnError(RuntimeLogMessages.UNCAUGHT_EXCEPTION, error);
+        };
+        process.on("unhandledRejection", rejectionHandler);
+        process.on("uncaughtException", exceptionHandler);
+        this.processErrorHandlers.push({ event: "unhandledRejection", handler: rejectionHandler }, { event: "uncaughtException", handler: exceptionHandler });
+    }
+    /**
+     * Remove previously registered signal handlers.
+     *
+     * Prevents handler accumulation when `start()` is called multiple times
+     * (e.g., after `stop()` → `start()` restart).
+     */
+    removeSignalHandlers() {
+        for (const { signal, handler } of this.signalHandlers) {
+            process.removeListener(signal, handler);
+        }
+        this.signalHandlers = [];
+        for (const { event, handler } of this.processErrorHandlers) {
+            process.removeListener(event, handler);
+        }
+        this.processErrorHandlers = [];
+        this.shutdownInProgress = false;
+    }
+    /**
+     * Perform graceful shutdown with optional timeout enforcement.
+     *
+     * If `forceExitOnTimeout` is enabled, forces `process.exit(1)` when
+     * the shutdown exceeds the configured timeout. The timeout is unref'd
+     * to avoid keeping the event loop alive if shutdown completes in time.
+     */
+    async gracefulStop(config) {
+        if (!config.forceExitOnTimeout) {
+            await this.stop();
+            return;
+        }
+        // Race stop() against a timeout. If stop() completes in time, the timeout
+        // is cleared. If the timeout fires first, force-exit with a short drain
+        // period for pending I/O (logger flush, OTEL export).
+        let timedOut = false;
+        const timeout = setTimeout(() => {
+            timedOut = true;
+            logger.error(RuntimeLogMessages.SHUTDOWN_FORCED);
+            // Give pending log writes a brief window to flush before hard exit.
+            // setImmediate ensures current I/O callbacks can complete.
+            setImmediate(() => process.exit(1));
+        }, config.timeoutMs).unref();
+        let stopError;
+        try {
+            await this.stop();
+        }
+        catch (error) {
+            stopError = error;
+        }
+        finally {
+            if (!timedOut) {
+                clearTimeout(timeout);
+            }
+        }
+        // Check timeout BEFORE re-throwing stop errors — if the timeout already
+        // scheduled setImmediate(exit(1)), the promise resolution (microtask)
+        // can race ahead and trigger .then(exit(0)) first. Throwing here
+        // ensures the caller's .catch(exit(1)) wins.
+        if (timedOut) {
+            throw new Error("Shutdown completed after timeout — forcing exit(1)");
+        }
+        if (stopError instanceof Error) {
+            throw stopError;
+        }
+        else if (stopError !== undefined) {
+            throw new Error(typeof stopError === "string" ? stopError : "Shutdown failed");
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Internal Helpers
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Transitions the server state and logs the change.
+     */
+    transitionState(newState) {
+        const previous = this.serverState;
+        this.serverState = newState;
+        logger.debug(RuntimeLogMessages.STATE_TRANSITION, previous, newState);
+    }
+    /**
+     * Invokes a lifecycle hook with error logging.
+     * Hook errors are logged as warnings but do not abort the lifecycle.
+     */
+    async invokeLifecycleHook(name, fn) {
+        try {
+            await fn();
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            logger.warn(RuntimeLogMessages.LIFECYCLE_HOOK_ERROR, name, msg);
+        }
+    }
+    /**
+     * Log the auth configuration at startup.
+     *
+     * Warns when auth is configured with stdio (unsupported)
+     * or when auth is used without trust proxy behind a reverse proxy.
+     */
+    logAuthConfiguration() {
+        const auth = this.options.auth;
+        if (!auth)
+            return;
+        if (this.transportMode === "stdio") {
+            logger.warn(RuntimeLogMessages.AUTH_STDIO_WARNING);
+            return;
+        }
+        if (isFullOAuthProvider(auth.provider)) {
+            logger.info(RuntimeLogMessages.AUTH_OAUTH_ENABLED, auth.issuerUrl?.toString() ?? "not set");
+        }
+        else {
+            logger.info(RuntimeLogMessages.AUTH_BEARER_ENABLED);
+        }
+        // Warn about missing trust proxy when auth is enabled
+        const config = getFrameworkConfig();
+        if (!config.MCP_TRUST_PROXY) {
+            logger.warn(RuntimeLogMessages.AUTH_NO_TRUST_PROXY);
+        }
+    }
+    /**
+     * Dispose the auth provider if it has a `dispose()` method.
+     */
+    async disposeAuthProvider() {
+        const provider = this.options.auth?.provider;
+        if (provider && "dispose" in provider && typeof provider.dispose === "function") {
+            // Support both sync and async dispose() implementations
+            await provider.dispose();
+            logger.debug(RuntimeLogMessages.AUTH_PROVIDER_DISPOSED);
+        }
+    }
+}
+//# sourceMappingURL=server-instance.js.map

package/build/server/server-instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-instance.js","sourceRoot":"","sources":["../../src/server/server-instance.ts"],"names":[],"mappings":"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"}