@nifrajs/web 0.1.0-alpha.1

package/dist/isr.js

@@ -0,0 +1,331 @@
+/**
+ * ISR (Incremental Static Regeneration). A caching layer that sits ABOVE the agnostic SSR
+ * handler: it stores a rendered `Response` keyed by URL and serves it with stale-while-revalidate
+ * freshness, so dynamic pages get static-like speed and revalidate in the background. Agnostic to the
+ * UI framework (it caches bytes), coupled to the runtime only through this pluggable {@link CacheStore}.
+ *
+ * This module is the store primitive; the SWR wrapper (`withISR`) builds on it next.
+ */
+import { isDraftEnabled } from "./draft.js";
+/**
+ * In-process ISR cache. Refuses to run in production unless explicitly allowed (mirrors the
+ * rate-limit `MemoryStore` — a per-instance cache is unsafe across instances). Bounded **LRU**: a
+ * read or write bumps the entry, so the least-recently-used evicts past `max` (a hot, frequently-read
+ * page survives a burst of new pages).
+ */
+export class MemoryCacheStore {
+    cache = new Map();
+    max;
+    constructor(options = {}) {
+        const isProd = typeof process !== "undefined" && process.env?.NODE_ENV === "production";
+        if (options.allowInProduction !== true && isProd) {
+            throw new Error("[nifra/web] MemoryCacheStore is per-instance and unsafe in production (each instance caches " +
+                "separately, and on-demand revalidation won't propagate). Use a shared store (Workers KV, " +
+                "Redis, the Cache API), or pass { allowInProduction: true } for a single-instance deploy.");
+        }
+        this.max = options.max ?? 500;
+    }
+    get(key) {
+        const value = this.cache.get(key);
+        // LRU: a read bumps the entry to the tail so the bounded evict drops the LEAST-RECENTLY-USED,
+        // not the oldest-written — otherwise a burst of new pages would evict a hot, frequently-read one.
+        if (value !== undefined) {
+            this.cache.delete(key);
+            this.cache.set(key, value);
+        }
+        return Promise.resolve(value);
+    }
+    set(key, value) {
+        this.cache.delete(key); // re-insert at the tail so Map order tracks recency (with get) for the LRU evict
+        this.cache.set(key, value);
+        while (this.cache.size > this.max) {
+            const oldest = this.cache.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.cache.delete(oldest);
+        }
+        return Promise.resolve();
+    }
+    delete(key) {
+        this.cache.delete(key);
+        return Promise.resolve();
+    }
+}
+/**
+ * Structural validation of a KV-read value before it's trusted as a {@link CachedResponse}. The store
+ * is a trust boundary (version skew across a deploy, corruption, tampering), so a malformed entry is
+ * treated as a miss (the page re-renders + overwrites it) rather than served as a broken response.
+ */
+const isCachedResponse = (value) => {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    if (typeof v.body !== "string" ||
+        typeof v.status !== "number" ||
+        typeof v.storedAt !== "number" ||
+        typeof v.revalidate !== "number" ||
+        typeof v.headers !== "object" ||
+        v.headers === null) {
+        return false;
+    }
+    for (const headerValue of Object.values(v.headers)) {
+        if (typeof headerValue !== "string")
+            return false;
+    }
+    return true;
+};
+/**
+ * A {@link CacheStore} backed by a **Cloudflare Workers KV** namespace (or any {@link KVNamespaceLike}
+ * binding) — the production-grade shared/durable store ISR wants: cached pages and on-demand purges
+ * hold *across* worker instances (unlike the per-instance {@link MemoryCacheStore}). Entries serialize
+ * to JSON; every read is validated before it's trusted (a malformed/version-skewed entry is treated as
+ * a miss). Construct it in your Workers `fetch` from the binding: `new KVCacheStore(env.ISR_CACHE)`.
+ */
+export class KVCacheStore {
+    kv;
+    putOptions;
+    constructor(kv, options = {}) {
+        if (options.expirationTtl !== undefined && options.expirationTtl < 60) {
+            throw new Error("[nifra/web] KVCacheStore expirationTtl must be >= 60 (Cloudflare KV's minimum), and should " +
+                "exceed your longest `revalidate` window so stale-while-revalidate isn't turned into a " +
+                "blocking miss by KV expiry.");
+        }
+        this.kv = kv;
+        // Precompute the put options object once: omit it entirely when no TTL (KV then never expires).
+        this.putOptions =
+            options.expirationTtl !== undefined ? { expirationTtl: options.expirationTtl } : undefined;
+    }
+    async get(key) {
+        const raw = await this.kv.get(key);
+        if (raw === null)
+            return undefined;
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            // A corrupt (non-JSON) entry: treat as a miss so the page re-renders; the next set overwrites it.
+            return undefined;
+        }
+        return isCachedResponse(parsed) ? parsed : undefined;
+    }
+    async set(key, value) {
+        await this.kv.put(key, JSON.stringify(value), this.putOptions);
+    }
+    async delete(key) {
+        await this.kv.delete(key);
+    }
+}
+/** Response header marking how an ISR response was served: a cache `hit` (fresh), `stale` (served +
+ * regenerating behind it), or `miss` (rendered now + stored). Useful for debugging + tests. */
+export const ISR_STATUS_HEADER = "x-nifra-isr";
+/**
+ * Response header a route uses to advertise its ISR freshness (**seconds**) to a {@link withISR}
+ * wrapper — `createWebApp` emits it from a route's `export const revalidate`. Deliberately distinct
+ * from the action-revalidation `x-nifra-revalidate` header (a CSV path list the *client* parses to
+ * refetch): this one is an integer TTL the *wrapper* reads, so the two channels never alias.
+ */
+export const ISR_REVALIDATE_HEADER = "x-nifra-isr-revalidate";
+const defaultKey = (req) => {
+    const url = new URL(req.url);
+    return url.origin + url.pathname + url.search;
+};
+/** ISR caches a full-document SSR response: a `GET` (not a data-mode soft-nav fetch), `200`, `text/html`.
+ * Assets, data-mode GETs, redirects, and errors pass through uncached. */
+const cacheControlHas = (headers, names) => {
+    const value = headers.get("cache-control");
+    if (value === null)
+        return false;
+    const directives = value
+        .toLowerCase()
+        .split(",")
+        .map((part) => part.trim().split("=", 1)[0]);
+    return names.some((name) => directives.includes(name));
+};
+const hasSetCookie = (headers) => headers.has("set-cookie") || (headers.getSetCookie?.().length ?? 0) > 0;
+const requestCarriesPrivateState = (req) => req.headers.has("authorization") || req.headers.has("cookie");
+const responseIsExplicitlyPublic = (res) => cacheControlHas(res.headers, ["public"]);
+const isCacheablePage = (req, res) => {
+    if (req.method !== "GET")
+        return false;
+    if (req.headers.get("x-nifra-data") !== null)
+        return false;
+    if (res.status !== 200)
+        return false;
+    if (!(res.headers.get("content-type") ?? "").includes("text/html"))
+        return false;
+    if (hasSetCookie(res.headers))
+        return false;
+    if (cacheControlHas(res.headers, ["private", "no-store"]))
+        return false;
+    // Cookie/Authorization requests often personalize HTML without setting a new cookie. Cache them only
+    // when the route explicitly declares the response public.
+    if (requestCarriesPrivateState(req) && !responseIsExplicitlyPublic(res))
+        return false;
+    return true;
+};
+const CACHEABLE_RESPONSE_HEADERS = new Set([
+    "cache-control",
+    "content-language",
+    "content-type",
+    "etag",
+    "last-modified",
+    "link",
+]);
+const headersOf = (res) => {
+    const out = {};
+    res.headers.forEach((value, key) => {
+        if (CACHEABLE_RESPONSE_HEADERS.has(key))
+            out[key] = value;
+    });
+    return out;
+};
+const responseFrom = (entry, status) => new Response(entry.body, {
+    status: entry.status,
+    headers: { ...sanitizeCachedHeaders(entry.headers), [ISR_STATUS_HEADER]: status },
+});
+function sanitizeCachedHeaders(headers) {
+    const out = {};
+    for (const [key, value] of Object.entries(headers)) {
+        const normalized = key.toLowerCase();
+        if (CACHEABLE_RESPONSE_HEADERS.has(normalized))
+            out[normalized] = value;
+    }
+    return out;
+}
+/**
+ * Wrap a nifra app with **Incremental Static Regeneration**: a cacheable page is served from
+ * {@link CacheStore} when fresh, served **stale while a fresh copy regenerates in the background**
+ * (`platform.waitUntil` on edge), or rendered + stored on a miss. Framework-agnostic (it caches the
+ * rendered bytes). Returns a `fetch(req, platform?)` handler — hand it to `Bun.serve`/the Workers
+ * `export default`, etc. Regeneration is single-flight per key (no stampede on a hot stale page).
+ *
+ * Each route's freshness comes from the `revalidate` header the app sets (per-route
+ * `export const revalidate`), falling back to `options.revalidate`. Only full-document `text/html`
+ * GET 200s are cached; everything else (assets, data-mode GETs, redirects, errors) passes through.
+ */
+export function withISR(app, options) {
+    const { store, now } = options;
+    const keyOf = options.key ?? defaultKey;
+    const draftSecret = options.draftSecret;
+    const regenerating = new Set();
+    // Per-page TTL (ms): the app's `x-nifra-isr-revalidate` header (seconds) if present, else the default.
+    const ttlMs = (res) => {
+        const header = res.headers.get(ISR_REVALIDATE_HEADER);
+        const seconds = header === null ? options.revalidate : Number(header);
+        return (Number.isFinite(seconds) ? seconds : options.revalidate) * 1000;
+    };
+    const render = async (req, platform, key) => {
+        const res = await app.fetch(req, platform);
+        if (!isCacheablePage(req, res))
+            return res;
+        const body = await res.text();
+        const entry = {
+            body,
+            status: res.status,
+            headers: headersOf(res),
+            storedAt: now(),
+            revalidate: ttlMs(res),
+        };
+        await store.set(key, entry);
+        return new Response(body, {
+            status: res.status,
+            headers: { ...entry.headers, [ISR_STATUS_HEADER]: "miss" },
+        });
+    };
+    // Background regeneration (single-flight per key) — a failed regen keeps the stale entry; the next
+    // stale hit retries. Never throws (it runs detached / under waitUntil).
+    const regenerate = async (req, platform, key) => {
+        if (regenerating.has(key))
+            return;
+        regenerating.add(key);
+        try {
+            const res = await app.fetch(req, platform);
+            if (isCacheablePage(req, res)) {
+                await store.set(key, {
+                    body: await res.text(),
+                    status: res.status,
+                    headers: headersOf(res),
+                    storedAt: now(),
+                    revalidate: ttlMs(res),
+                });
+            }
+            else {
+                await res.body?.cancel();
+            }
+        }
+        catch {
+            // keep the stale entry; a later request retries the regeneration
+        }
+        finally {
+            regenerating.delete(key);
+        }
+    };
+    return async (req, platform) => {
+        const key = req.method === "GET" ? keyOf(req) : null;
+        if (key === null)
+            return app.fetch(req, platform);
+        // Draft/preview: an editor (valid signed cookie) always renders fresh and is never cached, so
+        // unpublished content can't leak into the public cache (and the editor isn't served a stale page).
+        if (draftSecret !== undefined && (await isDraftEnabled(req, draftSecret))) {
+            return app.fetch(req, platform);
+        }
+        const hit = await store.get(key);
+        if (hit !== undefined) {
+            if (now() - hit.storedAt < hit.revalidate)
+                return responseFrom(hit, "hit");
+            // Stale: serve it now, regenerate behind it (waitUntil keeps the edge worker alive for the regen).
+            const task = regenerate(req, platform, key);
+            if (typeof platform?.waitUntil === "function")
+                platform.waitUntil(task);
+            else
+                void task.catch(() => { });
+            return responseFrom(hit, "stale");
+        }
+        return render(req, platform, key);
+    };
+}
+const jsonError = (status, error) => Response.json({ ok: false, error }, { status });
+/** Constant-time string equality (XOR-accumulate, no early exit). A length mismatch returns `false`
+ * up front — the length isn't the secret, and different-length buffers can't be compared in constant
+ * time anyway. Used to check the on-demand revalidation token without leaking it via timing. */
+function timingSafeEqual(a, b) {
+    const enc = new TextEncoder();
+    const ba = enc.encode(a);
+    const bb = enc.encode(b);
+    if (ba.length !== bb.length)
+        return false;
+    let diff = 0;
+    for (let i = 0; i < ba.length; i++)
+        diff |= ba[i] ^ bb[i];
+    return diff === 0;
+}
+/**
+ * An **on-demand revalidation** (purge) endpoint — a `fetch` handler that drops a path's cached entry
+ * so the next request re-renders. `POST` with the secret in the token header and the path as `?path=`
+ * or a JSON `{ "path": "/blog/x" }` body. The token is checked in **constant time** (wrong/missing →
+ * `401`); a missing/relative path → `400`; non-POST → `405`. Mount it on a nifra route, e.g.
+ * `app.post("/__nifra/revalidate", (c) => handler(c.req))`.
+ */
+export function revalidateEndpoint(options) {
+    const tokenHeader = options.tokenHeader ?? "x-nifra-revalidate-token";
+    const keyOf = options.key ?? ((path, req) => new URL(req.url).origin + path);
+    return async (req) => {
+        if (req.method !== "POST")
+            return jsonError(405, "method_not_allowed");
+        if (!timingSafeEqual(req.headers.get(tokenHeader) ?? "", options.secret)) {
+            return jsonError(401, "unauthorized");
+        }
+        let path = new URL(req.url).searchParams.get("path");
+        if (path === null) {
+            const body = await req.json().catch(() => null);
+            const candidate = typeof body === "object" && body !== null ? body.path : undefined;
+            path = typeof candidate === "string" ? candidate : null;
+        }
+        if (path === null || !path.startsWith("/"))
+            return jsonError(400, "invalid_path");
+        await options.store.delete(keyOf(path, req));
+        return Response.json({ revalidated: path });
+    };
+}
+//# sourceMappingURL=isr.js.map

