IBM i MCP Server

/** * @fileoverview Factory for creating an authentication strategy based on configuration. * This module centralizes the logic for selecting and instantiating the correct * authentication strategy, promoting loose coupling and easy extensibility. * @module src/mcp-server/transports/auth/authFactory */ import { config } from "@/config/index.js"; import { logger, requestContextService } from "@/utils/index.js"; import { AuthStrategy } from "./strategies/authStrategy.js"; import { IBMiTokenStrategy } from "./strategies/ibmiTokenStrategy.js"; import { JwtStrategy } from "./strategies/jwtStrategy.js"; import { OauthStrategy } from "./strategies/oauthStrategy.js"; /** * Creates and returns an authentication strategy instance based on the * application's configuration (`config.mcpAuthMode`). * * @returns An instance of a class that implements the `AuthStrategy` interface, * or `null` if authentication is disabled (`none`). * @throws {Error} If the auth mode is unknown or misconfigured. */ export function createAuthStrategy(): AuthStrategy | null { const context = requestContextService.createRequestContext({ operation: "createAuthStrategy", authMode: config.mcpAuthMode, }); logger.info(context, "Creating authentication strategy..."); switch (config.mcpAuthMode) { case "jwt": logger.debug(context, "Instantiating JWT authentication strategy."); return new JwtStrategy(); case "oauth": logger.debug(context, "Instantiating OAuth authentication strategy."); return new OauthStrategy(); case "ibmi": logger.debug( context, "Instantiating IBM i token authentication strategy.", ); return new IBMiTokenStrategy(); case "none": logger.info(context, "Authentication is disabled ('none' mode)."); return null; // No authentication default: // This ensures that if a new auth mode is added to the config type // but not to this factory, we get a compile-time or runtime error. logger.error( context, `Unknown authentication mode: ${config.mcpAuthMode}`, ); throw new Error(`Unknown authentication mode: ${config.mcpAuthMode}`); } }