ai.matey.http.core 0.2.0

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,eAAe;AACf,2CAA+C;AAAtC,6GAAA,eAAe,OAAA;AA2BxB,kBAAkB;AAClB,yDAAoF;AAA3E,iHAAA,YAAY,OAAA;AAAE,uHAAA,kBAAkB,OAAA;AAAE,gHAAA,WAAW,OAAA;AAEtD,sBAAsB;AACtB,iEAWiC;AAV/B,iHAAA,QAAQ,OAAA;AACR,kHAAA,SAAS,OAAA;AACT,uHAAA,cAAc,OAAA;AACd,qHAAA,YAAY,OAAA;AACZ,qHAAA,YAAY,OAAA;AACZ,oHAAA,WAAW,OAAA;AACX,qHAAA,YAAY,OAAA;AACZ,iHAAA,QAAQ,OAAA;AACR,sHAAA,aAAa,OAAA;AACb,6HAAA,oBAAoB,OAAA;AAGtB,OAAO;AACP,qCAA2F;AAAlF,+GAAA,oBAAoB,OAAA;AAAE,qGAAA,UAAU,OAAA;AAAE,0GAAA,eAAe,OAAA;AAAE,sGAAA,WAAW,OAAA;AAEvE,iBAAiB;AACjB,qCAQmB;AAPjB,+GAAA,oBAAoB,OAAA;AACpB,qHAAA,0BAA0B,OAAA;AAC1B,gHAAA,qBAAqB,OAAA;AACrB,mHAAA,wBAAwB,OAAA;AACxB,gHAAA,qBAAqB,OAAA;AACrB,yGAAA,cAAc,OAAA;AACd,2GAAA,gBAAgB,OAAA;AAGlB,gBAAgB;AAChB,qDAK2B;AAJzB,8GAAA,WAAW,OAAA;AACX,qHAAA,kBAAkB,OAAA;AAClB,oHAAA,iBAAiB,OAAA;AACjB,uHAAA,oBAAoB,OAAA;AAGtB,iBAAiB;AACjB,uDAQ4B;AAP1B,uHAAA,mBAAmB,OAAA;AACnB,6HAAA,yBAAyB,OAAA;AACzB,+HAAA,2BAA2B,OAAA;AAC3B,oHAAA,gBAAgB,OAAA;AAChB,oHAAA,gBAAgB,OAAA;AAChB,iHAAA,aAAa,OAAA;AACb,iHAAA,aAAa,OAAA;AAGf,YAAY;AACZ,+DAMgC;AAL9B,8HAAA,sBAAsB,OAAA;AACtB,oHAAA,YAAY,OAAA;AACZ,0HAAA,kBAAkB,OAAA;AAClB,yHAAA,iBAAiB,OAAA;AACjB,6HAAA,qBAAqB,OAAA;AAGvB,UAAU;AACV,uDAK4B;AAJ1B,gHAAA,YAAY,OAAA;AACZ,uHAAA,mBAAmB,OAAA;AACnB,iHAAA,aAAa,OAAA;AACb,mHAAA,eAAe,OAAA;AAGjB,gBAAgB;AAChB,yCAUqB;AATnB,wGAAA,WAAW,OAAA;AACX,8GAAA,iBAAiB,OAAA;AACjB,wHAAA,2BAA2B,OAAA;AAC3B,iHAAA,oBAAoB,OAAA;AACpB,gHAAA,mBAAmB,OAAA"}

package/dist/cjs/rate-limiter.js

