ai.matey.http.core 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AI Matey Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cjs/auth.js

@@ -0,0 +1,173 @@
+"use strict";
+/**
+ * Authentication Handler
+ *
+ * Handles authentication validation for HTTP requests.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultAuthValidator = void 0;
+exports.createBearerTokenValidator = createBearerTokenValidator;
+exports.createAPIKeyValidator = createAPIKeyValidator;
+exports.createBasicAuthValidator = createBasicAuthValidator;
+exports.combineAuthValidators = combineAuthValidators;
+exports.requireAllAuth = requireAllAuth;
+exports.skipAuthForPaths = skipAuthForPaths;
+const crypto_1 = require("crypto");
+const request_parser_js_1 = require("./request-parser.js");
+/**
+ * Timing-safe string comparison to prevent timing attacks.
+ * Returns false if strings have different lengths (without revealing length via timing).
+ */
+function safeCompare(a, b) {
+    const bufA = Buffer.from(a);
+    const bufB = Buffer.from(b);
+    // If lengths differ, still do a comparison to prevent timing leaks
+    if (bufA.length !== bufB.length) {
+        // Compare against itself to maintain constant time
+        (0, crypto_1.timingSafeEqual)(bufA, bufA);
+        return false;
+    }
+    return (0, crypto_1.timingSafeEqual)(bufA, bufB);
+}
+/**
+ * Default auth validator (always allows)
+ */
+const defaultAuthValidator = () => true;
+exports.defaultAuthValidator = defaultAuthValidator;
+/**
+ * Create bearer token validator
+ */
+function createBearerTokenValidator(validTokens) {
+    return async (req) => {
+        const token = (0, request_parser_js_1.extractBearerToken)(req);
+        if (!token) {
+            return false;
+        }
+        if (typeof validTokens === 'function') {
+            return await validTokens(token);
+        }
+        if (validTokens instanceof Set) {
+            // Use timing-safe comparison for each token
+            for (const validToken of validTokens) {
+                if (safeCompare(validToken, token)) {
+                    return true;
+                }
+            }
+            return false;
+        }
+        // Use timing-safe comparison for array
+        for (const validToken of validTokens) {
+            if (safeCompare(validToken, token)) {
+                return true;
+            }
+        }
+        return false;
+    };
+}
+/**
+ * Create API key validator (checks x-api-key header)
+ */
+function createAPIKeyValidator(validKeys) {
+    return async (req) => {
+        const apiKey = req.headers['x-api-key'];
+        if (!apiKey) {
+            return false;
+        }
+        if (typeof validKeys === 'function') {
+            return await validKeys(apiKey);
+        }
+        if (validKeys instanceof Set) {
+            // Use timing-safe comparison for each key
+            for (const validKey of validKeys) {
+                if (safeCompare(validKey, apiKey)) {
+                    return true;
+                }
+            }
+            return false;
+        }
+        // Use timing-safe comparison for array
+        for (const validKey of validKeys) {
+            if (safeCompare(validKey, apiKey)) {
+                return true;
+            }
+        }
+        return false;
+    };
+}
+/**
+ * Create basic auth validator
+ */
+function createBasicAuthValidator(credentials) {
+    return async (req) => {
+        const auth = req.headers.authorization;
+        if (!auth?.startsWith('Basic ')) {
+            return false;
+        }
+        try {
+            const encoded = auth.slice(6);
+            const decoded = Buffer.from(encoded, 'base64').toString('utf-8');
+            const [username, password] = decoded.split(':');
+            if (!username || !password) {
+                return false;
+            }
+            if (typeof credentials === 'function') {
+                return await credentials(username, password);
+            }
+            const storedPassword = credentials.get(username);
+            if (!storedPassword) {
+                return false;
+            }
+            return safeCompare(storedPassword, password);
+        }
+        catch {
+            return false;
+        }
+    };
+}
+/**
+ * Combine multiple auth validators (OR logic)
+ */
+function combineAuthValidators(...validators) {
+    return async (req) => {
+        for (const validator of validators) {
+            if (await validator(req)) {
+                return true;
+            }
+        }
+        return false;
+    };
+}
+/**
+ * Require all auth validators to pass (AND logic)
+ */
+function requireAllAuth(...validators) {
+    return async (req) => {
+        for (const validator of validators) {
+            if (!(await validator(req))) {
+                return false;
+            }
+        }
+        return true;
+    };
+}
+/**
+ * Skip auth for certain paths
+ */
+function skipAuthForPaths(validator, paths) {
+    return async (req) => {
+        const url = new URL(req.url || '/', `http://${req.headers.host || 'localhost'}`);
+        const path = url.pathname;
+        if (typeof paths === 'function') {
+            if (paths(path)) {
+                return true;
+            }
+        }
+        else if (paths.includes(path)) {
+            return true;
+        }
+        return await validator(req);
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/cjs/auth.js.map

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

package/dist/cjs/cors.js

@@ -0,0 +1,140 @@
+"use strict";
+/**
+ * CORS Handler
+ *
+ * Handles Cross-Origin Resource Sharing (CORS) for HTTP requests.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeCORSOptions = normalizeCORSOptions;
+exports.handleCORS = handleCORS;
+exports.handlePreflight = handlePreflight;
+exports.isPreflight = isPreflight;
+/**
+ * Default CORS options
+ */
+const DEFAULT_CORS_OPTIONS = {
+    origin: '*',
+    methods: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS'],
+    allowedHeaders: ['Content-Type', 'Authorization'],
+    exposedHeaders: [],
+    credentials: true,
+    maxAge: 86400, // 24 hours
+};
+/**
+ * Normalize CORS options
+ */
+function normalizeCORSOptions(options) {
+    if (options === false) {
+        return null;
+    }
+    if (options === true || options === undefined) {
+        return DEFAULT_CORS_OPTIONS;
+    }
+    return {
+        origin: options.origin ?? DEFAULT_CORS_OPTIONS.origin,
+        methods: options.methods ?? DEFAULT_CORS_OPTIONS.methods,
+        allowedHeaders: options.allowedHeaders ?? DEFAULT_CORS_OPTIONS.allowedHeaders,
+        exposedHeaders: options.exposedHeaders ?? DEFAULT_CORS_OPTIONS.exposedHeaders,
+        credentials: options.credentials ?? DEFAULT_CORS_OPTIONS.credentials,
+        maxAge: options.maxAge ?? DEFAULT_CORS_OPTIONS.maxAge,
+    };
+}
+/**
+ * Handle CORS headers
+ */
+function handleCORS(req, res, options) {
+    const origin = req.headers.origin || '';
+    // Check if origin is allowed
+    if (!isOriginAllowed(origin, options.origin)) {
+        return false;
+    }
+    // Set Access-Control-Allow-Origin
+    if (typeof options.origin === 'string' && options.origin === '*') {
+        res.setHeader('Access-Control-Allow-Origin', '*');
+    }
+    else {
+        res.setHeader('Access-Control-Allow-Origin', origin);
+        res.setHeader('Vary', 'Origin');
+    }
+    // Set Access-Control-Allow-Credentials
+    if (options.credentials) {
+        res.setHeader('Access-Control-Allow-Credentials', 'true');
+    }
+    // Set Access-Control-Expose-Headers
+    if (options.exposedHeaders.length > 0) {
+        res.setHeader('Access-Control-Expose-Headers', Array.isArray(options.exposedHeaders)
+            ? options.exposedHeaders.join(', ')
+            : options.exposedHeaders);
+    }
+    return true;
+}
+/**
+ * Handle CORS preflight (OPTIONS) request
+ */
+function handlePreflight(req, res, options) {
+    const origin = req.headers.origin || '';
+    // Check if origin is allowed
+    if (!isOriginAllowed(origin, options.origin)) {
+        res.statusCode = 403;
+        res.end('Origin not allowed');
+        return;
+    }
+    // Set Access-Control-Allow-Origin
+    if (typeof options.origin === 'string' && options.origin === '*') {
+        res.setHeader('Access-Control-Allow-Origin', '*');
+    }
+    else {
+        res.setHeader('Access-Control-Allow-Origin', origin);
+        res.setHeader('Vary', 'Origin');
+    }
+    // Set Access-Control-Allow-Methods
+    res.setHeader('Access-Control-Allow-Methods', Array.isArray(options.methods) ? options.methods.join(', ') : options.methods);
+    // Set Access-Control-Allow-Headers
+    const requestHeaders = req.headers['access-control-request-headers'];
+    if (requestHeaders) {
+        res.setHeader('Access-Control-Allow-Headers', requestHeaders);
+    }
+    else {
+        res.setHeader('Access-Control-Allow-Headers', Array.isArray(options.allowedHeaders)
+            ? options.allowedHeaders.join(', ')
+            : options.allowedHeaders);
+    }
+    // Set Access-Control-Allow-Credentials
+    if (options.credentials) {
+        res.setHeader('Access-Control-Allow-Credentials', 'true');
+    }
+    // Set Access-Control-Max-Age
+    res.setHeader('Access-Control-Max-Age', String(options.maxAge));
+    // Send successful preflight response
+    res.statusCode = 204;
+    res.end();
+}
+/**
+ * Check if origin is allowed
+ */
+function isOriginAllowed(origin, allowedOrigin) {
+    if (!origin) {
+        return true; // Allow requests without origin header
+    }
+    if (typeof allowedOrigin === 'string') {
+        return allowedOrigin === '*' || allowedOrigin === origin;
+    }
+    if (Array.isArray(allowedOrigin)) {
+        return allowedOrigin.includes(origin) || allowedOrigin.includes('*');
+    }
+    if (typeof allowedOrigin === 'function') {
+        return allowedOrigin(origin);
+    }
+    return false;
+}
+/**
+ * Check if request is a CORS preflight request
+ */
+function isPreflight(req) {
+    return (req.method === 'OPTIONS' &&
+        !!req.headers.origin &&
+        !!req.headers['access-control-request-method']);
+}
+//# sourceMappingURL=cors.js.map

package/dist/cjs/cors.js.map

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

package/dist/cjs/error-handler.js

@@ -0,0 +1,147 @@
+"use strict";
+/**
+ * Error Handler
+ *
+ * Handles errors in HTTP requests and formats appropriate responses.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultErrorHandler = void 0;
+exports.createLoggingErrorHandler = createLoggingErrorHandler;
+exports.createReportingErrorHandler = createReportingErrorHandler;
+exports.wrapErrorHandler = wrapErrorHandler;
+exports.isRetryableError = isRetryableError;
+exports.isClientError = isClientError;
+exports.isServerError = isServerError;
+const response_formatter_js_1 = require("./response-formatter.js");
+const ai_matey_errors_1 = require("ai.matey.errors");
+/**
+ * Default error handler
+ */
+const defaultErrorHandler = (error, req, res) => {
+    // Detect provider format from request
+    const format = (0, response_formatter_js_1.detectProviderFormat)(req.url || '');
+    // Map error to HTTP status code
+    const statusCode = getHTTPStatusCode(error);
+    // Log error (in production, this should go to a proper logger)
+    if (statusCode >= 500) {
+        console.error('HTTP Server Error:', error);
+    }
+    // Send error response
+    (0, response_formatter_js_1.sendError)(res, error, statusCode, format);
+    return Promise.resolve();
+};
+exports.defaultErrorHandler = defaultErrorHandler;
+/**
+ * Get HTTP status code from error
+ */
+function getHTTPStatusCode(error) {
+    // Check for adapter errors
+    if (error instanceof ai_matey_errors_1.ValidationError) {
+        return 400;
+    }
+    if (error instanceof ai_matey_errors_1.AuthenticationError) {
+        return 401;
+    }
+    if (error instanceof ai_matey_errors_1.RateLimitError) {
+        return 429;
+    }
+    if (error instanceof ai_matey_errors_1.NetworkError) {
+        return 502;
+    }
+    if (error instanceof ai_matey_errors_1.ProviderError) {
+        return 503;
+    }
+    if (error instanceof ai_matey_errors_1.StreamError) {
+        return 500;
+    }
+    if (error instanceof ai_matey_errors_1.AdapterError) {
+        return 500;
+    }
+    // Check for common error patterns in message
+    const message = error.message.toLowerCase();
+    if (message.includes('invalid') || message.includes('malformed')) {
+        return 400;
+    }
+    if (message.includes('unauthorized') || message.includes('authentication')) {
+        return 401;
+    }
+    if (message.includes('forbidden') || message.includes('permission')) {
+        return 403;
+    }
+    if (message.includes('not found')) {
+        return 404;
+    }
+    if (message.includes('timeout')) {
+        return 504;
+    }
+    if (message.includes('too large')) {
+        return 413;
+    }
+    // Default to 500
+    return 500;
+}
+/**
+ * Create error handler that logs to a custom logger
+ */
+function createLoggingErrorHandler(log) {
+    return async (error, req, res) => {
+        log(`HTTP Error: ${req.method} ${req.url}`, error);
+        await (0, exports.defaultErrorHandler)(error, req, res);
+    };
+}
+/**
+ * Create error handler that reports errors to an external service
+ */
+function createReportingErrorHandler(reporter) {
+    return async (error, req, res) => {
+        // Report error asynchronously (don't wait)
+        reporter(error, req).catch((reportError) => {
+            console.error('Error reporting failed:', reportError);
+        });
+        // Send response
+        await (0, exports.defaultErrorHandler)(error, req, res);
+    };
+}
+/**
+ * Wrap error handler with custom logic
+ */
+function wrapErrorHandler(baseHandler, wrapper) {
+    return async (error, req, res) => {
+        await wrapper(error, req, res, async () => {
+            await baseHandler(error, req, res);
+        });
+    };
+}
+/**
+ * Check if error should be retried
+ */
+function isRetryableError(error) {
+    if (error instanceof ai_matey_errors_1.AdapterError) {
+        return error.isRetryable;
+    }
+    if (error instanceof ai_matey_errors_1.NetworkError || error instanceof ai_matey_errors_1.ProviderError) {
+        return true;
+    }
+    // Check for timeout errors by message
+    if (error.message.toLowerCase().includes('timeout')) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Check if error is a client error (4xx)
+ */
+function isClientError(error) {
+    const statusCode = getHTTPStatusCode(error);
+    return statusCode >= 400 && statusCode < 500;
+}
+/**
+ * Check if error is a server error (5xx)
+ */
+function isServerError(error) {
+    const statusCode = getHTTPStatusCode(error);
+    return statusCode >= 500;
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/cjs/error-handler.js.map

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