@giovchat/react-native 0.0.0-stage → 0.3.0

package/src/i18n.ts

@@ -0,0 +1,474 @@
+import { createContext, useContext } from "react";
+
+/**
+ * The SDK's own interface text in the five languages the Giov dashboard ships. Text the business
+ * writes (greeting, placeholder, bot name) comes from the widget configuration and is not translated.
+ * Hosts pick the language with the `locale` prop (default: the device language) and can replace any
+ * string with `strings`.
+ */
+export interface GiovChatStrings {
+  loading: string;
+  tryAgain: string;
+  retry: string;
+  closeChat: string;
+  /** The header menu button. */
+  menu: string;
+  /** The header menu's link to the workspace's privacy policy, as in the web widget. */
+  privacyPolicy: string;
+  /** Spoken when a reply arrives: who wrote it and what they wrote. */
+  newMessage: (sender: string, text: string) => string;
+  connecting: string;
+  reconnecting: string;
+  statusPerson: string;
+  statusBot: string;
+  statusTeam: string;
+  composerPlaceholder: string;
+  messageInput: string;
+  sendMessage: string;
+  attachFile: string;
+  removeAttachment: (name: string) => string;
+  you: string;
+  agent: string;
+  automated: string;
+  botTyping: (name: string) => string;
+  teamTyping: string;
+  sending: string;
+  notSent: string;
+  tapToRetry: string;
+  /** On a message that was not sent, to drop it. */
+  discard: string;
+  uploading: (percent: number) => string;
+  uploadFailed: string;
+  /** Errors, by kind; the SDK never shows raw server text. */
+  sessionExpired: string;
+  conversationEnded: string;
+  unavailable: string;
+  sendFailed: string;
+  busy: string;
+  attachmentsOff: string;
+  typeNotAllowed: (name: string) => string;
+  fileTooLarge: (name: string, maxMb: number) => string;
+  tooManyFiles: (max: number) => string;
+  openAttachment: (name: string) => string;
+  attachment: string;
+  image: string;
+  /** In place of an image that could not load (it loads again once its link is renewed). */
+  imageUnavailable: string;
+  preChatTitle: string;
+  firstName: string;
+  lastName: string;
+  email: string;
+  phone: string;
+  required: (label: string) => string;
+  startChat: string;
+  /** Conversation ratings (the card, the thumbs under GiovBot answers): visible text and screen-reader labels. */
+  rateTitle: string;
+  yourRating: string;
+  /** The five faces, from 1 (Very bad) to 5 (Great). */
+  ratingFace: (score: number) => string;
+  ratingComment: string;
+  ratingSend: string;
+  ratingThanks: string;
+  ratingChange: string;
+  ratingCancel: string;
+  ratingClosed: string;
+  ratingFailed: string;
+  ratingTooMany: string;
+  ratingWait: (seconds: number) => string;
+  answerGroup: string;
+  answerGood: string;
+  answerBad: string;
+  answerReason: string;
+  answerSkip: string;
+  answerFailed: string;
+  closeRating: string;
+  /** Replaces the composer once the team closed the conversation. */
+  startNewConversation: string;
+}
+
+export type GiovChatLocale = "en" | "fr" | "es" | "pt" | "de";
+
+const en: GiovChatStrings = {
+  loading: "Loading…",
+  tryAgain: "Try again",
+  retry: "Retry",
+  closeChat: "Close chat",
+  menu: "Menu",
+  privacyPolicy: "GDPR and privacy",
+  newMessage: (sender, text) => `${sender}: ${text}`,
+  connecting: "Connecting…",
+  reconnecting: "Connection lost. Reconnecting…",
+  statusPerson: "Live agent",
+  statusBot: "AI assistant · Online",
+  statusTeam: "We'll be with you shortly",
+  composerPlaceholder: "Type a message…",
+  messageInput: "Message",
+  sendMessage: "Send message",
+  attachFile: "Attach file",
+  removeAttachment: (name) => `Remove ${name}`,
+  you: "You",
+  agent: "Agent",
+  automated: "Automated",
+  botTyping: (name) => `${name} is typing`,
+  teamTyping: "Support team is typing",
+  sending: "Sending…",
+  notSent: "Not sent",
+  tapToRetry: "Tap to retry",
+  discard: "Discard",
+  uploading: (percent) => `Uploading ${percent}%`,
+  uploadFailed: "File upload failed",
+  sessionExpired: "Chat session expired. Please start a new chat.",
+  conversationEnded: "This conversation has ended.",
+  unavailable: "Chat is unavailable. Please try again.",
+  sendFailed: "Message could not be sent.",
+  busy: "The team is busy right now. Please try again in a moment.",
+  attachmentsOff: "File attachments are turned off for this chat.",
+  typeNotAllowed: (name) => `${name}: this file type is not allowed.`,
+  fileTooLarge: (name, maxMb) => `${name}: files must be ${maxMb} MB or smaller.`,
+  tooManyFiles: (max) => `You can attach up to ${max} files at a time.`,
+  openAttachment: (name) => `Open ${name}`,
+  attachment: "Attachment",
+  image: "Image",
+  imageUnavailable: "Image unavailable",
+  preChatTitle: "Before we start…",
+  firstName: "First name",
+  lastName: "Last name",
+  email: "Email",
+  phone: "Phone",
+  required: (label) => `${label} *`,
+  startChat: "Start chat",
+  rateTitle: "Rate this conversation",
+  yourRating: "Your rating",
+  ratingFace: (score) => ["Very bad", "Bad", "Okay", "Good", "Great"][score - 1] ?? String(score),
+  ratingComment: "Add a comment (optional)",
+  ratingSend: "Send",
+  ratingThanks: "Thanks",
+  ratingChange: "Change",
+  ratingCancel: "Cancel",
+  ratingClosed: "This rating request has closed.",
+  ratingFailed: "Couldn't send. Please try again.",
+  ratingTooMany: "You have changed this rating too many times.",
+  ratingWait: (seconds) => `Too many requests. Please wait ${seconds} s and try again.`,
+  answerGroup: "Rate this answer",
+  answerGood: "Good answer",
+  answerBad: "Bad answer",
+  answerReason: "What went wrong? (optional)",
+  answerSkip: "Skip",
+  answerFailed: "Couldn't save",
+  closeRating: "Close",
+  startNewConversation: "Start a new conversation",
+};
+
+const fr: GiovChatStrings = {
+  loading: "Chargement…",
+  tryAgain: "Réessayer",
+  retry: "Réessayer",
+  closeChat: "Fermer le chat",
+  menu: "Menu",
+  privacyPolicy: "RGPD et confidentialité",
+  newMessage: (sender, text) => `${sender} : ${text}`,
+  connecting: "Connexion…",
+  reconnecting: "Connexion perdue. Reconnexion…",
+  statusPerson: "Conseiller en ligne",
+  statusBot: "Assistant IA · En ligne",
+  statusTeam: "Nous vous répondons très vite",
+  composerPlaceholder: "Écrivez un message…",
+  messageInput: "Message",
+  sendMessage: "Envoyer le message",
+  attachFile: "Joindre un fichier",
+  removeAttachment: (name) => `Retirer ${name}`,
+  you: "Vous",
+  agent: "Conseiller",
+  automated: "Automatique",
+  botTyping: (name) => `${name} écrit`,
+  teamTyping: "L'équipe écrit",
+  sending: "Envoi…",
+  notSent: "Non envoyé",
+  tapToRetry: "Touchez pour réessayer",
+  discard: "Supprimer",
+  uploading: (percent) => `Envoi ${percent} %`,
+  uploadFailed: "Échec de l'envoi du fichier",
+  sessionExpired: "La session de chat a expiré. Démarrez un nouveau chat.",
+  conversationEnded: "Cette conversation est terminée.",
+  unavailable: "Le chat est indisponible. Réessayez.",
+  sendFailed: "Le message n'a pas pu être envoyé.",
+  busy: "L'équipe est très occupée. Réessayez dans un instant.",
+  attachmentsOff: "Les pièces jointes sont désactivées pour ce chat.",
+  typeNotAllowed: (name) => `${name} : ce type de fichier n'est pas autorisé.`,
+  fileTooLarge: (name, maxMb) => `${name} : les fichiers doivent faire ${maxMb} Mo maximum.`,
+  tooManyFiles: (max) => `Vous pouvez joindre jusqu'à ${max} fichiers à la fois.`,
+  openAttachment: (name) => `Ouvrir ${name}`,
+  attachment: "Pièce jointe",
+  image: "Image",
+  imageUnavailable: "Image indisponible",
+  preChatTitle: "Avant de commencer…",
+  firstName: "Prénom",
+  lastName: "Nom",
+  email: "E-mail",
+  phone: "Téléphone",
+  required: (label) => `${label} *`,
+  startChat: "Démarrer le chat",
+  rateTitle: "Évaluer cette conversation",
+  yourRating: "Votre note",
+  ratingFace: (score) => ["Très mauvais", "Mauvais", "Moyen", "Bon", "Excellent"][score - 1] ?? String(score),
+  ratingComment: "Ajouter un commentaire (facultatif)",
+  ratingSend: "Envoyer",
+  ratingThanks: "Merci",
+  ratingChange: "Modifier",
+  ratingCancel: "Annuler",
+  ratingClosed: "Cette demande d'évaluation est terminée.",
+  ratingFailed: "Envoi impossible. Réessayez.",
+  ratingTooMany: "Vous avez trop souvent modifié cette note.",
+  ratingWait: (seconds) => `Trop de demandes. Patientez ${seconds} s puis réessayez.`,
+  answerGroup: "Évaluer cette réponse",
+  answerGood: "Bonne réponse",
+  answerBad: "Mauvaise réponse",
+  answerReason: "Qu'est-ce qui n'allait pas ? (facultatif)",
+  answerSkip: "Passer",
+  answerFailed: "Enregistrement impossible",
+  closeRating: "Fermer",
+  startNewConversation: "Démarrer une nouvelle conversation",
+};
+
+const es: GiovChatStrings = {
+  loading: "Cargando…",
+  tryAgain: "Reintentar",
+  retry: "Reintentar",
+  closeChat: "Cerrar chat",
+  menu: "Menú",
+  privacyPolicy: "RGPD y privacidad",
+  newMessage: (sender, text) => `${sender}: ${text}`,
+  connecting: "Conectando…",
+  reconnecting: "Conexión perdida. Reconectando…",
+  statusPerson: "Agente en vivo",
+  statusBot: "Asistente de IA · En línea",
+  statusTeam: "Te atenderemos en breve",
+  composerPlaceholder: "Escribe un mensaje…",
+  messageInput: "Mensaje",
+  sendMessage: "Enviar mensaje",
+  attachFile: "Adjuntar archivo",
+  removeAttachment: (name) => `Quitar ${name}`,
+  you: "Tú",
+  agent: "Agente",
+  automated: "Automático",
+  botTyping: (name) => `${name} está escribiendo`,
+  teamTyping: "El equipo está escribiendo",
+  sending: "Enviando…",
+  notSent: "No enviado",
+  tapToRetry: "Toca para reintentar",
+  discard: "Descartar",
+  uploading: (percent) => `Subiendo ${percent} %`,
+  uploadFailed: "No se pudo subir el archivo",
+  sessionExpired: "La sesión de chat caducó. Inicia un chat nuevo.",
+  conversationEnded: "Esta conversación ha terminado.",
+  unavailable: "El chat no está disponible. Inténtalo de nuevo.",
+  sendFailed: "No se pudo enviar el mensaje.",
+  busy: "El equipo está ocupado ahora. Inténtalo de nuevo en un momento.",
+  attachmentsOff: "Los archivos adjuntos están desactivados en este chat.",
+  typeNotAllowed: (name) => `${name}: este tipo de archivo no está permitido.`,
+  fileTooLarge: (name, maxMb) => `${name}: los archivos deben pesar ${maxMb} MB o menos.`,
+  tooManyFiles: (max) => `Puedes adjuntar hasta ${max} archivos a la vez.`,
+  openAttachment: (name) => `Abrir ${name}`,
+  attachment: "Archivo adjunto",
+  image: "Imagen",
+  imageUnavailable: "Imagen no disponible",
+  preChatTitle: "Antes de empezar…",
+  firstName: "Nombre",
+  lastName: "Apellido",
+  email: "Correo electrónico",
+  phone: "Teléfono",
+  required: (label) => `${label} *`,
+  startChat: "Iniciar chat",
+  rateTitle: "Valora esta conversación",
+  yourRating: "Tu valoración",
+  ratingFace: (score) => ["Muy mala", "Mala", "Regular", "Buena", "Excelente"][score - 1] ?? String(score),
+  ratingComment: "Añade un comentario (opcional)",
+  ratingSend: "Enviar",
+  ratingThanks: "Gracias",
+  ratingChange: "Cambiar",
+  ratingCancel: "Cancelar",
+  ratingClosed: "Esta solicitud de valoración ha terminado.",
+  ratingFailed: "No se pudo enviar. Inténtalo de nuevo.",
+  ratingTooMany: "Has cambiado esta valoración demasiadas veces.",
+  ratingWait: (seconds) => `Demasiadas solicitudes. Espera ${seconds} s e inténtalo de nuevo.`,
+  answerGroup: "Valora esta respuesta",
+  answerGood: "Buena respuesta",
+  answerBad: "Mala respuesta",
+  answerReason: "¿Qué salió mal? (opcional)",
+  answerSkip: "Omitir",
+  answerFailed: "No se pudo guardar",
+  closeRating: "Cerrar",
+  startNewConversation: "Iniciar una conversación nueva",
+};
+
+const pt: GiovChatStrings = {
+  loading: "Carregando…",
+  tryAgain: "Tentar novamente",
+  retry: "Tentar novamente",
+  closeChat: "Fechar chat",
+  menu: "Menu",
+  privacyPolicy: "RGPD e privacidade",
+  newMessage: (sender, text) => `${sender}: ${text}`,
+  connecting: "Conectando…",
+  reconnecting: "Conexão perdida. Reconectando…",
+  statusPerson: "Atendente ao vivo",
+  statusBot: "Assistente de IA · Online",
+  statusTeam: "Responderemos em breve",
+  composerPlaceholder: "Digite uma mensagem…",
+  messageInput: "Mensagem",
+  sendMessage: "Enviar mensagem",
+  attachFile: "Anexar arquivo",
+  removeAttachment: (name) => `Remover ${name}`,
+  you: "Você",
+  agent: "Atendente",
+  automated: "Automático",
+  botTyping: (name) => `${name} está digitando`,
+  teamTyping: "A equipe está digitando",
+  sending: "Enviando…",
+  notSent: "Não enviada",
+  tapToRetry: "Toque para tentar novamente",
+  discard: "Descartar",
+  uploading: (percent) => `Enviando ${percent}%`,
+  uploadFailed: "Falha ao enviar o arquivo",
+  sessionExpired: "A sessão do chat expirou. Inicie um novo chat.",
+  conversationEnded: "Esta conversa foi encerrada.",
+  unavailable: "O chat está indisponível. Tente novamente.",
+  sendFailed: "Não foi possível enviar a mensagem.",
+  busy: "A equipe está ocupada agora. Tente novamente em instantes.",
+  attachmentsOff: "Os anexos estão desativados neste chat.",
+  typeNotAllowed: (name) => `${name}: este tipo de arquivo não é permitido.`,
+  fileTooLarge: (name, maxMb) => `${name}: os arquivos devem ter até ${maxMb} MB.`,
+  tooManyFiles: (max) => `Você pode anexar até ${max} arquivos por vez.`,
+  openAttachment: (name) => `Abrir ${name}`,
+  attachment: "Anexo",
+  image: "Imagem",
+  imageUnavailable: "Imagem indisponível",
+  preChatTitle: "Antes de começar…",
+  firstName: "Nome",
+  lastName: "Sobrenome",
+  email: "E-mail",
+  phone: "Telefone",
+  required: (label) => `${label} *`,
+  startChat: "Iniciar chat",
+  rateTitle: "Avalie esta conversa",
+  yourRating: "Sua avaliação",
+  ratingFace: (score) => ["Muito ruim", "Ruim", "Regular", "Boa", "Ótima"][score - 1] ?? String(score),
+  ratingComment: "Adicione um comentário (opcional)",
+  ratingSend: "Enviar",
+  ratingThanks: "Obrigado",
+  ratingChange: "Alterar",
+  ratingCancel: "Cancelar",
+  ratingClosed: "Este pedido de avaliação foi encerrado.",
+  ratingFailed: "Não foi possível enviar. Tente novamente.",
+  ratingTooMany: "Você alterou esta avaliação vezes demais.",
+  ratingWait: (seconds) => `Muitas solicitações. Aguarde ${seconds} s e tente novamente.`,
+  answerGroup: "Avalie esta resposta",
+  answerGood: "Boa resposta",
+  answerBad: "Resposta ruim",
+  answerReason: "O que deu errado? (opcional)",
+  answerSkip: "Pular",
+  answerFailed: "Não foi possível salvar",
+  closeRating: "Fechar",
+  startNewConversation: "Iniciar uma nova conversa",
+};
+
+const de: GiovChatStrings = {
+  loading: "Wird geladen…",
+  tryAgain: "Erneut versuchen",
+  retry: "Erneut versuchen",
+  closeChat: "Chat schließen",
+  menu: "Menü",
+  privacyPolicy: "DSGVO und Datenschutz",
+  newMessage: (sender, text) => `${sender}: ${text}`,
+  connecting: "Verbindung wird hergestellt…",
+  reconnecting: "Verbindung unterbrochen. Neuer Versuch…",
+  statusPerson: "Live-Support",
+  statusBot: "KI-Assistent · Online",
+  statusTeam: "Wir sind gleich für dich da",
+  composerPlaceholder: "Nachricht schreiben…",
+  messageInput: "Nachricht",
+  sendMessage: "Nachricht senden",
+  attachFile: "Datei anhängen",
+  removeAttachment: (name) => `${name} entfernen`,
+  you: "Du",
+  agent: "Support",
+  automated: "Automatisch",
+  botTyping: (name) => `${name} schreibt`,
+  teamTyping: "Das Team schreibt",
+  sending: "Wird gesendet…",
+  notSent: "Nicht gesendet",
+  tapToRetry: "Tippen zum Wiederholen",
+  discard: "Verwerfen",
+  uploading: (percent) => `Wird hochgeladen: ${percent} %`,
+  uploadFailed: "Datei konnte nicht hochgeladen werden",
+  sessionExpired: "Die Chat-Sitzung ist abgelaufen. Starte einen neuen Chat.",
+  conversationEnded: "Diese Unterhaltung ist beendet.",
+  unavailable: "Der Chat ist nicht verfügbar. Bitte versuche es erneut.",
+  sendFailed: "Die Nachricht konnte nicht gesendet werden.",
+  busy: "Das Team ist gerade ausgelastet. Bitte versuche es gleich noch einmal.",
+  attachmentsOff: "Dateianhänge sind in diesem Chat deaktiviert.",
+  typeNotAllowed: (name) => `${name}: Dieser Dateityp ist nicht erlaubt.`,
+  fileTooLarge: (name, maxMb) => `${name}: Dateien dürfen höchstens ${maxMb} MB groß sein.`,
+  tooManyFiles: (max) => `Du kannst bis zu ${max} Dateien auf einmal anhängen.`,
+  openAttachment: (name) => `${name} öffnen`,
+  attachment: "Anhang",
+  image: "Bild",
+  imageUnavailable: "Bild nicht verfügbar",
+  preChatTitle: "Bevor es losgeht…",
+  firstName: "Vorname",
+  lastName: "Nachname",
+  email: "E-Mail",
+  phone: "Telefon",
+  required: (label) => `${label} *`,
+  startChat: "Chat starten",
+  rateTitle: "Bewerte diese Unterhaltung",
+  yourRating: "Deine Bewertung",
+  ratingFace: (score) => ["Sehr schlecht", "Schlecht", "Okay", "Gut", "Sehr gut"][score - 1] ?? String(score),
+  ratingComment: "Kommentar hinzufügen (optional)",
+  ratingSend: "Senden",
+  ratingThanks: "Danke",
+  ratingChange: "Ändern",
+  ratingCancel: "Abbrechen",
+  ratingClosed: "Diese Bewertungsanfrage ist beendet.",
+  ratingFailed: "Senden fehlgeschlagen. Bitte versuche es erneut.",
+  ratingTooMany: "Du hast diese Bewertung zu oft geändert.",
+  ratingWait: (seconds) => `Zu viele Anfragen. Warte ${seconds} s und versuche es erneut.`,
+  answerGroup: "Bewerte diese Antwort",
+  answerGood: "Gute Antwort",
+  answerBad: "Schlechte Antwort",
+  answerReason: "Was ist schiefgelaufen? (optional)",
+  answerSkip: "Überspringen",
+  answerFailed: "Speichern fehlgeschlagen",
+  closeRating: "Schließen",
+  startNewConversation: "Neue Unterhaltung starten",
+};
+
+export const GIOVCHAT_STRINGS: Readonly<Record<GiovChatLocale, GiovChatStrings>> = { en, fr, es, pt, de };
+
+/** "fr-CA" → "fr", "pt_BR" → "pt"; anything not shipped falls back to English. */
+export function resolveLocale(value: string | null | undefined): GiovChatLocale {
+  const language = String(value ?? "").trim().toLowerCase().split(/[-_]/)[0];
+  return (Object.keys(GIOVCHAT_STRINGS) as GiovChatLocale[]).includes(language as GiovChatLocale) ? language as GiovChatLocale : "en";
+}
+
+/** The device language from Intl (Hermes and JSC both ship it), with no native module. */
+export function deviceLocale(): string {
+  try { return Intl.DateTimeFormat().resolvedOptions().locale || "en"; } catch { return "en"; }
+}
+
+/** The strings for a locale with the host's overrides on top; malformed overrides are ignored. */
+export function resolveStrings(locale?: string | null, overrides?: Partial<GiovChatStrings> | null): GiovChatStrings {
+  const base = GIOVCHAT_STRINGS[resolveLocale(locale ?? deviceLocale())];
+  if (!overrides || typeof overrides !== "object") return base;
+  const result = { ...base } as Record<string, unknown>;
+  for (const [key, value] of Object.entries(overrides)) {
+    const current = (base as unknown as Record<string, unknown>)[key];
+    if (current === undefined || typeof value !== typeof current) continue;
+    if (typeof value === "string" && !value.trim()) continue;
+    result[key] = value;
+  }
+  return result as unknown as GiovChatStrings;
+}
+
+export const GiovChatStringsContext = createContext<GiovChatStrings>(en);
+export const useGiovChatStrings = () => useContext(GiovChatStringsContext);

