mcp-server-framework 1.0.0

package/build/errors/factory.js

@@ -0,0 +1,244 @@
+/**
+ * Framework Error Factory
+ *
+ * Centralized error creation for the MCP framework layer.
+ * Application-specific errors should extend these in app/errors/.
+ *
+ * @module errors/factory
+ */
+import { ZodError } from "zod";
+import { AppError } from "./core/index.js";
+import { McpProtocolError, SessionError, TransportError, ValidationError, ConfigurationError, InternalError, RegistryError, OperationError, OperationCancelledError, ConnectionError, AuthenticationError, AuthorizationError, } from "./categories/index.js";
+/**
+ * Framework Error Factory
+ *
+ * Provides static methods for creating framework-level errors.
+ * This factory is generic and can be extended by application code.
+ *
+ * @example
+ * ```typescript
+ * // MCP errors
+ * throw FrameworkErrorFactory.mcp.invalidRequest('Missing params');
+ * throw FrameworkErrorFactory.session.expired('sess-123');
+ *
+ * // Validation errors
+ * throw FrameworkErrorFactory.validation.fromZodError(zodError);
+ * throw FrameworkErrorFactory.validation.fieldRequired('name');
+ *
+ * // Operation errors
+ * throw FrameworkErrorFactory.operation.failed('deploy', 'timeout');
+ * ```
+ */
+export const FrameworkErrorFactory = {
+    // ─────────────────────────────────────────────────────────────────────────
+    // MCP Protocol Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    mcp: {
+        /** Create an invalid request error */
+        invalidRequest: (reason) => McpProtocolError.invalidRequest(reason),
+        /** Create a method not found error */
+        methodNotFound: (method) => McpProtocolError.methodNotFound(method),
+        /** Create an invalid params error */
+        invalidParams: (reason) => McpProtocolError.invalidParams(reason),
+        /** Create a parse error */
+        parseError: (reason) => McpProtocolError.parseError(reason),
+        /** Create a custom MCP error */
+        custom: (message, code) => new McpProtocolError(message, code),
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // Session Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    session: {
+        /** Create a session not found error */
+        notFound: (sessionId) => SessionError.sessionNotFound(sessionId),
+        /** Create a session expired error */
+        expired: (sessionId) => SessionError.sessionExpired(sessionId),
+        /** Create a session limit reached error */
+        limitReached: (maxSessions) => SessionError.sessionLimitReached(maxSessions),
+        /** Create an invalid session state error */
+        invalidState: (sessionId, currentState, expectedState) => SessionError.invalidState(sessionId, currentState, expectedState),
+        /** Create a custom session error */
+        custom: (message, sessionId) => new SessionError(message, { sessionId }),
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // Transport Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    transport: {
+        /** Create a connection failed error */
+        connectionFailed: (reason) => TransportError.connectionFailed(reason),
+        /** Create a connection closed error */
+        connectionClosed: (reason) => TransportError.connectionClosed(reason),
+        /** Create an invalid header error */
+        invalidHeader: (header, reason) => TransportError.invalidHeader(header, reason),
+        /** Create a protocol mismatch error */
+        protocolMismatch: (expected, received) => TransportError.protocolMismatch(expected, received),
+        /** Create a rate limited error */
+        rateLimited: (retryAfterSeconds) => TransportError.rateLimited(retryAfterSeconds),
+        /** Create a DNS rebinding error */
+        dnsRebinding: (host) => TransportError.dnsRebinding(host),
+        /** Create a port-in-use error */
+        portInUse: (bind) => TransportError.portInUse(bind),
+        /** Create a privileges-required error */
+        privilegesRequired: (bind) => TransportError.privilegesRequired(bind),
+        /** Create a custom transport error */
+        custom: (message, transportType) => new TransportError(message, { transportType }),
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // Validation Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    validation: {
+        /** Create from a Zod error */
+        fromZodError: (error, message) => ValidationError.fromZodError(error, message),
+        /** Create a field required error */
+        fieldRequired: (field) => ValidationError.fieldRequired(field),
+        /** Create a field invalid error */
+        fieldInvalid: (field, value) => ValidationError.fieldInvalid(field, value),
+        /** Create a type mismatch error */
+        fieldTypeMismatch: (field, expectedType) => ValidationError.fieldTypeMismatch(field, expectedType),
+        /** Create a min constraint error */
+        fieldMin: (field, min) => ValidationError.fieldMin(field, min),
+        /** Create a max constraint error */
+        fieldMax: (field, max) => ValidationError.fieldMax(field, max),
+        /** Create a pattern mismatch error */
+        fieldPattern: (field) => ValidationError.fieldPattern(field),
+        /** Create a custom validation error */
+        custom: (message, field) => new ValidationError(message, { field }),
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // Configuration Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    configuration: {
+        /** Create a missing env var error */
+        missingEnvVar: (varName) => ConfigurationError.missingEnvVar(varName),
+        /** Create an invalid env var error */
+        invalidEnvVar: (varName, reason) => ConfigurationError.invalidEnvVar(varName, reason),
+        /** Create an invalid configuration error */
+        invalid: (message) => ConfigurationError.invalid(message),
+        /** Config file not found (explicit MCP_CONFIG_FILE path) */
+        fileNotFound: (filePath) => ConfigurationError.fileNotFound(filePath),
+        /** Config file could not be read */
+        fileReadFailed: (filePath, cause) => ConfigurationError.fileReadFailed(filePath, cause),
+        /** Config file TOML/YAML parse failure */
+        fileParseFailed: (filePath, cause) => ConfigurationError.fileParseFailed(filePath, cause),
+        /** Config file schema validation failed (typos, wrong types) */
+        fileValidationFailed: (filePath, zodError) => ConfigurationError.fileValidationFailed(filePath, zodError),
+        /** Unsupported config file extension */
+        unsupportedFormat: (extension) => ConfigurationError.unsupportedFormat(extension),
+        /** Cross-field constraint violation */
+        constraintViolation: (message, fields) => ConfigurationError.constraintViolation(message, fields),
+        /** Create a custom configuration error */
+        custom: (message, configKey) => new ConfigurationError(message, { configKey }),
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // Operation Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    operation: {
+        /** Create a failed operation error */
+        failed: (operation, reason) => OperationError.failed(operation, reason),
+        /** Create a timeout error */
+        timeout: (operation, timeoutMs) => OperationError.timeout(operation, timeoutMs),
+        /** Create an unavailable error */
+        unavailable: (operation) => OperationError.unavailable(operation),
+        /** Create a custom operation error */
+        custom: (message, operation) => new OperationError(message, { operation }),
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // Cancellation Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    cancellation: {
+        /** Create from a cancelled request */
+        fromRequest: (requestId, reason) => OperationCancelledError.fromRequest(requestId, reason),
+        /** Create from an AbortSignal */
+        fromAbortSignal: (signal, requestId) => OperationCancelledError.fromAbortSignal(signal, requestId),
+        /** Create a custom cancellation error */
+        custom: (message, requestId) => new OperationCancelledError(message, requestId),
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // System Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    internal: {
+        /** Wrap an unknown error */
+        wrap: (error, context) => InternalError.wrap(error, context),
+        /** Create an unexpected state error */
+        unexpectedState: (description) => InternalError.unexpectedState(description),
+        /** Create a not implemented error */
+        notImplemented: (feature) => InternalError.notImplemented(feature),
+        /** Create a custom internal error */
+        custom: (message) => new InternalError(message),
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // Registry Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    registry: {
+        /** Tool not found */
+        toolNotFound: (name) => RegistryError.toolNotFound(name),
+        /** Duplicate tool */
+        duplicateTool: (name) => RegistryError.duplicateTool(name),
+        /** Resource not found */
+        resourceNotFound: (name) => RegistryError.resourceNotFound(name),
+        /** Duplicate resource */
+        duplicateResource: (name) => RegistryError.duplicateResource(name),
+        /** Prompt not found */
+        promptNotFound: (name) => RegistryError.promptNotFound(name),
+        /** Duplicate prompt */
+        duplicatePrompt: (name) => RegistryError.duplicatePrompt(name),
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // Connection Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    connection: {
+        /** Create a generic connection failed error */
+        failed: (target, reason) => ConnectionError.failed(target, reason),
+        /** Create a connection refused error */
+        refused: (target) => ConnectionError.refused(target),
+        /** Create a connection timeout error */
+        timeout: (target, timeoutMs) => ConnectionError.timeout(target, timeoutMs),
+        /** Create a connection lost error */
+        lost: (target) => ConnectionError.lost(target),
+        /** Create a connection reset error */
+        reset: (target) => ConnectionError.reset(target),
+        /** Create a health check failed error */
+        healthCheckFailed: (reason, target) => ConnectionError.healthCheckFailed(reason, target),
+        /** Create a custom connection error */
+        custom: (message, target) => new ConnectionError(message, target),
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // Auth Errors
+    // ─────────────────────────────────────────────────────────────────────────
+    auth: {
+        /** Token is invalid or malformed */
+        invalidToken: (reason) => AuthenticationError.invalidToken(reason),
+        /** Token has expired */
+        tokenExpired: () => AuthenticationError.tokenExpired(),
+        /** No token provided */
+        missingToken: () => AuthenticationError.missingToken(),
+        /** Token lacks required scopes */
+        insufficientScope: (required, actual) => AuthorizationError.insufficientScope(required, actual),
+        /** Generic forbidden */
+        forbidden: (reason) => AuthorizationError.forbidden(reason),
+        /** Custom authentication error */
+        unauthorized: (message) => new AuthenticationError(message),
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // Utility Methods
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Check if an error is an AppError (framework or app error)
+     */
+    isAppError: (error) => {
+        return error instanceof AppError;
+    },
+    /**
+     * Normalize any error to an AppError
+     */
+    normalize: (error, fallbackMessage) => {
+        if (error instanceof AppError) {
+            return error;
+        }
+        const message = error instanceof Error ? error.message : fallbackMessage || "An unexpected error occurred";
+        return new InternalError(message, {
+            cause: error instanceof Error ? error : undefined,
+        });
+    },
+};
+//# sourceMappingURL=factory.js.map

package/build/errors/factory.js.map

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

package/build/errors/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Framework Errors Module
+ *
+ * This module provides the error system for the MCP server framework.
+ * Application-specific errors should be created in app/errors/ by extending
+ * these base classes.
+ *
+ * @module errors
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   FrameworkErrorFactory,
+ *   AppError,
+ *   ValidationError,
+ *   ErrorCodes,
+ * } from './errors/index.js';
+ *
+ * // Using the factory
+ * throw FrameworkErrorFactory.validation.fieldRequired('name');
+ *
+ * // Using classes directly
+ * throw new ValidationError('Invalid input', { field: 'email' });
+ *
+ * // Checking error types
+ * if (FrameworkErrorFactory.isAppError(error)) {
+ *   console.log(error.code, error.statusCode);
+ * }
+ * ```
+ */
+export { ErrorCodes, ErrorCategory, type ErrorCodeType, type ErrorCategoryType, HttpStatus, ErrorCodeToHttpStatus, getHttpStatusForErrorCode, type HttpStatusType, JsonRpcErrorCode, isSpecDefinedJsonRpcError, isServerDefinedJsonRpcError, isValidJsonRpcErrorCode, createJsonRpcError, type JsonRpcErrorCodeType, type JsonRpcErrorResponse, VALIDATION_LIMITS, REDACTED_PLACEHOLDER, isSensitiveKey, redactIfSensitive, AppError, TransportErrorMessage, } from "./core/index.js";
+export type { SerializedError, BaseErrorOptions, ValidationErrorOptions, ValidationIssue, TransportErrorMessageKey, } from "./core/index.js";
+export { McpProtocolError, SessionError, TransportError, ValidationError, ConfigurationError, InternalError, RegistryError, OperationError, OperationCancelledError, ConnectionError, AuthenticationError, AuthorizationError, } from "./categories/index.js";
+export { FrameworkErrorFactory, type FrameworkErrorFactoryType } from "./factory.js";
+//# sourceMappingURL=index.d.ts.map

package/build/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAMH,OAAO,EAEL,UAAU,EACV,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,iBAAiB,EAEtB,UAAU,EACV,qBAAqB,EACrB,yBAAyB,EACzB,KAAK,cAAc,EAEnB,gBAAgB,EAChB,yBAAyB,EACzB,2BAA2B,EAC3B,uBAAuB,EACvB,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAEzB,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EAEjB,QAAQ,EAER,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAEV,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,EAEf,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EAEL,gBAAgB,EAChB,YAAY,EACZ,cAAc,EAEd,eAAe,EACf,kBAAkB,EAElB,aAAa,EACb,aAAa,EAEb,cAAc,EACd,uBAAuB,EAEvB,eAAe,EAEf,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EAAE,qBAAqB,EAAE,KAAK,yBAAyB,EAAE,MAAM,cAAc,CAAC"}

package/build/errors/index.js

@@ -0,0 +1,67 @@
+/**
+ * Framework Errors Module
+ *
+ * This module provides the error system for the MCP server framework.
+ * Application-specific errors should be created in app/errors/ by extending
+ * these base classes.
+ *
+ * @module errors
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   FrameworkErrorFactory,
+ *   AppError,
+ *   ValidationError,
+ *   ErrorCodes,
+ * } from './errors/index.js';
+ *
+ * // Using the factory
+ * throw FrameworkErrorFactory.validation.fieldRequired('name');
+ *
+ * // Using classes directly
+ * throw new ValidationError('Invalid input', { field: 'email' });
+ *
+ * // Checking error types
+ * if (FrameworkErrorFactory.isAppError(error)) {
+ *   console.log(error.code, error.statusCode);
+ * }
+ * ```
+ */
+// ─────────────────────────────────────────────────────────────────────────
+// Core
+// ─────────────────────────────────────────────────────────────────────────
+export { 
+// Error Codes & Categories
+ErrorCodes, ErrorCategory, 
+// HTTP
+HttpStatus, ErrorCodeToHttpStatus, getHttpStatusForErrorCode, 
+// JSON-RPC
+JsonRpcErrorCode, isSpecDefinedJsonRpcError, isServerDefinedJsonRpcError, isValidJsonRpcErrorCode, createJsonRpcError, 
+// Validation
+VALIDATION_LIMITS, REDACTED_PLACEHOLDER, isSensitiveKey, redactIfSensitive, 
+// Base Error
+AppError, 
+// Transport Error Messages
+TransportErrorMessage, } from "./core/index.js";
+// ─────────────────────────────────────────────────────────────────────────
+// Error Categories
+// ─────────────────────────────────────────────────────────────────────────
+export { 
+// MCP Protocol
+McpProtocolError, SessionError, TransportError, 
+// Validation
+ValidationError, ConfigurationError, 
+// System
+InternalError, RegistryError, 
+// Operation
+OperationError, OperationCancelledError, 
+// Connection
+ConnectionError, 
+// Auth
+AuthenticationError, AuthorizationError, } from "./categories/index.js";
+// ─────────────────────────────────────────────────────────────────────────
+// Factory
+// ─────────────────────────────────────────────────────────────────────────
+export { FrameworkErrorFactory } from "./factory.js";
+//# sourceMappingURL=index.js.map

