@relyvolabs/web-sdk 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,108 @@
-# Temporary Holding Version
+# @relyvolabs/web-sdk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Browser client SDK for Relyvo: realtime chat and video calls. The browser holds
+only short-lived credentials minted by your backend — never an API key.
+
+```ts
+import { RelyvoChat, RelyvoCall } from "@relyvolabs/web-sdk";
+
+const chat = new RelyvoChat(credentials);
+await chat.connect();
+chat.on("message", ({ message, senderName }) => render(message, senderName));
+await chat.send({ content: "hello", clientMessageId: crypto.randomUUID() });
+
+const call = await RelyvoCall.connect({ serverUrl, token });
+await call.enableCamera();
+await call.enableMicrophone();
+```
+
+Your backend creates both credential sets with
+[`relyvo-server-sdk`](https://github.com/relyvolabs/relyvo-server-sdk):
+
+| Feature | Server-side call | What the browser receives |
+| --- | --- | --- |
+| Video | `video.createToken(...)` | `serverUrl` + participant `token` |
+| Chat | `chat.upsertUser`, `chat.createUserToken`, realtime tokens | `wsUrl`, connection `token`, `channel`, `subscriptionToken` (+ typing channel) |
+
+## Chat runs without REST
+
+Chat operations are RPC frames on the Centrifugo WebSocket the client already
+holds:
+
+```
+browser ──WS──► Centrifugo ──proxy──► chat-api ──► PostgreSQL
+```
+
+`send`, `history`, `markRead` and `channels` all travel this path, so the browser
+never calls Relyvo REST and no CORS allowance is required. Identity and project
+scope come from the connection token; the SDK never sends a project or user id.
+
+## API
+
+### `new RelyvoChat(credentials, options?)`
+
+| Credential | Meaning |
+| --- | --- |
+| `wsUrl` | Centrifugo WebSocket URL |
+| `token` | Centrifugo connection token |
+| `channel` | Conversation channel (`project:<id>:channel:<id>`) |
+| `subscriptionToken` | Subscription token for that channel |
+| `typingChannel` / `typingSubscriptionToken` | Optional typing sibling |
+
+Methods: `connect()`, `on(event, handler)`, `send()`, `history()`, `markRead()`,
+`channels()`, `disconnect()`.
+
+### Token refresh
+
+Connection and subscription tokens are short-lived. Give the SDK callbacks that
+ask your backend for replacement tokens; the transport reconnects on its own.
+
+```ts
+const chat = new RelyvoChat(credentials, {
+  getConnectionToken: async () => {
+    const response = await fetch("/api/chat/token");
+    return (await response.json()).token;
+  },
+  getSubscriptionToken: async (channel) => {
+    const response = await fetch(`/api/chat/subscription?channel=${encodeURIComponent(channel)}`);
+    return (await response.json()).token;
+  },
+});
+```
+
+The callbacks run when a token expires, never before, and they must reach a
+server: a browser cannot mint these tokens.
+
+Events: `connected`, `disconnected`, `message`, `typing`, `error`.
+
+### `RelyvoCall.connect({ serverUrl, token }, options?)`
+
+Methods: `enableCamera()`, `enableMicrophone()`, `shareScreen()`, `on(event, handler)`,
+`disconnect()`. `call.room` exposes the underlying LiveKit room when you need
+something this wrapper does not cover.
+
+Events: `connected`, `disconnected`, `participantConnected`,
+`participantDisconnected`, `trackSubscribed`, `trackUnsubscribed`,
+`connectionQualityChanged`, `mediaDevicesError`.
+
+## Errors
+
+Every failure is a `RelyvoError` with a stable `code`: transport failures use
+`transport_error` / `connect_failed`, and a rejected RPC carries the chat
+service's own code (`forbidden`, `not_found`, `rate_limited`, …).
+
+## Requirements
+
+- `centrifuge` and `livekit-client` are peer dependencies; install the versions
+  your app already uses so there is one copy of each.
+- Video and screen sharing need a secure context (`https://` or `localhost`).
+
+## Status
+
+`0.1.0`: chat (send, history, read, channels, typing) and call connect with
+camera/microphone/screen control. Attachments, edits and deletes are not exposed
+yet.
+
+## Licence
+
+Proprietary. Not for redistribution.

package/dist/index.cjs

@@ -0,0 +1,303 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  RelyvoCall: () => RelyvoCall,
+  RelyvoChat: () => RelyvoChat,
+  RelyvoError: () => RelyvoError,
+  VERSION: () => VERSION,
+  isRelyvoError: () => isRelyvoError
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/chat.ts
+var import_centrifuge = require("centrifuge");
+
+// src/errors.ts
+var RelyvoError = class extends Error {
+  constructor(code, message, cause) {
+    super(message, cause === void 0 ? void 0 : { cause });
+    /** Stable machine code. RPC failures carry the chat service's code. */
+    __publicField(this, "code");
+    /** Transport-level cause, when there is one. */
+    __publicField(this, "cause");
+    this.name = "RelyvoError";
+    this.code = code;
+    this.cause = cause;
+  }
+};
+function isRelyvoError(error) {
+  return error instanceof RelyvoError;
+}
+
+// src/chat.ts
+var defaultFactory = (wsUrl, options) => new import_centrifuge.Centrifuge(wsUrl, {
+  token: options.token,
+  ...options.getToken === void 0 ? {} : { getToken: options.getToken }
+});
+var RelyvoChat = class {
+  constructor(credentials, options = {}) {
+    __publicField(this, "credentials");
+    __publicField(this, "client");
+    __publicField(this, "connectTimeoutMs");
+    __publicField(this, "getSubscriptionToken");
+    __publicField(this, "handlers", {
+      connected: /* @__PURE__ */ new Set(),
+      disconnected: /* @__PURE__ */ new Set(),
+      message: /* @__PURE__ */ new Set(),
+      typing: /* @__PURE__ */ new Set(),
+      error: /* @__PURE__ */ new Set()
+    });
+    __publicField(this, "typingSubscription");
+    __publicField(this, "conversationSubscription");
+    this.credentials = credentials;
+    this.connectTimeoutMs = options.connectTimeoutMs ?? 1e4;
+    this.getSubscriptionToken = options.getSubscriptionToken;
+    this.client = (options.createCentrifuge ?? defaultFactory)(credentials.wsUrl, {
+      token: credentials.token,
+      ...options.getConnectionToken === void 0 ? {} : { getToken: options.getConnectionToken }
+    });
+    this.client.on("connected", () => this.emit("connected"));
+    this.client.on("disconnected", (ctx) => this.emit("disconnected", ctx?.reason));
+    this.client.on(
+      "error",
+      (ctx) => this.emit("error", new RelyvoError("transport_error", String(ctx?.error ?? "connection error")))
+    );
+  }
+  /** Opens the socket and subscribes to the conversation and typing channels. */
+  async connect() {
+    const connected = new Promise((resolve, reject) => {
+      const timer = setTimeout(
+        () => reject(new RelyvoError("connect_timeout", "the realtime connection timed out")),
+        this.connectTimeoutMs
+      );
+      this.handlers.connected.add(() => {
+        clearTimeout(timer);
+        resolve();
+      });
+      this.handlers.error.add((error) => {
+        clearTimeout(timer);
+        reject(error);
+      });
+    });
+    this.client.connect();
+    await connected;
+    this.conversationSubscription = this.client.newSubscription(
+      this.credentials.channel,
+      this.subscriptionTokenOptions(this.credentials.channel, this.credentials.subscriptionToken)
+    );
+    this.conversationSubscription.on("publication", (ctx) => this.handlePublication(ctx?.data));
+    await this.conversationSubscription.subscribe();
+    if (this.credentials.typingChannel && this.credentials.typingSubscriptionToken) {
+      this.typingSubscription = this.client.newSubscription(
+        this.credentials.typingChannel,
+        this.subscriptionTokenOptions(
+          this.credentials.typingChannel,
+          this.credentials.typingSubscriptionToken
+        )
+      );
+      this.typingSubscription.on("publication", (ctx) => this.handleTyping(ctx?.data));
+      await this.typingSubscription.subscribe();
+    }
+  }
+  on(event, handler) {
+    this.handlers[event].add(handler);
+    return () => this.handlers[event].delete(handler);
+  }
+  /** Sends a message. The same clientMessageId returns the original message. */
+  async send(input) {
+    return this.rpc("chat.send", {
+      channel_id: this.channelId,
+      client_message_id: input.clientMessageId,
+      content: input.content,
+      type: input.type ?? "text",
+      ...input.metadata === void 0 ? {} : { metadata: input.metadata }
+    });
+  }
+  /** Reads history backwards from a cursor, or forwards with `direction: "after"`. */
+  history(input = {}) {
+    return this.rpc("chat.history", {
+      channel_id: this.channelId,
+      ...input.before === void 0 ? {} : { cursor: input.before },
+      ...input.limit === void 0 ? {} : { limit: input.limit },
+      ...input.direction === void 0 ? {} : { direction: input.direction }
+    });
+  }
+  /** Marks the channel read up to a message. */
+  async markRead(messageId) {
+    await this.rpc("chat.read", { channel_id: this.channelId, message_id: messageId });
+  }
+  /** Lists the channels this user belongs to. */
+  channels(input = {}) {
+    return this.rpc("chat.channels", input).then((page) => page.items ?? []);
+  }
+  disconnect() {
+    this.conversationSubscription?.unsubscribe();
+    this.typingSubscription?.unsubscribe();
+    this.client.disconnect();
+  }
+  /** Channel id extracted from the subscription channel name. */
+  get channelId() {
+    const parts = this.credentials.channel.split(":");
+    const id = parts[parts.length - 1];
+    if (!id) {
+      throw new RelyvoError("invalid_credentials", "the channel name does not contain an id");
+    }
+    return id;
+  }
+  subscriptionTokenOptions(channel, token) {
+    return {
+      token,
+      ...this.getSubscriptionToken === void 0 ? {} : { getToken: () => this.getSubscriptionToken(channel) }
+    };
+  }
+  async rpc(method, data) {
+    let response;
+    try {
+      response = await this.client.rpc(method, data);
+    } catch (cause) {
+      throw new RelyvoError("transport_error", `rpc ${method} failed`, cause);
+    }
+    const envelope = response?.data;
+    if (!envelope || envelope.ok !== true) {
+      throw new RelyvoError(
+        envelope?.error?.code ?? "rpc_failed",
+        envelope?.error?.message ?? `rpc ${method} failed`
+      );
+    }
+    return envelope.data;
+  }
+  handlePublication(payload) {
+    if (!payload || payload.type !== "chat.message.created") return;
+    const data = payload.data ?? {};
+    if (data.channel_id !== this.channelId || !data.message) return;
+    const event = {
+      message: data.message,
+      channelId: data.channel_id,
+      senderId: data.sender?.id ?? data.message.sender_id,
+      senderName: data.sender?.display_name
+    };
+    this.emit("message", event);
+  }
+  handleTyping(payload) {
+    if (!payload || payload.type !== "chat.typing") return;
+    const data = payload.data ?? {};
+    if (data.channel_id !== this.channelId || !data.user_id) return;
+    const event = {
+      channel_id: data.channel_id,
+      user_id: data.user_id,
+      display_name: data.display_name
+    };
+    this.emit("typing", event);
+  }
+  emit(event, ...args) {
+    for (const handler of this.handlers[event]) {
+      handler(...args);
+    }
+  }
+};
+
+// src/video.ts
+var import_livekit_client = require("livekit-client");
+var defaultFactory2 = () => new import_livekit_client.Room({ adaptiveStream: true, dynacast: true });
+var EVENT_NAMES = {
+  connected: import_livekit_client.RoomEvent.Connected,
+  disconnected: import_livekit_client.RoomEvent.Disconnected,
+  participantConnected: import_livekit_client.RoomEvent.ParticipantConnected,
+  participantDisconnected: import_livekit_client.RoomEvent.ParticipantDisconnected,
+  trackSubscribed: import_livekit_client.RoomEvent.TrackSubscribed,
+  trackUnsubscribed: import_livekit_client.RoomEvent.TrackUnsubscribed,
+  connectionQualityChanged: import_livekit_client.RoomEvent.ConnectionQualityChanged,
+  mediaDevicesError: import_livekit_client.RoomEvent.MediaDevicesError
+};
+var RelyvoCall = class _RelyvoCall {
+  constructor(room) {
+    __publicField(this, "room");
+    __publicField(this, "connected", false);
+    this.room = room;
+  }
+  /** Connects to the room the token was minted for. */
+  static async connect(credentials, options = {}) {
+    if (!credentials.serverUrl || !credentials.token) {
+      throw new RelyvoError("invalid_credentials", "serverUrl and token are required");
+    }
+    const call = new _RelyvoCall((options.createRoom ?? defaultFactory2)());
+    try {
+      await call.room.connect(credentials.serverUrl, credentials.token);
+    } catch (cause) {
+      throw new RelyvoError("connect_failed", "the media connection could not be established", cause);
+    }
+    call.connected = true;
+    return call;
+  }
+  /** Publishes or stops the camera. */
+  async enableCamera(enabled = true) {
+    this.requireConnected();
+    await this.room.localParticipant.setCameraEnabled(enabled);
+  }
+  /** Publishes or stops the microphone. */
+  async enableMicrophone(enabled = true) {
+    this.requireConnected();
+    await this.room.localParticipant.setMicrophoneEnabled(enabled);
+  }
+  /** Starts or stops screen sharing where the browser supports it. */
+  async shareScreen(enabled = true) {
+    this.requireConnected();
+    if (enabled && typeof navigator !== "undefined" && !navigator.mediaDevices?.getDisplayMedia) {
+      throw new RelyvoError("unsupported", "this browser does not support screen sharing");
+    }
+    await this.room.localParticipant.setScreenShareEnabled(enabled);
+  }
+  /** Subscribes to a room event. Returns an unsubscribe function. */
+  on(event, handler) {
+    const name = EVENT_NAMES[event];
+    this.room.on(name, handler);
+    return () => {
+      const target = this.room;
+      target.off?.(name, handler);
+    };
+  }
+  /** Leaves the room and releases the local devices. */
+  disconnect() {
+    if (!this.connected) return;
+    this.connected = false;
+    void this.room.disconnect();
+  }
+  requireConnected() {
+    if (!this.connected) {
+      throw new RelyvoError("not_connected", "the call is not connected");
+    }
+  }
+};
+
+// src/index.ts
+var VERSION = "0.1.0";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RelyvoCall,
+  RelyvoChat,
+  RelyvoError,
+  VERSION,
+  isRelyvoError
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/chat.ts","../src/errors.ts","../src/video.ts"],"sourcesContent":["/**\n * Relyvo browser client SDK.\n *\n * The browser holds only short-lived credentials minted by your backend: a\n * Centrifugo connection token for chat and a LiveKit participant token for\n * media. Chat operations travel as RPC frames on the WebSocket, so this SDK\n * never calls Relyvo REST and never needs a CORS allowance.\n *\n * @example\n * ```ts\n * const chat = new RelyvoChat(credentials);\n * await chat.connect();\n * chat.on(\"message\", ({ message }) => console.log(message.content));\n * await chat.send({ content: \"hello\", clientMessageId: crypto.randomUUID() });\n * ```\n */\n\nexport { RelyvoChat } from \"./chat.js\";\nexport type {\n  CentrifugeClient,\n  CentrifugeFactory,\n  CentrifugeSubscription,\n  RelyvoChatOptions,\n} from \"./chat.js\";\nexport { RelyvoError, isRelyvoError } from \"./errors.js\";\nexport { RelyvoCall } from \"./video.js\";\nexport type { RelyvoCallOptions, RoomFactory, RoomLike } from \"./video.js\";\nexport type {\n  CallCredentials,\n  CallEvent,\n  ChatChannel,\n  ChatCredentials,\n  ChatEventHandler,\n  ChatMessage,\n  ChatMessagePage,\n  ChatMessageType,\n  MessageEvent,\n  TypingEvent,\n} from \"./types.js\";\n\nexport const VERSION = \"0.1.0\";\n","import { Centrifuge } from \"centrifuge\";\n\nimport { RelyvoError } from \"./errors.js\";\nimport type {\n  ChatChannel,\n  ChatCredentials,\n  ChatEventHandler,\n  ChatMessage,\n  ChatMessagePage,\n  MessageEvent,\n  TypingEvent,\n} from \"./types.js\";\n\n/** The subset of the Centrifuge client this SDK depends on. */\nexport interface CentrifugeSubscription {\n  subscribe(): Promise<unknown>;\n  unsubscribe(): void;\n  on(event: \"publication\" | \"subscribed\" | \"error\", handler: (ctx: any) => void): void;\n}\n\n/** Centrifuge fetches a replacement token through getToken when one expires. */\nexport interface ConnectionTokenOptions {\n  token?: string;\n  getToken?: () => Promise<string>;\n}\n\nexport interface SubscriptionTokenOptions {\n  token?: string;\n  getToken?: () => Promise<string>;\n}\n\nexport interface CentrifugeClient {\n  connect(): void;\n  disconnect(): void;\n  on(event: \"connected\" | \"disconnected\" | \"error\", handler: (ctx: any) => void): void;\n  newSubscription(channel: string, options: SubscriptionTokenOptions): CentrifugeSubscription;\n  rpc(method: string, data: unknown): Promise<{ data: unknown }>;\n}\n\nexport type CentrifugeFactory = (wsUrl: string, options: ConnectionTokenOptions) => CentrifugeClient;\n\nconst defaultFactory: CentrifugeFactory = (wsUrl, options) =>\n  new Centrifuge(wsUrl, {\n    token: options.token,\n    ...(options.getToken === undefined ? {} : { getToken: options.getToken }),\n  }) as unknown as CentrifugeClient;\n\nexport interface RelyvoChatOptions {\n  /** Injectable transport, used by tests. */\n  createCentrifuge?: CentrifugeFactory;\n  connectTimeoutMs?: number;\n  /**\n   * Called when the connection token expires. Return a fresh Centrifugo\n   * connection token from your backend; the transport reconnects by itself.\n   */\n  getConnectionToken?: () => Promise<string>;\n  /**\n   * Called when a subscription token expires. Receive the channel name and\n   * return a fresh subscription token for it.\n   */\n  getSubscriptionToken?: (channel: string) => Promise<string>;\n}\n\ntype RpcEnvelope<T> = {\n  ok?: boolean;\n  data?: T;\n  error?: { code?: string; message?: string };\n};\n\n/**\n * Realtime chat over the Centrifugo connection.\n *\n * Every operation is an RPC frame on the WebSocket the client already holds, so\n * the browser never calls Relyvo REST and needs no CORS allowance. Identity comes\n * from the connection token; this class never sends a project or user id.\n */\nexport class RelyvoChat {\n  readonly credentials: ChatCredentials;\n\n  private readonly client: CentrifugeClient;\n  private readonly connectTimeoutMs: number;\n  private readonly getSubscriptionToken?: (channel: string) => Promise<string>;\n  private readonly handlers: { [K in keyof ChatEventHandler]: Set<ChatEventHandler[K]> } = {\n    connected: new Set(),\n    disconnected: new Set(),\n    message: new Set(),\n    typing: new Set(),\n    error: new Set(),\n  };\n  private typingSubscription?: CentrifugeSubscription;\n  private conversationSubscription?: CentrifugeSubscription;\n\n  constructor(credentials: ChatCredentials, options: RelyvoChatOptions = {}) {\n    this.credentials = credentials;\n    this.connectTimeoutMs = options.connectTimeoutMs ?? 10_000;\n    this.getSubscriptionToken = options.getSubscriptionToken;\n    this.client = (options.createCentrifuge ?? defaultFactory)(credentials.wsUrl, {\n      token: credentials.token,\n      ...(options.getConnectionToken === undefined\n        ? {}\n        : { getToken: options.getConnectionToken }),\n    });\n\n    this.client.on(\"connected\", () => this.emit(\"connected\"));\n    this.client.on(\"disconnected\", (ctx) => this.emit(\"disconnected\", ctx?.reason));\n    this.client.on(\"error\", (ctx) =>\n      this.emit(\"error\", new RelyvoError(\"transport_error\", String(ctx?.error ?? \"connection error\"))),\n    );\n  }\n\n  /** Opens the socket and subscribes to the conversation and typing channels. */\n  async connect(): Promise<void> {\n    const connected = new Promise<void>((resolve, reject) => {\n      const timer = setTimeout(\n        () => reject(new RelyvoError(\"connect_timeout\", \"the realtime connection timed out\")),\n        this.connectTimeoutMs,\n      );\n\n      this.handlers.connected.add(() => {\n        clearTimeout(timer);\n        resolve();\n      });\n      this.handlers.error.add((error) => {\n        clearTimeout(timer);\n        reject(error);\n      });\n    });\n\n    this.client.connect();\n    await connected;\n\n    this.conversationSubscription = this.client.newSubscription(\n      this.credentials.channel,\n      this.subscriptionTokenOptions(this.credentials.channel, this.credentials.subscriptionToken),\n    );\n    this.conversationSubscription.on(\"publication\", (ctx) => this.handlePublication(ctx?.data));\n    await this.conversationSubscription.subscribe();\n\n    if (this.credentials.typingChannel && this.credentials.typingSubscriptionToken) {\n      this.typingSubscription = this.client.newSubscription(\n        this.credentials.typingChannel,\n        this.subscriptionTokenOptions(\n          this.credentials.typingChannel,\n          this.credentials.typingSubscriptionToken,\n        ),\n      );\n      this.typingSubscription.on(\"publication\", (ctx) => this.handleTyping(ctx?.data));\n      await this.typingSubscription.subscribe();\n    }\n  }\n\n  on<K extends keyof ChatEventHandler>(event: K, handler: ChatEventHandler[K]): () => void {\n    this.handlers[event].add(handler);\n    return () => this.handlers[event].delete(handler);\n  }\n\n  /** Sends a message. The same clientMessageId returns the original message. */\n  async send(input: {\n    content: string;\n    clientMessageId: string;\n    type?: string;\n    metadata?: Record<string, unknown>;\n  }): Promise<{ message: ChatMessage; created: boolean }> {\n    return this.rpc(\"chat.send\", {\n      channel_id: this.channelId,\n      client_message_id: input.clientMessageId,\n      content: input.content,\n      type: input.type ?? \"text\",\n      ...(input.metadata === undefined ? {} : { metadata: input.metadata }),\n    });\n  }\n\n  /** Reads history backwards from a cursor, or forwards with `direction: \"after\"`. */\n  history(input: { before?: string; limit?: number; direction?: \"before\" | \"after\" } = {}): Promise<ChatMessagePage> {\n    return this.rpc(\"chat.history\", {\n      channel_id: this.channelId,\n      ...(input.before === undefined ? {} : { cursor: input.before }),\n      ...(input.limit === undefined ? {} : { limit: input.limit }),\n      ...(input.direction === undefined ? {} : { direction: input.direction }),\n    });\n  }\n\n  /** Marks the channel read up to a message. */\n  async markRead(messageId: string): Promise<void> {\n    await this.rpc(\"chat.read\", { channel_id: this.channelId, message_id: messageId });\n  }\n\n  /** Lists the channels this user belongs to. */\n  channels(input: { cursor?: string; limit?: number } = {}): Promise<ChatChannel[]> {\n    return this.rpc<{ items: ChatChannel[] }>(\"chat.channels\", input).then((page) => page.items ?? []);\n  }\n\n  disconnect(): void {\n    this.conversationSubscription?.unsubscribe();\n    this.typingSubscription?.unsubscribe();\n    this.client.disconnect();\n  }\n\n  /** Channel id extracted from the subscription channel name. */\n  private get channelId(): string {\n    const parts = this.credentials.channel.split(\":\");\n    const id = parts[parts.length - 1];\n    if (!id) {\n      throw new RelyvoError(\"invalid_credentials\", \"the channel name does not contain an id\");\n    }\n    return id;\n  }\n\n  private subscriptionTokenOptions(\n    channel: string,\n    token: string,\n  ): SubscriptionTokenOptions {\n    return {\n      token,\n      ...(this.getSubscriptionToken === undefined\n        ? {}\n        : { getToken: () => this.getSubscriptionToken!(channel) }),\n    };\n  }\n\n  private async rpc<T>(method: string, data: unknown): Promise<T> {\n    let response: { data: unknown };\n    try {\n      response = await this.client.rpc(method, data);\n    } catch (cause) {\n      throw new RelyvoError(\"transport_error\", `rpc ${method} failed`, cause);\n    }\n\n    const envelope = response?.data as RpcEnvelope<T> | undefined;\n    if (!envelope || envelope.ok !== true) {\n      throw new RelyvoError(\n        envelope?.error?.code ?? \"rpc_failed\",\n        envelope?.error?.message ?? `rpc ${method} failed`,\n      );\n    }\n\n    return envelope.data as T;\n  }\n\n  private handlePublication(payload: any): void {\n    if (!payload || payload.type !== \"chat.message.created\") return;\n\n    const data = payload.data ?? {};\n    if (data.channel_id !== this.channelId || !data.message) return;\n\n    const event: MessageEvent = {\n      message: data.message,\n      channelId: data.channel_id,\n      senderId: data.sender?.id ?? data.message.sender_id,\n      senderName: data.sender?.display_name,\n    };\n    this.emit(\"message\", event);\n  }\n\n  private handleTyping(payload: any): void {\n    if (!payload || payload.type !== \"chat.typing\") return;\n\n    const data = payload.data ?? {};\n    if (data.channel_id !== this.channelId || !data.user_id) return;\n\n    const event: TypingEvent = {\n      channel_id: data.channel_id,\n      user_id: data.user_id,\n      display_name: data.display_name,\n    };\n    this.emit(\"typing\", event);\n  }\n\n  private emit<K extends keyof ChatEventHandler>(event: K, ...args: Parameters<ChatEventHandler[K]>): void {\n    for (const handler of this.handlers[event]) {\n      (handler as (...values: unknown[]) => void)(...args);\n    }\n  }\n}\n","/** One error type for every failure this SDK produces. */\nexport class RelyvoError extends Error {\n  /** Stable machine code. RPC failures carry the chat service's code. */\n  readonly code: string;\n  /** Transport-level cause, when there is one. */\n  readonly cause?: unknown;\n\n  constructor(code: string, message: string, cause?: unknown) {\n    super(message, cause === undefined ? undefined : { cause });\n    this.name = \"RelyvoError\";\n    this.code = code;\n    this.cause = cause;\n  }\n}\n\nexport function isRelyvoError(error: unknown): error is RelyvoError {\n  return error instanceof RelyvoError;\n}\n","import { Room, RoomEvent } from \"livekit-client\";\n\nimport { RelyvoError } from \"./errors.js\";\nimport type { CallCredentials, CallEvent } from \"./types.js\";\n\n/** The subset of the LiveKit Room this SDK depends on. */\nexport interface RoomLike {\n  connect(url: string, token: string): Promise<void>;\n  disconnect(): Promise<void> | void;\n  on(event: string, handler: (...args: any[]) => void): unknown;\n  localParticipant: {\n    setCameraEnabled(enabled: boolean): Promise<void>;\n    setMicrophoneEnabled(enabled: boolean): Promise<void>;\n    setScreenShareEnabled(enabled: boolean): Promise<void>;\n  };\n}\n\nexport type RoomFactory = () => RoomLike;\n\nconst defaultFactory: RoomFactory = () =>\n  new Room({ adaptiveStream: true, dynacast: true }) as unknown as RoomLike;\n\n/** LiveKit event names, mapped so callers do not import the media library. */\nconst EVENT_NAMES: Record<CallEvent, RoomEvent> = {\n  connected: RoomEvent.Connected,\n  disconnected: RoomEvent.Disconnected,\n  participantConnected: RoomEvent.ParticipantConnected,\n  participantDisconnected: RoomEvent.ParticipantDisconnected,\n  trackSubscribed: RoomEvent.TrackSubscribed,\n  trackUnsubscribed: RoomEvent.TrackUnsubscribed,\n  connectionQualityChanged: RoomEvent.ConnectionQualityChanged,\n  mediaDevicesError: RoomEvent.MediaDevicesError,\n};\n\nexport interface RelyvoCallOptions {\n  /** Injectable room, used by tests. */\n  createRoom?: RoomFactory;\n}\n\n/**\n * One video or voice call.\n *\n * The participant token is minted by your backend with the Relyvo server SDK; the\n * grant is join-only and already scoped to the room, so this class cannot ask for\n * more than that token allows.\n */\nexport class RelyvoCall {\n  readonly room: RoomLike;\n  private connected = false;\n\n  private constructor(room: RoomLike) {\n    this.room = room;\n  }\n\n  /** Connects to the room the token was minted for. */\n  static async connect(\n    credentials: CallCredentials,\n    options: RelyvoCallOptions = {},\n  ): Promise<RelyvoCall> {\n    if (!credentials.serverUrl || !credentials.token) {\n      throw new RelyvoError(\"invalid_credentials\", \"serverUrl and token are required\");\n    }\n\n    const call = new RelyvoCall((options.createRoom ?? defaultFactory)());\n\n    try {\n      await call.room.connect(credentials.serverUrl, credentials.token);\n    } catch (cause) {\n      throw new RelyvoError(\"connect_failed\", \"the media connection could not be established\", cause);\n    }\n\n    call.connected = true;\n    return call;\n  }\n\n  /** Publishes or stops the camera. */\n  async enableCamera(enabled = true): Promise<void> {\n    this.requireConnected();\n    await this.room.localParticipant.setCameraEnabled(enabled);\n  }\n\n  /** Publishes or stops the microphone. */\n  async enableMicrophone(enabled = true): Promise<void> {\n    this.requireConnected();\n    await this.room.localParticipant.setMicrophoneEnabled(enabled);\n  }\n\n  /** Starts or stops screen sharing where the browser supports it. */\n  async shareScreen(enabled = true): Promise<void> {\n    this.requireConnected();\n    if (enabled && typeof navigator !== \"undefined\" && !navigator.mediaDevices?.getDisplayMedia) {\n      throw new RelyvoError(\"unsupported\", \"this browser does not support screen sharing\");\n    }\n    await this.room.localParticipant.setScreenShareEnabled(enabled);\n  }\n\n  /** Subscribes to a room event. Returns an unsubscribe function. */\n  on(event: CallEvent, handler: (...args: any[]) => void): () => void {\n    const name = EVENT_NAMES[event];\n    this.room.on(name, handler);\n    return () => {\n      const target = this.room as unknown as {\n        off?: (event: string, callback: (...args: any[]) => void) => void;\n      };\n      target.off?.(name, handler);\n    };\n  }\n\n  /** Leaves the room and releases the local devices. */\n  disconnect(): void {\n    if (!this.connected) return;\n    this.connected = false;\n    void this.room.disconnect();\n  }\n\n  private requireConnected(): void {\n    if (!this.connected) {\n      throw new RelyvoError(\"not_connected\", \"the call is not connected\");\n    }\n  }\n}\n"],"mappings":"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","names":["defaultFactory"]}

