@timber-js/app 0.2.0-alpha.21 → 0.2.0-alpha.211

package/dist/adapters/nitro.js.map

@@ -1 +1 @@
-{"version":3,"file":"nitro.js","names":[],"sources":["../../src/adapters/compress-module.ts","../../src/adapters/nitro.ts"],"sourcesContent":["// Generated compression module template for self-hosted deployments.\n//\n// This file generates a standalone ESM module (_compress.mjs) that is\n// written to the build output during adapter buildOutput(). It's imported\n// by the Nitro entry and preview server at runtime.\n//\n// Uses CompressionStream (Web API) for gzip. Brotli is left to CDNs/reverse\n// proxies — at streaming quality levels its ratio advantage is marginal and\n// node:zlib buffers output internally, breaking streaming.\n// Cloudflare Workers don't need this — the edge auto-compresses.\n//\n// See design/25-production-deployments.md.\n\n/**\n * Generate a standalone ESM module that exports compressResponse().\n *\n * Written to `_compress.mjs` during buildOutput. Imported by the Nitro entry\n * and preview server.\n *\n * @internal Exported for testing.\n */\nexport function generateCompressModule(): string {\n  return `// Generated by @timber-js/app — response compression for self-hosted deployments.\n// Do not edit — this file is regenerated on each build.\n// Uses CompressionStream (Web API) for gzip. Brotli is left to CDNs/reverse\n// proxies — at streaming quality levels its ratio advantage is marginal and\n// node:zlib buffers output internally, breaking streaming.\n\nconst COMPRESSIBLE_TYPES = new Set([\n  'text/html', 'text/css', 'text/plain', 'text/xml', 'text/javascript',\n  'text/x-component', 'application/json', 'application/javascript',\n  'application/xml', 'application/xhtml+xml', 'application/rss+xml',\n  'application/atom+xml', 'image/svg+xml',\n]);\n\nconst NO_COMPRESS_STATUSES = new Set([204, 304]);\n\nfunction negotiateEncoding(acceptEncoding) {\n  if (!acceptEncoding) return null;\n  // Parse tokens with quality values. Per RFC 9110 §12.5.3, q=0 means\n  // \"not acceptable\" — the client explicitly rejects that encoding.\n  // Brotli (br) is intentionally not handled at the application level.\n  const parts = acceptEncoding.split(',');\n  for (const part of parts) {\n    const [token, ...params] = part.split(';');\n    const name = token.trim().toLowerCase();\n    if (name !== 'gzip') continue;\n    let qValue = 1;\n    for (const param of params) {\n      const trimmed = param.trim().toLowerCase();\n      if (trimmed.startsWith('q=')) {\n        qValue = parseFloat(trimmed.slice(2));\n        if (Number.isNaN(qValue)) qValue = 1;\n        break;\n      }\n    }\n    if (qValue > 0) return 'gzip';\n  }\n  return null;\n}\n\nfunction shouldCompress(response) {\n  if (!response.body) return false;\n  if (NO_COMPRESS_STATUSES.has(response.status)) return false;\n  if (response.headers.has('Content-Encoding')) return false;\n  const contentType = response.headers.get('Content-Type');\n  if (!contentType) return false;\n  const mimeType = contentType.split(';')[0].trim().toLowerCase();\n  if (mimeType === 'text/event-stream') return false;\n  return COMPRESSIBLE_TYPES.has(mimeType);\n}\n\nfunction compressWithGzip(body) {\n  return body.pipeThrough(new CompressionStream('gzip'));\n}\n\nexport function compressResponse(request, response) {\n  if (!shouldCompress(response)) return response;\n  const acceptEncoding = request.headers.get('Accept-Encoding') || '';\n  const encoding = negotiateEncoding(acceptEncoding);\n  if (!encoding) return response;\n  const compressedBody = compressWithGzip(response.body);\n  const headers = new Headers(response.headers);\n  headers.set('Content-Encoding', encoding);\n  headers.delete('Content-Length');\n  const existingVary = headers.get('Vary');\n  if (existingVary) {\n    if (!existingVary.toLowerCase().includes('accept-encoding')) {\n      headers.set('Vary', existingVary + ', Accept-Encoding');\n    }\n  } else {\n    headers.set('Vary', 'Accept-Encoding');\n  }\n  return new Response(compressedBody, {\n    status: response.status,\n    statusText: response.statusText,\n    headers,\n  });\n}\n`;\n}\n","// Nitro adapter — multi-platform deployment\n//\n// Covers everything except Cloudflare Workers: Node.js, Bun, Vercel,\n// Netlify, AWS Lambda, Deno Deploy, Azure Functions. Nitro handles\n// compression, graceful shutdown, static file serving, and platform quirks.\n// See design/11-platform.md and design/25-production-deployments.md.\n\nimport { writeFile, readFile, mkdir, cp } from 'node:fs/promises';\nimport { execFile } from 'node:child_process';\nimport { join, relative } from 'node:path';\nimport type { TimberPlatformAdapter, TimberConfig } from './types';\nimport { generateCompressModule } from './compress-module.js';\n// Inlined from server/asset-headers.ts — adapters are loaded by Node at\n// Vite startup time, before Vite's module resolver is available, so cross-\n// directory .ts imports don't resolve.\nconst IMMUTABLE_CACHE = 'public, max-age=31536000, immutable';\nconst STATIC_CACHE = 'public, max-age=3600, must-revalidate';\n\nfunction generateHeadersFile(): string {\n  return `# Auto-generated by @timber-js/app — static asset cache headers.\n# See design/25-production-deployments.md §\"CDN / Edge Cache\"\n\n/assets/*\n  Cache-Control: ${IMMUTABLE_CACHE}\n\n/*\n  Cache-Control: ${STATIC_CACHE}\n`;\n}\n\n// ─── Presets ─────────────────────────────────────────────────────────────────\n\n/**\n * Supported Nitro deployment presets.\n *\n * Each preset maps to a Nitro deployment target. The adapter generates\n * the appropriate configuration and entry point for the selected platform.\n */\nexport type NitroPreset =\n  | 'vercel'\n  | 'vercel-edge'\n  | 'netlify'\n  | 'netlify-edge'\n  | 'aws-lambda'\n  | 'deno-deploy'\n  | 'azure-functions'\n  | 'node-server'\n  | 'bun';\n\n/** Preset-specific Nitro configuration. */\ninterface PresetConfig {\n  /** Nitro preset name passed to the Nitro build. */\n  nitroPreset: string;\n  /** Output directory name within the build dir. */\n  outputDir: string;\n  /** Whether the runtime supports waitUntil. */\n  supportsWaitUntil: boolean;\n  /** Whether the runtime supports application-level 103 Early Hints. */\n  supportsEarlyHints: boolean;\n  /** Value for TIMBER_RUNTIME env var. See design/25-production-deployments.md. */\n  runtimeName: string;\n  /** Additional nitro.config fields for this preset. */\n  extraConfig?: Record<string, unknown>;\n}\n\nconst PRESET_CONFIGS: Record<NitroPreset, PresetConfig> = {\n  'vercel': {\n    nitroPreset: 'vercel',\n    outputDir: '.vercel/output',\n    supportsWaitUntil: true,\n    supportsEarlyHints: false,\n    runtimeName: 'vercel',\n    extraConfig: { vercel: { functions: { maxDuration: 30 } } },\n  },\n  'vercel-edge': {\n    nitroPreset: 'vercel-edge',\n    outputDir: '.vercel/output',\n    supportsWaitUntil: true,\n    supportsEarlyHints: false,\n    runtimeName: 'vercel-edge',\n  },\n  'netlify': {\n    nitroPreset: 'netlify',\n    outputDir: '.netlify/functions-internal',\n    supportsWaitUntil: false,\n    supportsEarlyHints: false,\n    runtimeName: 'netlify',\n  },\n  'netlify-edge': {\n    nitroPreset: 'netlify-edge',\n    outputDir: '.netlify/edge-functions',\n    supportsWaitUntil: true,\n    supportsEarlyHints: false,\n    runtimeName: 'netlify-edge',\n  },\n  'aws-lambda': {\n    nitroPreset: 'aws-lambda',\n    outputDir: '.output',\n    supportsWaitUntil: false,\n    supportsEarlyHints: false,\n    runtimeName: 'aws-lambda',\n  },\n  'deno-deploy': {\n    nitroPreset: 'deno-deploy',\n    outputDir: '.output',\n    supportsWaitUntil: true,\n    supportsEarlyHints: false,\n    runtimeName: 'deno-deploy',\n  },\n  'azure-functions': {\n    nitroPreset: 'azure-functions',\n    outputDir: '.output',\n    supportsWaitUntil: false,\n    supportsEarlyHints: false,\n    runtimeName: 'azure-functions',\n  },\n  'node-server': {\n    nitroPreset: 'node-server',\n    outputDir: '.output',\n    supportsWaitUntil: true,\n    // Disabled by default: most node-server deployments sit behind a\n    // reverse proxy (nginx, caddy, traefik) that doesn't support 103\n    // Early Hints over HTTP/1.1. Sending 103 causes nginx to intermittently\n    // treat the response as an error and retry after proxy_connect_timeout\n    // (~5s stalls on ~23% of requests). Link headers on the 200 response\n    // are the safe fallback — Cloudflare and other CDNs convert them to\n    // 103 automatically at the edge (over HTTP/2+ to the browser).\n    supportsEarlyHints: false,\n    runtimeName: 'node-server',\n  },\n  'bun': {\n    nitroPreset: 'bun',\n    outputDir: '.output',\n    supportsWaitUntil: true,\n    // Disabled for same reason as node-server — reverse proxies choke on 103.\n    // Link headers on the 200 response are converted to 103 by CDNs.\n    supportsEarlyHints: false,\n    runtimeName: 'bun',\n  },\n};\n\n// ─── Options ─────────────────────────────────────────────────────────────────\n\n/** Options for the Nitro adapter. */\nexport interface NitroAdapterOptions {\n  /**\n   * Deployment preset. Determines the target platform.\n   * @default 'node-server'\n   */\n  preset?: NitroPreset;\n\n  /**\n   * Enable application-level gzip compression for HTML and RSC responses.\n   *\n   * When `true` (default), the origin compresses responses using the Web\n   * `CompressionStream` API. This is useful for self-hosted deployments\n   * where no reverse proxy or CDN handles compression.\n   *\n   * Set to `false` when deploying behind a reverse proxy (nginx, caddy)\n   * or CDN (Cloudflare, Fastly, Vercel) that compresses at the edge.\n   * Disabling origin compression saves CPU on the Node.js event loop —\n   * compressing 1MB+ streaming HTML responses takes 10-15ms of main\n   * thread time per request, directly reducing throughput under load.\n   *\n   * @default true\n   */\n  compress?: boolean;\n\n  /**\n   * Additional Nitro configuration to merge into the generated config.\n   * Overrides default values for the selected preset.\n   */\n  nitroConfig?: Record<string, unknown>;\n}\n\n// ─── Adapter ─────────────────────────────────────────────────────────────────\n\n/**\n * Create a Nitro-based adapter for multi-platform deployment.\n *\n * Nitro abstracts deployment targets — the same timber.js app can deploy\n * to Vercel, Netlify, AWS, Deno Deploy, or Azure by changing the preset.\n *\n * @example\n * ```ts\n * import { nitro } from '@timber-js/app/adapters/nitro'\n *\n * export default {\n *   output: 'server',\n *   adapter: nitro({ preset: 'vercel' }),\n * }\n * ```\n */\nexport function nitro(options: NitroAdapterOptions = {}): TimberPlatformAdapter {\n  const preset = options.preset ?? 'node-server';\n  const compress = options.compress ?? true;\n  const presetConfig = PRESET_CONFIGS[preset];\n  const pendingPromises: Promise<unknown>[] = [];\n\n  return {\n    name: `nitro-${preset}`,\n\n    async buildOutput(config: TimberConfig, buildDir: string) {\n      const outDir = join(buildDir, 'nitro');\n      await mkdir(outDir, { recursive: true });\n\n      // Copy client assets to public directory.\n      // When client JavaScript is disabled, skip .js files — only CSS,\n      // fonts, images, and other static assets are needed.\n      const clientDir = join(buildDir, 'client');\n      const publicDir = join(outDir, 'public');\n      await mkdir(publicDir, { recursive: true });\n      await cp(clientDir, publicDir, {\n        recursive: true,\n        filter: config.clientJavascriptDisabled ? (src: string) => !src.endsWith('.js') : undefined,\n      }).catch(() => {\n        // Client dir may not exist when client JavaScript is disabled\n      });\n\n      // Write _headers file for platforms that support it (Netlify, etc.).\n      // See design/25-production-deployments.md §\"CDN / Edge Cache\"\n      await writeFile(join(publicDir, '_headers'), generateHeadersFile());\n\n      // Write the build manifest init module (if manifest data was produced).\n      if (config.manifestInit) {\n        await writeFile(join(outDir, '_timber-manifest-init.js'), config.manifestInit);\n      }\n\n      // Write the compression helper module for runtime use.\n      // See design/25-production-deployments.md — self-hosted deployments\n      // need application-level compression (Cloudflare handles it at the edge).\n      await writeFile(join(outDir, '_compress.mjs'), generateCompressModule());\n\n      // Copy rsc/ssr build output into the nitro dir so imports stay local\n      // during the Nitro bundling step (avoids broken relative paths in output).\n      await cp(join(buildDir, 'rsc'), join(outDir, 'rsc'), { recursive: true });\n      await cp(join(buildDir, 'ssr'), join(outDir, 'ssr'), { recursive: true }).catch(() => {});\n\n      // Prepend the manifest assignment directly into the RSC entry so\n      // globalThis.__TIMBER_BUILD_MANIFEST__ is set before any module reads it.\n      // This must be top-level code, not an import, because rollup tree-shakes\n      // side-effect-only globalThis assignments from imported modules.\n      if (config.manifestInit) {\n        const rscEntry = join(outDir, 'rsc', 'index.js');\n        const rscContent = await readFile(rscEntry, 'utf-8');\n        await writeFile(rscEntry, `${config.manifestInit}\\n${rscContent}`);\n      }\n\n      // Generate the Nitro entry point (imports from ./rsc/ within nitro dir)\n      const entry = generateNitroEntry(buildDir, outDir, preset, compress);\n      await writeFile(join(outDir, 'entry.ts'), entry);\n\n      // Run the Nitro build to produce a production-ready server bundle.\n      // The output goes to dist/nitro/.output/server/index.mjs (for node-server preset).\n      // Config is passed programmatically — no nitro.config.ts file needed.\n      await runNitroBuild(outDir, preset, options.nitroConfig);\n    },\n\n    // Only presets that produce a locally-runnable server get preview().\n    // Serverless presets (vercel, netlify, aws-lambda, etc.) have no\n    // local runtime — Vite's built-in preview is the fallback.\n    preview: LOCALLY_PREVIEWABLE.has(preset)\n      ? async (_config: TimberConfig, buildDir: string) => {\n          // Generate a standalone preview server that uses Node's built-in\n          // HTTP server. The Nitro entry.ts can't be run directly because\n          // it imports h3 (a Nitro dependency not available at runtime).\n          const previewScript = generatePreviewScript(buildDir, preset);\n          const scriptPath = join(buildDir, 'nitro', '_preview-server.mjs');\n          await writeFile(scriptPath, previewScript);\n\n          const command = preset === 'bun' ? 'bun' : 'node';\n          await spawnNitroPreview(command, [scriptPath], join(buildDir, 'nitro'));\n        }\n      : undefined,\n\n    waitUntil: presetConfig.supportsWaitUntil\n      ? (promise: Promise<unknown>) => {\n          const tracked = promise.catch((err) => {\n            console.error('[timber] waitUntil promise rejected:', err);\n          });\n          pendingPromises.push(tracked);\n        }\n      : undefined,\n  };\n}\n\n// ─── Entry Generation ────────────────────────────────────────────────────────\n\n/** @internal Exported for testing. */\nexport function generateNitroEntry(\n  buildDir: string,\n  outDir: string,\n  preset: NitroPreset,\n  compress = true,\n  hasManifestInit = false\n): string {\n  // The RSC entry is the main request handler — it exports the fetch handler as default.\n  // rsc/ is copied into the nitro dir so the import is local.\n  // The manifest init is prepended to rsc/index.js before the nitro build,\n  // so globalThis.__TIMBER_BUILD_MANIFEST__ is set before any code reads it.\n  const serverEntryRelative = './rsc/index.js';\n  const runtimeName = PRESET_CONFIGS[preset].runtimeName;\n  const earlyHints = PRESET_CONFIGS[preset].supportsEarlyHints;\n  const supportsWaitUntil = PRESET_CONFIGS[preset].supportsWaitUntil;\n\n  // On node-server and bun, wrap the handler with ALS so the pipeline\n  // can send 103 Early Hints via res.writeEarlyHints(). Other presets\n  // either don't support 103 or handle it at the CDN level.\n  //\n  // For presets that support waitUntil, bridge h3's event.waitUntil()\n  // to timber's waitUntil() primitive via the ALS bridge.\n  // See design/11-platform.md §\"waitUntil()\".\n  let handlerCall: string;\n  if (earlyHints && supportsWaitUntil) {\n    handlerCall = `  const nodeRes = event.node?.res\n  const earlyHintsSender = (typeof nodeRes?.writeEarlyHints === 'function')\n    ? (links) => { try { nodeRes.writeEarlyHints({ link: links }) } catch {} }\n    : undefined\n\n  const waitUntilFn = (typeof event.waitUntil === 'function')\n    ? (p) => event.waitUntil(p)\n    : undefined\n\n  const callHandler = () => handler(webRequest)\n  let wrappedHandler = earlyHintsSender\n    ? () => runWithEarlyHintsSender(earlyHintsSender, callHandler)\n    : callHandler\n  const webResponse = waitUntilFn\n    ? await runWithWaitUntil(waitUntilFn, wrappedHandler)\n    : await wrappedHandler()`;\n  } else if (earlyHints) {\n    handlerCall = `  const nodeRes = event.node?.res\n  const earlyHintsSender = (typeof nodeRes?.writeEarlyHints === 'function')\n    ? (links) => { try { nodeRes.writeEarlyHints({ link: links }) } catch {} }\n    : undefined\n\n  const webResponse = earlyHintsSender\n    ? await runWithEarlyHintsSender(earlyHintsSender, () => handler(webRequest))\n    : await handler(webRequest)`;\n  } else if (supportsWaitUntil) {\n    handlerCall = `  const waitUntilFn = (typeof event.waitUntil === 'function')\n    ? (p) => event.waitUntil(p)\n    : undefined\n\n  const webResponse = waitUntilFn\n    ? await runWithWaitUntil(waitUntilFn, () => handler(webRequest))\n    : await handler(webRequest)`;\n  } else {\n    handlerCall = `  const webResponse = await handler(webRequest)`;\n  }\n\n  // Build manifest init must be imported before the handler so that\n  // globalThis.__TIMBER_BUILD_MANIFEST__ is set when the virtual module evaluates.\n  // ESM guarantees imports are evaluated in order.\n  const manifestImport = hasManifestInit ? \"import './_timber-manifest-init.js'\\n\" : '';\n\n  // Import runWithWaitUntil only when the preset supports it.\n  const waitUntilImport = supportsWaitUntil ? ', runWithWaitUntil' : '';\n\n  const compressImport = compress ? \"import { compressResponse } from './_compress.mjs'\\n\" : '';\n  const compressCall = compress ? 'compressResponse(webRequest, webResponse)' : 'webResponse';\n\n  return `// Generated by @timber-js/app/adapters/nitro\n// Do not edit — this file is regenerated on each build.\n\n// Patch global Web Streams with fast-webstreams (backed by Node.js native streams).\n// Must run before ANY code creates ReadableStream/WritableStream/TransformStream.\n// React's RSC Flight streams, SSR output, .tee(), and all pipeThrough transforms\n// benefit: 3.8x faster reads, 11x faster transforms, 13x faster sequential tee.\n// See: https://github.com/vercel-labs/fast-webstreams\nimport { patchGlobalWebStreams } from 'experimental-fast-webstreams'\npatchGlobalWebStreams()\n\n${manifestImport}import handler, { runWithEarlyHintsSender${waitUntilImport} } from '${serverEntryRelative}'\n${compressImport}\n// Set TIMBER_RUNTIME for instrumentation.ts conditional SDK initialization.\n// See design/25-production-deployments.md §\"TIMBER_RUNTIME\".\nprocess.env.TIMBER_RUNTIME = '${runtimeName}'\n\n// Nitro's index.mjs wraps this import with defineLazyEventHandler, which\n// already handles the event handler protocol. We export a plain async\n// function — no defineEventHandler wrapper needed.\n// Nitro bundles h3 into its internal _libs/ directory but doesn't make\n// it available as a bare specifier in the output's node_modules.\nexport default async function timberHandler(event) {\n  // h3 v2: event.req is the Web Request\n  const webRequest = event.req\n${handlerCall}\n  return ${compressCall}\n}\n`;\n}\n\n/** @internal Exported for testing. */\nexport function generateNitroConfig(\n  preset: NitroPreset,\n  userConfig?: Record<string, unknown>\n): string {\n  const presetConfig = PRESET_CONFIGS[preset];\n\n  const config: Record<string, unknown> = {\n    preset: presetConfig.nitroPreset,\n    entry: './entry.ts',\n    output: { dir: presetConfig.outputDir },\n    // Static asset cache headers — hashed assets are immutable, others get 1h.\n    // See design/25-production-deployments.md §\"CDN / Edge Cache\"\n    routeRules: {\n      '/assets/**': { headers: { 'Cache-Control': IMMUTABLE_CACHE } },\n    },\n    ...presetConfig.extraConfig,\n    ...userConfig,\n  };\n\n  const configJson = JSON.stringify(config, null, 2);\n\n  return `// Generated by @timber-js/app/adapters/nitro\n// Do not edit — this file is regenerated on each build.\n\nimport { defineNitroConfig } from 'nitro/config'\n\nexport default defineNitroConfig(${configJson})\n`;\n}\n\n// ─── Preview ─────────────────────────────────────────────────────────────────\n\n/** Presets that produce a locally-runnable server entry. */\nconst LOCALLY_PREVIEWABLE = new Set<NitroPreset>(['node-server', 'bun']);\n\n/**\n * Generate a standalone preview server script that uses Node's built-in\n * HTTP server. This bypasses Nitro entirely — the Nitro entry.ts imports\n * h3 which isn't available outside a Nitro build. For local preview we\n * just need to serve static files and route requests to the RSC handler.\n *\n * @internal Exported for testing.\n */\nexport function generatePreviewScript(buildDir: string, preset: NitroPreset): string {\n  const rscEntryRelative = relative(join(buildDir, 'nitro'), join(buildDir, 'rsc', 'index.js'));\n  const rscEntry = rscEntryRelative.startsWith('.') ? rscEntryRelative : './' + rscEntryRelative;\n  const publicDir = './public';\n  const manifestInitPath = './_timber-manifest-init.js';\n  const runtimeName = PRESET_CONFIGS[preset].runtimeName;\n\n  return `// Generated by @timber-js/app — standalone preview server.\n// Uses Node's built-in HTTP server to serve static assets and route\n// dynamic requests through the RSC handler. No Nitro/h3 dependency.\n\n// Patch global Web Streams with fast-webstreams before any imports.\nimport { patchGlobalWebStreams } from 'experimental-fast-webstreams';\npatchGlobalWebStreams();\n\nimport { createServer } from 'node:http';\nimport { readFile, stat } from 'node:fs/promises';\nimport { join, extname } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { existsSync } from 'node:fs';\n\n// Set runtime before importing the handler.\nprocess.env.TIMBER_RUNTIME = '${runtimeName}';\n\n// Load the build manifest if it exists.\nconst __dirname = fileURLToPath(new URL('.', import.meta.url));\nconst manifestPath = join(__dirname, '${manifestInitPath}');\nif (existsSync(manifestPath)) {\n  await import('${manifestInitPath}');\n}\n\n// Import the RSC handler (default export is the fetch-like handler).\nconst { default: handler, runWithEarlyHintsSender } = await import('${rscEntry}');\n\n// Import compression helper for self-hosted response compression.\nconst { compressResponse } = await import('./_compress.mjs');\n\nconst MIME_TYPES = {\n  '.html': 'text/html',\n  '.js': 'application/javascript',\n  '.mjs': 'application/javascript',\n  '.css': 'text/css',\n  '.json': 'application/json',\n  '.png': 'image/png',\n  '.jpg': 'image/jpeg',\n  '.jpeg': 'image/jpeg',\n  '.gif': 'image/gif',\n  '.svg': 'image/svg+xml',\n  '.ico': 'image/x-icon',\n  '.woff': 'font/woff',\n  '.woff2': 'font/woff2',\n  '.ttf': 'font/ttf',\n  '.otf': 'font/otf',\n  '.webp': 'image/webp',\n  '.avif': 'image/avif',\n  '.webm': 'video/webm',\n  '.mp4': 'video/mp4',\n  '.txt': 'text/plain',\n  '.xml': 'application/xml',\n  '.wasm': 'application/wasm',\n};\n\nconst publicDir = join(__dirname, '${publicDir}');\nconst port = parseInt(process.env.PORT || '3000', 10);\nconst host = process.env.HOST || process.env.HOSTNAME || 'localhost';\n\nconst server = createServer(async (req, res) => {\n  const url = new URL(req.url || '/', \\`http://\\${host}:\\${port}\\`);\n\n  // Try serving static files from the public directory first.\n  const filePath = join(publicDir, url.pathname);\n  // Prevent path traversal.\n  if (filePath.startsWith(publicDir)) {\n    try {\n      const fileStat = await stat(filePath);\n      if (fileStat.isFile()) {\n        const ext = extname(filePath);\n        const contentType = MIME_TYPES[ext] || 'application/octet-stream';\n        const body = await readFile(filePath);\n        // Hashed assets get immutable cache, others get short cache.\n        const cacheControl = url.pathname.startsWith('/assets/')\n          ? 'public, max-age=31536000, immutable'\n          : 'public, max-age=3600, must-revalidate';\n        res.writeHead(200, {\n          'Content-Type': contentType,\n          'Content-Length': body.length,\n          'Cache-Control': cacheControl,\n        });\n        res.end(body);\n        return;\n      }\n    } catch {\n      // File not found — fall through to the RSC handler.\n    }\n  }\n\n  // Convert Node request to Web Request.\n  const headers = new Headers();\n  for (const [key, value] of Object.entries(req.headers)) {\n    if (value) {\n      if (Array.isArray(value)) {\n        for (const v of value) headers.append(key, v);\n      } else {\n        headers.set(key, value);\n      }\n    }\n  }\n\n  let body = undefined;\n  if (req.method !== 'GET' && req.method !== 'HEAD') {\n    body = await new Promise((resolve) => {\n      const chunks = [];\n      req.on('data', (chunk) => chunks.push(chunk));\n      req.on('end', () => resolve(Buffer.concat(chunks)));\n    });\n  }\n\n  const webRequest = new Request(url.href, {\n    method: req.method,\n    headers,\n    body,\n    duplex: body ? 'half' : undefined,\n  });\n\n  try {\n    // Support 103 Early Hints when available.\n    const earlyHintsSender = (typeof res.writeEarlyHints === 'function')\n      ? (links) => { try { res.writeEarlyHints({ link: links }); } catch {} }\n      : undefined;\n\n    const rawResponse = earlyHintsSender && runWithEarlyHintsSender\n      ? await runWithEarlyHintsSender(earlyHintsSender, () => handler(webRequest))\n      : await handler(webRequest);\n\n    // Compress the response for self-hosted deployments.\n    const webResponse = compressResponse(webRequest, rawResponse);\n\n    // Write the response back to the Node response.\n    res.writeHead(webResponse.status, Object.fromEntries(webResponse.headers.entries()));\n\n    if (webResponse.body) {\n      const reader = webResponse.body.getReader();\n      const pump = async () => {\n        while (true) {\n          const { done, value } = await reader.read();\n          if (done) { res.end(); return; }\n          res.write(value);\n        }\n      };\n      await pump();\n    } else {\n      res.end();\n    }\n  } catch (err) {\n    console.error('[timber preview] Request error:', err);\n    if (!res.headersSent) {\n      res.writeHead(500, { 'Content-Type': 'text/plain' });\n    }\n    res.end('Internal Server Error');\n  }\n});\n\nserver.listen(port, host, () => {\n  console.log();\n  console.log('  ⚡ timber preview server running at:');\n  console.log();\n  console.log(\\`    ➜  http://\\${host}:\\${port}\\`);\n  console.log();\n});\n`;\n}\n\n/** Command descriptor for Nitro preview — testable without spawning. */\nexport interface NitroPreviewCommand {\n  command: string;\n  args: string[];\n  cwd: string;\n}\n\n/** @internal Exported for testing. */\nexport function generateNitroPreviewCommand(\n  buildDir: string,\n  preset: NitroPreset\n): NitroPreviewCommand | null {\n  if (!LOCALLY_PREVIEWABLE.has(preset)) return null;\n\n  const nitroDir = join(buildDir, 'nitro');\n  const entryPath = join(nitroDir, 'entry.ts');\n\n  const command = preset === 'bun' ? 'bun' : 'node';\n  return {\n    command,\n    args: [entryPath],\n    cwd: nitroDir,\n  };\n}\n\n/**\n * Run the Nitro production build using the programmatic API.\n * Uses dynamic import so nitro is only loaded at build time.\n * Externalizes the timber RSC/SSR output — those files are pre-built\n * by timber and have internal references that nitro's bundler can't follow.\n */\nasync function runNitroBuild(\n  nitroDir: string,\n  preset: NitroPreset,\n  userConfig?: Record<string, unknown>\n): Promise<void> {\n  const presetConfig = PRESET_CONFIGS[preset];\n  const {\n    createNitro,\n    build: nitroBuild,\n    prepare,\n    copyPublicAssets,\n  } = await import('nitro/builder');\n\n  const nitro = await createNitro({\n    rootDir: nitroDir,\n    preset: presetConfig.nitroPreset,\n    // Use renderer.entry so Nitro wraps our handler with its server runtime\n    // (HTTP server, static file serving, graceful shutdown, etc.).\n    // Using `entry` directly would bypass the Nitro server runtime.\n    renderer: { handler: join(nitroDir, 'entry.ts') },\n    output: { dir: join(nitroDir, presetConfig.outputDir) },\n    routeRules: {\n      '/assets/**': { headers: { 'Cache-Control': IMMUTABLE_CACHE } },\n    },\n    // Don't bundle the timber RSC/SSR build output — it has its own\n    // internal file references that nitro's bundler can't follow.\n    // Mark them as external so rollup leaves the imports as-is.\n    rollupConfig: {\n      external: [/\\.\\.\\/rsc\\//],\n    },\n    ...presetConfig.extraConfig,\n    ...userConfig,\n  });\n\n  await prepare(nitro);\n  await copyPublicAssets(nitro);\n  await nitroBuild(nitro);\n  await nitro.close();\n}\n\n/** Spawn a Nitro preview process and pipe stdio. */\nfunction spawnNitroPreview(command: string, args: string[], cwd: string): Promise<void> {\n  return new Promise<void>((resolve, reject) => {\n    const child = execFile(command, args, { cwd }, (err) => {\n      if (err) reject(err);\n      else resolve();\n    });\n    child.stdout?.pipe(process.stdout);\n    child.stderr?.pipe(process.stderr);\n  });\n}\n\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\n/**\n * Get the preset configuration for a given preset name.\n * @internal Exported for testing.\n */\nexport function getPresetConfig(preset: NitroPreset): PresetConfig {\n  return PRESET_CONFIGS[preset];\n}\n"],"mappings":"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"}
+{"version":3,"file":"nitro.js","names":[],"sources":["../../src/adapters/compress-module.ts","../../src/adapters/canonicalize-module.ts","../../src/adapters/nitro-presets.ts","../../src/adapters/nitro-preview.ts","../../src/adapters/nitro.ts"],"sourcesContent":["// Compiles server/compress.ts into a standalone ESM module (_compress.mjs)\n// for self-hosted deployments. The adapter writes this to the build output\n// during buildOutput(). It's imported by the Nitro entry and preview server\n// at runtime.\n//\n// By compiling the actual TypeScript source rather than maintaining a\n// hand-written string template, any fix to server/compress.ts automatically\n// flows to the production module. See design/18-build-system.md (\"entry\n// modules are real TypeScript files, not codegen strings\").\n//\n// The transform strips types; it does NOT bundle. The emitted file sits\n// alone in the build output, so any import specifier that survives into it\n// is a module resolution failure at runtime on the deployed server. Shared\n// constants are therefore interpolated here — the same treatment the\n// Cloudflare worker template gives `RSC_KEY_HEADERS` — and anything else\n// that reaches the output as an import is rejected with a build error\n// rather than shipped.\n\nimport { transformWithOxc } from 'vite';\n// Vite's ?raw import embeds the file as a string at build time — works\n// in both dev (Vite resolves the TS source) and the published package\n// (the string is inlined into the compiled adapter entry).\nimport compressSource from '../server/compress.ts?raw';\nimport { RSC_CONTENT_TYPE } from '../shared/rsc-media-type.ts';\n\n/**\n * The one import `server/compress.ts` is allowed to carry, and its inlined\n * form.\n *\n * The binding list is matched exactly rather than as `{…}`. A second binding\n * added to that import would otherwise be erased along with the statement and\n * become a `ReferenceError` in the deployed `_compress.mjs` — the failure this\n * whole module exists to make impossible. Matching exactly means such an\n * import falls through to the rejection below instead.\n */\nconst INLINED_IMPORTS: ReadonlyArray<{ pattern: RegExp; replacement: string }> = [\n  {\n    pattern:\n      /^import\\s*\\{\\s*RSC_CONTENT_TYPE\\s*,?\\s*\\}\\s*from\\s*[\"'][^\"']*shared\\/rsc-media-type\\.(?:js|ts)[\"'];?[ \\t]*$/m,\n    replacement: `const RSC_CONTENT_TYPE = ${JSON.stringify(RSC_CONTENT_TYPE)};`,\n  },\n];\n\n/**\n * Every way a module specifier can reach the emitted file, minus Node\n * builtins.\n *\n * `node:*` is exempt because it resolves on the deployed server exactly as it\n * does here — `_compress.mjs` already imports `node:zlib` and `node:stream`,\n * and self-hosted (Node/Bun) is the only place this file runs. Everything\n * else — relative paths, bare packages — has no resolution target next to a\n * lone `.mjs` in the build output.\n *\n * All three forms are listed rather than the one `server/compress.ts` happens\n * to use, because a re-export or a lazy `await import()` fails in exactly the\n * same place and is exactly as invisible until deploy.\n */\nconst MODULE_SPECIFIERS: readonly RegExp[] = [\n  // import … from '…'  /  export … from '…'\n  /^[ \\t]*(?:import|export)\\b[^\\n]*\\bfrom\\s*[\"'](?!node:)[^\"']+[\"']/m,\n  // import '…'  (side effect only)\n  /^[ \\t]*import\\s*[\"'](?!node:)[^\"']+[\"']/m,\n  // import('…')  (dynamic, literal specifier)\n  /\\bimport\\s*\\(\\s*[\"'](?!node:)[^\"']+[\"']/,\n];\n\n/**\n * Replace the shared-module imports with their values and reject anything\n * else that would leave a dangling specifier in `_compress.mjs`.\n *\n * Exported separately from `generateCompressModule` so both branches can be\n * driven with fixtures: the source it normally compiles is fixed, so a test\n * of the generator alone can only ever exercise whichever branch that source\n * happens to take today.\n *\n * @internal Exported for testing.\n */\nexport function inlineCompressImports(code: string): string {\n  let out = code;\n  for (const { pattern, replacement } of INLINED_IMPORTS) {\n    out = out.replace(pattern, replacement);\n  }\n  assertStandalone(out, 'server/compress.ts', '_compress.mjs');\n  return out;\n}\n\n/**\n * Throw if type-stripped server source still imports anything but a Node\n * builtin. Such a module is emitted alone into the build output, where no\n * specifier has anything to resolve to.\n *\n * @internal Shared by the standalone-module generators.\n */\nexport function assertStandalone(code: string, source: string, emitted: string): void {\n  const surviving = MODULE_SPECIFIERS.map((pattern) => pattern.exec(code)).find(Boolean);\n  if (surviving) {\n    throw new Error(\n      `[timber] ${source} is emitted as a standalone ${emitted} (type-stripped, ` +\n        `not bundled), so it cannot import anything at runtime. Found: ${surviving[0].trim()}\\n` +\n        `  Either inline the value in the generator in adapters/ or ` +\n        `keep the dependency out of ${source}.`\n    );\n  }\n}\n\n/**\n * Compile server/compress.ts into a standalone ESM module.\n *\n * Uses Vite's OXC transform to strip TypeScript types from the\n * embedded source. The result is written to `_compress.mjs` during\n * buildOutput.\n *\n * @internal Exported for testing.\n */\nexport async function generateCompressModule(): Promise<string> {\n  const result = await transformWithOxc(compressSource, 'compress.ts', {\n    lang: 'ts',\n  });\n\n  return (\n    '// Generated by @timber-js/app — compiled from server/compress.ts.\\n' +\n    '// Do not edit — this file is regenerated on each build.\\n' +\n    inlineCompressImports(result.code)\n  );\n}\n","// Compiles server/canonicalize.ts into a standalone ESM module\n// (_canonicalize.mjs) for the Nitro preview server, so preview answers a\n// request path exactly as the runtime's request boundary does — the same\n// rejections (encoded separators, null bytes, malformed encoding, escaping\n// the root) and the same single decode — instead of a hand-kept copy of\n// those rules drifting from them. Same mechanism as compress-module.ts:\n// type-stripped, not bundled, so the source must stay import-free.\n\nimport { transformWithOxc } from 'vite';\n// Vite's ?raw import embeds the file as a string at build time (see\n// compress-module.ts).\nimport canonicalizeSource from '../server/canonicalize.ts?raw';\nimport { assertStandalone } from './compress-module.ts';\n\n/**\n * Compile server/canonicalize.ts into a standalone ESM module exporting\n * `canonicalize`.\n *\n * @internal Exported for testing.\n */\nexport async function generateCanonicalizeModule(): Promise<string> {\n  const result = await transformWithOxc(canonicalizeSource, 'canonicalize.ts', { lang: 'ts' });\n  assertStandalone(result.code, 'server/canonicalize.ts', '_canonicalize.mjs');\n  return (\n    '// Generated by @timber-js/app — compiled from server/canonicalize.ts.\\n' +\n    '// Do not edit — this file is regenerated on each build.\\n' +\n    result.code\n  );\n}\n","// Nitro preset catalog — per-platform build configuration.\n//\n// Shared by the nitro adapter (build + entry generation) and the preview\n// module. See design/25-production-deployments.md for the preset matrix.\n\n/**\n * Supported Nitro deployment presets.\n *\n * Each preset maps to a Nitro deployment target. The adapter generates\n * the appropriate configuration and entry point for the selected platform.\n */\nexport type NitroPreset =\n  | 'vercel'\n  | 'vercel-edge'\n  | 'netlify'\n  | 'netlify-edge'\n  | 'aws-lambda'\n  | 'deno-deploy'\n  | 'azure-functions'\n  | 'node-server'\n  | 'bun';\n\n/** Preset-specific Nitro configuration. */\nexport interface PresetConfig {\n  /** Nitro preset name passed to the Nitro build. */\n  nitroPreset: string;\n  /** Output directory name within the build dir. */\n  outputDir: string;\n  /** Whether the runtime supports waitUntil. */\n  supportsWaitUntil: boolean;\n  /** Whether the runtime supports application-level 103 Early Hints. */\n  supportsEarlyHints: boolean;\n  /** Value for TIMBER_RUNTIME env var. See design/25-production-deployments.md. */\n  runtimeName: string;\n  /** Additional nitro.config fields for this preset. */\n  extraConfig?: Record<string, unknown>;\n}\n\nexport const PRESET_CONFIGS: Record<NitroPreset, PresetConfig> = {\n  'vercel': {\n    nitroPreset: 'vercel',\n    outputDir: '.vercel/output',\n    supportsWaitUntil: true,\n    supportsEarlyHints: false,\n    runtimeName: 'vercel',\n    extraConfig: { vercel: { functions: { maxDuration: 30 } } },\n  },\n  'vercel-edge': {\n    nitroPreset: 'vercel-edge',\n    outputDir: '.vercel/output',\n    supportsWaitUntil: true,\n    supportsEarlyHints: false,\n    runtimeName: 'vercel-edge',\n  },\n  'netlify': {\n    nitroPreset: 'netlify',\n    outputDir: '.netlify/functions-internal',\n    supportsWaitUntil: false,\n    supportsEarlyHints: false,\n    runtimeName: 'netlify',\n  },\n  'netlify-edge': {\n    nitroPreset: 'netlify-edge',\n    outputDir: '.netlify/edge-functions',\n    supportsWaitUntil: true,\n    supportsEarlyHints: false,\n    runtimeName: 'netlify-edge',\n  },\n  'aws-lambda': {\n    nitroPreset: 'aws-lambda',\n    outputDir: '.output',\n    supportsWaitUntil: false,\n    supportsEarlyHints: false,\n    runtimeName: 'aws-lambda',\n  },\n  'deno-deploy': {\n    nitroPreset: 'deno-deploy',\n    outputDir: '.output',\n    supportsWaitUntil: true,\n    supportsEarlyHints: false,\n    runtimeName: 'deno-deploy',\n  },\n  'azure-functions': {\n    nitroPreset: 'azure-functions',\n    outputDir: '.output',\n    supportsWaitUntil: false,\n    supportsEarlyHints: false,\n    runtimeName: 'azure-functions',\n  },\n  'node-server': {\n    nitroPreset: 'node-server',\n    outputDir: '.output',\n    supportsWaitUntil: true,\n    // Disabled by default: most node-server deployments sit behind a\n    // reverse proxy (nginx, caddy, traefik) that doesn't support 103\n    // Early Hints over HTTP/1.1. Sending 103 causes nginx to intermittently\n    // treat the response as an error and retry after proxy_connect_timeout\n    // (~5s stalls on ~23% of requests). Link headers on the 200 response\n    // are the safe fallback — Cloudflare and other CDNs convert them to\n    // 103 automatically at the edge (over HTTP/2+ to the browser).\n    supportsEarlyHints: false,\n    runtimeName: 'node-server',\n  },\n  'bun': {\n    nitroPreset: 'bun',\n    outputDir: '.output',\n    supportsWaitUntil: true,\n    // Disabled for same reason as node-server — reverse proxies choke on 103.\n    // Link headers on the 200 response are converted to 103 by CDNs.\n    supportsEarlyHints: false,\n    runtimeName: 'bun',\n  },\n};\n\n/** Presets that produce a locally-runnable server entry. */\nexport const LOCALLY_PREVIEWABLE = new Set<NitroPreset>(['node-server', 'bun']);\n\n/**\n * Get the preset configuration for a given preset name.\n * @internal Exported for testing.\n */\nexport function getPresetConfig(preset: NitroPreset): PresetConfig {\n  return PRESET_CONFIGS[preset];\n}\n","// Nitro local preview — standalone server codegen and process spawning.\n//\n// `buildOutput` writes `_preview-server.mjs` into the Nitro output directory,\n// generated from the build's own artifacts; `timber preview` runs the\n// adapter's preview(), which spawns it. See design/25-production-deployments.md\n// §Preview.\n\nimport { execFile } from 'node:child_process';\nimport { IMMUTABLE_CACHE, STATIC_CACHE } from './shared.ts';\n\n/**\n * Content-Type by file extension for the preview server. Static hosts decide\n * this themselves; the table covers the file types a web build ships so the\n * preview does not turn ordinary files into downloads. An extension missing\n * here is served as `application/octet-stream`.\n */\nconst PREVIEW_MIME_TYPES: Readonly<Record<string, string>> = {\n  // Documents and code\n  '.html': 'text/html; charset=utf-8',\n  '.htm': 'text/html; charset=utf-8',\n  '.css': 'text/css; charset=utf-8',\n  '.js': 'text/javascript; charset=utf-8',\n  '.mjs': 'text/javascript; charset=utf-8',\n  '.cjs': 'text/javascript; charset=utf-8',\n  '.map': 'application/json; charset=utf-8',\n  '.json': 'application/json; charset=utf-8',\n  '.jsonld': 'application/ld+json',\n  '.webmanifest': 'application/manifest+json',\n  '.xml': 'application/xml',\n  '.rss': 'application/rss+xml',\n  '.atom': 'application/atom+xml',\n  '.txt': 'text/plain; charset=utf-8',\n  '.md': 'text/markdown; charset=utf-8',\n  '.csv': 'text/csv; charset=utf-8',\n  '.ics': 'text/calendar; charset=utf-8',\n  '.vtt': 'text/vtt; charset=utf-8',\n  '.pdf': 'application/pdf',\n  '.wasm': 'application/wasm',\n  '.zip': 'application/zip',\n  '.gz': 'application/gzip',\n  // Images\n  '.png': 'image/png',\n  '.apng': 'image/apng',\n  '.jpg': 'image/jpeg',\n  '.jpeg': 'image/jpeg',\n  '.gif': 'image/gif',\n  '.svg': 'image/svg+xml',\n  '.ico': 'image/x-icon',\n  '.webp': 'image/webp',\n  '.avif': 'image/avif',\n  '.bmp': 'image/bmp',\n  '.tif': 'image/tiff',\n  '.tiff': 'image/tiff',\n  // Fonts\n  '.woff': 'font/woff',\n  '.woff2': 'font/woff2',\n  '.ttf': 'font/ttf',\n  '.otf': 'font/otf',\n  // Audio and video\n  '.mp3': 'audio/mpeg',\n  '.wav': 'audio/wav',\n  '.ogg': 'audio/ogg',\n  '.oga': 'audio/ogg',\n  '.m4a': 'audio/mp4',\n  '.flac': 'audio/flac',\n  '.mp4': 'video/mp4',\n  '.webm': 'video/webm',\n  '.ogv': 'video/ogg',\n  '.mov': 'video/quicktime',\n};\n\n/** What the generated preview server serves, as `buildOutput` knows it. */\nexport type PreviewScriptOptions = StaticPreviewScriptOptions | ServerPreviewScriptOptions;\n\ninterface PreviewScriptOptionsBase {\n  /**\n   * `BuildArtifacts.immutableDirs` — served with a one-year immutable\n   * `Cache-Control`, every other file with a revalidating one.\n   */\n  immutableDirs: readonly string[];\n  /**\n   * The deployment base, normalized (`/` or `/repo/`). Requests arrive in\n   * deployed-URL space; files are laid out in route space, so the script\n   * strips it before looking anything up.\n   */\n  base: string;\n}\n\n/** A static build: serve the pre-rendered site and nothing else. */\nexport interface StaticPreviewScriptOptions extends PreviewScriptOptionsBase {\n  output: 'static';\n  /** `StaticBuildArtifacts.contentTypes` — extensionless API route outputs. */\n  contentTypes: Readonly<Record<string, string>>;\n}\n\n/** A server build: serve `public/`, route everything else to the RSC handler. */\nexport interface ServerPreviewScriptOptions extends PreviewScriptOptionsBase {\n  output: 'server';\n  /** Value for `TIMBER_RUNTIME`, set before the handler evaluates. */\n  runtimeName: string;\n  /** Import specifier of the RSC handler, relative to the script. */\n  rscEntry: string;\n  /**\n   * Whether this build wrote `_timber-manifest-init.js` beside the script.\n   * Recorded from the build, never probed: the Nitro output directory is not\n   * cleaned between server builds, so a file on disk can be a stale one.\n   */\n  hasManifestInit: boolean;\n}\n\n/**\n * Generate a standalone preview server script that uses Node's built-in\n * HTTP server. This bypasses Nitro entirely — the Nitro entry.ts imports\n * h3 which isn't available outside a Nitro build. For local preview we\n * just need to serve static files and, in a server build, route requests\n * to the RSC handler.\n *\n * Generated at build time rather than at preview time, so everything it\n * serves comes from the build's artifacts instead of guesses about the\n * directory it runs in.\n *\n * @internal Exported for testing.\n */\nexport function generatePreviewScript(options: PreviewScriptOptions): string {\n  const immutablePrefixes = options.immutableDirs.map((dir) => `/${dir}/`);\n  const contentTypes = options.output === 'static' ? options.contentTypes : {};\n\n  // A server build loads its handler (after the runtime and manifest are in\n  // place); a static build has no handler to load.\n  const handlerSetup =\n    options.output === 'server'\n      ? `// Set runtime before importing the handler.\nprocess.env.TIMBER_RUNTIME = ${JSON.stringify(options.runtimeName)};\n${\n  options.hasManifestInit\n    ? `\n// Load the build manifest before the handler reads it.\nawait import('./_timber-manifest-init.js');\n`\n    : ''\n}\n// Import the RSC handler (default export is the fetch-like handler).\nconst { default: handler, runWithEarlyHintsSender } = await import(${JSON.stringify(options.rscEntry)});\n\n// Import compression helper for self-hosted response compression.\nconst { compressResponse } = await import('./_compress.mjs');\n\n// Web→Node response bridge with backpressure (TIM-1154).\nconst { sendNodeResponse } = await import('./_send-response.mjs');\n`\n      : '';\n\n  // What happens when no file matches: a static build answers with its own\n  // 404 page, a server build hands the request to the RSC handler.\n  const fallback =\n    options.output === 'static'\n      ? `  if (badPath) {\n    res.writeHead(400, { 'Content-Type': 'text/plain' });\n    res.end('Bad Request');\n    return;\n  }\n  const notFound = await findFile('/404.html');\n  if (notFound) {\n    await sendFile(req, res, notFound, 404, 'text/html', 'public, max-age=0, must-revalidate');\n    return;\n  }\n  res.writeHead(404, { 'Content-Type': 'text/plain' });\n  res.end('Not Found');\n`\n      : `  await handleDynamic(req, res, url);\n`;\n\n  const dynamicHandler =\n    options.output === 'server'\n      ? `\nasync function handleDynamic(req, res, url) {\n  // Convert Node request to Web Request.\n  const headers = new Headers();\n  for (const [key, value] of Object.entries(req.headers)) {\n    if (value) {\n      if (Array.isArray(value)) {\n        for (const v of value) headers.append(key, v);\n      } else {\n        headers.set(key, value);\n      }\n    }\n  }\n\n  let body = undefined;\n  if (req.method !== 'GET' && req.method !== 'HEAD') {\n    body = await new Promise((resolve) => {\n      const chunks = [];\n      req.on('data', (chunk) => chunks.push(chunk));\n      req.on('end', () => resolve(Buffer.concat(chunks)));\n    });\n  }\n\n  const webRequest = new Request(url.href, {\n    method: req.method,\n    headers,\n    body,\n    duplex: body ? 'half' : undefined,\n  });\n\n  try {\n    // Support 103 Early Hints when available.\n    const earlyHintsSender = (typeof res.writeEarlyHints === 'function')\n      ? (links) => { try { res.writeEarlyHints({ link: links }); } catch {} }\n      : undefined;\n\n    const rawResponse = earlyHintsSender && runWithEarlyHintsSender\n      ? await runWithEarlyHintsSender(earlyHintsSender, () => handler(webRequest))\n      : await handler(webRequest);\n\n    // Compress the response for self-hosted deployments.\n    const webResponse = compressResponse(webRequest, rawResponse);\n\n    // Write the response to Node's ServerResponse. sendNodeResponse handles\n    // status, headers (including Set-Cookie splitting via [...headers]),\n    // body streaming with backpressure, and client disconnect cleanup.\n    // See TIM-1154.\n    await sendNodeResponse(res, webResponse);\n  } catch (err) {\n    console.error('[timber preview] Request error:', err);\n    if (!res.headersSent) {\n      res.writeHead(500, { 'Content-Type': 'text/plain' });\n    }\n    res.end('Internal Server Error');\n  }\n}\n`\n      : '';\n\n  return `// Generated by @timber-js/app — standalone preview server.\n// Do not edit — this file is regenerated on each build.\n// Uses Node's built-in HTTP server to serve the build's files${\n    options.output === 'server' ? ' and route\\n// dynamic requests through the RSC handler' : ''\n  }. No Nitro/h3 dependency.\n\nimport { createServer } from 'node:http';\nimport { readFile, stat } from 'node:fs/promises';\nimport { join, extname, sep } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { canonicalize } from './_canonicalize.mjs';\n\nconst __dirname = fileURLToPath(new URL('.', import.meta.url));\n\n${handlerSetup}\nconst MIME_TYPES = ${JSON.stringify(PREVIEW_MIME_TYPES, null, 2)};\n\n// Recorded by the build: content-hashed directories, and the Content-Type of\n// each extensionless API route output (a file name cannot say it). Both are\n// decoded route-space paths, matched against the decoded request path.\nconst IMMUTABLE_PREFIXES = ${JSON.stringify(immutablePrefixes)};\nconst BASE = ${JSON.stringify(options.base)};\nconst CONTENT_TYPES = ${JSON.stringify(contentTypes)};\nconst SERVE_DIRECTORY_INDEX = ${options.output === 'static'};\n\nconst publicDir = join(__dirname, 'public');\n\n/**\n * The file under publicDir that a decoded URL path names, or null. A static\n * build lays its pages out as <path>/index.html, so a directory serves its\n * index there.\n */\nasync function findFile(pathname) {\n  const filePath = join(publicDir, pathname);\n  // Prevent path traversal (and a sibling like public-other/ passing a bare\n  // prefix check).\n  if (!filePath.startsWith(publicDir + sep)) return null;\n  try {\n    const fileStat = await stat(filePath);\n    if (fileStat.isFile()) return filePath;\n    if (SERVE_DIRECTORY_INDEX && fileStat.isDirectory()) {\n      const index = join(filePath, 'index.html');\n      if ((await stat(index)).isFile()) return index;\n    }\n  } catch {\n    // Not found.\n  }\n  return null;\n}\n\n/**\n * The route-space path for a request path, or null when the request is\n * outside the deployment base (it names no file of this build).\n */\nfunction stripBase(pathname) {\n  if (BASE === '/') return pathname;\n  if (pathname === BASE.slice(0, -1)) return '/';\n  if (!pathname.startsWith(BASE)) return null;\n  return pathname.slice(BASE.length - 1);\n}\n\nasync function sendFile(req, res, filePath, status, contentType, cacheControl) {\n  const body = await readFile(filePath);\n  res.writeHead(status, {\n    'Content-Type': contentType,\n    'Content-Length': body.length,\n    'Cache-Control': cacheControl,\n  });\n  res.end(req.method === 'HEAD' ? undefined : body);\n}\n${dynamicHandler}\n// Port resolution (TIM-842):\n//   - Default to 3000\n//   - If PORT env var is set, honor it strictly (fail loudly on conflict)\n//   - Otherwise auto-bump from 3000 until a free port is found\n// Mirrors the dev server behavior so timber dev/preview/production all\n// behave the same way around port selection.\nconst envPort = process.env.PORT ? parseInt(process.env.PORT, 10) : null;\nconst portIsExplicit = envPort != null && Number.isFinite(envPort) && envPort > 0;\nconst startPort = portIsExplicit ? envPort : 3000;\nconst host = process.env.HOST || 'localhost';\n\n// Set after listenWithBump() resolves so request handlers can build\n// absolute URLs from the actual bound port (which may differ from\n// startPort after an auto-bump).\nlet boundPort = startPort;\n\nconst server = createServer(async (req, res) => {\n  // Scheme from the socket's TLS state — a hardcoded http:// breaks CSRF\n  // origin comparison and absolute-URL construction when TLS is terminated\n  // at this server (TIM-1073; mirrors the dev-server fix in TIM-1067).\n  // X-Forwarded-Proto is intentionally not consulted here: on a direct\n  // connection it would be attacker-controlled. The CSRF layer honors it\n  // separately for reverse-proxy deployments.\n  const scheme = req.socket?.encrypted ? 'https' : 'http';\n  const url = new URL(req.url || '/', \\`\\${scheme}://\\${host}:\\${boundPort}\\`);\n\n  // The runtime's own request-boundary canonicalizer (_canonicalize.mjs,\n  // compiled from server/canonicalize.ts): one decode, and the same 400s for\n  // encoded separators, null bytes, malformed encoding, and escaping the root\n  // (design/13-security.md). The base is stripped from its canonical result,\n  // so an encoded spelling of the base is the same path. What remains, in\n  // route space, is looked up in public/; null names no file.\n  const canonical = canonicalize(url.pathname, false);\n  const badPath = !canonical.ok;\n  const pathname = canonical.ok ? stripBase(canonical.pathname) : null;\n  const filePath = pathname === null ? null : await findFile(pathname);\n  if (filePath) {\n    const contentType =\n      CONTENT_TYPES[pathname] || MIME_TYPES[extname(filePath).toLowerCase()] || 'application/octet-stream';\n    // Hashed assets get immutable cache, others get short cache.\n    const isImmutable = IMMUTABLE_PREFIXES.some((prefix) => pathname.startsWith(prefix));\n    const cacheControl = isImmutable ? ${JSON.stringify(IMMUTABLE_CACHE)} : ${JSON.stringify(STATIC_CACHE)};\n    await sendFile(req, res, filePath, 200, contentType, cacheControl);\n    return;\n  }\n\n${fallback}});\n\nfunction listenWithBump(port, attempt = 0) {\n  return new Promise((resolveListen, rejectListen) => {\n    const onError = (err) => {\n      server.removeListener('listening', onListening);\n      if (err && err.code === 'EADDRINUSE' && !portIsExplicit && attempt < 100) {\n        if (attempt === 0) {\n          console.log(\\`  [timber] Port \\${port} in use, trying \\${port + 1}...\\`);\n        }\n        listenWithBump(port + 1, attempt + 1).then(resolveListen, rejectListen);\n        return;\n      }\n      rejectListen(err);\n    };\n    const onListening = () => {\n      server.removeListener('error', onError);\n      resolveListen(port);\n    };\n    server.once('error', onError);\n    server.once('listening', onListening);\n    server.listen(port, host);\n  });\n}\n\ntry {\n  boundPort = await listenWithBump(startPort);\n  if (boundPort !== startPort) {\n    console.log();\n    console.log(\\`  [timber] Port \\${startPort} in use, using \\${boundPort}\\`);\n  }\n  console.log();\n  console.log('  ⚡ timber preview server running at:');\n  console.log();\n  console.log(\\`    ➜  http://\\${host}:\\${boundPort}\\`);\n  console.log();\n} catch (err) {\n  if (err && err.code === 'EADDRINUSE') {\n    console.error(\\`[timber] Port \\${startPort} is already in use. \\` +\n      'Set PORT to a free port, or unset PORT to auto-pick.');\n  } else {\n    console.error('[timber] Failed to start preview server:', err);\n  }\n  process.exit(1);\n}\n`;\n}\n\n/** Spawn a Nitro preview process and pipe stdio. */\nexport function spawnNitroPreview(command: string, args: string[], cwd: string): Promise<void> {\n  return new Promise<void>((resolve, reject) => {\n    const child = execFile(command, args, { cwd }, (err) => {\n      if (err) reject(err);\n      else resolve();\n    });\n    child.stdout?.pipe(process.stdout);\n    child.stderr?.pipe(process.stderr);\n  });\n}\n\n/**\n * Generate a standalone ESM module that exports sendNodeResponse.\n *\n * Mirrors srvx/node's sendNodeResponse: status + headers via writeHead,\n * body streaming with backpressure (waits for drain on write() === false),\n * and client disconnect cleanup. Written to `_send-response.mjs` during\n * buildOutput for use by the preview server script. See TIM-1154.\n *\n * @internal Exported for testing.\n */\nexport function generateSendResponseModule(): string {\n  return `// Generated by @timber-js/app — Web→Node response bridge.\n// Do not edit — this file is regenerated on each build.\n// Mirrors srvx/node's sendNodeResponse with backpressure support.\n\nexport function sendNodeResponse(nodeRes, webRes) {\n  if (!webRes) {\n    nodeRes.statusCode = 500;\n    return new Promise((resolve) => nodeRes.end(resolve));\n  }\n  const rawHeaders = [...webRes.headers];\n  const writeHeaders = rawHeaders.flat();\n  if (!nodeRes.headersSent) {\n    if (nodeRes.req?.httpVersion === '2.0') {\n      nodeRes.writeHead(webRes.status, writeHeaders);\n    } else {\n      nodeRes.writeHead(webRes.status, webRes.statusText, writeHeaders);\n    }\n  }\n  if (!webRes.body) {\n    return new Promise((resolve) => nodeRes.end(resolve));\n  }\n  // Stream with backpressure: pause reading when the kernel buffer is\n  // full (write() returns false) and resume on 'drain'.\n  if (nodeRes.destroyed) {\n    webRes.body.cancel();\n    return;\n  }\n  const reader = webRes.body.getReader();\n  function streamCancel(error) {\n    reader.cancel(error).catch(() => {});\n    if (error) nodeRes.destroy(error);\n  }\n  function streamHandle({ done, value }) {\n    try {\n      if (done) {\n        nodeRes.end();\n      } else if (nodeRes.write(value)) {\n        reader.read().then(streamHandle, streamCancel);\n      } else {\n        nodeRes.once('drain', () => reader.read().then(streamHandle, streamCancel));\n      }\n    } catch (error) {\n      streamCancel(error instanceof Error ? error : undefined);\n    }\n  }\n  nodeRes.on('close', streamCancel);\n  nodeRes.on('error', streamCancel);\n  reader.read().then(streamHandle, streamCancel);\n  return reader.closed.catch(streamCancel).finally(() => {\n    nodeRes.off('close', streamCancel);\n    nodeRes.off('error', streamCancel);\n  });\n}\n`;\n}\n","// Nitro adapter — multi-platform deployment\n//\n// Covers everything except Cloudflare Workers: Node.js, Bun, Vercel,\n// Netlify, AWS Lambda, Deno Deploy, Azure Functions. Nitro handles\n// compression, graceful shutdown, static file serving, and platform quirks.\n// See design/11-platform.md and design/25-production-deployments.md.\n\nimport { existsSync } from 'node:fs';\nimport { cp, glob, readFile, writeFile } from 'node:fs/promises';\nimport { basename, dirname, join, relative, sep } from 'node:path';\nimport {\n  buildStaticDirectoryOutput,\n  runSharedBuildSteps,\n  writeHeadersFile,\n} from './build-output-helper.ts';\nimport { generateCompressModule } from './compress-module.ts';\nimport { generateCanonicalizeModule } from './canonicalize-module.ts';\nimport { LOCALLY_PREVIEWABLE, PRESET_CONFIGS, type NitroPreset } from './nitro-presets.ts';\nimport {\n  generatePreviewScript,\n  generateSendResponseModule,\n  spawnNitroPreview,\n} from './nitro-preview.ts';\nimport { adapterBase, IMMUTABLE_CACHE } from './shared.ts';\nimport type {\n  BuildArtifacts,\n  PreviewTarget,\n  TimberConfig,\n  TimberPlatformAdapter,\n} from './types.ts';\n\n// NitroPreset is part of the public adapter API (NitroAdapterOptions.preset),\n// so it stays importable from this module.\nexport type { NitroPreset } from './nitro-presets.ts';\n\n// ─── Options ─────────────────────────────────────────────────────────────────\n\n/**\n * Static deploy target for `output: 'static'` mode.\n *\n * Controls platform-specific files written alongside the static output:\n * - `'github-pages'` — writes `.nojekyll` to skip Jekyll processing\n * - `'generic'` — no extra files (default)\n */\nexport type StaticTarget = 'github-pages' | 'generic';\n\n/** Options for the Nitro adapter. */\nexport interface NitroAdapterOptions {\n  /**\n   * Deployment preset. Determines the target platform.\n   * @default 'node-server'\n   */\n  preset?: NitroPreset;\n\n  /**\n   * Enable application-level gzip compression for HTML and RSC responses.\n   *\n   * When `true` (default), the origin compresses responses using the Web\n   * `CompressionStream` API. This is useful for self-hosted deployments\n   * where no reverse proxy or CDN handles compression.\n   *\n   * Set to `false` when deploying behind a reverse proxy (nginx, caddy)\n   * or CDN (Cloudflare, Fastly, Vercel) that compresses at the edge.\n   * Disabling origin compression saves CPU on the Node.js event loop —\n   * compressing 1MB+ streaming HTML responses takes 10-15ms of main\n   * thread time per request, directly reducing throughput under load.\n   *\n   * @default true\n   */\n  compress?: boolean;\n\n  /**\n   * Static deploy target for `output: 'static'` mode. Controls\n   * platform-specific files (e.g. `.nojekyll` for GitHub Pages).\n   * @default 'generic'\n   */\n  staticTarget?: StaticTarget;\n\n  /**\n   * Additional Nitro configuration to merge into the generated config.\n   * Overrides default values for the selected preset.\n   */\n  nitroConfig?: Record<string, unknown>;\n}\n\n// ─── Adapter ─────────────────────────────────────────────────────────────────\n\n/**\n * Create a Nitro-based adapter for multi-platform deployment.\n *\n * Nitro abstracts deployment targets — the same timber.js app can deploy\n * to Vercel, Netlify, AWS, Deno Deploy, or Azure by changing the preset.\n *\n * @example\n * ```ts\n * import { nitro } from '@timber-js/app/adapters/nitro'\n *\n * export default {\n *   output: 'server',\n *   adapter: nitro({ preset: 'vercel' }),\n * }\n * ```\n */\nexport function nitro(options: NitroAdapterOptions = {}): TimberPlatformAdapter {\n  const preset = options.preset ?? 'node-server';\n  const compress = options.compress ?? true;\n  return {\n    name: `nitro-${preset}`,\n\n    async buildOutput(config: TimberConfig, artifacts: BuildArtifacts) {\n      const outDir = join(artifacts.outputDir, 'nitro');\n\n      // ── Static mode: plain directory output ────────────────────────\n      // No Nitro server — just pre-rendered HTML + client assets.\n      if (artifacts.output === 'static') {\n        await buildStaticDirectoryOutput(config, artifacts, outDir, 'public');\n        const publicDir = join(outDir, 'public');\n\n        // Write _headers for cache control + extensionless Content-Type.\n        // Netlify supports the _headers convention just like Cloudflare.\n        await writeHeadersFile(publicDir, config, artifacts);\n\n        // Local preview serves the site as the build recorded it.\n        await writeFile(join(outDir, CANONICALIZE_MODULE), await generateCanonicalizeModule());\n        await writeFile(\n          join(outDir, PREVIEW_SCRIPT),\n          generatePreviewScript({\n            output: 'static',\n            immutableDirs: artifacts.immutableDirs,\n            base: adapterBase(config),\n            contentTypes: artifacts.contentTypes,\n          })\n        );\n\n        // Platform-specific files for static deploy targets.\n        const target = options.staticTarget ?? 'generic';\n        if (target === 'github-pages') {\n          // Deploy-from-a-branch runs Jekyll, which drops `_`-prefixed paths —\n          // every `_rsc/` payload. Written unconditionally: GitHub reads only\n          // that the file exists, never its contents.\n          await writeFile(join(publicDir, '.nojekyll'), '');\n          // GitHub Pages doesn't support _redirects files. Warn if any\n          // redirects were generated — those routes will 404 on GH Pages.\n          try {\n            const redirects = await readFile(join(publicDir, '_redirects'), 'utf-8');\n            if (redirects.trim().length > 0) {\n              console.warn(\n                `[timber] Warning: GitHub Pages does not support _redirects files. ` +\n                  `Redirect rules from middleware/proxy will not work on this platform.`\n              );\n            }\n          } catch {\n            // No _redirects file — nothing to warn about\n          }\n        }\n\n        return;\n      }\n\n      // Steps 1–5: shared across all adapters (mkdir, copy client/rsc/ssr,\n      // write _headers, write manifest-init).\n      await runSharedBuildSteps({\n        config,\n        artifacts,\n        outDir,\n        publicDirName: 'public',\n      });\n\n      // Write runtime helper modules used by the preview server.\n      // See design/25-production-deployments.md — self-hosted deployments\n      // need application-level compression (Cloudflare handles it at the edge).\n      await writeFile(join(outDir, '_compress.mjs'), await generateCompressModule());\n\n      // Web→Node response bridge with backpressure. See TIM-1154.\n      await writeFile(join(outDir, '_send-response.mjs'), generateSendResponseModule());\n\n      // Standalone preview server for presets with a local runtime. It loads\n      // the build's own RSC bundle — not the copy under nitro/rsc/ — because\n      // the handler reads prebuilt payloads from ../prebuilt beside its\n      // bundle, and the build's prebuilt/ is cleaned every build while\n      // nitro/prebuilt/ is not: a build that captured nothing would otherwise\n      // preview an earlier build's payloads.\n      if (LOCALLY_PREVIEWABLE.has(preset)) {\n        await writeFile(join(outDir, CANONICALIZE_MODULE), await generateCanonicalizeModule());\n        await writeFile(\n          join(outDir, PREVIEW_SCRIPT),\n          generatePreviewScript({\n            output: 'server',\n            runtimeName: PRESET_CONFIGS[preset].runtimeName,\n            rscEntry: importSpecifier(outDir, join(artifacts.rsc.path, 'index.js')),\n            hasManifestInit: !!artifacts.manifestInit,\n            immutableDirs: artifacts.immutableDirs,\n            base: adapterBase(config),\n          })\n        );\n      }\n\n      // Prepend the manifest assignment directly into the RSC entry so\n      // globalThis.__TIMBER_BUILD_MANIFEST__ is set before any module reads it.\n      // This must be top-level code, not an import, because rollup tree-shakes\n      // side-effect-only globalThis assignments from imported modules.\n      if (artifacts.manifestInit) {\n        const rscEntry = join(outDir, 'rsc', 'index.js');\n        const rscContent = await readFile(rscEntry, 'utf-8');\n        await writeFile(rscEntry, `${artifacts.manifestInit}\\n${rscContent}`);\n      }\n\n      // Generate the Nitro entry point (imports from ./rsc/ within nitro dir)\n      const entry = generateNitroEntry(preset, compress);\n      await writeFile(join(outDir, 'entry.ts'), entry);\n\n      // Run the Nitro build to produce a production-ready server bundle.\n      // The output goes to dist/nitro/.output/server/index.mjs (for node-server preset).\n      // Config is passed programmatically — no nitro.config.ts file needed.\n      const { serverDir } = await runNitroBuild(\n        outDir,\n        preset,\n        artifacts.immutableDirs,\n        options.nitroConfig\n      );\n\n      // Copy prebuilt flight payloads into the Nitro output. The RSC entry\n      // resolves `../prebuilt/` relative to its bundled chunk\n      // (<serverDir>/_chunks/), so prebuilt/ must live at\n      // <serverDir>/prebuilt/. serverDir is the resolved path from Nitro\n      // (honors user overrides via nitroConfig.output.serverDir).\n      if (artifacts.prebuilt) {\n        const prebuiltSrc = artifacts.prebuilt.path;\n        await cp(prebuiltSrc, join(serverDir, 'prebuilt'), { recursive: true });\n\n        // Vercel with functionRules clones __server.func to per-route .func\n        // directories during the Nitro build. Copy prebuilt into those clones\n        // so requests routed to them also resolve ../prebuilt correctly.\n        if (preset === 'vercel' || preset === 'vercel-edge') {\n          const functionsDir = dirname(serverDir);\n          const baseFuncName = basename(serverDir);\n          await copyPrebuiltToVercelFuncClones(functionsDir, prebuiltSrc, baseFuncName);\n        }\n      }\n    },\n\n    // buildOutput wrote the preview server for this build: a static file\n    // server for a static build, and for a server build on a preset with a\n    // local runtime (node-server, bun), one that routes to the RSC handler.\n    // Serverless presets (vercel, netlify, aws-lambda, etc.) have no local\n    // runtime, so a server build on one has nothing to preview.\n    async preview(_config: TimberConfig, { output, outputDir }: PreviewTarget) {\n      if (output === 'server' && !LOCALLY_PREVIEWABLE.has(preset)) {\n        throw new Error(\n          `[timber] The nitro '${preset}' preset has no local runtime, so \\`timber preview\\` ` +\n            `cannot run its server build. Preview with a node-server build, or with the ` +\n            `platform's own tooling.`\n        );\n      }\n      const nitroDir = join(outputDir, 'nitro');\n      const script = join(nitroDir, PREVIEW_SCRIPT);\n      if (!existsSync(script)) {\n        throw new Error(\n          `[timber] No preview server at ${script}. Run \\`timber build\\` before \\`timber preview\\`.`\n        );\n      }\n      // Only a bun server build needs Bun. The static file server uses Node\n      // built-ins, so it runs on the Node already running timber, as does a\n      // node-server build — no PATH lookup for either.\n      const command = output === 'server' && preset === 'bun' ? 'bun' : process.execPath;\n      await spawnNitroPreview(command, [script], nitroDir);\n    },\n  };\n}\n\n/** The preview server buildOutput writes into the Nitro output directory. */\nconst PREVIEW_SCRIPT = '_preview-server.mjs';\n\n/** The request-path canonicalizer the preview server imports beside it. */\nconst CANONICALIZE_MODULE = '_canonicalize.mjs';\n\n/** A relative ESM import specifier for `file`, as imported from a module in `fromDir`. */\nfunction importSpecifier(fromDir: string, file: string): string {\n  const path = relative(fromDir, file).split(sep).join('/');\n  return path.startsWith('../') ? path : './' + path;\n}\n\n// ─── Entry Generation ────────────────────────────────────────────────────────\n\n/** @internal Exported for testing. */\nexport function generateNitroEntry(preset: NitroPreset, compress = true): string {\n  // The RSC entry is the main request handler — it exports the fetch handler as default.\n  // rsc/ is copied into the nitro dir so the import is local.\n  // The manifest init is prepended to rsc/index.js before the nitro build,\n  // so globalThis.__TIMBER_BUILD_MANIFEST__ is set before any code reads it.\n  const serverEntryRelative = './rsc/index.js';\n  const runtimeName = PRESET_CONFIGS[preset].runtimeName;\n  const earlyHints = PRESET_CONFIGS[preset].supportsEarlyHints;\n  const supportsWaitUntil = PRESET_CONFIGS[preset].supportsWaitUntil;\n\n  // On node-server and bun, wrap the handler with ALS so the pipeline\n  // can send 103 Early Hints via res.writeEarlyHints(). Other presets\n  // either don't support 103 or handle it at the CDN level.\n  //\n  // For presets that support waitUntil, bridge h3's event.waitUntil()\n  // to timber's waitUntil() primitive via the ALS bridge.\n  // See design/11-platform.md §\"waitUntil()\".\n  let handlerCall: string;\n  if (earlyHints && supportsWaitUntil) {\n    handlerCall = `  const nodeRes = event.node?.res\n  const earlyHintsSender = (typeof nodeRes?.writeEarlyHints === 'function')\n    ? (links) => { try { nodeRes.writeEarlyHints({ link: links }) } catch {} }\n    : undefined\n\n  const waitUntilFn = (typeof event.waitUntil === 'function')\n    ? (p) => event.waitUntil(p)\n    : undefined\n\n  const callHandler = () => handler(webRequest)\n  let wrappedHandler = earlyHintsSender\n    ? () => runWithEarlyHintsSender(earlyHintsSender, callHandler)\n    : callHandler\n  const webResponse = waitUntilFn\n    ? await runWithWaitUntil(waitUntilFn, wrappedHandler)\n    : await wrappedHandler()`;\n  } else if (earlyHints) {\n    handlerCall = `  const nodeRes = event.node?.res\n  const earlyHintsSender = (typeof nodeRes?.writeEarlyHints === 'function')\n    ? (links) => { try { nodeRes.writeEarlyHints({ link: links }) } catch {} }\n    : undefined\n\n  const webResponse = earlyHintsSender\n    ? await runWithEarlyHintsSender(earlyHintsSender, () => handler(webRequest))\n    : await handler(webRequest)`;\n  } else if (supportsWaitUntil) {\n    handlerCall = `  const waitUntilFn = (typeof event.waitUntil === 'function')\n    ? (p) => event.waitUntil(p)\n    : undefined\n\n  const webResponse = waitUntilFn\n    ? await runWithWaitUntil(waitUntilFn, () => handler(webRequest))\n    : await handler(webRequest)`;\n  } else {\n    handlerCall = `  const webResponse = await handler(webRequest)`;\n  }\n\n  // Import runWithWaitUntil only when the preset supports it.\n  const waitUntilImport = supportsWaitUntil ? ', runWithWaitUntil' : '';\n\n  const compressImport = compress ? \"import { compressResponse } from './_compress.mjs'\\n\" : '';\n  const compressCall = compress ? 'compressResponse(webRequest, webResponse)' : 'webResponse';\n\n  return `// Generated by @timber-js/app/adapters/nitro\n// Do not edit — this file is regenerated on each build.\n\nimport handler, { runWithEarlyHintsSender${waitUntilImport} } from '${serverEntryRelative}'\n${compressImport}\n// Set TIMBER_RUNTIME for instrumentation.ts conditional SDK initialization.\n// See design/25-production-deployments.md §\"TIMBER_RUNTIME\".\nprocess.env.TIMBER_RUNTIME = '${runtimeName}'\n\n// Nitro's index.mjs wraps this import with defineLazyEventHandler, which\n// already handles the event handler protocol. We export a plain async\n// function — no defineEventHandler wrapper needed.\n// Nitro bundles h3 into its internal _libs/ directory but doesn't make\n// it available as a bare specifier in the output's node_modules.\nexport default async function timberHandler(event) {\n  // h3 v2: event.req is the Web Request\n  const webRequest = event.req\n${handlerCall}\n  return ${compressCall}\n}\n`;\n}\n\n// ─── Build Hint Filtering ────────────────────────────────────────────────────\n\n/**\n * Prefixes of nitro build-output lines that give wrong advice for timber\n * builds. Every nitro bundler path emits these hints via `logger.success` —\n * the rollup path hardcodes `npx nitro preview`; rolldown and vite default\n * to it. That command resolves `.output/nitro.json` relative to cwd, but\n * timber's nitro build lives at `.timber/dist/nitro/.output`, so the\n * suggested command can never work from the project root.\n * Prefix matching degrades gracefully: if upstream rewords the line\n * entirely, it passes through rather than being silently eaten.\n */\nconst NITRO_PREVIEW_HINT_PREFIX = 'You can preview this build using';\nconst NITRO_DEPLOY_HINT_PREFIX = 'You can deploy this build using';\nconst SUPPRESSED_NITRO_HINT_PREFIXES = [NITRO_PREVIEW_HINT_PREFIX, NITRO_DEPLOY_HINT_PREFIX];\n\n/** @internal Exported for testing. */\nexport function isSuppressedNitroHint(\n  message: unknown,\n  prefixes: readonly string[] = SUPPRESSED_NITRO_HINT_PREFIXES\n): boolean {\n  return typeof message === 'string' && prefixes.some((prefix) => message.startsWith(prefix));\n}\n\n/**\n * Nitro's rolldown and vite builders render `framework.previewCommand` /\n * `framework.deployCommand` into these hints. A user who explicitly set one\n * via `nitroConfig` has provided valid guidance — only suppress the hints\n * whose command is still nitro's broken default.\n *\n * @internal Exported for testing.\n */\nexport function selectSuppressedHintPrefixes(framework?: {\n  previewCommand?: string;\n  deployCommand?: string;\n}): string[] {\n  return [\n    ...(framework?.previewCommand ? [] : [NITRO_PREVIEW_HINT_PREFIX]),\n    ...(framework?.deployCommand ? [] : [NITRO_DEPLOY_HINT_PREFIX]),\n  ];\n}\n\n/** Minimal structural view of the nitro (consola) logger the wrap needs. */\ninterface NitroBuildLogger {\n  success: (message: unknown, ...args: unknown[]) => void;\n}\n\n/**\n * Wrap a nitro logger's `success` so hardcoded preview/deploy hints are\n * dropped for this programmatic build only. Returns the original\n * (unfiltered) success fn so timber can print its own hint — which shares\n * the suppressed prefix on purpose, replacing nitro's wording.\n *\n * @internal Exported for testing.\n */\nexport function wrapNitroLoggerForBuild(\n  logger: NitroBuildLogger,\n  prefixes: readonly string[] = SUPPRESSED_NITRO_HINT_PREFIXES\n): NitroBuildLogger['success'] {\n  const originalSuccess = logger.success.bind(logger);\n  const wrapped = (message: unknown, ...args: unknown[]) => {\n    if (isSuppressedNitroHint(message, prefixes)) return;\n    originalSuccess(message, ...args);\n  };\n  // Preserve consola LogFn properties (e.g. `.raw`) on the replacement.\n  logger.success = Object.assign(wrapped, logger.success);\n  return originalSuccess;\n}\n\n/**\n * Timber's own post-build hint. Locally-runnable presets are previewed via\n * `timber preview`, which invokes this adapter's `preview()` to run the\n * generated `_preview-server.mjs`. Serverless presets get no hint — their\n * output lives under `.timber/dist/nitro/`, so any cwd-relative deploy\n * command would be as wrong as the nitro hint this replaces.\n *\n * @internal Exported for testing.\n */\nexport function getPostBuildHint(preset: NitroPreset): string | null {\n  return LOCALLY_PREVIEWABLE.has(preset)\n    ? 'You can preview this build using `timber preview`'\n    : null;\n}\n\n/**\n * Run the Nitro production build using the programmatic API.\n * Uses dynamic import so nitro is only loaded at build time.\n * Externalizes the timber RSC/SSR output — those files are pre-built\n * by timber and have internal references that nitro's bundler can't follow.\n */\ninterface NitroBuildResult {\n  /** Resolved output.serverDir — where the server bundle + _chunks/ live. */\n  serverDir: string;\n}\n\nasync function runNitroBuild(\n  nitroDir: string,\n  preset: NitroPreset,\n  immutableDirs: readonly string[],\n  userConfig?: Record<string, unknown>\n): Promise<NitroBuildResult> {\n  const presetConfig = PRESET_CONFIGS[preset];\n  const {\n    createNitro,\n    build: nitroBuild,\n    prepare,\n    copyPublicAssets,\n  } = await import('nitro/builder');\n\n  const nitro = await createNitro({\n    rootDir: nitroDir,\n    preset: presetConfig.nitroPreset,\n    // Use renderer.entry so Nitro wraps our handler with its server runtime\n    // (HTTP server, static file serving, graceful shutdown, etc.).\n    // Using `entry` directly would bypass the Nitro server runtime.\n    renderer: { handler: join(nitroDir, 'entry.ts') },\n    output: { dir: join(nitroDir, presetConfig.outputDir) },\n    // One rule per content-hashed directory the build recorded.\n    routeRules: Object.fromEntries(\n      immutableDirs.map((dir) => [`/${dir}/**`, { headers: { 'Cache-Control': IMMUTABLE_CACHE } }])\n    ),\n    // Don't bundle the timber RSC/SSR build output — it has its own\n    // internal file references that nitro's bundler can't follow.\n    // Mark them as external so rollup leaves the imports as-is.\n    rollupConfig: {\n      external: [/\\.\\.\\/rsc\\//],\n    },\n    ...presetConfig.extraConfig,\n    ...userConfig,\n  });\n\n  // Drop nitro's `npx nitro preview` / `npx nitro deploy` hints —\n  // they can never work from the project root (see TIM-1375). Hints whose\n  // command the user explicitly configured via framework.previewCommand /\n  // deployCommand pass through untouched — except on the rollup builder,\n  // which ignores framework commands and unconditionally prints the broken\n  // defaults (nitro/dist/_build/rollup.mjs), so user commands are treated\n  // as absent there: defaults stay suppressed, timber's hint still prints.\n  // logSuccess is the unfiltered fn used below to print timber's hint.\n  const framework = nitro.options.builder === 'rollup' ? undefined : nitro.options.framework;\n  const logSuccess = wrapNitroLoggerForBuild(nitro.logger, selectSuppressedHintPrefixes(framework));\n\n  // Read the resolved serverDir AFTER config merging — userConfig may\n  // override output.dir or output.serverDir. Nitro appends a trailing\n  // slash during resolution; strip it for join() compatibility.\n  const raw = nitro.options.output.serverDir;\n  const serverDir = raw.endsWith('/') ? raw.slice(0, -1) : raw;\n\n  await prepare(nitro);\n  await copyPublicAssets(nitro);\n  await nitroBuild(nitro);\n  await nitro.close();\n\n  // A user-configured previewCommand already printed via nitro's own hint —\n  // don't print a second, conflicting one.\n  const hint = framework?.previewCommand ? null : getPostBuildHint(preset);\n  if (hint) logSuccess(hint);\n\n  return { serverDir };\n}\n// ─── Helpers ─────────────────────────────────────────────────────────────────\n\n/**\n * Copy prebuilt payloads into cloned Vercel function directories.\n *\n * When users configure `vercel.functionRules`, Nitro's compiled hook clones\n * the base __server.func to per-route .func directories. These clones are\n * created during `runNitroBuild()` — before our post-build prebuilt copy.\n * Each clone resolves `../prebuilt` independently, so they each need a copy.\n *\n * @internal Exported for testing.\n */\nexport async function copyPrebuiltToVercelFuncClones(\n  functionsDir: string,\n  prebuiltSrc: string,\n  baseFuncName: string\n): Promise<void> {\n  const funcDirs: string[] = [];\n  try {\n    for await (const match of glob('**/*.func', { cwd: functionsDir })) {\n      if (!match.endsWith(baseFuncName)) {\n        funcDirs.push(join(functionsDir, match));\n      }\n    }\n  } catch {\n    return;\n  }\n  await Promise.all(\n    funcDirs.map((dir) => cp(prebuiltSrc, join(dir, 'prebuilt'), { recursive: true }))\n  );\n}\n"],"mappings":"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"}

