gemi 0.136.0 → 0.138.0

package/dist/{chunk-qpwb3gnh.js → chunk-zvzvgrrn.js}

@@ -1,5 +1,5 @@
 // @bun
 class m{name;cron;withoutOverlapping=!1;onOneServer=!1;shouldRun(){return!0}callback(f){}onTick(){}onComplete(){}static exp(f){return f}}
-export{m as pd};
+export{m as Bd};
 
-//# debugId=ADF306CF090B8A8064756E2164756E21
+//# debugId=CA191E394274AEC064756E2164756E21

package/dist/{chunk-qpwb3gnh.js.map → chunk-zvzvgrrn.js.map}

@@ -5,6 +5,6 @@
     "// A cron expression accepted by `Bun.cron`: a 5-field expression\n// (`minute hour day-of-month month day-of-week`, interpreted in UTC) or one of\n// the nicknames below. The `string & {}` member keeps arbitrary expressions\n// assignable while still surfacing the nicknames in editor autocomplete.\nexport type CronExpression =\n  | \"@yearly\"\n  | \"@annually\"\n  | \"@monthly\"\n  | \"@weekly\"\n  | \"@daily\"\n  | \"@midnight\"\n  | \"@hourly\"\n  | (string & {});\n\nimport type { HeldLock } from \"../lock/LockManager\";\n\nexport type WithoutOverlapping =\n  | boolean\n  | {\n      /**\n       * The lock's lease, in milliseconds: how long it outlives an instance\n       * that died holding it. Renewed every third of this while the tick\n       * runs, so it does not limit how long a tick may take. Default five\n       * minutes.\n       */\n      expiresAfter?: number;\n    };\n\nexport class CronJob {\n  name: string;\n  cron: CronExpression;\n\n  /**\n   * Skips a tick while an earlier tick of this job is still running, on this\n   * instance or any other sharing the queue's storage. With the database\n   * queue driver that is a lock row in `gemi_locks`; with the memory driver\n   * it only covers this process.\n   *\n   * The lock is held across `onTick`, `callback` and `onComplete`, and handed\n   * to `callback` as its argument. If its lease is lost while the tick runs\n   * (the instance stalled past `expiresAfter`), `lock.lost` aborts and the\n   * scheduler logs it. Writes that must not land after that go through\n   * `lock.fence(...)`.\n   *\n   * It does not stop a second instance from running the same tick after the\n   * first one finished; `onOneServer` does.\n   */\n  withoutOverlapping: WithoutOverlapping = false;\n\n  /**\n   * Runs each tick on one instance only, across every instance sharing the\n   * queue's storage: the first to claim the tick's minute runs it, the others\n   * skip it. Assumes the instances' clocks agree to well within a minute.\n   */\n  onOneServer = false;\n\n  /**\n   * Decides whether this tick happens at all. Evaluated once per tick, before\n   * anything else; returning `false` skips `onTick`, `callback` and\n   * `onComplete` alike.\n   *\n   * ### Why this is a member and not a line the job writes for itself\n   *\n   * A job that reports outward — mails a digest, opens a Sentry issue, pings a\n   * channel — must not fire from a laptop, and the guard for that has to cover\n   * the whole tick. There was nowhere to write it. gemi calls `onTick` and\n   * `onComplete` *outside* `callback`, so a guard placed in a lifecycle hook\n   * only stops the hook it lives in: an early `return` at the top of `callback`\n   * leaves the job still announcing that it started and still announcing that\n   * it finished, which for an outward-reporting job is most of the damage.\n   *\n   * The only construct that covered every hook was an abstract base class that\n   * shadowed `callback` with the guard and renamed the real body to `run()` —\n   * and that costs the app the framework's own vocabulary. A job then reads\n   * `async run()` while every page of the documentation reads `async\n   * callback()`, so the next person to follow the docs writes a `callback` the\n   * base class never calls: no error, no output, a job that silently does\n   * nothing. Forgetting *this* member fails the other way round — the job runs,\n   * which is what it did before anyone asked for a gate.\n   *\n   * ### What it gates\n   *\n   * Work, not registration. A job whose gate returns `false` is still\n   * scheduled, still holds its `Bun.cron` handle, and still appears in\n   * `app(Scheduler).jobs` — \"is it scheduled\" and \"will it do anything\" are\n   * different questions and the second one is answered per tick. That is also\n   * why this is a method: a field would be read once, when the scheduler\n   * constructs the job at boot, and would freeze whatever it saw then.\n   *\n   * A gate that throws is logged and treated as `false`. Cron work recurs, so\n   * a skipped tick is recovered by the next one, while an email sent from the\n   * wrong machine is not recovered at all.\n   *\n   * ### Composing with a base class\n   *\n   * Nothing here calls `super` for you. A subclass that overrides `shouldRun`\n   * for its own reason silently replaces whatever its base was gating on, so\n   * narrow rather than redefine:\n   *\n   * ```typescript\n   * async shouldRun() {\n   *   return (await super.shouldRun()) && this.hasSubscribers();\n   * }\n   * ```\n   *\n   * A shared base should annotate its return type as written here rather than\n   * let it be inferred: a base returning a plain `boolean` narrows the\n   * signature its subclasses inherit, and the `await super` above then does not\n   * typecheck against it.\n   */\n  shouldRun(): Promise<boolean> | boolean {\n    return true;\n  }\n\n  /**\n   * The tick's work. `lock` is the `withoutOverlapping` lock when the job\n   * declares one.\n   */\n  callback(_lock?: HeldLock): Promise<void> | void {}\n  onTick(): Promise<void> | void {}\n  onComplete(): Promise<void> | void {}\n\n  static exp(expression: CronExpression) {\n    return expression;\n  }\n}\n"
   ],
   "mappings": ";AA4BO,MAAM,CAAQ,CACnB,KACA,KAiBA,mBAAyC,GAOzC,YAAc,GAwDd,SAAS,EAA+B,CACtC,MAAO,GAOT,QAAQ,CAAC,EAAwC,EACjD,MAAM,EAAyB,EAC/B,UAAU,EAAyB,QAE5B,IAAG,CAAC,EAA4B,CACrC,OAAO,EAEX",
-  "debugId": "ADF306CF090B8A8064756E2164756E21",
+  "debugId": "CA191E394274AEC064756E2164756E21",
   "names": []
 }

package/dist/chunks/{RealtimeClient-DsWbFRC7.js → RealtimeClient-B345JtXu.js}

