@accurix/centrinfo-widget 1.1.0 → 2.0.0

package/dist/{types-CiW6Ilds.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' | 'area' | 'stacked_bar' | 'pie' | 'scatter' | 'funnel';
+  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;
@@ -249,6 +450,7 @@ interface AuthenticatedHistoryMessage {
     url?: string;
   }>;
   visualization?: AnalyticsVisualization;
+  artifacts?: ChatArtifact[];
   createdAt: string;
 }
 interface AuthenticatedHistoryConversation {
@@ -269,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;
@@ -306,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). */
@@ -333,10 +540,12 @@ interface Transport {
   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
@@ -349,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>;
   /**
@@ -369,6 +578,25 @@ 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. */
@@ -416,6 +644,13 @@ 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).
@@ -435,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;
   /**
@@ -604,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';
@@ -621,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[];
@@ -635,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;
@@ -681,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;
@@ -707,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, WidgetThemeTokens as c, ActionType as d, AnalyticsVisualization as f, WidgetStrings as g, Transport as h, Source as i, WidgetUser as l, GifResult as m, ChatMessage as n, WidgetConfig as o, DemoSlotsResult as p, FeaturedLink as r, WidgetHandle as s, BootstrapInfo as t, ActionResult 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.1.0",
+  "version": "2.0.0",
   "private": false,
   "type": "module",
   "sideEffects": [
@@ -59,7 +59,7 @@
   },
   "module": "./dist/index.mjs",
   "peerDependencies": {
-    "@accurix/centrinfo": "^0.1.2"
+    "@accurix/centrinfo": "^0.2.0"
   },
   "publishConfig": {
     "access": "public",