@flightdev/edge 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Flight Contributors
+
+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,145 @@
+# @flight-framework/edge
+
+Edge Runtime handlers for Flight Framework. Deploy to any edge provider with a unified API.
+
+## Philosophy
+
+**Flight doesn't impose** - you choose your edge provider. All adapters are optional.
+
+## Features
+
+- **Unified geo API** - Same geo data interface across all providers
+- **Cloudflare Workers** - Full cf object access, KV, R2, D1
+- **Vercel Edge** - Next.js compatible middleware and routes
+- **Deno Deploy** - Native Deno.serve() integration
+- **Provider portable** - Switch providers without code changes
+- **Zero lock-in** - Standard Request/Response objects
+
+## Installation
+
+```bash
+npm install @flight-framework/edge
+```
+
+## Quick Start
+
+```typescript
+import { createEdgeHandler } from '@flight-framework/edge';
+
+const handler = createEdgeHandler((request, ctx) => {
+    const { country, city } = ctx.geo;
+    
+    // Fire-and-forget logging
+    ctx.waitUntil(logAnalytics(request));
+    
+    return Response.json({ country, city });
+});
+
+export default handler;
+```
+
+## Adapters
+
+### Cloudflare Workers
+
+```typescript
+import { createEdgeHandler } from '@flight-framework/edge';
+import { createCloudflareHandler } from '@flight-framework/edge/cloudflare';
+
+const handler = createEdgeHandler((req, ctx) => {
+    // Full geo data from Cloudflare
+    const { country, city, timezone } = ctx.geo;
+    
+    // Cloudflare-specific properties
+    const isBot = ctx.cf?.isBot;
+    const colo = ctx.cf?.colo;
+    
+    // Access KV, R2, D1 via env
+    const kv = ctx.env?.MY_KV;
+    
+    return Response.json({ country, city, isBot });
+});
+
+export default createCloudflareHandler(handler);
+```
+
+### Vercel Edge
+
+```typescript
+// app/api/geo/route.ts
+import { createEdgeHandler } from '@flight-framework/edge';
+import { createVercelHandler } from '@flight-framework/edge/vercel';
+
+const handler = createEdgeHandler((req, ctx) => {
+    return Response.json({ country: ctx.geo.country });
+});
+
+export const GET = createVercelHandler(handler);
+export const runtime = 'edge';
+```
+
+### Deno Deploy
+
+```typescript
+import { createEdgeHandler } from '@flight-framework/edge';
+import { serve } from '@flight-framework/edge/deno';
+
+const handler = createEdgeHandler((req, ctx) => {
+    return new Response(`Hello from ${ctx.geo.country}!`);
+});
+
+serve(handler, { port: 8000 });
+```
+
+## EdgeContext API
+
+```typescript
+interface EdgeContext {
+    // Geolocation data
+    geo: {
+        country?: string;   // ISO country code (AR, US, DE)
+        city?: string;      // City name
+        region?: string;    // Region/state
+        latitude?: string;
+        longitude?: string;
+        timezone?: string;  // IANA timezone
+    };
+    
+    // Cloudflare-specific (only with CF adapter)
+    cf?: {
+        colo?: string;      // Data center
+        isBot?: boolean;
+        asn?: number;
+        // ... more
+    };
+    
+    // Environment bindings
+    env?: Record<string, unknown>;
+    
+    // Lifecycle methods
+    waitUntil: (promise: Promise<unknown>) => void;
+    passThroughOnException?: () => void;
+}
+```
+
+## Utilities
+
+```typescript
+import {
+    isEdgeRuntime,
+    getEdgeRuntime,
+    getGeoFromRequest,
+} from '@flight-framework/edge';
+
+// Check runtime
+if (isEdgeRuntime()) {
+    const runtime = getEdgeRuntime(); // 'cloudflare' | 'vercel' | 'deno'
+}
+
+// Extract geo from any request
+const geo = getGeoFromRequest(request);
+```
+
+## License
+
+MIT

package/dist/adapters/cloudflare.d.ts

@@ -0,0 +1,101 @@
+import { EdgeHandler } from '../index.js';
+import 'undici';
+
+/**
+ * Cloudflare Workers Adapter
+ *
+ * Convert a Flight edge handler to a Cloudflare Workers ExportedHandler.
+ *
+ * @example
+ * ```typescript
+ * // src/worker.ts
+ * import { createEdgeHandler } from '@flightdev/edge';
+ * import { createCloudflareHandler } from '@flightdev/edge/cloudflare';
+ *
+ * const handler = createEdgeHandler((request, ctx) => {
+ *     return new Response(`Hello from ${ctx.geo.country}!`);
+ * });
+ *
+ * export default createCloudflareHandler(handler);
+ * ```
+ */
+
+interface CloudflareExecutionContext {
+    waitUntil(promise: Promise<unknown>): void;
+    passThroughOnException(): void;
+}
+type CloudflareEnv = Record<string, unknown>;
+interface CloudflareExportedHandler {
+    fetch(request: Request, env: CloudflareEnv, ctx: CloudflareExecutionContext): Response | Promise<Response>;
+}
+/**
+ * Create a Cloudflare Workers compatible handler from a Flight edge handler.
+ *
+ * This adapter:
+ * - Extracts geo data from the `cf` object on the request
+ * - Provides `waitUntil` and `passThroughOnException` from execution context
+ * - Exposes environment bindings
+ *
+ * @param handler - Flight edge handler
+ * @returns Cloudflare ExportedHandler object
+ *
+ * @example
+ * ```typescript
+ * import { createEdgeHandler } from '@flightdev/edge';
+ * import { createCloudflareHandler } from '@flightdev/edge/cloudflare';
+ *
+ * const handler = createEdgeHandler(async (request, ctx) => {
+ *     // Geo data from Cloudflare
+ *     const { country, city, timezone } = ctx.geo;
+ *
+ *     // Cloudflare-specific properties
+ *     const isBot = ctx.cf?.isBot;
+ *     const colo = ctx.cf?.colo;
+ *
+ *     // Access environment bindings (KV, R2, D1, etc.)
+ *     const kv = ctx.env?.MY_KV as KVNamespace;
+ *
+ *     // Fire and forget analytics
+ *     ctx.waitUntil(trackAnalytics({ country, path: request.url }));
+ *
+ *     return Response.json({ country, city, isBot, colo });
+ * });
+ *
+ * export default createCloudflareHandler(handler);
+ * ```
+ */
+declare function createCloudflareHandler(handler: EdgeHandler): CloudflareExportedHandler;
+/**
+ * Create a Cloudflare Pages Function handler.
+ * Similar to Worker but adapted for Pages Functions context.
+ *
+ * @param handler - Flight edge handler
+ * @returns Pages Function handler
+ */
+declare function createPagesHandler(handler: EdgeHandler): (context: {
+    request: Request;
+    env: CloudflareEnv;
+    waitUntil: (promise: Promise<unknown>) => void;
+    passThroughToOrigin: () => void;
+}) => Promise<Response>;
+/**
+ * Check if running in Cloudflare Workers environment.
+ */
+declare function isCloudflareWorker(): boolean;
+/**
+ * Get the colo (data center) that served the request.
+ * Useful for debugging and analytics.
+ */
+declare function getColo(request: Request): string | undefined;
+/**
+ * Check if the request is from a known bot.
+ * Uses Cloudflare's bot detection.
+ */
+declare function isBot(request: Request): boolean;
+/**
+ * Get bot score (0-100). Only available on Enterprise plans.
+ * Lower score = more likely to be a bot.
+ */
+declare function getBotScore(request: Request): number | undefined;
+
+export { createCloudflareHandler, createPagesHandler, getBotScore, getColo, isBot, isCloudflareWorker };

package/dist/adapters/cloudflare.js

@@ -0,0 +1,76 @@
+// src/adapters/cloudflare.ts
+function createCloudflareHandler(handler) {
+  return {
+    async fetch(request, env, ctx) {
+      const cf = request.cf;
+      const geo = {
+        country: cf?.country,
+        city: cf?.city,
+        region: cf?.region ?? cf?.regionCode,
+        latitude: cf?.latitude,
+        longitude: cf?.longitude,
+        timezone: cf?.timezone,
+        continent: cf?.continent,
+        postalCode: cf?.postalCode,
+        metroCode: cf?.metroCode
+      };
+      const cfProperties = {
+        asn: cf?.asn,
+        asOrganization: cf?.asOrganization,
+        colo: cf?.colo,
+        httpProtocol: cf?.httpProtocol,
+        requestPriority: cf?.requestPriority,
+        tlsCipher: cf?.tlsCipher,
+        tlsVersion: cf?.tlsVersion,
+        isBot: cf?.isBot,
+        botScore: cf?.botScore,
+        verifiedBotCategory: cf?.verifiedBotCategory
+      };
+      const edgeContext = {
+        geo,
+        cf: cfProperties,
+        env,
+        waitUntil: ctx.waitUntil.bind(ctx),
+        passThroughOnException: ctx.passThroughOnException.bind(ctx)
+      };
+      return handler(request, edgeContext);
+    }
+  };
+}
+function createPagesHandler(handler) {
+  return async (context) => {
+    const cf = context.request.cf;
+    const geo = {
+      country: cf?.country,
+      city: cf?.city,
+      region: cf?.region,
+      latitude: cf?.latitude,
+      longitude: cf?.longitude,
+      timezone: cf?.timezone
+    };
+    const edgeContext = {
+      geo,
+      cf,
+      env: context.env,
+      waitUntil: context.waitUntil,
+      passThroughOnException: context.passThroughToOrigin
+    };
+    return handler(context.request, edgeContext);
+  };
+}
+function isCloudflareWorker() {
+  return typeof globalThis.WebSocketPair !== "undefined" && typeof globalThis.caches !== "undefined";
+}
+function getColo(request) {
+  return request.cf?.colo;
+}
+function isBot(request) {
+  return request.cf?.isBot ?? false;
+}
+function getBotScore(request) {
+  return request.cf?.botScore;
+}
+
+export { createCloudflareHandler, createPagesHandler, getBotScore, getColo, isBot, isCloudflareWorker };
+//# sourceMappingURL=cloudflare.js.map
+//# sourceMappingURL=cloudflare.js.map