package/dist/adapters/shared.d.ts

@@ -0,0 +1,67 @@
+/**
+ * The deployment base an adapter should write platform rules against.
+ *
+ * `config.base` is optional on `TimberConfig` because adapters can be invoked
+ * by callers that predate it (a hand-written adapter, a test harness). Falling
+ * back to `'/'` reproduces the pre-TIM-1274 output exactly, which is correct
+ * for the only deployments those callers can have: a build under a non-root
+ * base always goes through `plugins/post-build.ts`, which populates it.
+ *
+ * Typed structurally rather than as `TimberConfig` so this module keeps no
+ * import of `./types.js` at runtime.
+ */
+export declare function adapterBase(config: {
+    base?: string;
+}): string;
+/** Cache-Control value for hashed (immutable) assets. */
+export declare const IMMUTABLE_CACHE = "public, max-age=31536000, immutable";
+/** Cache-Control value for unhashed static assets. */
+export declare const STATIC_CACHE = "public, max-age=3600, must-revalidate";
+export interface HeadersFileOptions {
+    /**
+     * The deployment base, already normalized by `normalizeBasePath()` —
+     * leading and trailing slash, `'/'` at the domain root.
+     *
+     * Required rather than defaulted: a caller that forgets it would emit
+     * root-relative rules that match nothing, which is the bug this closes.
+     */
+    base: string;
+    /**
+     * Content-hashed directories, from `BuildArtifacts.immutableDirs`. Each
+     * gets an immutable `Cache-Control` wildcard rule.
+     */
+    immutableDirs: readonly string[];
+    /** Unhashed static files (route-space paths) needing per-file cache rules. */
+    unhashedPaths?: string[];
+    /** Route-space path → Content-Type, for extensionless API route outputs. */
+    contentTypes?: Record<string, string>;
+    /**
+     * Verbatim contents of the user's `public/_headers`, appended after the
+     * generated rules. See `mergeUserHeaders` for why it goes last.
+     */
+    userRules?: string;
+}
+/**
+ * Count the rules in a `_headers` file — a rule is a path line, which is any
+ * line that is neither blank, a comment, nor an indented header.
+ *
+ * @internal Exported for testing.
+ */
+export declare function countHeaderRules(content: string): number;
+/** One `_headers` block: a path pattern and the headers it sets. */
+export interface HeaderRule {
+    pattern: string;
+    headers: Array<{
+        name: string;
+        value: string;
+    }>;
+}
+/**
+ * Parse a `_headers` file. A non-indented, non-comment line opens a rule; the
+ * indented `Name: value` lines beneath it belong to that rule.
+ *
+ * @internal Exported for testing.
+ */
+export declare function parseHeaderRules(content: string): HeaderRule[];
+export declare function generateHeadersFile({ base, immutableDirs, unhashedPaths, contentTypes, userRules, }: HeadersFileOptions): string;
+//# sourceMappingURL=shared.d.ts.map

