@skillsmith/mcp-server 0.1.0

package/dist/src/middleware/errorFormatter.js

@@ -0,0 +1,294 @@
+/**
+ * SMI-1061: MCP Error Formatter for License Errors
+ *
+ * Formats license errors into MCP protocol-compliant error responses
+ * with actionable information for clients.
+ */
+// ============================================================================
+// Error Formatting
+// ============================================================================
+/**
+ * Format a license error into an MCP-compliant error response
+ *
+ * @param error - The license error to format
+ * @returns MCP-formatted error response
+ *
+ * @example
+ * ```typescript
+ * import { formatLicenseError } from './middleware/errorFormatter.js';
+ *
+ * try {
+ *   await checkFeature('audit_logging');
+ * } catch (error) {
+ *   if (isLicenseError(error)) {
+ *     return formatLicenseError(error);
+ *   }
+ *   throw error;
+ * }
+ * ```
+ */
+export function formatLicenseError(error) {
+    const errorDetails = {
+        code: error.code || 'LICENSE_ERROR',
+        message: error.message,
+        feature: error.feature,
+        currentTier: error.currentTier,
+        requiredTier: error.requiredTier,
+        upgradeUrl: error.upgradeUrl || 'https://skillsmith.io/upgrade',
+        timestamp: error.timestamp?.toISOString(),
+    };
+    // Build the error response structure matching MCP protocol
+    const errorBody = {
+        error: {
+            code: errorDetails.code,
+            message: errorDetails.message,
+            details: {},
+        },
+    };
+    // Add details if present
+    const details = errorBody.error;
+    if (errorDetails.feature) {
+        details.details.feature = errorDetails.feature;
+    }
+    if (errorDetails.currentTier) {
+        details.details.currentTier = errorDetails.currentTier;
+    }
+    if (errorDetails.requiredTier) {
+        details.details.requiredTier = errorDetails.requiredTier;
+    }
+    if (errorDetails.upgradeUrl) {
+        details.details.upgradeUrl = errorDetails.upgradeUrl;
+    }
+    // Remove empty details object
+    if (Object.keys(details.details).length === 0) {
+        delete errorBody.error.details;
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(errorBody, null, 2),
+            },
+        ],
+        isError: true,
+        _meta: {
+            upgradeUrl: errorDetails.upgradeUrl,
+            errorCode: errorDetails.code,
+            recoverable: isRecoverableError(errorDetails.code),
+        },
+    };
+}
+/**
+ * Check if an error code represents a recoverable error
+ */
+function isRecoverableError(code) {
+    // License not found and invalid are potentially recoverable
+    // (by setting the license key or refreshing)
+    const recoverableCodes = ['E002', 'E003', 'LICENSE_INVALID', 'LICENSE_NOT_FOUND'];
+    return recoverableCodes.includes(code);
+}
+/**
+ * Format a generic error for MCP response
+ *
+ * Use this for non-license errors that still need MCP formatting.
+ */
+export function formatGenericError(error, code = 'INTERNAL_ERROR') {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    error: {
+                        code,
+                        message: error.message,
+                    },
+                }, null, 2),
+            },
+        ],
+        isError: true,
+    };
+}
+// ============================================================================
+// Error Code Mapping
+// ============================================================================
+/**
+ * Map internal license error codes to user-friendly messages
+ */
+const ERROR_MESSAGES = {
+    E001: 'Your license has expired. Please renew to continue using premium features.',
+    E002: 'Your license key is invalid. Please verify the key format or contact support.',
+    E003: 'No license key found. Set SKILLSMITH_LICENSE_KEY environment variable.',
+    E004: 'This feature is not available in your current license tier.',
+    E005: 'You have exceeded your license quota. Please upgrade or reduce usage.',
+    LICENSE_EXPIRED: 'Your license has expired. Please renew to continue using premium features.',
+    LICENSE_INVALID: 'Your license key is invalid. Please verify the key format or contact support.',
+    LICENSE_NOT_FOUND: 'No license key found. Set SKILLSMITH_LICENSE_KEY environment variable.',
+    FEATURE_NOT_AVAILABLE: 'This feature is not available in your current license tier.',
+    QUOTA_EXCEEDED: 'You have exceeded your license quota. Please upgrade or reduce usage.',
+};
+/**
+ * Get a user-friendly message for an error code
+ */
+export function getUserFriendlyMessage(code) {
+    return ERROR_MESSAGES[code] || 'An error occurred with your license. Please contact support.';
+}
+const DEFAULT_UPGRADE_URL_CONFIG = {
+    baseUrl: 'https://skillsmith.io/upgrade',
+    includeFeature: true,
+    includeTiers: true,
+    includeSource: true,
+};
+/**
+ * Generate a customized upgrade URL with tracking parameters
+ */
+export function generateUpgradeUrl(error, config = {}) {
+    const fullConfig = { ...DEFAULT_UPGRADE_URL_CONFIG, ...config };
+    const params = new URLSearchParams();
+    if (fullConfig.includeFeature && error.feature) {
+        params.set('feature', error.feature);
+    }
+    if (fullConfig.includeTiers) {
+        if (error.currentTier) {
+            params.set('from', error.currentTier);
+        }
+        if (error.requiredTier) {
+            params.set('to', error.requiredTier);
+        }
+    }
+    if (fullConfig.includeSource) {
+        params.set('source', 'mcp-error');
+        if (error.code) {
+            params.set('error_code', error.code);
+        }
+    }
+    const queryString = params.toString();
+    return queryString ? `${fullConfig.baseUrl}?${queryString}` : fullConfig.baseUrl || '';
+}
+// ============================================================================
+// Response Builders
+// ============================================================================
+/**
+ * Build an upgrade required response
+ *
+ * Use this when a feature requires an upgrade but isn't a full error.
+ */
+export function buildUpgradeRequiredResponse(feature, currentTier, requiredTier) {
+    const upgradeUrl = `https://skillsmith.io/upgrade?feature=${feature}&from=${currentTier}&to=${requiredTier}`;
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    error: {
+                        code: 'E004',
+                        message: `${feature} requires ${requiredTier} tier`,
+                        details: {
+                            feature,
+                            currentTier,
+                            requiredTier,
+                            upgradeUrl,
+                        },
+                    },
+                }, null, 2),
+            },
+        ],
+        isError: true,
+        _meta: {
+            upgradeUrl,
+            errorCode: 'E004',
+            recoverable: false,
+        },
+    };
+}
+/**
+ * Build a license expired response with renewal URL
+ */
+export function buildLicenseExpiredResponse(expiredAt) {
+    const renewUrl = 'https://skillsmith.io/renew';
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    error: {
+                        code: 'E001',
+                        message: 'Your license has expired',
+                        details: {
+                            expiredAt: expiredAt?.toISOString(),
+                            renewUrl,
+                        },
+                    },
+                }, null, 2),
+            },
+        ],
+        isError: true,
+        _meta: {
+            upgradeUrl: renewUrl,
+            errorCode: 'E001',
+            recoverable: false,
+        },
+    };
+}
+/**
+ * Build a quota exceeded response
+ */
+export function buildQuotaExceededResponse(quotaType, current, max) {
+    const upgradeUrl = `https://skillsmith.io/upgrade?quota=${quotaType}`;
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    error: {
+                        code: 'E005',
+                        message: `${quotaType} quota exceeded`,
+                        details: {
+                            quotaType,
+                            current,
+                            max,
+                            upgradeUrl,
+                        },
+                    },
+                }, null, 2),
+            },
+        ],
+        isError: true,
+        _meta: {
+            upgradeUrl,
+            errorCode: 'E005',
+            recoverable: false,
+        },
+    };
+}
+// ============================================================================
+// Validation Helpers
+// ============================================================================
+/**
+ * Check if an object looks like a license error
+ */
+export function isLicenseErrorLike(error) {
+    if (!error || typeof error !== 'object') {
+        return false;
+    }
+    const e = error;
+    // Must have a message
+    if (typeof e.message !== 'string') {
+        return false;
+    }
+    // Should have license-specific properties
+    const hasLicenseProps = 'code' in e || 'feature' in e || 'currentTier' in e || 'requiredTier' in e || 'upgradeUrl' in e;
+    return hasLicenseProps;
+}
+/**
+ * Safely convert any error to MCP format
+ */
+export function safeFormatError(error) {
+    if (isLicenseErrorLike(error)) {
+        return formatLicenseError(error);
+    }
+    if (error instanceof Error) {
+        return formatGenericError(error);
+    }
+    return formatGenericError(new Error(String(error)));
+}
+//# sourceMappingURL=errorFormatter.js.map

