ai.matey.http.core 0.2.0

package/dist/esm/health.js

@@ -0,0 +1,210 @@
+/**
+ * Health Check Utilities
+ *
+ * Health check endpoint for monitoring and load balancers.
+ *
+ * @module
+ */
+/**
+ * Health check handler
+ */
+export class HealthCheck {
+    config;
+    customChecks;
+    metadata;
+    startTime;
+    router;
+    constructor(bridgeOrRouter, config = {}) {
+        this.config = {
+            serviceName: 'ai.matey',
+            version: '1.0.0',
+            includeUptime: true,
+            includeChecks: true,
+            checkBackends: true,
+            ...config,
+        };
+        this.customChecks = config.customChecks || {};
+        this.metadata = config.metadata || {};
+        this.startTime = Date.now();
+        // Detect if bridge or router
+        if ('getBackends' in bridgeOrRouter) {
+            this.router = bridgeOrRouter;
+        }
+        // Bridge support can be added in the future
+    }
+    /**
+     * Perform health check
+     */
+    async check() {
+        const checks = {};
+        // Basic system check
+        if (this.config.includeChecks) {
+            checks.system = {
+                status: 'healthy',
+                message: 'System operational',
+            };
+            // Check backend health (router only)
+            if (this.router && this.config.checkBackends) {
+                try {
+                    // For now, assume healthy if router exists
+                    // In the future, we can add a getBackends() method to Router
+                    checks.backends = {
+                        status: 'healthy',
+                        message: 'Router operational',
+                    };
+                }
+                catch (error) {
+                    checks.backends = {
+                        status: 'unhealthy',
+                        message: 'Unable to check backends',
+                        details: { error: error.message },
+                    };
+                }
+            }
+            // Run custom checks
+            for (const [name, checkFn] of Object.entries(this.customChecks)) {
+                try {
+                    checks[name] = await checkFn();
+                }
+                catch (error) {
+                    checks[name] = {
+                        status: 'unhealthy',
+                        message: `Check failed: ${error.message}`,
+                    };
+                }
+            }
+        }
+        // Determine overall status
+        const statuses = Object.values(checks).map((c) => c.status);
+        let overallStatus = 'healthy';
+        if (statuses.includes('unhealthy')) {
+            overallStatus = 'unhealthy';
+        }
+        else if (statuses.includes('degraded')) {
+            overallStatus = 'degraded';
+        }
+        const result = {
+            status: overallStatus,
+            timestamp: new Date().toISOString(),
+            service: this.config.serviceName,
+            version: this.config.version,
+        };
+        if (this.config.includeUptime) {
+            result.uptime = Date.now() - this.startTime;
+        }
+        if (this.config.includeChecks && Object.keys(checks).length > 0) {
+            result.checks = checks;
+        }
+        if (Object.keys(this.metadata).length > 0) {
+            result.metadata = this.metadata;
+        }
+        return result;
+    }
+    /**
+     * Handle health check request
+     */
+    async handle(_req, res) {
+        const result = await this.check();
+        // Set status code based on health
+        const statusCode = result.status === 'healthy' ? 200 : result.status === 'degraded' ? 200 : 503;
+        res.status(statusCode);
+        res.header('Content-Type', 'application/json');
+        res.header('Cache-Control', 'no-cache, no-store, must-revalidate');
+        res.send(result);
+    }
+}
+/**
+ * Create health check handler
+ *
+ * @param bridgeOrRouter - Bridge or Router instance
+ * @param config - Health check configuration
+ * @returns Health check handler
+ *
+ * @example
+ * ```typescript
+ * import { createHealthCheck } from 'ai.matey.http';
+ *
+ * const healthCheck = createHealthCheck(bridge, {
+ *   serviceName: 'my-ai-service',
+ *   version: '1.0.0',
+ * });
+ *
+ * // In your HTTP server:
+ * if (req.url === '/health') {
+ *   await healthCheck.handle(req, res);
+ * }
+ * ```
+ */
+export function createHealthCheck(bridgeOrRouter, config) {
+    return new HealthCheck(bridgeOrRouter, config);
+}
+/**
+ * Create simple health check middleware
+ *
+ * @param bridgeOrRouter - Bridge or Router instance
+ * @param path - Health check path (default: '/health')
+ * @param config - Health check configuration
+ * @returns Middleware function
+ *
+ * @example
+ * ```typescript
+ * import { createHealthCheckMiddleware } from 'ai.matey.http';
+ *
+ * const healthMiddleware = createHealthCheckMiddleware(bridge);
+ *
+ * // Use in HTTP server
+ * app.use(healthMiddleware);
+ * ```
+ */
+export function createHealthCheckMiddleware(bridgeOrRouter, path = '/health', config) {
+    const healthCheck = new HealthCheck(bridgeOrRouter, config);
+    return async (req, res) => {
+        if (req.url === path || req.url?.startsWith(`${path}?`)) {
+            await healthCheck.handle(req, res);
+            return true; // Handled
+        }
+        return false; // Not handled
+    };
+}
+/**
+ * Readiness check (for Kubernetes)
+ *
+ * Returns 200 when service is ready to accept traffic.
+ */
+export function createReadinessCheck(bridgeOrRouter) {
+    const healthCheck = new HealthCheck(bridgeOrRouter, {
+        includeUptime: false,
+        includeChecks: true,
+        checkBackends: true,
+    });
+    return async (_req, res) => {
+        const result = await healthCheck.check();
+        // Only ready if all checks are healthy
+        const isReady = result.status === 'healthy';
+        res.status(isReady ? 200 : 503);
+        res.header('Content-Type', 'application/json');
+        res.send({
+            ready: isReady,
+            timestamp: result.timestamp,
+            checks: result.checks,
+        });
+    };
+}
+/**
+ * Liveness check (for Kubernetes)
+ *
+ * Returns 200 if service is alive (even if degraded).
+ */
+export function createLivenessCheck() {
+    const startTime = Date.now();
+    return (_req, res) => {
+        res.status(200);
+        res.header('Content-Type', 'application/json');
+        res.send({
+            alive: true,
+            timestamp: new Date().toISOString(),
+            uptime: Date.now() - startTime,
+        });
+    };
+}
+//# sourceMappingURL=health.js.map

