@flightdev/core 0.6.7

package/dist/chunk-UVH5XJRP.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-UVH5XJRP.js.map
+//# sourceMappingURL=chunk-UVH5XJRP.js.map

package/dist/chunk-UVH5XJRP.js.map

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

@@ -0,0 +1,282 @@
+import { createStreamingSSR } from './chunk-C37YQQI7.js';
+
+// src/streaming/observability.ts
+function generateStreamId() {
+  return `stream_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
+}
+async function createInstrumentedStream(config) {
+  const {
+    shell,
+    shellEnd,
+    suspenseBoundaries,
+    options = {},
+    observer,
+    onMetrics,
+    meta
+  } = config;
+  const streamId = generateStreamId();
+  const startTime = Date.now();
+  const boundaryTimings = [];
+  const boundaryStarts = /* @__PURE__ */ new Map();
+  let shellTime = 0;
+  let totalBytes = 0;
+  let resolveMetrics;
+  const metricsPromise = new Promise((r) => {
+    resolveMetrics = r;
+  });
+  observer?.onStreamStart?.(streamId);
+  const instrumentedBoundaries = suspenseBoundaries.map((boundary) => {
+    const boundaryStart = Date.now();
+    boundaryStarts.set(boundary.id, boundaryStart);
+    observer?.onBoundaryStart?.({
+      streamId,
+      boundaryId: boundary.id,
+      startTime: boundaryStart - startTime
+    });
+    return {
+      ...boundary,
+      contentPromise: boundary.contentPromise.then(
+        (content) => {
+          const endTime = Date.now();
+          const timing = {
+            id: boundary.id,
+            startTime: boundaryStarts.get(boundary.id) - startTime,
+            endTime: endTime - startTime,
+            duration: endTime - boundaryStarts.get(boundary.id),
+            success: true,
+            contentSize: new TextEncoder().encode(content).length
+          };
+          boundaryTimings.push(timing);
+          observer?.onBoundaryEnd?.({ ...timing, streamId });
+          return content;
+        },
+        (error) => {
+          const endTime = Date.now();
+          const timing = {
+            id: boundary.id,
+            startTime: boundaryStarts.get(boundary.id) - startTime,
+            endTime: endTime - startTime,
+            duration: endTime - boundaryStarts.get(boundary.id),
+            success: false,
+            error: error instanceof Error ? error.message : String(error)
+          };
+          boundaryTimings.push(timing);
+          observer?.onBoundaryEnd?.({ ...timing, streamId });
+          observer?.onError?.({ streamId, boundaryId: boundary.id, error });
+          throw error;
+        }
+      )
+    };
+  });
+  const result = await createStreamingSSR({
+    shell,
+    shellEnd,
+    suspenseBoundaries: instrumentedBoundaries,
+    options: {
+      ...options,
+      onShellReady: () => {
+        shellTime = Date.now() - startTime;
+        observer?.onShellReady?.({ streamId, duration: shellTime });
+        options.onShellReady?.();
+      },
+      onAllReady: () => {
+        const totalStreamTime = Date.now() - startTime;
+        const metrics = {
+          streamId,
+          startTime,
+          shellTime,
+          totalStreamTime,
+          boundaries: boundaryTimings,
+          successCount: boundaryTimings.filter((b) => b.success).length,
+          errorCount: boundaryTimings.filter((b) => !b.success).length,
+          totalBytes,
+          meta
+        };
+        observer?.onStreamEnd?.(metrics);
+        onMetrics?.(metrics);
+        resolveMetrics(metrics);
+        options.onAllReady?.();
+      },
+      onError: (error) => {
+        observer?.onError?.({ streamId, error });
+        options.onError?.(error);
+      }
+    }
+  });
+  const countingStream = result.stream.pipeThrough(
+    new TransformStream({
+      transform(chunk, controller) {
+        totalBytes += chunk.length;
+        controller.enqueue(chunk);
+      }
+    })
+  );
+  return {
+    stream: countingStream,
+    abort: result.abort,
+    shellReady: result.shellReady,
+    allReady: result.allReady,
+    metrics: metricsPromise,
+    streamId
+  };
+}
+var MetricsAggregator = class {
+  metrics = [];
+  maxSamples;
+  constructor(maxSamples = 1e3) {
+    this.maxSamples = maxSamples;
+  }
+  /**
+   * Add metrics from a stream
+   */
+  add(metrics) {
+    this.metrics.push(metrics);
+    if (this.metrics.length > this.maxSamples) {
+      this.metrics.shift();
+    }
+  }
+  /**
+   * Get average shell time
+   */
+  getAverageShellTime() {
+    if (this.metrics.length === 0) return 0;
+    return this.metrics.reduce((sum, m) => sum + m.shellTime, 0) / this.metrics.length;
+  }
+  /**
+   * Get average total stream time
+   */
+  getAverageTotalTime() {
+    if (this.metrics.length === 0) return 0;
+    return this.metrics.reduce((sum, m) => sum + m.totalStreamTime, 0) / this.metrics.length;
+  }
+  /**
+   * Get slowest boundaries (by average duration)
+   */
+  getSlowestBoundaries(limit = 5) {
+    const boundaryStats = /* @__PURE__ */ new Map();
+    for (const m of this.metrics) {
+      for (const b of m.boundaries) {
+        const stats = boundaryStats.get(b.id) || { totalDuration: 0, count: 0, errors: 0 };
+        stats.totalDuration += b.duration;
+        stats.count++;
+        if (!b.success) stats.errors++;
+        boundaryStats.set(b.id, stats);
+      }
+    }
+    return [...boundaryStats.entries()].map(([id, stats]) => ({
+      id,
+      avgDuration: stats.totalDuration / stats.count,
+      errorRate: stats.errors / stats.count
+    })).sort((a, b) => b.avgDuration - a.avgDuration).slice(0, limit);
+  }
+  /**
+   * Get overall error rate
+   */
+  getErrorRate() {
+    const total = this.metrics.reduce((sum, m) => sum + m.boundaries.length, 0);
+    const errors = this.metrics.reduce((sum, m) => sum + m.errorCount, 0);
+    return total > 0 ? errors / total : 0;
+  }
+  /**
+   * Get percentiles for shell time
+   */
+  getShellTimePercentiles() {
+    const sorted = [...this.metrics].map((m) => m.shellTime).sort((a, b) => a - b);
+    const len = sorted.length;
+    if (len === 0) return { p50: 0, p90: 0, p99: 0 };
+    return {
+      p50: sorted[Math.floor(len * 0.5)] ?? 0,
+      p90: sorted[Math.floor(len * 0.9)] ?? 0,
+      p99: sorted[Math.floor(len * 0.99)] ?? 0
+    };
+  }
+  /**
+   * Export all metrics for external analysis
+   */
+  export() {
+    return [...this.metrics];
+  }
+  /**
+   * Clear all metrics
+   */
+  clear() {
+    this.metrics = [];
+  }
+};
+function createLoggerObserver(log) {
+  return {
+    onStreamStart: (streamId) => {
+      log("[Flight] Stream started", { streamId });
+    },
+    onShellReady: ({ streamId, duration }) => {
+      log("[Flight] Shell ready", { streamId, duration: `${duration}ms` });
+    },
+    onBoundaryStart: ({ streamId, boundaryId, startTime }) => {
+      log("[Flight] Boundary started", { streamId, boundaryId, startTime: `${startTime}ms` });
+    },
+    onBoundaryEnd: (timing) => {
+      log("[Flight] Boundary completed", {
+        streamId: timing.streamId,
+        boundaryId: timing.id,
+        duration: `${timing.duration}ms`,
+        success: timing.success,
+        size: timing.contentSize ? `${timing.contentSize}b` : void 0
+      });
+    },
+    onStreamEnd: (metrics) => {
+      log("[Flight] Stream completed", {
+        streamId: metrics.streamId,
+        totalTime: `${metrics.totalStreamTime}ms`,
+        shellTime: `${metrics.shellTime}ms`,
+        boundaries: metrics.boundaries.length,
+        errors: metrics.errorCount
+      });
+    },
+    onError: ({ streamId, boundaryId, error }) => {
+      log("[Flight] Stream error", { streamId, boundaryId, error: error.message });
+    }
+  };
+}
+function createHttpObserver(endpoint, options) {
+  const { headers = {}, batchSize = 10, flushInterval = 5e3 } = options || {};
+  const buffer = [];
+  let flushTimer = null;
+  const flush = async () => {
+    if (buffer.length === 0) return;
+    const batch = buffer.splice(0, buffer.length);
+    try {
+      await fetch(endpoint, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          ...headers
+        },
+        body: JSON.stringify({ metrics: batch, timestamp: Date.now() })
+      });
+    } catch (error) {
+      console.error("[Flight] Failed to send metrics:", error);
+      buffer.unshift(...batch);
+    }
+  };
+  const scheduleFlush = () => {
+    if (flushTimer) return;
+    flushTimer = setTimeout(() => {
+      flushTimer = null;
+      flush();
+    }, flushInterval);
+  };
+  return {
+    onStreamEnd: (metrics) => {
+      buffer.push(metrics);
+      if (buffer.length >= batchSize) {
+        flush();
+      } else {
+        scheduleFlush();
+      }
+    }
+  };
+}
+
+export { MetricsAggregator, createHttpObserver, createInstrumentedStream, createLoggerObserver };
+//# sourceMappingURL=chunk-WZIJKCL3.js.map
+//# sourceMappingURL=chunk-WZIJKCL3.js.map

package/dist/chunk-WZIJKCL3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/streaming/observability.ts"],"names":[],"mappings":"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","file":"chunk-WZIJKCL3.js","sourcesContent":["/**\r\n * @flightdev/core - Streaming Observability\r\n * \r\n * Zero-telemetry metrics and instrumentation for streaming SSR.\r\n * All data stays on YOUR infrastructure - never sent anywhere.\r\n * \r\n * Best Practices 2026:\r\n * - Comprehensive timing metrics for each boundary\r\n * - Hook-based observability for custom integrations\r\n * - Performance insights without vendor lock-in\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createInstrumentedStream } from '@flightdev/core/streaming';\r\n * \r\n * const { stream, metrics } = await createInstrumentedStream({\r\n *     shell: '<html>...',\r\n *     boundaries: [...],\r\n *     onMetrics: (m) => myAnalytics.track(m), // YOUR system\r\n * });\r\n * ```\r\n */\r\n\r\nimport type { StreamingRenderOptions, SuspenseBoundaryConfig } from './index.js';\r\nimport { createStreamingSSR } from './index.js';\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Timing information for a single boundary\r\n */\r\nexport interface BoundaryTiming {\r\n    /** Boundary identifier */\r\n    id: string;\r\n    /** When the boundary started resolving (ms since stream start) */\r\n    startTime: number;\r\n    /** When the boundary finished resolving */\r\n    endTime: number;\r\n    /** Total duration in milliseconds */\r\n    duration: number;\r\n    /** Whether it resolved successfully */\r\n    success: boolean;\r\n    /** Size of content in bytes (if successful) */\r\n    contentSize?: number;\r\n    /** Error message if failed */\r\n    error?: string;\r\n}\r\n\r\n/**\r\n * Overall streaming metrics\r\n */\r\nexport interface StreamingMetrics {\r\n    /** Unique ID for this stream session */\r\n    streamId: string;\r\n    /** When streaming started */\r\n    startTime: number;\r\n    /** Time to shell ready (TTFB improvement) */\r\n    shellTime: number;\r\n    /** Time until all boundaries resolved */\r\n    totalStreamTime: number;\r\n    /** Individual boundary timings */\r\n    boundaries: BoundaryTiming[];\r\n    /** Number of boundaries that resolved successfully */\r\n    successCount: number;\r\n    /** Number of boundaries that failed */\r\n    errorCount: number;\r\n    /** Total bytes streamed */\r\n    totalBytes: number;\r\n    /** Strategy used (if priority streaming) */\r\n    strategy?: string;\r\n    /** Custom metadata you can add */\r\n    meta?: Record<string, unknown>;\r\n}\r\n\r\n/**\r\n * Observability hooks for streaming events\r\n */\r\nexport interface StreamingObserver {\r\n    /** Called when streaming starts */\r\n    onStreamStart?: (streamId: string) => void;\r\n    /** Called when shell is sent */\r\n    onShellReady?: (timing: { streamId: string; duration: number }) => void;\r\n    /** Called when a boundary starts resolving */\r\n    onBoundaryStart?: (info: { streamId: string; boundaryId: string; startTime: number }) => void;\r\n    /** Called when a boundary finishes */\r\n    onBoundaryEnd?: (timing: BoundaryTiming & { streamId: string }) => void;\r\n    /** Called when streaming completes */\r\n    onStreamEnd?: (metrics: StreamingMetrics) => void;\r\n    /** Called on any error */\r\n    onError?: (error: { streamId: string; boundaryId?: string; error: Error }) => void;\r\n}\r\n\r\n/**\r\n * Configuration for instrumented streaming\r\n */\r\nexport interface InstrumentedStreamConfig {\r\n    /** Initial HTML shell */\r\n    shell: string;\r\n    /** Closing HTML */\r\n    shellEnd: string;\r\n    /** Suspense boundaries */\r\n    suspenseBoundaries: SuspenseBoundaryConfig[];\r\n    /** Streaming options */\r\n    options?: StreamingRenderOptions;\r\n    /** Observer hooks */\r\n    observer?: StreamingObserver;\r\n    /** Callback when all metrics are ready */\r\n    onMetrics?: (metrics: StreamingMetrics) => void;\r\n    /** Custom metadata to include in metrics */\r\n    meta?: Record<string, unknown>;\r\n}\r\n\r\n/**\r\n * Result of instrumented streaming\r\n */\r\nexport interface InstrumentedStreamResult {\r\n    /** The readable stream */\r\n    stream: ReadableStream<Uint8Array>;\r\n    /** Abort the stream */\r\n    abort: () => void;\r\n    /** Shell ready promise */\r\n    shellReady: Promise<void>;\r\n    /** All content ready promise */\r\n    allReady: Promise<void>;\r\n    /** Final metrics (resolves when stream completes) */\r\n    metrics: Promise<StreamingMetrics>;\r\n    /** Stream ID for correlation */\r\n    streamId: string;\r\n}\r\n\r\n// ============================================================================\r\n// Implementation\r\n// ============================================================================\r\n\r\n/**\r\n * Generate a unique stream ID\r\n */\r\nfunction generateStreamId(): string {\r\n    return `stream_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;\r\n}\r\n\r\n/**\r\n * Create an instrumented streaming SSR response with full observability\r\n */\r\nexport async function createInstrumentedStream(\r\n    config: InstrumentedStreamConfig\r\n): Promise<InstrumentedStreamResult> {\r\n    const {\r\n        shell,\r\n        shellEnd,\r\n        suspenseBoundaries,\r\n        options = {},\r\n        observer,\r\n        onMetrics,\r\n        meta,\r\n    } = config;\r\n\r\n    const streamId = generateStreamId();\r\n    const startTime = Date.now();\r\n    const boundaryTimings: BoundaryTiming[] = [];\r\n    const boundaryStarts = new Map<string, number>();\r\n    let shellTime = 0;\r\n    let totalBytes = 0;\r\n\r\n    // Metrics promise\r\n    let resolveMetrics: (m: StreamingMetrics) => void;\r\n    const metricsPromise = new Promise<StreamingMetrics>((r) => { resolveMetrics = r; });\r\n\r\n    // Notify stream start\r\n    observer?.onStreamStart?.(streamId);\r\n\r\n    // Wrap boundaries with instrumentation\r\n    const instrumentedBoundaries: SuspenseBoundaryConfig[] = suspenseBoundaries.map(boundary => {\r\n        const boundaryStart = Date.now();\r\n        boundaryStarts.set(boundary.id, boundaryStart);\r\n\r\n        observer?.onBoundaryStart?.({\r\n            streamId,\r\n            boundaryId: boundary.id,\r\n            startTime: boundaryStart - startTime,\r\n        });\r\n\r\n        return {\r\n            ...boundary,\r\n            contentPromise: boundary.contentPromise.then(\r\n                (content) => {\r\n                    const endTime = Date.now();\r\n                    const timing: BoundaryTiming = {\r\n                        id: boundary.id,\r\n                        startTime: boundaryStarts.get(boundary.id)! - startTime,\r\n                        endTime: endTime - startTime,\r\n                        duration: endTime - boundaryStarts.get(boundary.id)!,\r\n                        success: true,\r\n                        contentSize: new TextEncoder().encode(content).length,\r\n                    };\r\n                    boundaryTimings.push(timing);\r\n                    observer?.onBoundaryEnd?.({ ...timing, streamId });\r\n                    return content;\r\n                },\r\n                (error) => {\r\n                    const endTime = Date.now();\r\n                    const timing: BoundaryTiming = {\r\n                        id: boundary.id,\r\n                        startTime: boundaryStarts.get(boundary.id)! - startTime,\r\n                        endTime: endTime - startTime,\r\n                        duration: endTime - boundaryStarts.get(boundary.id)!,\r\n                        success: false,\r\n                        error: error instanceof Error ? error.message : String(error),\r\n                    };\r\n                    boundaryTimings.push(timing);\r\n                    observer?.onBoundaryEnd?.({ ...timing, streamId });\r\n                    observer?.onError?.({ streamId, boundaryId: boundary.id, error: error as Error });\r\n                    throw error;\r\n                }\r\n            ),\r\n        };\r\n    });\r\n\r\n    // Create the underlying stream with instrumented callbacks\r\n    const result = await createStreamingSSR({\r\n        shell,\r\n        shellEnd,\r\n        suspenseBoundaries: instrumentedBoundaries,\r\n        options: {\r\n            ...options,\r\n            onShellReady: () => {\r\n                shellTime = Date.now() - startTime;\r\n                observer?.onShellReady?.({ streamId, duration: shellTime });\r\n                options.onShellReady?.();\r\n            },\r\n            onAllReady: () => {\r\n                const totalStreamTime = Date.now() - startTime;\r\n\r\n                const metrics: StreamingMetrics = {\r\n                    streamId,\r\n                    startTime,\r\n                    shellTime,\r\n                    totalStreamTime,\r\n                    boundaries: boundaryTimings,\r\n                    successCount: boundaryTimings.filter(b => b.success).length,\r\n                    errorCount: boundaryTimings.filter(b => !b.success).length,\r\n                    totalBytes,\r\n                    meta,\r\n                };\r\n\r\n                observer?.onStreamEnd?.(metrics);\r\n                onMetrics?.(metrics);\r\n                resolveMetrics!(metrics);\r\n                options.onAllReady?.();\r\n            },\r\n            onError: (error) => {\r\n                observer?.onError?.({ streamId, error });\r\n                options.onError?.(error);\r\n            },\r\n        },\r\n    });\r\n\r\n    // Wrap stream to count bytes\r\n    const countingStream = result.stream.pipeThrough(\r\n        new TransformStream<Uint8Array, Uint8Array>({\r\n            transform(chunk, controller) {\r\n                totalBytes += chunk.length;\r\n                controller.enqueue(chunk);\r\n            },\r\n        })\r\n    );\r\n\r\n    return {\r\n        stream: countingStream,\r\n        abort: result.abort,\r\n        shellReady: result.shellReady,\r\n        allReady: result.allReady,\r\n        metrics: metricsPromise,\r\n        streamId,\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Utility: Metrics Aggregator\r\n// ============================================================================\r\n\r\n/**\r\n * Aggregate metrics from multiple streams for analysis\r\n */\r\nexport class MetricsAggregator {\r\n    private metrics: StreamingMetrics[] = [];\r\n    private maxSamples: number;\r\n\r\n    constructor(maxSamples = 1000) {\r\n        this.maxSamples = maxSamples;\r\n    }\r\n\r\n    /**\r\n     * Add metrics from a stream\r\n     */\r\n    add(metrics: StreamingMetrics): void {\r\n        this.metrics.push(metrics);\r\n        if (this.metrics.length > this.maxSamples) {\r\n            this.metrics.shift();\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Get average shell time\r\n     */\r\n    getAverageShellTime(): number {\r\n        if (this.metrics.length === 0) return 0;\r\n        return this.metrics.reduce((sum, m) => sum + m.shellTime, 0) / this.metrics.length;\r\n    }\r\n\r\n    /**\r\n     * Get average total stream time\r\n     */\r\n    getAverageTotalTime(): number {\r\n        if (this.metrics.length === 0) return 0;\r\n        return this.metrics.reduce((sum, m) => sum + m.totalStreamTime, 0) / this.metrics.length;\r\n    }\r\n\r\n    /**\r\n     * Get slowest boundaries (by average duration)\r\n     */\r\n    getSlowestBoundaries(limit = 5): { id: string; avgDuration: number; errorRate: number }[] {\r\n        const boundaryStats = new Map<string, { totalDuration: number; count: number; errors: number }>();\r\n\r\n        for (const m of this.metrics) {\r\n            for (const b of m.boundaries) {\r\n                const stats = boundaryStats.get(b.id) || { totalDuration: 0, count: 0, errors: 0 };\r\n                stats.totalDuration += b.duration;\r\n                stats.count++;\r\n                if (!b.success) stats.errors++;\r\n                boundaryStats.set(b.id, stats);\r\n            }\r\n        }\r\n\r\n        return [...boundaryStats.entries()]\r\n            .map(([id, stats]) => ({\r\n                id,\r\n                avgDuration: stats.totalDuration / stats.count,\r\n                errorRate: stats.errors / stats.count,\r\n            }))\r\n            .sort((a, b) => b.avgDuration - a.avgDuration)\r\n            .slice(0, limit);\r\n    }\r\n\r\n    /**\r\n     * Get overall error rate\r\n     */\r\n    getErrorRate(): number {\r\n        const total = this.metrics.reduce((sum, m) => sum + m.boundaries.length, 0);\r\n        const errors = this.metrics.reduce((sum, m) => sum + m.errorCount, 0);\r\n        return total > 0 ? errors / total : 0;\r\n    }\r\n\r\n    /**\r\n     * Get percentiles for shell time\r\n     */\r\n    getShellTimePercentiles(): { p50: number; p90: number; p99: number } {\r\n        const sorted = [...this.metrics].map(m => m.shellTime).sort((a, b) => a - b);\r\n        const len = sorted.length;\r\n        if (len === 0) return { p50: 0, p90: 0, p99: 0 };\r\n\r\n        return {\r\n            p50: sorted[Math.floor(len * 0.5)] ?? 0,\r\n            p90: sorted[Math.floor(len * 0.9)] ?? 0,\r\n            p99: sorted[Math.floor(len * 0.99)] ?? 0,\r\n        };\r\n    }\r\n\r\n    /**\r\n     * Export all metrics for external analysis\r\n     */\r\n    export(): StreamingMetrics[] {\r\n        return [...this.metrics];\r\n    }\r\n\r\n    /**\r\n     * Clear all metrics\r\n     */\r\n    clear(): void {\r\n        this.metrics = [];\r\n    }\r\n}\r\n\r\n// ============================================================================\r\n// Utility: Create Observer from Logger\r\n// ============================================================================\r\n\r\n/**\r\n * Create a streaming observer from a simple logger function\r\n */\r\nexport function createLoggerObserver(\r\n    log: (message: string, data?: Record<string, unknown>) => void\r\n): StreamingObserver {\r\n    return {\r\n        onStreamStart: (streamId) => {\r\n            log('[Flight] Stream started', { streamId });\r\n        },\r\n        onShellReady: ({ streamId, duration }) => {\r\n            log('[Flight] Shell ready', { streamId, duration: `${duration}ms` });\r\n        },\r\n        onBoundaryStart: ({ streamId, boundaryId, startTime }) => {\r\n            log('[Flight] Boundary started', { streamId, boundaryId, startTime: `${startTime}ms` });\r\n        },\r\n        onBoundaryEnd: (timing) => {\r\n            log('[Flight] Boundary completed', {\r\n                streamId: (timing as any).streamId,\r\n                boundaryId: timing.id,\r\n                duration: `${timing.duration}ms`,\r\n                success: timing.success,\r\n                size: timing.contentSize ? `${timing.contentSize}b` : undefined,\r\n            });\r\n        },\r\n        onStreamEnd: (metrics) => {\r\n            log('[Flight] Stream completed', {\r\n                streamId: metrics.streamId,\r\n                totalTime: `${metrics.totalStreamTime}ms`,\r\n                shellTime: `${metrics.shellTime}ms`,\r\n                boundaries: metrics.boundaries.length,\r\n                errors: metrics.errorCount,\r\n            });\r\n        },\r\n        onError: ({ streamId, boundaryId, error }) => {\r\n            log('[Flight] Stream error', { streamId, boundaryId, error: error.message });\r\n        },\r\n    };\r\n}\r\n\r\n/**\r\n * Create observer that sends metrics to a custom endpoint (YOUR infrastructure)\r\n */\r\nexport function createHttpObserver(endpoint: string, options?: {\r\n    headers?: Record<string, string>;\r\n    batchSize?: number;\r\n    flushInterval?: number;\r\n}): StreamingObserver {\r\n    const { headers = {}, batchSize = 10, flushInterval = 5000 } = options || {};\r\n    const buffer: StreamingMetrics[] = [];\r\n    let flushTimer: ReturnType<typeof setTimeout> | null = null;\r\n\r\n    const flush = async () => {\r\n        if (buffer.length === 0) return;\r\n        const batch = buffer.splice(0, buffer.length);\r\n\r\n        try {\r\n            await fetch(endpoint, {\r\n                method: 'POST',\r\n                headers: {\r\n                    'Content-Type': 'application/json',\r\n                    ...headers,\r\n                },\r\n                body: JSON.stringify({ metrics: batch, timestamp: Date.now() }),\r\n            });\r\n        } catch (error) {\r\n            console.error('[Flight] Failed to send metrics:', error);\r\n            // Re-add to buffer for retry\r\n            buffer.unshift(...batch);\r\n        }\r\n    };\r\n\r\n    const scheduleFlush = () => {\r\n        if (flushTimer) return;\r\n        flushTimer = setTimeout(() => {\r\n            flushTimer = null;\r\n            flush();\r\n        }, flushInterval);\r\n    };\r\n\r\n    return {\r\n        onStreamEnd: (metrics) => {\r\n            buffer.push(metrics);\r\n            if (buffer.length >= batchSize) {\r\n                flush();\r\n            } else {\r\n                scheduleFlush();\r\n            }\r\n        },\r\n    };\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"}