Resilience

Named helpers for reconnect / wake / restore workflows (canonical name Resilience, not “Recovery”).

Previous: Conditions · Next: Adapters

Import path

import { createBrowserLifecycle, createResilienceApi } from "@jayoncode/browser-lifecycle";

Usage

import { createBrowserLifecycle, createResilienceApi } from "@jayoncode/browser-lifecycle";

const lifecycle = createBrowserLifecycle();
const resilience = createResilienceApi(lifecycle);

resilience.onReconnect(() => flushOfflineQueue());
resilience.onWake(() => refreshStaleData()); // page:resume
resilience.onRestore(() => rehydrateUi()); // session:restored

// Fires on any of the three
const off = resilience.onRecover(() => sync());
off();

resilience.dispose();

Wraps catalog events only — no persistence engine, no extra browser APIs.

Error isolation

Pass onHandlerError to observe (e.g. log) handler exceptions without letting them escape:

const resilience = createResilienceApi(lifecycle, {
  onHandlerError: (error) => reportToSentry(error),
});

When omitted, thrown errors from a resilience handler are swallowed silently — the session keeps running either way.

Framework adapters →