@superfunctions/http-fastify 0.1.0

package/README.md

@@ -0,0 +1,244 @@
+# @superfunctions/http-fastify
+
+Fastify adapter for [@superfunctions/http](../http) - Use framework-agnostic routers with Fastify.
+
+## Installation
+
+```bash
+npm install @superfunctions/http @superfunctions/http-fastify fastify
+```
+
+## Quick Start
+
+```typescript
+import Fastify from 'fastify';
+import { createRouter } from '@superfunctions/http';
+import { toFastifyPlugin } from '@superfunctions/http-fastify';
+
+// Define your router (framework-agnostic)
+const apiRouter = createRouter({
+  routes: [
+    {
+      method: 'GET',
+      path: '/users/:id',
+      handler: async (req, ctx) => {
+        return Response.json({ id: ctx.params.id });
+      },
+    },
+  ],
+});
+
+// Use with Fastify
+const fastify = Fastify();
+await fastify.register(toFastifyPlugin(apiRouter), { prefix: '/api' });
+await fastify.listen({ port: 3000 });
+```
+
+## API
+
+### `toFastifyPlugin(router)`
+
+Converts a `@superfunctions/http` router to a Fastify plugin.
+
+**Parameters:**
+- `router`: Router instance from `@superfunctions/http`
+
+**Returns:** `FastifyPluginAsync`
+
+**Example:**
+```typescript
+import { toFastifyPlugin } from '@superfunctions/http-fastify';
+
+await fastify.register(toFastifyPlugin(myRouter), { 
+  prefix: '/api' 
+});
+```
+
+
+## Usage Examples
+
+### With Plugin Options
+
+```typescript
+import Fastify from 'fastify';
+import { toFastifyPlugin } from '@superfunctions/http-fastify';
+
+const fastify = Fastify();
+
+// Register with prefix
+await fastify.register(toFastifyPlugin(apiRouter), { 
+  prefix: '/api/v1' 
+});
+
+// Routes accessible at: /api/v1/*
+await fastify.listen({ port: 3000 });
+```
+
+### With Middleware
+
+```typescript
+import { createRouter } from '@superfunctions/http';
+import { toFastifyPlugin } from '@superfunctions/http-fastify';
+
+const router = createRouter({
+  middleware: [
+    async (req, ctx, next) => {
+      // Auth middleware
+      const token = req.headers.get('Authorization');
+      if (!token) {
+        return Response.json({ error: 'Unauthorized' }, { status: 401 });
+      }
+      return next();
+    },
+  ],
+  routes: [
+    {
+      method: 'GET',
+      path: '/protected',
+      handler: async () => Response.json({ data: 'secret' }),
+    },
+  ],
+});
+
+await fastify.register(toFastifyPlugin(router), { prefix: '/api' });
+```
+
+### With Custom Context
+
+```typescript
+interface AppContext {
+  db: Database;
+}
+
+const router = createRouter<AppContext>({
+  context: { db: myDatabase },
+  routes: [
+    {
+      method: 'GET',
+      path: '/users',
+      handler: async (req, ctx) => {
+        const users = await ctx.db.findMany({ model: 'users' });
+        return Response.json(users);
+      },
+    },
+  ],
+});
+
+await fastify.register(toFastifyPlugin(router), { prefix: '/api' });
+```
+
+### Multiple Routers
+
+```typescript
+const usersRouter = createRouter({ routes: [/* user routes */] });
+const postsRouter = createRouter({ routes: [/* post routes */] });
+
+await fastify.register(toFastifyPlugin(usersRouter), { prefix: '/api/users' });
+await fastify.register(toFastifyPlugin(postsRouter), { prefix: '/api/posts' });
+```
+
+### With Fastify Decorators
+
+You can combine with other Fastify plugins:
+
+```typescript
+import Fastify from 'fastify';
+import fastifyCors from '@fastify/cors';
+import { toFastifyPlugin } from '@superfunctions/http-fastify';
+
+const fastify = Fastify();
+
+// Register CORS plugin
+await fastify.register(fastifyCors, {
+  origin: 'https://example.com'
+});
+
+// Register your router
+await fastify.register(toFastifyPlugin(apiRouter), { prefix: '/api' });
+
+await fastify.listen({ port: 3000 });
+```
+
+## Important Notes
+
+### Plugin Registration
+
+The adapter returns a Fastify plugin that must be registered with `await fastify.register()`:
+
+```typescript
+// ✅ Correct - await registration
+await fastify.register(toFastifyPlugin(router));
+
+// ❌ Incorrect - missing await
+fastify.register(toFastifyPlugin(router));
+```
+
+### Prefix Handling
+
+The adapter automatically handles the prefix from plugin options:
+
+```typescript
+const router = createRouter({
+  routes: [
+    { method: 'GET', path: '/hello', handler: () => Response.json({ msg: 'hi' }) }
+  ]
+});
+
+// Route accessible at: /api/hello
+await fastify.register(toFastifyPlugin(router), { prefix: '/api' });
+```
+
+### JSON Serialization
+
+Fastify automatically serializes JSON responses. The adapter handles this by:
+- Parsing JSON from Web Response
+- Sending parsed objects to Fastify
+- Letting Fastify handle serialization
+
+### Body Parsing
+
+Fastify automatically parses JSON and form data. The adapter accesses the parsed body via `request.body`.
+
+### Testing
+
+Use Fastify's built-in `inject` method for testing:
+
+```typescript
+const response = await fastify.inject({
+  method: 'GET',
+  url: '/api/hello'
+});
+
+expect(response.statusCode).toBe(200);
+expect(response.json()).toEqual({ message: 'Hello' });
+```
+
+## TypeScript
+
+Full TypeScript support with proper types:
+
+```typescript
+import type { Router } from '@superfunctions/http';
+import type { FastifyPluginAsync } from 'fastify';
+
+const myRouter: Router = createRouter({ routes: [...] });
+const plugin: FastifyPluginAsync = toFastifyPlugin(myRouter);
+
+await fastify.register(plugin, { prefix: '/api' });
+```
+
+## Performance
+
+The adapter is designed for minimal overhead:
+- Uses catch-all route to delegate to the router
+- Minimal request/response translation
+- Leverages Fastify's fast JSON serialization
+
+## Compatibility
+
+- Fastify 4.x ✅
+- Fastify 5.x ✅
+
+## License
+
+MIT

