@flight-framework/core 0.0.3 → 0.1.0

package/dist/{chunk-CLMFEKYM.js → chunk-54HPVE7N.js}

@@ -25,6 +25,20 @@ async function scanRoutes(options) {
             routes.push(...slotRoutes);
             continue;
           }
+          const interceptMatch = entry.name.match(/^\((\.+)\)(.+)$/);
+          if (interceptMatch) {
+            const level = interceptMatch[1].length;
+            const targetSegment = interceptMatch[2];
+            const interceptRoutes = await scanInterceptDir(
+              fullPath,
+              basePath,
+              level,
+              targetSegment,
+              extensions
+            );
+            routes.push(...interceptRoutes);
+            continue;
+          }
           await scanDir(fullPath, `${basePath}/${entry.name}`);
         } else if (entry.isFile()) {
           const ext = extname(entry.name);
@@ -77,6 +91,57 @@ async function scanSlotDir(dir, basePath, slotName, extensions = [".ts", ".js",
   }
   return routes;
 }
+async function scanInterceptDir(dir, basePath, level, targetSegment, extensions = [".ts", ".js", ".tsx", ".jsx"]) {
+  const routes = [];
+  const pathParts = basePath.split("/").filter(Boolean);
+  let interceptPath;
+  if (level === 1) {
+    interceptPath = `${basePath}/${targetSegment}`;
+  } else if (level === 2) {
+    pathParts.pop();
+    interceptPath = `/${pathParts.join("/")}/${targetSegment}`;
+  } else {
+    interceptPath = `/${targetSegment}`;
+  }
+  try {
+    const entries = await readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = join(dir, entry.name);
+      if (entry.isFile()) {
+        const ext = extname(entry.name);
+        if (!extensions.includes(ext)) {
+          continue;
+        }
+        const routeInfo = parseRouteFile(entry.name, basePath);
+        if (routeInfo && routeInfo.method && routeInfo.path) {
+          routes.push({
+            method: routeInfo.method,
+            path: routeInfo.path,
+            filePath: fullPath,
+            type: routeInfo.type,
+            interceptInfo: {
+              level,
+              target: targetSegment,
+              interceptPath: interceptPath.replace(/\/+/g, "/") || "/"
+            }
+          });
+        }
+      } else if (entry.isDirectory()) {
+        const subRoutes = await scanInterceptDir(
+          fullPath,
+          `${basePath}/${entry.name}`,
+          level,
+          targetSegment,
+          extensions
+        );
+        routes.push(...subRoutes);
+      }
+    }
+  } catch (error) {
+    console.error(`[Flight] Failed to scan intercept (${".".repeat(level)})${targetSegment}:`, error);
+  }
+  return routes;
+}
 function parseRouteFile(filename, basePath) {
   const ext = extname(filename);
   const nameWithoutExt = basename(filename, ext);
@@ -205,5 +270,5 @@ async function createFileRouter(options) {
 }
 
 export { createFileRouter, loadRoutes, scanRoutes };
-//# sourceMappingURL=chunk-CLMFEKYM.js.map
-//# sourceMappingURL=chunk-CLMFEKYM.js.map
+//# sourceMappingURL=chunk-54HPVE7N.js.map
+//# sourceMappingURL=chunk-54HPVE7N.js.map

package/dist/chunk-54HPVE7N.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/file-router/index.ts"],"names":[],"mappings":"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","file":"chunk-54HPVE7N.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    /** Intercepting route info (for (.) (..) (...) convention) */\r\n    interceptInfo?: {\r\n        /** Number of levels to intercept: 1 = same, 2 = parent, 3+ = root */\r\n        level: number;\r\n        /** Target route segment to intercept */\r\n        target: string;\r\n        /** Original path that triggers interception */\r\n        interceptPath: string;\r\n    };\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                    // Detect intercepting routes ((.) (..) (...) convention)\r\n                    const interceptMatch = entry.name.match(/^\\((\\.+)\\)(.+)$/);\r\n                    if (interceptMatch) {\r\n                        const level = interceptMatch[1].length;\r\n                        const targetSegment = interceptMatch[2];\r\n                        // Scan intercept directory and mark routes with interceptInfo\r\n                        const interceptRoutes = await scanInterceptDir(\r\n                            fullPath,\r\n                            basePath,\r\n                            level,\r\n                            targetSegment,\r\n                            extensions\r\n                        );\r\n                        routes.push(...interceptRoutes);\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 * Scan an intercepting route directory\r\n * Uses (.) (..) (...) convention similar to Next.js\r\n * - (.)segment - intercepts from same level\r\n * - (..)segment - intercepts from parent level\r\n * - (...)segment - intercepts from root\r\n */\r\nasync function scanInterceptDir(\r\n    dir: string,\r\n    basePath: string,\r\n    level: number,\r\n    targetSegment: string,\r\n    extensions: string[] = ['.ts', '.js', '.tsx', '.jsx']\r\n): Promise<FileRoute[]> {\r\n    const routes: FileRoute[] = [];\r\n\r\n    // Calculate the intercept path based on level\r\n    const pathParts = basePath.split('/').filter(Boolean);\r\n    let interceptPath: string;\r\n\r\n    if (level === 1) {\r\n        // (.) - Same level, intercepts sibling route\r\n        interceptPath = `${basePath}/${targetSegment}`;\r\n    } else if (level === 2) {\r\n        // (..) - Parent level\r\n        pathParts.pop();\r\n        interceptPath = `/${pathParts.join('/')}/${targetSegment}`;\r\n    } else {\r\n        // (...) - Root level (3 or more dots)\r\n        interceptPath = `/${targetSegment}`;\r\n    }\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                        interceptInfo: {\r\n                            level,\r\n                            target: targetSegment,\r\n                            interceptPath: interceptPath.replace(/\\/+/g, '/') || '/',\r\n                        },\r\n                    });\r\n                }\r\n            } else if (entry.isDirectory()) {\r\n                // Recurse into subdirectories within intercept folder\r\n                const subRoutes = await scanInterceptDir(\r\n                    fullPath,\r\n                    `${basePath}/${entry.name}`,\r\n                    level,\r\n                    targetSegment,\r\n                    extensions\r\n                );\r\n                routes.push(...subRoutes);\r\n            }\r\n        }\r\n    } catch (error) {\r\n        console.error(`[Flight] Failed to scan intercept (${'.'.repeat(level)})${targetSegment}:`, 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"]}

package/dist/{chunk-ABNCAPQB.js → chunk-6WSPUG5L.js}

@@ -217,5 +217,5 @@ async function streamSequential(boundaries) {
 }
 
 export { createLazyContent, createStreamingResponse, createStreamingSSR, renderWithStreaming, streamParallel, streamSequential };
-//# sourceMappingURL=chunk-ABNCAPQB.js.map
-//# sourceMappingURL=chunk-ABNCAPQB.js.map
+//# sourceMappingURL=chunk-6WSPUG5L.js.map
+//# sourceMappingURL=chunk-6WSPUG5L.js.map

package/dist/chunk-6WSPUG5L.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/streaming/index.ts"],"names":[],"mappings":"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","file":"chunk-6WSPUG5L.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     * IDs of boundaries that must resolve before this one.\r\n     * Enables dependency-aware streaming for complex data relationships.\r\n     * @example ['user'] - Wait for 'user' boundary before starting\r\n     */\r\n    dependsOn?: string[];\r\n    /** Custom metadata for observability */\r\n    meta?: Record<string, unknown>;\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-I2B4WSHC.js

@@ -0,0 +1,126 @@
+// src/file-router/streaming-hints.ts
+var DEFAULT_STREAMING_HINTS = {
+  enabled: true,
+  timeout: 1e4,
+  // 10 seconds
+  priority: "normal",
+  boundaries: [],
+  forceStatic: false,
+  cache: {
+    ttl: void 0,
+    swr: void 0,
+    tags: []
+  }
+};
+async function resolveStreamingConfig(module, params, request, routePath = "/") {
+  if (typeof module.getStreamingConfig === "function") {
+    try {
+      const dynamicConfig = await module.getStreamingConfig(params, request);
+      return {
+        ...DEFAULT_STREAMING_HINTS,
+        ...dynamicConfig,
+        source: "dynamic",
+        routePath
+      };
+    } catch (error) {
+      console.warn(`[Flight] Error in getStreamingConfig for ${routePath}:`, error);
+    }
+  }
+  if (module.streaming) {
+    return {
+      ...DEFAULT_STREAMING_HINTS,
+      ...module.streaming,
+      source: "static",
+      routePath
+    };
+  }
+  return {
+    ...DEFAULT_STREAMING_HINTS,
+    source: "default",
+    routePath
+  };
+}
+async function loadRouteWithStreaming(filePath, moduleLoader) {
+  let module;
+  if (moduleLoader) {
+    module = await moduleLoader(filePath);
+  } else {
+    const { pathToFileURL } = await import('url');
+    const fileUrl = pathToFileURL(filePath).href;
+    module = await import(fileUrl);
+  }
+  return {
+    module,
+    hasStreamingConfig: "streaming" in module,
+    hasGetStreamingConfig: typeof module.getStreamingConfig === "function"
+  };
+}
+function shouldStream(config, request) {
+  if (config.forceStatic) {
+    return { stream: false, reason: "forceStatic enabled" };
+  }
+  if (config.enabled === false) {
+    return { stream: false, reason: "streaming disabled in config" };
+  }
+  if (request) {
+    request.headers.get("user-agent") || "";
+    if (request.headers.get("x-no-stream") === "true") {
+      return { stream: false, reason: "x-no-stream header" };
+    }
+    if (config.priority === "low") {
+      const ect = request.headers.get("ect");
+      if (ect && ["slow-2g", "2g"].includes(ect)) {
+        return { stream: false, reason: "low priority + slow connection" };
+      }
+    }
+  }
+  return { stream: true, reason: "streaming enabled" };
+}
+function createStreamingController(timeout) {
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => {
+    controller.abort(new Error(`Streaming timeout after ${timeout}ms`));
+  }, timeout);
+  return {
+    controller,
+    signal: controller.signal,
+    cleanup: () => clearTimeout(timeoutId)
+  };
+}
+function generateCacheKey(routePath, params, config) {
+  const paramString = Object.entries(params).sort(([a], [b]) => a.localeCompare(b)).map(([k, v]) => `${k}=${v}`).join("&");
+  return `streaming:${routePath}:${paramString}`;
+}
+function getStreamingCacheHeaders(config) {
+  if (!config.cache) return {};
+  const headers = {};
+  if (config.cache.ttl) {
+    if (config.cache.swr) {
+      headers["Cache-Control"] = `s-maxage=${config.cache.ttl}, stale-while-revalidate=${config.cache.swr}`;
+    } else {
+      headers["Cache-Control"] = `s-maxage=${config.cache.ttl}`;
+    }
+  }
+  if (config.cache.tags && config.cache.tags.length > 0) {
+    headers["X-Cache-Tags"] = config.cache.tags.join(",");
+  }
+  return headers;
+}
+function hasStreamingConfig(module) {
+  if (!module || typeof module !== "object") return false;
+  return "streaming" in module || "getStreamingConfig" in module;
+}
+function isValidStreamingHints(obj) {
+  if (!obj || typeof obj !== "object") return false;
+  const hints = obj;
+  if (hints.enabled !== void 0 && typeof hints.enabled !== "boolean") return false;
+  if (hints.timeout !== void 0 && typeof hints.timeout !== "number") return false;
+  if (hints.priority !== void 0 && !["high", "normal", "low"].includes(hints.priority)) return false;
+  if (hints.boundaries !== void 0 && !Array.isArray(hints.boundaries)) return false;
+  if (hints.forceStatic !== void 0 && typeof hints.forceStatic !== "boolean") return false;
+  return true;
+}
+
+export { DEFAULT_STREAMING_HINTS, createStreamingController, generateCacheKey, getStreamingCacheHeaders, hasStreamingConfig, isValidStreamingHints, loadRouteWithStreaming, resolveStreamingConfig, shouldStream };
+//# sourceMappingURL=chunk-I2B4WSHC.js.map
+//# sourceMappingURL=chunk-I2B4WSHC.js.map

