@flight-framework/core 0.0.3 → 0.2.0

package/package.json

@@ -1,101 +1,181 @@
-{
-    "name": "@flight-framework/core",
-    "version": "0.0.3",
-    "description": "Core primitives for Flight Framework - routing, rendering, caching",
-    "keywords": [
-        "flight",
-        "framework",
-        "core",
-        "ssr",
-        "routing"
-    ],
-    "license": "MIT",
-    "author": "Flight Contributors",
-    "type": "module",
-    "exports": {
-        ".": {
-            "types": "./dist/index.d.ts",
-            "import": "./dist/index.js"
-        },
-        "./router": {
-            "types": "./dist/router/index.d.ts",
-            "import": "./dist/router/index.js"
-        },
-        "./render": {
-            "types": "./dist/render/index.d.ts",
-            "import": "./dist/render/index.js"
-        },
-        "./cache": {
-            "types": "./dist/cache/index.d.ts",
-            "import": "./dist/cache/index.js"
-        },
-        "./middleware": {
-            "types": "./dist/middleware/index.d.ts",
-            "import": "./dist/middleware/index.js"
-        },
-        "./config": {
-            "types": "./dist/config/index.d.ts",
-            "import": "./dist/config/index.js"
-        },
-        "./adapters": {
-            "types": "./dist/adapters/index.d.ts",
-            "import": "./dist/adapters/index.js"
-        },
-        "./server": {
-            "types": "./dist/server/index.d.ts",
-            "import": "./dist/server/index.js"
-        },
-        "./file-router": {
-            "types": "./dist/file-router/index.d.ts",
-            "import": "./dist/file-router/index.js"
-        },
-        "./actions": {
-            "types": "./dist/actions/index.d.ts",
-            "import": "./dist/actions/index.js"
-        },
-        "./handlers": {
-            "types": "./dist/handlers/index.d.ts",
-            "import": "./dist/handlers/index.js"
-        },
-        "./streaming": {
-            "types": "./dist/streaming/index.d.ts",
-            "import": "./dist/streaming/index.js"
-        },
-        "./rsc": {
-            "types": "./dist/rsc/index.d.ts",
-            "import": "./dist/rsc/index.js"
-        }
-    },
-    "main": "./dist/index.js",
-    "types": "./dist/index.d.ts",
-    "files": [
-        "dist"
-    ],
-    "scripts": {
-        "build": "tsup",
-        "dev": "tsup --watch",
-        "test": "vitest run",
-        "test:watch": "vitest",
-        "lint": "eslint src/",
-        "clean": "rimraf dist",
-        "typecheck": "tsc --noEmit"
-    },
-    "dependencies": {
-        "radix3": "^1.1.0"
-    },
-    "devDependencies": {
-        "@types/node": "^22.0.0",
-        "rimraf": "^6.0.0",
-        "tsup": "^8.0.0",
-        "typescript": "^5.7.0",
-        "vitest": "^2.0.0"
-    },
-    "peerDependencies": {
-        "vite": "^6.0.0 || ^7.0.0"
-    },
-    "peerDependenciesMeta": {
-        "vite": {
-            "optional": true
-        }
-    }
+{
+  "name": "@flight-framework/core",
+  "version": "0.2.0",
+  "description": "Core primitives for Flight Framework - routing, rendering, caching",
+  "keywords": [
+    "flight",
+    "framework",
+    "core",
+    "ssr",
+    "routing"
+  ],
+  "license": "MIT",
+  "author": "Flight Contributors",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./router": {
+      "types": "./dist/router/index.d.ts",
+      "import": "./dist/router/index.js"
+    },
+    "./render": {
+      "types": "./dist/render/index.d.ts",
+      "import": "./dist/render/index.js"
+    },
+    "./cache": {
+      "types": "./dist/cache/index.d.ts",
+      "import": "./dist/cache/index.js"
+    },
+    "./middleware": {
+      "types": "./dist/middleware/index.d.ts",
+      "import": "./dist/middleware/index.js"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.ts",
+      "import": "./dist/config/index.js"
+    },
+    "./adapters": {
+      "types": "./dist/adapters/index.d.ts",
+      "import": "./dist/adapters/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js"
+    },
+    "./file-router": {
+      "types": "./dist/file-router/index.d.ts",
+      "import": "./dist/file-router/index.js"
+    },
+    "./actions": {
+      "types": "./dist/actions/index.d.ts",
+      "import": "./dist/actions/index.js"
+    },
+    "./handlers": {
+      "types": "./dist/handlers/index.d.ts",
+      "import": "./dist/handlers/index.js"
+    },
+    "./streaming": {
+      "types": "./dist/streaming/index.d.ts",
+      "import": "./dist/streaming/index.js"
+    },
+    "./streaming/priority": {
+      "types": "./dist/streaming/priority.d.ts",
+      "import": "./dist/streaming/priority.js"
+    },
+    "./streaming/observability": {
+      "types": "./dist/streaming/observability.d.ts",
+      "import": "./dist/streaming/observability.js"
+    },
+    "./streaming/conditional": {
+      "types": "./dist/streaming/conditional.d.ts",
+      "import": "./dist/streaming/conditional.js"
+    },
+    "./streaming/adapters": {
+      "types": "./dist/streaming/adapters/index.d.ts",
+      "import": "./dist/streaming/adapters/index.js"
+    },
+    "./islands": {
+      "types": "./dist/islands/index.d.ts",
+      "import": "./dist/islands/index.js"
+    },
+    "./file-router/streaming-hints": {
+      "types": "./dist/file-router/streaming-hints.d.ts",
+      "import": "./dist/file-router/streaming-hints.js"
+    },
+    "./rsc": {
+      "types": "./dist/rsc/index.d.ts",
+      "import": "./dist/rsc/index.js"
+    },
+    "./rsc/payload": {
+      "types": "./dist/rsc/payload.d.ts",
+      "import": "./dist/rsc/payload.js"
+    },
+    "./rsc/boundaries": {
+      "types": "./dist/rsc/boundaries.d.ts",
+      "import": "./dist/rsc/boundaries.js"
+    },
+    "./rsc/context": {
+      "types": "./dist/rsc/context.d.ts",
+      "import": "./dist/rsc/context.js"
+    },
+    "./rsc/stream": {
+      "types": "./dist/rsc/stream.d.ts",
+      "import": "./dist/rsc/stream.js"
+    },
+    "./rsc/renderer": {
+      "types": "./dist/rsc/renderer.d.ts",
+      "import": "./dist/rsc/renderer.js"
+    },
+    "./rsc/vite-plugin": {
+      "types": "./dist/rsc/vite-plugin.d.ts",
+      "import": "./dist/rsc/vite-plugin.js"
+    },
+    "./rsc/adapters": {
+      "types": "./dist/rsc/adapters/index.d.ts",
+      "import": "./dist/rsc/adapters/index.js"
+    },
+    "./rsc/adapters/react": {
+      "types": "./dist/rsc/adapters/react.d.ts",
+      "import": "./dist/rsc/adapters/react.js"
+    },
+    "./rsc/adapters/vue": {
+      "types": "./dist/rsc/adapters/vue.d.ts",
+      "import": "./dist/rsc/adapters/vue.js"
+    },
+    "./rsc/adapters/solid": {
+      "types": "./dist/rsc/adapters/solid.d.ts",
+      "import": "./dist/rsc/adapters/solid.js"
+    },
+    "./rsc/adapters/preact": {
+      "types": "./dist/rsc/adapters/preact.d.ts",
+      "import": "./dist/rsc/adapters/preact.js"
+    },
+    "./rsc/plugins": {
+      "types": "./dist/rsc/plugins/index.d.ts",
+      "import": "./dist/rsc/plugins/index.js"
+    },
+    "./rsc/plugins/esbuild": {
+      "types": "./dist/rsc/plugins/esbuild.d.ts",
+      "import": "./dist/rsc/plugins/esbuild.js"
+    },
+    "./rsc/plugins/rollup": {
+      "types": "./dist/rsc/plugins/rollup.d.ts",
+      "import": "./dist/rsc/plugins/rollup.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "radix3": "^1.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "rimraf": "^6.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.0.0"
+  },
+  "peerDependencies": {
+    "vite": "^6.0.0 || ^7.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/",
+    "clean": "rimraf dist",
+    "typecheck": "tsc --noEmit"
+  }
 }