package/dist/adapters/cloudflare.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/cloudflare.ts"],"names":[],"mappings":";AAuGO,SAAS,wBAAwB,OAAA,EAAiD;AACrF,EAAA,OAAO;AAAA,IACH,MAAM,KAAA,CACF,OAAA,EACA,GAAA,EACA,GAAA,EACiB;AAEjB,MAAA,MAAM,KAAM,OAAA,CAAgB,EAAA;AAG5B,MAAA,MAAM,GAAA,GAAe;AAAA,QACjB,SAAS,EAAA,EAAI,OAAA;AAAA,QACb,MAAM,EAAA,EAAI,IAAA;AAAA,QACV,MAAA,EAAQ,EAAA,EAAI,MAAA,IAAU,EAAA,EAAI,UAAA;AAAA,QAC1B,UAAU,EAAA,EAAI,QAAA;AAAA,QACd,WAAW,EAAA,EAAI,SAAA;AAAA,QACf,UAAU,EAAA,EAAI,QAAA;AAAA,QACd,WAAW,EAAA,EAAI,SAAA;AAAA,QACf,YAAY,EAAA,EAAI,UAAA;AAAA,QAChB,WAAW,EAAA,EAAI;AAAA,OACnB;AAGA,MAAA,MAAM,YAAA,GAAqC;AAAA,QACvC,KAAK,EAAA,EAAI,GAAA;AAAA,QACT,gBAAgB,EAAA,EAAI,cAAA;AAAA,QACpB,MAAM,EAAA,EAAI,IAAA;AAAA,QACV,cAAc,EAAA,EAAI,YAAA;AAAA,QAClB,iBAAiB,EAAA,EAAI,eAAA;AAAA,QACrB,WAAW,EAAA,EAAI,SAAA;AAAA,QACf,YAAY,EAAA,EAAI,UAAA;AAAA,QAChB,OAAO,EAAA,EAAI,KAAA;AAAA,QACX,UAAU,EAAA,EAAI,QAAA;AAAA,QACd,qBAAqB,EAAA,EAAI;AAAA,OAC7B;AAGA,MAAA,MAAM,WAAA,GAA2B;AAAA,QAC7B,GAAA;AAAA,QACA,EAAA,EAAI,YAAA;AAAA,QACJ,GAAA;AAAA,QACA,SAAA,EAAW,GAAA,CAAI,SAAA,CAAU,IAAA,CAAK,GAAG,CAAA;AAAA,QACjC,sBAAA,EAAwB,GAAA,CAAI,sBAAA,CAAuB,IAAA,CAAK,GAAG;AAAA,OAC/D;AAEA,MAAA,OAAO,OAAA,CAAQ,SAAS,WAAW,CAAA;AAAA,IACvC;AAAA,GACJ;AACJ;AASO,SAAS,mBAAmB,OAAA,EAAsB;AACrD,EAAA,OAAO,OAAO,OAAA,KAKW;AACrB,IAAA,MAAM,EAAA,GAAM,QAAQ,OAAA,CAAgB,EAAA;AAEpC,IAAA,MAAM,GAAA,GAAe;AAAA,MACjB,SAAS,EAAA,EAAI,OAAA;AAAA,MACb,MAAM,EAAA,EAAI,IAAA;AAAA,MACV,QAAQ,EAAA,EAAI,MAAA;AAAA,MACZ,UAAU,EAAA,EAAI,QAAA;AAAA,MACd,WAAW,EAAA,EAAI,SAAA;AAAA,MACf,UAAU,EAAA,EAAI;AAAA,KAClB;AAEA,IAAA,MAAM,WAAA,GAA2B;AAAA,MAC7B,GAAA;AAAA,MACA,EAAA;AAAA,MACA,KAAK,OAAA,CAAQ,GAAA;AAAA,MACb,WAAW,OAAA,CAAQ,SAAA;AAAA,MACnB,wBAAwB,OAAA,CAAQ;AAAA,KACpC;AAEA,IAAA,OAAO,OAAA,CAAQ,OAAA,CAAQ,OAAA,EAAS,WAAW,CAAA;AAAA,EAC/C,CAAA;AACJ;AASO,SAAS,kBAAA,GAA8B;AAC1C,EAAA,OAAO,OAAQ,UAAA,CAAmB,aAAA,KAAkB,WAAA,IAChD,OAAQ,WAAmB,MAAA,KAAW,WAAA;AAC9C;AAMO,SAAS,QAAQ,OAAA,EAAsC;AAC1D,EAAA,OAAS,QAAgB,EAAA,EAAoC,IAAA;AACjE;AAMO,SAAS,MAAM,OAAA,EAA2B;AAC7C,EAAA,OAAS,OAAA,CAAgB,IAAoC,KAAA,IAAS,KAAA;AAC1E;AAMO,SAAS,YAAY,OAAA,EAAsC;AAC9D,EAAA,OAAS,QAAgB,EAAA,EAAoC,QAAA;AACjE","file":"cloudflare.js","sourcesContent":["/**\r\n * Cloudflare Workers Adapter\r\n * \r\n * Convert a Flight edge handler to a Cloudflare Workers ExportedHandler.\r\n * \r\n * @example\r\n * ```typescript\r\n * // src/worker.ts\r\n * import { createEdgeHandler } from '@flightdev/edge';\r\n * import { createCloudflareHandler } from '@flightdev/edge/cloudflare';\r\n * \r\n * const handler = createEdgeHandler((request, ctx) => {\r\n *     return new Response(`Hello from ${ctx.geo.country}!`);\r\n * });\r\n * \r\n * export default createCloudflareHandler(handler);\r\n * ```\r\n */\r\n\r\nimport type { EdgeHandler, EdgeContext, EdgeGeo, CloudflareProperties } from '../index';\r\n\r\n// =============================================================================\r\n// Cloudflare Types (no external dependency required)\r\n// =============================================================================\r\n\r\ninterface IncomingRequestCfProperties {\r\n    asn?: number;\r\n    asOrganization?: string;\r\n    city?: string;\r\n    colo?: string;\r\n    continent?: string;\r\n    country?: string;\r\n    httpProtocol?: string;\r\n    latitude?: string;\r\n    longitude?: string;\r\n    metroCode?: string;\r\n    postalCode?: string;\r\n    region?: string;\r\n    regionCode?: string;\r\n    timezone?: string;\r\n    isBot?: boolean;\r\n    botScore?: number;\r\n    verifiedBotCategory?: string;\r\n    requestPriority?: string;\r\n    tlsCipher?: string;\r\n    tlsVersion?: string;\r\n}\r\n\r\ninterface CloudflareExecutionContext {\r\n    waitUntil(promise: Promise<unknown>): void;\r\n    passThroughOnException(): void;\r\n}\r\n\r\ntype CloudflareEnv = Record<string, unknown>;\r\n\r\ninterface CloudflareExportedHandler {\r\n    fetch(\r\n        request: Request,\r\n        env: CloudflareEnv,\r\n        ctx: CloudflareExecutionContext\r\n    ): Response | Promise<Response>;\r\n}\r\n\r\n// =============================================================================\r\n// Adapter Implementation\r\n// =============================================================================\r\n\r\n/**\r\n * Create a Cloudflare Workers compatible handler from a Flight edge handler.\r\n * \r\n * This adapter:\r\n * - Extracts geo data from the `cf` object on the request\r\n * - Provides `waitUntil` and `passThroughOnException` from execution context\r\n * - Exposes environment bindings\r\n * \r\n * @param handler - Flight edge handler\r\n * @returns Cloudflare ExportedHandler object\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createEdgeHandler } from '@flightdev/edge';\r\n * import { createCloudflareHandler } from '@flightdev/edge/cloudflare';\r\n * \r\n * const handler = createEdgeHandler(async (request, ctx) => {\r\n *     // Geo data from Cloudflare\r\n *     const { country, city, timezone } = ctx.geo;\r\n *     \r\n *     // Cloudflare-specific properties\r\n *     const isBot = ctx.cf?.isBot;\r\n *     const colo = ctx.cf?.colo;\r\n *     \r\n *     // Access environment bindings (KV, R2, D1, etc.)\r\n *     const kv = ctx.env?.MY_KV as KVNamespace;\r\n *     \r\n *     // Fire and forget analytics\r\n *     ctx.waitUntil(trackAnalytics({ country, path: request.url }));\r\n *     \r\n *     return Response.json({ country, city, isBot, colo });\r\n * });\r\n * \r\n * export default createCloudflareHandler(handler);\r\n * ```\r\n */\r\nexport function createCloudflareHandler(handler: EdgeHandler): CloudflareExportedHandler {\r\n    return {\r\n        async fetch(\r\n            request: Request,\r\n            env: CloudflareEnv,\r\n            ctx: CloudflareExecutionContext\r\n        ): Promise<Response> {\r\n            // Extract cf properties from request\r\n            const cf = (request as any).cf as IncomingRequestCfProperties | undefined;\r\n\r\n            // Build geo object from cf data\r\n            const geo: EdgeGeo = {\r\n                country: cf?.country,\r\n                city: cf?.city,\r\n                region: cf?.region ?? cf?.regionCode,\r\n                latitude: cf?.latitude,\r\n                longitude: cf?.longitude,\r\n                timezone: cf?.timezone,\r\n                continent: cf?.continent,\r\n                postalCode: cf?.postalCode,\r\n                metroCode: cf?.metroCode,\r\n            };\r\n\r\n            // Build Cloudflare-specific properties\r\n            const cfProperties: CloudflareProperties = {\r\n                asn: cf?.asn,\r\n                asOrganization: cf?.asOrganization,\r\n                colo: cf?.colo,\r\n                httpProtocol: cf?.httpProtocol,\r\n                requestPriority: cf?.requestPriority,\r\n                tlsCipher: cf?.tlsCipher,\r\n                tlsVersion: cf?.tlsVersion,\r\n                isBot: cf?.isBot,\r\n                botScore: cf?.botScore,\r\n                verifiedBotCategory: cf?.verifiedBotCategory,\r\n            };\r\n\r\n            // Create unified EdgeContext\r\n            const edgeContext: EdgeContext = {\r\n                geo,\r\n                cf: cfProperties,\r\n                env,\r\n                waitUntil: ctx.waitUntil.bind(ctx),\r\n                passThroughOnException: ctx.passThroughOnException.bind(ctx),\r\n            };\r\n\r\n            return handler(request, edgeContext);\r\n        },\r\n    };\r\n}\r\n\r\n/**\r\n * Create a Cloudflare Pages Function handler.\r\n * Similar to Worker but adapted for Pages Functions context.\r\n * \r\n * @param handler - Flight edge handler\r\n * @returns Pages Function handler\r\n */\r\nexport function createPagesHandler(handler: EdgeHandler) {\r\n    return async (context: {\r\n        request: Request;\r\n        env: CloudflareEnv;\r\n        waitUntil: (promise: Promise<unknown>) => void;\r\n        passThroughToOrigin: () => void;\r\n    }): Promise<Response> => {\r\n        const cf = (context.request as any).cf as IncomingRequestCfProperties | undefined;\r\n\r\n        const geo: EdgeGeo = {\r\n            country: cf?.country,\r\n            city: cf?.city,\r\n            region: cf?.region,\r\n            latitude: cf?.latitude,\r\n            longitude: cf?.longitude,\r\n            timezone: cf?.timezone,\r\n        };\r\n\r\n        const edgeContext: EdgeContext = {\r\n            geo,\r\n            cf: cf as CloudflareProperties,\r\n            env: context.env,\r\n            waitUntil: context.waitUntil,\r\n            passThroughOnException: context.passThroughToOrigin,\r\n        };\r\n\r\n        return handler(context.request, edgeContext);\r\n    };\r\n}\r\n\r\n// =============================================================================\r\n// Utilities\r\n// =============================================================================\r\n\r\n/**\r\n * Check if running in Cloudflare Workers environment.\r\n */\r\nexport function isCloudflareWorker(): boolean {\r\n    return typeof (globalThis as any).WebSocketPair !== 'undefined' &&\r\n        typeof (globalThis as any).caches !== 'undefined';\r\n}\r\n\r\n/**\r\n * Get the colo (data center) that served the request.\r\n * Useful for debugging and analytics.\r\n */\r\nexport function getColo(request: Request): string | undefined {\r\n    return ((request as any).cf as IncomingRequestCfProperties)?.colo;\r\n}\r\n\r\n/**\r\n * Check if the request is from a known bot.\r\n * Uses Cloudflare's bot detection.\r\n */\r\nexport function isBot(request: Request): boolean {\r\n    return ((request as any).cf as IncomingRequestCfProperties)?.isBot ?? false;\r\n}\r\n\r\n/**\r\n * Get bot score (0-100). Only available on Enterprise plans.\r\n * Lower score = more likely to be a bot.\r\n */\r\nexport function getBotScore(request: Request): number | undefined {\r\n    return ((request as any).cf as IncomingRequestCfProperties)?.botScore;\r\n}\r\n"]}