package/src/identity.ts

@@ -0,0 +1,54 @@
+import type { GiovWidgetConfig } from "./types";
+
+/**
+ * Who the visitor is talking to, as the web widget shows it (apps/widget-web/src/components/
+ * header-identity.ts): a person once one has taken over (their name and photo), otherwise the AI
+ * assistant while it answers (its own name and avatar), and the team title when neither is set up.
+ */
+export type HeaderIdentityKind = "person" | "bot" | "team";
+export interface HeaderIdentity {
+  kind: HeaderIdentityKind;
+  title: string;
+  avatar: string | null;
+}
+
+export function headerIdentity(
+  config: Pick<GiovWidgetConfig, "title" | "botEnabled" | "botName" | "botAvatarUrl" | "avatarUrl">,
+  currentAgentName?: string | null,
+  currentAgentAvatar?: string | null,
+): HeaderIdentity {
+  if (currentAgentName) return { kind: "person", title: currentAgentName, avatar: safeImageUrl(currentAgentAvatar) };
+  if (config.botEnabled && config.botName) return { kind: "bot", title: config.botName, avatar: safeImageUrl(config.botAvatarUrl) };
+  return { kind: "team", title: config.title, avatar: safeImageUrl(config.avatarUrl) };
+}
+
+/** Only http(s) images are loaded; anything else falls back to the initial. */
+export function safeImageUrl(value: unknown): string | null {
+  return typeof value === "string" && /^https?:\/\//i.test(value.trim()) ? value.trim() : null;
+}
+
+type IdentityInput = { role: string; isBot?: boolean; isAutomated?: boolean; senderName?: string | null };
+
+/** The label above a bubble. AI delivery is also automated internally; the AI identity takes precedence. */
+export function messageSenderLabel(
+  message: IdentityInput,
+  labels: { botName?: string; agentName?: string | null; you: string; automated: string; agent: string },
+): string {
+  if (message.role !== "agent") return labels.you;
+  if (message.isBot === true) return labels.botName?.trim() || "GiovBot";
+  if (message.isAutomated === true) return labels.automated;
+  return message.senderName?.trim() || labels.agentName?.trim() || labels.agent;
+}
+
+export type AgentTypingState = { visible: boolean; isBot?: boolean };
+
+/** Only explicit server AI metadata may brand a typing indicator as the AI (as in the widget). */
+export function reduceAgentTyping(current: AgentTypingState, event: { type?: unknown; role?: unknown; isBot?: unknown }): AgentTypingState {
+  if (event.role !== "agent") return current;
+  if (event.type === "typing") return { visible: true, isBot: typeof event.isBot === "boolean" ? event.isBot : undefined };
+  if (event.type === "typing_end") {
+    if (typeof event.isBot === "boolean" && typeof current.isBot === "boolean" && event.isBot !== current.isBot) return current;
+    return { visible: false };
+  }
+  return current;
+}

