@flightdev/core 0.6.7

package/dist/cache/index.d.ts

@@ -0,0 +1,191 @@
+/**
+ * Flight Cache - Agnostic caching primitives
+ *
+ * Flight provides the interface, you choose the implementation.
+ * Use in-memory, Redis, Cloudflare KV, Upstash, or anything else.
+ *
+ * @example
+ * ```typescript
+ * import { createCache } from '@flightdev/core';
+ * import { redis } from '@flightdev/cache-redis';
+ *
+ * const cache = createCache({
+ *     adapter: redis({ url: process.env.REDIS_URL }),
+ *     defaultTTL: 3600,
+ * });
+ *
+ * await cache.set('user:1', userData, { tags: ['users'] });
+ * await cache.invalidateTag('users');
+ * ```
+ */
+interface CacheOptions {
+    /** Time-to-live in seconds */
+    ttl?: number;
+    /** Cache tags for invalidation */
+    tags?: string[];
+    /** Stale-while-revalidate time in seconds */
+    swr?: number;
+}
+interface CacheEntry<T> {
+    /** Cached value */
+    value: T;
+    /** When this entry expires (timestamp) */
+    expiresAt?: number;
+    /** When this entry becomes stale (timestamp) */
+    staleAt?: number;
+    /** Cache tags for invalidation */
+    tags?: string[];
+    /** When this entry was created */
+    createdAt: number;
+}
+interface Cache {
+    /** Get a value from cache */
+    get<T>(key: string): Promise<T | undefined>;
+    /** Set a value in cache */
+    set<T>(key: string, value: T, options?: CacheOptions): Promise<void>;
+    /** Delete a value from cache */
+    delete(key: string): Promise<boolean>;
+    /** Check if a key exists */
+    has(key: string): Promise<boolean>;
+    /** Clear all cache entries */
+    clear(): Promise<void>;
+    /** Invalidate entries by tag */
+    invalidateTag(tag: string): Promise<void>;
+    /** Invalidate entries by multiple tags */
+    invalidateTags(tags: string[]): Promise<void>;
+    /** Get or set with a factory function */
+    getOrSet<T>(key: string, factory: () => Promise<T>, options?: CacheOptions): Promise<T>;
+    /** Get multiple values at once */
+    getMany<T>(keys: string[]): Promise<Map<string, T | undefined>>;
+    /** Set multiple values at once */
+    setMany<T>(entries: Map<string, T>, options?: CacheOptions): Promise<void>;
+    /** Get cache statistics (if tracking enabled) */
+    getStats?(): CacheStats | undefined;
+}
+interface CacheStats {
+    hits: number;
+    misses: number;
+    sets: number;
+    deletes: number;
+}
+/** Adapter interface for external cache providers */
+interface CacheAdapter {
+    /** Adapter name for identification */
+    readonly name: string;
+    /** Get an entry from cache */
+    get<T>(key: string): Promise<CacheEntry<T> | undefined>;
+    /** Set an entry in cache */
+    set<T>(key: string, entry: CacheEntry<T>): Promise<void>;
+    /** Delete an entry from cache */
+    delete(key: string): Promise<boolean>;
+    /** Check if key exists */
+    has(key: string): Promise<boolean>;
+    /** Clear all entries */
+    clear(): Promise<void>;
+    /** Get keys matching pattern (optional) */
+    keys?(pattern?: string): Promise<string[]>;
+    /** Get multiple entries at once (optional, for performance) */
+    getMany?<T>(keys: string[]): Promise<Map<string, CacheEntry<T> | undefined>>;
+    /** Set multiple entries at once (optional, for performance) */
+    setMany?<T>(entries: Map<string, CacheEntry<T>>): Promise<void>;
+    /** Whether this adapter supports distributed tags natively */
+    readonly supportsDistributedTags?: boolean;
+    /** Add a key to a tag set (for distributed tag management) */
+    addToTag?(tag: string, key: string): Promise<void>;
+    /** Get all keys associated with a tag */
+    getTagMembers?(tag: string): Promise<string[]>;
+    /** Delete a tag and return its members */
+    deleteTag?(tag: string): Promise<string[]>;
+    /** Close connection (for cleanup) */
+    close?(): Promise<void>;
+    /** Check if adapter is healthy */
+    ping?(): Promise<boolean>;
+}
+interface Serializer {
+    serialize(value: unknown): string;
+    deserialize<T>(data: string): T;
+}
+/** Default JSON serializer */
+declare const jsonSerializer: Serializer;
+interface MemoryCacheAdapterOptions {
+    /** Maximum number of entries (0 = unlimited) */
+    maxSize?: number;
+    /** Cleanup interval in ms (default: 60000) */
+    cleanupInterval?: number;
+}
+/**
+ * Create in-memory cache adapter
+ */
+declare function memory(options?: MemoryCacheAdapterOptions): CacheAdapter;
+interface CreateCacheOptions {
+    /** Custom cache adapter (defaults to in-memory) */
+    adapter?: CacheAdapter;
+    /** Default TTL for all entries (seconds) */
+    defaultTTL?: number;
+    /** Key prefix for namespacing */
+    prefix?: string;
+    /** Custom serializer (for external adapters) */
+    serializer?: Serializer;
+    /** Track cache statistics */
+    trackStats?: boolean;
+}
+/**
+ * Create a new cache instance
+ *
+ * @example
+ * ```typescript
+ * // Simple in-memory cache
+ * const cache = createCache();
+ *
+ * // With Redis adapter
+ * import { redis } from '@flightdev/cache-redis';
+ * const cache = createCache({
+ *     adapter: redis({ url: 'redis://localhost:6379' }),
+ *     defaultTTL: 3600,
+ *     prefix: 'myapp',
+ * });
+ * ```
+ */
+declare function createCache(options?: CreateCacheOptions): Cache;
+/**
+ * Create a cache key from multiple parts
+ *
+ * @example
+ * ```typescript
+ * cacheKey('user', userId, 'profile'); // "user:123:profile"
+ * ```
+ */
+declare function cacheKey(...parts: (string | number | boolean | undefined)[]): string;
+/**
+ * Wrap a function with caching
+ *
+ * @example
+ * ```typescript
+ * const getCachedUser = cached(cache, getUser, {
+ *     ttl: 300,
+ *     keyFn: (userId) => `user:${userId}`,
+ * });
+ *
+ * const user = await getCachedUser(123);
+ * ```
+ */
+declare function cached<T extends (...args: unknown[]) => Promise<unknown>>(cache: Cache, fn: T, options?: CacheOptions & {
+    keyFn?: (...args: Parameters<T>) => string;
+}): T;
+/**
+ * Create a deduplication wrapper to prevent duplicate concurrent requests
+ *
+ * @example
+ * ```typescript
+ * const dedupedFetch = dedupe(fetchUser);
+ *
+ * // These will share the same request
+ * const [user1, user2] = await Promise.all([
+ *     dedupedFetch(123),
+ *     dedupedFetch(123),
+ * ]);
+ * ```
+ */
+declare function dedupe<T extends (...args: unknown[]) => Promise<unknown>>(fn: T, keyFn?: (...args: Parameters<T>) => string): T;
+
+export { type Cache, type CacheAdapter, type CacheEntry, type CacheOptions, type CacheStats, type CreateCacheOptions, type MemoryCacheAdapterOptions, type Serializer, cacheKey, cached, createCache, dedupe, jsonSerializer, memory };