package/dist/adapters/deno.d.ts

@@ -0,0 +1,96 @@
+import { EdgeHandler } from '../index.js';
+import 'undici';
+
+/**
+ * Deno Deploy Adapter
+ *
+ * Convert a Flight edge handler to work with Deno.serve().
+ *
+ * @example
+ * ```typescript
+ * // server.ts
+ * import { createEdgeHandler } from '@flightdev/edge';
+ * import { createDenoHandler, serve } from '@flightdev/edge/deno';
+ *
+ * const handler = createEdgeHandler((request, ctx) => {
+ *     return new Response(`Hello from ${ctx.geo.country}!`);
+ * });
+ *
+ * serve(createDenoHandler(handler), { port: 8000 });
+ * ```
+ */
+
+interface DenoServeHandlerInfo {
+    remoteAddr: {
+        hostname: string;
+        port: number;
+        transport: 'tcp' | 'udp';
+    };
+}
+interface DenoServeOptions {
+    port?: number;
+    hostname?: string;
+    signal?: AbortSignal;
+    onListen?: (params: {
+        hostname: string;
+        port: number;
+    }) => void;
+    onError?: (error: Error) => Response | Promise<Response>;
+}
+/**
+ * Create a Deno.serve compatible handler from a Flight edge handler.
+ *
+ * Note: Deno Deploy provides limited geo data compared to Cloudflare.
+ * Geo extraction relies on third-party services or custom headers.
+ *
+ * @param handler - Flight edge handler
+ * @returns Deno-compatible fetch handler
+ *
+ * @example
+ * ```typescript
+ * import { createEdgeHandler } from '@flightdev/edge';
+ * import { createDenoHandler } from '@flightdev/edge/deno';
+ *
+ * const handler = createEdgeHandler((req, ctx) => {
+ *     // Geo may be limited on Deno Deploy
+ *     const { country } = ctx.geo;
+ *
+ *     ctx.waitUntil(logRequest(req));
+ *
+ *     return Response.json({ message: 'Hello from Deno!', country });
+ * });
+ *
+ * Deno.serve(createDenoHandler(handler));
+ * ```
+ */
+declare function createDenoHandler(handler: EdgeHandler): (request: Request, info?: DenoServeHandlerInfo) => Promise<Response>;
+/**
+ * Convenience wrapper for Deno.serve with Flight handler.
+ *
+ * @example
+ * ```typescript
+ * import { createEdgeHandler } from '@flightdev/edge';
+ * import { serve } from '@flightdev/edge/deno';
+ *
+ * const handler = createEdgeHandler((req, ctx) => {
+ *     return new Response('Hello!');
+ * });
+ *
+ * serve(handler, { port: 8000 });
+ * ```
+ */
+declare function serve(handler: EdgeHandler, options?: DenoServeOptions): void;
+/**
+ * Check if running in Deno runtime.
+ */
+declare function isDeno(): boolean;
+/**
+ * Check if running in Deno Deploy (as opposed to local Deno).
+ */
+declare function isDenoDeployment(): boolean;
+/**
+ * Get the deployment region on Deno Deploy.
+ */
+declare function getDenoRegion(): string | undefined;
+
+export { createDenoHandler, getDenoRegion, isDeno, isDenoDeployment, serve };

package/dist/adapters/deno.js