@@ -1,4 +1,4 @@
-import { H as realtime } from "./ThemeProvider-gWqXjGh-.js";
+import { H as realtime } from "./ThemeProvider-BwlMubvu.js";
 import { t as channelKey } from "./channelKey-CIhHpX6x.js";
 //#region services/broadcast/protocol.ts
 /**
@@ -550,4 +550,4 @@ function tabClient() {
 //#endregion
 export { IDLE_CLOSE_MS, MAX_LIMIT_RETRIES, RELEASE_LINGER_MS, RESYNC_COALESCE_MS, RealtimeClient, backoffDelay, tabClient };
 
-//# sourceMappingURL=RealtimeClient-DsWbFRC7.js.map
+//# sourceMappingURL=RealtimeClient-B345JtXu.js.map

package/dist/chunks/{RealtimeClient-DsWbFRC7.js.map → RealtimeClient-B345JtXu.js.map}

@@ -1 +1 @@
-{"version":3,"file":"RealtimeClient-DsWbFRC7.js","names":[],"sources":["../../services/broadcast/protocol.ts","../../client/realtime/RealtimeClient.ts"],"sourcesContent":["/**\n * The `gemi.v1` WebSocket protocol, shared by the server transport\n * (`SocketHub`) and the browser client (`gemi/client`'s connection manager).\n * Types and constants only: this module is imported by the browser bundle, so\n * it must never import a server module.\n *\n * Every frame is a JSON text frame. Binary frames are refused.\n *\n * From the client:\n *\n * - `{op:\"sub\", id, ch, p?}`: subscribe `id` (chosen by the client, unique per\n *   socket) to the channel pattern `ch` with params `p`. The server builds\n *   the topic and authorizes it.\n * - `{op:\"unsub\", id}`\n * - `{op:\"ping\"}`: answered with `pong`. The client sends one every\n *   `heartbeatMs` and reconnects when it hears nothing for twice that.\n *\n * From the server:\n *\n * - `{op:\"hello\", socketId, tag, heartbeatMs}`: the first frame. `socketId`\n *   goes in the `X-Gemi-Socket` header of the client's own requests (for\n *   `Broadcast.toOthers`); it is never shown to anyone else. `tag` is what\n *   an event frame's `x` carries when it skips this socket.\n * - `{op:\"subscribed\", id, t}`: `id` joined topic `t`. Sent only once this\n *   process receives the topic's events, so the resync the client runs on it\n *   cannot miss one.\n * - `{op:\"denied\", id, code}`: `id` was refused, or later revoked.\n * - `{op:\"ev\", t, ev, d?, x?}`: an event on topic `t`. Dropped by the socket\n *   whose `tag` is `x`.\n * - `{op:\"gap\"}`: events may have been lost for this socket; resync all.\n * - `{op:\"pong\"}`\n * - `{op:\"bye\", code, retryAfter}`: the server is going away (a restart).\n *   Reconnect after `retryAfter` ms.\n */\n\n/** The WebSocket subprotocol. */\nexport const BROADCAST_PROTOCOL = \"gemi.v1\";\n\n/** The default endpoint, `defineBroadcastConfig({ path })`. */\nexport const DEFAULT_SOCKET_PATH = \"/__gemi/socket\";\n\nexport { SOCKET_ID_HEADER } from \"./socketHeader\";\n\n/** What a subscription id may look like. */\nexport const SUBSCRIPTION_ID = /^[A-Za-z0-9_-]{1,32}$/;\n\n/**\n * Close codes the server uses. 1012 and 1013 are the standard \"restart\" and\n * \"try again later\"; the 4xxx ones are gemi's own.\n */\nexport const CloseCode = {\n  /** The client went away (tab closed, socket released). */\n  Normal: 1000,\n  /** A frame that was not JSON text, or not a known op. */\n  UnsupportedData: 1003,\n  /** Too many frames, or a frame over the size limit. */\n  PolicyViolation: 1008,\n  /** The server is restarting; `bye` said when to come back. */\n  Restart: 1012,\n  /** The socket fell too far behind; reconnect and resync. */\n  TryAgainLater: 1013,\n  /** The socket's user was signed out or its access revoked. */\n  Revoked: 4001,\n} as const;\n\n/** Why a subscription was refused. */\nexport type DeniedCode =\n  /** No channel with that pattern. Permanent. */\n  | \"unknown_channel\"\n  /** Missing, extra or malformed params. Permanent. */\n  | \"invalid_params\"\n  /** The channel's authorization said no. */\n  | \"denied\"\n  /** Authorization failed (a session store outage, a bug). Retryable. */\n  | \"error\"\n  /** The socket has `maxChannelsPerSocket` subscriptions already. */\n  | \"limit\"\n  /** Too many `sub`/`unsub` frames; retry later. */\n  | \"rate_limited\"\n  /** The subscription was revoked by `Broadcast.revoke`. */\n  | \"revoked\"\n  /** The frame was malformed, or the id is already in use. */\n  | \"invalid\";\n\nexport type ClientFrame =\n  | { op: \"sub\"; id: string; ch: string; p?: Record<string, string | number> }\n  | { op: \"unsub\"; id: string }\n  | { op: \"ping\" };\n\nexport type ServerFrame =\n  | { op: \"hello\"; socketId: string; tag: string; heartbeatMs: number }\n  | { op: \"subscribed\"; id: string; t: string }\n  | { op: \"denied\"; id: string; code: DeniedCode }\n  | { op: \"ev\"; t: string; ev: string; d?: unknown; x?: string }\n  | { op: \"gap\" }\n  | { op: \"pong\" }\n  | { op: \"bye\"; code: number; retryAfter: number };\n\n/**\n * Whether a refusal is final for this socket's session: resubscribing will\n * get the same answer, so the client does not retry it on its own.\n */\nexport function isPermanentDenial(code: DeniedCode): boolean {\n  return code === \"unknown_channel\" || code === \"invalid_params\" || code === \"invalid\";\n}\n","import {\n  BROADCAST_PROTOCOL,\n  CloseCode,\n  DEFAULT_SOCKET_PATH,\n  isPermanentDenial,\n  type ClientFrame,\n  type DeniedCode,\n  type ServerFrame,\n} from \"../../services/broadcast/protocol\";\nimport { channelKey } from \"./channelKey\";\nimport { realtime } from \"./loader\";\n\n/**\n * Where a channel subscription stands, as the hooks report it.\n *\n * - `idle`: the hook is disabled (`enabled: false`).\n * - `connecting`: the socket is opening, or the `sub` awaits its answer.\n * - `open`: subscribed; events arrive.\n * - `denied`: the server refused (or revoked) it; `code` says why.\n * - `closed`: no socket, on the server, before the first effect, or while\n *   waiting to reconnect.\n */\nexport type ChannelStatus = \"idle\" | \"connecting\" | \"open\" | \"denied\" | \"closed\";\n\nexport type ChannelParamValues = Record<string, string | number>;\n\n/** What a hook hands the socket for one channel. */\nexport interface ChannelListener {\n  onEvent?(event: string, data: unknown): void;\n  /** Events may have been missed: refetch what the channel describes. */\n  onResync?(): void;\n  onStatus?(status: ChannelStatus, code: DeniedCode | null): void;\n}\n\n/**\n * What the hooks subscribe through: the tab's `RealtimeClient`, or a\n * `FakeSocket` in tests. Returns the release function.\n */\nexport interface RealtimeSocket {\n  subscribe(pattern: string, params: ChannelParamValues, listener: ChannelListener): () => void;\n}\n\nexport interface RealtimeOptions {\n  /** The socket endpoint, `defineBroadcastConfig({ path })`. Default `/__gemi/socket`. */\n  path?: string;\n  /**\n   * How long a hidden tab keeps its socket, in ms, before disconnecting. On\n   * becoming visible again it reconnects and resyncs. Default 60 000.\n   */\n  hiddenDisconnectMs?: number;\n}\n\ninterface ClientInternals {\n  /** Test seam: the WebSocket class. */\n  WebSocket?: typeof WebSocket;\n  /** Test seam: the full URL, instead of the page's origin + `path`. */\n  url?: string;\n  random?: () => number;\n}\n\n/** The minimum gap between two resyncs of one subscription. */\nexport const RESYNC_COALESCE_MS = 2_000;\n/** How long the socket stays open after its last subscription goes. */\nexport const IDLE_CLOSE_MS = 5_000;\n/**\n * How long a subscription outlives its last listener. A hook that remounts\n * within it (StrictMode's double mount, a route change back, a list that\n * re-renders its rows) picks the same subscription up again: no `unsub`, no\n * new `sub`, nothing counted against the server's rate limit.\n */\nexport const RELEASE_LINGER_MS = 1_500;\n/** The least wait before resending a `sub` denied with `rate_limited`. */\nconst RATE_LIMITED_RETRY_MS = 5_000;\n/**\n * How often a `sub` denied with `limit` is resent on one socket. The socket\n * holds as many channels as the server allows, so only a released one makes\n * room: worth a few tries with backoff, not a retry for as long as the socket\n * lives. Past it the subscription waits for the next connection.\n */\nexport const MAX_LIMIT_RETRIES = 5;\nconst MIN_BACKOFF_MS = 1_000;\nconst MAX_BACKOFF_MS = 30_000;\nconst DEFAULT_HEARTBEAT_MS = 25_000;\nconst DEFAULT_HIDDEN_DISCONNECT_MS = 60_000;\n\ninterface Entry {\n  key: string;\n  id: string;\n  pattern: string;\n  params: ChannelParamValues;\n  listeners: Set<ChannelListener>;\n  status: ChannelStatus;\n  code: DeniedCode | null;\n  /** Refused for good: not resent on a reconnect. */\n  permanent: boolean;\n  topic: string | null;\n  lastResyncAt: number;\n  resyncTimer: ReturnType<typeof setTimeout> | null;\n  /** Set while the entry outlives its last listener; see `RELEASE_LINGER_MS`. */\n  lingerTimer: ReturnType<typeof setTimeout> | null;\n  /** A transient denial's resend, on the same socket. */\n  retryTimer: ReturnType<typeof setTimeout> | null;\n  retries: number;\n}\n\n/**\n * The tab's one WebSocket to the app (`gemi.v1`), multiplexing every channel\n * the mounted hooks subscribe to.\n *\n * Opened by the first subscription and closed a few seconds after the last\n * one goes. Reconnects with full-jitter backoff (1 to 30 s), or after the\n * server's `bye.retryAfter`, at once on `online`; resubscribes everything\n * then. A tab hidden for `hiddenDisconnectMs` disconnects, and reconnects\n * when shown. Every `subscribed` ack and every `gap` resyncs the\n * subscription (coalesced to one per 2 s), because events are volatile: a\n * client that may have missed one refetches over HTTP.\n *\n * Loaded on first use (#891): import this module as a type only, and reach\n * the tab's instance through `./loader`, or it lands in every route's entry\n * chunk.\n */\nexport class RealtimeClient implements RealtimeSocket {\n  private options: Required<RealtimeOptions>;\n  private readonly internals: ClientInternals;\n  private ws: WebSocket | null = null;\n  private entries = new Map<string, Entry>();\n  private byId = new Map<string, Entry>();\n  private topics = new Map<string, Set<string>>();\n  private nextId = 1;\n  private attempt = 0;\n  private tag: string | null = null;\n  private socketIdValue: string | null = null;\n  private heartbeatMs = DEFAULT_HEARTBEAT_MS;\n  private reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n  private idleTimer: ReturnType<typeof setTimeout> | null = null;\n  private hiddenTimer: ReturnType<typeof setTimeout> | null = null;\n  private pingTimer: ReturnType<typeof setInterval> | null = null;\n  private livenessTimer: ReturnType<typeof setTimeout> | null = null;\n  private retryAfter: number | null = null;\n  private revoked = false;\n  private pausedWhileHidden = false;\n  private listening = false;\n\n  constructor(options: RealtimeOptions = {}, internals: ClientInternals = {}) {\n    this.options = withDefaults(options);\n    this.internals = internals;\n  }\n\n  configure(options: RealtimeOptions) {\n    this.options = withDefaults({ ...this.options, ...options });\n  }\n\n  /** The id to send as `X-Gemi-Socket`, while the socket is open. */\n  get socketId(): string | null {\n    return this.socketIdValue;\n  }\n\n  subscribe(pattern: string, params: ChannelParamValues, listener: ChannelListener): () => void {\n    const key = channelKey(pattern, params);\n    let entry = this.entries.get(key);\n    if (!entry) {\n      entry = {\n        key,\n        id: String(this.nextId++),\n        pattern,\n        params: { ...params },\n        listeners: new Set(),\n        status: \"closed\",\n        code: null,\n        permanent: false,\n        topic: null,\n        lastResyncAt: 0,\n        resyncTimer: null,\n        lingerTimer: null,\n        retryTimer: null,\n        retries: 0,\n      };\n      this.entries.set(key, entry);\n      this.byId.set(entry.id, entry);\n      if (this.isOpen()) {\n        this.sendSub(entry);\n      }\n    }\n    if (entry.lingerTimer) {\n      clearTimeout(entry.lingerTimer);\n      entry.lingerTimer = null;\n    }\n    entry.listeners.add(listener);\n    listener.onStatus?.(entry.status, entry.code);\n    this.cancelIdleClose();\n    this.listen();\n    if (!this.ws && !this.reconnectTimer && !this.pausedWhileHidden) {\n      this.connect();\n    }\n\n    let released = false;\n    return () => {\n      if (released) return;\n      released = true;\n      this.release(entry!, listener);\n    };\n  }\n\n  private release(entry: Entry, listener: ChannelListener) {\n    entry.listeners.delete(listener);\n    if (entry.listeners.size > 0 || entry.lingerTimer) return;\n    entry.lingerTimer = setTimeout(() => {\n      entry.lingerTimer = null;\n      if (entry.listeners.size === 0) this.drop(entry);\n    }, RELEASE_LINGER_MS);\n  }\n\n  private drop(entry: Entry) {\n    if (entry.resyncTimer) clearTimeout(entry.resyncTimer);\n    this.clearRetry(entry);\n    this.entries.delete(entry.key);\n    this.byId.delete(entry.id);\n    this.dropTopic(entry);\n    if (this.isOpen() && (entry.status === \"open\" || entry.status === \"connecting\")) {\n      this.send({ op: \"unsub\", id: entry.id });\n    }\n    if (this.entries.size === 0) this.scheduleIdleClose();\n  }\n\n  private isOpen() {\n    return this.ws !== null && this.ws.readyState === 1;\n  }\n\n  private connect() {\n    if (typeof window === \"undefined\") return;\n    if (this.entries.size === 0) return;\n    const Impl = this.internals.WebSocket ?? globalThis.WebSocket;\n    if (!Impl) return;\n    this.clearReconnect();\n    let ws: WebSocket;\n    try {\n    ws = new Impl(this.url(), [BROADCAST_PROTOCOL]);\n    } catch {\n      this.scheduleReconnect();\n      return;\n    }\n    this.ws = ws;\n    for (const entry of this.entries.values()) {\n      if (!entry.permanent) this.setStatus(entry, \"connecting\", null);\n    }\n    ws.onopen = () => {\n      if (this.ws !== ws) return;\n      this.touch();\n      for (const entry of this.entries.values()) {\n        if (entry.permanent) continue;\n        // A new socket starts every transient denial's count over.\n        entry.retries = 0;\n        this.sendSub(entry);\n      }\n    };\n    ws.onmessage = (event: MessageEvent) => {\n      if (this.ws !== ws) return;\n      this.touch();\n      let frame: ServerFrame;\n      try {\n        frame = JSON.parse(String(event.data));\n      } catch {\n        return;\n      }\n      this.handle(frame);\n    };\n    ws.onclose = (event: CloseEvent) => {\n      if (this.ws !== ws) return;\n      this.onClosed(event.code);\n    };\n    ws.onerror = () => {\n      // A `close` follows.\n    };\n  }\n\n  private url(): string {\n    if (this.internals.url) return this.internals.url;\n    const { protocol, host } = window.location;\n    return `${protocol === \"https:\" ? \"wss:\" : \"ws:\"}//${host}${this.options.path}`;\n  }\n\n  private sendSub(entry: Entry) {\n    this.setStatus(entry, \"connecting\", null);\n    const frame: ClientFrame = { op: \"sub\", id: entry.id, ch: entry.pattern };\n    if (Object.keys(entry.params).length > 0) frame.p = entry.params;\n    this.send(frame);\n  }\n\n  private send(frame: ClientFrame) {\n    if (!this.isOpen()) return;\n    try {\n      this.ws!.send(JSON.stringify(frame));\n    } catch {\n      // The close handler takes over.\n    }\n  }\n\n  private handle(frame: ServerFrame) {\n    switch (frame.op) {\n      case \"hello\":\n        this.socketIdValue = frame.socketId;\n        this.tag = frame.tag;\n        this.attempt = 0;\n        this.revoked = false;\n        if (frame.heartbeatMs > 0) {\n          this.heartbeatMs = frame.heartbeatMs;\n        }\n        this.startHeartbeat();\n        return;\n      case \"subscribed\": {\n        const entry = this.byId.get(frame.id);\n        if (!entry) return;\n        this.dropTopic(entry);\n        entry.topic = frame.t;\n        let ids = this.topics.get(frame.t);\n        if (!ids) this.topics.set(frame.t, (ids = new Set()));\n        ids.add(entry.id);\n        this.clearRetry(entry);\n        entry.retries = 0;\n        this.setStatus(entry, \"open\", null);\n        // The window between the view rendering and this ack, or the time\n        // the socket was down, may have carried events this tab missed.\n        this.resync(entry);\n        return;\n      }\n      case \"denied\": {\n        const entry = this.byId.get(frame.id);\n        if (!entry) return;\n        this.dropTopic(entry);\n        entry.permanent = isPermanentDenial(frame.code);\n        this.setStatus(entry, \"denied\", frame.code);\n        this.scheduleRetry(entry, frame.code);\n        return;\n      }\n      case \"ev\": {\n        if (frame.x !== undefined && frame.x === this.tag) return;\n        const ids = this.topics.get(frame.t);\n        if (!ids) return;\n        for (const id of Array.from(ids)) {\n          const entry = this.byId.get(id);\n          if (!entry) continue;\n          for (const listener of Array.from(entry.listeners)) {\n            try {\n              listener.onEvent?.(frame.ev, frame.d);\n            } catch (error) {\n              reportListenerError(error);\n            }\n          }\n        }\n        return;\n      }\n      case \"gap\":\n        for (const entry of this.entries.values()) {\n          if (entry.status === \"open\") this.resync(entry);\n        }\n        return;\n      case \"bye\":\n        this.retryAfter = Math.max(0, Number(frame.retryAfter) || 0);\n        return;\n      case \"pong\":\n        return;\n    }\n  }\n\n  private onClosed(code: number) {\n    this.ws = null;\n    this.socketIdValue = null;\n    this.tag = null;\n    this.stopHeartbeat();\n    this.topics.clear();\n    for (const entry of this.entries.values()) {\n      entry.topic = null;\n      // The reconnect resends it.\n      this.clearRetry(entry);\n      if (!entry.permanent) this.setStatus(entry, \"closed\", null);\n    }\n    if (code === CloseCode.Revoked) this.revoked = true;\n    if (this.entries.size > 0 && !this.pausedWhileHidden) this.scheduleReconnect();\n  }\n\n  private scheduleReconnect() {\n    this.clearReconnect();\n    let delay: number;\n    if (this.retryAfter !== null) {\n      delay = this.retryAfter;\n      this.retryAfter = null;\n    } else if (this.revoked) {\n      // Signed out or access revoked: come back promptly, as whoever we are now.\n      this.revoked = false;\n      delay = Math.floor(this.random() * 500);\n    } else {\n      delay = backoffDelay(this.attempt, this.random());\n    }\n    this.attempt++;\n    this.reconnectTimer = setTimeout(() => {\n      this.reconnectTimer = null;\n      this.connect();\n    }, delay);\n  }\n\n  private clearReconnect() {\n    if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n    this.reconnectTimer = null;\n  }\n\n  private random() {\n    return (this.internals.random ?? Math.random)();\n  }\n\n  private startHeartbeat() {\n    this.stopHeartbeat();\n    this.pingTimer = setInterval(() => this.send({ op: \"ping\" }), this.heartbeatMs);\n    this.touch();\n  }\n\n  private stopHeartbeat() {\n    if (this.pingTimer) clearInterval(this.pingTimer);\n    if (this.livenessTimer) clearTimeout(this.livenessTimer);\n    this.pingTimer = null;\n    this.livenessTimer = null;\n  }\n\n  /** Anything from the server proves the socket alive. */\n  private touch() {\n    if (this.livenessTimer) clearTimeout(this.livenessTimer);\n    const ws = this.ws;\n    this.livenessTimer = setTimeout(() => {\n      if (this.ws !== ws || !ws) return;\n      // Silent for two heartbeats: a dead connection a proxy never closed.\n      try {\n        ws.close();\n      } catch {}\n      this.onClosed(1006);\n    }, this.heartbeatMs * 2);\n  }\n\n  private setStatus(entry: Entry, status: ChannelStatus, code: DeniedCode | null) {\n    if (entry.status === status && entry.code === code) return;\n    entry.status = status;\n    entry.code = code;\n    for (const listener of Array.from(entry.listeners)) {\n      try {\n        listener.onStatus?.(status, code);\n      } catch (error) {\n        reportListenerError(error);\n      }\n    }\n  }\n\n  /** At most one resync per subscription per 2 s; a later one is deferred, not dropped. */\n  private resync(entry: Entry) {\n    if (entry.resyncTimer) return;\n    const now = Date.now();\n    const wait = entry.lastResyncAt + RESYNC_COALESCE_MS - now;\n    const fire = () => {\n      entry.resyncTimer = null;\n      entry.lastResyncAt = Date.now();\n      for (const listener of Array.from(entry.listeners)) {\n        try {\n          listener.onResync?.();\n        } catch (error) {\n          reportListenerError(error);\n        }\n      }\n    };\n    if (entry.lastResyncAt === 0 || wait <= 0) fire();\n    else entry.resyncTimer = setTimeout(fire, wait);\n  }\n\n  /**\n   * A transient denial (`rate_limited`, `error`, `limit`) is retried on the\n   * same socket, with backoff: a healthy socket may never reconnect. `denied`\n   * and `revoked` are the channel's answer for this session, so they wait for\n   * the next connection (a sign-in reconnects), and a permanent one is never\n   * resent. `limit` gives up after `MAX_LIMIT_RETRIES` on one socket.\n   */\n  private scheduleRetry(entry: Entry, code: DeniedCode) {\n    if (code !== \"rate_limited\" && code !== \"error\" && code !== \"limit\") return;\n    if (code === \"limit\" && entry.retries >= MAX_LIMIT_RETRIES) return;\n    this.clearRetry(entry);\n    const floor = code === \"rate_limited\" ? RATE_LIMITED_RETRY_MS : MIN_BACKOFF_MS;\n    const delay = Math.max(floor, backoffDelay(entry.retries, this.random()));\n    entry.retries++;\n    entry.retryTimer = setTimeout(() => {\n      entry.retryTimer = null;\n      if (this.entries.get(entry.key) !== entry || entry.status !== \"denied\") return;\n      if (this.isOpen()) this.sendSub(entry);\n    }, delay);\n  }\n\n  private clearRetry(entry: Entry) {\n    if (entry.retryTimer) clearTimeout(entry.retryTimer);\n    entry.retryTimer = null;\n  }\n\n  private dropTopic(entry: Entry) {\n    if (!entry.topic) return;\n    const ids = this.topics.get(entry.topic);\n    ids?.delete(entry.id);\n    if (ids && ids.size === 0) this.topics.delete(entry.topic);\n    entry.topic = null;\n  }\n\n  private scheduleIdleClose() {\n    this.cancelIdleClose();\n    this.idleTimer = setTimeout(() => {\n      this.idleTimer = null;\n      if (this.entries.size > 0) return;\n      this.clearReconnect();\n      this.close();\n    }, IDLE_CLOSE_MS);\n  }\n\n  private cancelIdleClose() {\n    if (this.idleTimer) clearTimeout(this.idleTimer);\n    this.idleTimer = null;\n  }\n\n  /** Closes the socket without reconnecting. */\n  private close() {\n    const ws = this.ws;\n    if (!ws) return;\n    this.ws = null;\n    try {\n      ws.close(CloseCode.Normal);\n    } catch {}\n    this.onClosed(CloseCode.Normal);\n  }\n\n  private listen() {\n    if (this.listening || typeof window === \"undefined\") return;\n    this.listening = true;\n    window.addEventListener(\"online\", this.onOnline);\n    if (typeof document !== \"undefined\") {\n      document.addEventListener(\"visibilitychange\", this.onVisibility);\n    }\n  }\n\n  private onOnline = () => {\n    if (this.entries.size === 0 || this.ws || this.pausedWhileHidden) return;\n    this.attempt = 0;\n    this.connect();\n  };\n\n  private onVisibility = () => {\n    if (document.visibilityState === \"hidden\") {\n      if (this.hiddenTimer) return;\n      this.hiddenTimer = setTimeout(() => {\n        this.hiddenTimer = null;\n        if (document.visibilityState !== \"hidden\") return;\n        this.pausedWhileHidden = true;\n        this.clearReconnect();\n        this.close();\n      }, this.options.hiddenDisconnectMs);\n      return;\n    }\n    if (this.hiddenTimer) clearTimeout(this.hiddenTimer);\n    this.hiddenTimer = null;\n    if (this.pausedWhileHidden) {\n      this.pausedWhileHidden = false;\n      this.attempt = 0;\n      // The `subscribed` acks resync every subscription.\n      this.connect();\n    }\n  };\n\n  /**\n   * Drops the socket and opens a new one at once, when anything is\n   * subscribed. A socket keeps the session it was opened with (the upgrade's\n   * cookies), so signing in or out in this tab reconnects it: every channel\n   * is then authorized as the new session, and the acks resync.\n   */\n  reconnect() {\n    this.close();\n    this.clearReconnect();\n    this.attempt = 0;\n    if (this.entries.size > 0 && !this.pausedWhileHidden) this.connect();\n  }\n\n  /** For tests: drops the socket, timers and listeners. */\n  dispose() {\n    this.clearReconnect();\n    this.cancelIdleClose();\n    if (this.hiddenTimer) clearTimeout(this.hiddenTimer);\n    for (const entry of this.entries.values()) {\n      if (entry.resyncTimer) clearTimeout(entry.resyncTimer);\n      if (entry.lingerTimer) clearTimeout(entry.lingerTimer);\n      this.clearRetry(entry);\n    }\n    this.entries.clear();\n    this.byId.clear();\n    this.close();\n    if (this.listening && typeof window !== \"undefined\") {\n      window.removeEventListener(\"online\", this.onOnline);\n      document?.removeEventListener(\"visibilitychange\", this.onVisibility);\n      this.listening = false;\n    }\n  }\n}\n\n/** Full jitter, 1 to 30 s: `max(1 s, random × min(30 s, 1 s × 2^attempt))`. */\nexport function backoffDelay(attempt: number, random: number): number {\n  const cap = Math.min(MAX_BACKOFF_MS, MIN_BACKOFF_MS * 2 ** Math.min(attempt, 10));\n  return Math.max(MIN_BACKOFF_MS, Math.floor(random * cap));\n}\n\nfunction withDefaults(options: RealtimeOptions): Required<RealtimeOptions> {\n  return {\n    path: options.path ?? DEFAULT_SOCKET_PATH,\n    hiddenDisconnectMs: options.hiddenDisconnectMs ?? DEFAULT_HIDDEN_DISCONNECT_MS,\n  };\n}\n\nfunction reportListenerError(error: unknown) {\n  setTimeout(() => {\n    throw error;\n  });\n}\n\n/**\n * The tab's client, created on first use with the options `configureRealtime`\n * set. `loadRealtimeClient` in `./loader` calls it once this module is loaded.\n */\nexport function tabClient(): RealtimeClient {\n  return (realtime.client ??= new RealtimeClient(realtime.options));\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,IAAa,qBAAqB;;;;;AAclC,IAAa,YAAY;;CAEvB,QAAQ;;CAER,iBAAiB;;CAEjB,iBAAiB;;CAEjB,SAAS;;CAET,eAAe;;CAEf,SAAS;AACX;;;;;AAuCA,SAAgB,kBAAkB,MAA2B;CAC3D,OAAO,SAAS,qBAAqB,SAAS,oBAAoB,SAAS;AAC7E;;;;AC3CA,IAAa,qBAAqB;;AAElC,IAAa,gBAAgB;;;;;;;AAO7B,IAAa,oBAAoB;;AAEjC,IAAM,wBAAwB;;;;;;;AAO9B,IAAa,oBAAoB;AACjC,IAAM,iBAAiB;AACvB,IAAM,iBAAiB;AACvB,IAAM,uBAAuB;AAC7B,IAAM,+BAA+B;;;;;;;;;;;;;;;;;AAsCrC,IAAa,iBAAb,MAAsD;CACpD;CACA;CACA,KAA+B;CAC/B,0BAAkB,IAAI,IAAmB;CACzC,uBAAe,IAAI,IAAmB;CACtC,yBAAiB,IAAI,IAAyB;CAC9C,SAAiB;CACjB,UAAkB;CAClB,MAA6B;CAC7B,gBAAuC;CACvC,cAAsB;CACtB,iBAA+D;CAC/D,YAA0D;CAC1D,cAA4D;CAC5D,YAA2D;CAC3D,gBAA8D;CAC9D,aAAoC;CACpC,UAAkB;CAClB,oBAA4B;CAC5B,YAAoB;CAEpB,YAAY,UAA2B,CAAC,GAAG,YAA6B,CAAC,GAAG;EAC1E,KAAK,UAAU,aAAa,OAAO;EACnC,KAAK,YAAY;CACnB;CAEA,UAAU,SAA0B;EAClC,KAAK,UAAU,aAAa;GAAE,GAAG,KAAK;GAAS,GAAG;EAAQ,CAAC;CAC7D;;CAGA,IAAI,WAA0B;EAC5B,OAAO,KAAK;CACd;CAEA,UAAU,SAAiB,QAA4B,UAAuC;EAC5F,MAAM,MAAM,WAAW,SAAS,MAAM;EACtC,IAAI,QAAQ,KAAK,QAAQ,IAAI,GAAG;EAChC,IAAI,CAAC,OAAO;GACV,QAAQ;IACN;IACA,IAAI,OAAO,KAAK,QAAQ;IACxB;IACA,QAAQ,EAAE,GAAG,OAAO;IACpB,2BAAW,IAAI,IAAI;IACnB,QAAQ;IACR,MAAM;IACN,WAAW;IACX,OAAO;IACP,cAAc;IACd,aAAa;IACb,aAAa;IACb,YAAY;IACZ,SAAS;GACX;GACA,KAAK,QAAQ,IAAI,KAAK,KAAK;GAC3B,KAAK,KAAK,IAAI,MAAM,IAAI,KAAK;GAC7B,IAAI,KAAK,OAAO,GACd,KAAK,QAAQ,KAAK;EAEtB;EACA,IAAI,MAAM,aAAa;GACrB,aAAa,MAAM,WAAW;GAC9B,MAAM,cAAc;EACtB;EACA,MAAM,UAAU,IAAI,QAAQ;EAC5B,SAAS,WAAW,MAAM,QAAQ,MAAM,IAAI;EAC5C,KAAK,gBAAgB;EACrB,KAAK,OAAO;EACZ,IAAI,CAAC,KAAK,MAAM,CAAC,KAAK,kBAAkB,CAAC,KAAK,mBAC5C,KAAK,QAAQ;EAGf,IAAI,WAAW;EACf,aAAa;GACX,IAAI,UAAU;GACd,WAAW;GACX,KAAK,QAAQ,OAAQ,QAAQ;EAC/B;CACF;CAEA,QAAgB,OAAc,UAA2B;EACvD,MAAM,UAAU,OAAO,QAAQ;EAC/B,IAAI,MAAM,UAAU,OAAO,KAAK,MAAM,aAAa;EACnD,MAAM,cAAc,iBAAiB;GACnC,MAAM,cAAc;GACpB,IAAI,MAAM,UAAU,SAAS,GAAG,KAAK,KAAK,KAAK;EACjD,GAAG,iBAAiB;CACtB;CAEA,KAAa,OAAc;EACzB,IAAI,MAAM,aAAa,aAAa,MAAM,WAAW;EACrD,KAAK,WAAW,KAAK;EACrB,KAAK,QAAQ,OAAO,MAAM,GAAG;EAC7B,KAAK,KAAK,OAAO,MAAM,EAAE;EACzB,KAAK,UAAU,KAAK;EACpB,IAAI,KAAK,OAAO,MAAM,MAAM,WAAW,UAAU,MAAM,WAAW,eAChE,KAAK,KAAK;GAAE,IAAI;GAAS,IAAI,MAAM;EAAG,CAAC;EAEzC,IAAI,KAAK,QAAQ,SAAS,GAAG,KAAK,kBAAkB;CACtD;CAEA,SAAiB;EACf,OAAO,KAAK,OAAO,QAAQ,KAAK,GAAG,eAAe;CACpD;CAEA,UAAkB;EAChB,IAAI,OAAO,WAAW,aAAa;EACnC,IAAI,KAAK,QAAQ,SAAS,GAAG;EAC7B,MAAM,OAAO,KAAK,UAAU,aAAa,WAAW;EACpD,IAAI,CAAC,MAAM;EACX,KAAK,eAAe;EACpB,IAAI;EACJ,IAAI;GACJ,KAAK,IAAI,KAAK,KAAK,IAAI,GAAG,CAAC,kBAAkB,CAAC;EAC9C,QAAQ;GACN,KAAK,kBAAkB;GACvB;EACF;EACA,KAAK,KAAK;EACV,KAAK,MAAM,SAAS,KAAK,QAAQ,OAAO,GACtC,IAAI,CAAC,MAAM,WAAW,KAAK,UAAU,OAAO,cAAc,IAAI;EAEhE,GAAG,eAAe;GAChB,IAAI,KAAK,OAAO,IAAI;GACpB,KAAK,MAAM;GACX,KAAK,MAAM,SAAS,KAAK,QAAQ,OAAO,GAAG;IACzC,IAAI,MAAM,WAAW;IAErB,MAAM,UAAU;IAChB,KAAK,QAAQ,KAAK;GACpB;EACF;EACA,GAAG,aAAa,UAAwB;GACtC,IAAI,KAAK,OAAO,IAAI;GACpB,KAAK,MAAM;GACX,IAAI;GACJ,IAAI;IACF,QAAQ,KAAK,MAAM,OAAO,MAAM,IAAI,CAAC;GACvC,QAAQ;IACN;GACF;GACA,KAAK,OAAO,KAAK;EACnB;EACA,GAAG,WAAW,UAAsB;GAClC,IAAI,KAAK,OAAO,IAAI;GACpB,KAAK,SAAS,MAAM,IAAI;EAC1B;EACA,GAAG,gBAAgB,CAEnB;CACF;CAEA,MAAsB;EACpB,IAAI,KAAK,UAAU,KAAK,OAAO,KAAK,UAAU;EAC9C,MAAM,EAAE,UAAU,SAAS,OAAO;EAClC,OAAO,GAAG,aAAa,WAAW,SAAS,MAAM,IAAI,OAAO,KAAK,QAAQ;CAC3E;CAEA,QAAgB,OAAc;EAC5B,KAAK,UAAU,OAAO,cAAc,IAAI;EACxC,MAAM,QAAqB;GAAE,IAAI;GAAO,IAAI,MAAM;GAAI,IAAI,MAAM;EAAQ;EACxE,IAAI,OAAO,KAAK,MAAM,MAAM,CAAC,CAAC,SAAS,GAAG,MAAM,IAAI,MAAM;EAC1D,KAAK,KAAK,KAAK;CACjB;CAEA,KAAa,OAAoB;EAC/B,IAAI,CAAC,KAAK,OAAO,GAAG;EACpB,IAAI;GACF,KAAK,GAAI,KAAK,KAAK,UAAU,KAAK,CAAC;EACrC,QAAQ,CAER;CACF;CAEA,OAAe,OAAoB;EACjC,QAAQ,MAAM,IAAd;GACE,KAAK;IACH,KAAK,gBAAgB,MAAM;IAC3B,KAAK,MAAM,MAAM;IACjB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,IAAI,MAAM,cAAc,GACtB,KAAK,cAAc,MAAM;IAE3B,KAAK,eAAe;IACpB;GACF,KAAK,cAAc;IACjB,MAAM,QAAQ,KAAK,KAAK,IAAI,MAAM,EAAE;IACpC,IAAI,CAAC,OAAO;IACZ,KAAK,UAAU,KAAK;IACpB,MAAM,QAAQ,MAAM;IACpB,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,CAAC;IACjC,IAAI,CAAC,KAAK,KAAK,OAAO,IAAI,MAAM,GAAI,sBAAM,IAAI,IAAI,CAAE;IACpD,IAAI,IAAI,MAAM,EAAE;IAChB,KAAK,WAAW,KAAK;IACrB,MAAM,UAAU;IAChB,KAAK,UAAU,OAAO,QAAQ,IAAI;IAGlC,KAAK,OAAO,KAAK;IACjB;GACF;GACA,KAAK,UAAU;IACb,MAAM,QAAQ,KAAK,KAAK,IAAI,MAAM,EAAE;IACpC,IAAI,CAAC,OAAO;IACZ,KAAK,UAAU,KAAK;IACpB,MAAM,YAAY,kBAAkB,MAAM,IAAI;IAC9C,KAAK,UAAU,OAAO,UAAU,MAAM,IAAI;IAC1C,KAAK,cAAc,OAAO,MAAM,IAAI;IACpC;GACF;GACA,KAAK,MAAM;IACT,IAAI,MAAM,MAAM,KAAA,KAAa,MAAM,MAAM,KAAK,KAAK;IACnD,MAAM,MAAM,KAAK,OAAO,IAAI,MAAM,CAAC;IACnC,IAAI,CAAC,KAAK;IACV,KAAK,MAAM,MAAM,MAAM,KAAK,GAAG,GAAG;KAChC,MAAM,QAAQ,KAAK,KAAK,IAAI,EAAE;KAC9B,IAAI,CAAC,OAAO;KACZ,KAAK,MAAM,YAAY,MAAM,KAAK,MAAM,SAAS,GAC/C,IAAI;MACF,SAAS,UAAU,MAAM,IAAI,MAAM,CAAC;KACtC,SAAS,OAAO;MACd,oBAAoB,KAAK;KAC3B;IAEJ;IACA;GACF;GACA,KAAK;IACH,KAAK,MAAM,SAAS,KAAK,QAAQ,OAAO,GACtC,IAAI,MAAM,WAAW,QAAQ,KAAK,OAAO,KAAK;IAEhD;GACF,KAAK;IACH,KAAK,aAAa,KAAK,IAAI,GAAG,OAAO,MAAM,UAAU,KAAK,CAAC;IAC3D;GACF,KAAK,QACH;EACJ;CACF;CAEA,SAAiB,MAAc;EAC7B,KAAK,KAAK;EACV,KAAK,gBAAgB;EACrB,KAAK,MAAM;EACX,KAAK,cAAc;EACnB,KAAK,OAAO,MAAM;EAClB,KAAK,MAAM,SAAS,KAAK,QAAQ,OAAO,GAAG;GACzC,MAAM,QAAQ;GAEd,KAAK,WAAW,KAAK;GACrB,IAAI,CAAC,MAAM,WAAW,KAAK,UAAU,OAAO,UAAU,IAAI;EAC5D;EACA,IAAI,SAAS,UAAU,SAAS,KAAK,UAAU;EAC/C,IAAI,KAAK,QAAQ,OAAO,KAAK,CAAC,KAAK,mBAAmB,KAAK,kBAAkB;CAC/E;CAEA,oBAA4B;EAC1B,KAAK,eAAe;EACpB,IAAI;EACJ,IAAI,KAAK,eAAe,MAAM;GAC5B,QAAQ,KAAK;GACb,KAAK,aAAa;EACpB,OAAO,IAAI,KAAK,SAAS;GAEvB,KAAK,UAAU;GACf,QAAQ,KAAK,MAAM,KAAK,OAAO,IAAI,GAAG;EACxC,OACE,QAAQ,aAAa,KAAK,SAAS,KAAK,OAAO,CAAC;EAElD,KAAK;EACL,KAAK,iBAAiB,iBAAiB;GACrC,KAAK,iBAAiB;GACtB,KAAK,QAAQ;EACf,GAAG,KAAK;CACV;CAEA,iBAAyB;EACvB,IAAI,KAAK,gBAAgB,aAAa,KAAK,cAAc;EACzD,KAAK,iBAAiB;CACxB;CAEA,SAAiB;EACf,QAAQ,KAAK,UAAU,UAAU,KAAK,OAAA,CAAQ;CAChD;CAEA,iBAAyB;EACvB,KAAK,cAAc;EACnB,KAAK,YAAY,kBAAkB,KAAK,KAAK,EAAE,IAAI,OAAO,CAAC,GAAG,KAAK,WAAW;EAC9E,KAAK,MAAM;CACb;CAEA,gBAAwB;EACtB,IAAI,KAAK,WAAW,cAAc,KAAK,SAAS;EAChD,IAAI,KAAK,eAAe,aAAa,KAAK,aAAa;EACvD,KAAK,YAAY;EACjB,KAAK,gBAAgB;CACvB;;CAGA,QAAgB;EACd,IAAI,KAAK,eAAe,aAAa,KAAK,aAAa;EACvD,MAAM,KAAK,KAAK;EAChB,KAAK,gBAAgB,iBAAiB;GACpC,IAAI,KAAK,OAAO,MAAM,CAAC,IAAI;GAE3B,IAAI;IACF,GAAG,MAAM;GACX,QAAQ,CAAC;GACT,KAAK,SAAS,IAAI;EACpB,GAAG,KAAK,cAAc,CAAC;CACzB;CAEA,UAAkB,OAAc,QAAuB,MAAyB;EAC9E,IAAI,MAAM,WAAW,UAAU,MAAM,SAAS,MAAM;EACpD,MAAM,SAAS;EACf,MAAM,OAAO;EACb,KAAK,MAAM,YAAY,MAAM,KAAK,MAAM,SAAS,GAC/C,IAAI;GACF,SAAS,WAAW,QAAQ,IAAI;EAClC,SAAS,OAAO;GACd,oBAAoB,KAAK;EAC3B;CAEJ;;CAGA,OAAe,OAAc;EAC3B,IAAI,MAAM,aAAa;EACvB,MAAM,MAAM,KAAK,IAAI;EACrB,MAAM,OAAO,MAAM,eAAe,qBAAqB;EACvD,MAAM,aAAa;GACjB,MAAM,cAAc;GACpB,MAAM,eAAe,KAAK,IAAI;GAC9B,KAAK,MAAM,YAAY,MAAM,KAAK,MAAM,SAAS,GAC/C,IAAI;IACF,SAAS,WAAW;GACtB,SAAS,OAAO;IACd,oBAAoB,KAAK;GAC3B;EAEJ;EACA,IAAI,MAAM,iBAAiB,KAAK,QAAQ,GAAG,KAAK;OAC3C,MAAM,cAAc,WAAW,MAAM,IAAI;CAChD;;;;;;;;CASA,cAAsB,OAAc,MAAkB;EACpD,IAAI,SAAS,kBAAkB,SAAS,WAAW,SAAS,SAAS;EACrE,IAAI,SAAS,WAAW,MAAM,WAAA,GAA8B;EAC5D,KAAK,WAAW,KAAK;EAErB,MAAM,QAAQ,KAAK,IADL,SAAS,iBAAiB,wBAAwB,gBAClC,aAAa,MAAM,SAAS,KAAK,OAAO,CAAC,CAAC;EACxE,MAAM;EACN,MAAM,aAAa,iBAAiB;GAClC,MAAM,aAAa;GACnB,IAAI,KAAK,QAAQ,IAAI,MAAM,GAAG,MAAM,SAAS,MAAM,WAAW,UAAU;GACxE,IAAI,KAAK,OAAO,GAAG,KAAK,QAAQ,KAAK;EACvC,GAAG,KAAK;CACV;CAEA,WAAmB,OAAc;EAC/B,IAAI,MAAM,YAAY,aAAa,MAAM,UAAU;EACnD,MAAM,aAAa;CACrB;CAEA,UAAkB,OAAc;EAC9B,IAAI,CAAC,MAAM,OAAO;EAClB,MAAM,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK;EACvC,KAAK,OAAO,MAAM,EAAE;EACpB,IAAI,OAAO,IAAI,SAAS,GAAG,KAAK,OAAO,OAAO,MAAM,KAAK;EACzD,MAAM,QAAQ;CAChB;CAEA,oBAA4B;EAC1B,KAAK,gBAAgB;EACrB,KAAK,YAAY,iBAAiB;GAChC,KAAK,YAAY;GACjB,IAAI,KAAK,QAAQ,OAAO,GAAG;GAC3B,KAAK,eAAe;GACpB,KAAK,MAAM;EACb,GAAG,aAAa;CAClB;CAEA,kBAA0B;EACxB,IAAI,KAAK,WAAW,aAAa,KAAK,SAAS;EAC/C,KAAK,YAAY;CACnB;;CAGA,QAAgB;EACd,MAAM,KAAK,KAAK;EAChB,IAAI,CAAC,IAAI;EACT,KAAK,KAAK;EACV,IAAI;GACF,GAAG,MAAM,UAAU,MAAM;EAC3B,QAAQ,CAAC;EACT,KAAK,SAAS,UAAU,MAAM;CAChC;CAEA,SAAiB;EACf,IAAI,KAAK,aAAa,OAAO,WAAW,aAAa;EACrD,KAAK,YAAY;EACjB,OAAO,iBAAiB,UAAU,KAAK,QAAQ;EAC/C,IAAI,OAAO,aAAa,aACtB,SAAS,iBAAiB,oBAAoB,KAAK,YAAY;CAEnE;CAEA,iBAAyB;EACvB,IAAI,KAAK,QAAQ,SAAS,KAAK,KAAK,MAAM,KAAK,mBAAmB;EAClE,KAAK,UAAU;EACf,KAAK,QAAQ;CACf;CAEA,qBAA6B;EAC3B,IAAI,SAAS,oBAAoB,UAAU;GACzC,IAAI,KAAK,aAAa;GACtB,KAAK,cAAc,iBAAiB;IAClC,KAAK,cAAc;IACnB,IAAI,SAAS,oBAAoB,UAAU;IAC3C,KAAK,oBAAoB;IACzB,KAAK,eAAe;IACpB,KAAK,MAAM;GACb,GAAG,KAAK,QAAQ,kBAAkB;GAClC;EACF;EACA,IAAI,KAAK,aAAa,aAAa,KAAK,WAAW;EACnD,KAAK,cAAc;EACnB,IAAI,KAAK,mBAAmB;GAC1B,KAAK,oBAAoB;GACzB,KAAK,UAAU;GAEf,KAAK,QAAQ;EACf;CACF;;;;;;;CAQA,YAAY;EACV,KAAK,MAAM;EACX,KAAK,eAAe;EACpB,KAAK,UAAU;EACf,IAAI,KAAK,QAAQ,OAAO,KAAK,CAAC,KAAK,mBAAmB,KAAK,QAAQ;CACrE;;CAGA,UAAU;EACR,KAAK,eAAe;EACpB,KAAK,gBAAgB;EACrB,IAAI,KAAK,aAAa,aAAa,KAAK,WAAW;EACnD,KAAK,MAAM,SAAS,KAAK,QAAQ,OAAO,GAAG;GACzC,IAAI,MAAM,aAAa,aAAa,MAAM,WAAW;GACrD,IAAI,MAAM,aAAa,aAAa,MAAM,WAAW;GACrD,KAAK,WAAW,KAAK;EACvB;EACA,KAAK,QAAQ,MAAM;EACnB,KAAK,KAAK,MAAM;EAChB,KAAK,MAAM;EACX,IAAI,KAAK,aAAa,OAAO,WAAW,aAAa;GACnD,OAAO,oBAAoB,UAAU,KAAK,QAAQ;GAClD,UAAU,oBAAoB,oBAAoB,KAAK,YAAY;GACnE,KAAK,YAAY;EACnB;CACF;AACF;;AAGA,SAAgB,aAAa,SAAiB,QAAwB;CACpE,MAAM,MAAM,KAAK,IAAI,gBAAgB,iBAAiB,KAAK,KAAK,IAAI,SAAS,EAAE,CAAC;CAChF,OAAO,KAAK,IAAI,gBAAgB,KAAK,MAAM,SAAS,GAAG,CAAC;AAC1D;AAEA,SAAS,aAAa,SAAqD;CACzE,OAAO;EACL,MAAM,QAAQ,QAAA;EACd,oBAAoB,QAAQ,sBAAsB;CACpD;AACF;AAEA,SAAS,oBAAoB,OAAgB;CAC3C,iBAAiB;EACf,MAAM;CACR,CAAC;AACH;;;;;AAMA,SAAgB,YAA4B;CAC1C,OAAQ,SAAS,WAAW,IAAI,eAAe,SAAS,OAAO;AACjE"}
+{"version":3,"file":"RealtimeClient-B345JtXu.js","names":[],"sources":["../../services/broadcast/protocol.ts","../../client/realtime/RealtimeClient.ts"],"sourcesContent":["/**\n * The `gemi.v1` WebSocket protocol, shared by the server transport\n * (`SocketHub`) and the browser client (`gemi/client`'s connection manager).\n * Types and constants only: this module is imported by the browser bundle, so\n * it must never import a server module.\n *\n * Every frame is a JSON text frame. Binary frames are refused.\n *\n * From the client:\n *\n * - `{op:\"sub\", id, ch, p?}`: subscribe `id` (chosen by the client, unique per\n *   socket) to the channel pattern `ch` with params `p`. The server builds\n *   the topic and authorizes it.\n * - `{op:\"unsub\", id}`\n * - `{op:\"ping\"}`: answered with `pong`. The client sends one every\n *   `heartbeatMs` and reconnects when it hears nothing for twice that.\n *\n * From the server:\n *\n * - `{op:\"hello\", socketId, tag, heartbeatMs}`: the first frame. `socketId`\n *   goes in the `X-Gemi-Socket` header of the client's own requests (for\n *   `Broadcast.toOthers`); it is never shown to anyone else. `tag` is what\n *   an event frame's `x` carries when it skips this socket.\n * - `{op:\"subscribed\", id, t}`: `id` joined topic `t`. Sent only once this\n *   process receives the topic's events, so the resync the client runs on it\n *   cannot miss one.\n * - `{op:\"denied\", id, code}`: `id` was refused, or later revoked.\n * - `{op:\"ev\", t, ev, d?, x?}`: an event on topic `t`. Dropped by the socket\n *   whose `tag` is `x`.\n * - `{op:\"gap\"}`: events may have been lost for this socket; resync all.\n * - `{op:\"pong\"}`\n * - `{op:\"bye\", code, retryAfter}`: the server is going away (a restart).\n *   Reconnect after `retryAfter` ms.\n */\n\n/** The WebSocket subprotocol. */\nexport const BROADCAST_PROTOCOL = \"gemi.v1\";\n\n/** The default endpoint, `defineBroadcastConfig({ path })`. */\nexport const DEFAULT_SOCKET_PATH = \"/__gemi/socket\";\n\nexport { SOCKET_ID_HEADER } from \"./socketHeader\";\n\n/** What a subscription id may look like. */\nexport const SUBSCRIPTION_ID = /^[A-Za-z0-9_-]{1,32}$/;\n\n/**\n * Close codes the server uses. 1012 and 1013 are the standard \"restart\" and\n * \"try again later\"; the 4xxx ones are gemi's own.\n */\nexport const CloseCode = {\n  /** The client went away (tab closed, socket released). */\n  Normal: 1000,\n  /** A frame that was not JSON text, or not a known op. */\n  UnsupportedData: 1003,\n  /** Too many frames, or a frame over the size limit. */\n  PolicyViolation: 1008,\n  /** The server is restarting; `bye` said when to come back. */\n  Restart: 1012,\n  /** The socket fell too far behind; reconnect and resync. */\n  TryAgainLater: 1013,\n  /** The socket's user was signed out or its access revoked. */\n  Revoked: 4001,\n} as const;\n\n/** Why a subscription was refused. */\nexport type DeniedCode =\n  /** No channel with that pattern. Permanent. */\n  | \"unknown_channel\"\n  /** Missing, extra or malformed params. Permanent. */\n  | \"invalid_params\"\n  /** The channel's authorization said no. */\n  | \"denied\"\n  /** Authorization failed (a session store outage, a bug). Retryable. */\n  | \"error\"\n  /** The socket has `maxChannelsPerSocket` subscriptions already. */\n  | \"limit\"\n  /** Too many `sub`/`unsub` frames; retry later. */\n  | \"rate_limited\"\n  /** The subscription was revoked by `Broadcast.revoke`. */\n  | \"revoked\"\n  /** The frame was malformed, or the id is already in use. */\n  | \"invalid\";\n\nexport type ClientFrame =\n  | { op: \"sub\"; id: string; ch: string; p?: Record<string, string | number> }\n  | { op: \"unsub\"; id: string }\n  | { op: \"ping\" };\n\nexport type ServerFrame =\n  | { op: \"hello\"; socketId: string; tag: string; heartbeatMs: number }\n  | { op: \"subscribed\"; id: string; t: string }\n  | { op: \"denied\"; id: string; code: DeniedCode }\n  | { op: \"ev\"; t: string; ev: string; d?: unknown; x?: string }\n  | { op: \"gap\" }\n  | { op: \"pong\" }\n  | { op: \"bye\"; code: number; retryAfter: number };\n\n/**\n * Whether a refusal is final for this socket's session: resubscribing will\n * get the same answer, so the client does not retry it on its own.\n */\nexport function isPermanentDenial(code: DeniedCode): boolean {\n  return code === \"unknown_channel\" || code === \"invalid_params\" || code === \"invalid\";\n}\n","import {\n  BROADCAST_PROTOCOL,\n  CloseCode,\n  DEFAULT_SOCKET_PATH,\n  isPermanentDenial,\n  type ClientFrame,\n  type DeniedCode,\n  type ServerFrame,\n} from \"../../services/broadcast/protocol\";\nimport { channelKey } from \"./channelKey\";\nimport { realtime } from \"./loader\";\n\n/**\n * Where a channel subscription stands, as the hooks report it.\n *\n * - `idle`: the hook is disabled (`enabled: false`).\n * - `connecting`: the socket is opening, or the `sub` awaits its answer.\n * - `open`: subscribed; events arrive.\n * - `denied`: the server refused (or revoked) it; `code` says why.\n * - `closed`: no socket, on the server, before the first effect, or while\n *   waiting to reconnect.\n */\nexport type ChannelStatus = \"idle\" | \"connecting\" | \"open\" | \"denied\" | \"closed\";\n\nexport type ChannelParamValues = Record<string, string | number>;\n\n/** What a hook hands the socket for one channel. */\nexport interface ChannelListener {\n  onEvent?(event: string, data: unknown): void;\n  /** Events may have been missed: refetch what the channel describes. */\n  onResync?(): void;\n  onStatus?(status: ChannelStatus, code: DeniedCode | null): void;\n}\n\n/**\n * What the hooks subscribe through: the tab's `RealtimeClient`, or a\n * `FakeSocket` in tests. Returns the release function.\n */\nexport interface RealtimeSocket {\n  subscribe(pattern: string, params: ChannelParamValues, listener: ChannelListener): () => void;\n}\n\nexport interface RealtimeOptions {\n  /** The socket endpoint, `defineBroadcastConfig({ path })`. Default `/__gemi/socket`. */\n  path?: string;\n  /**\n   * How long a hidden tab keeps its socket, in ms, before disconnecting. On\n   * becoming visible again it reconnects and resyncs. Default 60 000.\n   */\n  hiddenDisconnectMs?: number;\n}\n\ninterface ClientInternals {\n  /** Test seam: the WebSocket class. */\n  WebSocket?: typeof WebSocket;\n  /** Test seam: the full URL, instead of the page's origin + `path`. */\n  url?: string;\n  random?: () => number;\n}\n\n/** The minimum gap between two resyncs of one subscription. */\nexport const RESYNC_COALESCE_MS = 2_000;\n/** How long the socket stays open after its last subscription goes. */\nexport const IDLE_CLOSE_MS = 5_000;\n/**\n * How long a subscription outlives its last listener. A hook that remounts\n * within it (StrictMode's double mount, a route change back, a list that\n * re-renders its rows) picks the same subscription up again: no `unsub`, no\n * new `sub`, nothing counted against the server's rate limit.\n */\nexport const RELEASE_LINGER_MS = 1_500;\n/** The least wait before resending a `sub` denied with `rate_limited`. */\nconst RATE_LIMITED_RETRY_MS = 5_000;\n/**\n * How often a `sub` denied with `limit` is resent on one socket. The socket\n * holds as many channels as the server allows, so only a released one makes\n * room: worth a few tries with backoff, not a retry for as long as the socket\n * lives. Past it the subscription waits for the next connection.\n */\nexport const MAX_LIMIT_RETRIES = 5;\nconst MIN_BACKOFF_MS = 1_000;\nconst MAX_BACKOFF_MS = 30_000;\nconst DEFAULT_HEARTBEAT_MS = 25_000;\nconst DEFAULT_HIDDEN_DISCONNECT_MS = 60_000;\n\ninterface Entry {\n  key: string;\n  id: string;\n  pattern: string;\n  params: ChannelParamValues;\n  listeners: Set<ChannelListener>;\n  status: ChannelStatus;\n  code: DeniedCode | null;\n  /** Refused for good: not resent on a reconnect. */\n  permanent: boolean;\n  topic: string | null;\n  lastResyncAt: number;\n  resyncTimer: ReturnType<typeof setTimeout> | null;\n  /** Set while the entry outlives its last listener; see `RELEASE_LINGER_MS`. */\n  lingerTimer: ReturnType<typeof setTimeout> | null;\n  /** A transient denial's resend, on the same socket. */\n  retryTimer: ReturnType<typeof setTimeout> | null;\n  retries: number;\n}\n\n/**\n * The tab's one WebSocket to the app (`gemi.v1`), multiplexing every channel\n * the mounted hooks subscribe to.\n *\n * Opened by the first subscription and closed a few seconds after the last\n * one goes. Reconnects with full-jitter backoff (1 to 30 s), or after the\n * server's `bye.retryAfter`, at once on `online`; resubscribes everything\n * then. A tab hidden for `hiddenDisconnectMs` disconnects, and reconnects\n * when shown. Every `subscribed` ack and every `gap` resyncs the\n * subscription (coalesced to one per 2 s), because events are volatile: a\n * client that may have missed one refetches over HTTP.\n *\n * Loaded on first use (#891): import this module as a type only, and reach\n * the tab's instance through `./loader`, or it lands in every route's entry\n * chunk.\n */\nexport class RealtimeClient implements RealtimeSocket {\n  private options: Required<RealtimeOptions>;\n  private readonly internals: ClientInternals;\n  private ws: WebSocket | null = null;\n  private entries = new Map<string, Entry>();\n  private byId = new Map<string, Entry>();\n  private topics = new Map<string, Set<string>>();\n  private nextId = 1;\n  private attempt = 0;\n  private tag: string | null = null;\n  private socketIdValue: string | null = null;\n  private heartbeatMs = DEFAULT_HEARTBEAT_MS;\n  private reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n  private idleTimer: ReturnType<typeof setTimeout> | null = null;\n  private hiddenTimer: ReturnType<typeof setTimeout> | null = null;\n  private pingTimer: ReturnType<typeof setInterval> | null = null;\n  private livenessTimer: ReturnType<typeof setTimeout> | null = null;\n  private retryAfter: number | null = null;\n  private revoked = false;\n  private pausedWhileHidden = false;\n  private listening = false;\n\n  constructor(options: RealtimeOptions = {}, internals: ClientInternals = {}) {\n    this.options = withDefaults(options);\n    this.internals = internals;\n  }\n\n  configure(options: RealtimeOptions) {\n    this.options = withDefaults({ ...this.options, ...options });\n  }\n\n  /** The id to send as `X-Gemi-Socket`, while the socket is open. */\n  get socketId(): string | null {\n    return this.socketIdValue;\n  }\n\n  subscribe(pattern: string, params: ChannelParamValues, listener: ChannelListener): () => void {\n    const key = channelKey(pattern, params);\n    let entry = this.entries.get(key);\n    if (!entry) {\n      entry = {\n        key,\n        id: String(this.nextId++),\n        pattern,\n        params: { ...params },\n        listeners: new Set(),\n        status: \"closed\",\n        code: null,\n        permanent: false,\n        topic: null,\n        lastResyncAt: 0,\n        resyncTimer: null,\n        lingerTimer: null,\n        retryTimer: null,\n        retries: 0,\n      };\n      this.entries.set(key, entry);\n      this.byId.set(entry.id, entry);\n      if (this.isOpen()) {\n        this.sendSub(entry);\n      }\n    }\n    if (entry.lingerTimer) {\n      clearTimeout(entry.lingerTimer);\n      entry.lingerTimer = null;\n    }\n    entry.listeners.add(listener);\n    listener.onStatus?.(entry.status, entry.code);\n    this.cancelIdleClose();\n    this.listen();\n    if (!this.ws && !this.reconnectTimer && !this.pausedWhileHidden) {\n      this.connect();\n    }\n\n    let released = false;\n    return () => {\n      if (released) return;\n      released = true;\n      this.release(entry!, listener);\n    };\n  }\n\n  private release(entry: Entry, listener: ChannelListener) {\n    entry.listeners.delete(listener);\n    if (entry.listeners.size > 0 || entry.lingerTimer) return;\n    entry.lingerTimer = setTimeout(() => {\n      entry.lingerTimer = null;\n      if (entry.listeners.size === 0) this.drop(entry);\n    }, RELEASE_LINGER_MS);\n  }\n\n  private drop(entry: Entry) {\n    if (entry.resyncTimer) clearTimeout(entry.resyncTimer);\n    this.clearRetry(entry);\n    this.entries.delete(entry.key);\n    this.byId.delete(entry.id);\n    this.dropTopic(entry);\n    if (this.isOpen() && (entry.status === \"open\" || entry.status === \"connecting\")) {\n      this.send({ op: \"unsub\", id: entry.id });\n    }\n    if (this.entries.size === 0) this.scheduleIdleClose();\n  }\n\n  private isOpen() {\n    return this.ws !== null && this.ws.readyState === 1;\n  }\n\n  private connect() {\n    if (typeof window === \"undefined\") return;\n    if (this.entries.size === 0) return;\n    const Impl = this.internals.WebSocket ?? globalThis.WebSocket;\n    if (!Impl) return;\n    this.clearReconnect();\n    let ws: WebSocket;\n    try {\n    ws = new Impl(this.url(), [BROADCAST_PROTOCOL]);\n    } catch {\n      this.scheduleReconnect();\n      return;\n    }\n    this.ws = ws;\n    for (const entry of this.entries.values()) {\n      if (!entry.permanent) this.setStatus(entry, \"connecting\", null);\n    }\n    ws.onopen = () => {\n      if (this.ws !== ws) return;\n      this.touch();\n      for (const entry of this.entries.values()) {\n        if (entry.permanent) continue;\n        // A new socket starts every transient denial's count over.\n        entry.retries = 0;\n        this.sendSub(entry);\n      }\n    };\n    ws.onmessage = (event: MessageEvent) => {\n      if (this.ws !== ws) return;\n      this.touch();\n      let frame: ServerFrame;\n      try {\n        frame = JSON.parse(String(event.data));\n      } catch {\n        return;\n      }\n      this.handle(frame);\n    };\n    ws.onclose = (event: CloseEvent) => {\n      if (this.ws !== ws) return;\n      this.onClosed(event.code);\n    };\n    ws.onerror = () => {\n      // A `close` follows.\n    };\n  }\n\n  private url(): string {\n    if (this.internals.url) return this.internals.url;\n    const { protocol, host } = window.location;\n    return `${protocol === \"https:\" ? \"wss:\" : \"ws:\"}//${host}${this.options.path}`;\n  }\n\n  private sendSub(entry: Entry) {\n    this.setStatus(entry, \"connecting\", null);\n    const frame: ClientFrame = { op: \"sub\", id: entry.id, ch: entry.pattern };\n    if (Object.keys(entry.params).length > 0) frame.p = entry.params;\n    this.send(frame);\n  }\n\n  private send(frame: ClientFrame) {\n    if (!this.isOpen()) return;\n    try {\n      this.ws!.send(JSON.stringify(frame));\n    } catch {\n      // The close handler takes over.\n    }\n  }\n\n  private handle(frame: ServerFrame) {\n    switch (frame.op) {\n      case \"hello\":\n        this.socketIdValue = frame.socketId;\n        this.tag = frame.tag;\n        this.attempt = 0;\n        this.revoked = false;\n        if (frame.heartbeatMs > 0) {\n          this.heartbeatMs = frame.heartbeatMs;\n        }\n        this.startHeartbeat();\n        return;\n      case \"subscribed\": {\n        const entry = this.byId.get(frame.id);\n        if (!entry) return;\n        this.dropTopic(entry);\n        entry.topic = frame.t;\n        let ids = this.topics.get(frame.t);\n        if (!ids) this.topics.set(frame.t, (ids = new Set()));\n        ids.add(entry.id);\n        this.clearRetry(entry);\n        entry.retries = 0;\n        this.setStatus(entry, \"open\", null);\n        // The window between the view rendering and this ack, or the time\n        // the socket was down, may have carried events this tab missed.\n        this.resync(entry);\n        return;\n      }\n      case \"denied\": {\n        const entry = this.byId.get(frame.id);\n        if (!entry) return;\n        this.dropTopic(entry);\n        entry.permanent = isPermanentDenial(frame.code);\n        this.setStatus(entry, \"denied\", frame.code);\n        this.scheduleRetry(entry, frame.code);\n        return;\n      }\n      case \"ev\": {\n        if (frame.x !== undefined && frame.x === this.tag) return;\n        const ids = this.topics.get(frame.t);\n        if (!ids) return;\n        for (const id of Array.from(ids)) {\n          const entry = this.byId.get(id);\n          if (!entry) continue;\n          for (const listener of Array.from(entry.listeners)) {\n            try {\n              listener.onEvent?.(frame.ev, frame.d);\n            } catch (error) {\n              reportListenerError(error);\n            }\n          }\n        }\n        return;\n      }\n      case \"gap\":\n        for (const entry of this.entries.values()) {\n          if (entry.status === \"open\") this.resync(entry);\n        }\n        return;\n      case \"bye\":\n        this.retryAfter = Math.max(0, Number(frame.retryAfter) || 0);\n        return;\n      case \"pong\":\n        return;\n    }\n  }\n\n  private onClosed(code: number) {\n    this.ws = null;\n    this.socketIdValue = null;\n    this.tag = null;\n    this.stopHeartbeat();\n    this.topics.clear();\n    for (const entry of this.entries.values()) {\n      entry.topic = null;\n      // The reconnect resends it.\n      this.clearRetry(entry);\n      if (!entry.permanent) this.setStatus(entry, \"closed\", null);\n    }\n    if (code === CloseCode.Revoked) this.revoked = true;\n    if (this.entries.size > 0 && !this.pausedWhileHidden) this.scheduleReconnect();\n  }\n\n  private scheduleReconnect() {\n    this.clearReconnect();\n    let delay: number;\n    if (this.retryAfter !== null) {\n      delay = this.retryAfter;\n      this.retryAfter = null;\n    } else if (this.revoked) {\n      // Signed out or access revoked: come back promptly, as whoever we are now.\n      this.revoked = false;\n      delay = Math.floor(this.random() * 500);\n    } else {\n      delay = backoffDelay(this.attempt, this.random());\n    }\n    this.attempt++;\n    this.reconnectTimer = setTimeout(() => {\n      this.reconnectTimer = null;\n      this.connect();\n    }, delay);\n  }\n\n  private clearReconnect() {\n    if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n    this.reconnectTimer = null;\n  }\n\n  private random() {\n    return (this.internals.random ?? Math.random)();\n  }\n\n  private startHeartbeat() {\n    this.stopHeartbeat();\n    this.pingTimer = setInterval(() => this.send({ op: \"ping\" }), this.heartbeatMs);\n    this.touch();\n  }\n\n  private stopHeartbeat() {\n    if (this.pingTimer) clearInterval(this.pingTimer);\n    if (this.livenessTimer) clearTimeout(this.livenessTimer);\n    this.pingTimer = null;\n    this.livenessTimer = null;\n  }\n\n  /** Anything from the server proves the socket alive. */\n  private touch() {\n    if (this.livenessTimer) clearTimeout(this.livenessTimer);\n    const ws = this.ws;\n    this.livenessTimer = setTimeout(() => {\n      if (this.ws !== ws || !ws) return;\n      // Silent for two heartbeats: a dead connection a proxy never closed.\n      try {\n        ws.close();\n      } catch {}\n      this.onClosed(1006);\n    }, this.heartbeatMs * 2);\n  }\n\n  private setStatus(entry: Entry, status: ChannelStatus, code: DeniedCode | null) {\n    if (entry.status === status && entry.code === code) return;\n    entry.status = status;\n    entry.code = code;\n    for (const listener of Array.from(entry.listeners)) {\n      try {\n        listener.onStatus?.(status, code);\n      } catch (error) {\n        reportListenerError(error);\n      }\n    }\n  }\n\n  /** At most one resync per subscription per 2 s; a later one is deferred, not dropped. */\n  private resync(entry: Entry) {\n    if (entry.resyncTimer) return;\n    const now = Date.now();\n    const wait = entry.lastResyncAt + RESYNC_COALESCE_MS - now;\n    const fire = () => {\n      entry.resyncTimer = null;\n      entry.lastResyncAt = Date.now();\n      for (const listener of Array.from(entry.listeners)) {\n        try {\n          listener.onResync?.();\n        } catch (error) {\n          reportListenerError(error);\n        }\n      }\n    };\n    if (entry.lastResyncAt === 0 || wait <= 0) fire();\n    else entry.resyncTimer = setTimeout(fire, wait);\n  }\n\n  /**\n   * A transient denial (`rate_limited`, `error`, `limit`) is retried on the\n   * same socket, with backoff: a healthy socket may never reconnect. `denied`\n   * and `revoked` are the channel's answer for this session, so they wait for\n   * the next connection (a sign-in reconnects), and a permanent one is never\n   * resent. `limit` gives up after `MAX_LIMIT_RETRIES` on one socket.\n   */\n  private scheduleRetry(entry: Entry, code: DeniedCode) {\n    if (code !== \"rate_limited\" && code !== \"error\" && code !== \"limit\") return;\n    if (code === \"limit\" && entry.retries >= MAX_LIMIT_RETRIES) return;\n    this.clearRetry(entry);\n    const floor = code === \"rate_limited\" ? RATE_LIMITED_RETRY_MS : MIN_BACKOFF_MS;\n    const delay = Math.max(floor, backoffDelay(entry.retries, this.random()));\n    entry.retries++;\n    entry.retryTimer = setTimeout(() => {\n      entry.retryTimer = null;\n      if (this.entries.get(entry.key) !== entry || entry.status !== \"denied\") return;\n      if (this.isOpen()) this.sendSub(entry);\n    }, delay);\n  }\n\n  private clearRetry(entry: Entry) {\n    if (entry.retryTimer) clearTimeout(entry.retryTimer);\n    entry.retryTimer = null;\n  }\n\n  private dropTopic(entry: Entry) {\n    if (!entry.topic) return;\n    const ids = this.topics.get(entry.topic);\n    ids?.delete(entry.id);\n    if (ids && ids.size === 0) this.topics.delete(entry.topic);\n    entry.topic = null;\n  }\n\n  private scheduleIdleClose() {\n    this.cancelIdleClose();\n    this.idleTimer = setTimeout(() => {\n      this.idleTimer = null;\n      if (this.entries.size > 0) return;\n      this.clearReconnect();\n      this.close();\n    }, IDLE_CLOSE_MS);\n  }\n\n  private cancelIdleClose() {\n    if (this.idleTimer) clearTimeout(this.idleTimer);\n    this.idleTimer = null;\n  }\n\n  /** Closes the socket without reconnecting. */\n  private close() {\n    const ws = this.ws;\n    if (!ws) return;\n    this.ws = null;\n    try {\n      ws.close(CloseCode.Normal);\n    } catch {}\n    this.onClosed(CloseCode.Normal);\n  }\n\n  private listen() {\n    if (this.listening || typeof window === \"undefined\") return;\n    this.listening = true;\n    window.addEventListener(\"online\", this.onOnline);\n    if (typeof document !== \"undefined\") {\n      document.addEventListener(\"visibilitychange\", this.onVisibility);\n    }\n  }\n\n  private onOnline = () => {\n    if (this.entries.size === 0 || this.ws || this.pausedWhileHidden) return;\n    this.attempt = 0;\n    this.connect();\n  };\n\n  private onVisibility = () => {\n    if (document.visibilityState === \"hidden\") {\n      if (this.hiddenTimer) return;\n      this.hiddenTimer = setTimeout(() => {\n        this.hiddenTimer = null;\n        if (document.visibilityState !== \"hidden\") return;\n        this.pausedWhileHidden = true;\n        this.clearReconnect();\n        this.close();\n      }, this.options.hiddenDisconnectMs);\n      return;\n    }\n    if (this.hiddenTimer) clearTimeout(this.hiddenTimer);\n    this.hiddenTimer = null;\n    if (this.pausedWhileHidden) {\n      this.pausedWhileHidden = false;\n      this.attempt = 0;\n      // The `subscribed` acks resync every subscription.\n      this.connect();\n    }\n  };\n\n  /**\n   * Drops the socket and opens a new one at once, when anything is\n   * subscribed. A socket keeps the session it was opened with (the upgrade's\n   * cookies), so signing in or out in this tab reconnects it: every channel\n   * is then authorized as the new session, and the acks resync.\n   */\n  reconnect() {\n    this.close();\n    this.clearReconnect();\n    this.attempt = 0;\n    if (this.entries.size > 0 && !this.pausedWhileHidden) this.connect();\n  }\n\n  /** For tests: drops the socket, timers and listeners. */\n  dispose() {\n    this.clearReconnect();\n    this.cancelIdleClose();\n    if (this.hiddenTimer) clearTimeout(this.hiddenTimer);\n    for (const entry of this.entries.values()) {\n      if (entry.resyncTimer) clearTimeout(entry.resyncTimer);\n      if (entry.lingerTimer) clearTimeout(entry.lingerTimer);\n      this.clearRetry(entry);\n    }\n    this.entries.clear();\n    this.byId.clear();\n    this.close();\n    if (this.listening && typeof window !== \"undefined\") {\n      window.removeEventListener(\"online\", this.onOnline);\n      document?.removeEventListener(\"visibilitychange\", this.onVisibility);\n      this.listening = false;\n    }\n  }\n}\n\n/** Full jitter, 1 to 30 s: `max(1 s, random × min(30 s, 1 s × 2^attempt))`. */\nexport function backoffDelay(attempt: number, random: number): number {\n  const cap = Math.min(MAX_BACKOFF_MS, MIN_BACKOFF_MS * 2 ** Math.min(attempt, 10));\n  return Math.max(MIN_BACKOFF_MS, Math.floor(random * cap));\n}\n\nfunction withDefaults(options: RealtimeOptions): Required<RealtimeOptions> {\n  return {\n    path: options.path ?? DEFAULT_SOCKET_PATH,\n    hiddenDisconnectMs: options.hiddenDisconnectMs ?? DEFAULT_HIDDEN_DISCONNECT_MS,\n  };\n}\n\nfunction reportListenerError(error: unknown) {\n  setTimeout(() => {\n    throw error;\n  });\n}\n\n/**\n * The tab's client, created on first use with the options `configureRealtime`\n * set. `loadRealtimeClient` in `./loader` calls it once this module is loaded.\n */\nexport function tabClient(): RealtimeClient {\n  return (realtime.client ??= new RealtimeClient(realtime.options));\n}\n"],"mappings":"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"}

