ai.matey.http.core 0.2.0

package/dist/types/handler.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Core HTTP Handler
+ *
+ * Framework-agnostic HTTP request handler that can be adapted to any framework.
+ * Contains all the core logic for CORS, auth, rate limiting, routing, and streaming.
+ *
+ * @module
+ */
+import type { GenericRequest, GenericResponse, CoreHandlerOptions } from './types.js';
+/**
+ * Core HTTP request handler (framework-agnostic)
+ */
+export declare class CoreHTTPHandler {
+    private readonly bridge;
+    private readonly options;
+    private readonly rateLimiter;
+    private readonly routeMatcher;
+    constructor(options: CoreHandlerOptions);
+    /**
+     * Dispose of the handler and release resources.
+     * Call this when the handler is no longer needed to prevent memory leaks.
+     */
+    dispose(): void;
+    /**
+     * Handle HTTP request
+     */
+    handle(req: GenericRequest, res: GenericResponse): Promise<void>;
+    /**
+     * Handle errors
+     */
+    private handleError;
+    /**
+     * Check if origin is allowed
+     */
+    private isOriginAllowed;
+    /**
+     * Get HTTP status code from error
+     */
+    private getErrorStatusCode;
+    /**
+     * Format error response in provider-specific format
+     */
+    private formatErrorResponse;
+}
+//# sourceMappingURL=handler.d.ts.map

package/dist/types/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AAMpB;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAQtB;IACF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;gBAEvC,OAAO,EAAE,kBAAkB;IAsCvC;;;OAGG;IACH,OAAO,IAAI,IAAI;IAMf;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAmNtE;;OAEG;YACW,WAAW;IAuBzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAuBvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgC1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;CA+B5B"}