@@ -0,0 +1,69 @@
+// src/adapters/deno.ts
+function createDenoHandler(handler) {
+  const pendingPromises = [];
+  return async (request, info) => {
+    const geo = extractGeoFromHeaders(request.headers);
+    const edgeContext = {
+      geo,
+      waitUntil: (promise) => {
+        pendingPromises.push(promise);
+      }
+    };
+    try {
+      const response = await handler(request, edgeContext);
+      if (pendingPromises.length > 0) {
+        Promise.allSettled(pendingPromises).catch(console.error);
+        pendingPromises.length = 0;
+      }
+      return response;
+    } catch (error) {
+      console.error("[Deno Edge] Handler error:", error);
+      return new Response("Internal Server Error", { status: 500 });
+    }
+  };
+}
+function serve(handler, options = {}) {
+  const denoHandler = createDenoHandler(handler);
+  if (typeof globalThis.Deno === "undefined") {
+    throw new Error("Deno runtime is not available. Are you running in Deno?");
+  }
+  const Deno = globalThis.Deno;
+  Deno.serve({
+    port: options.port ?? 8e3,
+    hostname: options.hostname ?? "0.0.0.0",
+    signal: options.signal,
+    onListen: options.onListen ?? (({ hostname, port }) => {
+      console.log(`[Flight Edge] Server running at http://${hostname}:${port}`);
+    }),
+    onError: options.onError ?? ((error) => {
+      console.error("[Flight Edge] Server error:", error);
+      return new Response("Internal Server Error", { status: 500 });
+    })
+  }, denoHandler);
+}
+function extractGeoFromHeaders(headers) {
+  return {
+    // Common geo headers from reverse proxies
+    country: headers.get("cf-ipcountry") ?? headers.get("x-country-code") ?? headers.get("x-geo-country") ?? void 0,
+    city: headers.get("cf-ipcity") ?? headers.get("x-city") ?? headers.get("x-geo-city") ?? void 0,
+    region: headers.get("cf-region") ?? headers.get("x-region") ?? headers.get("x-geo-region") ?? void 0,
+    latitude: headers.get("x-latitude") ?? headers.get("x-geo-latitude") ?? void 0,
+    longitude: headers.get("x-longitude") ?? headers.get("x-geo-longitude") ?? void 0,
+    timezone: headers.get("x-timezone") ?? headers.get("x-geo-timezone") ?? void 0
+  };
+}
+function isDeno() {
+  return typeof globalThis.Deno !== "undefined";
+}
+function isDenoDeployment() {
+  const Deno = globalThis.Deno;
+  return Deno?.env?.get("DENO_DEPLOYMENT_ID") !== void 0;
+}
+function getDenoRegion() {
+  const Deno = globalThis.Deno;
+  return Deno?.env?.get("DENO_REGION");
+}
+
+export { createDenoHandler, getDenoRegion, isDeno, isDenoDeployment, serve };
+//# sourceMappingURL=deno.js.map
+//# sourceMappingURL=deno.js.map

package/dist/adapters/deno.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/deno.ts"],"names":[],"mappings":"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","file":"deno.js","sourcesContent":["/**\r\n * Deno Deploy Adapter\r\n * \r\n * Convert a Flight edge handler to work with Deno.serve().\r\n * \r\n * @example\r\n * ```typescript\r\n * // server.ts\r\n * import { createEdgeHandler } from '@flightdev/edge';\r\n * import { createDenoHandler, serve } from '@flightdev/edge/deno';\r\n * \r\n * const handler = createEdgeHandler((request, ctx) => {\r\n *     return new Response(`Hello from ${ctx.geo.country}!`);\r\n * });\r\n * \r\n * serve(createDenoHandler(handler), { port: 8000 });\r\n * ```\r\n */\r\n\r\nimport type { EdgeHandler, EdgeContext, EdgeGeo } from '../index';\r\n\r\n// =============================================================================\r\n// Deno Types\r\n// =============================================================================\r\n\r\ninterface DenoServeHandlerInfo {\r\n    remoteAddr: {\r\n        hostname: string;\r\n        port: number;\r\n        transport: 'tcp' | 'udp';\r\n    };\r\n}\r\n\r\ninterface DenoServeOptions {\r\n    port?: number;\r\n    hostname?: string;\r\n    signal?: AbortSignal;\r\n    onListen?: (params: { hostname: string; port: number }) => void;\r\n    onError?: (error: Error) => Response | Promise<Response>;\r\n}\r\n\r\n// =============================================================================\r\n// Adapter Implementation\r\n// =============================================================================\r\n\r\n/**\r\n * Create a Deno.serve compatible handler from a Flight edge handler.\r\n * \r\n * Note: Deno Deploy provides limited geo data compared to Cloudflare.\r\n * Geo extraction relies on third-party services or custom headers.\r\n * \r\n * @param handler - Flight edge handler\r\n * @returns Deno-compatible fetch handler\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createEdgeHandler } from '@flightdev/edge';\r\n * import { createDenoHandler } from '@flightdev/edge/deno';\r\n * \r\n * const handler = createEdgeHandler((req, ctx) => {\r\n *     // Geo may be limited on Deno Deploy\r\n *     const { country } = ctx.geo;\r\n *     \r\n *     ctx.waitUntil(logRequest(req));\r\n *     \r\n *     return Response.json({ message: 'Hello from Deno!', country });\r\n * });\r\n * \r\n * Deno.serve(createDenoHandler(handler));\r\n * ```\r\n */\r\nexport function createDenoHandler(handler: EdgeHandler) {\r\n    // Store pending promises for waitUntil\r\n    const pendingPromises: Promise<unknown>[] = [];\r\n\r\n    return async (\r\n        request: Request,\r\n        info?: DenoServeHandlerInfo\r\n    ): Promise<Response> => {\r\n        // Extract geo from headers (if provided by reverse proxy)\r\n        const geo: EdgeGeo = extractGeoFromHeaders(request.headers);\r\n\r\n        // Create EdgeContext\r\n        const edgeContext: EdgeContext = {\r\n            geo,\r\n            waitUntil: (promise: Promise<unknown>) => {\r\n                pendingPromises.push(promise);\r\n            },\r\n        };\r\n\r\n        try {\r\n            const response = await handler(request, edgeContext);\r\n\r\n            // Wait for all pending promises after response\r\n            if (pendingPromises.length > 0) {\r\n                // Don't await - let them run in background\r\n                Promise.allSettled(pendingPromises).catch(console.error);\r\n                pendingPromises.length = 0;\r\n            }\r\n\r\n            return response;\r\n        } catch (error) {\r\n            console.error('[Deno Edge] Handler error:', error);\r\n            return new Response('Internal Server Error', { status: 500 });\r\n        }\r\n    };\r\n}\r\n\r\n/**\r\n * Convenience wrapper for Deno.serve with Flight handler.\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createEdgeHandler } from '@flightdev/edge';\r\n * import { serve } from '@flightdev/edge/deno';\r\n * \r\n * const handler = createEdgeHandler((req, ctx) => {\r\n *     return new Response('Hello!');\r\n * });\r\n * \r\n * serve(handler, { port: 8000 });\r\n * ```\r\n */\r\nexport function serve(\r\n    handler: EdgeHandler,\r\n    options: DenoServeOptions = {}\r\n): void {\r\n    const denoHandler = createDenoHandler(handler);\r\n\r\n    // Check if Deno is available\r\n    if (typeof (globalThis as any).Deno === 'undefined') {\r\n        throw new Error('Deno runtime is not available. Are you running in Deno?');\r\n    }\r\n\r\n    const Deno = (globalThis as any).Deno;\r\n\r\n    Deno.serve({\r\n        port: options.port ?? 8000,\r\n        hostname: options.hostname ?? '0.0.0.0',\r\n        signal: options.signal,\r\n        onListen: options.onListen ?? (({ hostname, port }: { hostname: string; port: number }) => {\r\n            console.log(`[Flight Edge] Server running at http://${hostname}:${port}`);\r\n        }),\r\n        onError: options.onError ?? ((error: Error) => {\r\n            console.error('[Flight Edge] Server error:', error);\r\n            return new Response('Internal Server Error', { status: 500 });\r\n        }),\r\n    }, denoHandler);\r\n}\r\n\r\n// =============================================================================\r\n// Utilities\r\n// =============================================================================\r\n\r\n/**\r\n * Extract geo from headers.\r\n * Deno Deploy doesn't provide geo by default - these come from reverse proxy.\r\n */\r\nfunction extractGeoFromHeaders(headers: Headers): EdgeGeo {\r\n    return {\r\n        // Common geo headers from reverse proxies\r\n        country: headers.get('cf-ipcountry') ??\r\n            headers.get('x-country-code') ??\r\n            headers.get('x-geo-country') ??\r\n            undefined,\r\n        city: headers.get('cf-ipcity') ??\r\n            headers.get('x-city') ??\r\n            headers.get('x-geo-city') ??\r\n            undefined,\r\n        region: headers.get('cf-region') ??\r\n            headers.get('x-region') ??\r\n            headers.get('x-geo-region') ??\r\n            undefined,\r\n        latitude: headers.get('x-latitude') ??\r\n            headers.get('x-geo-latitude') ??\r\n            undefined,\r\n        longitude: headers.get('x-longitude') ??\r\n            headers.get('x-geo-longitude') ??\r\n            undefined,\r\n        timezone: headers.get('x-timezone') ??\r\n            headers.get('x-geo-timezone') ??\r\n            undefined,\r\n    };\r\n}\r\n\r\n/**\r\n * Check if running in Deno runtime.\r\n */\r\nexport function isDeno(): boolean {\r\n    return typeof (globalThis as any).Deno !== 'undefined';\r\n}\r\n\r\n/**\r\n * Check if running in Deno Deploy (as opposed to local Deno).\r\n */\r\nexport function isDenoDeployment(): boolean {\r\n    const Deno = (globalThis as any).Deno;\r\n    return Deno?.env?.get('DENO_DEPLOYMENT_ID') !== undefined;\r\n}\r\n\r\n/**\r\n * Get the deployment region on Deno Deploy.\r\n */\r\nexport function getDenoRegion(): string | undefined {\r\n    const Deno = (globalThis as any).Deno;\r\n    return Deno?.env?.get('DENO_REGION');\r\n}\r\n"]}

package/dist/adapters/vercel.d.ts