package/dist/chunk-I2B4WSHC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/file-router/streaming-hints.ts"],"names":[],"mappings":"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","file":"chunk-I2B4WSHC.js","sourcesContent":["/**\r\n * @flight-framework/core - File Router Streaming Hints\r\n * \r\n * Per-route streaming configuration through exports.\r\n * The user defines streaming behavior at the route level.\r\n * \r\n * @example\r\n * ```typescript\r\n * // src/routes/products/[id].page.tsx\r\n * \r\n * // Static export for streaming hints\r\n * export const streaming = {\r\n *     enabled: true,\r\n *     timeout: 5000,\r\n *     priority: 'high',\r\n * };\r\n * \r\n * // Or dynamic function based on params\r\n * export function getStreamingConfig(params: { id: string }) {\r\n *     return {\r\n *         enabled: params.id !== 'preview',\r\n *         timeout: 3000,\r\n *     };\r\n * }\r\n * \r\n * export default function ProductPage({ params }) {\r\n *     return <Product id={params.id} />;\r\n * }\r\n * ```\r\n */\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Static streaming configuration export\r\n */\r\nexport interface StreamingHints {\r\n    /** Whether streaming is enabled for this route (default: true) */\r\n    enabled?: boolean;\r\n    /** Timeout before aborting streaming (ms) */\r\n    timeout?: number;\r\n    /** Priority hint for streaming scheduler */\r\n    priority?: 'high' | 'normal' | 'low';\r\n    /** Expected suspense boundary IDs */\r\n    boundaries?: string[];\r\n    /** Force static rendering (no streaming) */\r\n    forceStatic?: boolean;\r\n    /** Cache the static version */\r\n    cache?: {\r\n        /** Time to cache in seconds */\r\n        ttl?: number;\r\n        /** Stale-while-revalidate time in seconds */\r\n        swr?: number;\r\n        /** Cache tags for invalidation */\r\n        tags?: string[];\r\n    };\r\n}\r\n\r\n/**\r\n * Dynamic streaming configuration function\r\n */\r\nexport type GetStreamingConfig<TParams = Record<string, string>> = (\r\n    params: TParams,\r\n    request?: Request\r\n) => StreamingHints | Promise<StreamingHints>;\r\n\r\n/**\r\n * Route module with streaming exports\r\n */\r\nexport interface StreamingRouteModule {\r\n    /** Default component/handler */\r\n    default: unknown;\r\n    /** Static streaming configuration */\r\n    streaming?: StreamingHints;\r\n    /** Dynamic streaming configuration function */\r\n    getStreamingConfig?: GetStreamingConfig;\r\n    /** Other route exports (metadata, generateStaticParams, etc.) */\r\n    [key: string]: unknown;\r\n}\r\n\r\n/**\r\n * Resolved streaming configuration for a request\r\n */\r\nexport interface ResolvedStreamingConfig extends StreamingHints {\r\n    /** Source of the configuration */\r\n    source: 'static' | 'dynamic' | 'default';\r\n    /** Route path */\r\n    routePath: string;\r\n}\r\n\r\n// ============================================================================\r\n// Default Configuration\r\n// ============================================================================\r\n\r\n/**\r\n * Default streaming hints when none are specified\r\n */\r\nexport const DEFAULT_STREAMING_HINTS: Required<StreamingHints> = {\r\n    enabled: true,\r\n    timeout: 10000, // 10 seconds\r\n    priority: 'normal',\r\n    boundaries: [],\r\n    forceStatic: false,\r\n    cache: {\r\n        ttl: undefined as unknown as number,\r\n        swr: undefined as unknown as number,\r\n        tags: [],\r\n    },\r\n};\r\n\r\n// ============================================================================\r\n// Configuration Resolution\r\n// ============================================================================\r\n\r\n/**\r\n * Resolve streaming configuration for a route request\r\n */\r\nexport async function resolveStreamingConfig(\r\n    module: StreamingRouteModule,\r\n    params: Record<string, string>,\r\n    request?: Request,\r\n    routePath: string = '/'\r\n): Promise<ResolvedStreamingConfig> {\r\n    // Check for dynamic config first (takes precedence)\r\n    if (typeof module.getStreamingConfig === 'function') {\r\n        try {\r\n            const dynamicConfig = await module.getStreamingConfig(params, request);\r\n            return {\r\n                ...DEFAULT_STREAMING_HINTS,\r\n                ...dynamicConfig,\r\n                source: 'dynamic',\r\n                routePath,\r\n            };\r\n        } catch (error) {\r\n            console.warn(`[Flight] Error in getStreamingConfig for ${routePath}:`, error);\r\n            // Fall through to static config\r\n        }\r\n    }\r\n\r\n    // Check for static config\r\n    if (module.streaming) {\r\n        return {\r\n            ...DEFAULT_STREAMING_HINTS,\r\n            ...module.streaming,\r\n            source: 'static',\r\n            routePath,\r\n        };\r\n    }\r\n\r\n    // Return defaults\r\n    return {\r\n        ...DEFAULT_STREAMING_HINTS,\r\n        source: 'default',\r\n        routePath,\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Route Loader Enhancement\r\n// ============================================================================\r\n\r\n/**\r\n * Load route module and extract streaming configuration\r\n */\r\nexport async function loadRouteWithStreaming(\r\n    filePath: string,\r\n    moduleLoader?: (path: string) => Promise<StreamingRouteModule>\r\n): Promise<{\r\n    module: StreamingRouteModule;\r\n    hasStreamingConfig: boolean;\r\n    hasGetStreamingConfig: boolean;\r\n}> {\r\n    // Use custom loader or native import\r\n    let module: StreamingRouteModule;\r\n    if (moduleLoader) {\r\n        module = await moduleLoader(filePath);\r\n    } else {\r\n        const { pathToFileURL } = await import('node:url');\r\n        const fileUrl = pathToFileURL(filePath).href;\r\n        module = await import(fileUrl);\r\n    }\r\n\r\n    return {\r\n        module,\r\n        hasStreamingConfig: 'streaming' in module,\r\n        hasGetStreamingConfig: typeof module.getStreamingConfig === 'function',\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Streaming Decision Helper\r\n// ============================================================================\r\n\r\n/**\r\n * Determine if streaming should be used based on config and request\r\n */\r\nexport function shouldStream(\r\n    config: ResolvedStreamingConfig,\r\n    request?: Request\r\n): { stream: boolean; reason: string } {\r\n    // Force static always wins\r\n    if (config.forceStatic) {\r\n        return { stream: false, reason: 'forceStatic enabled' };\r\n    }\r\n\r\n    // Check enabled flag\r\n    if (config.enabled === false) {\r\n        return { stream: false, reason: 'streaming disabled in config' };\r\n    }\r\n\r\n    // Check for bot user agents (optional, user can also use conditional.ts)\r\n    if (request) {\r\n        const userAgent = request.headers.get('user-agent') || '';\r\n\r\n        // Check for explicit no-stream header\r\n        if (request.headers.get('x-no-stream') === 'true') {\r\n            return { stream: false, reason: 'x-no-stream header' };\r\n        }\r\n\r\n        // Check for low priority and slow connection\r\n        if (config.priority === 'low') {\r\n            const ect = request.headers.get('ect');\r\n            if (ect && ['slow-2g', '2g'].includes(ect)) {\r\n                return { stream: false, reason: 'low priority + slow connection' };\r\n            }\r\n        }\r\n    }\r\n\r\n    return { stream: true, reason: 'streaming enabled' };\r\n}\r\n\r\n// ============================================================================\r\n// Timeout Controller\r\n// ============================================================================\r\n\r\n/**\r\n * Create an abort controller with timeout\r\n */\r\nexport function createStreamingController(\r\n    timeout: number\r\n): {\r\n    controller: AbortController;\r\n    signal: AbortSignal;\r\n    cleanup: () => void;\r\n} {\r\n    const controller = new AbortController();\r\n    const timeoutId = setTimeout(() => {\r\n        controller.abort(new Error(`Streaming timeout after ${timeout}ms`));\r\n    }, timeout);\r\n\r\n    return {\r\n        controller,\r\n        signal: controller.signal,\r\n        cleanup: () => clearTimeout(timeoutId),\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Caching Integration\r\n// ============================================================================\r\n\r\n/**\r\n * Generate cache key for a streaming route\r\n */\r\nexport function generateCacheKey(\r\n    routePath: string,\r\n    params: Record<string, string>,\r\n    config: StreamingHints\r\n): string {\r\n    const paramString = Object.entries(params)\r\n        .sort(([a], [b]) => a.localeCompare(b))\r\n        .map(([k, v]) => `${k}=${v}`)\r\n        .join('&');\r\n\r\n    return `streaming:${routePath}:${paramString}`;\r\n}\r\n\r\n/**\r\n * Cache headers for static streaming fallback\r\n */\r\nexport function getStreamingCacheHeaders(config: StreamingHints): Record<string, string> {\r\n    if (!config.cache) return {};\r\n\r\n    const headers: Record<string, string> = {};\r\n\r\n    if (config.cache.ttl) {\r\n        if (config.cache.swr) {\r\n            headers['Cache-Control'] = `s-maxage=${config.cache.ttl}, stale-while-revalidate=${config.cache.swr}`;\r\n        } else {\r\n            headers['Cache-Control'] = `s-maxage=${config.cache.ttl}`;\r\n        }\r\n    }\r\n\r\n    if (config.cache.tags && config.cache.tags.length > 0) {\r\n        headers['X-Cache-Tags'] = config.cache.tags.join(',');\r\n    }\r\n\r\n    return headers;\r\n}\r\n\r\n// ============================================================================\r\n// Type Guards\r\n// ============================================================================\r\n\r\n/**\r\n * Check if a module has streaming configuration\r\n */\r\nexport function hasStreamingConfig(module: unknown): module is StreamingRouteModule {\r\n    if (!module || typeof module !== 'object') return false;\r\n    return 'streaming' in module || 'getStreamingConfig' in module;\r\n}\r\n\r\n/**\r\n * Validate streaming hints object\r\n */\r\nexport function isValidStreamingHints(obj: unknown): obj is StreamingHints {\r\n    if (!obj || typeof obj !== 'object') return false;\r\n    const hints = obj as StreamingHints;\r\n\r\n    if (hints.enabled !== undefined && typeof hints.enabled !== 'boolean') return false;\r\n    if (hints.timeout !== undefined && typeof hints.timeout !== 'number') return false;\r\n    if (hints.priority !== undefined && !['high', 'normal', 'low'].includes(hints.priority)) return false;\r\n    if (hints.boundaries !== undefined && !Array.isArray(hints.boundaries)) return false;\r\n    if (hints.forceStatic !== undefined && typeof hints.forceStatic !== 'boolean') return false;\r\n\r\n    return true;\r\n}\r\n"]}