@skillsmith/mcp-server 0.4.2 → 0.4.3

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

@@ -0,0 +1,237 @@
+/**
+ * @fileoverview Error Response Builder Functions
+ * @module @skillsmith/mcp-server/middleware/errorFormatter.builders
+ * @see SMI-1061: MCP Error Formatter for License Errors
+ * @see SMI-2741: Split from errorFormatter.ts to meet 500-line standard
+ *
+ * Pre-built MCP error response factories for common license error scenarios:
+ * - Upgrade required (feature tier mismatch)
+ * - License expired (renewal needed)
+ * - Quota exceeded (usage limit hit)
+ * - API authentication errors (401 handling)
+ */
+import { DEFAULT_UPGRADE_URL_CONFIG } from './errorFormatter.types.js';
+// ============================================================================
+// Upgrade URL Generation
+// ============================================================================
+/**
+ * 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,
+        },
+    };
+}
+// ============================================================================
+// API Authentication Error Formatting (SMI-XXXX)
+// ============================================================================
+/**
+ * Format a 401 authentication error for MCP display
+ * Provides user-friendly instructions for getting an API key
+ *
+ * @param details - Error details from the API response
+ * @returns MCP-formatted error response with signup instructions
+ */
+export function formatAuthenticationError(details = {}) {
+    const signupUrl = details.signupUrl || 'https://skillsmith.app/signup';
+    const docsUrl = details.docsUrl || 'https://skillsmith.app/docs/getting-started#api-key';
+    const trialInfo = details.trialUsed !== undefined && details.trialLimit !== undefined
+        ? `\n\n📊 **Trial Usage**: ${details.trialUsed}/${details.trialLimit} free requests used`
+        : '';
+    const message = `🔐 **Authentication Required**
+
+${details.reason || 'API key required for this request.'}
+
+**Get Started (Free - 1,000 requests/month):**
+1. Create account: ${signupUrl}
+2. Your API key will be generated automatically
+3. Add to your Claude settings:
+
+\`\`\`json
+{
+  "mcpServers": {
+    "skillsmith": {
+      "command": "npx",
+      "args": ["-y", "@skillsmith/mcp-server"],
+      "env": {
+        "SKILLSMITH_API_KEY": "your_key_here"
+      }
+    }
+  }
+}
+\`\`\`${trialInfo}
+
+[Documentation](${docsUrl})
+`;
+    return {
+        content: [
+            {
+                type: 'text',
+                text: message,
+            },
+        ],
+        isError: true,
+        _meta: {
+            errorCode: 'AUTHENTICATION_REQUIRED',
+            recoverable: true,
+            upgradeUrl: signupUrl,
+        },
+    };
+}
+/**
+ * Check if an API error is an authentication error (401)
+ */
+export function isAuthenticationError(error) {
+    if (!error || typeof error !== 'object') {
+        return false;
+    }
+    const e = error;
+    // Check for status code
+    if (e.statusCode === 401 || e.status === 401) {
+        return true;
+    }
+    // Check for error message patterns
+    if (typeof e.message === 'string') {
+        const msg = e.message.toLowerCase();
+        if (msg.includes('authentication required') || msg.includes('free trial exhausted')) {
+            return true;
+        }
+    }
+    // Check for error field
+    if (typeof e.error === 'string') {
+        const err = e.error.toLowerCase();
+        if (err.includes('authentication required')) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Extract authentication error details from an API error response
+ */
+export function extractAuthErrorDetails(error) {
+    if (!error || typeof error !== 'object') {
+        return {};
+    }
+    const e = error;
+    // Check for details object
+    if (e.details && typeof e.details === 'object') {
+        return e.details;
+    }
+    return {};
+}
+//# sourceMappingURL=errorFormatter.builders.js.map

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

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

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

@@ -1,55 +1,14 @@
 /**
  * SMI-1061: MCP Error Formatter for License Errors
+ * @see SMI-2741: Types split to errorFormatter.types.ts, builders to errorFormatter.builders.ts
  *
  * 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>;
-}
+export type { MCPErrorContent, MCPErrorResponse, LicenseErrorDetails, LicenseErrorLike, UpgradeUrlConfig, ApiAuthErrorDetails, } from './errorFormatter.types.js';
+export { ERROR_MESSAGES, DEFAULT_UPGRADE_URL_CONFIG } from './errorFormatter.types.js';
+export { generateUpgradeUrl, buildUpgradeRequiredResponse, buildLicenseExpiredResponse, buildQuotaExceededResponse, formatAuthenticationError, isAuthenticationError, extractAuthErrorDetails, } from './errorFormatter.builders.js';
+import type { MCPErrorResponse, LicenseErrorLike } from './errorFormatter.types.js';
 /**
  * Format a license error into an MCP-compliant error response
  *
@@ -81,33 +40,6 @@ export declare function formatGenericError(error: Error, code?: string): MCPErro
  * 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
  */
@@ -116,31 +48,4 @@ export declare function isLicenseErrorLike(error: unknown): error is LicenseErro
  * Safely convert any error to MCP format
  */
 export declare function safeFormatError(error: unknown): MCPErrorResponse;
-/**
- * Details from a 401 API authentication error
- */
-export interface ApiAuthErrorDetails {
-    reason?: string;
-    signupUrl?: string;
-    docsUrl?: string;
-    hint?: string;
-    trialUsed?: number;
-    trialLimit?: number;
-}
-/**
- * Format a 401 authentication error for MCP display
- * Provides user-friendly instructions for getting an API key
- *
- * @param details - Error details from the API response
- * @returns MCP-formatted error response with signup instructions
- */
-export declare function formatAuthenticationError(details?: ApiAuthErrorDetails): MCPErrorResponse;
-/**
- * Check if an API error is an authentication error (401)
- */
-export declare function isAuthenticationError(error: unknown): boolean;
-/**
- * Extract authentication error details from an API error response
- */
-export declare function extractAuthErrorDetails(error: unknown): ApiAuthErrorDetails;
 //# sourceMappingURL=errorFormatter.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errorFormatter.d.ts","sourceRoot":"","sources":["../../../src/middleware/errorFormatter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errorFormatter.d.ts","sourceRoot":"","sources":["../../../src/middleware/errorFormatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AAGtF,OAAO,EACL,kBAAkB,EAClB,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,8BAA8B,CAAA;AAGrC,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAEjB,MAAM,2BAA2B,CAAA;AAMlC;;;;;;;;;;;;;;;;;;;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;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAe3D;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"}

package/dist/src/middleware/errorFormatter.js

@@ -1,9 +1,13 @@
 /**
  * SMI-1061: MCP Error Formatter for License Errors
+ * @see SMI-2741: Types split to errorFormatter.types.ts, builders to errorFormatter.builders.ts
  *
  * Formats license errors into MCP protocol-compliant error responses
  * with actionable information for clients.
  */
+export { ERROR_MESSAGES, DEFAULT_UPGRADE_URL_CONFIG } from './errorFormatter.types.js';
+// Re-export builders from companion file
+export { generateUpgradeUrl, buildUpgradeRequiredResponse, buildLicenseExpiredResponse, buildQuotaExceededResponse, formatAuthenticationError, isAuthenticationError, extractAuthErrorDetails, } from './errorFormatter.builders.js';
 // ============================================================================
 // Error Formatting
 // ============================================================================
@@ -111,154 +115,23 @@ export function formatGenericError(error, code = 'INTERNAL_ERROR') {
 // ============================================================================
 // 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,
-        },
+    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.',
     };
+    return ERROR_MESSAGES[code] || 'An error occurred with your license. Please contact support.';
 }
 // ============================================================================
 // Validation Helpers