package/dist/src/middleware/errorFormatter.js.map

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

package/dist/src/middleware/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * MCP Server Middleware
+ *
+ * Exports all middleware for the Skillsmith MCP server.
+ */
+export { cspMiddleware, buildCspHeader, generateNonce, validateCspHeader, validateCspHeaderDetailed, getCspForEnvironment, DEFAULT_CSP_DIRECTIVES, STRICT_CSP_DIRECTIVES, type CspDirectives, type CspValidationResult, } from './csp.js';
+export { createLicenseMiddleware, requireFeature, isEnterpriseFeature, requiresLicense, getRequiredFeature, createLicenseErrorResponse, type LicenseMiddleware, type LicenseMiddlewareContext, type LicenseValidationResult, type LicenseInfo, type FeatureFlag, TOOL_FEATURES, FEATURE_DISPLAY_NAMES, FEATURE_TIERS, } from './license.js';
+export { createDegradationMiddleware, getTierComparisonMessage, consoleDegradationLogger, type DegradationMiddleware, type DegradationMiddlewareOptions, type DegradationLogger, type DegradationLogEvent, type McpToolRequest, type McpToolResponse, type ToolHandler, } from './degradation.js';
+export { formatLicenseError, formatGenericError, getUserFriendlyMessage, generateUpgradeUrl, buildUpgradeRequiredResponse, buildLicenseExpiredResponse, buildQuotaExceededResponse, isLicenseErrorLike, safeFormatError, type MCPErrorContent, type MCPErrorResponse, type LicenseErrorDetails as MCPLicenseErrorDetails, type LicenseErrorLike, type UpgradeUrlConfig, } from './errorFormatter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/middleware/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/middleware/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,aAAa,EACb,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,mBAAmB,GACzB,MAAM,UAAU,CAAA;AAGjB,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,0BAA0B,EAC1B,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,aAAa,EACb,qBAAqB,EACrB,aAAa,GACd,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,EAC1B,kBAAkB,EAClB,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,IAAI,sBAAsB,EAClD,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAA"}

