smoodly 0.0.49 → 0.0.51

package/dist/admin/ops-impl.js

@@ -5,7 +5,7 @@ import { canonicalTags, distinctTags } from "../tags.js";
 import { can, isMemberRole, normalizeRole } from "../permissions.js";
 import { ASSET_COLLECTION } from "../media.js";
 import { adminHref, adminSlugTaken, isAdminSlug } from "../admin-path.js";
-import { affectedTargets, collectionTag, entryTag, pageTag, pagesTreeTag, globalTag } from "../revalidate.js";
+import { addressesTag, affectedTargets, collectionTag, entryTag, pageTag, pagesTreeTag, globalTag } from "../revalidate.js";
 import { ensureFixedNodes, fixedNodeOf, fixedNodeSpecs } from "./fixed-nodes.js";
 import { ensureGlobalItems } from "./global-items.js";
 import { SLUG_GRAMMAR_MESSAGE, validateCustomNode, validateFields, validateNode } from "./validate.js";
@@ -268,10 +268,21 @@ export function createAdminOps(deps) {
         for (const id of unique)
             effects.revalidate(pageTag(id));
     };
-    /** The tree listing's unit (spec 2026-09-11 §2): every page op that changes what it shows. */
-    const expireTree = () => effects?.revalidate?.(pagesTreeTag());
-    /** A collection's list units: every entry write, since a non-versioned collection's published read is its live row. */
-    const expireCollection = (name) => effects?.revalidate?.(collectionTag(name));
+    /** The tree listing's unit (spec 2026-09-11 §2): every page op that changes what it shows. The same ops
+     *  change which addresses resolve, so the addresses tag fires with it (plan 2026-10-09 next cached routes). */
+    const expireTree = () => {
+        effects?.revalidate?.(pagesTreeTag());
+        effects?.revalidate?.(addressesTag());
+    };
+    /** A collection's list units: every entry write, since a non-versioned collection's published read is its live
+     *  row. An entry write can give an address a document or take it away, so the addresses tag fires with it —
+     *  except on a save that changed no slug (`addresses: false`): an autosave of fields moves no address, and a
+     *  tag that fired per keystroke would re-render every cached miss and code-owned page for nothing. */
+    const expireCollection = (name, options = {}) => {
+        effects?.revalidate?.(collectionTag(name));
+        if (options.addresses !== false)
+            effects?.revalidate?.(addressesTag());
+    };
     /** A node and every descendant, node first, in listPages() order. */
     const subtreeIds = async (id) => {
         const all = await pages.listPages();
@@ -900,7 +911,7 @@ export function createAdminOps(deps) {
                     if (below.length > 0)
                         await fanOut(below);
                 }
-                expireCollection(collection);
+                expireCollection(collection, { addresses: slugChanged }); // the slug is the address; nothing else in a save moves one
                 return ok(entry);
             }),
             setStatus: (collection, id, locale, status, expected) => guard(async () => {
@@ -1300,6 +1311,7 @@ export function createAdminOps(deps) {
                     return err("validation", `smoodly: "${path}" is the address of "${owner}".`);
                 }
                 await pages.addRedirect({ kind: target.kind, id: target.id, locale, path });
+                effects?.revalidate?.(addressesTag()); // a cached 404 at the old address must become the 308
                 return ok(null);
             }),
             remove: (locale, path) => guard(async () => {
@@ -1307,6 +1319,7 @@ export function createAdminOps(deps) {
                 if (unsupported)
                     return unsupported;
                 await pages.removeRedirect(locale, path); // the stored address, as list gave it
+                effects?.revalidate?.(addressesTag()); // a cached 308 must become the 404
                 return ok(null);
             }),
         },

package/dist/next/index.d.ts

