@flamingo-stack/openframe-frontend-core 0.0.691-snapshot.20261001154617 → 0.0.691

package/dist/{chunk-Z7QCNCBN.js → chunk-7WYWPELF.js}

@@ -1,14 +1,14 @@
 "use client";
 import {
   ContactForm
-} from "./chunk-TXFGG47A.js";
+} from "./chunk-XBYF4SGD.js";
 import {
   DeliveryRow,
   DevCardRowContent,
   DevCardRowSkeletonList,
   DevSectionPage,
   ListEmptyState
-} from "./chunk-RK47E3PP.js";
+} from "./chunk-JSG7WZKV.js";
 import {
   EmptyState,
   UnifiedPagination
@@ -19,7 +19,7 @@ import {
   TOAST_COPY,
   isOptimistic,
   useOptionalTicketLive
-} from "./chunk-MCNQKS6I.js";
+} from "./chunk-KVDLL4LU.js";
 import {
   AlertDialog,
   AlertDialogAction,
@@ -35,7 +35,7 @@ import {
   Textarea,
   TicketAttachmentsList,
   devSectionAnchorId
-} from "./chunk-CKO6NKNE.js";
+} from "./chunk-KMW2PXBU.js";
 import {
   toast,
   useScrollToHash
@@ -1832,4 +1832,4 @@ export {
   HelpCenterCreateForm,
   HelpCenterList
 };
-//# sourceMappingURL=chunk-Z7QCNCBN.js.map
+//# sourceMappingURL=chunk-7WYWPELF.js.map

package/dist/{chunk-RTKF5AYA.cjs → chunk-BXAGR3PO.cjs}

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } 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 _chunkEXWS2QSDcjs = require('./chunk-EXWS2QSD.cjs');
+var _chunkCWXRZVDIcjs = require('./chunk-CWXRZVDI.cjs');
 
 
 var _chunkGZRU2A4Lcjs = require('./chunk-GZRU2A4L.cjs');
