@flightdev/core 0.6.7

package/dist/chunk-OEJMIE2Q.js

@@ -0,0 +1,351 @@
+// src/streaming/priority.ts
+async function streamWithPriority(config) {
+  const {
+    shell,
+    shellEnd,
+    boundaries,
+    strategy,
+    options = {},
+    onBoundaryResolved,
+    globalTimeout
+  } = config;
+  let shellResolved = false;
+  const resolutionsPromise = [];
+  let resolveShell;
+  let resolveAll;
+  const shellReady = new Promise((r) => {
+    resolveShell = r;
+  });
+  const allReady = new Promise((r) => {
+    resolveAll = r;
+  });
+  const encoder = new TextEncoder();
+  const sortedBoundaries = [...boundaries].sort((a, b) => a.priority - b.priority);
+  const dependencyMap = /* @__PURE__ */ new Map();
+  const resolvedIds = /* @__PURE__ */ new Set();
+  for (const b of boundaries) {
+    if (b.dependsOn && b.dependsOn.length > 0) {
+      dependencyMap.set(b.id, new Set(b.dependsOn));
+    }
+  }
+  const canProcess = (id) => {
+    const deps = dependencyMap.get(id);
+    if (!deps) return true;
+    for (const dep of deps) {
+      if (!resolvedIds.has(dep)) return false;
+    }
+    return true;
+  };
+  const stream = new ReadableStream({
+    async start(controller) {
+      try {
+        const shellHtml = buildShellWithPriorityPlaceholders(shell, sortedBoundaries, shellEnd, options);
+        controller.enqueue(encoder.encode(shellHtml));
+        shellResolved = true;
+        options.onShellReady?.();
+        resolveShell();
+        if (boundaries.length > 0) {
+          await processBoundariesByStrategy(
+            controller,
+            encoder,
+            sortedBoundaries,
+            strategy,
+            dependencyMap,
+            resolvedIds,
+            canProcess,
+            resolutionsPromise,
+            onBoundaryResolved,
+            globalTimeout,
+            options
+          );
+        }
+        if (options.bootstrapScripts?.length || options.bootstrapModules?.length) {
+          const hydrationScript = buildHydrationScripts(options);
+          controller.enqueue(encoder.encode(hydrationScript));
+        }
+        options.onAllReady?.();
+        resolveAll();
+        controller.close();
+      } catch (error) {
+        if (!shellResolved) {
+          options.onShellError?.(error);
+        }
+        options.onError?.(error);
+        controller.error(error);
+      }
+    },
+    cancel() {
+    }
+  });
+  return {
+    stream,
+    abort: () => {
+    },
+    shellReady,
+    allReady,
+    resolutions: Promise.resolve(resolutionsPromise)
+  };
+}
+async function processBoundariesByStrategy(controller, encoder, boundaries, strategy, dependencyMap, resolvedIds, canProcess, resolutions, onResolved, globalTimeout, options) {
+  switch (strategy) {
+    case "priority-first":
+      await processPriorityFirst(controller, encoder, boundaries, resolvedIds, resolutions, onResolved, globalTimeout, options);
+      break;
+    case "first-ready":
+      await processFirstReady(controller, encoder, boundaries, resolvedIds, resolutions, onResolved, globalTimeout);
+      break;
+    case "dependency-aware":
+      await processDependencyAware(controller, encoder, boundaries, dependencyMap, resolvedIds, canProcess, resolutions, onResolved, globalTimeout);
+      break;
+    case "deadline-strict":
+      await processDeadlineStrict(controller, encoder, boundaries, resolvedIds, resolutions, onResolved);
+      break;
+    case "round-robin":
+      await processRoundRobin(controller, encoder, boundaries, resolvedIds, resolutions, onResolved, globalTimeout);
+      break;
+  }
+}
+async function processPriorityFirst(controller, encoder, boundaries, resolvedIds, resolutions, onResolved, globalTimeout, options) {
+  for (const boundary of boundaries) {
+    const resolution = await resolveBoundary(boundary, globalTimeout);
+    resolutions.push(resolution);
+    resolvedIds.add(boundary.id);
+    onResolved?.(resolution);
+    if (resolution.status === "resolved" && resolution.content) {
+      const script = buildContentReplacement(boundary.id, resolution.content);
+      controller.enqueue(encoder.encode(script));
+    } else if (resolution.status === "error" || resolution.status === "timeout") {
+      const errorScript = buildErrorReplacement(boundary.id, resolution.error?.message || "Timeout");
+      controller.enqueue(encoder.encode(errorScript));
+      options?.onError?.(resolution.error || new Error("Boundary timeout"));
+    }
+  }
+}
+async function processFirstReady(controller, encoder, boundaries, resolvedIds, resolutions, onResolved, globalTimeout, _options) {
+  const pending = boundaries.map((b) => resolveBoundary(b, globalTimeout));
+  const results = await Promise.allSettled(pending);
+  for (let i = 0; i < results.length; i++) {
+    const result = results[i];
+    const boundary = boundaries[i];
+    if (result.status === "fulfilled") {
+      const resolution = result.value;
+      resolutions.push(resolution);
+      resolvedIds.add(boundary.id);
+      onResolved?.(resolution);
+      if (resolution.status === "resolved" && resolution.content) {
+        const script = buildContentReplacement(boundary.id, resolution.content);
+        controller.enqueue(encoder.encode(script));
+      } else {
+        const errorScript = buildErrorReplacement(boundary.id, resolution.error?.message || "Failed");
+        controller.enqueue(encoder.encode(errorScript));
+      }
+    }
+  }
+}
+async function processDependencyAware(controller, encoder, boundaries, dependencyMap, resolvedIds, canProcess, resolutions, onResolved, globalTimeout, _options) {
+  const remaining = [...boundaries];
+  while (remaining.length > 0) {
+    const readyIndex = remaining.findIndex((b) => canProcess(b.id));
+    if (readyIndex === -1) {
+      console.warn("[Flight] Circular dependency detected, falling back to priority order");
+      for (const b of remaining) {
+        const resolution2 = await resolveBoundary(b, globalTimeout);
+        resolutions.push(resolution2);
+        resolvedIds.add(b.id);
+        onResolved?.(resolution2);
+        if (resolution2.content) {
+          controller.enqueue(encoder.encode(buildContentReplacement(b.id, resolution2.content)));
+        }
+      }
+      break;
+    }
+    const boundary = remaining.splice(readyIndex, 1)[0];
+    const resolution = await resolveBoundary(boundary, globalTimeout);
+    resolutions.push(resolution);
+    resolvedIds.add(boundary.id);
+    onResolved?.(resolution);
+    if (resolution.status === "resolved" && resolution.content) {
+      controller.enqueue(encoder.encode(buildContentReplacement(boundary.id, resolution.content)));
+    } else {
+      controller.enqueue(encoder.encode(buildErrorReplacement(boundary.id, resolution.error?.message || "Failed")));
+    }
+  }
+}
+async function processDeadlineStrict(controller, encoder, boundaries, resolvedIds, resolutions, onResolved, _options) {
+  const promises = boundaries.map(async (boundary) => {
+    const deadline = boundary.deadline || 5e3;
+    const resolution = await resolveBoundary(boundary, deadline);
+    return { boundary, resolution };
+  });
+  const results = await Promise.allSettled(promises);
+  for (const result of results) {
+    if (result.status === "fulfilled") {
+      const { boundary, resolution } = result.value;
+      resolutions.push(resolution);
+      resolvedIds.add(boundary.id);
+      onResolved?.(resolution);
+      if (resolution.status === "timeout") {
+        console.log(`[Flight] Boundary ${boundary.id} skipped due to deadline`);
+      } else if (resolution.status === "resolved" && resolution.content) {
+        controller.enqueue(encoder.encode(buildContentReplacement(boundary.id, resolution.content)));
+      } else {
+        controller.enqueue(encoder.encode(buildErrorReplacement(boundary.id, resolution.error?.message || "Error")));
+      }
+    }
+  }
+}
+async function processRoundRobin(controller, encoder, boundaries, resolvedIds, resolutions, onResolved, globalTimeout, _options) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const b of boundaries) {
+    const group = groups.get(b.priority) || [];
+    group.push(b);
+    groups.set(b.priority, group);
+  }
+  const sortedPriorities = [...groups.keys()].sort((a, b) => a - b);
+  const queues = sortedPriorities.map((p) => [...groups.get(p)]);
+  while (queues.some((q) => q.length > 0)) {
+    for (const queue of queues) {
+      if (queue.length === 0) continue;
+      const boundary = queue.shift();
+      const resolution = await resolveBoundary(boundary, globalTimeout);
+      resolutions.push(resolution);
+      resolvedIds.add(boundary.id);
+      onResolved?.(resolution);
+      if (resolution.status === "resolved" && resolution.content) {
+        controller.enqueue(encoder.encode(buildContentReplacement(boundary.id, resolution.content)));
+      }
+    }
+  }
+}
+async function resolveBoundary(boundary, timeout) {
+  const startTime = Date.now();
+  const contentPromise = typeof boundary.content === "function" ? boundary.content() : boundary.content;
+  try {
+    let content;
+    if (timeout) {
+      const timeoutPromise = new Promise((_, reject) => {
+        setTimeout(() => reject(new Error("Deadline exceeded")), timeout);
+      });
+      content = await Promise.race([contentPromise, timeoutPromise]);
+    } else {
+      content = await contentPromise;
+    }
+    return {
+      id: boundary.id,
+      content,
+      duration: Date.now() - startTime,
+      status: "resolved"
+    };
+  } catch (error) {
+    const isTimeout = error.message === "Deadline exceeded";
+    return {
+      id: boundary.id,
+      content: null,
+      duration: Date.now() - startTime,
+      status: isTimeout ? "timeout" : "error",
+      error
+    };
+  }
+}
+function buildShellWithPriorityPlaceholders(shell, boundaries, shellEnd, options) {
+  let html = shell;
+  if (options.bootstrapScriptContent) {
+    html += `<script>${options.bootstrapScriptContent}</script>`;
+  }
+  for (const boundary of boundaries) {
+    html += `
+<!--$?--><template id="B:${boundary.id}" data-priority="${boundary.priority}"></template>
+${boundary.fallback}
+<!--/$-->`;
+  }
+  html += shellEnd;
+  return html;
+}
+function buildContentReplacement(id, content) {
+  const escaped = content.replace(/\\/g, "\\\\").replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/'/g, "\\'").replace(/"/g, '\\"').replace(/\n/g, "\\n").replace(/\r/g, "\\r");
+  return `
+<script>
+(function(){
+  var b=document.getElementById("B:${id}");
+  if(b){
+    var p=b.previousSibling;
+    while(p&&p.nodeType===8&&p.data==="$?")p=p.previousSibling;
+    var n=b.nextSibling;
+    var f=document.createDocumentFragment();
+    var t=document.createElement("template");
+    t.innerHTML="${escaped}";
+    while(t.content.firstChild)f.appendChild(t.content.firstChild);
+    if(n&&n.nodeType===8&&n.data==="/$"){
+      var s=n.nextSibling;
+      while(s&&s!==b){var x=s.nextSibling;s.parentNode.removeChild(s);s=x;}
+    }
+    b.parentNode.replaceChild(f,b);
+  }
+})();
+</script>`;
+}
+function buildErrorReplacement(id, message) {
+  const escaped = message.replace(/'/g, "\\'").replace(/"/g, '\\"');
+  return `
+<script>
+(function(){
+  var b=document.getElementById("B:${id}");
+  if(b){
+    var t=document.createElement("div");
+    t.className="flight-streaming-error";
+    t.setAttribute("data-boundary-id","${id}");
+    t.textContent="Error: ${escaped}";
+    b.parentNode.replaceChild(t,b);
+  }
+})();
+</script>`;
+}
+function buildHydrationScripts(options) {
+  let scripts = "";
+  if (options.bootstrapScripts?.length) {
+    for (const src of options.bootstrapScripts) {
+      const nonceAttr = options.nonce ? ` nonce="${options.nonce}"` : "";
+      scripts += `<script src="${src}"${nonceAttr} async></script>`;
+    }
+  }
+  if (options.bootstrapModules?.length) {
+    for (const src of options.bootstrapModules) {
+      const nonceAttr = options.nonce ? ` nonce="${options.nonce}"` : "";
+      scripts += `<script type="module" src="${src}"${nonceAttr}></script>`;
+    }
+  }
+  return scripts;
+}
+function validateDependencies(boundaries) {
+  const graph = /* @__PURE__ */ new Map();
+  const allIds = new Set(boundaries.map((b) => b.id));
+  for (const b of boundaries) {
+    graph.set(b.id, b.dependsOn?.filter((d) => allIds.has(d)) || []);
+  }
+  const cycles = [];
+  const visited = /* @__PURE__ */ new Set();
+  const recursionStack = /* @__PURE__ */ new Set();
+  function dfs(id, path) {
+    if (recursionStack.has(id)) {
+      const cycleStart = path.indexOf(id);
+      cycles.push(path.slice(cycleStart));
+      return true;
+    }
+    if (visited.has(id)) return false;
+    visited.add(id);
+    recursionStack.add(id);
+    for (const dep of graph.get(id) || []) {
+      if (dfs(dep, [...path, id])) return true;
+    }
+    recursionStack.delete(id);
+    return false;
+  }
+  for (const id of graph.keys()) {
+    dfs(id, []);
+  }
+  return { valid: cycles.length === 0, cycles: cycles.length > 0 ? cycles : void 0 };
+}
+
+export { streamWithPriority, validateDependencies };
+//# sourceMappingURL=chunk-OEJMIE2Q.js.map
+//# sourceMappingURL=chunk-OEJMIE2Q.js.map

package/dist/chunk-OEJMIE2Q.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/streaming/priority.ts"],"names":["resolution"],"mappings":"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","file":"chunk-OEJMIE2Q.js","sourcesContent":["/**\r\n * @flightdev/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 '@flightdev/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"]}