payfri-video-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Payfri
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,289 @@
+# payfri-video-sdk
+
+SDK del **servicio de video de Payfri**. Integra videollamadas en tu producto en minutos: tu
+backend emite tokens contra la API del servicio y tu frontend se une a la llamada — sin implementar
+WebRTC ni montar infraestructura de medios propia. Tres entry points con una **separación estricta
+de seguridad**:
+
+| Entry | Dónde corre | Credencial que recibe | Para qué |
+| --- | --- | --- | --- |
+| `payfri-video-sdk/server` | Tu **backend** | **API key** del tenant (secreta) | Crear salas y emitir tokens |
+| `payfri-video-sdk/client` | **Navegador** | Solo un **token** de corta duración | Unirse a la llamada (web) |
+| `payfri-video-sdk/native` | **React Native** | Solo un **token** de corta duración | Unirse a la llamada (móvil) |
+
+> La API key **jamás** debe llegar al navegador ni al dispositivo. Los tipos de `/client` y
+> `/native` hacen **imposible** pasarla (no compila), y además hay una verificación en runtime.
+
+## Cómo funciona
+
+```
+Tu backend ──(API key)──▶ API de video ──▶ { token, livekitUrl }
+     │                                            │
+     └────────── pasa token + livekitUrl ─────────┘
+                          ▼
+   Navegador / app móvil se une a la llamada con el token
+```
+
+1. Tu backend usa la API key para pedir un **token de acceso** (`tokens.issue`).
+2. Le pasas `{ token, livekitUrl }` a tu frontend (respuesta de tu propio endpoint).
+3. El frontend se une a la sala con `/client` (web) o `/native` (React Native).
+
+Los tokens expiran (default **1 hora**, configurable de 60 s a 12 h), así que emite uno nuevo por
+participante y por sesión.
+
+## Qué necesitas antes de empezar
+
+Te lo entrega el equipo que administra el servicio de video:
+
+- **`baseUrl`** — URL de la API de video, p. ej. `https://api.video.tuempresa.com`
+- **`apiKey`** — API key de tu tenant (formato `{prefijo}_live_{aleatorio}`). Se muestra **una sola
+  vez** al crearla: guárdala en un gestor de secretos, nunca en el código.
+- **`embedBaseUrl`** (solo para `/native`) — URL de la página embebible, p. ej.
+  `https://embed.tuempresa.com`
+- **Alta de CORS** — pide que agreguen el dominio de tu frontend a los orígenes permitidos de la API.
+
+Requisitos técnicos: Node 18+ en el backend (usa `fetch` global; en runtimes sin él puedes inyectar
+uno propio). El paquete se distribuye en **ESM + CJS con tipos incluidos**.
+
+## Instalación
+
+```bash
+# Backend (emitir tokens) — sin dependencias extra
+npm install payfri-video-sdk
+
+# Navegador (unirse a la llamada) — livekit-client es peer dependency
+npm install payfri-video-sdk livekit-client
+
+# React Native / Expo
+npm install payfri-video-sdk react-native-webview
+```
+
+Todas las peer dependencies son **opcionales**: instala solo lo que exige el entry que uses.
+
+> `livekit-client` aparece porque el motor de medios del servicio es [LiveKit](https://livekit.io);
+> es un detalle interno de implementación — tú solo interactúas con la API del servicio y con este SDK.
+
+---
+
+## Backend — `payfri-video-sdk/server`
+
+```ts
+import { createVideoClient } from "payfri-video-sdk/server";
+
+const video = createVideoClient({
+  baseUrl: process.env.VIDEO_API_BASE_URL!, // https://api.video.tuempresa.com
+  apiKey: process.env.VIDEO_API_KEY!,       // secreta, SOLO en el servidor
+});
+
+// Emitir un token para un participante (crea la sala si no existe)
+const { token, livekitUrl } = await video.tokens.issue({
+  roomName: "consulta-123",
+  identity: "doctor-45",
+  displayName: "Dra. López",
+  createIfMissing: true,
+});
+
+// Devuelve { token, livekitUrl } a tu frontend. NUNCA la apiKey.
+```
+
+### `createVideoClient(options)`
+
+| Opción | Tipo | Requerido | Descripción |
+| --- | --- | --- | --- |
+| `baseUrl` | `string` | ✅ | Base de la API de video (sin `/` final) |
+| `apiKey` | `string` | ✅ | API key del tenant. Solo en servidores |
+| `fetch` | `typeof fetch` | — | `fetch` personalizado (tests / runtimes sin fetch global) |
+
+### Métodos
+
+| Método | Descripción |
+| --- | --- |
+| `tokens.issue(input)` | **El central.** Emite el token de acceso a la videollamada |
+| `rooms.create(input?)` | Crea una sala |
+| `rooms.get(roomName)` | Estado de la sala + participantes conectados |
+| `rooms.end(roomName)` | Cierra la sala y desconecta a todos |
+
+### `tokens.issue(input)`
+
+| Campo | Tipo | Default | Descripción |
+| --- | --- | --- | --- |
+| `roomName` | `string` | requerido | Alfanumérico con `.` `_` `-` (máx. 120, sin `__`) |
+| `identity` | `string` | requerido | Identidad **única** del participante en la sala (máx. 120) |
+| `displayName` | `string` | — | Nombre visible en la UI |
+| `canPublish` | `boolean` | `true` | Puede publicar cámara/micrófono |
+| `canSubscribe` | `boolean` | `true` | Puede ver/oír a los demás |
+| `canPublishData` | `boolean` | `true` | Puede enviar mensajes de datos |
+| `ttlSeconds` | `number` | `3600` | Vigencia del token (60–43200) |
+| `metadata` | `object` | — | Metadata adjunta al participante |
+| `createIfMissing` | `boolean` | `false` | Crea la sala si no existe (si no, `404`) |
+
+Devuelve `{ token, livekitUrl, roomName, identity, expiresAt }`.
+
+> Tip: para un espectador (webinar, supervisión) emite `{ canPublish: false }`.
+
+### `rooms.create(input?)`
+
+| Campo | Tipo | Descripción |
+| --- | --- | --- |
+| `name` | `string?` | Nombre de la sala (se genera uno si lo omites) |
+| `maxParticipants` | `number?` | Límite de participantes |
+| `emptyTimeoutSeconds` | `number?` | Segundos que la sala vive vacía antes de cerrarse |
+| `metadata` | `object?` | Metadata de la sala |
+
+### Errores
+
+Toda respuesta no-2xx lanza **`VideoApiError`** con `{ code, message, status }`:
+
+```ts
+import { createVideoClient, VideoApiError } from "payfri-video-sdk/server";
+
+try {
+  await video.tokens.issue({ roomName: "no-existe", identity: "u1" });
+} catch (err) {
+  if (err instanceof VideoApiError) {
+    console.error(err.status, err.code, err.message); // 404 ROOM_NOT_FOUND ...
+  }
+}
+```
+
+| `status` | Causa típica |
+| --- | --- |
+| 401 | API key inválida o revocada |
+| 403 | Tenant suspendido |
+| 404 | Sala inexistente (usa `createIfMissing: true` si aplica) |
+| 400 | Body inválido (revisa `message`) |
+
+---
+
+## Navegador — `payfri-video-sdk/client`
+
+```ts
+import { joinRoom } from "payfri-video-sdk/client";
+
+const handle = await joinRoom({
+  token,      // recibido desde TU backend
+  livekitUrl, // recibido desde TU backend
+  container: document.getElementById("call")!,
+});
+
+handle.on("participantJoined", (p) => console.log("entró", p.identity));
+handle.on("error", (e) => console.error(e));
+
+await handle.toggleMic();    // → boolean (nuevo estado)
+await handle.toggleCamera(); // → boolean (nuevo estado)
+await handle.leave();        // salir y liberar recursos
+```
+
+### `joinRoom(options)`
+
+| Opción | Tipo | Default | Descripción |
+| --- | --- | --- | --- |
+| `token` | `string` | requerido | Token de acceso emitido por tu backend |
+| `livekitUrl` | `string` | requerido | URL `wss` del servidor de medios (la devuelve `tokens.issue`; pásala tal cual) |
+| `container` | `HTMLElement` | requerido | Elemento donde se montan los videos |
+| `enableCamera` | `boolean` | `true` | Publicar cámara al conectar |
+| `enableMicrophone` | `boolean` | `true` | Publicar micrófono al conectar |
+| `roomOptions` | `RoomOptions` | — | Opciones avanzadas de `livekit-client` |
+| `connectOptions` | `RoomConnectOptions` | — | Opciones de conexión de `livekit-client` |
+
+### Eventos del `RoomHandle`
+
+| Evento | Payload | Cuándo |
+| --- | --- | --- |
+| `connected` | — | Conectó a la sala |
+| `disconnected` | — | Se perdió/cerró la conexión |
+| `participantJoined` | `{ identity }` | Entró un participante remoto |
+| `participantLeft` | `{ identity }` | Salió un participante remoto |
+| `error` | `Error` | Fallo de conexión o de dispositivos |
+
+Para casos avanzados, `handle.room` expone el `Room` de `livekit-client` subyacente.
+
+### Seguridad de tipos
+
+`joinRoom` **no tiene** campo para la API key. Esto no compila:
+
+```ts
+// @ts-expect-error — apiKey no existe en JoinRoomOptions
+joinRoom({ token, livekitUrl, container, apiKey: "..." });
+```
+
+Y en runtime, `joinRoom` lanza si detecta `apiKey`/`apiSecret`/`secret` en las opciones.
+
+---
+
+## React Native — `payfri-video-sdk/native`
+
+Componente `<VideoCall>` que incrusta la videollamada en un `WebView` (carga la página embebible
+del servicio). **No requiere `react-native-webrtc`** ni código nativo propio.
+
+```tsx
+import { VideoCall } from "payfri-video-sdk/native";
+
+<VideoCall
+  token={token}           // recibido desde TU backend
+  livekitUrl={livekitUrl} // recibido desde TU backend
+  embedBaseUrl="https://embed.tuempresa.com"
+  onConnected={() => console.log("conectado")}
+  onLeave={() => navigation.goBack()}
+  onError={(e) => console.warn(e.message)}
+  style={{ flex: 1 }}
+/>;
+```
+
+### Props de `<VideoCall>`
+
+| Prop | Tipo | Requerido | Descripción |
+| --- | --- | --- | --- |
+| `token` | `string` | ✅ | Token de acceso emitido por tu backend |
+| `livekitUrl` | `string` | ✅ | URL `wss` del servidor de medios (la devuelve `tokens.issue`; pásala tal cual) |
+| `embedBaseUrl` | `string` | ✅ | Base de la página embebible (**HTTPS obligatorio**) |
+| `theme` | `string` | — | Color de acento para branding (ej. `#4f7cff`) |
+| `onConnected` | `() => void` | — | La videollamada conectó |
+| `onDisconnected` | `() => void` | — | El usuario se desconectó o se cerró la sala |
+| `onLeave` | `() => void` | — | El usuario pulsó "salir" en la UI |
+| `onParticipantJoined` | `({ identity }) => void` | — | Entró un participante remoto |
+| `onParticipantLeft` | `({ identity }) => void` | — | Salió un participante remoto |
+| `onError` | `(error: Error) => void` | — | Permisos denegados, token inválido, fallo de sala |
+| `style` | `StyleProp<ViewStyle>` | — | Estilo del contenedor (default: ocupa todo) |
+
+Igual que `/client`, `VideoCallProps` **no tiene** campo para la API key (no compila si la pasas).
+
+### Permisos de cámara y micrófono
+
+**Expo** — activa el config plugin en `app.json` y no toques archivos nativos:
+
+```jsonc
+{
+  "expo": {
+    "plugins": [
+      ["payfri-video-sdk", { "cameraText": "Para videollamadas", "microphoneText": "Para videollamadas" }]
+    ]
+  }
+}
+```
+
+El plugin inyecta en el prebuild `NSCameraUsageDescription` / `NSMicrophoneUsageDescription` (iOS)
+y `CAMERA` / `RECORD_AUDIO` (Android).
+
+**React Native "bare"** (sin Expo) — agrégalos a mano en `Info.plist` y `AndroidManifest.xml`.
+
+> App de ejemplo completa (Expo):
+> [`examples/expo-videocall`](https://github.com/Payfri/VideoCallsGateway/tree/main/examples/expo-videocall)
+
+---
+
+## Solución de problemas
+
+| Síntoma | Causa probable | Solución |
+| --- | --- | --- |
+| `401 UNAUTHORIZED` desde `/server` | API key mal copiada o revocada | Verifica la env var; pide una key nueva si fue revocada |
+| CORS bloquea la petición del navegador | Tu dominio no está en la lista de orígenes | Pide el alta de tu dominio al equipo de la plataforma |
+| "token inválido o expirado" al unirse | El token venció (default 1 h) | Emite un token nuevo por sesión; sube `ttlSeconds` si aplica |
+| Cámara/micrófono no arrancan (web) | Contexto no seguro | Sirve tu página por **HTTPS** (`getUserMedia` lo exige) |
+| Cámara/micrófono no arrancan (RN) | Permisos no declarados | Config plugin (Expo) o permisos manuales (bare) + rebuild |
+| `No hay fetch disponible` en `/server` | Node < 18 o runtime sin fetch | Usa Node 18+ o pasa `fetch` en las opciones |
+| Pantalla en blanco en `<VideoCall>` | `embedBaseUrl` en HTTP o mal apuntada | Debe ser HTTPS y responder la página `/room` |
+
+## Licencia
+
+[MIT](https://github.com/Payfri/VideoCallsGateway/blob/main/packages/sdk/LICENSE)

package/app.plugin.cjs

@@ -0,0 +1,8 @@
+// Punto de entrada del config plugin de Expo.
+//
+// El paquete es "type": "module", así que un `app.plugin.js` sería ESM y Expo
+// (que hace require()) fallaría en Node 18/20. Con extensión .cjs forzamos
+// CommonJS, y el mapa de `exports` hace que `payfri-video-sdk/app.plugin.js` resuelva
+// a este archivo. Reexporta el plugin compilado por tsup (que exporta la función
+// directamente en su module.exports).
+module.exports = require("./dist/plugin/withVideoSdk.cjs");

package/dist/client/index.cjs

@@ -0,0 +1,99 @@
+'use strict';
+
+var livekitClient = require('livekit-client');
+
+// src/client/join-room.ts
+
+// src/client/emitter.ts
+var TypedEmitter = class {
+  listeners = /* @__PURE__ */ new Map();
+  on(event, cb) {
+    const set = this.listeners.get(event) ?? /* @__PURE__ */ new Set();
+    set.add(cb);
+    this.listeners.set(event, set);
+  }
+  off(event, cb) {
+    this.listeners.get(event)?.delete(cb);
+  }
+  emit(event, payload) {
+    for (const cb of this.listeners.get(event) ?? []) {
+      cb(payload);
+    }
+  }
+};
+
+// src/client/join-room.ts
+async function joinRoom(options) {
+  for (const forbidden of ["apiKey", "apiSecret", "secret"]) {
+    if (forbidden in options) {
+      throw new Error(`joinRoom no acepta "${forbidden}": jam\xE1s pases credenciales al navegador`);
+    }
+  }
+  const { token, livekitUrl, container } = options;
+  const emitter = new TypedEmitter();
+  const room = new livekitClient.Room(options.roomOptions);
+  const attach = (track) => {
+    const el = track.attach();
+    el.setAttribute("data-lk-track", track.sid ?? "");
+    if (el instanceof HTMLVideoElement) {
+      el.style.width = "100%";
+    }
+    container.appendChild(el);
+  };
+  room.on(livekitClient.RoomEvent.TrackSubscribed, (track) => attach(track)).on(livekitClient.RoomEvent.TrackUnsubscribed, (track) => {
+    track.detach().forEach((el) => el.remove());
+  }).on(livekitClient.RoomEvent.LocalTrackPublished, (pub) => {
+    if (pub.track && pub.kind === "video") {
+      const el = pub.track.attach();
+      el.setAttribute("data-lk-local", "true");
+      if (el instanceof HTMLMediaElement) {
+        el.muted = true;
+      }
+      if (el instanceof HTMLVideoElement) {
+        el.style.width = "100%";
+      }
+      container.appendChild(el);
+    }
+  }).on(
+    livekitClient.RoomEvent.ParticipantConnected,
+    (p) => emitter.emit("participantJoined", { identity: p.identity })
+  ).on(
+    livekitClient.RoomEvent.ParticipantDisconnected,
+    (p) => emitter.emit("participantLeft", { identity: p.identity })
+  ).on(livekitClient.RoomEvent.Disconnected, () => emitter.emit("disconnected", void 0)).on(livekitClient.RoomEvent.MediaDevicesError, (err) => emitter.emit("error", err));
+  try {
+    await room.connect(livekitUrl, token, options.connectOptions);
+  } catch (err) {
+    emitter.emit("error", err instanceof Error ? err : new Error(String(err)));
+    throw err;
+  }
+  if (options.enableMicrophone !== false) {
+    await room.localParticipant.setMicrophoneEnabled(true);
+  }
+  if (options.enableCamera !== false) {
+    await room.localParticipant.setCameraEnabled(true);
+  }
+  emitter.emit("connected", void 0);
+  return {
+    on: emitter.on.bind(emitter),
+    off: emitter.off.bind(emitter),
+    async toggleMic() {
+      const next = !room.localParticipant.isMicrophoneEnabled;
+      await room.localParticipant.setMicrophoneEnabled(next);
+      return next;
+    },
+    async toggleCamera() {
+      const next = !room.localParticipant.isCameraEnabled;
+      await room.localParticipant.setCameraEnabled(next);
+      return next;
+    },
+    async leave() {
+      await room.disconnect();
+    },
+    room
+  };
+}
+
+exports.joinRoom = joinRoom;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/client/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/emitter.ts","../../src/client/join-room.ts"],"names":["Room","RoomEvent"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { RoomHandleEvent, RoomHandleEventMap } from \"./types\";\n\ntype AnyCb = (payload: never) => void;\n\n/** Emisor de eventos tipado y minimalista para el handle de la sala. */\nexport class TypedEmitter {\n  private readonly listeners = new Map<RoomHandleEvent, Set<AnyCb>>();\n\n  on<E extends RoomHandleEvent>(event: E, cb: (payload: RoomHandleEventMap[E]) => void): void {\n    const set = this.listeners.get(event) ?? new Set<AnyCb>();\n    set.add(cb as AnyCb);\n    this.listeners.set(event, set);\n  }\n\n  off<E extends RoomHandleEvent>(event: E, cb: (payload: RoomHandleEventMap[E]) => void): void {\n    this.listeners.get(event)?.delete(cb as AnyCb);\n  }\n\n  emit<E extends RoomHandleEvent>(event: E, payload: RoomHandleEventMap[E]): void {\n    for (const cb of this.listeners.get(event) ?? []) {\n      (cb as (payload: RoomHandleEventMap[E]) => void)(payload);\n    }\n  }\n}\n","import {\n  type LocalTrackPublication,\n  type RemoteParticipant,\n  type RemoteTrack,\n  Room,\n  RoomEvent,\n} from \"livekit-client\";\nimport { TypedEmitter } from \"./emitter\";\nimport type { JoinRoomOptions, RoomHandle } from \"./types\";\n\n/**\n * Conecta a una sala de LiveKit desde el navegador y monta los videos en el\n * contenedor. Solo necesita `token` + `livekitUrl`; nunca una API key.\n */\nexport async function joinRoom(options: JoinRoomOptions): Promise<RoomHandle> {\n  // Guard defensivo: el tipo ya lo impide, pero rechazamos cualquier intento de\n  // colar credenciales de servidor al navegador.\n  for (const forbidden of [\"apiKey\", \"apiSecret\", \"secret\"]) {\n    if (forbidden in (options as unknown as Record<string, unknown>)) {\n      throw new Error(`joinRoom no acepta \"${forbidden}\": jamás pases credenciales al navegador`);\n    }\n  }\n\n  const { token, livekitUrl, container } = options;\n  const emitter = new TypedEmitter();\n  const room = new Room(options.roomOptions);\n\n  const attach = (track: RemoteTrack): void => {\n    const el = track.attach();\n    el.setAttribute(\"data-lk-track\", track.sid ?? \"\");\n    if (el instanceof HTMLVideoElement) {\n      el.style.width = \"100%\";\n    }\n    container.appendChild(el);\n  };\n\n  room\n    .on(RoomEvent.TrackSubscribed, (track: RemoteTrack) => attach(track))\n    .on(RoomEvent.TrackUnsubscribed, (track: RemoteTrack) => {\n      track.detach().forEach((el) => el.remove());\n    })\n    .on(RoomEvent.LocalTrackPublished, (pub: LocalTrackPublication) => {\n      if (pub.track && pub.kind === \"video\") {\n        const el = pub.track.attach();\n        el.setAttribute(\"data-lk-local\", \"true\");\n        if (el instanceof HTMLMediaElement) {\n          el.muted = true; // evitar eco del audio propio\n        }\n        if (el instanceof HTMLVideoElement) {\n          el.style.width = \"100%\";\n        }\n        container.appendChild(el);\n      }\n    })\n    .on(RoomEvent.ParticipantConnected, (p: RemoteParticipant) =>\n      emitter.emit(\"participantJoined\", { identity: p.identity }),\n    )\n    .on(RoomEvent.ParticipantDisconnected, (p: RemoteParticipant) =>\n      emitter.emit(\"participantLeft\", { identity: p.identity }),\n    )\n    .on(RoomEvent.Disconnected, () => emitter.emit(\"disconnected\", undefined))\n    .on(RoomEvent.MediaDevicesError, (err: Error) => emitter.emit(\"error\", err));\n\n  try {\n    await room.connect(livekitUrl, token, options.connectOptions);\n  } catch (err) {\n    emitter.emit(\"error\", err instanceof Error ? err : new Error(String(err)));\n    throw err;\n  }\n\n  if (options.enableMicrophone !== false) {\n    await room.localParticipant.setMicrophoneEnabled(true);\n  }\n  if (options.enableCamera !== false) {\n    await room.localParticipant.setCameraEnabled(true);\n  }\n\n  emitter.emit(\"connected\", undefined);\n\n  return {\n    on: emitter.on.bind(emitter),\n    off: emitter.off.bind(emitter),\n    async toggleMic() {\n      const next = !room.localParticipant.isMicrophoneEnabled;\n      await room.localParticipant.setMicrophoneEnabled(next);\n      return next;\n    },\n    async toggleCamera() {\n      const next = !room.localParticipant.isCameraEnabled;\n      await room.localParticipant.setCameraEnabled(next);\n      return next;\n    },\n    async leave() {\n      await room.disconnect();\n    },\n    room,\n  };\n}\n"]}

package/dist/client/index.d.cts

@@ -0,0 +1,53 @@
+import { RoomOptions, RoomConnectOptions, Room } from 'livekit-client';
+
+/**
+ * Opciones para unirse a una sala desde el navegador. SOLO recibe `token` y
+ * `livekitUrl`: NO existe un campo para la API key, por lo que el tipo hace
+ * imposible filtrarla al cliente.
+ */
+interface JoinRoomOptions {
+    /** Token de acceso de LiveKit (corta duración) emitido por tu backend. */
+    token: string;
+    /** URL ws/wss del servidor LiveKit. */
+    livekitUrl: string;
+    /** Contenedor donde se montan los videos. */
+    container: HTMLElement;
+    /** Publicar cámara al conectar (default true). */
+    enableCamera?: boolean;
+    /** Publicar micrófono al conectar (default true). */
+    enableMicrophone?: boolean;
+    roomOptions?: RoomOptions;
+    connectOptions?: RoomConnectOptions;
+}
+type RoomHandleEvent = "connected" | "disconnected" | "participantJoined" | "participantLeft" | "error";
+interface RoomHandleEventMap {
+    connected: void;
+    disconnected: void;
+    participantJoined: {
+        identity: string;
+    };
+    participantLeft: {
+        identity: string;
+    };
+    error: Error;
+}
+interface RoomHandle {
+    on<E extends RoomHandleEvent>(event: E, cb: (payload: RoomHandleEventMap[E]) => void): void;
+    off<E extends RoomHandleEvent>(event: E, cb: (payload: RoomHandleEventMap[E]) => void): void;
+    /** Alterna el micrófono. Devuelve el nuevo estado (true = activo). */
+    toggleMic(): Promise<boolean>;
+    /** Alterna la cámara. Devuelve el nuevo estado (true = activa). */
+    toggleCamera(): Promise<boolean>;
+    /** Sale de la sala y libera los recursos. */
+    leave(): Promise<void>;
+    /** Acceso de bajo nivel al Room de livekit-client. */
+    readonly room: Room;
+}
+
+/**
+ * Conecta a una sala de LiveKit desde el navegador y monta los videos en el
+ * contenedor. Solo necesita `token` + `livekitUrl`; nunca una API key.
+ */
+declare function joinRoom(options: JoinRoomOptions): Promise<RoomHandle>;
+
+export { type JoinRoomOptions, type RoomHandle, type RoomHandleEvent, type RoomHandleEventMap, joinRoom };

package/dist/client/index.d.ts

@@ -0,0 +1,53 @@
+import { RoomOptions, RoomConnectOptions, Room } from 'livekit-client';
+
+/**
+ * Opciones para unirse a una sala desde el navegador. SOLO recibe `token` y
+ * `livekitUrl`: NO existe un campo para la API key, por lo que el tipo hace
+ * imposible filtrarla al cliente.
+ */
+interface JoinRoomOptions {
+    /** Token de acceso de LiveKit (corta duración) emitido por tu backend. */
+    token: string;
+    /** URL ws/wss del servidor LiveKit. */
+    livekitUrl: string;
+    /** Contenedor donde se montan los videos. */
+    container: HTMLElement;
+    /** Publicar cámara al conectar (default true). */
+    enableCamera?: boolean;
+    /** Publicar micrófono al conectar (default true). */
+    enableMicrophone?: boolean;
+    roomOptions?: RoomOptions;
+    connectOptions?: RoomConnectOptions;
+}
+type RoomHandleEvent = "connected" | "disconnected" | "participantJoined" | "participantLeft" | "error";
+interface RoomHandleEventMap {
+    connected: void;
+    disconnected: void;
+    participantJoined: {
+        identity: string;
+    };
+    participantLeft: {
+        identity: string;
+    };
+    error: Error;
+}
+interface RoomHandle {
+    on<E extends RoomHandleEvent>(event: E, cb: (payload: RoomHandleEventMap[E]) => void): void;
+    off<E extends RoomHandleEvent>(event: E, cb: (payload: RoomHandleEventMap[E]) => void): void;
+    /** Alterna el micrófono. Devuelve el nuevo estado (true = activo). */
+    toggleMic(): Promise<boolean>;
+    /** Alterna la cámara. Devuelve el nuevo estado (true = activa). */
+    toggleCamera(): Promise<boolean>;
+    /** Sale de la sala y libera los recursos. */
+    leave(): Promise<void>;
+    /** Acceso de bajo nivel al Room de livekit-client. */
+    readonly room: Room;
+}
+
+/**
+ * Conecta a una sala de LiveKit desde el navegador y monta los videos en el
+ * contenedor. Solo necesita `token` + `livekitUrl`; nunca una API key.
+ */
+declare function joinRoom(options: JoinRoomOptions): Promise<RoomHandle>;
+
+export { type JoinRoomOptions, type RoomHandle, type RoomHandleEvent, type RoomHandleEventMap, joinRoom };

package/dist/client/index.js

@@ -0,0 +1,97 @@
+import { Room, RoomEvent } from 'livekit-client';
+
+// src/client/join-room.ts
+
+// src/client/emitter.ts
+var TypedEmitter = class {
+  listeners = /* @__PURE__ */ new Map();
+  on(event, cb) {
+    const set = this.listeners.get(event) ?? /* @__PURE__ */ new Set();
+    set.add(cb);
+    this.listeners.set(event, set);
+  }
+  off(event, cb) {
+    this.listeners.get(event)?.delete(cb);
+  }
+  emit(event, payload) {
+    for (const cb of this.listeners.get(event) ?? []) {
+      cb(payload);
+    }
+  }
+};
+
+// src/client/join-room.ts
+async function joinRoom(options) {
+  for (const forbidden of ["apiKey", "apiSecret", "secret"]) {
+    if (forbidden in options) {
+      throw new Error(`joinRoom no acepta "${forbidden}": jam\xE1s pases credenciales al navegador`);
+    }
+  }
+  const { token, livekitUrl, container } = options;
+  const emitter = new TypedEmitter();
+  const room = new Room(options.roomOptions);
+  const attach = (track) => {
+    const el = track.attach();
+    el.setAttribute("data-lk-track", track.sid ?? "");
+    if (el instanceof HTMLVideoElement) {
+      el.style.width = "100%";
+    }
+    container.appendChild(el);
+  };
+  room.on(RoomEvent.TrackSubscribed, (track) => attach(track)).on(RoomEvent.TrackUnsubscribed, (track) => {
+    track.detach().forEach((el) => el.remove());
+  }).on(RoomEvent.LocalTrackPublished, (pub) => {
+    if (pub.track && pub.kind === "video") {
+      const el = pub.track.attach();
+      el.setAttribute("data-lk-local", "true");
+      if (el instanceof HTMLMediaElement) {
+        el.muted = true;
+      }
+      if (el instanceof HTMLVideoElement) {
+        el.style.width = "100%";
+      }
+      container.appendChild(el);
+    }
+  }).on(
+    RoomEvent.ParticipantConnected,
+    (p) => emitter.emit("participantJoined", { identity: p.identity })
+  ).on(
+    RoomEvent.ParticipantDisconnected,
+    (p) => emitter.emit("participantLeft", { identity: p.identity })
+  ).on(RoomEvent.Disconnected, () => emitter.emit("disconnected", void 0)).on(RoomEvent.MediaDevicesError, (err) => emitter.emit("error", err));
+  try {
+    await room.connect(livekitUrl, token, options.connectOptions);
+  } catch (err) {
+    emitter.emit("error", err instanceof Error ? err : new Error(String(err)));
+    throw err;
+  }
+  if (options.enableMicrophone !== false) {
+    await room.localParticipant.setMicrophoneEnabled(true);
+  }
+  if (options.enableCamera !== false) {
+    await room.localParticipant.setCameraEnabled(true);
+  }
+  emitter.emit("connected", void 0);
+  return {
+    on: emitter.on.bind(emitter),
+    off: emitter.off.bind(emitter),
+    async toggleMic() {
+      const next = !room.localParticipant.isMicrophoneEnabled;
+      await room.localParticipant.setMicrophoneEnabled(next);
+      return next;
+    },
+    async toggleCamera() {
+      const next = !room.localParticipant.isCameraEnabled;
+      await room.localParticipant.setCameraEnabled(next);
+      return next;
+    },
+    async leave() {
+      await room.disconnect();
+    },
+    room
+  };
+}
+
+export { joinRoom };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/emitter.ts","../../src/client/join-room.ts"],"names":[],"mappings":";;;;;AAKO,IAAM,eAAN,MAAmB;AAAA,EACP,SAAA,uBAAgB,GAAA,EAAiC;AAAA,EAElE,EAAA,CAA8B,OAAU,EAAA,EAAoD;AAC1F,IAAA,MAAM,MAAM,IAAA,CAAK,SAAA,CAAU,IAAI,KAAK,CAAA,wBAAS,GAAA,EAAW;AACxD,IAAA,GAAA,CAAI,IAAI,EAAW,CAAA;AACnB,IAAA,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,KAAA,EAAO,GAAG,CAAA;AAAA,EAC/B;AAAA,EAEA,GAAA,CAA+B,OAAU,EAAA,EAAoD;AAC3F,IAAA,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,KAAK,CAAA,EAAG,OAAO,EAAW,CAAA;AAAA,EAC/C;AAAA,EAEA,IAAA,CAAgC,OAAU,OAAA,EAAsC;AAC9E,IAAA,KAAA,MAAW,MAAM,IAAA,CAAK,SAAA,CAAU,IAAI,KAAK,CAAA,IAAK,EAAC,EAAG;AAChD,MAAC,GAAgD,OAAO,CAAA;AAAA,IAC1D;AAAA,EACF;AACF,CAAA;;;ACTA,eAAsB,SAAS,OAAA,EAA+C;AAG5E,EAAA,KAAA,MAAW,SAAA,IAAa,CAAC,QAAA,EAAU,WAAA,EAAa,QAAQ,CAAA,EAAG;AACzD,IAAA,IAAI,aAAc,OAAA,EAAgD;AAChE,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,oBAAA,EAAuB,SAAS,CAAA,2CAAA,CAA0C,CAAA;AAAA,IAC5F;AAAA,EACF;AAEA,EAAA,MAAM,EAAE,KAAA,EAAO,UAAA,EAAY,SAAA,EAAU,GAAI,OAAA;AACzC,EAAA,MAAM,OAAA,GAAU,IAAI,YAAA,EAAa;AACjC,EAAA,MAAM,IAAA,GAAO,IAAI,IAAA,CAAK,OAAA,CAAQ,WAAW,CAAA;AAEzC,EAAA,MAAM,MAAA,GAAS,CAAC,KAAA,KAA6B;AAC3C,IAAA,MAAM,EAAA,GAAK,MAAM,MAAA,EAAO;AACxB,IAAA,EAAA,CAAG,YAAA,CAAa,eAAA,EAAiB,KAAA,CAAM,GAAA,IAAO,EAAE,CAAA;AAChD,IAAA,IAAI,cAAc,gBAAA,EAAkB;AAClC,MAAA,EAAA,CAAG,MAAM,KAAA,GAAQ,MAAA;AAAA,IACnB;AACA,IAAA,SAAA,CAAU,YAAY,EAAE,CAAA;AAAA,EAC1B,CAAA;AAEA,EAAA,IAAA,CACG,EAAA,CAAG,SAAA,CAAU,eAAA,EAAiB,CAAC,KAAA,KAAuB,MAAA,CAAO,KAAK,CAAC,CAAA,CACnE,EAAA,CAAG,SAAA,CAAU,iBAAA,EAAmB,CAAC,KAAA,KAAuB;AACvD,IAAA,KAAA,CAAM,QAAO,CAAE,OAAA,CAAQ,CAAC,EAAA,KAAO,EAAA,CAAG,QAAQ,CAAA;AAAA,EAC5C,CAAC,CAAA,CACA,EAAA,CAAG,SAAA,CAAU,mBAAA,EAAqB,CAAC,GAAA,KAA+B;AACjE,IAAA,IAAI,GAAA,CAAI,KAAA,IAAS,GAAA,CAAI,IAAA,KAAS,OAAA,EAAS;AACrC,MAAA,MAAM,EAAA,GAAK,GAAA,CAAI,KAAA,CAAM,MAAA,EAAO;AAC5B,MAAA,EAAA,CAAG,YAAA,CAAa,iBAAiB,MAAM,CAAA;AACvC,MAAA,IAAI,cAAc,gBAAA,EAAkB;AAClC,QAAA,EAAA,CAAG,KAAA,GAAQ,IAAA;AAAA,MACb;AACA,MAAA,IAAI,cAAc,gBAAA,EAAkB;AAClC,QAAA,EAAA,CAAG,MAAM,KAAA,GAAQ,MAAA;AAAA,MACnB;AACA,MAAA,SAAA,CAAU,YAAY,EAAE,CAAA;AAAA,IAC1B;AAAA,EACF,CAAC,CAAA,CACA,EAAA;AAAA,IAAG,SAAA,CAAU,oBAAA;AAAA,IAAsB,CAAC,MACnC,OAAA,CAAQ,IAAA,CAAK,qBAAqB,EAAE,QAAA,EAAU,CAAA,CAAE,QAAA,EAAU;AAAA,GAC5D,CACC,EAAA;AAAA,IAAG,SAAA,CAAU,uBAAA;AAAA,IAAyB,CAAC,MACtC,OAAA,CAAQ,IAAA,CAAK,mBAAmB,EAAE,QAAA,EAAU,CAAA,CAAE,QAAA,EAAU;AAAA,GAC1D,CACC,GAAG,SAAA,CAAU,YAAA,EAAc,MAAM,OAAA,CAAQ,IAAA,CAAK,gBAAgB,MAAS,CAAC,EACxE,EAAA,CAAG,SAAA,CAAU,mBAAmB,CAAC,GAAA,KAAe,QAAQ,IAAA,CAAK,OAAA,EAAS,GAAG,CAAC,CAAA;AAE7E,EAAA,IAAI;AACF,IAAA,MAAM,IAAA,CAAK,OAAA,CAAQ,UAAA,EAAY,KAAA,EAAO,QAAQ,cAAc,CAAA;AAAA,EAC9D,SAAS,GAAA,EAAK;AACZ,IAAA,OAAA,CAAQ,IAAA,CAAK,OAAA,EAAS,GAAA,YAAe,KAAA,GAAQ,GAAA,GAAM,IAAI,KAAA,CAAM,MAAA,CAAO,GAAG,CAAC,CAAC,CAAA;AACzE,IAAA,MAAM,GAAA;AAAA,EACR;AAEA,EAAA,IAAI,OAAA,CAAQ,qBAAqB,KAAA,EAAO;AACtC,IAAA,MAAM,IAAA,CAAK,gBAAA,CAAiB,oBAAA,CAAqB,IAAI,CAAA;AAAA,EACvD;AACA,EAAA,IAAI,OAAA,CAAQ,iBAAiB,KAAA,EAAO;AAClC,IAAA,MAAM,IAAA,CAAK,gBAAA,CAAiB,gBAAA,CAAiB,IAAI,CAAA;AAAA,EACnD;AAEA,EAAA,OAAA,CAAQ,IAAA,CAAK,aAAa,MAAS,CAAA;AAEnC,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,OAAA,CAAQ,EAAA,CAAG,IAAA,CAAK,OAAO,CAAA;AAAA,IAC3B,GAAA,EAAK,OAAA,CAAQ,GAAA,CAAI,IAAA,CAAK,OAAO,CAAA;AAAA,IAC7B,MAAM,SAAA,GAAY;AAChB,MAAA,MAAM,IAAA,GAAO,CAAC,IAAA,CAAK,gBAAA,CAAiB,mBAAA;AACpC,MAAA,MAAM,IAAA,CAAK,gBAAA,CAAiB,oBAAA,CAAqB,IAAI,CAAA;AACrD,MAAA,OAAO,IAAA;AAAA,IACT,CAAA;AAAA,IACA,MAAM,YAAA,GAAe;AACnB,MAAA,MAAM,IAAA,GAAO,CAAC,IAAA,CAAK,gBAAA,CAAiB,eAAA;AACpC,MAAA,MAAM,IAAA,CAAK,gBAAA,CAAiB,gBAAA,CAAiB,IAAI,CAAA;AACjD,MAAA,OAAO,IAAA;AAAA,IACT,CAAA;AAAA,IACA,MAAM,KAAA,GAAQ;AACZ,MAAA,MAAM,KAAK,UAAA,EAAW;AAAA,IACxB,CAAA;AAAA,IACA;AAAA,GACF;AACF","file":"index.js","sourcesContent":["import type { RoomHandleEvent, RoomHandleEventMap } from \"./types\";\n\ntype AnyCb = (payload: never) => void;\n\n/** Emisor de eventos tipado y minimalista para el handle de la sala. */\nexport class TypedEmitter {\n  private readonly listeners = new Map<RoomHandleEvent, Set<AnyCb>>();\n\n  on<E extends RoomHandleEvent>(event: E, cb: (payload: RoomHandleEventMap[E]) => void): void {\n    const set = this.listeners.get(event) ?? new Set<AnyCb>();\n    set.add(cb as AnyCb);\n    this.listeners.set(event, set);\n  }\n\n  off<E extends RoomHandleEvent>(event: E, cb: (payload: RoomHandleEventMap[E]) => void): void {\n    this.listeners.get(event)?.delete(cb as AnyCb);\n  }\n\n  emit<E extends RoomHandleEvent>(event: E, payload: RoomHandleEventMap[E]): void {\n    for (const cb of this.listeners.get(event) ?? []) {\n      (cb as (payload: RoomHandleEventMap[E]) => void)(payload);\n    }\n  }\n}\n","import {\n  type LocalTrackPublication,\n  type RemoteParticipant,\n  type RemoteTrack,\n  Room,\n  RoomEvent,\n} from \"livekit-client\";\nimport { TypedEmitter } from \"./emitter\";\nimport type { JoinRoomOptions, RoomHandle } from \"./types\";\n\n/**\n * Conecta a una sala de LiveKit desde el navegador y monta los videos en el\n * contenedor. Solo necesita `token` + `livekitUrl`; nunca una API key.\n */\nexport async function joinRoom(options: JoinRoomOptions): Promise<RoomHandle> {\n  // Guard defensivo: el tipo ya lo impide, pero rechazamos cualquier intento de\n  // colar credenciales de servidor al navegador.\n  for (const forbidden of [\"apiKey\", \"apiSecret\", \"secret\"]) {\n    if (forbidden in (options as unknown as Record<string, unknown>)) {\n      throw new Error(`joinRoom no acepta \"${forbidden}\": jamás pases credenciales al navegador`);\n    }\n  }\n\n  const { token, livekitUrl, container } = options;\n  const emitter = new TypedEmitter();\n  const room = new Room(options.roomOptions);\n\n  const attach = (track: RemoteTrack): void => {\n    const el = track.attach();\n    el.setAttribute(\"data-lk-track\", track.sid ?? \"\");\n    if (el instanceof HTMLVideoElement) {\n      el.style.width = \"100%\";\n    }\n    container.appendChild(el);\n  };\n\n  room\n    .on(RoomEvent.TrackSubscribed, (track: RemoteTrack) => attach(track))\n    .on(RoomEvent.TrackUnsubscribed, (track: RemoteTrack) => {\n      track.detach().forEach((el) => el.remove());\n    })\n    .on(RoomEvent.LocalTrackPublished, (pub: LocalTrackPublication) => {\n      if (pub.track && pub.kind === \"video\") {\n        const el = pub.track.attach();\n        el.setAttribute(\"data-lk-local\", \"true\");\n        if (el instanceof HTMLMediaElement) {\n          el.muted = true; // evitar eco del audio propio\n        }\n        if (el instanceof HTMLVideoElement) {\n          el.style.width = \"100%\";\n        }\n        container.appendChild(el);\n      }\n    })\n    .on(RoomEvent.ParticipantConnected, (p: RemoteParticipant) =>\n      emitter.emit(\"participantJoined\", { identity: p.identity }),\n    )\n    .on(RoomEvent.ParticipantDisconnected, (p: RemoteParticipant) =>\n      emitter.emit(\"participantLeft\", { identity: p.identity }),\n    )\n    .on(RoomEvent.Disconnected, () => emitter.emit(\"disconnected\", undefined))\n    .on(RoomEvent.MediaDevicesError, (err: Error) => emitter.emit(\"error\", err));\n\n  try {\n    await room.connect(livekitUrl, token, options.connectOptions);\n  } catch (err) {\n    emitter.emit(\"error\", err instanceof Error ? err : new Error(String(err)));\n    throw err;\n  }\n\n  if (options.enableMicrophone !== false) {\n    await room.localParticipant.setMicrophoneEnabled(true);\n  }\n  if (options.enableCamera !== false) {\n    await room.localParticipant.setCameraEnabled(true);\n  }\n\n  emitter.emit(\"connected\", undefined);\n\n  return {\n    on: emitter.on.bind(emitter),\n    off: emitter.off.bind(emitter),\n    async toggleMic() {\n      const next = !room.localParticipant.isMicrophoneEnabled;\n      await room.localParticipant.setMicrophoneEnabled(next);\n      return next;\n    },\n    async toggleCamera() {\n      const next = !room.localParticipant.isCameraEnabled;\n      await room.localParticipant.setCameraEnabled(next);\n      return next;\n    },\n    async leave() {\n      await room.disconnect();\n    },\n    room,\n  };\n}\n"]}