adapter-edge

A lightweight adapter for running a single, framework-agnostic request handler on any edge runtime that speaks the Fetch API — Cloudflare Workers, Vercel Edge, Deno Deploy, Netlify Edge, Bun, and more.

Install

npm install adapter-edge

Usage

import { createEdgeAdapter, toFetchHandler } from "adapter-edge";

const handler = createEdgeAdapter(
  async (request, ctx) => {
    return Response.json({ url: request.url, hasEnv: !!ctx.env });
  },
  {
    middleware: [
      (next) => async (req, ctx) => {
        const res = await next(req, ctx);
        res.headers.set("x-powered-by", "adapter-edge");
        return res;
      },
    ],
  },
);

// Cloudflare Workers / Vercel Edge style export:
export default { fetch: toFetchHandler(handler) };

API

createEdgeAdapter(handler, options?)

Composes a handler with middleware and error handling into a single EdgeHandler.

• middleware — array of EdgeMiddleware, applied outermost-first.
• onError(error, request) — called when the handler throws; defaults to a JSON 500.

toFetchHandler(handler)

Adapts an EdgeHandler to the (request, env, ctx) signature used by Cloudflare Workers and Vercel Edge functions.

notFound

A ready-made EdgeHandler that returns 404 Not Found.

License

MIT