package/src/index.ts

@@ -0,0 +1,85 @@
+// Public types
+export type {
+  GiovChatContact,
+  GiovChatSession,
+  GiovChatSessionStorage,
+  GiovChatConnectionStatus,
+  GiovAnswerFeedback,
+  GiovFeedbackValue,
+  GiovMessage,
+  GiovRatingBlock,
+  GiovRatingRequest,
+  GiovRatingResult,
+  GiovRatingScore,
+  GiovWidgetConfig,
+  MessageHandler,
+  RequestUserInfo,
+  StatusHandler,
+} from "./types";
+
+// Advanced / headless usage
+export {
+  ChatClient,
+  createConversation,
+  DEFAULT_BASE_URL,
+  fetchWidgetConfig,
+  fetchConversationHistory,
+  PUSH_TOKEN_PATH,
+  SDK_VERSION,
+  UPLOAD_TIMEOUT_MS,
+  unregisterPushToken,
+} from "./client";
+export type {
+  ChatClientOptions,
+  GiovConversationHistory,
+  GiovConversationState,
+  GiovPushOptions,
+  GiovPushPlatform,
+  GiovPushRegistration,
+  GiovStreamEvent,
+  GiovUploadResult,
+} from "./client";
+export { Outbox, ACK_TIMEOUT_MS, MAX_SEND_FAILURES, MAX_MESSAGE_CHARS, clampMessage } from "./outbox";
+export type { OutboxEntry, OutboxState } from "./outbox";
+export { parseChatMarkdown, parseInline, plainText } from "./markdown";
+export type { Block as ChatMarkdownBlock, InlineNode as ChatMarkdownInline } from "./markdown";
+export { headerIdentity, messageSenderLabel, reduceAgentTyping } from "./identity";
+export type { HeaderIdentity, HeaderIdentityKind, AgentTypingState } from "./identity";
+export {
+  DEFAULT_ATTACHMENT_POLICY,
+  MAX_ATTACHED_FILES,
+  SUPPORTED_ATTACHMENT_TYPES,
+  normalizeAttachmentPolicy,
+  validateAttachments,
+} from "./attachments";
+export type {
+  GiovAttachment,
+  GiovAttachmentPolicy,
+  GiovAttachmentPreview,
+  GiovChatAttachmentPicker,
+  GiovChatPickedFile,
+} from "./attachments";
+
+// Main component
+export { GiovChat } from "./GiovChat";
+export type { GiovChatProps, GiovChatHandle } from "./GiovChat";
+export { useGiovChatUnreadCount } from "./unread";
+export { GIOVCHAT_STRINGS, resolveLocale, resolveStrings } from "./i18n";
+export type { GiovChatLocale, GiovChatStrings } from "./i18n";
+export { useGiovRating } from "./ratingStore";
+export type { GiovRatingController } from "./ratingStore";
+export { MAX_FEEDBACK_REASON, MAX_RATING_COMMENT, nextFeedback, parseRatingFrame, patchRating, pendingRatingRequest, ratingPhase, supersedeRatings } from "./rating";
+export type { GiovRatingFrame } from "./rating";
+export { RatingCard, AnswerFeedback } from "./components/RatingCard";
+export type { RatingCardProps, RateFn, VoteFn } from "./components/RatingCard";
+export { GiovChatError } from "./errors";
+export type { GiovChatErrorCode } from "./errors";
+export { GiovBranding } from "./components/Branding";
+export type { GiovBrandingProps } from "./components/Branding";
+export { FOOTER_MIN_CONTRAST } from "./brandingStyle";
+export type { GiovChatBrandingStyle } from "./brandingStyle";
+export type {
+  GiovChatStyleOverrides,
+  GiovChatTextStyle,
+  GiovChatBackgroundStyle,
+} from "./styleOverrides";