@johnhenry/aimatey-http

Note: Previously published as [email protected].

HTTP framework adapters for AI Matey - Universal AI Adapter System.

Part of the ai.matey monorepo.

Installation

npm install @johnhenry/aimatey-http

Overview

This package provides HTTP framework integrations for serving AI Matey bridges as API endpoints. Supports multiple popular Node.js and edge frameworks.

Included Adapters

• Express - Express.js middleware
• Fastify - Fastify handler
• Hono - Hono middleware (works on edge)
• Koa - Koa middleware
• Node - Native Node.js HTTP handler
• Deno - Deno HTTP handler

For core HTTP utilities (auth, CORS, rate limiting), see @johnhenry/aimatey-http-core.

Usage

Express

import express from 'express';
import { ExpressMiddleware } from '@johnhenry/aimatey-http';
import { Bridge } from '@johnhenry/aimatey-core';

const app = express();
const bridge = new Bridge(frontend, backend);

const middleware = new ExpressMiddleware({ bridge });
app.post('/v1/chat/completions', middleware.handler());

Fastify

import Fastify from 'fastify';
import { FastifyHandler } from '@johnhenry/aimatey-http';

const fastify = Fastify();
const handler = new FastifyHandler({ bridge });

fastify.post('/v1/chat/completions', handler.handler());

Hono

import { Hono } from 'hono';
import { HonoMiddleware } from '@johnhenry/aimatey-http';

const app = new Hono();
const middleware = new HonoMiddleware({ bridge });

app.post('/v1/chat/completions', middleware.handler());

Node.js Native HTTP

import http from 'http';
import { NodeHTTPListener } from '@johnhenry/aimatey-http';

const listener = new NodeHTTPListener({ bridge });
const server = http.createServer(listener.handler());

Deno

import { DenoHandler } from '@johnhenry/aimatey-http';

const handler = new DenoHandler({ bridge });
Deno.serve(handler.handler());

API Reference

See the TypeScript definitions for detailed API documentation.

License

MIT - see LICENSE for details.