@@ -0,0 +1,111 @@
+import { EdgeHandler } from '../index.js';
+import 'undici';
+
+/**
+ * Vercel Edge Adapter
+ *
+ * Convert a Flight edge handler to work with Vercel Edge Runtime.
+ *
+ * @example
+ * ```typescript
+ * // app/api/geo/route.ts
+ * import { createEdgeHandler } from '@flightdev/edge';
+ * import { createVercelHandler } from '@flightdev/edge/vercel';
+ *
+ * const handler = createEdgeHandler((request, ctx) => {
+ *     return Response.json({ country: ctx.geo.country });
+ * });
+ *
+ * export const GET = createVercelHandler(handler);
+ * export const runtime = 'edge';
+ * ```
+ */
+
+interface VercelGeo {
+    city?: string;
+    country?: string;
+    countryRegion?: string;
+    latitude?: string;
+    longitude?: string;
+    region?: string;
+}
+interface VercelRequestContext {
+    geo?: VercelGeo;
+    ip?: string;
+    waitUntil?: (promise: Promise<unknown>) => void;
+}
+/**
+ * Create a Vercel Edge Runtime compatible handler from a Flight edge handler.
+ *
+ * This adapter:
+ * - Extracts geo data from Vercel's geo headers
+ * - Provides waitUntil when available
+ * - Works with Next.js Edge API Routes and Middleware
+ *
+ * @param handler - Flight edge handler
+ * @returns Vercel-compatible fetch handler
+ *
+ * @example
+ * ```typescript
+ * // Next.js App Router
+ * // app/api/location/route.ts
+ * import { createEdgeHandler } from '@flightdev/edge';
+ * import { createVercelHandler } from '@flightdev/edge/vercel';
+ *
+ * const handler = createEdgeHandler((req, ctx) => {
+ *     const { country, city, region } = ctx.geo;
+ *
+ *     // Redirect based on country
+ *     if (country === 'AR') {
+ *         return Response.redirect('https://ar.example.com');
+ *     }
+ *
+ *     return Response.json({ country, city, region });
+ * });
+ *
+ * export const GET = createVercelHandler(handler);
+ * export const runtime = 'edge';
+ * ```
+ */
+declare function createVercelHandler(handler: EdgeHandler): (request: Request, context?: VercelRequestContext) => Promise<Response>;
+/**
+ * Create a Vercel Edge Middleware compatible handler.
+ *
+ * @example
+ * ```typescript
+ * // middleware.ts
+ * import { createEdgeHandler } from '@flightdev/edge';
+ * import { createMiddlewareHandler } from '@flightdev/edge/vercel';
+ *
+ * const handler = createEdgeHandler((req, ctx) => {
+ *     // Block certain countries
+ *     if (ctx.geo.country === 'XX') {
+ *         return new Response('Access Denied', { status: 403 });
+ *     }
+ *
+ *     // Continue to next middleware/route
+ *     return null as any; // Return NextResponse.next() in actual usage
+ * });
+ *
+ * export default createMiddlewareHandler(handler);
+ *
+ * export const config = {
+ *     matcher: '/api/:path*',
+ * };
+ * ```
+ */
+declare function createMiddlewareHandler(handler: EdgeHandler): (request: Request) => Promise<Response>;
+/**
+ * Check if running in Vercel Edge Runtime.
+ */
+declare function isVercelEdge(): boolean;
+/**
+ * Get the deployment region.
+ */
+declare function getDeploymentRegion(request: Request): string | undefined;
+/**
+ * Get client IP address.
+ */
+declare function getClientIP(request: Request): string | undefined;
+
+export { createMiddlewareHandler, createVercelHandler, getClientIP, getDeploymentRegion, isVercelEdge };

package/dist/adapters/vercel.js

@@ -0,0 +1,53 @@
+// src/adapters/vercel.ts
+function createVercelHandler(handler) {
+  return async (request, context) => {
+    const geo = extractGeoFromHeaders(request.headers);
+    if (context?.geo) {
+      geo.city = context.geo.city ?? geo.city;
+      geo.country = context.geo.country ?? geo.country;
+      geo.region = context.geo.countryRegion ?? context.geo.region ?? geo.region;
+      geo.latitude = context.geo.latitude ?? geo.latitude;
+      geo.longitude = context.geo.longitude ?? geo.longitude;
+    }
+    const edgeContext = {
+      geo,
+      waitUntil: context?.waitUntil ?? (() => {
+      })
+    };
+    return handler(request, edgeContext);
+  };
+}
+function createMiddlewareHandler(handler) {
+  return async (request) => {
+    const geo = extractGeoFromHeaders(request.headers);
+    const edgeContext = {
+      geo,
+      waitUntil: () => {
+      }
+    };
+    return handler(request, edgeContext);
+  };
+}
+function extractGeoFromHeaders(headers) {
+  return {
+    country: headers.get("x-vercel-ip-country") ?? void 0,
+    city: headers.get("x-vercel-ip-city") ? decodeURIComponent(headers.get("x-vercel-ip-city")) : void 0,
+    region: headers.get("x-vercel-ip-country-region") ?? void 0,
+    latitude: headers.get("x-vercel-ip-latitude") ?? void 0,
+    longitude: headers.get("x-vercel-ip-longitude") ?? void 0,
+    timezone: headers.get("x-vercel-ip-timezone") ?? void 0
+  };
+}
+function isVercelEdge() {
+  return typeof globalThis.EdgeRuntime !== "undefined";
+}
+function getDeploymentRegion(request) {
+  return request.headers.get("x-vercel-deployment-url")?.split(".")[0];
+}
+function getClientIP(request) {
+  return request.headers.get("x-forwarded-for")?.split(",")[0]?.trim() ?? request.headers.get("x-real-ip") ?? void 0;
+}
+
+export { createMiddlewareHandler, createVercelHandler, getClientIP, getDeploymentRegion, isVercelEdge };
+//# sourceMappingURL=vercel.js.map
+//# sourceMappingURL=vercel.js.map