package/dist/src/middleware/index.js

@@ -0,0 +1,14 @@
+/**
+ * MCP Server Middleware
+ *
+ * Exports all middleware for the Skillsmith MCP server.
+ */
+// CSP middleware
+export { cspMiddleware, buildCspHeader, generateNonce, validateCspHeader, validateCspHeaderDetailed, getCspForEnvironment, DEFAULT_CSP_DIRECTIVES, STRICT_CSP_DIRECTIVES, } from './csp.js';
+// License middleware
+export { createLicenseMiddleware, requireFeature, isEnterpriseFeature, requiresLicense, getRequiredFeature, createLicenseErrorResponse, TOOL_FEATURES, FEATURE_DISPLAY_NAMES, FEATURE_TIERS, } from './license.js';
+// Degradation middleware (SMI-1060)
+export { createDegradationMiddleware, getTierComparisonMessage, consoleDegradationLogger, } from './degradation.js';
+// MCP Error Formatter (SMI-1061)
+export { formatLicenseError, formatGenericError, getUserFriendlyMessage, generateUpgradeUrl, buildUpgradeRequiredResponse, buildLicenseExpiredResponse, buildQuotaExceededResponse, isLicenseErrorLike, safeFormatError, } from './errorFormatter.js';
+//# sourceMappingURL=index.js.map

package/dist/src/middleware/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/middleware/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,iBAAiB;AACjB,OAAO,EACL,aAAa,EACb,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,GAGtB,MAAM,UAAU,CAAA;AAEjB,qBAAqB;AACrB,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,0BAA0B,EAM1B,aAAa,EACb,qBAAqB,EACrB,aAAa,GACd,MAAM,cAAc,CAAA;AAErB,oCAAoC;AACpC,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,GAQzB,MAAM,kBAAkB,CAAA;AAEzB,iCAAiC;AACjC,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,EAC1B,kBAAkB,EAClB,eAAe,GAMhB,MAAM,qBAAqB,CAAA"}

package/dist/src/middleware/license.d.ts

