adapter-edge 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vincent Adiasor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,57 @@
+# adapter-edge
+
+A lightweight adapter for running a single, framework-agnostic request handler
+on any edge runtime that speaks the [Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API) —
+Cloudflare Workers, Vercel Edge, Deno Deploy, Netlify Edge, Bun, and more.
+
+## Install
+
+```sh
+npm install adapter-edge
+```
+
+## Usage
+
+```ts
+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

package/dist/index.cjs

@@ -0,0 +1,58 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createEdgeAdapter: () => createEdgeAdapter,
+  notFound: () => notFound,
+  toFetchHandler: () => toFetchHandler
+});
+module.exports = __toCommonJS(index_exports);
+var defaultOnError = (error) => {
+  const message = error instanceof Error ? error.message : "Internal Server Error";
+  return new Response(JSON.stringify({ error: message }), {
+    status: 500,
+    headers: { "content-type": "application/json" }
+  });
+};
+function createEdgeAdapter(handler, options = {}) {
+  const { middleware = [], onError = defaultOnError } = options;
+  const composed = middleware.reduceRight(
+    (next, mw) => mw(next),
+    handler
+  );
+  return async (request, context) => {
+    try {
+      return await composed(request, context);
+    } catch (error) {
+      return onError(error, request);
+    }
+  };
+}
+function toFetchHandler(handler) {
+  return (request, env, ctx) => handler(request, { env, waitUntil: ctx?.waitUntil });
+}
+var notFound = () => new Response("Not Found", { status: 404 });
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createEdgeAdapter,
+  notFound,
+  toFetchHandler
+});

package/dist/index.d.cts

@@ -0,0 +1,48 @@
+/**
+ * adapter-edge
+ *
+ * A tiny adapter that lets you write a single, framework-agnostic request
+ * handler and run it on any edge runtime that speaks the Fetch API
+ * (Cloudflare Workers, Vercel Edge, Deno Deploy, Netlify Edge, Bun, etc.).
+ */
+/**
+ * Extra context passed alongside the request. Edge runtimes expose different
+ * shapes here (env bindings, waitUntil, etc.), so it is intentionally open.
+ */
+interface EdgeContext {
+    /** Runtime-provided environment / bindings (e.g. Cloudflare `env`). */
+    env?: Record<string, unknown>;
+    /** Schedule background work that outlives the response, when supported. */
+    waitUntil?: (promise: Promise<unknown>) => void;
+    /** Anything else the host runtime wants to surface. */
+    [key: string]: unknown;
+}
+/**
+ * A framework-agnostic handler. Receives a standard `Request` plus an
+ * `EdgeContext` and returns a `Response` (or a promise of one).
+ */
+type EdgeHandler = (request: Request, context: EdgeContext) => Response | Promise<Response>;
+/** Middleware wraps a handler, optionally short-circuiting it. */
+type EdgeMiddleware = (handler: EdgeHandler) => EdgeHandler;
+interface CreateEdgeAdapterOptions {
+    /** Middleware applied outermost-first (left to right). */
+    middleware?: EdgeMiddleware[];
+    /** Called when the handler throws. Defaults to a 500 response. */
+    onError?: (error: unknown, request: Request) => Response | Promise<Response>;
+}
+/**
+ * Compose a handler with middleware and error handling into a single
+ * `EdgeHandler` you can mount on any edge runtime.
+ */
+declare function createEdgeAdapter(handler: EdgeHandler, options?: CreateEdgeAdapterOptions): EdgeHandler;
+/**
+ * Convenience wrapper for Cloudflare Workers / Vercel Edge style exports,
+ * mapping their `(request, env, ctx)` signature onto an `EdgeHandler`.
+ */
+declare function toFetchHandler(handler: EdgeHandler): (request: Request, env?: Record<string, unknown>, ctx?: {
+    waitUntil?: (p: Promise<unknown>) => void;
+}) => Response | Promise<Response>;
+/** A no-op handler returning 404 — handy as a fallback. */
+declare const notFound: EdgeHandler;
+
+export { type CreateEdgeAdapterOptions, type EdgeContext, type EdgeHandler, type EdgeMiddleware, createEdgeAdapter, notFound, toFetchHandler };

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * adapter-edge
+ *
+ * A tiny adapter that lets you write a single, framework-agnostic request
+ * handler and run it on any edge runtime that speaks the Fetch API
+ * (Cloudflare Workers, Vercel Edge, Deno Deploy, Netlify Edge, Bun, etc.).
+ */
+/**
+ * Extra context passed alongside the request. Edge runtimes expose different
+ * shapes here (env bindings, waitUntil, etc.), so it is intentionally open.
+ */
+interface EdgeContext {
+    /** Runtime-provided environment / bindings (e.g. Cloudflare `env`). */
+    env?: Record<string, unknown>;
+    /** Schedule background work that outlives the response, when supported. */
+    waitUntil?: (promise: Promise<unknown>) => void;
+    /** Anything else the host runtime wants to surface. */
+    [key: string]: unknown;
+}
+/**
+ * A framework-agnostic handler. Receives a standard `Request` plus an
+ * `EdgeContext` and returns a `Response` (or a promise of one).
+ */
+type EdgeHandler = (request: Request, context: EdgeContext) => Response | Promise<Response>;
+/** Middleware wraps a handler, optionally short-circuiting it. */
+type EdgeMiddleware = (handler: EdgeHandler) => EdgeHandler;
+interface CreateEdgeAdapterOptions {
+    /** Middleware applied outermost-first (left to right). */
+    middleware?: EdgeMiddleware[];
+    /** Called when the handler throws. Defaults to a 500 response. */
+    onError?: (error: unknown, request: Request) => Response | Promise<Response>;
+}
+/**
+ * Compose a handler with middleware and error handling into a single
+ * `EdgeHandler` you can mount on any edge runtime.
+ */
+declare function createEdgeAdapter(handler: EdgeHandler, options?: CreateEdgeAdapterOptions): EdgeHandler;
+/**
+ * Convenience wrapper for Cloudflare Workers / Vercel Edge style exports,
+ * mapping their `(request, env, ctx)` signature onto an `EdgeHandler`.
+ */
+declare function toFetchHandler(handler: EdgeHandler): (request: Request, env?: Record<string, unknown>, ctx?: {
+    waitUntil?: (p: Promise<unknown>) => void;
+}) => Response | Promise<Response>;
+/** A no-op handler returning 404 — handy as a fallback. */
+declare const notFound: EdgeHandler;
+
+export { type CreateEdgeAdapterOptions, type EdgeContext, type EdgeHandler, type EdgeMiddleware, createEdgeAdapter, notFound, toFetchHandler };

package/dist/index.js

@@ -0,0 +1,31 @@
+// src/index.ts
+var defaultOnError = (error) => {
+  const message = error instanceof Error ? error.message : "Internal Server Error";
+  return new Response(JSON.stringify({ error: message }), {
+    status: 500,
+    headers: { "content-type": "application/json" }
+  });
+};
+function createEdgeAdapter(handler, options = {}) {
+  const { middleware = [], onError = defaultOnError } = options;
+  const composed = middleware.reduceRight(
+    (next, mw) => mw(next),
+    handler
+  );
+  return async (request, context) => {
+    try {
+      return await composed(request, context);
+    } catch (error) {
+      return onError(error, request);
+    }
+  };
+}
+function toFetchHandler(handler) {
+  return (request, env, ctx) => handler(request, { env, waitUntil: ctx?.waitUntil });
+}
+var notFound = () => new Response("Not Found", { status: 404 });
+export {
+  createEdgeAdapter,
+  notFound,
+  toFetchHandler
+};

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "adapter-edge",
+  "version": "0.1.0",
+  "description": "A lightweight adapter for running framework-agnostic handlers on edge runtimes (Cloudflare Workers, Vercel Edge, Deno, etc.).",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "edge",
+    "adapter",
+    "cloudflare-workers",
+    "vercel-edge",
+    "deno",
+    "fetch",
+    "handler",
+    "serverless"
+  ],
+  "author": "@ydaymad",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.5.0"
+  }
+}