@abide/abide 0.116.0 → 0.116.1

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @abide/abide
 
+## 0.116.1
+
+### Patch Changes
+
+- 7dedb9a: the offline worker keeps an answer marked `cache-control: public` — a public file, a font a stylesheet draws with — through a sign-in, a sign-out and a form submitted, which drop only what was saved for the caller
+- 6a69393: a copy the offline worker kept stands in for a year where the network fails, rather than a week — a page, a GET's answer and a public file carry `stale-if-error=31536000`
+
 ## 0.116.0
 
 ### Minor Changes

package/docs/REGISTRY.md

@@ -291,8 +291,8 @@ type Gated<Gate, Accepted> = [Schema<Accepted>] extends [Gate] ? never : Failed<
 | `cache-control: no-store` | `/__abide/openapi.json`, `/__abide/mcp` | Refuses caching for an answer about the app's surfaces. | 21.4 |
 | `cache-control: public, max-age=31536000, immutable` | the built bundle | A chunk addressed by its own content hash. | 21.5 |
 | `cache-control: public, max-age=0, must-revalidate` | a file under a `public` directory | A file at an address the build never chose. | 21.12 |
-| `cache-control: private, stale-while-revalidate=604800, stale-if-error=604800` | a page, a `GET`'s answer, where `ABIDE_OFFLINE` registers its worker | The default that lets a copy kept on the device stand in for the network. | 21.22, 21.11, 21.17 |
-| `cache-control: public, max-age=0, stale-while-revalidate=604800, stale-if-error=604800` | a file under a `public` directory, where `ABIDE_OFFLINE` registers its worker | The same, for a file at an address the build never chose. | 21.23 |
+| `cache-control: private, stale-while-revalidate=604800, stale-if-error=31536000` | a page, a `GET`'s answer, where `ABIDE_OFFLINE` registers its worker | The default that lets a copy kept on the device stand in for the network. | 21.22, 21.11, 21.17 |
+| `cache-control: public, max-age=0, stale-while-revalidate=604800, stale-if-error=31536000` | a file under a `public` directory, where `ABIDE_OFFLINE` registers its worker | The same, for a file at an address the build never chose. | 21.23 |
 | `clear-site-data: "cache"` | an answer carrying `abide-principal`, where pages are kept offline | Drops what the browser's own cache kept for the caller signed in before. | 21.24 |
 | `etag` | a file under a `public` directory | The answered bytes, addressed by their content. | 21.13, 21.14 |
 | `referrer-policy: strict-origin-when-cross-origin` | a page | The browsers' own default, written down. | 21.6 |

package/docs/RULEBOOK.md

@@ -1448,11 +1448,11 @@ time those rungs took apart from what they wrapped.
 
 21.22 Where 45.1 has a page register the worker `ABIDE_OFFLINE` turns on, a page, and the answer of
 a `GET` of the app's own that is neither a refusal nor a stream 16.32 frames, MUST default to `cache-control: private,
-stale-while-revalidate=604800, stale-if-error=604800`.
+stale-while-revalidate=604800, stale-if-error=31536000`.
 
 21.23 Where 45.1 has a page register the worker `ABIDE_OFFLINE` turns on, a file under a `public`
 directory MUST answer `cache-control: public, max-age=0, stale-while-revalidate=604800,
-stale-if-error=604800`.
+stale-if-error=31536000`.
 
 21.24 Where 45.1 has a page register the worker `ABIDE_OFFLINE` turns on, an answer carrying the
 `abide-principal` header 26.24 has it carry MUST carry `clear-site-data: "cache"`.
@@ -3301,8 +3301,9 @@ rather than one a redirect led to, that is neither a stream 16.32 frames nor a b
 45.6 The worker `ABIDE_OFFLINE` turns on MUST answer a file of the build's bundle from what it
 saved.
 
-45.7 The worker `ABIDE_OFFLINE` turns on MUST drop everything it saved where an answer it is handed
-carries `abide-principal`, where `principal` changes in any tab, and where a form is submitted.
+45.7 The worker `ABIDE_OFFLINE` turns on MUST drop everything it saved, save an answer whose
+`cache-control` is `public`, where an answer it is handed carries `abide-principal`, where
+`principal` changes in any tab, and where a form is submitted.
 
 45.8 The worker `ABIDE_OFFLINE` turns on, of a new build, MUST drop everything the one before it
 saved, and every file of the bundle the new build does not name.

package/docs/abide.md

@@ -6541,12 +6541,12 @@ abide start
 ABIDE_OFFLINE=0 abide start
 ```
 
