@accurix/centrinfo-widget 1.0.1 → 2.0.0

package/dist/{types-rfkc-TtX.d.cts → types-B0r4SXaT.d.cts}

@@ -8,14 +8,59 @@
  * never produces.
  */
 interface WidgetStrings {
+  /** Optional full-page labels. Older integrations use the core labels as fallbacks. */
+  fullPageNewConversation?: string;
+  fullPageHistory?: string;
+  fullPageShare?: string;
+  fullPageExport?: string;
+  fullPageSupportQueued?: string;
+  fullPageSources?: string;
+  fullPageActions?: string;
+  fullPageDownloadTranscript?: string;
+  fullPageLiveAgent?: string;
+  fullPageAttachmentTooLarge?: string;
+  fullPageAttachmentUnsupported?: string;
+  fullPageAttachmentFailed?: string;
   openChat: string;
   closeChat: string;
+  closeHistory: string;
+  unreadMessage: string;
+  unreadMessages: string;
   muteSounds: string;
   unmuteSounds: string;
   /** Header presence line when the org is reachable. */
   statusOnline: string;
   /** Header presence line when bootstrap was loaded with `offline`. */
   statusOffline: string;
+  liveSupport: string;
+  waitingForTeam: string;
+  assistantName: string;
+  chatName: string;
+  welcomeLabel: string;
+  welcomeEyebrow: string;
+  welcomePrompt: string;
+  agentTyping: string;
+  expandedAnalyticsResult: string;
+  privacyAndData: string;
+  muteMicrophone: string;
+  unmuteMicrophone: string;
+  chooseMicrophone: string;
+  defaultMicrophone: string;
+  microphone: string;
+  talkNow: string;
+  expandView: string;
+  exitExpandedView: string;
+  minimizeVoiceChat: string;
+  endVoiceChat: string;
+  restoreVoiceChat: string;
+  reopenVoiceChat: string;
+  voiceConnecting: string;
+  voiceListening: string;
+  voiceProcessing: string;
+  voiceSpeaking: string;
+  voiceNoise: string;
+  voiceMisunderstood: string;
+  voiceDenied: string;
   composerPlaceholder: string;
   send: string;
   emoji: string;
@@ -23,6 +68,7 @@ interface WidgetStrings {
   attachFile: string;
   recordVoice: string;
   stopRecording: string;
+  actionTestMode: string;
   stop: string;
   copy: string;
   copied: string;
@@ -64,6 +110,11 @@ interface WidgetStrings {
   attaching: string;
   attachTooLarge: string;
   attachFailed: string;
+  removeAttachment: string;
+  dropFileHere: string;
+  clearDeviceData: string;
+  clearDeviceDataBody: string;
+  clearDeviceDataCta: string;
   /** Handoff card (manual follow-up request). */
   handoffTitle: string;
   handoffName: string;
@@ -75,9 +126,32 @@ interface WidgetStrings {
   /** Generic action-form success fallback + error. */
   formThanks: string;
   formError: string;
+  /** Public action drawer chrome. Action-specific copy remains descriptor data. */
+  actionContactOptions: string;
+  actionGetInTouch: string;
+  actionMore: string;
+  actionNeedHelp: string;
+  actionChoose: string;
+  actionFooter: string;
+  actionCategorySupport: string;
+  actionCategorySales: string;
+  actionCategoryMarketing: string;
+  actionClose: string;
+  actionAs: string;
   /** Demo-booking picker. */
   bookingPickTime: string;
+  bookingPickDay: string;
+  bookingPickTimeLabel: string;
   bookingDuration: string;
+  bookingTimezone: string;
+  bookingSchedulerFallback: string;
+  bookingCheckingAvailability: string;
+  bookingNoSlots: string;
+  bookingAvailabilityUnavailable: string;
+  bookingEarlierToday: string;
+  bookingCalendarBusy: string;
+  bookingAlreadyBooked: string;
+  bookingNotOffered: string;
   /** Confirmation after requesting a demo. `{when}` = the chosen slot. */
   bookingRequested: string;
   /** Confirmation when a real calendar event was created. `{when}` = slot. */
@@ -98,11 +172,58 @@ interface WidgetStrings {
 //#endregion
 //#region src/api/types.d.ts
 /** The result metadata that arrives with (or after) an answer. */
+/**
+ * One visitor action, described entirely by the backend.
+ *
+ * Production actions arrive from the backend. A visibly marked test-mode shim
+ * remains only for installations running an older backend response contract.
+ *
+ * `id` is the stable identifier (e.g. `public_book_demo`); it is never shown
+ * to a visitor. Everything a visitor reads is display text the backend may
+ * translate.
+ */
+interface PublicChatActionField {
+  key: string;
+  label: string;
+  kind: 'text' | 'email' | 'tel' | 'textarea';
+  required?: boolean;
+  identity?: 'name' | 'email' | 'phone';
+  placeholder?: string;
+}
+type PublicChatActionReadiness = 'available' | 'degraded' | 'unavailable';
+interface PublicChatAction {
+  id: string;
+  /** POST /public-chat/<endpoint> */
+  endpoint: string;
+  /** Generic renderer selected by the backend contract. Defaults to form. */
+  presentation?: 'form' | 'booking';
+  label: string;
+  description: string;
+  category: 'support' | 'sales' | 'marketing';
+  icon: string;
+  formTitle: string;
+  submitLabel: string;
+  fields: PublicChatActionField[];
+  delivery: string;
+  prompt: string;
+  shortLabel: string;
+  enabled: boolean;
+  readiness: PublicChatActionReadiness;
+  /** Visitor-safe explanation shown when readiness is `degraded`. */
+  readinessNote?: string;
+  /** Client-only compatibility marker. Never emitted by the production catalogue. */
+  legacyFallback?: boolean;
+}
 interface TurnResult {
   answer: string;
   sources: Source[];
   suggestedReplies: string[];
+  /** Legacy: raw tool ids. Prefer `actions`. */
   availableActions: string[];
+  /** Structured action descriptors. Empty on older backends. */
+  actions?: PublicChatAction[];
+  /** Action the backend resolved for this turn — open its form directly. */
+  selectedAction?: string;
   handoffOffered: boolean;
   /** Contact fields the backend wants inline before handoff, e.g. ["email"]. */
   requestedContactFields?: string[];
@@ -116,6 +237,7 @@ interface TurnResult {
   audioBase64?: string;
   mimeType?: string;
   visualization?: AnalyticsVisualization;
+  artifacts?: ChatArtifact[];
 }
 interface AnalyticsVisualizationColumn {
   key: string;
@@ -132,7 +254,7 @@ interface AnalyticsVisualizationColumn {
   groupable?: boolean;
 }
 interface AnalyticsVisualizationRecommendation {
-  type: 'kpi' | 'table' | 'line' | 'area' | 'bar' | 'stacked_bar' | 'pie' | 'scatter' | 'funnel';
+  type: 'kpi' | 'table' | 'line' | 'area' | 'bar' | 'stacked_bar' | 'pie' | 'scatter' | 'funnel' | 'heatmap' | 'radar';
   mode: string;
   categoryField?: string;
   valueFields?: string[];
@@ -141,6 +263,8 @@ interface AnalyticsVisualizationRecommendation {
   confidence?: number;
 }
 interface AnalyticsVisualizationExplanation {
+  conversationalPreface?: string;
+  metricReference?: string;
   headline: string;
   summary: string;
   evidence?: string[];
@@ -162,12 +286,85 @@ interface AnalyticsVisualizationExplanation {
   };
   limitations?: string[];
   followUps?: string[];
-  source: 'governed_result' | 'ai_grounded';
+  source: 'governed_result' | 'ai_grounded' | 'rag_deterministic_analysis' | 'analysis_contract' | string;
+}
+interface AnalyticsVisualizationAnalysis {
+  summary: string;
+  highlights?: Array<{
+    kind: 'value' | 'result' | 'leader' | 'lowest' | 'share' | 'trend' | string;
+    title: string;
+    description: string;
+    field?: string;
+    value?: number;
+    changePercent?: number;
+  }>;
+  suggestedQuestions?: string[];
+  limitations?: string[];
+  method?: 'governed_result' | 'ai_grounded' | 'ai_enhanced' | string;
+}
+interface AnalyticsVisualizationAnalysisIntent {
+  method: string;
+  metric?: string;
+  metricOperation?: 'direct' | 'ratio' | 'rate' | 'share' | string;
+  numeratorMetric?: string;
+  denominatorMetric?: string;
+  timeField?: string;
+  breakdowns?: string[];
+  comparison?: string;
+  requestedAspects?: string[];
+  requestedOutputs?: string[];
+  requestedEntities?: string[];
+  requiredEvidence?: string[];
+  status: 'planned' | 'completed' | 'incomplete' | 'failed' | string;
+  message?: string;
+}
+interface AnalyticsVisualizationAnalysisCoverage {
+  complete: boolean;
+  coveredAspects?: string[];
+  missingAspects?: string[];
+  evidenceKeys?: string[];
+}
+interface AnalyticsVisualizationBusinessAnalysis {
+  type: 'analysis_result';
+  method: string;
+  question: string;
+  answer: string;
+  evidence: Array<{
+    id: string;
+    statement: string;
+    values?: Record<string, unknown>;
+  }>;
+  tables?: Array<{
+    title: string;
+    columns: string[];
+    rows: Array<Record<string, unknown>>;
+  }>;
+  charts?: Array<{
+    type: 'bar' | 'line' | 'scatter' | string;
+    title: string;
+    x: string;
+    y: string;
+    rows: Array<Record<string, unknown>>;
+  }>;
+  confidence: 'low' | 'medium' | 'high';
+  limitations?: string[];
+  recommendedActions?: string[];
+  sources?: Array<{
+    name: string;
+    type: string;
+    entity: string;
+    rowCount: number;
+  }>;
+  quality?: Record<string, unknown>;
+  provenance?: Record<string, unknown>;
+  explanation?: AnalyticsVisualizationExplanation;
+  intent?: AnalyticsVisualizationAnalysisIntent;
+  coverage?: AnalyticsVisualizationAnalysisCoverage;
 }
 interface AnalyticsVisualization {
   version?: number;
   presentation?: 'kpi' | 'chart' | 'table';
-  type: 'kpi' | 'table' | 'bar' | 'line' | 'stacked_bar';
+  type: 'kpi' | 'table' | 'bar' | 'line' | 'area' | 'stacked_bar' | 'pie' | 'scatter' | 'funnel' | 'heatmap' | 'radar';
   title?: string;
   label?: string;
   value?: string;
@@ -211,6 +408,10 @@ interface AnalyticsVisualization {
     isMixed: boolean;
   };
   chartRecommendation?: AnalyticsVisualizationRecommendation;
+  analysis?: AnalyticsVisualizationAnalysis;
+  businessAnalysis?: AnalyticsVisualizationBusinessAnalysis;
+  analysisIntent?: AnalyticsVisualizationAnalysisIntent;
+  analysisCoverage?: AnalyticsVisualizationAnalysisCoverage;
   expandable?: boolean;
   tableAvailable?: boolean;
   downloadAvailable?: boolean;
@@ -238,6 +439,31 @@ interface LiveEventsResult {
   conversationEnded?: boolean;
   events: LiveEvent[];
 }
+interface AuthenticatedHistoryMessage {
+  id: string;
+  role: 'user' | 'assistant' | 'system';
+  content: string;
+  authorName?: string;
+  messageType?: string;
+  sources?: Array<{
+    title?: string;
+    url?: string;
+  }>;
+  visualization?: AnalyticsVisualization;
+  artifacts?: ChatArtifact[];
+  createdAt: string;
+}
+interface AuthenticatedHistoryConversation {
+  sessionId: string;
+  title: string;
+  ended: boolean;
+  lastSeenAt: string;
+  messages: AuthenticatedHistoryMessage[];
+}
+interface AuthenticatedHistoryResult {
+  activeSessionId?: string;
+  conversations: AuthenticatedHistoryConversation[];
+}
 interface StreamCallbacks {
   /** Called with each incremental text chunk. */
   onChunk: (text: string) => void;
@@ -245,7 +471,6 @@ interface StreamCallbacks {
   /** True only for turns sent from the active Speak-with-AI call. */
   voicePlaybackRequested?: boolean;
 }
-type ActionType = 'contact' | 'inquiry' | 'book-demo' | 'request-callback' | 'subscribe-newsletter';
 interface ActionResult {
   ok: boolean;
   note?: string;
@@ -282,6 +507,12 @@ interface BusyRange {
 }
 /** Booking availability for the picker. */
 interface DemoSlotsResult {
+  status?: 'available' | 'request_only' | 'delegated' | 'unavailable';
+  reason?: string;
+  timezone?: string;
+  slotDurationMinutes?: number;
+  /** Exact provider-checked slot instants the visitor may choose. */
+  available?: string[];
   /** Exact slot instants (UTC ISO) already booked via the widget. */
   taken: string[];
   /** Busy ranges from the connected calendar (Google / Outlook). */
@@ -301,16 +532,20 @@ interface GifResult {
  */
 interface Transport {
   bootstrap(): Promise<BootstrapInfo>;
+  /** Server-backed history for the verified SDK customer. Anonymous returns empty. */
+  history(): Promise<AuthenticatedHistoryResult>;
   /** Stream a turn; resolves with final metadata once `done`. */
   stream(question: string, sessionId: string, cb: StreamCallbacks): Promise<TurnResult>;
   /** Poll for staff/system events after a timestamp during live handoff. */
   liveEvents(sessionId: string, after: string): Promise<LiveEventsResult>;
   /** Soft visitor typing hint for the staff console. */
   typing(sessionId: string, isTyping: boolean): Promise<void>;
-  action(type: ActionType, payload: Record<string, unknown>): Promise<ActionResult>;
+  action(type: string, payload: Record<string, unknown>, endpointOverride?: string): Promise<ActionResult>;
   /** Synthesize short widget UI prompts through the token's configured TTS voice. */
   speak(text: string): Promise<SpeechResult>;
   transcribe(audioBase64: string, mimeType: string, languageHint?: string, durationSeconds?: number): Promise<string>;
+  /** Preferred binary voice upload. Optional for backward-compatible custom transports. */
+  transcribeAudio?(audio: Blob, mimeType: string, languageHint?: string, durationSeconds?: number): Promise<string>;
   /**
    * Extract text from a visitor-attached image / PDF via the backend's
    * multimodal endpoint (`POST /public-chat/extract`). The returned text is
@@ -323,8 +558,8 @@ interface Transport {
   /**
    * Booking availability within [fromISO, toISO]: `taken` = exact slot instants
    * already booked via the widget; `busy` = ranges the connected calendar
-   * (Google / Outlook) is occupied. The picker greys out both. Best-effort —
-   * empty when unavailable (the picker then shows everything as open).
+   * (Google / Outlook) is occupied. Connected event calendars fail closed:
+   * provider errors reject this call instead of making every slot look open.
    */
   demoSlots(fromISO: string, toISO: string): Promise<DemoSlotsResult>;
   /**
@@ -342,10 +577,32 @@ interface Transport {
 }
 //#endregion
 //#region src/types.d.ts
+type ChatSurface = 'floating' | 'full-page';
+interface WidgetActionTranslation {
+  label?: string;
+  shortLabel?: string;
+  description?: string;
+  formTitle?: string;
+  submitLabel?: string;
+  delivery?: string;
+  prompt?: string;
+  readinessNote?: string;
+  fields?: Record<string, {
+    label?: string;
+    placeholder?: string;
+  }>;
+}
+interface WidgetTranslationBundle {
+  labels?: Partial<WidgetStrings>;
+  /** Action copy keyed by the stable backend action ID. */
+  actions?: Record<string, WidgetActionTranslation>;
+}
 /** Public configuration surface passed to `Centrinfo.init()` / <CentrinfoWidget>. */
 interface WidgetConfig {
   /** The org's public chat token (`pub_*`). Required. It IS the org identity. */
   token: string;
+  /** Conversation namespace. Set by the SDK surface mounting the chat. */
+  chatSurface?: ChatSurface;
   /** Short-lived server-signed context token for governed customer analytics. */
   analyticsContextToken?: string;
   /** Short-lived SDK customer identity JWT for authenticated chat access. */
@@ -356,6 +613,11 @@ interface WidgetConfig {
   apiBaseUrl?: string;
   /** Brand accent (any CSS color). Overrides the persona/default green. */
   accentColor?: string;
+  /**
+   * Full brand token map for SDK-rendered chat surfaces. `accentColor` remains
+   * a shorthand for `themeTokens.accent` and wins when both are supplied.
+   */
+  themeTokens?: WidgetThemeTokens;
   /** Optional display-name override. Normally loaded from the token bootstrap. */
   agentName?: string;
   /** Optional header avatar URL override. Normally loaded from the token bootstrap. */
@@ -382,14 +644,22 @@ interface WidgetConfig {
    * chat answers themselves are already multilingual server-side.
    */
   labels?: Partial<WidgetStrings>;
+  /** Locale used to select a translation bundle. Defaults to browser locale. */
+  locale?: string;
+  /**
+   * Translation data keyed by locale (`fr`, `fr-CA`, `yo`, ...). Exact locale
+   * wins, then its base language. Explicit `labels` still wins over the pack.
+   */
+  translations?: Record<string, WidgetTranslationBundle>;
   /**
    * Where the visible transcript is stored across reloads:
    * - `local` (default) — `localStorage`, survives browser restarts (30d TTL).
    * - `session` — `sessionStorage`, cleared when the tab closes (better on
    *   shared / kiosk machines so the next visitor can't read prior chats).
    * - `none` — never persisted; the transcript lives only in memory.
-   * The backend session id + memory are unaffected — this is purely the
-   * locally-rendered history.
+   * Authenticated SDK users also restore retained conversations from the
+   * backend on a new browser or device. This setting controls the local cache
+   * and remains the only persistence layer for anonymous visitors.
    */
   persistence?: 'local' | 'session' | 'none';
   /**
@@ -400,6 +670,11 @@ interface WidgetConfig {
   attachments?: boolean;
   /** Stacking context against the host page. */
   zIndex?: number;
+  /**
+   * CSP nonce applied to the fallback inline stylesheet on browsers without
+   * constructable stylesheet support. Pass the nonce used by the host page.
+   */
+  styleNonce?: string;
   /** Use the built-in mock transport (local preview, no backend/token needed). */
   demo?: boolean;
   /**
@@ -437,7 +712,7 @@ interface WidgetConfig {
   /** CSS selector for host-page element(s) that open the widget on click
    * (your own launcher). Listeners are (re)bound automatically. */
   customLauncherSelector?: string;
-  /** Auto-logout (wipe local data) after this many minutes of inactivity.
+  /** Auto-logout (wipe local cache) after this many minutes of inactivity.
    * 0 / omitted = never. Use on shared / kiosk devices. */
   sessionDurationMinutes?: number;
   /**
@@ -473,6 +748,25 @@ interface WidgetConfig {
   onAction?: (action: string) => void;
   onHandoff?: () => void;
 }
+/** Shared theme tokens consumed by the floating widget and full-page chat app. */
+interface WidgetThemeTokens {
+  accent?: string;
+  accentStrong?: string;
+  accentSoft?: string;
+  accentText?: string;
+  background?: string;
+  surface?: string;
+  surfaceMuted?: string;
+  text?: string;
+  mutedText?: string;
+  border?: string;
+  shadow?: string;
+  radius?: string;
+  fontFamily?: string;
+  success?: string;
+  warning?: string;
+  danger?: string;
+}
 /** A B2B company / account the visitor belongs to (Intercom "Company object").
  * Folded into the session metadata for the staff inbox. */
 interface WidgetCompany {
@@ -550,6 +844,19 @@ interface WidgetHandle {
   destroy: () => void;
 }
 /** A rendered chat message. */
+interface ChatArtifact {
+  type: 'image' | 'resource_link' | 'visualization';
+  name?: string;
+  title?: string;
+  caption?: string;
+  altText?: string;
+  mimeType?: 'image/png' | 'image/jpeg' | 'image/webp' | string;
+  /** Base64 only, without a data-URL prefix. */
+  data?: string;
+  uri?: string;
+  /** Local compatibility bridge for the existing governed analytics result. */
+  visualization?: AnalyticsVisualization;
+}
 interface ChatMessage {
   id: string;
   role: 'user' | 'assistant' | 'system';
@@ -567,6 +874,10 @@ interface ChatMessage {
   sources?: Source[];
   suggestedReplies?: string[];
   availableActions?: string[];
+  /** Structured action descriptors from the backend (preferred over ids). */
+  actions?: PublicChatAction[];
+  /** Action the backend resolved for this turn — its form opens directly. */
+  selectedAction?: string;
   handoffOffered?: boolean;
   /** Contact fields requested by final API metadata before handoff. */
   requestedContactFields?: string[];
@@ -581,6 +892,7 @@ interface ChatMessage {
   /** Visitor's 👍/👎 on this assistant reply (persisted so it survives reloads). */
   feedback?: 'up' | 'down';
   visualization?: AnalyticsVisualization;
+  artifacts?: ChatArtifact[];
 }
 interface Source {
   title?: string;
@@ -627,6 +939,8 @@ interface BootstrapInfo {
   memoryRetentionDays: number;
   memoryMessageCap: number;
   availableActions: string[];
+  /** Structured action descriptors. Empty from a backend that predates them. */
+  actions?: PublicChatAction[];
   accentColor?: string;
   /** One-line description under the agent name on the welcome screen (≤500). */
   agentDescription?: string;
@@ -653,6 +967,18 @@ interface SchedulerInfo {
   label?: string;
   mode?: 'event' | 'link';
   bookingLink?: string;
+  availability?: {
+    timezone: string;
+    weekdays: number[];
+    startTime: string;
+    endTime: string;
+    slotDurationMinutes: number;
+    bufferBeforeMinutes: number;
+    bufferAfterMinutes: number;
+    minimumNoticeMinutes: number;
+    bookingWindowDays: number;
+    calendarIds: string[];
+  };
 }
 //#endregion
-export { Visitor as a, WidgetUser as c, AnalyticsVisualization as d, DemoSlotsResult as f, WidgetStrings as h, Source as i, ActionResult as l, Transport as m, ChatMessage as n, WidgetConfig as o, GifResult as p, FeaturedLink as r, WidgetHandle as s, BootstrapInfo as t, ActionType as u };
+export { PublicChatActionField as _, Source as a, WidgetConfig as c, WidgetUser as d, ActionResult as f, PublicChatAction as g, GifResult as h, FeaturedLink as i, WidgetHandle as l, DemoSlotsResult as m, ChatArtifact as n, Visitor as o, AnalyticsVisualization as p, ChatMessage as r, WidgetActionTranslation as s, BootstrapInfo as t, WidgetThemeTokens as u, Transport as v, WidgetStrings as y };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@accurix/centrinfo-widget",
-  "version": "1.0.1",
+  "version": "2.0.0",
   "private": false,
   "type": "module",
   "sideEffects": [
@@ -43,9 +43,6 @@
   "dependencies": {
     "preact": "^10.27.0"
   },
-  "peerDependencies": {
-    "@accurix/centrinfo": "^0.1.1"
-  },
   "devDependencies": {
     "@playwright/test": "^1.50.0",
     "@types/node": "^22.0.0",
@@ -56,10 +53,14 @@
     "typescript": "^5.8.0",
     "vite": "^7.0.0",
     "vitest": "^3.2.0",
+    "wrangler": "^4.91.0",
     "@accurix/centrinfo-results": "^0.1.0",
     "@accurix/web-config-eslint": "^0.0.0"
   },
   "module": "./dist/index.mjs",
+  "peerDependencies": {
+    "@accurix/centrinfo": "^0.2.0"
+  },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"