@nifrajs/web 2.9.1 → 2.10.0

package/dist/route-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-manifest.d.ts","sourceRoot":"","sources":["../src/route-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE1D;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,KAAK,CAAA;AAEjD,uEAAuE;AACvE,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,cAAc,CAAA;AAEvD,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,iGAAiG;IACjG,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC7C,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAA;CAC9C;AAED,wGAAwG;AACxG,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAA;IACpC,sFAAsF;IACtF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED,2FAA2F;AAC3F,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAC9C,QAAQ,CAAC,SAAS,EAAE,SAAS,qBAAqB,EAAE,CAAA;IACpD,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAA;CACtD;AAKD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,gBAAgB,GAAG,YAAY,GAAG,SAAS,CAAC,EACpF,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,GACnC,kBAAkB,CAyBpB;AA0BD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE;IACP,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAA;IAClE,mGAAmG;IACnG,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;CAC9C,GACL,OAAO,CAAC,aAAa,CAAC,CAuCxB;AAED,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CA2CnE"}
+{"version":3,"file":"route-manifest.d.ts","sourceRoot":"","sources":["../src/route-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE1D;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,KAAK,CAAA;AAEjD,uEAAuE;AACvE,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,cAAc,CAAA;AAEvD,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,iGAAiG;IACjG,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC7C,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAA;CAC9C;AAED,wGAAwG;AACxG,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAA;IACpC,sFAAsF;IACtF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED,2FAA2F;AAC3F,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAC9C,QAAQ,CAAC,SAAS,EAAE,SAAS,qBAAqB,EAAE,CAAA;IACpD,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAA;CACtD;AAKD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,IAAI,CACV,WAAW,EACX,WAAW,GAAG,gBAAgB,GAAG,YAAY,GAAG,gBAAgB,GAAG,SAAS,CAC7E,EACD,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,GACnC,kBAAkB,CA6BpB;AA0BD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE;IACP,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAA;IAClE,mGAAmG;IACnG,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;CAC9C,GACL,OAAO,CAAC,aAAa,CAAC,CAuCxB;AAED,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CA2CnE"}

package/dist/route-manifest.js

@@ -24,6 +24,9 @@ export function deriveRouteEntry(id, pattern, module, prerenderedPaths) {
     const entry = { id, pattern, mode, hydrate: module.hydrate !== false, requires };
     if (mode === "isr" && module.revalidate !== undefined)
         entry.revalidate = module.revalidate;
+    if (mode === "isr" && module.revalidateTags !== undefined) {
+        entry.revalidateTags = module.revalidateTags;
+    }
     if (prerenderedPaths !== undefined)
         entry.prerenderedPaths = prerenderedPaths;
     return entry;

package/dist/route-manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"route-manifest.js","sourceRoot":"","sources":["../src/route-manifest.ts"],"names":[],"mappings":"AAwEA,+EAA+E;AAC/E,MAAM,SAAS,GAAG,CAAC,OAAe,EAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AAEpE;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,EAAU,EACV,OAAe,EACf,MAAoF,EACpF,gBAAoC;IAEpC,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,KAAK,IAAI,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,CAAA;IACvF,mGAAmG;IACnG,oGAAoG;IACpG,uFAAuF;IACvF,MAAM,UAAU,GAAG,gBAAgB,KAAK,SAAS,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAA;IAChF,MAAM,QAAQ,GAAG,cAAc,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,CAAA;IACtE,MAAM,IAAI,GAAe,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAA;IAE9F,MAAM,QAAQ,GAAsB,EAAE,CAAA;IACtC,IAAI,IAAI,KAAK,QAAQ;QAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC9C,IAAI,IAAI,KAAK,KAAK;QAAE,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;IAEjD,MAAM,KAAK,GAQP,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,KAAK,KAAK,EAAE,QAAQ,EAAE,CAAA;IACtE,IAAI,IAAI,KAAK,KAAK,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;QAAE,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAA;IAC3F,IAAI,gBAAgB,KAAK,SAAS;QAAE,KAAK,CAAC,gBAAgB,GAAG,gBAAgB,CAAA;IAC7E,OAAO,KAA2B,CAAA;AACpC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,mBAAmB,GAAyD;IAChF,GAAG,EAAE,CAAC,QAAQ,CAAC;IACf,IAAI,EAAE,CAAC,QAAQ,CAAC;IAChB,IAAI,EAAE,CAAC,QAAQ,CAAC;IAChB,UAAU,EAAE,CAAC,QAAQ,CAAC;IACtB,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,EAAE;CACX,CAAA;AAED,MAAM,WAAW,GAA8C;IAC7D,MAAM,EACJ,yOAAyO;IAC3O,YAAY,EACV,oHAAoH;CACvH,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAkB,EAClB,UAKI,EAAE;IAEN,MAAM,OAAO,GAAyB,EAAE,CAAA;IACxC,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,iGAAiG;QACjG,8DAA8D;QAC9D,MAAM,MAAM,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAgB,CAAA;QAClD,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAClG,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;IAE1D,MAAM,SAAS,GAA4B,EAAE,CAAA;IAC7C,MAAM,YAAY,GAChB,OAAO,CAAC,YAAY;QACpB,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;IAClF,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACxC,IAAI,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC;oBAAE,SAAQ;gBAC/C,SAAS,CAAC,IAAI,CAAC;oBACb,EAAE,EAAE,KAAK,CAAC,EAAE;oBACZ,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,UAAU;oBACV,WAAW,EAAE,WAAW,CAAC,UAAU,CAAC;iBACrC,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAA+B,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAA;IACxE,KAAK,MAAM,KAAK,IAAI,OAAO;QAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEpD,MAAM,MAAM,GAKR,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAA;IAC1C,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAAE,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;IAChE,OAAO,MAAuB,CAAA;AAChC,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,mBAAmB,CAAC,QAAuB;IACzD,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,CAAC,IAAI,CACR,QAAQ,CAAC,MAAM,KAAK,SAAS;QAC3B,CAAC,CAAC,sBAAsB;QACxB,CAAC,CAAC,kCAAkC,QAAQ,CAAC,MAAM,EAAE,CACxD,CAAA;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAA;QAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAA;IAC/E,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IACpF,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAA;IACvC,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,KAAK,GACT,KAAK,CAAC,IAAI,KAAK,KAAK;YAClB,CAAC,CAAC,cAAc,KAAK,CAAC,UAAU,GAAG;YACnC,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ;gBACvB,CAAC,CAAC,cAAc,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACrF,CAAC,CAAC,aAAa,CAAA;QACrB,KAAK,CAAC,IAAI,CACR,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YACpB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YACxC,KAAK,CACR,CAAA;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CACR,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,aAAa,QAAQ,CAAC,MAAM,CAAC,GAAG,UAAU,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,CAC7F,CAAA;IAED,IAAI,QAAQ,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACd,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,SAAS,CAAC,MAAM,qCAAqC,CAAC,CAAA;QAC/E,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,OAAO,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAA;QACjE,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}
+{"version":3,"file":"route-manifest.js","sourceRoot":"","sources":["../src/route-manifest.ts"],"names":[],"mappings":"AA0EA,+EAA+E;AAC/E,MAAM,SAAS,GAAG,CAAC,OAAe,EAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AAEpE;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,EAAU,EACV,OAAe,EACf,MAGC,EACD,gBAAoC;IAEpC,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,KAAK,IAAI,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,CAAA;IACvF,mGAAmG;IACnG,oGAAoG;IACpG,uFAAuF;IACvF,MAAM,UAAU,GAAG,gBAAgB,KAAK,SAAS,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAA;IAChF,MAAM,QAAQ,GAAG,cAAc,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,CAAA;IACtE,MAAM,IAAI,GAAe,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAA;IAE9F,MAAM,QAAQ,GAAsB,EAAE,CAAA;IACtC,IAAI,IAAI,KAAK,QAAQ;QAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC9C,IAAI,IAAI,KAAK,KAAK;QAAE,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;IAEjD,MAAM,KAAK,GASP,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,KAAK,KAAK,EAAE,QAAQ,EAAE,CAAA;IACtE,IAAI,IAAI,KAAK,KAAK,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;QAAE,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAA;IAC3F,IAAI,IAAI,KAAK,KAAK,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QAC1D,KAAK,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAA;IAC9C,CAAC;IACD,IAAI,gBAAgB,KAAK,SAAS;QAAE,KAAK,CAAC,gBAAgB,GAAG,gBAAgB,CAAA;IAC7E,OAAO,KAA2B,CAAA;AACpC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,mBAAmB,GAAyD;IAChF,GAAG,EAAE,CAAC,QAAQ,CAAC;IACf,IAAI,EAAE,CAAC,QAAQ,CAAC;IAChB,IAAI,EAAE,CAAC,QAAQ,CAAC;IAChB,UAAU,EAAE,CAAC,QAAQ,CAAC;IACtB,MAAM,EAAE,CAAC,QAAQ,CAAC;IAClB,MAAM,EAAE,EAAE;CACX,CAAA;AAED,MAAM,WAAW,GAA8C;IAC7D,MAAM,EACJ,yOAAyO;IAC3O,YAAY,EACV,oHAAoH;CACvH,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAkB,EAClB,UAKI,EAAE;IAEN,MAAM,OAAO,GAAyB,EAAE,CAAA;IACxC,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,iGAAiG;QACjG,8DAA8D;QAC9D,MAAM,MAAM,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAgB,CAAA;QAClD,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAClG,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;IAE1D,MAAM,SAAS,GAA4B,EAAE,CAAA;IAC7C,MAAM,YAAY,GAChB,OAAO,CAAC,YAAY;QACpB,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;IAClF,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,KAAK,MAAM,UAAU,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACxC,IAAI,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC;oBAAE,SAAQ;gBAC/C,SAAS,CAAC,IAAI,CAAC;oBACb,EAAE,EAAE,KAAK,CAAC,EAAE;oBACZ,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,UAAU;oBACV,WAAW,EAAE,WAAW,CAAC,UAAU,CAAC;iBACrC,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAA+B,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAA;IACxE,KAAK,MAAM,KAAK,IAAI,OAAO;QAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEpD,MAAM,MAAM,GAKR,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAA;IAC1C,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAAE,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;IAChE,OAAO,MAAuB,CAAA;AAChC,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,mBAAmB,CAAC,QAAuB;IACzD,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,CAAC,IAAI,CACR,QAAQ,CAAC,MAAM,KAAK,SAAS;QAC3B,CAAC,CAAC,sBAAsB;QACxB,CAAC,CAAC,kCAAkC,QAAQ,CAAC,MAAM,EAAE,CACxD,CAAA;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAA;QAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAA;IAC/E,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IACpF,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAA;IACvC,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,KAAK,GACT,KAAK,CAAC,IAAI,KAAK,KAAK;YAClB,CAAC,CAAC,cAAc,KAAK,CAAC,UAAU,GAAG;YACnC,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ;gBACvB,CAAC,CAAC,cAAc,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACrF,CAAC,CAAC,aAAa,CAAA;QACrB,KAAK,CAAC,IAAI,CACR,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YACpB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YACxC,KAAK,CACR,CAAA;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CACR,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,aAAa,QAAQ,CAAC,MAAM,CAAC,GAAG,UAAU,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,CAC7F,CAAA;IAED,IAAI,QAAQ,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACd,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,SAAS,CAAC,MAAM,qCAAqC,CAAC,CAAA;QAC/E,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,OAAO,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAA;QACjE,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}

package/package.json

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

package/src/dev.ts

@@ -367,7 +367,10 @@ export async function createDevServer(options: DevServerOptions): Promise<DevSer
           return new Response(body, { headers })
         }
         // Static probe before routing; a miss returns undefined and falls through, so no route is
-        // shadowed and a page render never pays a filesystem stat (extension-less paths skip it).
+        // shadowed. Every GET/HEAD pays the probe, including page renders and API routes: the handler
+        // serves extension-less files too (an ACME challenge token is the reason), so there is no
+        // cheap prefilter to skip. Dev only - production serves `public/` from the CDN, and a caller
+        // mounting this handler itself can pass `files` to answer a miss without touching the disk.
         const staticFile = await servePublic(req)
         if (staticFile !== undefined) return staticFile
         try {

package/src/index.ts

@@ -27,7 +27,7 @@ import { isDraftEnabled } from "./draft.ts"
 import { trustedHeadAttributes } from "./internal/head-attributes.ts"
 import { jsStringLiteral } from "./internal/js-string.ts"
 import { EXECUTABLE_SCRIPT_TYPES, INERT_SCRIPT_TYPES } from "./internal/script-types.ts"
-import { ISR_REVALIDATE_HEADER } from "./isr.ts"
+import { ISR_REVALIDATE_HEADER, ISR_REVALIDATE_TAGS_HEADER, serializeISRTags } from "./isr.ts"
 import { generateLlmsTxt } from "./llms-txt.ts"
 import type {
   LayoutEntry,
@@ -83,6 +83,7 @@ export {
   type CachedResponse,
   type CacheStore,
   ISR_REVALIDATE_HEADER,
+  ISR_REVALIDATE_TAGS_HEADER,
   ISR_STATUS_HEADER,
   type ISRApp,
   type ISROptions,
@@ -427,6 +428,8 @@ export interface RenderPageOptions {
   /** ISR: route freshness in seconds, emitted as the `x-nifra-isr-revalidate` header for a `withISR`
    * wrapper to read. Omit ⇒ no header (the wrapper's default TTL applies). */
   readonly revalidate?: number
+  /** ISR invalidation tags emitted as a bounded `x-nifra-isr-tags` header. */
+  readonly revalidateTags?: readonly string[]
   /** Matched route id; written to `window.__NIFRA_ROUTE__` so the client hydrates this chain. */
   readonly routeId?: string
   /** The matched route's decoded path params - surfaced to the page as `params` (via {@link RenderProps})
@@ -541,6 +544,7 @@ export function renderPageResult(options: RenderPageInput): MaybePromise<Rendere
     styles = [],
     prerenderedPaths = [],
     revalidate,
+    revalidateTags = [],
     routeId,
     status = 200,
     title = "nifra",
@@ -695,6 +699,8 @@ export function renderPageResult(options: RenderPageInput): MaybePromise<Rendere
   // dedicated header (not the action-revalidation `x-nifra-revalidate`) so the TTL channel never aliases
   // the client's path-list channel.
   if (revalidate !== undefined) headers[ISR_REVALIDATE_HEADER] = String(revalidate)
+  const serializedTags = serializeISRTags(revalidateTags)
+  if (serializedTags !== undefined) headers[ISR_REVALIDATE_TAGS_HEADER] = serializedTags
   const renderProps: RenderProps = {
     data: forComponent,
     actionData: actionSplit?.forComponent,
@@ -2225,6 +2231,7 @@ export function createWebApp<Env = unknown>(
           ...stylesOf(route.id),
           prerenderedPaths: options.prerenderedPaths ?? [],
           ...(mod.revalidate !== undefined ? { revalidate: mod.revalidate } : {}),
+          ...(mod.revalidateTags !== undefined ? { revalidateTags: mod.revalidateTags } : {}),
           ...(mod.islandScripts !== undefined ? { islandScripts: mod.islandScripts } : {}),
           ...titleOption,
           ...assemblyCacheFor(mod, chainLayoutModules),

package/src/isr.ts

@@ -20,6 +20,8 @@ export interface CachedResponse {
   readonly storedAt: number
   /** Freshness window (ms): `now - storedAt >= revalidate` ⇒ stale (serve it, regenerate behind it). */
   readonly revalidate: number
+  /** Public, bounded invalidation labels. A tag purge makes matching entries miss immediately. */
+  readonly tags?: readonly string[]
 }
 
 /**
@@ -35,6 +37,45 @@ export interface CacheStore {
   set(key: string, value: CachedResponse): Promise<void>
   /** Drop `key` (on-demand revalidation / purge). A no-op if absent. */
   delete(key: string): Promise<void>
+  /** Drop every cached response carrying `tag`, when the backend supports tag invalidation. */
+  readonly invalidateTag?: (tag: string) => Promise<void>
+}
+
+const ISR_TAG_PATTERN = /^[A-Za-z][A-Za-z0-9._:/-]{0,127}$/
+const MAX_ISR_TAGS = 32
+
+function normalizeTag(tag: string): string {
+  if (typeof tag !== "string" || !ISR_TAG_PATTERN.test(tag)) {
+    throw new TypeError("[nifra/web] ISR tag must be a bounded token")
+  }
+  return tag
+}
+
+function normalizeTags(tags: readonly string[] | undefined): readonly string[] {
+  if (tags === undefined) return []
+  if (!Array.isArray(tags) || tags.length > MAX_ISR_TAGS) {
+    throw new TypeError("[nifra/web] ISR tags must contain at most 32 bounded tokens")
+  }
+  const unique = new Set<string>()
+  for (const tag of tags) unique.add(normalizeTag(tag))
+  return Object.freeze([...unique])
+}
+
+function tagsFromHeader(value: string | null): readonly string[] {
+  if (value === null || value.trim() === "") return []
+  try {
+    return normalizeTags(value.split(",").map((tag) => tag.trim()))
+  } catch {
+    // A malformed response-controlled header must never accidentally create an unpurgeable cache
+    // entry. Treat it as untagged; route declarations are validated before they reach this path.
+    return []
+  }
+}
+
+/** Validate and serialize route-declared ISR tags for the internal response header. */
+export function serializeISRTags(tags: readonly string[]): string | undefined {
+  const normalized = normalizeTags(tags)
+  return normalized.length === 0 ? undefined : normalized.join(",")
 }
 
 export interface MemoryCacheStoreOptions {
@@ -52,8 +93,12 @@ export interface MemoryCacheStoreOptions {
  * page survives a burst of new pages).
  */
 export class MemoryCacheStore implements CacheStore {
-  private readonly cache = new Map<string, CachedResponse>()
+  private readonly cache = new Map<
+    string,
+    { readonly value: CachedResponse; readonly tagEpochs: Readonly<Record<string, string>> }
+  >()
   private readonly max: number
+  private readonly tagEpoch = new Map<string, string>()
 
   constructor(options: MemoryCacheStoreOptions = {}) {
     const isProd = typeof process !== "undefined" && process.env?.NODE_ENV === "production"
@@ -71,31 +116,75 @@ export class MemoryCacheStore implements CacheStore {
   }
 
   get(key: string): Promise<CachedResponse | undefined> {
-    const value = this.cache.get(key)
+    const row = this.cache.get(key)
+    if (row !== undefined) {
+      for (const [tag, epoch] of Object.entries(row.tagEpochs)) {
+        if ((this.tagEpoch.get(tag) ?? "0") !== epoch) {
+          this.cache.delete(key)
+          this.pruneTagEpochs()
+          return Promise.resolve(undefined)
+        }
+      }
+    }
+    const value = row?.value
     // 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)
+      this.cache.set(
+        key,
+        row as {
+          readonly value: CachedResponse
+          readonly tagEpochs: Readonly<Record<string, string>>
+        },
+      )
     }
     return Promise.resolve(value)
   }
 
   set(key: string, value: CachedResponse): Promise<void> {
+    const tags = normalizeTags(value.tags)
+    const tagEpochs: Record<string, string> = {}
+    for (const tag of tags) tagEpochs[tag] = this.tagEpoch.get(tag) ?? "0"
     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)
+    this.cache.set(key, { value: tags.length === 0 ? value : { ...value, tags }, tagEpochs })
     while (this.cache.size > this.max) {
       const oldest = this.cache.keys().next().value
       if (oldest === undefined) break
       this.cache.delete(oldest)
     }
+    this.pruneTagEpochs()
     return Promise.resolve()
   }
 
   delete(key: string): Promise<void> {
     this.cache.delete(key)
+    this.pruneTagEpochs()
+    return Promise.resolve()
+  }
+
+  invalidateTag(tag: string): Promise<void> {
+    normalizeTag(tag)
+    this.tagEpoch.set(tag, crypto.randomUUID())
+    // This store is bounded and local, so eagerly remove matching rows. It keeps invalidation
+    // immediate and lets us discard epoch keys that no retained entry references anymore.
+    for (const [key, row] of this.cache) {
+      if (Object.hasOwn(row.tagEpochs, tag)) this.cache.delete(key)
+    }
+    this.pruneTagEpochs()
     return Promise.resolve()
   }
+
+  private pruneTagEpochs(): void {
+    if (this.tagEpoch.size === 0) return
+    const used = new Set<string>()
+    for (const row of this.cache.values()) {
+      for (const tag of Object.keys(row.tagEpochs)) used.add(tag)
+    }
+    for (const tag of this.tagEpoch.keys()) {
+      if (!used.has(tag)) this.tagEpoch.delete(tag)
+    }
+  }
 }
 
 /**
@@ -121,6 +210,16 @@ export interface KVCacheStoreOptions {
    * overwritten on regeneration or purged via `revalidateEndpoint`.
    */
   readonly expirationTtl?: number
+  /**
+   * Smallest `expirationTtl` this binding accepts (**seconds**). Defaults to 60, which is Cloudflare
+   * KV's floor - the common case, and worth rejecting at construction because Cloudflare fails the
+   * `put` at runtime instead, one deploy later.
+   *
+   * The floor belongs to the *binding*, not to this class. {@link KVNamespaceLike} is structural, so
+   * a Redis, Deno KV, Upstash, or in-memory binding satisfies it too, and those accept far shorter
+   * TTLs. Pass their real minimum, or `0` for a backend with none.
+   */
+  readonly minExpirationTtl?: number
 }
 
 /**
@@ -141,31 +240,64 @@ const isCachedResponse = (value: unknown): value is CachedResponse => {
   ) {
     return false
   }
+  if (v.tags !== undefined) {
+    if (!Array.isArray(v.tags)) return false
+    try {
+      normalizeTags(v.tags as string[])
+    } catch {
+      return false
+    }
+  }
   for (const headerValue of Object.values(v.headers as Record<string, unknown>)) {
     if (typeof headerValue !== "string") return false
   }
   return true
 }
 
+const KV_TAG_EPOCH_PREFIX = "__nifra_isr_tag_v1:"
+
+type StoredTaggedResponse = CachedResponse & {
+  readonly __nifraTagEpochs?: Readonly<Record<string, string>>
+}
+
 /**
  * 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)`.
+ *
+ * Cloudflare is the default, not a requirement: {@link KVNamespaceLike} is three structural methods,
+ * so a Redis, Deno KV, or Upstash binding satisfies it (pass `minExpirationTtl` for their TTL floor).
+ * A backend that *can* enumerate keys deserves its own {@link CacheStore} rather than this one - the
+ * epoch indirection in {@link KVCacheStore.invalidateTag} exists only because KV cannot list by tag.
  */
 export class KVCacheStore implements CacheStore {
   private readonly kv: KVNamespaceLike
   private readonly putOptions: { readonly expirationTtl?: number } | undefined
 
   constructor(kv: KVNamespaceLike, options: KVCacheStoreOptions = {}) {
-    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.",
+    const floor = options.minExpirationTtl ?? 60
+    if (!Number.isSafeInteger(floor) || floor < 0) {
+      throw new RangeError(
+        "[nifra/web] KVCacheStore minExpirationTtl must be a non-negative integer",
       )
     }
+    if (options.expirationTtl !== undefined) {
+      if (!Number.isSafeInteger(options.expirationTtl) || options.expirationTtl < 0) {
+        throw new RangeError(
+          "[nifra/web] KVCacheStore expirationTtl must be a non-negative integer (seconds)",
+        )
+      }
+      if (options.expirationTtl < floor) {
+        throw new Error(
+          `[nifra/web] KVCacheStore expirationTtl must be >= ${floor}, this binding's minimum. 60 is ` +
+            "Cloudflare KV's floor and the default; pass `minExpirationTtl` for a backend with a " +
+            "lower one. Whatever the floor, the TTL should exceed your longest `revalidate` window, " +
+            "or expiry turns a stale-while-revalidate into a blocking miss.",
+        )
+      }
+    }
     this.kv = kv
     // Precompute the put options object once: omit it entirely when no TTL (KV then never expires).
     this.putOptions =
@@ -182,16 +314,53 @@ export class KVCacheStore implements CacheStore {
       // 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
+    if (!isCachedResponse(parsed)) return undefined
+    const tags = normalizeTags(parsed.tags)
+    if (tags.length === 0) return parsed
+    const epochs = (parsed as StoredTaggedResponse).__nifraTagEpochs
+    if (epochs === undefined) return undefined
+    const current = await Promise.all(
+      tags.map(async (tag) => [tag, (await this.kv.get(this.tagKey(tag))) ?? "0"] as const),
+    )
+    if (current.some(([tag, epoch]) => epochs[tag] !== epoch)) return undefined
+    const { __nifraTagEpochs: _ignored, ...value } = parsed as StoredTaggedResponse
+    return value
   }
 
   async set(key: string, value: CachedResponse): Promise<void> {
-    await this.kv.put(key, JSON.stringify(value), this.putOptions)
+    const tags = normalizeTags(value.tags)
+    if (tags.length === 0) {
+      await this.kv.put(key, JSON.stringify(value), this.putOptions)
+      return
+    }
+    const epochs = Object.fromEntries(
+      await Promise.all(
+        tags.map(async (tag) => [tag, (await this.kv.get(this.tagKey(tag))) ?? "0"] as const),
+      ),
+    )
+    const stored: StoredTaggedResponse = {
+      ...value,
+      tags,
+      __nifraTagEpochs: epochs,
+    }
+    await this.kv.put(key, JSON.stringify(stored), this.putOptions)
   }
 
   async delete(key: string): Promise<void> {
     await this.kv.delete(key)
   }
+
+  async invalidateTag(tag: string): Promise<void> {
+    normalizeTag(tag)
+    // Epoch invalidation avoids KV key enumeration and remains bounded for a tag with millions of
+    // pages. Epoch keys intentionally have no expiration: an expired epoch would resurrect entries
+    // written before the invalidation when their page key still exists.
+    await this.kv.put(this.tagKey(tag), crypto.randomUUID())
+  }
+
+  private tagKey(tag: string): string {
+    return `${KV_TAG_EPOCH_PREFIX}${encodeURIComponent(tag)}`
+  }
 }
 
 /** Minimal platform shape `withISR` needs - just `waitUntil` (edge runtimes extend the response
@@ -209,6 +378,9 @@ export interface ISRApp {
  * regenerating behind it), or `miss` (rendered now + stored). Useful for debugging + tests. */
 export const ISR_STATUS_HEADER = "x-nifra-isr"
 
+/** Response header carrying bounded route tags into {@link withISR}. */
+export const ISR_REVALIDATE_TAGS_HEADER = "x-nifra-isr-tags"
+
 /**
  * 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
@@ -289,6 +461,9 @@ const CACHEABLE_RESPONSE_HEADERS = new Set([
   "link",
 ])
 
+const tagsOf = (res: Response): readonly string[] =>
+  tagsFromHeader(res.headers.get(ISR_REVALIDATE_TAGS_HEADER))
+
 const headersOf = (res: Response): Record<string, string> => {
   const out: Record<string, string> = {}
   res.headers.forEach((value, key) => {
@@ -349,12 +524,14 @@ export function withISR(
     const res = await app.fetch(req, platform)
     if (!isCacheablePage(req, res)) return res
     const body = await res.text()
+    const tags = tagsOf(res)
     const entry: CachedResponse = {
       body,
       status: res.status,
       headers: headersOf(res),
       storedAt: now(),
       revalidate: ttlMs(res),
+      ...(tags.length === 0 ? {} : { tags }),
     }
     await store.set(key, entry)
     return new Response(body, {
@@ -375,12 +552,14 @@ export function withISR(
     try {
       const res = await app.fetch(req, platform)
       if (isCacheablePage(req, res)) {
+        const tags = tagsOf(res)
         await store.set(key, {
           body: await res.text(),
           status: res.status,
           headers: headersOf(res),
           storedAt: now(),
           revalidate: ttlMs(res),
+          ...(tags.length === 0 ? {} : { tags }),
         })
       } else {
         await res.body?.cancel()
@@ -431,9 +610,10 @@ export interface RevalidateEndpointOptions {
 
 /**
  * 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.
+ * or invalidates every entry carrying a tag. `POST` with the secret in the token header and either
+ * `?path=/blog/x`, `?tag=products`, or a JSON `{ "path": "/blog/x" }` / `{ "tag": "products" }` body.
+ * The token is checked in **constant time** (wrong/missing → `401`); malformed targets → `400`;
+ * non-POST → `405`. A store without tag support returns `501` for tag requests. Mount it on a nifra route, e.g.
  * `app.post("/__nifra/revalidate", (c) => handler(c.req))`.
  */
 export function revalidateEndpoint(
@@ -446,12 +626,29 @@ export function revalidateEndpoint(
     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 url = new URL(req.url)
+    let path = url.searchParams.get("path")
+    let tag = url.searchParams.get("tag")
+    if (path === null && tag === null) {
       const body: unknown = await req.json().catch(() => null)
-      const candidate =
-        typeof body === "object" && body !== null ? (body as { path?: unknown }).path : undefined
-      path = typeof candidate === "string" ? candidate : null
+      if (typeof body === "object" && body !== null) {
+        const candidate = body as { path?: unknown; tag?: unknown }
+        path = typeof candidate.path === "string" ? candidate.path : null
+        tag = typeof candidate.tag === "string" ? candidate.tag : null
+      }
+    }
+    if (path !== null && tag !== null) return jsonError(400, "choose_path_or_tag")
+    if (tag !== null) {
+      try {
+        normalizeTag(tag)
+      } catch {
+        return jsonError(400, "invalid_tag")
+      }
+      if (options.store.invalidateTag === undefined) {
+        return jsonError(501, "tag_invalidation_not_supported")
+      }
+      await options.store.invalidateTag(tag)
+      return Response.json({ revalidatedTag: tag })
     }
     if (path === null || !path.startsWith("/")) return jsonError(400, "invalid_path")
     await options.store.delete(keyOf(path, req))

package/src/manifest.ts

@@ -227,6 +227,8 @@ export interface RouteModule {
    * default). Older-than-`revalidate` cached pages are served stale while regenerating.
    */
   readonly revalidate?: number
+  /** Optional bounded tags used by ISR on-demand invalidation (`?tag=...`). */
+  readonly revalidateTags?: readonly string[]
   /**
    * 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

package/src/public-dir.ts

@@ -14,6 +14,7 @@
  */
 import { realpath } from "node:fs/promises"
 import { normalize, resolve, sep } from "node:path"
+import { parseByteRange } from "@nifrajs/core/range"
 import { pathnameOf } from "@nifrajs/core/server"
 
 /** How long each subtree may be cached. Content-hashed bundle output can be immutable; a
@@ -38,6 +39,35 @@ export interface ServePublicDirOptions {
 const IMMUTABLE = "public, max-age=31536000, immutable"
 const ONE_DAY = "public, max-age=86400"
 
+/** HTTP dates carry second precision; comparing raw milliseconds makes every file look stale. */
+function seconds(time: number): number {
+  return Math.floor(time / 1000)
+}
+
+/**
+ * `If-Range` decides whether a range request is still safe to answer partially. The only validator
+ * this handler publishes is `last-modified`, so an entity-tag form can never match and the whole
+ * representation is sent instead - which is the conformant outcome, not a fallback. Dates use strong
+ * comparison (RFC 9110 13.1.5): a file modified since the client's copy invalidates its byte offsets.
+ */
+function ifRangeMatches(value: string | null, lastModified: number | undefined): boolean {
+  if (value === null) return true
+  if (lastModified === undefined) return false
+  const item = value.trim()
+  if (item.startsWith('"') || item.startsWith("W/")) return false
+  const parsed = Date.parse(item)
+  return Number.isFinite(parsed) && seconds(parsed) === seconds(lastModified)
+}
+
+/** `If-Modified-Since` freshness. No ETag is published, so there is no `If-None-Match` precedence. */
+function isNotModified(request: Request, lastModified: number | undefined): boolean {
+  if (lastModified === undefined) return false
+  const since = request.headers.get("if-modified-since")
+  if (since === null) return false
+  const parsed = Date.parse(since)
+  return Number.isFinite(parsed) && seconds(parsed) >= seconds(lastModified)
+}
+
 /**
  * Resolve a URL pathname to an absolute path **confined** to `root`, or `undefined` if it escapes.
  *
@@ -101,12 +131,52 @@ export function servePublicDir(
     }
     const file = Bun.file(resolvedFile)
     if (!(await file.exists())) return undefined
+    const size = file.size
     const headers = new Headers({
       "cache-control": pathname.startsWith(hashedPrefix) ? hashed : assets,
+      // Advertised unconditionally: a client that never sees `accept-ranges` will not attempt a seek,
+      // so a video or audio file under `public/` is scrubbable only once this header is present.
+      "accept-ranges": "bytes",
     })
-    // HEAD must not carry a body, but must otherwise match GET's headers.
-    return request.method === "HEAD"
-      ? new Response(null, { headers })
-      : new Response(file, { headers })
+    // `new Response(file)` used to infer the media type, which meant HEAD - built from a null body -
+    // silently lost it. Setting it here is what makes the two methods agree.
+    if (file.type !== "") headers.set("content-type", file.type)
+    const lastModified =
+      Number.isFinite(file.lastModified) && file.lastModified > 0 ? file.lastModified : undefined
+    if (lastModified !== undefined) {
+      headers.set("last-modified", new Date(lastModified).toUTCString())
+    }
+    const head = request.method === "HEAD"
+
+    if (isNotModified(request, lastModified)) {
+      headers.delete("content-type")
+      return new Response(null, { status: 304, headers })
+    }
+
+    const rangeHeader = request.headers.get("range")
+    const range =
+      rangeHeader !== null && ifRangeMatches(request.headers.get("if-range"), lastModified)
+        ? parseByteRange(rangeHeader, size)
+        : ({ kind: "none" } as const)
+
+    if (range.kind === "unsatisfiable") {
+      headers.delete("content-type")
+      headers.set("content-range", `bytes */${size}`)
+      return new Response(null, { status: 416, headers })
+    }
+
+    if (range.kind === "satisfiable" && range.ranges.length === 1) {
+      const { start, end } = range.ranges[0]!
+      headers.set("content-range", `bytes ${start}-${end}/${size}`)
+      headers.set("content-length", String(end - start + 1))
+      // `slice` keeps the read lazy: only the selected window is ever pulled off disk.
+      return new Response(head ? null : file.slice(start, end + 1), { status: 206, headers })
+    }
+
+    // Multiple ranges would require assembling `multipart/byteranges`, and doing that for a file on
+    // disk means buffering the whole representation to serve a request that asked for less of it.
+    // RFC 9110 lets a server ignore Range entirely, so the full body is the conformant answer here.
+    if (head) headers.set("content-length", String(size))
+    return new Response(head ? null : file, { headers })
   }
 }

package/src/route-manifest.ts

@@ -41,6 +41,8 @@ export interface RouteManifestEntry {
   readonly hydrate: boolean
   /** Revalidation window in seconds. Present only for `isr`. */
   readonly revalidate?: number
+  /** Bounded tags that can purge this route from a shared ISR store. */
+  readonly revalidateTags?: readonly string[]
   /**
    * Concrete paths prerendered at build. Present for `static` routes: a single path for a static route,
    * one per `getStaticPaths` entry for a dynamic one. Absent means "no path was enumerated", which for a
@@ -84,7 +86,10 @@ const isDynamic = (pattern: string): boolean => /[:*]/.test(pattern)
 export function deriveRouteEntry(
   id: string,
   pattern: string,
-  module: Pick<RouteModule, "prerender" | "getStaticPaths" | "revalidate" | "hydrate">,
+  module: Pick<
+    RouteModule,
+    "prerender" | "getStaticPaths" | "revalidate" | "revalidateTags" | "hydrate"
+  >,
   prerenderedPaths?: readonly string[],
 ): RouteManifestEntry {
   const wantsPrerender = module.prerender === true || module.getStaticPaths !== undefined
@@ -105,10 +110,14 @@ export function deriveRouteEntry(
     mode: RenderMode
     hydrate: boolean
     revalidate?: number
+    revalidateTags?: readonly string[]
     prerenderedPaths?: readonly string[]
     requires: readonly RouteCapability[]
   } = { id, pattern, mode, hydrate: module.hydrate !== false, requires }
   if (mode === "isr" && module.revalidate !== undefined) entry.revalidate = module.revalidate
+  if (mode === "isr" && module.revalidateTags !== undefined) {
+    entry.revalidateTags = module.revalidateTags
+  }
   if (prerenderedPaths !== undefined) entry.prerenderedPaths = prerenderedPaths
   return entry as RouteManifestEntry
 }