@withmarsha/embed

Loader del widget de la Recepcionista web de Marsha, distribuido por npm para poder servirlo vía CDN (unpkg).

El formulario de captación es un paquete aparte, con su propia versión: @withmarsha/form-embed (form.js). Se versionan y publican de forma independiente para que un cambio en uno no toque al otro.

El loader vive commiteado aquí en embed.js (es un fichero suelto de navegador, IIFE, sin build). El paquete se distribuye solo por npm/unpkg; no se sirve self-hosted.

Una sola vez: cuenta y login

1. Tener una cuenta npm con acceso al scope @withmarsha (crear la org en npmjs.com; gratis para paquetes públicos).
2. Iniciar sesión en la máquina:

   npm login          # abre el navegador para autenticar
   npm whoami         # confirma que estás logueado

   La sesión queda guardada; no hay que repetirlo en cada publicación.

Publicar una versión nueva

1. Edita el loader en packages/embed/embed.js.
2. Sube la versión en packages/embed/package.json (semver):
   • parche (1.0.0 → 1.0.1) para fixes,
   • minor (1.0.0 → 1.1.0) para cambios compatibles,
   • major (1.0.0 → 2.0.0) para cambios que rompen el snippet del cliente.
3. Publica (o taguea embed-v<version> y deja que lo haga la GitHub Action .github/workflows/publish-embed.yml):

   cd packages/embed
   npm publish

   publishConfig.access: "public" ya lo deja como paquete público.

unpkg lo sirve automáticamente (no se "sube" nada a unpkg):

https://unpkg.com/@withmarsha/[email protected]/embed.js

Comprobar qué se va a publicar sin publicar:

npm pack --dry-run

Snippet que pega el cliente

<script async
  src="https://unpkg.com/@withmarsha/embed@^1.0.0/embed.js"
  data-receptionist="recp_xxx"></script>

• ^1.0.0 = el cliente recibe la última 1.x automáticamente; un cambio que rompa exige publicar 2.0.0 y que el cliente actualice el rango a mano.
• data-receptionist = publicId de una Recepcionista web en estado published, con el dominio del cliente en su allowedDomains.
• data-origin = opcional, solo para apuntar a un backend que no sea prod (dev/staging/preview). Por defecto el loader usa https://withmarsha.com.