@skillsmith/mcp-server 0.3.0 → 0.3.1

package/dist/src/middleware/license.js

@@ -1,292 +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 { TOOL_FEATURES, FEATURE_DISPLAY_NAMES, FEATURE_TIERS, } from './toolFeatureMapping.js';
-/**
- * Configuration for the upgrade URL
- */
-const UPGRADE_URL = 'https://skillsmith.app/pricing';
-/**
- * Type guard to validate enterprise module structure
- */
-function isEnterpriseModule(mod) {
-    return (typeof mod === 'object' &&
-        mod !== null &&
-        'LicenseValidator' in mod &&
-        typeof mod['LicenseValidator'] === 'function');
-}
-/**
- * Attempt to load the enterprise license validator
- * Returns null if the package is not installed
- */
-async function tryLoadEnterpriseValidator() {
-    try {
-        // Dynamic import with variable to prevent TypeScript from resolving at compile time
-        // This is an optional peer dependency that may not be installed
-        const packageName = '@skillsmith/enterprise';
-        const enterprise = await import(/* webpackIgnore: true */ packageName);
-        if (isEnterpriseModule(enterprise)) {
-            return new enterprise.LicenseValidator();
-        }
-        return null;
-    }
-    catch {
-        // Enterprise package not installed - this is expected for community users
-        return null;
-    }
-}
-/**
- * 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 function isEnterpriseFeature(toolName) {
-    const feature = TOOL_FEATURES[toolName];
-    if (feature == null) {
-        return false;
-    }
-    return FEATURE_TIERS[feature] === 'enterprise';
-}
-/**
- * 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 function requiresLicense(toolName) {
-    return TOOL_FEATURES[toolName] !== null && TOOL_FEATURES[toolName] !== undefined;
-}
-/**
- * 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 function getRequiredFeature(toolName) {
-    return TOOL_FEATURES[toolName] ?? null;
-}
-/**
- * Check if license is expiring soon (within 30 days)
- */
-function getExpirationWarning(expiresAt) {
-    if (!expiresAt)
-        return undefined;
-    const daysUntilExpiry = Math.floor((expiresAt.getTime() - Date.now()) / (1000 * 60 * 60 * 24));
-    if (daysUntilExpiry <= 30 && daysUntilExpiry > 0) {
-        return `Your license expires in ${daysUntilExpiry} day${daysUntilExpiry === 1 ? '' : 's'}. Please renew to avoid service interruption.`;
-    }
-    return undefined;
-}
-/**
- * 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 function createLicenseMiddleware(options) {
-    const envVar = options?.licenseKeyEnvVar ?? 'SKILLSMITH_LICENSE_KEY';
-    const cacheTtl = options?.cacheTtlMs ?? 5 * 60 * 1000; // 5 minutes default
-    const context = {
-        validator: null,
-        licenseKey: process.env[envVar],
-        cachedLicense: null,
-        cacheExpiry: 0,
-    };
-    // Initialize validator lazily
-    let validatorPromise = null;
-    async function getValidator() {
-        if (!validatorPromise) {
-            validatorPromise = tryLoadEnterpriseValidator();
-        }
-        if (context.validator === null) {
-            context.validator = await validatorPromise;
-        }
-        return context.validator;
-    }
-    async function getLicenseInfo() {
-        // Check cache first
-        if (context.cachedLicense && Date.now() < context.cacheExpiry) {
-            return context.cachedLicense;
-        }
-        // No license key = community user
-        if (!context.licenseKey) {
-            const communityLicense = {
-                valid: true,
-                tier: 'community',
-                features: [],
-            };
-            context.cachedLicense = communityLicense;
-            context.cacheExpiry = Date.now() + cacheTtl;
-            return communityLicense;
-        }
-        // Try to validate with enterprise package
-        const validator = await getValidator();
-        if (!validator) {
-            // Enterprise package not installed but license key provided
-            // Security-conscious decision: Return null to indicate validation failure
-            // rather than silently degrading to community tier. This ensures paying
-            // customers get feedback that their license couldn't be validated.
-            // See SMI-1130 for rationale.
-            return null;
-        }
-        try {
-            const result = await validator.validate(context.licenseKey);
-            // Check if validation was successful
-            if (!result.valid || !result.license) {
-                // Invalid license - return null to indicate validation failure
-                return null;
-            }
-            // Convert enterprise License to middleware LicenseInfo
-            const license = {
-                valid: true,
-                tier: result.license.tier,
-                features: result.license.features,
-                expiresAt: result.license.expiresAt,
-                organizationId: result.license.customerId,
-            };
-            context.cachedLicense = license;
-            context.cacheExpiry = Date.now() + cacheTtl;
-            return license;
-        }
-        catch {
-            // Validation threw an exception - treat as invalid license
-            return null;
-        }
-    }
-    async function checkFeature(feature) {
-        const license = await getLicenseInfo();
-        // No valid license
-        if (!license || !license.valid) {
-            const tier = FEATURE_TIERS[feature];
-            const displayName = FEATURE_DISPLAY_NAMES[feature];
-            return {
-                valid: false,
-                feature,
-                message: `The "${displayName}" feature requires a ${tier} license. Your license could not be validated.`,
-                upgradeUrl: `${UPGRADE_URL}?feature=${feature}`,
-            };
-        }
-        // Community tier - no paid features
-        if (license.tier === 'community') {
-            const tier = FEATURE_TIERS[feature];
-            const displayName = FEATURE_DISPLAY_NAMES[feature];
-            return {
-                valid: false,
-                feature,
-                message: `The "${displayName}" feature requires a ${tier} license. You are currently on the community tier.`,
-                upgradeUrl: `${UPGRADE_URL}?feature=${feature}&current=community`,
-            };
-        }
-        // Individual tier - only individual features (basic_analytics, email_support)
-        const featureTier = FEATURE_TIERS[feature];
-        if (license.tier === 'individual' && (featureTier === 'team' || featureTier === 'enterprise')) {
-            const displayName = FEATURE_DISPLAY_NAMES[feature];
-            return {
-                valid: false,
-                feature,
-                message: `The "${displayName}" feature requires a ${featureTier} license. You are currently on the individual tier.`,
-                upgradeUrl: `${UPGRADE_URL}?feature=${feature}&current=individual`,
-            };
-        }
-        // Team tier - only team features (not enterprise)
-        if (license.tier === 'team' && featureTier === 'enterprise') {
-            const displayName = FEATURE_DISPLAY_NAMES[feature];
-            return {
-                valid: false,
-                feature,
-                message: `The "${displayName}" feature requires an enterprise license. You are currently on the team tier.`,
-                upgradeUrl: `${UPGRADE_URL}?feature=${feature}&current=team`,
-            };
-        }
-        // Check if feature is in the license
-        if (!license.features.includes(feature)) {
-            const displayName = FEATURE_DISPLAY_NAMES[feature];
-            const tier = FEATURE_TIERS[feature];
-            return {
-                valid: false,
-                feature,
-                message: `The "${displayName}" feature is not included in your license. Please upgrade to access this ${tier} feature.`,
-                upgradeUrl: `${UPGRADE_URL}?feature=${feature}&upgrade=true`,
-            };
-        }
-        const warning = getExpirationWarning(license.expiresAt);
-        return { valid: true, warning };
-    }
-    async function checkTool(toolName) {
-        const requiredFeature = getRequiredFeature(toolName);
-        // Community tool - no license required
-        if (requiredFeature === null) {
-            return { valid: true };
-        }
-        return checkFeature(requiredFeature);
-    }
-    function invalidateCache() {
-        context.cachedLicense = null;
-        context.cacheExpiry = 0;
-    }
-    return {
-        checkFeature,
-        checkTool,
-        getLicenseInfo,
-        invalidateCache,
-    };
-}
-/**
- * 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 function requireFeature(feature) {
-    return async (middleware) => {
-        return middleware.checkFeature(feature);
-    };
-}
-/**
- * Create an error response for license validation failures
- *
- * @param result - The license validation result
- * @returns MCP-formatted error response
- */
-export function createLicenseErrorResponse(result) {
-    return {
-        content: [
-            {
-                type: 'text',
-                text: JSON.stringify({
-                    error: 'license_required',
-                    message: result.message,
-                    feature: result.feature,
-                    upgradeUrl: result.upgradeUrl,
-                }, null, 2),
-            },
-        ],
-        isError: true,
-        _meta: result.upgradeUrl ? { upgradeUrl: result.upgradeUrl } : undefined,
-    };
-}
-export { TOOL_FEATURES, FEATURE_DISPLAY_NAMES, FEATURE_TIERS } from './toolFeatureMapping.js';
-//# sourceMappingURL=license.js.map

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

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

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

