@asteby/metacore-pwa 0.6.15 → 0.7.1

package/README.md

@@ -114,6 +114,49 @@ By default, `PushNotificationService` calls these endpoints on your injected `ap
 
 Override any path via `<PWAProvider pushOptions={{ publicKeyPath: '/v1/webpush/key' }} />`.
 
+## Política de actualización
+
+Por defecto (`updateStrategy="auto"`) nada cambia: el provider recarga en cada `controllerchange`. Con `updateStrategy="prompt"` la actualización la gobierna una política compartida, sin cambios de comportamiento para quien no la activa.
+
+```tsx
+<PWAProvider
+  api={api}
+  updateStrategy="prompt"
+  updateCheckIntervalMs={5 * 60_000}      // update() cada 5 min (solo pestaña visible) + al volver + focus
+  autoApplyAfterMs={24 * 60 * 60_000}     // opcional: aplicar solo tras 24 h esperando, en momento seguro
+  staleAutoApplyAfterMs={10 * 60_000}     // opcional: umbral cuando versionCheck detecta desfase
+  versionCheck={{
+    current: __APP_COMMIT__,              // versión embebida en el build (Vite `define`)
+    fetchLatest: async () => (await fetch('/health').then((r) => r.json())).commit,
+  }}
+>
+  <PWAUpdatePrompt />   {/* solo UI: toast compartido, se retrae con un modal abierto */}
+</PWAProvider>
+```
+
+Requisito: el `sw.js` no debe hacer `skipWaiting` al instalar, solo al mensaje `SKIP_WAITING` (como la plantilla incluida).
+
+| Opción | Default | Efecto |
+|---|---|---|
+| `dismissTtlMs` | 1 h | "Después" oculta el aviso ese tiempo |
+| (interno) `acceptedTtlMs` | 2 min | tras "Actualizar", un SW aún en espera se aplica sin re-preguntar |
+| `autoApplyAfterMs` | `undefined` | **nunca** auto-aplica; si se define, aplica al cumplirse y en momento seguro (también si se descartó el aviso) |
+| `staleAutoApplyAfterMs` | `undefined` | umbral usado mientras `versionCheck` indique que el cliente está desfasado (gana el menor de los dos) |
+| `isSafeToApply` | ver abajo | reemplaza el test de momento seguro |
+| `versionCheck` | — | `{ current, fetchLatest, intervalMs = 5 min }`. Si `fetchLatest()` difiere de `current` se marca *stale* y se fuerza `registration.update()` al instante. La librería no asume el endpoint |
+
+**Momento seguro** (por defecto; un `apply` nunca ocurre sin él): sin diálogo Radix abierto; sin campo enfocado con contenido ni campo en el que el usuario escribió (evento `input` de confianza, últimos 30 min) que aún tenga contenido (los campos precargados/autocompletados no cuentan); y pestaña oculta, o usuario inactivo ≥ 60 s. Se reevalúa cada 15 s mientras hay una actualización esperando.
+
+Un `<input type="file">` con archivos seleccionados cuenta como edición en curso (no seguro). Limitaciones del test por defecto: **no detecta subidas, peticiones `fetch`/XHR ni escrituras en curso** que no pasen por un campo con contenido, y el clic explícito en "Actualizar" **omite** el momento seguro (es decisión del usuario). Si tu host tiene subidas o formularios críticos, pasa tu propio `isSafeToApply` (por ejemplo, devolviendo `false` mientras haya una subida o mutación activa).
+
+**Garantía anti-bucle**: máximo UN intento de recarga por `acceptedTtlMs` (2 min) y por worker en espera. Se persiste `metacore_pwa_update_last_apply_attempt_at`; si tras recargar el worker sigue en espera (p. ej. un `sw.js` que ignora `SKIP_WAITING`) no se vuelve a aplicar de forma automática (ni por aceptación previa ni por `autoApplyAfterMs`): se limpia la aceptación y se vuelve al aviso. Solo un clic explícito en "Actualizar" puede reintentar. Cuando cambia el worker en espera (otro `scriptURL` o instancia) se reinician su antigüedad, el descarte y el intento.
+
+**Recarga**: una sola, solo tras `SKIP_WAITING` -> `controllerchange`, con fallback a 5 s. En modo `prompt` un `controllerchange` ajeno (otra pestaña) no recarga esta.
+
+Los estados de persistencia (`metacore_pwa_update_*` en `localStorage`) permiten que `autoApplyAfterMs` cuente desde la primera vez que se vio la actualización aunque el usuario recargue sin activarla. Si el storage no está disponible la política degrada a solo-sesión.
+
+Capas reutilizables: `decideUpdate` / `isSafeSnapshot` (puras), `createUpdateController` (sin React) y `useServiceWorkerUpdate` (hook) para hosts que no usan `PWAProvider`.
+
 ## Exports
 
 ```ts

package/dist/dom-safety.d.ts

@@ -0,0 +1,31 @@
+/**
+ * "Safe moment" to reload the app. We only reload when ALL hold:
+ *  - no modal/dialog is open (a form is likely in there);
+ *  - the user is not mid-input: no focused field with content, and no field the
+ *    user typed into (trusted `input` event) within the last `EDIT_WINDOW_MS`
+ *    that still has content (a file input with selected files counts).
+ *    Prefilled/autofilled fields don't count;
+ *  - the tab is hidden, OR the user has been idle for `minIdleMs` (default 60 s)
+ *    so we don't yank the page from under someone who is reading/scrolling.
+ * Hosts with other needs pass `isSafeToApply` to replace this.
+ */
+export interface SafetySnapshot {
+    modalOpen: boolean;
+    editingInProgress: boolean;
+    visible: boolean;
+    /** ms since the last pointer/keyboard/touch/wheel activity. */
+    idleMs: number;
+}
+export interface SafetyOptions {
+    /** Idle time required to reload a VISIBLE tab. Default 60 s. */
+    minIdleMs?: number;
+}
+export declare const DEFAULT_MIN_IDLE_MS: number;
+export declare function isSafeSnapshot(s: SafetySnapshot, opts?: SafetyOptions): boolean;
+/**
+ * Starts (ref-counted) tracking of user edits and activity. Returns a disposer.
+ * No-op outside the browser.
+ */
+export declare function installActivityTracking(doc?: Document | undefined): () => void;
+export declare function readSafetySnapshot(doc?: Document | undefined, now?: number): SafetySnapshot;
+//# sourceMappingURL=dom-safety.d.ts.map

package/dist/dom-safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-safety.d.ts","sourceRoot":"","sources":["../src/dom-safety.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,OAAO,CAAA;IAClB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,eAAO,MAAM,mBAAmB,QAAY,CAAA;AAG5C,wBAAgB,cAAc,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAInF;AA0BD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,QAAQ,GAAG,SAAkE,GAAG,MAAM,IAAI,CAsCtI;AAED,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,QAAQ,GAAG,SAAkE,EAAE,GAAG,SAAa,GAAG,cAAc,CAqBvJ"}

package/dist/dom-safety.js