package/dist/chunks/{ThemeProvider-gWqXjGh-.js → ThemeProvider-BwlMubvu.js}

@@ -779,7 +779,7 @@ function loadedRealtimeClient() {
 }
 var loading = null;
 /** The lazily loaded client. Replaceable in tests, to simulate a failed load. */
-var lazyModules = { client: () => import("./RealtimeClient-DsWbFRC7.js") };
+var lazyModules = { client: () => import("./RealtimeClient-B345JtXu.js") };
 /**
 * `./live`, loaded by the first live query. `<Page>` in `gemi/testing` sets
 * `current` up front, so a live query on a provided socket subscribes during
@@ -787,7 +787,7 @@ var lazyModules = { client: () => import("./RealtimeClient-DsWbFRC7.js") };
 */
 var liveModule = {
 	current: null,
-	load: () => import("./live-CUdMhXHL.js").then((n) => n.n)
+	load: () => import("./live-Cq65lqVg.js").then((n) => n.n)
 };
 /**
 * The tab's client, loading its module and creating it on first use. `null`
@@ -3563,51 +3563,118 @@ function C(r = [], e = []) {
 	return r.length !== e.length || r.some((t, o) => !Object.is(t, e[o]));
 }
 //#endregion
+//#region client/theme.ts
+/** The cookie gemi stores the choice in unless `theme.cookie` names another. */
+var DEFAULT_THEME_COOKIE = "theme";
+function isTheme(value) {
+	return value === "light" || value === "dark" || value === "system";
+}
+/** `"system"` asks the browser; the other two are already resolved. */
+function resolveTheme(theme, prefersDark) {
+	if (theme === "system") return prefersDark ? "dark" : "light";
+	return theme;
+}
+/**
+* Puts `resolved` on `<html>`: the class, and `color-scheme` for the browser's
+* own widgets. Removes only the other theme class, never anything else.
+*/
+function applyTheme(root, resolved) {
+	root.classList.remove(resolved === "dark" ? "light" : "dark");
+	root.classList.add(resolved);
+	root.style.colorScheme = resolved;
+}
+/** One year: the choice should outlive the session, as `localStorage` did. */
+var COOKIE_MAX_AGE = 3600 * 24 * 365;
+/**
+* Stores the choice where both the server and the inline script read it: the
+* cookie. `localStorage` is still written, so a page from an older build that
+* only reads storage agrees with this one.
+*/
+function storeTheme(theme, cookie = DEFAULT_THEME_COOKIE) {
+	try {
+		document.cookie = `${cookie}=${theme}; path=/; max-age=${COOKIE_MAX_AGE}; samesite=lax`;
+	} catch {}
+	try {
+		localStorage.setItem("theme", theme);
+	} catch {}
+}
+/** The stored choice in the browser: the cookie, else the legacy `localStorage` key. */
+function readStoredTheme(cookie = DEFAULT_THEME_COOKIE) {
+	try {
+		for (const part of document.cookie.split(";")) {
+			const eq = part.indexOf("=");
+			if (eq < 0 || part.slice(0, eq).trim() !== cookie) continue;
+			const value = decodeURIComponent(part.slice(eq + 1).trim());
+			if (isTheme(value)) return value;
+		}
+	} catch {}
+	try {
+		const value = localStorage.getItem("theme");
+		if (isTheme(value)) return value;
+	} catch {}
+	return null;
+}
+//#endregion
 //#region client/ThemeProvider.tsx
