kaafil-react-uikit 0.8.0 → 0.10.0

package/dist/offline/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/offline/credentialCache.ts","../../src/offline/serviceWorker.ts"],"names":[],"mappings":";AA+DA,SAAS,oBAAoB,KAAA,EAAyB;AACpD,EAAA,OAAO,KAAA,YAAiB,SAAA;AAC1B;AA6BO,SAAS,oBAAA,CACd,SACA,OAAA,EACoB;AACpB,EAAA,MAAM,EAAE,OAAM,GAAI,OAAA;AAClB,EAAA,MAAM,aAAA,GAAgB,QAAQ,aAAA,IAAiB,mBAAA;AAE/C,EAAA,OAAO,eAAe,gBAAA,GAA8C;AAClE,IAAA,IAAI;AACF,MAAA,MAAM,KAAA,GAAQ,MAAM,OAAA,EAAQ;AAC5B,MAAA,MAAM,KAAA,CAAM,MAAM,KAAK,CAAA;AACvB,MAAA,OAAO,KAAA;AAAA,IACT,SAAS,KAAA,EAAgB;AAGvB,MAAA,IAAI,CAAC,aAAA,CAAc,KAAK,CAAA,EAAG,MAAM,KAAA;AAEjC,MAAA,MAAM,MAAA,GAAS,MAAM,KAAA,CAAM,IAAA,EAAK;AAChC,MAAA,IAAI,MAAA,KAAW,MAAM,MAAM,KAAA;AAE3B,MAAA,OAAO,MAAA;AAAA,IACT;AAAA,EACF,CAAA;AACF;AAgBO,SAAS,4BAA4B,KAAA,EAAgC;AAC1E,EAAA,MAAM,GAAA,GAAM,qBAAqB,KAAK,CAAA,CAAA;AAEtC,EAAA,OAAO;AAAA,IACL,IAAA,GAAgC;AAC9B,MAAA,IAAI;AACF,QAAA,MAAM,GAAA,GAAM,YAAA,CAAa,OAAA,CAAQ,GAAG,CAAA;AACpC,QAAA,IAAI,GAAA,KAAQ,MAAM,OAAO,IAAA;AACzB,QAAA,OAAO,IAAA,CAAK,MAAM,GAAG,CAAA;AAAA,MACvB,CAAA,CAAA,MAAQ;AACN,QAAA,OAAO,IAAA;AAAA,MACT;AAAA,IACF,CAAA;AAAA,IACA,MAAM,UAAA,EAAoC;AACxC,MAAA,IAAI;AACF,QAAA,YAAA,CAAa,OAAA,CAAQ,GAAA,EAAK,IAAA,CAAK,SAAA,CAAU,UAAU,CAAC,CAAA;AAAA,MACtD,CAAA,CAAA,MAAQ;AAAA,MAGR;AAAA,IACF,CAAA;AAAA,IACA,KAAA,GAAc;AACZ,MAAA,IAAI;AACF,QAAA,YAAA,CAAa,WAAW,GAAG,CAAA;AAAA,MAC7B,CAAA,CAAA,MAAQ;AAAA,MAER;AAAA,IACF;AAAA,GACF;AACF;;;AC7DA,SAAS,gBAAgB,GAAA,EAAmB;AAC1C,EAAA,OAAO,IAAI,QAAA,KAAa,WAAA,IAAe,GAAA,CAAI,QAAA,CAAS,SAAS,YAAY,CAAA;AAC3E;AAEA,SAAS,aAAa,GAAA,EAAmB;AACvC,EAAA,OAAO,GAAA,CAAI,MAAA,KAAY,IAAA,CAA2C,QAAA,CAAS,MAAA;AAC7E;AA0CO,SAAS,0BAA0B,OAAA,EAA0C;AAClF,EAAA,MAAM,KAAA,GAAQ,IAAA;AACd,EAAA,MAAM,EAAE,SAAA,EAAW,WAAA,EAAa,QAAA,EAAS,GAAI,OAAA;AAC7C,EAAA,MAAM,YAAA,GAAe,QAAQ,YAAA,IAAgB,eAAA;AAC7C,EAAA,MAAM,WAAA,GAAc,QAAQ,WAAA,IAAe,YAAA;AAC3C,EAAA,MAAM,YAAA,GAAe,QAAQ,YAAA,KAAiB,IAAA;AAE9C,EAAA,KAAA,CAAM,gBAAA,CAAiB,SAAA,EAAW,CAAC,KAAA,KAAU;AAC3C,IAAA,KAAA,CAAM,SAAA;AAAA,MAAA,CACH,YAAY;AACX,QAAA,MAAM,KAAA,GAAQ,MAAM,MAAA,CAAO,IAAA,CAAK,SAAS,CAAA;AACzC,QAAA,MAAM,KAAA,CAAM,MAAA,CAAO,CAAC,GAAG,QAAQ,CAAC,CAAA;AAChC,QAAA,MAAM,MAAM,WAAA,EAAY;AAAA,MAC1B,CAAA;AAAG,KACL;AAAA,EACF,CAAC,CAAA;AAED,EAAA,KAAA,CAAM,gBAAA,CAAiB,UAAA,EAAY,CAAC,KAAA,KAAU;AAC5C,IAAA,KAAA,CAAM,SAAA;AAAA,MAAA,CACH,YAAY;AACX,QAAA,MAAM,KAAA,GAAQ,MAAM,MAAA,CAAO,IAAA,EAAK;AAChC,QAAA,MAAM,OAAA,CAAQ,GAAA;AAAA,UACZ,KAAA,CAAM,MAAA,CAAO,CAAC,IAAA,KAAS,IAAA,KAAS,SAAS,CAAA,CAAE,GAAA,CAAI,CAAC,IAAA,KAAS,MAAA,CAAO,MAAA,CAAO,IAAI,CAAC;AAAA,SAC9E;AACA,QAAA,MAAM,KAAA,CAAM,QAAQ,KAAA,EAAM;AAAA,MAC5B,CAAA;AAAG,KACL;AAAA,EACF,CAAC,CAAA;AAED,EAAA,KAAA,CAAM,gBAAA,CAAiB,OAAA,EAAS,CAAC,KAAA,KAAU;AACzC,IAAA,MAAM,EAAE,SAAQ,GAAI,KAAA;AAMpB,IAAA,IAAI,OAAA,CAAQ,WAAW,KAAA,EAAO;AAE9B,IAAA,MAAM,GAAA,GAAM,IAAI,GAAA,CAAI,OAAA,CAAQ,GAAG,CAAA;AAO/B,IAAA,IAAI,YAAA,CAAa,GAAG,CAAA,EAAG;AAMvB,IAAA,IAAI,CAAC,WAAA,CAAY,GAAG,CAAA,EAAG;AAKvB,IAAA,IAAI,OAAA,CAAQ,SAAS,UAAA,EAAY;AAC/B,MAAA,KAAA,CAAM,WAAA;AAAA,QAAA,CACH,YAAY;AACX,UAAA,IAAI;AACF,YAAA,OAAO,MAAM,MAAM,OAAO,CAAA;AAAA,UAC5B,CAAA,CAAA,MAAQ;AACN,YAAA,MAAM,KAAA,GAAQ,MAAM,MAAA,CAAO,IAAA,CAAK,SAAS,CAAA;AACzC,YAAA,MAAM,KAAA,GAAQ,MAAM,KAAA,CAAM,KAAA,CAAM,WAAW,CAAA;AAC3C,YAAA,IAAI,KAAA,KAAU,QAAW,OAAO,KAAA;AAChC,YAAA,MAAM,IAAI,KAAA,CAAM,CAAA,sBAAA,EAAyB,WAAW,CAAA,WAAA,EAAc,SAAS,CAAA,CAAE,CAAA;AAAA,UAC/E;AAAA,QACF,CAAA;AAAG,OACL;AACA,MAAA;AAAA,IACF;AAMA,IAAA,KAAA,CAAM,WAAA;AAAA,MAAA,CACH,YAAY;AACX,QAAA,MAAM,KAAA,GAAQ,MAAM,MAAA,CAAO,IAAA,CAAK,SAAS,CAAA;AACzC,QAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,KAAA,CAAM,OAAO,CAAA;AACrC,QAAA,IAAI,GAAA,KAAQ,QAAW,OAAO,GAAA;AAE9B,QAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,OAAO,CAAA;AACpC,QAAA,IAAI,YAAA,IAAgB,QAAA,CAAS,EAAA,IAAM,QAAA,CAAS,SAAS,OAAA,EAAS;AAK5D,UAAA,KAAK,KAAA,CAAM,GAAA,CAAI,OAAA,EAAS,QAAA,CAAS,OAAO,CAAA;AAAA,QAC1C;AACA,QAAA,OAAO,QAAA;AAAA,MACT,CAAA;AAAG,KACL;AAAA,EACF,CAAC,CAAA;AACH","file":"index.js","sourcesContent":["// An OPT-IN cache around the host's own credential resolver.\n//\n// The kit never persists a credential — where a token lives, how long it is\n// kept and what clears it are host security decisions, not a design system's\n// (`SessionShell.tsx`'s own header states this, and it is why\n// `credentialResolver` is a one-shot supplier whose result is handed straight\n// to `client.*.open()` and never stored).\n//\n// That rule is about WHERE the token lives, not about who sequences the\n// fallback. Every integrator hits the same two subtleties on the way to\n// milestone 10, and both are easy to get quietly wrong:\n//\n//   1. Falling back on ANY failure. A 401 or a 500 from a reachable server is\n//      a real failure and must still surface — silently serving a cached\n//      credential past a revocation is the failure mode that matters.\n//   2. Treating the cache as an authority on freshness. It is not, and this\n//      module deliberately cannot be: see `isUnreachable` below.\n//\n// So this helper owns the SEQUENCE and leaves the STORAGE to the host, which\n// keeps the security decision exactly where it was.\n\n/** The shape `KaafilUIKitProvider`'s `credentialResolver` resolves to —\n * structurally identical to `SessionShell.tsx`'s own union, restated here\n * rather than imported because nothing outside `src/core` may reach into the\n * SDK-facing shells (hard rule #1) and this module must stay SDK-free. */\nexport type StoredCredential =\n  | { readonly accessToken: string; readonly refreshToken: string; readonly agencyRef: string }\n  | { readonly shareToken: string };\n\nexport type CredentialResolver = () => Promise<StoredCredential>;\n\n/**\n * The host's own storage. Sync or async — a `localStorage` implementation and\n * an IndexedDB one both satisfy this.\n *\n * Nothing here is written to `window` (hard rule #22); a storage API is the\n * host's to choose, a global token stash is not.\n */\nexport interface CredentialStore {\n  read(): Promise<StoredCredential | null> | StoredCredential | null;\n  write(credential: StoredCredential): Promise<void> | void;\n  clear(): Promise<void> | void;\n}\n\nexport interface CachedCredentialOptions {\n  readonly store: CredentialStore;\n  /**\n   * Whether a thrown value means **the request never completed** — the only\n   * case in which the cached credential may be used.\n   *\n   * The default recognises exactly one thing: the `TypeError` that `fetch`\n   * throws when it cannot reach the network at all. That is deliberately\n   * narrow. A host using axios, ky or their own wrapper throws something else\n   * for the same condition and MUST supply this — a predicate that returns\n   * `true` too eagerly turns a 401 into a silent session extension, which is\n   * the exact bug this helper exists to prevent.\n   */\n  readonly isUnreachable?: (error: unknown) => boolean;\n}\n\n/** `fetch` rejects with a `TypeError` when the request never reached a server.\n * A response with a status — 401, 423, 500 — resolves, and is therefore not\n * this case. */\nfunction isFetchNetworkError(error: unknown): boolean {\n  return error instanceof TypeError;\n}\n\n/**\n * Wrap a credential resolver so a reload with no network still opens the\n * surface, instead of stranding the outbox behind a session that cannot mint.\n *\n * ```ts\n * const resolver = withCachedCredential(\n *   () => fetch('/api/admin-session', { method: 'POST' }).then((r) => r.json()),\n *   { store: localStorageCredentialStore('sharma:desk') },\n * );\n * ```\n *\n * ── WHAT THIS DOES NOT DO, ON PURPOSE ───────────────────────────────────────\n *\n * It stores and restores. It NEVER judges freshness, and it has no opinion on\n * expiry. A cached access token still expires, and offline it cannot be\n * refreshed — a manager who has been offline longer than the token's life will\n * not get in, and that is a real limit to design around, not a bug here. The\n * kit surfaces the outcome through `onSessionExpired` on the provider, which\n * is where a host reacts.\n *\n * That is not only a design preference: \"now\" in this package is\n * `meta.serverTime`, never a local wall clock, and a device that has been\n * offline for hours has no trustworthy `serverTime` to compare against. A\n * helper that checked expiry here would have to read the device clock to do\n * it — the precise thing the architecture forbids, for the precise reason it\n * would be wrong.\n */\nexport function withCachedCredential(\n  resolve: CredentialResolver,\n  options: CachedCredentialOptions,\n): CredentialResolver {\n  const { store } = options;\n  const isUnreachable = options.isUnreachable ?? isFetchNetworkError;\n\n  return async function resolveWithCache(): Promise<StoredCredential> {\n    try {\n      const fresh = await resolve();\n      await store.write(fresh);\n      return fresh;\n    } catch (error: unknown) {\n      // A server that ANSWERED — 401, 403, 500 — is a real failure and must\n      // surface. Only a request that never completed may fall back.\n      if (!isUnreachable(error)) throw error;\n\n      const cached = await store.read();\n      if (cached === null) throw error;\n\n      return cached;\n    }\n  };\n}\n\n/**\n * A `CredentialStore` over `localStorage`, for hosts that have decided that is\n * the right place for their token. Deliberately NOT the default — the kit does\n * not choose where a credential lives.\n *\n * `scope` is an IDENTIFIER (a staff id, a persona name), never the\n * credential's own secret: it becomes a storage key, and a key is readable by\n * anything that can read the store.\n *\n * Every access is wrapped: a private window, cleared site data, or a browser\n * configured to block site storage makes these APIs throw on access rather\n * than return empty, and a credential cache that takes the app down when\n * storage is unavailable is worse than no cache at all.\n */\nexport function localStorageCredentialStore(scope: string): CredentialStore {\n  const key = `kaafil:credential:${scope}`;\n\n  return {\n    read(): StoredCredential | null {\n      try {\n        const raw = localStorage.getItem(key);\n        if (raw === null) return null;\n        return JSON.parse(raw) as StoredCredential;\n      } catch {\n        return null;\n      }\n    },\n    write(credential: StoredCredential): void {\n      try {\n        localStorage.setItem(key, JSON.stringify(credential));\n      } catch {\n        // Storage unavailable or full — the surface still opens online, and\n        // the offline reload is what degrades. Never fail the mint for this.\n      }\n    },\n    clear(): void {\n      try {\n        localStorage.removeItem(key);\n      } catch {\n        // Same reasoning as `write`.\n      }\n    },\n  };\n}\n","// The Kaafil-specific half of a host's service worker.\n//\n// ── WHY THIS IS NOT A DROP-IN SERVICE WORKER ────────────────────────────────\n//\n// Kaafil makes your DATA survive a reload — the write goes to a durable outbox\n// and the read comes back from the snapshot store, both in IndexedDB, both\n// outliving a reload. It does nothing about your APPLICATION: the HTML\n// document, your JS, your CSS. Those come off the network like any other page,\n// so with no service worker a reload while offline gets the browser's offline\n// error page, and the queued writes sit intact behind a document that will not\n// open. The data was never lost; you just cannot reach it.\n//\n// Closing that gap is a service worker, and the CACHING half of it belongs to\n// the host: only your bundler knows your build's hashed filenames, your deploy\n// cadence and your revalidation strategy. Shipping an opinionated one here\n// would fight `vite-plugin-pwa`, `next-pwa` or whatever Workbox config you\n// already have.\n//\n// What this module ships instead is the part the kit genuinely knows: the\n// rules that are true of ANY Kaafil integration regardless of build tool. You\n// supply the precache manifest; this supplies the fetch policy.\n//\n// ── ON CACHING THE UIKIT'S OWN CSS AND JS ───────────────────────────────────\n//\n// There is nothing separate to do. This package is bundled INTO your build, so\n// its CSS and JS are already part of the output your precache manifest covers.\n// There is no Kaafil-specific asset step to add, and no Kaafil CDN URL to\n// allow — if your app shell is cached, so is the UIKit.\n\n/** The subset of the service-worker globals this module touches, declared\n * locally so the package does not have to add `lib: [\"WebWorker\"]` to its\n * tsconfig for one file. */\ninterface ServiceWorkerFetchEvent extends Event {\n  readonly request: Request;\n  respondWith(response: Promise<Response> | Response): void;\n}\n\ninterface ServiceWorkerLifecycleEvent extends Event {\n  waitUntil(promise: Promise<unknown>): void;\n}\n\ninterface ServiceWorkerScope {\n  addEventListener(type: 'install', listener: (event: ServiceWorkerLifecycleEvent) => void): void;\n  addEventListener(type: 'activate', listener: (event: ServiceWorkerLifecycleEvent) => void): void;\n  addEventListener(type: 'fetch', listener: (event: ServiceWorkerFetchEvent) => void): void;\n  skipWaiting(): Promise<void>;\n  readonly clients: { claim(): Promise<void> };\n}\n\nexport interface KaafilOfflineShellOptions {\n  /**\n   * The cache this worker owns. Change it to invalidate — `activate` deletes\n   * every cache whose name differs, so your version string stays the only\n   * revalidation knob and this module never invents a second one.\n   */\n  readonly cacheName: string;\n  /**\n   * The document served for a navigation that cannot reach the network. Must\n   * be one of `precache`.\n   */\n  readonly appShellUrl: string;\n  /**\n   * Your build output, from your own bundler. `vite-plugin-pwa` and Workbox\n   * both inject a manifest; map it to URLs and pass it here.\n   */\n  readonly precache: readonly string[];\n  /**\n   * Whether a URL is a Kaafil API call, which must NEVER be served from cache.\n   * Defaults to any `kaafil.in` host. Override if you proxy the API through\n   * your own origin — and if you do, this is the one option you cannot afford\n   * to get wrong; see the note on `handleFetch`.\n   */\n  readonly isApiRequest?: (url: URL) => boolean;\n  /**\n   * Whether a URL is YOURS to serve. Anything answering `false` is declined\n   * outright, so your own `fetch` listener — or the browser — handles it.\n   *\n   * Defaults to same-origin. That default is the point: before it existed this\n   * handler claimed every non-API GET including cross-origin ones, so a\n   * third-party font, an analytics beacon or a map tile went through a cache\n   * lookup that could never hit. Widen it only if you genuinely want this\n   * worker answering for another origin.\n   */\n  readonly isHostOwned?: (url: URL) => boolean;\n  /**\n   * Whether to cache a successful response fetched on a miss, so the next\n   * offline load can serve it. Defaults to `false`.\n   *\n   * Off by default because `cacheName` is meant to stay the only revalidation\n   * knob, and a cache that grows by itself is harder to reason about than one\n   * whose contents you listed. Turn it on when precaching your build is\n   * impractical — a bundler with content-hashed chunks you cannot enumerate at\n   * worker-build time is the usual case.\n   *\n   * Only same-origin, `ok` responses are stored: an opaque cross-origin\n   * response cannot be read back usefully, and caching a 404 pins it until the\n   * next version bump.\n   */\n  readonly runtimeCache?: boolean;\n}\n\nfunction isKaafilApiHost(url: URL): boolean {\n  return url.hostname === 'kaafil.in' || url.hostname.endsWith('.kaafil.in');\n}\n\nfunction isSameOrigin(url: URL): boolean {\n  return url.origin === (self as unknown as { location: Location }).location.origin;\n}\n\n/**\n * Register the Kaafil offline-shell rules on a service worker you own.\n *\n * ```js title=\"src/sw.ts\"\n * import { installKaafilOfflineShell } from 'kaafil-react-uikit/offline';\n *\n * installKaafilOfflineShell({\n *   cacheName: 'sharma-shell-v4',\n *   appShellUrl: '/index.html',\n *   precache: self.__WB_MANIFEST.map((e) => e.url),\n * });\n * ```\n *\n * Call it from your worker's top level. It adds `install`, `activate` and\n * `fetch` listeners and returns nothing.\n *\n * ── WHAT IT CLAIMS, PRECISELY ──────────────────────────────────────────────\n *\n * This used to say it \"calls `respondWith` only for requests it actually\n * owns\", which read as though it took a few and left the rest. It takes most\n * of them. It DECLINES exactly three kinds of request:\n *\n *   - anything that is not a `GET`\n *   - anything `isApiRequest` answers true for\n *   - anything `isHostOwned` answers false for (default: cross-origin)\n *\n * Every other GET is answered here. That matters for composition: the first\n * `respondWith` wins, so a `fetch` listener you register alongside this one\n * only ever sees the three cases above. If you need a rule of your own for a\n * route this handler claims, exclude it with `isHostOwned` rather than adding\n * a second listener and wondering why it never runs.\n *\n * ── WHAT IS AVAILABLE OFFLINE ──────────────────────────────────────────────\n *\n * By default, exactly what you put in `precache` — nothing else. A miss falls\n * through to the network and, unless `runtimeCache` is on, the response is\n * returned without being stored, so the next offline load misses again.\n * `precache` is therefore not a warm-up optimisation; it is the whole offline\n * surface. Set `runtimeCache: true` if enumerating your build is impractical.\n */\nexport function installKaafilOfflineShell(options: KaafilOfflineShellOptions): void {\n  const scope = self as unknown as ServiceWorkerScope;\n  const { cacheName, appShellUrl, precache } = options;\n  const isApiRequest = options.isApiRequest ?? isKaafilApiHost;\n  const isHostOwned = options.isHostOwned ?? isSameOrigin;\n  const runtimeCache = options.runtimeCache === true;\n\n  scope.addEventListener('install', (event) => {\n    event.waitUntil(\n      (async () => {\n        const cache = await caches.open(cacheName);\n        await cache.addAll([...precache]);\n        await scope.skipWaiting();\n      })(),\n    );\n  });\n\n  scope.addEventListener('activate', (event) => {\n    event.waitUntil(\n      (async () => {\n        const names = await caches.keys();\n        await Promise.all(\n          names.filter((name) => name !== cacheName).map((name) => caches.delete(name)),\n        );\n        await scope.clients.claim();\n      })(),\n    );\n  });\n\n  scope.addEventListener('fetch', (event) => {\n    const { request } = event;\n\n    // NEVER touch a write. The outbox owns retries and their idempotency (no\n    // hook mints its own key, and none accepts one); a service worker that\n    // replays a POST is a second retry engine racing the first, and the\n    // visible symptom is a duplicate expense nobody can explain.\n    if (request.method !== 'GET') return;\n\n    const url = new URL(request.url);\n\n    // NEVER cache a Kaafil API response. Two different failures, both real: a\n    // cached trip read shows a manager stale data they will act on, and a\n    // cached SHARE response keeps serving a traveller's itinerary after the\n    // token was revoked — a disclosure, not a staleness bug. Reads that should\n    // survive offline already do, from the SDK's own snapshot store.\n    if (isApiRequest(url)) return;\n\n    // Declined, not claimed. A cross-origin font, beacon or map tile has\n    // nothing to gain from a cache this worker fills, and claiming it only\n    // makes the host's own listener unreachable — the first `respondWith`\n    // wins.\n    if (!isHostOwned(url)) return;\n\n    // A navigation that cannot reach the network falls back to the cached app\n    // shell. This single rule is what turns \"reload while offline\" from the\n    // browser's error page into a working surface with the outbox intact.\n    if (request.mode === 'navigate') {\n      event.respondWith(\n        (async () => {\n          try {\n            return await fetch(request);\n          } catch {\n            const cache = await caches.open(cacheName);\n            const shell = await cache.match(appShellUrl);\n            if (shell !== undefined) return shell;\n            throw new Error(`kaafil offline shell: ${appShellUrl} is not in ${cacheName}`);\n          }\n        })(),\n      );\n      return;\n    }\n\n    // Everything else is cache-first. A miss goes to the network — and, unless\n    // `runtimeCache` is on, the answer is returned WITHOUT being stored, so the\n    // next offline load misses again. That is why `precache` is the offline\n    // surface rather than a warm-up: this path never grows it.\n    event.respondWith(\n      (async () => {\n        const cache = await caches.open(cacheName);\n        const hit = await cache.match(request);\n        if (hit !== undefined) return hit;\n\n        const response = await fetch(request);\n        if (runtimeCache && response.ok && response.type === 'basic') {\n          // `ok` so a 404 is not pinned until the next version bump, and\n          // `basic` so an opaque cross-origin response — which cannot be read\n          // back usefully — is never stored. `clone()` because a Response body\n          // may only be consumed once.\n          void cache.put(request, response.clone());\n        }\n        return response;\n      })(),\n    );\n  });\n}\n"]}