package/dist/isr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isr.js","sourceRoot":"","sources":["../src/isr.ts"],"names":[],"mappings":"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"}

package/dist/manifest.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Route manifest — the fs-free heart of file-based routing. Maps route file paths to nifra
+ * router patterns + their nested layout chain. `discoverRoutes` (in `@nifrajs/web/fs`) scans
+ * the filesystem and feeds `buildManifest`; everything here is pure logic, so it stays
+ * portable (no fs, no DOM) and fully unit-testable. Edge deploys pre-build the manifest.
+ */
+/** Context passed to a route `loader`. The `api` + `env` are injected by `createWebApp` and typed
+ * per-route via `@nifrajs/client`'s `LoaderArgs<Api, Env>` (here they are opaque to the agnostic core). */
+export interface LoaderContext {
+    readonly params: Record<string, string>;
+    readonly request: Request;
+    readonly api: unknown;
+    /** Platform bindings forwarded from the request `c.env` (Workers env/KV/D1). Opaque here. */
+    readonly env: unknown;
+    /** `true` when the request carries a valid draft/preview cookie (only when `createWebApp` is given a
+     * `draftSecret`; otherwise always `false`). Branch on it to load unpublished content for editors. */
+    readonly draft: boolean;
+}
+/** A route's optional data loader: params/request in, data out. */
+export type Loader = (ctx: LoaderContext) => unknown | Promise<unknown>;
+/**
+ * A route's optional mutation, run on POST. Shares the loader context (params/request/api);
+ * read the form/JSON body off `request`. Returns either a `Response` (e.g. a redirect —
+ * passed straight through) or data, surfaced to the page component as `actionData`.
+ */
+export type Action = (ctx: LoaderContext) => unknown | Promise<unknown>;
+/** The document head a route contributes — title + `<meta>`/`<link>` tag attribute sets. */
+export interface Meta {
+    readonly title?: string;
+    readonly meta?: ReadonlyArray<Record<string, string>>;
+    readonly link?: ReadonlyArray<Record<string, string>>;
+}
+/** Args for a route's `meta` function: the loader's data + the route params. */
+export interface MetaArgs<Data = unknown> {
+    readonly data: Data;
+    readonly params: Record<string, string>;
+}
+/** A route's `meta`: a static {@link Meta}, or a function of the loader data + params. */
+export type MetaInput = Meta | ((args: MetaArgs) => Meta);
+/** One concrete parameterization of a dynamic route, returned by {@link GetStaticPaths}. */
+export interface StaticPath {
+    /** Values for the route's `:param` segments, e.g. `{ id: "7" }` for `/users/:id`. */
+    readonly params: Record<string, string>;
+}
+/** What a route's `getStaticPaths` returns: the param sets to prerender + the unlisted-path policy. */
+export interface StaticPaths {
+    readonly paths: readonly StaticPath[];
+    /**
+     * How a path NOT in `paths` is handled. `"ssr"` (default) → rendered on-demand by the worker
+     * (the natural hybrid behavior — an unlisted path simply isn't a static file); `"404"` → only the
+     * listed paths exist. Recorded by `prerenderRoutes` for the deploy layer.
+     */
+    readonly fallback?: "ssr" | "404";
+}
+/** A dynamic route's build-time param enumeration (the SSG equivalent of "which pages exist"). */
+export type GetStaticPaths = () => StaticPaths | Promise<StaticPaths>;
+/** A route module — the default component + optional loader / action / meta. */
+export interface RouteModule {
+    readonly default: unknown;
+    readonly loader?: Loader;
+    readonly action?: Action;
+    readonly meta?: MetaInput;
+    /**
+     * Opt this route out of nifra's full-document client hydration. The server still renders the full
+     * HTML document, loaders/actions still run, and native links/forms still work; the generated app
+     * client, route chunks, and loader globals are omitted for hard navigations. Intended for static or
+     * island-hydrated pages where interactivity is mounted by smaller, explicit client entries.
+     */
+    readonly hydrate?: boolean;
+    /**
+     * Opt a **static** route (no `:param`/`*`) into build-time prerendering (SSG): `prerenderRoutes`
+     * (from `@nifrajs/web/build`) renders it to a static `index.html` at build. The loader runs at build
+     * with the in-process `api` (build-safe data only — no per-request cookies/secrets); `defer()` on a
+     * prerendered route resolves at build. For **dynamic** routes use {@link getStaticPaths} instead.
+     */
+    readonly prerender?: boolean;
+    /**
+     * Enumerate the concrete params to prerender for a **dynamic** (`:param`) route — the SSG path list
+     * (blogs/docs/etc.). Runs at build; `prerenderRoutes` renders one `index.html` per returned path.
+     */
+    readonly getStaticPaths?: GetStaticPaths;
+    /**
+     * ISR freshness for this route, in **seconds**. `createWebApp` emits it as an `x-nifra-revalidate`
+     * response header that `withISR` reads to set the page's cache TTL (overriding the wrapper's
+     * default). Older-than-`revalidate` cached pages are served stale while regenerating.
+     */
+    readonly revalidate?: number;
+    /**
+     * No-framework island bundles (`@nifrajs/web/islands`) to load on this route, as `<script
+     * type="module">` in the document tail. Loaded **regardless of `hydrate`** — pair with
+     * `export const hydrate = false` for a static page that ships zero framework JS and mounts
+     * interactivity through `<Island>` markers + `mountIslands` enhancers instead.
+     */
+    readonly islandScripts?: readonly string[];
+}
+/** A layout (or `_404`/`_error`) entry: its source file (for client codegen) + a lazy loader. */
+export interface LayoutEntry {
+    readonly file: string;
+    readonly load: () => Promise<{
+        default: unknown;
+    }>;
+}
+/** One matched route: pattern, nested layout ids (outermost → innermost), source file, loader. */
+export interface RouteEntry {
+    readonly id: string;
+    readonly pattern: string;
+    readonly layoutIds: readonly string[];
+    /** `_error` boundary ids in this route's ancestor chain (outermost → innermost). The last is the
+     * **nearest** boundary, rendered when the route's loader throws. Always set by `buildManifest`
+     * (optional only so hand-built test manifests may omit it); absent/empty ⇒ no boundary (error 500s). */
+    readonly errorIds?: readonly string[];
+    readonly file: string;
+    readonly load: () => Promise<RouteModule>;
+}
+/** The full route manifest. */
+export interface Manifest {
+    readonly routes: readonly RouteEntry[];
+    readonly layouts: Readonly<Record<string, LayoutEntry>>;
+    /** Per-segment `_error` boundary components, keyed by id (`_error`, `a/_error`, …). Always set by
+     * `buildManifest` (optional only so hand-built test manifests may omit it). */
+    readonly errors?: Readonly<Record<string, LayoutEntry>>;
+    readonly notFound?: LayoutEntry;
+}
+/**
+ * Derive **every** nifra router pattern a route file maps to (relative to the routes dir):
+ * `index` → the parent path, `[id]` → `:id`, `[...slug]` → `*slug` (catch-all, captures the rest of
+ * the path into one param), `(group)` folders are dropped from the URL (organization only), and an
+ * optional `[[lang]]` expands the set — once with the segment present (`:lang`) and once absent. A file
+ * with no optionals yields exactly one pattern. Throws on an invalid param or a catch-all that isn't
+ * the last segment.
+ */
+export declare function filePathToPatterns(file: string): string[];
+/**
+ * The **canonical** single pattern for a route file — all optional segments present. A file with no
+ * optionals yields its one pattern. Use {@link filePathToPatterns} to get every pattern (optionals
+ * expand the set).
+ */
+export declare function filePathToPattern(file: string): string;
+/**
+ * Build a manifest from route file paths (relative to the routes dir) + an `importer` that
+ * turns a path into a lazy module loader. Pure — no fs. Throws at boot (the loud-and-early
+ * RouteConfigError ethos) on duplicate patterns. `_layout`/`_404`/`_error` files are special; other
+ * `_`-prefixed files are ignored (private/colocated, never routed).
+ */
+export declare function buildManifest(files: readonly string[], importer: (file: string) => () => Promise<RouteModule>): Manifest;
+/**
+ * Substitute a route pattern's `:param` segments with concrete values: `/users/:id` + `{id:"7"}` →
+ * `/users/7`. Returns the filled path plus any params that had no value (a `getStaticPaths` bug) so
+ * the caller can skip rather than emit a path with a literal `:name`. Shared by the SSG driver and
+ * {@link enumeratePrerenderedPaths}.
+ */
+export declare function fillRoutePattern(pattern: string, params: Record<string, string>): {
+    path: string;
+    missing: string[];
+};
+/** The static-routing facts a server needs from the route modules: which concrete paths are
+ * prerendered, plus each dynamic route's `getStaticPaths` fallback policy. */
+export interface StaticRoutes {
+    /** Concrete prerendered paths — static `prerender` routes + each `getStaticPaths` entry. */
+    readonly paths: string[];
+    /** Per dynamic route pattern, its `getStaticPaths` `fallback` (`"ssr"` default). `createWebApp` uses
+     * `"404"` to reject an unlisted path under that route at runtime (the path simply doesn't exist). */
+    readonly fallbacks: Record<string, "ssr" | "404">;
+}
+/**
+ * Enumerate the static-routing facts `prerenderRoutes` would produce — static routes opted in via
+ * `export const prerender = true`, each `getStaticPaths` entry of a dynamic route, and each dynamic
+ * route's `fallback` policy. Pure (no rendering), so a server can compute what to hand `createWebApp`
+ * (the prerendered set for the client's static-`_data.json` soft-nav + the fallback map for
+ * `"404"` enforcement). A production server may instead read the build's `prerendered.json` to avoid
+ * loading every route module at startup. Catch-all/wildcard routes and dynamic routes without
+ * `getStaticPaths` are omitted from `paths`.
+ */
+export declare function enumerateStaticRoutes(routes: readonly RouteEntry[]): Promise<StaticRoutes>;
+/** The prerendered-path subset of {@link enumerateStaticRoutes} — kept for callers that only need the
+ * paths (e.g. injecting `window.__NIFRA_PRERENDERED__`). */
+export declare function enumeratePrerenderedPaths(routes: readonly RouteEntry[]): Promise<string[]>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"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"}