@@ -0,0 +1,104 @@
+import { hasOpenModal } from './use-modal-open';
+export const DEFAULT_MIN_IDLE_MS = 60 * 1000;
+const EDIT_WINDOW_MS = 30 * 60 * 1000;
+export function isSafeSnapshot(s, opts = {}) {
+    const minIdle = opts.minIdleMs ?? DEFAULT_MIN_IDLE_MS;
+    if (s.modalOpen || s.editingInProgress)
+        return false;
+    return !s.visible || s.idleMs >= minIdle;
+}
+const NON_TEXT_INPUTS = new Set([
+    'hidden', 'checkbox', 'radio', 'button', 'submit', 'reset', 'range', 'color', 'image',
+]);
+function hasContent(el) {
+    if (typeof HTMLInputElement !== 'undefined' && el instanceof HTMLInputElement) {
+        // A <input type=file> with selected files is work in progress too.
+        if (el.type === 'file')
+            return (el.files?.length ?? 0) > 0;
+        return !NON_TEXT_INPUTS.has(el.type) && el.value.trim().length > 0;
+    }
+    if (typeof HTMLTextAreaElement !== 'undefined' && el instanceof HTMLTextAreaElement) {
+        return el.value.trim().length > 0;
+    }
+    if (el instanceof HTMLElement && el.isContentEditable) {
+        return (el.textContent ?? '').trim().length > 0;
+    }
+    return false;
+}
+const edited = new WeakMap();
+let lastActivity = Date.now();
+let trackers = 0;
+let untrack;
+/**
+ * Starts (ref-counted) tracking of user edits and activity. Returns a disposer.
+ * No-op outside the browser.
+ */
+export function installActivityTracking(doc = typeof document === 'undefined' ? undefined : document) {
+    if (!doc)
+        return () => { };
+    if (trackers === 0) {
+        const onInput = (e) => {
+            if (e.isTrusted && e.target instanceof Element)
+                edited.set(e.target, Date.now());
+            lastActivity = Date.now();
+        };
+        const onActivity = () => {
+            lastActivity = Date.now();
+        };
+        const onFormDone = (e) => {
+            if (typeof HTMLFormElement !== 'undefined' && e.target instanceof HTMLFormElement) {
+                for (const el of Array.from(e.target.elements))
+                    edited.delete(el);
+            }
+        };
+        const activity = ['pointerdown', 'keydown', 'touchstart', 'wheel'];
+        doc.addEventListener('input', onInput, true);
+        doc.addEventListener('submit', onFormDone, true);
+        doc.addEventListener('reset', onFormDone, true);
+        for (const t of activity)
+            doc.addEventListener(t, onActivity, { capture: true, passive: true });
+        untrack = () => {
+            doc.removeEventListener('input', onInput, true);
+            doc.removeEventListener('submit', onFormDone, true);
+            doc.removeEventListener('reset', onFormDone, true);
+            for (const t of activity)
+                doc.removeEventListener(t, onActivity, true);
+        };
+    }
+    trackers += 1;
+    let done = false;
+    return () => {
+        if (done)
+            return;
+        done = true;
+        trackers -= 1;
+        if (trackers === 0) {
+            untrack?.();
+            untrack = undefined;
+        }
+    };
+}
+export function readSafetySnapshot(doc = typeof document === 'undefined' ? undefined : document, now = Date.now()) {
+    if (!doc)
+        return { modalOpen: false, editingInProgress: false, visible: false, idleMs: Infinity };
+    const active = doc.activeElement;
+    let editing = !!active && active !== doc.body && hasContent(active);
+    if (!editing) {
+        // WeakMap is not iterable: probe the editable candidates currently in the DOM.
+        const candidates = doc.querySelectorAll('input, textarea, [contenteditable]');
+        for (const el of Array.from(candidates)) {
+            const at = edited.get(el);
+            if (at !== undefined && now - at < EDIT_WINDOW_MS && el.isConnected && hasContent(el)) {
+                editing = true;
+                break;
+            }
+        }
+    }
+    return {
+        modalOpen: hasOpenModal(doc),
+        editingInProgress: editing,
+        visible: doc.visibilityState === 'visible',
+        idleMs: now - lastActivity,
+    };
+}
+//# sourceMappingURL=dom-safety.js.map

package/dist/dom-safety.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-safety.js","sourceRoot":"","sources":["../src/dom-safety.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -6,6 +6,14 @@ export { PushNotificationService, } from './push-service';
 export type { PushApiClient, PushServiceOptions } from './push-service';
 export { NotificationManager, notificationManager, } from './notification-manager';
 export type { NotificationOptions, NotificationManagerOptions } from './notification-manager';
+export { decideUpdate, resolveUpdatePolicy, autoApplyThreshold, isWithinTtl, DEFAULT_UPDATE_POLICY, } from './update-policy';
+export type { UpdatePolicy, UpdateState, UpdateDecision } from './update-policy';
+export { isSafeSnapshot, readSafetySnapshot, installActivityTracking } from './dom-safety';
+export type { SafetySnapshot, SafetyOptions } from './dom-safety';
+export { createUpdateController } from './update-controller';
+export type { UpdateController, UpdateControllerOptions, UpdateSnapshot, VersionCheck, } from './update-controller';
+export { useServiceWorkerUpdate } from './use-service-worker-update';
+export type { UseServiceWorkerUpdateOptions, UseServiceWorkerUpdateResult, } from './use-service-worker-update';
 export { useModalOpen, hasOpenModal } from './use-modal-open';
 export { PWAInstallPrompt, PWAUpdatePrompt, OfflineIndicator, NotificationPermissionPrompt, } from './components';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AACvD,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAClD,YAAY,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAErD,OAAO,EACL,uBAAuB,GACxB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAEvE,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AAE7F,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE7D,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,4BAA4B,GAC7B,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AACvD,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAClD,YAAY,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAErD,OAAO,EACL,uBAAuB,GACxB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAEvE,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AAE7F,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,qBAAqB,GACtB,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChF,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAC1F,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAC5D,YAAY,EACV,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,EACd,YAAY,GACb,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACpE,YAAY,EACV,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE7D,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,4BAA4B,GAC7B,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -2,6 +2,10 @@ export { PWAProvider, usePWAContext } from './provider';
 export { usePWA, useNotifications } from './hooks';
 export { PushNotificationService, } from './push-service';
 export { NotificationManager, notificationManager, } from './notification-manager';