-Each page the CRM opens is kept on the device, with the answers its handlers gave, the public files it loaded and the bundle it runs, until `ABIDE_OFFLINE=0` turns that off where the CRM is served. A kept page opens at once, however weak the signal, and the network is asked for the next copy behind it. With the network gone, a page opened in the last week loads again with its data and works. One never opened says the device is offline, and a link to it leaves the page you are on standing.
+Each page the CRM opens is kept on the device, with the answers its handlers gave, the public files it loaded and the bundle it runs, until `ABIDE_OFFLINE=0` turns that off where the CRM is served. A kept page opens at once, however weak the signal, and the network is asked for the next copy behind it. With the network gone, a page opened in the last year loads again with its data and works. One never opened says the device is offline, and a link to it leaves the page you are on standing.
 
 | Name | What it does for the CRM |
 | --- | --- |
-| `cache-control: private, stale-while-revalidate=604800, stale-if-error=604800` | what a page and a handler's answer carry, so the device shows what it kept while it asks again |
-| `cache-control: public, max-age=0, stale-while-revalidate=604800, stale-if-error=604800` | the same, for a public file |
+| `cache-control: private, stale-while-revalidate=604800, stale-if-error=31536000` | what a page and a handler's answer carry, so the device shows what it kept while it asks again |
+| `cache-control: public, max-age=0, stale-while-revalidate=604800, stale-if-error=31536000` | the same, for a public file |
 | `clear-site-data: "cache"` | what a sign-in or a sign-out answers, so the browser forgets what it kept for the last person |
 
 What is kept is what those headers allow, and nothing else decides it. A handler that writes `cache-control: no-store` through `response` is never kept, and an answer with a `ttl` is shown from the device until its `max-age` runs out. A refresh always asks the network.
