@flight-framework/core 0.0.3 → 0.2.0

package/dist/chunk-62C7LX2E.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/rsc/context.ts"],"names":[],"mappings":"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","file":"chunk-62C7LX2E.js","sourcesContent":["/**\r\n * @flight-framework/core - Server Context\r\n * \r\n * API de contexto para Server Components.\r\n * Provee acceso a datos del request de forma explícita y type-safe.\r\n * \r\n * Filosofía Flight:\r\n * - Contexto EXPLÍCITO (no magia con AsyncLocalStorage)\r\n * - Pasado como argumento (testeable, predecible)\r\n * - Extensible con adapters custom\r\n * - Inmutable por defecto\r\n * \r\n * @module @flight-framework/core/rsc/context\r\n */\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\n/**\r\n * Contexto del servidor disponible en Server Components\r\n */\r\nexport interface ServerContext {\r\n    /** Request actual (Web API Request) */\r\n    readonly request: Request;\r\n\r\n    /** Parámetros de ruta */\r\n    readonly params: Readonly<Record<string, string>>;\r\n\r\n    /** Search params de la URL */\r\n    readonly searchParams: URLSearchParams;\r\n\r\n    /** Headers del request */\r\n    readonly headers: Headers;\r\n\r\n    /** Accessor de cookies */\r\n    readonly cookies: CookieAccessor;\r\n\r\n    /** Headers de respuesta (mutables) */\r\n    readonly responseHeaders: Headers;\r\n\r\n    /** Signal para cancelación */\r\n    readonly signal: AbortSignal;\r\n\r\n    /** URL parseada */\r\n    readonly url: URL;\r\n\r\n    /** Método HTTP */\r\n    readonly method: string;\r\n\r\n    /** Context extensions (para adapters) */\r\n    readonly extensions: ContextExtensions;\r\n}\r\n\r\n/**\r\n * Accessor para cookies con lazy parsing\r\n */\r\nexport interface CookieAccessor {\r\n    /** Obtiene el valor de una cookie */\r\n    get(name: string): string | undefined;\r\n\r\n    /** Obtiene todas las cookies */\r\n    getAll(): Readonly<Record<string, string>>;\r\n\r\n    /** Verifica si existe una cookie */\r\n    has(name: string): boolean;\r\n}\r\n\r\n/**\r\n * Extensiones del contexto para adapters\r\n */\r\nexport interface ContextExtensions {\r\n    /** Obtiene una extensión */\r\n    get<T>(key: string): T | undefined;\r\n\r\n    /** Verifica si existe una extensión */\r\n    has(key: string): boolean;\r\n}\r\n\r\n/**\r\n * Opciones para crear ServerContext\r\n */\r\nexport interface ServerContextOptions {\r\n    /** Parámetros de ruta */\r\n    params?: Record<string, string>;\r\n\r\n    /** Extensiones custom */\r\n    extensions?: Record<string, unknown>;\r\n\r\n    /** Headers de respuesta iniciales */\r\n    responseHeaders?: HeadersInit;\r\n}\r\n\r\n// ============================================================================\r\n// Implementation\r\n// ============================================================================\r\n\r\n/**\r\n * Crea un ServerContext a partir de un Request\r\n * \r\n * @example\r\n * ```typescript\r\n * const ctx = createServerContext(request, { \r\n *   params: { id: '123' } \r\n * });\r\n * \r\n * // En un Server Component\r\n * async function UserPage(props, ctx: ServerContext) {\r\n *   const userId = ctx.params.id;\r\n *   const user = await db.users.get(userId);\r\n *   return <UserProfile user={user} />;\r\n * }\r\n * ```\r\n */\r\nexport function createServerContext(\r\n    request: Request,\r\n    options: ServerContextOptions = {}\r\n): ServerContext {\r\n    const { params = {}, extensions = {}, responseHeaders: initHeaders } = options;\r\n\r\n    // Parse URL\r\n    const url = new URL(request.url);\r\n\r\n    // Lazy cookie parsing\r\n    let parsedCookies: Record<string, string> | null = null;\r\n\r\n    const parseCookies = (): Record<string, string> => {\r\n        if (parsedCookies !== null) return parsedCookies;\r\n\r\n        parsedCookies = {};\r\n        const cookieHeader = request.headers.get('cookie');\r\n\r\n        if (cookieHeader) {\r\n            for (const cookie of cookieHeader.split(';')) {\r\n                const trimmed = cookie.trim();\r\n                const eqIndex = trimmed.indexOf('=');\r\n\r\n                if (eqIndex > 0) {\r\n                    const key = trimmed.slice(0, eqIndex).trim();\r\n                    const value = trimmed.slice(eqIndex + 1).trim();\r\n\r\n                    // Decode URL-encoded values\r\n                    try {\r\n                        parsedCookies[key] = decodeURIComponent(value);\r\n                    } catch {\r\n                        parsedCookies[key] = value;\r\n                    }\r\n                }\r\n            }\r\n        }\r\n\r\n        return parsedCookies;\r\n    };\r\n\r\n    // Cookie accessor\r\n    const cookies: CookieAccessor = {\r\n        get(name: string): string | undefined {\r\n            return parseCookies()[name];\r\n        },\r\n        getAll(): Readonly<Record<string, string>> {\r\n            return Object.freeze({ ...parseCookies() });\r\n        },\r\n        has(name: string): boolean {\r\n            return name in parseCookies();\r\n        },\r\n    };\r\n\r\n    // Extensions accessor\r\n    const contextExtensions: ContextExtensions = {\r\n        get<T>(key: string): T | undefined {\r\n            return extensions[key] as T | undefined;\r\n        },\r\n        has(key: string): boolean {\r\n            return key in extensions;\r\n        },\r\n    };\r\n\r\n    // Response headers (mutable)\r\n    const responseHeaders = new Headers(initHeaders);\r\n\r\n    return Object.freeze({\r\n        request,\r\n        params: Object.freeze({ ...params }),\r\n        searchParams: url.searchParams,\r\n        headers: request.headers,\r\n        cookies,\r\n        responseHeaders,\r\n        signal: request.signal,\r\n        url,\r\n        method: request.method,\r\n        extensions: contextExtensions,\r\n    });\r\n}\r\n\r\n// ============================================================================\r\n// Context Helpers\r\n// ============================================================================\r\n\r\n/**\r\n * Obtiene un header del request\r\n */\r\nexport function getHeader(ctx: ServerContext, name: string): string | null {\r\n    return ctx.headers.get(name);\r\n}\r\n\r\n/**\r\n * Obtiene todos los headers como objeto\r\n */\r\nexport function getHeaders(ctx: ServerContext): Record<string, string> {\r\n    const headers: Record<string, string> = {};\r\n    ctx.headers.forEach((value, key) => {\r\n        headers[key] = value;\r\n    });\r\n    return headers;\r\n}\r\n\r\n/**\r\n * Verifica si el request es un POST/PUT/PATCH/DELETE (mutation request)\r\n */\r\nexport function isMutationRequest(ctx: ServerContext): boolean {\r\n    return ['POST', 'PUT', 'PATCH', 'DELETE'].includes(ctx.method);\r\n}\r\n\r\n/**\r\n * Verifica si el request acepta JSON\r\n */\r\nexport function acceptsJson(ctx: ServerContext): boolean {\r\n    const accept = ctx.headers.get('accept') || '';\r\n    return accept.includes('application/json') || accept.includes('*/*');\r\n}\r\n\r\n/**\r\n * Verifica si el request es AJAX/fetch\r\n */\r\nexport function isAjaxRequest(ctx: ServerContext): boolean {\r\n    return ctx.headers.get('x-requested-with')?.toLowerCase() === 'xmlhttprequest' ||\r\n        ctx.headers.has('x-flight-action');\r\n}\r\n\r\n/**\r\n * Verifica si el request viene de un bot\r\n */\r\nexport function isBotRequest(ctx: ServerContext): boolean {\r\n    const ua = ctx.headers.get('user-agent')?.toLowerCase() || '';\r\n    const botPatterns = [\r\n        'bot', 'crawler', 'spider', 'scraper',\r\n        'googlebot', 'bingbot', 'yandexbot', 'duckduckbot',\r\n        'slurp', 'baiduspider', 'facebookexternalhit',\r\n        'twitterbot', 'linkedinbot', 'embedly', 'quora',\r\n        'outbrain', 'pinterest', 'slack', 'vkshare',\r\n        'w3c_validator', 'lighthouse', 'pagespeed',\r\n    ];\r\n    return botPatterns.some(pattern => ua.includes(pattern));\r\n}\r\n\r\n/**\r\n * Verifica si el cliente soporta streaming\r\n */\r\nexport function supportsStreaming(ctx: ServerContext): boolean {\r\n    // Check for no-stream preference\r\n    const noStream = ctx.searchParams.get('_nostream');\r\n    if (noStream === '1' || noStream === 'true') return false;\r\n\r\n    // Bots typically don't support streaming well\r\n    if (isBotRequest(ctx)) return false;\r\n\r\n    // Check for slow connection hints\r\n    const connection = ctx.headers.get('downlink') || ctx.headers.get('ect');\r\n    if (connection === 'slow-2g' || connection === '2g') return false;\r\n\r\n    return true;\r\n}\r\n\r\n/**\r\n * Obtiene el idioma preferido del cliente\r\n */\r\nexport function getPreferredLanguage(ctx: ServerContext, available: string[]): string | undefined {\r\n    const acceptLang = ctx.headers.get('accept-language');\r\n    if (!acceptLang) return available[0];\r\n\r\n    // Parse Accept-Language header\r\n    const languages = acceptLang\r\n        .split(',')\r\n        .map(lang => {\r\n            const [code, q = 'q=1'] = lang.trim().split(';');\r\n            const quality = parseFloat(q.replace('q=', '')) || 1;\r\n            return { code: code!.trim().toLowerCase(), quality };\r\n        })\r\n        .sort((a, b) => b.quality - a.quality);\r\n\r\n    // Find best match\r\n    for (const { code } of languages) {\r\n        // Exact match\r\n        const exact = available.find(a => a.toLowerCase() === code);\r\n        if (exact) return exact;\r\n\r\n        // Language-only match (e.g., 'es' matches 'es-AR')\r\n        const baseCode = code.split('-')[0];\r\n        const partial = available.find(a => a.toLowerCase().startsWith(baseCode!));\r\n        if (partial) return partial;\r\n    }\r\n\r\n    return available[0];\r\n}\r\n\r\n// ============================================================================\r\n// Response Helpers\r\n// ============================================================================\r\n\r\n/**\r\n * Sets a cookie in the response\r\n */\r\nexport function setCookie(\r\n    ctx: ServerContext,\r\n    name: string,\r\n    value: string,\r\n    options: CookieOptions = {}\r\n): void {\r\n    const parts = [`${encodeURIComponent(name)}=${encodeURIComponent(value)}`];\r\n\r\n    if (options.maxAge !== undefined) {\r\n        parts.push(`Max-Age=${options.maxAge}`);\r\n    }\r\n    if (options.expires) {\r\n        parts.push(`Expires=${options.expires.toUTCString()}`);\r\n    }\r\n    if (options.path) {\r\n        parts.push(`Path=${options.path}`);\r\n    }\r\n    if (options.domain) {\r\n        parts.push(`Domain=${options.domain}`);\r\n    }\r\n    if (options.secure) {\r\n        parts.push('Secure');\r\n    }\r\n    if (options.httpOnly) {\r\n        parts.push('HttpOnly');\r\n    }\r\n    if (options.sameSite) {\r\n        parts.push(`SameSite=${options.sameSite}`);\r\n    }\r\n\r\n    ctx.responseHeaders.append('Set-Cookie', parts.join('; '));\r\n}\r\n\r\n/**\r\n * Deletes a cookie\r\n */\r\nexport function deleteCookie(ctx: ServerContext, name: string, options: Pick<CookieOptions, 'path' | 'domain'> = {}): void {\r\n    setCookie(ctx, name, '', {\r\n        ...options,\r\n        maxAge: 0,\r\n        expires: new Date(0),\r\n    });\r\n}\r\n\r\n/**\r\n * Cookie options\r\n */\r\nexport interface CookieOptions {\r\n    /** Max age in seconds */\r\n    maxAge?: number;\r\n    /** Expiration date */\r\n    expires?: Date;\r\n    /** Cookie path */\r\n    path?: string;\r\n    /** Cookie domain */\r\n    domain?: string;\r\n    /** HTTPS only */\r\n    secure?: boolean;\r\n    /** Not accessible via JavaScript */\r\n    httpOnly?: boolean;\r\n    /** SameSite attribute */\r\n    sameSite?: 'Strict' | 'Lax' | 'None';\r\n}\r\n\r\n/**\r\n * Sets cache control headers\r\n */\r\nexport function setCacheControl(ctx: ServerContext, options: CacheControlOptions): void {\r\n    const parts: string[] = [];\r\n\r\n    if (options.public) parts.push('public');\r\n    if (options.private) parts.push('private');\r\n    if (options.noCache) parts.push('no-cache');\r\n    if (options.noStore) parts.push('no-store');\r\n    if (options.maxAge !== undefined) parts.push(`max-age=${options.maxAge}`);\r\n    if (options.sMaxAge !== undefined) parts.push(`s-maxage=${options.sMaxAge}`);\r\n    if (options.staleWhileRevalidate !== undefined) {\r\n        parts.push(`stale-while-revalidate=${options.staleWhileRevalidate}`);\r\n    }\r\n    if (options.staleIfError !== undefined) {\r\n        parts.push(`stale-if-error=${options.staleIfError}`);\r\n    }\r\n    if (options.mustRevalidate) parts.push('must-revalidate');\r\n    if (options.immutable) parts.push('immutable');\r\n\r\n    ctx.responseHeaders.set('Cache-Control', parts.join(', '));\r\n}\r\n\r\n/**\r\n * Cache control options\r\n */\r\nexport interface CacheControlOptions {\r\n    public?: boolean;\r\n    private?: boolean;\r\n    noCache?: boolean;\r\n    noStore?: boolean;\r\n    maxAge?: number;\r\n    sMaxAge?: number;\r\n    staleWhileRevalidate?: number;\r\n    staleIfError?: number;\r\n    mustRevalidate?: boolean;\r\n    immutable?: boolean;\r\n}\r\n\r\n// ============================================================================\r\n// Error Helpers\r\n// ============================================================================\r\n\r\n/**\r\n * Not found error - triggers 404 handling\r\n */\r\nexport function notFound(message = 'Not Found'): never {\r\n    const error = new Error(message) as Error & { __flight_not_found: true };\r\n    error.__flight_not_found = true;\r\n    throw error;\r\n}\r\n\r\n/**\r\n * Check if error is a not found error\r\n */\r\nexport function isNotFoundError(error: unknown): boolean {\r\n    return error instanceof Error && '__flight_not_found' in error;\r\n}\r\n\r\n/**\r\n * Redirect error - triggers redirect handling\r\n */\r\nexport function redirect(url: string, status: 301 | 302 | 303 | 307 | 308 = 307): never {\r\n    const error = new Error(`Redirect: ${url}`) as Error & {\r\n        __flight_redirect: { url: string; status: number }\r\n    };\r\n    error.__flight_redirect = { url, status };\r\n    throw error;\r\n}\r\n\r\n/**\r\n * Check if error is a redirect error\r\n */\r\nexport function isRedirectError(error: unknown): error is Error & {\r\n    __flight_redirect: { url: string; status: number }\r\n} {\r\n    return error instanceof Error && '__flight_redirect' in error;\r\n}\r\n\r\n/**\r\n * Get redirect info from error\r\n */\r\nexport function getRedirectInfo(error: Error & { __flight_redirect: { url: string; status: number } }): { url: string; status: number } {\r\n    return error.__flight_redirect;\r\n}\r\n"]}

