@rangojs/router 0.21.0 → 0.22.0

package/dist/types/urls/path-helper.d.ts

@@ -1,4 +1,22 @@
+import type { Handler } from "../types.js";
 import type { PathFn, ResponsePathFn, JsonResponsePathFn, TextResponsePathFn } from "./path-helper-types.js";
+/**
+ * A retained on-demand producer must never render on a live production
+ * request: bundle eviction is skipped for onDemand routes (the producer body
+ * stays available for router.prerender()), so without this gate an
+ * overlay+manifest miss on a plain Prerender(..., { onDemand }) route would
+ * execute the producer in-request — uncached per-request renders with the
+ * personalization guard unarmed. Keep the pre-retention miss contract instead
+ * (DataNotFoundError -> 404). Producer runs (build-time bake and
+ * router.prerender()) arrive with ctx.build true (createPrerenderContext);
+ * Vite dev keeps the documented live fall-through on a dev-store miss, except
+ * for a page the overlay marks removed (`_prerenderRemoved`): a live render
+ * would show in dev a page production answers with a 404.
+ * Pass-through when the route is not onDemand.
+ *
+ * @internal Exported for the unit test.
+ */
+export declare function gateOnDemandProducer<TEnv>(producer: Handler<any, any, TEnv>, isOnDemand: boolean): Handler<any, any, TEnv>;
 export declare function createPathHelper<TEnv>(): PathFn<TEnv>;
 export declare function attachPathResponseTags<TEnv>(pathFn: PathFn<TEnv>): PathFn<TEnv> & {
     json: JsonResponsePathFn<TEnv>;

package/dist/types/vite/discovery/state.d.ts

@@ -63,6 +63,7 @@ export interface ChunkInfo {
         name: string;
         handlerId: string;
         passthrough: boolean;
+        onDemand: boolean;
     }>;
 }
 export interface PerRouterManifestEntry {
@@ -159,6 +160,16 @@ export interface DiscoveryState {
     buildData: import("./build-versions.js").BuildDataRecord[];
     handlerChunkInfoMap: Map<string, ChunkInfo>;
     staticHandlerChunkInfoMap: Map<string, ChunkInfo>;
+    /**
+     * handlerId ($$id) -> route name for every route the evaluated source marks
+     * onDemand. Written during discovery (buildStart), consumed by the
+     * generateBundle chunk scan (extractHandlerExportsFromChunk) as the
+     * authoritative onDemand set driving producer retention — the same source
+     * that sets the runtime od trie flag, so any truthy onDemand spelling
+     * (literal, spread, imported const) both marks the route and retains its
+     * producer.
+     */
+    onDemandHandlerIds: Map<string, string>;
     rscEntryFileName: string | null;
     resolvedPrerenderModules: Map<string, string[]> | undefined;
     resolvedStaticModules: Map<string, string[]> | undefined;

package/dist/types/vite/inject-client-debug.d.ts

@@ -1,28 +1,9 @@
 import type { Connect } from "vite";
-/**
- * Bake the resolved INTERNAL_RANGO_DEBUG value into the router's `internal-debug`
- * module so the flag reaches the CLIENT debug logs by just setting the env var.
- *
- * internal-debug.ts normally reads the flag via `typeof __RANGO_DEBUG__`, a Vite
- * define. That delivery is unreliable on the client: in dev Vite ships the define
- * only as an injected global whose presence varies across consumer setups, so the
- * module can fall through to `process.env` (undefined in the browser) and the FE
- * debug flag silently stays false while the server logs work. A Vite `transform`
- * runs on the module regardless of how (or whether) the define is delivered, in
- * both dev and build and for every environment, so the discovery plugin uses this
- * to replace the module with the resolved literal.
- */
-/**
- * Scope to the router's own internal-debug module: the published package
- * (`/@rangojs/router/`, incl. pnpm's nested layout) or the monorepo workspace
- * (`/packages/rangojs-router/`). The package-anchored path avoids matching a
- * consumer file that merely sits under a directory named `rangojs-router`.
- * Accepts module ids and dev-server URLs (`/@fs/...internal-debug.ts?v=abc`).
- */
+/** A router flag module: internal-debug.ts or internal-suspense-audit.ts. */
 export declare function isRouterInternalDebugId(id: string): boolean;
 /**
- * Transform: replace the module with the resolved literal.
- * Returns null for any module that is not the router's internal-debug module.
+ * Transform: replace a router flag module with the resolved literal.
+ * Returns null for any other module.
  */
 export declare function injectClientDebugFlag(id: string): {
     code: string;
@@ -44,9 +25,9 @@ export declare function injectClientDebugFlag(id: string): {
  * immune -- workspace source is outside node_modules and served no-cache --
  * which is why this bit only npm consumers.
  *
- * internal-debug.ts is the ONLY flag-varying module in the graph (its importers
- * are byte-identical across flag states), so forcing revalidation for this one
- * tiny module is sufficient and costs one conditional request per session. The
+ * The two flag modules are the only flag-varying modules in the graph (their
+ * importers are byte-identical across flag states), so forcing revalidation for
+ * them is sufficient and costs a conditional request each per session. The
  * middleware is unconditional (not gated on the flag) so an already-poisoned
  * cache heals in both directions. Alternatives that do not work: a plugin
  * `resolveId` appending a flag query never fires in Vite 8 dev for

package/dist/types/vite/utils/bundle-analysis.d.ts

@@ -6,12 +6,15 @@
 export declare function findMatchingParenInBundle(code: string, openParenPos: number): number;
 /**
  * Scan a bundled chunk for handler exports and extract their names + $$id values.
- * Optionally detects passthrough flag. @internal Exported for testing only.
+ * Optionally detects the passthrough flag by parsing the call body, and marks
+ * onDemand from the authoritative discovery-derived handlerId set.
+ * @internal Exported for testing only.
  */
-export declare function extractHandlerExportsFromChunk(chunkCode: string, handlerModules: Map<string, string[]>, fnName: string, detectPassthrough: boolean): Array<{
+export declare function extractHandlerExportsFromChunk(chunkCode: string, handlerModules: Map<string, string[]>, fnName: string, detectPassthrough: boolean, onDemandHandlerIds?: ReadonlyMap<string, string>): Array<{
     name: string;
     handlerId: string;
     passthrough: boolean;
+    onDemand: boolean;
 }>;
 /**
  * Evict handler code from a bundled chunk, replacing full call expressions with stubs.
@@ -22,6 +25,7 @@ export declare function evictHandlerCode(code: string, exports: Array<{
     name: string;
     handlerId: string;
     passthrough?: boolean;
+    onDemand?: boolean;
 }>, fnName: string, brand: string): {
     code: string;
     savedBytes: number;