@@ -291,99 +164,4 @@ export function safeFormatError(error) {
     }
     return formatGenericError(new Error(String(error)));
 }
-/**
- * Format a 401 authentication error for MCP display
- * Provides user-friendly instructions for getting an API key
- *
- * @param details - Error details from the API response
- * @returns MCP-formatted error response with signup instructions
- */
-export function formatAuthenticationError(details = {}) {
-    const signupUrl = details.signupUrl || 'https://skillsmith.app/signup';
-    const docsUrl = details.docsUrl || 'https://skillsmith.app/docs/getting-started#api-key';
-    const trialInfo = details.trialUsed !== undefined && details.trialLimit !== undefined
-        ? `\n\n📊 **Trial Usage**: ${details.trialUsed}/${details.trialLimit} free requests used`
-        : '';
-    const message = `🔐 **Authentication Required**
-
-${details.reason || 'API key required for this request.'}
-
-**Get Started (Free - 1,000 requests/month):**
-1. Create account: ${signupUrl}
-2. Your API key will be generated automatically
-3. Add to your Claude settings:
-
-\`\`\`json
-{
-  "mcpServers": {
-    "skillsmith": {
-      "command": "npx",
-      "args": ["-y", "@skillsmith/mcp-server"],
-      "env": {
-        "SKILLSMITH_API_KEY": "your_key_here"
-      }
-    }
-  }
-}
-\`\`\`${trialInfo}
-
-[Documentation](${docsUrl})
-`;
-    return {
-        content: [
-            {
-                type: 'text',
-                text: message,
-            },
-        ],
-        isError: true,
-        _meta: {
-            errorCode: 'AUTHENTICATION_REQUIRED',
-            recoverable: true,
-            upgradeUrl: signupUrl,
-        },
-    };
-}
-/**
- * Check if an API error is an authentication error (401)
- */
-export function isAuthenticationError(error) {
-    if (!error || typeof error !== 'object') {
-        return false;
-    }
-    const e = error;
-    // Check for status code
-    if (e.statusCode === 401 || e.status === 401) {
-        return true;
-    }
-    // Check for error message patterns
-    if (typeof e.message === 'string') {
-        const msg = e.message.toLowerCase();
-        if (msg.includes('authentication required') || msg.includes('free trial exhausted')) {
-            return true;
-        }
-    }
-    // Check for error field
-    if (typeof e.error === 'string') {
-        const err = e.error.toLowerCase();
-        if (err.includes('authentication required')) {
-            return true;
-        }
-    }
-    return false;
-}
-/**
- * Extract authentication error details from an API error response
- */
-export function extractAuthErrorDetails(error) {
-    if (!error || typeof error !== 'object') {
-        return {};
-    }
-    const e = error;
-    // Check for details object
-    if (e.details && typeof e.details === 'object') {
-        return e.details;
-    }
-    return {};
-}
 //# sourceMappingURL=errorFormatter.js.map