package/dist/cache/index.js

@@ -0,0 +1,3 @@
+export { cacheKey, cached, createCache, dedupe, jsonSerializer, memory } from '../chunk-ZZZML7Y3.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/chunk-62HISNA3.js

@@ -0,0 +1,354 @@
+// src/adapters/handler.ts
+function createUniversalHandler(options = {}) {
+  const {
+    manifest,
+    routeRules = {},
+    basePath = "",
+    onError = defaultErrorHandler,
+    onNotFound = defaultNotFoundHandler,
+    hooks = {}
+  } = options;
+  return {
+    /**
+     * Handle incoming request
+     */
+    async fetch(request, env, ctx) {
+      try {
+        if (hooks.beforeHandle) {
+          const modifiedRequest = await hooks.beforeHandle(request);
+          if (modifiedRequest) request = modifiedRequest;
+        }
+        const url = new URL(request.url);
+        let pathname = url.pathname;
+        if (basePath && pathname.startsWith(basePath)) {
+          pathname = pathname.slice(basePath.length) || "/";
+        }
+        const rules = matchRouteRules(pathname, routeRules);
+        if (rules?.redirect) {
+          return handleRedirect(rules.redirect);
+        }
+        if (rules?.proxy) {
+          return handleProxy(request, rules.proxy);
+        }
+        if (request.method === "OPTIONS" && rules?.cors) {
+          return handleCorsPreFlight(rules.cors);
+        }
+        const route = manifest?.routes?.find((r) => matchPath(pathname, r.path));
+        if (!route) {
+          return await onNotFound(request);
+        }
+        const context = {
+          url,
+          params: extractParams(pathname, route.path),
+          headers: request.headers,
+          method: request.method
+        };
+        if (hooks.beforeRender) {
+          await hooks.beforeRender(context);
+        }
+        let response;
+        switch (route.mode) {
+          case "ssr":
+          case "isr":
+            response = await handleSSR(context, options);
+            break;
+          case "ssg":
+            response = await handleSSG(context, options);
+            break;
+          case "csr":
+            response = handleCSR(options);
+            break;
+          default:
+            response = await handleSSR(context, options);
+        }
+        if (rules?.cache) {
+          response = applyCacheHeaders(response, rules.cache);
+        }
+        if (rules?.cors) {
+          response = applyCorsHeaders(response, rules.cors, request);
+        }
+        if (rules?.headers) {
+          response = applyCustomHeaders(response, rules.headers);
+        }
+        if (hooks.afterHandle) {
+          const modifiedResponse = await hooks.afterHandle(request, response);
+          if (modifiedResponse) response = modifiedResponse;
+        }
+        return response;
+      } catch (error) {
+        return onError(error, request);
+      }
+    },
+    /**
+     * Check if this handler can handle the request
+     */
+    canHandle(request) {
+      const url = new URL(request.url);
+      let pathname = url.pathname;
+      if (basePath && pathname.startsWith(basePath)) {
+        pathname = pathname.slice(basePath.length) || "/";
+      }
+      if (manifest?.routes) {
+        return manifest.routes.some((r) => matchPath(pathname, r.path));
+      }
+      return Object.keys(routeRules).some(
+        (pattern) => matchPath(pathname, pattern)
+      );
+    }
+  };
+}
+function defaultErrorHandler(error, _request) {
+  console.error("[Flight] Request error:", error);
+  return new Response(
+    JSON.stringify({
+      error: "Internal Server Error",
+      message: process.env.NODE_ENV === "development" ? error.message : void 0
+    }),
+    {
+      status: 500,
+      headers: { "Content-Type": "application/json" }
+    }
+  );
+}
+function defaultNotFoundHandler(_request) {
+  return new Response("Not Found", { status: 404 });
+}
+function matchRouteRules(pathname, rules) {
+  for (const [pattern, config] of Object.entries(rules)) {
+    if (matchPath(pathname, pattern)) {
+      return config;
+    }
+  }
+  return null;
+}
+function matchPath(pathname, pattern) {
+  if (pattern === pathname) return true;
+  if (pattern.endsWith("/**")) {
+    const prefix = pattern.slice(0, -3);
+    return pathname.startsWith(prefix);
+  }
+  if (pattern.endsWith("/*")) {
+    const prefix = pattern.slice(0, -2);
+    const rest = pathname.slice(prefix.length);
+    return pathname.startsWith(prefix) && !rest.includes("/");
+  }
+  const patternParts = pattern.split("/");
+  const pathParts = pathname.split("/");
+  if (patternParts.length !== pathParts.length) return false;
+  return patternParts.every((part, i) => {
+    if (part.startsWith("[") && part.endsWith("]")) return true;
+    if (part.startsWith(":")) return true;
+    return part === pathParts[i];
+  });
+}
+function extractParams(pathname, pattern) {
+  const params = {};
+  const patternParts = pattern.split("/");
+  const pathParts = pathname.split("/");
+  patternParts.forEach((part, i) => {
+    if (part.startsWith("[") && part.endsWith("]")) {
+      const key = part.slice(1, -1).replace("...", "");
+      params[key] = pathParts[i] ?? "";
+    } else if (part.startsWith(":")) {
+      params[part.slice(1)] = pathParts[i] ?? "";
+    }
+  });
+  return params;
+}
+function handleRedirect(redirect) {
+  const to = typeof redirect === "string" ? redirect : redirect.to;
+  const status = typeof redirect === "string" ? 302 : redirect.statusCode ?? 302;
+  return new Response(null, {
+    status,
+    headers: { Location: to }
+  });
+}
+async function handleProxy(request, target) {
+  const url = new URL(request.url);
+  const targetUrl = new URL(target);
+  targetUrl.pathname = url.pathname;
+  targetUrl.search = url.search;
+  const proxyRequest = new Request(targetUrl.toString(), {
+    method: request.method,
+    headers: request.headers,
+    body: request.body
+  });
+  return fetch(proxyRequest);
+}
+function handleCorsPreFlight(cors) {
+  const options = cors === true ? {} : cors || {};
+  return new Response(null, {
+    status: 204,
+    headers: {
+      "Access-Control-Allow-Origin": resolveOrigin(options.origin),
+      "Access-Control-Allow-Methods": (options.methods ?? ["GET", "POST", "PUT", "DELETE", "PATCH"]).join(", "),
+      "Access-Control-Allow-Headers": (options.allowedHeaders ?? ["Content-Type", "Authorization"]).join(", "),
+      "Access-Control-Max-Age": String(options.maxAge ?? 86400),
+      ...options.credentials && { "Access-Control-Allow-Credentials": "true" }
+    }
+  });
+}
+function resolveOrigin(origin) {
+  if (origin === true || origin === void 0) return "*";
+  if (origin === false) return "*";
+  if (Array.isArray(origin)) return origin[0] ?? "*";
+  return origin;
+}
+function applyCacheHeaders(response, cache) {
+  const headers = new Headers(response.headers);
+  let cacheControl = `public, max-age=${cache.maxAge ?? 0}`;
+  if (cache.swr) {
+    cacheControl += `, stale-while-revalidate=${cache.swr}`;
+  }
+  headers.set("Cache-Control", cacheControl);
+  return new Response(response.body, {
+    status: response.status,
+    statusText: response.statusText,
+    headers
+  });
+}
+function applyCorsHeaders(response, cors, _request) {
+  const options = cors === true ? {} : cors || {};
+  const headers = new Headers(response.headers);
+  headers.set("Access-Control-Allow-Origin", resolveOrigin(options.origin));
+  if (options.credentials) {
+    headers.set("Access-Control-Allow-Credentials", "true");
+  }
+  if (options.exposedHeaders) {
+    headers.set("Access-Control-Expose-Headers", options.exposedHeaders.join(", "));
+  }
+  return new Response(response.body, {
+    status: response.status,
+    statusText: response.statusText,
+    headers
+  });
+}
+function applyCustomHeaders(response, customHeaders) {
+  const headers = new Headers(response.headers);
+  for (const [key, value] of Object.entries(customHeaders)) {
+    headers.set(key, value);
+  }
+  return new Response(response.body, {
+    status: response.status,
+    statusText: response.statusText,
+    headers
+  });
+}
+async function handleSSR(context, options) {
+  const { framework, hooks } = options;
+  if (!framework) {
+    return new Response(createPlaceholderHTML(context.url.pathname), {
+      headers: { "Content-Type": "text/html; charset=utf-8" }
+    });
+  }
+  let result = await framework.renderToString({}, context);
+  if (hooks?.afterRender) {
+    const modifiedResult = await hooks.afterRender(result);
+    if (modifiedResult) result = modifiedResult;
+  }
+  return new Response(result.html, {
+    status: result.status,
+    headers: result.headers
+  });
+}
+async function handleSSG(context, options) {
+  return handleSSR(context, options);
+}
+function handleCSR(options) {
+  const html = `<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Flight App</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/assets/client.js"></script>
+  </body>
+</html>`;
+  return new Response(html, {
+    headers: { "Content-Type": "text/html; charset=utf-8" }
+  });
+}
+function createPlaceholderHTML(pathname) {
+  return `<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Flight</title>
+    <style>
+      body { font-family: system-ui, sans-serif; display: flex; align-items: center; justify-content: center; min-height: 100vh; margin: 0; background: #0a0a0a; color: #fafafa; }
+      .container { text-align: center; }
+      h1 { font-size: 3rem; margin-bottom: 0.5rem; }
+      p { color: #888; }
+      code { background: #1a1a1a; padding: 0.25rem 0.5rem; border-radius: 4px; font-size: 0.875rem; }
+    </style>
+  </head>
+  <body>
+    <div class="container">
+      <h1>Flight</h1>
+      <p>Path: <code>${pathname}</code></p>
+      <p>Configure a UI framework adapter to enable SSR.</p>
+    </div>
+  </body>
+</html>`;
+}
+
+// src/adapters/validation.ts
+function createValidatedAdapter(name, schema, factory) {
+  return (rawOptions = {}) => {
+    const parseResult = schema.safeParse(rawOptions);
+    if (!parseResult.success) {
+      const errorMessage = formatValidationError(name, parseResult.error);
+      throw new Error(errorMessage);
+    }
+    const validatedOptions = parseResult.data;
+    const adapterConfig = factory(validatedOptions);
+    return {
+      name,
+      adapt: adapterConfig.adapt,
+      emulate: adapterConfig.emulate,
+      supports: adapterConfig.supports
+    };
+  };
+}
+function validateAdapterOptions(schema, options) {
+  const result = schema.safeParse(options);
+  return result.success ? result.data : null;
+}
+function assertValidOptions(name, schema, options) {
+  const result = schema.safeParse(options);
+  if (!result.success) {
+    throw new Error(formatValidationError(name, result.error));
+  }
+  return result.data;
+}
+function formatValidationError(adapterName, error) {
+  const prefix = `[${adapterName}] Invalid adapter options`;
+  if (error && typeof error === "object" && "issues" in error) {
+    const zodError = error;
+    const issues = zodError.issues.map((issue) => `  - ${issue.path.join(".")}: ${issue.message}`).join("\n");
+    return `${prefix}:
+${issues}`;
+  }
+  if (error instanceof Error) {
+    return `${prefix}: ${error.message}`;
+  }
+  return `${prefix}: Unknown validation error`;
+}
+
+// src/adapters/index.ts
+function createAdapter(options) {
+  return {
+    name: options.name,
+    adapt: options.adapt,
+    emulate: options.emulate,
+    supports: options.supports
+  };
+}
+
+export { assertValidOptions, createAdapter, createUniversalHandler, createValidatedAdapter, validateAdapterOptions };
+//# sourceMappingURL=chunk-62HISNA3.js.map
+//# sourceMappingURL=chunk-62HISNA3.js.map

