@skillsmith/mcp-server 0.3.0 → 0.3.1

package/dist/src/middleware/degradation.js

@@ -1,319 +0,0 @@
-/**
- * SMI-1060: Graceful Degradation Middleware
- *
- * Middleware that wraps tool handlers with graceful degradation,
- * returning helpful messages instead of hard errors when features
- * are unavailable.
- */
-import { createLicenseMiddleware, getRequiredFeature, } from './license.js';
-import { TOOL_FEATURES, FEATURE_DISPLAY_NAMES, FEATURE_TIERS, } from './toolFeatureMapping.js';
-// ============================================================================
-// Constants
-// ============================================================================
-const BASE_URL = 'https://skillsmith.app';
-/**
- * Pricing information for each tier
- */
-const TIER_PRICING = {
-    community: '$0/month',
-    individual: '$9.99/month',
-    team: '$25/user/month',
-    enterprise: '$55/user/month',
-};
-/**
- * Feature descriptions for upgrade prompts
- */
-const FEATURE_DESCRIPTIONS = {
-    // Individual tier features
-    basic_analytics: 'Track your personal skill usage and activity',
-    email_support: 'Get help from our support team via email',
-    // Team tier features
-    private_skills: 'Create and manage private skills for your organization',
-    team_workspaces: 'Collaborate with your team on shared skill collections',
-    usage_analytics: 'Track skill usage and adoption across your organization',
-    priority_support: 'Get faster response times from our support team',
-    // Enterprise tier features
-    sso_saml: 'Integrate with your identity provider for secure single sign-on',
-    rbac: 'Fine-grained access control with custom roles and permissions',
-    audit_logging: 'Comprehensive audit trail for compliance and security',
-    siem_export: 'Export audit logs to your SIEM platform for centralized monitoring',
-    compliance_reports: 'Generate compliance reports for SOC2, HIPAA, and other standards',
-    private_registry: 'Host a private registry of skills for your organization',
-    // Additional features
-    custom_integrations: 'Build custom integrations with your tools',
-    advanced_analytics: 'In-depth usage analytics and reporting',
-};
-// ============================================================================
-// Default Logger
-// ============================================================================
-/**
- * Default no-op logger
- */
-const noopLogger = {
-    log: () => { },
-};
-/**
- * Console logger for degradation events
- */
-export const consoleDegradationLogger = {
-    log: (event) => {
-        const prefix = event.action === 'degraded' ? '[UPGRADE REQUIRED]' : `[${event.action.toUpperCase()}]`;
-        console.log(`${prefix} ${event.toolName}: ${event.message || 'No message'}`);
-    },
-};
-// ============================================================================
-// Upgrade Message Generators
-// ============================================================================
-/**
- * Create an upgrade prompt for a denied feature
- */
-function createUpgradePrompt(feature, _currentTier) {
-    const displayName = FEATURE_DISPLAY_NAMES[feature];
-    const requiredTier = FEATURE_TIERS[feature];
-    const pricing = TIER_PRICING[requiredTier];
-    return `${displayName} requires ${requiredTier.charAt(0).toUpperCase() + requiredTier.slice(1)} tier (${pricing}). Upgrade at ${BASE_URL}/upgrade?tier=${requiredTier}&feature=${feature}`;
-}
-/**
- * Create a detailed upgrade message with feature description
- */
-function createDetailedUpgradeMessage(feature, currentTier) {
-    const displayName = FEATURE_DISPLAY_NAMES[feature];
-    const description = FEATURE_DESCRIPTIONS[feature];
-    const requiredTier = FEATURE_TIERS[feature];
-    const pricing = TIER_PRICING[requiredTier];
-    const currentPricing = TIER_PRICING[currentTier];
-    return [
-        `Feature Unavailable: ${displayName}`,
-        '',
-        description,
-        '',
-        `Current tier: ${currentTier.charAt(0).toUpperCase() + currentTier.slice(1)} (${currentPricing})`,
-        `Required tier: ${requiredTier.charAt(0).toUpperCase() + requiredTier.slice(1)} (${pricing})`,
-        '',
-        `Upgrade to unlock: ${BASE_URL}/upgrade?tier=${requiredTier}&feature=${feature}`,
-        `Compare plans: ${BASE_URL}/pricing?highlight=${feature}&current=${currentTier}`,
-    ].join('\n');
-}
-/**
- * Get tier comparison message
- */
-export function getTierComparisonMessage() {
-    return [
-        'Skillsmith Pricing Tiers',
-        '========================',
-        '',
-        'Community ($0/month)',
-        '----------------------------------------',
-        '  - Core features: search, install, recommend, validate, compare',
-        '',
-        'Team ($25/user/month)',
-        '----------------------------------------',
-        '  - Private Skills',
-        '  - Team Workspaces',
-        '  - Priority Support',
-        '',
-        'Enterprise ($55/user/month)',
-        '----------------------------------------',
-        '  - SSO/SAML Integration',
-        '  - Role-Based Access Control',
-        '  - Audit Logging',
-        '  - Custom Integrations',
-        '  - Advanced Analytics',
-        '',
-        `Learn more: ${BASE_URL}/pricing`,
-    ].join('\n');
-}
-// ============================================================================
-// Graceful Degradation Response
-// ============================================================================
-/**
- * Create a graceful degradation response for an unavailable feature
- */
-function createGracefulDegradationResponse(toolName, feature, currentTier, _validationResult) {
-    const requiredTier = FEATURE_TIERS[feature];
-    const displayName = FEATURE_DISPLAY_NAMES[feature];
-    const response = {
-        status: 'upgrade_required',
-        feature: {
-            id: feature,
-            name: displayName,
-            description: FEATURE_DESCRIPTIONS[feature],
-        },
-        tiers: {
-            current: {
-                id: currentTier,
-                pricing: TIER_PRICING[currentTier],
-            },
-            required: {
-                id: requiredTier,
-                pricing: TIER_PRICING[requiredTier],
-            },
-        },
-        upgrade: {
-            message: createUpgradePrompt(feature, currentTier),
-            detailedMessage: createDetailedUpgradeMessage(feature, currentTier),
-            url: `${BASE_URL}/upgrade?tier=${requiredTier}&feature=${feature}&tool=${toolName}`,
-            pricingUrl: `${BASE_URL}/pricing?highlight=${feature}&current=${currentTier}`,
-        },
-        alternatives: getCommunityAlternatives(toolName),
-    };
-    return {
-        content: [
-            {
-                type: 'text',
-                text: JSON.stringify(response, null, 2),
-            },
-        ],
-        isError: false,
-        _meta: {
-            upgradeRequired: true,
-            feature,
-            requiredTier,
-            upgradeUrl: response.upgrade.url,
-        },
-    };
-}
-/**
- * Get community-tier alternatives for a premium tool
- */
-function getCommunityAlternatives(toolName) {
-    // Map of premium tools to their community alternatives
-    const alternatives = {
-        publish_private: ['search', 'get_skill', 'install_skill'],
-        team_workspace: ['search', 'install_skill'],
-        share_skill: ['search', 'skill_compare'],
-        configure_sso: ['search'],
-        audit_export: ['search'],
-        audit_query: ['search'],
-        rbac_manage: ['search'],
-        rbac_assign_role: ['search'],
-        rbac_create_policy: ['search'],
-        analytics_dashboard: ['search', 'skill_recommend'],
-        usage_report: ['search'],
-        webhook_configure: ['search'],
-        api_key_manage: ['search'],
-    };
-    return alternatives[toolName] || ['search', 'get_skill', 'install_skill'];
-}
-// ============================================================================
-// Middleware Factory
-// ============================================================================
-/**
- * Create the degradation middleware
- *
- * This middleware wraps tool handlers to provide graceful degradation
- * when features are unavailable due to license restrictions.
- *
- * @param options - Middleware configuration options
- * @returns Middleware wrapper function
- *
- * @example
- * ```typescript
- * const middleware = createDegradationMiddleware({
- *   logger: consoleDegradationLogger,
- *   verbose: true,
- * });
- *
- * const wrappedHandler = middleware.wrapHandler('audit_query', originalHandler);
- * ```
- */
-export function createDegradationMiddleware(options = {}) {
-    const licenseMiddleware = options.licenseMiddleware ?? createLicenseMiddleware();
-    const logger = options.logger ?? noopLogger;
-    /**
-     * Wrap a tool handler with graceful degradation
-     */
-    async function wrapHandler(toolName, handler, request) {
-        // Check if tool requires a license
-        const requiredFeature = getRequiredFeature(toolName);
-        // Community tools always pass through
-        if (requiredFeature === null) {
-            logger.log({
-                timestamp: new Date().toISOString(),
-                toolName,
-                feature: null,
-                tier: 'community',
-                action: 'allowed',
-                message: 'Community tool - no license required',
-            });
-            return handler(request);
-        }
-        // Check license for the required feature
-        const validationResult = await licenseMiddleware.checkFeature(requiredFeature);
-        if (validationResult.valid) {
-            const licenseInfo = await licenseMiddleware.getLicenseInfo();
-            logger.log({
-                timestamp: new Date().toISOString(),
-                toolName,
-                feature: requiredFeature,
-                tier: licenseInfo?.tier ?? 'community',
-                action: 'allowed',
-                message: 'Feature available in license',
-            });
-            return handler(request);
-        }
-        // Feature not available - return graceful degradation response
-        const licenseInfo = await licenseMiddleware.getLicenseInfo();
-        const currentTier = licenseInfo?.tier ?? 'community';
-        logger.log({
-            timestamp: new Date().toISOString(),
-            toolName,
-            feature: requiredFeature,
-            tier: currentTier,
-            action: 'degraded',
-            message: `Feature ${requiredFeature} requires upgrade`,
-        });
-        return createGracefulDegradationResponse(toolName, requiredFeature, currentTier, validationResult);
-    }
-    /**
-     * Create a wrapped handler function
-     */
-    function createWrappedHandler(toolName, handler) {
-        return async (request) => {
-            return wrapHandler(toolName, handler, request);
-        };
-    }
-    /**
-     * Check if a tool would be degraded for the current license
-     */
-    async function wouldDegrade(toolName) {
-        const requiredFeature = getRequiredFeature(toolName);
-        if (requiredFeature === null) {
-            return false;
-        }
-        const validationResult = await licenseMiddleware.checkFeature(requiredFeature);
-        return !validationResult.valid;
-    }
-    /**
-     * Get degradation status for all tools
-     */
-    async function getDegradationStatus() {
-        const status = new Map();
-        for (const toolName of Object.keys(TOOL_FEATURES)) {
-            status.set(toolName, await wouldDegrade(toolName));
-        }
-        return status;
-    }
-    /**
-     * Get upgrade prompt for a tool
-     */
-    async function getUpgradePrompt(toolName) {
-        const requiredFeature = getRequiredFeature(toolName);
-        if (requiredFeature === null) {
-            return null;
-        }
-        const licenseInfo = await licenseMiddleware.getLicenseInfo();
-        const currentTier = licenseInfo?.tier ?? 'community';
-        return createUpgradePrompt(requiredFeature, currentTier);
-    }
-    return {
-        wrapHandler,
-        createWrappedHandler,
-        wouldDegrade,
-        getDegradationStatus,
-        getUpgradePrompt,
-        getTierComparisonMessage,
-        licenseMiddleware,
-    };
-}
-//# sourceMappingURL=degradation.js.map

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

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

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

