@ultimat3/pwa 21.0.0 → 22.0.0

package/README.md

@@ -81,6 +81,21 @@ gate. `CAPABILITY_SW_MARKERS` is checked against the emitted `sw.js` in both dir
 here that the generator does not honour is a failing test rather than an installed app announcing a
 capability nothing implements.
 
+## Error classes
+
+Every error class `src/index.ts` exports, for `instanceof` inside one process. Across a wire or
+a job boundary the class is gone and the `code` is what survives — match on that.
+
+| Class | Code | Declared in |
+|---|---|---|
+| `BuildIdMissingError` | `X_BUILD_ID_MISSING` | `src/errors.ts` |
+| `NotImplementedError` | `X_NOT_IMPLEMENTED` | `src/errors.ts` |
+| `PwaIconMissingError` | `X_PWA_ICON_MISSING` | `src/errors.ts` |
+| `PwaManifestInvalidError` | `X_PWA_MANIFEST_INVALID` | `src/errors.ts` |
+| `PwaNoOfflineFallbackError` | `X_PWA_NO_OFFLINE_FALLBACK` | `src/errors.ts` |
+| `PwaStrategyExhaustedError` | `X_PWA_STRATEGY_EXHAUSTED` | `src/errors.ts` |
+| `SwScopeInvalidError` | `X_SW_SCOPE_INVALID` | `src/errors.ts` |
+
 ## Public API
 
 | Export | Owns |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/pwa",
-  "version": "21.0.0",
+  "version": "22.0.0",
   "description": "Generated service worker, web manifest, icons, push and version-skew handling.",
   "license": "MIT",
   "type": "module",
@@ -32,7 +32,7 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/core": "21.0.0",
-    "@ultimat3/seo": "21.0.0"
+    "@ultimat3/core": "22.0.0",
+    "@ultimat3/seo": "22.0.0"
   }
 }

package/src/index.ts

@@ -17,7 +17,6 @@ export {
 export type { Capability, CapabilityFlags, ResolvedCapabilities } from './capabilities';
 export {
   CAPABILITIES,
-  CAPABILITY_MANIFEST_KEYS,
   CAPABILITY_SW_MARKERS,
   enabledCapabilities,
   isEnabled,
@@ -57,7 +56,6 @@ export {
   maskableSafeZone,
   planIcons,
   requireSourceIcon,
-  SPLASH_MATRIX,
 } from './icons';
 export type {
   BeforeInstallPromptEventLike,
@@ -68,7 +66,7 @@ export type {
   IosGuidance,
   ReadSignal,
 } from './install';
-export { createInstallController, iosInstallGuidance, MIN_ENGAGEMENT_MS } from './install';
+export { createInstallController, iosInstallGuidance } from './install';
 export type {
   DisplayMode,
   FileHandler,
@@ -90,7 +88,6 @@ export type { PrecacheAsset, PrecacheEntry, PrecacheInput, PrecacheManifest } fr
 export {
   buildPrecacheManifest,
   DEFAULT_PRECACHE_WARN_BYTES,
-  serializePrecacheManifest,
 } from './precache';
 export type {
   PushPayload,
@@ -105,7 +102,6 @@ export type {
 export {
   pushSource,
   renderPushPayload,
-  serializePushMessage,
   subscribeSource,
   subscriptionState,
 } from './push';
@@ -123,10 +119,7 @@ export {
   MODE_STRATEGY,
   networkFirst,
   networkOnly,
-  STRATEGY_FN_NAMES,
-  STRATEGY_FNS,
   STRATEGY_NAMES,
-  STRATEGY_SOURCE,
   staleWhileRevalidate,
   strategyFor,
 } from './strategies';

package/src/strategies.ts

@@ -80,6 +80,8 @@ export interface StrategyEnv {
   /** The named cache this strategy reads and writes. */
   open(cacheName: string): Promise<StrategyCache>;
   fetch(request: Request): Promise<Response>;
+  /** The fetch event's `waitUntil`, when there is one — background work must be handed to it. */
+  wait?(work: Promise<unknown>): void;
 }
 
 export interface StrategyCache {
@@ -139,7 +141,10 @@ export async function staleWhileRevalidate(
     .catch(async () => (hit !== undefined ? hit : fallbackOrThrow(options)));
 
   if (hit !== undefined) {
-    void refresh.catch(() => undefined);
+    // The refresh is handed to the event's `waitUntil` NOW, before the cached answer returns:
+    // taken after `respondWith` settled, a browser refuses the extension (`InvalidStateError`) and
+    // may kill the worker mid-refresh. `later` also swallows its rejection, as `.catch` did.
+    env.wait?.(refresh.catch(() => undefined));
     return hit;
   }
   return refresh;
@@ -215,7 +220,7 @@ export const STRATEGY_SOURCE = Object.freeze<Record<StrategyName, string>>({
   const c=await openCache(cn);const hit=await c.match(req);
   const refresh=fetch(req).then((r)=>{if(r.ok)later(wait,c.put(req,r.clone()));return r})
     .catch(()=>hit||(fb?fb():Response.error()));
-  if(hit){refresh.catch(()=>{});return hit}
+  if(hit){later(wait,refresh);return hit}
   return refresh
 }`,
   'network-only': `async function networkOnly(req,cn,fb,wait){