@flight-framework/core 0.0.3 → 0.2.0

package/dist/chunk-WOEIJWGJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/streaming/priority.ts"],"names":["resolution"],"mappings":"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","file":"chunk-WOEIJWGJ.js","sourcesContent":["/**\r\n * @flight-framework/core - Priority-Based Streaming SSR\r\n * \r\n * Out-of-order streaming with priority control, deadlines, and dependencies.\r\n * Gives developers full control over streaming order and timing.\r\n * \r\n * Best Practices 2026:\r\n * - Priority-based content delivery for optimal UX\r\n * - Deadline-aware streaming to prevent slow boundaries from blocking\r\n * - Dependency graphs for complex data relationships\r\n * - Strategy-based streaming modes for different use cases\r\n * \r\n * @example\r\n * ```typescript\r\n * import { streamWithPriority } from '@flight-framework/core/streaming';\r\n * \r\n * const result = await streamWithPriority({\r\n *     shell: '<html>...',\r\n *     shellEnd: '</html>',\r\n *     boundaries: [\r\n *         { id: 'hero', priority: 1, content: fetchHero() },\r\n *         { id: 'nav', priority: 2, content: fetchNav() },\r\n *         { id: 'comments', priority: 10, content: fetchComments() },\r\n *     ],\r\n *     strategy: 'priority-first',\r\n * });\r\n * ```\r\n */\r\n\r\nimport type { StreamingRenderOptions, StreamingRenderResult } from './index.js';\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Boundary with priority and advanced options\r\n */\r\nexport interface PriorityBoundary {\r\n    /** Unique identifier for this boundary */\r\n    id: string;\r\n    /** Fallback HTML while loading */\r\n    fallback: string;\r\n    /** Content promise or factory function */\r\n    content: Promise<string> | (() => Promise<string>);\r\n    /** Priority level (lower number = higher priority, rendered first) */\r\n    priority: number;\r\n    /** Maximum time to wait before skipping (ms). Boundary shows fallback if exceeded. */\r\n    deadline?: number;\r\n    /** IDs of boundaries that must resolve before this one starts */\r\n    dependsOn?: string[];\r\n    /** Optional metadata for observability */\r\n    meta?: Record<string, unknown>;\r\n}\r\n\r\n/**\r\n * Streaming strategy - how to order content delivery\r\n */\r\nexport type StreamingStrategy =\r\n    | 'priority-first'    // Strictly respect priority order\r\n    | 'first-ready'       // Send as soon as ready (fastest TTFB)\r\n    | 'dependency-aware'  // Respect dependencies, then priority\r\n    | 'round-robin'       // Alternate between priority levels\r\n    | 'deadline-strict';  // Skip any boundary that misses deadline\r\n\r\n/**\r\n * Result of a priority boundary resolution\r\n */\r\nexport interface BoundaryResolution {\r\n    id: string;\r\n    content: string | null;\r\n    duration: number;\r\n    status: 'resolved' | 'timeout' | 'error' | 'skipped';\r\n    error?: Error;\r\n}\r\n\r\n/**\r\n * Priority streaming configuration\r\n */\r\nexport interface PriorityStreamConfig {\r\n    /** Initial HTML shell */\r\n    shell: string;\r\n    /** Closing HTML */\r\n    shellEnd: string;\r\n    /** Boundaries with priorities */\r\n    boundaries: PriorityBoundary[];\r\n    /** Streaming strategy */\r\n    strategy: StreamingStrategy;\r\n    /** Base streaming options */\r\n    options?: StreamingRenderOptions;\r\n    /** Callback when a boundary resolves */\r\n    onBoundaryResolved?: (resolution: BoundaryResolution) => void;\r\n    /** Global timeout for all boundaries */\r\n    globalTimeout?: number;\r\n}\r\n\r\n/**\r\n * Priority streaming result with additional metrics\r\n */\r\nexport interface PriorityStreamResult extends StreamingRenderResult {\r\n    /** Resolution details for each boundary */\r\n    resolutions: Promise<BoundaryResolution[]>;\r\n}\r\n\r\n// ============================================================================\r\n// Priority Queue Implementation\r\n// ============================================================================\r\n\r\n// Note: QueuedBoundary interface removed - not currently used\r\n// Can be added back when implementing more advanced queue features\r\n\r\n/**\r\n * Create a priority-ordered streaming SSR response\r\n */\r\nexport async function streamWithPriority(\r\n    config: PriorityStreamConfig\r\n): Promise<PriorityStreamResult> {\r\n    const {\r\n        shell,\r\n        shellEnd,\r\n        boundaries,\r\n        strategy,\r\n        options = {},\r\n        onBoundaryResolved,\r\n        globalTimeout,\r\n    } = config;\r\n\r\n    let shellResolved = false;\r\n    // State tracking variables available for future use if needed\r\n    const resolutionsPromise: BoundaryResolution[] = [];\r\n\r\n    // Promises for lifecycle events\r\n    let resolveShell: () => void;\r\n    let resolveAll: () => void;\r\n    const shellReady = new Promise<void>((r) => { resolveShell = r; });\r\n    const allReady = new Promise<void>((r) => { resolveAll = r; });\r\n\r\n    const encoder = new TextEncoder();\r\n\r\n    // Sort boundaries by priority and prepare queue\r\n    const sortedBoundaries = [...boundaries].sort((a, b) => a.priority - b.priority);\r\n\r\n    // Build dependency graph\r\n    const dependencyMap = new Map<string, Set<string>>();\r\n    const resolvedIds = new Set<string>();\r\n\r\n    for (const b of boundaries) {\r\n        if (b.dependsOn && b.dependsOn.length > 0) {\r\n            dependencyMap.set(b.id, new Set(b.dependsOn));\r\n        }\r\n    }\r\n\r\n    // Check if a boundary's dependencies are satisfied\r\n    const canProcess = (id: string): boolean => {\r\n        const deps = dependencyMap.get(id);\r\n        if (!deps) return true;\r\n        for (const dep of deps) {\r\n            if (!resolvedIds.has(dep)) return false;\r\n        }\r\n        return true;\r\n    };\r\n\r\n    // Create the readable stream\r\n    const stream = new ReadableStream<Uint8Array>({\r\n        async start(controller) {\r\n            try {\r\n                // 1. Send shell with fallback placeholders\r\n                const shellHtml = buildShellWithPriorityPlaceholders(shell, sortedBoundaries, shellEnd, options);\r\n                controller.enqueue(encoder.encode(shellHtml));\r\n\r\n                shellResolved = true;\r\n                options.onShellReady?.();\r\n                resolveShell!();\r\n\r\n                // 2. Process boundaries based on strategy\r\n                if (boundaries.length > 0) {\r\n                    await processBoundariesByStrategy(\r\n                        controller,\r\n                        encoder,\r\n                        sortedBoundaries,\r\n                        strategy,\r\n                        dependencyMap,\r\n                        resolvedIds,\r\n                        canProcess,\r\n                        resolutionsPromise,\r\n                        onBoundaryResolved,\r\n                        globalTimeout,\r\n                        options\r\n                    );\r\n                }\r\n\r\n                // 3. Send hydration scripts\r\n                if (options.bootstrapScripts?.length || options.bootstrapModules?.length) {\r\n                    const hydrationScript = buildHydrationScripts(options);\r\n                    controller.enqueue(encoder.encode(hydrationScript));\r\n                }\r\n\r\n                options.onAllReady?.();\r\n                resolveAll!();\r\n                controller.close();\r\n\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            // Stream cancelled by consumer\r\n        },\r\n    });\r\n\r\n    return {\r\n        stream,\r\n        abort: () => { /* abort requested */ },\r\n        shellReady,\r\n        allReady,\r\n        resolutions: Promise.resolve(resolutionsPromise),\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Strategy Processors\r\n// ============================================================================\r\n\r\nasync function processBoundariesByStrategy(\r\n    controller: ReadableStreamDefaultController<Uint8Array>,\r\n    encoder: TextEncoder,\r\n    boundaries: PriorityBoundary[],\r\n    strategy: StreamingStrategy,\r\n    dependencyMap: Map<string, Set<string>>,\r\n    resolvedIds: Set<string>,\r\n    canProcess: (id: string) => boolean,\r\n    resolutions: BoundaryResolution[],\r\n    onResolved?: (r: BoundaryResolution) => void,\r\n    globalTimeout?: number,\r\n    options?: StreamingRenderOptions\r\n): Promise<void> {\r\n    switch (strategy) {\r\n        case 'priority-first':\r\n            await processPriorityFirst(controller, encoder, boundaries, resolvedIds, resolutions, onResolved, globalTimeout, options);\r\n            break;\r\n        case 'first-ready':\r\n            await processFirstReady(controller, encoder, boundaries, resolvedIds, resolutions, onResolved, globalTimeout, options);\r\n            break;\r\n        case 'dependency-aware':\r\n            await processDependencyAware(controller, encoder, boundaries, dependencyMap, resolvedIds, canProcess, resolutions, onResolved, globalTimeout, options);\r\n            break;\r\n        case 'deadline-strict':\r\n            await processDeadlineStrict(controller, encoder, boundaries, resolvedIds, resolutions, onResolved, options);\r\n            break;\r\n        case 'round-robin':\r\n            await processRoundRobin(controller, encoder, boundaries, resolvedIds, resolutions, onResolved, globalTimeout, options);\r\n            break;\r\n    }\r\n}\r\n\r\n/**\r\n * Priority-first: Process boundaries strictly by priority order\r\n */\r\nasync function processPriorityFirst(\r\n    controller: ReadableStreamDefaultController<Uint8Array>,\r\n    encoder: TextEncoder,\r\n    boundaries: PriorityBoundary[],\r\n    resolvedIds: Set<string>,\r\n    resolutions: BoundaryResolution[],\r\n    onResolved?: (r: BoundaryResolution) => void,\r\n    globalTimeout?: number,\r\n    options?: StreamingRenderOptions\r\n): Promise<void> {\r\n    for (const boundary of boundaries) {\r\n        const resolution = await resolveBoundary(boundary, globalTimeout);\r\n        resolutions.push(resolution);\r\n        resolvedIds.add(boundary.id);\r\n        onResolved?.(resolution);\r\n\r\n        if (resolution.status === 'resolved' && resolution.content) {\r\n            const script = buildContentReplacement(boundary.id, resolution.content);\r\n            controller.enqueue(encoder.encode(script));\r\n        } else if (resolution.status === 'error' || resolution.status === 'timeout') {\r\n            const errorScript = buildErrorReplacement(boundary.id, resolution.error?.message || 'Timeout');\r\n            controller.enqueue(encoder.encode(errorScript));\r\n            options?.onError?.(resolution.error || new Error('Boundary timeout'));\r\n        }\r\n    }\r\n}\r\n\r\n/**\r\n * First-ready: Process boundaries as they resolve (race all)\r\n */\r\nasync function processFirstReady(\r\n    controller: ReadableStreamDefaultController<Uint8Array>,\r\n    encoder: TextEncoder,\r\n    boundaries: PriorityBoundary[],\r\n    resolvedIds: Set<string>,\r\n    resolutions: BoundaryResolution[],\r\n    onResolved?: (r: BoundaryResolution) => void,\r\n    globalTimeout?: number,\r\n    _options?: StreamingRenderOptions\r\n): Promise<void> {\r\n    const pending = boundaries.map(b => resolveBoundary(b, globalTimeout));\r\n    const results = await Promise.allSettled(pending);\r\n\r\n    for (let i = 0; i < results.length; i++) {\r\n        const result = results[i];\r\n        const boundary = boundaries[i];\r\n\r\n        if (result.status === 'fulfilled') {\r\n            const resolution = result.value;\r\n            resolutions.push(resolution);\r\n            resolvedIds.add(boundary.id);\r\n            onResolved?.(resolution);\r\n\r\n            if (resolution.status === 'resolved' && resolution.content) {\r\n                const script = buildContentReplacement(boundary.id, resolution.content);\r\n                controller.enqueue(encoder.encode(script));\r\n            } else {\r\n                const errorScript = buildErrorReplacement(boundary.id, resolution.error?.message || 'Failed');\r\n                controller.enqueue(encoder.encode(errorScript));\r\n            }\r\n        }\r\n    }\r\n}\r\n\r\n/**\r\n * Dependency-aware: Respect dependencies before processing\r\n */\r\nasync function processDependencyAware(\r\n    controller: ReadableStreamDefaultController<Uint8Array>,\r\n    encoder: TextEncoder,\r\n    boundaries: PriorityBoundary[],\r\n    dependencyMap: Map<string, Set<string>>,\r\n    resolvedIds: Set<string>,\r\n    canProcess: (id: string) => boolean,\r\n    resolutions: BoundaryResolution[],\r\n    onResolved?: (r: BoundaryResolution) => void,\r\n    globalTimeout?: number,\r\n    _options?: StreamingRenderOptions\r\n): Promise<void> {\r\n    const remaining = [...boundaries];\r\n\r\n    while (remaining.length > 0) {\r\n        // Find next boundary that can be processed\r\n        const readyIndex = remaining.findIndex(b => canProcess(b.id));\r\n\r\n        if (readyIndex === -1) {\r\n            // Circular dependency detected - process remaining by priority\r\n            console.warn('[Flight] Circular dependency detected, falling back to priority order');\r\n            for (const b of remaining) {\r\n                const resolution = await resolveBoundary(b, globalTimeout);\r\n                resolutions.push(resolution);\r\n                resolvedIds.add(b.id);\r\n                onResolved?.(resolution);\r\n\r\n                if (resolution.content) {\r\n                    controller.enqueue(encoder.encode(buildContentReplacement(b.id, resolution.content)));\r\n                }\r\n            }\r\n            break;\r\n        }\r\n\r\n        const boundary = remaining.splice(readyIndex, 1)[0];\r\n        const resolution = await resolveBoundary(boundary, globalTimeout);\r\n        resolutions.push(resolution);\r\n        resolvedIds.add(boundary.id);\r\n        onResolved?.(resolution);\r\n\r\n        if (resolution.status === 'resolved' && resolution.content) {\r\n            controller.enqueue(encoder.encode(buildContentReplacement(boundary.id, resolution.content)));\r\n        } else {\r\n            controller.enqueue(encoder.encode(buildErrorReplacement(boundary.id, resolution.error?.message || 'Failed')));\r\n        }\r\n    }\r\n}\r\n\r\n/**\r\n * Deadline-strict: Skip boundaries that exceed their deadline\r\n */\r\nasync function processDeadlineStrict(\r\n    controller: ReadableStreamDefaultController<Uint8Array>,\r\n    encoder: TextEncoder,\r\n    boundaries: PriorityBoundary[],\r\n    resolvedIds: Set<string>,\r\n    resolutions: BoundaryResolution[],\r\n    onResolved?: (r: BoundaryResolution) => void,\r\n    _options?: StreamingRenderOptions\r\n): Promise<void> {\r\n    const promises = boundaries.map(async (boundary) => {\r\n        const deadline = boundary.deadline || 5000; // Default 5s\r\n        const resolution = await resolveBoundary(boundary, deadline);\r\n        return { boundary, resolution };\r\n    });\r\n\r\n    const results = await Promise.allSettled(promises);\r\n\r\n    for (const result of results) {\r\n        if (result.status === 'fulfilled') {\r\n            const { boundary, resolution } = result.value;\r\n            resolutions.push(resolution);\r\n            resolvedIds.add(boundary.id);\r\n            onResolved?.(resolution);\r\n\r\n            if (resolution.status === 'timeout') {\r\n                // Skip - leave fallback in place\r\n                console.log(`[Flight] Boundary ${boundary.id} skipped due to deadline`);\r\n            } else if (resolution.status === 'resolved' && resolution.content) {\r\n                controller.enqueue(encoder.encode(buildContentReplacement(boundary.id, resolution.content)));\r\n            } else {\r\n                controller.enqueue(encoder.encode(buildErrorReplacement(boundary.id, resolution.error?.message || 'Error')));\r\n            }\r\n        }\r\n    }\r\n}\r\n\r\n/**\r\n * Round-robin: Alternate between priority groups\r\n */\r\nasync function processRoundRobin(\r\n    controller: ReadableStreamDefaultController<Uint8Array>,\r\n    encoder: TextEncoder,\r\n    boundaries: PriorityBoundary[],\r\n    resolvedIds: Set<string>,\r\n    resolutions: BoundaryResolution[],\r\n    onResolved?: (r: BoundaryResolution) => void,\r\n    globalTimeout?: number,\r\n    _options?: StreamingRenderOptions\r\n): Promise<void> {\r\n    // Group by priority\r\n    const groups = new Map<number, PriorityBoundary[]>();\r\n    for (const b of boundaries) {\r\n        const group = groups.get(b.priority) || [];\r\n        group.push(b);\r\n        groups.set(b.priority, group);\r\n    }\r\n\r\n    const sortedPriorities = [...groups.keys()].sort((a, b) => a - b);\r\n    const queues = sortedPriorities.map(p => [...groups.get(p)!]);\r\n\r\n    // Process round-robin\r\n    while (queues.some(q => q.length > 0)) {\r\n        for (const queue of queues) {\r\n            if (queue.length === 0) continue;\r\n\r\n            const boundary = queue.shift()!;\r\n            const resolution = await resolveBoundary(boundary, globalTimeout);\r\n            resolutions.push(resolution);\r\n            resolvedIds.add(boundary.id);\r\n            onResolved?.(resolution);\r\n\r\n            if (resolution.status === 'resolved' && resolution.content) {\r\n                controller.enqueue(encoder.encode(buildContentReplacement(boundary.id, resolution.content)));\r\n            }\r\n        }\r\n    }\r\n}\r\n\r\n// ============================================================================\r\n// Boundary Resolution\r\n// ============================================================================\r\n\r\nasync function resolveBoundary(\r\n    boundary: PriorityBoundary,\r\n    timeout?: number\r\n): Promise<BoundaryResolution> {\r\n    const startTime = Date.now();\r\n    const contentPromise = typeof boundary.content === 'function'\r\n        ? boundary.content()\r\n        : boundary.content;\r\n\r\n    try {\r\n        let content: string;\r\n\r\n        if (timeout) {\r\n            const timeoutPromise = new Promise<never>((_, reject) => {\r\n                setTimeout(() => reject(new Error('Deadline exceeded')), timeout);\r\n            });\r\n            content = await Promise.race([contentPromise, timeoutPromise]);\r\n        } else {\r\n            content = await contentPromise;\r\n        }\r\n\r\n        return {\r\n            id: boundary.id,\r\n            content,\r\n            duration: Date.now() - startTime,\r\n            status: 'resolved',\r\n        };\r\n    } catch (error) {\r\n        const isTimeout = (error as Error).message === 'Deadline exceeded';\r\n        return {\r\n            id: boundary.id,\r\n            content: null,\r\n            duration: Date.now() - startTime,\r\n            status: isTimeout ? 'timeout' : 'error',\r\n            error: error as Error,\r\n        };\r\n    }\r\n}\r\n\r\n// ============================================================================\r\n// HTML Builders\r\n// ============================================================================\r\n\r\nfunction buildShellWithPriorityPlaceholders(\r\n    shell: string,\r\n    boundaries: PriorityBoundary[],\r\n    shellEnd: string,\r\n    options: StreamingRenderOptions\r\n): string {\r\n    let html = shell;\r\n\r\n    if (options.bootstrapScriptContent) {\r\n        html += `<script>${options.bootstrapScriptContent}</script>`;\r\n    }\r\n\r\n    // Add placeholders with priority data attributes\r\n    for (const boundary of boundaries) {\r\n        html += `\r\n<!--$?--><template id=\"B:${boundary.id}\" data-priority=\"${boundary.priority}\"></template>\r\n${boundary.fallback}\r\n<!--/$-->`;\r\n    }\r\n\r\n    html += shellEnd;\r\n    return html;\r\n}\r\n\r\nfunction buildContentReplacement(id: string, content: string): string {\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\nfunction buildErrorReplacement(id: string, message: string): string {\r\n    const escaped = message.replace(/'/g, \"\\\\'\").replace(/\"/g, '\\\\\"');\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=\"flight-streaming-error\";\r\n    t.setAttribute(\"data-boundary-id\",\"${id}\");\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\nfunction buildHydrationScripts(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// Utility: Validate Dependencies (check for cycles)\r\n// ============================================================================\r\n\r\n/**\r\n * Validate that boundaries don't have circular dependencies\r\n */\r\nexport function validateDependencies(boundaries: PriorityBoundary[]): { valid: boolean; cycles?: string[][] } {\r\n    const graph = new Map<string, string[]>();\r\n    const allIds = new Set(boundaries.map(b => b.id));\r\n\r\n    for (const b of boundaries) {\r\n        graph.set(b.id, b.dependsOn?.filter(d => allIds.has(d)) || []);\r\n    }\r\n\r\n    const cycles: string[][] = [];\r\n    const visited = new Set<string>();\r\n    const recursionStack = new Set<string>();\r\n\r\n    function dfs(id: string, path: string[]): boolean {\r\n        if (recursionStack.has(id)) {\r\n            const cycleStart = path.indexOf(id);\r\n            cycles.push(path.slice(cycleStart));\r\n            return true;\r\n        }\r\n        if (visited.has(id)) return false;\r\n\r\n        visited.add(id);\r\n        recursionStack.add(id);\r\n\r\n        for (const dep of graph.get(id) || []) {\r\n            if (dfs(dep, [...path, id])) return true;\r\n        }\r\n\r\n        recursionStack.delete(id);\r\n        return false;\r\n    }\r\n\r\n    for (const id of graph.keys()) {\r\n        dfs(id, []);\r\n    }\r\n\r\n    return { valid: cycles.length === 0, cycles: cycles.length > 0 ? cycles : undefined };\r\n}\r\n"]}

