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

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

@@ -0,0 +1,64 @@
+/** What the generated preview server serves, as `buildOutput` knows it. */
+export type PreviewScriptOptions = StaticPreviewScriptOptions | ServerPreviewScriptOptions;
+interface PreviewScriptOptionsBase {
+    /**
+     * `BuildArtifacts.immutableDirs` — served with a one-year immutable
+     * `Cache-Control`, every other file with a revalidating one.
+     */
+    immutableDirs: readonly string[];
+    /**
+     * The deployment base, normalized (`/` or `/repo/`). Requests arrive in
+     * deployed-URL space; files are laid out in route space, so the script
+     * strips it before looking anything up.
+     */
+    base: string;
+}
+/** A static build: serve the pre-rendered site and nothing else. */
+export interface StaticPreviewScriptOptions extends PreviewScriptOptionsBase {
+    output: 'static';
+    /** `StaticBuildArtifacts.contentTypes` — extensionless API route outputs. */
+    contentTypes: Readonly<Record<string, string>>;
+}
+/** A server build: serve `public/`, route everything else to the RSC handler. */
+export interface ServerPreviewScriptOptions extends PreviewScriptOptionsBase {
+    output: 'server';
+    /** Value for `TIMBER_RUNTIME`, set before the handler evaluates. */
+    runtimeName: string;
+    /** Import specifier of the RSC handler, relative to the script. */
+    rscEntry: string;
+    /**
+     * Whether this build wrote `_timber-manifest-init.js` beside the script.
+     * Recorded from the build, never probed: the Nitro output directory is not
+     * cleaned between server builds, so a file on disk can be a stale one.
+     */
+    hasManifestInit: 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, in a server build, route requests
+ * to the RSC handler.
+ *
+ * Generated at build time rather than at preview time, so everything it
+ * serves comes from the build's artifacts instead of guesses about the
+ * directory it runs in.
+ *
+ * @internal Exported for testing.
+ */
+export declare function generatePreviewScript(options: PreviewScriptOptions): string;
+/** 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;
+export {};
+//# 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":"AAuEA,2EAA2E;AAC3E,MAAM,MAAM,oBAAoB,GAAG,0BAA0B,GAAG,0BAA0B,CAAC;AAE3F,UAAU,wBAAwB;IAChC;;;OAGG;IACH,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,oEAAoE;AACpE,MAAM,WAAW,0BAA2B,SAAQ,wBAAwB;IAC1E,MAAM,EAAE,QAAQ,CAAC;IACjB,6EAA6E;IAC7E,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAChD;AAED,iFAAiF;AACjF,MAAM,WAAW,0BAA2B,SAAQ,wBAAwB;IAC1E,MAAM,EAAE,QAAQ,CAAC;IACjB,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAiR3E;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 {
     /**
@@ -44,6 +32,12 @@ export interface NitroAdapterOptions {
      * @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.
@@ -68,30 +62,53 @@ export interface NitroAdapterOptions {
  */
 export declare function nitro(options?: NitroAdapterOptions): TimberPlatformAdapter;
 /** @internal Exported for testing. */
-export declare function generateNitroEntry(buildDir: string, outDir: string, preset: NitroPreset, compress?: boolean, hasManifestInit?: boolean): string;
+export declare function generateNitroEntry(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;
+/**
+ * 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;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,KAAK,CAAC,OAAO,GAAE,mBAAwB,GAAG,qBAAqB,CA2F9E;AAID,sCAAsC;AACtC,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,EACnB,QAAQ,UAAO,EACf,eAAe,UAAQ,GACtB,MAAM,CAgGR;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,CA0KnF;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;AA8DD;;;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":"AAiBA,OAAO,EAAuC,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAO3F,OAAO,KAAK,EAIV,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAIpB,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,CAqK9E;AAgBD,sCAAsC;AACtC,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,UAAO,GAAG,MAAM,CAmF/E;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;AAgFD;;;;;;;;;GASG;AACH,wBAAsB,8BAA8B,CAClD,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAcf"}