@elliotding/ai-agent-mcp 0.1.26 → 0.1.27

package/dist/utils/validation.js

@@ -0,0 +1,214 @@
+"use strict";
+/**
+ * Request Validation Utilities
+ * Enhanced validation with clear error messages
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestValidationError = void 0;
+exports.validateRequired = validateRequired;
+exports.validateString = validateString;
+exports.validateEnum = validateEnum;
+exports.validateArray = validateArray;
+exports.validateObject = validateObject;
+exports.validateBoolean = validateBoolean;
+exports.validateNumber = validateNumber;
+exports.validateSSEConnectionParams = validateSSEConnectionParams;
+exports.validateMessageParams = validateMessageParams;
+class RequestValidationError extends Error {
+    errors;
+    statusCode;
+    constructor(errors, statusCode = 400) {
+        const message = errors.map(e => `${e.field}: ${e.message}`).join('; ');
+        super(message);
+        this.name = 'RequestValidationError';
+        this.errors = errors;
+        this.statusCode = statusCode;
+    }
+    toJSON() {
+        return {
+            error: 'Validation Error',
+            message: this.message,
+            details: this.errors,
+        };
+    }
+}
+exports.RequestValidationError = RequestValidationError;
+/**
+ * Validate required field
+ */
+function validateRequired(value, fieldName) {
+    if (value === undefined || value === null || value === '') {
+        return {
+            field: fieldName,
+            message: `Missing required field: '${fieldName}'`,
+            expected: 'non-empty value',
+            received: typeof value,
+        };
+    }
+    return null;
+}
+/**
+ * Validate string type
+ */
+function validateString(value, fieldName) {
+    if (typeof value !== 'string') {
+        return {
+            field: fieldName,
+            message: `Field '${fieldName}' must be a string`,
+            expected: 'string',
+            received: typeof value,
+        };
+    }
+    return null;
+}
+/**
+ * Validate enum value
+ */
+function validateEnum(value, fieldName, allowedValues) {
+    if (!allowedValues.includes(value)) {
+        // Find closest match for suggestion
+        const suggestion = findClosestMatch(value, allowedValues);
+        return {
+            field: fieldName,
+            message: `Field '${fieldName}' has invalid value`,
+            expected: `one of: ${allowedValues.map(v => `'${v}'`).join(', ')}`,
+            received: value,
+            suggestion: suggestion ? `Did you mean '${suggestion}'?` : undefined,
+        };
+    }
+    return null;
+}
+/**
+ * Validate array type
+ */
+function validateArray(value, fieldName) {
+    if (!Array.isArray(value)) {
+        return {
+            field: fieldName,
+            message: `Field '${fieldName}' must be an array`,
+            expected: 'array',
+            received: typeof value,
+        };
+    }
+    return null;
+}
+/**
+ * Validate object type
+ */
+function validateObject(value, fieldName) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        return {
+            field: fieldName,
+            message: `Field '${fieldName}' must be an object`,
+            expected: 'object',
+            received: Array.isArray(value) ? 'array' : typeof value,
+        };
+    }
+    return null;
+}
+/**
+ * Validate boolean type
+ */
+function validateBoolean(value, fieldName) {
+    if (typeof value !== 'boolean') {
+        return {
+            field: fieldName,
+            message: `Field '${fieldName}' must be a boolean`,
+            expected: 'boolean (true or false)',
+            received: typeof value,
+        };
+    }
+    return null;
+}
+/**
+ * Validate number type
+ */
+function validateNumber(value, fieldName) {
+    if (typeof value !== 'number' || isNaN(value)) {
+        return {
+            field: fieldName,
+            message: `Field '${fieldName}' must be a number`,
+            expected: 'number',
+            received: typeof value,
+        };
+    }
+    return null;
+}
+/**
+ * Find closest string match (simple Levenshtein distance)
+ */
+function findClosestMatch(value, candidates) {
+    if (!value || typeof value !== 'string') {
+        return null;
+    }
+    let minDistance = Infinity;
+    let closest = null;
+    for (const candidate of candidates) {
+        const distance = levenshteinDistance(value.toLowerCase(), candidate.toLowerCase());
+        if (distance < minDistance && distance <= 2) {
+            // Only suggest if distance is small
+            minDistance = distance;
+            closest = candidate;
+        }
+    }
+    return closest;
+}
+/**
+ * Calculate Levenshtein distance between two strings
+ */
+function levenshteinDistance(a, b) {
+    const matrix = [];
+    for (let i = 0; i <= b.length; i++) {
+        matrix[i] = [i];
+    }
+    for (let j = 0; j <= a.length; j++) {
+        matrix[0][j] = j;
+    }
+    for (let i = 1; i <= b.length; i++) {
+        for (let j = 1; j <= a.length; j++) {
+            if (b.charAt(i - 1) === a.charAt(j - 1)) {
+                matrix[i][j] = matrix[i - 1][j - 1];
+            }
+            else {
+                matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, // substitution
+                matrix[i][j - 1] + 1, // insertion
+                matrix[i - 1][j] + 1 // deletion
+                );
+            }
+        }
+    }
+    return matrix[b.length][a.length];
+}
+/**
+ * Validate SSE connection parameters
+ */
+function validateSSEConnectionParams(_body) {
+    const errors = [];
+    // Validate Authorization header (will be checked in middleware)
+    // No body parameters required for SSE connection
+    return errors;
+}
+/**
+ * Validate message parameters
+ */
+function validateMessageParams(body) {
+    const errors = [];
+    // sessionId is required
+    const sessionIdError = validateRequired(body.sessionId, 'sessionId');
+    if (sessionIdError) {
+        errors.push(sessionIdError);
+    }
+    else {
+        const sessionIdTypeError = validateString(body.sessionId, 'sessionId');
+        if (sessionIdTypeError) {
+            errors.push(sessionIdTypeError);
+        }
+    }
+    // message is required
+    const messageError = validateRequired(body.message, 'message');
+    if (messageError) {
+        errors.push(messageError);
+    }
+    return errors;
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elliotding/ai-agent-mcp",
-  "version": "0.1.26",
+  "version": "0.1.27",
   "description": "CSP AI Agent MCP Server - Centralized AI tools distribution and management",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",