package/build/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,4EAA4E;AAC5E,OAAO;AACP,4EAA4E;AAE5E,OAAO;AACL,2BAA2B;AAC3B,UAAU,EACV,aAAa;AAGb,OAAO;AACP,UAAU,EACV,qBAAqB,EACrB,yBAAyB;AAEzB,WAAW;AACX,gBAAgB,EAChB,yBAAyB,EACzB,2BAA2B,EAC3B,uBAAuB,EACvB,kBAAkB;AAGlB,aAAa;AACb,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,iBAAiB;AACjB,aAAa;AACb,QAAQ;AACR,2BAA2B;AAC3B,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAYzB,4EAA4E;AAC5E,mBAAmB;AACnB,4EAA4E;AAE5E,OAAO;AACL,eAAe;AACf,gBAAgB,EAChB,YAAY,EACZ,cAAc;AACd,aAAa;AACb,eAAe,EACf,kBAAkB;AAClB,SAAS;AACT,aAAa,EACb,aAAa;AACb,YAAY;AACZ,cAAc,EACd,uBAAuB;AACvB,aAAa;AACb,eAAe;AACf,OAAO;AACP,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,4EAA4E;AAC5E,UAAU;AACV,4EAA4E;AAE5E,OAAO,EAAE,qBAAqB,EAAkC,MAAM,cAAc,CAAC"}