+var DARK_QUERY = "(prefers-color-scheme: dark)";
 var ThemeContext = createContext({
 	theme: "light",
-	setTheme: (theme) => {}
+	resolved: "light",
+	setTheme: () => {}
 });
-function storeTheme(theme) {
-	try {
-		localStorage.setItem("theme", theme);
-	} catch (error) {
-		console.error("Failed to store theme in localStorage:", error);
-	}
+function initialResolved(theme) {
+	return theme === "system" ? null : theme;
 }
 var ThemeProvider = (props) => {
-	const [theme, setTheme] = useState(() => {
-		if (props.theme) return props.theme;
-		if (typeof window === "undefined") return "light";
-		return localStorage.getItem("theme") || "light";
-	});
+	const data = useContext(ServerDataContext)?.theme;
+	const cookie = data?.cookie ?? "theme";
+	const [theme, setThemeState] = useState(() => props.theme ?? data?.value ?? data?.default ?? "light");
+	const [resolved, setResolved] = useState(() => initialResolved(theme));
 	useEffect(() => {
-		if (theme === "system") window.matchMedia("(prefers-color-scheme: dark)").addEventListener("change", ({ matches }) => {
-			document.documentElement.classList.remove("light", "dark");
-			document.documentElement.classList.add(matches ? "dark" : "light");
-		});
+		if (props.theme || data?.value) return;
+		const stored = readStoredTheme(cookie);
+		if (stored && stored !== theme) {
+			setThemeState(stored);
+			setResolved(initialResolved(stored));
+		}
+	}, []);
+	useEffect(() => {
+		if (theme !== "system" || typeof window.matchMedia !== "function") return;
+		const media = window.matchMedia(DARK_QUERY);
+		setResolved(resolveTheme("system", media.matches));
+		const onChange = ({ matches }) => {
+			const next = resolveTheme("system", matches);
+			setResolved(next);
+			applyTheme(document.documentElement, next);
+		};
+		media.addEventListener("change", onChange);
+		return () => media.removeEventListener("change", onChange);
 	}, [theme]);
+	const setTheme = (next) => {
+		const nextResolved = resolveTheme(next, typeof window.matchMedia === "function" && window.matchMedia(DARK_QUERY).matches);
+		setThemeState(next);
+		setResolved(nextResolved);
+		storeTheme(next, cookie);
+		applyTheme(document.documentElement, nextResolved);
+	};
 	return /* @__PURE__ */ jsx(ThemeContext.Provider, {
 		value: {
 			theme,
-			setTheme: (newTheme) => {
-				setTheme(newTheme);
-				storeTheme(newTheme);
-				let documentTheme = newTheme;
-				if (newTheme === "system") documentTheme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
-				document.documentElement.classList.remove("light", "dark");
-				document.documentElement.classList.add(documentTheme);
-			}
+			resolved,
+			setTheme
 		},
 		children: props.children
 	});
 };
+/**
+* The visitor's theme: `theme` (their choice), `resolved` (`"light"` or
+* `"dark"`, `null` until `"system"` is known) and `setTheme`, which applies it
+* to `<html>` and stores it in the theme cookie the server reads.
+*/
 function useTheme() {
-	const context = useContext(ThemeContext);
-	if (!context) throw new Error("useTheme must be used within a ThemeProvider");
-	return context;
+	return useContext(ThemeContext);
 }
 //#endregion
 export { DEFAULT_STALE_TIME as $, ServerDataContext as A, followLive as B, readRoutePayload as C, useNavigate as D, useSearchParams as E, ProgressManager as F, loadedModule as G, realtime as H, Action as I, QueryConfigContext as J, toVariantKey as K, createMemoryHistory as L, useLocation as M, domainUrl as N, I18nContext as O, isAbsoluteUrl as P, pickDefined as Q, RealtimeContext as R, setActiveLocale as S, useRoute as T, reconnectRealtime as U, liveModule as V, loadLazy as W, QueryManagerProvider as X, QueryManagerContext as Y, USER_QUERY_CONFIG_KEYS as Z, isChunkLoadError as _, useRouteTransition as a, Subject as at, loadDictionaryForRender as b, ClientRouterContext as c, ComponentsProvider as d, isRetryableQueryError as et, initialViewModulesReady as f, configureChunkLoadRecovery as g, CHUNK_RELOAD_MARKER as h, RouteTransitionProvider as i, QueryError as it, ServerDataProvider as j, I18nProvider as k, ClientRouterProvider as l, subscribeViewModules as m, useTheme as n, retryDelayFor as nt, useChannelSubscription as o, loadViewModule as p, applyParams as q, m as r, shouldRetryQuery as rt, useCoalesced as s, ThemeProvider as t, parseRetryAfter as tt, ComponentsContext as u, recoverFromChunkLoadError as v, routeDataUrl as w, registerDictionary as x, loadDictionary as y, configureRealtime as z };
 
-//# sourceMappingURL=ThemeProvider-gWqXjGh-.js.map
+//# sourceMappingURL=ThemeProvider-BwlMubvu.js.map