@ultimat3/render 27.6.0 → 27.7.0

package/README.md

@@ -588,7 +588,9 @@ a job boundary the class is gone and the `code` is what survives — match on th
   `DEFAULT_ISR_REGENERATE_DEADLINE_MS` (30 s; `isrController({ regenerateDeadlineMs })`),
   so a render that never settles no longer pins the page for the life of the process. A stored
   path takes its TTL and tags from the most specific matching route (static > `:param` >
-  `*catch-all`, per segment), never the first in table order.
+  `*catch-all`, per segment), never the first in table order. The route is matched on the path
+  with its query and its routed locale prefix removed (`unlocalizedPath`), as the router matches
+  it — the key keeps both, so `/en/blog/a` is its own entry under `/blog/:slug`'s TTL and tags.
 - **A tag-revalidated ISR document carries its purge keys while it is shared-cacheable**,
   `As of 2026-10-02` — `@ultimat3/http`'s `cache-headers` stage rewrites the response to `private`
   for a signed-in visitor and strips both headers: `Surrogate-Key`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/render",
-  "version": "27.6.0",
+  "version": "27.7.0",
   "description": "The route primitive and the five render modes: static, isr, ssr, stream, spa.",
   "license": "MIT",
   "type": "module",
@@ -40,11 +40,11 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/cache": "27.6.0",
-    "@ultimat3/core": "27.6.0",
-    "@ultimat3/http": "27.6.0",
-    "@ultimat3/i18n": "27.6.0",
-    "@ultimat3/seo": "27.6.0",
+    "@ultimat3/cache": "27.7.0",
+    "@ultimat3/core": "27.7.0",
+    "@ultimat3/http": "27.7.0",
+    "@ultimat3/i18n": "27.7.0",
+    "@ultimat3/seo": "27.7.0",
     "sass": "1.105.1"
   }
 }

package/src/render-isr-store.ts

@@ -12,6 +12,8 @@ export interface IsrEntry {
    * The store key: the request's pathname AND its query, params sorted. Not the route's pattern
    * and not the bare pathname — `/blog?page=2` and `/blog?page=3` render different documents, and
    * keying both as `/blog` served the second visitor the first one's HTML (#171).
+   * A routed locale prefix stays on it (`/en/blog`): the controller removes it only to find the
+   * route, so a store may never use this as a route path.
    */
   readonly path: string;
   readonly html: string;

package/src/render-isr.ts

@@ -18,6 +18,7 @@ import {
 } from '@ultimat3/cache';
 import type { Scheduler } from '@ultimat3/core';
 import { finiteCount, logger, renderThrowable, singleFlight } from '@ultimat3/core';
+import { unlocalizedPath } from '@ultimat3/i18n';
 import { parseTtlMs } from './duration';
 import { finiteStatus, isRenderStatus } from './finite-status';
 import type { RouteDescriptor } from './registry';
@@ -64,15 +65,22 @@ export function isrKey(url: URL, locale: string): string {
 }
 
 /**
- * The route pattern a key belongs to. Every lookup that asks the ROUTE TABLE a question — the
- * descriptor, and therefore the TTL — has to strip the query first: `descriptorFor('/blog?page=2')`
- * matches no route, so the entry would silently fall back to `ttlMs: null` and a declared
- * `revalidate: { ttl: '5m' }` would become tag-only. Keying without this split is a half-fix that
- * trades a leak for a wrong TTL.
+ * The path the ROUTE TABLE knows a key by. Every lookup that asks the table a question — the
+ * descriptor, and therefore the TTL and the tags — has to undo what the key carries beyond the
+ * route, in the order the router does before it matches (`@ultimat3/http`'s `routing` stage):
+ *
+ * - the query: `descriptorFor('/blog?page=2')` matches no route;
+ * - the routed locale prefix: `/en/blog/a` is the `/blog/:slug` route in English. The key KEEPS the
+ *   prefix — it is the URL the document was rendered for, `canonical` and all — and the table has
+ *   never heard of it. Left on, a prefixed page matched no route: `ttlMs: null` and no tag edge, so
+ *   it was fresh forever while the default locale's copy of the same page went stale on schedule.
+ *
+ * `unlocalizedPath` is i18n's, the one the router's own split is built on: a segment that names no
+ * routed locale is left alone, so `/fr/blog` is still no route.
  */
 function routePathOf(key: string): string {
   const query = key.indexOf('?');
-  return query === -1 ? key : key.slice(0, query);
+  return unlocalizedPath(query === -1 ? key : key.slice(0, query));
 }
 
 /**