@flight-framework/core 0.4.0 → 0.5.0

package/dist/adapters/index.d.ts

@@ -134,6 +134,128 @@ interface UniversalHandler {
  */
 declare function createUniversalHandler(options?: UniversalHandlerOptions): UniversalHandler;
 
+/**
+ * Flight Adapters - Optional Validation Helpers
+ *
+ * This module provides optional validation utilities for adapter options.
+ * Zod is NOT required - these are only used if the developer chooses to
+ * add runtime validation to their adapter.
+ *
+ * @example Without validation (default - no Zod needed)
+ * ```typescript
+ * import { createAdapter } from '@flight-framework/core/adapters';
+ *
+ * export default function myAdapter(options = {}) {
+ *     return createAdapter({
+ *         name: 'my-adapter',
+ *         adapt: async (builder) => { ... }
+ *     });
+ * }
+ * ```
+ *
+ * @example With optional Zod validation (if developer wants it)
+ * ```typescript
+ * import { createValidatedAdapter } from '@flight-framework/core/adapters';
+ * import { z } from 'zod';
+ *
+ * const optionsSchema = z.object({
+ *     port: z.number().default(3000),
+ *     healthCheck: z.boolean().default(true),
+ * });
+ *
+ * export default createValidatedAdapter(
+ *     'my-adapter',
+ *     optionsSchema,
+ *     (options) => ({
+ *         adapt: async (builder) => { ... }
+ *     })
+ * );
+ * ```
+ *
+ * @module @flight-framework/core/adapters/validation
+ */
+
+/**
+ * Minimal Zod-like schema interface
+ * This allows the validation helper to work with Zod or any compatible library
+ * without requiring Zod as a direct dependency
+ */
+interface ZodLikeSchema<T = unknown> {
+    parse(data: unknown): T;
+    safeParse(data: unknown): {
+        success: true;
+        data: T;
+    } | {
+        success: false;
+        error: unknown;
+    };
+}
+/**
+ * Options for validated adapter factory
+ */
+interface ValidatedAdapterOptions<T> {
+    /** Parsed and validated options */
+    adapt: (builder: AdapterBuilder) => Promise<void>;
+    /** Optional emulate function */
+    emulate?: FlightAdapter['emulate'];
+    /** Optional supports declaration */
+    supports?: FlightAdapter['supports'];
+}
+/**
+ * Create a validated adapter factory
+ *
+ * This helper validates adapter options at runtime using a Zod-like schema.
+ * The developer chooses whether to use this - it's completely optional.
+ *
+ * @param name - Adapter name
+ * @param schema - Zod-like schema for options validation
+ * @param factory - Factory function that receives validated options
+ * @returns Adapter factory function
+ *
+ * @example
+ * ```typescript
+ * import { createValidatedAdapter } from '@flight-framework/core/adapters';
+ * import { z } from 'zod';
+ *
+ * const schema = z.object({
+ *     port: z.number().default(3000),
+ *     region: z.string().optional(),
+ * });
+ *
+ * export default createValidatedAdapter('my-adapter', schema, (options) => ({
+ *     adapt: async (builder) => {
+ *         // options is fully typed: { port: number; region?: string }
+ *         console.log(`Using port ${options.port}`);
+ *     }
+ * }));
+ * ```
+ */
+declare function createValidatedAdapter<TSchema extends ZodLikeSchema>(name: string, schema: TSchema, factory: (options: ReturnType<TSchema['parse']>) => ValidatedAdapterOptions<ReturnType<TSchema['parse']>>): (options?: unknown) => FlightAdapter;
+/**
+ * Validate adapter options without throwing
+ * Returns null if validation fails, useful for optional validation
+ *
+ * @param schema - Zod-like schema
+ * @param options - Options to validate
+ * @returns Validated options or null
+ */
+declare function validateAdapterOptions<TSchema extends ZodLikeSchema>(schema: TSchema, options: unknown): ReturnType<TSchema['parse']> | null;
+/**
+ * Assert adapter options are valid, throwing detailed error if not
+ *
+ * @param name - Adapter name for error messages
+ * @param schema - Zod-like schema
+ * @param options - Options to validate
+ * @returns Validated options
+ * @throws Error with detailed message if validation fails
+ */
+declare function assertValidOptions<TSchema extends ZodLikeSchema>(name: string, schema: TSchema, options: unknown): ReturnType<TSchema['parse']>;
+/**
+ * Extract the inferred type from a Zod-like schema
+ * Useful for typing adapter options in TypeScript
+ */
+type InferSchema<T extends ZodLikeSchema> = ReturnType<T['parse']>;
+
 /**
  * Flight Adapters - Universal deployment adapters
  *
@@ -377,4 +499,4 @@ interface DatabaseAdapter {
     transaction?<T>(fn: (tx: DatabaseAdapter) => Promise<T>): Promise<T>;
 }
 
-export { type AdapterBuilder, type AdapterOptions, type AuthAdapter, type AuthSession, type AuthUser, type BuildManifest, type CorsOptions, type DatabaseAdapter, type EmailAdapter, type FlightAdapter, type HandlerHooks, type JobsAdapter, type RouteManifest, type RouteManifestEntry, type RouteRuleConfig, type RouteRules, type StorageAdapter, type UniversalHandler, type UniversalHandlerOptions, createAdapter, createUniversalHandler };
+export { type AdapterBuilder, type AdapterOptions, type AuthAdapter, type AuthSession, type AuthUser, type BuildManifest, type CorsOptions, type DatabaseAdapter, type EmailAdapter, type FlightAdapter, type HandlerHooks, type InferSchema, type JobsAdapter, type RouteManifest, type RouteManifestEntry, type RouteRuleConfig, type RouteRules, type StorageAdapter, type UniversalHandler, type UniversalHandlerOptions, type ValidatedAdapterOptions, type ZodLikeSchema, assertValidOptions, createAdapter, createUniversalHandler, createValidatedAdapter, validateAdapterOptions };

package/dist/adapters/index.js

@@ -1,3 +1,3 @@
-export { createAdapter, createUniversalHandler } from '../chunk-K5NYYNFS.js';
+export { assertValidOptions, createAdapter, createUniversalHandler, createValidatedAdapter, validateAdapterOptions } from '../chunk-77MJZCYD.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{chunk-K5NYYNFS.js → chunk-77MJZCYD.js}

@@ -296,6 +296,49 @@ function createPlaceholderHTML(pathname) {
 </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 {
@@ -306,6 +349,6 @@ function createAdapter(options) {
   };
 }
 
-export { createAdapter, createUniversalHandler };
-//# sourceMappingURL=chunk-K5NYYNFS.js.map
-//# sourceMappingURL=chunk-K5NYYNFS.js.map
+export { assertValidOptions, createAdapter, createUniversalHandler, createValidatedAdapter, validateAdapterOptions };
+//# sourceMappingURL=chunk-77MJZCYD.js.map
+//# sourceMappingURL=chunk-77MJZCYD.js.map

package/dist/chunk-77MJZCYD.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-77MJZCYD.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 @flight-framework/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 '@flight-framework/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 '@flight-framework/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 '@flight-framework/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 @flight-framework/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 '@flight-framework/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 '@flight-framework/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"]}

package/dist/index.js

@@ -15,7 +15,7 @@ import './chunk-K2CQZPCG.js';
 export { composeComponents, createAsyncComponent, createClientBoundary, createRenderContext, deserializeProps, executeServerComponent, revalidatePath as rscRevalidatePath, revalidateTag as rscRevalidateTag, serializeProps, serverFetch, withErrorBoundary } from './chunk-LNV47HGV.js';
 import './chunk-ZIE56LCA.js';
 export { detectBoundaryType, hasUseClientDirective, hasUseServerDirective } from './chunk-PDW5WCMW.js';
-import './chunk-K5NYYNFS.js';
+import './chunk-77MJZCYD.js';
 export { createServer } from './chunk-EGB7C73X.js';
 export { createFileRouter, loadRoutes, scanRoutes } from './chunk-3KRBRSRJ.js';
 export { RedirectError, redirect as actionRedirect, cookies, executeAction, executeFormAction, getAction, handleActionRequest, isRedirectError, parseFormData, registerAction } from './chunk-3QP3E7HS.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flight-framework/core",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Core primitives for Flight Framework - routing, rendering, caching",
   "keywords": [
     "flight",

package/dist/chunk-K5NYYNFS.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/adapters/handler.ts","../src/adapters/index.ts"],"names":[],"mappings":"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","file":"chunk-K5NYYNFS.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 @flight-framework/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 '@flight-framework/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 - 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 '@flight-framework/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// ============================================================================\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"]}