@flight-framework/core 0.2.6 → 0.3.0

package/dist/chunk-YNTMYL36.js.map

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

package/dist/config/index.js

@@ -1,3 +1,3 @@
-export { defineConfig, findConfigFile, loadConfig, resolveConfig } from '../chunk-IXMD5QH2.js';
+export { defineConfig, findConfigFile, loadConfig, resolveConfig } from '../chunk-EHVUAFNH.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/errors/index.js

@@ -1,4 +1,4 @@
-export { BadRequestError, FlightError, ForbiddenError, InternalError, NotFoundError, UnauthorizedError, clearError, createError, createErrorResponse, forbidden, getError, getErrorStatusCode, isFlightError, isForbiddenError, isNotFoundError, isUnauthorizedError, notFound, showError, unauthorized, wrapWithDigest } from '../chunk-FSJNOPYE.js';
-import '../chunk-YHEVHRLH.js';
+export { BadRequestError, FlightError, ForbiddenError, InternalError, NotFoundError, UnauthorizedError, clearError, createError, createErrorResponse, forbidden, getError, getErrorStatusCode, isFlightError, isForbiddenError, isNotFoundError, isUnauthorizedError, notFound, showError, unauthorized, wrapWithDigest } from '../chunk-2JVEH76V.js';
+import '../chunk-OZBPR27I.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/file-router/index.js

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

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

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

package/dist/handlers/index.js

@@ -1,3 +1,3 @@
-export { createRouteContext, error, json, parseBody, redirect } from '../chunk-W6D62JCI.js';
+export { createRouteContext, error, json, parseBody, redirect } from '../chunk-A4TKWQBU.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js

@@ -1,36 +1,36 @@
-export { MetricsAggregator, createHttpObserver, createInstrumentedStream, createLoggerObserver } from './chunk-6BDCTUQY.js';
-export { DEFAULT_BOT_PATTERNS, addStreamingHeaders, createConditionalStreamer, createStreamingResponse as createConditionalStreamingResponse, createStaticResponse, isBot, isSlowConnection, prefersNoStream, streamIf, supportsStreaming } from './chunk-XOIYNY4I.js';
-export { createHTMXStreamAdapter, createReactStreamAdapter, createSolidStreamAdapter, createStreamAdapter, createSvelteStreamAdapter, createVueStreamAdapter } from './chunk-MQQLYWZZ.js';
-export { createIslandRegistry, createPreactIslandAdapter, createReactIslandAdapter, createSolidIslandAdapter, createVueIslandAdapter, defineIsland, hydrateIslands, registerFlightIslandElement, registerIsland, renderIsland, renderIslands, setIslandAdapter } from './chunk-WFAWAHJH.js';
-export { DEFAULT_STREAMING_HINTS, createStreamingController, generateCacheKey, getStreamingCacheHeaders, hasStreamingConfig, isValidStreamingHints, loadRouteWithStreaming, resolveStreamingConfig, shouldStream } from './chunk-XSY5AAXT.js';
-export { streamWithPriority, validateDependencies } from './chunk-WOEIJWGJ.js';
-import './chunk-SUILH4ID.js';
-export { createServer } from './chunk-LBYDTULN.js';
-export { defineConfig } from './chunk-IXMD5QH2.js';
-export { createFileRouter, loadRoutes, scanRoutes } from './chunk-54HPVE7N.js';
-export { RedirectError, redirect as actionRedirect, cookies, executeAction, executeFormAction, getAction, handleActionRequest, isRedirectError, parseFormData, registerAction } from './chunk-3QP3E7HS.js';
-export { createRouteContext, error, json, parseBody, redirect } from './chunk-W6D62JCI.js';
-export { createLazyContent, createStreamingResponse, createStreamingSSR, renderWithStreaming, streamParallel, streamSequential } from './chunk-RSVA2EYO.js';
+export { MetricsAggregator, createHttpObserver, createInstrumentedStream, createLoggerObserver } from './chunk-YNTMYL36.js';
+export { DEFAULT_BOT_PATTERNS, addStreamingHeaders, createConditionalStreamer, createStreamingResponse as createConditionalStreamingResponse, createStaticResponse, isBot, isSlowConnection, prefersNoStream, streamIf, supportsStreaming } from './chunk-VNO2YUVD.js';
+export { createHTMXStreamAdapter, createReactStreamAdapter, createSolidStreamAdapter, createStreamAdapter, createSvelteStreamAdapter, createVueStreamAdapter } from './chunk-GNS2FGPC.js';
+export { createIslandRegistry, createPreactIslandAdapter, createReactIslandAdapter, createSolidIslandAdapter, createVueIslandAdapter, defineIsland, hydrateIslands, registerFlightIslandElement, registerIsland, renderIsland, renderIslands, setIslandAdapter } from './chunk-UFWGOJL7.js';
+export { DEFAULT_STREAMING_HINTS, createStreamingController, generateCacheKey, getStreamingCacheHeaders, hasStreamingConfig, isValidStreamingHints, loadRouteWithStreaming, resolveStreamingConfig, shouldStream } from './chunk-PO7IHPFF.js';
+export { streamWithPriority, validateDependencies } from './chunk-NZS2YJ43.js';
+import './chunk-QK6UEQ75.js';
+export { createServer } from './chunk-UL4Q5CIJ.js';
+export { defineConfig } from './chunk-EHVUAFNH.js';
+export { createFileRouter, loadRoutes, scanRoutes } from './chunk-UGTETAJ2.js';
+export { RedirectError, redirect as actionRedirect, cookies, executeAction, executeFormAction, getAction, handleActionRequest, isRedirectError, parseFormData, registerAction } from './chunk-OZ3EXPLE.js';
+export { createRouteContext, error, json, parseBody, redirect } from './chunk-A4TKWQBU.js';
+export { createLazyContent, createStreamingResponse, createStreamingSSR, renderWithStreaming, streamParallel, streamSequential } from './chunk-CNY3ZUVG.js';
 import './chunk-63SCEXD7.js';
