| 1 | /** |
| 2 | * Browser-side durable session helpers for Impeccable live mode. |
| 3 | * |
| 4 | * Kept separate from live-browser.js so recovery state can be tested without |
| 5 | * booting the full overlay UI. Served before live-browser.js and attached to |
| 6 | * window.__IMPECCABLE_LIVE_SESSION__. |
| 7 | */ |
| 8 | (function (root) { |
| 9 | 'use strict'; |
| 10 | |
| 11 | function createLiveBrowserSessionState({ prefix, storage, idFactory }) { |
| 12 | if (!prefix) throw new Error('prefix required'); |
| 13 | const store = storage || root.localStorage; |
| 14 | const makeId = idFactory || function () { return Math.random().toString(16).slice(2, 10); }; |
| 15 | const sessionKey = prefix + '-session'; |
| 16 | const handledKey = sessionKey + '-handled'; |
| 17 | const scrollKey = sessionKey + '-scroll'; |
| 18 | let checkpointRevision = 0; |
| 19 | const owner = makeId(); |
| 20 | |
| 21 | function safeRead(key) { |
| 22 | try { return store.getItem(key); } catch { return null; } |
| 23 | } |
| 24 | |
| 25 | function safeWrite(key, value) { |
| 26 | try { store.setItem(key, value); } catch { /* quota exceeded or private mode */ } |
| 27 | } |
| 28 | |
| 29 | function safeRemove(key) { |
| 30 | try { store.removeItem(key); } catch { /* unavailable storage */ } |
| 31 | } |
| 32 | |
| 33 | function loadSession() { |
| 34 | try { |
| 35 | const raw = safeRead(sessionKey); |
| 36 | if (!raw) return null; |
| 37 | const parsed = JSON.parse(raw); |
| 38 | if (Number.isInteger(parsed.checkpointRevision)) { |
| 39 | checkpointRevision = Math.max(checkpointRevision, parsed.checkpointRevision); |
| 40 | } |
| 41 | return parsed; |
| 42 | } catch { return null; } |
| 43 | } |
| 44 | |
| 45 | function saveSession(session) { |
| 46 | if (!session || !session.id) return; |
| 47 | const payload = { |
| 48 | ...session, |
| 49 | checkpointRevision, |
| 50 | }; |
| 51 | safeWrite(sessionKey, JSON.stringify(payload)); |
| 52 | } |
| 53 | |
| 54 | function clearSession() { |
| 55 | safeRemove(sessionKey); |
| 56 | } |
| 57 | |
| 58 | function nextCheckpointRevision() { |
| 59 | checkpointRevision += 1; |
| 60 | const existing = loadSession(); |
| 61 | if (existing?.id) saveSession(existing); |
| 62 | return checkpointRevision; |
| 63 | } |
| 64 | |
| 65 | function seedCheckpointRevision(value) { |
| 66 | if (Number.isInteger(value)) checkpointRevision = Math.max(checkpointRevision, value); |
| 67 | return checkpointRevision; |
| 68 | } |
| 69 | |
| 70 | function currentCheckpointRevision() { |
| 71 | return checkpointRevision; |
| 72 | } |
| 73 | |
| 74 | function markHandled(id) { |
| 75 | if (!id) return; |
| 76 | safeWrite(handledKey, id); |
| 77 | } |
| 78 | |
| 79 | function isHandled(id) { |
| 80 | return !!id && safeRead(handledKey) === id; |
| 81 | } |
| 82 | |
| 83 | function clearHandled() { |
| 84 | safeRemove(handledKey); |
| 85 | } |
| 86 | |
| 87 | function writeScrollY(y) { |
| 88 | safeWrite(scrollKey, String(y)); |
| 89 | } |
| 90 | |
| 91 | function readScrollY() { |
| 92 | const raw = safeRead(scrollKey); |
| 93 | if (raw == null) return null; |
| 94 | const n = parseFloat(raw); |
| 95 | return isFinite(n) ? n : null; |
| 96 | } |
| 97 | |
| 98 | function clearScrollY() { |
| 99 | safeRemove(scrollKey); |
| 100 | } |
| 101 | |
| 102 | return { |
| 103 | owner, |
| 104 | sessionKey, |
| 105 | handledKey, |
| 106 | scrollKey, |
| 107 | saveSession, |
| 108 | loadSession, |
| 109 | clearSession, |
| 110 | nextCheckpointRevision, |
| 111 | seedCheckpointRevision, |
| 112 | currentCheckpointRevision, |
| 113 | markHandled, |
| 114 | isHandled, |
| 115 | clearHandled, |
| 116 | writeScrollY, |
| 117 | readScrollY, |
| 118 | clearScrollY, |
| 119 | }; |
| 120 | } |
| 121 | |
| 122 | root.__IMPECCABLE_LIVE_SESSION__ = { createLiveBrowserSessionState }; |
| 123 | })(typeof window !== 'undefined' ? window : globalThis); |
| 124 |