@nifrajs/web 1.7.0 → 1.9.0

package/dist/query.js

@@ -1,9 +1,11 @@
 /**
  * The agnostic keyed query-cache — a `query(key, fn)` primitive with in-flight dedup, `staleTime`
- * freshness, prefix `invalidateQueries`, and bounded GC. Pure logic, no `window`, no framework, no
+ * freshness, prefix `invalidateQueries`, imperative cache read/write, prefetch, SSR dehydrate/hydrate,
+ * infinite (paged) queries, and standalone mutations. Pure logic, no `window`, no framework, no
  * `Date.now`/timers (the clock is injected) — so it unit-tests deterministically and is safe to import
- * from the SSR core's main entry. A per-adapter binding (`useQuery`/`createQuery`) subscribes to a
- * query's `subscribe`/`snapshot` store (the same shape the router + fetchers use).
+ * from the SSR core's main entry. A per-adapter binding (`useQuery`/`useMutation`/`createQuery`)
+ * subscribes to a query/mutation's `subscribe`/`snapshot` store (the same shape the router + fetchers
+ * use).
  *
  * This is a SECOND keyed cache, distinct from the router's path-keyed route cache (F16): route loaders
  * + navigation use the path cache; component-level interactive data (search, infinite scroll, polling)
@@ -41,9 +43,13 @@ const PENDING = Object.freeze({
     isFetching: false,
     updatedAt: Number.NEGATIVE_INFINITY,
 });
+/** Build a success state for freshly-set data (imperative writes + hydration). */
+function successState(data, updatedAt) {
+    return { status: "success", data, error: undefined, isFetching: false, updatedAt };
+}
 export function createQueryClient(options) {
     const { now } = options;
-    const staleTime = options.staleTime ?? 0;
+    const defaultStaleTime = options.staleTime ?? 0;
     const gcTime = options.gcTime ?? 5 * 60_000;
     const max = options.max ?? 1000;
     const cache = new Map();
@@ -64,17 +70,14 @@ export function createQueryClient(options) {
                 cache.delete(h); // oldest-inserted unsubscribed first (Map order)
         }
     };