package/build/index.d.ts

@@ -0,0 +1,93 @@
+/**
+ * MCP Server Framework
+ *
+ * A production-ready framework for building Model Context Protocol servers.
+ * Provides a clean, type-safe API for defining tools, resources, and prompts.
+ *
+ * @example Basic Server Setup
+ * ```typescript
+ * import { createServer, defineTool, text, z } from 'mcp-server-framework';
+ *
+ * const healthTool = defineTool({
+ *   name: 'health',
+ *   description: 'Check server health',
+ *   input: z.object({}),
+ *   handler: async () => text('OK'),
+ * });
+ *
+ * const { start } = createServer({
+ *   name: 'my-server',
+ *   version: '1.0.0',
+ *   transport: { mode: 'stdio' },
+ * });
+ *
+ * await start();
+ * ```
+ *
+ * ## Subpath Imports (Advanced)
+ *
+ * Internal modules are available via subpath imports for advanced use cases:
+ * ```typescript
+ * import { ConnectionStateManager } from 'mcp-server-framework/connection';
+ * import { SessionManagerImpl } from 'mcp-server-framework/session';
+ * import { startHttpTransport, createExpressApp } from 'mcp-server-framework/http';
+ * import { getActiveSpan, SpanKind } from 'mcp-server-framework/telemetry';
+ * import { FrameworkErrorFactory } from 'mcp-server-framework/errors';
+ * import { Logger } from 'mcp-server-framework/logger';
+ * import { getFrameworkConfig } from 'mcp-server-framework/config';
+ * ```
+ *
+ * @packageDocumentation
+ * @module mcp-server-framework
+ */
+export { createServer } from "./server/index.js";
+export { McpServerBuilder } from "./server/index.js";
+export { defineTool } from "./mcp/capabilities/tools/index.js";
+export { defineResource, defineResourceTemplate } from "./mcp/capabilities/resources/index.js";
+export { definePrompt } from "./mcp/capabilities/prompts/index.js";
+export { defineApp } from "./mcp/capabilities/apps/index.js";
+export { defineTask } from "./mcp/capabilities/tasks/index.js";
+export { z } from "zod";
+export { text, json, error, image, audio, multi } from "./mcp/responses/index.js";
+export { isHttpTransport } from "./server/index.js";
+export { isStaticResource, isResourceTemplate } from "./mcp/types/index.js";
+export { isServiceClient } from "./connection/index.js";
+export { isFullOAuthProvider } from "./server/auth/index.js";
+export { createUpstreamOAuthProvider } from "./server/auth/index.js";
+export { createOidcProvider } from "./server/auth/index.js";
+export { fetchOidcDiscovery, getOidcDiscovery, clearOidcDiscoveryCache } from "./server/auth/index.js";
+export { ProxyOAuthServerProvider } from "@modelcontextprotocol/sdk/server/auth/providers/proxyProvider.js";
+export type { ProxyOptions, ProxyEndpoints } from "@modelcontextprotocol/sdk/server/auth/providers/proxyProvider.js";
+export { requireAuth, requireScope, requireScopes, hasScope, hasAllScopes, hasAnyScope } from "./server/auth/index.js";
+export { createBearerAuth, createCustomHeaderAuth } from "./server/middleware/index.js";
+export type { BearerAuthOptions, CustomHeaderAuthOptions } from "./server/middleware/index.js";
+export type { AuthInfo, OAuthServerProvider, TokenVerifier, AuthProvider, AuthenticatedExtra, AuthOptions, UpstreamOAuthOptions, UpstreamOAuthProviderResult, UpstreamEndpoints, OidcProviderOptions, OidcDiscoveryDocument, } from "./server/auth/index.js";
+export type { CreateServerOptions, CreateServerResult, ServerBuilder } from "./server/index.js";
+export type { TransportMode, BaseHttpTransportOptions, StdioTransportOptions, HttpTransportOptions, HttpsTransportOptions, TlsConfig, TransportOptions, ServerCapabilities, HealthConfig, SessionConfigOptions, ServerOptions, ServerInstance, ServerState, ServerLifecycleHooks, ShutdownConfig, } from "./server/index.js";
+export type { CompletionResult, CompletionCallback, ToolAnnotations, ToolDefinition, ToolProvider, BaseResourceDefinition, ResourceStaticDefinition, ResourceTemplateDefinition, ResourceDefinition, TextResourceContent, BlobResourceContent, ResourceContent, ResourceProvider, PromptRole, PromptMessage, PromptDefinition, PromptProvider, AppResourceDefinition, AppDefinition, TaskSupport, TaskToolHandler, TaskToolDefinition, TaskToolProvider, } from "./mcp/types/index.js";
+export type { ToolContext, TaskCreateContext, TaskOperationContext, ProgressData, ProgressReporter, PingHandler, HandlersConfig, } from "./mcp/types/index.js";
+export type { ToolResponse, ContentAudience, ContentAnnotations, ResponseOptions, TextResponseOptions, JsonResponseOptions, ErrorResponseOptions, ImageMimeType, ImageResponseOptions, AudioMimeType, AudioResponseOptions, } from "./mcp/types/index.js";
+export type { ServiceClient, ServiceClientFactory, HealthCheckResult, HealthStatus } from "./connection/index.js";
+export { ConnectionStateManager } from "./connection/index.js";
+export type { EventStore, EventId, StreamId } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+export type { CreateMessageRequest, CreateMessageResult, CreateMessageRequestParams, CreateMessageRequestParamsBase, SamplingMessage, Root, ListRootsResult, ElicitRequestFormParams, ElicitRequestURLParams, ElicitResult, } from "@modelcontextprotocol/sdk/types.js";
+export { ToolRegistry, ResourceRegistry, PromptRegistry, TaskToolRegistry, globalToolRegistry, globalResourceRegistry, globalPromptRegistry, globalTaskToolRegistry, } from "./mcp/capabilities/registry/index.js";
+/**
+ * `resetAllRegistries` is re-exported from the registry module.
+ * Import it directly from the main package:
+ * ```typescript
+ * import { resetAllRegistries } from 'mcp-server-framework';
+ * ```
+ */
+export { resetAllRegistries } from "./mcp/capabilities/registry/index.js";
+export type { RegistryItem } from "./mcp/capabilities/registry/index.js";
+export { Logger, logger, configureLogger, getLoggerConfig } from "./logger/index.js";
+export type { LogLevel, LoggerInterface, LoggerConfig } from "./logger/index.js";
+export { AppError, McpProtocolError, SessionError, TransportError, ValidationError, ConfigurationError, InternalError, RegistryError, OperationError, OperationCancelledError, ConnectionError, AuthenticationError, AuthorizationError, FrameworkErrorFactory, } from "./errors/index.js";
+export type { ErrorCodeType, BaseErrorOptions, ValidationErrorOptions, ValidationIssue, SerializedError, FrameworkErrorFactoryType, } from "./errors/index.js";
+export { getFrameworkConfig, getConfigSource, CONFIG_FILE_ENV_VAR, DISCOVERY_FILENAMES, registerConfigSection, getAppConfig, frameworkEnvSchema, validateConfigConstraints, booleanFromEnv, commaSeparatedList, optionalCommaSeparatedList, } from "./config/index.js";
+export type { ConfigSource, ConfigFileFormat, FrameworkEnvConfig, ConfigConstraintViolation } from "./config/index.js";
+export { initializeTelemetry, shutdownTelemetry, isTelemetryEnabled, getTracer, withSpan, withSpanSync, MCP_ATTRIBUTES, } from "./telemetry/index.js";
+export type { TelemetryConfig, SpanOptions, ServerMetrics, ServerStats } from "./telemetry/index.js";
+export { parseEnvBoolean, getEnvString, getEnvOptional } from "./utils/index.js";
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

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