package/dist/adapter.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Fastify adapter for @superfunctions/http
+ */
+import type { Router } from '@superfunctions/http';
+import type { FastifyPluginAsync } from 'fastify';
+/**
+ * Convert a @superfunctions/http Router to a Fastify plugin
+ *
+ * Usage:
+ * ```typescript
+ * fastify.register(toFastifyPlugin(router), { prefix: '/api' });
+ * ```
+ */
+export declare function toFastifyPlugin(router: Router): FastifyPluginAsync;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAmB,kBAAkB,EAAgC,MAAM,SAAS,CAAC;AAEjG;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAmBlE"}

package/dist/adapter.js

@@ -0,0 +1,102 @@
+/**
+ * Fastify adapter for @superfunctions/http
+ */
+/**
+ * Convert a @superfunctions/http Router to a Fastify plugin
+ *
+ * Usage:
+ * ```typescript
+ * fastify.register(toFastifyPlugin(router), { prefix: '/api' });
+ * ```
+ */
+export function toFastifyPlugin(router) {
+    const plugin = async (fastify, opts) => {
+        const prefix = opts.prefix || '';
+        // Catch all route that delegates to the router
+        fastify.all('/*', async (request, reply) => {
+            // Convert Fastify Request to Web Standard Request
+            // Strip the prefix from the URL so router can match correctly
+            const webRequest = await convertToWebRequest(request, prefix);
+            // Handle with router (router will do the routing)
+            const webResponse = await router.handle(webRequest);
+            // Convert Web Response to Fastify Reply
+            await convertToFastifyReply(webResponse, reply);
+        });
+    };
+    return plugin;
+}
+/**
+ * Convert Fastify Request to Web Standard Request
+ */
+async function convertToWebRequest(request, prefix = '') {
+    // Build full URL
+    // Strip prefix from URL so router can match routes correctly
+    let path = request.url;
+    if (prefix && path.startsWith(prefix)) {
+        path = path.slice(prefix.length) || '/';
+    }
+    const protocol = request.protocol;
+    const host = request.hostname;
+    const url = `${protocol}://${host}${path}`;
+    // Convert headers
+    const headers = new Headers();
+    for (const [key, value] of Object.entries(request.headers)) {
+        if (value) {
+            if (Array.isArray(value)) {
+                value.forEach((v) => headers.append(key, v));
+            }
+            else {
+                headers.set(key, value);
+            }
+        }
+    }
+    // Handle body
+    let body = null;
+    if (request.method !== 'GET' && request.method !== 'HEAD') {
+        // Fastify parses body automatically if content-type parser is registered
+        if (request.body && Object.keys(request.body).length > 0) {
+            body = JSON.stringify(request.body);
+            if (!headers.has('Content-Type')) {
+                headers.set('Content-Type', 'application/json');
+            }
+        }
+    }
+    return new Request(url, {
+        method: request.method,
+        headers,
+        body,
+    });
+}
+/**
+ * Convert Web Standard Response to Fastify Reply
+ */
+async function convertToFastifyReply(webResponse, reply) {
+    // Set status
+    reply.status(webResponse.status);
+    // Set headers
+    webResponse.headers.forEach((value, key) => {
+        reply.header(key, value);
+    });
+    // Send body
+    if (webResponse.body) {
+        const text = await webResponse.text();
+        // Fastify expects parsed JSON if Content-Type is application/json
+        const contentType = webResponse.headers.get('Content-Type');
+        if (contentType?.includes('application/json')) {
+            try {
+                reply.send(JSON.parse(text));
+            }
+            catch {
+                // If parsing fails, send as text
+                reply.send(text);
+            }
+        }
+        else {
+            reply.send(text);
+        }
+    }
+    else {
+        reply.send();
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @superfunctions/http-fastify - Fastify adapter
+ */
+export { toFastifyPlugin } from './adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+/**
+ * @superfunctions/http-fastify - Fastify adapter
+ */
+export { toFastifyPlugin } from './adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@superfunctions/http-fastify",
+  "version": "0.1.0",
+  "description": "Fastify adapter for @superfunctions/http",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest",
+    "test:watch": "vitest --watch",
+    "lint": "echo 'lint not configured'",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "peerDependencies": {
+    "@superfunctions/http": "^0.1.0",
+    "fastify": "^4.0.0 || ^5.0.0"
+  },
+  "devDependencies": {
+    "@superfunctions/http": "^0.1.0",
+    "@types/node": "^22.0.0",
+    "fastify": "^5.2.0",
+    "typescript": "^5.6.0",
+    "vitest": "^3.2.4"
+  },
+  "keywords": [
+    "http",
+    "fastify",
+    "adapter",
+    "router",
+    "superfunctions"
+  ],
+  "author": "21n",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/21nCo/super-functions/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/21nCo/super-functions.git",
+    "directory": "packages/http-fastify"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}