+export { decideUpdate, resolveUpdatePolicy, autoApplyThreshold, isWithinTtl, DEFAULT_UPDATE_POLICY, } from './update-policy';
+export { isSafeSnapshot, readSafetySnapshot, installActivityTracking } from './dom-safety';
+export { createUpdateController } from './update-controller';
+export { useServiceWorkerUpdate } from './use-service-worker-update';
 export { useModalOpen, hasOpenModal } from './use-modal-open';
 export { PWAInstallPrompt, PWAUpdatePrompt, OfflineIndicator, NotificationPermissionPrompt, } from './components';
 // `metacorePWA` lives in the dedicated `@asteby/metacore-pwa/vite-plugin`

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAOvD,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAGlD,OAAO,EACL,uBAAuB,GACxB,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,wBAAwB,CAAA;AAG/B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE7D,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,4BAA4B,GAC7B,MAAM,cAAc,CAAA;AAErB,0EAA0E;AAC1E,yEAAyE;AACzE,kEAAkE;AAClE,yEAAyE;AACzE,uBAAuB;AACvB,EAAE;AACF,mEAAmE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAOvD,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAGlD,OAAO,EACL,uBAAuB,GACxB,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,wBAAwB,CAAA;AAG/B,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,WAAW,EACX,qBAAqB,GACtB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAE1F,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAO5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AAMpE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE7D,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,4BAA4B,GAC7B,MAAM,cAAc,CAAA;AAErB,0EAA0E;AAC1E,yEAAyE;AACzE,kEAAkE;AAClE,yEAAyE;AACzE,uBAAuB;AACvB,EAAE;AACF,mEAAmE"}

package/dist/provider.d.ts

@@ -1,4 +1,6 @@
 import { type ReactNode } from 'react';
+import type { VersionCheck } from './update-controller';
+import type { UpdatePolicy } from './update-policy';
 import { type PushApiClient, type PushServiceOptions } from './push-service';
 export interface PWAContextValue {
     isOnline: boolean;
@@ -46,8 +48,30 @@ export interface PWAProviderProps {
     pushOptions?: PushServiceOptions;
     /** Override user-facing toast messages. */
     messages?: PWAProviderMessages;
-    /** Interval in ms between SW update checks. Default: 1 hour. Set to 0 to disable. */
+    /** Interval in ms between SW update checks. Default: 1 hour (5 min when `updateStrategy="prompt"`). Set to 0 to disable. */
     updateCheckIntervalMs?: number;
+    /**
+     * How a waiting service worker is handled.
+     *  - `'auto'` (default, unchanged): the provider reloads on every
+     *    `controllerchange` (hosts whose sw.js does skipWaiting + clientsClaim).
+     *  - `'prompt'`: shared update policy. Nothing reloads until the user accepts
+     *    (`updateApp`) or, if configured, `autoApplyAfterMs` /
+     *    `staleAutoApplyAfterMs` elapse at a safe moment (no open modal, no
+     *    half-filled form, tab hidden or idle). Pair with `<PWAUpdatePrompt />`
+     *    and a sw.js that does NOT skipWaiting on install (only on the
+     *    `SKIP_WAITING` message, as in the packaged template).
+     */
+    updateStrategy?: 'auto' | 'prompt';
+    /** Prompt strategy: auto-apply after the update has waited this long (safe moments only). Default: never. */
+    autoApplyAfterMs?: number;
+    /** Prompt strategy: like `autoApplyAfterMs` once `versionCheck` found the client outdated. Default: never. */
+    staleAutoApplyAfterMs?: number;
+    /** Prompt strategy: how long a dismissal hides the prompt. Default 1 h. */
+    dismissTtlMs?: UpdatePolicy['dismissTtlMs'];
+    /** Prompt strategy: replaces the default "safe to reload" test. */
+    isSafeToApply?: () => boolean;
+    /** Prompt strategy: compare the embedded build version with the server's. */
+    versionCheck?: VersionCheck;
     /**
      * Automatically create the push subscription once notification permission is
      * granted (default: true). Having permission is NOT enough — without a
@@ -64,7 +88,7 @@ export interface PWAProviderProps {
     /** Called when SW registration fails. */
     onRegisterError?: (error: unknown) => void;
 }
-export declare function PWAProvider({ children, api, pushOptions, messages, updateCheckIntervalMs, autoSubscribeOnGranted, onRegistered, onRegisterError, }: PWAProviderProps): import("react").JSX.Element;
+export declare function PWAProvider({ children, api, pushOptions, messages, updateCheckIntervalMs, updateStrategy, autoApplyAfterMs, staleAutoApplyAfterMs, dismissTtlMs, isSafeToApply, versionCheck, autoSubscribeOnGranted, onRegistered, onRegisterError, }: PWAProviderProps): import("react").JSX.Element;
 export declare function usePWAContext(): PWAContextValue;
 export {};
 //# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AACA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAA;AAGd,OAAO,EAA2B,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAErG,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,CAAA;IACjB,aAAa,EAAE,OAAO,CAAA;IACtB,WAAW,EAAE,OAAO,CAAA;IACpB,eAAe,EAAE,OAAO,CAAA;IACxB,gBAAgB,EAAE,OAAO,CAAA;IACzB,UAAU,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IAClC,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,iBAAiB,EAAE,MAAM,IAAI,CAAA;IAC7B,eAAe,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IACvC,mBAAmB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3C,oBAAoB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1C;AAID,2DAA2D;AAC3D,UAAU,wBAAyB,SAAQ,KAAK;IAC9C,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3B,UAAU,EAAE,OAAO,CAAC;QAAE,OAAO,EAAE,UAAU,GAAG,WAAW,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC7E;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,cAAc,EAAE,wBAAwB,GAAG,IAAI,CAAA;KAChD;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAYD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,SAAS,CAAA;IACnB;;;OAGG;IACH,GAAG,CAAC,EAAE,aAAa,CAAA;IACnB,oCAAoC;IACpC,WAAW,CAAC,EAAE,kBAAkB,CAAA;IAChC,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,mBAAmB,CAAA;IAC9B,qFAAqF;IACrF,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B;;;;;;;OAOG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,YAAY,EAAE,yBAAyB,GAAG,SAAS,KAAK,IAAI,CAAA;IAC5E,yCAAyC;IACzC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CAC3C;AAED,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,GAAG,EACH,WAAW,EACX,QAAQ,EACR,qBAAsC,EACtC,sBAA6B,EAC7B,YAAY,EACZ,eAAe,GAChB,EAAE,gBAAgB,+BA0SlB;AAED,wBAAgB,aAAa,IAAI,eAAe,CAM/C"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"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"}

package/dist/provider.js

@@ -3,6 +3,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useContext, useEffect, useMemo, useRef, useState, } from 'react';
 import { useRegisterSW } from 'virtual:pwa-register/react';
 import { toast } from 'sonner';