@@ -7681,8 +7681,8 @@ Transports: what is written in place rather than imported.
 | `cache-control: no-store` | `/__abide/openapi.json`, `/__abide/mcp` | Refuses caching for an answer about the app's surfaces. | [21.4](/rulebook#21.4) |
 | `cache-control: public, max-age=31536000, immutable` | the built bundle | A chunk addressed by its own content hash. | [21.5](/rulebook#21.5) |
 | `cache-control: public, max-age=0, must-revalidate` | a file under a `public` directory | A file at an address the build never chose. | [21.12](/rulebook#21.12) |
-| `cache-control: private, stale-while-revalidate=604800, stale-if-error=604800` | a page, a `GET`'s answer, where `ABIDE_OFFLINE` registers its worker | The default that lets a copy kept on the device stand in for the network. | [21.22](/rulebook#21.22), [21.11](/rulebook#21.11), [21.17](/rulebook#21.17) |
-| `cache-control: public, max-age=0, stale-while-revalidate=604800, stale-if-error=604800` | a file under a `public` directory, where `ABIDE_OFFLINE` registers its worker | The same, for a file at an address the build never chose. | [21.23](/rulebook#21.23) |
+| `cache-control: private, stale-while-revalidate=604800, stale-if-error=31536000` | a page, a `GET`'s answer, where `ABIDE_OFFLINE` registers its worker | The default that lets a copy kept on the device stand in for the network. | [21.22](/rulebook#21.22), [21.11](/rulebook#21.11), [21.17](/rulebook#21.17) |
+| `cache-control: public, max-age=0, stale-while-revalidate=604800, stale-if-error=31536000` | a file under a `public` directory, where `ABIDE_OFFLINE` registers its worker | The same, for a file at an address the build never chose. | [21.23](/rulebook#21.23) |
 | `clear-site-data: "cache"` | an answer carrying `abide-principal`, where pages are kept offline | Drops what the browser's own cache kept for the caller signed in before. | [21.24](/rulebook#21.24) |
 | `etag` | a file under a `public` directory | The answered bytes, addressed by their content. | [21.13](/rulebook#21.13), [21.14](/rulebook#21.14) |
 | `referrer-policy: strict-origin-when-cross-origin` | a page | The browsers' own default, written down. | [21.6](/rulebook#21.6) |

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@abide/abide",
-    "version": "0.116.0",
+    "version": "0.116.1",
     "type": "module",
     "description": "Isomorphic type-safe framework for reactive async interfaces for humans and machines",
     "license": "MIT",

package/src/server/OFFLINE_STALE.ts

@@ -1,10 +1,11 @@
 // 21.22, 21.23 — HOW LONG A COPY KEPT ON THE DEVICE STAYS SERVABLE once stale, where `ABIDE_OFFLINE`
-// registers its worker: a week, while the network answers or fails to — as long as Safari keeps an
-// unvisited site's storage.
+// registers its worker: a week while the network answers and the copy is asked for again behind it,
+// and a year where the network fails — a copy of any age beats the page saying nothing was saved, and
+// what may evict it sooner (Safari's week for a site not visited) is the browser's, not this header's.
 //
 // NO `max-age` BESIDE IT on a page or a `GET`: a copy reads `max-age` as its own life (18.14), and
 // a followed copy stale from the moment it landed would reload on every read. With no lifetime and
 // no `Last-Modified`, a cache holds the answer stale at once, which is all the two windows need.
 
 export const OFFLINE_STALE =
-    'stale-while-revalidate=604800, stale-if-error=604800'
+    'stale-while-revalidate=604800, stale-if-error=31536000'

package/src/server/answerWorker.ts

@@ -15,6 +15,7 @@ import {
     OFFLINE_BUNDLE,
     OFFLINE_CACHE_PREFIX,
     OFFLINE_SAVED,
+    OFFLINE_SHARED,
 } from '#shared/OFFLINE_CACHES.ts'
 import { PRINCIPAL_HEADER } from '#shared/PRINCIPAL_HEADER.ts'
 import { REACHED_MESSAGE } from '#shared/REACHED_MESSAGE.ts'
@@ -31,6 +32,7 @@ const STREAMED_TYPES = [
 
 const CACHES = `const OURS = ${JSON.stringify(OFFLINE_CACHE_PREFIX)}
 const SAVED = ${JSON.stringify(OFFLINE_SAVED)}
+const SHARED = ${JSON.stringify(OFFLINE_SHARED)}
 const BUNDLE = ${JSON.stringify(OFFLINE_BUNDLE)}
 
 async function dropOurs(keeping) {
@@ -112,7 +114,7 @@ async function answer(event, page) {
             request.cache === 'no-store')
     const saved = bypass
         ? undefined
-        : await caches.match(request, { cacheName: SAVED, ignoreVary: true })
+        : await savedCopy(request)
     const life = saved === undefined ? undefined : lifeOf(saved)
     if (life !== undefined) {
         if (life.age < life.fresh) return marked(saved)
@@ -197,7 +199,7 @@ async function keepReached(url) {
     if (reaching.has(url)) return
     reaching.add(url)
     try {
-        const saved = await caches.match(url, { cacheName: SAVED, ignoreVary: true })
+        const saved = await savedCopy(url)
         if (saved === undefined || !standsIn(lifeOf(saved))) await keepPage(url)
     } finally {
         reaching.delete(url)
@@ -247,9 +249,19 @@ function kept(response) {
     return !STREAMED.some((streamed) => type.startsWith(streamed))
 }
 
+// The copy saved of an address, a caller's own ahead of one any caller may be answered.
+async function savedCopy(request) {
+    return (
+        (await caches.match(request, { cacheName: SAVED, ignoreVary: true })) ??
+        (await caches.match(request, { cacheName: SHARED, ignoreVary: true }))
+    )
+}
+
 // 45.7 — EVERY PAGE SAVED DROPPED, and with them every copy asked for before the drop: one asked under
 // the cookies of then would land after it holding the caller signed out since. The drop an answer's
-// own abide-principal makes is the exception, since that answer is the new caller's.
+// own abide-principal makes is the exception, since that answer is the new caller's. What any caller
+// may be answered is kept apart and left standing: it was never the caller's to drop, and a font
+// thrown away at sign-in is a page drawn without it offline.
 let drops = 0
 
 function dropSaved() {
@@ -259,15 +271,19 @@ function dropSaved() {
 
 // Saves a copy 45.3 and 45.4 let through where no drop has come since its request was asked — after
 // the drop its own answer makes where that answer rotated the principal — and cancels one where one has.
+// One any caller may be answered is saved whenever it was asked, since no caller's cookies made it.
 async function keep(request, copy, since, rotated) {
     if (rotated) {
         await dropSaved()
         since = drops
     }
     if (copy === undefined) return
-    if (since !== drops) return copy.body?.cancel()
-    const cache = await caches.open(SAVED)
-    await cache.put(request, copy)
+    const shared = directivesOf(copy).has('public')
+    if (!shared && since !== drops) return copy.body?.cancel()
+    // An address whose answer went public or private since leaves no copy behind for savedCopy to
+    // prefer over this one.
+    await (await caches.open(shared ? SAVED : SHARED)).delete(request)
+    await (await caches.open(shared ? SHARED : SAVED)).put(request, copy)
 }
 
 function offline() {

package/src/shared/OFFLINE_CACHES.ts

@@ -5,8 +5,11 @@
 /** What every cache the worker keeps is named under, so a cache an earlier worker named is found. */
 export const OFFLINE_CACHE_PREFIX = 'abide:'
 
-/** The pages, the handlers' answers and the public files the worker saved, by address. */
+/** The pages and the handlers' answers the worker saved, by address. */
 export const OFFLINE_SAVED = `${OFFLINE_CACHE_PREFIX}saved`
 
+/** What the worker saved that any caller may be answered — `cache-control: public` — by address. */
+export const OFFLINE_SHARED = `${OFFLINE_CACHE_PREFIX}shared`
+
 /** The build's bundle, saved as the worker installs. */
 export const OFFLINE_BUNDLE = `${OFFLINE_CACHE_PREFIX}bundle`