package/dist/chunk-5KF3QQWZ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/rsc/index.ts"],"names":[],"mappings":"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","file":"chunk-5KF3QQWZ.js","sourcesContent":["/**\r\n * @flight-framework/core - React Server Components Support\r\n * \r\n * Framework-agnostic primitives for RSC-like patterns.\r\n * Enables async server components, client/server boundaries, and data fetching.\r\n * \r\n * Best Practices 2025/2026:\r\n * - Async components for server-side data fetching\r\n * - 'use client' / 'use server' directive detection\r\n * - Automatic component serialization\r\n * - Props passing between server and client\r\n */\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Component rendering context\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 */\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 */\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// Directive Detection (Build-time)\r\n// ============================================================================\r\n\r\n/**\r\n * Check if a file has 'use client' directive\r\n */\r\nexport function hasUseClientDirective(source: string): boolean {\r\n    const firstLine = source.trim().split('\\n')[0] ?? '';\r\n    return /^['\"]use client['\"];?/.test(firstLine);\r\n}\r\n\r\n/**\r\n * Check if a file has 'use server' directive\r\n */\r\nexport function hasUseServerDirective(source: string): boolean {\r\n    const firstLine = source.trim().split('\\n')[0] ?? '';\r\n    return /^['\"]use server['\"];?/.test(firstLine);\r\n}\r\n\r\n/**\r\n * Detect component type from source\r\n */\r\nexport function detectComponentType(source: string): ComponentType {\r\n    if (hasUseClientDirective(source)) return 'client';\r\n    if (hasUseServerDirective(source)) return 'server';\r\n    return 'hybrid';\r\n}\r\n\r\n// ============================================================================\r\n// Server Component Execution\r\n// ============================================================================\r\n\r\n/**\r\n * Execute an async server component\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 */\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 (like Next.js fetch extensions)\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, tags = [], ...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    // In a real implementation, this would invalidate cache entries by tag\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    // In a real implementation, this would invalidate cache entries by path\r\n    console.log(`[Flight] Revalidating path: ${path}`);\r\n}\r\n\r\n// ============================================================================\r\n// Component Serialization (for client boundary crossing)\r\n// ============================================================================\r\n\r\n/**\r\n * Serialize props for transmission to client\r\n */\r\nexport function serializeProps(props: unknown): string {\r\n    // Pre-process to handle special types before JSON.stringify\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 */\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 */\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        // Hydrate with the framework's hydration method\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 */\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 */\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 * Wrap a server component with error handling\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 (like Next.js notFound())\r\n */\r\nexport function notFound(): never {\r\n    const error = new Error('Not Found');\r\n    (error as any).__flight_not_found = true;\r\n    throw error;\r\n}\r\n\r\n/**\r\n * Check if error is not found\r\n */\r\nexport function isNotFoundError(error: unknown): boolean {\r\n    return error instanceof Error && (error as any).__flight_not_found === true;\r\n}\r\n\r\n/**\r\n * Server-side redirect (like Next.js redirect())\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 any).__flight_redirect = { url, type };\r\n    throw error;\r\n}\r\n\r\n/**\r\n * Check if error is redirect\r\n */\r\nexport function isRedirectError(error: unknown): { url: string; type: string } | null {\r\n    if (error instanceof Error && (error as any).__flight_redirect) {\r\n        return (error as any).__flight_redirect;\r\n    }\r\n    return null;\r\n}\r\n"]}

