@bircleai/widget-protocol 0.6.0 → 0.6.2

package/dist/index.cjs

@@ -131,6 +131,13 @@ function sanitizeThemeTexts(raw) {
   }
   return n > 0 ? out : null;
 }
+function safeLauncherToken(v) {
+  if (typeof v !== "string") return null;
+  const t = v.trim();
+  if (t === "bircle" || t === "chat") return t;
+  if (t.length > 0 && t.length <= 8 && !t.includes(":") && !t.includes("/")) return t;
+  return null;
+}
 function sanitizeServerTheme(raw) {
   if (typeof raw !== "object" || raw === null) return {};
   const o = raw;
@@ -139,7 +146,7 @@ function sanitizeServerTheme(raw) {
   if (primaryColor !== null) out.primaryColor = primaryColor;
   const accentColor = safeThemeColor(o.accentColor);
   if (accentColor !== null) out.accentColor = accentColor;
-  const launcherIcon = safeThemeUrl(o.launcherIcon);
+  const launcherIcon = safeThemeUrl(o.launcherIcon) ?? safeLauncherToken(o.launcherIcon);
   if (launcherIcon !== null) out.launcherIcon = launcherIcon;
   const headerLogo = safeThemeUrl(o.headerLogo);
   if (headerLogo !== null) out.headerLogo = headerLogo;
@@ -160,8 +167,28 @@ function sanitizeServerTheme(raw) {
   if (locale !== null) out.locale = locale;
   const texts = sanitizeThemeTexts(o.texts);
   if (texts !== null) out.texts = texts;
+  const faqs = sanitizeThemeFaqs(o.faqs);
+  if (faqs !== null) out.faqs = faqs;
   return out;
 }
+function sanitizeThemeFaqs(raw) {
+  if (!Array.isArray(raw)) return null;
+  const out = [];
+  for (const item of raw) {
+    if (out.length >= 6) break;
+    if (typeof item !== "object" || item === null) continue;
+    const v = item;
+    const label = typeof v.label === "string" ? v.label.trim() : "";
+    if (label === "" || label.length > 60) continue;
+    const entry = { label };
+    if (typeof v.message === "string") {
+      const message = v.message.trim();
+      if (message !== "" && message.length <= 500) entry.message = message;
+    }
+    out.push(entry);
+  }
+  return out.length > 0 ? out : null;
+}
 function safeThemeLocale(value) {
   if (typeof value !== "string") return null;
   const v = value.trim();

package/dist/index.d.cts

@@ -334,7 +334,7 @@ interface ChallengeUiConfig {
 interface ThemeResponse {
     /** Color de marca. `#rgb` o `#rrggbb`. Pasa por `safeThemeColor`. */
     primaryColor?: string;
-    /** URL https del ícono del launcher. */
+    /** Ícono del launcher: URL https, un built-in ("bircle" | "chat") o un emoji corto. */
     launcherIcon?: string;
     position?: "bottom-right" | "bottom-left";
     /** URL https del logo del header. */
@@ -460,19 +460,6 @@ declare function safeThemeColor(value: unknown): string | null;
  * que termina en un `<img src>` es un vector de XSS en el sitio del cliente.
  */
 declare function safeThemeUrl(value: unknown): string | null;
-/**
- * Tema del server, saneado campo por campo contra el contrato.
- *
- * ES EL ÚNICO CAMINO DE ENTRADA del branding remoto: lo que no sale de acá no
- * debería aplicarse. Devuelve un objeto NUEVO con sólo los campos válidos —
- * nunca el input— así ninguna clave extra del wire (una que el server agregue
- * mañana, o una que un theme viejo tenga guardada) se cuela por un spread.
- *
- * NUNCA LANZA Y NUNCA RECHAZA EL TEMA ENTERO: un campo inválido se descarta y el
- * consumidor cae a su default. Perder el branding completo —o peor, no pintar el
- * chat— porque el `accentColor` está mal cargado sería mucho peor que mostrar el
- * acento por default.
- */
 declare function sanitizeServerTheme(raw: unknown): ServerThemeResponse;
 /**
  * Evento entregado por el WebSocket del widget (respuesta del asistente o del

package/dist/index.d.ts

@@ -334,7 +334,7 @@ interface ChallengeUiConfig {
 interface ThemeResponse {
     /** Color de marca. `#rgb` o `#rrggbb`. Pasa por `safeThemeColor`. */
     primaryColor?: string;
-    /** URL https del ícono del launcher. */
+    /** Ícono del launcher: URL https, un built-in ("bircle" | "chat") o un emoji corto. */
     launcherIcon?: string;
     position?: "bottom-right" | "bottom-left";
     /** URL https del logo del header. */
@@ -460,19 +460,6 @@ declare function safeThemeColor(value: unknown): string | null;
  * que termina en un `<img src>` es un vector de XSS en el sitio del cliente.
  */
 declare function safeThemeUrl(value: unknown): string | null;
-/**
- * Tema del server, saneado campo por campo contra el contrato.
- *
- * ES EL ÚNICO CAMINO DE ENTRADA del branding remoto: lo que no sale de acá no
- * debería aplicarse. Devuelve un objeto NUEVO con sólo los campos válidos —
- * nunca el input— así ninguna clave extra del wire (una que el server agregue
- * mañana, o una que un theme viejo tenga guardada) se cuela por un spread.
- *
- * NUNCA LANZA Y NUNCA RECHAZA EL TEMA ENTERO: un campo inválido se descarta y el
- * consumidor cae a su default. Perder el branding completo —o peor, no pintar el
- * chat— porque el `accentColor` está mal cargado sería mucho peor que mostrar el
- * acento por default.
- */
 declare function sanitizeServerTheme(raw: unknown): ServerThemeResponse;
 /**
  * Evento entregado por el WebSocket del widget (respuesta del asistente o del

package/dist/index.js

@@ -83,6 +83,13 @@ function sanitizeThemeTexts(raw) {
   }
   return n > 0 ? out : null;
 }
+function safeLauncherToken(v) {
+  if (typeof v !== "string") return null;
+  const t = v.trim();
+  if (t === "bircle" || t === "chat") return t;
+  if (t.length > 0 && t.length <= 8 && !t.includes(":") && !t.includes("/")) return t;
+  return null;
+}
 function sanitizeServerTheme(raw) {
   if (typeof raw !== "object" || raw === null) return {};
   const o = raw;
@@ -91,7 +98,7 @@ function sanitizeServerTheme(raw) {
   if (primaryColor !== null) out.primaryColor = primaryColor;
   const accentColor = safeThemeColor(o.accentColor);
   if (accentColor !== null) out.accentColor = accentColor;
-  const launcherIcon = safeThemeUrl(o.launcherIcon);
+  const launcherIcon = safeThemeUrl(o.launcherIcon) ?? safeLauncherToken(o.launcherIcon);
   if (launcherIcon !== null) out.launcherIcon = launcherIcon;
   const headerLogo = safeThemeUrl(o.headerLogo);
   if (headerLogo !== null) out.headerLogo = headerLogo;
@@ -112,8 +119,28 @@ function sanitizeServerTheme(raw) {
   if (locale !== null) out.locale = locale;
   const texts = sanitizeThemeTexts(o.texts);
   if (texts !== null) out.texts = texts;
+  const faqs = sanitizeThemeFaqs(o.faqs);
+  if (faqs !== null) out.faqs = faqs;
   return out;
 }
+function sanitizeThemeFaqs(raw) {
+  if (!Array.isArray(raw)) return null;
+  const out = [];
+  for (const item of raw) {
+    if (out.length >= 6) break;
+    if (typeof item !== "object" || item === null) continue;
+    const v = item;
+    const label = typeof v.label === "string" ? v.label.trim() : "";
+    if (label === "" || label.length > 60) continue;
+    const entry = { label };
+    if (typeof v.message === "string") {
+      const message = v.message.trim();
+      if (message !== "" && message.length <= 500) entry.message = message;
+    }
+    out.push(entry);
+  }
+  return out.length > 0 ? out : null;
+}
 function safeThemeLocale(value) {
   if (typeof value !== "string") return null;
   const v = value.trim();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bircleai/widget-protocol",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Contrato compartido del Chat Gateway de BircleAI (tipos + helpers de parseo).",
   "license": "SEE LICENSE IN LICENSE.md",
   "type": "module",