package/dist/adapters/vercel.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/vercel.ts"],"names":[],"mappings":";AA8EO,SAAS,oBAAoB,OAAA,EAAsB;AACtD,EAAA,OAAO,OACH,SACA,OAAA,KACoB;AAEpB,IAAA,MAAM,GAAA,GAAe,qBAAA,CAAsB,OAAA,CAAQ,OAAO,CAAA;AAG1D,IAAA,IAAI,SAAS,GAAA,EAAK;AACd,MAAA,GAAA,CAAI,IAAA,GAAO,OAAA,CAAQ,GAAA,CAAI,IAAA,IAAQ,GAAA,CAAI,IAAA;AACnC,MAAA,GAAA,CAAI,OAAA,GAAU,OAAA,CAAQ,GAAA,CAAI,OAAA,IAAW,GAAA,CAAI,OAAA;AACzC,MAAA,GAAA,CAAI,SAAS,OAAA,CAAQ,GAAA,CAAI,iBAAiB,OAAA,CAAQ,GAAA,CAAI,UAAU,GAAA,CAAI,MAAA;AACpE,MAAA,GAAA,CAAI,QAAA,GAAW,OAAA,CAAQ,GAAA,CAAI,QAAA,IAAY,GAAA,CAAI,QAAA;AAC3C,MAAA,GAAA,CAAI,SAAA,GAAY,OAAA,CAAQ,GAAA,CAAI,SAAA,IAAa,GAAA,CAAI,SAAA;AAAA,IACjD;AAGA,IAAA,MAAM,WAAA,GAA2B;AAAA,MAC7B,GAAA;AAAA,MACA,SAAA,EAAW,OAAA,EAAS,SAAA,KAAc,MAAM;AAAA,MAAE,CAAA;AAAA,KAC9C;AAEA,IAAA,OAAO,OAAA,CAAQ,SAAS,WAAW,CAAA;AAAA,EACvC,CAAA;AACJ;AA4BO,SAAS,wBAAwB,OAAA,EAAsB;AAC1D,EAAA,OAAO,OAAO,OAAA,KAAwC;AAClD,IAAA,MAAM,GAAA,GAAM,qBAAA,CAAsB,OAAA,CAAQ,OAAO,CAAA;AAEjD,IAAA,MAAM,WAAA,GAA2B;AAAA,MAC7B,GAAA;AAAA,MACA,WAAW,MAAM;AAAA,MAAE;AAAA,KACvB;AAEA,IAAA,OAAO,OAAA,CAAQ,SAAS,WAAW,CAAA;AAAA,EACvC,CAAA;AACJ;AASA,SAAS,sBAAsB,OAAA,EAA2B;AACtD,EAAA,OAAO;AAAA,IACH,OAAA,EAAS,OAAA,CAAQ,GAAA,CAAI,qBAAqB,CAAA,IAAK,MAAA;AAAA,IAC/C,IAAA,EAAM,OAAA,CAAQ,GAAA,CAAI,kBAAkB,CAAA,GAC9B,mBAAmB,OAAA,CAAQ,GAAA,CAAI,kBAAkB,CAAE,CAAA,GACnD,MAAA;AAAA,IACN,MAAA,EAAQ,OAAA,CAAQ,GAAA,CAAI,4BAA4B,CAAA,IAAK,MAAA;AAAA,IACrD,QAAA,EAAU,OAAA,CAAQ,GAAA,CAAI,sBAAsB,CAAA,IAAK,MAAA;AAAA,IACjD,SAAA,EAAW,OAAA,CAAQ,GAAA,CAAI,uBAAuB,CAAA,IAAK,MAAA;AAAA,IACnD,QAAA,EAAU,OAAA,CAAQ,GAAA,CAAI,sBAAsB,CAAA,IAAK;AAAA,GACrD;AACJ;AAKO,SAAS,YAAA,GAAwB;AACpC,EAAA,OAAO,OAAQ,WAAmB,WAAA,KAAgB,WAAA;AACtD;AAKO,SAAS,oBAAoB,OAAA,EAAsC;AACtE,EAAA,OAAO,OAAA,CAAQ,QAAQ,GAAA,CAAI,yBAAyB,GAAG,KAAA,CAAM,GAAG,EAAE,CAAC,CAAA;AACvE;AAKO,SAAS,YAAY,OAAA,EAAsC;AAC9D,EAAA,OAAO,QAAQ,OAAA,CAAQ,GAAA,CAAI,iBAAiB,CAAA,EAAG,MAAM,GAAG,CAAA,CAAE,CAAC,CAAA,EAAG,MAAK,IAC/D,OAAA,CAAQ,OAAA,CAAQ,GAAA,CAAI,WAAW,CAAA,IAC/B,MAAA;AACR","file":"vercel.js","sourcesContent":["/**\r\n * Vercel Edge Adapter\r\n * \r\n * Convert a Flight edge handler to work with Vercel Edge Runtime.\r\n * \r\n * @example\r\n * ```typescript\r\n * // app/api/geo/route.ts\r\n * import { createEdgeHandler } from '@flightdev/edge';\r\n * import { createVercelHandler } from '@flightdev/edge/vercel';\r\n * \r\n * const handler = createEdgeHandler((request, ctx) => {\r\n *     return Response.json({ country: ctx.geo.country });\r\n * });\r\n * \r\n * export const GET = createVercelHandler(handler);\r\n * export const runtime = 'edge';\r\n * ```\r\n */\r\n\r\nimport type { EdgeHandler, EdgeContext, EdgeGeo } from '../index';\r\n\r\n// =============================================================================\r\n// Vercel Types\r\n// =============================================================================\r\n\r\ninterface VercelGeo {\r\n    city?: string;\r\n    country?: string;\r\n    countryRegion?: string;\r\n    latitude?: string;\r\n    longitude?: string;\r\n    region?: string;\r\n}\r\n\r\ninterface VercelRequestContext {\r\n    geo?: VercelGeo;\r\n    ip?: string;\r\n    waitUntil?: (promise: Promise<unknown>) => void;\r\n}\r\n\r\n// =============================================================================\r\n// Adapter Implementation\r\n// =============================================================================\r\n\r\n/**\r\n * Create a Vercel Edge Runtime compatible handler from a Flight edge handler.\r\n * \r\n * This adapter:\r\n * - Extracts geo data from Vercel's geo headers\r\n * - Provides waitUntil when available\r\n * - Works with Next.js Edge API Routes and Middleware\r\n * \r\n * @param handler - Flight edge handler\r\n * @returns Vercel-compatible fetch handler\r\n * \r\n * @example\r\n * ```typescript\r\n * // Next.js App Router\r\n * // app/api/location/route.ts\r\n * import { createEdgeHandler } from '@flightdev/edge';\r\n * import { createVercelHandler } from '@flightdev/edge/vercel';\r\n * \r\n * const handler = createEdgeHandler((req, ctx) => {\r\n *     const { country, city, region } = ctx.geo;\r\n *     \r\n *     // Redirect based on country\r\n *     if (country === 'AR') {\r\n *         return Response.redirect('https://ar.example.com');\r\n *     }\r\n *     \r\n *     return Response.json({ country, city, region });\r\n * });\r\n * \r\n * export const GET = createVercelHandler(handler);\r\n * export const runtime = 'edge';\r\n * ```\r\n */\r\nexport function createVercelHandler(handler: EdgeHandler) {\r\n    return async (\r\n        request: Request,\r\n        context?: VercelRequestContext\r\n    ): Promise<Response> => {\r\n        // Extract geo from headers (Vercel injects these)\r\n        const geo: EdgeGeo = extractGeoFromHeaders(request.headers);\r\n\r\n        // Override with context geo if available\r\n        if (context?.geo) {\r\n            geo.city = context.geo.city ?? geo.city;\r\n            geo.country = context.geo.country ?? geo.country;\r\n            geo.region = context.geo.countryRegion ?? context.geo.region ?? geo.region;\r\n            geo.latitude = context.geo.latitude ?? geo.latitude;\r\n            geo.longitude = context.geo.longitude ?? geo.longitude;\r\n        }\r\n\r\n        // Create EdgeContext\r\n        const edgeContext: EdgeContext = {\r\n            geo,\r\n            waitUntil: context?.waitUntil ?? (() => { }),\r\n        };\r\n\r\n        return handler(request, edgeContext);\r\n    };\r\n}\r\n\r\n/**\r\n * Create a Vercel Edge Middleware compatible handler.\r\n * \r\n * @example\r\n * ```typescript\r\n * // middleware.ts\r\n * import { createEdgeHandler } from '@flightdev/edge';\r\n * import { createMiddlewareHandler } from '@flightdev/edge/vercel';\r\n * \r\n * const handler = createEdgeHandler((req, ctx) => {\r\n *     // Block certain countries\r\n *     if (ctx.geo.country === 'XX') {\r\n *         return new Response('Access Denied', { status: 403 });\r\n *     }\r\n *     \r\n *     // Continue to next middleware/route\r\n *     return null as any; // Return NextResponse.next() in actual usage\r\n * });\r\n * \r\n * export default createMiddlewareHandler(handler);\r\n * \r\n * export const config = {\r\n *     matcher: '/api/:path*',\r\n * };\r\n * ```\r\n */\r\nexport function createMiddlewareHandler(handler: EdgeHandler) {\r\n    return async (request: Request): Promise<Response> => {\r\n        const geo = extractGeoFromHeaders(request.headers);\r\n\r\n        const edgeContext: EdgeContext = {\r\n            geo,\r\n            waitUntil: () => { },\r\n        };\r\n\r\n        return handler(request, edgeContext);\r\n    };\r\n}\r\n\r\n// =============================================================================\r\n// Utilities\r\n// =============================================================================\r\n\r\n/**\r\n * Extract geo data from Vercel's geo headers.\r\n */\r\nfunction extractGeoFromHeaders(headers: Headers): EdgeGeo {\r\n    return {\r\n        country: headers.get('x-vercel-ip-country') ?? undefined,\r\n        city: headers.get('x-vercel-ip-city')\r\n            ? decodeURIComponent(headers.get('x-vercel-ip-city')!)\r\n            : undefined,\r\n        region: headers.get('x-vercel-ip-country-region') ?? undefined,\r\n        latitude: headers.get('x-vercel-ip-latitude') ?? undefined,\r\n        longitude: headers.get('x-vercel-ip-longitude') ?? undefined,\r\n        timezone: headers.get('x-vercel-ip-timezone') ?? undefined,\r\n    };\r\n}\r\n\r\n/**\r\n * Check if running in Vercel Edge Runtime.\r\n */\r\nexport function isVercelEdge(): boolean {\r\n    return typeof (globalThis as any).EdgeRuntime !== 'undefined';\r\n}\r\n\r\n/**\r\n * Get the deployment region.\r\n */\r\nexport function getDeploymentRegion(request: Request): string | undefined {\r\n    return request.headers.get('x-vercel-deployment-url')?.split('.')[0];\r\n}\r\n\r\n/**\r\n * Get client IP address.\r\n */\r\nexport function getClientIP(request: Request): string | undefined {\r\n    return request.headers.get('x-forwarded-for')?.split(',')[0]?.trim() ??\r\n        request.headers.get('x-real-ip') ??\r\n        undefined;\r\n}\r\n"]}

package/dist/index.d.ts

