@bircleai/widget-protocol 0.6.1 → 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;

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;

package/package.json

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