package/dist/adapters/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/adapters/shared.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE7D;AAID,yDAAyD;AACzD,eAAO,MAAM,eAAe,wCAAwC,CAAC;AAErE,sDAAsD;AACtD,eAAO,MAAM,YAAY,0CAA0C,CAAC;AAsCpE,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED,oEAAoE;AACpE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAmB9D;AAmBD,wBAAgB,mBAAmB,CAAC,EAClC,IAAI,EACJ,aAAa,EACb,aAAa,EACb,YAAY,EACZ,SAAS,GACV,EAAE,kBAAkB,GAAG,MAAM,CAmH7B"}

package/dist/adapters/types.d.ts

@@ -1,23 +1,131 @@
 /**
  * Configuration passed to adapter lifecycle methods.
  * A subset of the resolved timber.config.ts relevant to adapters.
+ *
+ * Configuration only: nothing here is produced by a build phase. What the
+ * build produced — directories, the manifest initialization module, the
+ * static site — arrives separately as {@link BuildArtifacts}, and the output
+ * mode is the discriminant of that union rather than a field here, so an
+ * adapter cannot be handed a static mode with no static site (TIM-1524).
  */
 export interface TimberConfig {
-    output: 'server' | 'static';
+    /** Absolute path to the project root (Vite root). */
+    root?: string;
+    /**
+     * The resolved deployment base, normalized by `normalizeBasePath()` —
+     * leading and trailing slash, `'/'` at the domain root.
+     *
+     * Adapters write platform files (`_headers`, `_redirects`) whose rules the
+     * host matches against the *request* path, so those rules live in deployed-
+     * URL space rather than route space and need this prefix (TIM-1274).
+     *
+     * Populated by `plugins/post-build.ts` from `ctx.base`, the single copy
+     * lifted in TIM-1261. Adapters must not re-derive it from `config.base`.
+     */
+    base?: string;
     clientJavascriptDisabled?: boolean;
+}
+/** A directory a build phase wrote. */
+export interface DirectoryArtifact {
+    /** Absolute path. Adapters never join it against `outputDir` or `root`. */
+    readonly path: string;
+}
+interface BuildArtifactsBase {
+    /**
+     * The build output directory (`.timber/dist` by default) — where adapters
+     * write their own platform directory (`cloudflare/`, `nitro/`). Not the
+     * project root; that is `TimberConfig.root`.
+     */
+    readonly outputDir: string;
     /**
-     * JS module source that sets globalThis.__TIMBER_BUILD_MANIFEST__.
-     * Written by adapters as _timber-manifest-init.js, imported before the RSC handler.
-     * Undefined when no build manifest was produced (e.g., dev mode or no client assets).
+     * The browser bundle: client JS, CSS, fonts, and everything Vite copied
+     * out of `public/`. Always produced — with client JavaScript disabled it
+     * still carries the stylesheets and `public/`; adapters drop the `.js`.
      */
-    manifestInit?: string;
+    readonly client: DirectoryArtifact;
+    /**
+     * Directories of the served tree whose every file name carries a content
+     * hash — `'assets'`, `'_timber/fonts'`, and in a static build whose RSC
+     * payloads were hashed, `'_rsc'`. Relative to the site root, `/`-separated,
+     * no leading or trailing slash, and in route space: an adapter writing
+     * platform rules adds the deployment `base` itself.
+     *
+     * Each entry is recorded by the phase that hashed the files — the client
+     * environment from its `build.assetsDir`, the font plugin when it emitted a
+     * binary, static generation when it hashed payloads — so adapters mark
+     * these immutable without knowing which plugin names or hashes what.
+     */
+    readonly immutableDirs: readonly string[];
+}
+/** Build products of an `output: 'server'` build. */
+export interface ServerBuildArtifacts extends BuildArtifactsBase {
+    readonly output: 'server';
+    /** The RSC server bundle. Its `index.js` is the request handler. */
+    readonly rsc: DirectoryArtifact;
+    /**
+     * The SSR bundle. The RSC bundle imports it by a path the RSC plugin
+     * computed between the two build directories — siblings named `rsc/` and
+     * `ssr/` — so adapters deploy them as siblings under those names.
+     */
+    readonly ssr: DirectoryArtifact;
+    /**
+     * `cache.component` flight payloads captured at build time (design/44).
+     * Present only when the capture pass wrote at least one payload.
+     */
+    readonly prebuilt?: DirectoryArtifact;
+    /**
+     * Generated JS module source that sets `globalThis.__TIMBER_BUILD_MANIFEST__`.
+     * Must evaluate before the RSC handler; adapters
+     * write it as `_timber-manifest-init.js` or prepend it to the entry.
+     * Absent when no build manifest was produced.
+     */
+    readonly manifestInit?: string;
+}
+/** Build products of an `output: 'static'` build. */
+export interface StaticBuildArtifacts extends BuildArtifactsBase {
+    readonly output: 'static';
+    /**
+     * The pre-rendered site: `path/index.html`, RSC payloads under `_rsc/`
+     * (content-hashed unless client JavaScript is disabled), API route
+     * outputs, `404.html`, and a generated `_redirects` when any redirect was
+     * captured.
+     */
+    readonly pages: DirectoryArtifact;
+    /**
+     * Content-Type for each extensionless API route output, keyed by URL path
+     * (e.g. `/api/data` → `application/json`). Adapters write these as
+     * `_headers` rules; a static host cannot infer them from a file name.
+     * See TIM-1241.
+     */
+    readonly contentTypes: Readonly<Record<string, string>>;
+}
+/**
+ * Everything a `timber build` produced, as the adapter consumes it.
+ *
+ * Each field is recorded by the phase that wrote it. The two optional fields
+ * are the two products a build can legitimately lack — `prebuilt` (nothing
+ * captured) and `manifestInit` (no build manifest) — and adapters branch on
+ * their presence (`if (artifacts.prebuilt)`) rather than probing the
+ * filesystem.
+ */
+export type BuildArtifacts = ServerBuildArtifacts | StaticBuildArtifacts;
+/**
+ * What `timber preview` asks an adapter to serve. Preview runs in a later
+ * process with no build in memory, so it gets the output directory and the
+ * configured mode rather than {@link BuildArtifacts}; the mode is what tells
+ * an adapter whether a server entry exists to run at all.
+ */
+export interface PreviewTarget {
+    readonly output: 'server' | 'static';
+    /** The build output directory `buildOutput` wrote its platform directory into. */
+    readonly outputDir: string;
 }
 /**
  * The formal adapter interface. An adapter transforms the build output
  * into a deployable artifact for a specific platform.
  *
- * Adapters are small: they receive the build output directory and
- * transform or copy it into whatever shape the platform expects.
+ * Adapters are small: they receive a description of what the build
+ * produced and transform or copy it into whatever shape the platform expects.
  */
 export interface TimberPlatformAdapter {
     /** Unique adapter name (e.g. 'cloudflare', 'node', 'bun'). */
@@ -26,18 +134,15 @@ export interface TimberPlatformAdapter {
      * Transform the build output for the target platform.
      * Called at the end of `timber build`.
      */
-    buildOutput(config: TimberConfig, buildDir: string): Promise<void>;
+    buildOutput(config: TimberConfig, artifacts: BuildArtifacts): Promise<void>;
     /**
      * Start a local preview server for the built output.
-     * Falls back to the built-in Node.js preview server if not provided.
-     */
-    preview?(config: TimberConfig, buildDir: string): Promise<void>;
-    /**
-     * Register a promise to be kept alive after the response is sent.
-     * Maps to platform-specific lifecycle extension (e.g. ctx.waitUntil()
-     * on Cloudflare Workers). Undefined if the platform doesn't support it.
+     * Falls back to Vite's preview server if not provided.
+     *
+     * Runs in a later process than the build (`timber preview`); see
+     * {@link PreviewTarget}.
      */
-    waitUntil?(promise: Promise<unknown>): void;
+    preview?(config: TimberConfig, target: PreviewTarget): Promise<void>;
     /**
      * Send 103 Early Hints to the client before the final response.
      *
@@ -50,4 +155,5 @@ export interface TimberPlatformAdapter {
      */
     sendEarlyHints?(links: string[]): void;
 }
+export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/adapters/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE;;;OAGG;IACH,OAAO,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE;;;;OAIG;IACH,SAAS,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAE5C;;;;;;;;;OASG;IACH,cAAc,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CACxC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAMA;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;;OAUG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,uCAAuC;AACvC,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,kBAAkB;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED,qDAAqD;AACrD,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,qDAAqD;AACrD,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACzD;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;AAEzE;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACrC,kFAAkF;IAClF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E;;;;;;OAMG;IACH,OAAO,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErE;;;;;;;;;OASG;IACH,cAAc,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CACxC"}

package/dist/analyze/chains.d.ts

@@ -0,0 +1,124 @@
+/**
+ * chains — boundary-aware import-chain stitching (the "why" answer).
+ *
+ * The human-meaningful import chain for a client-reachable module is a
+ * JOIN of two graphs: RSC-graph importers ABOVE the `'use client'`
+ * boundary and SSR-graph importers BELOW it. Walking `importers` naively
+ * in one graph produces virtual-entry noise (`virtual:vite-rsc/css`)
+ * instead of semantic importers — the design/47 §7 findings this module
+ * bakes in:
+ *
+ * - RSC-side walks terminate at `virtual:timber-route-manifest` or the
+ *   first route-convention file (page/layout/…), never the literal RSC
+ *   entry — route files' importer is the manifest, whose importers are
+ *   framework internals; the manifest is the semantic root.
+ * - `\0virtual:vite-rsc/*` importers are filtered so they can never
+ *   surface in a chain.
+ * - When multiple boundaries import the target, one chain is reported
+ *   PER BOUNDARY — a single BFS shortest path would pick arbitrarily.
+ *
+ * The chain/hop shapes and text formatting are shared with doc 43's
+ * `timber why` so both commands emit the same contract: hops carry
+ * `{ id, directive, boundary }`, and one shortest chain is emitted per
+ * (boundary, reaching route entry) pair — doc 43's "one shortest path
+ * per reaching entry", crossed with §7's per-boundary rule.
+ *
+ * Design docs: 47-module-environment-tooling.md §7, 43-analyze-cli.md
+ * §Output Formats.
+ */
+import { type Directive } from './classify.ts';
+/**
+ * Duck-typed view of a Vite environment module node — a supertype of
+ * `EnvironmentModuleNode` for the members the walk reads, so live
+ * dev-server graphs and crawl graphs both satisfy it structurally.
+ */
+export interface ChainModuleNode {
+    id: string | null;
+    url: string;
+    file: string | null;
+    importers: Set<ChainModuleNode>;
+}
+/** Duck-typed view of a Vite environment module graph. */
+export interface ChainGraph {
+    getModulesByFile(file: string): Set<ChainModuleNode> | undefined;
+}
+/** Per-hop directive in doc 43's JSON vocabulary. */
+export type HopDirective = 'client' | 'server' | null;
+export interface ChainHop {
+    /** Absolute file path, or a virtual module id printed verbatim. */
+    id: string;
+    directive: HopDirective;
+    /** True only on the hop that crosses the server→client boundary. */
+    boundary: boolean;
+}
+export interface ImportChain {
+    /**
+     * Semantic root: a route-convention file, or the route-manifest
+     * virtual id when the walk reached it without passing one. Null when
+     * the RSC-side walk dead-ended (no root found) — the chain then
+     * starts at its deepest known importer and consumers must present it
+     * as partial.
+     */
+    entry: string | null;
+    /**
+     * The `'use client'` file this chain crosses; null for a pure
+     * server-side chain.
+     */
+    boundary: string | null;
+    /** Hops in forward import order, entry → … → target. */
+    hops: ChainHop[];
+}
+export interface ChainContext {
+    rsc: ChainGraph;
+    ssr: ChainGraph;
+    /** Absolute app directory — scopes route-convention root detection. */
+    appDir: string;
+    /**
+     * Configured pageExtensions, when the caller has resolved the app
+     * config — a `page.mdx` app's route files are only roots with it.
+     * Omitted → scanner defaults.
+     */
+    pageExtensions?: readonly string[];
+    /**
+     * First directive of a file's ORIGINAL source (design/43: never the
+     * transformed output, where directives are stripped/proxied).
+     */
+    getDirective(file: string): Directive;
+}
+/**
+ * Stitch the import chain(s) for a target file.
+ *
+ * - Target in the SSR graph (client-side): walk SSR importers up to
+ *   each `'use client'` boundary that the RSC graph knows (nested
+ *   boundaries only reachable from other client components are walked
+ *   THROUGH — they exist in no RSC graph, so the chain must continue
+ *   to a boundary a server component actually references), then walk
+ *   RSC importers from that boundary to the semantic root. One chain
+ *   per boundary.
+ * - Target in the RSC graph without `'use client'`: a pure server
+ *   chain (boundary: null). Shared modules get both kinds.
+ * - Target IS an RSC-known boundary: an RSC-side chain from the target
+ *   itself, PLUS any outer-boundary chains the SSR walk finds — a
+ *   boundary imported by another boundary is pulled in by both. A
+ *   nested `'use client'` target the RSC graph does NOT know is
+ *   handled like any client-internal file — the SSR walk continues to
+ *   the boundary a server component references.
+ */
+export declare function stitchImportChains(rawTargetFile: string, rawCtx: ChainContext): ImportChain[];
+/**
+ * Render chains in doc 43's text shape — shared by `timber graph` and
+ * `timber why` so both commands print identically:
+ *
+ * ```
+ *   app/page.tsx
+ *     → app/nav.tsx  ← 'use client' [boundary]
+ *       → src/lib/icons/chevron.ts
+ * ```
+ *
+ * Paths under `projectRoot` print relative; virtual ids print verbatim
+ * (doc 43 §Relative-vs-Absolute Paths). A partial chain (entry: null)
+ * is prefixed with an honest marker instead of silently posing as
+ * complete.
+ */
+export declare function formatChains(chains: ImportChain[], projectRoot: string): string;
+//# sourceMappingURL=chains.d.ts.map