ai.matey.http 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/deno/adapter.js

@@ -0,0 +1,173 @@
+"use strict";
+/**
+ * Deno HTTP Adapter
+ *
+ * Converts Deno Request/Response to GenericRequest/GenericResponse
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DenoResponseAdapter = exports.DenoRequestAdapter = void 0;
+/**
+ * Adapter that converts Deno Request to GenericRequest
+ */
+class DenoRequestAdapter {
+    request;
+    connInfo;
+    _body = null;
+    constructor(request, connInfo) {
+        this.request = request;
+        this.connInfo = connInfo;
+    }
+    get method() {
+        return this.request.method || 'GET';
+    }
+    get url() {
+        return this.request.url || '/';
+    }
+    get headers() {
+        const headers = {};
+        this.request.headers.forEach((value, key) => {
+            headers[key.toLowerCase()] = value;
+        });
+        return headers;
+    }
+    get body() {
+        // Return parsed body (must be set externally via setBody)
+        return this._body;
+    }
+    get params() {
+        // Params would need to be provided by routing layer
+        return undefined;
+    }
+    get query() {
+        // Parse query string from URL
+        const url = new URL(this.request.url);
+        const query = {};
+        url.searchParams.forEach((value, key) => {
+            query[key] = value;
+        });
+        return Object.keys(query).length > 0 ? query : undefined;
+    }
+    get ip() {
+        // Try to get IP from connection info or headers
+        if (this.connInfo?.remoteAddr?.hostname) {
+            return this.connInfo.remoteAddr.hostname;
+        }
+        const forwarded = this.request.headers.get('x-forwarded-for');
+        if (forwarded) {
+            return forwarded.split(',')[0]?.trim();
+        }
+        const realIp = this.request.headers.get('x-real-ip');
+        if (realIp) {
+            return realIp;
+        }
+        return undefined;
+    }
+    /**
+     * Set the parsed body (must be called before passing to handler)
+     */
+    setBody(body) {
+        this._body = body;
+    }
+    /**
+     * Get the underlying Deno request object
+     */
+    get raw() {
+        return this.request;
+    }
+}
+exports.DenoRequestAdapter = DenoRequestAdapter;
+/**
+ * Adapter that converts GenericResponse methods to Deno Response
+ */
+class DenoResponseAdapter {
+    _statusCode = 200;
+    _headers = new Headers();
+    _sent = false;
+    _response = null;
+    constructor() { }
+    status(code) {
+        if (!this._sent) {
+            this._statusCode = code;
+        }
+    }
+    header(name, value) {
+        if (!this._sent) {
+            this._headers.set(name, value);
+        }
+    }
+    send(data) {
+        if (this._sent) {
+            return;
+        }
+        this._sent = true;
+        // Clone headers to ensure they're properly set
+        const headers = new Headers(this._headers);
+        // Handle empty string (e.g., for CORS preflight 204 responses)
+        if (data === '') {
+            // 204 No Content responses cannot have a body (not even empty string)
+            // Use null for 204, empty string for other status codes
+            this._response = new Response(this._statusCode === 204 ? null : '', {
+                status: this._statusCode,
+                headers,
+            });
+            return;
+        }
+        // Create JSON response
+        headers.set('Content-Type', 'application/json');
+        this._response = new Response(JSON.stringify(data), {
+            status: this._statusCode,
+            headers,
+        });
+    }
+    stream(generator) {
+        if (this._sent) {
+            return Promise.resolve();
+        }
+        this._sent = true;
+        // Create SSE stream
+        const stream = new ReadableStream({
+            async start(controller) {
+                try {
+                    for await (const chunk of generator) {
+                        const data = `data: ${JSON.stringify(chunk)}\n\n`;
+                        controller.enqueue(new TextEncoder().encode(data));
+                    }
+                    // Send done marker
+                    const done = 'data: [DONE]\n\n';
+                    controller.enqueue(new TextEncoder().encode(done));
+                    controller.close();
+                }
+                catch (error) {
+                    console.error('Streaming error:', error);
+                    controller.error(error);
+                }
+            },
+        });
+        // Set SSE headers
+        this._headers.set('Content-Type', 'text/event-stream');
+        this._headers.set('Cache-Control', 'no-cache');
+        this._headers.set('Connection', 'keep-alive');
+        this._response = new Response(stream, {
+            status: this._statusCode,
+            headers: this._headers,
+        });
+        return Promise.resolve();
+    }
+    isWritable() {
+        return !this._sent;
+    }
+    /**
+     * Get the generated Response object
+     */
+    getResponse() {
+        if (!this._response) {
+            // If no response was generated, create an error response
+            return new Response('Internal Server Error', { status: 500 });
+        }
+        return this._response;
+    }
+}
+exports.DenoResponseAdapter = DenoResponseAdapter;
+//# sourceMappingURL=adapter.js.map