package/dist/chunk-XOIYNY4I.js

@@ -0,0 +1,164 @@
+// src/streaming/conditional.ts
+var DEFAULT_BOT_PATTERNS = [
+  /googlebot/i,
+  /bingbot/i,
+  /slurp/i,
+  // Yahoo
+  /duckduckbot/i,
+  /baiduspider/i,
+  /yandexbot/i,
+  /sogou/i,
+  /facebot/i,
+  // Facebook
+  /twitterbot/i,
+  /linkedinbot/i,
+  /whatsapp/i,
+  /telegrambot/i,
+  /discordbot/i,
+  /slackbot/i,
+  /applebot/i,
+  /crawler/i,
+  /spider/i,
+  /bot\//i,
+  /bot;/i,
+  /headless/i,
+  // Headless browsers
+  /lighthouse/i,
+  // Google Lighthouse
+  /pagespeed/i,
+  /gtmetrix/i,
+  /pingdom/i,
+  /uptimerobot/i
+];
+function isBot(request, customPatterns) {
+  const userAgent = request.headers.get("user-agent") || "";
+  const patterns = customPatterns || DEFAULT_BOT_PATTERNS;
+  return patterns.some((pattern) => pattern.test(userAgent));
+}
+function prefersNoStream(request) {
+  if (request.headers.get("x-no-stream") === "true") return true;
+  if (request.headers.get("x-prefer-static") === "true") return true;
+  const accept = request.headers.get("accept") || "";
+  if (accept.includes("text/html; streaming=false")) return true;
+  return false;
+}
+function isSlowConnection(request) {
+  const ect = request.headers.get("ect");
+  if (ect && ["slow-2g", "2g"].includes(ect)) return true;
+  if (request.headers.get("save-data") === "on") return true;
+  const downlink = request.headers.get("downlink");
+  if (downlink && parseFloat(downlink) < 1) return true;
+  return false;
+}
+function supportsStreaming(request) {
+  const userAgent = request.headers.get("user-agent") || "";
+  if (/MSIE|Trident/i.test(userAgent)) return false;
+  if (/Opera Mini/i.test(userAgent)) return false;
+  const secChUa = request.headers.get("sec-ch-ua");
+  if (secChUa) {
+    return true;
+  }
+  return true;
+}
+function getBuiltInCondition(condition, botPatterns) {
+  switch (condition) {
+    case "always-stream":
+      return () => true;
+    case "never-stream":
+      return () => false;
+    case "no-bots":
+      return (req) => !isBot(req, botPatterns) && !prefersNoStream(req);
+    case "fast-network":
+      return (req) => !isSlowConnection(req) && !isBot(req, botPatterns);
+    case "modern-browser":
+      return (req) => supportsStreaming(req) && !isBot(req, botPatterns);
+  }
+}
+async function streamIf(config) {
+  const {
+    request,
+    condition,
+    stream,
+    static: staticFn,
+    botPatterns,
+    forceStreamParam = "__stream",
+    forceStaticParam = "__static"
+  } = config;
+  const url = new URL(request.url);
+  if (url.searchParams.has(forceStreamParam)) {
+    const result2 = await stream();
+    return { result: result2, streaming: true, reason: "forced via query param" };
+  }
+  if (url.searchParams.has(forceStaticParam)) {
+    const result2 = await staticFn();
+    return { result: result2, streaming: false, reason: "forced via query param" };
+  }
+  const conditionFn = typeof condition === "function" ? condition : getBuiltInCondition(condition, botPatterns);
+  let shouldStream;
+  let reason;
+  try {
+    shouldStream = await conditionFn(request);
+    reason = shouldStream ? "condition passed" : "condition failed";
+  } catch (error) {
+    shouldStream = false;
+    reason = `condition error: ${error instanceof Error ? error.message : "unknown"}`;
+  }
+  if (typeof condition === "string") {
+    if (!shouldStream && condition === "no-bots") {
+      reason = isBot(request, botPatterns) ? "bot detected" : "user prefers no streaming";
+    } else if (!shouldStream && condition === "fast-network") {
+      reason = isSlowConnection(request) ? "slow connection detected" : "bot detected";
+    }
+  }
+  const result = shouldStream ? await stream() : await staticFn();
+  return { result, streaming: shouldStream, reason };
+}
+function createConditionalStreamer(defaultCondition, options) {
+  return async (config) => {
+    return streamIf({
+      request: config.request,
+      condition: config.condition || defaultCondition,
+      stream: config.stream,
+      static: config.static,
+      ...options
+    });
+  };
+}
+function addStreamingHeaders(response, decision) {
+  const headers = new Headers(response.headers);
+  headers.set("X-Flight-Streaming", decision.streaming ? "true" : "false");
+  headers.set("X-Flight-Streaming-Reason", decision.reason);
+  return new Response(response.body, {
+    status: response.status,
+    statusText: response.statusText,
+    headers
+  });
+}
+function createStreamingResponse(stream, options) {
+  const { status = 200, headers = {}, isStreaming = true } = options || {};
+  return new Response(stream, {
+    status,
+    headers: {
+      "Content-Type": "text/html; charset=utf-8",
+      "Transfer-Encoding": isStreaming ? "chunked" : void 0,
+      "X-Content-Type-Options": "nosniff",
+      "X-Flight-Streaming": isStreaming ? "true" : "false",
+      ...headers
+    }
+  });
+}
+function createStaticResponse(html, options) {
+  const { status = 200, headers = {} } = options || {};
+  return new Response(html, {
+    status,
+    headers: {
+      "Content-Type": "text/html; charset=utf-8",
+      "X-Flight-Streaming": "false",
+      ...headers
+    }
+  });
+}
+
+export { DEFAULT_BOT_PATTERNS, addStreamingHeaders, createConditionalStreamer, createStaticResponse, createStreamingResponse, isBot, isSlowConnection, prefersNoStream, streamIf, supportsStreaming };
+//# sourceMappingURL=chunk-XOIYNY4I.js.map
+//# sourceMappingURL=chunk-XOIYNY4I.js.map