@@ -160,7 +160,7 @@ function TicketLiveProvider({ children, enabled = true }) {
   _react2.default.useEffect(() => {
     if (!streamEnabled) return void 0;
     if (typeof window === "undefined") return void 0;
-    subscriptionRef.current = _chunkEXWS2QSDcjs.createSseSubscription.call(void 0, {
+    subscriptionRef.current = _chunkCWXRZVDIcjs.createSseSubscription.call(void 0, {
       url: streamUrl,
       onEvent: (name, data) => handlersRef.current.onEvent(name, data),
       onStatusChange: (status) => handlersRef.current.onStatus(status),
@@ -275,4 +275,4 @@ var TOAST_COPY = {
 
 
 exports.useOptionalTicketLive = useOptionalTicketLive; exports.useTicketLive = useTicketLive; exports.TicketLiveProvider = TicketLiveProvider; exports.isOptimistic = isOptimistic; exports.TICKET_TEXT_MAX_CHARS = TICKET_TEXT_MAX_CHARS; exports.TICKET_MARK_READ_DEBOUNCE_MS = TICKET_MARK_READ_DEBOUNCE_MS; exports.TOAST_COPY = TOAST_COPY;
-//# sourceMappingURL=chunk-RTKF5AYA.cjs.map
+//# sourceMappingURL=chunk-BXAGR3PO.cjs.map

package/dist/{chunk-RTKF5AYA.cjs.map → chunk-BXAGR3PO.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-RTKF5AYA.cjs","../src/components/tickets/ticket-live-provider.tsx","../src/components/tickets/types.ts"],"names":[],"mappings":"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","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-RTKF5AYA.cjs","sourcesContent":[null,"'use client';\n\n/**\n * TicketLiveProvider — the ONE client home for support-ticket realtime.\n *\n * DOMAIN logic only — connection lifecycle is owned entirely by the\n * common SSE client (`createSseSubscription`; its module header lists\n * the policies); this provider consumes its consolidated\n * `onConnectedChange` signal.\n *\n * Owns:\n *   - the unread summary — delivered EXCLUSIVELY by the stream\n *     (`ticket-summary` frames on connect + debounced after events) and\n *     by `ticket-read` responses. The client holds NO summary fetch\n *     path: resync-on-(re)connect is served by the SERVER (every\n *     connect pushes a fresh summary);\n *   - query invalidation on events (list + open drawer refresh live);\n *   - `markRead` with local write-through zeroing for 0-latency,\n *     reconciled by the response's server-computed summary;\n *   - the ticket-contract `no-stream` (204) retry policy.\n *\n * There is NO polling anywhere and NO summary endpoint. Hosts whose\n * stream endpoint 404s or is absent get no unread indication — the\n * indication IS a realtime feature (a 404ing endpoint is re-probed on\n * presence, rate-limited by the client).\n *\n * Invalidation semantics on events — deliberately `invalidateQueries`,\n * NOT `setQueryData` patches: the ticket hooks run `gcTime: 0`, so\n * there is usually no cache entry to patch, and `TicketsCacheSlot`\n * shape rules apply when there is.\n */\n\nimport { useQueryClient } from '@tanstack/react-query';\nimport React from 'react';\nimport { useChatRuntime } from '../../contexts/chat-runtime-context';\nimport { embedAuthedFetch } from '../../utils/embed-authed-fetch';\nimport { createSseSubscription, type SseSubscription, type SseTransportStatus } from '../../utils/sse-subscription';\nimport { useChatIdentity } from '../chat/hooks/use-chat-identity';\nimport type { TicketMessageStreamData, TicketStreamEvent, TicketUnreadSummary } from './types';\n\n// Ticket realtime is its OWN api surface — deliberately NOT under\n// `/api/chat/agent/*` (that prefix is the chat agent's tool surface;\n// ticket streaming/read-receipts are unrelated to chat).\nconst TICKET_STREAM_ENDPOINT = '/api/tickets/stream';\nconst TICKET_READ_ENDPOINT = '/api/tickets/read';\n\nconst EMPTY_SUMMARY: TicketUnreadSummary = { totalUnread: 0, tickets: {}, latestUnreadAt: {} };\n\n/** ISO stamps can carry mixed timezone offsets (server `+00:00` vs an\n *  optimistic local `Z`) — lexicographic string comparison mis-orders\n *  those, so every stamp comparison goes through parsed epoch ms.\n *  Missing/unparseable stamps sort oldest. */\nconst stampMs = (stamp: string | null | undefined): number => {\n  if (!stamp) return 0;\n  const ms = Date.parse(stamp);\n  return Number.isNaN(ms) ? 0 : ms;\n};\n\n/** Trailing debounce for event-burst invalidations (an agent pasting 5\n *  messages must not fire 5 list refetches). */\nconst INVALIDATE_DEBOUNCE_MS = 1_500;\n\nexport interface TicketLiveContextValue {\n  /** Viewer has a resolved, non-anon chat identity. Surfaces (e.g. the\n   *  header cell) hide themselves when false — computed here so they\n   *  don't each spin up their own identity resolution. */\n  authed: boolean;\n  /** Realtime-subscribed (server-confirmed), not merely HTTP-open. */\n  connected: boolean;\n  /** Unread total across tickets — drives the header count badge. */\n  unreadTotal: number;\n  /** Per-ticket unread counts (missing key = 0) — drives row dots.\n   *  The currently-open ticket is masked to 0. */\n  unreadByTicket: Record<string, number>;\n  /** The ticket with the NEWEST unread reply (open ticket excluded) —\n   *  the header cell routes to it via the SSOT deep link\n   *  (`buildTicketOpenHref`). Null when nothing is unread. */\n  nextUnreadTicketId: string | null;\n  /** Mark a ticket read: POSTs the receipt, zeroes the ticket locally\n   *  (0-latency), then applies the response's server-computed summary. */\n  markRead: (ticketExternalId: string) => Promise<void>;\n  /** Drawer open/close registration — suppresses unread bumps for the\n   *  open ticket and masks it in the derived map. */\n  setOpenTicketId: (ticketExternalId: string | null) => void;\n  /** Hint that the viewer just created a ticket — reconnects the stream\n   *  (fresh ownership set + fresh server-pushed summary). */\n  notifyTicketCreated: () => void;\n}\n\nconst TicketLiveContext = React.createContext<TicketLiveContextValue | null>(null);\n\nexport function useOptionalTicketLive(): TicketLiveContextValue | null {\n  return React.useContext(TicketLiveContext);\n}\n\nexport function useTicketLive(): TicketLiveContextValue {\n  const ctx = React.useContext(TicketLiveContext);\n  if (!ctx) {\n    throw new Error('useTicketLive must be used within <TicketLiveProvider>');\n  }\n  return ctx;\n}\n\nfunction isTicketMessageData(value: unknown): value is TicketMessageStreamData {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    typeof (value as TicketMessageStreamData).ticket_external_id === 'string'\n  );\n}\n\nfunction isSummaryData(value: unknown): value is TicketUnreadSummary {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    typeof (value as TicketUnreadSummary).totalUnread === 'number' &&\n    typeof (value as TicketUnreadSummary).tickets === 'object'\n  );\n}\n\nexport interface TicketLiveProviderProps {\n  children: React.ReactNode;\n  /**\n   * Whether ticket realtime is available to this host at all (feature flag,\n   * session, entitlement). `false` provides NO context — `useOptionalTicketLive()`\n   * reads `null`, `useTicketLive()` throws, and no identity or stream request is\n   * made: byte-for-byte what a host got by not mounting this at all.\n   *\n   * It exists so a host never has to mount this CONDITIONALLY. A host that writes\n   * `enabled ? <TicketLiveProvider>{children}</TicketLiveProvider> : <>{children}</>`\n   * changes the element TYPE at that position the moment its flag answers, and React\n   * tears down and remounts everything below. In openframe-frontend that wrapper sat\n   * around the whole `AppLayout`, so every cold load remounted the app shell and the\n   * page under it — visibly, as a chat drawer opened by a deep link replaying its\n   * open animation. Mount it always and pass the answer here instead.\n   *\n   * One consequence of mounting it always: a `ChatRuntime` must be above it even\n   * while disabled. The identity resolver reads one unconditionally (Rules of\n   * Hooks) and throws without it; `enabled` gates the request, not the read.\n   */\n  enabled?: boolean;\n}\n\nexport function TicketLiveProvider({ children, enabled = true }: TicketLiveProviderProps) {\n  const runtime = useChatRuntime();\n  const identity = useChatIdentity(enabled);\n  const queryClient = useQueryClient();\n\n  const streamUrl = runtime?.endpoints.ticketStreamUrl ?? TICKET_STREAM_ENDPOINT;\n  const readUrl = runtime?.endpoints.ticketReadUrl ?? TICKET_READ_ENDPOINT;\n\n  // Gates the stream below (via `streamEnabled`) as well as every surface that\n  // reads `authed` — one predicate, so a disabled provider is also a silent one.\n  const authed = enabled && identity.authTier !== 'anon' && !!identity.user?.email;\n\n  const [connected, setConnected] = React.useState(false);\n  // The SINGLE unread source — written ONLY from server-computed\n  // summaries (stream frames + markRead responses) plus the two\n  // 0-latency optimistic writes (event bump, markRead zero), both\n  // reconciled by the next server summary.\n  const [summary, setSummary] = React.useState<TicketUnreadSummary>(EMPTY_SUMMARY);\n  // State + ref for the open drawer: state drives the derived map,\n  // the ref lets stream callbacks read it without re-subscribing.\n  const [openTicketIdState, setOpenTicketIdState] = React.useState<string | null>(null);\n  const openTicketIdRef = React.useRef<string | null>(null);\n\n  // ---- Debounced (trailing) invalidation of ticket queries on events ----\n  const pendingTicketIdsRef = React.useRef<Set<string>>(new Set());\n  const invalidateTimerRef = React.useRef<ReturnType<typeof setTimeout> | null>(null);\n  const flushInvalidations = React.useCallback(() => {\n    invalidateTimerRef.current = null;\n    const ids = Array.from(pendingTicketIdsRef.current);\n    pendingTicketIdsRef.current.clear();\n    void queryClient.invalidateQueries({ queryKey: ['tickets'] });\n    for (const id of ids) {\n      void queryClient.invalidateQueries({ queryKey: ['ticket-engagements', id] });\n    }\n  }, [queryClient]);\n  const scheduleInvalidation = React.useCallback(\n    (ticketId?: string) => {\n      if (ticketId) pendingTicketIdsRef.current.add(ticketId);\n      if (invalidateTimerRef.current) return;\n      invalidateTimerRef.current = setTimeout(flushInvalidations, INVALIDATE_DEBOUNCE_MS);\n    },\n    [flushInvalidations],\n  );\n\n  // ---- Optimistic unread writes (reconciled by server summaries) ----\n  const bumpUnread = React.useCallback((ticketId: string, createdAt?: string | null) => {\n    setSummary(prev => {\n      const stamp = createdAt ?? new Date().toISOString();\n      const existing = prev.latestUnreadAt[ticketId];\n      return {\n        totalUnread: prev.totalUnread + 1,\n        tickets: { ...prev.tickets, [ticketId]: (prev.tickets[ticketId] ?? 0) + 1 },\n        latestUnreadAt: {\n          ...prev.latestUnreadAt,\n          [ticketId]: existing && stampMs(existing) > stampMs(stamp) ? existing : stamp,\n        },\n      };\n    });\n  }, []);\n\n  const zeroUnread = React.useCallback((ticketId: string) => {\n    setSummary(prev => {\n      const current = prev.tickets[ticketId] ?? 0;\n      if (current === 0) return prev;\n      const tickets = { ...prev.tickets };\n      delete tickets[ticketId];\n      const latestUnreadAt = { ...prev.latestUnreadAt };\n      delete latestUnreadAt[ticketId];\n      return { totalUnread: Math.max(0, prev.totalUnread - current), tickets, latestUnreadAt };\n    });\n  }, []);\n\n  // ---- Stream lifecycle (owned by the SSE CLIENT — the provider only\n  // consumes its consolidated signals) ----\n  const subscriptionRef = React.useRef<SseSubscription | null>(null);\n  const noStreamRef = React.useRef(false);\n\n  // Stable handler refs so the subscription effect doesn't churn.\n  const handlersRef = React.useRef<{\n    onEvent: (eventName: string, data: unknown) => void;\n    onStatus: (status: SseTransportStatus) => void;\n    onConnected: (connected: boolean) => void;\n  }>({ onEvent: () => {}, onStatus: () => {}, onConnected: () => {} });\n\n  const handleConnected = (isConnected: boolean) => {\n    setConnected(isConnected);\n    if (isConnected) {\n      // Event-gap healing on every (re)connect: the SERVER pushes a\n      // fresh summary; the open drawer refetches through the ACL'd path.\n      const openId = openTicketIdRef.current;\n      if (openId) {\n        void queryClient.invalidateQueries({ queryKey: ['ticket-engagements', openId] });\n      }\n    }\n  };\n\n  const handleEvent = (eventName: string, data: unknown) => {\n    if (eventName === 'ticket-summary') {\n      const frame = data as TicketStreamEvent | null;\n      if (isSummaryData(frame?.data)) {\n        setSummary({\n          totalUnread: frame.data.totalUnread,\n          tickets: frame.data.tickets ?? {},\n          latestUnreadAt: frame.data.latestUnreadAt ?? {},\n        });\n      }\n      return;\n    }\n\n    if (eventName === 'ticket-resync') {\n      // Ownership gained / degraded payload — a fresh ticket-summary\n      // frame follows from the server; refresh the query surfaces.\n      scheduleInvalidation();\n      return;\n    }\n\n    if (eventName === 'ticket-status') {\n      // Meaningful ticket-row change (close/reopen/pipeline move). The\n      // server pushes an updated summary right after (closures count as\n      // unread server-side); here we just refresh the query surfaces so\n      // the status badge flips live.\n      const frame = data as TicketStreamEvent | null;\n      const ticketId = (frame?.data as { ticket_external_id?: string } | undefined)?.ticket_external_id;\n      scheduleInvalidation(ticketId);\n      return;\n    }\n\n    if (eventName === 'ticket-message') {\n      const frame = data as TicketStreamEvent | null;\n      const payload = frame?.data;\n      if (!isTicketMessageData(payload)) {\n        scheduleInvalidation();\n        return;\n      }\n      // Always invalidate (own replies from another tab render live);\n      // bump unread ONLY on the server-stamped predicate, and never for\n      // the ticket whose drawer is open. The server's debounced summary\n      // push reconciles moments later.\n      scheduleInvalidation(payload.ticket_external_id);\n      if (payload.countsAsUnread && payload.ticket_external_id !== openTicketIdRef.current) {\n        bumpUnread(payload.ticket_external_id, payload.hubspot_created_at);\n      }\n    }\n  };\n\n  const handleStatus = (status: SseTransportStatus) => {\n    // The client owns connection lifecycle. The only transport status\n    // with DOMAIN meaning is the ticket contract's `no-stream` (204 =\n    // zero owned tickets): remember it so a domain signal (own\n    // create_ticket, window focus) can retry.\n    if (status === 'open') noStreamRef.current = false;\n    if (status === 'no-stream') noStreamRef.current = true;\n  };\n\n  // Publish the three handlers into the stable ref. In an unconditional effect\n  // rather than in the render body: every caller is an SSE transport callback,\n  // which can only fire after a commit, and a render attempt React discards\n  // must not be able to leave a handler behind that closes over state the user\n  // never saw. Declared BEFORE the subscription effect so it is filled first\n  // in the same flush.\n  React.useEffect(() => {\n    handlersRef.current.onConnected = handleConnected;\n    handlersRef.current.onEvent = handleEvent;\n    handlersRef.current.onStatus = handleStatus;\n  });\n\n  // Mount/unmount of the subscription — gated on auth + a usable URL.\n  const streamEnabled = authed && !!streamUrl;\n  React.useEffect(() => {\n    if (!streamEnabled) return undefined;\n    if (typeof window === 'undefined') return undefined;\n\n    subscriptionRef.current = createSseSubscription({\n      url: streamUrl,\n      onEvent: (name, data) => handlersRef.current.onEvent(name, data),\n      onStatusChange: status => handlersRef.current.onStatus(status),\n      onConnectedChange: isConnected => handlersRef.current.onConnected(isConnected),\n      // Long-lived per-user stream: suspend while hidden (scale relief),\n      // resume + reconnect on visible/online — all inside the client.\n      pauseWhenHidden: true,\n    });\n\n    const retryIfIdle = () => {\n      // After a 204 (no-stream), a focus signal is the retry trigger. Only\n      // 204 — the client's contract leaves that retry to the caller; it\n      // retries terminal / 401 states on its own.\n      if (noStreamRef.current) {\n        noStreamRef.current = false;\n        subscriptionRef.current?.reconnectNow();\n      }\n    };\n    window.addEventListener('focus', retryIfIdle);\n\n    return () => {\n      window.removeEventListener('focus', retryIfIdle);\n      if (invalidateTimerRef.current) {\n        clearTimeout(invalidateTimerRef.current);\n        invalidateTimerRef.current = null;\n      }\n      subscriptionRef.current?.close();\n      subscriptionRef.current = null;\n      setConnected(false);\n      setSummary(EMPTY_SUMMARY);\n    };\n    // handlersRef is stable; streamUrl/auth changes remount the stream.\n  }, [streamEnabled, streamUrl]);\n\n  // ---- Public API ----\n  const markRead = React.useCallback(\n    async (ticketExternalId: string) => {\n      try {\n        const response = await embedAuthedFetch(readUrl, {\n          method: 'POST',\n          body: JSON.stringify({ ticket_id: ticketExternalId }),\n        });\n        if (!response.ok) return;\n        // 0-latency local zero, then reconcile with the response's\n        // server-computed summary (THE truth — includes closure\n        // accounting and other tickets).\n        zeroUnread(ticketExternalId);\n        const body = (await response.json().catch(() => null)) as { summary?: TicketUnreadSummary } | null;\n        if (isSummaryData(body?.summary)) {\n          setSummary({\n            totalUnread: body.summary.totalUnread,\n            tickets: body.summary.tickets ?? {},\n            latestUnreadAt: body.summary.latestUnreadAt ?? {},\n          });\n        }\n      } catch {\n        // Non-fatal — the receipt lands on the next markRead; unread\n        // state reconciles via the next server summary push.\n      }\n    },\n    [readUrl, zeroUnread],\n  );\n\n  const setOpenTicketId = React.useCallback((ticketExternalId: string | null) => {\n    openTicketIdRef.current = ticketExternalId;\n    setOpenTicketIdState(ticketExternalId);\n  }, []);\n\n  const notifyTicketCreated = React.useCallback(() => {\n    // Fresh connect → fresh ownership set + fresh server summary\n    // (covers both the no-stream 204 wait state and an already-live\n    // stream whose set predates the new ticket).\n    noStreamRef.current = false;\n    subscriptionRef.current?.reconnectNow();\n  }, []);\n\n  // Derived unread map — open ticket masked to 0 so a server summary\n  // landing inside the markRead debounce window can't transiently\n  // re-badge it.\n  const value = React.useMemo<TicketLiveContextValue>(() => {\n    let unreadByTicket = summary.tickets;\n    let unreadTotal = summary.totalUnread;\n    if (openTicketIdState && unreadByTicket[openTicketIdState]) {\n      const masked = unreadByTicket[openTicketIdState];\n      unreadByTicket = { ...unreadByTicket };\n      delete unreadByTicket[openTicketIdState];\n      unreadTotal = Math.max(0, unreadTotal - masked);\n    }\n    // Ticket with the NEWEST unread reply (compared as parsed epoch ms\n    // via `stampMs` — mixed timezone offsets break string ordering) —\n    // header cell routes there. Falls back to any unread key if a\n    // timestamp is missing.\n    let nextUnreadTicketId: string | null = null;\n    let nextStampMs = 0;\n    for (const id of Object.keys(unreadByTicket)) {\n      const ms = stampMs(summary.latestUnreadAt[id]);\n      if (nextUnreadTicketId === null || ms > nextStampMs) {\n        nextUnreadTicketId = id;\n        nextStampMs = ms;\n      }\n    }\n    return {\n      authed,\n      connected,\n      unreadTotal,\n      unreadByTicket,\n      nextUnreadTicketId,\n      markRead,\n      setOpenTicketId,\n      notifyTicketCreated,\n    };\n  }, [summary, authed, connected, openTicketIdState, markRead, setOpenTicketId, notifyTicketCreated]);\n\n  return <TicketLiveContext.Provider value={enabled ? value : null}>{children}</TicketLiveContext.Provider>;\n}\n","/**\n * Wire shape of a row returned by `POST /api/chat/agent/find-ticket`.\n * Mirrors the executor's projection at `lib/data/hubspot-tools.ts`\n * (`FIND_TICKET_SELECT` / `FindTicketResult`).\n *\n * Cross-repo duplication is INTENTIONAL: this lib ships independently\n * of the hub, so we can't import `FindTicketResult` from\n * `hubspot-tools.ts` directly. If the server adds a column to\n * `FIND_TICKET_SELECT`, also add it here. The smoke test in §F of the\n * plan covers the happy path; a wire-contract test belongs in the hub.\n *\n * `find-ticket` returns `customer_emails: string[]` (jsonb array), NOT\n * a single `customer_email`. The list is server-self-scoped to the\n * caller's session email; the array is exposed for admin/staff\n * surfaces, which the ticket center doesn't render.\n */\nexport interface TicketData {\n  id: string;\n  /** HubSpot ticket id (display number, e.g. \"1234\"). */\n  external_id: string;\n  subject: string | null;\n  /** Short (≤400 char) HTML-stripped preview of the ticket body —\n   *  used for the list-card subtitle when needed. */\n  preview: string | null;\n  /** Longer (≤4k char) sanitized body. INCLUDES every appended\n   *  `content_addendum` comment because the `update_ticket` executor\n   *  reads + re-writes the `content` property server-side with a\n   *  `---` separator. Render this in the drawer's description block\n   *  and the user sees both the original message + every comment they\n   *  (or staff) added. */\n  body: string | null;\n  /** Canonical OPEN | CLOSED (HubSpot pipeline derived). */\n  status: string | null;\n  /** Human label like \"New\" / \"Working on it\" / \"Waiting on contact\" /\n   *  \"Closed\". Drives the badge text; canonical status drives color. */\n  pipeline_stage_label: string | null;\n  clickup_task_id: string | null;\n  /** Snapshot of the linked ClickUp delivery task — populated server-side\n   *  via the `clickup_tasks` mirror when `clickup_task_id` is set. Drives\n   *  the \"Linked delivery\" card surface on the ticket drawer (status\n   *  badge + ClickUp deep link). `null` when no link OR the ClickUp row\n   *  was deleted / not yet synced. */\n  clickup: TicketClickupSummary | null;\n  priority: string | null;\n  customer_emails: string[];\n  customer_company: string | null;\n  /** HubSpot contact's display name. Drives the customer attribution\n   *  on the drawer when the viewer is NOT the customer themselves\n   *  (admin browsing / multi-contact second viewer). Conversations\n   *  API messages don't carry per-message sender info on Custom\n   *  Channels, so this is the only reliable source for \"what's the\n   *  customer's name.\" */\n  customer_name: string | null;\n  /** HubSpot owner id of the agent assigned to this ticket. Carried as\n   *  raw id for debugging; rendering goes through `assignedOwner`. Null\n   *  when unassigned. */\n  assigned_to: string | null;\n  /** Resolved assigned-owner profile — name + email + avatar. Populated\n   *  server-side via `attachOwnerProfiles` which joins through the\n   *  `hubspot_owners` mirror to `profiles` by email. Drives the\n   *  \"Assigned to\" attribution in the drawer header. Null when\n   *  unassigned OR the owner couldn't be resolved (rare — only when\n   *  the agent was deleted from HubSpot between the ticket update and\n   *  the next owners reconcile). */\n  assignedOwner: TicketAssignedOwner | null;\n  hubspot_updated_at: string;\n}\n\n/** Resolved profile of a ticket's assigned agent — surfaced in the\n *  drawer header. Subset of the server's `MirroredOwnerProfile`\n *  trimmed to just the rendering fields. */\nexport interface TicketAssignedOwner {\n  name: string | null;\n  email: string | null;\n  avatarUrl: string | null;\n}\n\n/** Compact projection of a linked ClickUp task — matches the server's\n *  `ClickupSummary` and aligns with `DeliveryItem` so the linked-card\n *  on a ticket can render through the same `DeliveryRow` primitive used\n *  on `/bug-fixes-and-enhancements`. */\nexport interface TicketClickupSummary {\n  /** ClickUp task external_id (e.g. \"86ad4e022\"). Used as the\n   *  `?focus=<id>` URL param to scroll the public delivery page to\n   *  this row. */\n  external_id: string;\n  title: string | null;\n  description: string | null;\n  /** ClickUp status name — e.g. \"complete\" / \"working\" / \"design approved\"\n   *  / \"waiting for release\". Used as the badge label. */\n  status: string | null;\n  /** ClickUp's per-status hex color (e.g. \"#008844\"). Forwarded to the\n   *  badge so colors match the ClickUp board exactly. */\n  status_color: string | null;\n  /** Bucket — `'backlog' | 'working' | 'complete' | 'unknown'`. Used as\n   *  a fallback when status_color is missing. */\n  status_category: string | null;\n  /** ClickUp custom item label (`'Bug'` / `'Request'`) — drives the\n   *  type badge (\"BUG-FIX\" / \"ENHANCEMENT\"). */\n  task_type: string | null;\n  custom_item_id: number | null;\n  /** Every ClickUp list the task is associated with. UI joins with \", \". */\n  list_names: string[];\n  /** Unix-ms timestamps so the row's \"ACTIVE X ago\" subtitle uses the\n   *  shared `getRelativeTime()` helper. */\n  date_opened: number | null;\n  date_updated: number | null;\n  date_closed: number | null;\n  /** Direct https://app.clickup.com/t/<id> deep link. Kept on the wire\n   *  for admin surfaces; the customer-facing linked card navigates\n   *  internally instead. */\n  clickup_url: string | null;\n  /** Composed server-side via the SAME `buildDevSectionUrl` helper the\n   *  chat-inline delivery card uses. Carries `?search=<id>` so the\n   *  delivery list filters to that single task on landing. */\n  delivery_href: string;\n  /** Target platform name for the host's `useNavLink` to decide\n   *  same-tab vs new-tab on cross-platform links. */\n  delivery_target_platform: string;\n  /** Release version label set by the delivery team, e.g. \"0.9\" / \"1.0\".\n   *  Shown beside the status when present. */\n  target_version: string | null;\n}\n\n/**\n * Optimistic placeholder a `submitTicket` call prepends to the list\n * BEFORE the server roundtrip resolves. Drawer is hidden until the\n * real id arrives. The wrapper destructures `_optimistic` before\n * forwarding to `<ChatTicketItem>` so the DOM doesn't see an unknown\n * prop.\n */\nexport interface OptimisticTicket extends TicketData {\n  _optimistic: true;\n}\n\nexport type AnyTicket = TicketData | OptimisticTicket;\n\nexport function isOptimistic(t: AnyTicket): t is OptimisticTicket {\n  return (t as OptimisticTicket)._optimistic === true;\n}\n\n/**\n * Shape of a single `['tickets', …]` TanStack-Query cache slot.\n * Mirrors `FindTicketResponse` in `hooks/use-tickets-list.ts` — kept\n * here because the cache-mutation call sites in `useTicketActions` and\n * `<HelpCenterList>` would otherwise have to redeclare the shape inline.\n *\n * A 2026-05-29 prod regression (`t.map is not a function` on\n * close/reopen) was caused by assuming the cache held a bare\n * `TicketData[]` instead of this wrapper — every helper that calls\n * `queryClient.setQueriesData` / `getQueriesData` on `['tickets']`\n * MUST type the value through this shape and project / reassemble\n * `tickets` explicitly.\n */\nexport interface TicketsCacheSlot {\n  tickets?: TicketData[];\n  count?: number;\n  totalCount?: number;\n  page?: number;\n  pageSize?: number;\n  totalPages?: number;\n  scope?: 'self' | 'all';\n}\n\n/**\n * Stable server-side error codes the ticket-action helpers route\n * through `mapTicketActionError`. Anything else is treated as a generic\n * server error.\n *\n * Reply-specific codes (`HUBSPOT_5XX` / `HUBSPOT_400_VALIDATION` /\n * `HUBSPOT_404_THREAD` / `HUBSPOT_REPLY_UNKNOWN`) drive the drawer\n * banner that appears above the composer when a customer reply fails.\n * Distinct from `HUBSPOT_DISCONNECTED` (whole-system) and\n * `TICKET_NOT_FOUND` (terminal-row) — the reply codes are per-attempt\n * + retryable except for `HUBSPOT_404_THREAD`.\n */\nexport type TicketActionErrorCode =\n  | 'PROPOSAL_NOT_CLAIMABLE'\n  | 'TICKET_NOT_FOUND'\n  | 'TICKET_OWNERSHIP_DENIED'\n  | 'HUBSPOT_DISCONNECTED'\n  | 'RATE_LIMITED'\n  | 'INVALID_TOOL_ARGS'\n  | 'HUBSPOT_5XX'\n  | 'HUBSPOT_400_VALIDATION'\n  | 'HUBSPOT_404_THREAD'\n  | 'HUBSPOT_REPLY_UNKNOWN'\n  | 'UNKNOWN';\n\nexport interface MappedTicketActionError {\n  code: TicketActionErrorCode;\n  /** Human-readable copy safe to show in a toast. */\n  message: string;\n  /** When true, the form should disable submit + show the\n   *  support-down banner. Set only for HUBSPOT_DISCONNECTED. */\n  supportSystemDown: boolean;\n  /** When true, the helper should remove the affected row optimistically\n   *  (TICKET_NOT_FOUND). */\n  removeRowFromCache: boolean;\n  /** Retry hint surfaced from a 429 response. Caller decides whether\n   *  to mention it in the toast. */\n  retryAfterSeconds?: number;\n}\n\n/**\n * Defensive client-side cap on ticket text (initial content + comment\n * addendums). HubSpot Note engagements accept more, but a 100KB paste\n * should fail fast at the UI rather than burning a server round-trip.\n * Both the open-ticket form and the per-row comment textarea import\n * this so a future server-side hardening only touches one place.\n */\nexport const TICKET_TEXT_MAX_CHARS = 5000;\n\n/**\n * Wire contract of the ticket live stream (`GET /api/chat/agent/\n * ticket-stream`, SSE). Producer (the hub route's `mapEvent`) imports\n * THIS type — same producer/consumer SSOT pattern as\n * `ConversationEngagementWire = TicketEngagement`. A schema drift here\n * would be a silent serialization bug; keep one named contract.\n *\n * Frames carry METADATA ONLY — never message bodies. Content is always\n * refetched through the ACL'd `list-engagements` path (one read path).\n *\n * Event names (`eventType`):\n *   - `ticket-message` — a message row landed in the mirror for one of\n *     the viewer's tickets. `data` carries the metadata.\n *   - `ticket-status`  — a MEANINGFUL ticket-row change (status /\n *     pipeline stage / closure) landed in the mirror. Server-side\n *     old-vs-new diffing drops no-op writes (sync stamps). Clients\n *     invalidate + refetch the summary (closures count as unread\n *     server-side via `closed_at` vs the read receipt).\n *   - `ticket-summary` — the server-computed `TicketUnreadSummary`.\n *     THE stream is the summary webservice: pushed on connect (server-\n *     side resync-on-reconnect) and re-pushed (debounced) after every\n *     delivered event. Clients hold NO summary fetch path.\n *   - `ticket-resync`  — degraded frame: something happened that the\n *     server couldn't fully describe (truncated Realtime payload, or\n *     the connection's ownership set just gained tickets). A fresh\n *     `ticket-summary` follows it; clients invalidate queries.\n *\n * The server also emits `status` frames (`subscribed` / `retrying` /\n * `reconnect_failed`) from the shared SSE utility — clients derive\n * `connected` from those, NOT from the HTTP stream being open.\n */\nexport type TicketStreamEventType = 'ticket-message' | 'ticket-status' | 'ticket-summary' | 'ticket-resync';\n\n/** Metadata payload of a `ticket-message` frame. */\nexport type TicketMessageStreamData = {\n  ticket_external_id: string;\n  /** Mirror row's HubSpot message id. */\n  message_id: string;\n  /** Server-stamped via the same direction predicate the wire mapper\n   *  uses. Clients never re-derive author classification. */\n  authorRole: 'customer' | 'support';\n  /** Server-stamped via the visibility+direction unread predicate\n   *  (`countsAsUnread` in the hub's conversations DAL). ONLY frames\n   *  with `true` may bump client-side unread state. */\n  countsAsUnread: boolean;\n  hubspot_created_at: string | null;\n};\n\n/** Metadata payload of a `ticket-status` frame. */\nexport type TicketStatusStreamData = {\n  ticket_external_id: string;\n  /** Canonical OPEN | CLOSED after the change. */\n  status: string | null;\n  pipeline_stage_label: string | null;\n  closed_at: string | null;\n};\n\nexport interface TicketStreamEvent {\n  eventType: TicketStreamEventType;\n  /** Human-readable label (SSE envelope compat) — clients ignore it. */\n  message: string;\n  /** `ticket-message` → TicketMessageStreamData; `ticket-status` →\n   *  TicketStatusStreamData; `ticket-summary` → TicketUnreadSummary;\n   *  absent on `ticket-resync`. */\n  data?: TicketMessageStreamData | TicketStatusStreamData | TicketUnreadSummary;\n}\n\n/**\n * The SINGLE unread source, delivered EXCLUSIVELY over the stream\n * (`ticket-summary` frames on connect + after events) and in\n * `ticket-read` responses. There is no summary fetch endpoint. Header\n * badge total AND per-row dots both read this via the\n * `TicketLiveProvider` map; missing keys mean 0.\n */\nexport type TicketUnreadSummary = {\n  totalUnread: number;\n  tickets: Record<string, number>;\n  /** ISO timestamp of the NEWEST unread message per ticket (same keys as\n   *  `tickets`). Drives \"route to the most recent update\" on the header\n   *  cell: the ticket with the max value here is `nextUnreadTicketId`. */\n  latestUnreadAt: Record<string, string>;\n};\n\n/**\n * Trailing debounce for `markRead` while the drawer is open and new\n * messages stream in — flushed on drawer close so a fast open/close\n * still persists the receipt. Named beside its sibling cadences so\n * every timing knob lives in one file.\n */\nexport const TICKET_MARK_READ_DEBOUNCE_MS = 2000;\n\n/**\n * Ticket deep-link SSOT — DEFINED in the server-safe param-keys module\n * (`utils/dev-sections/dev-section-param-keys.ts`, beside its sibling\n * `devSectionAnchorId`) because producers span both worlds: the hub's\n * SERVER-side chat-ref builder and the client header cell. Re-exported\n * here so ticket-surface consumers keep one import home.\n */\nexport { TICKET_OPEN_PARAM, buildTicketOpenHref } from '../../utils/dev-sections/dev-section-param-keys';\n\n/**\n * Centralized toast copy. Keep all wording here so QA / localization\n * can find every user-visible string in one file.\n */\nexport const TOAST_COPY = {\n  open_success: { title: 'Ticket opened', description: 'We received your message and will follow up shortly.' },\n  open_mirror_pending: { title: 'Ticket opened', description: 'Syncing — your ticket will appear momentarily.' },\n  close_success: { title: 'Ticket closed' },\n  reopen_success: { title: 'Ticket reopened' },\n  comment_success: { title: 'Comment added' },\n  attach_success: { title: 'Files attached' },\n  // Failure variants are constructed dynamically from MappedTicketActionError.\n} as const;\n"]}
+{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-BXAGR3PO.cjs","../src/components/tickets/ticket-live-provider.tsx","../src/components/tickets/types.ts"],"names":[],"mappings":"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","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-BXAGR3PO.cjs","sourcesContent":[null,"'use client';\n\n/**\n * TicketLiveProvider — the ONE client home for support-ticket realtime.\n *\n * DOMAIN logic only — connection lifecycle is owned entirely by the\n * common SSE client (`createSseSubscription`; its module header lists\n * the policies); this provider consumes its consolidated\n * `onConnectedChange` signal.\n *\n * Owns:\n *   - the unread summary — delivered EXCLUSIVELY by the stream\n *     (`ticket-summary` frames on connect + debounced after events) and\n *     by `ticket-read` responses. The client holds NO summary fetch\n *     path: resync-on-(re)connect is served by the SERVER (every\n *     connect pushes a fresh summary);\n *   - query invalidation on events (list + open drawer refresh live);\n *   - `markRead` with local write-through zeroing for 0-latency,\n *     reconciled by the response's server-computed summary;\n *   - the ticket-contract `no-stream` (204) retry policy.\n *\n * There is NO polling anywhere and NO summary endpoint. Hosts whose\n * stream endpoint 404s or is absent get no unread indication — the\n * indication IS a realtime feature (a 404ing endpoint is re-probed on\n * presence, rate-limited by the client).\n *\n * Invalidation semantics on events — deliberately `invalidateQueries`,\n * NOT `setQueryData` patches: the ticket hooks run `gcTime: 0`, so\n * there is usually no cache entry to patch, and `TicketsCacheSlot`\n * shape rules apply when there is.\n */\n\nimport { useQueryClient } from '@tanstack/react-query';\nimport React from 'react';\nimport { useChatRuntime } from '../../contexts/chat-runtime-context';\nimport { embedAuthedFetch } from '../../utils/embed-authed-fetch';\nimport { createSseSubscription, type SseSubscription, type SseTransportStatus } from '../../utils/sse-subscription';\nimport { useChatIdentity } from '../chat/hooks/use-chat-identity';\nimport type { TicketMessageStreamData, TicketStreamEvent, TicketUnreadSummary } from './types';\n\n// Ticket realtime is its OWN api surface — deliberately NOT under\n// `/api/chat/agent/*` (that prefix is the chat agent's tool surface;\n// ticket streaming/read-receipts are unrelated to chat).\nconst TICKET_STREAM_ENDPOINT = '/api/tickets/stream';\nconst TICKET_READ_ENDPOINT = '/api/tickets/read';\n\nconst EMPTY_SUMMARY: TicketUnreadSummary = { totalUnread: 0, tickets: {}, latestUnreadAt: {} };\n\n/** ISO stamps can carry mixed timezone offsets (server `+00:00` vs an\n *  optimistic local `Z`) — lexicographic string comparison mis-orders\n *  those, so every stamp comparison goes through parsed epoch ms.\n *  Missing/unparseable stamps sort oldest. */\nconst stampMs = (stamp: string | null | undefined): number => {\n  if (!stamp) return 0;\n  const ms = Date.parse(stamp);\n  return Number.isNaN(ms) ? 0 : ms;\n};\n\n/** Trailing debounce for event-burst invalidations (an agent pasting 5\n *  messages must not fire 5 list refetches). */\nconst INVALIDATE_DEBOUNCE_MS = 1_500;\n\nexport interface TicketLiveContextValue {\n  /** Viewer has a resolved, non-anon chat identity. Surfaces (e.g. the\n   *  header cell) hide themselves when false — computed here so they\n   *  don't each spin up their own identity resolution. */\n  authed: boolean;\n  /** Realtime-subscribed (server-confirmed), not merely HTTP-open. */\n  connected: boolean;\n  /** Unread total across tickets — drives the header count badge. */\n  unreadTotal: number;\n  /** Per-ticket unread counts (missing key = 0) — drives row dots.\n   *  The currently-open ticket is masked to 0. */\n  unreadByTicket: Record<string, number>;\n  /** The ticket with the NEWEST unread reply (open ticket excluded) —\n   *  the header cell routes to it via the SSOT deep link\n   *  (`buildTicketOpenHref`). Null when nothing is unread. */\n  nextUnreadTicketId: string | null;\n  /** Mark a ticket read: POSTs the receipt, zeroes the ticket locally\n   *  (0-latency), then applies the response's server-computed summary. */\n  markRead: (ticketExternalId: string) => Promise<void>;\n  /** Drawer open/close registration — suppresses unread bumps for the\n   *  open ticket and masks it in the derived map. */\n  setOpenTicketId: (ticketExternalId: string | null) => void;\n  /** Hint that the viewer just created a ticket — reconnects the stream\n   *  (fresh ownership set + fresh server-pushed summary). */\n  notifyTicketCreated: () => void;\n}\n\nconst TicketLiveContext = React.createContext<TicketLiveContextValue | null>(null);\n\nexport function useOptionalTicketLive(): TicketLiveContextValue | null {\n  return React.useContext(TicketLiveContext);\n}\n\nexport function useTicketLive(): TicketLiveContextValue {\n  const ctx = React.useContext(TicketLiveContext);\n  if (!ctx) {\n    throw new Error('useTicketLive must be used within <TicketLiveProvider>');\n  }\n  return ctx;\n}\n\nfunction isTicketMessageData(value: unknown): value is TicketMessageStreamData {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    typeof (value as TicketMessageStreamData).ticket_external_id === 'string'\n  );\n}\n\nfunction isSummaryData(value: unknown): value is TicketUnreadSummary {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    typeof (value as TicketUnreadSummary).totalUnread === 'number' &&\n    typeof (value as TicketUnreadSummary).tickets === 'object'\n  );\n}\n\nexport interface TicketLiveProviderProps {\n  children: React.ReactNode;\n  /**\n   * Whether ticket realtime is available to this host at all (feature flag,\n   * session, entitlement). `false` provides NO context — `useOptionalTicketLive()`\n   * reads `null`, `useTicketLive()` throws, and no identity or stream request is\n   * made: byte-for-byte what a host got by not mounting this at all.\n   *\n   * It exists so a host never has to mount this CONDITIONALLY. A host that writes\n   * `enabled ? <TicketLiveProvider>{children}</TicketLiveProvider> : <>{children}</>`\n   * changes the element TYPE at that position the moment its flag answers, and React\n   * tears down and remounts everything below. In openframe-frontend that wrapper sat\n   * around the whole `AppLayout`, so every cold load remounted the app shell and the\n   * page under it — visibly, as a chat drawer opened by a deep link replaying its\n   * open animation. Mount it always and pass the answer here instead.\n   *\n   * One consequence of mounting it always: a `ChatRuntime` must be above it even\n   * while disabled. The identity resolver reads one unconditionally (Rules of\n   * Hooks) and throws without it; `enabled` gates the request, not the read.\n   */\n  enabled?: boolean;\n}\n\nexport function TicketLiveProvider({ children, enabled = true }: TicketLiveProviderProps) {\n  const runtime = useChatRuntime();\n  const identity = useChatIdentity(enabled);\n  const queryClient = useQueryClient();\n\n  const streamUrl = runtime?.endpoints.ticketStreamUrl ?? TICKET_STREAM_ENDPOINT;\n  const readUrl = runtime?.endpoints.ticketReadUrl ?? TICKET_READ_ENDPOINT;\n\n  // Gates the stream below (via `streamEnabled`) as well as every surface that\n  // reads `authed` — one predicate, so a disabled provider is also a silent one.\n  const authed = enabled && identity.authTier !== 'anon' && !!identity.user?.email;\n\n  const [connected, setConnected] = React.useState(false);\n  // The SINGLE unread source — written ONLY from server-computed\n  // summaries (stream frames + markRead responses) plus the two\n  // 0-latency optimistic writes (event bump, markRead zero), both\n  // reconciled by the next server summary.\n  const [summary, setSummary] = React.useState<TicketUnreadSummary>(EMPTY_SUMMARY);\n  // State + ref for the open drawer: state drives the derived map,\n  // the ref lets stream callbacks read it without re-subscribing.\n  const [openTicketIdState, setOpenTicketIdState] = React.useState<string | null>(null);\n  const openTicketIdRef = React.useRef<string | null>(null);\n\n  // ---- Debounced (trailing) invalidation of ticket queries on events ----\n  const pendingTicketIdsRef = React.useRef<Set<string>>(new Set());\n  const invalidateTimerRef = React.useRef<ReturnType<typeof setTimeout> | null>(null);\n  const flushInvalidations = React.useCallback(() => {\n    invalidateTimerRef.current = null;\n    const ids = Array.from(pendingTicketIdsRef.current);\n    pendingTicketIdsRef.current.clear();\n    void queryClient.invalidateQueries({ queryKey: ['tickets'] });\n    for (const id of ids) {\n      void queryClient.invalidateQueries({ queryKey: ['ticket-engagements', id] });\n    }\n  }, [queryClient]);\n  const scheduleInvalidation = React.useCallback(\n    (ticketId?: string) => {\n      if (ticketId) pendingTicketIdsRef.current.add(ticketId);\n      if (invalidateTimerRef.current) return;\n      invalidateTimerRef.current = setTimeout(flushInvalidations, INVALIDATE_DEBOUNCE_MS);\n    },\n    [flushInvalidations],\n  );\n\n  // ---- Optimistic unread writes (reconciled by server summaries) ----\n  const bumpUnread = React.useCallback((ticketId: string, createdAt?: string | null) => {\n    setSummary(prev => {\n      const stamp = createdAt ?? new Date().toISOString();\n      const existing = prev.latestUnreadAt[ticketId];\n      return {\n        totalUnread: prev.totalUnread + 1,\n        tickets: { ...prev.tickets, [ticketId]: (prev.tickets[ticketId] ?? 0) + 1 },\n        latestUnreadAt: {\n          ...prev.latestUnreadAt,\n          [ticketId]: existing && stampMs(existing) > stampMs(stamp) ? existing : stamp,\n        },\n      };\n    });\n  }, []);\n\n  const zeroUnread = React.useCallback((ticketId: string) => {\n    setSummary(prev => {\n      const current = prev.tickets[ticketId] ?? 0;\n      if (current === 0) return prev;\n      const tickets = { ...prev.tickets };\n      delete tickets[ticketId];\n      const latestUnreadAt = { ...prev.latestUnreadAt };\n      delete latestUnreadAt[ticketId];\n      return { totalUnread: Math.max(0, prev.totalUnread - current), tickets, latestUnreadAt };\n    });\n  }, []);\n\n  // ---- Stream lifecycle (owned by the SSE CLIENT — the provider only\n  // consumes its consolidated signals) ----\n  const subscriptionRef = React.useRef<SseSubscription | null>(null);\n  const noStreamRef = React.useRef(false);\n\n  // Stable handler refs so the subscription effect doesn't churn.\n  const handlersRef = React.useRef<{\n    onEvent: (eventName: string, data: unknown) => void;\n    onStatus: (status: SseTransportStatus) => void;\n    onConnected: (connected: boolean) => void;\n  }>({ onEvent: () => {}, onStatus: () => {}, onConnected: () => {} });\n\n  const handleConnected = (isConnected: boolean) => {\n    setConnected(isConnected);\n    if (isConnected) {\n      // Event-gap healing on every (re)connect: the SERVER pushes a\n      // fresh summary; the open drawer refetches through the ACL'd path.\n      const openId = openTicketIdRef.current;\n      if (openId) {\n        void queryClient.invalidateQueries({ queryKey: ['ticket-engagements', openId] });\n      }\n    }\n  };\n\n  const handleEvent = (eventName: string, data: unknown) => {\n    if (eventName === 'ticket-summary') {\n      const frame = data as TicketStreamEvent | null;\n      if (isSummaryData(frame?.data)) {\n        setSummary({\n          totalUnread: frame.data.totalUnread,\n          tickets: frame.data.tickets ?? {},\n          latestUnreadAt: frame.data.latestUnreadAt ?? {},\n        });\n      }\n      return;\n    }\n\n    if (eventName === 'ticket-resync') {\n      // Ownership gained / degraded payload — a fresh ticket-summary\n      // frame follows from the server; refresh the query surfaces.\n      scheduleInvalidation();\n      return;\n    }\n\n    if (eventName === 'ticket-status') {\n      // Meaningful ticket-row change (close/reopen/pipeline move). The\n      // server pushes an updated summary right after (closures count as\n      // unread server-side); here we just refresh the query surfaces so\n      // the status badge flips live.\n      const frame = data as TicketStreamEvent | null;\n      const ticketId = (frame?.data as { ticket_external_id?: string } | undefined)?.ticket_external_id;\n      scheduleInvalidation(ticketId);\n      return;\n    }\n\n    if (eventName === 'ticket-message') {\n      const frame = data as TicketStreamEvent | null;\n      const payload = frame?.data;\n      if (!isTicketMessageData(payload)) {\n        scheduleInvalidation();\n        return;\n      }\n      // Always invalidate (own replies from another tab render live);\n      // bump unread ONLY on the server-stamped predicate, and never for\n      // the ticket whose drawer is open. The server's debounced summary\n      // push reconciles moments later.\n      scheduleInvalidation(payload.ticket_external_id);\n      if (payload.countsAsUnread && payload.ticket_external_id !== openTicketIdRef.current) {\n        bumpUnread(payload.ticket_external_id, payload.hubspot_created_at);\n      }\n    }\n  };\n\n  const handleStatus = (status: SseTransportStatus) => {\n    // The client owns connection lifecycle. The only transport status\n    // with DOMAIN meaning is the ticket contract's `no-stream` (204 =\n    // zero owned tickets): remember it so a domain signal (own\n    // create_ticket, window focus) can retry.\n    if (status === 'open') noStreamRef.current = false;\n    if (status === 'no-stream') noStreamRef.current = true;\n  };\n\n  // Publish the three handlers into the stable ref. In an unconditional effect\n  // rather than in the render body: every caller is an SSE transport callback,\n  // which can only fire after a commit, and a render attempt React discards\n  // must not be able to leave a handler behind that closes over state the user\n  // never saw. Declared BEFORE the subscription effect so it is filled first\n  // in the same flush.\n  React.useEffect(() => {\n    handlersRef.current.onConnected = handleConnected;\n    handlersRef.current.onEvent = handleEvent;\n    handlersRef.current.onStatus = handleStatus;\n  });\n\n  // Mount/unmount of the subscription — gated on auth + a usable URL.\n  const streamEnabled = authed && !!streamUrl;\n  React.useEffect(() => {\n    if (!streamEnabled) return undefined;\n    if (typeof window === 'undefined') return undefined;\n\n    subscriptionRef.current = createSseSubscription({\n      url: streamUrl,\n      onEvent: (name, data) => handlersRef.current.onEvent(name, data),\n      onStatusChange: status => handlersRef.current.onStatus(status),\n      onConnectedChange: isConnected => handlersRef.current.onConnected(isConnected),\n      // Long-lived per-user stream: suspend while hidden (scale relief),\n      // resume + reconnect on visible/online — all inside the client.\n      pauseWhenHidden: true,\n    });\n\n    const retryIfIdle = () => {\n      // After a 204 (no-stream), a focus signal is the retry trigger. Only\n      // 204 — the client's contract leaves that retry to the caller; it\n      // retries terminal / 401 states on its own.\n      if (noStreamRef.current) {\n        noStreamRef.current = false;\n        subscriptionRef.current?.reconnectNow();\n      }\n    };\n    window.addEventListener('focus', retryIfIdle);\n\n    return () => {\n      window.removeEventListener('focus', retryIfIdle);\n      if (invalidateTimerRef.current) {\n        clearTimeout(invalidateTimerRef.current);\n        invalidateTimerRef.current = null;\n      }\n      subscriptionRef.current?.close();\n      subscriptionRef.current = null;\n      setConnected(false);\n      setSummary(EMPTY_SUMMARY);\n    };\n    // handlersRef is stable; streamUrl/auth changes remount the stream.\n  }, [streamEnabled, streamUrl]);\n\n  // ---- Public API ----\n  const markRead = React.useCallback(\n    async (ticketExternalId: string) => {\n      try {\n        const response = await embedAuthedFetch(readUrl, {\n          method: 'POST',\n          body: JSON.stringify({ ticket_id: ticketExternalId }),\n        });\n        if (!response.ok) return;\n        // 0-latency local zero, then reconcile with the response's\n        // server-computed summary (THE truth — includes closure\n        // accounting and other tickets).\n        zeroUnread(ticketExternalId);\n        const body = (await response.json().catch(() => null)) as { summary?: TicketUnreadSummary } | null;\n        if (isSummaryData(body?.summary)) {\n          setSummary({\n            totalUnread: body.summary.totalUnread,\n            tickets: body.summary.tickets ?? {},\n            latestUnreadAt: body.summary.latestUnreadAt ?? {},\n          });\n        }\n      } catch {\n        // Non-fatal — the receipt lands on the next markRead; unread\n        // state reconciles via the next server summary push.\n      }\n    },\n    [readUrl, zeroUnread],\n  );\n\n  const setOpenTicketId = React.useCallback((ticketExternalId: string | null) => {\n    openTicketIdRef.current = ticketExternalId;\n    setOpenTicketIdState(ticketExternalId);\n  }, []);\n\n  const notifyTicketCreated = React.useCallback(() => {\n    // Fresh connect → fresh ownership set + fresh server summary\n    // (covers both the no-stream 204 wait state and an already-live\n    // stream whose set predates the new ticket).\n    noStreamRef.current = false;\n    subscriptionRef.current?.reconnectNow();\n  }, []);\n\n  // Derived unread map — open ticket masked to 0 so a server summary\n  // landing inside the markRead debounce window can't transiently\n  // re-badge it.\n  const value = React.useMemo<TicketLiveContextValue>(() => {\n    let unreadByTicket = summary.tickets;\n    let unreadTotal = summary.totalUnread;\n    if (openTicketIdState && unreadByTicket[openTicketIdState]) {\n      const masked = unreadByTicket[openTicketIdState];\n      unreadByTicket = { ...unreadByTicket };\n      delete unreadByTicket[openTicketIdState];\n      unreadTotal = Math.max(0, unreadTotal - masked);\n    }\n    // Ticket with the NEWEST unread reply (compared as parsed epoch ms\n    // via `stampMs` — mixed timezone offsets break string ordering) —\n    // header cell routes there. Falls back to any unread key if a\n    // timestamp is missing.\n    let nextUnreadTicketId: string | null = null;\n    let nextStampMs = 0;\n    for (const id of Object.keys(unreadByTicket)) {\n      const ms = stampMs(summary.latestUnreadAt[id]);\n      if (nextUnreadTicketId === null || ms > nextStampMs) {\n        nextUnreadTicketId = id;\n        nextStampMs = ms;\n      }\n    }\n    return {\n      authed,\n      connected,\n      unreadTotal,\n      unreadByTicket,\n      nextUnreadTicketId,\n      markRead,\n      setOpenTicketId,\n      notifyTicketCreated,\n    };\n  }, [summary, authed, connected, openTicketIdState, markRead, setOpenTicketId, notifyTicketCreated]);\n\n  return <TicketLiveContext.Provider value={enabled ? value : null}>{children}</TicketLiveContext.Provider>;\n}\n","/**\n * Wire shape of a row returned by `POST /api/chat/agent/find-ticket`.\n * Mirrors the executor's projection at `lib/data/hubspot-tools.ts`\n * (`FIND_TICKET_SELECT` / `FindTicketResult`).\n *\n * Cross-repo duplication is INTENTIONAL: this lib ships independently\n * of the hub, so we can't import `FindTicketResult` from\n * `hubspot-tools.ts` directly. If the server adds a column to\n * `FIND_TICKET_SELECT`, also add it here. The smoke test in §F of the\n * plan covers the happy path; a wire-contract test belongs in the hub.\n *\n * `find-ticket` returns `customer_emails: string[]` (jsonb array), NOT\n * a single `customer_email`. The list is server-self-scoped to the\n * caller's session email; the array is exposed for admin/staff\n * surfaces, which the ticket center doesn't render.\n */\nexport interface TicketData {\n  id: string;\n  /** HubSpot ticket id (display number, e.g. \"1234\"). */\n  external_id: string;\n  subject: string | null;\n  /** Short (≤400 char) HTML-stripped preview of the ticket body —\n   *  used for the list-card subtitle when needed. */\n  preview: string | null;\n  /** Longer (≤4k char) sanitized body. INCLUDES every appended\n   *  `content_addendum` comment because the `update_ticket` executor\n   *  reads + re-writes the `content` property server-side with a\n   *  `---` separator. Render this in the drawer's description block\n   *  and the user sees both the original message + every comment they\n   *  (or staff) added. */\n  body: string | null;\n  /** Canonical OPEN | CLOSED (HubSpot pipeline derived). */\n  status: string | null;\n  /** Human label like \"New\" / \"Working on it\" / \"Waiting on contact\" /\n   *  \"Closed\". Drives the badge text; canonical status drives color. */\n  pipeline_stage_label: string | null;\n  clickup_task_id: string | null;\n  /** Snapshot of the linked ClickUp delivery task — populated server-side\n   *  via the `clickup_tasks` mirror when `clickup_task_id` is set. Drives\n   *  the \"Linked delivery\" card surface on the ticket drawer (status\n   *  badge + ClickUp deep link). `null` when no link OR the ClickUp row\n   *  was deleted / not yet synced. */\n  clickup: TicketClickupSummary | null;\n  priority: string | null;\n  customer_emails: string[];\n  customer_company: string | null;\n  /** HubSpot contact's display name. Drives the customer attribution\n   *  on the drawer when the viewer is NOT the customer themselves\n   *  (admin browsing / multi-contact second viewer). Conversations\n   *  API messages don't carry per-message sender info on Custom\n   *  Channels, so this is the only reliable source for \"what's the\n   *  customer's name.\" */\n  customer_name: string | null;\n  /** HubSpot owner id of the agent assigned to this ticket. Carried as\n   *  raw id for debugging; rendering goes through `assignedOwner`. Null\n   *  when unassigned. */\n  assigned_to: string | null;\n  /** Resolved assigned-owner profile — name + email + avatar. Populated\n   *  server-side via `attachOwnerProfiles` which joins through the\n   *  `hubspot_owners` mirror to `profiles` by email. Drives the\n   *  \"Assigned to\" attribution in the drawer header. Null when\n   *  unassigned OR the owner couldn't be resolved (rare — only when\n   *  the agent was deleted from HubSpot between the ticket update and\n   *  the next owners reconcile). */\n  assignedOwner: TicketAssignedOwner | null;\n  hubspot_updated_at: string;\n}\n\n/** Resolved profile of a ticket's assigned agent — surfaced in the\n *  drawer header. Subset of the server's `MirroredOwnerProfile`\n *  trimmed to just the rendering fields. */\nexport interface TicketAssignedOwner {\n  name: string | null;\n  email: string | null;\n  avatarUrl: string | null;\n}\n\n/** Compact projection of a linked ClickUp task — matches the server's\n *  `ClickupSummary` and aligns with `DeliveryItem` so the linked-card\n *  on a ticket can render through the same `DeliveryRow` primitive used\n *  on `/bug-fixes-and-enhancements`. */\nexport interface TicketClickupSummary {\n  /** ClickUp task external_id (e.g. \"86ad4e022\"). Used as the\n   *  `?focus=<id>` URL param to scroll the public delivery page to\n   *  this row. */\n  external_id: string;\n  title: string | null;\n  description: string | null;\n  /** ClickUp status name — e.g. \"complete\" / \"working\" / \"design approved\"\n   *  / \"waiting for release\". Used as the badge label. */\n  status: string | null;\n  /** ClickUp's per-status hex color (e.g. \"#008844\"). Forwarded to the\n   *  badge so colors match the ClickUp board exactly. */\n  status_color: string | null;\n  /** Bucket — `'backlog' | 'working' | 'complete' | 'unknown'`. Used as\n   *  a fallback when status_color is missing. */\n  status_category: string | null;\n  /** ClickUp custom item label (`'Bug'` / `'Request'`) — drives the\n   *  type badge (\"BUG-FIX\" / \"ENHANCEMENT\"). */\n  task_type: string | null;\n  custom_item_id: number | null;\n  /** Every ClickUp list the task is associated with. UI joins with \", \". */\n  list_names: string[];\n  /** Unix-ms timestamps so the row's \"ACTIVE X ago\" subtitle uses the\n   *  shared `getRelativeTime()` helper. */\n  date_opened: number | null;\n  date_updated: number | null;\n  date_closed: number | null;\n  /** Direct https://app.clickup.com/t/<id> deep link. Kept on the wire\n   *  for admin surfaces; the customer-facing linked card navigates\n   *  internally instead. */\n  clickup_url: string | null;\n  /** Composed server-side via the SAME `buildDevSectionUrl` helper the\n   *  chat-inline delivery card uses. Carries `?search=<id>` so the\n   *  delivery list filters to that single task on landing. */\n  delivery_href: string;\n  /** Target platform name for the host's `useNavLink` to decide\n   *  same-tab vs new-tab on cross-platform links. */\n  delivery_target_platform: string;\n  /** Release version label set by the delivery team, e.g. \"0.9\" / \"1.0\".\n   *  Shown beside the status when present. */\n  target_version: string | null;\n}\n\n/**\n * Optimistic placeholder a `submitTicket` call prepends to the list\n * BEFORE the server roundtrip resolves. Drawer is hidden until the\n * real id arrives. The wrapper destructures `_optimistic` before\n * forwarding to `<ChatTicketItem>` so the DOM doesn't see an unknown\n * prop.\n */\nexport interface OptimisticTicket extends TicketData {\n  _optimistic: true;\n}\n\nexport type AnyTicket = TicketData | OptimisticTicket;\n\nexport function isOptimistic(t: AnyTicket): t is OptimisticTicket {\n  return (t as OptimisticTicket)._optimistic === true;\n}\n\n/**\n * Shape of a single `['tickets', …]` TanStack-Query cache slot.\n * Mirrors `FindTicketResponse` in `hooks/use-tickets-list.ts` — kept\n * here because the cache-mutation call sites in `useTicketActions` and\n * `<HelpCenterList>` would otherwise have to redeclare the shape inline.\n *\n * A 2026-05-29 prod regression (`t.map is not a function` on\n * close/reopen) was caused by assuming the cache held a bare\n * `TicketData[]` instead of this wrapper — every helper that calls\n * `queryClient.setQueriesData` / `getQueriesData` on `['tickets']`\n * MUST type the value through this shape and project / reassemble\n * `tickets` explicitly.\n */\nexport interface TicketsCacheSlot {\n  tickets?: TicketData[];\n  count?: number;\n  totalCount?: number;\n  page?: number;\n  pageSize?: number;\n  totalPages?: number;\n  scope?: 'self' | 'all';\n}\n\n/**\n * Stable server-side error codes the ticket-action helpers route\n * through `mapTicketActionError`. Anything else is treated as a generic\n * server error.\n *\n * Reply-specific codes (`HUBSPOT_5XX` / `HUBSPOT_400_VALIDATION` /\n * `HUBSPOT_404_THREAD` / `HUBSPOT_REPLY_UNKNOWN`) drive the drawer\n * banner that appears above the composer when a customer reply fails.\n * Distinct from `HUBSPOT_DISCONNECTED` (whole-system) and\n * `TICKET_NOT_FOUND` (terminal-row) — the reply codes are per-attempt\n * + retryable except for `HUBSPOT_404_THREAD`.\n */\nexport type TicketActionErrorCode =\n  | 'PROPOSAL_NOT_CLAIMABLE'\n  | 'TICKET_NOT_FOUND'\n  | 'TICKET_OWNERSHIP_DENIED'\n  | 'HUBSPOT_DISCONNECTED'\n  | 'RATE_LIMITED'\n  | 'INVALID_TOOL_ARGS'\n  | 'HUBSPOT_5XX'\n  | 'HUBSPOT_400_VALIDATION'\n  | 'HUBSPOT_404_THREAD'\n  | 'HUBSPOT_REPLY_UNKNOWN'\n  | 'UNKNOWN';\n\nexport interface MappedTicketActionError {\n  code: TicketActionErrorCode;\n  /** Human-readable copy safe to show in a toast. */\n  message: string;\n  /** When true, the form should disable submit + show the\n   *  support-down banner. Set only for HUBSPOT_DISCONNECTED. */\n  supportSystemDown: boolean;\n  /** When true, the helper should remove the affected row optimistically\n   *  (TICKET_NOT_FOUND). */\n  removeRowFromCache: boolean;\n  /** Retry hint surfaced from a 429 response. Caller decides whether\n   *  to mention it in the toast. */\n  retryAfterSeconds?: number;\n}\n\n/**\n * Defensive client-side cap on ticket text (initial content + comment\n * addendums). HubSpot Note engagements accept more, but a 100KB paste\n * should fail fast at the UI rather than burning a server round-trip.\n * Both the open-ticket form and the per-row comment textarea import\n * this so a future server-side hardening only touches one place.\n */\nexport const TICKET_TEXT_MAX_CHARS = 5000;\n\n/**\n * Wire contract of the ticket live stream (`GET /api/chat/agent/\n * ticket-stream`, SSE). Producer (the hub route's `mapEvent`) imports\n * THIS type — same producer/consumer SSOT pattern as\n * `ConversationEngagementWire = TicketEngagement`. A schema drift here\n * would be a silent serialization bug; keep one named contract.\n *\n * Frames carry METADATA ONLY — never message bodies. Content is always\n * refetched through the ACL'd `list-engagements` path (one read path).\n *\n * Event names (`eventType`):\n *   - `ticket-message` — a message row landed in the mirror for one of\n *     the viewer's tickets. `data` carries the metadata.\n *   - `ticket-status`  — a MEANINGFUL ticket-row change (status /\n *     pipeline stage / closure) landed in the mirror. Server-side\n *     old-vs-new diffing drops no-op writes (sync stamps). Clients\n *     invalidate + refetch the summary (closures count as unread\n *     server-side via `closed_at` vs the read receipt).\n *   - `ticket-summary` — the server-computed `TicketUnreadSummary`.\n *     THE stream is the summary webservice: pushed on connect (server-\n *     side resync-on-reconnect) and re-pushed (debounced) after every\n *     delivered event. Clients hold NO summary fetch path.\n *   - `ticket-resync`  — degraded frame: something happened that the\n *     server couldn't fully describe (truncated Realtime payload, or\n *     the connection's ownership set just gained tickets). A fresh\n *     `ticket-summary` follows it; clients invalidate queries.\n *\n * The server also emits `status` frames (`subscribed` / `retrying` /\n * `reconnect_failed`) from the shared SSE utility — clients derive\n * `connected` from those, NOT from the HTTP stream being open.\n */\nexport type TicketStreamEventType = 'ticket-message' | 'ticket-status' | 'ticket-summary' | 'ticket-resync';\n\n/** Metadata payload of a `ticket-message` frame. */\nexport type TicketMessageStreamData = {\n  ticket_external_id: string;\n  /** Mirror row's HubSpot message id. */\n  message_id: string;\n  /** Server-stamped via the same direction predicate the wire mapper\n   *  uses. Clients never re-derive author classification. */\n  authorRole: 'customer' | 'support';\n  /** Server-stamped via the visibility+direction unread predicate\n   *  (`countsAsUnread` in the hub's conversations DAL). ONLY frames\n   *  with `true` may bump client-side unread state. */\n  countsAsUnread: boolean;\n  hubspot_created_at: string | null;\n};\n\n/** Metadata payload of a `ticket-status` frame. */\nexport type TicketStatusStreamData = {\n  ticket_external_id: string;\n  /** Canonical OPEN | CLOSED after the change. */\n  status: string | null;\n  pipeline_stage_label: string | null;\n  closed_at: string | null;\n};\n\nexport interface TicketStreamEvent {\n  eventType: TicketStreamEventType;\n  /** Human-readable label (SSE envelope compat) — clients ignore it. */\n  message: string;\n  /** `ticket-message` → TicketMessageStreamData; `ticket-status` →\n   *  TicketStatusStreamData; `ticket-summary` → TicketUnreadSummary;\n   *  absent on `ticket-resync`. */\n  data?: TicketMessageStreamData | TicketStatusStreamData | TicketUnreadSummary;\n}\n\n/**\n * The SINGLE unread source, delivered EXCLUSIVELY over the stream\n * (`ticket-summary` frames on connect + after events) and in\n * `ticket-read` responses. There is no summary fetch endpoint. Header\n * badge total AND per-row dots both read this via the\n * `TicketLiveProvider` map; missing keys mean 0.\n */\nexport type TicketUnreadSummary = {\n  totalUnread: number;\n  tickets: Record<string, number>;\n  /** ISO timestamp of the NEWEST unread message per ticket (same keys as\n   *  `tickets`). Drives \"route to the most recent update\" on the header\n   *  cell: the ticket with the max value here is `nextUnreadTicketId`. */\n  latestUnreadAt: Record<string, string>;\n};\n\n/**\n * Trailing debounce for `markRead` while the drawer is open and new\n * messages stream in — flushed on drawer close so a fast open/close\n * still persists the receipt. Named beside its sibling cadences so\n * every timing knob lives in one file.\n */\nexport const TICKET_MARK_READ_DEBOUNCE_MS = 2000;\n\n/**\n * Ticket deep-link SSOT — DEFINED in the server-safe param-keys module\n * (`utils/dev-sections/dev-section-param-keys.ts`, beside its sibling\n * `devSectionAnchorId`) because producers span both worlds: the hub's\n * SERVER-side chat-ref builder and the client header cell. Re-exported\n * here so ticket-surface consumers keep one import home.\n */\nexport { TICKET_OPEN_PARAM, buildTicketOpenHref } from '../../utils/dev-sections/dev-section-param-keys';\n\n/**\n * Centralized toast copy. Keep all wording here so QA / localization\n * can find every user-visible string in one file.\n */\nexport const TOAST_COPY = {\n  open_success: { title: 'Ticket opened', description: 'We received your message and will follow up shortly.' },\n  open_mirror_pending: { title: 'Ticket opened', description: 'Syncing — your ticket will appear momentarily.' },\n  close_success: { title: 'Ticket closed' },\n  reopen_success: { title: 'Ticket reopened' },\n  comment_success: { title: 'Comment added' },\n  attach_success: { title: 'Files attached' },\n  // Failure variants are constructed dynamically from MappedTicketActionError.\n} as const;\n"]}

package/dist/{chunk-KDCIYRZV.cjs → chunk-BXE2RZEV.cjs}

@@ -2,11 +2,11 @@
 
 
 
-var _chunkF6LXGP6Scjs = require('./chunk-F6LXGP6S.cjs');
+var _chunkWZYIAKIHcjs = require('./chunk-WZYIAKIH.cjs');
 
 
 
-var _chunk5XPK2QGUcjs = require('./chunk-5XPK2QGU.cjs');
+var _chunkLCENRN2Ncjs = require('./chunk-LCENRN2N.cjs');
 
 
 var _chunkUSKQURNFcjs = require('./chunk-USKQURNF.cjs');
@@ -18,7 +18,7 @@ var _chunkUSKQURNFcjs = require('./chunk-USKQURNF.cjs');
 
 
 
-var _chunkEXWS2QSDcjs = require('./chunk-EXWS2QSD.cjs');
+var _chunkCWXRZVDIcjs = require('./chunk-CWXRZVDI.cjs');
 
 
 
@@ -132,14 +132,14 @@ function OnboardingGuidesCatalogView({
     });
   };
   const source = _nullishCoalesce(_optionalChain([runtime, 'optionalAccess', _6 => _6.source]), () => ( "openframe"));
-  const docSearch = _chunk5XPK2QGUcjs.useDocSearch.call(void 0, {
+  const docSearch = _chunkLCENRN2Ncjs.useDocSearch.call(void 0, {
     source,
     baseRoute: basePath,
     onNavigate: (path) => router.push(path),
     tableIds: ["onboarding-guides"]
   });
   const defaultRenderCard = (guide) => {
-    const cta = _chunkEXWS2QSDcjs.resolveContentHref.call(void 0, _optionalChain([runtime, 'optionalAccess', _7 => _7.composeContentUrl]), {
+    const cta = _chunkCWXRZVDIcjs.resolveContentHref.call(void 0, _optionalChain([runtime, 'optionalAccess', _7 => _7.composeContentUrl]), {
       type: "onboarding_guide",
       slug: guide.slug,
       basePath,
@@ -150,7 +150,7 @@ function OnboardingGuidesCatalogView({
   const renderCardFn = _nullishCoalesce(renderCard, () => ( defaultRenderCard));
   const preControls = /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, "div", { className: "space-y-4", children: [
     /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-      _chunk5XPK2QGUcjs.DocSearchBar,
+      _chunkLCENRN2Ncjs.DocSearchBar,
       {
         placeholder: "Search onboarding guides, releases, case studies\u2026",
         query: docSearch.query,
@@ -162,7 +162,7 @@ function OnboardingGuidesCatalogView({
       }
     ),
     sections.length > 0 && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-      _chunkEXWS2QSDcjs.FilterPillRow,
+      _chunkCWXRZVDIcjs.FilterPillRow,
       {
         label: "Section",
         selectedValue: activeSection,
@@ -172,7 +172,7 @@ function OnboardingGuidesCatalogView({
     )
   ] });
   if (selfFetch && guidesRes.error) {
-    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkEXWS2QSDcjs.LoadError, { message: "Failed to load onboarding guides.", onRetry: guidesRes.reload });
+    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkCWXRZVDIcjs.LoadError, { message: "Failed to load onboarding guides.", onRetry: guidesRes.reload });
   }
   if (selfFetch && guidesRes.data == null && isLoading) {
     return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, OnboardingGuidesCatalogSkeleton, {});
@@ -204,7 +204,7 @@ function OnboardingGuideDetailView({
   slug,
   guideEndpoint,
   related = [],
-  MarkdownRenderer = _chunkEXWS2QSDcjs.RichMarkdownRenderer,
+  MarkdownRenderer = _chunkCWXRZVDIcjs.RichMarkdownRenderer,
   renderRelatedCard,
   backHref,
   backLabel = "Back to Getting Started",
@@ -216,7 +216,7 @@ function OnboardingGuideDetailView({
   const runtime = _chunkU2YLMFJKcjs.useChatRuntime.call(void 0, );
   const captions = _chunkGZRU2A4Lcjs.useCaptions.call(void 0, );
   const router = _chunkSADRZ4YIcjs.useRouter.call(void 0, );
-  const renderShell = (node) => shell ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkEXWS2QSDcjs.PageShell, { children: node }) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "page-shell-content", children: node });
+  const renderShell = (node) => shell ? /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkCWXRZVDIcjs.PageShell, { children: node }) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "page-shell-content", children: node });
   const url = initialData ? null : slug && guideEndpoint ? guideEndpoint(slug) : null;
   const { data: guide, isLoading, error, reload } = _chunkUSKQURNFcjs.useSelfFetch.call(void 0, url, { initialData });
   const { ref: videoWarmupRef } = _chunkGZRU2A4Lcjs.useVideoWarmup.call(void 0, {
@@ -224,13 +224,13 @@ function OnboardingGuideDetailView({
     supabaseStorageOrigin: _optionalChain([runtime, 'optionalAccess', _9 => _9.endpoints, 'access', _10 => _10.supabaseStorageOrigin])
   });
   if (error || !guide && !isLoading) {
-    return renderShell(/* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkEXWS2QSDcjs.LoadError, { message: "Guide not found.", onRetry: reload }));
+    return renderShell(/* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkCWXRZVDIcjs.LoadError, { message: "Guide not found.", onRetry: reload }));
   }
   if (!guide) {
     return renderShell(
       // Match the loaded page's top offset (TitleBlock's
       // `pt-[var(--spacing-system-l)]`) so content doesn't jump on load.
-      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "pt-[var(--spacing-system-l)]", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkF6LXGP6Scjs.DetailPageSkeleton, { bare: true, showImageGallery: false }) })
+      /* @__PURE__ */ _jsxruntime.jsx.call(void 0, "div", { className: "pt-[var(--spacing-system-l)]", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkWZYIAKIHcjs.DetailPageSkeleton, { bare: true, showImageGallery: false }) })
     );
   }
   const { captionsUrl, highlightCaptionsUrl } = captions.forEntity("onboarding_guide", guide);
@@ -238,7 +238,7 @@ function OnboardingGuideDetailView({
   // worst), so it's the terminal fallback — no trailing `|| undefined` needed.
   _chunkI27PWVWEcjs.buildOgPlaceholderUrl.call(void 0, _optionalChain([runtime, 'optionalAccess', _11 => _11.endpoints]), guide.title, { aspect: "wide" });
   const defaultRenderRelatedCard = (g) => {
-    const cta = _chunkEXWS2QSDcjs.resolveContentHref.call(void 0, _optionalChain([runtime, 'optionalAccess', _12 => _12.composeContentUrl]), {
+    const cta = _chunkCWXRZVDIcjs.resolveContentHref.call(void 0, _optionalChain([runtime, 'optionalAccess', _12 => _12.composeContentUrl]), {
       type: "onboarding_guide",
       slug: g.slug,
       basePath,
@@ -249,14 +249,14 @@ function OnboardingGuideDetailView({
   const renderRelatedCardFn = _nullishCoalesce(renderRelatedCard, () => ( defaultRenderRelatedCard));
   return renderShell(
     /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, 
-      _chunkEXWS2QSDcjs.PageLayout,
+      _chunkCWXRZVDIcjs.PageLayout,
       {
         title: guide.title,
         titleSize: "h1",
         titleWrap: true,
         backButton: { label: backLabel, onClick: () => router.push(resolvedBackHref) },
         children: [
-          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkEXWS2QSDcjs.EntityTagBadges, { tags: guide.onboarding_guide_tags }),
+          /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunkCWXRZVDIcjs.EntityTagBadges, { tags: guide.onboarding_guide_tags }),
           /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
             _chunk53O6PQ3Fcjs.EntityAuthorCard,
             {
@@ -301,7 +301,7 @@ function OnboardingGuideDetailView({
             }
           ),
           /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
-            _chunkF6LXGP6Scjs.ArticleAuthorByline,
+            _chunkWZYIAKIHcjs.ArticleAuthorByline,
             {
               author: _nullishCoalesce(_optionalChain([guide, 'access', _13 => _13.author, 'optionalAccess', _14 => _14.full_name]), () => ( null)),
               avatar: _optionalChain([guide, 'access', _15 => _15.author, 'optionalAccess', _16 => _16.avatar_url]),
@@ -389,4 +389,4 @@ function useOnboardingGuideSections() {
 
 
 exports.OnboardingGuidesCatalogSkeleton = OnboardingGuidesCatalogSkeleton; exports.OnboardingGuidesCatalogView = OnboardingGuidesCatalogView; exports.OnboardingGuideDetailView = OnboardingGuideDetailView; exports.onboardingGuideKeys = onboardingGuideKeys; exports.useOnboardingGuides = useOnboardingGuides; exports.useOnboardingGuide = useOnboardingGuide; exports.useOnboardingGuideSections = useOnboardingGuideSections;
-//# sourceMappingURL=chunk-KDCIYRZV.cjs.map
+//# sourceMappingURL=chunk-BXE2RZEV.cjs.map

package/dist/{chunk-KDCIYRZV.cjs.map → chunk-BXE2RZEV.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-KDCIYRZV.cjs","../src/components/onboarding-guides/onboarding-guides-catalog-view.tsx","../src/components/onboarding-guides/onboarding-guides-catalog-skeleton.tsx","../src/components/onboarding-guides/onboarding-guide-detail-view.tsx","../src/components/onboarding-guides/hooks/use-onboarding-guides.ts"],"names":["jsx","jsxs"],"mappings":"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","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-KDCIYRZV.cjs","sourcesContent":[null,"'use client';\n\n/**\n * Public-facing catalog view for `/onboarding-guides`.\n *\n * Two data modes:\n *   - **controlled** (hub SSR): pass `initialGuides` + `initialSections`\n *     (server-fetched; section changes re-render the host with new props).\n *   - **self-fetching** (config-only embed): omit the data props and pass\n *     `guidesEndpoint` + `sectionsEndpoint` (the api routes). The view fetches\n *     the guides (refetching on `?section=` change) + the section list itself —\n *     no host data layer. (Plain fetch + useEffect, the DeliveryLists pattern.)\n *\n * The view renders ONLY its body + its OWN controls (the RAG `<DocSearchBar>` +\n * dynamic section pills — onboarding's controls are content-driven, unlike the\n * static search/filter the `DevSectionView` chrome ships). It does NOT render the\n * page chrome: the CALLER wraps it in `<DevSectionPage sectionKey=\"onboarding\">`\n * (hero + back button), exactly like the roadmap / releases / delivery pages — so\n * every dev-center surface composes the same way and the view stays embeddable in\n * tabbed contexts. Card hrefs flow through `runtime.composeContentUrl`.\n */\n\nimport { GraduationCap } from 'lucide-react';\nimport { useMemo, useTransition, type ReactNode } from 'react';\n\nimport { useChatRuntime } from '../../contexts/chat-runtime-context';\nimport { useRouter, useSearchParams } from '../../embed-shims';\nimport { useSelfFetch } from '../../hooks/use-self-fetch';\nimport { resolveContentHref } from '../../utils/content-href';\nimport { OnboardingGuideCard } from '../chat/entity-cards/onboarding-guide-card';\nimport type { OnboardingGuide } from '../chat/types/entities/onboarding-guide';\nimport { DocSearchBar, useDocSearch } from '../shared/doc-search';\nimport { LoadError } from '../ui/error-state';\nimport { FilterPillRow } from '../ui/filter-pill-row';\nimport { OnboardingGuidesCatalogSkeleton } from './onboarding-guides-catalog-skeleton';\n\ntype SectionSummary = { section: string; section_order: number; count: number };\n\nexport interface OnboardingGuidesCatalogViewProps {\n  /** Controlled / SSR: server-fetched guides. Omit + pass `guidesEndpoint`\n   *  for the self-fetching config-only mode. */\n  initialGuides?: OnboardingGuide[];\n  initialSections?: SectionSummary[];\n  initialSection?: string;\n  /** Self-fetch: GET list endpoint (the api route). Appends `?section=`. */\n  guidesEndpoint?: string;\n  /** Self-fetch: GET section-summary endpoint (the api route). */\n  sectionsEndpoint?: string;\n  /** Optional per-row card renderer override. */\n  renderCard?: (guide: OnboardingGuide) => ReactNode;\n  /** Base path the catalog is mounted under (fallback href prefix + `?section=`\n   *  push target). Default `/onboarding-guides`. */\n  basePath?: string;\n}\n\nexport function OnboardingGuidesCatalogView({\n  initialGuides,\n  initialSections,\n  initialSection = '',\n  guidesEndpoint,\n  sectionsEndpoint,\n  renderCard,\n  basePath = '/onboarding-guides',\n}: OnboardingGuidesCatalogViewProps) {\n  const router = useRouter();\n  const searchParams = useSearchParams();\n  const [isPending, startTransition] = useTransition();\n  const runtime = useChatRuntime();\n\n  // Self-fetch only when the host supplied NO data but DID give an endpoint.\n  const selfFetch = initialGuides === undefined && guidesEndpoint !== undefined;\n  // Active section: from the URL when self-fetching, from the prop (host RSC\n  // already read the URL server-side) when controlled.\n  const sectionValue = selfFetch ? (searchParams.get('section') ?? '') : initialSection;\n  const activeSection = sectionValue || 'all';\n\n  // Self-fetch the guides (refetched whenever `?section=` changes — it's folded\n  // into the url) + the section summaries. Controlled mode passes `null` urls so\n  // the hook never fetches. The guides fetch carries the error/retry affordance.\n  const guidesQs = sectionValue ? `?section=${encodeURIComponent(sectionValue)}` : '';\n  const guidesRes = useSelfFetch<{ data?: OnboardingGuide[] }>(\n    selfFetch && guidesEndpoint ? `${guidesEndpoint}${guidesQs}` : null,\n  );\n  const sectionsRes = useSelfFetch<SectionSummary[]>(selfFetch && sectionsEndpoint ? sectionsEndpoint : null);\n\n  // Invariant: `guidesRes.data` is `null` until the first fetch resolves, then\n  // `{ data: [...] }`. The `?.data ?? []` chain collapses never-fetched (null) and\n  // legitimately-empty ([]) to the same `[]` — so the first-load skeleton gate below\n  // keys on the OUTER `guidesRes.data == null` to distinguish them (an empty section\n  // toggle keeps the chrome; only a true cold start shows the full-page skeleton).\n  // Memoised because the `??` fallback minted a NEW array on every\n  // render, which made the memo below re-run every time — i.e. do nothing.\n  const guides = useMemo(() => initialGuides ?? guidesRes.data?.data ?? [], [initialGuides, guidesRes.data?.data]);\n  const sections = useMemo(\n    () => initialSections ?? (Array.isArray(sectionsRes.data) ? sectionsRes.data : []),\n    [initialSections, sectionsRes.data],\n  );\n  const isLoading = selfFetch ? guidesRes.isLoading : false;\n\n  // Section grouping. Data arrives already filtered (server-side `?section=`\n  // for the host, or our `?section=` fetch); this just buckets visible rows.\n  const grouped = useMemo(() => {\n    const map = new Map<string, { section_order: number; guides: OnboardingGuide[] }>();\n    for (const g of guides) {\n      const existing = map.get(g.section);\n      if (existing) {\n        if (g.section_order < existing.section_order) existing.section_order = g.section_order;\n        existing.guides.push(g);\n      } else {\n        map.set(g.section, { section_order: g.section_order, guides: [g] });\n      }\n    }\n    for (const entry of map.values()) {\n      entry.guides.sort((a, b) => a.step_order - b.step_order || a.title.localeCompare(b.title));\n    }\n    return Array.from(map.entries())\n      .map(([section, info]) => ({ section, ...info }))\n      .sort((a, b) => a.section_order - b.section_order || a.section.localeCompare(b.section));\n  }, [guides]);\n\n  const sectionFilterOptions = useMemo(\n    () => [\n      { value: 'all', label: `All (${guides.length})` },\n      ...sections.map(s => ({ value: s.section, label: `${s.section} (${s.count})` })),\n    ],\n    [guides.length, sections],\n  );\n\n  // Section pill change → push `?section=X`. Controlled mode: host RSC\n  // re-fetches. Self-fetch mode: our guides effect re-fetches on the URL change.\n  const setSection = (value: string) => {\n    const params = new URLSearchParams(searchParams.toString());\n    if (value === 'all') {\n      params.delete('section');\n    } else {\n      params.set('section', value);\n    }\n    const qs = params.toString();\n    startTransition(() => {\n      router.push(qs ? `${basePath}?${qs}` : basePath);\n    });\n  };\n\n  // Search bar — scoped to onboarding-guides only via RAG-search `tableIds`.\n  const source = runtime?.source ?? 'openframe';\n  const docSearch = useDocSearch({\n    source,\n    baseRoute: basePath,\n    onNavigate: path => router.push(path),\n    tableIds: ['onboarding-guides'],\n  });\n\n  // Per-row card renderer — runtime-composed href, fallback to relative.\n  const defaultRenderCard = (guide: OnboardingGuide) => {\n    const cta = resolveContentHref(runtime?.composeContentUrl, {\n      type: 'onboarding_guide',\n      slug: guide.slug,\n      basePath,\n      platforms: guide.onboarding_guide_platforms,\n    });\n    return <OnboardingGuideCard guide={guide} href={cta.href} targetPlatform={cta.targetPlatform} size=\"catalog\" />;\n  };\n  const renderCardFn = renderCard ?? defaultRenderCard;\n\n  const preControls = (\n    <div className=\"space-y-4\">\n      <DocSearchBar\n        placeholder=\"Search onboarding guides, releases, case studies…\"\n        query={docSearch.query}\n        onQueryChange={docSearch.setQuery}\n        results={docSearch.results}\n        isLoading={docSearch.isLoading}\n        onResultSelect={docSearch.handleResultSelect}\n        showDropdown={docSearch.keepDropdownOpen}\n      />\n      {sections.length > 0 && (\n        <FilterPillRow\n          label=\"Section\"\n          selectedValue={activeSection}\n          onValueChange={setSection}\n          options={sectionFilterOptions}\n        />\n      )}\n    </div>\n  );\n\n  // A failed guides fetch → a RETRYABLE error (not the indistinguishable-from-\n  // empty \"no guides found\" state) — parity with the sibling self-fetch views.\n  if (selfFetch && guidesRes.error) {\n    return <LoadError message=\"Failed to load onboarding guides.\" onRetry={guidesRes.reload} />;\n  }\n  // Full-page skeleton ONLY on the very first load (no data has loaded yet) — a\n  // later section toggle that legitimately returns ZERO guides keeps the page\n  // chrome (search + section pills) and dims the grid via the className below.\n  if (selfFetch && guidesRes.data == null && isLoading) {\n    return <OnboardingGuidesCatalogSkeleton />;\n  }\n\n  return (\n    <div className=\"flex w-full flex-col gap-10\">\n      {preControls}\n      {guides.length === 0 ? (\n        <div className=\"py-16 text-center\">\n          <GraduationCap className=\"mx-auto mb-4 h-12 w-12 text-ods-text-secondary\" />\n          <h2 className=\"mb-2 text-ods-text-primary text-h3\">No onboarding guides found</h2>\n          <p className=\"text-ods-text-secondary text-h6\">\n            {activeSection !== 'all'\n              ? 'No guides in this section yet.'\n              : \"We're working on the onboarding library. Check back soon.\"}\n          </p>\n        </div>\n      ) : (\n        <div className={isPending || isLoading ? 'space-y-10 opacity-60 transition-opacity' : 'space-y-10'}>\n          {grouped.map(sec => (\n            <section key={sec.section} className=\"space-y-4\">\n              <h2 className=\"flex items-center gap-2 text-ods-text-primary text-h3\">\n                {sec.section}\n                <span className=\"inline-flex items-center justify-center rounded-full bg-ods-text-secondary/20 px-2 py-0.5 text-ods-text-secondary text-h6\">\n                  {sec.guides.length}\n                </span>\n              </h2>\n              {/* HORIZONTAL catalog list — single column so consecutive steps\n                  read top-to-bottom; a grid would visually reorder them. */}\n              <ul className=\"flex flex-col gap-4\">\n                {sec.guides.map(guide => (\n                  <li key={guide.id}>{renderCardFn(guide)}</li>\n                ))}\n              </ul>\n            </section>\n          ))}\n        </div>\n      )}\n    </div>\n  );\n}\n","'use client';\n\nimport { OnboardingGuideCardSkeleton } from '../chat/entity-cards/onboarding-guide-card';\n\n/**\n * Loading skeleton for `/onboarding-guides` — CHROME-LESS, exactly like the\n * loaded `<OnboardingGuidesCatalogView>`. The HOST page owns the\n * `<DevSectionPage sectionKey=\"onboarding\">` shell (hero + back button);\n * this component renders only what replaces the view: the search/pill\n * placeholder block and the section card lists.\n *\n * HISTORY: this used to mount its own `<DevSectionPage>` — nested inside the\n * page's shell that double-rendered the hero + back button during loading\n * (the view was made chrome-less in the page restructure; the skeleton was\n * missed). Keep BOTH chrome-less.\n *\n * Wrapper mirrors the loaded view's `w-full flex flex-col gap-10`; per-card\n * height matches the loaded catalog card so resolve shifts are zero.\n */\nexport function OnboardingGuidesCatalogSkeleton() {\n  return (\n    <div className=\"flex w-full animate-pulse flex-col gap-10\">\n      {/* Search input placeholder — matches `<SearchInput>` h-12 — plus the\n          section pill row (~74 px incl. padding), same as the loaded\n          preControls block. */}\n      <div className=\"space-y-4\">\n        <div className=\"h-12 w-full rounded-md border border-ods-border bg-ods-card\" />\n        <div className=\"flex flex-wrap items-center gap-3 rounded-lg border border-ods-border bg-ods-card p-4\">\n          <div className=\"h-4 w-14 rounded bg-ods-border/60\" />\n          {[0, 1, 2, 3].map(i => (\n            <div key={i} className=\"h-10 w-24 rounded-md border border-ods-border bg-ods-card\" />\n          ))}\n        </div>\n      </div>\n      <div className=\"space-y-10\">\n        {[4, 3, 3].map((cardCount, sectionIdx) => (\n          <section key={sectionIdx} className=\"space-y-4\">\n            <h2 className=\"flex items-center gap-2 tracking-[-0.36px] text-ods-text-primary text-h3\">\n              <span className=\"h-6 w-40 rounded bg-ods-border/70\" />\n              <span className=\"h-5 w-8 rounded-full bg-ods-text-secondary/20\" />\n            </h2>\n            <ul className=\"flex flex-col gap-4\">\n              {Array.from({ length: cardCount }).map((_, cardIdx) => (\n                <li key={cardIdx}>\n                  <OnboardingGuideCardSkeleton size=\"catalog\" />\n                </li>\n              ))}\n            </ul>\n          </section>\n        ))}\n      </div>\n    </div>\n  );\n}\n","'use client';\n\n/**\n * Public-facing detail view for `/onboarding-guides/<slug>`.\n *\n * Two modes:\n *   - **controlled** (hub SSR): pass `initialData` (a server-fetched guide).\n *   - **self-fetching** (config-only embed): pass `slug` + `guideEndpoint`\n *     (the api route) and the view fetches the guide itself — no host data\n *     layer. (Plain fetch + useEffect, the DeliveryLists pattern.)\n *\n * Everything else flows through lib primitives + the ChatRuntime context\n * (markdown, video warmup, captions, related-card hrefs via\n * `runtime.composeContentUrl`). Optional `MarkdownRenderer` lets hosts swap a\n * renderer with extra plugins.\n */\n\nimport { Fragment, type ComponentType, type ReactNode } from 'react';\nimport { useChatRuntime } from '../../contexts/chat-runtime-context';\nimport { useRouter } from '../../embed-shims';\nimport { useSelfFetch } from '../../hooks/use-self-fetch';\nimport type { VideoTeaser } from '../../types/video-processing';\nimport { resolveContentHref } from '../../utils/content-href';\nimport { buildOgPlaceholderUrl } from '../../utils/og-placeholder';\nimport { EntityAuthorCard } from '../chat/entity-cards/entity-author-card';\nimport { OnboardingGuideCard } from '../chat/entity-cards/onboarding-guide-card';\nimport type { OnboardingGuide } from '../chat/types/entities/onboarding-guide';\nimport { EntityTagBadges } from '../features/entity-tag-badges';\nimport { EntityVideoSection } from '../features/entity-video-section';\nimport { useCaptions } from '../features/use-captions';\nimport { useVideoWarmup } from '../features/use-video-warmup';\nimport { toStripProfile } from '../features/video-bites-shared';\nimport { VideoBitesStrip } from '../features/video-bites-strip';\n// PageShell (max-w-[1920px]) — the guide detail content must share the SAME\n// container sizing as the related-content/FAQ rail the host page renders\n// below it (which uses the wide shell). ArticleDetailLayout (1280px) made\n// the detail block visibly narrower than the rail.\nimport { PageShell } from '../layout/article-detail-layout';\nimport { PageLayout } from '../layout/page-layout';\nimport { ArticleAuthorByline } from '../shared/article-author-byline';\nimport { DetailPageSkeleton } from '../shared/detail-page-skeleton';\nimport { LoadError } from '../ui/error-state';\nimport { RichMarkdownRenderer } from '../ui/markdown';\n\nexport interface OnboardingGuideDetailViewProps {\n  /** Server-fetched guide (controlled / SSR mode). Omit it and pass\n   *  `slug` + `guideEndpoint` for the self-fetching config-only mode. */\n  initialData?: OnboardingGuide;\n  /** Self-fetch: the guide's slug (the host reads it from its route). */\n  slug?: string;\n  /** Self-fetch: builds the GET url for a single guide (the api route).\n   *  e.g. `(s) => \\`/content/api/onboarding-guides/${s}\\``. */\n  guideEndpoint?: (slug: string) => string;\n  related?: OnboardingGuide[];\n  /** Link target for the author name in the metadata grid — the host\n   *  computes it (public author page; absent ⇒ plain text). */\n  authorHref?: string;\n  /** Bio paragraph for the end-of-article author byline. Defaults to the\n   *  guide payload's `author.about` (hubs that hydrate it can omit this). */\n  authorBio?: string | null;\n  /** Byline fallback paragraph when the bio is empty — the host passes its\n   *  platform-aware copy (the lib has no config awareness). Absent ⇒ the\n   *  byline renders nothing below the name when the bio is empty. */\n  fallbackBio?: string | null;\n  /** Optional markdown renderer override. Defaults to lib\n   *  `<RichMarkdownRenderer>`. */\n  MarkdownRenderer?: ComponentType<{ content: string }>;\n  /** Optional per-row related-card renderer override. */\n  renderRelatedCard?: (guide: OnboardingGuide) => ReactNode;\n  /** Back-link target. Defaults to `basePath`. */\n  backHref?: string;\n  /** Back-link label. Defaults to \"Back to Getting Started\". */\n  backLabel?: string;\n  /** Base path the related-card hrefs default to when\n   *  `runtime.composeContentUrl` is not wired. Default `/onboarding-guides`. */\n  basePath?: string;\n  /** Optional slot rendered inside the page chrome, BELOW the article + related\n   *  guides — e.g. the hub's cross-type related-content / FAQ rail. Lets the hub\n   *  mount this view directly (no local wrapper); embedders omit it. */\n  relatedContent?: ReactNode;\n  /** Render the standalone `<PageShell>`. Default true. Pass false when the host\n   *  layout already provides the page container — only the padding box renders,\n   *  avoiding a nested `<main>`. */\n  shell?: boolean;\n}\n\nexport function OnboardingGuideDetailView({\n  authorHref,\n  authorBio,\n  fallbackBio,\n  initialData,\n  slug,\n  guideEndpoint,\n  related = [],\n  MarkdownRenderer = RichMarkdownRenderer,\n  renderRelatedCard,\n  backHref,\n  backLabel = 'Back to Getting Started',\n  basePath = '/onboarding-guides',\n  relatedContent,\n  shell = true,\n}: OnboardingGuideDetailViewProps) {\n  const resolvedBackHref = backHref ?? basePath;\n  const runtime = useChatRuntime();\n  const captions = useCaptions();\n  const router = useRouter();\n  // `shell` true → standalone `<PageShell>`; false → padding-only box (no nested\n  // <main>) for hosts whose layout already provides the container.\n  const renderShell = (node: ReactNode) =>\n    shell ? <PageShell>{node}</PageShell> : <div className=\"page-shell-content\">{node}</div>;\n\n  // Controlled (hub SSR `initialData`) OR self-fetch by slug (config-only embed).\n  const url = initialData ? null : slug && guideEndpoint ? guideEndpoint(slug) : null;\n  const { data: guide, isLoading, error, reload } = useSelfFetch<OnboardingGuide>(url, { initialData });\n\n  // Hooks must run unconditionally — feed them optional-chained values so they\n  // no-op while the guide is still loading.\n  const { ref: videoWarmupRef } = useVideoWarmup<HTMLDivElement>({\n    videoUrl: guide?.main_video_url,\n    supabaseStorageOrigin: runtime?.endpoints.supabaseStorageOrigin,\n  });\n\n  if (error || (!guide && !isLoading)) {\n    return renderShell(<LoadError message=\"Guide not found.\" onRetry={reload} />);\n  }\n  if (!guide) {\n    // Skeleton (not a bare \"Loading…\") for parity with every other shared view —\n    // catalog, roadmap, releases all render a skeleton on first load, so the detail\n    // page shouldn't flash text then content. `bare` + `PageShell` so the loading\n    // state matches the loaded page's full width / padding / min-height.\n    return renderShell(\n      // Match the loaded page's top offset (TitleBlock's\n      // `pt-[var(--spacing-system-l)]`) so content doesn't jump on load.\n      <div className=\"pt-[var(--spacing-system-l)]\">\n        <DetailPageSkeleton bare showImageGallery={false} />\n      </div>,\n    );\n  }\n\n  // Track URLs via the ONE captions configurer (`useCaptions`); same-origin\n  // hosts get the relative `/api/captions/...` default. Zero per-page wiring.\n  const { captionsUrl, highlightCaptionsUrl } = captions.forEntity('onboarding_guide', guide);\n\n  const videoPoster =\n    guide.main_video_thumbnail ||\n    guide.featured_image ||\n    guide.og_image_url ||\n    // `buildOgPlaceholderUrl` always returns a usable string (relative route at\n    // worst), so it's the terminal fallback — no trailing `|| undefined` needed.\n    buildOgPlaceholderUrl(runtime?.endpoints, guide.title, { aspect: 'wide' });\n\n  const defaultRenderRelatedCard = (g: OnboardingGuide) => {\n    const cta = resolveContentHref(runtime?.composeContentUrl, {\n      type: 'onboarding_guide',\n      slug: g.slug,\n      basePath,\n      platforms: g.onboarding_guide_platforms,\n    });\n    return <OnboardingGuideCard guide={g} href={cta.href} targetPlatform={cta.targetPlatform} />;\n  };\n  const renderRelatedCardFn = renderRelatedCard ?? defaultRenderRelatedCard;\n\n  return renderShell(\n    <PageLayout\n      title={guide.title}\n      titleSize=\"h1\"\n      titleWrap\n      backButton={{ label: backLabel, onClick: () => router.push(resolvedBackHref) }}\n    >\n      {/* Tags — flat onboarding_guide_tags[] from entity_tags. */}\n      <EntityTagBadges tags={guide.onboarding_guide_tags} />\n\n      {/* Metadata grid — Section · Step | Published | Author. */}\n      <EntityAuthorCard\n        author={guide.author}\n        authorHref={authorHref}\n        publishedAt={guide.published_at}\n        extraCells={[\n          {\n            value: `${guide.section} · Step ${guide.step_order}`,\n            label: 'Section',\n            uppercase: false,\n          },\n        ]}\n      />\n\n      {/* Video. `main_video_url` (Mux/MP4) and `youtube_url` are independent\n            columns — either populated renders the player. */}\n      {(guide.main_video_url || guide.youtube_url) && (\n        <div ref={videoWarmupRef}>\n          <EntityVideoSection\n            mainVideoUrl={guide.main_video_url}\n            youtubeUrl={guide.youtube_url || undefined}\n            highlightVideoUrl={guide.highlight_video_url}\n            mainVideoPoster={videoPoster}\n            highlightVideoThumbnail={guide.highlight_video_thumbnail || undefined}\n            videoSummary={undefined}\n            videoBites={undefined}\n            title={guide.title}\n            srtContent={guide.srt_content}\n            captionsUrl={captionsUrl}\n            highlightCaptionsUrl={highlightCaptionsUrl}\n            MarkdownRenderer={MarkdownRenderer}\n          />\n        </div>\n      )}\n\n      {/* Markdown body */}\n      {guide.content && (\n        <div className=\"space-y-4\">\n          <MarkdownRenderer content={guide.content} />\n        </div>\n      )}\n\n      {/* Video Bites — unified strip; renders nothing when no published bites. */}\n      <VideoBitesStrip\n        bites={(guide.video_bites as VideoTeaser[] | null) ?? []}\n        filterPublished={true}\n        showTitle={false}\n        profile={toStripProfile(guide.author)}\n        href={`/onboarding-guides/${guide.slug}`}\n      />\n\n      {/* End-of-article author byline (avatar + linked name + bio) — the\n            author DESCRIPTION block every article-shaped detail page renders.\n            Hidden when the guide has no author (the byline returns null). */}\n      <ArticleAuthorByline\n        author={guide.author?.full_name ?? null}\n        avatar={guide.author?.avatar_url}\n        jobTitle={guide.author?.job_title}\n        bio={authorBio ?? guide.author?.about}\n        href={authorHref}\n        fallbackBio={fallbackBio}\n      />\n\n      {/* Related — same-section, ordered by step. */}\n      {related.length > 0 && (\n        <div className=\"space-y-4 border-t border-ods-border pt-8\">\n          <h2 className=\"tracking-[-0.36px] text-ods-text-primary text-h3\">More in {guide.section}</h2>\n          <ul className=\"flex flex-col gap-3\">\n            {related.map(r => (\n              <li key={r.id}>{renderRelatedCardFn(r)}</li>\n            ))}\n          </ul>\n        </div>\n      )}\n\n      {/*\n       * Host slot — cross-type related-content / FAQ rail.\n       *\n       * KEYED DELIBERATELY. This is one member of PageLayout's static children\n       * array, and the only member whose element may be created in a SERVER\n       * component and crossed over the RSC boundary. Static JSX children are\n       * normally exempt from the key warning because `jsxs` runs\n       * `validateChildKeys` and stamps `_store.validated = 1` on each element —\n       * but a slot arriving over the wire is referenced as a lazy chunk wrapper,\n       * so validation marks the WRAPPER and the fulfilled path never copies the\n       * flag onto the revived element. It reaches the reconciler with\n       * `validated: 0, key: null` and warns, blaming PageLayout (the owner of the\n       * enclosing element) rather than anything actually at fault.\n       *\n       * A keyed Fragment emits no DOM, so rendered output is byte-identical.\n       * Do NOT \"fix\" this in PageLayout via `React.Children.toArray` — that would\n       * auto-key every consumer's children and change reconciliation identity for\n       * all of them, and that file carries an explicit FROZEN contract.\n       */}\n      <Fragment key=\"related-content\">{relatedContent}</Fragment>\n    </PageLayout>,\n  );\n}\n","'use client';\n\n/**\n * React Query hooks for Onboarding Guides — PUBLIC reads only.\n *\n * Admin mutations (create/update/delete/publish/stats/save-highlight)\n * stay HUB-side in `hooks/use-onboarding-guides.ts` and import the\n * `onboardingGuideKeys.admin` sub-namespace from this module so the\n * cache namespace `['onboarding-guides']` has a single source of truth.\n *\n * Endpoints (`/api/onboarding-guides*`) are host-supplied — non-Next.js\n * embedders must reverse-proxy the same routes. Same precedent as the\n * tickets list hook.\n */\n\nimport { useQuery } from '@tanstack/react-query';\n\nimport type {\n  OnboardingGuide,\n  OnboardingGuideFilters,\n  OnboardingGuideListResponse,\n  OnboardingGuideSectionSummary,\n} from '../../chat/types/entities/onboarding-guide';\n\n/**\n * Cache key builder for the `['onboarding-guides']` namespace.\n *\n * Includes BOTH public-read sub-keys (`lists`, `list`, `details`,\n * `detail`, `sections`) AND the `admin` sub-namespace. Admin mutations\n * live hub-side but invalidate against this same builder so a single\n * `qc.invalidateQueries({ queryKey: onboardingGuideKeys.all })` from\n * an admin hook also clears the public read cache.\n */\nexport const onboardingGuideKeys = {\n  all: ['onboarding-guides'] as const,\n  lists: () => [...onboardingGuideKeys.all, 'list'] as const,\n  list: (filters: OnboardingGuideFilters) => [...onboardingGuideKeys.lists(), filters] as const,\n  details: () => [...onboardingGuideKeys.all, 'detail'] as const,\n  detail: (slug: string) => [...onboardingGuideKeys.details(), slug] as const,\n  sections: () => [...onboardingGuideKeys.all, 'sections'] as const,\n  admin: {\n    all: ['admin', 'onboarding-guides'] as const,\n    lists: () => ['admin', 'onboarding-guides', 'list'] as const,\n    detail: (slug: string) => ['admin', 'onboarding-guide', slug] as const,\n    stats: () => ['admin', 'onboarding-guides', 'stats'] as const,\n  },\n};\n\nexport function useOnboardingGuides(filters?: OnboardingGuideFilters) {\n  return useQuery({\n    queryKey: onboardingGuideKeys.list(filters || {}),\n    queryFn: async (): Promise<OnboardingGuideListResponse> => {\n      const params = new URLSearchParams();\n      if (filters?.search) params.set('search', filters.search);\n      if (filters?.section) params.set('section', filters.section);\n      if (filters?.limit) params.set('limit', filters.limit.toString());\n      if (filters?.offset) params.set('offset', filters.offset.toString());\n      // Comma-joined, matching the route's `task_ids`-style split. This is the\n      // chat-card loader's path: `ids` ALSO tells the route to drop the\n      // platform scope, so omitting it silently returned a platform-filtered\n      // catalog page under a cache key that claimed to be the id-filtered set.\n      if (filters?.ids?.length) params.set('ids', filters.ids.join(','));\n      const res = await fetch(`/api/onboarding-guides?${params}`);\n      if (!res.ok) throw new Error('Failed to fetch onboarding guides');\n      return (await res.json()) as OnboardingGuideListResponse;\n    },\n  });\n}\n\nexport function useOnboardingGuide(slug: string | undefined) {\n  return useQuery({\n    queryKey: onboardingGuideKeys.detail(slug || ''),\n    queryFn: async (): Promise<OnboardingGuide> => {\n      const res = await fetch(`/api/onboarding-guides/${slug}`);\n      if (!res.ok) throw new Error('Failed to fetch onboarding guide');\n      return (await res.json()) as OnboardingGuide;\n    },\n    enabled: !!slug,\n  });\n}\n\nexport function useOnboardingGuideSections() {\n  return useQuery({\n    queryKey: onboardingGuideKeys.sections(),\n    queryFn: async (): Promise<OnboardingGuideSectionSummary[]> => {\n      const res = await fetch('/api/onboarding-guides/sections');\n      if (!res.ok) throw new Error('Failed to fetch onboarding-guide sections');\n      return (await res.json()) as OnboardingGuideSectionSummary[];\n    },\n    staleTime: 0,\n  });\n}\n"]}
+{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-BXE2RZEV.cjs","../src/components/onboarding-guides/onboarding-guides-catalog-view.tsx","../src/components/onboarding-guides/onboarding-guides-catalog-skeleton.tsx","../src/components/onboarding-guides/onboarding-guide-detail-view.tsx","../src/components/onboarding-guides/hooks/use-onboarding-guides.ts"],"names":["jsx","jsxs"],"mappings":"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","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/chunk-BXE2RZEV.cjs","sourcesContent":[null,"'use client';\n\n/**\n * Public-facing catalog view for `/onboarding-guides`.\n *\n * Two data modes:\n *   - **controlled** (hub SSR): pass `initialGuides` + `initialSections`\n *     (server-fetched; section changes re-render the host with new props).\n *   - **self-fetching** (config-only embed): omit the data props and pass\n *     `guidesEndpoint` + `sectionsEndpoint` (the api routes). The view fetches\n *     the guides (refetching on `?section=` change) + the section list itself —\n *     no host data layer. (Plain fetch + useEffect, the DeliveryLists pattern.)\n *\n * The view renders ONLY its body + its OWN controls (the RAG `<DocSearchBar>` +\n * dynamic section pills — onboarding's controls are content-driven, unlike the\n * static search/filter the `DevSectionView` chrome ships). It does NOT render the\n * page chrome: the CALLER wraps it in `<DevSectionPage sectionKey=\"onboarding\">`\n * (hero + back button), exactly like the roadmap / releases / delivery pages — so\n * every dev-center surface composes the same way and the view stays embeddable in\n * tabbed contexts. Card hrefs flow through `runtime.composeContentUrl`.\n */\n\nimport { GraduationCap } from 'lucide-react';\nimport { useMemo, useTransition, type ReactNode } from 'react';\n\nimport { useChatRuntime } from '../../contexts/chat-runtime-context';\nimport { useRouter, useSearchParams } from '../../embed-shims';\nimport { useSelfFetch } from '../../hooks/use-self-fetch';\nimport { resolveContentHref } from '../../utils/content-href';\nimport { OnboardingGuideCard } from '../chat/entity-cards/onboarding-guide-card';\nimport type { OnboardingGuide } from '../chat/types/entities/onboarding-guide';\nimport { DocSearchBar, useDocSearch } from '../shared/doc-search';\nimport { LoadError } from '../ui/error-state';\nimport { FilterPillRow } from '../ui/filter-pill-row';\nimport { OnboardingGuidesCatalogSkeleton } from './onboarding-guides-catalog-skeleton';\n\ntype SectionSummary = { section: string; section_order: number; count: number };\n\nexport interface OnboardingGuidesCatalogViewProps {\n  /** Controlled / SSR: server-fetched guides. Omit + pass `guidesEndpoint`\n   *  for the self-fetching config-only mode. */\n  initialGuides?: OnboardingGuide[];\n  initialSections?: SectionSummary[];\n  initialSection?: string;\n  /** Self-fetch: GET list endpoint (the api route). Appends `?section=`. */\n  guidesEndpoint?: string;\n  /** Self-fetch: GET section-summary endpoint (the api route). */\n  sectionsEndpoint?: string;\n  /** Optional per-row card renderer override. */\n  renderCard?: (guide: OnboardingGuide) => ReactNode;\n  /** Base path the catalog is mounted under (fallback href prefix + `?section=`\n   *  push target). Default `/onboarding-guides`. */\n  basePath?: string;\n}\n\nexport function OnboardingGuidesCatalogView({\n  initialGuides,\n  initialSections,\n  initialSection = '',\n  guidesEndpoint,\n  sectionsEndpoint,\n  renderCard,\n  basePath = '/onboarding-guides',\n}: OnboardingGuidesCatalogViewProps) {\n  const router = useRouter();\n  const searchParams = useSearchParams();\n  const [isPending, startTransition] = useTransition();\n  const runtime = useChatRuntime();\n\n  // Self-fetch only when the host supplied NO data but DID give an endpoint.\n  const selfFetch = initialGuides === undefined && guidesEndpoint !== undefined;\n  // Active section: from the URL when self-fetching, from the prop (host RSC\n  // already read the URL server-side) when controlled.\n  const sectionValue = selfFetch ? (searchParams.get('section') ?? '') : initialSection;\n  const activeSection = sectionValue || 'all';\n\n  // Self-fetch the guides (refetched whenever `?section=` changes — it's folded\n  // into the url) + the section summaries. Controlled mode passes `null` urls so\n  // the hook never fetches. The guides fetch carries the error/retry affordance.\n  const guidesQs = sectionValue ? `?section=${encodeURIComponent(sectionValue)}` : '';\n  const guidesRes = useSelfFetch<{ data?: OnboardingGuide[] }>(\n    selfFetch && guidesEndpoint ? `${guidesEndpoint}${guidesQs}` : null,\n  );\n  const sectionsRes = useSelfFetch<SectionSummary[]>(selfFetch && sectionsEndpoint ? sectionsEndpoint : null);\n\n  // Invariant: `guidesRes.data` is `null` until the first fetch resolves, then\n  // `{ data: [...] }`. The `?.data ?? []` chain collapses never-fetched (null) and\n  // legitimately-empty ([]) to the same `[]` — so the first-load skeleton gate below\n  // keys on the OUTER `guidesRes.data == null` to distinguish them (an empty section\n  // toggle keeps the chrome; only a true cold start shows the full-page skeleton).\n  // Memoised because the `??` fallback minted a NEW array on every\n  // render, which made the memo below re-run every time — i.e. do nothing.\n  const guides = useMemo(() => initialGuides ?? guidesRes.data?.data ?? [], [initialGuides, guidesRes.data?.data]);\n  const sections = useMemo(\n    () => initialSections ?? (Array.isArray(sectionsRes.data) ? sectionsRes.data : []),\n    [initialSections, sectionsRes.data],\n  );\n  const isLoading = selfFetch ? guidesRes.isLoading : false;\n\n  // Section grouping. Data arrives already filtered (server-side `?section=`\n  // for the host, or our `?section=` fetch); this just buckets visible rows.\n  const grouped = useMemo(() => {\n    const map = new Map<string, { section_order: number; guides: OnboardingGuide[] }>();\n    for (const g of guides) {\n      const existing = map.get(g.section);\n      if (existing) {\n        if (g.section_order < existing.section_order) existing.section_order = g.section_order;\n        existing.guides.push(g);\n      } else {\n        map.set(g.section, { section_order: g.section_order, guides: [g] });\n      }\n    }\n    for (const entry of map.values()) {\n      entry.guides.sort((a, b) => a.step_order - b.step_order || a.title.localeCompare(b.title));\n    }\n    return Array.from(map.entries())\n      .map(([section, info]) => ({ section, ...info }))\n      .sort((a, b) => a.section_order - b.section_order || a.section.localeCompare(b.section));\n  }, [guides]);\n\n  const sectionFilterOptions = useMemo(\n    () => [\n      { value: 'all', label: `All (${guides.length})` },\n      ...sections.map(s => ({ value: s.section, label: `${s.section} (${s.count})` })),\n    ],\n    [guides.length, sections],\n  );\n\n  // Section pill change → push `?section=X`. Controlled mode: host RSC\n  // re-fetches. Self-fetch mode: our guides effect re-fetches on the URL change.\n  const setSection = (value: string) => {\n    const params = new URLSearchParams(searchParams.toString());\n    if (value === 'all') {\n      params.delete('section');\n    } else {\n      params.set('section', value);\n    }\n    const qs = params.toString();\n    startTransition(() => {\n      router.push(qs ? `${basePath}?${qs}` : basePath);\n    });\n  };\n\n  // Search bar — scoped to onboarding-guides only via RAG-search `tableIds`.\n  const source = runtime?.source ?? 'openframe';\n  const docSearch = useDocSearch({\n    source,\n    baseRoute: basePath,\n    onNavigate: path => router.push(path),\n    tableIds: ['onboarding-guides'],\n  });\n\n  // Per-row card renderer — runtime-composed href, fallback to relative.\n  const defaultRenderCard = (guide: OnboardingGuide) => {\n    const cta = resolveContentHref(runtime?.composeContentUrl, {\n      type: 'onboarding_guide',\n      slug: guide.slug,\n      basePath,\n      platforms: guide.onboarding_guide_platforms,\n    });\n    return <OnboardingGuideCard guide={guide} href={cta.href} targetPlatform={cta.targetPlatform} size=\"catalog\" />;\n  };\n  const renderCardFn = renderCard ?? defaultRenderCard;\n\n  const preControls = (\n    <div className=\"space-y-4\">\n      <DocSearchBar\n        placeholder=\"Search onboarding guides, releases, case studies…\"\n        query={docSearch.query}\n        onQueryChange={docSearch.setQuery}\n        results={docSearch.results}\n        isLoading={docSearch.isLoading}\n        onResultSelect={docSearch.handleResultSelect}\n        showDropdown={docSearch.keepDropdownOpen}\n      />\n      {sections.length > 0 && (\n        <FilterPillRow\n          label=\"Section\"\n          selectedValue={activeSection}\n          onValueChange={setSection}\n          options={sectionFilterOptions}\n        />\n      )}\n    </div>\n  );\n\n  // A failed guides fetch → a RETRYABLE error (not the indistinguishable-from-\n  // empty \"no guides found\" state) — parity with the sibling self-fetch views.\n  if (selfFetch && guidesRes.error) {\n    return <LoadError message=\"Failed to load onboarding guides.\" onRetry={guidesRes.reload} />;\n  }\n  // Full-page skeleton ONLY on the very first load (no data has loaded yet) — a\n  // later section toggle that legitimately returns ZERO guides keeps the page\n  // chrome (search + section pills) and dims the grid via the className below.\n  if (selfFetch && guidesRes.data == null && isLoading) {\n    return <OnboardingGuidesCatalogSkeleton />;\n  }\n\n  return (\n    <div className=\"flex w-full flex-col gap-10\">\n      {preControls}\n      {guides.length === 0 ? (\n        <div className=\"py-16 text-center\">\n          <GraduationCap className=\"mx-auto mb-4 h-12 w-12 text-ods-text-secondary\" />\n          <h2 className=\"mb-2 text-ods-text-primary text-h3\">No onboarding guides found</h2>\n          <p className=\"text-ods-text-secondary text-h6\">\n            {activeSection !== 'all'\n              ? 'No guides in this section yet.'\n              : \"We're working on the onboarding library. Check back soon.\"}\n          </p>\n        </div>\n      ) : (\n        <div className={isPending || isLoading ? 'space-y-10 opacity-60 transition-opacity' : 'space-y-10'}>\n          {grouped.map(sec => (\n            <section key={sec.section} className=\"space-y-4\">\n              <h2 className=\"flex items-center gap-2 text-ods-text-primary text-h3\">\n                {sec.section}\n                <span className=\"inline-flex items-center justify-center rounded-full bg-ods-text-secondary/20 px-2 py-0.5 text-ods-text-secondary text-h6\">\n                  {sec.guides.length}\n                </span>\n              </h2>\n              {/* HORIZONTAL catalog list — single column so consecutive steps\n                  read top-to-bottom; a grid would visually reorder them. */}\n              <ul className=\"flex flex-col gap-4\">\n                {sec.guides.map(guide => (\n                  <li key={guide.id}>{renderCardFn(guide)}</li>\n                ))}\n              </ul>\n            </section>\n          ))}\n        </div>\n      )}\n    </div>\n  );\n}\n","'use client';\n\nimport { OnboardingGuideCardSkeleton } from '../chat/entity-cards/onboarding-guide-card';\n\n/**\n * Loading skeleton for `/onboarding-guides` — CHROME-LESS, exactly like the\n * loaded `<OnboardingGuidesCatalogView>`. The HOST page owns the\n * `<DevSectionPage sectionKey=\"onboarding\">` shell (hero + back button);\n * this component renders only what replaces the view: the search/pill\n * placeholder block and the section card lists.\n *\n * HISTORY: this used to mount its own `<DevSectionPage>` — nested inside the\n * page's shell that double-rendered the hero + back button during loading\n * (the view was made chrome-less in the page restructure; the skeleton was\n * missed). Keep BOTH chrome-less.\n *\n * Wrapper mirrors the loaded view's `w-full flex flex-col gap-10`; per-card\n * height matches the loaded catalog card so resolve shifts are zero.\n */\nexport function OnboardingGuidesCatalogSkeleton() {\n  return (\n    <div className=\"flex w-full animate-pulse flex-col gap-10\">\n      {/* Search input placeholder — matches `<SearchInput>` h-12 — plus the\n          section pill row (~74 px incl. padding), same as the loaded\n          preControls block. */}\n      <div className=\"space-y-4\">\n        <div className=\"h-12 w-full rounded-md border border-ods-border bg-ods-card\" />\n        <div className=\"flex flex-wrap items-center gap-3 rounded-lg border border-ods-border bg-ods-card p-4\">\n          <div className=\"h-4 w-14 rounded bg-ods-border/60\" />\n          {[0, 1, 2, 3].map(i => (\n            <div key={i} className=\"h-10 w-24 rounded-md border border-ods-border bg-ods-card\" />\n          ))}\n        </div>\n      </div>\n      <div className=\"space-y-10\">\n        {[4, 3, 3].map((cardCount, sectionIdx) => (\n          <section key={sectionIdx} className=\"space-y-4\">\n            <h2 className=\"flex items-center gap-2 tracking-[-0.36px] text-ods-text-primary text-h3\">\n              <span className=\"h-6 w-40 rounded bg-ods-border/70\" />\n              <span className=\"h-5 w-8 rounded-full bg-ods-text-secondary/20\" />\n            </h2>\n            <ul className=\"flex flex-col gap-4\">\n              {Array.from({ length: cardCount }).map((_, cardIdx) => (\n                <li key={cardIdx}>\n                  <OnboardingGuideCardSkeleton size=\"catalog\" />\n                </li>\n              ))}\n            </ul>\n          </section>\n        ))}\n      </div>\n    </div>\n  );\n}\n","'use client';\n\n/**\n * Public-facing detail view for `/onboarding-guides/<slug>`.\n *\n * Two modes:\n *   - **controlled** (hub SSR): pass `initialData` (a server-fetched guide).\n *   - **self-fetching** (config-only embed): pass `slug` + `guideEndpoint`\n *     (the api route) and the view fetches the guide itself — no host data\n *     layer. (Plain fetch + useEffect, the DeliveryLists pattern.)\n *\n * Everything else flows through lib primitives + the ChatRuntime context\n * (markdown, video warmup, captions, related-card hrefs via\n * `runtime.composeContentUrl`). Optional `MarkdownRenderer` lets hosts swap a\n * renderer with extra plugins.\n */\n\nimport { Fragment, type ComponentType, type ReactNode } from 'react';\nimport { useChatRuntime } from '../../contexts/chat-runtime-context';\nimport { useRouter } from '../../embed-shims';\nimport { useSelfFetch } from '../../hooks/use-self-fetch';\nimport type { VideoTeaser } from '../../types/video-processing';\nimport { resolveContentHref } from '../../utils/content-href';\nimport { buildOgPlaceholderUrl } from '../../utils/og-placeholder';\nimport { EntityAuthorCard } from '../chat/entity-cards/entity-author-card';\nimport { OnboardingGuideCard } from '../chat/entity-cards/onboarding-guide-card';\nimport type { OnboardingGuide } from '../chat/types/entities/onboarding-guide';\nimport { EntityTagBadges } from '../features/entity-tag-badges';\nimport { EntityVideoSection } from '../features/entity-video-section';\nimport { useCaptions } from '../features/use-captions';\nimport { useVideoWarmup } from '../features/use-video-warmup';\nimport { toStripProfile } from '../features/video-bites-shared';\nimport { VideoBitesStrip } from '../features/video-bites-strip';\n// PageShell (max-w-[1920px]) — the guide detail content must share the SAME\n// container sizing as the related-content/FAQ rail the host page renders\n// below it (which uses the wide shell). ArticleDetailLayout (1280px) made\n// the detail block visibly narrower than the rail.\nimport { PageShell } from '../layout/article-detail-layout';\nimport { PageLayout } from '../layout/page-layout';\nimport { ArticleAuthorByline } from '../shared/article-author-byline';\nimport { DetailPageSkeleton } from '../shared/detail-page-skeleton';\nimport { LoadError } from '../ui/error-state';\nimport { RichMarkdownRenderer } from '../ui/markdown';\n\nexport interface OnboardingGuideDetailViewProps {\n  /** Server-fetched guide (controlled / SSR mode). Omit it and pass\n   *  `slug` + `guideEndpoint` for the self-fetching config-only mode. */\n  initialData?: OnboardingGuide;\n  /** Self-fetch: the guide's slug (the host reads it from its route). */\n  slug?: string;\n  /** Self-fetch: builds the GET url for a single guide (the api route).\n   *  e.g. `(s) => \\`/content/api/onboarding-guides/${s}\\``. */\n  guideEndpoint?: (slug: string) => string;\n  related?: OnboardingGuide[];\n  /** Link target for the author name in the metadata grid — the host\n   *  computes it (public author page; absent ⇒ plain text). */\n  authorHref?: string;\n  /** Bio paragraph for the end-of-article author byline. Defaults to the\n   *  guide payload's `author.about` (hubs that hydrate it can omit this). */\n  authorBio?: string | null;\n  /** Byline fallback paragraph when the bio is empty — the host passes its\n   *  platform-aware copy (the lib has no config awareness). Absent ⇒ the\n   *  byline renders nothing below the name when the bio is empty. */\n  fallbackBio?: string | null;\n  /** Optional markdown renderer override. Defaults to lib\n   *  `<RichMarkdownRenderer>`. */\n  MarkdownRenderer?: ComponentType<{ content: string }>;\n  /** Optional per-row related-card renderer override. */\n  renderRelatedCard?: (guide: OnboardingGuide) => ReactNode;\n  /** Back-link target. Defaults to `basePath`. */\n  backHref?: string;\n  /** Back-link label. Defaults to \"Back to Getting Started\". */\n  backLabel?: string;\n  /** Base path the related-card hrefs default to when\n   *  `runtime.composeContentUrl` is not wired. Default `/onboarding-guides`. */\n  basePath?: string;\n  /** Optional slot rendered inside the page chrome, BELOW the article + related\n   *  guides — e.g. the hub's cross-type related-content / FAQ rail. Lets the hub\n   *  mount this view directly (no local wrapper); embedders omit it. */\n  relatedContent?: ReactNode;\n  /** Render the standalone `<PageShell>`. Default true. Pass false when the host\n   *  layout already provides the page container — only the padding box renders,\n   *  avoiding a nested `<main>`. */\n  shell?: boolean;\n}\n\nexport function OnboardingGuideDetailView({\n  authorHref,\n  authorBio,\n  fallbackBio,\n  initialData,\n  slug,\n  guideEndpoint,\n  related = [],\n  MarkdownRenderer = RichMarkdownRenderer,\n  renderRelatedCard,\n  backHref,\n  backLabel = 'Back to Getting Started',\n  basePath = '/onboarding-guides',\n  relatedContent,\n  shell = true,\n}: OnboardingGuideDetailViewProps) {\n  const resolvedBackHref = backHref ?? basePath;\n  const runtime = useChatRuntime();\n  const captions = useCaptions();\n  const router = useRouter();\n  // `shell` true → standalone `<PageShell>`; false → padding-only box (no nested\n  // <main>) for hosts whose layout already provides the container.\n  const renderShell = (node: ReactNode) =>\n    shell ? <PageShell>{node}</PageShell> : <div className=\"page-shell-content\">{node}</div>;\n\n  // Controlled (hub SSR `initialData`) OR self-fetch by slug (config-only embed).\n  const url = initialData ? null : slug && guideEndpoint ? guideEndpoint(slug) : null;\n  const { data: guide, isLoading, error, reload } = useSelfFetch<OnboardingGuide>(url, { initialData });\n\n  // Hooks must run unconditionally — feed them optional-chained values so they\n  // no-op while the guide is still loading.\n  const { ref: videoWarmupRef } = useVideoWarmup<HTMLDivElement>({\n    videoUrl: guide?.main_video_url,\n    supabaseStorageOrigin: runtime?.endpoints.supabaseStorageOrigin,\n  });\n\n  if (error || (!guide && !isLoading)) {\n    return renderShell(<LoadError message=\"Guide not found.\" onRetry={reload} />);\n  }\n  if (!guide) {\n    // Skeleton (not a bare \"Loading…\") for parity with every other shared view —\n    // catalog, roadmap, releases all render a skeleton on first load, so the detail\n    // page shouldn't flash text then content. `bare` + `PageShell` so the loading\n    // state matches the loaded page's full width / padding / min-height.\n    return renderShell(\n      // Match the loaded page's top offset (TitleBlock's\n      // `pt-[var(--spacing-system-l)]`) so content doesn't jump on load.\n      <div className=\"pt-[var(--spacing-system-l)]\">\n        <DetailPageSkeleton bare showImageGallery={false} />\n      </div>,\n    );\n  }\n\n  // Track URLs via the ONE captions configurer (`useCaptions`); same-origin\n  // hosts get the relative `/api/captions/...` default. Zero per-page wiring.\n  const { captionsUrl, highlightCaptionsUrl } = captions.forEntity('onboarding_guide', guide);\n\n  const videoPoster =\n    guide.main_video_thumbnail ||\n    guide.featured_image ||\n    guide.og_image_url ||\n    // `buildOgPlaceholderUrl` always returns a usable string (relative route at\n    // worst), so it's the terminal fallback — no trailing `|| undefined` needed.\n    buildOgPlaceholderUrl(runtime?.endpoints, guide.title, { aspect: 'wide' });\n\n  const defaultRenderRelatedCard = (g: OnboardingGuide) => {\n    const cta = resolveContentHref(runtime?.composeContentUrl, {\n      type: 'onboarding_guide',\n      slug: g.slug,\n      basePath,\n      platforms: g.onboarding_guide_platforms,\n    });\n    return <OnboardingGuideCard guide={g} href={cta.href} targetPlatform={cta.targetPlatform} />;\n  };\n  const renderRelatedCardFn = renderRelatedCard ?? defaultRenderRelatedCard;\n\n  return renderShell(\n    <PageLayout\n      title={guide.title}\n      titleSize=\"h1\"\n      titleWrap\n      backButton={{ label: backLabel, onClick: () => router.push(resolvedBackHref) }}\n    >\n      {/* Tags — flat onboarding_guide_tags[] from entity_tags. */}\n      <EntityTagBadges tags={guide.onboarding_guide_tags} />\n\n      {/* Metadata grid — Section · Step | Published | Author. */}\n      <EntityAuthorCard\n        author={guide.author}\n        authorHref={authorHref}\n        publishedAt={guide.published_at}\n        extraCells={[\n          {\n            value: `${guide.section} · Step ${guide.step_order}`,\n            label: 'Section',\n            uppercase: false,\n          },\n        ]}\n      />\n\n      {/* Video. `main_video_url` (Mux/MP4) and `youtube_url` are independent\n            columns — either populated renders the player. */}\n      {(guide.main_video_url || guide.youtube_url) && (\n        <div ref={videoWarmupRef}>\n          <EntityVideoSection\n            mainVideoUrl={guide.main_video_url}\n            youtubeUrl={guide.youtube_url || undefined}\n            highlightVideoUrl={guide.highlight_video_url}\n            mainVideoPoster={videoPoster}\n            highlightVideoThumbnail={guide.highlight_video_thumbnail || undefined}\n            videoSummary={undefined}\n            videoBites={undefined}\n            title={guide.title}\n            srtContent={guide.srt_content}\n            captionsUrl={captionsUrl}\n            highlightCaptionsUrl={highlightCaptionsUrl}\n            MarkdownRenderer={MarkdownRenderer}\n          />\n        </div>\n      )}\n\n      {/* Markdown body */}\n      {guide.content && (\n        <div className=\"space-y-4\">\n          <MarkdownRenderer content={guide.content} />\n        </div>\n      )}\n\n      {/* Video Bites — unified strip; renders nothing when no published bites. */}\n      <VideoBitesStrip\n        bites={(guide.video_bites as VideoTeaser[] | null) ?? []}\n        filterPublished={true}\n        showTitle={false}\n        profile={toStripProfile(guide.author)}\n        href={`/onboarding-guides/${guide.slug}`}\n      />\n\n      {/* End-of-article author byline (avatar + linked name + bio) — the\n            author DESCRIPTION block every article-shaped detail page renders.\n            Hidden when the guide has no author (the byline returns null). */}\n      <ArticleAuthorByline\n        author={guide.author?.full_name ?? null}\n        avatar={guide.author?.avatar_url}\n        jobTitle={guide.author?.job_title}\n        bio={authorBio ?? guide.author?.about}\n        href={authorHref}\n        fallbackBio={fallbackBio}\n      />\n\n      {/* Related — same-section, ordered by step. */}\n      {related.length > 0 && (\n        <div className=\"space-y-4 border-t border-ods-border pt-8\">\n          <h2 className=\"tracking-[-0.36px] text-ods-text-primary text-h3\">More in {guide.section}</h2>\n          <ul className=\"flex flex-col gap-3\">\n            {related.map(r => (\n              <li key={r.id}>{renderRelatedCardFn(r)}</li>\n            ))}\n          </ul>\n        </div>\n      )}\n\n      {/*\n       * Host slot — cross-type related-content / FAQ rail.\n       *\n       * KEYED DELIBERATELY. This is one member of PageLayout's static children\n       * array, and the only member whose element may be created in a SERVER\n       * component and crossed over the RSC boundary. Static JSX children are\n       * normally exempt from the key warning because `jsxs` runs\n       * `validateChildKeys` and stamps `_store.validated = 1` on each element —\n       * but a slot arriving over the wire is referenced as a lazy chunk wrapper,\n       * so validation marks the WRAPPER and the fulfilled path never copies the\n       * flag onto the revived element. It reaches the reconciler with\n       * `validated: 0, key: null` and warns, blaming PageLayout (the owner of the\n       * enclosing element) rather than anything actually at fault.\n       *\n       * A keyed Fragment emits no DOM, so rendered output is byte-identical.\n       * Do NOT \"fix\" this in PageLayout via `React.Children.toArray` — that would\n       * auto-key every consumer's children and change reconciliation identity for\n       * all of them, and that file carries an explicit FROZEN contract.\n       */}\n      <Fragment key=\"related-content\">{relatedContent}</Fragment>\n    </PageLayout>,\n  );\n}\n","'use client';\n\n/**\n * React Query hooks for Onboarding Guides — PUBLIC reads only.\n *\n * Admin mutations (create/update/delete/publish/stats/save-highlight)\n * stay HUB-side in `hooks/use-onboarding-guides.ts` and import the\n * `onboardingGuideKeys.admin` sub-namespace from this module so the\n * cache namespace `['onboarding-guides']` has a single source of truth.\n *\n * Endpoints (`/api/onboarding-guides*`) are host-supplied — non-Next.js\n * embedders must reverse-proxy the same routes. Same precedent as the\n * tickets list hook.\n */\n\nimport { useQuery } from '@tanstack/react-query';\n\nimport type {\n  OnboardingGuide,\n  OnboardingGuideFilters,\n  OnboardingGuideListResponse,\n  OnboardingGuideSectionSummary,\n} from '../../chat/types/entities/onboarding-guide';\n\n/**\n * Cache key builder for the `['onboarding-guides']` namespace.\n *\n * Includes BOTH public-read sub-keys (`lists`, `list`, `details`,\n * `detail`, `sections`) AND the `admin` sub-namespace. Admin mutations\n * live hub-side but invalidate against this same builder so a single\n * `qc.invalidateQueries({ queryKey: onboardingGuideKeys.all })` from\n * an admin hook also clears the public read cache.\n */\nexport const onboardingGuideKeys = {\n  all: ['onboarding-guides'] as const,\n  lists: () => [...onboardingGuideKeys.all, 'list'] as const,\n  list: (filters: OnboardingGuideFilters) => [...onboardingGuideKeys.lists(), filters] as const,\n  details: () => [...onboardingGuideKeys.all, 'detail'] as const,\n  detail: (slug: string) => [...onboardingGuideKeys.details(), slug] as const,\n  sections: () => [...onboardingGuideKeys.all, 'sections'] as const,\n  admin: {\n    all: ['admin', 'onboarding-guides'] as const,\n    lists: () => ['admin', 'onboarding-guides', 'list'] as const,\n    detail: (slug: string) => ['admin', 'onboarding-guide', slug] as const,\n    stats: () => ['admin', 'onboarding-guides', 'stats'] as const,\n  },\n};\n\nexport function useOnboardingGuides(filters?: OnboardingGuideFilters) {\n  return useQuery({\n    queryKey: onboardingGuideKeys.list(filters || {}),\n    queryFn: async (): Promise<OnboardingGuideListResponse> => {\n      const params = new URLSearchParams();\n      if (filters?.search) params.set('search', filters.search);\n      if (filters?.section) params.set('section', filters.section);\n      if (filters?.limit) params.set('limit', filters.limit.toString());\n      if (filters?.offset) params.set('offset', filters.offset.toString());\n      // Comma-joined, matching the route's `task_ids`-style split. This is the\n      // chat-card loader's path: `ids` ALSO tells the route to drop the\n      // platform scope, so omitting it silently returned a platform-filtered\n      // catalog page under a cache key that claimed to be the id-filtered set.\n      if (filters?.ids?.length) params.set('ids', filters.ids.join(','));\n      const res = await fetch(`/api/onboarding-guides?${params}`);\n      if (!res.ok) throw new Error('Failed to fetch onboarding guides');\n      return (await res.json()) as OnboardingGuideListResponse;\n    },\n  });\n}\n\nexport function useOnboardingGuide(slug: string | undefined) {\n  return useQuery({\n    queryKey: onboardingGuideKeys.detail(slug || ''),\n    queryFn: async (): Promise<OnboardingGuide> => {\n      const res = await fetch(`/api/onboarding-guides/${slug}`);\n      if (!res.ok) throw new Error('Failed to fetch onboarding guide');\n      return (await res.json()) as OnboardingGuide;\n    },\n    enabled: !!slug,\n  });\n}\n\nexport function useOnboardingGuideSections() {\n  return useQuery({\n    queryKey: onboardingGuideKeys.sections(),\n    queryFn: async (): Promise<OnboardingGuideSectionSummary[]> => {\n      const res = await fetch('/api/onboarding-guides/sections');\n      if (!res.ok) throw new Error('Failed to fetch onboarding-guide sections');\n      return (await res.json()) as OnboardingGuideSectionSummary[];\n    },\n    staleTime: 0,\n  });\n}\n"]}