package/dist/esm/health.js.map

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

package/dist/esm/index.js

@@ -0,0 +1,30 @@
+/**
+ * HTTP Core Module
+ *
+ * Framework-agnostic HTTP utilities for the Universal AI Adapter System.
+ * This package provides the core logic for HTTP request handling that can
+ * be adapted to any HTTP framework.
+ *
+ * @module
+ */
+// Core handler
+export { CoreHTTPHandler } from './handler.js';
+// Request parsing
+export { parseRequest, extractBearerToken, getClientIP } from './request-parser.js';
+// Response formatting
+export { sendJSON, sendError, sendSSEHeaders, sendSSEChunk, sendSSEEvent, sendSSEDone, sendSSEError, sendText, sendNoContent, detectProviderFormat, } from './response-formatter.js';
+// CORS
+export { normalizeCORSOptions, handleCORS, handlePreflight, isPreflight } from './cors.js';
+// Authentication
+export { defaultAuthValidator, createBearerTokenValidator, createAPIKeyValidator, createBasicAuthValidator, combineAuthValidators, requireAllAuth, skipAuthForPaths, } from './auth.js';
+// Rate limiting
+export { RateLimiter, userIDKeyGenerator, tokenKeyGenerator, combineKeyGenerators, } from './rate-limiter.js';
+// Error handling
+export { defaultErrorHandler, createLoggingErrorHandler, createReportingErrorHandler, wrapErrorHandler, isRetryableError, isClientError, isServerError, } from './error-handler.js';
+// Streaming
+export { handleStreamingRequest, SSEKeepAlive, onClientDisconnect, supportsStreaming, createAbortController, } from './streaming-handler.js';
+// Routing
+export { RouteMatcher, createDefaultRoutes, normalizePath, applyPathPrefix, } from './route-matcher.js';
+// Health checks
+export { HealthCheck, createHealthCheck, createHealthCheckMiddleware, createReadinessCheck, createLivenessCheck, } from './health.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAe;AACf,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AA2B/C,kBAAkB;AAClB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEpF,sBAAsB;AACtB,OAAO,EACL,QAAQ,EACR,SAAS,EACT,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAEjC,OAAO;AACP,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE3F,iBAAiB;AACjB,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,gBAAgB;AAChB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,iBAAiB;AACjB,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,YAAY;AACZ,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,UAAU;AACV,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,gBAAgB;AAChB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,2BAA2B,EAC3B,oBAAoB,EACpB,mBAAmB,GAKpB,MAAM,aAAa,CAAC"}