package/dist/cjs/deno/adapter.js.map

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

package/dist/cjs/deno/handler.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * Deno Handler
+ *
+ * HTTP request handler for Deno that uses the core handler.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DenoHandler = DenoHandler;
+const ai_matey_http_core_1 = require("ai.matey.http.core");
+const adapter_js_1 = require("./adapter.js");
+/**
+ * Create Deno HTTP handler for handling AI chat requests
+ *
+ * @param bridge - Bridge instance
+ * @param options - HTTP listener options
+ * @returns Deno HTTP handler function
+ *
+ * @example
+ * ```typescript
+ * import { DenoHandler } from 'ai.matey.http/deno';
+ *
+ * const bridge = new Bridge(frontend, backend);
+ *
+ * // Create handler
+ * const handler = DenoHandler(bridge, {
+ *   cors: true,
+ *   streaming: true,
+ * });
+ *
+ * // Use with Deno.serve
+ * Deno.serve({ port: 3000 }, handler);
+ * ```
+ */
+function DenoHandler(bridge, options = {}) {
+    // Create core handler with all business logic
+    const { cors, ...restOptions } = options;
+    const coreHandler = new ai_matey_http_core_1.CoreHTTPHandler({
+        bridge,
+        cors: cors === false || cors === undefined ? undefined : cors === true ? {} : cors,
+        ...restOptions, // HTTPListenerOptions types are compatible with CoreHandlerOptions at runtime
+    });
+    // Return Deno HTTP handler
+    return async (request, connInfo) => {
+        try {
+            // Parse JSON body if present (but not for OPTIONS requests)
+            const contentType = request.headers.get('content-type') || '';
+            const method = request.method;
+            let body = null;
+            if (method !== 'OPTIONS' && contentType.includes('application/json')) {
+                try {
+                    body = await request.json();
+                }
+                catch {
+                    // If JSON parsing fails, leave body as null
+                }
+            }
+            // Create adapters
+            const genericReq = new adapter_js_1.DenoRequestAdapter(request, connInfo);
+            genericReq.setBody(body);
+            const genericRes = new adapter_js_1.DenoResponseAdapter();
+            // Handle request through core handler
+            await coreHandler.handle(genericReq, genericRes);
+            // Return the response generated by the adapter
+            return genericRes.getResponse();
+        }
+        catch (error) {
+            // Return error response
+            console.error('Deno handler error:', error);
+            return new Response(JSON.stringify({ error: 'Internal Server Error' }), {
+                status: 500,
+                headers: { 'Content-Type': 'application/json' },
+            });
+        }
+    };
+}
+//# sourceMappingURL=handler.js.map