package/dist/chunk-63SCEXD7.js

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

package/dist/chunk-63SCEXD7.js.map

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

package/dist/chunk-6BDCTUQY.js

@@ -0,0 +1,282 @@
+import { createStreamingSSR } from './chunk-RSVA2EYO.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-6BDCTUQY.js.map
+//# sourceMappingURL=chunk-6BDCTUQY.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/streaming/observability.ts"],"names":[],"mappings":"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","file":"chunk-6BDCTUQY.js","sourcesContent":["/**\r\n * @flight-framework/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 '@flight-framework/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-6CD5FIYI.js

@@ -0,0 +1,252 @@
+// src/rsc/adapters/solid.ts
+var CLIENT_REFERENCE = /* @__PURE__ */ Symbol.for("flight.client.reference");
+function createSolidAdapter(deps) {
+  const { solid, web } = deps || {};
+  return {
+    name: "solid",
+    isElement(value) {
+      if (value === null || typeof value !== "object") {
+        return false;
+      }
+      const el = value;
+      if ("t" in el && ("p" in el || el.p === null)) {
+        return true;
+      }
+      if (typeof value === "function") {
+        return true;
+      }
+      return false;
+    },
+    getElementType(element) {
+      if (typeof element === "function") {
+        const fn = element;
+        return {
+          kind: "component",
+          fn,
+          name: fn.displayName || fn.name || "SolidComponent"
+        };
+      }
+      const el = element;
+      const type = el.t;
+      if (typeof type === "string") {
+        return { kind: "host", tag: type };
+      }
+      if (typeof type === "function") {
+        const fn = type;
+        if (solid) {
+          if (type === solid.For) {
+            return { kind: "fragment" };
+          }
+          if (type === solid.Show) {
+            return { kind: "fragment" };
+          }
+          if (type === solid.Suspense) {
+            return {
+              kind: "suspense",
+              fallback: el.p?.fallback
+            };
+          }
+        }
+        return {
+          kind: "component",
+          fn,
+          name: fn.displayName || fn.name || "Component"
+        };
+      }
+      if (typeof type === "symbol") {
+        return { kind: "fragment" };
+      }
+      return { kind: "null" };
+    },
+    getProps(element) {
+      if (typeof element === "function") {
+        return {};
+      }
+      return element.p || {};
+    },
+    getChildren(element) {
+      if (typeof element === "function") {
+        return [];
+      }
+      const props = element.p;
+      const children = props?.children;
+      if (children === void 0 || children === null) {
+        return [];
+      }
+      if (typeof children === "function") {
+        if (web?.isServer) {
+          try {
+            const result = children();
+            if (Array.isArray(result)) {
+              return result;
+            }
+            return [result];
+          } catch {
+            return [];
+          }
+        }
+        return [children];
+      }
+      if (Array.isArray(children)) {
+        return children.flat();
+      }
+      return [children];
+    },
+    getKey(element) {
+      if (typeof element === "function") {
+        return void 0;
+      }
+      const ref = element.r;
+      if (typeof ref === "string" || typeof ref === "number") {
+        return ref;
+      }
+      return void 0;
+    },
+    isClientBoundary(component) {
+      if (typeof component !== "function" && typeof component !== "object") {
+        return false;
+      }
+      const comp = component;
+      if (comp.__flight_client === true) return true;
+      if (comp.$$typeof === CLIENT_REFERENCE) return true;
+      return false;
+    },
+    async renderToString(element) {
+      if (web?.renderToStringAsync) {
+        return web.renderToStringAsync(() => element);
+      }
+      if (web?.renderToString) {
+        return web.renderToString(() => element);
+      }
+      throw new Error(
+        "renderToString not provided. Pass solid-js/web when creating the adapter: createSolidAdapter({ solid, web })"
+      );
+    }
+  };
+}
+function createSolidConsumer(deps, options = {}) {
+  const { solid, web } = deps;
+  const { registry = /* @__PURE__ */ new Map() } = options;
+  return {
+    /**
+     * Register a client component
+     */
+    register(id, loader) {
+      registry.set(id, loader);
+    },
+    /**
+     * Convert Flight elements to Solid JSX
+     */
+    toSolidElement(element) {
+      switch (element.$$type) {
+        case "null":
+          return null;
+        case "text":
+          return element.value;
+        case "host": {
+          const children = element.children.map((c) => this.toSolidElement(c));
+          return {
+            t: element.tag,
+            p: { ...element.props, children },
+            r: element.key
+          };
+        }
+        case "fragment": {
+          const children = element.children.map((c) => this.toSolidElement(c));
+          return children;
+        }
+        case "suspense": {
+          if (solid?.Suspense) {
+            const fallback = this.toSolidElement(element.fallback);
+            const children = element.children.map((c) => this.toSolidElement(c));
+            return {
+              t: solid.Suspense,
+              p: { fallback: () => fallback, children: () => children }
+            };
+          }
+          return element.children.map((c) => this.toSolidElement(c));
+        }
+        case "client": {
+          const loader = registry.get(element.ref);
+          if (!loader) {
+            console.warn(`[Flight] Client component not registered: ${element.ref}`);
+            if (element.ssr) {
+              return {
+                t: "div",
+                p: { innerHTML: element.ssr }
+              };
+            }
+            return null;
+          }
+          const LazyComponent = async () => {
+            const mod = await loader();
+            return mod.default ?? mod;
+          };
+          if (solid?.Suspense) {
+            return {
+              t: solid.Suspense,
+              p: {
+                fallback: () => element.ssr ? { t: "div", p: { innerHTML: element.ssr } } : null,
+                children: LazyComponent
+              }
+            };
+          }
+          return { t: LazyComponent, p: {} };
+        }
+        case "lazy": {
+          if (element.fallback) {
+            return this.toSolidElement(element.fallback);
+          }
+          return {
+            t: "div",
+            p: { "data-flight-pending": element.id }
+          };
+        }
+        default:
+          return null;
+      }
+    },
+    /**
+     * Hydrate Flight payload into DOM
+     */
+    hydrate(chunks, container) {
+      const rootChunk = chunks.find((c) => c.type === "S" && c.id === "root");
+      if (!rootChunk || rootChunk.type !== "S") {
+        throw new Error("[Flight] No root chunk found");
+      }
+      for (const chunk of chunks) {
+        if (chunk.type === "C") {
+          if (!registry.has(chunk.id)) {
+            registry.set(chunk.id, () => import(
+              /* webpackIgnore: true */
+              chunk.module
+            ));
+          }
+        }
+      }
+      const element = this.toSolidElement(rootChunk.tree);
+      if (web?.hydrate) {
+        return web.hydrate(() => element, container);
+      }
+      if (web?.render) {
+        return web.render(() => element, container);
+      }
+      throw new Error("[Flight] Solid web.hydrate or web.render not provided");
+    }
+  };
+}
+function markAsSolidClientComponent(component, moduleId, exportName = "default") {
+  const marked = component;
+  marked.$$typeof = CLIENT_REFERENCE;
+  marked.__flight_client = true;
+  marked.__flight_module = moduleId;
+  marked.__flight_export = exportName;
+  return marked;
+}
+function isServer(deps) {
+  return deps?.web?.isServer ?? typeof window === "undefined";
+}
+
+export { createSolidAdapter, createSolidConsumer, isServer, markAsSolidClientComponent };
+//# sourceMappingURL=chunk-6CD5FIYI.js.map
+//# sourceMappingURL=chunk-6CD5FIYI.js.map