@@ -0,0 +1,178 @@
+export { Request, Response } from 'undici';
+
+/**
+ * @flightdev/edge
+ *
+ * Edge Runtime handlers for Flight Framework.
+ * Deploy to any edge provider - Cloudflare Workers, Vercel Edge, Deno Deploy.
+ *
+ * Philosophy: Flight doesn't impose - you choose your edge provider.
+ * All adapters are optional, use only what you need.
+ *
+ * @example
+ * ```typescript
+ * import { createEdgeHandler } from '@flightdev/edge';
+ *
+ * export default createEdgeHandler((request, context) => {
+ *     const country = context.geo.country;
+ *     return new Response(`Hello from ${country}!`);
+ * });
+ * ```
+ */
+/**
+ * Geolocation data available at the edge.
+ * Availability varies by provider - always check for undefined.
+ */
+interface EdgeGeo {
+    /** ISO 3166-1 alpha-2 country code (e.g., "US", "AR", "DE") */
+    country?: string;
+    /** City name (e.g., "Buenos Aires", "New York") */
+    city?: string;
+    /** Region/state code (e.g., "CA", "TX") */
+    region?: string;
+    /** Latitude as string */
+    latitude?: string;
+    /** Longitude as string */
+    longitude?: string;
+    /** IANA timezone (e.g., "America/Argentina/Buenos_Aires") */
+    timezone?: string;
+    /** Continent code (e.g., "NA", "SA", "EU") */
+    continent?: string;
+    /** Postal code */
+    postalCode?: string;
+    /** Metro code (US only) */
+    metroCode?: string;
+}
+/**
+ * Cloudflare-specific properties.
+ * Only available when using Cloudflare Workers adapter.
+ */
+interface CloudflareProperties {
+    /** ASN of the request */
+    asn?: number;
+    /** ASN organization */
+    asOrganization?: string;
+    /** Colo (data center) that served the request */
+    colo?: string;
+    /** HTTP protocol version */
+    httpProtocol?: string;
+    /** Request priority */
+    requestPriority?: string;
+    /** TLS cipher */
+    tlsCipher?: string;
+    /** TLS version */
+    tlsVersion?: string;
+    /** Is the connection from a known bot */
+    isBot?: boolean;
+    /** Bot score (Enterprise only) */
+    botScore?: number;
+    /** Verified bot category */
+    verifiedBotCategory?: string;
+}
+/**
+ * Context provided to edge handlers.
+ * Contains geo data, provider-specific info, and lifecycle methods.
+ */
+interface EdgeContext {
+    /** Geolocation data derived from request IP */
+    geo: EdgeGeo;
+    /** Cloudflare-specific properties (only with Cloudflare adapter) */
+    cf?: CloudflareProperties;
+    /** Environment variables/bindings (provider-specific) */
+    env?: Record<string, unknown>;
+    /**
+     * Extend the lifetime of the request handler.
+     * Use for fire-and-forget operations like logging or analytics.
+     *
+     * @example
+     * ```typescript
+     * context.waitUntil(logAnalytics(request));
+     * return new Response('OK'); // Returns immediately
+     * ```
+     */
+    waitUntil: (promise: Promise<unknown>) => void;
+    /**
+     * Cloudflare only: Pass through to origin on exception.
+     * Allows graceful degradation to your origin server.
+     */
+    passThroughOnException?: () => void;
+}
+/**
+ * Edge handler function signature.
+ * Receives a standard Request and EdgeContext, returns a Response.
+ */
+type EdgeHandler = (request: Request, context: EdgeContext) => Response | Promise<Response>;
+/**
+ * Configuration options for edge handlers.
+ */
+interface EdgeHandlerOptions {
+    /**
+     * Enable request logging.
+     * @default false
+     */
+    logging?: boolean;
+    /**
+     * Custom error handler for uncaught exceptions.
+     */
+    onError?: (error: Error, request: Request) => Response | Promise<Response>;
+    /**
+     * Transform request before handler.
+     */
+    beforeRequest?: (request: Request) => Request | Promise<Request>;
+    /**
+     * Transform response after handler.
+     */
+    afterResponse?: (response: Response, request: Request) => Response | Promise<Response>;
+}
+/**
+ * Create an edge handler with unified context.
+ *
+ * This is a lightweight wrapper that normalizes the edge runtime environment
+ * across different providers. Use the provider-specific adapters for deployment.
+ *
+ * @param handler - Your edge handler function
+ * @param options - Optional configuration
+ * @returns Wrapped handler
+ *
+ * @example
+ * ```typescript
+ * import { createEdgeHandler } from '@flightdev/edge';
+ *
+ * const handler = createEdgeHandler(async (request, ctx) => {
+ *     // Access geo data (available on all providers)
+ *     const { country, city } = ctx.geo;
+ *
+ *     // Fire-and-forget logging
+ *     ctx.waitUntil(logRequest(request));
+ *
+ *     return Response.json({ country, city });
+ * });
+ *
+ * export default handler;
+ * ```
+ */
+declare function createEdgeHandler(handler: EdgeHandler, options?: EdgeHandlerOptions): EdgeHandler;
+/**
+ * Check if code is running in an edge runtime.
+ * Useful for conditional logic between edge and Node.js.
+ */
+declare function isEdgeRuntime(): boolean;
+/**
+ * Get the current edge runtime name.
+ * Returns undefined if not in an edge runtime.
+ */
+declare function getEdgeRuntime(): 'cloudflare' | 'vercel' | 'deno' | undefined;
+/**
+ * Create an empty EdgeContext for testing or fallback.
+ */
+declare function createEmptyContext(): EdgeContext;
+/**
+ * Extract geo data from a request.
+ * Attempts to read from various header formats used by different providers.
+ *
+ * @param request - The incoming request
+ * @returns Geo data object
+ */
+declare function getGeoFromRequest(request: Request): EdgeGeo;
+
+export { type CloudflareProperties, type EdgeContext, type EdgeGeo, type EdgeHandler, type EdgeHandlerOptions, createEdgeHandler, createEmptyContext, getEdgeRuntime, getGeoFromRequest, isEdgeRuntime };

package/dist/index.js