@@ -6,4 +6,5 @@ export type { SmoodlyQueries, QueryOptions, EntriesQuery, TypedEntryItem, Global
 export { previewRoute } from "./preview-route.ts";
 export { previewPill } from "./preview-pill.tsx";
 export { createAdminRoute } from "./admin-route.ts";
+export { buildGate } from "./reads.ts";
 export type { AdminRouteDeps } from "./admin-route.ts";

package/dist/next/index.js

@@ -4,3 +4,4 @@ export { createSmoodlyQueries } from "./queries.js";
 export { previewRoute } from "./preview-route.js";
 export { previewPill } from "./preview-pill.js";
 export { createAdminRoute } from "./admin-route.js";
+export { buildGate } from "./reads.js";

package/dist/next/page-renderer.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-// The site-route seam (spec 2026-09-05 §5): the two route files call
-// renderSmoodlyPath; everything else — request gating, draft mode, 404s,
+// The site-route seam (spec 2026-09-05 §5): the starters' one route file calls
+// renderSmoodlyPath; everything else — the build-only gate, draft mode, 404s,
 // the editor bridge (through the lazy canvas stub) — lives here, over the
 // framework-free site layer. The reads are the read layer's units, keyed
 // by (locale, path, target) and tagged by id (../reads.ts), run by Next's
@@ -8,19 +8,18 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-run
 import { Suspense } from "react";
 import { draftMode } from "next/headers";
 import { notFound, permanentRedirect, unstable_rethrow } from "next/navigation";
-import { connection } from "next/server";
 import { BRIDGE_CSS } from "../marks.js";
 import { CanvasBridgeSlot, CanvasNetSlot } from "./canvas-slot.js";
 import { DRAFT_META_NAME } from "../admin/editor/canvas-diagnosis.js";
 import { fixedPathFor } from "../localize.js";
 import { decodeSegment, joinPath } from "../paths.js";
 import { renderPage } from "../render.js";
-import { globalUnit, hitUnit } from "../reads.js";
+import { globalUnit, hitUnit, missUnit } from "../reads.js";
 import { toEntryItem } from "../read-shapes.js";
 import { pageContextOf } from "../site.js";
 import { metadataFromSeo } from "./meta.js";
 import { previewPill } from "./preview-pill.js";
-import { nextReads } from "./reads.js";
+import { buildGate, nextReads } from "./reads.js";
 /** Logged once per renderer when Next's cacheComponents is on (spec 2026-09-27 cache components §2). */
 export const CACHE_COMPONENTS_WARNING = "smoodly: Next's cacheComponents is on, and Smoodly does not support it — a missing page answers 200 with noindex instead of 404, and a redirect answers 200 instead of 308. Turn cacheComponents off in next.config.ts; the Next.js guide's \"Cache Components\" section says why (https://smoodly.io/docs/frameworks/nextjs).";
 /** The canvas net (spec 2026-09-27 section guard §5): Server Components hand a section that failed to the
@@ -96,34 +95,47 @@ export function createPageRenderer(options) {
         console.warn(CACHE_COMPONENTS_WARNING);
     }
     async function page(pathFor, opts, accept) {
-        warnCacheComponents(); // before connection(), so a build's prerender prints it too
-        // A CMS route is request-rendered by construction: without this a
-        // route with no dynamic segment would be prerendered against the
-        // database at build time (DESIGN.md §3).
-        await connection();
+        warnCacheComponents(); // before buildGate(), so a build's prerender prints it too
+        // A CMS route renders on its first visit and is cached until a tag expires it (plan 2026-10-09 next
+        // cached routes): nothing here may touch a dynamic API at run time. At build, the gate keeps a route
+        // without a dynamic segment off the database (DESIGN.md §3).
+        await buildGate();
         const locale = opts?.locale ?? site.locales.default;
         const path = pathFor(locale);
         const { isEnabled: draft } = await draftMode();
-        const params = await opts?.searchParams;
+        // searchParams is a dynamic API: read inside draft mode only, where the render is dynamic anyway.
+        const params = draft ? await opts?.searchParams : undefined;
         // Both parameters exist only inside draft mode: the public site never sees an editor bridge or an old version.
         const editor = draft && params?.["smoodly-editor"] === "1";
         const versionParam = params?.["smoodly-version"];
         const version = draft && typeof versionParam === "string" && versionParam !== "" ? versionParam : undefined;
         const target = await site.locate(locale, path);
-        if (target?.redirect)
+        // No document to tag: a redirect row, a miss or a code-owned page. Next caches the response like a
+        // page, so it hears the addresses tag (reads.ts missUnit, decision 4).
+        const tagAddress = () => nextReads.run(missUnit(site));
+        if (target?.redirect) {
+            await tagAddress();
             await redirectTo(target, locale, params);
+        }
+        if (!target)
+            await tagAddress();
         // A code-owned address with no record yet is served from code (spec 2026-09-30 tester findings §2).
         const hit = target ? await load(target, locale, path, version) : site.codePage(locale, path);
-        if (!hit || !accept(hit))
+        if (!hit || !accept(hit)) {
+            if (target)
+                await tagAddress();
             notFound();
+        }
         // The draft marker tells the page editor's canvas diagnosis that Smoodly
         // rendered this response (spec 2026-09-27 shadowed-page detector §3);
         // React hoists the meta into the head. Never outside draft mode.
         return (_jsxs(_Fragment, { children: [draft ? _jsx("meta", { name: DRAFT_META_NAME }) : null, editor ? _jsx("style", { "data-smoodly-bridge": "", children: BRIDGE_CSS }) : null, editor ? _jsx(CanvasBridgeSlot, {}) : null, draft && !editor && !version ? previewPill({ route: options.previewRoute }) : null, render(hit, editor, locale)] }));
     }
     async function metadata(pathFor, opts, accept) {
-        // generateMetadata runs alongside the page render, so it gates too.
-        await connection();
+        // generateMetadata runs alongside the page render, so it gates too. It runs no miss unit: Next renders
+        // metadata and page in one work-unit store, so the route entry's tags are the union of both, and no
+        // metadata-only render path exists in the App Router (plan 2026-10-09 next cached routes).
+        await buildGate();
         const locale = opts?.locale ?? site.locales.default;
         const path = pathFor(locale);
         const target = await site.locate(locale, path);
@@ -145,13 +157,13 @@ export function createPageRenderer(options) {
     const any = () => true;
     /** The escape hatch may only render ITS OWN registration's record. */
     const only = (Page) => (hit) => hit.kind === "page" && hit.template === Page.schema.name;
-    /** Resolved AFTER connection(), inside page()/metadata(), so a wiring
+    /** Resolved AFTER buildGate(), inside page()/metadata(), so a wiring
      *  error surfaces as a rejected promise like every other failure. */
     const fixedPath = (Page) => (locale) => fixedPathFor(Page.schema, locale, site.locales, site.homePageSlug);
     const literal = (segments) => () => joinPath(segments.map(decodeSegment));
     /** A global item for a layout, by schema: the unit `q.getGlobal` runs for the same item and locale. */
     async function getSmoodlyGlobal(item, opts) {
-        await connection();
+        await buildGate();
         return nextReads.run(globalUnit(site, item, opts?.locale ?? site.locales.default));
     }
     return {

package/dist/next/reads.d.ts

@@ -1,2 +1,7 @@
 import type { ReadAdapter } from "../reads.ts";
+/** Waits for a request only while `next build` prerenders (`NEXT_PHASE`), so a route file without a
+ *  dynamic segment, and a layout above it, read nothing at build and need no keys. At run time it does
+ *  nothing: a cached render that called `connection()` would answer a 500. The app's glue calls it before
+ *  reading the environment (smoodly/server.ts), the renderer before every read. */
+export declare function buildGate(): Promise<void>;
 export declare const nextReads: ReadAdapter;

package/dist/next/reads.js

@@ -1,14 +1,25 @@
 // The read layer's adapter for Next (spec 2026-10-02 astro cloud fit §6): the one place in the Next glue
-// that knows where a read is cached. The gate is `connection()`, so a build prerenders nothing against
-// the database; inside draft mode a unit reads the live draft and touches no cache; outside it the
-// published read is one `unstable_cache` unit under the unit's key and tags, which the admin's
-// operations expire (revalidate.ts). Next's cache key is the callback's source text plus the key parts,
-// so every unit is cached from the one closure below (a unit's `tagsOf` is ignored: the tags go in before the read): a second call site would split a shared unit.
+// that knows where a read is cached. The gate is `buildGate`: `connection()` while `next build` prerenders,
+// so a route without a dynamic segment stays off the database at build; nothing at run time, because a
+// render Next caches must not touch a dynamic API (it answers a 500, plan 2026-10-09 next cached routes).
+// Inside draft mode a unit reads the live draft and touches no cache; outside it the published read is
+// one `unstable_cache` unit under the unit's key and tags, which the admin's operations expire
+// (revalidate.ts). Next's cache key is the callback's source text plus the key parts, so every unit is
+// cached from the one closure below (a unit's `tagsOf` is ignored: the tags go in before the read): a
+// second call site would split a shared unit.
 import { unstable_cache } from "next/cache";
 import { draftMode } from "next/headers";
 import { connection } from "next/server";
+/** Waits for a request only while `next build` prerenders (`NEXT_PHASE`), so a route file without a
+ *  dynamic segment, and a layout above it, read nothing at build and need no keys. At run time it does
+ *  nothing: a cached render that called `connection()` would answer a 500. The app's glue calls it before
+ *  reading the environment (smoodly/server.ts), the renderer before every read. */
+export async function buildGate() {
+    if (process.env.NEXT_PHASE === "phase-production-build")
+        await connection();
+}
 export const nextReads = {
-    gate: () => connection(),
+    gate: () => buildGate(),
     async run(unit) {
         const { isEnabled: draft } = await draftMode();
         if (draft)

package/dist/reads.d.ts

@@ -57,6 +57,12 @@ export type SmoodlyQueries<C extends readonly CollectionSchema<any, string>[], S
  *  record, which fires no tag — can never serve the previous occupant (spec 2026-09-29 pre-install fixes
  *  §5). `version` is History's stored version and counts inside draft mode only. */
 export declare function hitUnit(site: SmoodlySite, target: PathTarget, locale: string, path: string, version?: string): ReadUnit<SiteHit | null>;
+/** An address with no document to tag — a miss, a redirect row or a code-owned page. The unit reads
+ *  nothing: it exists so a cached response hears the `addresses` tag, which every address-changing
+ *  operation fires (revalidate.ts). Next runs it (its route cache stores a 404 like a page); Astro never
+ *  caches such a response and does not call it. One key for every address: the tag reaches the route
+ *  entry before the lookup, so a per-address key would only write one data-cache row per scanned 404. */
+export declare function missUnit(site: SmoodlySite): ReadUnit<null>;
 /** Astro's route read of an address: one lookup outside draft mode — the tags come with the document, so no
  *  locate comes first; in draft mode, locate then load as the editing tables need (spec 2026-10-07 delivery
  *  model §3). A redirect row answers as a redirect; a code-owned page answers where no record lives. */

package/dist/reads.js

@@ -1,5 +1,5 @@
 import { referencedCollections } from "./read-shapes.js";
-import { collectionTag, entryTag, globalTag, pageTag, pagesTreeTag } from "./revalidate.js";
+import { addressesTag, collectionTag, entryTag, globalTag, pageTag, pagesTreeTag } from "./revalidate.js";
 /** JSON with object keys sorted at every level and `undefined` dropped, so two spellings of one query share a unit. */
 function stable(value) {
     if (Array.isArray(value))
@@ -28,6 +28,14 @@ export function hitUnit(site, target, locale, path, version) {
         read: (draft) => draft ? site.load(target, locale, path, { draft: true, ...(version !== undefined ? { version } : {}) }) : site.load(target, locale, path),
     };
 }
+/** An address with no document to tag — a miss, a redirect row or a code-owned page. The unit reads
+ *  nothing: it exists so a cached response hears the `addresses` tag, which every address-changing
+ *  operation fires (revalidate.ts). Next runs it (its route cache stores a 404 like a page); Astro never
+ *  caches such a response and does not call it. One key for every address: the tag reaches the route
+ *  entry before the lookup, so a per-address key would only write one data-cache row per scanned 404. */
+export function missUnit(site) {
+    return { key: ["smoodly-miss", site.cacheKey], tags: [addressesTag()], read: async () => null };
+}
 /** Astro's route read of an address: one lookup outside draft mode — the tags come with the document, so no
  *  locate comes first; in draft mode, locate then load as the editing tables need (spec 2026-10-07 delivery
  *  model §3). A redirect row answers as a redirect; a code-owned page answers where no record lives. */

package/dist/revalidate.d.ts

@@ -18,6 +18,11 @@ export declare const pagesTreeTag: () => string;
 /** A collection's list units: fired by every entry write in the
  *  collection, since a non-versioned collection's published read is its live row. */
 export declare const collectionTag: (name: string) => string;
+/** Every address that may begin or stop resolving: a miss, a redirect and a code-owned page cache
+ *  under it on Next (reads.ts `missUnit`), since Next caches a 404 like a hit (plan 2026-10-09 next
+ *  cached routes, decision 4). Fired by every page op that fires the tree tag, every entry write and
+ *  every redirect change (admin/ops-impl.ts). */
+export declare const addressesTag: () => string;
 export declare function affectedTargets(stores: {
     pages: PageStore;
     entries: EntryStore;

package/dist/revalidate.js

@@ -17,6 +17,11 @@ export const pagesTreeTag = () => "pages:tree";
 /** A collection's list units: fired by every entry write in the
  *  collection, since a non-versioned collection's published read is its live row. */
 export const collectionTag = (name) => `entries:${name}`;
+/** Every address that may begin or stop resolving: a miss, a redirect and a code-owned page cache
+ *  under it on Next (reads.ts `missUnit`), since Next caches a 404 like a hit (plan 2026-10-09 next
+ *  cached routes, decision 4). Fired by every page op that fires the tree tag, every entry write and
+ *  every redirect change (admin/ops-impl.ts). */
+export const addressesTag = () => "addresses";
 export async function affectedTargets(stores, entryId, options = {}) {
     const maxDepth = options.maxDepth ?? Infinity;
     const seen = new Set([entryId]);

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const SMOODLY_VERSION = "0.0.49";
+export declare const SMOODLY_VERSION = "0.0.51";

package/dist/version.js

@@ -1,2 +1,2 @@
 // Generated by scripts/write-version.mjs from package.json — do not edit.
-export const SMOODLY_VERSION = "0.0.49";
+export const SMOODLY_VERSION = "0.0.51";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smoodly",
-  "version": "0.0.49",
+  "version": "0.0.51",
   "description": "Open-source, code-first CMS for Astro and Next.js on Supabase: define a component once, it becomes a typed, editable building block.",
   "license": "MIT",
   "repository": {