@flamingo-stack/openframe-frontend-core 0.0.274 → 0.0.275

package/src/components/tickets/ticket-detail-drawer.tsx

@@ -631,6 +631,7 @@ function AssignedAgentRow({
       </span>
       {displayLabel ? (
         <span className="flex items-center gap-1.5 text-ods-text-primary font-medium">
+          {/* Avatar loads direct; `SquareAvatar`'s own onError falls back to initials. */}
           <SquareAvatar
             size="sm"
             variant="round"

package/src/contexts/chat-runtime-context.tsx

@@ -46,6 +46,15 @@ export interface ChatRuntime {
     chatStreamUrl: string
     /** POST agent approve/reject. Hub: '/api/chat/agent/confirm-tool'. */
     approvalToolUrl: string
+    /** Customer-ticket agent endpoints (Help Center). OPTIONAL — when unset,
+     *  the ticket hooks fall back to the bare hub paths
+     *  (`/api/chat/agent/{find-ticket,ticket-action,list-engagements}`).
+     *  Embedders behind a reverse proxy set these to their proxied paths
+     *  (e.g. `/content/api/chat/agent/...`) so tickets route through the SAME
+     *  endpoint config + proxy as every other endpoint. */
+    findTicketUrl?: string
+    ticketActionUrl?: string
+    listEngagementsUrl?: string
     /** GET slash-command catalog. Hub: '/api/docs/commands'. */
     commandsUrl: string
     /** Build entity-card list URL for a content type + ids. Hub delegates

package/src/hooks/use-contact-submission.ts

@@ -2,6 +2,7 @@ import { useState, useCallback, useEffect } from 'react';
 import { useToast } from "./use-toast";
 import { useRouter } from '../embed-shims/next-navigation';
 import { useRequiredEndpointsRuntime } from '../contexts/endpoints-runtime-context';
+import { contentFetch } from '../utils/embed-content-fetch';
 
 interface ContactSubmissionOptions {
   userId?: string;
@@ -57,7 +58,7 @@ export function useContactSubmission(options: ContactSubmissionOptions = {}) {
     setIsSubmitting(true);
 
     try {
-      const response = await fetch(contactUrl, {
+      const response = await contentFetch(contactUrl, {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({ 

package/src/hooks/use-self-fetch.ts

@@ -1,6 +1,7 @@
 'use client'
 
 import { useEffect, useRef, useState, type Dispatch, type SetStateAction } from 'react'
+import { contentFetch } from '../utils/embed-content-fetch'
 
 export interface UseSelfFetchResult<T> {
   data: T | null
@@ -71,7 +72,7 @@ export function useSelfFetch<T>(
       try {
         setIsLoading(true)
         setError(false)
-        const res = await fetch(url as string, { signal: ctrl.signal })
+        const res = await contentFetch(url as string, { signal: ctrl.signal })
         if (!res.ok) throw new Error(`Request failed (${res.status})`)
         const json = (await res.json()) as T
         if (!cancelled) {

package/src/styles/index.css

@@ -5,6 +5,7 @@
 @import "./ods-responsive-tokens.css";
 @import "./app-globals.css";
 @import "./chat-animations.css";
+@import "./ods-page-shell.css";
 
 /* Vendor/library style overrides */
 @import "./vendor-react-easy-crop.css";

package/src/styles/ods-page-shell.css

@@ -0,0 +1,29 @@
+/* PageShell outer padding.
+ *
+ * Driven by CSS custom properties so an embedder can match its host grid by
+ * setting the vars on ANY ancestor — no prop-threading through the lib wrappers
+ * (DevSectionPage / LegalDocumentPage / ReleaseDetailPage / …), no imperative
+ * global, no React context. The cascade scopes each override to its own subtree
+ * automatically and stays reactive to the media query below.
+ *
+ * Defaults reproduce the hub's canonical wide-page spacing
+ * (`px-6 md:px-20 py-6 md:py-10`). Override vars (all optional):
+ *   --page-shell-px / --page-shell-px-md   horizontal (default 1.5rem / 5rem)
+ *   --page-shell-pt / --page-shell-pt-md   top        (default 1.5rem / 2.5rem)
+ *   --page-shell-pb / --page-shell-pb-md   bottom     (default 1.5rem / 2.5rem)
+ */
+.page-shell-content {
+  padding-left: var(--page-shell-px, 1.5rem);
+  padding-right: var(--page-shell-px, 1.5rem);
+  padding-top: var(--page-shell-pt, 1.5rem);
+  padding-bottom: var(--page-shell-pb, 1.5rem);
+}
+
+@media (min-width: 768px) {
+  .page-shell-content {
+    padding-left: var(--page-shell-px-md, 5rem);
+    padding-right: var(--page-shell-px-md, 5rem);
+    padding-top: var(--page-shell-pt-md, 2.5rem);
+    padding-bottom: var(--page-shell-pb-md, 2.5rem);
+  }
+}

package/src/utils/embed-authed-fetch.ts

@@ -133,6 +133,16 @@ export function setEmbedAuthAdapter(adapter: EmbedAuthAdapter | null): void {
   storeRegisteredAuthAdapter(adapter)
 }
 
+/**
+ * Whether a host auth adapter is currently registered. Lets sibling helpers
+ * (e.g. `contentFetch`) route through `embedAuthedFetch` ONLY when a host has
+ * opted into embedded auth, and stay a plain `fetch` otherwise — so there's a
+ * single auth knob (the adapter), not a second content-fetch registration.
+ */
+export function hasEmbedAuthAdapter(): boolean {
+  return getRegisteredAuthAdapter() !== null
+}
+
 /**
  * `fetch` wrapper that attaches embed-proxy bearer headers (when
  * present in sessionStorage) and forces `credentials: 'same-origin'`

package/src/utils/embed-content-fetch.ts

@@ -0,0 +1,30 @@
+'use client'
+
+/**
+ * `contentFetch` — the fetch the lib's SELF-FETCHING content surfaces use:
+ * roadmap (list + vote + per-task refresh), delivery, product releases,
+ * onboarding guides (catalog + detail), legal docs, and the release-detail
+ * injected roadmap/delivery sections.
+ *
+ * It deliberately reuses the SINGLE embed-auth knob — the registered
+ * `EmbedAuthAdapter` — instead of introducing a second registration:
+ *   - adapter registered (host opted into embedded auth, e.g. openframe-frontend
+ *     for its embedded chat) → route through `embedAuthedFetch`, so content GETs/
+ *     POSTs carry the SAME bearer/cookie + 401-refresh as the chat.
+ *   - no adapter (the public hub, or the embedding example whose proxy injects
+ *     auth server-side) → a plain, byte-for-byte unchanged `fetch`.
+ *
+ * So a host wires auth ONCE (the chat adapter) and content inherits it; there is
+ * no content-specific fetcher to configure.
+ */
+
+import { embedAuthedFetch, hasEmbedAuthAdapter } from './embed-authed-fetch'
+
+export const contentFetch: typeof fetch = (input, init) => {
+  if (!hasEmbedAuthAdapter()) return fetch(input, init)
+  // embedAuthedFetch takes a string url; coerce the broader `fetch` input shape
+  // (content surfaces always pass strings, but handle URL/Request defensively).
+  const url =
+    typeof input === 'string' ? input : input instanceof URL ? input.href : (input as Request).url
+  return embedAuthedFetch(url, init)
+}