@@ -0,0 +1,74 @@
+// src/index.ts
+function createEdgeHandler(handler, options = {}) {
+  return async (request, context) => {
+    try {
+      const processedRequest = options.beforeRequest ? await options.beforeRequest(request) : request;
+      if (options.logging) {
+        const { method, url } = processedRequest;
+        const { country, city } = context.geo;
+        console.log(`[Edge] ${method} ${url} - ${city || "Unknown"}, ${country || "Unknown"}`);
+      }
+      const response = await handler(processedRequest, context);
+      return options.afterResponse ? await options.afterResponse(response, processedRequest) : response;
+    } catch (error) {
+      if (options.onError) {
+        return options.onError(error, request);
+      }
+      console.error("[Edge] Handler error:", error);
+      return new Response(
+        JSON.stringify({ error: "Internal Server Error" }),
+        {
+          status: 500,
+          headers: { "Content-Type": "application/json" }
+        }
+      );
+    }
+  };
+}
+function isEdgeRuntime() {
+  if (typeof globalThis.caches !== "undefined" && typeof globalThis.WebSocketPair !== "undefined") {
+    return true;
+  }
+  if (typeof globalThis.EdgeRuntime !== "undefined") {
+    return true;
+  }
+  if (typeof globalThis.Deno !== "undefined") {
+    return true;
+  }
+  return false;
+}
+function getEdgeRuntime() {
+  if (typeof globalThis.WebSocketPair !== "undefined") {
+    return "cloudflare";
+  }
+  if (typeof globalThis.EdgeRuntime !== "undefined") {
+    return "vercel";
+  }
+  if (typeof globalThis.Deno !== "undefined") {
+    return "deno";
+  }
+  return void 0;
+}
+function createEmptyContext() {
+  return {
+    geo: {},
+    waitUntil: () => {
+    }
+  };
+}
+function getGeoFromRequest(request) {
+  const headers = request.headers;
+  return {
+    // Cloudflare headers
+    country: headers.get("cf-ipcountry") ?? headers.get("x-vercel-ip-country") ?? void 0,
+    city: headers.get("cf-ipcity") ?? headers.get("x-vercel-ip-city") ?? void 0,
+    region: headers.get("cf-region") ?? headers.get("x-vercel-ip-country-region") ?? void 0,
+    latitude: headers.get("cf-iplatitude") ?? headers.get("x-vercel-ip-latitude") ?? void 0,
+    longitude: headers.get("cf-iplongitude") ?? headers.get("x-vercel-ip-longitude") ?? void 0,
+    timezone: headers.get("cf-timezone") ?? headers.get("x-vercel-ip-timezone") ?? void 0
+  };
+}
+
+export { createEdgeHandler, createEmptyContext, getEdgeRuntime, getGeoFromRequest, isEdgeRuntime };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\r\n * @flightdev/edge\r\n * \r\n * Edge Runtime handlers for Flight Framework.\r\n * Deploy to any edge provider - Cloudflare Workers, Vercel Edge, Deno Deploy.\r\n * \r\n * Philosophy: Flight doesn't impose - you choose your edge provider.\r\n * All adapters are optional, use only what you need.\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createEdgeHandler } from '@flightdev/edge';\r\n * \r\n * export default createEdgeHandler((request, context) => {\r\n *     const country = context.geo.country;\r\n *     return new Response(`Hello from ${country}!`);\r\n * });\r\n * ```\r\n */\r\n\r\n// =============================================================================\r\n// Types\r\n// =============================================================================\r\n\r\n/**\r\n * Geolocation data available at the edge.\r\n * Availability varies by provider - always check for undefined.\r\n */\r\nexport interface EdgeGeo {\r\n    /** ISO 3166-1 alpha-2 country code (e.g., \"US\", \"AR\", \"DE\") */\r\n    country?: string;\r\n    /** City name (e.g., \"Buenos Aires\", \"New York\") */\r\n    city?: string;\r\n    /** Region/state code (e.g., \"CA\", \"TX\") */\r\n    region?: string;\r\n    /** Latitude as string */\r\n    latitude?: string;\r\n    /** Longitude as string */\r\n    longitude?: string;\r\n    /** IANA timezone (e.g., \"America/Argentina/Buenos_Aires\") */\r\n    timezone?: string;\r\n    /** Continent code (e.g., \"NA\", \"SA\", \"EU\") */\r\n    continent?: string;\r\n    /** Postal code */\r\n    postalCode?: string;\r\n    /** Metro code (US only) */\r\n    metroCode?: string;\r\n}\r\n\r\n/**\r\n * Cloudflare-specific properties.\r\n * Only available when using Cloudflare Workers adapter.\r\n */\r\nexport interface CloudflareProperties {\r\n    /** ASN of the request */\r\n    asn?: number;\r\n    /** ASN organization */\r\n    asOrganization?: string;\r\n    /** Colo (data center) that served the request */\r\n    colo?: string;\r\n    /** HTTP protocol version */\r\n    httpProtocol?: string;\r\n    /** Request priority */\r\n    requestPriority?: string;\r\n    /** TLS cipher */\r\n    tlsCipher?: string;\r\n    /** TLS version */\r\n    tlsVersion?: string;\r\n    /** Is the connection from a known bot */\r\n    isBot?: boolean;\r\n    /** Bot score (Enterprise only) */\r\n    botScore?: number;\r\n    /** Verified bot category */\r\n    verifiedBotCategory?: string;\r\n}\r\n\r\n/**\r\n * Context provided to edge handlers.\r\n * Contains geo data, provider-specific info, and lifecycle methods.\r\n */\r\nexport interface EdgeContext {\r\n    /** Geolocation data derived from request IP */\r\n    geo: EdgeGeo;\r\n\r\n    /** Cloudflare-specific properties (only with Cloudflare adapter) */\r\n    cf?: CloudflareProperties;\r\n\r\n    /** Environment variables/bindings (provider-specific) */\r\n    env?: Record<string, unknown>;\r\n\r\n    /**\r\n     * Extend the lifetime of the request handler.\r\n     * Use for fire-and-forget operations like logging or analytics.\r\n     * \r\n     * @example\r\n     * ```typescript\r\n     * context.waitUntil(logAnalytics(request));\r\n     * return new Response('OK'); // Returns immediately\r\n     * ```\r\n     */\r\n    waitUntil: (promise: Promise<unknown>) => void;\r\n\r\n    /**\r\n     * Cloudflare only: Pass through to origin on exception.\r\n     * Allows graceful degradation to your origin server.\r\n     */\r\n    passThroughOnException?: () => void;\r\n}\r\n\r\n/**\r\n * Edge handler function signature.\r\n * Receives a standard Request and EdgeContext, returns a Response.\r\n */\r\nexport type EdgeHandler = (\r\n    request: Request,\r\n    context: EdgeContext\r\n) => Response | Promise<Response>;\r\n\r\n/**\r\n * Configuration options for edge handlers.\r\n */\r\nexport interface EdgeHandlerOptions {\r\n    /**\r\n     * Enable request logging.\r\n     * @default false\r\n     */\r\n    logging?: boolean;\r\n\r\n    /**\r\n     * Custom error handler for uncaught exceptions.\r\n     */\r\n    onError?: (error: Error, request: Request) => Response | Promise<Response>;\r\n\r\n    /**\r\n     * Transform request before handler.\r\n     */\r\n    beforeRequest?: (request: Request) => Request | Promise<Request>;\r\n\r\n    /**\r\n     * Transform response after handler.\r\n     */\r\n    afterResponse?: (response: Response, request: Request) => Response | Promise<Response>;\r\n}\r\n\r\n// =============================================================================\r\n// Core Implementation\r\n// =============================================================================\r\n\r\n/**\r\n * Create an edge handler with unified context.\r\n * \r\n * This is a lightweight wrapper that normalizes the edge runtime environment\r\n * across different providers. Use the provider-specific adapters for deployment.\r\n * \r\n * @param handler - Your edge handler function\r\n * @param options - Optional configuration\r\n * @returns Wrapped handler\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createEdgeHandler } from '@flightdev/edge';\r\n * \r\n * const handler = createEdgeHandler(async (request, ctx) => {\r\n *     // Access geo data (available on all providers)\r\n *     const { country, city } = ctx.geo;\r\n *     \r\n *     // Fire-and-forget logging\r\n *     ctx.waitUntil(logRequest(request));\r\n *     \r\n *     return Response.json({ country, city });\r\n * });\r\n * \r\n * export default handler;\r\n * ```\r\n */\r\nexport function createEdgeHandler(\r\n    handler: EdgeHandler,\r\n    options: EdgeHandlerOptions = {}\r\n): EdgeHandler {\r\n    return async (request: Request, context: EdgeContext): Promise<Response> => {\r\n        try {\r\n            // Before request hook\r\n            const processedRequest = options.beforeRequest\r\n                ? await options.beforeRequest(request)\r\n                : request;\r\n\r\n            // Logging\r\n            if (options.logging) {\r\n                const { method, url } = processedRequest;\r\n                const { country, city } = context.geo;\r\n                console.log(`[Edge] ${method} ${url} - ${city || 'Unknown'}, ${country || 'Unknown'}`);\r\n            }\r\n\r\n            // Execute handler\r\n            const response = await handler(processedRequest, context);\r\n\r\n            // After response hook\r\n            return options.afterResponse\r\n                ? await options.afterResponse(response, processedRequest)\r\n                : response;\r\n\r\n        } catch (error) {\r\n            // Custom error handler\r\n            if (options.onError) {\r\n                return options.onError(error as Error, request);\r\n            }\r\n\r\n            // Default error response\r\n            console.error('[Edge] Handler error:', error);\r\n            return new Response(\r\n                JSON.stringify({ error: 'Internal Server Error' }),\r\n                {\r\n                    status: 500,\r\n                    headers: { 'Content-Type': 'application/json' },\r\n                }\r\n            );\r\n        }\r\n    };\r\n}\r\n\r\n// =============================================================================\r\n// Utilities\r\n// =============================================================================\r\n\r\n/**\r\n * Check if code is running in an edge runtime.\r\n * Useful for conditional logic between edge and Node.js.\r\n */\r\nexport function isEdgeRuntime(): boolean {\r\n    // Cloudflare Workers\r\n    if (typeof (globalThis as any).caches !== 'undefined' &&\r\n        typeof (globalThis as any).WebSocketPair !== 'undefined') {\r\n        return true;\r\n    }\r\n\r\n    // Vercel Edge\r\n    if (typeof (globalThis as any).EdgeRuntime !== 'undefined') {\r\n        return true;\r\n    }\r\n\r\n    // Deno\r\n    if (typeof (globalThis as any).Deno !== 'undefined') {\r\n        return true;\r\n    }\r\n\r\n    return false;\r\n}\r\n\r\n/**\r\n * Get the current edge runtime name.\r\n * Returns undefined if not in an edge runtime.\r\n */\r\nexport function getEdgeRuntime(): 'cloudflare' | 'vercel' | 'deno' | undefined {\r\n    if (typeof (globalThis as any).WebSocketPair !== 'undefined') {\r\n        return 'cloudflare';\r\n    }\r\n    if (typeof (globalThis as any).EdgeRuntime !== 'undefined') {\r\n        return 'vercel';\r\n    }\r\n    if (typeof (globalThis as any).Deno !== 'undefined') {\r\n        return 'deno';\r\n    }\r\n    return undefined;\r\n}\r\n\r\n/**\r\n * Create an empty EdgeContext for testing or fallback.\r\n */\r\nexport function createEmptyContext(): EdgeContext {\r\n    return {\r\n        geo: {},\r\n        waitUntil: () => { },\r\n    };\r\n}\r\n\r\n/**\r\n * Extract geo data from a request.\r\n * Attempts to read from various header formats used by different providers.\r\n * \r\n * @param request - The incoming request\r\n * @returns Geo data object\r\n */\r\nexport function getGeoFromRequest(request: Request): EdgeGeo {\r\n    const headers = request.headers;\r\n\r\n    return {\r\n        // Cloudflare headers\r\n        country: headers.get('cf-ipcountry') ??\r\n            headers.get('x-vercel-ip-country') ??\r\n            undefined,\r\n        city: headers.get('cf-ipcity') ??\r\n            headers.get('x-vercel-ip-city') ??\r\n            undefined,\r\n        region: headers.get('cf-region') ??\r\n            headers.get('x-vercel-ip-country-region') ??\r\n            undefined,\r\n        latitude: headers.get('cf-iplatitude') ??\r\n            headers.get('x-vercel-ip-latitude') ??\r\n            undefined,\r\n        longitude: headers.get('cf-iplongitude') ??\r\n            headers.get('x-vercel-ip-longitude') ??\r\n            undefined,\r\n        timezone: headers.get('cf-timezone') ??\r\n            headers.get('x-vercel-ip-timezone') ??\r\n            undefined,\r\n    };\r\n}\r\n\r\n// =============================================================================\r\n// Re-exports for convenience\r\n// =============================================================================\r\n\r\nexport type { Request, Response } from './types';\r\n"]}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@flightdev/edge",
+  "version": "0.2.0",
+  "description": "Edge Runtime handlers for Flight Framework - deploy to any edge provider",
+  "keywords": [
+    "flight",
+    "edge",
+    "cloudflare",
+    "vercel",
+    "deno",
+    "workers",
+    "serverless"
+  ],
+  "license": "MIT",
+  "author": "Flight Contributors",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./cloudflare": {
+      "types": "./dist/adapters/cloudflare.d.ts",
+      "import": "./dist/adapters/cloudflare.js"
+    },
+    "./vercel": {
+      "types": "./dist/adapters/vercel.d.ts",
+      "import": "./dist/adapters/vercel.js"
+    },
+    "./deno": {
+      "types": "./dist/adapters/deno.d.ts",
+      "import": "./dist/adapters/deno.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "rimraf": "^6.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.0.0"
+  },
+  "peerDependencies": {
+    "@cloudflare/workers-types": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@cloudflare/workers-types": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "clean": "rimraf dist",
+    "typecheck": "tsc --noEmit"
+  }
+}