package/dist/esm/rate-limiter.js

@@ -0,0 +1,156 @@
+/**
+ * Rate Limiter
+ *
+ * Implements rate limiting for HTTP requests using a sliding window algorithm.
+ *
+ * @module
+ */
+import { getClientIP } from './request-parser.js';
+import { sendJSON } from './response-formatter.js';
+/**
+ * Rate limiter class
+ */
+export class RateLimiter {
+    options;
+    store;
+    cleanupIntervalId;
+    constructor(options) {
+        this.options = {
+            max: options.max,
+            windowMs: options.windowMs ?? 60000, // 1 minute default
+            keyGenerator: options.keyGenerator ?? defaultKeyGenerator,
+            handler: options.handler ?? defaultRateLimitHandler,
+            skip: options.skip ?? (() => false),
+            headers: options.headers ?? true,
+        };
+        this.store = new Map();
+        // Cleanup old entries periodically
+        this.cleanupIntervalId = setInterval(() => this.cleanup(), this.options.windowMs);
+    }
+    /**
+     * Dispose of the rate limiter and clean up resources.
+     * Call this when the rate limiter is no longer needed to prevent memory leaks.
+     */
+    dispose() {
+        if (this.cleanupIntervalId) {
+            clearInterval(this.cleanupIntervalId);
+            this.cleanupIntervalId = undefined;
+        }
+        this.store.clear();
+    }
+    /**
+     * Check if request should be rate limited
+     */
+    async check(req, res) {
+        // Check if rate limiting should be skipped
+        if (await this.options.skip(req)) {
+            return false;
+        }
+        const key = this.options.keyGenerator(req);
+        const now = Date.now();
+        // Get or create state for this key
+        let state = this.store.get(key);
+        if (!state || now >= state.resetTime) {
+            // Create new window
+            state = {
+                count: 0,
+                resetTime: now + this.options.windowMs,
+            };
+            this.store.set(key, state);
+        }
+        // Increment request count
+        state.count++;
+        // Add rate limit headers
+        if (this.options.headers) {
+            res.setHeader('X-RateLimit-Limit', String(this.options.max));
+            res.setHeader('X-RateLimit-Remaining', String(Math.max(0, this.options.max - state.count)));
+            res.setHeader('X-RateLimit-Reset', String(Math.ceil(state.resetTime / 1000)));
+        }
+        // Check if limit exceeded
+        if (state.count > this.options.max) {
+            const retryAfter = Math.ceil((state.resetTime - now) / 1000);
+            if (this.options.headers) {
+                res.setHeader('Retry-After', String(retryAfter));
+            }
+            // Call custom handler
+            await this.options.handler(req, res, retryAfter);
+            return true; // Rate limited
+        }
+        return false; // Not rate limited
+    }
+    /**
+     * Clean up expired entries
+     */
+    cleanup() {
+        const now = Date.now();
+        for (const [key, state] of this.store.entries()) {
+            if (now >= state.resetTime) {
+                this.store.delete(key);
+            }
+        }
+    }
+    /**
+     * Reset rate limit for a specific key
+     */
+    reset(key) {
+        this.store.delete(key);
+    }
+    /**
+     * Reset all rate limits
+     */
+    resetAll() {
+        this.store.clear();
+    }
+    /**
+     * Get current state for a key
+     */
+    getState(key) {
+        return this.store.get(key);
+    }
+}
+/**
+ * Default key generator (uses IP address)
+ */
+function defaultKeyGenerator(req) {
+    return getClientIP(req);
+}
+/**
+ * Default rate limit handler
+ */
+function defaultRateLimitHandler(_req, res, retryAfter) {
+    sendJSON(res, {
+        error: {
+            message: 'Too many requests, please try again later.',
+            type: 'rate_limit_exceeded',
+            retryAfter,
+        },
+    }, 429);
+}
+/**
+ * Create key generator from user ID in request body
+ */
+export function userIDKeyGenerator(req) {
+    // This would need to be called after body parsing
+    // For now, fall back to IP
+    return getClientIP(req);
+}
+/**
+ * Create key generator from authorization token
+ */
+export function tokenKeyGenerator(req) {
+    const auth = req.headers.authorization;
+    if (auth) {
+        return auth;
+    }
+    return getClientIP(req);
+}
+/**
+ * Create key generator that combines multiple factors
+ */
+export function combineKeyGenerators(...generators) {
+    return (req) => {
+        const parts = generators.map((gen) => gen(req));
+        return parts.join(':');
+    };
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/esm/rate-limiter.js.map

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

package/dist/esm/request-parser.js

@@ -0,0 +1,136 @@
+/**
+ * HTTP Request Parser
+ *
+ * Parses incoming HTTP requests into a standardized format for processing.
+ *
+ * @module
+ */
+/**
+ * Parse incoming HTTP request
+ */
+export async function parseRequest(req, maxBodySize = 10 * 1024 * 1024 // 10MB default
+) {
+    // Parse URL
+    const url = new URL(req.url || '/', `http://${req.headers.host || 'localhost'}`);
+    const path = url.pathname;
+    const method = req.method?.toUpperCase() || 'GET';
+    // Parse query parameters
+    const query = {};
+    url.searchParams.forEach((value, key) => {
+        query[key] = value;
+    });
+    // Normalize headers
+    const headers = {};
+    for (const [key, value] of Object.entries(req.headers)) {
+        if (typeof value === 'string') {
+            headers[key.toLowerCase()] = value;
+        }
+        else if (Array.isArray(value)) {
+            headers[key.toLowerCase()] = value[0] || '';
+        }
+    }
+    // Parse body (if present)
+    let body = null;
+    if (method === 'POST' || method === 'PUT' || method === 'PATCH') {
+        const rawBody = await readBody(req, maxBodySize);
+        if (rawBody) {
+            const contentType = headers['content-type'] || '';
+            if (contentType.includes('application/json')) {
+                try {
+                    body = JSON.parse(rawBody);
+                }
+                catch (error) {
+                    throw new Error(`Invalid JSON body: ${error instanceof Error ? error.message : String(error)}`);
+                }
+            }
+            else if (contentType.includes('application/x-www-form-urlencoded')) {
+                body = parseFormData(rawBody);
+            }
+            else {
+                // Unknown content type, try JSON anyway
+                try {
+                    body = JSON.parse(rawBody);
+                }
+                catch {
+                    body = rawBody;
+                }
+            }
+        }
+    }
+    // Detect streaming request
+    const stream = body?.stream === true || headers['accept'] === 'text/event-stream';
+    return {
+        body,
+        headers,
+        path,
+        method,
+        query,
+        stream,
+    };
+}
+/**
+ * Read request body as string
+ */
+function readBody(req, maxSize) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let totalSize = 0;
+        req.on('data', (chunk) => {
+            totalSize += chunk.length;
+            if (totalSize > maxSize) {
+                // Destroy the stream to stop receiving data and free resources
+                req.destroy();
+                reject(new Error(`Request body too large (max ${maxSize} bytes)`));
+                return;
+            }
+            chunks.push(chunk);
+        });
+        req.on('end', () => {
+            const body = Buffer.concat(chunks).toString('utf-8');
+            resolve(body);
+        });
+        req.on('error', (error) => {
+            reject(error);
+        });
+    });
+}
+/**
+ * Parse form-encoded data
+ */
+function parseFormData(data) {
+    const params = new URLSearchParams(data);
+    const result = {};
+    params.forEach((value, key) => {
+        result[key] = value;
+    });
+    return result;
+}
+/**
+ * Extract bearer token from Authorization header
+ */
+export function extractBearerToken(req) {
+    const auth = req.headers.authorization;
+    if (!auth) {
+        return null;
+    }
+    const match = auth.match(/^Bearer\s+(.+)$/i);
+    return match ? match[1] || null : null;
+}
+/**
+ * Get client IP address from request
+ */
+export function getClientIP(req) {
+    // Check common proxy headers
+    const forwarded = req.headers['x-forwarded-for'];
+    if (forwarded) {
+        const ips = typeof forwarded === 'string' ? forwarded.split(',') : forwarded;
+        return ips[0]?.trim() || 'unknown';
+    }
+    const realIP = req.headers['x-real-ip'];
+    if (realIP && typeof realIP === 'string') {
+        return realIP;
+    }
+    // Fallback to socket address
+    return req.socket.remoteAddress || 'unknown';
+}
+//# sourceMappingURL=request-parser.js.map

package/dist/esm/request-parser.js.map

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