@@ -0,0 +1,163 @@
+"use strict";
+/**
+ * Rate Limiter
+ *
+ * Implements rate limiting for HTTP requests using a sliding window algorithm.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimiter = void 0;
+exports.userIDKeyGenerator = userIDKeyGenerator;
+exports.tokenKeyGenerator = tokenKeyGenerator;
+exports.combineKeyGenerators = combineKeyGenerators;
+const request_parser_js_1 = require("./request-parser.js");
+const response_formatter_js_1 = require("./response-formatter.js");
+/**
+ * Rate limiter class
+ */
+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);
+    }
+}
+exports.RateLimiter = RateLimiter;
+/**
+ * Default key generator (uses IP address)
+ */
+function defaultKeyGenerator(req) {
+    return (0, request_parser_js_1.getClientIP)(req);
+}
+/**
+ * Default rate limit handler
+ */
+function defaultRateLimitHandler(_req, res, retryAfter) {
+    (0, response_formatter_js_1.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
+ */
+function userIDKeyGenerator(req) {
+    // This would need to be called after body parsing
+    // For now, fall back to IP
+    return (0, request_parser_js_1.getClientIP)(req);
+}
+/**
+ * Create key generator from authorization token
+ */
+function tokenKeyGenerator(req) {
+    const auth = req.headers.authorization;
+    if (auth) {
+        return auth;
+    }
+    return (0, request_parser_js_1.getClientIP)(req);
+}
+/**
+ * Create key generator that combines multiple factors
+ */
+function combineKeyGenerators(...generators) {
+    return (req) => {
+        const parts = generators.map((gen) => gen(req));
+        return parts.join(':');
+    };
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/cjs/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/cjs/request-parser.js

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * HTTP Request Parser
+ *
+ * Parses incoming HTTP requests into a standardized format for processing.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseRequest = parseRequest;
+exports.extractBearerToken = extractBearerToken;
+exports.getClientIP = getClientIP;
+/**
+ * Parse incoming HTTP request
+ */
+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
+ */
+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
+ */
+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/cjs/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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"}

package/dist/cjs/response-formatter.js

@@ -0,0 +1,218 @@
+"use strict";
+/**
+ * HTTP Response Formatter
+ *
+ * Formats responses for HTTP responses with proper headers and status codes.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendJSON = sendJSON;
+exports.sendError = sendError;
+exports.sendSSEHeaders = sendSSEHeaders;
+exports.sendSSEChunk = sendSSEChunk;
+exports.sendSSEEvent = sendSSEEvent;
+exports.sendSSEDone = sendSSEDone;
+exports.sendSSEError = sendSSEError;
+exports.sendText = sendText;
+exports.sendNoContent = sendNoContent;
+exports.detectProviderFormat = detectProviderFormat;
+/**
+ * Send JSON response
+ */
+function sendJSON(res, data, statusCode = 200, headers = {}) {
+    res.statusCode = statusCode;
+    res.setHeader('Content-Type', 'application/json');
+    // Set custom headers
+    for (const [key, value] of Object.entries(headers)) {
+        res.setHeader(key, value);
+    }
+    const body = JSON.stringify(data);
+    res.end(body);
+}
+/**
+ * Send error response
+ */
+function sendError(res, error, statusCode = 500, format = 'generic') {
+    let errorBody;
+    switch (format) {
+        case 'openai':
+            errorBody = formatOpenAIError(error, statusCode);
+            break;
+        case 'anthropic':
+            errorBody = formatAnthropicError(error, statusCode);
+            break;
+        default:
+            errorBody = formatGenericError(error, statusCode);
+            break;
+    }
+    sendJSON(res, errorBody, statusCode);
+}
+/**
+ * Format error in OpenAI style
+ */
+function formatOpenAIError(error, statusCode) {
+    return {
+        error: {
+            message: error.message,
+            type: getOpenAIErrorType(statusCode),
+            code: statusCode === 429 ? 'rate_limit_exceeded' : null,
+        },
+    };
+}
+/**
+ * Format error in Anthropic style
+ */
+function formatAnthropicError(error, statusCode) {
+    return {
+        type: 'error',
+        error: {
+            type: getAnthropicErrorType(statusCode),
+            message: error.message,
+        },
+    };
+}
+/**
+ * Format error in generic style
+ */
+function formatGenericError(error, statusCode) {
+    return {
+        error: {
+            message: error.message,
+            status: statusCode,
+        },
+    };
+}
+/**
+ * Get OpenAI error type from status code
+ */
+function getOpenAIErrorType(statusCode) {
+    switch (statusCode) {
+        case 400:
+            return 'invalid_request_error';
+        case 401:
+            return 'authentication_error';
+        case 403:
+            return 'permission_error';
+        case 404:
+            return 'not_found_error';
+        case 429:
+            return 'rate_limit_error';
+        case 500:
+            return 'server_error';
+        case 503:
+            return 'service_unavailable_error';
+        default:
+            return 'api_error';
+    }
+}
+/**
+ * Get Anthropic error type from status code
+ */
+function getAnthropicErrorType(statusCode) {
+    switch (statusCode) {
+        case 400:
+            return 'invalid_request_error';
+        case 401:
+            return 'authentication_error';
+        case 403:
+            return 'permission_error';
+        case 404:
+            return 'not_found_error';
+        case 429:
+            return 'rate_limit_error';
+        case 500:
+            return 'api_error';
+        case 529:
+            return 'overloaded_error';
+        default:
+            return 'api_error';
+    }
+}
+/**
+ * Send Server-Sent Events (SSE) headers
+ */
+function sendSSEHeaders(res, headers = {}) {
+    res.statusCode = 200;
+    res.setHeader('Content-Type', 'text/event-stream');
+    res.setHeader('Cache-Control', 'no-cache');
+    res.setHeader('Connection', 'keep-alive');
+    // Set custom headers
+    for (const [key, value] of Object.entries(headers)) {
+        res.setHeader(key, value);
+    }
+    // Write headers (flushes them to client)
+    res.flushHeaders?.();
+}
+/**
+ * Send SSE data chunk
+ */
+function sendSSEChunk(res, data) {
+    const json = JSON.stringify(data);
+    res.write(`data: ${json}\n\n`);
+}
+/**
+ * Send SSE event with custom event type
+ */
+function sendSSEEvent(res, event, data) {
+    const json = JSON.stringify(data);
+    res.write(`event: ${event}\ndata: ${json}\n\n`);
+}
+/**
+ * Send SSE done marker
+ */
+function sendSSEDone(res) {
+    res.write('data: [DONE]\n\n');
+    res.end();
+}
+/**
+ * Send SSE error
+ */
+function sendSSEError(res, error, format = 'generic') {
+    let errorData;
+    switch (format) {
+        case 'openai':
+            errorData = formatOpenAIError(error, 500);
+            break;
+        case 'anthropic':
+            errorData = formatAnthropicError(error, 500);
+            break;
+        default:
+            errorData = formatGenericError(error, 500);
+            break;
+    }
+    sendSSEChunk(res, errorData);
+    res.end();
+}
+/**
+ * Send plain text response
+ */
+function sendText(res, text, statusCode = 200, headers = {}) {
+    res.statusCode = statusCode;
+    res.setHeader('Content-Type', 'text/plain');
+    // Set custom headers
+    for (const [key, value] of Object.entries(headers)) {
+        res.setHeader(key, value);
+    }
+    res.end(text);
+}
+/**
+ * Send 204 No Content response
+ */
+function sendNoContent(res) {
+    res.statusCode = 204;
+    res.end();
+}
+/**
+ * Detect provider format from request path or headers
+ */
+function detectProviderFormat(path) {
+    if (path.includes('/chat/completions')) {
+        return 'openai';
+    }
+    if (path.includes('/messages')) {
+        return 'anthropic';
+    }
+    return 'generic';
+}
+//# sourceMappingURL=response-formatter.js.map

package/dist/cjs/response-formatter.js.map

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