@@ -1,119 +0,0 @@
-/**
- * SMI-1061: MCP Error Formatter for License Errors
- *
- * Formats license errors into MCP protocol-compliant error responses
- * with actionable information for clients.
- */
-/**
- * MCP-formatted error response content
- */
-export interface MCPErrorContent {
-    type: 'text';
-    text: string;
-}
-/**
- * MCP-formatted error response
- */
-export interface MCPErrorResponse {
-    content: MCPErrorContent[];
-    isError: true;
-    _meta?: {
-        upgradeUrl?: string;
-        errorCode?: string;
-        recoverable?: boolean;
-    };
-}
-/**
- * License error details structure (mirrors the enterprise package)
- */
-export interface LicenseErrorDetails {
-    code: string;
-    message: string;
-    feature?: string;
-    currentTier?: string;
-    requiredTier?: string;
-    upgradeUrl?: string;
-    context?: Record<string, unknown>;
-    timestamp?: string;
-}
-/**
- * Interface for license errors (duck-typed for optional enterprise package)
- */
-export interface LicenseErrorLike {
-    code?: string;
-    message: string;
-    feature?: string;
-    currentTier?: string;
-    requiredTier?: string;
-    upgradeUrl?: string;
-    context?: Record<string, unknown>;
-    timestamp?: Date;
-    toJSON?: () => Record<string, unknown>;
-}
-/**
- * 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 declare function formatLicenseError(error: LicenseErrorLike): MCPErrorResponse;
-/**
- * Format a generic error for MCP response
- *
- * Use this for non-license errors that still need MCP formatting.
- */
-export declare function formatGenericError(error: Error, code?: string): MCPErrorResponse;
-/**
- * Get a user-friendly message for an error code
- */
-export declare function getUserFriendlyMessage(code: string): string;
-/**
- * Configuration for upgrade URLs
- */
-export interface UpgradeUrlConfig {
-    baseUrl?: string;
-    includeFeature?: boolean;
-    includeTiers?: boolean;
-    includeSource?: boolean;
-}
-/**
- * Generate a customized upgrade URL with tracking parameters
- */
-export declare function generateUpgradeUrl(error: LicenseErrorLike, config?: Partial<UpgradeUrlConfig>): string;
-/**
- * Build an upgrade required response
- *
- * Use this when a feature requires an upgrade but isn't a full error.
- */
-export declare function buildUpgradeRequiredResponse(feature: string, currentTier: string, requiredTier: string): MCPErrorResponse;
-/**
- * Build a license expired response with renewal URL
- */
-export declare function buildLicenseExpiredResponse(expiredAt?: Date): MCPErrorResponse;
-/**
- * Build a quota exceeded response
- */
-export declare function buildQuotaExceededResponse(quotaType: string, current: number, max: number): MCPErrorResponse;
-/**
- * Check if an object looks like a license error
- */
-export declare function isLicenseErrorLike(error: unknown): error is LicenseErrorLike;
-/**
- * Safely convert any error to MCP format
- */
-export declare function safeFormatError(error: unknown): MCPErrorResponse;
-//# sourceMappingURL=errorFormatter.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"errorFormatter.d.ts","sourceRoot":"","sources":["../../../src/middleware/errorFormatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,OAAO,EAAE,IAAI,CAAA;IACb,KAAK,CAAC,EAAE;QACN,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,WAAW,CAAC,EAAE,OAAO,CAAA;KACtB,CAAA;CACF;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,SAAS,CAAC,EAAE,IAAI,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACvC;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,CAsD5E;AAYD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,SAAmB,GAAG,gBAAgB,CAmB1F;AAsBD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3D;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AASD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,gBAAgB,EACvB,MAAM,GAAE,OAAO,CAAC,gBAAgB,CAAM,GACrC,MAAM,CA0BR;AAMD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,gBAAgB,CAgClB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,CAAC,EAAE,IAAI,GAAG,gBAAgB,CA8B9E;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,gBAAgB,CAgClB;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAiB5E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAUhE"}