-    const query = (key, fn) => {
-        sweep();
-        const h = hashQueryKey(key);
-        const existing = cache.get(h);
-        if (existing !== undefined) {
-            existing.fn = fn; // re-bind the latest closure
-            return existing.handle;
-        }
+    // Build a cache entry + its handle. `fn`/`staleTime` are mutated in place on re-bind (closures change
+    // between renders). All the fetch/dedup/generation machinery lives here so query(), prefetchQuery(),
+    // setQueryData(), and invalidateQueries() share exactly one implementation.
+    const makeEntry = (key, fn, staleTime) => {
         const entry = {
             key,
-            fn: fn,
+            fn,
+            staleTime,
             state: PENDING,
             promise: undefined,
             promiseGen: 0,
@@ -83,25 +86,25 @@ export function createQueryClient(options) {
             subscribers: 0,
             gcAt: undefined,
             listeners: new Set(),
-            // `handle` is assigned just below; the cast lets the entry reference itself.
+            setState: undefined,
+            run: undefined,
             handle: undefined,
         };
         const emit = () => {
-            // Iterate the live set — no per-emit copy (the common case is 0–1 subscribers; the spread
-            // allocated an array on every state transition ∝ subscriber count). Contract: a listener must
-            // not synchronously subscribe/unsubscribe during notification — `useSyncExternalStore`/signal/
-            // store bindings don't (un/subscribe happens in a later effect/cleanup tick).
+            // Iterate the live set — no per-emit copy (the common case is 0–1 subscribers). Contract: a
+            // listener must not synchronously subscribe/unsubscribe during notification — `useSyncExternalStore`/
+            // signal/store bindings don't (un/subscribe happens in a later effect/cleanup tick).
             if (entry.listeners.size === 0)
                 return;
             for (const l of entry.listeners)
                 l();
         };
-        const setState = (next) => {
+        entry.setState = (next) => {
             entry.state = Object.freeze(next);
             emit();
         };
-        const isStale = () => entry.invalidated || now() - entry.state.updatedAt >= staleTime;
-        const run = (force) => {
+        const isStale = () => entry.invalidated || now() - entry.state.updatedAt >= entry.staleTime;
+        entry.run = (force) => {
             // Dedup — but join the in-flight fetch ONLY when it belongs to the current generation. An
             // `invalidateQueries` bumps `generation`, so a fetch that started *before* the invalidation is
             // superseded and must NOT satisfy this call (its data is pre-mutation); fall through and kick a
@@ -111,7 +114,7 @@ export function createQueryClient(options) {
             if (!force && entry.state.status === "success" && !isStale())
                 return Promise.resolve(entry.state.data); // fresh cache hit — no fn call
             const gen = entry.generation;
-            setState({ ...entry.state, isFetching: true }); // show the background/initial fetch
+            entry.setState({ ...entry.state, isFetching: true }); // show the background/initial fetch
             const promise = (async () => {
                 try {
                     const data = await entry.fn();
@@ -121,18 +124,12 @@ export function createQueryClient(options) {
                     if (gen !== entry.generation)
                         return data;
                     entry.invalidated = false;
-                    setState({
-                        status: "success",
-                        data,
-                        error: undefined,
-                        isFetching: false,
-                        updatedAt: now(),
-                    });
+                    entry.setState(successState(data, now()));
                     return data;
                 }
                 catch (error) {
                     if (gen === entry.generation)
-                        setState({ ...entry.state, status: "error", error, isFetching: false });
+                        entry.setState({ ...entry.state, status: "error", error, isFetching: false });
                     throw error;
                 }
                 finally {
@@ -160,11 +157,28 @@ export function createQueryClient(options) {
                         entry.gcAt = now() + gcTime;
                 };
             },
-            fetch: () => run(false),
-            refetch: () => run(true),
+            fetch: () => entry.run(false),
+            refetch: () => entry.run(true),
         };
+        return entry;
+    };
+    // Get an entry by key, or create + insert a fresh one. `fn`/`staleTime` re-bind on an existing entry.
+    const upsert = (key, fn, staleTime) => {
+        const h = hashQueryKey(key);
+        const existing = cache.get(h);
+        if (existing !== undefined) {
+            existing.fn = fn;
+            existing.staleTime = staleTime;
+            return existing;
+        }
+        const entry = makeEntry(key, fn, staleTime);
         cache.set(h, entry);
-        return entry.handle;
+        return entry;
+    };
+    const query = (key, fn, opts) => {
+        sweep();
+        return upsert(key, fn, opts?.staleTime ?? defaultStaleTime)
+            .handle;
     };
     const invalidateQueries = (keyOrPrefix) => {
         for (const entry of cache.values()) {
@@ -179,6 +193,267 @@ export function createQueryClient(options) {
                 void entry.handle.refetch().catch(() => { }); // refresh mounted now (best-effort)
         }
     };
-    return { query, invalidateQueries };
+    const getQueryData = (key) => {
+        const entry = cache.get(hashQueryKey(key));
+        return entry !== undefined && entry.state.status === "success"
+            ? entry.state.data
+            : undefined;
+    };
+    const setQueryData = (key, updater) => {
+        // Create a placeholder entry if none exists — its `fn` throws until a real `query(key, fn)` re-binds
+        // it, so a `setQueryData` for a key nobody queries yet never triggers a fetch on its own.
+        const entry = upsert(key, cache.get(hashQueryKey(key))?.fn ??
+            (() => Promise.reject(new Error("[nifra/web] query has no fetcher (setQueryData-only key)"))), defaultStaleTime);
+        const prev = entry.state.status === "success" ? entry.state.data : undefined;
+        const data = typeof updater === "function" ? updater(prev) : updater;
+        // A direct write is the new truth — bump the generation so any in-flight fetch can't overwrite it,
+        // and clear the invalidated flag (the caller just supplied fresh data).
+        entry.generation++;
+        entry.invalidated = false;
+        entry.setState(successState(data, now()));
+    };
+    const prefetchQuery = async (key, fn, opts) => {
+        sweep();
+        await upsert(key, fn, opts?.staleTime ?? defaultStaleTime).run(false);
+    };
+    const dehydrate = () => {
+        const queries = [];
+        for (const entry of cache.values()) {
+            if (entry.state.status === "success")
+                queries.push({ key: entry.key, data: entry.state.data, updatedAt: entry.state.updatedAt });
+        }
+        return { queries };
+    };
+    const hydrate = (state) => {
+        for (const q of state.queries) {
+            const entry = upsert(q.key, cache.get(hashQueryKey(q.key))?.fn ??
+                (() => Promise.reject(new Error("[nifra/web] hydrated query has no fetcher yet"))), defaultStaleTime);
+            // Don't clobber a client entry that's already fresher than the server snapshot (the client may
+            // have refetched between SSR and hydration). Seed only when we have no successful data or the
+            // incoming snapshot is newer.
+            if (entry.state.status !== "success" || q.updatedAt > entry.state.updatedAt)
+                entry.setState(successState(q.data, q.updatedAt));
+        }
+    };
+    // --- Infinite (paged) queries -----------------------------------------------------------------
+    const infiniteQuery = (key, fn, opts) => {
+        sweep();
+        const h = hashQueryKey(key);
+        const existing = infinite.get(h);
+        if (existing !== undefined) {
+            existing.rebind(fn, opts);
+            return existing.handle;
+        }
+        const created = makeInfinite(fn, opts);
+        infinite.set(h, created);
+        return created.handle;
+    };
+    const infinite = new Map();
+    const makeInfinite = (fetchPage, initialOpts) => {
+        let fn = fetchPage;
+        let opts = initialOpts;
+        let state = PENDING;
+        let generation = 0;
+        let promise;
+        let subscribers = 0;
+        const listeners = new Set();
+        const emit = () => {
+            for (const l of listeners)
+                l();
+        };
+        const setState = (next) => {
+            state = Object.freeze(next);
+            emit();
+        };
+        const nextParam = (data) => {
+            const last = data.pages[data.pages.length - 1];
+            if (last === undefined)
+                return undefined;
+            return opts.getNextPageParam(last, data.pages, data.pageParams[data.pageParams.length - 1], data.pageParams);
+        };
+        const prevParam = (data) => {
+            if (opts.getPreviousPageParam === undefined || data.pages.length === 0)
+                return undefined;
+            return opts.getPreviousPageParam(data.pages[0], data.pages, data.pageParams[0], data.pageParams);
+        };
+        const isStale = () => now() - state.updatedAt >= (opts.staleTime ?? defaultStaleTime);
+        // Run a paged operation under a fresh generation, guarding against a superseding op (like `run`).
+        const runPaged = (build) => {
+            if (promise !== undefined)
+                return promise;
+            const gen = ++generation;
+            setState({ ...state, isFetching: true });
+            const p = (async () => {
+                try {
+                    const data = await build();
+                    if (gen !== generation)
+                        return data;
+                    setState(successState(data, now()));
+                    return data;
+                }
+                catch (error) {
+                    if (gen === generation)
+                        setState({ ...state, status: "error", error, isFetching: false });
+                    throw error;
+                }
+                finally {
+                    if (gen === generation)
+                        promise = undefined;
+                }
+            })();
+            promise = p;
+            return p;
+        };
+        const fetchFirst = (force) => {
+            if (!force && state.status === "success" && !isStale() && state.data !== undefined)
+                return Promise.resolve(state.data);
+            return runPaged(async () => {
+                const page = await fn(opts.initialPageParam);
+                return { pages: [page], pageParams: [opts.initialPageParam] };
+            });
+        };
+        const handle = {
+            snapshot: () => state,
+            subscribe: (listener) => {
+                subscribers++;
+                listeners.add(listener);
+                return () => {
+                    listeners.delete(listener);
+                    subscribers--;
+                };
+            },
+            fetch: () => fetchFirst(false),
+            refetch: () => runPaged(async () => {
+                const current = state.data;
+                if (current === undefined || current.pages.length === 0) {
+                    const page = await fn(opts.initialPageParam);
+                    return { pages: [page], pageParams: [opts.initialPageParam] };
+                }
+                // Refetch every loaded page in order with its original param, so the list stays the same size.
+                const pages = [];
+                for (const param of current.pageParams)
+                    pages.push(await fn(param));
+                return { pages, pageParams: [...current.pageParams] };
+            }),
+            fetchNextPage: () => {
+                const current = state.data;
+                if (current === undefined)
+                    return fetchFirst(false);
+                const param = nextParam(current);
+                if (param === undefined || param === null)
+                    return Promise.resolve(current);
+                return runPaged(async () => {
+                    const page = await fn(param);
+                    return { pages: [...current.pages, page], pageParams: [...current.pageParams, param] };
+                });
+            },
+            fetchPreviousPage: () => {
+                const current = state.data;
+                if (current === undefined)
+                    return fetchFirst(false);
+                const param = prevParam(current);
+                if (param === undefined || param === null)
+                    return Promise.resolve(current);
+                return runPaged(async () => {
+                    const page = await fn(param);
+                    return { pages: [page, ...current.pages], pageParams: [param, ...current.pageParams] };
+                });
+            },
+            hasNextPage: () => {
+                const p = state.data === undefined ? undefined : nextParam(state.data);
+                return p !== undefined && p !== null;
+            },
+            hasPreviousPage: () => {
+                const p = state.data === undefined ? undefined : prevParam(state.data);
+                return p !== undefined && p !== null;
+            },
+        };
+        return {
+            handle: handle,
+            rebind: (nextFn, nextOpts) => {
+                fn = nextFn;
+                opts = nextOpts;
+            },
+        };
+    };
+    return {
+        query,
+        infiniteQuery,
+        invalidateQueries,
+        getQueryData,
+        setQueryData,
+        prefetchQuery,
+        dehydrate,
+        hydrate,
+    };
+}
+const IDLE_MUTATION = Object.freeze({
+    status: "idle",
+    data: undefined,
+    error: undefined,
+    variables: undefined,
+});
+/**
+ * Create a standalone mutation state machine — framework-agnostic, so a per-adapter `useMutation`
+ * binding just subscribes to it. Single-flight by a monotonic token: overlapping `mutate` calls each
+ * run their `fn`, but only the latest publishes state (an older, slower response can't clobber a newer
+ * one). The callbacks fire in TanStack order: `onMutate` (before), then `onSuccess`/`onError`, then
+ * `onSettled`.
+ */
+export function createMutation(fn, callbacks = {}) {
+    let mutationFn = fn;
+    let cbs = callbacks;
+    let state = IDLE_MUTATION;
+    let token = 0;
+    const listeners = new Set();
+    const emit = () => {
+        for (const l of listeners)
+            l();
+    };
+    const setState = (next) => {
+        state = Object.freeze(next);
+        emit();
+    };
+    return {
+        snapshot: () => state,
+        subscribe: (listener) => {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        rebind: (nextFn, nextCallbacks) => {
+            mutationFn = nextFn;
+            cbs = nextCallbacks;
+        },
+        reset: () => setState(IDLE_MUTATION),
+        mutate: async (variables) => {
+            const mine = ++token;
+            setState({ status: "pending", data: undefined, error: undefined, variables });
+            // Only await a callback when one is actually supplied — an `await undefined` would insert a
+            // needless microtask before the mutationFn runs (and complicates single-flight timing).
+            if (cbs.onMutate !== undefined)
+                await cbs.onMutate(variables);
+            try {
+                const data = await mutationFn(variables);
+                if (mine === token)
+                    setState({ status: "success", data, error: undefined, variables });
+                if (cbs.onSuccess !== undefined)
+                    await cbs.onSuccess(data, variables);
+                if (cbs.onSettled !== undefined)
+                    await cbs.onSettled(data, undefined, variables);
+                return data;
+            }
+            catch (error) {
+                if (mine === token)
+                    setState({ status: "error", data: undefined, error, variables });
+                if (cbs.onError !== undefined)
+                    await cbs.onError(error, variables);
+                if (cbs.onSettled !== undefined)
+                    await cbs.onSettled(undefined, error, variables);
+                throw error;
+            }
+        },
+    };
 }
 //# sourceMappingURL=query.js.map

package/dist/query.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nifrajs/web",
-  "version": "1.7.0",
+  "version": "1.9.0",
   "description": "Framework-agnostic SSR core for nifra — the render seam + HTML document orchestration.",
   "keywords": [
     "bun",
@@ -112,7 +112,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@nifrajs/core": "1.7.0"
+    "@nifrajs/core": "1.9.0"
   },
   "peerDependencies": {
     "sass": "^1.0.0",

package/src/build.ts

@@ -5,7 +5,7 @@
  * are Bun-specific and never on the request path (own subpath, like `@nifrajs/web/fs`); the *output*
  * runs on any runtime.
  */
-import { mkdirSync, writeFileSync } from "node:fs"
+import { mkdirSync, rmSync, writeFileSync } from "node:fs"
 import { dirname, relative, resolve as resolvePath } from "node:path"
 import type { BunPlugin } from "bun"
 import { sanitizeOutputNames } from "./chunk-names.ts"
@@ -705,6 +705,11 @@ export async function buildClient(options: BuildClientOptions): Promise<BuildMan
     )
   }
 
+  // The generated client-entry SOURCE (`_nifra-entry.ts`) was written into outDir only to serve as a
+  // Bun.build entrypoint; the shipped artifact is the content-hashed `_nifra-entry-<hash>.js` the HTML
+  // references. Remove the leftover source so it never ships in a static deploy dir (nothing links it).
+  rmSync(entryFile, { force: true })
+
   // #4: a `node:` builtin (e.g. `node:crypto`) pulled into a CLIENT chunk builds fine (Bun substitutes
   // a browser polyfill) but breaks/leaks at runtime. Fail the build with a named, actionable error
   // instead — caught at build time, not by a confused user in the browser. Graph-based (the metafile's

package/src/client.ts

@@ -5,6 +5,7 @@
  * a full page load). DOM-only — never imported on the server, so the store stays SSR-safe.
  */
 import type { Meta } from "./manifest.ts"
+import { type BrowserNavigate, setBrowserNavigate } from "./navigation.ts"
 import type { ClientRouter } from "./router.ts"
 
 export interface InstallHistoryOptions {
@@ -80,9 +81,14 @@ export function installHistory(
     for (const p of [vt.ready, vt.finished, vt.updateCallbackDone]) p.catch(() => {})
   }
 
-  const go = (path: string, push: boolean): void => {
+  const go = (path: string, mode: "push" | "replace"): void => {
     const url = new URL(path, location.origin)
-    if (push) {
+    if (mode === "replace") {
+      // Replace the current entry with the new URL. The entry we're leaving is discarded, so its scroll
+      // isn't worth saving; the new route scrolls to its fragment target, else the top.
+      history.replaceState({}, "", path)
+      pendingScroll = url.hash !== "" ? { hash: hashId(url.hash) } : { pos: [0, 0] }
+    } else {
       // Save the leaving entry's scroll, push a fresh entry (URL incl. any #hash), then scroll the new
       // route: to the fragment target if one was given, else to the top.
       history.replaceState({ ...(history.state ?? {}), nifraScroll: [scrollX, scrollY] }, "")
@@ -93,6 +99,20 @@ export function installHistory(
     transition(() => router.navigate(url.pathname + url.search).catch(() => fallback(path)))
   }
 
+  // Programmatic navigation for adapter `useNavigate` bindings, published through the DOM-free bridge
+  // (`@nifrajs/web`'s `getBrowserNavigate`). A string path pushes (or replaces); a number is a history
+  // delta (`-1` back / `1` forward), matching `history.go`. An off-route / cross-origin push still goes
+  // through `go`, whose `router.navigate` no-ops an unmatched path and whose fetch-failure falls back to
+  // a full load — same graceful degradation as a link click.
+  const navigate: BrowserNavigate = (to, navOptions) => {
+    if (typeof to === "number") {
+      history.go(to)
+      return
+    }
+    go(to, navOptions?.replace === true ? "replace" : "push")
+  }
+  setBrowserNavigate(navigate)
+
   // Resolve an event target to an in-app route path, or null (cross-origin, unknown route, or an
   // anchor opting out via target/download/rel=external). Shared by click + hover/focus prefetch.
   const inAppHref = (target: EventTarget | null): string | null => {
@@ -121,7 +141,7 @@ export function installHistory(
     const href = inAppHref(event.target)
     if (href === null) return
     event.preventDefault()
-    go(href, true)
+    go(href, "push")
   }
 
   // Hover/focus an in-app link → warm its chunk + data (the store dedupes the spam).
@@ -165,6 +185,7 @@ export function installHistory(
   window.addEventListener("popstate", onPopState)
   return () => {
     unsubscribe()
+    setBrowserNavigate(undefined) // stop routing `useNavigate` to a torn-down router
     document.removeEventListener("click", onClick)
     document.removeEventListener("pointerover", onPrefetch)
     document.removeEventListener("focusin", onPrefetch)