package/dist/types/health.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Health Check Utilities
+ *
+ * Health check endpoint for monitoring and load balancers.
+ *
+ * @module
+ */
+import type { GenericRequest, GenericResponse } from './types.js';
+import type { Bridge, Router } from 'ai.matey.core';
+/**
+ * Health status levels
+ */
+export type HealthStatus = 'healthy' | 'degraded' | 'unhealthy';
+/**
+ * Health check result
+ */
+export interface HealthCheckResult {
+    /**
+     * Overall health status
+     */
+    status: HealthStatus;
+    /**
+     * Timestamp of health check
+     */
+    timestamp: string;
+    /**
+     * Service name/version
+     */
+    service?: string;
+    version?: string;
+    /**
+     * Uptime in milliseconds
+     */
+    uptime?: number;
+    /**
+     * Component-specific checks
+     */
+    checks?: Record<string, ComponentHealth>;
+    /**
+     * Additional metadata
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Component health status
+ */
+export interface ComponentHealth {
+    status: HealthStatus;
+    message?: string;
+    latency?: number;
+    details?: Record<string, unknown>;
+}
+/**
+ * Health check configuration
+ */
+export interface HealthCheckConfig {
+    /**
+     * Service name
+     * @default 'ai.matey'
+     */
+    serviceName?: string;
+    /**
+     * Service version
+     * @default '1.0.0'
+     */
+    version?: string;
+    /**
+     * Include uptime in response
+     * @default true
+     */
+    includeUptime?: boolean;
+    /**
+     * Include component checks
+     * @default true
+     */
+    includeChecks?: boolean;
+    /**
+     * Custom health checks
+     */
+    customChecks?: Record<string, () => Promise<ComponentHealth>>;
+    /**
+     * Check backend health (for routers)
+     * @default true
+     */
+    checkBackends?: boolean;
+    /**
+     * Additional metadata to include
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Health check handler
+ */
+export declare class HealthCheck {
+    private config;
+    private customChecks;
+    private metadata;
+    private startTime;
+    private router?;
+    constructor(bridgeOrRouter: Bridge | Router, config?: HealthCheckConfig);
+    /**
+     * Perform health check
+     */
+    check(): Promise<HealthCheckResult>;
+    /**
+     * Handle health check request
+     */
+    handle(_req: GenericRequest, res: GenericResponse): Promise<void>;
+}
+/**
+ * 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 declare function createHealthCheck(bridgeOrRouter: Bridge | Router, config?: HealthCheckConfig): HealthCheck;
+/**
+ * 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 declare function createHealthCheckMiddleware(bridgeOrRouter: Bridge | Router, path?: string, config?: HealthCheckConfig): (req: GenericRequest, res: GenericResponse) => Promise<boolean>;
+/**
+ * Readiness check (for Kubernetes)
+ *
+ * Returns 200 when service is ready to accept traffic.
+ */
+export declare function createReadinessCheck(bridgeOrRouter: Bridge | Router): (req: GenericRequest, res: GenericResponse) => Promise<void>;
+/**
+ * Liveness check (for Kubernetes)
+ *
+ * Returns 200 if service is alive (even if degraded).
+ */
+export declare function createLivenessCheck(): (req: GenericRequest, res: GenericResponse) => void;
+//# sourceMappingURL=health.d.ts.map

package/dist/types/health.d.ts.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 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
+ */
+export { CoreHTTPHandler } from './handler.js';
+export type { HTTPRequestHandler, HTTPListenerOptions, CORSOptions, RateLimitOptions, RouteConfig, AuthValidator, ErrorHandler, RateLimitKeyGenerator, RateLimitHandler, ParsedRequest, RateLimitState, MatchedRoute, GenericRequest, GenericResponse, GenericAuthValidator, GenericErrorHandler, GenericRateLimitKeyGenerator, GenericRateLimitHandler, GenericRateLimitOptions, CoreHandlerOptions, ParsedGenericRequest, } from './types.js';
+export { parseRequest, extractBearerToken, getClientIP } from './request-parser.js';
+export { sendJSON, sendError, sendSSEHeaders, sendSSEChunk, sendSSEEvent, sendSSEDone, sendSSEError, sendText, sendNoContent, detectProviderFormat, } from './response-formatter.js';
+export { normalizeCORSOptions, handleCORS, handlePreflight, isPreflight } from './cors.js';
+export { defaultAuthValidator, createBearerTokenValidator, createAPIKeyValidator, createBasicAuthValidator, combineAuthValidators, requireAllAuth, skipAuthForPaths, } from './auth.js';
+export { RateLimiter, userIDKeyGenerator, tokenKeyGenerator, combineKeyGenerators, } from './rate-limiter.js';
+export { defaultErrorHandler, createLoggingErrorHandler, createReportingErrorHandler, wrapErrorHandler, isRetryableError, isClientError, isServerError, } from './error-handler.js';
+export { handleStreamingRequest, SSEKeepAlive, onClientDisconnect, supportsStreaming, createAbortController, } from './streaming-handler.js';
+export { RouteMatcher, createDefaultRoutes, normalizePath, applyPathPrefix, } from './route-matcher.js';
+export { HealthCheck, createHealthCheck, createHealthCheckMiddleware, createReadinessCheck, createLivenessCheck, type HealthCheckConfig, type HealthCheckResult, type HealthStatus, type ComponentHealth, } from './health.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,4BAA4B,EAC5B,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGpF,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;AAGjC,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG3F,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,2BAA2B,EAC3B,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC"}

package/dist/types/rate-limiter.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Rate Limiter
+ *
+ * Implements rate limiting for HTTP requests using a sliding window algorithm.
+ *
+ * @module
+ */
+import type { IncomingMessage, ServerResponse } from 'http';
+import type { RateLimitOptions, RateLimitState } from './types.js';
+/**
+ * Rate limiter class
+ */
+export declare class RateLimiter {
+    private readonly options;
+    private readonly store;
+    private cleanupIntervalId;
+    constructor(options: RateLimitOptions);
+    /**
+     * Dispose of the rate limiter and clean up resources.
+     * Call this when the rate limiter is no longer needed to prevent memory leaks.
+     */
+    dispose(): void;
+    /**
+     * Check if request should be rate limited
+     */
+    check(req: IncomingMessage, res: ServerResponse): Promise<boolean>;
+    /**
+     * Clean up expired entries
+     */
+    private cleanup;
+    /**
+     * Reset rate limit for a specific key
+     */
+    reset(key: string): void;
+    /**
+     * Reset all rate limits
+     */
+    resetAll(): void;
+    /**
+     * Get current state for a key
+     */
+    getState(key: string): RateLimitState | undefined;
+}
+/**
+ * Create key generator from user ID in request body
+ */
+export declare function userIDKeyGenerator(req: IncomingMessage): string;
+/**
+ * Create key generator from authorization token
+ */
+export declare function tokenKeyGenerator(req: IncomingMessage): string;
+/**
+ * Create key generator that combines multiple factors
+ */
+export declare function combineKeyGenerators(...generators: ((req: IncomingMessage) => string)[]): (req: IncomingMessage) => string;
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/types/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAInE;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IACpD,OAAO,CAAC,iBAAiB,CAA6C;gBAE1D,OAAO,EAAE,gBAAgB;IAgBrC;;;OAGG;IACH,OAAO,IAAI,IAAI;IAQf;;OAEG;IACG,KAAK,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAgDxE;;OAEG;IACH,OAAO,CAAC,OAAO;IAUf;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIxB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAIhB;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;CAGlD;AA8BD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAI/D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAQ9D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,UAAU,EAAE,CAAC,CAAC,GAAG,EAAE,eAAe,KAAK,MAAM,CAAC,EAAE,GAClD,CAAC,GAAG,EAAE,eAAe,KAAK,MAAM,CAKlC"}

package/dist/types/request-parser.d.ts

@@ -0,0 +1,22 @@
+/**
+ * HTTP Request Parser
+ *
+ * Parses incoming HTTP requests into a standardized format for processing.
+ *
+ * @module
+ */
+import type { IncomingMessage } from 'http';
+import type { ParsedRequest } from './types.js';
+/**
+ * Parse incoming HTTP request
+ */
+export declare function parseRequest(req: IncomingMessage, maxBodySize?: number): Promise<ParsedRequest>;
+/**
+ * Extract bearer token from Authorization header
+ */
+export declare function extractBearerToken(req: IncomingMessage): string | null;
+/**
+ * Get client IP address from request
+ */
+export declare function getClientIP(req: IncomingMessage): string;
+//# sourceMappingURL=request-parser.d.ts.map

package/dist/types/request-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-parser.d.ts","sourceRoot":"","sources":["../../src/request-parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;GAEG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,eAAe,EACpB,WAAW,GAAE,MAAyB,GACrC,OAAO,CAAC,aAAa,CAAC,CA8DxB;AAgDD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAStE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAexD"}

package/dist/types/response-formatter.d.ts

@@ -0,0 +1,49 @@
+/**
+ * HTTP Response Formatter
+ *
+ * Formats responses for HTTP responses with proper headers and status codes.
+ *
+ * @module
+ */
+import type { ServerResponse } from 'http';
+/**
+ * Send JSON response
+ */
+export declare function sendJSON(res: ServerResponse, data: any, statusCode?: number, headers?: Record<string, string>): void;
+/**
+ * Send error response
+ */
+export declare function sendError(res: ServerResponse, error: Error, statusCode?: number, format?: 'openai' | 'anthropic' | 'generic'): void;
+/**
+ * Send Server-Sent Events (SSE) headers
+ */
+export declare function sendSSEHeaders(res: ServerResponse, headers?: Record<string, string>): void;
+/**
+ * Send SSE data chunk
+ */
+export declare function sendSSEChunk(res: ServerResponse, data: any): void;
+/**
+ * Send SSE event with custom event type
+ */
+export declare function sendSSEEvent(res: ServerResponse, event: string, data: any): void;
+/**
+ * Send SSE done marker
+ */
+export declare function sendSSEDone(res: ServerResponse): void;
+/**
+ * Send SSE error
+ */
+export declare function sendSSEError(res: ServerResponse, error: Error, format?: 'openai' | 'anthropic' | 'generic'): void;
+/**
+ * Send plain text response
+ */
+export declare function sendText(res: ServerResponse, text: string, statusCode?: number, headers?: Record<string, string>): void;
+/**
+ * Send 204 No Content response
+ */
+export declare function sendNoContent(res: ServerResponse): void;
+/**
+ * Detect provider format from request path or headers
+ */
+export declare function detectProviderFormat(path: string): 'openai' | 'anthropic' | 'generic';
+//# sourceMappingURL=response-formatter.d.ts.map

package/dist/types/response-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-formatter.d.ts","sourceRoot":"","sources":["../../src/response-formatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAE3C;;GAEG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,GAAG,EACT,UAAU,GAAE,MAAY,EACxB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACnC,IAAI,CAWN;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,KAAK,EACZ,UAAU,GAAE,MAAY,EACxB,MAAM,GAAE,QAAQ,GAAG,WAAW,GAAG,SAAqB,GACrD,IAAI,CAgBN;AAwFD;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,IAAI,CAa9F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI,CAGjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI,CAGhF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAGrD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,KAAK,EACZ,MAAM,GAAE,QAAQ,GAAG,WAAW,GAAG,SAAqB,GACrD,IAAI,CAiBN;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAY,EACxB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACnC,IAAI,CAUN;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAGvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAUrF"}

package/dist/types/route-matcher.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Route Matcher
+ *
+ * Matches incoming HTTP requests to configured routes.
+ *
+ * @module
+ */
+import type { IncomingMessage } from 'http';
+import type { RouteConfig, MatchedRoute } from './types.js';
+/**
+ * Route matcher class
+ */
+export declare class RouteMatcher {
+    private routes;
+    constructor(routes: RouteConfig[]);
+    /**
+     * Match request to a route
+     */
+    match(req: IncomingMessage): MatchedRoute | null;
+    /**
+     * Add a route
+     */
+    addRoute(route: RouteConfig): void;
+    /**
+     * Remove a route
+     */
+    removeRoute(path: string): boolean;
+    /**
+     * Get all routes
+     */
+    getRoutes(): readonly RouteConfig[];
+}
+/**
+ * Create default routes for common provider endpoints
+ */
+export declare function createDefaultRoutes(frontendAdapters: Map<string, any>): RouteConfig[];
+/**
+ * Normalize path by removing trailing slashes and adding leading slash
+ */
+export declare function normalizePath(path: string): string;
+/**
+ * Apply path prefix to route paths
+ */
+export declare function applyPathPrefix(routes: RouteConfig[], prefix: string): RouteConfig[];
+//# sourceMappingURL=route-matcher.d.ts.map

package/dist/types/route-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-matcher.d.ts","sourceRoot":"","sources":["../../src/route-matcher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE5D;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,WAAW,EAAE;IAIjC;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,eAAe,GAAG,YAAY,GAAG,IAAI;IAyBhD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAIlC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IASlC;;OAEG;IACH,SAAS,IAAI,SAAS,WAAW,EAAE;CAGpC;AAkFD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,WAAW,EAAE,CAsBrF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYlD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAOpF"}

package/dist/types/streaming-handler.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Streaming Handler
+ *
+ * Handles Server-Sent Events (SSE) streaming for HTTP responses.
+ *
+ * @module
+ */
+import type { ServerResponse } from 'http';
+import type { Bridge } from 'ai.matey.core';
+/**
+ * Handle streaming request
+ */
+export declare function handleStreamingRequest(bridge: Bridge, request: any, res: ServerResponse, format?: 'openai' | 'anthropic' | 'generic', headers?: Record<string, string>): Promise<void>;
+/**
+ * Create SSE keep-alive mechanism
+ */
+export declare class SSEKeepAlive {
+    private intervalId;
+    /**
+     * Start sending keep-alive pings
+     */
+    start(res: ServerResponse, intervalMs?: number): void;
+    /**
+     * Stop sending keep-alive pings
+     */
+    stop(): void;
+}
+/**
+ * Handle client disconnect
+ */
+export declare function onClientDisconnect(res: ServerResponse, callback: () => void): void;
+/**
+ * Check if response supports streaming
+ */
+export declare function supportsStreaming(res: ServerResponse): boolean;
+/**
+ * Create streaming abort controller from response
+ */
+export declare function createAbortController(res: ServerResponse): AbortController;
+//# sourceMappingURL=streaming-handler.d.ts.map

package/dist/types/streaming-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-handler.d.ts","sourceRoot":"","sources":["../../src/streaming-handler.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAS5C;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,GAAG,EACZ,GAAG,EAAE,cAAc,EACnB,MAAM,GAAE,QAAQ,GAAG,WAAW,GAAG,SAAqB,EACtD,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACnC,OAAO,CAAC,IAAI,CAAC,CAoCf;AAcD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAA+B;IAEjD;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,cAAc,EAAE,UAAU,GAAE,MAAc,GAAG,IAAI;IAU5D;;OAEG;IACH,IAAI,IAAI,IAAI;CAMb;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAIlF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAE9D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,cAAc,GAAG,eAAe,CAQ1E"}