package/build/index.js

@@ -0,0 +1,107 @@
+/**
+ * MCP Server Framework
+ *
+ * A production-ready framework for building Model Context Protocol servers.
+ * Provides a clean, type-safe API for defining tools, resources, and prompts.
+ *
+ * @example Basic Server Setup
+ * ```typescript
+ * import { createServer, defineTool, text, z } from 'mcp-server-framework';
+ *
+ * const healthTool = defineTool({
+ *   name: 'health',
+ *   description: 'Check server health',
+ *   input: z.object({}),
+ *   handler: async () => text('OK'),
+ * });
+ *
+ * const { start } = createServer({
+ *   name: 'my-server',
+ *   version: '1.0.0',
+ *   transport: { mode: 'stdio' },
+ * });
+ *
+ * await start();
+ * ```
+ *
+ * ## Subpath Imports (Advanced)
+ *
+ * Internal modules are available via subpath imports for advanced use cases:
+ * ```typescript
+ * import { ConnectionStateManager } from 'mcp-server-framework/connection';
+ * import { SessionManagerImpl } from 'mcp-server-framework/session';
+ * import { startHttpTransport, createExpressApp } from 'mcp-server-framework/http';
+ * import { getActiveSpan, SpanKind } from 'mcp-server-framework/telemetry';
+ * import { FrameworkErrorFactory } from 'mcp-server-framework/errors';
+ * import { Logger } from 'mcp-server-framework/logger';
+ * import { getFrameworkConfig } from 'mcp-server-framework/config';
+ * ```
+ *
+ * @packageDocumentation
+ * @module mcp-server-framework
+ */
+// ═══════════════════════════════════════════════════════════════════════════════
+// PRIMARY API
+// ═══════════════════════════════════════════════════════════════════════════════
+// Server creation
+export { createServer } from "./server/index.js";
+export { McpServerBuilder } from "./server/index.js";
+// Definition helpers (auto-register in global registries)
+export { defineTool } from "./mcp/capabilities/tools/index.js";
+export { defineResource, defineResourceTemplate } from "./mcp/capabilities/resources/index.js";
+export { definePrompt } from "./mcp/capabilities/prompts/index.js";
+export { defineApp } from "./mcp/capabilities/apps/index.js";
+export { defineTask } from "./mcp/capabilities/tasks/index.js";
+// Schema validation (Zod re-export — see DD-011)
+export { z } from "zod";
+// Response helpers
+export { text, json, error, image, audio, multi } from "./mcp/responses/index.js";
+// Type guards
+export { isHttpTransport } from "./server/index.js";
+export { isStaticResource, isResourceTemplate } from "./mcp/types/index.js";
+export { isServiceClient } from "./connection/index.js";
+export { isFullOAuthProvider } from "./server/auth/index.js";
+// Auth provider factories
+export { createUpstreamOAuthProvider } from "./server/auth/index.js";
+export { createOidcProvider } from "./server/auth/index.js";
+export { fetchOidcDiscovery, getOidcDiscovery, clearOidcDiscoveryCache } from "./server/auth/index.js";
+// Auth providers (re-export SDK types for consumer convenience)
+export { ProxyOAuthServerProvider } from "@modelcontextprotocol/sdk/server/auth/providers/proxyProvider.js";
+// Auth guards
+export { requireAuth, requireScope, requireScopes, hasScope, hasAllScopes, hasAnyScope } from "./server/auth/index.js";
+// Auth middleware
+export { createBearerAuth, createCustomHeaderAuth } from "./server/middleware/index.js";
+export { ConnectionStateManager } from "./connection/index.js";
+// ═══════════════════════════════════════════════════════════════════════════════
+// REGISTRIES
+// ═══════════════════════════════════════════════════════════════════════════════
+export { ToolRegistry, ResourceRegistry, PromptRegistry, TaskToolRegistry, globalToolRegistry, globalResourceRegistry, globalPromptRegistry, globalTaskToolRegistry, } from "./mcp/capabilities/registry/index.js";
+/**
+ * `resetAllRegistries` is re-exported from the registry module.
+ * Import it directly from the main package:
+ * ```typescript
+ * import { resetAllRegistries } from 'mcp-server-framework';
+ * ```
+ */
+export { resetAllRegistries } from "./mcp/capabilities/registry/index.js";
+// ═══════════════════════════════════════════════════════════════════════════════
+// INFRASTRUCTURE — Logger
+// ═══════════════════════════════════════════════════════════════════════════════
+export { Logger, logger, configureLogger, getLoggerConfig } from "./logger/index.js";
+// ═══════════════════════════════════════════════════════════════════════════════
+// INFRASTRUCTURE — Errors
+// ═══════════════════════════════════════════════════════════════════════════════
+export { AppError, McpProtocolError, SessionError, TransportError, ValidationError, ConfigurationError, InternalError, RegistryError, OperationError, OperationCancelledError, ConnectionError, AuthenticationError, AuthorizationError, FrameworkErrorFactory, } from "./errors/index.js";
+// ═══════════════════════════════════════════════════════════════════════════════
+// INFRASTRUCTURE — Config
+// ═══════════════════════════════════════════════════════════════════════════════
+export { getFrameworkConfig, getConfigSource, CONFIG_FILE_ENV_VAR, DISCOVERY_FILENAMES, registerConfigSection, getAppConfig, frameworkEnvSchema, validateConfigConstraints, booleanFromEnv, commaSeparatedList, optionalCommaSeparatedList, } from "./config/index.js";
+// ═══════════════════════════════════════════════════════════════════════════════
+// INFRASTRUCTURE — Telemetry
+// ═══════════════════════════════════════════════════════════════════════════════
+export { initializeTelemetry, shutdownTelemetry, isTelemetryEnabled, getTracer, withSpan, withSpanSync, MCP_ATTRIBUTES, } from "./telemetry/index.js";
+// ═══════════════════════════════════════════════════════════════════════════════
+// UTILITIES
+// ═══════════════════════════════════════════════════════════════════════════════
+export { parseEnvBoolean, getEnvString, getEnvOptional } from "./utils/index.js";
+//# sourceMappingURL=index.js.map

package/build/index.js.map

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