@flamingo-stack/openframe-frontend-core 0.0.444 → 0.0.445

package/dist/chunk-P47NN7RY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/nats/nats.ts","../src/nats/shared-connection.ts","../src/nats/nats-provider.tsx","../src/nats/use-nats-subscription.ts"],"sourcesContent":["import type {\n  ConnectionOptions,\n  Consumer,\n  ConsumerMessages,\n  JsMsg,\n  MsgHdrs as NatsHeaders,\n  Msg,\n  NatsConnection,\n  Subscription,\n} from 'nats.ws'\n\nexport type { JsMsg, Msg, Subscription } from 'nats.ws'\n\nexport type JetStreamDeliverPolicy = 'new' | 'byStartSequence'\n\nexport interface JetStreamOrderedSubscribeOptions {\n  streamName: string\n  filterSubject: string\n  deliverPolicy: JetStreamDeliverPolicy\n  /** Required when deliverPolicy === 'byStartSequence'. */\n  optStartSeq?: number\n  /** Auto-cleanup the ephemeral consumer after this idle time. Default: 5 minutes. */\n  inactiveThresholdMs?: number\n  /** AbortSignal to tear down the consumer. */\n  signal?: AbortSignal\n}\n\nexport interface JetStreamSubscriptionHandle {\n  unsubscribe(): void\n}\n\nexport interface NatsClientOptions {\n  /**\n   * NATS server URL(s), for example:\n   * - \"wss://nats.example.com:443\"\n   * - [\"wss://nats-1.example.com:443\", \"wss://nats-2.example.com:443\"]\n   */\n  servers: string | string[]\n\n  /**\n   * Connection name (shows up in NATS monitoring).\n   */\n  name?: string\n\n  /**\n   * Auth options (pick one: token or user/pass).\n   */\n  token?: string\n  user?: string\n  pass?: string\n\n  /**\n   * Reconnect behavior.\n   */\n  reconnect?: boolean\n  maxReconnectAttempts?: number\n  reconnectTimeWaitMs?: number\n\n  /**\n   * Exponential backoff for reconnect delays.\n   * When set, uses `reconnectDelayHandler` from nats.ws under the hood,\n   * overriding `reconnectTimeWaitMs`.\n   */\n  exponentialBackoff?: {\n    /** Initial delay in ms (default: 1000) */\n    initialDelayMs?: number\n    /** Maximum delay cap in ms (default: 30000) */\n    maxDelayMs?: number\n    /** Multiplier per attempt (default: 2) */\n    multiplier?: number\n    /** Add random jitter 0-50% of delay to prevent thundering herd (default: true) */\n    jitter?: boolean\n  }\n\n  /**\n   * Ping behavior (keep-alive).\n   */\n  pingIntervalMs?: number\n  maxPingOut?: number\n\n  /**\n   * Optional inbox prefix (useful if you want to isolate request/reply inboxes).\n   */\n  inboxPrefix?: string\n\n  /**\n   * Connection timeout in milliseconds (maps to `nats.ws` connect option `timeout`).\n   * If you see `NatsError: TIMEOUT` during connect, increase this.\n   */\n  connectTimeoutMs?: number\n}\n\nexport interface NatsSubscribeOptions {\n  /**\n   * Queue group for load-balancing messages across subscribers.\n   */\n  queue?: string\n\n  /**\n   * Auto-unsubscribe after receiving this many messages.\n   */\n  max?: number\n\n  /**\n   * Abort signal to stop message iteration and unsubscribe.\n   */\n  signal?: AbortSignal\n}\n\nexport type NatsHeadersInit = Record<string, string> | NatsHeaders | undefined\n\nexport interface NatsPublishOptions {\n  headers?: NatsHeadersInit\n}\n\nexport interface NatsRequestOptions {\n  timeoutMs?: number\n  headers?: NatsHeadersInit\n}\n\nexport interface NatsSubscriptionHandle {\n  readonly subscription: Subscription\n  unsubscribe(): void\n}\n\nexport type NatsStatus =\n  | 'connecting'\n  | 'connected'\n  | 'disconnected'\n  | 'reconnecting'\n  | 'closed'\n  | 'error'\n\nexport interface NatsStatusEvent {\n  status: NatsStatus\n  data?: unknown\n}\n\nexport interface NatsClient {\n  connect(): Promise<void>\n  close(): Promise<void>\n\n  isConnected(): boolean\n\n  publishBytes(subject: string, payload: Uint8Array, options?: NatsPublishOptions): void\n  publishString(subject: string, payload: string, options?: NatsPublishOptions): void\n  publishJson<T>(subject: string, payload: T, options?: NatsPublishOptions): void\n\n  requestBytes(subject: string, payload: Uint8Array, options?: NatsRequestOptions): Promise<Msg>\n  requestString(subject: string, payload: string, options?: NatsRequestOptions): Promise<string>\n  requestJson<TResponse, TRequest = unknown>(\n    subject: string,\n    payload: TRequest,\n    options?: NatsRequestOptions,\n  ): Promise<TResponse>\n\n  subscribeBytes(\n    subject: string,\n    onMessage: (msg: Msg) => void | Promise<void>,\n    options?: NatsSubscribeOptions,\n  ): NatsSubscriptionHandle\n  subscribeString(\n    subject: string,\n    onMessage: (payload: string, msg: Msg) => void | Promise<void>,\n    options?: NatsSubscribeOptions,\n  ): NatsSubscriptionHandle\n  subscribeJson<T>(\n    subject: string,\n    onMessage: (payload: T, msg: Msg) => void | Promise<void>,\n    options?: NatsSubscribeOptions,\n  ): NatsSubscriptionHandle\n\n  /**\n   * Subscribe to a JetStream subject via an ephemeral OrderedConsumer (no acks).\n   * Use `optStartSeq` with `deliverPolicy: 'byStartSequence'` to resume from a known offset,\n   * or `deliverPolicy: 'new'` to live-tail.\n   */\n  subscribeJetStreamOrdered(\n    onMessage: (msg: JsMsg) => void | Promise<void>,\n    options: JetStreamOrderedSubscribeOptions,\n  ): Promise<JetStreamSubscriptionHandle>\n\n  onStatus(listener: (event: NatsStatusEvent) => void): () => void\n}\n\nfunction assertClientSide(): void {\n  // This wrapper is meant for browser/Tauri usage via WebSockets.\n  // Keep it safe to import from Next.js server bundles by throwing only when used.\n  if (typeof window === 'undefined') {\n    throw new Error('NATS client can only connect from the browser/runtime with WebSocket support (window is undefined).')\n  }\n}\n\nasync function importNats(): Promise<typeof import('nats.ws')> {\n  // Browser/Tauri only: always use the websocket client (no Node-only deps).\n  return await import('nats.ws')\n}\n\nfunction toNatsHeaders(nats: typeof import('nats.ws'), init: NatsHeadersInit): NatsHeaders | undefined {\n  if (!init) return undefined\n  if (typeof (init as NatsHeaders).get === 'function') return init as NatsHeaders\n\n  const h = nats.headers()\n  for (const [k, v] of Object.entries(init as Record<string, string>)) {\n    if (v !== undefined && v !== null) h.set(k, String(v))\n  }\n  return h\n}\n\n/** Returns a cryptographically random float in [0, 1). */\nfunction cryptoRandom(): number {\n  const buf = new Uint32Array(1)\n  crypto.getRandomValues(buf)\n  return buf[0] / (0xffffffff + 1)\n}\n\ninterface ExponentialBackoffHandle {\n  handler: () => number\n  reset: () => void\n}\n\nfunction createExponentialBackoffHandler(opts: NonNullable<NatsClientOptions['exponentialBackoff']>): ExponentialBackoffHandle {\n  const initialDelay = opts.initialDelayMs ?? 1000\n  const maxDelay = opts.maxDelayMs ?? 30_000\n  const multiplier = opts.multiplier ?? 2\n  const jitter = opts.jitter ?? true\n\n  let attempt = 0\n\n  return {\n    handler: (): number => {\n      const delay = Math.min(initialDelay * multiplier ** attempt, maxDelay)\n      attempt++\n      return jitter ? delay * (0.5 + cryptoRandom() * 0.5) : delay\n    },\n    reset: () => {\n      attempt = 0\n    },\n  }\n}\n\nfunction mapOptionsToConnectionOptions(\n  opts: NatsClientOptions,\n  backoff?: ExponentialBackoffHandle,\n): ConnectionOptions {\n  return {\n    servers: opts.servers,\n    name: opts.name,\n    token: opts.token,\n    user: opts.user,\n    pass: opts.pass,\n    timeout: opts.connectTimeoutMs ?? 15000,\n    reconnect: opts.reconnect ?? true,\n    maxReconnectAttempts: opts.maxReconnectAttempts,\n    reconnectTimeWait: opts.reconnectTimeWaitMs,\n    reconnectDelayHandler: backoff?.handler,\n    pingInterval: opts.pingIntervalMs,\n    maxPingOut: opts.maxPingOut,\n    inboxPrefix: opts.inboxPrefix,\n  }\n}\n\nfunction mapNatsTypeToStatus(type: unknown): NatsStatus | null {\n  const t = String(type).toLowerCase()\n  if (t.includes('disconnect')) return 'disconnected'\n  if (t === 'reconnecting') return 'reconnecting'\n  if (t === 'reconnect' || t.includes('connect')) return 'connected'\n  if (t.includes('error')) return 'error'\n  if (t.includes('close')) return 'closed'\n  return null\n}\n\nexport function createNatsClient(options: NatsClientOptions): NatsClient {\n  let nc: NatsConnection | null = null\n  let statusLoopAbort: AbortController | null = null\n  let connectInFlight: Promise<void> | null = null\n\n  const backoff = options.exponentialBackoff\n    ? createExponentialBackoffHandler(options.exponentialBackoff)\n    : undefined\n\n  const statusListeners = new Set<(event: NatsStatusEvent) => void>()\n\n  function emitStatus(event: NatsStatusEvent) {\n    for (const listener of statusListeners) {\n      try {\n        listener(event)\n      } catch {\n        // ignore listener failures\n      }\n    }\n  }\n\n  async function connect(): Promise<void> {\n    if (nc && !nc.isClosed()) return\n    if (connectInFlight) return connectInFlight\n    assertClientSide()\n\n    connectInFlight = (async () => {\n      try {\n        emitStatus({ status: 'connecting' })\n\n        const nats = await importNats()\n        const conn = await nats.connect(mapOptionsToConnectionOptions(options, backoff))\n        nc = conn\n\n        emitStatus({ status: 'connected' })\n\n        statusLoopAbort = new AbortController()\n        const signal = statusLoopAbort.signal\n\n        ;(async () => {\n          try {\n            for await (const s of conn.status()) {\n              if (signal.aborted) return\n              const mapped = mapNatsTypeToStatus((s as any)?.type)\n              if (mapped) {\n                if (mapped === 'connected' && backoff) {\n                  backoff.reset()\n                }\n                emitStatus({ status: mapped, data: (s as any)?.data })\n                if (mapped === 'closed') {\n                  nc = null\n                }\n              }\n            }\n          } catch (e) {\n            if (!signal.aborted) {\n              emitStatus({ status: 'error', data: e })\n              \n              if (nc === conn && conn.isClosed()) {\n                nc = null\n                emitStatus({ status: 'closed' })\n              }\n            }\n          }\n        })().catch(() => {\n          // ignore\n        })\n      } finally {\n        connectInFlight = null\n      }\n    })()\n\n    return connectInFlight\n  }\n\n  async function close(): Promise<void> {\n    const conn = nc\n    nc = null\n\n    if (statusLoopAbort) {\n      try {\n        statusLoopAbort.abort()\n      } catch {\n        // ignore\n      }\n      statusLoopAbort = null\n    }\n\n    if (!conn) return\n    try {\n      await conn.drain()\n    } finally {\n      try {\n        await conn.close()\n      } finally {\n        emitStatus({ status: 'closed' })\n      }\n    }\n  }\n\n  function requireConnection(): NatsConnection {\n    if (!nc) throw new Error('NATS is not connected. Call client.connect() first.')\n    return nc\n  }\n\n  function isConnected(): boolean {\n    return Boolean(nc) && !nc!.isClosed()\n  }\n\n  function publishBytes(subject: string, payload: Uint8Array, opts?: NatsPublishOptions): void {\n    const conn = requireConnection()\n    ;(async () => {\n      const nats = await importNats()\n      conn.publish(subject, payload, { headers: toNatsHeaders(nats, opts?.headers) })\n    })().catch((e) => emitStatus({ status: 'error', data: e }))\n  }\n\n  function publishString(subject: string, payload: string, opts?: NatsPublishOptions): void {\n    ;(async () => {\n      const nats = await importNats()\n      const sc = nats.StringCodec()\n      publishBytes(subject, sc.encode(payload), opts)\n    })().catch((e) => emitStatus({ status: 'error', data: e }))\n  }\n\n  function publishJson<T>(subject: string, payload: T, opts?: NatsPublishOptions): void {\n    ;(async () => {\n      const nats = await importNats()\n      const jc = nats.JSONCodec<T>()\n      publishBytes(subject, jc.encode(payload), opts)\n    })().catch((e) => emitStatus({ status: 'error', data: e }))\n  }\n\n  async function requestBytes(subject: string, payload: Uint8Array, opts?: NatsRequestOptions): Promise<Msg> {\n    const conn = requireConnection()\n    const nats = await importNats()\n    const msg = await conn.request(subject, payload, {\n      timeout: opts?.timeoutMs ?? 2000,\n      headers: toNatsHeaders(nats, opts?.headers),\n    })\n    return msg\n  }\n\n  async function requestString(subject: string, payload: string, opts?: NatsRequestOptions): Promise<string> {\n    const nats = await importNats()\n    const sc = nats.StringCodec()\n    const msg = await requestBytes(subject, sc.encode(payload), opts)\n    return sc.decode(msg.data)\n  }\n\n  async function requestJson<TResponse, TRequest = unknown>(\n    subject: string,\n    payload: TRequest,\n    opts?: NatsRequestOptions,\n  ): Promise<TResponse> {\n    const nats = await importNats()\n    const reqCodec = nats.JSONCodec<TRequest>()\n    const resCodec = nats.JSONCodec<TResponse>()\n    const msg = await requestBytes(subject, reqCodec.encode(payload), opts)\n    return resCodec.decode(msg.data)\n  }\n\n  function subscribeBytes(\n    subject: string,\n    onMessage: (msg: Msg) => void | Promise<void>,\n    opts?: NatsSubscribeOptions,\n  ): NatsSubscriptionHandle {\n    const conn = requireConnection()\n    const sub = conn.subscribe(subject, { queue: opts?.queue })\n    if (typeof opts?.max === 'number') sub.unsubscribe(opts.max)\n\n    const abortController = new AbortController()\n    const signal = opts?.signal ?? abortController.signal\n\n    ;(async () => {\n      try {\n        for await (const msg of sub) {\n          if (signal.aborted) break\n          await onMessage(msg)\n        }\n      } catch (e) {\n        emitStatus({ status: 'error', data: e })\n      } finally {\n        try {\n          sub.unsubscribe()\n        } catch {\n          // ignore\n        }\n      }\n    })().catch((e) => emitStatus({ status: 'error', data: e }))\n\n    return {\n      subscription: sub,\n      unsubscribe() {\n        try {\n          abortController.abort()\n        } catch {\n          // ignore\n        }\n        try {\n          sub.unsubscribe()\n        } catch {\n          // ignore\n        }\n      },\n    }\n  }\n\n  function subscribeString(\n    subject: string,\n    onMessage: (payload: string, msg: Msg) => void | Promise<void>,\n    opts?: NatsSubscribeOptions,\n  ): NatsSubscriptionHandle {\n    return subscribeBytes(\n      subject,\n      async (msg) => {\n        const nats = await importNats()\n        const sc = nats.StringCodec()\n        await onMessage(sc.decode(msg.data), msg)\n      },\n      opts,\n    )\n  }\n\n  function subscribeJson<T>(\n    subject: string,\n    onMessage: (payload: T, msg: Msg) => void | Promise<void>,\n    opts?: NatsSubscribeOptions,\n  ): NatsSubscriptionHandle {\n    return subscribeBytes(\n      subject,\n      async (msg) => {\n        const nats = await importNats()\n        const jc = nats.JSONCodec<T>()\n        await onMessage(jc.decode(msg.data), msg)\n      },\n      opts,\n    )\n  }\n\n  async function subscribeJetStreamOrdered(\n    onMessage: (msg: JsMsg) => void | Promise<void>,\n    opts: JetStreamOrderedSubscribeOptions,\n  ): Promise<JetStreamSubscriptionHandle> {\n    const conn = requireConnection()\n    if (opts.signal?.aborted) {\n      return { unsubscribe() {} }\n    }\n\n    const nats = await importNats()\n    if (opts.signal?.aborted) {\n      return { unsubscribe() {} }\n    }\n\n    const inactiveThresholdNs =\n      (opts.inactiveThresholdMs ?? 5 * 60_000) * 1_000_000\n\n    const js = conn.jetstream()\n    const consumer: Consumer = await js.consumers.get(opts.streamName, {\n      filterSubjects: opts.filterSubject,\n      deliver_policy: nats.DeliverPolicy.StartSequence,\n      opt_start_seq: opts.optStartSeq ?? 0,\n      inactive_threshold: inactiveThresholdNs,\n    })\n\n    const iterRef: { current: ConsumerMessages | null } = { current: null }\n    let closed = false\n\n    const onAbort = () => {\n      void teardown()\n    }\n    opts.signal?.addEventListener('abort', onAbort, { once: true })\n\n    async function teardown(): Promise<void> {\n      if (closed) return\n      closed = true\n      opts.signal?.removeEventListener('abort', onAbort)\n      const iter = iterRef.current\n      iterRef.current = null\n      if (iter) {\n        try {\n          await iter.close()\n        } catch {\n          // ignore\n        }\n      }\n    }\n\n    if (opts.signal?.aborted) {\n      void teardown()\n      return { unsubscribe() {} }\n    }\n\n    ;(async () => {\n      try {\n        const iter = await consumer.consume()\n        if (closed) {\n          try {\n            await iter.close()\n          } catch {\n            // ignore\n          }\n          return\n        }\n        iterRef.current = iter\n        for await (const msg of iter) {\n          if (closed) break\n          try {\n            await onMessage(msg)\n          } catch (e) {\n            emitStatus({ status: 'error', data: e })\n          }\n        }\n      } catch (e) {\n        if (!closed) emitStatus({ status: 'error', data: e })\n      }\n    })().catch((e) => emitStatus({ status: 'error', data: e }))\n\n    return {\n      unsubscribe() {\n        void teardown()\n      },\n    }\n  }\n\n  function onStatus(listener: (event: NatsStatusEvent) => void): () => void {\n    statusListeners.add(listener)\n    return () => statusListeners.delete(listener)\n  }\n\n  return {\n    connect,\n    close,\n    isConnected,\n    publishBytes,\n    publishString,\n    publishJson,\n    requestBytes,\n    requestString,\n    requestJson,\n    subscribeBytes,\n    subscribeString,\n    subscribeJson,\n    subscribeJetStreamOrdered,\n    onStatus,\n  }\n}\n","import { createNatsClient, type NatsClient, type NatsStatus, type NatsStatusEvent } from './nats'\n\nexport const NATS_DEFAULTS = {\n  SHARED_CLOSE_DELAY_MS: 3000,\n  CONNECT_TIMEOUT_MS: 10_000,\n  PING_INTERVAL_MS: 30_000,\n  MAX_PING_OUT: 3,\n  RETRY_INITIAL_DELAY_MS: 1000,\n  RETRY_MAX_DELAY_MS: 30_000,\n  RETRY_MULTIPLIER: 2,\n} as const\n\nexport interface NatsReconnectionBackoff {\n  /** Number of fast retries before exponential phase kicks in. Default: 0. */\n  fastRetries?: number\n  /** Delay used during the fast-retry phase. Default: RETRY_INITIAL_DELAY_MS. */\n  fastRetryDelayMs?: number\n  /** Base delay for the exponential phase. Default: RETRY_INITIAL_DELAY_MS. */\n  initialDelayMs?: number\n  /** Upper cap on any single retry delay. Default: RETRY_MAX_DELAY_MS. */\n  maxDelayMs?: number\n  /** Per-attempt multiplier during exponential phase. Default: RETRY_MULTIPLIER. */\n  multiplier?: number\n}\n\nexport interface SharedConnection {\n  wsUrl: string\n  client: NatsClient\n  connectPromise: Promise<void> | null\n  refCount: number\n  closeTimer: ReturnType<typeof setTimeout> | null\n  retryTimer: ReturnType<typeof setTimeout> | null\n  /**\n   * Identity of the consumer driving reconnect. When set, other consumers\n   * should observe status only and skip their own scheduleRetry — otherwise\n   * each disconnect triggers multiple concurrent connect() calls racing over\n   * connectPromise.\n   */\n  retryOwner: object | null\n}\n\nexport interface AcquireClientOptions {\n  name?: string\n  user?: string\n  pass?: string\n  connectTimeoutMs?: number\n  pingIntervalMs?: number\n  maxPingOut?: number\n}\n\nexport interface ReleaseClientOptions {\n  delayMs?: number\n}\n\n// One shared connection PER URL. The previous single-slot implementation\n// force-closed whatever was connected the moment any consumer acquired a\n// DIFFERENT URL — even with live refs on it. With two chat surfaces on\n// distinct endpoints (`/ws/nats` client chat vs `/ws/nats-api` dashboard)\n// mounted at once, each acquire killed the other's socket, and the loser's\n// retry loop self-cancelled (connection identity mismatch) leaving a dead\n// subscription that silently received nothing.\nconst connections = new Map<string, SharedConnection>()\n\n/** Legacy accessor from the single-slot era: returns the first live shared\n *  connection, or null. With MULTIPLE URLs connected (e.g. `/ws/nats` client\n *  chat + `/ws/nats-api` dashboard mounted together) \"first\" is whichever\n *  surface acquired first — an arbitrary, mount-order-dependent answer.\n *  Prefer `getSharedConnectionFor(url)`; this stays only for external\n *  registry-pinned consumers of the old single-connection API. */\nexport function getSharedConnection(): SharedConnection | null {\n  const first = connections.values().next()\n  return first.done ? null : first.value\n}\n\nexport function acquireClient(url: string, opts?: AcquireClientOptions): SharedConnection {\n  let conn = connections.get(url)\n\n  if (!conn) {\n    const {\n      name = 'openframe-frontend',\n      user = 'machine',\n      pass = '',\n      connectTimeoutMs = NATS_DEFAULTS.CONNECT_TIMEOUT_MS,\n      pingIntervalMs = NATS_DEFAULTS.PING_INTERVAL_MS,\n      maxPingOut = NATS_DEFAULTS.MAX_PING_OUT,\n    } = opts ?? {}\n\n    const client = createNatsClient({\n      servers: url,\n      name,\n      user,\n      pass,\n      connectTimeoutMs,\n      reconnect: false,\n      pingIntervalMs,\n      maxPingOut,\n    })\n\n    conn = {\n      wsUrl: url,\n      client,\n      connectPromise: null,\n      refCount: 0,\n      closeTimer: null,\n      retryTimer: null,\n      retryOwner: null,\n    }\n    connections.set(url, conn)\n  }\n\n  conn.refCount += 1\n  if (conn.closeTimer) {\n    clearTimeout(conn.closeTimer)\n    conn.closeTimer = null\n  }\n  return conn\n}\n\nexport function releaseClient(url: string, opts?: ReleaseClientOptions): void {\n  const conn = connections.get(url)\n  if (!conn) return\n\n  conn.refCount = Math.max(0, conn.refCount - 1)\n  if (conn.refCount > 0) return\n\n  const delay = opts?.delayMs ?? NATS_DEFAULTS.SHARED_CLOSE_DELAY_MS\n  conn.closeTimer = setTimeout(() => {\n    conn.closeTimer = null\n    // A new acquire may have raced in during the grace period.\n    if (conn.refCount > 0) return\n    if (connections.get(url) === conn) {\n      connections.delete(url)\n    }\n    if (conn.retryTimer) {\n      clearTimeout(conn.retryTimer)\n      conn.retryTimer = null\n    }\n    void conn.client.close().catch(() => {})\n  }, delay)\n}\n\nexport function getSharedConnectionFor(url: string | null | undefined): SharedConnection | null {\n  if (!url) return null\n  return connections.get(url) ?? null\n}\n\n// ---------------------------------------------------------------------------\n// Connection lifecycle: retry + status loop, shared by NatsProvider and the\n// chat hooks. Each consumer that wants to drive reconnect creates an\n// ownerToken and calls startConnectionLifecycle(). The first caller to claim\n// retryOwner runs the actual retry loop; subsequent claimants observe status\n// only. When the owner unmounts and releases retryOwner, the next status\n// event lets a surviving consumer pick up ownership opportunistically.\n// ---------------------------------------------------------------------------\n\nexport interface ConnectionLifecycleOptions {\n  conn: SharedConnection\n  wsUrl: string\n  onBeforeReconnect?: () => Promise<void> | void\n  backoff?: NatsReconnectionBackoff\n  getFreshUrl: () => string | null\n  /** Called on every status change (after closed-guard). */\n  onStatusChange?: (status: NatsStatus, evt: NatsStatusEvent) => void\n  /**\n   * Decide which statuses should trigger a retry attempt. Defaults to closed +\n   * disconnected. Override to skip 'error' (JetStream protocol errors that\n   * don't close the WS) or include it.\n   */\n  shouldRetryOn?: (status: NatsStatus) => boolean\n}\n\nexport interface ConnectionLifecycleHandle {\n  /** Stop observing status, clear any pending retry, release ownership if held. */\n  stop(): void\n}\n\nconst defaultShouldRetryOn = (status: NatsStatus) => status === 'closed' || status === 'disconnected'\n\nexport function startConnectionLifecycle(options: ConnectionLifecycleOptions): ConnectionLifecycleHandle {\n  const { conn, wsUrl } = options\n  // Each lifecycle gets its own identity for retry ownership. The first lifecycle to claim\n  // an unowned connection drives reconnect; later attachers observe status only until the\n  // owner releases (see opportunistic claim in scheduleRetry).\n  const ownerToken = {}\n  if (!conn.retryOwner) conn.retryOwner = ownerToken\n\n  let closed = false\n  let retryAttempt = 0\n\n  function emitSynthetic(status: NatsStatus) {\n    if (closed) return\n    options.onStatusChange?.(status, { status })\n    if (status === 'connected') {\n      retryAttempt = 0\n    }\n  }\n\n  function scheduleRetry() {\n    if (closed) return\n    if (getSharedConnectionFor(wsUrl) !== conn) return\n    if (!conn.retryOwner) conn.retryOwner = ownerToken\n    if (conn.retryOwner !== ownerToken) return\n\n    if (conn.retryTimer) {\n      clearTimeout(conn.retryTimer)\n      conn.retryTimer = null\n    }\n\n    const cfg = options.backoff ?? {}\n    const fastRetries = cfg.fastRetries ?? 0\n    const fastDelay = cfg.fastRetryDelayMs ?? NATS_DEFAULTS.RETRY_INITIAL_DELAY_MS\n    const baseDelay = cfg.initialDelayMs ?? NATS_DEFAULTS.RETRY_INITIAL_DELAY_MS\n    const maxDelay = cfg.maxDelayMs ?? NATS_DEFAULTS.RETRY_MAX_DELAY_MS\n    const multiplier = cfg.multiplier ?? NATS_DEFAULTS.RETRY_MULTIPLIER\n\n    const delay =\n      retryAttempt < fastRetries\n        ? fastDelay\n        : Math.min(baseDelay * multiplier ** (retryAttempt - fastRetries), maxDelay)\n    const jitteredDelay = delay * (0.5 + Math.random() * 0.5)\n    retryAttempt++\n\n    conn.retryTimer = setTimeout(async () => {\n      conn.retryTimer = null\n      if (closed) return\n      if (getSharedConnectionFor(wsUrl) !== conn) return\n\n      try {\n        await options.onBeforeReconnect?.()\n      } catch {\n        // continue regardless of token-refresh outcome\n      }\n      if (closed) return\n      if (getSharedConnectionFor(wsUrl) !== conn) return\n\n      const freshUrl = options.getFreshUrl()\n      if (freshUrl !== wsUrl) return\n\n      try {\n        conn.connectPromise = null\n        conn.connectPromise = conn.client.connect()\n        await conn.connectPromise\n        if (!closed && getSharedConnectionFor(wsUrl) === conn) {\n          retryAttempt = 0\n        }\n      } catch {\n        conn.connectPromise = null\n        if (!closed && getSharedConnectionFor(wsUrl) === conn) {\n          scheduleRetry()\n        }\n      }\n    }, jitteredDelay)\n  }\n\n  const shouldRetryOn = options.shouldRetryOn ?? defaultShouldRetryOn\n\n  const unsubStatus = conn.client.onStatus((evt) => {\n    if (closed) return\n    options.onStatusChange?.(evt.status, evt)\n    if (evt.status === 'connected') {\n      retryAttempt = 0\n    }\n    if (shouldRetryOn(evt.status)) {\n      scheduleRetry()\n    }\n  })\n\n  if (conn.client.isConnected()) {\n    emitSynthetic('connected')\n  }\n\n  void (async () => {\n    try {\n      conn.connectPromise ||= conn.client.connect()\n      await conn.connectPromise\n    } catch {\n      conn.connectPromise = null\n      if (closed) return\n\n      emitSynthetic('disconnected')\n      scheduleRetry()\n    }\n  })()\n\n  return {\n    stop() {\n      closed = true\n      unsubStatus()\n      if (conn.retryTimer) {\n        clearTimeout(conn.retryTimer)\n        conn.retryTimer = null\n      }\n      if (conn.retryOwner === ownerToken) {\n        conn.retryOwner = null\n      }\n    },\n  }\n}\n","'use client'\n\nimport * as React from 'react'\nimport type { NatsClient, NatsStatus } from './nats'\nimport {\n  acquireClient,\n  releaseClient,\n  startConnectionLifecycle,\n  type AcquireClientOptions,\n  type NatsReconnectionBackoff,\n} from './shared-connection'\n\nexport type { NatsReconnectionBackoff } from './shared-connection'\n\nexport interface NatsProviderProps {\n  children: React.ReactNode\n  /** Return the current NATS WebSocket URL (or null when not yet available, e.g. unauthenticated). */\n  getWsUrl: () => string | null\n  /** Called before each reconnect attempt. */\n  onBeforeReconnect?: () => Promise<void> | void\n  clientConfig?: AcquireClientOptions\n  reconnectionBackoff?: NatsReconnectionBackoff\n  /**\n   * Bump this to force re-evaluating `getWsUrl()` (e.g. when auth state flips).\n   * Provider does not subscribe to external auth state by itself.\n   */\n  urlRevision?: unknown\n}\n\nexport interface NatsContextValue {\n  client: NatsClient | null\n  status: NatsStatus\n  isReady: boolean\n  reconnectionCount: number\n}\n\nconst NatsContext = React.createContext<NatsContextValue | null>(null)\n\nexport function NatsProvider({\n  children,\n  getWsUrl,\n  onBeforeReconnect,\n  clientConfig,\n  reconnectionBackoff,\n  urlRevision,\n}: NatsProviderProps) {\n  const [client, setClient] = React.useState<NatsClient | null>(null)\n  const [status, setStatus] = React.useState<NatsStatus>('closed')\n  const [reconnectionCount, setReconnectionCount] = React.useState(0)\n\n  const getWsUrlRef = React.useRef(getWsUrl)\n  React.useEffect(() => {\n    getWsUrlRef.current = getWsUrl\n  }, [getWsUrl])\n\n  const onBeforeReconnectRef = React.useRef(onBeforeReconnect)\n  React.useEffect(() => {\n    onBeforeReconnectRef.current = onBeforeReconnect\n  }, [onBeforeReconnect])\n\n  const reconnectionBackoffRef = React.useRef(reconnectionBackoff)\n  React.useEffect(() => {\n    reconnectionBackoffRef.current = reconnectionBackoff\n  }, [reconnectionBackoff])\n\n  const clientConfigRef = React.useRef(clientConfig)\n  React.useEffect(() => {\n    clientConfigRef.current = clientConfig\n  }, [clientConfig])\n\n  const heldUrlRef = React.useRef<string | null>(null)\n  const hadConnectionBeforeRef = React.useRef(false)\n\n  React.useEffect(() => {\n    const wsUrl = getWsUrlRef.current()\n\n    if (!wsUrl) {\n      if (heldUrlRef.current) {\n        releaseClient(heldUrlRef.current)\n        heldUrlRef.current = null\n        setClient(null)\n        setStatus('closed')\n      }\n      return\n    }\n\n    if (heldUrlRef.current && heldUrlRef.current !== wsUrl) {\n      releaseClient(heldUrlRef.current)\n      heldUrlRef.current = null\n    }\n\n    const conn = acquireClient(wsUrl, clientConfigRef.current)\n    heldUrlRef.current = wsUrl\n    setClient(conn.client)\n    setStatus(conn.client.isConnected() ? 'connected' : 'connecting')\n\n    const lifecycle = startConnectionLifecycle({\n      conn,\n      wsUrl,\n      onBeforeReconnect: () => onBeforeReconnectRef.current?.(),\n      backoff: reconnectionBackoffRef.current,\n      getFreshUrl: () => getWsUrlRef.current(),\n      onStatusChange: (newStatus) => {\n        if (newStatus === 'error') return\n        setStatus(newStatus)\n        if (newStatus === 'connected') {\n          if (hadConnectionBeforeRef.current) {\n            setReconnectionCount((c) => c + 1)\n          }\n          hadConnectionBeforeRef.current = true\n        }\n      },\n    })\n\n    return () => {\n      lifecycle.stop()\n      if (heldUrlRef.current) {\n        releaseClient(heldUrlRef.current)\n        heldUrlRef.current = null\n      }\n      setClient(null)\n      setStatus('closed')\n    }\n  }, [urlRevision])\n\n  const value = React.useMemo<NatsContextValue>(\n    () => ({\n      client,\n      status,\n      isReady: status === 'connected' && client !== null,\n      reconnectionCount,\n    }),\n    [client, status, reconnectionCount],\n  )\n\n  return <NatsContext.Provider value={value}>{children}</NatsContext.Provider>\n}\n\nexport function useNats(): NatsContextValue {\n  const ctx = React.useContext(NatsContext)\n  if (!ctx) throw new Error('useNats must be used inside <NatsProvider>')\n  return ctx\n}\n\nexport function useOptionalNats(): NatsContextValue | null {\n  return React.useContext(NatsContext)\n}\n","'use client'\n\nimport * as React from 'react'\nimport type { JsMsg, Msg, NatsSubscribeOptions } from './nats'\nimport { useOptionalNats } from './nats-provider'\n\nexport interface UseNatsSubscriptionOptions extends NatsSubscribeOptions {\n  enabled?: boolean\n}\n\nexport interface UseNatsSubscriptionReturn {\n  isSubscribed: boolean\n  isReady: boolean\n}\n\n/**\n * Subscribe to a NATS subject using the shared connection from <NatsProvider>.\n * Automatically (re)subscribes when the connection becomes ready, when the\n * subject changes, and after reconnections.\n */\nexport function useNatsSubscription(\n  subject: string | null,\n  onMessage: (msg: Msg) => void | Promise<void>,\n  options?: UseNatsSubscriptionOptions,\n): UseNatsSubscriptionReturn {\n  const nats = useOptionalNats()\n  const handlerRef = React.useRef(onMessage)\n  React.useEffect(() => {\n    handlerRef.current = onMessage\n  }, [onMessage])\n\n  const [isSubscribed, setIsSubscribed] = React.useState(false)\n\n  const enabled = options?.enabled !== false\n  const queue = options?.queue\n  const max = options?.max\n  const reconnectionCount = nats?.reconnectionCount ?? 0\n  const isReady = !!nats?.isReady\n  const client = nats?.client ?? null\n\n  React.useEffect(() => {\n    if (!client || !isReady || !subject || !enabled) {\n      setIsSubscribed(false)\n      return\n    }\n\n    const sub = client.subscribeBytes(\n      subject,\n      (msg) => handlerRef.current(msg),\n      { queue, max },\n    )\n    setIsSubscribed(true)\n\n    return () => {\n      setIsSubscribed(false)\n      try {\n        sub.unsubscribe()\n      } catch {\n        // ignore\n      }\n    }\n    // reconnectionCount intentionally in deps: re-subscribe after reconnect\n  }, [client, isReady, subject, enabled, queue, max, reconnectionCount])\n\n  return { isSubscribed, isReady }\n}\n\nexport type UseNatsJsonSubscriptionOptions = UseNatsSubscriptionOptions\n\nexport function useNatsJsonSubscription<T = unknown>(\n  subject: string | null,\n  onPayload: (payload: T, msg: Msg) => void | Promise<void>,\n  options?: UseNatsJsonSubscriptionOptions,\n): UseNatsSubscriptionReturn {\n  const handlerRef = React.useRef(onPayload)\n  React.useEffect(() => {\n    handlerRef.current = onPayload\n  }, [onPayload])\n\n  const decoderRef = React.useRef<TextDecoder | null>(null)\n  if (!decoderRef.current && typeof TextDecoder !== 'undefined') {\n    decoderRef.current = new TextDecoder()\n  }\n\n  const wrapped = React.useCallback(async (msg: Msg) => {\n    const decoder = decoderRef.current\n    if (!decoder) return\n    try {\n      const parsed = JSON.parse(decoder.decode(msg.data)) as T\n      await handlerRef.current(parsed, msg)\n    } catch {\n      // ignore malformed payloads\n    }\n  }, [])\n\n  return useNatsSubscription(subject, wrapped, options)\n}\n\nexport type NatsJsMsg = JsMsg\n"],"mappings":"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","names":["React"]}

package/dist/{chunk-2CJ734N2.cjs → chunk-PTT4J5GF.cjs}

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }"use client";
 
 
-var _chunk7CZ4MJSIcjs = require('./chunk-7CZ4MJSI.cjs');
+var _chunkVIJARDBMcjs = require('./chunk-VIJARDBM.cjs');
 
 // src/hooks/use-self-fetch.ts
 var _react = require('react');