@@ -1,182 +0,0 @@
-/**
- * SMI-1091: Quota Enforcement Middleware for MCP Server
- *
- * Enforces API call quotas based on license tier.
- * Integrates with the license middleware and QuotaEnforcementService.
- *
- * Tier Limits:
- * - Community: 1,000 API calls/month (free)
- * - Individual: 10,000 API calls/month ($9.99/mo)
- * - Team: 100,000 API calls/month ($25/user/mo)
- * - Enterprise: Unlimited
- *
- * @see SMI-1055: Add license middleware to MCP server
- * @see packages/enterprise/src/quota/QuotaEnforcementService.ts
- */
-import type { LicenseMiddleware, LicenseInfo, LicenseTier } from './license.js';
-import { type MCPErrorResponse } from './errorFormatter.js';
-/**
- * Warning threshold type for quota levels
- */
-type WarningLevel = 0 | 80 | 90 | 100;
-/**
- * Quota check result returned after validating usage
- */
-export interface QuotaCheckResult {
-    /** Whether the tool call is allowed */
-    allowed: boolean;
-    /** Remaining API calls in the current period */
-    remaining: number;
-    /** Total limit for the current tier (-1 for unlimited) */
-    limit: number;
-    /** Percentage of quota used (0-100+) */
-    percentUsed: number;
-    /** Current warning level (0, 80, 90, or 100) */
-    warningLevel: WarningLevel;
-    /** When the quota resets (start of next billing period) */
-    resetAt: Date;
-    /** Warning or error message if applicable */
-    message?: string;
-    /** Upgrade URL if quota is exceeded or near limit */
-    upgradeUrl?: string;
-}
-/**
- * Quota information to include in response metadata
- */
-export interface QuotaMetadata {
-    /** Remaining API calls */
-    remaining: number;
-    /** Total limit (-1 for unlimited) */
-    limit: number;
-    /** When the quota resets */
-    resetAt: string;
-    /** Warning message if approaching limit */
-    warning?: string;
-}
-/**
- * Quota middleware configuration options
- */
-export interface QuotaMiddlewareOptions {
-    /**
-     * Cost of each API call (default: 1)
-     * Can be customized per tool if some tools are more expensive
-     */
-    defaultCost?: number;
-    /**
-     * Whether to track usage even for unlimited tiers (enterprise)
-     * Useful for analytics purposes
-     */
-    trackUnlimited?: boolean;
-    /**
-     * Custom storage adapter for quota tracking
-     * If not provided, uses in-memory storage (resets on restart)
-     */
-    storage?: QuotaStorage;
-}
-/**
- * Interface for quota storage adapters
- */
-export interface QuotaStorage {
-    /** Get current usage for a customer in the current period */
-    getUsage(customerId: string): Promise<{
-        used: number;
-        periodStart: Date;
-        periodEnd: Date;
-    }>;
-    /** Increment usage count */
-    incrementUsage(customerId: string, cost: number): Promise<void>;
-    /** Initialize quota for a new billing period */
-    initializePeriod(customerId: string, limit: number): Promise<void>;
-}
-/**
- * Quota middleware instance
- */
-export interface QuotaMiddleware {
-    /**
-     * Check if a tool call is allowed and track usage
-     * Call this BEFORE executing the tool
-     */
-    checkAndTrack(toolName: string, licenseInfo: LicenseInfo | null, customerId?: string): Promise<QuotaCheckResult>;
-    /**
-     * Get current quota status without incrementing
-     */
-    getStatus(licenseInfo: LicenseInfo | null, customerId?: string): Promise<QuotaCheckResult>;
-    /**
-     * Build quota metadata for response _meta field
-     */
-    buildMetadata(result: QuotaCheckResult): QuotaMetadata;
-    /**
-     * Build error response for quota exceeded
-     */
-    buildExceededResponse(result: QuotaCheckResult): MCPErrorResponse;
-}
-/**
- * Create a quota enforcement middleware
- *
- * @param options - Configuration options
- * @returns Quota middleware instance
- *
- * @example
- * ```typescript
- * import { createQuotaMiddleware } from './middleware/quota.js';
- * import { createLicenseMiddleware } from './middleware/license.js';
- *
- * const licenseMiddleware = createLicenseMiddleware();
- * const quotaMiddleware = createQuotaMiddleware();
- *
- * // In tool handler:
- * async function handleTool(toolName: string, params: unknown) {
- *   const licenseInfo = await licenseMiddleware.getLicenseInfo();
- *   const quotaResult = await quotaMiddleware.checkAndTrack(toolName, licenseInfo);
- *
- *   if (!quotaResult.allowed) {
- *     return quotaMiddleware.buildExceededResponse(quotaResult);
- *   }
- *
- *   // Execute tool...
- *   const result = await executeTool(toolName, params);
- *
- *   // Add quota metadata to response
- *   return {
- *     ...result,
- *     _meta: {
- *       ...result._meta,
- *       quota: quotaMiddleware.buildMetadata(quotaResult),
- *     },
- *   };
- * }
- * ```
- */
-export declare function createQuotaMiddleware(options?: QuotaMiddlewareOptions): QuotaMiddleware;
-/**
- * Wrap a tool handler with quota enforcement
- *
- * @param handler - The original tool handler
- * @param licenseMiddleware - License middleware instance
- * @param quotaMiddleware - Quota middleware instance
- * @returns Wrapped handler with quota enforcement
- *
- * @example
- * ```typescript
- * const searchHandler = withQuotaEnforcement(
- *   originalSearchHandler,
- *   licenseMiddleware,
- *   quotaMiddleware
- * );
- * ```
- */
-export declare function withQuotaEnforcement<TParams, TResult>(handler: (params: TParams) => Promise<TResult>, licenseMiddleware: LicenseMiddleware, quotaMiddleware: QuotaMiddleware): (toolName: string, params: TParams) => Promise<TResult | MCPErrorResponse>;
-/**
- * Check if a tier has unlimited quota
- */
-export declare function isUnlimitedTier(tier: LicenseTier): boolean;
-/**
- * Get the quota limit for a tier
- */
-export declare function getQuotaLimit(tier: LicenseTier): number;
-/**
- * Format quota remaining for display
- */
-export declare function formatQuotaRemaining(remaining: number, limit: number): string;
-export {};
-//# sourceMappingURL=quota.d.ts.map

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

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