package/dist/chunk-XOIYNY4I.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/streaming/conditional.ts"],"names":["result"],"mappings":"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","file":"chunk-XOIYNY4I.js","sourcesContent":["/**\r\n * @flight-framework/core - Conditional Streaming\r\n * \r\n * Smart streaming decisions based on request context.\r\n * Bots get full HTML, users get streaming - YOU control the logic.\r\n * \r\n * Best Practices 2026:\r\n * - SEO-friendly: Crawlers receive complete HTML\r\n * - Performance: Users get progressive streaming\r\n * - Flexibility: Custom conditions for any use case\r\n * \r\n * @example\r\n * ```typescript\r\n * import { streamIf } from '@flight-framework/core/streaming';\r\n * \r\n * const response = await streamIf({\r\n *     request,\r\n *     condition: (req) => !isBot(req), // YOUR logic\r\n *     stream: () => createStreamingSSR({ ... }),\r\n *     static: () => renderToString(<App />),\r\n * });\r\n * ```\r\n */\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Condition function to determine if streaming should be used\r\n */\r\nexport type StreamingCondition = (request: Request) => boolean | Promise<boolean>;\r\n\r\n/**\r\n * Built-in condition types\r\n */\r\nexport type BuiltInCondition =\r\n    | 'always-stream'       // Always use streaming\r\n    | 'never-stream'        // Always use static\r\n    | 'no-bots'            // Stream for users, static for bots\r\n    | 'fast-network'       // Stream only on fast connections\r\n    | 'modern-browser';    // Stream only on modern browsers\r\n\r\n/**\r\n * Configuration for conditional streaming\r\n */\r\nexport interface StreamIfConfig<T = Response> {\r\n    /** The incoming request */\r\n    request: Request;\r\n    /** Condition to check (function or built-in) */\r\n    condition: StreamingCondition | BuiltInCondition;\r\n    /** Factory for streaming response */\r\n    stream: () => Promise<T> | T;\r\n    /** Factory for static response */\r\n    static: () => Promise<T> | T;\r\n    /** Optional: Custom bot patterns */\r\n    botPatterns?: RegExp[];\r\n    /** Optional: Force streaming via query param (for testing) */\r\n    forceStreamParam?: string;\r\n    /** Optional: Force static via query param (for testing) */\r\n    forceStaticParam?: string;\r\n}\r\n\r\n/**\r\n * Result of condition evaluation\r\n */\r\nexport interface StreamingDecision {\r\n    /** Whether streaming was used */\r\n    streaming: boolean;\r\n    /** Reason for the decision */\r\n    reason: string;\r\n    /** The response */\r\n    response: Response;\r\n}\r\n\r\n// ============================================================================\r\n// Bot Detection\r\n// ============================================================================\r\n\r\n/**\r\n * Default bot patterns for detection\r\n */\r\nexport const DEFAULT_BOT_PATTERNS: RegExp[] = [\r\n    /googlebot/i,\r\n    /bingbot/i,\r\n    /slurp/i,           // Yahoo\r\n    /duckduckbot/i,\r\n    /baiduspider/i,\r\n    /yandexbot/i,\r\n    /sogou/i,\r\n    /facebot/i,         // Facebook\r\n    /twitterbot/i,\r\n    /linkedinbot/i,\r\n    /whatsapp/i,\r\n    /telegrambot/i,\r\n    /discordbot/i,\r\n    /slackbot/i,\r\n    /applebot/i,\r\n    /crawler/i,\r\n    /spider/i,\r\n    /bot\\//i,\r\n    /bot;/i,\r\n    /headless/i,        // Headless browsers\r\n    /lighthouse/i,      // Google Lighthouse\r\n    /pagespeed/i,\r\n    /gtmetrix/i,\r\n    /pingdom/i,\r\n    /uptimerobot/i,\r\n];\r\n\r\n/**\r\n * Check if a request is from a bot/crawler\r\n */\r\nexport function isBot(request: Request, customPatterns?: RegExp[]): boolean {\r\n    const userAgent = request.headers.get('user-agent') || '';\r\n    const patterns = customPatterns || DEFAULT_BOT_PATTERNS;\r\n    return patterns.some(pattern => pattern.test(userAgent));\r\n}\r\n\r\n/**\r\n * Check if request explicitly asks for no streaming\r\n */\r\nexport function prefersNoStream(request: Request): boolean {\r\n    // Check for custom header\r\n    if (request.headers.get('x-no-stream') === 'true') return true;\r\n    if (request.headers.get('x-prefer-static') === 'true') return true;\r\n\r\n    // Check Accept header for preference\r\n    const accept = request.headers.get('accept') || '';\r\n    if (accept.includes('text/html; streaming=false')) return true;\r\n\r\n    return false;\r\n}\r\n\r\n/**\r\n * Check if a connection is likely slow (based on headers)\r\n */\r\nexport function isSlowConnection(request: Request): boolean {\r\n    // ECT (Effective Connection Type) header\r\n    const ect = request.headers.get('ect');\r\n    if (ect && ['slow-2g', '2g'].includes(ect)) return true;\r\n\r\n    // Save-Data header\r\n    if (request.headers.get('save-data') === 'on') return true;\r\n\r\n    // Downlink header (Mbps)\r\n    const downlink = request.headers.get('downlink');\r\n    if (downlink && parseFloat(downlink) < 1) return true;\r\n\r\n    return false;\r\n}\r\n\r\n/**\r\n * Check if browser supports streaming well\r\n */\r\nexport function supportsStreaming(request: Request): boolean {\r\n    const userAgent = request.headers.get('user-agent') || '';\r\n\r\n    // IE doesn't support streaming well\r\n    if (/MSIE|Trident/i.test(userAgent)) return false;\r\n\r\n    // Very old browsers\r\n    if (/Opera Mini/i.test(userAgent)) return false;\r\n\r\n    // Check for modern browser features via client hints\r\n    const secChUa = request.headers.get('sec-ch-ua');\r\n    if (secChUa) {\r\n        // Has client hints = modern browser\r\n        return true;\r\n    }\r\n\r\n    return true; // Default to supporting streaming\r\n}\r\n\r\n// ============================================================================\r\n// Built-in Conditions\r\n// ============================================================================\r\n\r\nfunction getBuiltInCondition(\r\n    condition: BuiltInCondition,\r\n    botPatterns?: RegExp[]\r\n): StreamingCondition {\r\n    switch (condition) {\r\n        case 'always-stream':\r\n            return () => true;\r\n        case 'never-stream':\r\n            return () => false;\r\n        case 'no-bots':\r\n            return (req) => !isBot(req, botPatterns) && !prefersNoStream(req);\r\n        case 'fast-network':\r\n            return (req) => !isSlowConnection(req) && !isBot(req, botPatterns);\r\n        case 'modern-browser':\r\n            return (req) => supportsStreaming(req) && !isBot(req, botPatterns);\r\n    }\r\n}\r\n\r\n// ============================================================================\r\n// Main Function\r\n// ============================================================================\r\n\r\n/**\r\n * Conditionally use streaming or static rendering based on request context\r\n */\r\nexport async function streamIf<T = Response>(\r\n    config: StreamIfConfig<T>\r\n): Promise<{ result: T; streaming: boolean; reason: string }> {\r\n    const {\r\n        request,\r\n        condition,\r\n        stream,\r\n        static: staticFn,\r\n        botPatterns,\r\n        forceStreamParam = '__stream',\r\n        forceStaticParam = '__static',\r\n    } = config;\r\n\r\n    // Check for forced mode via query params (useful for testing)\r\n    const url = new URL(request.url);\r\n    if (url.searchParams.has(forceStreamParam)) {\r\n        const result = await stream();\r\n        return { result, streaming: true, reason: 'forced via query param' };\r\n    }\r\n    if (url.searchParams.has(forceStaticParam)) {\r\n        const result = await staticFn();\r\n        return { result, streaming: false, reason: 'forced via query param' };\r\n    }\r\n\r\n    // Resolve condition\r\n    const conditionFn = typeof condition === 'function'\r\n        ? condition\r\n        : getBuiltInCondition(condition, botPatterns);\r\n\r\n    // Evaluate condition\r\n    let shouldStream: boolean;\r\n    let reason: string;\r\n\r\n    try {\r\n        shouldStream = await conditionFn(request);\r\n        reason = shouldStream ? 'condition passed' : 'condition failed';\r\n    } catch (error) {\r\n        // On error, default to static (safer for SEO)\r\n        shouldStream = false;\r\n        reason = `condition error: ${error instanceof Error ? error.message : 'unknown'}`;\r\n    }\r\n\r\n    // Add specific reason for built-in conditions\r\n    if (typeof condition === 'string') {\r\n        if (!shouldStream && condition === 'no-bots') {\r\n            reason = isBot(request, botPatterns)\r\n                ? 'bot detected'\r\n                : 'user prefers no streaming';\r\n        } else if (!shouldStream && condition === 'fast-network') {\r\n            reason = isSlowConnection(request)\r\n                ? 'slow connection detected'\r\n                : 'bot detected';\r\n        }\r\n    }\r\n\r\n    // Execute appropriate renderer\r\n    const result = shouldStream ? await stream() : await staticFn();\r\n    return { result, streaming: shouldStream, reason };\r\n}\r\n\r\n/**\r\n * Create a middleware-style conditional streamer\r\n */\r\nexport function createConditionalStreamer<T = Response>(\r\n    defaultCondition: StreamingCondition | BuiltInCondition,\r\n    options?: {\r\n        botPatterns?: RegExp[];\r\n        forceStreamParam?: string;\r\n        forceStaticParam?: string;\r\n    }\r\n) {\r\n    return async (config: {\r\n        request: Request;\r\n        stream: () => Promise<T> | T;\r\n        static: () => Promise<T> | T;\r\n        condition?: StreamingCondition | BuiltInCondition;\r\n    }) => {\r\n        return streamIf({\r\n            request: config.request,\r\n            condition: config.condition || defaultCondition,\r\n            stream: config.stream,\r\n            static: config.static,\r\n            ...options,\r\n        });\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Response Helpers\r\n// ============================================================================\r\n\r\n/**\r\n * Add streaming decision headers to response (for debugging)\r\n */\r\nexport function addStreamingHeaders(\r\n    response: Response,\r\n    decision: { streaming: boolean; reason: string }\r\n): Response {\r\n    const headers = new Headers(response.headers);\r\n    headers.set('X-Flight-Streaming', decision.streaming ? 'true' : 'false');\r\n    headers.set('X-Flight-Streaming-Reason', decision.reason);\r\n\r\n    return new Response(response.body, {\r\n        status: response.status,\r\n        statusText: response.statusText,\r\n        headers,\r\n    });\r\n}\r\n\r\n/**\r\n * Create a streaming-aware Response with appropriate headers\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        isStreaming?: boolean;\r\n    }\r\n): Response {\r\n    const { status = 200, headers = {}, isStreaming = true } = options || {};\r\n\r\n    return new Response(stream, {\r\n        status,\r\n        headers: {\r\n            'Content-Type': 'text/html; charset=utf-8',\r\n            'Transfer-Encoding': isStreaming ? 'chunked' : undefined,\r\n            'X-Content-Type-Options': 'nosniff',\r\n            'X-Flight-Streaming': isStreaming ? 'true' : 'false',\r\n            ...headers,\r\n        } as HeadersInit,\r\n    });\r\n}\r\n\r\n/**\r\n * Create a static HTML Response\r\n */\r\nexport function createStaticResponse(\r\n    html: string,\r\n    options?: {\r\n        status?: number;\r\n        headers?: Record<string, string>;\r\n    }\r\n): Response {\r\n    const { status = 200, headers = {} } = options || {};\r\n\r\n    return new Response(html, {\r\n        status,\r\n        headers: {\r\n            'Content-Type': 'text/html; charset=utf-8',\r\n            'X-Flight-Streaming': 'false',\r\n            ...headers,\r\n        },\r\n    });\r\n}\r\n"]}