@@ -29,7 +29,7 @@ function useSelfFetch(url, options) {
       try {
         setIsLoading(true);
         setError(false);
-        const res = await _chunk7CZ4MJSIcjs.contentFetch.call(void 0, url, { signal: ctrl.signal });
+        const res = await _chunkVIJARDBMcjs.contentFetch.call(void 0, url, { signal: ctrl.signal });
         if (!res.ok) throw new Error(`Request failed (${res.status})`);
         const json = await res.json();
         if (!cancelled) {
@@ -78,4 +78,4 @@ function useSelfFetch(url, options) {
 
 
 exports.useSelfFetch = useSelfFetch;
-//# sourceMappingURL=chunk-2CJ734N2.cjs.map
+//# sourceMappingURL=chunk-PTT4J5GF.cjs.map

package/dist/{chunk-2CJ734N2.cjs.map → chunk-PTT4J5GF.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-2CJ734N2.cjs","../src/hooks/use-self-fetch.ts"],"names":[],"mappings":"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","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-2CJ734N2.cjs","sourcesContent":[null,"'use client'\n\nimport { useEffect, useRef, useState, type Dispatch, type SetStateAction } from 'react'\nimport { contentFetch } from '../utils/embed-content-fetch'\n\nexport interface UseSelfFetchResult<T> {\n  data: T | null\n  /** Imperatively patch the fetched data (e.g. optimistic vote updates). */\n  setData: Dispatch<SetStateAction<T | null>>\n  isLoading: boolean\n  error: boolean\n  /** Re-run the fetch (error-retry affordance). */\n  reload: () => void\n}\n\n/**\n * The single source for the 4 self-fetching content views\n * (`ProductReleasesView`, `RoadmapView`, the onboarding catalog/detail). GETs a\n * configured `url` into component state with **plain `fetch` + `useEffect`** —\n * deliberately NO react-query, so embedders don't need a QueryClient. This is\n * the same technology choice the shipped `DeliveryLists` makes; that component\n * predates this hook and still hand-rolls the loop (a future pass can migrate\n * it onto a two-url variant of this hook).\n *\n * Behaviour:\n *   - `url = null` → fetching is DISABLED (controlled / SSR mode, or missing\n *     config); returns `initialData ?? null` and never fetches.\n *   - `initialData` provided → hydrates immediately and SKIPS the first fetch\n *     (so the hub's server-rendered data isn't re-fetched on mount); later\n *     `url` changes still re-fetch.\n *   - a `cancelled` guard ensures an in-flight response from a STALE `url`\n *     (e.g. a fast pagination / section toggle) can't overwrite a newer one.\n *   - `reload()` bumps an internal key to retry after an error.\n *   - `revalidateOnVisibleAfterMs` (opt-in) → re-fetch when the tab becomes\n *     visible AND the held data is older than the threshold. Event-driven\n *     freshness with ZERO background requests — the replacement for\n *     setInterval polling. Data age counts from the last completed fetch, or\n *     from mount when `initialData` seeded it (an SSR seed is milliseconds\n *     old — without that, the first refocus would always refire).\n *\n * Re-fetches whenever `url` changes, so callers fold all query params INTO the\n * url string (the url IS the cache key).\n */\nexport function useSelfFetch<T>(\n  url: string | null,\n  options?: { initialData?: T; revalidateOnVisibleAfterMs?: number },\n): UseSelfFetchResult<T> {\n  const initialData = options?.initialData\n  const revalidateOnVisibleAfterMs = options?.revalidateOnVisibleAfterMs\n  const [data, setData] = useState<T | null>(initialData ?? null)\n  const [isLoading, setIsLoading] = useState(initialData === undefined && url !== null)\n  const [error, setError] = useState(false)\n  const [reloadKey, setReloadKey] = useState(0)\n  // When the held data was obtained: seeded at mount for SSR-hydrated data,\n  // stamped after each completed fetch. Drives the visibility revalidation age\n  // check. 0 = nothing held yet (first visible event may fetch).\n  const dataAtRef = useRef<number>(initialData !== undefined ? Date.now() : 0)\n  // The url whose data we currently hold — seeded from SSR `initialData`, then set after\n  // each completed fetch. The effect skips the fetch when this equals `url` (so server-\n  // rendered data isn't re-fetched on mount). A VALUE compare (not a one-shot flag) so the\n  // SSR-hydration skip survives React 18 StrictMode's mount→unmount→remount in dev;\n  // `reload()` nulls it to force a re-fetch of the same url.\n  const dataUrlRef = useRef<string | null>(initialData !== undefined ? url : null)\n\n  // Re-sync when a CONTROLLED `initialData` changes (e.g. the host navigates\n  // between detail slugs without remounting). No-op in self-fetch mode, where\n  // `initialData` is `undefined`.\n  useEffect(() => {\n    if (initialData !== undefined) setData(initialData)\n  }, [initialData])\n\n  useEffect(() => {\n    if (url === null) {\n      setIsLoading(false)\n      return\n    }\n    // Already hold data for this exact url (SSR-hydrated, or a prior completed fetch) →\n    // skip. `reload()` clears `dataUrlRef` so a retry of the same url still fetches.\n    if (dataUrlRef.current === url) return\n    const ctrl = new AbortController()\n    let cancelled = false\n    async function load() {\n      try {\n        setIsLoading(true)\n        setError(false)\n        const res = await contentFetch(url as string, { signal: ctrl.signal })\n        if (!res.ok) throw new Error(`Request failed (${res.status})`)\n        const json = (await res.json()) as T\n        if (!cancelled) {\n          setData(json)\n          dataUrlRef.current = url // remember the url we now hold data for\n          dataAtRef.current = Date.now()\n        }\n      } catch (err) {\n        // AbortError on cleanup (unmount / stale-url change / React StrictMode's dev\n        // double-invoke) is EXPECTED — the request was intentionally aborted. Aborting\n        // also means the orphaned StrictMode fetch shows as \"cancelled\" instead of\n        // completing as a wasted duplicate (parity with useChatIdentity). Only real\n        // failures fall through to the error state + console.\n        if (cancelled || (err as Error)?.name === 'AbortError') return\n        setError(true)\n        console.error('useSelfFetch:', url, err)\n      } finally {\n        if (!cancelled) setIsLoading(false)\n      }\n    }\n    load()\n    return () => {\n      cancelled = true\n      ctrl.abort()\n    }\n    // `url` folds in every query param; `reloadKey` drives retry.\n  }, [url, reloadKey])\n\n  // ONE force-refetch mechanic shared by reload() and the visibility\n  // revalidation: clear the held-url skip, bump the effect key.\n  const forceReload = () => {\n    dataUrlRef.current = null\n    setReloadKey((k) => k + 1)\n  }\n\n  // Opt-in visibility-driven revalidation. Registered only when the option is\n  // set and fetching is enabled; SSR-safe (effects don't run on the server)\n  // and StrictMode-safe (idempotent listener, cleaned up per mount cycle).\n  useEffect(() => {\n    if (!revalidateOnVisibleAfterMs || url === null) return\n    const onVisible = () => {\n      if (document.visibilityState !== 'visible') return\n      if (Date.now() - dataAtRef.current < revalidateOnVisibleAfterMs) return\n      forceReload()\n    }\n    document.addEventListener('visibilitychange', onVisible)\n    return () => document.removeEventListener('visibilitychange', onVisible)\n  }, [url, revalidateOnVisibleAfterMs])\n\n  return {\n    data,\n    setData,\n    isLoading,\n    error,\n    // Force a re-fetch of the current url (error-retry affordance).\n    reload: forceReload,\n  }\n}\n"]}
+{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-PTT4J5GF.cjs","../src/hooks/use-self-fetch.ts"],"names":[],"mappings":"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","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-PTT4J5GF.cjs","sourcesContent":[null,"'use client'\n\nimport { useEffect, useRef, useState, type Dispatch, type SetStateAction } from 'react'\nimport { contentFetch } from '../utils/embed-content-fetch'\n\nexport interface UseSelfFetchResult<T> {\n  data: T | null\n  /** Imperatively patch the fetched data (e.g. optimistic vote updates). */\n  setData: Dispatch<SetStateAction<T | null>>\n  isLoading: boolean\n  error: boolean\n  /** Re-run the fetch (error-retry affordance). */\n  reload: () => void\n}\n\n/**\n * The single source for the 4 self-fetching content views\n * (`ProductReleasesView`, `RoadmapView`, the onboarding catalog/detail). GETs a\n * configured `url` into component state with **plain `fetch` + `useEffect`** —\n * deliberately NO react-query, so embedders don't need a QueryClient. This is\n * the same technology choice the shipped `DeliveryLists` makes; that component\n * predates this hook and still hand-rolls the loop (a future pass can migrate\n * it onto a two-url variant of this hook).\n *\n * Behaviour:\n *   - `url = null` → fetching is DISABLED (controlled / SSR mode, or missing\n *     config); returns `initialData ?? null` and never fetches.\n *   - `initialData` provided → hydrates immediately and SKIPS the first fetch\n *     (so the hub's server-rendered data isn't re-fetched on mount); later\n *     `url` changes still re-fetch.\n *   - a `cancelled` guard ensures an in-flight response from a STALE `url`\n *     (e.g. a fast pagination / section toggle) can't overwrite a newer one.\n *   - `reload()` bumps an internal key to retry after an error.\n *   - `revalidateOnVisibleAfterMs` (opt-in) → re-fetch when the tab becomes\n *     visible AND the held data is older than the threshold. Event-driven\n *     freshness with ZERO background requests — the replacement for\n *     setInterval polling. Data age counts from the last completed fetch, or\n *     from mount when `initialData` seeded it (an SSR seed is milliseconds\n *     old — without that, the first refocus would always refire).\n *\n * Re-fetches whenever `url` changes, so callers fold all query params INTO the\n * url string (the url IS the cache key).\n */\nexport function useSelfFetch<T>(\n  url: string | null,\n  options?: { initialData?: T; revalidateOnVisibleAfterMs?: number },\n): UseSelfFetchResult<T> {\n  const initialData = options?.initialData\n  const revalidateOnVisibleAfterMs = options?.revalidateOnVisibleAfterMs\n  const [data, setData] = useState<T | null>(initialData ?? null)\n  const [isLoading, setIsLoading] = useState(initialData === undefined && url !== null)\n  const [error, setError] = useState(false)\n  const [reloadKey, setReloadKey] = useState(0)\n  // When the held data was obtained: seeded at mount for SSR-hydrated data,\n  // stamped after each completed fetch. Drives the visibility revalidation age\n  // check. 0 = nothing held yet (first visible event may fetch).\n  const dataAtRef = useRef<number>(initialData !== undefined ? Date.now() : 0)\n  // The url whose data we currently hold — seeded from SSR `initialData`, then set after\n  // each completed fetch. The effect skips the fetch when this equals `url` (so server-\n  // rendered data isn't re-fetched on mount). A VALUE compare (not a one-shot flag) so the\n  // SSR-hydration skip survives React 18 StrictMode's mount→unmount→remount in dev;\n  // `reload()` nulls it to force a re-fetch of the same url.\n  const dataUrlRef = useRef<string | null>(initialData !== undefined ? url : null)\n\n  // Re-sync when a CONTROLLED `initialData` changes (e.g. the host navigates\n  // between detail slugs without remounting). No-op in self-fetch mode, where\n  // `initialData` is `undefined`.\n  useEffect(() => {\n    if (initialData !== undefined) setData(initialData)\n  }, [initialData])\n\n  useEffect(() => {\n    if (url === null) {\n      setIsLoading(false)\n      return\n    }\n    // Already hold data for this exact url (SSR-hydrated, or a prior completed fetch) →\n    // skip. `reload()` clears `dataUrlRef` so a retry of the same url still fetches.\n    if (dataUrlRef.current === url) return\n    const ctrl = new AbortController()\n    let cancelled = false\n    async function load() {\n      try {\n        setIsLoading(true)\n        setError(false)\n        const res = await contentFetch(url as string, { signal: ctrl.signal })\n        if (!res.ok) throw new Error(`Request failed (${res.status})`)\n        const json = (await res.json()) as T\n        if (!cancelled) {\n          setData(json)\n          dataUrlRef.current = url // remember the url we now hold data for\n          dataAtRef.current = Date.now()\n        }\n      } catch (err) {\n        // AbortError on cleanup (unmount / stale-url change / React StrictMode's dev\n        // double-invoke) is EXPECTED — the request was intentionally aborted. Aborting\n        // also means the orphaned StrictMode fetch shows as \"cancelled\" instead of\n        // completing as a wasted duplicate (parity with useChatIdentity). Only real\n        // failures fall through to the error state + console.\n        if (cancelled || (err as Error)?.name === 'AbortError') return\n        setError(true)\n        console.error('useSelfFetch:', url, err)\n      } finally {\n        if (!cancelled) setIsLoading(false)\n      }\n    }\n    load()\n    return () => {\n      cancelled = true\n      ctrl.abort()\n    }\n    // `url` folds in every query param; `reloadKey` drives retry.\n  }, [url, reloadKey])\n\n  // ONE force-refetch mechanic shared by reload() and the visibility\n  // revalidation: clear the held-url skip, bump the effect key.\n  const forceReload = () => {\n    dataUrlRef.current = null\n    setReloadKey((k) => k + 1)\n  }\n\n  // Opt-in visibility-driven revalidation. Registered only when the option is\n  // set and fetching is enabled; SSR-safe (effects don't run on the server)\n  // and StrictMode-safe (idempotent listener, cleaned up per mount cycle).\n  useEffect(() => {\n    if (!revalidateOnVisibleAfterMs || url === null) return\n    const onVisible = () => {\n      if (document.visibilityState !== 'visible') return\n      if (Date.now() - dataAtRef.current < revalidateOnVisibleAfterMs) return\n      forceReload()\n    }\n    document.addEventListener('visibilitychange', onVisible)\n    return () => document.removeEventListener('visibilitychange', onVisible)\n  }, [url, revalidateOnVisibleAfterMs])\n\n  return {\n    data,\n    setData,\n    isLoading,\n    error,\n    // Force a re-fetch of the current url (error-retry affordance).\n    reload: forceReload,\n  }\n}\n"]}