@superfunctions/http 0.1.0 → 0.1.2

package/README.md

@@ -2,16 +2,6 @@
 
 Framework-agnostic HTTP abstraction layer for building web APIs that work across Express, Hono, Fastify, Next.js, and more.
 
-## Features
-
-- **Framework Agnostic**: Write your API logic once, deploy to any framework
-- **Web Standards**: Built on standard `Request` and `Response` APIs
-- **Type Safe**: Full TypeScript support with generic context types
-- **Zero Dependencies**: Core package has no runtime dependencies
-- **Middleware Support**: Compose middleware chains for authentication, CORS, etc.
-- **Path Parameters**: Express-style path patterns with parameter extraction
-- **Edge Compatible**: Works in edge runtimes (Cloudflare Workers, Deno, Bun)
-
 ## Installation
 
 ```bash
@@ -26,6 +16,15 @@ npm install @superfunctions/http-express
 
 # Hono
 npm install @superfunctions/http-hono
+
+# Fastify
+npm install @superfunctions/http-fastify
+
+# Next.js
+npm install @superfunctions/http-next
+
+# SvelteKit
+npm install @superfunctions/http-sveltekit
 ```
 
 ## Quick Start
@@ -73,12 +72,12 @@ const apiRouter = createRouter({
 
 ```typescript
 import express from 'express';
-import { toExpressRouter } from '@superfunctions/http-express';
+import { toExpress } from '@superfunctions/http-express';
 import { apiRouter } from './api';
 
 const app = express();
 app.use(express.json());
-app.use('/api', toExpressRouter(apiRouter));
+app.use('/api', toExpress(apiRouter));
 app.listen(3000);
 ```
 
@@ -86,11 +85,11 @@ app.listen(3000);
 
 ```typescript
 import { Hono } from 'hono';
-import { toHonoHandler } from '@superfunctions/http-hono';
+import { toHono } from '@superfunctions/http-hono';
 import { apiRouter } from './api';
 
 const app = new Hono();
-app.route('/api', toHonoHandler(apiRouter));
+app.route('/api', toHono(apiRouter));
 
 export default app;
 ```
@@ -106,14 +105,14 @@ const router = createRouter({ routes: [...] });
 
 // Cloudflare Workers
 export default {
-  fetch: (req) => router.handler(req)
+  fetch: router.handle
 };
 
 // Deno
-Deno.serve((req) => router.handler(req));
+Deno.serve(router.handle);
 
 // Bun
-Bun.serve({ fetch: (req) => router.handler(req) });
+Bun.serve({ fetch: router.handle });
 ```
 
 ## Features
@@ -187,6 +186,41 @@ const router = createRouter({
 });
 ```
 
+### Base Path
+
+**⚠️ Important: Only use `basePath` for standalone deployments without framework mounting.**
+
+```typescript
+// ✅ Good: Standalone deployment (Cloudflare Workers, Vercel Edge)
+const router = createRouter({
+  basePath: '/api/v1',
+  routes: [
+    { method: 'GET', path: '/users', handler: ... } // Accessible at /api/v1/users
+  ]
+});
+
+export default { fetch: router.handle }; // or router.handler
+
+// ❌ Bad: With framework mounting (creates double prefixing)
+const router = createRouter({
+  basePath: '/v1',  // Don't do this!
+  routes: [...]
+});
+app.use('/api', toExpress(router)); // Would need /api/v1/users
+
+// ✅ Good: With framework mounting (no basePath)
+const router = createRouter({
+  routes: [
+    { method: 'GET', path: '/users', handler: ... }
+  ]
+});
+app.use('/api/v1', toExpress(router)); // Accessible at /api/v1/users
+```
+
+**Rule of thumb:**
+- **Standalone deployment** → Use `basePath` in router
+- **Framework mounting** → Use framework's mounting (e.g., `app.use('/path', ...)`) and omit `basePath`
+
 ### CORS
 
 ```typescript
@@ -251,10 +285,11 @@ interface RouteContext {
 
 | Framework | Package | Function |
 |-----------|---------|----------|
-| Express | `@superfunctions/http-express` | `toExpressRouter()` |
-| Hono | `@superfunctions/http-hono` | `toHonoHandler()` |
-
-More adapters coming soon: Fastify, Next.js, SvelteKit, Remix, etc.
+| Express | `@superfunctions/http-express` | `toExpress()`, `toExpressHandler()` |
+| Hono | `@superfunctions/http-hono` | `toHono()` |
+| Fastify | `@superfunctions/http-fastify` | `toFastify()` |
+| Next.js | `@superfunctions/http-next` | `toNextHandlers()` |
+| SvelteKit | `@superfunctions/http-sveltekit` | `toSvelteKitHandler()`, `toSvelteKitHandlers()` |
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superfunctions/http",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Framework-agnostic HTTP abstraction layer for Superfunctions libraries",
   "type": "module",
   "main": "./dist/index.js",