package/dist/traveller/index.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunk7O3TPYK4_cjs = require('../chunk-7O3TPYK4.cjs');
-require('../chunk-LBTAK5JA.cjs');
-require('../chunk-4R7QBTNL.cjs');
-var chunkTDFM563X_cjs = require('../chunk-TDFM563X.cjs');
-var chunkASFUY3IE_cjs = require('../chunk-ASFUY3IE.cjs');
+var chunkE6SI2S3L_cjs = require('../chunk-E6SI2S3L.cjs');
+require('../chunk-PHVQIIOI.cjs');
+require('../chunk-LYCN2BOH.cjs');
+var chunkAJEZMD64_cjs = require('../chunk-AJEZMD64.cjs');
+var chunkP5HF55MO_cjs = require('../chunk-P5HF55MO.cjs');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
@@ -102,7 +102,7 @@ function HouseholdSheet({
   label,
   travellers
 }) {
-  const { t } = chunkASFUY3IE_cjs.useKaafilChrome();
+  const { t } = chunkP5HF55MO_cjs.useKaafilChrome();
   react.useEffect(() => {
     if (!open) {
       return;
@@ -179,11 +179,11 @@ var COPY_KEY = {
   "not-found": "chrome.shareView.ended.notFound"
 };
 function ShareEndedScreen({ reason }) {
-  const { t } = chunkASFUY3IE_cjs.useKaafilChrome();
+  const { t } = chunkP5HF55MO_cjs.useKaafilChrome();
   return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "kf-share-view__ended", role: "alert", "aria-live": "assertive", children: /* @__PURE__ */ jsxRuntime.jsx("p", { className: "kf-share-view__ended-message", children: t(COPY_KEY[reason]) }) });
 }
 function ShareSkeleton() {
-  const { t } = chunkASFUY3IE_cjs.useKaafilChrome();
+  const { t } = chunkP5HF55MO_cjs.useKaafilChrome();
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "kf-share-view__skeleton", role: "status", "aria-live": "polite", "aria-busy": "true", children: [
     /* @__PURE__ */ jsxRuntime.jsx("span", { className: "kf-visually-hidden", children: t("chrome.shareView.loading") }),
     /* @__PURE__ */ jsxRuntime.jsx("div", { className: "kf-share-view__skeleton-line kf-share-view__skeleton-line--eyebrow kf-shimmer" }),
@@ -297,7 +297,7 @@ function initialsOf(name) {
   return `${first}${last}`.toUpperCase();
 }
 function ContactActions({ row }) {
-  const { t } = chunkASFUY3IE_cjs.useKaafilChrome();
+  const { t } = chunkP5HF55MO_cjs.useKaafilChrome();
   if (row.phoneHref === null && row.whatsappHref === null) {
     return null;
   }
@@ -347,7 +347,7 @@ function ContactCard({
   ] });
 }
 function AgencyContactSection({ data }) {
-  const { t } = chunkASFUY3IE_cjs.useKaafilChrome();
+  const { t } = chunkP5HF55MO_cjs.useKaafilChrome();
   return /* @__PURE__ */ jsxRuntime.jsxs("section", { "aria-label": t("chrome.shareView.agency.eyebrow"), children: [
     /* @__PURE__ */ jsxRuntime.jsx("div", { className: "kf-share-view__eyebrow-row", children: /* @__PURE__ */ jsxRuntime.jsx("span", { className: "kf-eyebrow", children: t("chrome.shareView.agency.eyebrow") }) }),
     /* @__PURE__ */ jsxRuntime.jsx(ContactCard, { row: data, roleLabel: t("chrome.shareView.agency.roleLabel") })
@@ -364,7 +364,7 @@ function BrandHeaderSection({
   agencyContact,
   partyKind
 }) {
-  const { t } = chunkASFUY3IE_cjs.useKaafilChrome();
+  const { t } = chunkP5HF55MO_cjs.useKaafilChrome();
   const initial = agencyContact.name.trim().slice(0, 1).toUpperCase();
   const kindLabel = partyKind !== null ? t(PARTY_KIND_KEY[partyKind]) : null;
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "kf-share-view__brand-header", children: [
@@ -418,7 +418,7 @@ function formatSize(sizeBytes) {
   return `${(kb / 1024).toFixed(1)} MB`;
 }
 function DocumentsSection({ data, timezone }) {
-  const { t } = chunkASFUY3IE_cjs.useKaafilChrome();
+  const { t } = chunkP5HF55MO_cjs.useKaafilChrome();
   const files = data.files ?? [];
   if (data.vouchers.length === 0 && files.length === 0) {
     return null;
@@ -471,7 +471,7 @@ function SelectFieldEditor({
   required,
   onChange
 }) {
-  const { t } = chunkASFUY3IE_cjs.useKaafilChrome();
+  const { t } = chunkP5HF55MO_cjs.useKaafilChrome();
   const [open, setOpen] = react.useState(false);
   const rootRef = react.useRef(null);
   const selected = options.find((option) => option.value === value);
@@ -548,7 +548,7 @@ var fallback = {
   editor: ({ field, t }) => /* @__PURE__ */ jsxRuntime.jsx("p", { className: "kf-share-view__form-unsupported", children: t("chrome.shareView.form.unsupported").replace("{label}", field.label) }),
   preview: PlainPreview
 };
-var fieldRegistry = chunkASFUY3IE_cjs.createRegistry({ fallback });
+var fieldRegistry = chunkP5HF55MO_cjs.createRegistry({ fallback });
 fieldRegistry.register("HEADING", {
   editor: ({ field }) => /* @__PURE__ */ jsxRuntime.jsx("h3", { className: "kf-share-view__form-heading", children: field.label }),
   preview: ({ field }) => /* @__PURE__ */ jsxRuntime.jsx("h3", { className: "kf-share-view__form-heading", children: field.label })
@@ -974,7 +974,7 @@ function FormFillScreen({
   writeStatus,
   travellerRef
 }) {
-  const { t } = chunkASFUY3IE_cjs.useKaafilChrome();
+  const { t } = chunkP5HF55MO_cjs.useKaafilChrome();
   const [clientToken] = react.useState(() => crypto.randomUUID());
   const [answers, setAnswers] = react.useState(() => initialAnswers(form.fields));
   const readOnly = form.responseStatus === "SUBMITTED";
@@ -1073,15 +1073,15 @@ function isPendingRequired(form) {
   return form.required && form.fillState === "ok" && form.responseStatus === null;
 }
 function FormsSection({ token, travellerRef }) {
-  const engine = react.useContext(chunkASFUY3IE_cjs.OfflineEngineContext);
+  const engine = react.useContext(chunkP5HF55MO_cjs.OfflineEngineContext);
   if (engine === null) {
     return null;
   }
   return /* @__PURE__ */ jsxRuntime.jsx(ReadyFormsSection, { token, travellerRef });
 }
 function ReadyFormsSection({ token, travellerRef }) {
-  const { t } = chunkASFUY3IE_cjs.useKaafilChrome();
-  const { status, forms, renderForm, save, submit, writeStatus, refresh } = chunk7O3TPYK4_cjs.useShareForms(token);
+  const { t } = chunkP5HF55MO_cjs.useKaafilChrome();
+  const { status, forms, renderForm, save, submit, writeStatus, refresh } = chunkE6SI2S3L_cjs.useShareForms(token);
   const [openFormId, setOpenFormId] = react.useState(null);
   const [openForm, setOpenForm] = react.useState(null);
   const autoOpenedRef = react.useRef(false);
@@ -1197,7 +1197,7 @@ function HeroSection({
   travellers,
   onOpenHousehold
 }) {
-  const { t } = chunkASFUY3IE_cjs.useKaafilChrome();
+  const { t } = chunkP5HF55MO_cjs.useKaafilChrome();
   return /* @__PURE__ */ jsxRuntime.jsxs("section", { className: "kf-share-view__hero", "aria-label": t("chrome.shareView.trip.ariaLabel"), children: [
     /* @__PURE__ */ jsxRuntime.jsx("p", { className: "kf-share-view__hero-code kf-eyebrow", children: tripName }),
     /* @__PURE__ */ jsxRuntime.jsx(
@@ -1253,7 +1253,7 @@ function HeroSection({
   ] });
 }
 function HouseholdBanner({ label, names }) {
-  const { t } = chunkASFUY3IE_cjs.useKaafilChrome();
+  const { t } = chunkP5HF55MO_cjs.useKaafilChrome();
   if (names.length === 0 && label === null) {
     return null;
   }
@@ -1280,7 +1280,7 @@ function ItineraryDayStrip({
   selectedIndex,
   onSelectIndex
 }) {
-  const { t } = chunkASFUY3IE_cjs.useKaafilChrome();
+  const { t } = chunkP5HF55MO_cjs.useKaafilChrome();
   const todayIndex = itinerary.days.findIndex((day) => day.isToday);
   const selectedDay = itinerary.days[selectedIndex] ?? itinerary.days[0];
   if (itinerary.days.length === 0 || selectedDay === void 0) {
@@ -1342,7 +1342,7 @@ function ItineraryDayStrip({
   ] });
 }
 function ManagerContactSection({ data }) {
-  const { t } = chunkASFUY3IE_cjs.useKaafilChrome();
+  const { t } = chunkP5HF55MO_cjs.useKaafilChrome();
   return /* @__PURE__ */ jsxRuntime.jsxs("section", { "aria-label": t("chrome.shareView.manager.eyebrow"), children: [
     /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "kf-share-view__eyebrow-row", children: [
       /* @__PURE__ */ jsxRuntime.jsx("span", { className: "kf-eyebrow", children: t("chrome.shareView.manager.eyebrow") }),
@@ -1372,7 +1372,7 @@ function formatMinor(minor, currency) {
   return new Intl.NumberFormat(void 0, { style: "currency", currency }).format(minor / 100);
 }
 function MoneySection({ data }) {
-  const { t } = chunkASFUY3IE_cjs.useKaafilChrome();
+  const { t } = chunkP5HF55MO_cjs.useKaafilChrome();
   return /* @__PURE__ */ jsxRuntime.jsxs("section", { "aria-label": t("chrome.shareView.money.eyebrow"), children: [
     /* @__PURE__ */ jsxRuntime.jsx("div", { className: "kf-share-view__eyebrow-row", children: /* @__PURE__ */ jsxRuntime.jsx("span", { className: "kf-eyebrow", children: t("chrome.shareView.money.eyebrow") }) }),
     /* @__PURE__ */ jsxRuntime.jsxs("dl", { className: "kf-share-view__card kf-share-view__money", children: [
@@ -1391,7 +1391,7 @@ function MoneySection({ data }) {
     ] })
   ] });
 }
-var ITEM_TYPE_ICON = chunkASFUY3IE_cjs.createRegistry({
+var ITEM_TYPE_ICON = chunkP5HF55MO_cjs.createRegistry({
   fallback: () => /* @__PURE__ */ jsxRuntime.jsx(CompassIcon, {})
 });
 ITEM_TYPE_ICON.register("FLIGHT", () => /* @__PURE__ */ jsxRuntime.jsx(PlaneIcon, {}));
@@ -1430,7 +1430,7 @@ function pickNextItem(itinerary) {
   return void 0;
 }
 function NextUpBanner({ itinerary, timezone }) {
-  const { t } = chunkASFUY3IE_cjs.useKaafilChrome();
+  const { t } = chunkP5HF55MO_cjs.useKaafilChrome();
   const item = pickNextItem(itinerary);
   if (item === void 0) {
     return null;
@@ -1466,7 +1466,7 @@ var STATE_LABEL_KEY = {
 function dayLabel(t, n) {
   return t("chrome.shareView.dayLabel").replace("{n}", String(n));
 }
-var ROW_ICON = chunkASFUY3IE_cjs.createRegistry({ fallback: () => /* @__PURE__ */ jsxRuntime.jsx(CompassIcon, {}) });
+var ROW_ICON = chunkP5HF55MO_cjs.createRegistry({ fallback: () => /* @__PURE__ */ jsxRuntime.jsx(CompassIcon, {}) });
 ROW_ICON.register("transport", () => /* @__PURE__ */ jsxRuntime.jsx(CarIcon, {}));
 ROW_ICON.register("stay", () => /* @__PURE__ */ jsxRuntime.jsx(HouseIcon, {}));
 ROW_ICON.register("activity", () => /* @__PURE__ */ jsxRuntime.jsx(CompassIcon, {}));
@@ -1553,7 +1553,7 @@ function StayAndTransportSection({
   selectedDayIndex,
   serverTime
 }) {
-  const { t } = chunkASFUY3IE_cjs.useKaafilChrome();
+  const { t } = chunkP5HF55MO_cjs.useKaafilChrome();
   const allDayRows = [
     ...mergeDayBookings(
       transport,
@@ -1642,7 +1642,7 @@ function StayAndTransportSection({
   ] });
 }
 function TodayPlanSection({ itinerary, timezone }) {
-  const { t } = chunkASFUY3IE_cjs.useKaafilChrome();
+  const { t } = chunkP5HF55MO_cjs.useKaafilChrome();
   const today = itinerary.days.find((day) => day.isToday);
   if (today === void 0 || today.items.length === 0) {
     return null;
@@ -1669,7 +1669,7 @@ function isVisible(key, overrides) {
   return overrides?.[key] !== false;
 }
 function KaafilShareView(props) {
-  const session = chunkASFUY3IE_cjs.useSession();
+  const session = chunkP5HF55MO_cjs.useSession();
   if (session.status !== "authenticated") {
     return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "kf-share-view", "data-kf-family": "traveller", children: /* @__PURE__ */ jsxRuntime.jsx(ShareSkeleton, {}) });
   }
@@ -1684,8 +1684,8 @@ function ReadyKaafilShareView({
   renderSection,
   style
 }) {
-  const { t } = chunkASFUY3IE_cjs.useKaafilChrome();
-  const snapshot = chunk7O3TPYK4_cjs.useShareSnapshot(token, { travellerRef });
+  const { t } = chunkP5HF55MO_cjs.useKaafilChrome();
+  const snapshot = chunkE6SI2S3L_cjs.useShareSnapshot(token, { travellerRef });
   const [householdSheetOpen, setHouseholdSheetOpen] = react.useState(false);
   const [chosenDayIndex, setChosenDayIndex] = react.useState(-1);
   const itinerary = snapshot.sections.get("itinerary");
@@ -1705,7 +1705,7 @@ function ReadyKaafilShareView({
     () => snapshot.trip !== void 0 ? deriveTripStatus(snapshot.trip, itinerary, snapshot.serverTime, t) : void 0,
     [snapshot.trip, itinerary, snapshot.serverTime, t]
   );
-  const rootStyle = chunkASFUY3IE_cjs.tokenStyle(style);
+  const rootStyle = chunkP5HF55MO_cjs.tokenStyle(style);
   if (snapshot.status === "loading") {
     return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "kf-share-view", "data-kf-family": "traveller", style: rootStyle, children: /* @__PURE__ */ jsxRuntime.jsx(ShareSkeleton, {}) });
   }
@@ -1726,7 +1726,7 @@ function ReadyKaafilShareView({
   const selectedDayIndex = chosenDayIndex !== -1 ? chosenDayIndex : todayDayIndex !== -1 ? todayDayIndex : 0;
   const showStayAndTransport = accommodation !== void 0 || transport !== void 0 || activities !== void 0 || rooming !== void 0 || seating !== void 0 || pickup !== void 0;
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "kf-share-view", "data-kf-family": "traveller", style: rootStyle, children: [
-    /* @__PURE__ */ jsxRuntime.jsxs(chunkASFUY3IE_cjs.BrandShell, { headStrategy, appName: tripName, children: [
+    /* @__PURE__ */ jsxRuntime.jsxs(chunkP5HF55MO_cjs.BrandShell, { headStrategy, appName: tripName, children: [
       agencyContact !== void 0 ? /* @__PURE__ */ jsxRuntime.jsx(
         BrandHeaderSection,
         {
@@ -1794,11 +1794,11 @@ function ReadyKaafilShareView({
 
 Object.defineProperty(exports, "BootErrorScreen", {
   enumerable: true,
-  get: function () { return chunkTDFM563X_cjs.BootErrorScreen; }
+  get: function () { return chunkAJEZMD64_cjs.BootErrorScreen; }
 });
 Object.defineProperty(exports, "OfflineFallbackScreen", {
   enumerable: true,
-  get: function () { return chunkTDFM563X_cjs.OfflineFallbackScreen; }
+  get: function () { return chunkAJEZMD64_cjs.OfflineFallbackScreen; }
 });
 exports.KaafilShareView = KaafilShareView;
 //# sourceMappingURL=index.cjs.map

package/dist/traveller/index.js

@@ -1,8 +1,8 @@
-import { useShareSnapshot, useShareForms } from '../chunk-DYOAKTGJ.js';
-import '../chunk-Q4B25EZO.js';
-import '../chunk-GKR52SVU.js';
-export { BootErrorScreen, OfflineFallbackScreen } from '../chunk-YHGAFRN6.js';
-import { createRegistry, useKaafilChrome, useSession, tokenStyle, BrandShell, OfflineEngineContext } from '../chunk-ZURCZQQ7.js';
+import { useShareSnapshot, useShareForms } from '../chunk-UMLJEBQV.js';
+import '../chunk-2HGOHUFU.js';
+import '../chunk-VAUGZOY6.js';
+export { BootErrorScreen, OfflineFallbackScreen } from '../chunk-IDKRXLMY.js';
+import { createRegistry, useKaafilChrome, useSession, tokenStyle, BrandShell, OfflineEngineContext } from '../chunk-WMBFBZ7Q.js';
 import { useState, useRef, useEffect, useMemo, useContext } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kaafil-react-uikit",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "publishConfig": {
     "access": "public",
     "tag": "latest",
@@ -53,6 +53,11 @@
       "types": "./dist/testing/index.d.ts",
       "import": "./dist/testing/index.js",
       "require": "./dist/testing/index.cjs"
+    },
+    "./offline": {
+      "types": "./dist/offline/index.d.ts",
+      "import": "./dist/offline/index.js",
+      "require": "./dist/offline/index.cjs"
     }
   },
   "peerDependencies": {