package/dist/chunk-XSY5AAXT.js

@@ -0,0 +1,125 @@
+// 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) {
+    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-XSY5AAXT.js.map
+//# sourceMappingURL=chunk-XSY5AAXT.js.map

package/dist/chunk-XSY5AAXT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/file-router/streaming-hints.ts"],"names":[],"mappings":"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","file":"chunk-XSY5AAXT.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        // userAgent could be used here for bot detection if needed\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"]}

package/dist/chunk-Y22AMGTM.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=chunk-Y22AMGTM.js.map
+//# sourceMappingURL=chunk-Y22AMGTM.js.map

package/dist/chunk-Y22AMGTM.js.map

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

package/dist/file-router/index.d.ts

@@ -26,6 +26,15 @@ interface FileRoute {
     meta?: Record<string, unknown>;
     /** Parallel route slot name (for @folder convention) */
     slot?: string;
+    /** Intercepting route info (for (.) (..) (...) convention) */
+    interceptInfo?: {
+        /** Number of levels to intercept: 1 = same, 2 = parent, 3+ = root */
+        level: number;
+        /** Target route segment to intercept */
+        target: string;
+        /** Original path that triggers interception */
+        interceptPath: string;
+    };
 }
 interface FileRouterOptions {
     /** Root directory to scan (default: src/routes) */

package/dist/file-router/index.js

@@ -1,3 +1,3 @@
-export { createFileRouter, loadRoutes, scanRoutes } from '../chunk-CLMFEKYM.js';
+export { createFileRouter, loadRoutes, scanRoutes } from '../chunk-54HPVE7N.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/file-router/streaming-hints.d.ts

@@ -0,0 +1,129 @@
+/**
+ * @flight-framework/core - File Router Streaming Hints
+ *
+ * Per-route streaming configuration through exports.
+ * The user defines streaming behavior at the route level.
+ *
+ * @example
+ * ```typescript
+ * // src/routes/products/[id].page.tsx
+ *
+ * // Static export for streaming hints
+ * export const streaming = {
+ *     enabled: true,
+ *     timeout: 5000,
+ *     priority: 'high',
+ * };
+ *
+ * // Or dynamic function based on params
+ * export function getStreamingConfig(params: { id: string }) {
+ *     return {
+ *         enabled: params.id !== 'preview',
+ *         timeout: 3000,
+ *     };
+ * }
+ *
+ * export default function ProductPage({ params }) {
+ *     return <Product id={params.id} />;
+ * }
+ * ```
+ */
+/**
+ * Static streaming configuration export
+ */
+interface StreamingHints {
+    /** Whether streaming is enabled for this route (default: true) */
+    enabled?: boolean;
+    /** Timeout before aborting streaming (ms) */
+    timeout?: number;
+    /** Priority hint for streaming scheduler */
+    priority?: 'high' | 'normal' | 'low';
+    /** Expected suspense boundary IDs */
+    boundaries?: string[];
+    /** Force static rendering (no streaming) */
+    forceStatic?: boolean;
+    /** Cache the static version */
+    cache?: {
+        /** Time to cache in seconds */
+        ttl?: number;
+        /** Stale-while-revalidate time in seconds */
+        swr?: number;
+        /** Cache tags for invalidation */
+        tags?: string[];
+    };
+}
+/**
+ * Dynamic streaming configuration function
+ */
+type GetStreamingConfig<TParams = Record<string, string>> = (params: TParams, request?: Request) => StreamingHints | Promise<StreamingHints>;
+/**
+ * Route module with streaming exports
+ */
+interface StreamingRouteModule {
+    /** Default component/handler */
+    default: unknown;
+    /** Static streaming configuration */
+    streaming?: StreamingHints;
+    /** Dynamic streaming configuration function */
+    getStreamingConfig?: GetStreamingConfig;
+    /** Other route exports (metadata, generateStaticParams, etc.) */
+    [key: string]: unknown;
+}
+/**
+ * Resolved streaming configuration for a request
+ */
+interface ResolvedStreamingConfig extends StreamingHints {
+    /** Source of the configuration */
+    source: 'static' | 'dynamic' | 'default';
+    /** Route path */
+    routePath: string;
+}
+/**
+ * Default streaming hints when none are specified
+ */
+declare const DEFAULT_STREAMING_HINTS: Required<StreamingHints>;
+/**
+ * Resolve streaming configuration for a route request
+ */
+declare function resolveStreamingConfig(module: StreamingRouteModule, params: Record<string, string>, request?: Request, routePath?: string): Promise<ResolvedStreamingConfig>;
+/**
+ * Load route module and extract streaming configuration
+ */
+declare function loadRouteWithStreaming(filePath: string, moduleLoader?: (path: string) => Promise<StreamingRouteModule>): Promise<{
+    module: StreamingRouteModule;
+    hasStreamingConfig: boolean;
+    hasGetStreamingConfig: boolean;
+}>;
+/**
+ * Determine if streaming should be used based on config and request
+ */
+declare function shouldStream(config: ResolvedStreamingConfig, request?: Request): {
+    stream: boolean;
+    reason: string;
+};
+/**
+ * Create an abort controller with timeout
+ */
+declare function createStreamingController(timeout: number): {
+    controller: AbortController;
+    signal: AbortSignal;
+    cleanup: () => void;
+};
+/**
+ * Generate cache key for a streaming route
+ */
+declare function generateCacheKey(routePath: string, params: Record<string, string>, _config: StreamingHints): string;
+/**
+ * Cache headers for static streaming fallback
+ */
+declare function getStreamingCacheHeaders(config: StreamingHints): Record<string, string>;
+/**
+ * Check if a module has streaming configuration
+ */
+declare function hasStreamingConfig(module: unknown): module is StreamingRouteModule;
+/**
+ * Validate streaming hints object
+ */
+declare function isValidStreamingHints(obj: unknown): obj is StreamingHints;
+
+export { DEFAULT_STREAMING_HINTS, type GetStreamingConfig, type ResolvedStreamingConfig, type StreamingHints, type StreamingRouteModule, createStreamingController, generateCacheKey, getStreamingCacheHeaders, hasStreamingConfig, isValidStreamingHints, loadRouteWithStreaming, resolveStreamingConfig, shouldStream };

package/dist/file-router/streaming-hints.js

@@ -0,0 +1,3 @@
+export { DEFAULT_STREAMING_HINTS, createStreamingController, generateCacheKey, getStreamingCacheHeaders, hasStreamingConfig, isValidStreamingHints, loadRouteWithStreaming, resolveStreamingConfig, shouldStream } from '../chunk-XSY5AAXT.js';
+//# sourceMappingURL=streaming-hints.js.map
+//# sourceMappingURL=streaming-hints.js.map

package/dist/file-router/streaming-hints.js.map

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