package/dist/index.d.cts

@@ -0,0 +1,232 @@
+type ChatMessageType = "text" | "system" | "attachment";
+interface ChatMessage {
+    id: string;
+    channel_id: string;
+    channel_seq: number;
+    sender_id: string;
+    client_message_id?: string;
+    type: ChatMessageType;
+    content: string;
+    metadata?: Record<string, unknown> | null;
+    reply_to_message_id?: string | null;
+    created_at: string;
+    updated_at?: string;
+    deleted_at?: string | null;
+}
+interface ChatMessagePage {
+    items: ChatMessage[];
+    has_more: boolean;
+    next_cursor?: string;
+}
+interface ChatChannel {
+    id: string;
+    type: string;
+    name: string;
+    last_seq: number;
+    external_id?: string;
+}
+/** Credentials your backend mints with the Relyvo server SDK. */
+interface ChatCredentials {
+    /** Centrifugo WebSocket URL, e.g. wss://chat.example.com/connection/websocket */
+    wsUrl: string;
+    /** Centrifugo connection token for this user. */
+    token: string;
+    /** Conversation channel, e.g. project:<projectID>:channel:<channelID> */
+    channel: string;
+    /** Subscription token for the conversation channel. */
+    subscriptionToken: string;
+    /** Optional sibling channel that carries typing events. */
+    typingChannel?: string;
+    /** Subscription token for the typing channel. */
+    typingSubscriptionToken?: string;
+}
+interface CallCredentials {
+    /** Browser-facing LiveKit URL, e.g. wss://rtc.example.com */
+    serverUrl: string;
+    /** Short-lived participant token minted by your backend. */
+    token: string;
+}
+interface TypingEvent {
+    channel_id: string;
+    user_id: string;
+    display_name?: string;
+}
+interface MessageEvent {
+    message: ChatMessage;
+    senderId: string;
+    senderName?: string;
+    channelId: string;
+}
+type ChatEventHandler = {
+    connected: () => void;
+    disconnected: (reason?: string) => void;
+    message: (event: MessageEvent) => void;
+    typing: (event: TypingEvent) => void;
+    error: (error: Error) => void;
+};
+type CallEvent = "connected" | "disconnected" | "participantConnected" | "participantDisconnected" | "trackSubscribed" | "trackUnsubscribed" | "connectionQualityChanged" | "mediaDevicesError";
+
+/** The subset of the Centrifuge client this SDK depends on. */
+interface CentrifugeSubscription {
+    subscribe(): Promise<unknown>;
+    unsubscribe(): void;
+    on(event: "publication" | "subscribed" | "error", handler: (ctx: any) => void): void;
+}
+/** Centrifuge fetches a replacement token through getToken when one expires. */
+interface ConnectionTokenOptions {
+    token?: string;
+    getToken?: () => Promise<string>;
+}
+interface SubscriptionTokenOptions {
+    token?: string;
+    getToken?: () => Promise<string>;
+}
+interface CentrifugeClient {
+    connect(): void;
+    disconnect(): void;
+    on(event: "connected" | "disconnected" | "error", handler: (ctx: any) => void): void;
+    newSubscription(channel: string, options: SubscriptionTokenOptions): CentrifugeSubscription;
+    rpc(method: string, data: unknown): Promise<{
+        data: unknown;
+    }>;
+}
+type CentrifugeFactory = (wsUrl: string, options: ConnectionTokenOptions) => CentrifugeClient;
+interface RelyvoChatOptions {
+    /** Injectable transport, used by tests. */
+    createCentrifuge?: CentrifugeFactory;
+    connectTimeoutMs?: number;
+    /**
+     * Called when the connection token expires. Return a fresh Centrifugo
+     * connection token from your backend; the transport reconnects by itself.
+     */
+    getConnectionToken?: () => Promise<string>;
+    /**
+     * Called when a subscription token expires. Receive the channel name and
+     * return a fresh subscription token for it.
+     */
+    getSubscriptionToken?: (channel: string) => Promise<string>;
+}
+/**
+ * Realtime chat over the Centrifugo connection.
+ *
+ * Every operation is an RPC frame on the WebSocket the client already holds, so
+ * the browser never calls Relyvo REST and needs no CORS allowance. Identity comes
+ * from the connection token; this class never sends a project or user id.
+ */
+declare class RelyvoChat {
+    readonly credentials: ChatCredentials;
+    private readonly client;
+    private readonly connectTimeoutMs;
+    private readonly getSubscriptionToken?;
+    private readonly handlers;
+    private typingSubscription?;
+    private conversationSubscription?;
+    constructor(credentials: ChatCredentials, options?: RelyvoChatOptions);
+    /** Opens the socket and subscribes to the conversation and typing channels. */
+    connect(): Promise<void>;
+    on<K extends keyof ChatEventHandler>(event: K, handler: ChatEventHandler[K]): () => void;
+    /** Sends a message. The same clientMessageId returns the original message. */
+    send(input: {
+        content: string;
+        clientMessageId: string;
+        type?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<{
+        message: ChatMessage;
+        created: boolean;
+    }>;
+    /** Reads history backwards from a cursor, or forwards with `direction: "after"`. */
+    history(input?: {
+        before?: string;
+        limit?: number;
+        direction?: "before" | "after";
+    }): Promise<ChatMessagePage>;
+    /** Marks the channel read up to a message. */
+    markRead(messageId: string): Promise<void>;
+    /** Lists the channels this user belongs to. */
+    channels(input?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<ChatChannel[]>;
+    disconnect(): void;
+    /** Channel id extracted from the subscription channel name. */
+    private get channelId();
+    private subscriptionTokenOptions;
+    private rpc;
+    private handlePublication;
+    private handleTyping;
+    private emit;
+}
+
+/** One error type for every failure this SDK produces. */
+declare class RelyvoError extends Error {
+    /** Stable machine code. RPC failures carry the chat service's code. */
+    readonly code: string;
+    /** Transport-level cause, when there is one. */
+    readonly cause?: unknown;
+    constructor(code: string, message: string, cause?: unknown);
+}
+declare function isRelyvoError(error: unknown): error is RelyvoError;
+
+/** The subset of the LiveKit Room this SDK depends on. */
+interface RoomLike {
+    connect(url: string, token: string): Promise<void>;
+    disconnect(): Promise<void> | void;
+    on(event: string, handler: (...args: any[]) => void): unknown;
+    localParticipant: {
+        setCameraEnabled(enabled: boolean): Promise<void>;
+        setMicrophoneEnabled(enabled: boolean): Promise<void>;
+        setScreenShareEnabled(enabled: boolean): Promise<void>;
+    };
+}
+type RoomFactory = () => RoomLike;
+interface RelyvoCallOptions {
+    /** Injectable room, used by tests. */
+    createRoom?: RoomFactory;
+}
+/**
+ * One video or voice call.
+ *
+ * The participant token is minted by your backend with the Relyvo server SDK; the
+ * grant is join-only and already scoped to the room, so this class cannot ask for
+ * more than that token allows.
+ */
+declare class RelyvoCall {
+    readonly room: RoomLike;
+    private connected;
+    private constructor();
+    /** Connects to the room the token was minted for. */
+    static connect(credentials: CallCredentials, options?: RelyvoCallOptions): Promise<RelyvoCall>;
+    /** Publishes or stops the camera. */
+    enableCamera(enabled?: boolean): Promise<void>;
+    /** Publishes or stops the microphone. */
+    enableMicrophone(enabled?: boolean): Promise<void>;
+    /** Starts or stops screen sharing where the browser supports it. */
+    shareScreen(enabled?: boolean): Promise<void>;
+    /** Subscribes to a room event. Returns an unsubscribe function. */
+    on(event: CallEvent, handler: (...args: any[]) => void): () => void;
+    /** Leaves the room and releases the local devices. */
+    disconnect(): void;
+    private requireConnected;
+}
+
+/**
+ * Relyvo browser client SDK.
+ *
+ * The browser holds only short-lived credentials minted by your backend: a
+ * Centrifugo connection token for chat and a LiveKit participant token for
+ * media. Chat operations travel as RPC frames on the WebSocket, so this SDK
+ * never calls Relyvo REST and never needs a CORS allowance.
+ *
+ * @example
+ * ```ts
+ * const chat = new RelyvoChat(credentials);
+ * await chat.connect();
+ * chat.on("message", ({ message }) => console.log(message.content));
+ * await chat.send({ content: "hello", clientMessageId: crypto.randomUUID() });
+ * ```
+ */
+
+declare const VERSION = "0.1.0";
+
+export { type CallCredentials, type CallEvent, type CentrifugeClient, type CentrifugeFactory, type CentrifugeSubscription, type ChatChannel, type ChatCredentials, type ChatEventHandler, type ChatMessage, type ChatMessagePage, type ChatMessageType, type MessageEvent, RelyvoCall, type RelyvoCallOptions, RelyvoChat, type RelyvoChatOptions, RelyvoError, type RoomFactory, type RoomLike, type TypingEvent, VERSION, isRelyvoError };

package/dist/index.d.ts

@@ -0,0 +1,232 @@
+type ChatMessageType = "text" | "system" | "attachment";
+interface ChatMessage {
+    id: string;
+    channel_id: string;
+    channel_seq: number;
+    sender_id: string;
+    client_message_id?: string;
+    type: ChatMessageType;
+    content: string;
+    metadata?: Record<string, unknown> | null;
+    reply_to_message_id?: string | null;
+    created_at: string;
+    updated_at?: string;
+    deleted_at?: string | null;
+}
+interface ChatMessagePage {
+    items: ChatMessage[];
+    has_more: boolean;
+    next_cursor?: string;
+}
+interface ChatChannel {
+    id: string;
+    type: string;
+    name: string;
+    last_seq: number;
+    external_id?: string;
+}
+/** Credentials your backend mints with the Relyvo server SDK. */
+interface ChatCredentials {
+    /** Centrifugo WebSocket URL, e.g. wss://chat.example.com/connection/websocket */
+    wsUrl: string;
+    /** Centrifugo connection token for this user. */
+    token: string;
+    /** Conversation channel, e.g. project:<projectID>:channel:<channelID> */
+    channel: string;
+    /** Subscription token for the conversation channel. */
+    subscriptionToken: string;
+    /** Optional sibling channel that carries typing events. */
+    typingChannel?: string;
+    /** Subscription token for the typing channel. */
+    typingSubscriptionToken?: string;
+}
+interface CallCredentials {
+    /** Browser-facing LiveKit URL, e.g. wss://rtc.example.com */
+    serverUrl: string;
+    /** Short-lived participant token minted by your backend. */
+    token: string;
+}
+interface TypingEvent {
+    channel_id: string;
+    user_id: string;
+    display_name?: string;
+}
+interface MessageEvent {
+    message: ChatMessage;
+    senderId: string;
+    senderName?: string;
+    channelId: string;
+}
+type ChatEventHandler = {
+    connected: () => void;
+    disconnected: (reason?: string) => void;
+    message: (event: MessageEvent) => void;
+    typing: (event: TypingEvent) => void;
+    error: (error: Error) => void;
+};
+type CallEvent = "connected" | "disconnected" | "participantConnected" | "participantDisconnected" | "trackSubscribed" | "trackUnsubscribed" | "connectionQualityChanged" | "mediaDevicesError";
+
+/** The subset of the Centrifuge client this SDK depends on. */
+interface CentrifugeSubscription {
+    subscribe(): Promise<unknown>;
+    unsubscribe(): void;
+    on(event: "publication" | "subscribed" | "error", handler: (ctx: any) => void): void;
+}
+/** Centrifuge fetches a replacement token through getToken when one expires. */
+interface ConnectionTokenOptions {
+    token?: string;
+    getToken?: () => Promise<string>;
+}
+interface SubscriptionTokenOptions {
+    token?: string;
+    getToken?: () => Promise<string>;
+}
+interface CentrifugeClient {
+    connect(): void;
+    disconnect(): void;
+    on(event: "connected" | "disconnected" | "error", handler: (ctx: any) => void): void;
+    newSubscription(channel: string, options: SubscriptionTokenOptions): CentrifugeSubscription;
+    rpc(method: string, data: unknown): Promise<{
+        data: unknown;
+    }>;
+}
+type CentrifugeFactory = (wsUrl: string, options: ConnectionTokenOptions) => CentrifugeClient;
+interface RelyvoChatOptions {
+    /** Injectable transport, used by tests. */
+    createCentrifuge?: CentrifugeFactory;
+    connectTimeoutMs?: number;
+    /**
+     * Called when the connection token expires. Return a fresh Centrifugo
+     * connection token from your backend; the transport reconnects by itself.
+     */
+    getConnectionToken?: () => Promise<string>;
+    /**
+     * Called when a subscription token expires. Receive the channel name and
+     * return a fresh subscription token for it.
+     */
+    getSubscriptionToken?: (channel: string) => Promise<string>;
+}
+/**
+ * Realtime chat over the Centrifugo connection.
+ *
+ * Every operation is an RPC frame on the WebSocket the client already holds, so
+ * the browser never calls Relyvo REST and needs no CORS allowance. Identity comes
+ * from the connection token; this class never sends a project or user id.
+ */
+declare class RelyvoChat {
+    readonly credentials: ChatCredentials;
+    private readonly client;
+    private readonly connectTimeoutMs;
+    private readonly getSubscriptionToken?;
+    private readonly handlers;
+    private typingSubscription?;
+    private conversationSubscription?;
+    constructor(credentials: ChatCredentials, options?: RelyvoChatOptions);
+    /** Opens the socket and subscribes to the conversation and typing channels. */
+    connect(): Promise<void>;
+    on<K extends keyof ChatEventHandler>(event: K, handler: ChatEventHandler[K]): () => void;
+    /** Sends a message. The same clientMessageId returns the original message. */
+    send(input: {
+        content: string;
+        clientMessageId: string;
+        type?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<{
+        message: ChatMessage;
+        created: boolean;
+    }>;
+    /** Reads history backwards from a cursor, or forwards with `direction: "after"`. */
+    history(input?: {
+        before?: string;
+        limit?: number;
+        direction?: "before" | "after";
+    }): Promise<ChatMessagePage>;
+    /** Marks the channel read up to a message. */
+    markRead(messageId: string): Promise<void>;
+    /** Lists the channels this user belongs to. */
+    channels(input?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<ChatChannel[]>;
+    disconnect(): void;
+    /** Channel id extracted from the subscription channel name. */
+    private get channelId();
+    private subscriptionTokenOptions;
+    private rpc;
+    private handlePublication;
+    private handleTyping;
+    private emit;
+}
+
+/** One error type for every failure this SDK produces. */
+declare class RelyvoError extends Error {
+    /** Stable machine code. RPC failures carry the chat service's code. */
+    readonly code: string;
+    /** Transport-level cause, when there is one. */
+    readonly cause?: unknown;
+    constructor(code: string, message: string, cause?: unknown);
+}
+declare function isRelyvoError(error: unknown): error is RelyvoError;
+
+/** The subset of the LiveKit Room this SDK depends on. */
+interface RoomLike {
+    connect(url: string, token: string): Promise<void>;
+    disconnect(): Promise<void> | void;
+    on(event: string, handler: (...args: any[]) => void): unknown;
+    localParticipant: {
+        setCameraEnabled(enabled: boolean): Promise<void>;
+        setMicrophoneEnabled(enabled: boolean): Promise<void>;
+        setScreenShareEnabled(enabled: boolean): Promise<void>;
+    };
+}
+type RoomFactory = () => RoomLike;
+interface RelyvoCallOptions {
+    /** Injectable room, used by tests. */
+    createRoom?: RoomFactory;
+}
+/**
+ * One video or voice call.
+ *
+ * The participant token is minted by your backend with the Relyvo server SDK; the
+ * grant is join-only and already scoped to the room, so this class cannot ask for
+ * more than that token allows.
+ */
+declare class RelyvoCall {
+    readonly room: RoomLike;
+    private connected;
+    private constructor();
+    /** Connects to the room the token was minted for. */
+    static connect(credentials: CallCredentials, options?: RelyvoCallOptions): Promise<RelyvoCall>;
+    /** Publishes or stops the camera. */
+    enableCamera(enabled?: boolean): Promise<void>;
+    /** Publishes or stops the microphone. */
+    enableMicrophone(enabled?: boolean): Promise<void>;
+    /** Starts or stops screen sharing where the browser supports it. */
+    shareScreen(enabled?: boolean): Promise<void>;
+    /** Subscribes to a room event. Returns an unsubscribe function. */
+    on(event: CallEvent, handler: (...args: any[]) => void): () => void;
+    /** Leaves the room and releases the local devices. */
+    disconnect(): void;
+    private requireConnected;
+}
+
+/**
+ * Relyvo browser client SDK.
+ *
+ * The browser holds only short-lived credentials minted by your backend: a
+ * Centrifugo connection token for chat and a LiveKit participant token for
+ * media. Chat operations travel as RPC frames on the WebSocket, so this SDK
+ * never calls Relyvo REST and never needs a CORS allowance.
+ *
+ * @example
+ * ```ts
+ * const chat = new RelyvoChat(credentials);
+ * await chat.connect();
+ * chat.on("message", ({ message }) => console.log(message.content));
+ * await chat.send({ content: "hello", clientMessageId: crypto.randomUUID() });
+ * ```
+ */
+
+declare const VERSION = "0.1.0";
+
+export { type CallCredentials, type CallEvent, type CentrifugeClient, type CentrifugeFactory, type CentrifugeSubscription, type ChatChannel, type ChatCredentials, type ChatEventHandler, type ChatMessage, type ChatMessagePage, type ChatMessageType, type MessageEvent, RelyvoCall, type RelyvoCallOptions, RelyvoChat, type RelyvoChatOptions, RelyvoError, type RoomFactory, type RoomLike, type TypingEvent, VERSION, isRelyvoError };

package/dist/index.js

@@ -0,0 +1,274 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/chat.ts
+import { Centrifuge } from "centrifuge";
+
+// src/errors.ts
+var RelyvoError = class extends Error {
+  constructor(code, message, cause) {
+    super(message, cause === void 0 ? void 0 : { cause });
+    /** Stable machine code. RPC failures carry the chat service's code. */
+    __publicField(this, "code");
+    /** Transport-level cause, when there is one. */
+    __publicField(this, "cause");
+    this.name = "RelyvoError";
+    this.code = code;
+    this.cause = cause;
+  }
+};
+function isRelyvoError(error) {
+  return error instanceof RelyvoError;
+}
+
+// src/chat.ts
+var defaultFactory = (wsUrl, options) => new Centrifuge(wsUrl, {
+  token: options.token,
+  ...options.getToken === void 0 ? {} : { getToken: options.getToken }
+});
+var RelyvoChat = class {
+  constructor(credentials, options = {}) {
+    __publicField(this, "credentials");
+    __publicField(this, "client");
+    __publicField(this, "connectTimeoutMs");
+    __publicField(this, "getSubscriptionToken");
+    __publicField(this, "handlers", {
+      connected: /* @__PURE__ */ new Set(),
+      disconnected: /* @__PURE__ */ new Set(),
+      message: /* @__PURE__ */ new Set(),
+      typing: /* @__PURE__ */ new Set(),
+      error: /* @__PURE__ */ new Set()
+    });
+    __publicField(this, "typingSubscription");
+    __publicField(this, "conversationSubscription");
+    this.credentials = credentials;
+    this.connectTimeoutMs = options.connectTimeoutMs ?? 1e4;
+    this.getSubscriptionToken = options.getSubscriptionToken;
+    this.client = (options.createCentrifuge ?? defaultFactory)(credentials.wsUrl, {
+      token: credentials.token,
+      ...options.getConnectionToken === void 0 ? {} : { getToken: options.getConnectionToken }
+    });
+    this.client.on("connected", () => this.emit("connected"));
+    this.client.on("disconnected", (ctx) => this.emit("disconnected", ctx?.reason));
+    this.client.on(
+      "error",
+      (ctx) => this.emit("error", new RelyvoError("transport_error", String(ctx?.error ?? "connection error")))
+    );
+  }
+  /** Opens the socket and subscribes to the conversation and typing channels. */
+  async connect() {
+    const connected = new Promise((resolve, reject) => {
+      const timer = setTimeout(
+        () => reject(new RelyvoError("connect_timeout", "the realtime connection timed out")),
+        this.connectTimeoutMs
+      );
+      this.handlers.connected.add(() => {
+        clearTimeout(timer);
+        resolve();
+      });
+      this.handlers.error.add((error) => {
+        clearTimeout(timer);
+        reject(error);
+      });
+    });
+    this.client.connect();
+    await connected;
+    this.conversationSubscription = this.client.newSubscription(
+      this.credentials.channel,
+      this.subscriptionTokenOptions(this.credentials.channel, this.credentials.subscriptionToken)
+    );
+    this.conversationSubscription.on("publication", (ctx) => this.handlePublication(ctx?.data));
+    await this.conversationSubscription.subscribe();
+    if (this.credentials.typingChannel && this.credentials.typingSubscriptionToken) {
+      this.typingSubscription = this.client.newSubscription(
+        this.credentials.typingChannel,
+        this.subscriptionTokenOptions(
+          this.credentials.typingChannel,
+          this.credentials.typingSubscriptionToken
+        )
+      );
+      this.typingSubscription.on("publication", (ctx) => this.handleTyping(ctx?.data));
+      await this.typingSubscription.subscribe();
+    }
+  }
+  on(event, handler) {
+    this.handlers[event].add(handler);
+    return () => this.handlers[event].delete(handler);
+  }
+  /** Sends a message. The same clientMessageId returns the original message. */
+  async send(input) {
+    return this.rpc("chat.send", {
+      channel_id: this.channelId,
+      client_message_id: input.clientMessageId,
+      content: input.content,
+      type: input.type ?? "text",
+      ...input.metadata === void 0 ? {} : { metadata: input.metadata }
+    });
+  }
+  /** Reads history backwards from a cursor, or forwards with `direction: "after"`. */
+  history(input = {}) {
+    return this.rpc("chat.history", {
+      channel_id: this.channelId,
+      ...input.before === void 0 ? {} : { cursor: input.before },
+      ...input.limit === void 0 ? {} : { limit: input.limit },
+      ...input.direction === void 0 ? {} : { direction: input.direction }
+    });
+  }
+  /** Marks the channel read up to a message. */
+  async markRead(messageId) {
+    await this.rpc("chat.read", { channel_id: this.channelId, message_id: messageId });
+  }
+  /** Lists the channels this user belongs to. */
+  channels(input = {}) {
+    return this.rpc("chat.channels", input).then((page) => page.items ?? []);
+  }
+  disconnect() {
+    this.conversationSubscription?.unsubscribe();
+    this.typingSubscription?.unsubscribe();
+    this.client.disconnect();
+  }
+  /** Channel id extracted from the subscription channel name. */
+  get channelId() {
+    const parts = this.credentials.channel.split(":");
+    const id = parts[parts.length - 1];
+    if (!id) {
+      throw new RelyvoError("invalid_credentials", "the channel name does not contain an id");
+    }
+    return id;
+  }
+  subscriptionTokenOptions(channel, token) {
+    return {
+      token,
+      ...this.getSubscriptionToken === void 0 ? {} : { getToken: () => this.getSubscriptionToken(channel) }
+    };
+  }
+  async rpc(method, data) {
+    let response;
+    try {
+      response = await this.client.rpc(method, data);
+    } catch (cause) {
+      throw new RelyvoError("transport_error", `rpc ${method} failed`, cause);
+    }
+    const envelope = response?.data;
+    if (!envelope || envelope.ok !== true) {
+      throw new RelyvoError(
+        envelope?.error?.code ?? "rpc_failed",
+        envelope?.error?.message ?? `rpc ${method} failed`
+      );
+    }
+    return envelope.data;
+  }
+  handlePublication(payload) {
+    if (!payload || payload.type !== "chat.message.created") return;
+    const data = payload.data ?? {};
+    if (data.channel_id !== this.channelId || !data.message) return;
+    const event = {
+      message: data.message,
+      channelId: data.channel_id,
+      senderId: data.sender?.id ?? data.message.sender_id,
+      senderName: data.sender?.display_name
+    };
+    this.emit("message", event);
+  }
+  handleTyping(payload) {
+    if (!payload || payload.type !== "chat.typing") return;
+    const data = payload.data ?? {};
+    if (data.channel_id !== this.channelId || !data.user_id) return;
+    const event = {
+      channel_id: data.channel_id,
+      user_id: data.user_id,
+      display_name: data.display_name
+    };
+    this.emit("typing", event);
+  }
+  emit(event, ...args) {
+    for (const handler of this.handlers[event]) {
+      handler(...args);
+    }
+  }
+};
+
+// src/video.ts
+import { Room, RoomEvent } from "livekit-client";
+var defaultFactory2 = () => new Room({ adaptiveStream: true, dynacast: true });
+var EVENT_NAMES = {
+  connected: RoomEvent.Connected,
+  disconnected: RoomEvent.Disconnected,
+  participantConnected: RoomEvent.ParticipantConnected,
+  participantDisconnected: RoomEvent.ParticipantDisconnected,
+  trackSubscribed: RoomEvent.TrackSubscribed,
+  trackUnsubscribed: RoomEvent.TrackUnsubscribed,
+  connectionQualityChanged: RoomEvent.ConnectionQualityChanged,
+  mediaDevicesError: RoomEvent.MediaDevicesError
+};
+var RelyvoCall = class _RelyvoCall {
+  constructor(room) {
+    __publicField(this, "room");
+    __publicField(this, "connected", false);
+    this.room = room;
+  }
+  /** Connects to the room the token was minted for. */
+  static async connect(credentials, options = {}) {
+    if (!credentials.serverUrl || !credentials.token) {
+      throw new RelyvoError("invalid_credentials", "serverUrl and token are required");
+    }
+    const call = new _RelyvoCall((options.createRoom ?? defaultFactory2)());
+    try {
+      await call.room.connect(credentials.serverUrl, credentials.token);
+    } catch (cause) {
+      throw new RelyvoError("connect_failed", "the media connection could not be established", cause);
+    }
+    call.connected = true;
+    return call;
+  }
+  /** Publishes or stops the camera. */
+  async enableCamera(enabled = true) {
+    this.requireConnected();
+    await this.room.localParticipant.setCameraEnabled(enabled);
+  }
+  /** Publishes or stops the microphone. */
+  async enableMicrophone(enabled = true) {
+    this.requireConnected();
+    await this.room.localParticipant.setMicrophoneEnabled(enabled);
+  }
+  /** Starts or stops screen sharing where the browser supports it. */
+  async shareScreen(enabled = true) {
+    this.requireConnected();
+    if (enabled && typeof navigator !== "undefined" && !navigator.mediaDevices?.getDisplayMedia) {
+      throw new RelyvoError("unsupported", "this browser does not support screen sharing");
+    }
+    await this.room.localParticipant.setScreenShareEnabled(enabled);
+  }
+  /** Subscribes to a room event. Returns an unsubscribe function. */
+  on(event, handler) {
+    const name = EVENT_NAMES[event];
+    this.room.on(name, handler);
+    return () => {
+      const target = this.room;
+      target.off?.(name, handler);
+    };
+  }
+  /** Leaves the room and releases the local devices. */
+  disconnect() {
+    if (!this.connected) return;
+    this.connected = false;
+    void this.room.disconnect();
+  }
+  requireConnected() {
+    if (!this.connected) {
+      throw new RelyvoError("not_connected", "the call is not connected");
+    }
+  }
+};
+
+// src/index.ts
+var VERSION = "0.1.0";
+export {
+  RelyvoCall,
+  RelyvoChat,
+  RelyvoError,
+  VERSION,
+  isRelyvoError
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/chat.ts","../src/errors.ts","../src/video.ts","../src/index.ts"],"sourcesContent":["import { Centrifuge } from \"centrifuge\";\n\nimport { RelyvoError } from \"./errors.js\";\nimport type {\n  ChatChannel,\n  ChatCredentials,\n  ChatEventHandler,\n  ChatMessage,\n  ChatMessagePage,\n  MessageEvent,\n  TypingEvent,\n} from \"./types.js\";\n\n/** The subset of the Centrifuge client this SDK depends on. */\nexport interface CentrifugeSubscription {\n  subscribe(): Promise<unknown>;\n  unsubscribe(): void;\n  on(event: \"publication\" | \"subscribed\" | \"error\", handler: (ctx: any) => void): void;\n}\n\n/** Centrifuge fetches a replacement token through getToken when one expires. */\nexport interface ConnectionTokenOptions {\n  token?: string;\n  getToken?: () => Promise<string>;\n}\n\nexport interface SubscriptionTokenOptions {\n  token?: string;\n  getToken?: () => Promise<string>;\n}\n\nexport interface CentrifugeClient {\n  connect(): void;\n  disconnect(): void;\n  on(event: \"connected\" | \"disconnected\" | \"error\", handler: (ctx: any) => void): void;\n  newSubscription(channel: string, options: SubscriptionTokenOptions): CentrifugeSubscription;\n  rpc(method: string, data: unknown): Promise<{ data: unknown }>;\n}\n\nexport type CentrifugeFactory = (wsUrl: string, options: ConnectionTokenOptions) => CentrifugeClient;\n\nconst defaultFactory: CentrifugeFactory = (wsUrl, options) =>\n  new Centrifuge(wsUrl, {\n    token: options.token,\n    ...(options.getToken === undefined ? {} : { getToken: options.getToken }),\n  }) as unknown as CentrifugeClient;\n\nexport interface RelyvoChatOptions {\n  /** Injectable transport, used by tests. */\n  createCentrifuge?: CentrifugeFactory;\n  connectTimeoutMs?: number;\n  /**\n   * Called when the connection token expires. Return a fresh Centrifugo\n   * connection token from your backend; the transport reconnects by itself.\n   */\n  getConnectionToken?: () => Promise<string>;\n  /**\n   * Called when a subscription token expires. Receive the channel name and\n   * return a fresh subscription token for it.\n   */\n  getSubscriptionToken?: (channel: string) => Promise<string>;\n}\n\ntype RpcEnvelope<T> = {\n  ok?: boolean;\n  data?: T;\n  error?: { code?: string; message?: string };\n};\n\n/**\n * Realtime chat over the Centrifugo connection.\n *\n * Every operation is an RPC frame on the WebSocket the client already holds, so\n * the browser never calls Relyvo REST and needs no CORS allowance. Identity comes\n * from the connection token; this class never sends a project or user id.\n */\nexport class RelyvoChat {\n  readonly credentials: ChatCredentials;\n\n  private readonly client: CentrifugeClient;\n  private readonly connectTimeoutMs: number;\n  private readonly getSubscriptionToken?: (channel: string) => Promise<string>;\n  private readonly handlers: { [K in keyof ChatEventHandler]: Set<ChatEventHandler[K]> } = {\n    connected: new Set(),\n    disconnected: new Set(),\n    message: new Set(),\n    typing: new Set(),\n    error: new Set(),\n  };\n  private typingSubscription?: CentrifugeSubscription;\n  private conversationSubscription?: CentrifugeSubscription;\n\n  constructor(credentials: ChatCredentials, options: RelyvoChatOptions = {}) {\n    this.credentials = credentials;\n    this.connectTimeoutMs = options.connectTimeoutMs ?? 10_000;\n    this.getSubscriptionToken = options.getSubscriptionToken;\n    this.client = (options.createCentrifuge ?? defaultFactory)(credentials.wsUrl, {\n      token: credentials.token,\n      ...(options.getConnectionToken === undefined\n        ? {}\n        : { getToken: options.getConnectionToken }),\n    });\n\n    this.client.on(\"connected\", () => this.emit(\"connected\"));\n    this.client.on(\"disconnected\", (ctx) => this.emit(\"disconnected\", ctx?.reason));\n    this.client.on(\"error\", (ctx) =>\n      this.emit(\"error\", new RelyvoError(\"transport_error\", String(ctx?.error ?? \"connection error\"))),\n    );\n  }\n\n  /** Opens the socket and subscribes to the conversation and typing channels. */\n  async connect(): Promise<void> {\n    const connected = new Promise<void>((resolve, reject) => {\n      const timer = setTimeout(\n        () => reject(new RelyvoError(\"connect_timeout\", \"the realtime connection timed out\")),\n        this.connectTimeoutMs,\n      );\n\n      this.handlers.connected.add(() => {\n        clearTimeout(timer);\n        resolve();\n      });\n      this.handlers.error.add((error) => {\n        clearTimeout(timer);\n        reject(error);\n      });\n    });\n\n    this.client.connect();\n    await connected;\n\n    this.conversationSubscription = this.client.newSubscription(\n      this.credentials.channel,\n      this.subscriptionTokenOptions(this.credentials.channel, this.credentials.subscriptionToken),\n    );\n    this.conversationSubscription.on(\"publication\", (ctx) => this.handlePublication(ctx?.data));\n    await this.conversationSubscription.subscribe();\n\n    if (this.credentials.typingChannel && this.credentials.typingSubscriptionToken) {\n      this.typingSubscription = this.client.newSubscription(\n        this.credentials.typingChannel,\n        this.subscriptionTokenOptions(\n          this.credentials.typingChannel,\n          this.credentials.typingSubscriptionToken,\n        ),\n      );\n      this.typingSubscription.on(\"publication\", (ctx) => this.handleTyping(ctx?.data));\n      await this.typingSubscription.subscribe();\n    }\n  }\n\n  on<K extends keyof ChatEventHandler>(event: K, handler: ChatEventHandler[K]): () => void {\n    this.handlers[event].add(handler);\n    return () => this.handlers[event].delete(handler);\n  }\n\n  /** Sends a message. The same clientMessageId returns the original message. */\n  async send(input: {\n    content: string;\n    clientMessageId: string;\n    type?: string;\n    metadata?: Record<string, unknown>;\n  }): Promise<{ message: ChatMessage; created: boolean }> {\n    return this.rpc(\"chat.send\", {\n      channel_id: this.channelId,\n      client_message_id: input.clientMessageId,\n      content: input.content,\n      type: input.type ?? \"text\",\n      ...(input.metadata === undefined ? {} : { metadata: input.metadata }),\n    });\n  }\n\n  /** Reads history backwards from a cursor, or forwards with `direction: \"after\"`. */\n  history(input: { before?: string; limit?: number; direction?: \"before\" | \"after\" } = {}): Promise<ChatMessagePage> {\n    return this.rpc(\"chat.history\", {\n      channel_id: this.channelId,\n      ...(input.before === undefined ? {} : { cursor: input.before }),\n      ...(input.limit === undefined ? {} : { limit: input.limit }),\n      ...(input.direction === undefined ? {} : { direction: input.direction }),\n    });\n  }\n\n  /** Marks the channel read up to a message. */\n  async markRead(messageId: string): Promise<void> {\n    await this.rpc(\"chat.read\", { channel_id: this.channelId, message_id: messageId });\n  }\n\n  /** Lists the channels this user belongs to. */\n  channels(input: { cursor?: string; limit?: number } = {}): Promise<ChatChannel[]> {\n    return this.rpc<{ items: ChatChannel[] }>(\"chat.channels\", input).then((page) => page.items ?? []);\n  }\n\n  disconnect(): void {\n    this.conversationSubscription?.unsubscribe();\n    this.typingSubscription?.unsubscribe();\n    this.client.disconnect();\n  }\n\n  /** Channel id extracted from the subscription channel name. */\n  private get channelId(): string {\n    const parts = this.credentials.channel.split(\":\");\n    const id = parts[parts.length - 1];\n    if (!id) {\n      throw new RelyvoError(\"invalid_credentials\", \"the channel name does not contain an id\");\n    }\n    return id;\n  }\n\n  private subscriptionTokenOptions(\n    channel: string,\n    token: string,\n  ): SubscriptionTokenOptions {\n    return {\n      token,\n      ...(this.getSubscriptionToken === undefined\n        ? {}\n        : { getToken: () => this.getSubscriptionToken!(channel) }),\n    };\n  }\n\n  private async rpc<T>(method: string, data: unknown): Promise<T> {\n    let response: { data: unknown };\n    try {\n      response = await this.client.rpc(method, data);\n    } catch (cause) {\n      throw new RelyvoError(\"transport_error\", `rpc ${method} failed`, cause);\n    }\n\n    const envelope = response?.data as RpcEnvelope<T> | undefined;\n    if (!envelope || envelope.ok !== true) {\n      throw new RelyvoError(\n        envelope?.error?.code ?? \"rpc_failed\",\n        envelope?.error?.message ?? `rpc ${method} failed`,\n      );\n    }\n\n    return envelope.data as T;\n  }\n\n  private handlePublication(payload: any): void {\n    if (!payload || payload.type !== \"chat.message.created\") return;\n\n    const data = payload.data ?? {};\n    if (data.channel_id !== this.channelId || !data.message) return;\n\n    const event: MessageEvent = {\n      message: data.message,\n      channelId: data.channel_id,\n      senderId: data.sender?.id ?? data.message.sender_id,\n      senderName: data.sender?.display_name,\n    };\n    this.emit(\"message\", event);\n  }\n\n  private handleTyping(payload: any): void {\n    if (!payload || payload.type !== \"chat.typing\") return;\n\n    const data = payload.data ?? {};\n    if (data.channel_id !== this.channelId || !data.user_id) return;\n\n    const event: TypingEvent = {\n      channel_id: data.channel_id,\n      user_id: data.user_id,\n      display_name: data.display_name,\n    };\n    this.emit(\"typing\", event);\n  }\n\n  private emit<K extends keyof ChatEventHandler>(event: K, ...args: Parameters<ChatEventHandler[K]>): void {\n    for (const handler of this.handlers[event]) {\n      (handler as (...values: unknown[]) => void)(...args);\n    }\n  }\n}\n","/** One error type for every failure this SDK produces. */\nexport class RelyvoError extends Error {\n  /** Stable machine code. RPC failures carry the chat service's code. */\n  readonly code: string;\n  /** Transport-level cause, when there is one. */\n  readonly cause?: unknown;\n\n  constructor(code: string, message: string, cause?: unknown) {\n    super(message, cause === undefined ? undefined : { cause });\n    this.name = \"RelyvoError\";\n    this.code = code;\n    this.cause = cause;\n  }\n}\n\nexport function isRelyvoError(error: unknown): error is RelyvoError {\n  return error instanceof RelyvoError;\n}\n","import { Room, RoomEvent } from \"livekit-client\";\n\nimport { RelyvoError } from \"./errors.js\";\nimport type { CallCredentials, CallEvent } from \"./types.js\";\n\n/** The subset of the LiveKit Room this SDK depends on. */\nexport interface RoomLike {\n  connect(url: string, token: string): Promise<void>;\n  disconnect(): Promise<void> | void;\n  on(event: string, handler: (...args: any[]) => void): unknown;\n  localParticipant: {\n    setCameraEnabled(enabled: boolean): Promise<void>;\n    setMicrophoneEnabled(enabled: boolean): Promise<void>;\n    setScreenShareEnabled(enabled: boolean): Promise<void>;\n  };\n}\n\nexport type RoomFactory = () => RoomLike;\n\nconst defaultFactory: RoomFactory = () =>\n  new Room({ adaptiveStream: true, dynacast: true }) as unknown as RoomLike;\n\n/** LiveKit event names, mapped so callers do not import the media library. */\nconst EVENT_NAMES: Record<CallEvent, RoomEvent> = {\n  connected: RoomEvent.Connected,\n  disconnected: RoomEvent.Disconnected,\n  participantConnected: RoomEvent.ParticipantConnected,\n  participantDisconnected: RoomEvent.ParticipantDisconnected,\n  trackSubscribed: RoomEvent.TrackSubscribed,\n  trackUnsubscribed: RoomEvent.TrackUnsubscribed,\n  connectionQualityChanged: RoomEvent.ConnectionQualityChanged,\n  mediaDevicesError: RoomEvent.MediaDevicesError,\n};\n\nexport interface RelyvoCallOptions {\n  /** Injectable room, used by tests. */\n  createRoom?: RoomFactory;\n}\n\n/**\n * One video or voice call.\n *\n * The participant token is minted by your backend with the Relyvo server SDK; the\n * grant is join-only and already scoped to the room, so this class cannot ask for\n * more than that token allows.\n */\nexport class RelyvoCall {\n  readonly room: RoomLike;\n  private connected = false;\n\n  private constructor(room: RoomLike) {\n    this.room = room;\n  }\n\n  /** Connects to the room the token was minted for. */\n  static async connect(\n    credentials: CallCredentials,\n    options: RelyvoCallOptions = {},\n  ): Promise<RelyvoCall> {\n    if (!credentials.serverUrl || !credentials.token) {\n      throw new RelyvoError(\"invalid_credentials\", \"serverUrl and token are required\");\n    }\n\n    const call = new RelyvoCall((options.createRoom ?? defaultFactory)());\n\n    try {\n      await call.room.connect(credentials.serverUrl, credentials.token);\n    } catch (cause) {\n      throw new RelyvoError(\"connect_failed\", \"the media connection could not be established\", cause);\n    }\n\n    call.connected = true;\n    return call;\n  }\n\n  /** Publishes or stops the camera. */\n  async enableCamera(enabled = true): Promise<void> {\n    this.requireConnected();\n    await this.room.localParticipant.setCameraEnabled(enabled);\n  }\n\n  /** Publishes or stops the microphone. */\n  async enableMicrophone(enabled = true): Promise<void> {\n    this.requireConnected();\n    await this.room.localParticipant.setMicrophoneEnabled(enabled);\n  }\n\n  /** Starts or stops screen sharing where the browser supports it. */\n  async shareScreen(enabled = true): Promise<void> {\n    this.requireConnected();\n    if (enabled && typeof navigator !== \"undefined\" && !navigator.mediaDevices?.getDisplayMedia) {\n      throw new RelyvoError(\"unsupported\", \"this browser does not support screen sharing\");\n    }\n    await this.room.localParticipant.setScreenShareEnabled(enabled);\n  }\n\n  /** Subscribes to a room event. Returns an unsubscribe function. */\n  on(event: CallEvent, handler: (...args: any[]) => void): () => void {\n    const name = EVENT_NAMES[event];\n    this.room.on(name, handler);\n    return () => {\n      const target = this.room as unknown as {\n        off?: (event: string, callback: (...args: any[]) => void) => void;\n      };\n      target.off?.(name, handler);\n    };\n  }\n\n  /** Leaves the room and releases the local devices. */\n  disconnect(): void {\n    if (!this.connected) return;\n    this.connected = false;\n    void this.room.disconnect();\n  }\n\n  private requireConnected(): void {\n    if (!this.connected) {\n      throw new RelyvoError(\"not_connected\", \"the call is not connected\");\n    }\n  }\n}\n","/**\n * Relyvo browser client SDK.\n *\n * The browser holds only short-lived credentials minted by your backend: a\n * Centrifugo connection token for chat and a LiveKit participant token for\n * media. Chat operations travel as RPC frames on the WebSocket, so this SDK\n * never calls Relyvo REST and never needs a CORS allowance.\n *\n * @example\n * ```ts\n * const chat = new RelyvoChat(credentials);\n * await chat.connect();\n * chat.on(\"message\", ({ message }) => console.log(message.content));\n * await chat.send({ content: \"hello\", clientMessageId: crypto.randomUUID() });\n * ```\n */\n\nexport { RelyvoChat } from \"./chat.js\";\nexport type {\n  CentrifugeClient,\n  CentrifugeFactory,\n  CentrifugeSubscription,\n  RelyvoChatOptions,\n} from \"./chat.js\";\nexport { RelyvoError, isRelyvoError } from \"./errors.js\";\nexport { RelyvoCall } from \"./video.js\";\nexport type { RelyvoCallOptions, RoomFactory, RoomLike } from \"./video.js\";\nexport type {\n  CallCredentials,\n  CallEvent,\n  ChatChannel,\n  ChatCredentials,\n  ChatEventHandler,\n  ChatMessage,\n  ChatMessagePage,\n  ChatMessageType,\n  MessageEvent,\n  TypingEvent,\n} from \"./types.js\";\n\nexport const VERSION = \"0.1.0\";\n"],"mappings":"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","names":["defaultFactory"]}

package/package.json

@@ -1,6 +1,63 @@
 {
   "name": "@relyvolabs/web-sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Browser client SDK for Relyvo: realtime chat over Centrifugo and video calls over LiveKit, with no REST and no API key in the browser.",
+  "license": "UNLICENSED",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "relyvo",
+    "rtc",
+    "chat",
+    "sdk",
+    "client",
+    "webrtc"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/relyvolabs/relyvo-web-sdk.git"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "pack:check": "npm pack --dry-run"
+  },
+  "peerDependencies": {
+    "centrifuge": ">=5",
+    "livekit-client": ">=2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "centrifuge": "5.8.0",
+    "livekit-client": "2.23.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild"
+    ]
+  }
+}