package/dist/chunk-ABNCAPQB.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/streaming/index.ts"],"names":[],"mappings":"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","file":"chunk-ABNCAPQB.js","sourcesContent":["/**\r\n * @flight-framework/core - Streaming SSR\r\n * \r\n * Full streaming server-side rendering implementation following React 18+/19 patterns.\r\n * Supports both Node.js (renderToPipeableStream) and Edge (renderToReadableStream) environments.\r\n * \r\n * Best Practices 2025/2026:\r\n * - Progressive HTML streaming with Suspense boundaries\r\n * - Shell-first rendering for fast TTFB\r\n * - Nested Suspense for granular loading states\r\n * - Error boundaries for graceful degradation\r\n * - Web Streams API for Edge runtime compatibility\r\n */\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Streaming render options following React's conventions\r\n */\r\nexport interface StreamingRenderOptions {\r\n    /** Bootstrap scripts to load on client */\r\n    bootstrapScripts?: string[];\r\n    /** Bootstrap ES modules */\r\n    bootstrapModules?: string[];\r\n    /** Inline script content */\r\n    bootstrapScriptContent?: string;\r\n    /** Prefix for React IDs (useId) */\r\n    identifierPrefix?: string;\r\n    /** Nonce for CSP */\r\n    nonce?: string;\r\n    /** Callback when shell is ready (main content before Suspense) */\r\n    onShellReady?: () => void;\r\n    /** Callback when shell errors */\r\n    onShellError?: (error: Error) => void;\r\n    /** Callback when all content is ready */\r\n    onAllReady?: () => void;\r\n    /** Callback for any error */\r\n    onError?: (error: Error) => void;\r\n    /** Timeout before aborting stream */\r\n    timeoutMs?: number;\r\n    /** Progressive hydration enabled */\r\n    progressiveHydration?: boolean;\r\n}\r\n\r\n/**\r\n * Streaming render result\r\n */\r\nexport interface StreamingRenderResult {\r\n    /** The readable stream to pipe to response */\r\n    stream: ReadableStream<Uint8Array>;\r\n    /** Abort the stream */\r\n    abort: () => void;\r\n    /** Promise that resolves when shell is ready */\r\n    shellReady: Promise<void>;\r\n    /** Promise that resolves when all content is ready */\r\n    allReady: Promise<void>;\r\n}\r\n\r\n/**\r\n * Suspense boundary configuration\r\n */\r\nexport interface SuspenseBoundaryConfig {\r\n    /** Unique ID for this boundary */\r\n    id: string;\r\n    /** Fallback HTML to show while loading */\r\n    fallback: string;\r\n    /** Content resolver promise */\r\n    contentPromise: Promise<string>;\r\n}\r\n\r\n// ============================================================================\r\n// Streaming Renderer\r\n// ============================================================================\r\n\r\n/**\r\n * Create a streaming SSR response using Web Streams API.\r\n * Compatible with Edge Runtime (Cloudflare, Vercel Edge, Deno).\r\n * \r\n * @example\r\n * ```typescript\r\n * const result = await createStreamingSSR({\r\n *   shell: '<html><body><div id=\"root\">',\r\n *   shellEnd: '</div></body></html>',\r\n *   suspenseBoundaries: [\r\n *     {\r\n *       id: 'posts',\r\n *       fallback: '<div>Loading posts...</div>',\r\n *       contentPromise: fetchAndRenderPosts(),\r\n *     }\r\n *   ],\r\n *   bootstrapScripts: ['/client.js'],\r\n * });\r\n * \r\n * return new Response(result.stream, {\r\n *   headers: { 'Content-Type': 'text/html' },\r\n * });\r\n * ```\r\n */\r\nexport async function createStreamingSSR(config: {\r\n    /** Initial HTML shell (before suspense content) */\r\n    shell: string;\r\n    /** Closing HTML shell */\r\n    shellEnd: string;\r\n    /** Suspense boundaries with async content */\r\n    suspenseBoundaries?: SuspenseBoundaryConfig[];\r\n    /** Streaming options */\r\n    options?: StreamingRenderOptions;\r\n}): Promise<StreamingRenderResult> {\r\n    const { shell, shellEnd, suspenseBoundaries = [], options = {} } = config;\r\n\r\n    let shellResolved = false;\r\n    let allResolved = false;\r\n    let _aborted = false;\r\n    let abortController: AbortController | null = null;\r\n\r\n    // Shell ready promise\r\n    let resolveShell: () => void;\r\n    const shellReady = new Promise<void>((resolve) => {\r\n        resolveShell = resolve;\r\n    });\r\n\r\n    // All ready promise\r\n    let resolveAll: () => void;\r\n    const allReady = new Promise<void>((resolve) => {\r\n        resolveAll = resolve;\r\n    });\r\n\r\n    const encoder = new TextEncoder();\r\n\r\n    const stream = new ReadableStream<Uint8Array>({\r\n        async start(controller) {\r\n            try {\r\n                // 1. Send the shell immediately (fast TTFB)\r\n                const shellWithPlaceholders = buildShellWithPlaceholders(\r\n                    shell,\r\n                    suspenseBoundaries,\r\n                    shellEnd,\r\n                    options\r\n                );\r\n\r\n                controller.enqueue(encoder.encode(shellWithPlaceholders));\r\n\r\n                shellResolved = true;\r\n                options.onShellReady?.();\r\n                resolveShell!();\r\n\r\n                // 2. Stream Suspense boundary contents as they resolve\r\n                if (suspenseBoundaries.length > 0) {\r\n                    await streamSuspenseContent(controller, encoder, suspenseBoundaries, options);\r\n                }\r\n\r\n                // 3. Send hydration script if needed\r\n                if (options.bootstrapScripts?.length || options.bootstrapModules?.length) {\r\n                    const hydrationScript = buildHydrationScript(options);\r\n                    controller.enqueue(encoder.encode(hydrationScript));\r\n                }\r\n\r\n                allResolved = true;\r\n                options.onAllReady?.();\r\n                resolveAll!();\r\n\r\n                controller.close();\r\n            } catch (error) {\r\n                if (!shellResolved) {\r\n                    options.onShellError?.(error as Error);\r\n                }\r\n                options.onError?.(error as Error);\r\n                controller.error(error);\r\n            }\r\n        },\r\n\r\n        cancel() {\r\n            _aborted = true;\r\n            abortController?.abort();\r\n        },\r\n    });\r\n\r\n    // Abort function\r\n    const abort = () => {\r\n        _aborted = true;\r\n        abortController?.abort();\r\n    };\r\n\r\n    // Timeout handling\r\n    if (options.timeoutMs) {\r\n        abortController = new AbortController();\r\n        setTimeout(() => {\r\n            if (!allResolved) {\r\n                abort();\r\n            }\r\n        }, options.timeoutMs);\r\n    }\r\n\r\n    return {\r\n        stream,\r\n        abort,\r\n        shellReady,\r\n        allReady,\r\n    };\r\n}\r\n\r\n/**\r\n * Build shell HTML with Suspense placeholders\r\n */\r\nfunction buildShellWithPlaceholders(\r\n    shell: string,\r\n    boundaries: SuspenseBoundaryConfig[],\r\n    shellEnd: string,\r\n    options: StreamingRenderOptions\r\n): string {\r\n    let html = shell;\r\n\r\n    // Add inline bootstrap script if provided\r\n    if (options.bootstrapScriptContent) {\r\n        html += `<script>${options.bootstrapScriptContent}</script>`;\r\n    }\r\n\r\n    // Add Suspense fallbacks with placeholder markers\r\n    for (const boundary of boundaries) {\r\n        html += `\r\n<!--$?--><template id=\"B:${boundary.id}\"></template>\r\n${boundary.fallback}\r\n<!--/$-->`;\r\n    }\r\n\r\n    html += shellEnd;\r\n\r\n    return html;\r\n}\r\n\r\n/**\r\n * Stream Suspense content as promises resolve\r\n */\r\nasync function streamSuspenseContent(\r\n    controller: ReadableStreamDefaultController<Uint8Array>,\r\n    encoder: TextEncoder,\r\n    boundaries: SuspenseBoundaryConfig[],\r\n    options: StreamingRenderOptions\r\n): Promise<void> {\r\n    // Race all boundaries - stream each as it completes\r\n    const pending = boundaries.map(async (boundary) => {\r\n        try {\r\n            const content = await boundary.contentPromise;\r\n            return { boundary, content, error: null };\r\n        } catch (error) {\r\n            return { boundary, content: null, error: error as Error };\r\n        }\r\n    });\r\n\r\n    // Process as each resolves\r\n    const results = await Promise.allSettled(pending);\r\n\r\n    for (const result of results) {\r\n        if (result.status === 'fulfilled') {\r\n            const { boundary, content, error } = result.value;\r\n\r\n            if (error) {\r\n                // Send error replacement\r\n                const errorScript = buildErrorReplacement(boundary.id, error.message);\r\n                controller.enqueue(encoder.encode(errorScript));\r\n                options.onError?.(error);\r\n            } else if (content) {\r\n                // Send content replacement script\r\n                const replacementScript = buildContentReplacement(boundary.id, content);\r\n                controller.enqueue(encoder.encode(replacementScript));\r\n            }\r\n        }\r\n    }\r\n}\r\n\r\n/**\r\n * Build script to replace Suspense placeholder with actual content\r\n * This follows React's streaming hydration pattern\r\n */\r\nfunction buildContentReplacement(id: string, content: string): string {\r\n    // Escape script-breaking characters\r\n    const escaped = content\r\n        .replace(/\\\\/g, '\\\\\\\\')\r\n        .replace(/</g, '\\\\u003c')\r\n        .replace(/>/g, '\\\\u003e')\r\n        .replace(/'/g, \"\\\\'\")\r\n        .replace(/\"/g, '\\\\\"')\r\n        .replace(/\\n/g, '\\\\n')\r\n        .replace(/\\r/g, '\\\\r');\r\n\r\n    return `\r\n<script>\r\n(function(){\r\n  var b=document.getElementById(\"B:${id}\");\r\n  if(b){\r\n    var p=b.previousSibling;\r\n    while(p&&p.nodeType===8&&p.data===\"$?\")p=p.previousSibling;\r\n    var n=b.nextSibling;\r\n    var f=document.createDocumentFragment();\r\n    var t=document.createElement(\"template\");\r\n    t.innerHTML=\"${escaped}\";\r\n    while(t.content.firstChild)f.appendChild(t.content.firstChild);\r\n    if(n&&n.nodeType===8&&n.data===\"/$\"){\r\n      var s=n.nextSibling;\r\n      while(s&&s!==b){var x=s.nextSibling;s.parentNode.removeChild(s);s=x;}\r\n    }\r\n    b.parentNode.replaceChild(f,b);\r\n  }\r\n})();\r\n</script>`;\r\n}\r\n\r\n/**\r\n * Build script to show error in place of Suspense content\r\n */\r\nfunction buildErrorReplacement(id: string, message: string): string {\r\n    const escaped = message.replace(/'/g, \"\\\\'\").replace(/\"/g, '\\\\\"');\r\n\r\n    return `\r\n<script>\r\n(function(){\r\n  var b=document.getElementById(\"B:${id}\");\r\n  if(b){\r\n    var t=document.createElement(\"div\");\r\n    t.className=\"streaming-error\";\r\n    t.textContent=\"Error: ${escaped}\";\r\n    b.parentNode.replaceChild(t,b);\r\n  }\r\n})();\r\n</script>`;\r\n}\r\n\r\n/**\r\n * Build hydration bootstrap script\r\n */\r\nfunction buildHydrationScript(options: StreamingRenderOptions): string {\r\n    let scripts = '';\r\n\r\n    if (options.bootstrapScripts?.length) {\r\n        for (const src of options.bootstrapScripts) {\r\n            const nonceAttr = options.nonce ? ` nonce=\"${options.nonce}\"` : '';\r\n            scripts += `<script src=\"${src}\"${nonceAttr} async></script>`;\r\n        }\r\n    }\r\n\r\n    if (options.bootstrapModules?.length) {\r\n        for (const src of options.bootstrapModules) {\r\n            const nonceAttr = options.nonce ? ` nonce=\"${options.nonce}\"` : '';\r\n            scripts += `<script type=\"module\" src=\"${src}\"${nonceAttr}></script>`;\r\n        }\r\n    }\r\n\r\n    return scripts;\r\n}\r\n\r\n// ============================================================================\r\n// Streaming Response Helpers\r\n// ============================================================================\r\n\r\n/**\r\n * Create a streaming HTML Response object\r\n */\r\nexport function createStreamingResponse(\r\n    stream: ReadableStream<Uint8Array>,\r\n    options: {\r\n        status?: number;\r\n        headers?: Record<string, string>;\r\n    } = {}\r\n): Response {\r\n    return new Response(stream, {\r\n        status: options.status || 200,\r\n        headers: {\r\n            'Content-Type': 'text/html; charset=utf-8',\r\n            'Transfer-Encoding': 'chunked',\r\n            'X-Content-Type-Options': 'nosniff',\r\n            ...options.headers,\r\n        },\r\n    });\r\n}\r\n\r\n/**\r\n * Higher-level API: Render page with Suspense boundaries\r\n * \r\n * @example\r\n * ```typescript\r\n * return renderWithStreaming({\r\n *   layout: ({ children }) => `\r\n *     <html>\r\n *       <head><title>My App</title></head>\r\n *       <body><div id=\"root\">${children}</div></body>\r\n *     </html>\r\n *   `,\r\n *   page: async () => '<h1>Welcome</h1>',\r\n *   suspense: {\r\n *     posts: {\r\n *       fallback: '<div class=\"skeleton\">Loading...</div>',\r\n *       content: fetchPosts().then(renderPosts),\r\n *     },\r\n *   },\r\n * });\r\n * ```\r\n */\r\nexport async function renderWithStreaming(config: {\r\n    /** Layout wrapper */\r\n    layout: (props: { children: string }) => string;\r\n    /** Main page content (sync part) */\r\n    page: () => string | Promise<string>;\r\n    /** Suspense boundaries keyed by ID */\r\n    suspense?: Record<string, { fallback: string; content: Promise<string> }>;\r\n    /** Bootstrap scripts */\r\n    bootstrapScripts?: string[];\r\n    /** Timeout in ms */\r\n    timeoutMs?: number;\r\n}): Promise<Response> {\r\n    const { layout, page, suspense = {}, bootstrapScripts, timeoutMs } = config;\r\n\r\n    // Get synchronous page content\r\n    const pageContent = await page();\r\n\r\n    // Build suspense boundaries\r\n    const boundaries: SuspenseBoundaryConfig[] = Object.entries(suspense).map(\r\n        ([id, { fallback, content }]) => ({\r\n            id,\r\n            fallback,\r\n            contentPromise: content,\r\n        })\r\n    );\r\n\r\n    // Create streaming result\r\n    const result = await createStreamingSSR({\r\n        shell: layout({ children: pageContent }),\r\n        shellEnd: '',\r\n        suspenseBoundaries: boundaries,\r\n        options: {\r\n            bootstrapScripts,\r\n            timeoutMs,\r\n        },\r\n    });\r\n\r\n    return createStreamingResponse(result.stream);\r\n}\r\n\r\n// ============================================================================\r\n// Progressive Rendering Utilities\r\n// ============================================================================\r\n\r\n/**\r\n * Create a lazy component that streams its content\r\n */\r\nexport function createLazyContent<T>(\r\n    fetcher: () => Promise<T>,\r\n    renderer: (data: T) => string,\r\n    fallback: string\r\n): { fallback: string; content: Promise<string> } {\r\n    return {\r\n        fallback,\r\n        content: fetcher().then(renderer),\r\n    };\r\n}\r\n\r\n/**\r\n * Parallel streaming: resolve multiple boundaries simultaneously\r\n */\r\nexport async function streamParallel(\r\n    boundaries: Array<{\r\n        id: string;\r\n        fallback: string;\r\n        content: () => Promise<string>;\r\n    }>\r\n): Promise<SuspenseBoundaryConfig[]> {\r\n    return boundaries.map((b) => ({\r\n        id: b.id,\r\n        fallback: b.fallback,\r\n        contentPromise: b.content(),\r\n    }));\r\n}\r\n\r\n/**\r\n * Sequential streaming: resolve boundaries in order\r\n */\r\nexport async function streamSequential(\r\n    boundaries: Array<{\r\n        id: string;\r\n        fallback: string;\r\n        content: () => Promise<string>;\r\n    }>\r\n): Promise<SuspenseBoundaryConfig[]> {\r\n    const result: SuspenseBoundaryConfig[] = [];\r\n\r\n    for (const b of boundaries) {\r\n        result.push({\r\n            id: b.id,\r\n            fallback: b.fallback,\r\n            contentPromise: b.content(),\r\n        });\r\n    }\r\n\r\n    return result;\r\n}\r\n\r\n// ============================================================================\r\n// Export for use with React\r\n// ============================================================================\r\n\r\n/**\r\n * NOTE: For React-specific streaming with renderToPipeableStream or \r\n * renderToReadableStream, use the dedicated React adapter:\r\n * \r\n * ```typescript\r\n * import { renderToReadableStream } from 'react-dom/server';\r\n * import { createStreamingResponse } from '@flight-framework/core/streaming';\r\n * \r\n * const stream = await renderToReadableStream(<App />, {\r\n *   bootstrapScripts: ['/client.js'],\r\n * });\r\n * \r\n * return createStreamingResponse(stream);\r\n * ```\r\n * \r\n * This module provides framework-agnostic streaming primitives that work\r\n * with any UI library or custom HTML generation.\r\n */\r\n"]}