@@ -0,0 +1,161 @@
+/**
+ * License validation middleware for MCP server
+ *
+ * Validates that the user has the required license features for enterprise tools.
+ * Gracefully degrades if @skillsmith/enterprise is not installed.
+ *
+ * @see SMI-1055: Add license middleware to MCP server
+ */
+import { type FeatureFlag } from './toolFeatureMapping.js';
+/**
+ * License validation result
+ */
+export interface LicenseValidationResult {
+    valid: boolean;
+    feature?: FeatureFlag;
+    message?: string;
+    upgradeUrl?: string;
+    warning?: string;
+}
+/**
+ * License information interface (mirrors @skillsmith/enterprise LicenseInfo)
+ */
+export interface LicenseInfo {
+    valid: boolean;
+    tier: 'community' | 'team' | 'enterprise';
+    features: FeatureFlag[];
+    expiresAt?: Date;
+    organizationId?: string;
+}
+/**
+ * License from enterprise package validation
+ */
+interface EnterpriseLicense {
+    tier: 'community' | 'team' | 'enterprise';
+    features: FeatureFlag[];
+    customerId: string;
+    issuedAt: Date;
+    expiresAt: Date;
+}
+/**
+ * Validation result from enterprise package
+ */
+interface EnterpriseValidationResult {
+    valid: boolean;
+    license?: EnterpriseLicense;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+/**
+ * License validator instance type from enterprise package
+ * Uses duck typing to avoid interface drift with the actual implementation
+ */
+type EnterpriseValidator = {
+    validate(licenseKey: string): Promise<EnterpriseValidationResult>;
+};
+/**
+ * Check if a tool name corresponds to an enterprise feature
+ *
+ * @param toolName - The name of the MCP tool
+ * @returns true if the tool requires an enterprise license
+ */
+export declare function isEnterpriseFeature(toolName: string): boolean;
+/**
+ * Check if a tool name requires any license (team or enterprise)
+ *
+ * @param toolName - The name of the MCP tool
+ * @returns true if the tool requires any license
+ */
+export declare function requiresLicense(toolName: string): boolean;
+/**
+ * Get the required feature for a tool
+ *
+ * @param toolName - The name of the MCP tool
+ * @returns The feature flag required, or null if community tool
+ */
+export declare function getRequiredFeature(toolName: string): FeatureFlag | null;
+/**
+ * License middleware context
+ */
+export interface LicenseMiddlewareContext {
+    validator: EnterpriseValidator | null;
+    licenseKey: string | undefined;
+    cachedLicense: LicenseInfo | null;
+    cacheExpiry: number;
+}
+/**
+ * License middleware instance
+ */
+export interface LicenseMiddleware {
+    /**
+     * Check if a specific feature is available
+     */
+    checkFeature(feature: FeatureFlag): Promise<LicenseValidationResult>;
+    /**
+     * Check if a tool can be executed
+     */
+    checkTool(toolName: string): Promise<LicenseValidationResult>;
+    /**
+     * Get the current license info
+     */
+    getLicenseInfo(): Promise<LicenseInfo | null>;
+    /**
+     * Invalidate the cached license
+     */
+    invalidateCache(): void;
+}
+/**
+ * Create a license middleware factory
+ *
+ * This middleware reads the license key from environment variables and
+ * validates tool access based on the license features.
+ *
+ * @param options - Optional configuration
+ * @returns License middleware instance
+ */
+export declare function createLicenseMiddleware(options?: {
+    licenseKeyEnvVar?: string;
+    cacheTtlMs?: number;
+}): LicenseMiddleware;
+/**
+ * Higher-order function to create feature requirement middleware
+ *
+ * Use this to wrap tool handlers that require specific features.
+ *
+ * @param feature - The feature flag required
+ * @returns Middleware function that checks the feature
+ *
+ * @example
+ * ```typescript
+ * const middleware = createLicenseMiddleware();
+ * const requireAudit = requireFeature('audit_logging');
+ *
+ * // In tool handler:
+ * const validation = await requireAudit(middleware);
+ * if (!validation.valid) {
+ *   return { error: validation.message, upgradeUrl: validation.upgradeUrl };
+ * }
+ * ```
+ */
+export declare function requireFeature(feature: FeatureFlag): (middleware: LicenseMiddleware) => Promise<LicenseValidationResult>;
+/**
+ * Create an error response for license validation failures
+ *
+ * @param result - The license validation result
+ * @returns MCP-formatted error response
+ */
+export declare function createLicenseErrorResponse(result: LicenseValidationResult): {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError: true;
+    _meta?: {
+        upgradeUrl: string;
+    };
+};
+export type { FeatureFlag } from './toolFeatureMapping.js';
+export { TOOL_FEATURES, FEATURE_DISPLAY_NAMES, FEATURE_TIERS } from './toolFeatureMapping.js';
+//# sourceMappingURL=license.d.ts.map

package/dist/src/middleware/license.d.ts.map

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