+import { useServiceWorkerUpdate } from './use-service-worker-update';
 import { PushNotificationService } from './push-service';
 const PWAContext = createContext(undefined);
 const DEFAULT_MESSAGES = {
@@ -14,7 +15,10 @@ const DEFAULT_MESSAGES = {
     cannotInstall: 'La app ya está instalada o no se puede instalar',
     installing: 'Instalando app...',
 };
-export function PWAProvider({ children, api, pushOptions, messages, updateCheckIntervalMs = 60 * 60 * 1000, autoSubscribeOnGranted = true, onRegistered, onRegisterError, }) {
+export function PWAProvider({ children, api, pushOptions, messages, updateCheckIntervalMs, updateStrategy = 'auto', autoApplyAfterMs, staleAutoApplyAfterMs, dismissTtlMs, isSafeToApply, versionCheck, autoSubscribeOnGranted = true, onRegistered, onRegisterError, }) {
+    const promptMode = updateStrategy === 'prompt';
+    // Legacy cadence: 1 h. The policy machine defaults to 5 min (its own default).
+    const legacyIntervalMs = updateCheckIntervalMs ?? 60 * 60 * 1000;
     const msgs = useMemo(() => ({ ...DEFAULT_MESSAGES, ...messages }), [messages]);
     const [isOnline, setIsOnline] = useState(typeof navigator !== 'undefined' ? navigator.onLine : true);
     const [isInstallable, setIsInstallable] = useState(false);
@@ -25,13 +29,22 @@ export function PWAProvider({ children, api, pushOptions, messages, updateCheckI
     if (api && !pushServiceRef.current) {
         pushServiceRef.current = new PushNotificationService(api, pushOptions);
     }
-    const { needRefresh: [needRefresh, setNeedRefresh], updateServiceWorker, } = useRegisterSW({
+    const policyUpdate = useServiceWorkerUpdate({
+        enabled: promptMode,
+        checkIntervalMs: updateCheckIntervalMs,
+        autoApplyAfterMs,
+        staleAutoApplyAfterMs,
+        dismissTtlMs,
+        isSafeToApply,
+        versionCheck,
+    });
+    const { needRefresh: [legacyNeedRefresh, setNeedRefresh], updateServiceWorker, } = useRegisterSW({
         onRegistered(registration) {
             onRegistered?.(registration);
-            if (registration && updateCheckIntervalMs > 0) {
+            if (!promptMode && registration && legacyIntervalMs > 0) {
                 setInterval(() => {
                     registration.update();
-                }, updateCheckIntervalMs);
+                }, legacyIntervalMs);
             }
         },
         onRegisterError(error) {
@@ -157,6 +170,10 @@ export function PWAProvider({ children, api, pushOptions, messages, updateCheckI
         };
     }, [msgs]);
     useEffect(() => {
+        // Prompt strategy: the reload is owned by the update policy (single reload
+        // after OUR SKIP_WAITING), never by a bare controllerchange.
+        if (promptMode)
+            return;
         if (typeof navigator === 'undefined' || !('serviceWorker' in navigator))
             return;
         let refreshing = false;
@@ -170,7 +187,7 @@ export function PWAProvider({ children, api, pushOptions, messages, updateCheckI
         return () => {
             navigator.serviceWorker.removeEventListener('controllerchange', handleControllerChange);
         };
-    }, []);
+    }, [promptMode]);
     // Independent SW update detection. A host may alias `virtual:pwa-register/react`
     // to a no-op stub (e.g. ops's module-federation setup), in which case
     // useRegisterSW.onRegistered never fires and the periodic update() above never
@@ -184,7 +201,7 @@ export function PWAProvider({ children, api, pushOptions, messages, updateCheckI
     useEffect(() => {
         if (typeof navigator === 'undefined' || !('serviceWorker' in navigator))
             return;
-        if (updateCheckIntervalMs <= 0)
+        if (promptMode || legacyIntervalMs <= 0)
             return;
         let reg;
         let interval;
@@ -195,7 +212,7 @@ export function PWAProvider({ children, api, pushOptions, messages, updateCheckI
             .then((registration) => {
             reg = registration;
             check();
-            interval = setInterval(check, updateCheckIntervalMs);
+            interval = setInterval(check, legacyIntervalMs);
         })
             .catch(() => { });
         const onVisible = () => {
@@ -214,7 +231,7 @@ export function PWAProvider({ children, api, pushOptions, messages, updateCheckI
             }
             window.removeEventListener('focus', check);
         };
-    }, [updateCheckIntervalMs]);
+    }, [promptMode, legacyIntervalMs]);
     const installApp = async () => {
         if (!deferredPrompt) {
             toast.error(msgs.cannotInstall);
@@ -232,6 +249,10 @@ export function PWAProvider({ children, api, pushOptions, messages, updateCheckI
         return false;
     };
     const updateApp = () => {
+        if (promptMode) {
+            policyUpdate.applyNow();
+            return;
+        }
         // For autoUpdate SWs (skipWaiting + clientsClaim on install) there is no
         // "waiting" worker at click-time — the new SW is already active and
         // serving the updated assets.  updateServiceWorker(true) posts a
@@ -279,12 +300,12 @@ export function PWAProvider({ children, api, pushOptions, messages, updateCheckI
     const value = {
         isOnline,
         isInstallable,
-        needRefresh,
+        needRefresh: promptMode ? policyUpdate.updatePending : legacyNeedRefresh,
         isPushSupported,
         isPushSubscribed,
         installApp,
         updateApp,
-        closeUpdatePrompt: () => setNeedRefresh(false),
+        closeUpdatePrompt: () => (promptMode ? policyUpdate.dismiss() : setNeedRefresh(false)),
         subscribeToPush,
         unsubscribeFromPush,
         testPushNotification,

package/dist/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"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"}

package/dist/update-controller.d.ts

@@ -0,0 +1,68 @@
+import { type UpdatePolicy } from './update-policy';
+/**
+ * Framework-free state machine that drives a service-worker update according to
+ * an {@link UpdatePolicy}. The React hook / PWAProvider are thin wrappers, and
+ * tests drive it with a fake registration.
+ *
+ * Effects: periodic `registration.update()` (visible tab only), re-check on
+ * visibilitychange/focus, `updatefound` -> `statechange` detection of the
+ * waiting worker, periodic re-evaluation while an update waits (so
+ * `autoApplyAfterMs` and "becomes safe" are noticed), optional version-drift
+ * check, and a single guarded reload after `SKIP_WAITING` -> `controllerchange`
+ * (with a fallback timer).
+ */
+export interface VersionCheck {
+    /** Version embedded in this build (e.g. commit hash via Vite `define`). */
+    current: string;
+    /** Fetches the latest deployed version. Return undefined when unknown. The library assumes no endpoint. */
+    fetchLatest: () => Promise<string | undefined>;
+    /** How often to compare. Default 5 min. */
+    intervalMs?: number;
+}
+export interface UpdateControllerOptions {
+    policy?: Partial<UpdatePolicy>;
+    /** `registration.update()` cadence while visible. Default 5 min. 0 disables. */
+    checkIntervalMs?: number;
+    /** Re-evaluation cadence while an update is waiting. Default 15 s. */
+    evaluateIntervalMs?: number;
+    /** Replaces the default safe-moment test (modal/edit/idle). */
+    isSafeToApply?: () => boolean;
+    versionCheck?: VersionCheck;
+    /** localStorage key prefix. Default `metacore_pwa_update`. */
+    storagePrefix?: string;
+    /** Reload anyway if `controllerchange` never fires. Default 5 s. */
+    reloadFallbackMs?: number;
+    /** Delay between `update()` and re-reading `registration.waiting`. Default 5 s. */
+    postCheckDelayMs?: number;
+}
+export type UpdateRegistration = Pick<ServiceWorkerRegistration, 'waiting' | 'installing' | 'update' | 'addEventListener' | 'removeEventListener'>;
+export interface UpdateControllerDeps {
+    now: () => number;
+    storage: Pick<Storage, 'getItem' | 'setItem' | 'removeItem'> | undefined;
+    container: Pick<ServiceWorkerContainer, 'addEventListener' | 'removeEventListener'> | undefined;
+    doc: Pick<Document, 'addEventListener' | 'removeEventListener' | 'visibilityState'> | undefined;
+    win: Pick<Window, 'addEventListener' | 'removeEventListener'> | undefined;
+    reload: () => void;
+}
+export interface UpdateSnapshot {
+    /** The prompt should be shown (decision === 'prompt'). */
+    updatePending: boolean;
+    /** SKIP_WAITING sent, waiting for controllerchange/reload. */
+    applying: boolean;
+    /** Client is known to be older than the server. */
+    stale: boolean;
+}
+export interface UpdateController {
+    /** Binds the live registration and starts evaluating. */
+    attach: (registration: UpdateRegistration) => void;
+    /** Starts listeners/timers (idempotent). Returns a disposer. */
+    start: () => () => void;
+    stop: () => void;
+    evaluate: () => void;
+    applyNow: () => void;
+    dismiss: () => void;
+    getSnapshot: () => UpdateSnapshot;
+    subscribe: (fn: (s: UpdateSnapshot) => void) => () => void;
+}
+export declare function createUpdateController(options?: UpdateControllerOptions, depsOverride?: Partial<UpdateControllerDeps>): UpdateController;
+//# sourceMappingURL=update-controller.d.ts.map

package/dist/update-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-controller.d.ts","sourceRoot":"","sources":["../src/update-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,iBAAiB,CAAA;AAGxB;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAA;IACf,2GAA2G;IAC3G,WAAW,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAC9C,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;IAC9B,gFAAgF;IAChF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,sEAAsE;IACtE,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,OAAO,CAAA;IAC7B,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,mFAAmF;IACnF,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACnC,yBAAyB,EACzB,SAAS,GAAG,YAAY,GAAG,QAAQ,GAAG,kBAAkB,GAAG,qBAAqB,CACjF,CAAA;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,MAAM,CAAA;IACjB,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC,GAAG,SAAS,CAAA;IACxE,SAAS,EAAE,IAAI,CAAC,sBAAsB,EAAE,kBAAkB,GAAG,qBAAqB,CAAC,GAAG,SAAS,CAAA;IAC/F,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,kBAAkB,GAAG,qBAAqB,GAAG,iBAAiB,CAAC,GAAG,SAAS,CAAA;IAC/F,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,qBAAqB,CAAC,GAAG,SAAS,CAAA;IACzE,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,aAAa,EAAE,OAAO,CAAA;IACtB,8DAA8D;IAC9D,QAAQ,EAAE,OAAO,CAAA;IACjB,mDAAmD;IACnD,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,MAAM,EAAE,CAAC,YAAY,EAAE,kBAAkB,KAAK,IAAI,CAAA;IAClD,gEAAgE;IAChE,KAAK,EAAE,MAAM,MAAM,IAAI,CAAA;IACvB,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,WAAW,EAAE,MAAM,cAAc,CAAA;IACjC,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,cAAc,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;CAC3D;AAsBD,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,uBAA4B,EACrC,YAAY,GAAE,OAAO,CAAC,oBAAoB,CAAM,GAC/C,gBAAgB,CA2RlB"}

package/dist/update-controller.js

@@ -0,0 +1,309 @@
+import { decideUpdate, isWithinTtl, resolveUpdatePolicy, } from './update-policy';
+import { installActivityTracking, isSafeSnapshot, readSafetySnapshot } from './dom-safety';
+const safeStorage = () => {
+    try {
+        return typeof localStorage === 'undefined' ? undefined : localStorage;
+    }
+    catch {
+        return undefined;
+    }
+};
+function defaultDeps() {
+    const hasSW = typeof navigator !== 'undefined' && 'serviceWorker' in navigator;
+    return {
+        now: () => Date.now(),
+        storage: safeStorage(),
+        container: hasSW ? navigator.serviceWorker : undefined,
+        doc: typeof document === 'undefined' ? undefined : document,
+        win: typeof window === 'undefined' ? undefined : window,
+        reload: () => window.location.reload(),
+    };
+}
+export function createUpdateController(options = {}, depsOverride = {}) {
+    const deps = { ...defaultDeps(), ...depsOverride };
+    const policy = resolveUpdatePolicy(options.policy);
+    const checkIntervalMs = options.checkIntervalMs ?? 5 * 60 * 1000;
+    const evaluateIntervalMs = options.evaluateIntervalMs ?? 15 * 1000;
+    const fallbackMs = options.reloadFallbackMs ?? 5000;
+    const postCheckMs = options.postCheckDelayMs ?? 5000;
+    const prefix = options.storagePrefix ?? 'metacore_pwa_update';
+    const K = {
+        since: `${prefix}_waiting_since`,
+        dismissed: `${prefix}_dismissed_at`,
+        accepted: `${prefix}_accepted_at`,
+        attempt: `${prefix}_last_apply_attempt_at`,
+    };
+    const read = (key) => {
+        try {
+            const v = deps.storage?.getItem(key);
+            if (!v)
+                return undefined;
+            const n = Number(v);
+            return Number.isFinite(n) ? n : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    };
+    const write = (key, value) => {
+        try {
+            if (value === undefined)
+                deps.storage?.removeItem(key);
+            else
+                deps.storage?.setItem(key, String(value));
+        }
+        catch {
+            /* storage unavailable: policy degrades to in-session behaviour */
+        }
+    };
+    let registration;
+    let snapshot = { updatePending: false, applying: false, stale: false };
+    const listeners = new Set();
+    let started = false;
+    let reloaded = false;
+    let evalTimer;
+    let cleanups = [];
+    let installingCleanup;
+    let controllerChangeCleanup;
+    // Identity of the waiting worker last seen by THIS instance (a new deploy replaces it).
+    let seenWaiting;
+    const timeouts = new Set();
+    const patch = (p) => {
+        const next = { ...snapshot, ...p };
+        if (next.updatePending === snapshot.updatePending &&
+            next.applying === snapshot.applying &&
+            next.stale === snapshot.stale) {
+            return;
+        }
+        snapshot = next;
+        listeners.forEach((fn) => fn(snapshot));
+    };
+    const later = (fn, ms) => {
+        const t = setTimeout(() => {
+            timeouts.delete(t);
+            fn();
+        }, ms);
+        timeouts.add(t);
+    };
+    const isSafe = () => options.isSafeToApply ? options.isSafeToApply() : isSafeSnapshot(readSafetySnapshot(undefined, deps.now()));
+    const reloadOnce = () => {
+        if (reloaded)
+            return;
+        reloaded = true;
+        deps.reload();
+    };
+    const stopEvalTimer = () => {
+        if (evalTimer)
+            clearInterval(evalTimer);
+        evalTimer = undefined;
+    };
+    const evaluate = () => {
+        if (!registration)
+            return;
+        const now = deps.now();
+        const hasWaiting = !!registration.waiting;
+        if (!hasWaiting) {
+            // Nothing pending: a previous acceptance has been fulfilled.
+            seenWaiting = undefined;
+            write(K.since, undefined);
+            write(K.accepted, undefined);
+            write(K.attempt, undefined);
+            stopEvalTimer();
+            patch({ updatePending: false });
+            return;
+        }
+        if (snapshot.applying)
+            return; // reload in flight: never decide again
+        const waiting = registration.waiting;
+        const identity = { ref: waiting, scriptURL: waiting?.scriptURL };
+        if (seenWaiting && (seenWaiting.ref !== identity.ref || seenWaiting.scriptURL !== identity.scriptURL)) {
+            // A different worker is waiting (e.g. v2 deployed over a waiting v1): it
+            // inherits neither v1's age, its dismissal nor its apply attempt.
+            write(K.since, undefined);
+            write(K.dismissed, undefined);
+            write(K.accepted, undefined);
+            write(K.attempt, undefined);
+        }
+        seenWaiting = identity;
+        // Hard loop guard: at most ONE automatic apply attempt per acceptedTtlMs. If
+        // we already tried and a worker is STILL waiting, applying again would loop
+        // (sw.js ignoring SKIP_WAITING...). Forget the acceptance and go back to
+        // asking; only an explicit click on "Update" may retry.
+        const recentAttempt = isWithinTtl(read(K.attempt), now, policy.acceptedTtlMs);
+        if (recentAttempt)
+            write(K.accepted, undefined);
+        let waitingSince = read(K.since);
+        if (waitingSince === undefined || waitingSince > now) {
+            waitingSince = now;
+            write(K.since, now);
+        }
+        const decision = decideUpdate({
+            hasWaiting,
+            now,
+            waitingSince,
+            dismissedAt: read(K.dismissed),
+            acceptedAt: read(K.accepted),
+            stale: snapshot.stale,
+            safe: !recentAttempt && isSafe(),
+        }, policy);
+        if (decision === 'apply') {
+            applyNow();
+            return;
+        }
+        patch({ updatePending: decision === 'prompt' });
+        if (started && !evalTimer && evaluateIntervalMs > 0) {
+            evalTimer = setInterval(evaluate, evaluateIntervalMs);
+        }
+    };
+    function applyNow() {
+        if (snapshot.applying || !registration)
+            return;
+        patch({ applying: true, updatePending: false });
+        // Next deploy must notify again; remember the acceptance so a still-waiting
+        // worker after the reload is applied without re-asking.
+        const at = deps.now();
+        write(K.dismissed, undefined);
+        // Never renew a still-valid acceptance; always stamp the attempt (loop guard).
+        if (!isWithinTtl(read(K.accepted), at, policy.acceptedTtlMs))
+            write(K.accepted, at);
+        write(K.attempt, at);
+        // ONE reload, and only once the new worker controls the page. Reloading
+        // earlier leaves a blank page on mobile (old precache already cleaned).
+        controllerChangeCleanup?.();
+        deps.container?.addEventListener('controllerchange', reloadOnce, { once: true });
+        controllerChangeCleanup = () => deps.container?.removeEventListener('controllerchange', reloadOnce);
+        later(reloadOnce, fallbackMs);
+        const waiting = registration?.waiting;
+        if (waiting) {
+            try {
+                waiting.postMessage({ type: 'SKIP_WAITING' });
+            }
+            catch {
+                reloadOnce();
+            }
+        }
+        else {
+            // Already active (skipWaiting worker) or nothing to activate: reload picks the new build.
+            reloadOnce();
+        }
+    }
+    const check = () => {
+        if (!registration)
+            return;
+        void registration.update().catch(() => { });
+        // update() installs in the background; look again shortly after.
+        later(evaluate, postCheckMs);
+    };
+    const checkVisible = () => {
+        if (deps.doc && deps.doc.visibilityState !== 'visible')
+            return;
+        check();
+    };
+    const checkVersion = async () => {
+        const vc = options.versionCheck;
+        if (!vc)
+            return;
+        let latest;
+        try {
+            latest = await vc.fetchLatest();
+        }
+        catch {
+            return;
+        }
+        if (!latest)
+            return;
+        const stale = latest !== vc.current;
+        const wasStale = snapshot.stale;
+        patch({ stale });
+        if (stale && (!wasStale || !registration?.waiting))
+            check();
+        else if (stale !== wasStale)
+            evaluate();
+    };
+    const onUpdateFound = () => {
+        const installing = registration?.installing;
+        if (!installing)
+            return;
+        installingCleanup?.();
+        const onState = () => {
+            if (installing.state === 'installed')
+                evaluate();
+        };
+        installing.addEventListener('statechange', onState);
+        installingCleanup = () => installing.removeEventListener('statechange', onState);
+    };
+    const controller = {
+        attach(reg) {
+            if (registration === reg)
+                return;
+            registration?.removeEventListener('updatefound', onUpdateFound);
+            installingCleanup?.();
+            installingCleanup = undefined;
+            registration = reg;
+            reg.addEventListener('updatefound', onUpdateFound);
+            evaluate();
+            if (started)
+                checkVisible();
+        },
+        start() {
+            if (started)
+                return () => { };
+            started = true;
+            const onVisible = () => {
+                if (deps.doc?.visibilityState === 'visible') {
+                    checkVisible();
+                    void checkVersion();
+                    evaluate();
+                }
+            };
+            deps.doc?.addEventListener('visibilitychange', onVisible);
+            deps.win?.addEventListener('focus', onVisible);
+            cleanups.push(() => deps.doc?.removeEventListener('visibilitychange', onVisible));
+            cleanups.push(() => deps.win?.removeEventListener('focus', onVisible));
+            if (!options.isSafeToApply)
+                cleanups.push(installActivityTracking());
+            if (checkIntervalMs > 0) {
+                const id = setInterval(checkVisible, checkIntervalMs);
+                cleanups.push(() => clearInterval(id));
+            }
+            if (options.versionCheck) {
+                void checkVersion();
+                const id = setInterval(() => void checkVersion(), options.versionCheck.intervalMs ?? 5 * 60 * 1000);
+                cleanups.push(() => clearInterval(id));
+            }
+            if (registration) {
+                evaluate();
+                checkVisible();
+            }
+            return () => controller.stop();
+        },
+        stop() {
+            started = false;
+            stopEvalTimer();
+            registration?.removeEventListener('updatefound', onUpdateFound);
+            installingCleanup?.();
+            installingCleanup = undefined;
+            controllerChangeCleanup?.();
+            controllerChangeCleanup = undefined;
+            cleanups.forEach((fn) => fn());
+            cleanups = [];
+            timeouts.forEach((t) => clearTimeout(t));
+            timeouts.clear();
+        },
+        evaluate,
+        applyNow,
+        dismiss() {
+            write(K.dismissed, deps.now());
+            patch({ updatePending: false });
+        },
+        getSnapshot: () => snapshot,
+        subscribe(fn) {
+            listeners.add(fn);
+            return () => {
+                listeners.delete(fn);
+            };
+        },
+    };
+    return controller;
+}
+//# sourceMappingURL=update-controller.js.map

package/dist/update-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-controller.js","sourceRoot":"","sources":["../src/update-controller.ts"],"names":[],"mappings":"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"}

package/dist/update-policy.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Pure (React-free, DOM-free) update policy.
+ *
+ * Given a snapshot of the service-worker update state, decides whether the
+ * host should do nothing, ask the user, or silently apply the update. All
+ * functions are deterministic so the whole decision table is unit-testable.
+ *
+ * Invariants:
+ *  - Nothing is ever applied unless `safe` is true (never reload a half-filled form).
+ *  - With the default policy nothing is ever auto-applied: the worst case is a
+ *    prompt (current behaviour of every Metacore host).
+ */
+export type UpdateDecision = 'none' | 'prompt' | 'apply';
+export interface UpdatePolicy {
+    /** How long a dismissal ("Después") keeps the prompt hidden. Default: 1 h. */
+    dismissTtlMs: number;
+    /**
+     * How long after the user clicked "Actualizar" a still-waiting worker is
+     * applied without asking again (reload that lost the race, other tab open…).
+     * Default: 2 min.
+     */
+    acceptedTtlMs: number;
+    /**
+     * Apply on its own once the update has been waiting this long AND the moment
+     * is safe. Default: undefined = never auto-apply.
+     */
+    autoApplyAfterMs?: number;
+    /**
+     * Same as `autoApplyAfterMs` but used when the client is known to run an
+     * older build than the server (see `versionCheck`). When both are set the
+     * smaller one wins while stale. Default: undefined.
+     */
+    staleAutoApplyAfterMs?: number;
+}
+export declare const DEFAULT_UPDATE_POLICY: UpdatePolicy;
+export interface UpdateState {
+    /** A worker is installed and waiting to activate. */
+    hasWaiting: boolean;
+    /** Current epoch ms. */
+    now: number;
+    /** Epoch ms when the waiting worker was first seen (persisted across reloads). */
+    waitingSince?: number;
+    /** Epoch ms of the last dismissal. */
+    dismissedAt?: number;
+    /** Epoch ms of the last explicit "update now" click. */
+    acceptedAt?: number;
+    /** The client is known to be older than the server. */
+    stale: boolean;
+    /** Applying (reloading) right now would not interrupt the user. */
+    safe: boolean;
+}
+export declare function resolveUpdatePolicy(policy?: Partial<UpdatePolicy>): UpdatePolicy;
+/** True when `at` happened within the last `ttl` ms (future timestamps never count). */
+export declare function isWithinTtl(at: number | undefined, now: number, ttl: number): boolean;
+/** The auto-apply threshold in force for this state, or undefined when disabled. */
+export declare function autoApplyThreshold(stale: boolean, policy: UpdatePolicy): number | undefined;
+/**
+ * Decision table (first match wins):
+ *  1. no waiting worker                          -> none
+ *  2. accepted recently                          -> apply if safe, else none (never re-ask)
+ *  3. auto-apply threshold reached               -> apply if safe
+ *  4. dismissed within TTL                       -> none
+ *  5. otherwise                                  -> prompt
+ * A threshold reached while unsafe falls through to 4/5 (prompt unless dismissed).
+ */
+export declare function decideUpdate(state: UpdateState, policyInput?: Partial<UpdatePolicy>): UpdateDecision;
+//# sourceMappingURL=update-policy.d.ts.map

package/dist/update-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-policy.d.ts","sourceRoot":"","sources":["../src/update-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;AAExD,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,YAAY,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,eAAO,MAAM,qBAAqB,EAAE,YAKnC,CAAA;AAED,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,UAAU,EAAE,OAAO,CAAA;IACnB,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,uDAAuD;IACvD,KAAK,EAAE,OAAO,CAAA;IACd,mEAAmE;IACnE,IAAI,EAAE,OAAO,CAAA;CACd;AAED,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAQhF;AAKD,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAIrF;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAM3F;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,cAAc,CAoBpG"}

package/dist/update-policy.js

@@ -0,0 +1,75 @@
+/**
+ * Pure (React-free, DOM-free) update policy.
+ *
+ * Given a snapshot of the service-worker update state, decides whether the
+ * host should do nothing, ask the user, or silently apply the update. All
+ * functions are deterministic so the whole decision table is unit-testable.
+ *
+ * Invariants:
+ *  - Nothing is ever applied unless `safe` is true (never reload a half-filled form).
+ *  - With the default policy nothing is ever auto-applied: the worst case is a
+ *    prompt (current behaviour of every Metacore host).
+ */
+export const DEFAULT_UPDATE_POLICY = {
+    dismissTtlMs: 60 * 60 * 1000,
+    acceptedTtlMs: 2 * 60 * 1000,
+    autoApplyAfterMs: undefined,
+    staleAutoApplyAfterMs: undefined,
+};
+export function resolveUpdatePolicy(policy) {
+    const out = { ...DEFAULT_UPDATE_POLICY };
+    if (!policy)
+        return out;
+    for (const k of Object.keys(policy)) {
+        const v = policy[k];
+        if (v !== undefined)
+            out[k] = v;
+    }
+    return out;
+}
+const validMs = (v) => typeof v === 'number' && Number.isFinite(v) && v >= 0;
+/** True when `at` happened within the last `ttl` ms (future timestamps never count). */
+export function isWithinTtl(at, now, ttl) {
+    if (at === undefined || !Number.isFinite(at))
+        return false;
+    const age = now - at;
+    return age >= 0 && age < ttl;
+}
+/** The auto-apply threshold in force for this state, or undefined when disabled. */
+export function autoApplyThreshold(stale, policy) {
+    const normal = validMs(policy.autoApplyAfterMs) ? policy.autoApplyAfterMs : undefined;
+    const staleMs = stale && validMs(policy.staleAutoApplyAfterMs) ? policy.staleAutoApplyAfterMs : undefined;
+    if (normal === undefined)
+        return staleMs;
+    if (staleMs === undefined)
+        return normal;
+    return Math.min(normal, staleMs);
+}
+/**
+ * Decision table (first match wins):
+ *  1. no waiting worker                          -> none
+ *  2. accepted recently                          -> apply if safe, else none (never re-ask)
+ *  3. auto-apply threshold reached               -> apply if safe
+ *  4. dismissed within TTL                       -> none
+ *  5. otherwise                                  -> prompt
+ * A threshold reached while unsafe falls through to 4/5 (prompt unless dismissed).
+ */
+export function decideUpdate(state, policyInput) {
+    if (!state.hasWaiting)
+        return 'none';
+    const policy = resolveUpdatePolicy(policyInput);
+    if (isWithinTtl(state.acceptedAt, state.now, policy.acceptedTtlMs)) {
+        return state.safe ? 'apply' : 'none';
+    }
+    const threshold = autoApplyThreshold(state.stale, policy);
+    if (threshold !== undefined &&
+        state.waitingSince !== undefined &&
+        state.now - state.waitingSince >= threshold &&
+        state.safe) {
+        return 'apply';
+    }
+    if (isWithinTtl(state.dismissedAt, state.now, policy.dismissTtlMs))
+        return 'none';
+    return 'prompt';
+}
+//# sourceMappingURL=update-policy.js.map

package/dist/update-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-policy.js","sourceRoot":"","sources":["../src/update-policy.ts"],"names":[],"mappings":"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"}

package/dist/use-service-worker-update.d.ts

@@ -0,0 +1,25 @@
+import { type UpdateSnapshot, type VersionCheck } from './update-controller';
+import type { UpdatePolicy } from './update-policy';
+export interface UseServiceWorkerUpdateOptions extends Partial<UpdatePolicy> {
+    /** Turn the whole machine off (default true). Lets PWAProvider keep its legacy path. */
+    enabled?: boolean;
+    /** `registration.update()` cadence while the tab is visible. Default 5 min. 0 disables. */
+    checkIntervalMs?: number;
+    /** Replaces the default safe-moment test. */
+    isSafeToApply?: () => boolean;
+    versionCheck?: VersionCheck;
+    storagePrefix?: string;
+}
+export interface UseServiceWorkerUpdateResult extends UpdateSnapshot {
+    /** User accepted: SKIP_WAITING + single reload after controllerchange. */
+    applyNow: () => void;
+    /** User dismissed: hides the prompt for `dismissTtlMs`. */
+    dismiss: () => void;
+}
+/**
+ * React wrapper over {@link createUpdateController}. Binds to
+ * `navigator.serviceWorker.ready`, so it works regardless of how the host
+ * registers the worker (including a stubbed `virtual:pwa-register`).
+ */
+export declare function useServiceWorkerUpdate(options?: UseServiceWorkerUpdateOptions): UseServiceWorkerUpdateResult;
+//# sourceMappingURL=use-service-worker-update.d.ts.map

package/dist/use-service-worker-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-service-worker-update.d.ts","sourceRoot":"","sources":["../src/use-service-worker-update.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD,MAAM,WAAW,6BAA8B,SAAQ,OAAO,CAAC,YAAY,CAAC;IAC1E,wFAAwF;IACxF,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,2FAA2F;IAC3F,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,6CAA6C;IAC7C,aAAa,CAAC,EAAE,MAAM,OAAO,CAAA;IAC7B,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,4BAA6B,SAAQ,cAAc;IAClE,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAID;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,6BAAkC,GAAG,4BAA4B,CA8DhH"}

package/dist/use-service-worker-update.js

@@ -0,0 +1,70 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { createUpdateController, } from './update-controller';
+const IDLE = { updatePending: false, applying: false, stale: false };
+/**
+ * React wrapper over {@link createUpdateController}. Binds to
+ * `navigator.serviceWorker.ready`, so it works regardless of how the host
+ * registers the worker (including a stubbed `virtual:pwa-register`).
+ */
+export function useServiceWorkerUpdate(options = {}) {
+    const { enabled = true, checkIntervalMs, storagePrefix } = options;
+    const optsRef = useRef(options);
+    optsRef.current = options;
+    const [snap, setSnap] = useState(IDLE);
+    const ctrlRef = useRef(null);
+    const policyKey = [
+        options.dismissTtlMs,
+        options.acceptedTtlMs,
+        options.autoApplyAfterMs,
+        options.staleAutoApplyAfterMs,
+    ].join('|');
+    const vc = options.versionCheck;
+    const hasVc = !!vc;
+    const vcCurrent = vc?.current;
+    const vcInterval = vc?.intervalMs;
+    useEffect(() => {
+        if (!enabled || typeof navigator === 'undefined' || !('serviceWorker' in navigator))
+            return;
+        const o = optsRef.current;
+        const ctrl = createUpdateController({
+            policy: {
+                dismissTtlMs: o.dismissTtlMs,
+                acceptedTtlMs: o.acceptedTtlMs,
+                autoApplyAfterMs: o.autoApplyAfterMs,
+                staleAutoApplyAfterMs: o.staleAutoApplyAfterMs,
+            },
+            checkIntervalMs,
+            storagePrefix,
+            // Read through the ref so inline callbacks don't restart the machine.
+            isSafeToApply: o.isSafeToApply ? () => optsRef.current.isSafeToApply?.() ?? true : undefined,
+            versionCheck: hasVc && vcCurrent !== undefined
+                ? {
+                    current: vcCurrent,
+                    intervalMs: vcInterval,
+                    fetchLatest: () => optsRef.current.versionCheck?.fetchLatest() ?? Promise.resolve(undefined),
+                }
+                : undefined,
+        });
+        ctrlRef.current = ctrl;
+        const unsub = ctrl.subscribe(setSnap);
+        const stop = ctrl.start();
+        let cancelled = false;
+        navigator.serviceWorker.ready
+            .then((reg) => {
+            if (!cancelled)
+                ctrl.attach(reg);
+        })
+            .catch(() => { });
+        return () => {
+            cancelled = true;
+            unsub();
+            stop();
+            ctrlRef.current = null;
+            setSnap(IDLE);
+        };
+    }, [enabled, checkIntervalMs, storagePrefix, policyKey, hasVc, vcCurrent, vcInterval]);
+    const applyNow = useCallback(() => ctrlRef.current?.applyNow(), []);
+    const dismiss = useCallback(() => ctrlRef.current?.dismiss(), []);
+    return { ...snap, applyNow, dismiss };
+}
+//# sourceMappingURL=use-service-worker-update.js.map

package/dist/use-service-worker-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-service-worker-update.js","sourceRoot":"","sources":["../src/use-service-worker-update.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteby/metacore-pwa",
-  "version": "0.6.15",
+  "version": "0.7.1",
   "description": "Metacore PWA helpers — vite plugin wrapper, install/update prompts, push notifications, offline indicator",
   "license": "Apache-2.0",
   "repository": {
@@ -49,7 +49,7 @@
   },
   "dependencies": {
     "lucide-react": "^1.0.0",
-    "@asteby/metacore-notifications": "38.0.0"
+    "@asteby/metacore-notifications": "38.1.0"
   },
   "devDependencies": {
     "@types/react": "^19.0.0",
@@ -59,7 +59,8 @@
     "sonner": "^2.0.0",
     "typescript": "^6.0.0",
     "vite": "^8.0.0",
-    "vite-plugin-pwa": "^1.2.0"
+    "vite-plugin-pwa": "^1.2.0",
+    "vitest": "^4.0.0"
   },
   "publishConfig": {
     "access": "public"
@@ -68,6 +69,7 @@
     "build": "tsc -p tsconfig.json",
     "dev": "tsc -w -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
     "clean": "rm -rf dist"
   }
 }