package/dist/chunk-CLMFEKYM.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/file-router/index.ts"],"names":[],"mappings":"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","file":"chunk-CLMFEKYM.js","sourcesContent":["/**\r\n * @flight-framework/core - File Router\r\n * \r\n * Auto-discovery of routes from file system.\r\n * Similar to Next.js App Router and Nuxt server/api patterns.\r\n */\r\n\r\nimport { readdir } from 'node:fs/promises';\r\nimport { join, basename, extname } from 'node:path';\r\nimport { pathToFileURL } from 'node:url';\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';\r\n\r\nexport type Handler = (context: unknown) => Response | Promise<Response>;\r\nexport type Middleware = (context: unknown, next: () => Promise<Response>) => Response | Promise<Response>;\r\n\r\nexport interface FileRoute {\r\n    /** HTTP method (GET, POST, etc) or 'ALL' */\r\n    method: HttpMethod | 'ALL';\r\n    /** Route path with params (e.g., /users/:id) */\r\n    path: string;\r\n    /** Original file path */\r\n    filePath: string;\r\n    /** Handler function (for APIs) */\r\n    handler?: Handler;\r\n    /** Route-specific middleware */\r\n    middleware?: Middleware[];\r\n    /** Route type: 'page' for SSR pages, 'api' for API endpoints */\r\n    type: 'page' | 'api';\r\n    /** Component function (for pages) */\r\n    component?: () => unknown;\r\n    /** Page metadata (title, description, etc) */\r\n    meta?: Record<string, unknown>;\r\n    /** Parallel route slot name (for @folder convention) */\r\n    slot?: string;\r\n}\r\n\r\nexport interface FileRouterOptions {\r\n    /** Root directory to scan (default: src/routes) */\r\n    directory: string;\r\n    /** File extensions to consider (default: ['.ts', '.js']) */\r\n    extensions?: string[];\r\n    /** Whether to watch for changes (default: false in prod) */\r\n    watch?: boolean;\r\n    /** \r\n     * Custom module loader for development with Vite.\r\n     * Pass vite.ssrLoadModule to load TSX files correctly.\r\n     * Falls back to native import() if not provided.\r\n     */\r\n    moduleLoader?: (filePath: string) => Promise<any>;\r\n}\r\n\r\nexport interface ScanResult {\r\n    routes: FileRoute[];\r\n    errors: string[];\r\n}\r\n\r\n// ============================================================================\r\n// File Scanner\r\n// ============================================================================\r\n\r\n/**\r\n * Scan a directory for route files\r\n */\r\nexport async function scanRoutes(options: FileRouterOptions): Promise<ScanResult> {\r\n    const {\r\n        directory,\r\n        extensions = ['.ts', '.js'],\r\n    } = options;\r\n\r\n    const routes: FileRoute[] = [];\r\n    const errors: string[] = [];\r\n\r\n    async function scanDir(dir: string, basePath: string = ''): Promise<void> {\r\n        try {\r\n            const entries = await readdir(dir, { withFileTypes: true });\r\n\r\n            for (const entry of entries) {\r\n                const fullPath = join(dir, entry.name);\r\n\r\n                if (entry.isDirectory()) {\r\n                    // Skip hidden directories and node_modules\r\n                    if (entry.name.startsWith('.') || entry.name === 'node_modules') {\r\n                        continue;\r\n                    }\r\n\r\n                    // Detect parallel route slots (@folder convention)\r\n                    if (entry.name.startsWith('@')) {\r\n                        const slotName = entry.name.slice(1);\r\n                        // Scan slot directory and mark routes with slot name\r\n                        const slotRoutes = await scanSlotDir(fullPath, basePath, slotName, extensions);\r\n                        routes.push(...slotRoutes);\r\n                        continue;\r\n                    }\r\n\r\n                    // Recurse into subdirectory\r\n                    await scanDir(fullPath, `${basePath}/${entry.name}`);\r\n                } else if (entry.isFile()) {\r\n                    const ext = extname(entry.name);\r\n\r\n                    if (!extensions.includes(ext)) {\r\n                        continue;\r\n                    }\r\n\r\n                    // Parse route from filename\r\n                    const routeInfo = parseRouteFile(entry.name, basePath);\r\n\r\n                    if (routeInfo && routeInfo.method && routeInfo.path) {\r\n                        routes.push({\r\n                            method: routeInfo.method,\r\n                            path: routeInfo.path,\r\n                            filePath: fullPath,\r\n                            type: routeInfo.type,\r\n                        });\r\n                    }\r\n                }\r\n            }\r\n        } catch (error) {\r\n            errors.push(`Failed to scan ${dir}: ${error}`);\r\n        }\r\n    }\r\n\r\n    await scanDir(directory);\r\n\r\n    return { routes, errors };\r\n}\r\n\r\n/**\r\n * Scan a parallel route slot directory\r\n */\r\nasync function scanSlotDir(\r\n    dir: string,\r\n    basePath: string,\r\n    slotName: string,\r\n    extensions: string[] = ['.ts', '.js', '.tsx', '.jsx']\r\n): Promise<FileRoute[]> {\r\n    const routes: FileRoute[] = [];\r\n\r\n    try {\r\n        const entries = await readdir(dir, { withFileTypes: true });\r\n\r\n        for (const entry of entries) {\r\n            const fullPath = join(dir, entry.name);\r\n\r\n            if (entry.isFile()) {\r\n                const ext = extname(entry.name);\r\n\r\n                if (!extensions.includes(ext)) {\r\n                    continue;\r\n                }\r\n\r\n                const routeInfo = parseRouteFile(entry.name, basePath);\r\n\r\n                if (routeInfo && routeInfo.method && routeInfo.path) {\r\n                    routes.push({\r\n                        method: routeInfo.method,\r\n                        path: routeInfo.path,\r\n                        filePath: fullPath,\r\n                        type: routeInfo.type,\r\n                        slot: slotName,\r\n                    });\r\n                }\r\n            }\r\n        }\r\n    } catch (error) {\r\n        console.error(`[Flight] Failed to scan slot @${slotName}:`, error);\r\n    }\r\n\r\n    return routes;\r\n}\r\n\r\n// ============================================================================\r\n// Route Parser\r\n// ============================================================================\r\n\r\ninterface ParsedRoute {\r\n    method: HttpMethod | 'ALL';\r\n    path: string;\r\n    type: 'page' | 'api';\r\n}\r\n\r\n/**\r\n * Parse route information from filename and path\r\n * \r\n * Patterns:\r\n * - index.ts → /\r\n * - users.ts → /users\r\n * - users.get.ts → GET /users (API)\r\n * - users.post.ts → POST /users (API)\r\n * - about.page.tsx → GET /about (Page)\r\n * - blog/[slug].page.tsx → GET /blog/:slug (Page)\r\n * - [id].ts → /:id\r\n * - [...slug].ts → /* (catch-all)\r\n * - [[...slug]].ts → /* (optional catch-all)\r\n */\r\nfunction parseRouteFile(filename: string, basePath: string): ParsedRoute | null {\r\n    const ext = extname(filename);\r\n    const nameWithoutExt = basename(filename, ext);\r\n\r\n    // Skip files starting with underscore (private)\r\n    if (nameWithoutExt.startsWith('_')) {\r\n        return null;\r\n    }\r\n\r\n    // Detect route type\r\n    let type: 'page' | 'api' = 'api';\r\n    let routeName = nameWithoutExt;\r\n    let method: HttpMethod | 'ALL' = 'ALL';\r\n\r\n    // Check for page suffix (e.g., about.page.tsx, index.page.tsx)\r\n    const pageMatch = nameWithoutExt.match(/^(.+)?\\.page$/i);\r\n    if (pageMatch) {\r\n        type = 'page';\r\n        method = 'GET'; // Pages are always GET\r\n        routeName = pageMatch[1] || 'index';\r\n    } else {\r\n        // Check for method suffix (e.g., users.get.ts)\r\n        const methodMatch = nameWithoutExt.match(/^(.+)\\.(get|post|put|delete|patch|head|options)$/i);\r\n        if (methodMatch) {\r\n            routeName = methodMatch[1] || nameWithoutExt;\r\n            method = (methodMatch[2] || 'ALL').toUpperCase() as HttpMethod;\r\n        }\r\n    }\r\n\r\n    // Also check if file is in /api/ directory\r\n    if (basePath.startsWith('/api') || basePath.includes('/api/')) {\r\n        type = 'api';\r\n    }\r\n\r\n    // Build route path\r\n    let path = basePath;\r\n\r\n    if (routeName !== 'index') {\r\n        path = `${basePath}/${convertToRoutePath(routeName)}`;\r\n    }\r\n\r\n    // Ensure path starts with /\r\n    if (!path.startsWith('/')) {\r\n        path = '/' + path;\r\n    }\r\n\r\n    // Remove trailing slash (except for root)\r\n    if (path !== '/' && path.endsWith('/')) {\r\n        path = path.slice(0, -1);\r\n    }\r\n\r\n    return { method, path, type };\r\n}\r\n\r\n/**\r\n * Convert filename segment to route path segment\r\n * \r\n * - [id] → :id\r\n * - [...slug] → *\r\n * - [[...slug]] → *?\r\n */\r\nfunction convertToRoutePath(name: string): string {\r\n    // Optional catch-all: [[...slug]]\r\n    if (name.startsWith('[[...') && name.endsWith(']]')) {\r\n        const paramName = name.slice(5, -2);\r\n        return `:${paramName}*`;\r\n    }\r\n\r\n    // Catch-all: [...slug]\r\n    if (name.startsWith('[...') && name.endsWith(']')) {\r\n        const paramName = name.slice(4, -1);\r\n        return `:${paramName}+`;\r\n    }\r\n\r\n    // Dynamic param: [id]\r\n    if (name.startsWith('[') && name.endsWith(']')) {\r\n        const paramName = name.slice(1, -1);\r\n        return `:${paramName}`;\r\n    }\r\n\r\n    return name;\r\n}\r\n\r\n// ============================================================================\r\n// Route Loader\r\n// ============================================================================\r\n\r\n/**\r\n * Load routes with their handlers or components\r\n * @param scanResult - Result from scanRoutes\r\n * @param moduleLoader - Optional custom loader (use vite.ssrLoadModule for dev)\r\n */\r\nexport async function loadRoutes(\r\n    scanResult: ScanResult,\r\n    moduleLoader?: (filePath: string) => Promise<any>\r\n): Promise<FileRoute[]> {\r\n    const loadedRoutes: FileRoute[] = [];\r\n\r\n    for (const route of scanResult.routes) {\r\n        try {\r\n            // Use custom loader if provided (Vite ssrLoadModule for TSX)\r\n            // Otherwise fall back to native import() for production\r\n            let module: any;\r\n            if (moduleLoader) {\r\n                module = await moduleLoader(route.filePath);\r\n            } else {\r\n                // Convert to file:// URL for Windows ESM compatibility\r\n                const fileUrl = pathToFileURL(route.filePath).href;\r\n                module = await import(fileUrl);\r\n            }\r\n\r\n            // Handle PAGE routes\r\n            if (route.type === 'page') {\r\n                // Pages export default component\r\n                const component = module.default;\r\n                const meta = module.meta || module.metadata || {};\r\n\r\n                if (component) {\r\n                    loadedRoutes.push({\r\n                        ...route,\r\n                        component,\r\n                        meta,\r\n                    });\r\n                }\r\n                continue;\r\n            }\r\n\r\n            // Handle API routes\r\n            if (route.method === 'ALL') {\r\n                // Look for named exports: GET, POST, PUT, DELETE, etc\r\n                const methods: HttpMethod[] = ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD', 'OPTIONS'];\r\n\r\n                for (const method of methods) {\r\n                    if (typeof module[method] === 'function') {\r\n                        loadedRoutes.push({\r\n                            ...route,\r\n                            method,\r\n                            handler: module[method],\r\n                        });\r\n                    }\r\n                }\r\n\r\n                // Also check for default export as handler\r\n                if (typeof module.default === 'function') {\r\n                    loadedRoutes.push({\r\n                        ...route,\r\n                        method: 'ALL',\r\n                        handler: module.default,\r\n                    });\r\n                }\r\n            } else {\r\n                // Specific method from filename suffix\r\n                const handler = module[route.method] || module.default;\r\n\r\n                if (typeof handler === 'function') {\r\n                    loadedRoutes.push({\r\n                        ...route,\r\n                        handler,\r\n                    });\r\n                }\r\n            }\r\n        } catch (error) {\r\n            console.error(`[Flight] Failed to load route ${route.filePath}:`, error);\r\n        }\r\n    }\r\n\r\n    return loadedRoutes;\r\n}\r\n\r\n// ============================================================================\r\n// File Router Factory\r\n// ============================================================================\r\n\r\nexport interface FileRouter {\r\n    routes: FileRoute[];\r\n    refresh: () => Promise<void>;\r\n}\r\n\r\n/**\r\n * Create a file-based router\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createFileRouter } from '@flight-framework/core/file-router';\r\n * import { createServer } from '@flight-framework/http';\r\n * \r\n * const router = await createFileRouter({ directory: './src/routes' });\r\n * const app = createServer();\r\n * \r\n * // Register all discovered routes\r\n * for (const route of router.routes) {\r\n *     app[route.method.toLowerCase()](route.path, route.handler);\r\n * }\r\n * ```\r\n */\r\nexport async function createFileRouter(options: FileRouterOptions): Promise<FileRouter> {\r\n    let routes: FileRoute[] = [];\r\n    const { moduleLoader } = options;\r\n\r\n    async function refresh(): Promise<void> {\r\n        const scanResult = await scanRoutes(options);\r\n\r\n        if (scanResult.errors.length > 0) {\r\n            console.warn('[Flight] Route scan errors:', scanResult.errors);\r\n        }\r\n\r\n        routes = await loadRoutes(scanResult, moduleLoader);\r\n\r\n        console.log(`[Flight] Loaded ${routes.length} routes from ${options.directory}`);\r\n    }\r\n\r\n    // Initial load\r\n    await refresh();\r\n\r\n    return {\r\n        get routes() {\r\n            return routes;\r\n        },\r\n        refresh,\r\n    };\r\n}\r\n"]}