-export { createServerContext, isNotFoundError, isRedirectError as isRscRedirectError, notFound, redirect as rscRedirect } from './chunk-62C7LX2E.js';
-import './chunk-PVUMB632.js';
-import './chunk-P6WSBVDT.js';
-import './chunk-K2CQZPCG.js';
-export { composeComponents, createAsyncComponent, createClientBoundary, createRenderContext, deserializeProps, executeServerComponent, revalidatePath as rscRevalidatePath, revalidateTag as rscRevalidateTag, serializeProps, serverFetch, withErrorBoundary } from './chunk-3ZSSRE6M.js';
-import './chunk-ZIE56LCA.js';
-export { detectBoundaryType, hasUseClientDirective, hasUseServerDirective } from './chunk-PDW5WCMW.js';
+export { createServerContext, isNotFoundError, isRedirectError as isRscRedirectError, notFound, redirect as rscRedirect } from './chunk-CKJHJPKQ.js';
+import './chunk-A2QRUBVE.js';
+import './chunk-FRAH5QNY.js';
+import './chunk-6GI6HFSQ.js';
+export { composeComponents, createAsyncComponent, createClientBoundary, createRenderContext, deserializeProps, executeServerComponent, revalidatePath as rscRevalidatePath, revalidateTag as rscRevalidateTag, serializeProps, serverFetch, withErrorBoundary } from './chunk-2R23X5Z3.js';
+import './chunk-XU6MRYG2.js';
+export { detectBoundaryType, hasUseClientDirective, hasUseServerDirective } from './chunk-5XHOLZBJ.js';
 import './chunk-Y22AMGTM.js';
-import './chunk-TASAT7KB.js';
-import './chunk-2F2QU6RC.js';
-import './chunk-VPFMHGEV.js';
-import './chunk-MDQNNIHH.js';
-export { BadRequestError, FlightError, ForbiddenError, InternalError, NotFoundError, UnauthorizedError, clearError, createError, createErrorResponse, forbidden as createForbidden, notFound as createNotFound, unauthorized as createUnauthorized, getError, getErrorStatusCode, isFlightError, isForbiddenError as isForbidden, isNotFoundError as isNotFound, isUnauthorizedError as isUnauthorized, showError, wrapWithDigest } from './chunk-FSJNOPYE.js';
+import './chunk-HNPO6LFW.js';
+import './chunk-3UQJE3XZ.js';
+import './chunk-3N5ZBVZJ.js';
+import './chunk-65JYF3DJ.js';
+export { BadRequestError, FlightError, ForbiddenError, InternalError, NotFoundError, UnauthorizedError, clearError, createError, createErrorResponse, forbidden as createForbidden, notFound as createNotFound, unauthorized as createUnauthorized, getError, getErrorStatusCode, isFlightError, isForbiddenError as isForbidden, isNotFoundError as isNotFound, isUnauthorizedError as isUnauthorized, showError, wrapWithDigest } from './chunk-2JVEH76V.js';
 import './chunk-PL37KFRJ.js';
-export { getEnvironment, isBrowser, isDevelopment, isProduction, isServer, isTest } from './chunk-YHEVHRLH.js';
-export { createRouter } from './chunk-GCQZ4FHI.js';
-import './chunk-ZVC3ZWLM.js';
-export { cacheKey, cached, createCache, dedupe, jsonSerializer, memory } from './chunk-R7SQAREQ.js';
-export { createMiddlewareChain } from './chunk-KWFX6WHG.js';
+export { getEnvironment, isBrowser, isDevelopment, isProduction, isServer, isTest } from './chunk-OZBPR27I.js';
+export { createRouter } from './chunk-ARBKF6VI.js';
+import './chunk-B2LPSCES.js';
+export { cacheKey, cached, createCache, dedupe, jsonSerializer, memory } from './chunk-LKOPJ3GS.js';
+export { createMiddlewareChain } from './chunk-JFUKVWSO.js';
 import { promises } from 'fs';
 import { dirname, join } from 'path';