package/dist/cjs/deno/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../src/deno/handler.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AA8BH,kCAoDC;AA9ED,2DAAqD;AACrD,6CAAuE;AAEvE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAgB,WAAW,CACzB,MAAc,EACd,UAA+B,EAAE;IAEjC,8CAA8C;IAC9C,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC;IAEzC,MAAM,WAAW,GAAG,IAAI,oCAAe,CAAC;QACtC,MAAM;QACN,IAAI,EAAE,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;QAClF,GAAI,WAAmB,EAAE,8EAA8E;KACxG,CAAC,CAAC;IAEH,2BAA2B;IAC3B,OAAO,KAAK,EACV,OAAgB,EAChB,QAAiD,EAC9B,EAAE;QACrB,IAAI,CAAC;YACH,4DAA4D;YAC5D,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;YAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAC9B,IAAI,IAAI,GAAG,IAAI,CAAC;YAEhB,IAAI,MAAM,KAAK,SAAS,IAAI,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBACrE,IAAI,CAAC;oBACH,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;gBAC9B,CAAC;gBAAC,MAAM,CAAC;oBACP,4CAA4C;gBAC9C,CAAC;YACH,CAAC;YAED,kBAAkB;YAClB,MAAM,UAAU,GAAG,IAAI,+BAAkB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC7D,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAEzB,MAAM,UAAU,GAAG,IAAI,gCAAmB,EAAE,CAAC;YAE7C,sCAAsC;YACtC,MAAM,WAAW,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YAEjD,+CAA+C;YAC/C,OAAO,UAAU,CAAC,WAAW,EAAE,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,wBAAwB;YACxB,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;YAC5C,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,EAAE;gBACtE,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;aAChD,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/cjs/deno/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Deno HTTP Adapter
+ *
+ * HTTP adapter for Deno
+ *
+ * @module
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./adapter.js"), exports);
+__exportStar(require("./handler.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/deno/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/deno/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;AAEH,+CAA6B;AAC7B,+CAA6B"}

package/dist/cjs/express/adapter.js

@@ -0,0 +1,150 @@
+"use strict";
+/**
+ * Express HTTP Adapter
+ *
+ * Converts Express Request/Response to GenericRequest/GenericResponse
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExpressResponseAdapter = exports.ExpressRequestAdapter = void 0;
+const ai_matey_http_core_1 = require("ai.matey.http.core");
+/**
+ * Adapter that converts Express Request to GenericRequest
+ */
+class ExpressRequestAdapter {
+    req;
+    constructor(req) {
+        this.req = req;
+    }
+    get method() {
+        return this.req.method || 'GET';
+    }
+    get url() {
+        return this.req.originalUrl || this.req.url || '/';
+    }
+    get headers() {
+        const headers = {};
+        for (const [key, value] of Object.entries(this.req.headers)) {
+            if (typeof value === 'string') {
+                headers[key.toLowerCase()] = value;
+            }
+            else if (Array.isArray(value)) {
+                headers[key.toLowerCase()] = value.join(', ');
+            }
+        }
+        return headers;
+    }
+    get body() {
+        // Express body is already parsed if body-parser middleware is used
+        return this.req.body ?? null;
+    }
+    get params() {
+        return this.req.params;
+    }
+    get query() {
+        // Express query can have arrays, so we need to stringify them
+        const query = {};
+        for (const [key, value] of Object.entries(this.req.query)) {
+            if (typeof value === 'string') {
+                query[key] = value;
+            }
+            else if (Array.isArray(value)) {
+                const primitives = value.filter((v) => typeof v === 'string' || typeof v === 'number' || typeof v === 'boolean');
+                query[key] = primitives.map((v) => v.toString()).join(',');
+            }
+            else if (value !== undefined && typeof value !== 'object') {
+                query[key] = String(value);
+            }
+        }
+        return Object.keys(query).length > 0 ? query : undefined;
+    }
+    get ip() {
+        // Express provides multiple IP sources
+        return this.req.ip || this.req.socket?.remoteAddress;
+    }
+    /**
+     * Get the underlying Express request object
+     */
+    get raw() {
+        return this.req;
+    }
+}
+exports.ExpressRequestAdapter = ExpressRequestAdapter;
+/**
+ * Adapter that converts GenericResponse methods to Express Response
+ */
+class ExpressResponseAdapter {
+    res;
+    _statusCode = 200;
+    _headersSent = false;
+    constructor(res) {
+        this.res = res;
+    }
+    status(code) {
+        this._statusCode = code;
+        if (!this._headersSent) {
+            this.res.status(code);
+        }
+    }
+    header(name, value) {
+        if (!this._headersSent) {
+            this.res.setHeader(name, value);
+        }
+    }
+    send(data) {
+        if (!this.isWritable()) {
+            return;
+        }
+        this._headersSent = true;
+        // Handle empty string (e.g., for CORS preflight 204 responses)
+        if (data === '') {
+            this.res.end();
+            return;
+        }
+        // Express has a built-in json() method
+        this.res.status(this._statusCode).json(data);
+    }
+    async stream(generator) {
+        if (!this.isWritable()) {
+            return;
+        }
+        this._headersSent = true;
+        // Get the underlying Node.js response for SSE
+        const nodeRes = this.res;
+        // Set SSE headers
+        (0, ai_matey_http_core_1.sendSSEHeaders)(nodeRes, {});
+        try {
+            // Stream chunks
+            for await (const chunk of generator) {
+                if (!this.isWritable()) {
+                    break;
+                }
+                (0, ai_matey_http_core_1.sendSSEChunk)(nodeRes, chunk);
+            }
+            // Send done marker
+            if (this.isWritable()) {
+                (0, ai_matey_http_core_1.sendSSEDone)(nodeRes);
+            }
+        }
+        catch (error) {
+            // If error occurs during streaming, we can't change status code
+            // Just log and close
+            console.error('Streaming error:', error);
+            if (this.isWritable()) {
+                nodeRes.end();
+            }
+        }
+    }
+    isWritable() {
+        return !this.res.headersSent && this.res.writable;
+    }
+    /**
+     * Get the underlying Express response object
+     */
+    get raw() {
+        return this.res;
+    }
+}
+exports.ExpressResponseAdapter = ExpressResponseAdapter;
+//# sourceMappingURL=adapter.js.map

package/dist/cjs/express/adapter.js.map

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

package/dist/cjs/express/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Express HTTP Adapter
+ *
+ * HTTP adapter for Express.js
+ *
+ * @module
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./adapter.js"), exports);
+__exportStar(require("./middleware.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/express/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/express/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;AAEH,+CAA6B;AAC7B,kDAAgC"}

package/dist/cjs/express/middleware.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * Express Middleware
+ *
+ * HTTP request middleware for Express that uses the core handler.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExpressMiddleware = ExpressMiddleware;
+const ai_matey_http_core_1 = require("ai.matey.http.core");
+const adapter_js_1 = require("./adapter.js");
+/**
+ * Create Express middleware for handling AI chat requests
+ *
+ * @param bridge - Bridge instance
+ * @param options - HTTP listener options
+ * @returns Express middleware function
+ *
+ * @example
+ * ```typescript
+ * import express from 'express';
+ * import { ExpressMiddleware } from 'ai.matey.http/express';
+ *
+ * const app = express();
+ * const bridge = new Bridge(frontend, backend);
+ *
+ * // Use body parser middleware first
+ * app.use(express.json());
+ *
+ * // Add AI chat middleware
+ * app.use('/v1/messages', ExpressMiddleware(bridge, {
+ *   cors: true,
+ *   streaming: true,
+ * }));
+ *
+ * app.listen(3000);
+ * ```
+ */
+function ExpressMiddleware(bridge, options = {}) {
+    // Create core handler with all business logic
+    const { cors, ...restOptions } = options;
+    const coreHandler = new ai_matey_http_core_1.CoreHTTPHandler({
+        bridge,
+        cors: cors === false || cors === undefined ? undefined : cors === true ? {} : cors,
+        ...restOptions, // HTTPListenerOptions types are compatible with CoreHandlerOptions at runtime
+    });
+    // Return Express middleware
+    return async (req, res, next) => {
+        try {
+            // Create adapters
+            const genericReq = new adapter_js_1.ExpressRequestAdapter(req);
+            const genericRes = new adapter_js_1.ExpressResponseAdapter(res);
+            // Handle request through core handler
+            await coreHandler.handle(genericReq, genericRes);
+        }
+        catch (error) {
+            // Pass error to Express error handling middleware
+            next(error);
+        }
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/cjs/express/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../../src/express/middleware.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAmCH,8CA2BC;AAzDD,2DAAqD;AACrD,6CAA6E;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,SAAgB,iBAAiB,CAC/B,MAAc,EACd,UAA+B,EAAE;IAEjC,8CAA8C;IAC9C,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC;IAEzC,MAAM,WAAW,GAAG,IAAI,oCAAe,CAAC;QACtC,MAAM;QACN,IAAI,EAAE,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;QAClF,GAAI,WAAmB,EAAE,8EAA8E;KACxG,CAAC,CAAC;IAEH,4BAA4B;IAC5B,OAAO,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAiB,EAAE;QAC9E,IAAI,CAAC;YACH,kBAAkB;YAClB,MAAM,UAAU,GAAG,IAAI,kCAAqB,CAAC,GAAG,CAAC,CAAC;YAClD,MAAM,UAAU,GAAG,IAAI,mCAAsB,CAAC,GAAG,CAAC,CAAC;YAEnD,sCAAsC;YACtC,MAAM,WAAW,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,kDAAkD;YAClD,IAAI,CAAC,KAAK,CAAC,CAAC;QACd,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}