@timber-js/app 0.2.0-alpha.2 → 0.2.0-alpha.200

package/dist/adapters/cloudflare.js

@@ -1,188 +1,2 @@
-import { join, relative } from "node:path";
-import { cp, mkdir, writeFile } from "node:fs/promises";
-import { AsyncLocalStorage } from "node:async_hooks";
-import { execFile } from "node:child_process";
-//#region src/adapters/cloudflare.ts
-var IMMUTABLE_CACHE = "public, max-age=31536000, immutable";
-var STATIC_CACHE = "public, max-age=3600, must-revalidate";
-function generateHeadersFile() {
-	return `# Auto-generated by @timber-js/app — static asset cache headers.
-# See design/25-production-deployments.md §"CDN / Edge Cache"
-
-/assets/*
-  Cache-Control: ${IMMUTABLE_CACHE}
-
-/*
-  Cache-Control: ${STATIC_CACHE}
-`;
-}
-var bindingsAls = new AsyncLocalStorage();
-/**
-* Get Cloudflare Worker bindings for the current request.
-*
-* Returns the `env` object passed to the Worker's `fetch` handler,
-* giving direct access to KV, D1, Durable Objects, R2, Queues, and
-* any other bindings configured in `wrangler.jsonc`.
-*
-* Must be called within a request context (server component, middleware,
-* server action). Throws outside a request.
-*
-* @example
-* ```ts
-* import { getCloudflareBindings } from '@timber-js/app/adapters/cloudflare'
-*
-* export default async function Page() {
-*   const { MY_KV, MY_DB } = getCloudflareBindings()
-*   const data = await MY_KV.get('key')
-*   return <div>{data}</div>
-* }
-* ```
-*/
-function getCloudflareBindings() {
-	const env = bindingsAls.getStore();
-	if (!env) throw new Error("getCloudflareBindings() called outside a Cloudflare Workers request context. It can only be called from server components, middleware, or server actions when running on the Cloudflare adapter.");
-	return env;
-}
-/**
-* Run a function with Cloudflare bindings available via getCloudflareBindings().
-* @internal Used by wrapWithExecutionContext.
-*/
-function runWithBindings(env, fn) {
-	return bindingsAls.run(env, fn);
-}
-/**
-* Create a Cloudflare Workers adapter.
-*
-* @example
-* ```ts
-* import { cloudflare } from '@timber-js/app/adapters/cloudflare'
-*
-* export default {
-*   output: 'server',
-*   adapter: cloudflare(),
-* }
-* ```
-*/
-function cloudflare(options = {}) {
-	return {
-		name: "cloudflare",
-		async buildOutput(config, buildDir) {
-			const outDir = join(buildDir, "cloudflare");
-			await mkdir(outDir, { recursive: true });
-			const clientDir = join(buildDir, "client");
-			const staticDir = join(outDir, "static");
-			await mkdir(staticDir, { recursive: true });
-			await cp(clientDir, staticDir, {
-				recursive: true,
-				filter: config.clientJavascriptDisabled ? (src) => !src.endsWith(".js") : void 0
-			}).catch(() => {});
-			await writeFile(join(staticDir, "_headers"), generateHeadersFile());
-			const rscDir = join(buildDir, "rsc");
-			const ssrDir = join(buildDir, "ssr");
-			await cp(rscDir, join(outDir, "rsc"), { recursive: true });
-			await cp(ssrDir, join(outDir, "ssr"), { recursive: true });
-			if (config.manifestInit) await writeFile(join(outDir, "_timber-manifest-init.js"), config.manifestInit);
-			const workerEntry = generateWorkerEntry(outDir, outDir, !!config.manifestInit);
-			await writeFile(join(outDir, "_worker.js"), workerEntry);
-			const wranglerConfig = generateWranglerConfig(config, options);
-			await writeFile(join(outDir, "wrangler.jsonc"), JSON.stringify(wranglerConfig, null, 2));
-		},
-		async preview(_config, buildDir) {
-			const cmd = generatePreviewCommand(buildDir);
-			await spawnPreviewProcess(cmd.command, cmd.args, cmd.cwd);
-		},
-		waitUntil(_promise) {}
-	};
-}
-/**
-* Wrap a timber request handler to bind the Cloudflare execution context
-* for `waitUntil()` support and env bindings passthrough.
-* Called from the generated worker entry.
-*
-* This function:
-* 1. Binds `adapter.waitUntil()` to `ctx.waitUntil()` per-request
-* 2. Makes `env` accessible via `getCloudflareBindings()` per-request via ALS
-*/
-function wrapWithExecutionContext(adapter, handler) {
-	return { async fetch(request, env, ctx) {
-		const originalWaitUntil = adapter.waitUntil;
-		adapter.waitUntil = (promise) => {
-			ctx.waitUntil(promise);
-		};
-		try {
-			return await runWithBindings(env, () => handler(request));
-		} finally {
-			adapter.waitUntil = originalWaitUntil;
-		}
-	} };
-}
-/** @internal Exported for testing. */
-function generateWorkerEntry(buildDir, outDir, hasManifestInit = false) {
-	let rscEntryRelative = relative(outDir, join(buildDir, "rsc", "index.js"));
-	if (!rscEntryRelative.startsWith(".")) rscEntryRelative = "./" + rscEntryRelative;
-	return `// Generated by @timber-js/app/adapters/cloudflare
-// Do not edit — this file is regenerated on each build.
-
-${hasManifestInit ? "import './_timber-manifest-init.js'\n" : ""}import handler from '${rscEntryRelative}'
-
-// Set TIMBER_RUNTIME for instrumentation.ts conditional SDK initialization.
-// See design/25-production-deployments.md §"TIMBER_RUNTIME".
-globalThis.process ??= { env: {} }
-process.env.TIMBER_RUNTIME = 'cloudflare'
-
-export default { fetch: handler }
-`;
-}
-/** @internal Exported for testing. */
-function generateWranglerConfig(config, options) {
-	const base = {
-		name: "timber-app",
-		main: "_worker.js",
-		compatibility_date: options.compatibilityDate ?? (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
-		compatibility_flags: options.compatibilityFlags ?? ["nodejs_compat"],
-		no_bundle: true,
-		find_additional_modules: true,
-		rules: [{
-			type: "ESModule",
-			globs: ["**/*.js"]
-		}],
-		assets: { directory: "./static" }
-	};
-	if (options.wrangler) return {
-		...base,
-		...options.wrangler
-	};
-	return base;
-}
-/** @internal Exported for testing. */
-function generatePreviewCommand(buildDir) {
-	const cfDir = join(buildDir, "cloudflare");
-	return {
-		command: "wrangler",
-		args: [
-			"dev",
-			"--local",
-			"--config",
-			join(cfDir, "wrangler.jsonc")
-		],
-		cwd: cfDir
-	};
-}
-/**
-* Spawn a long-running preview process and pipe stdio to the parent.
-* Resolves when the process exits.
-*/
-function spawnPreviewProcess(command, args, cwd) {
-	return new Promise((resolve, reject) => {
-		const child = execFile(command, args, { cwd }, (err) => {
-			if (err) reject(err);
-			else resolve();
-		});
-		child.stdout?.pipe(process.stdout);
-		child.stderr?.pipe(process.stderr);
-	});
-}
-//#endregion
-export { cloudflare, generatePreviewCommand, generateWorkerEntry, generateWranglerConfig, getCloudflareBindings, runWithBindings, wrapWithExecutionContext };
-
-//# sourceMappingURL=cloudflare.js.map
+import { a as generatePreviewCommand, c as generateWranglerConfig, d as readUserWranglerConfig, f as runWithBindings, i as generatePrebuiltSourceModule, l as getCloudflareBindings, n as cloudflare, o as generateRuntimeInitModule, r as generateBindingsConfig, s as generateWorkerEntry, t as buildStaticOutput, u as readPrebuiltData } from "../_chunks/cloudflare-BFb__LYG.js";
+export { buildStaticOutput, cloudflare, generateBindingsConfig, generatePrebuiltSourceModule, generatePreviewCommand, generateRuntimeInitModule, generateWorkerEntry, generateWranglerConfig, getCloudflareBindings, readPrebuiltData, readUserWranglerConfig, runWithBindings };

package/dist/adapters/compress-module.d.ts

@@ -1,10 +1,23 @@
 /**
- * Generate a standalone ESM module that exports compressResponse().
+ * Replace the shared-module imports with their values and reject anything
+ * else that would leave a dangling specifier in `_compress.mjs`.
  *
- * Written to `_compress.mjs` during buildOutput. Imported by the Nitro entry
- * and preview server.
+ * Exported separately from `generateCompressModule` so both branches can be
+ * driven with fixtures: the source it normally compiles is fixed, so a test
+ * of the generator alone can only ever exercise whichever branch that source
+ * happens to take today.
  *
  * @internal Exported for testing.
  */
-export declare function generateCompressModule(): string;
+export declare function inlineCompressImports(code: string): string;
+/**
+ * Compile server/compress.ts into a standalone ESM module.
+ *
+ * Uses Vite's OXC transform to strip TypeScript types from the
+ * embedded source. The result is written to `_compress.mjs` during
+ * buildOutput.
+ *
+ * @internal Exported for testing.
+ */
+export declare function generateCompressModule(): Promise<string>;
 //# sourceMappingURL=compress-module.d.ts.map

package/dist/adapters/compress-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compress-module.d.ts","sourceRoot":"","sources":["../../src/adapters/compress-module.ts"],"names":[],"mappings":"AAaA;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CA+E/C"}
+{"version":3,"file":"compress-module.d.ts","sourceRoot":"","sources":["../../src/adapters/compress-module.ts"],"names":[],"mappings":"AAkEA;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAe1D;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC,CAU9D"}

package/dist/adapters/fs-identity.d.ts

@@ -0,0 +1,64 @@
+/**
+ * What the output filesystem considers "the same file".
+ *
+ * Two build steps compare paths to decide whether two artifacts would land on
+ * one file — the render pass (`plugins/static-build.ts`) and the adapter's
+ * tree merge (`build-output-helper.ts`). Both are predicting a filesystem
+ * decision, so both ask the filesystem rather than comparing raw strings
+ * (TIM-1266).
+ *
+ * Two properties matter, and they are independent:
+ *
+ * - **Case folding.** macOS APFS and Windows NTFS fold by default, ext4 does
+ *   not. Dynamic params `Foo` and `foo` are one file on a Mac and two on
+ *   Linux CI.
+ * - **Unicode normalization.** APFS compares normalization-insensitively, so
+ *   `café` spelled NFC (`é`) and NFD (`e` + combining acute) address one
+ *   file. This holds even on a *case-sensitive* APFS volume, which is why it
+ *   is probed separately rather than inferred from case folding.
+ *
+ * Probed rather than read off `process.platform`: a case-sensitive volume on
+ * macOS and a case-insensitive mount on Linux are both ordinary, and the
+ * answer that matters is the one for the directory being written.
+ *
+ * Leaf module — Node built-ins only. Deliberately not in `adapters/shared.ts`,
+ * which `server/asset-headers.ts` re-exports from and which therefore must
+ * stay free of `node:fs` for the Workers bundle.
+ */
+/** How the output filesystem decides that two paths name one file. */
+export interface FsIdentity {
+    /** `Foo` and `foo` are the same file. */
+    caseInsensitive: boolean;
+    /** Canonically equivalent Unicode spellings are the same file. */
+    normalizationInsensitive: boolean;
+    /**
+     * Trailing dots and spaces are stripped from each segment, so `foo.` and
+     * `foo` are the same file. Win32 does this in path resolution rather than
+     * in the filesystem, which is why it is probed like the others.
+     */
+    stripsTrailingDotsAndSpaces: boolean;
+}
+/** Every path comparison is exact — the conservative answer when unprobed. */
+export declare const EXACT_FS_IDENTITY: FsIdentity;
+/**
+ * Probe `dir` by writing one file and asking for it under other spellings.
+ *
+ * Returns {@link EXACT_FS_IDENTITY} when the probe cannot run. That
+ * under-detects, but a directory this cannot write to is one the caller is
+ * about to fail on anyway, with a clearer error than a missed collision.
+ */
+export declare function detectFsIdentity(dir: string): Promise<FsIdentity>;
+/**
+ * Fold a path to the identity the filesystem compares it under.
+ *
+ * Normalization first, then case: `toLowerCase()` operates per code point, so
+ * folding a decomposed string first would leave the combining marks in a
+ * different order than folding a precomposed one.
+ *
+ * An approximation of the filesystem's own algorithm — APFS and NTFS fold per
+ * their own Unicode tables, which `toLowerCase()` matches for everything short
+ * of the exotic. It errs toward *finding* a collision, and the cost of a false
+ * positive is a build error naming two routes rather than a silent overwrite.
+ */
+export declare function fsKey(path: string, identity: FsIdentity): string;
+//# sourceMappingURL=fs-identity.d.ts.map

package/dist/adapters/fs-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-identity.d.ts","sourceRoot":"","sources":["../../src/adapters/fs-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH,sEAAsE;AACtE,MAAM,WAAW,UAAU;IACzB,yCAAyC;IACzC,eAAe,EAAE,OAAO,CAAC;IACzB,kEAAkE;IAClE,wBAAwB,EAAE,OAAO,CAAC;IAClC;;;;OAIG;IACH,2BAA2B,EAAE,OAAO,CAAC;CACtC;AAED,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,EAAE,UAI/B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAwBvE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,MAAM,CAKhE"}

package/dist/adapters/nitro-presets.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Supported Nitro deployment presets.
+ *
+ * Each preset maps to a Nitro deployment target. The adapter generates
+ * the appropriate configuration and entry point for the selected platform.
+ */
+export type NitroPreset = 'vercel' | 'vercel-edge' | 'netlify' | 'netlify-edge' | 'aws-lambda' | 'deno-deploy' | 'azure-functions' | 'node-server' | 'bun';
+/** Preset-specific Nitro configuration. */
+export interface PresetConfig {
+    /** Nitro preset name passed to the Nitro build. */
+    nitroPreset: string;
+    /** Output directory name within the build dir. */
+    outputDir: string;
+    /**
+     * Path to the server bundle directory relative to outputDir.
+     * Nitro places the bundled server entry + _chunks/ here.
+     * Most presets use `server`; Vercel uses `functions/__server.func`.
+     */
+    serverBundleDir: string;
+    /** Whether the runtime supports waitUntil. */
+    supportsWaitUntil: boolean;
+    /** Whether the runtime supports application-level 103 Early Hints. */
+    supportsEarlyHints: boolean;
+    /** Value for TIMBER_RUNTIME env var. See design/25-production-deployments.md. */
+    runtimeName: string;
+    /** Additional nitro.config fields for this preset. */
+    extraConfig?: Record<string, unknown>;
+}
+export declare const PRESET_CONFIGS: Record<NitroPreset, PresetConfig>;
+/** Presets that produce a locally-runnable server entry. */
+export declare const LOCALLY_PREVIEWABLE: Set<NitroPreset>;
+/**
+ * Get the preset configuration for a given preset name.
+ * @internal Exported for testing.
+ */
+export declare function getPresetConfig(preset: NitroPreset): PresetConfig;
+//# sourceMappingURL=nitro-presets.d.ts.map

package/dist/adapters/nitro-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nitro-presets.d.ts","sourceRoot":"","sources":["../../src/adapters/nitro-presets.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,aAAa,GACb,SAAS,GACT,cAAc,GACd,YAAY,GACZ,aAAa,GACb,iBAAiB,GACjB,aAAa,GACb,KAAK,CAAC;AAEV,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sEAAsE;IACtE,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,WAAW,EAAE,YAAY,CAmF5D,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,kBAA+C,CAAC;AAEhF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,CAEjE"}

package/dist/adapters/nitro-preview.d.ts

@@ -0,0 +1,32 @@
+import { type NitroPreset } from './nitro-presets.ts';
+/**
+ * Generate a standalone preview server script that uses Node's built-in
+ * HTTP server. This bypasses Nitro entirely — the Nitro entry.ts imports
+ * h3 which isn't available outside a Nitro build. For local preview we
+ * just need to serve static files and route requests to the RSC handler.
+ *
+ * @internal Exported for testing.
+ */
+export declare function generatePreviewScript(buildDir: string, preset: NitroPreset): string;
+/** Command descriptor for Nitro preview — testable without spawning. */
+export interface NitroPreviewCommand {
+    command: string;
+    args: string[];
+    cwd: string;
+}
+/** @internal Exported for testing. */
+export declare function generateNitroPreviewCommand(buildDir: string, preset: NitroPreset): NitroPreviewCommand | null;
+/** Spawn a Nitro preview process and pipe stdio. */
+export declare function spawnNitroPreview(command: string, args: string[], cwd: string): Promise<void>;
+/**
+ * Generate a standalone ESM module that exports sendNodeResponse.
+ *
+ * Mirrors srvx/node's sendNodeResponse: status + headers via writeHead,
+ * body streaming with backpressure (waits for drain on write() === false),
+ * and client disconnect cleanup. Written to `_send-response.mjs` during
+ * buildOutput for use by the preview server script. See TIM-1154.
+ *
+ * @internal Exported for testing.
+ */
+export declare function generateSendResponseModule(): string;
+//# sourceMappingURL=nitro-preview.d.ts.map

package/dist/adapters/nitro-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nitro-preview.d.ts","sourceRoot":"","sources":["../../src/adapters/nitro-preview.ts"],"names":[],"mappings":"AAQA,OAAO,EAAwC,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE5F;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAyNnF;AAED,wEAAwE;AACxE,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,sCAAsC;AACtC,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,GAClB,mBAAmB,GAAG,IAAI,CAY5B;AAED,oDAAoD;AACpD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS7F;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAuDnD"}

package/dist/adapters/nitro.d.ts

@@ -1,26 +1,14 @@
-import type { TimberPlatformAdapter } from './types';
+import { type NitroPreset } from './nitro-presets.ts';
+import type { TimberPlatformAdapter } from './types.ts';
+export type { NitroPreset } from './nitro-presets.ts';
 /**
- * Supported Nitro deployment presets.
+ * Static deploy target for `output: 'static'` mode.
  *
- * Each preset maps to a Nitro deployment target. The adapter generates
- * the appropriate configuration and entry point for the selected platform.
+ * Controls platform-specific files written alongside the static output:
+ * - `'github-pages'` — writes `.nojekyll` to skip Jekyll processing
+ * - `'generic'` — no extra files (default)
  */
-export type NitroPreset = 'vercel' | 'vercel-edge' | 'netlify' | 'netlify-edge' | 'aws-lambda' | 'deno-deploy' | 'azure-functions' | 'node-server' | 'bun';
-/** Preset-specific Nitro configuration. */
-interface PresetConfig {
-    /** Nitro preset name passed to the Nitro build. */
-    nitroPreset: string;
-    /** Output directory name within the build dir. */
-    outputDir: string;
-    /** Whether the runtime supports waitUntil. */
-    supportsWaitUntil: boolean;
-    /** Whether the runtime supports application-level 103 Early Hints. */
-    supportsEarlyHints: boolean;
-    /** Value for TIMBER_RUNTIME env var. See design/25-production-deployments.md. */
-    runtimeName: string;
-    /** Additional nitro.config fields for this preset. */
-    extraConfig?: Record<string, unknown>;
-}
+export type StaticTarget = 'github-pages' | 'generic';
 /** Options for the Nitro adapter. */
 export interface NitroAdapterOptions {
     /**
@@ -28,6 +16,28 @@ export interface NitroAdapterOptions {
      * @default 'node-server'
      */
     preset?: NitroPreset;
+    /**
+     * Enable application-level gzip compression for HTML and RSC responses.
+     *
+     * When `true` (default), the origin compresses responses using the Web
+     * `CompressionStream` API. This is useful for self-hosted deployments
+     * where no reverse proxy or CDN handles compression.
+     *
+     * Set to `false` when deploying behind a reverse proxy (nginx, caddy)
+     * or CDN (Cloudflare, Fastly, Vercel) that compresses at the edge.
+     * Disabling origin compression saves CPU on the Node.js event loop —
+     * compressing 1MB+ streaming HTML responses takes 10-15ms of main
+     * thread time per request, directly reducing throughput under load.
+     *
+     * @default true
+     */
+    compress?: boolean;
+    /**
+     * Static deploy target for `output: 'static'` mode. Controls
+     * platform-specific files (e.g. `.nojekyll` for GitHub Pages).
+     * @default 'generic'
+     */
+    staticTarget?: StaticTarget;
     /**
      * Additional Nitro configuration to merge into the generated config.
      * Overrides default values for the selected preset.
@@ -52,30 +62,65 @@ export interface NitroAdapterOptions {
  */
 export declare function nitro(options?: NitroAdapterOptions): TimberPlatformAdapter;
 /** @internal Exported for testing. */
-export declare function generateNitroEntry(buildDir: string, outDir: string, preset: NitroPreset, hasManifestInit?: boolean): string;
+export declare function generateNitroEntry(buildDir: string, outDir: string, preset: NitroPreset, compress?: boolean): string;
 /** @internal Exported for testing. */
-export declare function generateNitroConfig(preset: NitroPreset, userConfig?: Record<string, unknown>): string;
+export declare function isSuppressedNitroHint(message: unknown, prefixes?: readonly string[]): boolean;
 /**
- * Generate a standalone preview server script that uses Node's built-in
- * HTTP server. This bypasses Nitro entirely — the Nitro entry.ts imports
- * h3 which isn't available outside a Nitro build. For local preview we
- * just need to serve static files and route requests to the RSC handler.
+ * Nitro's rolldown and vite builders render `framework.previewCommand` /
+ * `framework.deployCommand` into these hints. A user who explicitly set one
+ * via `nitroConfig` has provided valid guidance — only suppress the hints
+ * whose command is still nitro's broken default.
  *
  * @internal Exported for testing.
  */
-export declare function generatePreviewScript(buildDir: string, preset: NitroPreset): string;
-/** Command descriptor for Nitro preview — testable without spawning. */
-export interface NitroPreviewCommand {
-    command: string;
-    args: string[];
-    cwd: string;
+export declare function selectSuppressedHintPrefixes(framework?: {
+    previewCommand?: string;
+    deployCommand?: string;
+}): string[];
+/** Minimal structural view of the nitro (consola) logger the wrap needs. */
+interface NitroBuildLogger {
+    success: (message: unknown, ...args: unknown[]) => void;
 }
-/** @internal Exported for testing. */
-export declare function generateNitroPreviewCommand(buildDir: string, preset: NitroPreset): NitroPreviewCommand | null;
 /**
- * Get the preset configuration for a given preset name.
+ * Wrap a nitro logger's `success` so hardcoded preview/deploy hints are
+ * dropped for this programmatic build only. Returns the original
+ * (unfiltered) success fn so timber can print its own hint — which shares
+ * the suppressed prefix on purpose, replacing nitro's wording.
+ *
+ * @internal Exported for testing.
+ */
+export declare function wrapNitroLoggerForBuild(logger: NitroBuildLogger, prefixes?: readonly string[]): NitroBuildLogger['success'];
+/**
+ * Timber's own post-build hint. Locally-runnable presets are previewed via
+ * `timber preview`, which invokes this adapter's `preview()` to run the
+ * generated `_preview-server.mjs`. Serverless presets get no hint — their
+ * output lives under `.timber/dist/nitro/`, so any cwd-relative deploy
+ * command would be as wrong as the nitro hint this replaces.
+ *
+ * @internal Exported for testing.
+ */
+export declare function getPostBuildHint(preset: NitroPreset): string | null;
+/**
+ * Resolve the destination path for prebuilt flight payloads in the Nitro
+ * output directory. The RSC entry resolves `../prebuilt/` relative to its
+ * bundled chunk location (`<serverBundleDir>/_chunks/`), so prebuilt/ must
+ * live at `<serverBundleDir>/prebuilt/`.
+ *
+ * The serverBundleDir varies by preset — Nitro's Vercel preset uses
+ * `functions/__server.func` while most others use `server`.
+ *
+ * @internal Exported for testing.
+ */
+export declare function resolvePrebuiltOutputPath(outDir: string, preset: NitroPreset): string;
+/**
+ * Copy prebuilt payloads into cloned Vercel function directories.
+ *
+ * When users configure `vercel.functionRules`, Nitro's compiled hook clones
+ * the base __server.func to per-route .func directories. These clones are
+ * created during `runNitroBuild()` — before our post-build prebuilt copy.
+ * Each clone resolves `../prebuilt` independently, so they each need a copy.
+ *
  * @internal Exported for testing.
  */
-export declare function getPresetConfig(preset: NitroPreset): PresetConfig;
-export {};
+export declare function copyPrebuiltToVercelFuncClones(functionsDir: string, prebuiltSrc: string, baseFuncName: string): Promise<void>;
 //# sourceMappingURL=nitro.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"nitro.d.ts","sourceRoot":"","sources":["../../src/adapters/nitro.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,qBAAqB,EAAgB,MAAM,SAAS,CAAC;AAsBnE;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,aAAa,GACb,SAAS,GACT,cAAc,GACd,YAAY,GACZ,aAAa,GACb,iBAAiB,GACjB,aAAa,GACb,KAAK,CAAC;AAEV,2CAA2C;AAC3C,UAAU,YAAY;IACpB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,sEAAsE;IACtE,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAgFD,qCAAqC;AACrC,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,KAAK,CAAC,OAAO,GAAE,mBAAwB,GAAG,qBAAqB,CA0F9E;AAID,sCAAsC;AACtC,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,EACnB,eAAe,UAAQ,GACtB,MAAM,CAsFR;AAED,sCAAsC;AACtC,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,MAAM,CAyBR;AAOD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAsKnF;AAED,wEAAwE;AACxE,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,sCAAsC;AACtC,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,GAClB,mBAAmB,GAAG,IAAI,CAY5B;AAyDD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,CAEjE"}
+{"version":3,"file":"nitro.d.ts","sourceRoot":"","sources":["../../src/adapters/nitro.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAuC,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAO3F,OAAO,KAAK,EAAgB,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAItE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItD;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,SAAS,CAAC;AAEtD,qCAAqC;AACrC,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,KAAK,CAAC,OAAO,GAAE,mBAAwB,GAAG,qBAAqB,CAwH9E;AAID,sCAAsC;AACtC,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,EACnB,QAAQ,UAAO,GACd,MAAM,CAmFR;AAkBD,sCAAsC;AACtC,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,QAAQ,GAAE,SAAS,MAAM,EAAmC,GAC3D,OAAO,CAET;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,CAAC,EAAE;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,MAAM,EAAE,CAKX;AAED,4EAA4E;AAC5E,UAAU,gBAAgB;IACxB,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACzD;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,GAAE,SAAS,MAAM,EAAmC,GAC3D,gBAAgB,CAAC,SAAS,CAAC,CAS7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAInE;AA+ED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAGrF;AAED;;;;;;;;;GASG;AACH,wBAAsB,8BAA8B,CAClD,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAoBf"}