@fishjam-cloud/js-server-sdk 0.22.0 → 0.23.0

package/dist/chunk-6DZX6EAA.mjs

@@ -0,0 +1,37 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var __commonJS = (cb, mod) => function __require2() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+export {
+  __require,
+  __commonJS,
+  __toESM
+};

package/dist/index.d.mts

@@ -643,6 +643,10 @@ type FishjamConfig = {
 };
 type ErrorEventHandler = (msg: Event) => void;
 type CloseEventHandler = (code: number, reason: string) => void;
+type AgentCallbacks = {
+    onError?: ErrorEventHandler;
+    onClose?: CloseEventHandler;
+};
 
 type WithRoomId<T> = {
     [P in keyof T]: NonNullable<T[P]> extends {
@@ -713,7 +717,9 @@ type IncomingTrackData = Omit<NonNullable<AgentResponse_TrackData>, 'peerId'> &
 type OutgoingTrackData = Omit<NonNullable<AgentRequest_TrackData>, 'peerId'> & {
     peerId: PeerId;
 };
-type AgentTrack = Track;
+type AgentTrack = Omit<Track, 'id'> & {
+    id: TrackId;
+};
 type TrackType = 'audio' | 'video';
 type AudioCodecParameters = {
     encoding: 'opus' | 'pcm16';
@@ -731,12 +737,27 @@ type AgentEvents = {
 declare const FishjamAgent_base: new () => TypedEventEmitter<AgentEvents>;
 declare class FishjamAgent extends FishjamAgent_base {
     private readonly client;
-    constructor(config: FishjamConfig, agentToken: string, onError: ErrorEventHandler, onClose: CloseEventHandler);
+    private resolveConnectionPromise;
+    private readonly connectionPromise;
+    constructor(config: FishjamConfig, agentToken: string, callbacks?: AgentCallbacks);
+    /**
+     * Await Agent connection to Fishjam.
+     */
+    awaitConnected(): Promise<void>;
     /**
      * Creates an outgoing audio track for the agent
      * @returns a new audio track
      */
     createTrack(codecParameters: AudioCodecParameters, metadata?: object): AgentTrack;
+    /**
+     * Interrupt track indentified by `trackId`.
+     *
+     * Any audio that has been sent by the agent, but not played
+     * by Fishjam will be cleared and be prevented from playing.
+     *
+     * Audio sent after the interrupt will be played normally.
+     */
+    interruptTrack(trackId: TrackId): void;
     /**
      * Deletes an outgoing audio track for the agent
      */
@@ -745,6 +766,7 @@ declare class FishjamAgent extends FishjamAgent_base {
      * Send audio data for the given track
      */
     sendData(trackId: TrackId, data: Uint8Array): void;
+    disconnect(): void;
     private dispatchNotification;
     private setupConnection;
     private isExpectedEvent;
@@ -787,14 +809,14 @@ declare class FishjamClient {
     /**
      * Create a new peer assigned to a room.
      */
-    createPeer(roomId: RoomId, options?: PeerOptions): Promise<{
+    createPeer(roomId: RoomId, options?: PeerOptionsWebRTC): Promise<{
         peer: Peer;
         peerToken: string;
     }>;
     /**
      * Create a new agent assigned to a room.
      */
-    createAgent(roomId: RoomId, options: PeerOptions | undefined, onError: ErrorEventHandler, onClose: CloseEventHandler): Promise<{
+    createAgent(roomId: RoomId, options?: PeerOptionsAgent, callbacks?: AgentCallbacks): Promise<{
         agent: FishjamAgent;
         peer: Peer;
     }>;
@@ -860,4 +882,4 @@ declare class ServiceUnavailableException extends FishjamBaseException {
 declare class UnknownException extends FishjamBaseException {
 }
 
-export { type AgentEvents, type AgentTrack, type AudioCodecParameters, BadRequestException, type Brand, type CloseEventHandler, type ErrorEventHandler, type ExpectedAgentEvents, type ExpectedEvents, FishjamAgent, FishjamBaseException, FishjamClient, type FishjamConfig, FishjamNotFoundException, FishjamWSNotifier, ForbiddenException, type IncomingTrackData, MissingFishjamIdException, type NotificationEvents, type OutgoingTrackData, type Peer, type PeerAdded, type PeerConnected, type PeerCrashed, type PeerDeleted, type PeerDisconnected, type PeerId, type PeerMetadataUpdated, PeerNotFoundException, type PeerOptions, PeerStatus, type Room, type RoomConfig, RoomConfigRoomTypeEnum, RoomConfigVideoCodecEnum, type RoomCrashed, type RoomCreated, type RoomDeleted, type RoomId, RoomNotFoundException, ServerMessage, ServiceUnavailableException, type StreamConnected, type StreamDisconnected, type StreamerToken, type TrackAdded, type TrackId, type TrackMetadataUpdated, type TrackRemoved, type TrackType, UnauthorizedException, UnknownException, type ViewerConnected, type ViewerDisconnected, type ViewerToken };
+export { type AgentCallbacks, type AgentEvents, type AgentTrack, type AudioCodecParameters, BadRequestException, type Brand, type CloseEventHandler, type ErrorEventHandler, type ExpectedAgentEvents, type ExpectedEvents, FishjamAgent, FishjamBaseException, FishjamClient, type FishjamConfig, FishjamNotFoundException, FishjamWSNotifier, ForbiddenException, type IncomingTrackData, MissingFishjamIdException, type NotificationEvents, type OutgoingTrackData, type Peer, type PeerAdded, type PeerConnected, type PeerCrashed, type PeerDeleted, type PeerDisconnected, type PeerId, type PeerMetadataUpdated, PeerNotFoundException, type PeerOptions, type PeerOptionsAgent, type PeerOptionsWebRTC, PeerStatus, type Room, type RoomConfig, RoomConfigRoomTypeEnum, RoomConfigVideoCodecEnum, type RoomCrashed, type RoomCreated, type RoomDeleted, type RoomId, RoomNotFoundException, ServerMessage, ServiceUnavailableException, type StreamConnected, type StreamDisconnected, type StreamerToken, type TrackAdded, type TrackId, type TrackMetadataUpdated, type TrackRemoved, type TrackType, UnauthorizedException, UnknownException, type ViewerConnected, type ViewerDisconnected, type ViewerToken };

package/dist/index.d.ts

@@ -643,6 +643,10 @@ type FishjamConfig = {
 };
 type ErrorEventHandler = (msg: Event) => void;
 type CloseEventHandler = (code: number, reason: string) => void;
+type AgentCallbacks = {
+    onError?: ErrorEventHandler;
+    onClose?: CloseEventHandler;
+};
 
 type WithRoomId<T> = {
     [P in keyof T]: NonNullable<T[P]> extends {
@@ -713,7 +717,9 @@ type IncomingTrackData = Omit<NonNullable<AgentResponse_TrackData>, 'peerId'> &
 type OutgoingTrackData = Omit<NonNullable<AgentRequest_TrackData>, 'peerId'> & {
     peerId: PeerId;
 };
-type AgentTrack = Track;
+type AgentTrack = Omit<Track, 'id'> & {
+    id: TrackId;
+};
 type TrackType = 'audio' | 'video';
 type AudioCodecParameters = {
     encoding: 'opus' | 'pcm16';
@@ -731,12 +737,27 @@ type AgentEvents = {
 declare const FishjamAgent_base: new () => TypedEventEmitter<AgentEvents>;
 declare class FishjamAgent extends FishjamAgent_base {
     private readonly client;
-    constructor(config: FishjamConfig, agentToken: string, onError: ErrorEventHandler, onClose: CloseEventHandler);
+    private resolveConnectionPromise;
+    private readonly connectionPromise;
+    constructor(config: FishjamConfig, agentToken: string, callbacks?: AgentCallbacks);
+    /**
+     * Await Agent connection to Fishjam.
+     */
+    awaitConnected(): Promise<void>;
     /**
      * Creates an outgoing audio track for the agent
      * @returns a new audio track
      */
     createTrack(codecParameters: AudioCodecParameters, metadata?: object): AgentTrack;
+    /**
+     * Interrupt track indentified by `trackId`.
+     *
+     * Any audio that has been sent by the agent, but not played
+     * by Fishjam will be cleared and be prevented from playing.
+     *
+     * Audio sent after the interrupt will be played normally.
+     */
+    interruptTrack(trackId: TrackId): void;
     /**
      * Deletes an outgoing audio track for the agent
      */
@@ -745,6 +766,7 @@ declare class FishjamAgent extends FishjamAgent_base {
      * Send audio data for the given track
      */
     sendData(trackId: TrackId, data: Uint8Array): void;
+    disconnect(): void;
     private dispatchNotification;
     private setupConnection;
     private isExpectedEvent;
@@ -787,14 +809,14 @@ declare class FishjamClient {
     /**
      * Create a new peer assigned to a room.
      */
-    createPeer(roomId: RoomId, options?: PeerOptions): Promise<{
+    createPeer(roomId: RoomId, options?: PeerOptionsWebRTC): Promise<{
         peer: Peer;
         peerToken: string;
     }>;
     /**
      * Create a new agent assigned to a room.
      */
-    createAgent(roomId: RoomId, options: PeerOptions | undefined, onError: ErrorEventHandler, onClose: CloseEventHandler): Promise<{
+    createAgent(roomId: RoomId, options?: PeerOptionsAgent, callbacks?: AgentCallbacks): Promise<{
         agent: FishjamAgent;
         peer: Peer;
     }>;
@@ -860,4 +882,4 @@ declare class ServiceUnavailableException extends FishjamBaseException {
 declare class UnknownException extends FishjamBaseException {
 }
 
-export { type AgentEvents, type AgentTrack, type AudioCodecParameters, BadRequestException, type Brand, type CloseEventHandler, type ErrorEventHandler, type ExpectedAgentEvents, type ExpectedEvents, FishjamAgent, FishjamBaseException, FishjamClient, type FishjamConfig, FishjamNotFoundException, FishjamWSNotifier, ForbiddenException, type IncomingTrackData, MissingFishjamIdException, type NotificationEvents, type OutgoingTrackData, type Peer, type PeerAdded, type PeerConnected, type PeerCrashed, type PeerDeleted, type PeerDisconnected, type PeerId, type PeerMetadataUpdated, PeerNotFoundException, type PeerOptions, PeerStatus, type Room, type RoomConfig, RoomConfigRoomTypeEnum, RoomConfigVideoCodecEnum, type RoomCrashed, type RoomCreated, type RoomDeleted, type RoomId, RoomNotFoundException, ServerMessage, ServiceUnavailableException, type StreamConnected, type StreamDisconnected, type StreamerToken, type TrackAdded, type TrackId, type TrackMetadataUpdated, type TrackRemoved, type TrackType, UnauthorizedException, UnknownException, type ViewerConnected, type ViewerDisconnected, type ViewerToken };
+export { type AgentCallbacks, type AgentEvents, type AgentTrack, type AudioCodecParameters, BadRequestException, type Brand, type CloseEventHandler, type ErrorEventHandler, type ExpectedAgentEvents, type ExpectedEvents, FishjamAgent, FishjamBaseException, FishjamClient, type FishjamConfig, FishjamNotFoundException, FishjamWSNotifier, ForbiddenException, type IncomingTrackData, MissingFishjamIdException, type NotificationEvents, type OutgoingTrackData, type Peer, type PeerAdded, type PeerConnected, type PeerCrashed, type PeerDeleted, type PeerDisconnected, type PeerId, type PeerMetadataUpdated, PeerNotFoundException, type PeerOptions, type PeerOptionsAgent, type PeerOptionsWebRTC, PeerStatus, type Room, type RoomConfig, RoomConfigRoomTypeEnum, RoomConfigVideoCodecEnum, type RoomCrashed, type RoomCreated, type RoomDeleted, type RoomId, RoomNotFoundException, ServerMessage, ServiceUnavailableException, type StreamConnected, type StreamDisconnected, type StreamerToken, type TrackAdded, type TrackId, type TrackMetadataUpdated, type TrackRemoved, type TrackType, UnauthorizedException, UnknownException, type ViewerConnected, type ViewerDisconnected, type ViewerToken };

package/dist/index.js

@@ -19424,6 +19424,8 @@ __export(index_exports, {
   MissingFishjamIdException: () => MissingFishjamIdException,
   PeerNotFoundException: () => PeerNotFoundException,
   PeerOptions: () => import_fishjam_openapi2.PeerOptions,
+  PeerOptionsAgent: () => import_fishjam_openapi2.PeerOptionsAgent,
+  PeerOptionsWebRTC: () => import_fishjam_openapi2.PeerOptionsWebRTC,
   PeerStatus: () => import_fishjam_openapi2.PeerStatus,
   RoomConfig: () => import_fishjam_openapi2.RoomConfig,
   RoomConfigRoomTypeEnum: () => import_fishjam_openapi2.RoomConfigRoomTypeEnum,
@@ -19519,6 +19521,7 @@ var FishjamWSNotifier = class extends import_events.EventEmitter {
     const fishjamUrl = getFishjamUrl(config);
     const websocketUrl = `${httpToWebsocket(fishjamUrl)}/socket/server/websocket`;
     this.client = new WebSocket(websocketUrl);
+    this.client.binaryType = "arraybuffer";
     this.client.onerror = (message) => onError(message);
     this.client.onclose = (message) => onClose(message.code, message.reason);
     this.client.onmessage = (message) => this.dispatchNotification(message);
@@ -19526,7 +19529,8 @@ var FishjamWSNotifier = class extends import_events.EventEmitter {
   }
   dispatchNotification(message) {
     try {
-      const decodedMessage = import_fishjam_proto.ServerMessage.decode(message.data);
+      const data = new Uint8Array(message.data);
+      const decodedMessage = import_fishjam_proto.ServerMessage.decode(data);
       const [notification, msg] = Object.entries(decodedMessage).find(([_k, v]) => v);
       if (!this.isExpectedEvent(notification)) return;
       this.emit(notification, msg);
@@ -19554,16 +19558,27 @@ var import_fishjam_proto2 = __toESM(require_dist2());
 var expectedEventsList2 = ["trackData"];
 var FishjamAgent = class extends import_events2.EventEmitter {
   client;
-  constructor(config, agentToken, onError, onClose) {
+  resolveConnectionPromise = null;
+  connectionPromise;
+  constructor(config, agentToken, callbacks) {
     super();
     const fishjamUrl = getFishjamUrl(config);
     const websocketUrl = `${httpToWebsocket(fishjamUrl)}/socket/agent/websocket`;
     this.client = new WebSocket(websocketUrl);
     this.client.binaryType = "arraybuffer";
-    this.client.onerror = (message) => onError(message);
-    this.client.onclose = (message) => onClose(message.code, message.reason);
+    this.client.onclose = (message) => callbacks?.onClose?.(message.code, message.reason);
+    this.client.onerror = (message) => callbacks?.onError?.(message);
     this.client.onmessage = (message) => this.dispatchNotification(message);
     this.client.onopen = () => this.setupConnection(agentToken);
+    this.connectionPromise = new Promise((resolve) => {
+      this.resolveConnectionPromise = resolve;
+    });
+  }
+  /**
+   * Await Agent connection to Fishjam.
+   */
+  async awaitConnected() {
+    return this.connectionPromise;
   }
   /**
    * Creates an outgoing audio track for the agent
@@ -19580,6 +19595,18 @@ var FishjamAgent = class extends import_events2.EventEmitter {
     this.client.send(addTrack);
     return track;
   }
+  /**
+   * Interrupt track indentified by `trackId`.
+   *
+   * Any audio that has been sent by the agent, but not played
+   * by Fishjam will be cleared and be prevented from playing.
+   *
+   * Audio sent after the interrupt will be played normally.
+   */
+  interruptTrack(trackId) {
+    const msg = import_fishjam_proto2.AgentRequest.encode({ interruptTrack: { trackId } }).finish();
+    this.client.send(msg);
+  }
   /**
    * Deletes an outgoing audio track for the agent
    */
@@ -19594,6 +19621,9 @@ var FishjamAgent = class extends import_events2.EventEmitter {
     const trackData = import_fishjam_proto2.AgentRequest.encode({ trackData: { trackId, data } }).finish();
     this.client.send(trackData);
   }
+  disconnect() {
+    this.client.close();
+  }
   dispatchNotification(message) {
     try {
       const data = new Uint8Array(message.data);
@@ -19608,6 +19638,10 @@ var FishjamAgent = class extends import_events2.EventEmitter {
   setupConnection(agentToken) {
     const auth = import_fishjam_proto2.AgentRequest.encode({ authRequest: { token: agentToken } }).finish();
     this.client.send(auth);
+    if (this.resolveConnectionPromise) {
+      this.resolveConnectionPromise();
+      this.resolveConnectionPromise = null;
+    }
   }
   isExpectedEvent(notification) {
     return expectedEventsList2.includes(notification);
@@ -19738,7 +19772,7 @@ var FishjamClient = class {
   /**
    * Create a new agent assigned to a room.
    */
-  async createAgent(roomId, options = {}, onError, onClose) {
+  async createAgent(roomId, options = {}, callbacks) {
     try {
       const response = await this.roomApi.addPeer(roomId, {
         type: "agent",
@@ -19747,7 +19781,8 @@ var FishjamClient = class {
       const {
         data: { data }
       } = response;
-      const agent = new FishjamAgent(this.fishjamConfig, data.token, onError, onClose);
+      const agent = new FishjamAgent(this.fishjamConfig, data.token, callbacks);
+      await agent.awaitConnected();
       return { agent, peer: data.peer };
     } catch (error) {
       throw mapException(error);
@@ -19846,6 +19881,8 @@ var FishjamClient = class {
   MissingFishjamIdException,
   PeerNotFoundException,
   PeerOptions,
+  PeerOptionsAgent,
+  PeerOptionsWebRTC,
   PeerStatus,
   RoomConfig,
   RoomConfigRoomTypeEnum,

package/dist/index.mjs

@@ -1,69 +1,43 @@
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-var __commonJS = (cb, mod) => function __require2() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
-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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
+import {
+  __commonJS,
+  __require,
+  __toESM
+} from "./chunk-6DZX6EAA.mjs";
 
 // ../fishjam-openapi/dist/index.js
 var require_dist = __commonJS({
   "../fishjam-openapi/dist/index.js"(exports, module) {
     "use strict";
-    var __create2 = Object.create;
-    var __defProp2 = Object.defineProperty;
-    var __getOwnPropDesc2 = Object.getOwnPropertyDescriptor;
-    var __getOwnPropNames2 = Object.getOwnPropertyNames;
-    var __getProtoOf2 = Object.getPrototypeOf;
-    var __hasOwnProp2 = Object.prototype.hasOwnProperty;
+    var __create = Object.create;
+    var __defProp = Object.defineProperty;
+    var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+    var __getOwnPropNames = Object.getOwnPropertyNames;
+    var __getProtoOf = Object.getPrototypeOf;
+    var __hasOwnProp = Object.prototype.hasOwnProperty;
     var __commonJS2 = (cb, mod) => function __require2() {
-      return mod || (0, cb[__getOwnPropNames2(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+      return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
     };
     var __export = (target, all3) => {
       for (var name in all3)
-        __defProp2(target, name, { get: all3[name], enumerable: true });
+        __defProp(target, name, { get: all3[name], enumerable: true });
     };
-    var __copyProps2 = (to, from, except, desc) => {
+    var __copyProps = (to, from, except, desc) => {
       if (from && typeof from === "object" || typeof from === "function") {
-        for (let key of __getOwnPropNames2(from))
-          if (!__hasOwnProp2.call(to, key) && key !== except)
-            __defProp2(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc2(from, key)) || desc.enumerable });
+        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 __toESM2 = (mod, isNodeMode, target) => (target = mod != null ? __create2(__getProtoOf2(mod)) : {}, __copyProps2(
+    var __toESM2 = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
       // If the importer is in node compatibility mode or this is not an ESM
       // file that has been converted to a CommonJS file using a Babel-
       // compatible transform (i.e. "__esModule" has not been set), then set
       // "default" to the CommonJS "module.exports" for node compatibility.
-      isNodeMode || !mod || !mod.__esModule ? __defProp2(target, "default", { value: mod, enumerable: true }) : target,
+      isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
       mod
     ));
-    var __toCommonJS = (mod) => __copyProps2(__defProp2({}, "__esModule", { value: true }), mod);
+    var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
     var require_delayed_stream = __commonJS2({
       "../../node_modules/delayed-stream/lib/delayed_stream.js"(exports2, module2) {
         "use strict";
@@ -15459,23 +15433,23 @@ var require_dist = __commonJS({
 var require_dist2 = __commonJS({
   "../fishjam-proto/dist/index.js"(exports, module) {
     "use strict";
-    var __defProp2 = Object.defineProperty;
-    var __getOwnPropDesc2 = Object.getOwnPropertyDescriptor;
-    var __getOwnPropNames2 = Object.getOwnPropertyNames;
-    var __hasOwnProp2 = Object.prototype.hasOwnProperty;
+    var __defProp = Object.defineProperty;
+    var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+    var __getOwnPropNames = Object.getOwnPropertyNames;
+    var __hasOwnProp = Object.prototype.hasOwnProperty;
     var __export = (target, all) => {
       for (var name in all)
-        __defProp2(target, name, { get: all[name], enumerable: true });
+        __defProp(target, name, { get: all[name], enumerable: true });
     };
-    var __copyProps2 = (to, from, except, desc) => {
+    var __copyProps = (to, from, except, desc) => {
       if (from && typeof from === "object" || typeof from === "function") {
-        for (let key of __getOwnPropNames2(from))
-          if (!__hasOwnProp2.call(to, key) && key !== except)
-            __defProp2(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc2(from, key)) || desc.enumerable });
+        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) => __copyProps2(__defProp2({}, "__esModule", { value: true }), mod);
+    var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
     var index_exports = {};
     __export(index_exports, {
       AgentRequest: () => AgentRequest2,
@@ -19494,6 +19468,7 @@ var FishjamWSNotifier = class extends EventEmitter {
     const fishjamUrl = getFishjamUrl(config);
     const websocketUrl = `${httpToWebsocket(fishjamUrl)}/socket/server/websocket`;
     this.client = new WebSocket(websocketUrl);
+    this.client.binaryType = "arraybuffer";
     this.client.onerror = (message) => onError(message);
     this.client.onclose = (message) => onClose(message.code, message.reason);
     this.client.onmessage = (message) => this.dispatchNotification(message);
@@ -19501,7 +19476,8 @@ var FishjamWSNotifier = class extends EventEmitter {
   }
   dispatchNotification(message) {
     try {
-      const decodedMessage = import_fishjam_proto.ServerMessage.decode(message.data);
+      const data = new Uint8Array(message.data);
+      const decodedMessage = import_fishjam_proto.ServerMessage.decode(data);
       const [notification, msg] = Object.entries(decodedMessage).find(([_k, v]) => v);
       if (!this.isExpectedEvent(notification)) return;
       this.emit(notification, msg);
@@ -19529,16 +19505,27 @@ import { v4 as uuid4 } from "uuid";
 var expectedEventsList2 = ["trackData"];
 var FishjamAgent = class extends EventEmitter2 {
   client;
-  constructor(config, agentToken, onError, onClose) {
+  resolveConnectionPromise = null;
+  connectionPromise;
+  constructor(config, agentToken, callbacks) {
     super();
     const fishjamUrl = getFishjamUrl(config);
     const websocketUrl = `${httpToWebsocket(fishjamUrl)}/socket/agent/websocket`;
     this.client = new WebSocket(websocketUrl);
     this.client.binaryType = "arraybuffer";
-    this.client.onerror = (message) => onError(message);
-    this.client.onclose = (message) => onClose(message.code, message.reason);
+    this.client.onclose = (message) => callbacks?.onClose?.(message.code, message.reason);
+    this.client.onerror = (message) => callbacks?.onError?.(message);
     this.client.onmessage = (message) => this.dispatchNotification(message);
     this.client.onopen = () => this.setupConnection(agentToken);
+    this.connectionPromise = new Promise((resolve) => {
+      this.resolveConnectionPromise = resolve;
+    });
+  }
+  /**
+   * Await Agent connection to Fishjam.
+   */
+  async awaitConnected() {
+    return this.connectionPromise;
   }
   /**
    * Creates an outgoing audio track for the agent
@@ -19555,6 +19542,18 @@ var FishjamAgent = class extends EventEmitter2 {
     this.client.send(addTrack);
     return track;
   }
+  /**
+   * Interrupt track indentified by `trackId`.
+   *
+   * Any audio that has been sent by the agent, but not played
+   * by Fishjam will be cleared and be prevented from playing.
+   *
+   * Audio sent after the interrupt will be played normally.
+   */
+  interruptTrack(trackId) {
+    const msg = import_fishjam_proto2.AgentRequest.encode({ interruptTrack: { trackId } }).finish();
+    this.client.send(msg);
+  }
   /**
    * Deletes an outgoing audio track for the agent
    */
@@ -19569,6 +19568,9 @@ var FishjamAgent = class extends EventEmitter2 {
     const trackData = import_fishjam_proto2.AgentRequest.encode({ trackData: { trackId, data } }).finish();
     this.client.send(trackData);
   }
+  disconnect() {
+    this.client.close();
+  }
   dispatchNotification(message) {
     try {
       const data = new Uint8Array(message.data);
@@ -19583,6 +19585,10 @@ var FishjamAgent = class extends EventEmitter2 {
   setupConnection(agentToken) {
     const auth = import_fishjam_proto2.AgentRequest.encode({ authRequest: { token: agentToken } }).finish();
     this.client.send(auth);
+    if (this.resolveConnectionPromise) {
+      this.resolveConnectionPromise();
+      this.resolveConnectionPromise = null;
+    }
   }
   isExpectedEvent(notification) {
     return expectedEventsList2.includes(notification);
@@ -19713,7 +19719,7 @@ var FishjamClient = class {
   /**
    * Create a new agent assigned to a room.
    */
-  async createAgent(roomId, options = {}, onError, onClose) {
+  async createAgent(roomId, options = {}, callbacks) {
     try {
       const response = await this.roomApi.addPeer(roomId, {
         type: "agent",
@@ -19722,7 +19728,8 @@ var FishjamClient = class {
       const {
         data: { data }
       } = response;
-      const agent = new FishjamAgent(this.fishjamConfig, data.token, onError, onClose);
+      const agent = new FishjamAgent(this.fishjamConfig, data.token, callbacks);
+      await agent.awaitConnected();
       return { agent, peer: data.peer };
     } catch (error) {
       throw mapException(error);
@@ -19810,6 +19817,8 @@ var FishjamClient = class {
   }
 };
 var export_PeerOptions = import_fishjam_openapi2.PeerOptions;
+var export_PeerOptionsAgent = import_fishjam_openapi2.PeerOptionsAgent;
+var export_PeerOptionsWebRTC = import_fishjam_openapi2.PeerOptionsWebRTC;
 var export_PeerStatus = import_fishjam_openapi2.PeerStatus;
 var export_RoomConfig = import_fishjam_openapi2.RoomConfig;
 var export_RoomConfigRoomTypeEnum = import_fishjam_openapi2.RoomConfigRoomTypeEnum;
@@ -19828,6 +19837,8 @@ export {
   MissingFishjamIdException,
   PeerNotFoundException,
   export_PeerOptions as PeerOptions,
+  export_PeerOptionsAgent as PeerOptionsAgent,
+  export_PeerOptionsWebRTC as PeerOptionsWebRTC,
   export_PeerStatus as PeerStatus,
   export_RoomConfig as RoomConfig,
   export_RoomConfigRoomTypeEnum as RoomConfigRoomTypeEnum,

package/dist/integrations/gemini.d.mts

@@ -0,0 +1,39 @@
+import { GoogleGenAIOptions, GoogleGenAI } from '@google/genai';
+
+/**
+ * A collection of settings for Google Gemini integration.
+ */
+declare const _default: {
+    /**
+     * Creates a GoogleGenAI client.
+     * This function dynamically imports the "@google/genai" module,
+     * so it will only be loaded when this function is called.
+     *
+     * @param options Configuration for the GoogleGenAI client.
+     * @returns A GoogleGenAI instance.
+     */
+    createClient: (options: GoogleGenAIOptions) => GoogleGenAI;
+    /**
+     * Predefined audio settings for the agent's output track,
+     * configured for Gemini's 24kHz audio output.
+     */
+    geminiOutputAudioSettings: {
+        readonly encoding: "pcm16";
+        readonly channels: 1;
+        readonly sampleRate: 24000;
+    };
+    /**
+     * Predefined audio settings for subscribing to room audio,
+     * configured for Gemini's 16kHz audio input.
+     */
+    geminiInputAudioSettings: {
+        readonly audioFormat: "pcm16";
+        readonly audioSampleRate: 16000;
+    };
+    /**
+     * The MIME type for the audio data sent to Gemini.
+     */
+    inputMimeType: "audio/pcm;rate=16000";
+};
+
+export { _default as default };

package/dist/integrations/gemini.d.ts

@@ -0,0 +1,39 @@
+import { GoogleGenAIOptions, GoogleGenAI } from '@google/genai';
+
+/**
+ * A collection of settings for Google Gemini integration.
+ */
+declare const _default: {
+    /**
+     * Creates a GoogleGenAI client.
+     * This function dynamically imports the "@google/genai" module,
+     * so it will only be loaded when this function is called.
+     *
+     * @param options Configuration for the GoogleGenAI client.
+     * @returns A GoogleGenAI instance.
+     */
+    createClient: (options: GoogleGenAIOptions) => GoogleGenAI;
+    /**
+     * Predefined audio settings for the agent's output track,
+     * configured for Gemini's 24kHz audio output.
+     */
+    geminiOutputAudioSettings: {
+        readonly encoding: "pcm16";
+        readonly channels: 1;
+        readonly sampleRate: 24000;
+    };
+    /**
+     * Predefined audio settings for subscribing to room audio,
+     * configured for Gemini's 16kHz audio input.
+     */
+    geminiInputAudioSettings: {
+        readonly audioFormat: "pcm16";
+        readonly audioSampleRate: 16000;
+    };
+    /**
+     * The MIME type for the audio data sent to Gemini.
+     */
+    inputMimeType: "audio/pcm;rate=16000";
+};
+
+export { _default as default };

package/dist/integrations/gemini.js

@@ -0,0 +1,154 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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);
+
+// src/integrations/gemini.ts
+var gemini_exports = {};
+__export(gemini_exports, {
+  default: () => gemini_default
+});
+module.exports = __toCommonJS(gemini_exports);
+
+// package.json
+var package_default = {
+  name: "@fishjam-cloud/js-server-sdk",
+  version: "0.23.0",
+  description: "Fishjam server SDK for JavaScript",
+  homepage: "https://github.com/fishjam-cloud/js-server-sdk",
+  author: "Fishjam Team",
+  repository: {
+    type: "git",
+    url: "https://github.com/fishjam-cloud/js-server-sdk.git"
+  },
+  bugs: {
+    url: "https://github.com/fishjam-cloud/js-server-sdk/issues"
+  },
+  license: "Apache-2.0",
+  keywords: [
+    "webrtc",
+    "fishjam",
+    "server",
+    "membrane"
+  ],
+  main: "./dist/index.js",
+  types: "./dist/index.d.ts",
+  files: [
+    "dist"
+  ],
+  exports: {
+    ".": "./dist/index.js",
+    "./gemini": "./dist/integrations/gemini.js"
+  },
+  scripts: {
+    build: "tsup --dts-resolve",
+    format: "prettier --write .",
+    "format:check": "prettier --check .",
+    typecheck: "tsc --noEmit",
+    lint: "eslint . --fix",
+    "lint:check": "eslint . "
+  },
+  tsup: {
+    entry: [
+      "src/index.ts",
+      "src/integrations/gemini.ts",
+      "src/proto.ts"
+    ],
+    noExternal: [
+      "fishjam-openapi",
+      "fishjam-proto"
+    ],
+    minify: false,
+    format: [
+      "cjs",
+      "esm"
+    ],
+    outDir: "dist"
+  },
+  dependencies: {
+    axios: "^1.7.9",
+    uuid: "^11.1.0"
+  },
+  peerDependencies: {
+    "@google/genai": "^1.0.0"
+  },
+  peerDependenciesMeta: {
+    "@google/genai": {
+      optional: true
+    }
+  },
+  devDependencies: {
+    "@fishjam-cloud/fishjam-openapi": "workspace:*",
+    "@fishjam-cloud/fishjam-proto": "workspace:*",
+    "@openapitools/openapi-generator-cli": "^2.18.4",
+    "@types/node": "^22.13.16",
+    "@types/websocket": "^1.0.10",
+    eslint: "^9.33.0",
+    prettier: "^3.6.2",
+    tsup: "^8.4.0",
+    "typed-emitter": "^2.1.0"
+  }
+};
+
+// src/integrations/gemini.ts
+var SDK_NAME = "fishjam-js-server-sdk";
+var gemini_default = {
+  /**
+   * Creates a GoogleGenAI client.
+   * This function dynamically imports the "@google/genai" module,
+   * so it will only be loaded when this function is called.
+   *
+   * @param options Configuration for the GoogleGenAI client.
+   * @returns A GoogleGenAI instance.
+   */
+  createClient: (options) => {
+    const { GoogleGenAI } = require("@google/genai");
+    const trackingHeader = { "X-Goog-Api-Client": `${SDK_NAME}/${package_default.version}` };
+    const finalOptions = {
+      ...options,
+      httpOptions: {
+        ...options.httpOptions,
+        headers: {
+          ...options.httpOptions?.headers,
+          ...trackingHeader
+        }
+      }
+    };
+    return new GoogleGenAI(finalOptions);
+  },
+  /**
+   * Predefined audio settings for the agent's output track,
+   * configured for Gemini's 24kHz audio output.
+   */
+  geminiOutputAudioSettings: {
+    encoding: "pcm16",
+    channels: 1,
+    sampleRate: 24e3
+  },
+  /**
+   * Predefined audio settings for subscribing to room audio,
+   * configured for Gemini's 16kHz audio input.
+   */
+  geminiInputAudioSettings: {
+    audioFormat: "pcm16",
+    audioSampleRate: 16e3
+  },
+  /**
+   * The MIME type for the audio data sent to Gemini.
+   */
+  inputMimeType: "audio/pcm;rate=16000"
+};

package/dist/integrations/gemini.mjs

@@ -0,0 +1,135 @@
+import {
+  __require
+} from "../chunk-6DZX6EAA.mjs";
+
+// package.json
+var package_default = {
+  name: "@fishjam-cloud/js-server-sdk",
+  version: "0.23.0",
+  description: "Fishjam server SDK for JavaScript",
+  homepage: "https://github.com/fishjam-cloud/js-server-sdk",
+  author: "Fishjam Team",
+  repository: {
+    type: "git",
+    url: "https://github.com/fishjam-cloud/js-server-sdk.git"
+  },
+  bugs: {
+    url: "https://github.com/fishjam-cloud/js-server-sdk/issues"
+  },
+  license: "Apache-2.0",
+  keywords: [
+    "webrtc",
+    "fishjam",
+    "server",
+    "membrane"
+  ],
+  main: "./dist/index.js",
+  types: "./dist/index.d.ts",
+  files: [
+    "dist"
+  ],
+  exports: {
+    ".": "./dist/index.js",
+    "./gemini": "./dist/integrations/gemini.js"
+  },
+  scripts: {
+    build: "tsup --dts-resolve",
+    format: "prettier --write .",
+    "format:check": "prettier --check .",
+    typecheck: "tsc --noEmit",
+    lint: "eslint . --fix",
+    "lint:check": "eslint . "
+  },
+  tsup: {
+    entry: [
+      "src/index.ts",
+      "src/integrations/gemini.ts",
+      "src/proto.ts"
+    ],
+    noExternal: [
+      "fishjam-openapi",
+      "fishjam-proto"
+    ],
+    minify: false,
+    format: [
+      "cjs",
+      "esm"
+    ],
+    outDir: "dist"
+  },
+  dependencies: {
+    axios: "^1.7.9",
+    uuid: "^11.1.0"
+  },
+  peerDependencies: {
+    "@google/genai": "^1.0.0"
+  },
+  peerDependenciesMeta: {
+    "@google/genai": {
+      optional: true
+    }
+  },
+  devDependencies: {
+    "@fishjam-cloud/fishjam-openapi": "workspace:*",
+    "@fishjam-cloud/fishjam-proto": "workspace:*",
+    "@openapitools/openapi-generator-cli": "^2.18.4",
+    "@types/node": "^22.13.16",
+    "@types/websocket": "^1.0.10",
+    eslint: "^9.33.0",
+    prettier: "^3.6.2",
+    tsup: "^8.4.0",
+    "typed-emitter": "^2.1.0"
+  }
+};
+
+// src/integrations/gemini.ts
+var SDK_NAME = "fishjam-js-server-sdk";
+var gemini_default = {
+  /**
+   * Creates a GoogleGenAI client.
+   * This function dynamically imports the "@google/genai" module,
+   * so it will only be loaded when this function is called.
+   *
+   * @param options Configuration for the GoogleGenAI client.
+   * @returns A GoogleGenAI instance.
+   */
+  createClient: (options) => {
+    const { GoogleGenAI } = __require("@google/genai");
+    const trackingHeader = { "X-Goog-Api-Client": `${SDK_NAME}/${package_default.version}` };
+    const finalOptions = {
+      ...options,
+      httpOptions: {
+        ...options.httpOptions,
+        headers: {
+          ...options.httpOptions?.headers,
+          ...trackingHeader
+        }
+      }
+    };
+    return new GoogleGenAI(finalOptions);
+  },
+  /**
+   * Predefined audio settings for the agent's output track,
+   * configured for Gemini's 24kHz audio output.
+   */
+  geminiOutputAudioSettings: {
+    encoding: "pcm16",
+    channels: 1,
+    sampleRate: 24e3
+  },
+  /**
+   * Predefined audio settings for subscribing to room audio,
+   * configured for Gemini's 16kHz audio input.
+   */
+  geminiInputAudioSettings: {
+    audioFormat: "pcm16",
+    audioSampleRate: 16e3
+  },
+  /**
+   * The MIME type for the audio data sent to Gemini.
+   */
+  inputMimeType: "audio/pcm;rate=16000"
+};
+export {
+  gemini_default as default
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fishjam-cloud/js-server-sdk",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "Fishjam server SDK for JavaScript",
   "homepage": "https://github.com/fishjam-cloud/js-server-sdk",
   "author": "Fishjam Team",
@@ -24,7 +24,8 @@
     "dist"
   ],
   "exports": {
-    ".": "./dist/index.js"
+    ".": "./dist/index.js",
+    "./gemini": "./dist/integrations/gemini.js"
   },
   "scripts": {
     "build": "tsup --dts-resolve",
@@ -37,6 +38,7 @@
   "tsup": {
     "entry": [
       "src/index.ts",
+      "src/integrations/gemini.ts",
       "src/proto.ts"
     ],
     "noExternal": [
@@ -54,9 +56,17 @@
     "axios": "^1.7.9",
     "uuid": "^11.1.0"
   },
+  "peerDependencies": {
+    "@google/genai": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@google/genai": {
+      "optional": true
+    }
+  },
   "devDependencies": {
-    "@fishjam-cloud/fishjam-openapi": "0.22.0",
-    "@fishjam-cloud/fishjam-proto": "0.22.0",
+    "@fishjam-cloud/fishjam-openapi": "0.23.0",
+    "@fishjam-cloud/fishjam-proto": "0.23.0",
     "@openapitools/openapi-generator-cli": "^2.18.4",
     "@types/node": "^22.13.16",
     "@types/websocket": "^1.0.10",