exisjs 0.6.1 → 0.7.0

package/dist/dev/dep-graph.js

@@ -1,111 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateDependencyGraph = generateDependencyGraph;
-const promises_1 = __importDefault(require("node:fs/promises"));
-const node_path_1 = __importDefault(require("node:path"));
-const node_fs_1 = require("node:fs");
-async function generateDependencyGraph(apiDir, cwd) {
-    const graph = new Map();
-    const visited = new Set();
-    const routeFiles = await findRouteFiles(apiDir);
-    for (const routeFile of routeFiles) {
-        await processFile(routeFile, routeFile, cwd, graph, visited);
-    }
-    // Also save to .exis/dev/dependency-graph.json (skip during tests)
-    if (process.env.NODE_ENV !== 'test' && process.env.__EXIS_TEST !== 'true') {
-        const exisDevPath = node_path_1.default.join(cwd, '.exis', 'dev');
-        try {
-            await promises_1.default.mkdir(exisDevPath, { recursive: true });
-            const serializable = {};
-            for (const [dep, routes] of graph.entries()) {
-                serializable[node_path_1.default.relative(cwd, dep)] = Array.from(routes).map((r) => node_path_1.default.relative(cwd, r));
-            }
-            await promises_1.default.writeFile(node_path_1.default.join(exisDevPath, 'dependency-graph.json'), JSON.stringify(serializable, null, 2));
-        }
-        catch {
-            // Ignore errors saving
-        }
-    }
-    return graph;
-}
-async function findRouteFiles(dir) {
-    const files = [];
-    const entries = await promises_1.default.readdir(dir, { withFileTypes: true });
-    for (const entry of entries) {
-        const fullPath = node_path_1.default.join(dir, entry.name);
-        if (entry.isDirectory()) {
-            files.push(...(await findRouteFiles(fullPath)));
-        }
-        else if (entry.name === 'route.ts' || entry.name === 'route.js') {
-            files.push(fullPath);
-        }
-    }
-    return files;
-}
-async function processFile(filePath, routeFilePath, cwd, graph, visited) {
-    const visitKey = `${filePath}:${routeFilePath}`;
-    if (visited.has(visitKey))
-        return;
-    visited.add(visitKey);
-    let content;
-    try {
-        content = await promises_1.default.readFile(filePath, 'utf8');
-    }
-    catch {
-        return;
-    }
-    const importRegex = /(?:import|export)(?:\s+(?:[^'"]*)\s+from\s+)?['"]([^'"]+)['"]|import\(['"]([^'"]+)['"]\)/g;
-    let match;
-    while ((match = importRegex.exec(content)) !== null) {
-        const importPath = match[1] || match[2];
-        if (!importPath)
-            continue;
-        if (importPath.startsWith('.')) {
-            const resolved = resolveImport(filePath, importPath);
-            if (resolved) {
-                addEdge(resolved, routeFilePath, graph);
-                await processFile(resolved, routeFilePath, cwd, graph, visited);
-            }
-        }
-        else if (importPath.startsWith('@/')) {
-            const resolved = resolveAlias(cwd, importPath);
-            if (resolved) {
-                addEdge(resolved, routeFilePath, graph);
-                await processFile(resolved, routeFilePath, cwd, graph, visited);
-            }
-        }
-    }
-}
-function addEdge(dependency, dependent, graph) {
-    const dep = node_path_1.default.resolve(dependency);
-    const dest = node_path_1.default.resolve(dependent);
-    if (!graph.has(dep))
-        graph.set(dep, new Set());
-    graph.get(dep).add(dest);
-}
-function resolveImport(importerFile, importPath) {
-    const dir = node_path_1.default.dirname(importerFile);
-    const target = node_path_1.default.join(dir, importPath);
-    return resolveFile(target);
-}
-function resolveAlias(cwd, importPath) {
-    const target = node_path_1.default.join(cwd, 'src', importPath.slice(2));
-    return resolveFile(target);
-}
-function resolveFile(basePath) {
-    if (basePath.endsWith('.ts') || basePath.endsWith('.js')) {
-        if ((0, node_fs_1.existsSync)(basePath))
-            return basePath;
-    }
-    const extensions = ['.ts', '.js', '/index.ts', '/index.js'];
-    for (const ext of extensions) {
-        const fullPath = basePath + ext;
-        if ((0, node_fs_1.existsSync)(fullPath))
-            return fullPath;
-    }
-    return null;
-}
-//# sourceMappingURL=dep-graph.js.map

package/dist/dev/dep-graph.js.map

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

package/dist/dev/hot-reload.d.ts

@@ -1,30 +0,0 @@
-import type { Router } from '../router/router';
-interface HotReloaderOptions {
-    apiDirs: string[];
-    router: Router;
-    routeMap: Map<string, string>;
-    mountRoute: (filePath: string, routePath: string) => Promise<void>;
-    clearCache: () => void;
-}
-export declare class HotReloader {
-    private apiDirs;
-    private router;
-    private routeMap;
-    private mountRoute;
-    private clearCache;
-    private watcher;
-    private depGraph;
-    constructor(opts: HotReloaderOptions);
-    start(): Promise<void>;
-    private isRouteFile;
-    private isGatewayFile;
-    private handleFileChange;
-    private handleChange;
-    private handleAdd;
-    private handleDelete;
-    private invalidateCache;
-    private filePathToRoutePath;
-    stop(): Promise<void>;
-}
-export {};
-//# sourceMappingURL=hot-reload.d.ts.map

package/dist/dev/hot-reload.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hot-reload.d.ts","sourceRoot":"","sources":["../../src/dev/hot-reload.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAsB9C,UAAU,kBAAkB;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAClE,UAAU,EAAE,MAAM,IAAI,CAAA;CACvB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,UAAU,CAAwD;IAC1E,OAAO,CAAC,UAAU,CAAY;IAC9B,OAAO,CAAC,OAAO,CAA4C;IAC3D,OAAO,CAAC,QAAQ,CAAiC;gBAErC,IAAI,EAAE,kBAAkB;IAQ9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA+C5B,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,aAAa;YAKP,gBAAgB;YA6BhB,YAAY;YAyCZ,SAAS;IAiCvB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,mBAAmB;IAoCrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAM5B"}

package/dist/dev/hot-reload.js

@@ -1,262 +0,0 @@
-"use strict";
-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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HotReloader = void 0;
-const node_path_1 = __importDefault(require("node:path"));
-const error_overlay_1 = require("../dev/error-overlay");
-const dep_graph_1 = require("../dev/dep-graph");
-const c = {
-    green: '\x1b[32m',
-    cyan: '\x1b[36m',
-    yellow: '\x1b[33m',
-    red: '\x1b[31m',
-    gray: '\x1b[90m',
-    bold: '\x1b[1m',
-    reset: '\x1b[0m',
-};
-function ts() {
-    const now = new Date();
-    const h = String(now.getHours()).padStart(2, '0');
-    const m = String(now.getMinutes()).padStart(2, '0');
-    const s = String(now.getSeconds()).padStart(2, '0');
-    return `${c.gray}[${h}:${m}:${s}]${c.reset}`;
-}
-class HotReloader {
-    constructor(opts) {
-        this.watcher = null;
-        this.depGraph = new Map();
-        this.apiDirs = opts.apiDirs;
-        this.router = opts.router;
-        this.routeMap = opts.routeMap;
-        this.mountRoute = opts.mountRoute;
-        this.clearCache = opts.clearCache;
-    }
-    async start() {
-        let chokidar;
-        try {
-            chokidar = await Promise.resolve().then(() => __importStar(require('chokidar')));
-        }
-        catch {
-            return; // chokidar not available, skip HRR
-        }
-        this.depGraph = new Map();
-        for (const dir of this.apiDirs) {
-            const graph = await (0, dep_graph_1.generateDependencyGraph)(dir, process.cwd());
-            for (const [k, v] of graph) {
-                this.depGraph.set(k, v);
-            }
-        }
-        const watchDirs = this.apiDirs.map((dir) => {
-            return node_path_1.default.dirname(dir); // e.g. src/http -> src, http -> .
-        });
-        // De-duplicate watchDirs
-        const uniqueWatchDirs = Array.from(new Set(watchDirs)).map((d) => node_path_1.default.resolve(process.cwd(), d));
-        this.watcher = chokidar.watch(uniqueWatchDirs, {
-            ignoreInitial: true,
-            ignored: ['**/node_modules/**', '**/.exis/**'],
-        });
-        this.watcher.on('change', async (filePath) => {
-            await this.handleFileChange(filePath);
-        });
-        this.watcher.on('add', async (filePath) => {
-            if (this.isRouteFile(filePath)) {
-                this.handleAdd(filePath);
-            }
-        });
-        this.watcher.on('unlink', (filePath) => {
-            if (this.isRouteFile(filePath)) {
-                this.handleDelete(filePath);
-            }
-        });
-    }
-    isRouteFile(filePath) {
-        const base = node_path_1.default.basename(filePath);
-        return base === 'route.ts' || base === 'route.js';
-    }
-    isGatewayFile(filePath) {
-        const base = node_path_1.default.basename(filePath);
-        return base === 'gateway.ts' || base === 'gateway.js';
-    }
-    async handleFileChange(filePath) {
-        const normalized = node_path_1.default.resolve(filePath);
-        if (this.isRouteFile(normalized)) {
-            return this.handleChange(normalized);
-        }
-        if (this.isGatewayFile(normalized)) {
-            const gatewayDir = node_path_1.default.dirname(normalized);
-            this.invalidateCache(normalized);
-            for (const [routeFile] of this.routeMap) {
-                if (routeFile.startsWith(gatewayDir)) {
-                    await this.handleChange(routeFile);
-                }
-            }
-            return;
-        }
-        if (this.depGraph.has(normalized)) {
-            const dependents = this.depGraph.get(normalized);
-            if (dependents.size > 0) {
-                this.invalidateCache(normalized);
-                for (const routeFile of dependents) {
-                    await this.handleChange(routeFile);
-                }
-            }
-        }
-    }
-    async handleChange(filePath) {
-        const start = performance.now();
-        const normalized = node_path_1.default.resolve(filePath);
-        const routePath = this.routeMap.get(normalized);
-        if (!routePath) {
-            // Unknown route file, try to compute the route path
-            return this.handleAdd(filePath);
-        }
-        // 1. Remove old routes from this file
-        this.router.removeRoutesBySource(normalized);
-        // 2. Clear the module cache so we get a fresh import
-        this.invalidateCache(normalized);
-        // 3. Re-import and mount
-        try {
-            await this.mountRoute(normalized, routePath);
-            // Update dependency graph
-            this.depGraph = new Map();
-            for (const dir of this.apiDirs) {
-                const graph = await (0, dep_graph_1.generateDependencyGraph)(dir, process.cwd());
-                for (const [k, v] of graph) {
-                    this.depGraph.set(k, v);
-                }
-            }
-            const elapsed = Math.round(performance.now() - start);
-            const relative = node_path_1.default
-                .relative(process.cwd(), normalized)
-                .replace(/\\/g, '/');
-            console.log(`${ts()} ${c.green}HMR:${c.reset} Reloaded ${c.cyan}${relative}${c.reset} in ${elapsed}ms`);
-        }
-        catch (err) {
-            (0, error_overlay_1.formatDevError)(err, normalized);
-        }
-    }
-    async handleAdd(filePath) {
-        const normalized = node_path_1.default.resolve(filePath);
-        // Compute the route path from the file path
-        const routePath = this.filePathToRoutePath(normalized);
-        if (!routePath)
-            return;
-        this.routeMap.set(normalized, routePath);
-        try {
-            this.invalidateCache(normalized);
-            await this.mountRoute(normalized, routePath);
-            // Update dependency graph for the new file
-            this.depGraph = new Map();
-            for (const dir of this.apiDirs) {
-                const graph = await (0, dep_graph_1.generateDependencyGraph)(dir, process.cwd());
-                for (const [k, v] of graph) {
-                    this.depGraph.set(k, v);
-                }
-            }
-            const relative = node_path_1.default
-                .relative(process.cwd(), normalized)
-                .replace(/\\/g, '/');
-            console.log(`${ts()} ${c.green}HMR:${c.reset} Added route ${c.cyan}${relative}${c.reset} → ${c.yellow}${routePath}${c.reset}`);
-        }
-        catch (err) {
-            (0, error_overlay_1.formatDevError)(err, normalized);
-        }
-    }
-    handleDelete(filePath) {
-        const normalized = node_path_1.default.resolve(filePath);
-        const removed = this.router.removeRoutesBySource(normalized);
-        this.routeMap.delete(normalized);
-        if (removed > 0) {
-            const relative = node_path_1.default
-                .relative(process.cwd(), normalized)
-                .replace(/\\/g, '/');
-            console.log(`${ts()} ${c.red}HMR:${c.reset} Removed route ${c.cyan}${relative}${c.reset} (${removed} handler${removed > 1 ? 's' : ''})`);
-        }
-    }
-    invalidateCache(filePath) {
-        // Clear CommonJS cache
-        const resolved = require.resolve(filePath);
-        if (resolved && require.cache[resolved]) {
-            delete require.cache[resolved];
-        }
-        // For ESM, we append a cache-busting query param on the import URL
-        // This is handled in the mountRoute function
-        this.clearCache();
-    }
-    filePathToRoutePath(filePath) {
-        let matchedApiDir = null;
-        for (const dir of this.apiDirs) {
-            if (filePath.startsWith(node_path_1.default.resolve(dir))) {
-                matchedApiDir = dir;
-                break;
-            }
-        }
-        if (!matchedApiDir)
-            return null;
-        const relative = node_path_1.default.relative(matchedApiDir, filePath).replace(/\\/g, '/');
-        // Remove route.ts / route.js from the end
-        const dir = node_path_1.default.dirname(relative);
-        let routePath = '/api';
-        if (dir !== '.') {
-            const segments = dir.split('/').map((segment) => {
-                // Skip (group) folders
-                if (segment.startsWith('(') && segment.endsWith(')'))
-                    return null;
-                // [...slug] catch-all
-                if (segment.startsWith('[...') && segment.endsWith(']')) {
-                    return '*' + segment.slice(4, -1);
-                }
-                // [id] dynamic param
-                return segment.replace(/\[(.*?)\]/g, ':$1');
-            });
-            const validSegments = segments.filter(Boolean);
-            if (validSegments.length > 0) {
-                routePath += '/' + validSegments.join('/');
-            }
-        }
-        return routePath;
-    }
-    async stop() {
-        if (this.watcher) {
-            await this.watcher.close();
-            this.watcher = null;
-        }
-    }
-}
-exports.HotReloader = HotReloader;
-//# sourceMappingURL=hot-reload.js.map

package/dist/dev/hot-reload.js.map

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

package/dist/docs/content/adapters.mdx

@@ -1,199 +0,0 @@
----
-nextUrl: "/"
-nextTitle: "Back to Home"
----
-
-# Adapters & Serverless
-
-ExisJS was engineered using modern web standards (Fetch API, Request/Response patterns). Because of this, ExisJS can run across various JavaScript runtimes.
-
-To deploy your ExisJS application to serverless or edge environments, you simply wrap your `app` with the corresponding adapter from `exisjs/adapters`.
-
-Every adapter handles **lazy initialization** automatically—your routes, plugins, and lifecycle hooks (`onStart`) are bootstrapped on the very first incoming request (cold start), so you never have to worry about manual setup in serverless environments.
-
----
-
-## Available Adapters
-
-| Adapter | Import | Environment |
-|---------|--------|-------------|
-| `vercel` | `exisjs/adapters` | Vercel Serverless Functions |
-| `aws` | `exisjs/adapters` | AWS Lambda + API Gateway |
-| `cloudflare` | `exisjs/adapters` | Cloudflare Workers |
-| `netlify` | `exisjs/adapters` | Netlify Edge Functions |
-| `deno` | `exisjs/adapters` | Deno Deploy / Deno.serve |
-| `bun` | `exisjs/adapters` | Bun.serve |
-| `fastly` | `exisjs/adapters` | Fastly Compute@Edge |
-
-> [!WARNING]
-> **Edge Limitations**: When deploying to Edge runtimes (Cloudflare Workers, Vercel Edge, Netlify Edge, Fastly), some Node.js specific features will not function. Specifically:
-> - **Queues & Cron**: Background jobs and scheduled tasks require a long-running process and are unsupported on Edge.
-> - **WebSockets**: State-heavy WebSockets are not supported via the standard Edge Fetch adapters.
-> - **FileSystem Cache**: `FileSystemCacheStore` cannot write to a filesystem on Edge. You must configure a `RedisCacheStore` if you need caching on the Edge.
-
----
-
-## Vercel
-
-To deploy an ExisJS app to Vercel, create an `api/index.js` entrypoint that wraps your app with the `vercel` adapter.
-
-```javascript filename="api/index.js"
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import { vercel } from "exisjs/adapters";
-
-const projectRoot = join(dirname(fileURLToPath(import.meta.url)), "..");
-
-// We use a dynamic import with a file URL to prevent Vercel's bundler (@vercel/node)
-// from statically cloning dependencies (like Mongoose) into the entrypoint.
-// This ensures your dynamic routes and server use the exact same module instances.
-const serverPath = join(projectRoot, ".exis", "server", "src", "http", "server.js");
-const { default: app } = await import("file://" + serverPath);
-
-export default vercel(app, { cwd: projectRoot });
-```
-
-Then configure `vercel.json` to route all traffic to this function and bundle the compiled `.exis` directory:
-
-```json filename="vercel.json"
-{
-  "version": 2,
-  "buildCommand": "npm run build",
-  "functions": {
-    "api/index.js": {
-      "includeFiles": ".exis/**/*"
-    }
-  },
-  "rewrites": [
-    { "source": "/(.*)", "destination": "/api/index" }
-  ]
-}
-```
-
-> **Note:** ExisJS compiles your application into the `.exis/` directory during `exisjs build`. The `includeFiles` configuration ensures Vercel bundles these compiled files alongside your serverless function. You also need a `public/` directory (even an empty one with a `.keep` file) to prevent Vercel's missing output directory error.
-
----
-
-## AWS Lambda
-
-Deploying an ExisJS API as an AWS Lambda function (behind API Gateway) takes one line of code. The `aws` adapter converts API Gateway events into native Node.js HTTP streams that ExisJS understands.
-
-```typescript filename="src/lambda.ts"
-import app from './http/server'
-import { aws } from 'exisjs/adapters'
-
-// Export the AWS Lambda handler
-export const handler = aws(app)
-```
-
-The adapter automatically handles:
-- Mapping `httpMethod`, `path`, and `queryStringParameters` from API Gateway events
-- Converting headers and request bodies
-- Collecting the response stream and returning a properly formatted `APIGatewayResult`
-- Base64 encoding for binary responses
-
----
-
-## Cloudflare Workers
-
-ExisJS works on Cloudflare Workers using the Web Standard Fetch API.
-
-```typescript filename="src/worker.ts"
-import app from './http/server'
-import { cloudflare } from 'exisjs/adapters'
-
-export default cloudflare(app)
-```
-
-The adapter returns an object with a `fetch` method that Cloudflare Workers expects. Your `env` and `ctx` (execution context) are automatically passed through to your route handlers.
-
----
-
-## Netlify
-
-Netlify Edge Functions use the Web Standard Fetch API, which ExisJS supports.
-
-```typescript filename="netlify/edge-functions/api.ts"
-import app from '../../src/http/server'
-import { netlify } from 'exisjs/adapters'
-
-export default netlify(app)
-```
-
-The adapter wraps your app and passes both the incoming `Request` and Netlify's `Context` object through to ExisJS.
-
----
-
-## Deno
-
-Deno natively supports the Web Standard Fetch API, so ExisJS runs on it without any compatibility layers.
-
-```typescript filename="src/main.ts"
-import app from './http/server'
-import { deno } from 'exisjs/adapters'
-
-Deno.serve({ port: 8000 }, deno(app))
-```
-
----
-
-## Bun
-
-Bun provides a native HTTP server. The `bun` adapter ties directly into Bun's `serve` function.
-
-```typescript filename="src/main.ts"
-import app from './http/server'
-import { bun } from 'exisjs/adapters'
-
-Bun.serve({
-  port: 3000,
-  ...bun(app)
-})
-```
-
----
-
-## Fastly Compute@Edge
-
-Fastly's Compute@Edge platform runs your code at the network edge. The `fastly` adapter integrates with Fastly's event-driven model.
-
-```typescript filename="src/index.ts"
-import app from './http/server'
-import { fastly } from 'exisjs/adapters'
-
-addEventListener('fetch', fastly(app))
-```
-
----
-
-## The Fetch Adapter (Building Custom Adapters)
-
-Under the hood, ExisJS provides a universal **Fetch adapter** (`handleFetch`) that bridges the gap between the Web Standard `Request`/`Response` API and ExisJS's internal Node.js-style request pipeline.
-
-Every edge/serverless adapter (Cloudflare, Deno, Bun, Netlify, Fastly) ultimately calls `app.fetch()`, which internally uses `handleFetch` to:
-
-1. **Convert** a Web Standard `Request` into a Node.js-compatible `IncomingMessage` (via `FetchIncomingMessage`)
-2. **Route** the request through ExisJS's full middleware and routing pipeline
-3. **Collect** the response and convert it back into a Web Standard `Response` (via `FetchServerResponse`)
-
-This means you can create your own custom adapter for **any** runtime that supports the Fetch API:
-
-```typescript filename="src/my-custom-adapter.ts"
-import app from './http/server'
-
-// app.fetch() works anywhere that has the Web Standard Request/Response API
-const server = createMyCustomServer({
-  async handler(request: Request): Promise<Response> {
-    return app.fetch(request)
-  }
-})
-```
-
-The `app.fetch()` method accepts an optional `env` and `ctx` parameter, which are passed through to your route handlers—allowing platform-specific features (like Cloudflare's KV bindings or Deno's connection info) to be accessed from within your ExisJS routes.
-
-```typescript
-// Signature
-app.fetch(request: Request, env?: any, ctx?: any): Promise<Response>
-```
-
-This architecture ensures that ExisJS remains portable. Your application code stays the same—only the deployment wrapper changes.