@skillsmith/mcp-server 0.2.3 → 0.3.1

package/dist/src/middleware/errorFormatter.js

@@ -1,294 +0,0 @@
-/**
- * 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.app/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.app/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.app/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.app/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.app/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

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

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

@@ -1,11 +0,0 @@
-/**
- * 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 LicenseTier, type FeatureFlag, TOOL_FEATURES, FEATURE_DISPLAY_NAMES, FEATURE_TIERS, } from './license.js';
-export { createQuotaMiddleware, withQuotaEnforcement, isUnlimitedTier, getQuotaLimit, formatQuotaRemaining, type QuotaMiddleware, type QuotaMiddlewareOptions, type QuotaCheckResult, type QuotaMetadata, type QuotaStorage, } from './quota.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

@@ -1 +0,0 @@
-{"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,KAAK,WAAW,EAChB,aAAa,EACb,qBAAqB,EACrB,aAAa,GACd,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAA;AAGnB,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

@@ -1,16 +0,0 @@
-/**
- * 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';
-// Quota enforcement middleware (SMI-1091)
-export { createQuotaMiddleware, withQuotaEnforcement, isUnlimitedTier, getQuotaLimit, formatQuotaRemaining, } from './quota.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

@@ -1 +0,0 @@
-{"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,EAO1B,aAAa,EACb,qBAAqB,EACrB,aAAa,GACd,MAAM,cAAc,CAAA;AAErB,0CAA0C;AAC1C,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,oBAAoB,GAMrB,MAAM,YAAY,CAAA;AAEnB,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

@@ -1,169 +0,0 @@
-/**
- * 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 tiers available in Skillsmith
- * - community: Free tier (1,000 API calls/month)
- * - individual: Solo developers ($9.99/mo, 10,000 API calls/month)
- * - team: Development teams ($25/user/mo, 100,000 API calls/month)
- * - enterprise: Full enterprise ($55/user/mo, unlimited)
- */
-export type LicenseTier = 'community' | 'individual' | 'team' | 'enterprise';
-/**
- * License information interface (mirrors @skillsmith/enterprise LicenseInfo)
- */
-export interface LicenseInfo {
-    valid: boolean;
-    tier: LicenseTier;
-    features: FeatureFlag[];
-    expiresAt?: Date;
-    organizationId?: string;
-}
-/**
- * License from enterprise package validation
- */
-interface EnterpriseLicense {
-    tier: LicenseTier;
-    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

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