package/dist/chunk-62HISNA3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/handler.ts","../src/adapters/validation.ts","../src/adapters/index.ts"],"names":[],"mappings":"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","file":"chunk-62HISNA3.js","sourcesContent":["/**\r\n * Flight Universal Handler - Platform-agnostic request handler\r\n * \r\n * This is the core abstraction that allows Flight applications to run anywhere.\r\n * Adapters can use this handler, or implement their own - zero lock-in.\r\n * \r\n * @module @flightdev/core/adapters/handler\r\n */\r\n\r\nimport type { RenderContext, RenderResult, UIFrameworkAdapter } from '../render/index.js';\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Route rules for per-path configuration\r\n * Similar to Nitro's routeRules - completely optional to use\r\n */\r\nexport interface RouteRules {\r\n    [pattern: string]: RouteRuleConfig;\r\n}\r\n\r\nexport interface RouteRuleConfig {\r\n    /** Cache configuration */\r\n    cache?: {\r\n        /** Max age in seconds */\r\n        maxAge?: number;\r\n        /** Stale-while-revalidate in seconds */\r\n        swr?: number;\r\n        /** Vary headers */\r\n        vary?: string[];\r\n    };\r\n\r\n    /** CORS configuration */\r\n    cors?: boolean | CorsOptions;\r\n\r\n    /** Headers to add to response */\r\n    headers?: Record<string, string>;\r\n\r\n    /** Redirect configuration */\r\n    redirect?: string | {\r\n        to: string;\r\n        statusCode?: 301 | 302 | 303 | 307 | 308;\r\n    };\r\n\r\n    /** Proxy to another URL */\r\n    proxy?: string;\r\n\r\n    /** Render mode override */\r\n    render?: 'ssr' | 'ssg' | 'csr' | 'isr';\r\n\r\n    /** ISR revalidation time in seconds */\r\n    isr?: number;\r\n\r\n    /** Prerender at build time */\r\n    prerender?: boolean;\r\n}\r\n\r\nexport interface CorsOptions {\r\n    origin?: string | string[] | boolean;\r\n    methods?: string[];\r\n    allowedHeaders?: string[];\r\n    exposedHeaders?: string[];\r\n    credentials?: boolean;\r\n    maxAge?: number;\r\n}\r\n\r\n/**\r\n * Handler options - all optional, user configures what they need\r\n */\r\nexport interface UniversalHandlerOptions {\r\n    /** Route manifest from build */\r\n    manifest?: RouteManifest;\r\n\r\n    /** UI framework adapter (optional - for SSR) */\r\n    framework?: UIFrameworkAdapter;\r\n\r\n    /** Route rules (optional) */\r\n    routeRules?: RouteRules;\r\n\r\n    /** Static files directory (optional) */\r\n    staticDir?: string;\r\n\r\n    /** Base path (optional) */\r\n    basePath?: string;\r\n\r\n    /** Custom error handler (optional) */\r\n    onError?: (error: Error, request: Request) => Response | Promise<Response>;\r\n\r\n    /** Custom not found handler (optional) */\r\n    onNotFound?: (request: Request) => Response | Promise<Response>;\r\n\r\n    /** Hooks for extensibility (optional) */\r\n    hooks?: HandlerHooks;\r\n}\r\n\r\n/**\r\n * Handler hooks for extensibility - all optional\r\n */\r\nexport interface HandlerHooks {\r\n    /** Before handling request */\r\n    beforeHandle?: (request: Request) => Request | Promise<Request> | void;\r\n\r\n    /** After getting response, before sending */\r\n    afterHandle?: (request: Request, response: Response) => Response | Promise<Response> | void;\r\n\r\n    /** Before SSR render */\r\n    beforeRender?: (context: RenderContext) => void | Promise<void>;\r\n\r\n    /** After SSR render */\r\n    afterRender?: (result: RenderResult) => RenderResult | Promise<RenderResult>;\r\n}\r\n\r\n/**\r\n * Route manifest from build\r\n */\r\nexport interface RouteManifest {\r\n    routes: Array<{\r\n        path: string;\r\n        component: string;\r\n        mode: 'ssr' | 'ssg' | 'csr' | 'isr';\r\n        handler?: string;\r\n    }>;\r\n    staticFiles?: string[];\r\n}\r\n\r\n/**\r\n * Universal handler interface\r\n */\r\nexport interface UniversalHandler {\r\n    /** Handle a fetch request */\r\n    fetch(request: Request, env?: unknown, ctx?: unknown): Promise<Response>;\r\n\r\n    /** Check if this handler can handle the request */\r\n    canHandle(request: Request): boolean;\r\n}\r\n\r\n// ============================================================================\r\n// Handler Factory\r\n// ============================================================================\r\n\r\n/**\r\n * Create a universal request handler\r\n * \r\n * This is the main abstraction for handling requests.\r\n * Adapters can use this, extend it, or ignore it completely.\r\n * \r\n * @example\r\n * ```typescript\r\n * // Using the handler (optional)\r\n * import { createUniversalHandler } from '@flightdev/core/adapters';\r\n * \r\n * const handler = createUniversalHandler({\r\n *   manifest: await import('./manifest.json'),\r\n *   routeRules: {\r\n *     '/api/**': { cors: true },\r\n *     '/blog/**': { cache: { maxAge: 3600 } },\r\n *   },\r\n * });\r\n * \r\n * // In your adapter\r\n * export default {\r\n *   fetch: handler.fetch,\r\n * };\r\n * ```\r\n */\r\nexport function createUniversalHandler(options: UniversalHandlerOptions = {}): UniversalHandler {\r\n    const {\r\n        manifest,\r\n        routeRules = {},\r\n        basePath = '',\r\n        onError = defaultErrorHandler,\r\n        onNotFound = defaultNotFoundHandler,\r\n        hooks = {},\r\n    } = options;\r\n\r\n    return {\r\n        /**\r\n         * Handle incoming request\r\n         */\r\n        async fetch(request: Request, env?: unknown, ctx?: unknown): Promise<Response> {\r\n            try {\r\n                // Run beforeHandle hook\r\n                if (hooks.beforeHandle) {\r\n                    const modifiedRequest = await hooks.beforeHandle(request);\r\n                    if (modifiedRequest) request = modifiedRequest;\r\n                }\r\n\r\n                const url = new URL(request.url);\r\n                let pathname = url.pathname;\r\n\r\n                // Strip base path if present\r\n                if (basePath && pathname.startsWith(basePath)) {\r\n                    pathname = pathname.slice(basePath.length) || '/';\r\n                }\r\n\r\n                // Apply route rules\r\n                const rules = matchRouteRules(pathname, routeRules);\r\n\r\n                // Handle redirect rules\r\n                if (rules?.redirect) {\r\n                    return handleRedirect(rules.redirect);\r\n                }\r\n\r\n                // Handle proxy rules\r\n                if (rules?.proxy) {\r\n                    return handleProxy(request, rules.proxy);\r\n                }\r\n\r\n                // Handle CORS preflight\r\n                if (request.method === 'OPTIONS' && rules?.cors) {\r\n                    return handleCorsPreFlight(rules.cors);\r\n                }\r\n\r\n                // Find matching route from manifest\r\n                const route = manifest?.routes?.find(r => matchPath(pathname, r.path));\r\n\r\n                // No matching route - try static or return 404\r\n                if (!route) {\r\n                    return await onNotFound(request);\r\n                }\r\n\r\n                // Build render context\r\n                const context: RenderContext = {\r\n                    url,\r\n                    params: extractParams(pathname, route.path),\r\n                    headers: request.headers,\r\n                    method: request.method,\r\n                };\r\n\r\n                // Run beforeRender hook\r\n                if (hooks.beforeRender) {\r\n                    await hooks.beforeRender(context);\r\n                }\r\n\r\n                // Generate response based on route mode\r\n                let response: Response;\r\n\r\n                switch (route.mode) {\r\n                    case 'ssr':\r\n                    case 'isr':\r\n                        response = await handleSSR(context, options);\r\n                        break;\r\n                    case 'ssg':\r\n                        response = await handleSSG(context, options);\r\n                        break;\r\n                    case 'csr':\r\n                        response = handleCSR(options);\r\n                        break;\r\n                    default:\r\n                        response = await handleSSR(context, options);\r\n                }\r\n\r\n                // Apply cache headers from route rules\r\n                if (rules?.cache) {\r\n                    response = applyCacheHeaders(response, rules.cache);\r\n                }\r\n\r\n                // Apply CORS headers\r\n                if (rules?.cors) {\r\n                    response = applyCorsHeaders(response, rules.cors, request);\r\n                }\r\n\r\n                // Apply custom headers\r\n                if (rules?.headers) {\r\n                    response = applyCustomHeaders(response, rules.headers);\r\n                }\r\n\r\n                // Run afterHandle hook\r\n                if (hooks.afterHandle) {\r\n                    const modifiedResponse = await hooks.afterHandle(request, response);\r\n                    if (modifiedResponse) response = modifiedResponse;\r\n                }\r\n\r\n                return response;\r\n\r\n            } catch (error) {\r\n                return onError(error as Error, request);\r\n            }\r\n        },\r\n\r\n        /**\r\n         * Check if this handler can handle the request\r\n         */\r\n        canHandle(request: Request): boolean {\r\n            const url = new URL(request.url);\r\n            let pathname = url.pathname;\r\n\r\n            if (basePath && pathname.startsWith(basePath)) {\r\n                pathname = pathname.slice(basePath.length) || '/';\r\n            }\r\n\r\n            // Check manifest routes\r\n            if (manifest?.routes) {\r\n                return manifest.routes.some(r => matchPath(pathname, r.path));\r\n            }\r\n\r\n            // Check route rules\r\n            return Object.keys(routeRules).some(pattern =>\r\n                matchPath(pathname, pattern)\r\n            );\r\n        },\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Internal Helpers\r\n// ============================================================================\r\n\r\nfunction defaultErrorHandler(error: Error, _request: Request): Response {\r\n    console.error('[Flight] Request error:', error);\r\n\r\n    return new Response(\r\n        JSON.stringify({\r\n            error: 'Internal Server Error',\r\n            message: process.env.NODE_ENV === 'development' ? error.message : undefined,\r\n        }),\r\n        {\r\n            status: 500,\r\n            headers: { 'Content-Type': 'application/json' },\r\n        }\r\n    );\r\n}\r\n\r\nfunction defaultNotFoundHandler(_request: Request): Response {\r\n    return new Response('Not Found', { status: 404 });\r\n}\r\n\r\nfunction matchRouteRules(pathname: string, rules: RouteRules): RouteRuleConfig | null {\r\n    for (const [pattern, config] of Object.entries(rules)) {\r\n        if (matchPath(pathname, pattern)) {\r\n            return config;\r\n        }\r\n    }\r\n    return null;\r\n}\r\n\r\nfunction matchPath(pathname: string, pattern: string): boolean {\r\n    // Handle exact match\r\n    if (pattern === pathname) return true;\r\n\r\n    // Handle wildcard patterns\r\n    if (pattern.endsWith('/**')) {\r\n        const prefix = pattern.slice(0, -3);\r\n        return pathname.startsWith(prefix);\r\n    }\r\n\r\n    if (pattern.endsWith('/*')) {\r\n        const prefix = pattern.slice(0, -2);\r\n        const rest = pathname.slice(prefix.length);\r\n        return pathname.startsWith(prefix) && !rest.includes('/');\r\n    }\r\n\r\n    // Handle dynamic params\r\n    const patternParts = pattern.split('/');\r\n    const pathParts = pathname.split('/');\r\n\r\n    if (patternParts.length !== pathParts.length) return false;\r\n\r\n    return patternParts.every((part, i) => {\r\n        if (part.startsWith('[') && part.endsWith(']')) return true;\r\n        if (part.startsWith(':')) return true;\r\n        return part === pathParts[i];\r\n    });\r\n}\r\n\r\nfunction extractParams(pathname: string, pattern: string): Record<string, string> {\r\n    const params: Record<string, string> = {};\r\n    const patternParts = pattern.split('/');\r\n    const pathParts = pathname.split('/');\r\n\r\n    patternParts.forEach((part, i) => {\r\n        if (part.startsWith('[') && part.endsWith(']')) {\r\n            const key = part.slice(1, -1).replace('...', '');\r\n            params[key] = pathParts[i] ?? '';\r\n        } else if (part.startsWith(':')) {\r\n            params[part.slice(1)] = pathParts[i] ?? '';\r\n        }\r\n    });\r\n\r\n    return params;\r\n}\r\n\r\nfunction handleRedirect(redirect: string | { to: string; statusCode?: number }): Response {\r\n    const to = typeof redirect === 'string' ? redirect : redirect.to;\r\n    const status = typeof redirect === 'string' ? 302 : (redirect.statusCode ?? 302);\r\n\r\n    return new Response(null, {\r\n        status,\r\n        headers: { Location: to },\r\n    });\r\n}\r\n\r\nasync function handleProxy(request: Request, target: string): Promise<Response> {\r\n    const url = new URL(request.url);\r\n    const targetUrl = new URL(target);\r\n    targetUrl.pathname = url.pathname;\r\n    targetUrl.search = url.search;\r\n\r\n    const proxyRequest = new Request(targetUrl.toString(), {\r\n        method: request.method,\r\n        headers: request.headers,\r\n        body: request.body,\r\n    });\r\n\r\n    return fetch(proxyRequest);\r\n}\r\n\r\nfunction handleCorsPreFlight(cors: boolean | CorsOptions): Response {\r\n    // Normalize CORS options - true means default options, object means custom\r\n    const options: CorsOptions = cors === true ? {} : (cors || {});\r\n\r\n    return new Response(null, {\r\n        status: 204,\r\n        headers: {\r\n            'Access-Control-Allow-Origin': resolveOrigin(options.origin),\r\n            'Access-Control-Allow-Methods': (options.methods ?? ['GET', 'POST', 'PUT', 'DELETE', 'PATCH']).join(', '),\r\n            'Access-Control-Allow-Headers': (options.allowedHeaders ?? ['Content-Type', 'Authorization']).join(', '),\r\n            'Access-Control-Max-Age': String(options.maxAge ?? 86400),\r\n            ...(options.credentials && { 'Access-Control-Allow-Credentials': 'true' }),\r\n        },\r\n    });\r\n}\r\n\r\nfunction resolveOrigin(origin?: string | string[] | boolean): string {\r\n    if (origin === true || origin === undefined) return '*';\r\n    if (origin === false) return '*';\r\n    if (Array.isArray(origin)) return origin[0] ?? '*';\r\n    return origin;\r\n}\r\n\r\nfunction applyCacheHeaders(response: Response, cache: { maxAge?: number; swr?: number }): Response {\r\n    const headers = new Headers(response.headers);\r\n\r\n    let cacheControl = `public, max-age=${cache.maxAge ?? 0}`;\r\n    if (cache.swr) {\r\n        cacheControl += `, stale-while-revalidate=${cache.swr}`;\r\n    }\r\n\r\n    headers.set('Cache-Control', cacheControl);\r\n\r\n    return new Response(response.body, {\r\n        status: response.status,\r\n        statusText: response.statusText,\r\n        headers,\r\n    });\r\n}\r\n\r\nfunction applyCorsHeaders(response: Response, cors: boolean | CorsOptions, _request: Request): Response {\r\n    // Normalize CORS options\r\n    const options: CorsOptions = cors === true ? {} : (cors || {});\r\n    const headers = new Headers(response.headers);\r\n\r\n    headers.set('Access-Control-Allow-Origin', resolveOrigin(options.origin));\r\n\r\n    if (options.credentials) {\r\n        headers.set('Access-Control-Allow-Credentials', 'true');\r\n    }\r\n\r\n    if (options.exposedHeaders) {\r\n        headers.set('Access-Control-Expose-Headers', options.exposedHeaders.join(', '));\r\n    }\r\n\r\n    return new Response(response.body, {\r\n        status: response.status,\r\n        statusText: response.statusText,\r\n        headers,\r\n    });\r\n}\r\n\r\nfunction applyCustomHeaders(response: Response, customHeaders: Record<string, string>): Response {\r\n    const headers = new Headers(response.headers);\r\n\r\n    for (const [key, value] of Object.entries(customHeaders)) {\r\n        headers.set(key, value);\r\n    }\r\n\r\n    return new Response(response.body, {\r\n        status: response.status,\r\n        statusText: response.statusText,\r\n        headers,\r\n    });\r\n}\r\n\r\nasync function handleSSR(context: RenderContext, options: UniversalHandlerOptions): Promise<Response> {\r\n    const { framework, hooks } = options;\r\n\r\n    // If no framework adapter, return placeholder\r\n    if (!framework) {\r\n        return new Response(createPlaceholderHTML(context.url.pathname), {\r\n            headers: { 'Content-Type': 'text/html; charset=utf-8' },\r\n        });\r\n    }\r\n\r\n    // Render with framework adapter\r\n    let result = await framework.renderToString({} as never, context);\r\n\r\n    // Run afterRender hook\r\n    if (hooks?.afterRender) {\r\n        const modifiedResult = await hooks.afterRender(result);\r\n        if (modifiedResult) result = modifiedResult;\r\n    }\r\n\r\n    return new Response(result.html, {\r\n        status: result.status,\r\n        headers: result.headers,\r\n    });\r\n}\r\n\r\nasync function handleSSG(context: RenderContext, options: UniversalHandlerOptions): Promise<Response> {\r\n    // For SSG, typically serve pre-rendered HTML\r\n    // Fall back to SSR if not found\r\n    return handleSSR(context, options);\r\n}\r\n\r\nfunction handleCSR(options: UniversalHandlerOptions): Response {\r\n    const html = `<!DOCTYPE html>\r\n<html>\r\n  <head>\r\n    <meta charset=\"UTF-8\">\r\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\r\n    <title>Flight App</title>\r\n  </head>\r\n  <body>\r\n    <div id=\"app\"></div>\r\n    <script type=\"module\" src=\"/assets/client.js\"></script>\r\n  </body>\r\n</html>`;\r\n\r\n    return new Response(html, {\r\n        headers: { 'Content-Type': 'text/html; charset=utf-8' },\r\n    });\r\n}\r\n\r\nfunction createPlaceholderHTML(pathname: string): string {\r\n    return `<!DOCTYPE html>\r\n<html>\r\n  <head>\r\n    <meta charset=\"UTF-8\">\r\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\r\n    <title>Flight</title>\r\n    <style>\r\n      body { font-family: system-ui, sans-serif; display: flex; align-items: center; justify-content: center; min-height: 100vh; margin: 0; background: #0a0a0a; color: #fafafa; }\r\n      .container { text-align: center; }\r\n      h1 { font-size: 3rem; margin-bottom: 0.5rem; }\r\n      p { color: #888; }\r\n      code { background: #1a1a1a; padding: 0.25rem 0.5rem; border-radius: 4px; font-size: 0.875rem; }\r\n    </style>\r\n  </head>\r\n  <body>\r\n    <div class=\"container\">\r\n      <h1>Flight</h1>\r\n      <p>Path: <code>${pathname}</code></p>\r\n      <p>Configure a UI framework adapter to enable SSR.</p>\r\n    </div>\r\n  </body>\r\n</html>`;\r\n}\r\n\r\n// Note: All exports are at the point of definition (export interface, export function)\r\n","/**\r\n * Flight Adapters - Optional Validation Helpers\r\n * \r\n * This module provides optional validation utilities for adapter options.\r\n * Zod is NOT required - these are only used if the developer chooses to\r\n * add runtime validation to their adapter.\r\n * \r\n * @example Without validation (default - no Zod needed)\r\n * ```typescript\r\n * import { createAdapter } from '@flightdev/core/adapters';\r\n * \r\n * export default function myAdapter(options = {}) {\r\n *     return createAdapter({\r\n *         name: 'my-adapter',\r\n *         adapt: async (builder) => { ... }\r\n *     });\r\n * }\r\n * ```\r\n * \r\n * @example With optional Zod validation (if developer wants it)\r\n * ```typescript\r\n * import { createValidatedAdapter } from '@flightdev/core/adapters';\r\n * import { z } from 'zod';\r\n * \r\n * const optionsSchema = z.object({\r\n *     port: z.number().default(3000),\r\n *     healthCheck: z.boolean().default(true),\r\n * });\r\n * \r\n * export default createValidatedAdapter(\r\n *     'my-adapter',\r\n *     optionsSchema,\r\n *     (options) => ({\r\n *         adapt: async (builder) => { ... }\r\n *     })\r\n * );\r\n * ```\r\n * \r\n * @module @flightdev/core/adapters/validation\r\n */\r\n\r\nimport type { FlightAdapter, AdapterBuilder } from './index.js';\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Minimal Zod-like schema interface\r\n * This allows the validation helper to work with Zod or any compatible library\r\n * without requiring Zod as a direct dependency\r\n */\r\nexport interface ZodLikeSchema<T = unknown> {\r\n    parse(data: unknown): T;\r\n    safeParse(data: unknown): { success: true; data: T } | { success: false; error: unknown };\r\n}\r\n\r\n/**\r\n * Options for validated adapter factory\r\n */\r\nexport interface ValidatedAdapterOptions<T> {\r\n    /** Parsed and validated options */\r\n    adapt: (builder: AdapterBuilder) => Promise<void>;\r\n    /** Optional emulate function */\r\n    emulate?: FlightAdapter['emulate'];\r\n    /** Optional supports declaration */\r\n    supports?: FlightAdapter['supports'];\r\n}\r\n\r\n// ============================================================================\r\n// Validation Helpers\r\n// ============================================================================\r\n\r\n/**\r\n * Create a validated adapter factory\r\n * \r\n * This helper validates adapter options at runtime using a Zod-like schema.\r\n * The developer chooses whether to use this - it's completely optional.\r\n * \r\n * @param name - Adapter name\r\n * @param schema - Zod-like schema for options validation\r\n * @param factory - Factory function that receives validated options\r\n * @returns Adapter factory function\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createValidatedAdapter } from '@flightdev/core/adapters';\r\n * import { z } from 'zod';\r\n * \r\n * const schema = z.object({\r\n *     port: z.number().default(3000),\r\n *     region: z.string().optional(),\r\n * });\r\n * \r\n * export default createValidatedAdapter('my-adapter', schema, (options) => ({\r\n *     adapt: async (builder) => {\r\n *         // options is fully typed: { port: number; region?: string }\r\n *         console.log(`Using port ${options.port}`);\r\n *     }\r\n * }));\r\n * ```\r\n */\r\nexport function createValidatedAdapter<TSchema extends ZodLikeSchema>(\r\n    name: string,\r\n    schema: TSchema,\r\n    factory: (options: ReturnType<TSchema['parse']>) => ValidatedAdapterOptions<ReturnType<TSchema['parse']>>\r\n): (options?: unknown) => FlightAdapter {\r\n    return (rawOptions: unknown = {}): FlightAdapter => {\r\n        // Validate options using the provided schema\r\n        const parseResult = schema.safeParse(rawOptions);\r\n\r\n        if (!parseResult.success) {\r\n            const errorMessage = formatValidationError(name, parseResult.error);\r\n            throw new Error(errorMessage);\r\n        }\r\n\r\n        const validatedOptions = parseResult.data as ReturnType<TSchema['parse']>;\r\n        const adapterConfig = factory(validatedOptions);\r\n\r\n        return {\r\n            name,\r\n            adapt: adapterConfig.adapt,\r\n            emulate: adapterConfig.emulate,\r\n            supports: adapterConfig.supports,\r\n        };\r\n    };\r\n}\r\n\r\n/**\r\n * Validate adapter options without throwing\r\n * Returns null if validation fails, useful for optional validation\r\n * \r\n * @param schema - Zod-like schema\r\n * @param options - Options to validate\r\n * @returns Validated options or null\r\n */\r\nexport function validateAdapterOptions<TSchema extends ZodLikeSchema>(\r\n    schema: TSchema,\r\n    options: unknown\r\n): ReturnType<TSchema['parse']> | null {\r\n    const result = schema.safeParse(options);\r\n    return result.success ? (result.data as ReturnType<TSchema['parse']>) : null;\r\n}\r\n\r\n/**\r\n * Assert adapter options are valid, throwing detailed error if not\r\n * \r\n * @param name - Adapter name for error messages\r\n * @param schema - Zod-like schema\r\n * @param options - Options to validate\r\n * @returns Validated options\r\n * @throws Error with detailed message if validation fails\r\n */\r\nexport function assertValidOptions<TSchema extends ZodLikeSchema>(\r\n    name: string,\r\n    schema: TSchema,\r\n    options: unknown\r\n): ReturnType<TSchema['parse']> {\r\n    const result = schema.safeParse(options);\r\n\r\n    if (!result.success) {\r\n        throw new Error(formatValidationError(name, result.error));\r\n    }\r\n\r\n    return result.data as ReturnType<TSchema['parse']>;\r\n}\r\n\r\n// ============================================================================\r\n// Error Formatting\r\n// ============================================================================\r\n\r\n/**\r\n * Format a validation error into a readable message\r\n */\r\nfunction formatValidationError(adapterName: string, error: unknown): string {\r\n    const prefix = `[${adapterName}] Invalid adapter options`;\r\n\r\n    // Handle Zod errors\r\n    if (error && typeof error === 'object' && 'issues' in error) {\r\n        const zodError = error as { issues: Array<{ path: (string | number)[]; message: string }> };\r\n        const issues = zodError.issues\r\n            .map(issue => `  - ${issue.path.join('.')}: ${issue.message}`)\r\n            .join('\\n');\r\n        return `${prefix}:\\n${issues}`;\r\n    }\r\n\r\n    // Fallback for other error types\r\n    if (error instanceof Error) {\r\n        return `${prefix}: ${error.message}`;\r\n    }\r\n\r\n    return `${prefix}: Unknown validation error`;\r\n}\r\n\r\n// ============================================================================\r\n// Type Utilities\r\n// ============================================================================\r\n\r\n/**\r\n * Extract the inferred type from a Zod-like schema\r\n * Useful for typing adapter options in TypeScript\r\n */\r\nexport type InferSchema<T extends ZodLikeSchema> = ReturnType<T['parse']>;\r\n","/**\r\n * Flight Adapters - Universal deployment adapters\r\n * \r\n * Adapters transform Flight's output for different deployment targets.\r\n * The user chooses where to deploy - Flight provides the adapters.\r\n */\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/** Build manifest containing all generated assets */\r\nexport interface BuildManifest {\r\n    /** Entry points by name */\r\n    entries: Record<string, string>;\r\n    /** All generated files */\r\n    files: string[];\r\n    /** Route information */\r\n    routes: RouteManifestEntry[];\r\n    /** Server entry point (if applicable) */\r\n    serverEntry?: string;\r\n    /** Client entry point */\r\n    clientEntry?: string;\r\n}\r\n\r\n/** Route information in manifest */\r\nexport interface RouteManifestEntry {\r\n    /** Route path pattern */\r\n    path: string;\r\n    /** Render mode for this route */\r\n    mode: 'ssr' | 'ssg' | 'csr' | 'isr';\r\n    /** Component/handler file path */\r\n    component: string;\r\n    /** Pre-rendered paths (for SSG/ISR) */\r\n    prerendered?: string[];\r\n}\r\n\r\n/** Builder utilities passed to adapters */\r\nexport interface AdapterBuilder {\r\n    /** Build manifest */\r\n    manifest: BuildManifest;\r\n    /** Project root directory */\r\n    root: string;\r\n    /** Build output directory */\r\n    outDir: string;\r\n\r\n    /** Read a file from the build output */\r\n    readFile(path: string): Promise<string>;\r\n    /** Write a file to the adapter output */\r\n    writeFile(path: string, content: string): Promise<void>;\r\n    /** Copy files from build to adapter output */\r\n    copy(from: string, to: string): Promise<void>;\r\n    /** Get all files matching a pattern */\r\n    glob(pattern: string): Promise<string[]>;\r\n    /** Compress files for production */\r\n    compress?(files: string[]): Promise<void>;\r\n\r\n    /** Log info message */\r\n    log: {\r\n        info(message: string): void;\r\n        warn(message: string): void;\r\n        error(message: string): void;\r\n    };\r\n}\r\n\r\n/** Flight adapter interface */\r\nexport interface FlightAdapter {\r\n    /** Adapter name */\r\n    name: string;\r\n\r\n    /** \r\n     * Transform the build output for the target platform\r\n     * This is called after Flight's build process completes\r\n     */\r\n    adapt(builder: AdapterBuilder): Promise<void>;\r\n\r\n    /**\r\n     * Optional: Start listening for requests (for Node.js/Bun adapters)\r\n     */\r\n    listen?(server: unknown, port: number): Promise<void>;\r\n\r\n    /**\r\n     * Optional: Emulate the platform during development\r\n     * Useful for testing platform-specific behavior locally\r\n     */\r\n    emulate?(): {\r\n        /** Platform-specific env vars */\r\n        env?: Record<string, string>;\r\n        /** Custom middleware for dev server */\r\n        middleware?: unknown[];\r\n    };\r\n\r\n    /**\r\n     * Optional: Declare what this adapter supports\r\n     * Flight uses this to warn about incompatible features\r\n     */\r\n    supports?: {\r\n        /** Can read files at runtime (for dynamic content) */\r\n        read?: () => boolean;\r\n        /** Supports streaming responses */\r\n        streaming?: () => boolean;\r\n        /** Supports WebSockets */\r\n        websockets?: () => boolean;\r\n        /** Supports edge runtime */\r\n        edge?: () => boolean;\r\n        /** Supports Node.js runtime */\r\n        node?: () => boolean;\r\n    };\r\n}\r\n\r\n\r\n// ============================================================================\r\n// Adapter Factory Helper\r\n// ============================================================================\r\n\r\nexport interface AdapterOptions {\r\n    name: string;\r\n    adapt: (builder: AdapterBuilder) => Promise<void>;\r\n    emulate?: FlightAdapter['emulate'];\r\n    supports?: FlightAdapter['supports'];\r\n}\r\n\r\n/**\r\n * Create a Flight adapter\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createAdapter } from '@flightdev/core/adapters';\r\n * \r\n * export default function myAdapter(options = {}) {\r\n *   return createAdapter({\r\n *     name: 'my-adapter',\r\n *     async adapt(builder) {\r\n *       // Transform build output for your platform\r\n *     },\r\n *   });\r\n * }\r\n * ```\r\n */\r\nexport function createAdapter(options: AdapterOptions): FlightAdapter {\r\n    return {\r\n        name: options.name,\r\n        adapt: options.adapt,\r\n        emulate: options.emulate,\r\n        supports: options.supports,\r\n    };\r\n}\r\n\r\n// Re-export universal handler for adapters to use (optional)\r\nexport * from './handler.js';\r\n\r\n// Re-export optional validation helpers (Zod not required)\r\nexport * from './validation.js';\r\n\r\n// ============================================================================\r\n// Agnostic Service Adapters (Interfaces)\r\n// ============================================================================\r\n\r\n/**\r\n * Storage Adapter Interface\r\n * \r\n * Implement this to use any storage provider:\r\n * S3, Supabase Storage, Cloudflare R2, local filesystem, etc.\r\n */\r\nexport interface StorageAdapter {\r\n    name: string;\r\n\r\n    /** Upload a file */\r\n    upload(path: string, data: Buffer | Uint8Array | string, options?: {\r\n        contentType?: string;\r\n        metadata?: Record<string, string>;\r\n    }): Promise<{ url: string; path: string }>;\r\n\r\n    /** Download a file */\r\n    download(path: string): Promise<Buffer>;\r\n\r\n    /** Delete a file */\r\n    delete(path: string): Promise<void>;\r\n\r\n    /** List files with optional prefix */\r\n    list(prefix?: string): Promise<string[]>;\r\n\r\n    /** Get a signed URL for direct access */\r\n    getSignedUrl?(path: string, options?: {\r\n        expiresIn?: number;\r\n        operation?: 'read' | 'write';\r\n    }): Promise<string>;\r\n}\r\n\r\n/**\r\n * Auth Adapter Interface\r\n * \r\n * Implement this to use any auth provider:\r\n * Better Auth, Supabase Auth, Lucia, Auth.js, etc.\r\n */\r\nexport interface AuthAdapter {\r\n    name: string;\r\n\r\n    /** Get the current user from a request */\r\n    getUser(request: Request): Promise<AuthUser | null>;\r\n\r\n    /** Verify a session token */\r\n    verifySession(token: string): Promise<AuthSession | null>;\r\n\r\n    /** Optional middleware for handling auth-specific routes (e.g., /api/auth/*) */\r\n    middleware?: (req: Request) => Promise<Response | null>;\r\n}\r\n\r\nexport interface AuthUser {\r\n    id: string;\r\n    email?: string;\r\n    name?: string;\r\n    avatar?: string;\r\n    metadata?: Record<string, unknown>;\r\n}\r\n\r\nexport interface AuthSession {\r\n    user: AuthUser;\r\n    expiresAt: Date;\r\n    token: string;\r\n}\r\n\r\n/**\r\n * Email Adapter Interface\r\n * \r\n * Implement this to use any email provider:\r\n * Resend, SendGrid, Postmark, SMTP, etc.\r\n */\r\nexport interface EmailAdapter {\r\n    name: string;\r\n\r\n    /** Send an email */\r\n    send(options: {\r\n        to: string | string[];\r\n        subject: string;\r\n        html?: string;\r\n        text?: string;\r\n        from?: string;\r\n        replyTo?: string;\r\n        attachments?: Array<{\r\n            filename: string;\r\n            content: Buffer | string;\r\n            contentType?: string;\r\n        }>;\r\n    }): Promise<{ id: string; success: boolean }>;\r\n}\r\n\r\n/**\r\n * Queue/Jobs Adapter Interface\r\n * \r\n * Implement this to use any job queue:\r\n * BullMQ, Quirrel, Inngest, custom, etc.\r\n */\r\nexport interface JobsAdapter {\r\n    name: string;\r\n\r\n    /** Add a job to the queue */\r\n    enqueue<T>(jobName: string, data: T, options?: {\r\n        delay?: number;\r\n        priority?: number;\r\n        retries?: number;\r\n    }): Promise<{ id: string }>;\r\n\r\n    /** Schedule a recurring job */\r\n    schedule?(jobName: string, cron: string, data?: unknown): Promise<{ id: string }>;\r\n\r\n    /** Cancel a job */\r\n    cancel?(jobId: string): Promise<void>;\r\n}\r\n\r\n/**\r\n * Database Adapter Interface\r\n * \r\n * Note: This is intentionally minimal. \r\n * For databases, use your preferred ORM/query builder directly.\r\n * This interface is for Flight's internal use (sessions, cache, etc.)\r\n */\r\nexport interface DatabaseAdapter {\r\n    name: string;\r\n\r\n    /** Raw query execution */\r\n    query<T = unknown>(sql: string, params?: unknown[]): Promise<T[]>;\r\n\r\n    /** Execute a mutation */\r\n    execute(sql: string, params?: unknown[]): Promise<{ rowsAffected: number }>;\r\n\r\n    /** Transaction support */\r\n    transaction?<T>(fn: (tx: DatabaseAdapter) => Promise<T>): Promise<T>;\r\n}\r\n"]}