@flight-framework/core 0.3.1 → 0.4.0

package/dist/chunk-K5NYYNFS.js.map

@@ -0,0 +1 @@
+{"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"]}

package/dist/{chunk-3ZSSRE6M.js → chunk-LNV47HGV.js}

@@ -139,6 +139,32 @@ function composeComponents(...components) {
     return results.join("");
   };
 }
+function withAsyncErrorBoundary(component, options) {
+  const { fallback, onError, rethrowNavigation = true } = options;
+  return async (props, context) => {
+    try {
+      return await component(props, context);
+    } catch (error) {
+      if (rethrowNavigation) {
+        if (isNotFoundError(error)) {
+          throw error;
+        }
+        if (isRedirectError(error)) {
+          throw error;
+        }
+      }
+      if (onError) {
+        try {
+          onError(error, props, context);
+        } catch (callbackError) {
+          console.error("[Flight] Error in onError callback:", callbackError);
+        }
+      }
+      console.error("[Flight] Async component error:", error);
+      return fallback(error, props);
+    }
+  };
+}
 function withErrorBoundary(component, errorFallback) {
   return async (props, context) => {
     try {
@@ -169,6 +195,6 @@ function isRedirectError(error) {
   return null;
 }
 
-export { composeComponents, createAsyncComponent, createClientBoundary, createRenderContext, deserializeProps, executeServerComponent, isNotFoundError, isRedirectError, notFound, redirect, revalidatePath, revalidateTag, serializeProps, serverFetch, withErrorBoundary };
-//# sourceMappingURL=chunk-3ZSSRE6M.js.map
-//# sourceMappingURL=chunk-3ZSSRE6M.js.map
+export { composeComponents, createAsyncComponent, createClientBoundary, createRenderContext, deserializeProps, executeServerComponent, isNotFoundError, isRedirectError, notFound, redirect, revalidatePath, revalidateTag, serializeProps, serverFetch, withAsyncErrorBoundary, withErrorBoundary };
+//# sourceMappingURL=chunk-LNV47HGV.js.map
+//# sourceMappingURL=chunk-LNV47HGV.js.map

package/dist/chunk-LNV47HGV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/rsc/legacy.ts"],"names":[],"mappings":"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","file":"chunk-LNV47HGV.js","sourcesContent":["/**\r\n * @flight-framework/core - Legacy RSC Support\r\n * \r\n * Backward compatibility module for the original RSC implementation.\r\n * Use the new API from './index.js' for new features.\r\n * \r\n * @deprecated Use the new RSC API instead\r\n * @module @flight-framework/core/rsc/legacy\r\n */\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Component rendering context\r\n * @deprecated Use ServerContext from './context.js' instead\r\n */\r\nexport interface RenderContext {\r\n    /** Current request */\r\n    request: Request;\r\n    /** Route params */\r\n    params: Record<string, string>;\r\n    /** Search params */\r\n    searchParams: URLSearchParams;\r\n    /** Request headers */\r\n    headers: Headers;\r\n    /** Cookies */\r\n    cookies: Map<string, string>;\r\n}\r\n\r\n/**\r\n * Server component definition\r\n * @deprecated Use ServerComponentFn from './index.js' instead\r\n */\r\nexport interface ServerComponent<P = unknown> {\r\n    (props: P, context: RenderContext): Promise<string> | string;\r\n    /** Mark as server component */\r\n    __flight_server?: true;\r\n    /** Dependencies for hydration */\r\n    __flight_deps?: string[];\r\n}\r\n\r\n/**\r\n * Client component definition\r\n * @deprecated Use ClientReference from './boundaries.js' instead\r\n */\r\nexport interface ClientComponent<P = unknown> {\r\n    (props: P): unknown;\r\n    /** Mark as client component */\r\n    __flight_client?: true;\r\n    /** Client bundle path */\r\n    __flight_bundle?: string;\r\n}\r\n\r\n/**\r\n * Component type detection\r\n */\r\nexport type ComponentType = 'server' | 'client' | 'hybrid';\r\n\r\n// ============================================================================\r\n// Server Component Execution\r\n// ============================================================================\r\n\r\n/**\r\n * Execute an async server component\r\n * @deprecated Use the new rendering pipeline instead\r\n */\r\nexport async function executeServerComponent<P>(\r\n    component: ServerComponent<P>,\r\n    props: P,\r\n    context: RenderContext\r\n): Promise<string> {\r\n    try {\r\n        const result = await component(props, context);\r\n        return result;\r\n    } catch (error) {\r\n        console.error('[Flight] Server component error:', error);\r\n        throw error;\r\n    }\r\n}\r\n\r\n/**\r\n * Create a render context from a Request\r\n * @deprecated Use createServerContext from './context.js' instead\r\n */\r\nexport function createRenderContext(request: Request, params: Record<string, string> = {}): RenderContext {\r\n    const url = new URL(request.url);\r\n\r\n    // Parse cookies\r\n    const cookies = new Map<string, string>();\r\n    const cookieHeader = request.headers.get('cookie') || '';\r\n    cookieHeader.split(';').forEach(cookie => {\r\n        const [key, value] = cookie.trim().split('=');\r\n        if (key && value) cookies.set(key, value);\r\n    });\r\n\r\n    return {\r\n        request,\r\n        params,\r\n        searchParams: url.searchParams,\r\n        headers: request.headers,\r\n        cookies,\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Data Fetching Helpers\r\n// ============================================================================\r\n\r\n/**\r\n * Cache for server-side fetch requests\r\n */\r\nconst fetchCache = new Map<string, { data: unknown; timestamp: number }>();\r\n\r\n/**\r\n * Server-side fetch with automatic caching\r\n */\r\nexport async function serverFetch<T>(\r\n    url: string,\r\n    options: RequestInit & {\r\n        revalidate?: number | false;\r\n        tags?: string[];\r\n    } = {}\r\n): Promise<T> {\r\n    const { revalidate = 60, ...fetchOptions } = options;\r\n    const cacheKey = `${url}:${JSON.stringify(fetchOptions)}`;\r\n\r\n    // Check cache\r\n    const cached = fetchCache.get(cacheKey);\r\n    if (cached) {\r\n        const age = Date.now() - cached.timestamp;\r\n        if (revalidate === false || age < (revalidate * 1000)) {\r\n            return cached.data as T;\r\n        }\r\n    }\r\n\r\n    // Fetch fresh data\r\n    const response = await fetch(url, fetchOptions);\r\n\r\n    if (!response.ok) {\r\n        throw new Error(`Fetch failed: ${response.status} ${response.statusText}`);\r\n    }\r\n\r\n    const data = await response.json();\r\n\r\n    // Cache the result\r\n    if (revalidate !== false) {\r\n        fetchCache.set(cacheKey, {\r\n            data,\r\n            timestamp: Date.now(),\r\n        });\r\n    }\r\n\r\n    return data as T;\r\n}\r\n\r\n/**\r\n * Invalidate cache by tag\r\n */\r\nexport function revalidateTag(tag: string): void {\r\n    console.log(`[Flight] Revalidating tag: ${tag}`);\r\n}\r\n\r\n/**\r\n * Invalidate cache by path\r\n */\r\nexport function revalidatePath(path: string): void {\r\n    console.log(`[Flight] Revalidating path: ${path}`);\r\n}\r\n\r\n// ============================================================================\r\n// Component Serialization\r\n// ============================================================================\r\n\r\n/**\r\n * Serialize props for transmission to client\r\n * @deprecated Use serialize from './payload.js' instead\r\n */\r\nexport function serializeProps(props: unknown): string {\r\n    function preProcess(value: unknown): unknown {\r\n        if (value instanceof Date) {\r\n            return { __type: 'Date', value: value.toISOString() };\r\n        }\r\n        if (value instanceof Map) {\r\n            return { __type: 'Map', value: Array.from(value.entries()).map(([k, v]) => [preProcess(k), preProcess(v)]) };\r\n        }\r\n        if (value instanceof Set) {\r\n            return { __type: 'Set', value: Array.from(value).map(preProcess) };\r\n        }\r\n        if (typeof value === 'bigint') {\r\n            return { __type: 'BigInt', value: value.toString() };\r\n        }\r\n        if (typeof value === 'function') {\r\n            return undefined;\r\n        }\r\n        if (Array.isArray(value)) {\r\n            return value.map(preProcess);\r\n        }\r\n        if (value && typeof value === 'object') {\r\n            const result: Record<string, unknown> = {};\r\n            for (const [k, v] of Object.entries(value)) {\r\n                result[k] = preProcess(v);\r\n            }\r\n            return result;\r\n        }\r\n        return value;\r\n    }\r\n\r\n    return JSON.stringify(preProcess(props));\r\n}\r\n\r\n/**\r\n * Deserialize props on client\r\n * @deprecated Use deserialize from './payload.js' instead\r\n */\r\nexport function deserializeProps<T>(serialized: string): T {\r\n    return JSON.parse(serialized, (_key, value) => {\r\n        if (value && typeof value === 'object' && '__type' in value) {\r\n            switch (value.__type) {\r\n                case 'Date':\r\n                    return new Date(value.value);\r\n                case 'Map':\r\n                    return new Map(value.value);\r\n                case 'Set':\r\n                    return new Set(value.value);\r\n                case 'BigInt':\r\n                    return BigInt(value.value);\r\n            }\r\n        }\r\n        return value;\r\n    });\r\n}\r\n\r\n// ============================================================================\r\n// Client Component Boundary\r\n// ============================================================================\r\n\r\n/**\r\n * Create a client boundary placeholder\r\n * @deprecated Use clientRef from './payload.js' instead\r\n */\r\nexport function createClientBoundary(\r\n    componentId: string,\r\n    props: unknown,\r\n    fallback?: string\r\n): string {\r\n    const serializedProps = serializeProps(props);\r\n\r\n    return `\r\n<!--flight-client:${componentId}-->\r\n<div data-flight-component=\"${componentId}\" data-flight-props='${serializedProps.replace(/'/g, \"&#39;\")}'>\r\n    ${fallback || '<div>Loading...</div>'}\r\n</div>\r\n<!--/flight-client-->\r\n<script type=\"module\">\r\n(async function() {\r\n    const component = await import('/_flight/components/${componentId}.js');\r\n    const props = JSON.parse('${serializedProps.replace(/'/g, \"\\\\'\")}');\r\n    const container = document.querySelector('[data-flight-component=\"${componentId}\"]');\r\n    if (container && component.default) {\r\n        if (typeof component.hydrate === 'function') {\r\n            component.hydrate(container, props);\r\n        }\r\n    }\r\n})();\r\n</script>`;\r\n}\r\n\r\n// ============================================================================\r\n// Async Component Helpers\r\n// ============================================================================\r\n\r\n/**\r\n * Helper to create an async server component\r\n * @deprecated Use async Server Components directly\r\n */\r\nexport function createAsyncComponent<P, T>(\r\n    fetcher: (props: P, context: RenderContext) => Promise<T>,\r\n    renderer: (data: T, props: P) => string\r\n): ServerComponent<P> {\r\n    const component: ServerComponent<P> = async (props, context) => {\r\n        const data = await fetcher(props, context);\r\n        return renderer(data, props);\r\n    };\r\n    component.__flight_server = true;\r\n    return component;\r\n}\r\n\r\n/**\r\n * Compose multiple server components\r\n * @deprecated Use Promise.all with async components\r\n */\r\nexport function composeComponents(\r\n    ...components: Array<() => Promise<string> | string>\r\n): () => Promise<string> {\r\n    return async () => {\r\n        const results = await Promise.all(\r\n            components.map(async (comp) => await comp())\r\n        );\r\n        return results.join('');\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Error Boundary for Server Components\r\n// ============================================================================\r\n\r\n/**\r\n * Options for async error boundary\r\n */\r\nexport interface AsyncErrorBoundaryOptions<P, R> {\r\n    /** Fallback to render on error */\r\n    fallback: (error: Error, props: P) => R;\r\n    /** Optional callback when error occurs */\r\n    onError?: (error: Error, props: P, context: RenderContext) => void;\r\n    /** Whether to rethrow certain errors (e.g., redirects, not found) */\r\n    rethrowNavigation?: boolean;\r\n}\r\n\r\n/**\r\n * Wrap an async server component with comprehensive error handling.\r\n *\r\n * @example\r\n * ```typescript\r\n * const SafeUserPage = withAsyncErrorBoundary(UserPage, {\r\n *     fallback: (error, props) => `<div>Error loading user ${props.id}</div>`,\r\n *     onError: (error, props) => console.error(`Failed to load user ${props.id}:`, error),\r\n *     rethrowNavigation: true,\r\n * });\r\n * ```\r\n */\r\nexport function withAsyncErrorBoundary<P, R = string>(\r\n    component: (props: P, context: RenderContext) => Promise<R> | R,\r\n    options: AsyncErrorBoundaryOptions<P, R>\r\n): (props: P, context: RenderContext) => Promise<R> {\r\n    const { fallback, onError, rethrowNavigation = true } = options;\r\n\r\n    return async (props: P, context: RenderContext): Promise<R> => {\r\n        try {\r\n            return await component(props, context);\r\n        } catch (error) {\r\n            // Rethrow navigation errors if configured\r\n            if (rethrowNavigation) {\r\n                if (isNotFoundError(error)) {\r\n                    throw error;\r\n                }\r\n                if (isRedirectError(error)) {\r\n                    throw error;\r\n                }\r\n            }\r\n\r\n            // Call error callback if provided\r\n            if (onError) {\r\n                try {\r\n                    onError(error as Error, props, context);\r\n                } catch (callbackError) {\r\n                    console.error('[Flight] Error in onError callback:', callbackError);\r\n                }\r\n            }\r\n\r\n            // Log error\r\n            console.error('[Flight] Async component error:', error);\r\n\r\n            // Return fallback\r\n            return fallback(error as Error, props);\r\n        }\r\n    };\r\n}\r\n\r\n/**\r\n * Wrap a server component with error handling\r\n * @deprecated Use withAsyncErrorBoundary instead\r\n */\r\nexport function withErrorBoundary<P>(\r\n    component: ServerComponent<P>,\r\n    errorFallback: (error: Error) => string\r\n): ServerComponent<P> {\r\n    return async (props: P, context: RenderContext) => {\r\n        try {\r\n            return await component(props, context);\r\n        } catch (error) {\r\n            console.error('[Flight] Server component error:', error);\r\n            return errorFallback(error as Error);\r\n        }\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Not Found / Redirect Helpers\r\n// ============================================================================\r\n\r\n/**\r\n * Throw a not found error\r\n * @deprecated Use notFound from './context.js' instead\r\n */\r\nexport function notFound(): never {\r\n    const error = new Error('Not Found');\r\n    (error as Error & { __flight_not_found: boolean }).__flight_not_found = true;\r\n    throw error;\r\n}\r\n\r\n/**\r\n * Check if error is not found\r\n * @deprecated Use isNotFoundError from './context.js' instead\r\n */\r\nexport function isNotFoundError(error: unknown): boolean {\r\n    return error instanceof Error && (error as Error & { __flight_not_found?: boolean }).__flight_not_found === true;\r\n}\r\n\r\n/**\r\n * Server-side redirect\r\n * @deprecated Use redirect from './context.js' instead\r\n */\r\nexport function redirect(url: string, type: 'replace' | 'push' = 'replace'): never {\r\n    const error = new Error(`Redirect: ${url}`);\r\n    (error as Error & { __flight_redirect: { url: string; type: string } }).__flight_redirect = { url, type };\r\n    throw error;\r\n}\r\n\r\n/**\r\n * Check if error is redirect\r\n * @deprecated Use isRedirectError from './context.js' instead\r\n */\r\nexport function isRedirectError(error: unknown): { url: string; type: string } | null {\r\n    if (error instanceof Error && (error as Error & { __flight_redirect?: unknown }).__flight_redirect) {\r\n        return (error as Error & { __flight_redirect: { url: string; type: string } }).__flight_redirect;\r\n    }\r\n    return null;\r\n}\r\n"]}

package/dist/client.d.ts

@@ -0,0 +1,25 @@
+export { FlightConfig, FlightUserConfig } from './config/index.js';
+export { Route, RouteMatch, RouteParams, Router, createRouter } from './router/index.js';
+export { Cache, CacheAdapter, CacheEntry, CacheOptions, CacheStats, CreateCacheOptions, Serializer, cacheKey, cached, createCache, dedupe, jsonSerializer, memory } from './cache/index.js';
+export { Middleware, MiddlewareContext, MiddlewareNext, createMiddlewareChain } from './middleware/index.js';
+export { CustomHydrationTrigger, HydrateOptions, HydrationTrigger, IslandConfig, hydrateIslands, registerFlightIslandElement } from './islands/index.js';
+export { BuiltInCondition, DEFAULT_BOT_PATTERNS, StreamingCondition, isBot, isSlowConnection, prefersNoStream, supportsStreaming } from './streaming/conditional.js';
+export { BadRequestError, ErrorBoundaryOptions, FlightError, FlightErrorOptions, FlightErrorProps, ForbiddenError, InternalError, NotFoundError, ResetDetails, UnauthorizedError, clearError, createError, getError, getErrorStatusCode, isFlightError, isForbiddenError as isForbidden, isNotFoundError as isNotFound, isUnauthorizedError as isUnauthorized, showError } from './errors/index.js';
+export { getEnvironment, isBrowser, isDevelopment, isProduction, isServer, isTest } from './utils/index.js';
+import './render/index.js';
+import './adapters/index.js';
+
+/**
+ * Flight Framework - Core (Browser-Safe Exports)
+ *
+ * This entry point only exports modules that are safe to use in browser environments.
+ * Use this import when building for the client:
+ *
+ *   import { ... } from '@flight-framework/core/client';
+ *
+ * Server-only modules (file-router, prerender, etc.) are NOT included.
+ */
+
+declare const VERSION = "0.0.1";
+
+export { VERSION };

package/dist/client.js

@@ -0,0 +1,16 @@
+export { DEFAULT_BOT_PATTERNS, isBot, isSlowConnection, prefersNoStream, supportsStreaming } from './chunk-XOIYNY4I.js';
+export { hydrateIslands, registerFlightIslandElement } from './chunk-WFAWAHJH.js';
+export { createMiddlewareChain } from './chunk-OYF2OAKS.js';
+import './chunk-IXMD5QH2.js';
+export { BadRequestError, FlightError, ForbiddenError, InternalError, NotFoundError, UnauthorizedError, clearError, createError, getError, getErrorStatusCode, isFlightError, isForbiddenError as isForbidden, isNotFoundError as isNotFound, isUnauthorizedError as isUnauthorized, showError } from './chunk-FSJNOPYE.js';
+import './chunk-PL37KFRJ.js';
+export { getEnvironment, isBrowser, isDevelopment, isProduction, isServer, isTest } from './chunk-YHEVHRLH.js';
+export { createRouter } from './chunk-GCQZ4FHI.js';
+export { cacheKey, cached, createCache, dedupe, jsonSerializer, memory } from './chunk-R7SQAREQ.js';
+
+// src/client.ts
+var VERSION = "0.0.1";
+
+export { VERSION };
+//# sourceMappingURL=client.js.map
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":";;;;;;;;;;;AAuGO,IAAM,OAAA,GAAU","file":"client.js","sourcesContent":["/**\r\n * Flight Framework - Core (Browser-Safe Exports)\r\n *\r\n * This entry point only exports modules that are safe to use in browser environments.\r\n * Use this import when building for the client:\r\n *\r\n *   import { ... } from '@flight-framework/core/client';\r\n *\r\n * Server-only modules (file-router, prerender, etc.) are NOT included.\r\n */\r\n\r\n// Configuration (browser-safe parts only)\r\nexport { type FlightConfig, type FlightUserConfig } from './config/index.js';\r\n\r\n// Router (browser-safe)\r\nexport {\r\n    createRouter,\r\n    type Route,\r\n    type RouteMatch,\r\n    type Router,\r\n    type RouteParams,\r\n} from './router/index.js';\r\n\r\n// Cache (browser-safe)\r\nexport {\r\n    createCache,\r\n    memory,\r\n    cacheKey,\r\n    cached,\r\n    dedupe,\r\n    jsonSerializer,\r\n    type Cache,\r\n    type CacheOptions,\r\n    type CacheEntry,\r\n    type CacheAdapter,\r\n    type CacheStats,\r\n    type Serializer,\r\n    type CreateCacheOptions,\r\n} from './cache/index.js';\r\n\r\n// Middleware (browser-safe)\r\nexport {\r\n    createMiddlewareChain,\r\n    type Middleware,\r\n    type MiddlewareContext,\r\n    type MiddlewareNext,\r\n} from './middleware/index.js';\r\n\r\n// Islands (browser-safe hydration)\r\nexport {\r\n    hydrateIslands,\r\n    registerFlightIslandElement,\r\n    type HydrationTrigger,\r\n    type CustomHydrationTrigger,\r\n    type IslandConfig,\r\n    type HydrateOptions,\r\n} from './islands/index.js';\r\n\r\n// Streaming Conditional (browser-safe detection)\r\nexport {\r\n    isBot,\r\n    prefersNoStream,\r\n    isSlowConnection,\r\n    supportsStreaming,\r\n    DEFAULT_BOT_PATTERNS,\r\n    type StreamingCondition,\r\n    type BuiltInCondition,\r\n} from './streaming/conditional.js';\r\n\r\n// Error Handling (browser-safe)\r\nexport {\r\n    FlightError,\r\n    BadRequestError,\r\n    UnauthorizedError,\r\n    ForbiddenError,\r\n    NotFoundError,\r\n    InternalError,\r\n    createError,\r\n    showError,\r\n    clearError,\r\n    getError,\r\n    isFlightError,\r\n    isNotFoundError as isNotFound,\r\n    isForbiddenError as isForbidden,\r\n    isUnauthorizedError as isUnauthorized,\r\n    getErrorStatusCode,\r\n    type FlightErrorOptions,\r\n    type FlightErrorProps,\r\n    type ResetDetails,\r\n    type ErrorBoundaryOptions,\r\n} from './errors/index.js';\r\n\r\n// Environment Utilities (browser-safe)\r\nexport {\r\n    isProduction,\r\n    isDevelopment,\r\n    isTest,\r\n    isServer,\r\n    isBrowser,\r\n    getEnvironment,\r\n} from './utils/index.js';\r\n\r\n// Version\r\nexport const VERSION = '0.0.1';\r\n"]}

package/dist/index.js

@@ -1,36 +1,36 @@
+export { streamWithPriority, validateDependencies } from './chunk-WOEIJWGJ.js';
 export { MetricsAggregator, createHttpObserver, createInstrumentedStream, createLoggerObserver } from './chunk-6BDCTUQY.js';
-export { DEFAULT_BOT_PATTERNS, addStreamingHeaders, createConditionalStreamer, createStreamingResponse as createConditionalStreamingResponse, createStaticResponse, isBot, isSlowConnection, prefersNoStream, streamIf, supportsStreaming } from './chunk-XOIYNY4I.js';
 export { createHTMXStreamAdapter, createReactStreamAdapter, createSolidStreamAdapter, createStreamAdapter, createSvelteStreamAdapter, createVueStreamAdapter } from './chunk-MQQLYWZZ.js';
-export { createIslandRegistry, createPreactIslandAdapter, createReactIslandAdapter, createSolidIslandAdapter, createVueIslandAdapter, defineIsland, hydrateIslands, registerFlightIslandElement, registerIsland, renderIsland, renderIslands, setIslandAdapter } from './chunk-WFAWAHJH.js';
 export { DEFAULT_STREAMING_HINTS, createStreamingController, generateCacheKey, getStreamingCacheHeaders, hasStreamingConfig, isValidStreamingHints, loadRouteWithStreaming, resolveStreamingConfig, shouldStream } from './chunk-XSY5AAXT.js';
-export { streamWithPriority, validateDependencies } from './chunk-WOEIJWGJ.js';
-import './chunk-SUILH4ID.js';
-export { createServer } from './chunk-ROJFQCGV.js';
-export { defineConfig } from './chunk-IXMD5QH2.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';
-export { createRouteContext, error, json, parseBody, redirect } from './chunk-W6D62JCI.js';
-export { createLazyContent, createStreamingResponse, createStreamingSSR, renderWithStreaming, streamParallel, streamSequential } from './chunk-RSVA2EYO.js';
 import './chunk-63SCEXD7.js';
+import './chunk-Y22AMGTM.js';
+import './chunk-TASAT7KB.js';
+import './chunk-2F2QU6RC.js';
+import './chunk-VPFMHGEV.js';
+import './chunk-MDQNNIHH.js';
 export { createServerContext, isNotFoundError, isRedirectError as isRscRedirectError, notFound, redirect as rscRedirect } from './chunk-62C7LX2E.js';
 import './chunk-PVUMB632.js';
 import './chunk-P6WSBVDT.js';
 import './chunk-K2CQZPCG.js';
-export { composeComponents, createAsyncComponent, createClientBoundary, createRenderContext, deserializeProps, executeServerComponent, revalidatePath as rscRevalidatePath, revalidateTag as rscRevalidateTag, serializeProps, serverFetch, withErrorBoundary } from './chunk-3ZSSRE6M.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-Y22AMGTM.js';
-import './chunk-TASAT7KB.js';
-import './chunk-2F2QU6RC.js';
-import './chunk-VPFMHGEV.js';
-import './chunk-MDQNNIHH.js';
+import './chunk-K5NYYNFS.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';
+export { createRouteContext, error, json, parseBody, redirect } from './chunk-W6D62JCI.js';
+export { createLazyContent, createStreamingResponse, createStreamingSSR, renderWithStreaming, streamParallel, streamSequential } from './chunk-RSVA2EYO.js';
+export { DEFAULT_BOT_PATTERNS, addStreamingHeaders, createConditionalStreamer, createStreamingResponse as createConditionalStreamingResponse, createStaticResponse, isBot, isSlowConnection, prefersNoStream, streamIf, supportsStreaming } from './chunk-XOIYNY4I.js';
+export { createIslandRegistry, createPreactIslandAdapter, createReactIslandAdapter, createSolidIslandAdapter, createVueIslandAdapter, defineIsland, hydrateIslands, registerFlightIslandElement, registerIsland, renderIsland, renderIslands, setIslandAdapter } from './chunk-WFAWAHJH.js';
+export { createMiddlewareChain } from './chunk-OYF2OAKS.js';
+export { defineConfig } from './chunk-IXMD5QH2.js';
 export { BadRequestError, FlightError, ForbiddenError, InternalError, NotFoundError, UnauthorizedError, clearError, createError, createErrorResponse, forbidden as createForbidden, notFound as createNotFound, unauthorized as createUnauthorized, getError, getErrorStatusCode, isFlightError, isForbiddenError as isForbidden, isNotFoundError as isNotFound, isUnauthorizedError as isUnauthorized, showError, wrapWithDigest } from './chunk-FSJNOPYE.js';
 import './chunk-PL37KFRJ.js';
 export { getEnvironment, isBrowser, isDevelopment, isProduction, isServer, isTest } from './chunk-YHEVHRLH.js';
 export { createRouter } from './chunk-GCQZ4FHI.js';
 import './chunk-ZVC3ZWLM.js';
 export { cacheKey, cached, createCache, dedupe, jsonSerializer, memory } from './chunk-R7SQAREQ.js';
-export { createMiddlewareChain } from './chunk-OYF2OAKS.js';
 import { promises } from 'fs';
 import { dirname, join } from 'path';
 

package/dist/rsc/index.d.ts

@@ -7,21 +7,226 @@ export { FlightResponseOptions, FlightStreamError, FlightStreamOptions, FlightSt
 export { ComponentFn, ElementTypeInfo, FlightRenderer, RenderOptions, RenderResult, UIAdapter, createRenderer, renderServerComponent, renderServerComponentStreaming } from './renderer.js';
 export { ReactConsumerOptions, ReactServerComponent, createReactAdapter, createReactConsumer, markAsClientComponent } from './adapters/react.js';
 export { ClientManifestEntry, FlightRSCPluginOptions, ServerManifestEntry, default as flightRSC } from './vite-plugin.js';
-export { ComponentType, ClientComponent as LegacyClientComponent, ServerComponent as LegacyServerComponent, RenderContext, composeComponents, createAsyncComponent, createClientBoundary, createRenderContext, deserializeProps, executeServerComponent, isNotFoundError as legacyIsNotFoundError, isRedirectError as legacyIsRedirectError, notFound as legacyNotFound, redirect as legacyRedirect, revalidatePath, revalidateTag, serializeProps, serverFetch, withErrorBoundary } from './legacy.js';
+export { AsyncErrorBoundaryOptions, ComponentType, ClientComponent as LegacyClientComponent, ServerComponent as LegacyServerComponent, RenderContext, composeComponents, createAsyncComponent, createClientBoundary, createRenderContext, deserializeProps, executeServerComponent, isNotFoundError as legacyIsNotFoundError, isRedirectError as legacyIsRedirectError, notFound as legacyNotFound, redirect as legacyRedirect, revalidatePath, revalidateTag, serializeProps, serverFetch, withAsyncErrorBoundary, withErrorBoundary } from './legacy.js';
 import 'react';
 import 'vite';
 
+/**
+ * @flight-framework/core - RSC Type Helpers
+ *
+ * Type utilities for async server components, loaders, and actions.
+ * These types provide better TypeScript inference and developer experience.
+ *
+ * @module @flight-framework/core/rsc/types
+ */
+
+/**
+ * Type for async server components with data fetching.
+ *
+ * @example
+ * ```typescript
+ * const UserPage: AsyncServerComponent<{ id: string }> = async ({ id }, ctx) => {
+ *     const user = await db.users.get(id);
+ *     return h('div', null, text(user.name));
+ * };
+ * ```
+ */
+type AsyncServerComponent<Props = Record<string, unknown>, Result = FlightElement> = (props: Props, ctx: ServerContext) => Promise<Result>;
+/**
+ * Type for sync server components.
+ */
+type SyncServerComponent<Props = Record<string, unknown>, Result = FlightElement> = (props: Props, ctx: ServerContext) => Result;
+/**
+ * Union type for any server component (sync or async).
+ */
+type ServerComponent<Props = Record<string, unknown>, Result = FlightElement> = AsyncServerComponent<Props, Result> | SyncServerComponent<Props, Result>;
+/**
+ * Context provided to loader functions.
+ */
+interface LoaderContext {
+    /** Route parameters extracted from the URL path */
+    params: Record<string, string>;
+    /** The incoming request object */
+    request: Request;
+    /** URL search parameters */
+    searchParams: URLSearchParams;
+}
+/**
+ * Type for loader functions.
+ *
+ * @example
+ * ```typescript
+ * export const loader: LoaderFn = async ({ params }) => {
+ *     const user = await db.users.get(params.id);
+ *     return { user };
+ * };
+ * ```
+ */
+type LoaderFn<T = unknown> = (context: LoaderContext) => Promise<T> | T;
+/**
+ * Infer the return type of a loader function.
+ *
+ * @example
+ * ```typescript
+ * export async function loader() {
+ *     return { count: 42, items: ['a', 'b'] };
+ * }
+ *
+ * // Type is { count: number; items: string[] }
+ * type Data = InferLoaderData<typeof loader>;
+ * ```
+ */
+type InferLoaderData<T extends (...args: never[]) => unknown> = Awaited<ReturnType<T>>;
+/**
+ * Context provided to action functions.
+ */
+interface ActionContext {
+    /** The incoming request object */
+    request: Request;
+    /** Route parameters extracted from the URL path */
+    params: Record<string, string>;
+}
+/**
+ * Type for action functions.
+ *
+ * @example
+ * ```typescript
+ * export const action: ActionFn = async ({ request }) => {
+ *     const formData = await request.formData();
+ *     await db.items.create({ name: formData.get('name') });
+ *     return { success: true };
+ * };
+ * ```
+ */
+type ActionFn<T = unknown> = (context: ActionContext) => Promise<T> | T;
+/**
+ * Infer the return type of an action function.
+ *
+ * @example
+ * ```typescript
+ * export async function action() {
+ *     return { success: true, id: '123' };
+ * }
+ *
+ * // Type is { success: boolean; id: string }
+ * type Result = InferActionReturn<typeof action>;
+ * ```
+ */
+type InferActionReturn<T extends (...args: never[]) => unknown> = Awaited<ReturnType<T>>;
+/**
+ * Extract props type from a component function.
+ *
+ * @example
+ * ```typescript
+ * async function UserCard(props: { name: string; age: number }) {
+ *     return <div>{props.name}</div>;
+ * }
+ *
+ * // Type is { name: string; age: number }
+ * type Props = ComponentProps<typeof UserCard>;
+ * ```
+ */
+type ComponentProps<T> = T extends (props: infer P, ...args: unknown[]) => unknown ? P : never;
+/**
+ * Extract the return type of a component (after awaiting if async).
+ */
+type ComponentReturn<T> = T extends (...args: unknown[]) => infer R ? Awaited<R> : never;
+/**
+ * Props for page components with route parameters.
+ */
+interface PageProps<Params extends Record<string, string> = Record<string, string>> {
+    /** Route parameters from dynamic segments */
+    params: Params;
+    /** URL search parameters */
+    searchParams?: Record<string, string | string[]>;
+}
+/**
+ * Type for page components.
+ *
+ * @example
+ * ```typescript
+ * const PostPage: PageComponent<{ slug: string }> = async ({ params }) => {
+ *     const post = await getPost(params.slug);
+ *     return <article>{post.title}</article>;
+ * };
+ * ```
+ */
+type PageComponent<Params extends Record<string, string> = Record<string, string>> = AsyncServerComponent<PageProps<Params>>;
+/**
+ * Props for layout components.
+ */
+interface LayoutProps<Params extends Record<string, string> = Record<string, string>> {
+    /** Child components to render */
+    children: FlightElement;
+    /** Route parameters from dynamic segments */
+    params: Params;
+}
+/**
+ * Type for layout components.
+ */
+type LayoutComponent<Params extends Record<string, string> = Record<string, string>> = ServerComponent<LayoutProps<Params>>;
+/**
+ * Props for error boundary components.
+ */
+interface ErrorProps {
+    /** The error that was thrown */
+    error: Error;
+    /** Function to reset the error boundary */
+    reset: () => void;
+}
+/**
+ * Type for error components.
+ */
+type ErrorComponent = (props: ErrorProps) => FlightElement;
+/**
+ * Type for loading components (shown during Suspense).
+ */
+type LoadingComponent = () => FlightElement;
+/**
+ * Generate metadata for a page.
+ */
+type GenerateMetadata<Params extends Record<string, string> = Record<string, string>> = (props: PageProps<Params>) => Promise<Metadata> | Metadata;
+/**
+ * Page metadata type.
+ */
+interface Metadata {
+    title?: string | {
+        default: string;
+        template?: string;
+    };
+    description?: string;
+    keywords?: string[];
+    authors?: Array<{
+        name: string;
+        url?: string;
+    }>;
+    openGraph?: {
+        title?: string;
+        description?: string;
+        images?: string[];
+        url?: string;
+        type?: string;
+    };
+    twitter?: {
+        card?: 'summary' | 'summary_large_image' | 'player' | 'app';
+        title?: string;
+        description?: string;
+        images?: string[];
+    };
+    robots?: string | {
+        index?: boolean;
+        follow?: boolean;
+    };
+}
+
 /**
  * Server Component function type
+ * @deprecated Use AsyncServerComponent or ServerComponent from './types.js'
  */
 type ServerComponentFn<P = unknown, R = FlightElement> = (props: P, ctx: ServerContext) => R | Promise<R>;
 /**
  * Server Action function type
  */
 type ServerActionFn<Args extends unknown[] = unknown[], R = unknown> = (...args: Args) => Promise<R>;
-/**
- * Props for a component
- */
-type ComponentProps<T> = T extends (props: infer P, ...args: unknown[]) => unknown ? P : never;
 
-export { type ComponentProps, FlightElement, type ServerActionFn, type ServerComponentFn, ServerContext };
+export { type ActionContext, type ActionFn, type AsyncServerComponent, type ComponentProps, type ComponentReturn, type ErrorComponent, type ErrorProps, FlightElement, type GenerateMetadata, type InferActionReturn, type InferLoaderData, type LayoutComponent, type LayoutProps, type LoaderContext, type LoaderFn, type LoadingComponent, type Metadata, type PageComponent, type PageProps, type ServerActionFn, type ServerComponent, type ServerComponentFn, ServerContext, type SyncServerComponent };

package/dist/rsc/index.js

@@ -1,15 +1,15 @@
 import '../chunk-63SCEXD7.js';
+import '../chunk-Y22AMGTM.js';
+export { createReactAdapter, createReactConsumer, markAsClientComponent } from '../chunk-TASAT7KB.js';
+import '../chunk-2F2QU6RC.js';
+import '../chunk-VPFMHGEV.js';
+import '../chunk-MDQNNIHH.js';
 export { acceptsJson, createServerContext, deleteCookie, getHeader, getHeaders, getPreferredLanguage, getRedirectInfo, isAjaxRequest, isBotRequest, isMutationRequest, isNotFoundError, isRedirectError, notFound, redirect, setCacheControl, setCookie, supportsStreaming } from '../chunk-62C7LX2E.js';
 export { FlightStreamError, consumeFlightStream, createFlightResponse, createFlightStream, createFlightStreamFromArray, createHybridResponse, createStreamController, mergeFlightStreams, parseFlightStream, parseFlightStreamSync, prettyPrintChunks, transformFlightStream } from '../chunk-PVUMB632.js';
 export { FlightRenderer, createRenderer, renderServerComponent, renderServerComponentStreaming } from '../chunk-P6WSBVDT.js';
 export { FlightPayloadError, FlightSerializationError, clientRef, createActionChunk, createClientChunk, createErrorChunk, createHintChunk, createServerChunk, deserialize, fragment, generateChunkId, h, isFlightElement, resetChunkIdCounter, serialize, suspense, text, toFlightElement } from '../chunk-K2CQZPCG.js';
-export { composeComponents, createAsyncComponent, createClientBoundary, createRenderContext, deserializeProps, executeServerComponent, isNotFoundError as legacyIsNotFoundError, isRedirectError as legacyIsRedirectError, notFound as legacyNotFound, redirect as legacyRedirect, revalidatePath, revalidateTag, serializeProps, serverFetch, withErrorBoundary } from '../chunk-3ZSSRE6M.js';
+export { composeComponents, createAsyncComponent, createClientBoundary, createRenderContext, deserializeProps, executeServerComponent, isNotFoundError as legacyIsNotFoundError, isRedirectError as legacyIsRedirectError, notFound as legacyNotFound, redirect as legacyRedirect, revalidatePath, revalidateTag, serializeProps, serverFetch, withAsyncErrorBoundary, withErrorBoundary } from '../chunk-LNV47HGV.js';
 export { flightRSC } from '../chunk-ZIE56LCA.js';
 export { BoundaryRegistry, CLIENT_REFERENCE, SERVER_REFERENCE, analyzeModule, createClientReference, createServerReference, detectAsyncComponents, detectBoundaryType, detectInlineServerActions, getReferenceId, globalRegistry, hasUseClientDirective, hasUseServerDirective, isClientReference, isServerReference, registerClientComponent, registerServerAction } from '../chunk-PDW5WCMW.js';
-import '../chunk-Y22AMGTM.js';
-export { createReactAdapter, createReactConsumer, markAsClientComponent } from '../chunk-TASAT7KB.js';
-import '../chunk-2F2QU6RC.js';
-import '../chunk-VPFMHGEV.js';
-import '../chunk-MDQNNIHH.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/rsc/legacy.d.ts

@@ -99,9 +99,33 @@ declare function createAsyncComponent<P, T>(fetcher: (props: P, context: RenderC
  * @deprecated Use Promise.all with async components
  */
 declare function composeComponents(...components: Array<() => Promise<string> | string>): () => Promise<string>;
+/**
+ * Options for async error boundary
+ */
+interface AsyncErrorBoundaryOptions<P, R> {
+    /** Fallback to render on error */
+    fallback: (error: Error, props: P) => R;
+    /** Optional callback when error occurs */
+    onError?: (error: Error, props: P, context: RenderContext) => void;
+    /** Whether to rethrow certain errors (e.g., redirects, not found) */
+    rethrowNavigation?: boolean;
+}
+/**
+ * Wrap an async server component with comprehensive error handling.
+ *
+ * @example
+ * ```typescript
+ * const SafeUserPage = withAsyncErrorBoundary(UserPage, {
+ *     fallback: (error, props) => `<div>Error loading user ${props.id}</div>`,
+ *     onError: (error, props) => console.error(`Failed to load user ${props.id}:`, error),
+ *     rethrowNavigation: true,
+ * });
+ * ```
+ */
+declare function withAsyncErrorBoundary<P, R = string>(component: (props: P, context: RenderContext) => Promise<R> | R, options: AsyncErrorBoundaryOptions<P, R>): (props: P, context: RenderContext) => Promise<R>;
 /**
  * Wrap a server component with error handling
- * @deprecated Use try/catch in async components
+ * @deprecated Use withAsyncErrorBoundary instead
  */
 declare function withErrorBoundary<P>(component: ServerComponent<P>, errorFallback: (error: Error) => string): ServerComponent<P>;
 /**
@@ -128,4 +152,4 @@ declare function isRedirectError(error: unknown): {
     type: string;
 } | null;
 
-export { type ClientComponent, type ComponentType, type RenderContext, type ServerComponent, composeComponents, createAsyncComponent, createClientBoundary, createRenderContext, deserializeProps, executeServerComponent, isNotFoundError, isRedirectError, notFound, redirect, revalidatePath, revalidateTag, serializeProps, serverFetch, withErrorBoundary };
+export { type AsyncErrorBoundaryOptions, type ClientComponent, type ComponentType, type RenderContext, type ServerComponent, composeComponents, createAsyncComponent, createClientBoundary, createRenderContext, deserializeProps, executeServerComponent, isNotFoundError, isRedirectError, notFound, redirect, revalidatePath, revalidateTag, serializeProps, serverFetch, withAsyncErrorBoundary, withErrorBoundary };

package/dist/rsc/legacy.js

@@ -1,3 +1,3 @@
-export { composeComponents, createAsyncComponent, createClientBoundary, createRenderContext, deserializeProps, executeServerComponent, isNotFoundError, isRedirectError, notFound, redirect, revalidatePath, revalidateTag, serializeProps, serverFetch, withErrorBoundary } from '../chunk-3ZSSRE6M.js';
+export { composeComponents, createAsyncComponent, createClientBoundary, createRenderContext, deserializeProps, executeServerComponent, isNotFoundError, isRedirectError, notFound, redirect, revalidatePath, revalidateTag, serializeProps, serverFetch, withAsyncErrorBoundary, withErrorBoundary } from '../chunk-LNV47HGV.js';
 //# sourceMappingURL=legacy.js.map
 //# sourceMappingURL=legacy.js.map

package/dist/server/index.js

@@ -1,6 +1,6 @@
-export { createServer, getRuntime, isFlightServer } from '../chunk-ROJFQCGV.js';
+export { createServer, getRuntime, isFlightServer } from '../chunk-EGB7C73X.js';
+import '../chunk-OYF2OAKS.js';
 import '../chunk-IXMD5QH2.js';
 import '../chunk-GCQZ4FHI.js';
-import '../chunk-OYF2OAKS.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map