@fishjam-cloud/js-server-sdk 0.28.1 → 0.29.0-rc.2

package/dist/{chunk-GTNIELH6.mjs → chunk-ZKMES6M4.mjs}

@@ -1,7 +1,7 @@
 // package.json
 var package_default = {
   name: "@fishjam-cloud/js-server-sdk",
-  version: "0.28.1",
+  version: "0.29.0-rc.2",
   description: "Fishjam server SDK for JavaScript",
   homepage: "https://github.com/fishjam-cloud/js-server-sdk",
   author: "Fishjam Team",
@@ -90,7 +90,8 @@ var package_default = {
     "*.{js,ts,tsx,mjs,cjs}": [
       "eslint --fix --config eslint.config.mjs"
     ]
-  }
+  },
+  stableVersion: "0.28.1"
 };
 
 export {

package/dist/index.d.mts

@@ -840,6 +840,10 @@ type PeerType = PeerType$1 | 'unspecified';
  * with the addition of `'unspecified'` for messages whose track type is not set on the wire.
  */
 type TrackType = TrackType$2 | 'unspecified';
+/**
+ * Voice activity status of a track.
+ */
+type VadStatus = 'speech' | 'silence';
 type Room = {
     id: RoomId;
     peers: Peer[];
@@ -864,14 +868,14 @@ type Track = {
     type: TrackType;
     metadata: string;
 };
-declare const expectedEventsList$1: readonly ["roomCreated", "roomDeleted", "roomCrashed", "peerAdded", "peerDeleted", "peerConnected", "peerDisconnected", "peerMetadataUpdated", "peerCrashed", "streamerConnected", "streamerDisconnected", "viewerConnected", "viewerDisconnected", "trackAdded", "trackRemoved", "trackMetadataUpdated", "channelAdded", "channelRemoved"];
+declare const expectedEventsList$1: readonly ["roomCreated", "roomDeleted", "roomCrashed", "peerAdded", "peerDeleted", "peerConnected", "peerDisconnected", "peerMetadataUpdated", "peerCrashed", "streamerConnected", "streamerDisconnected", "viewerConnected", "viewerDisconnected", "trackAdded", "trackRemoved", "trackMetadataUpdated", "trackForwarding", "trackForwardingRemoved", "vadNotification", "channelAdded", "channelRemoved"];
 type ExpectedEvents = (typeof expectedEventsList$1)[number];
 /**
  * `ServerMessage` oneof members that are intentionally NOT emitted to users.
  * Grouped with a brief rationale so the classification stays reviewable.
  * Mirrors the Python SDK's `IGNORED_NOTIFICATIONS` partition (FCE-3215).
  */
-declare const ignoredEventsList: readonly ["authenticated", "authRequest", "subscribeRequest", "subscribeResponse", "trackForwarding", "trackForwardingRemoved", "vadNotification", "notificationBatch", "streamConnected", "streamDisconnected", "hlsPlayable", "hlsUploaded", "hlsUploadCrashed", "componentCrashed"];
+declare const ignoredEventsList: readonly ["authenticated", "authRequest", "subscribeRequest", "subscribeResponse", "notificationBatch", "streamConnected", "streamDisconnected", "hlsPlayable", "hlsUploaded", "hlsUploadCrashed", "componentCrashed"];
 type IgnoredEvents = (typeof ignoredEventsList)[number];
 /**
  * Field-level overrides applied to every notification payload: branded ID types
@@ -885,6 +889,9 @@ type NotificationOverrides = {
     peerId: PeerId;
     peerType: PeerType;
     track: Track | undefined;
+    audioTrack: Track | undefined;
+    videoTrack: Track | undefined;
+    status: VadStatus;
 };
 /** @inline */
 type Notification<K extends keyof ServerMessage> = Override<NonNullable<ServerMessage[K]>, NotificationOverrides>;
@@ -908,6 +915,9 @@ type Notifications = {
     trackAdded: Notification<'trackAdded'>;
     trackRemoved: Notification<'trackRemoved'>;
     trackMetadataUpdated: Notification<'trackMetadataUpdated'>;
+    trackForwarding: Notification<'trackForwarding'>;
+    trackForwardingRemoved: Notification<'trackForwardingRemoved'>;
+    vadNotification: Notification<'vadNotification'>;
     channelAdded: Notification<'channelAdded'>;
     channelRemoved: Notification<'channelRemoved'>;
 };
@@ -927,6 +937,9 @@ type ViewerDisconnected = Notifications['viewerDisconnected'];
 type TrackAdded = Notifications['trackAdded'];
 type TrackRemoved = Notifications['trackRemoved'];
 type TrackMetadataUpdated = Notifications['trackMetadataUpdated'];
+type TrackForwarding = Notifications['trackForwarding'];
+type TrackForwardingRemoved = Notifications['trackForwardingRemoved'];
+type VadNotification = Notifications['vadNotification'];
 type ChannelAdded = Notifications['channelAdded'];
 type ChannelRemoved = Notifications['channelRemoved'];
 type NotificationEvents = {
@@ -952,6 +965,10 @@ declare const FishjamWSNotifier_base: new () => TypedEventEmitter<NotificationEv
 declare class FishjamWSNotifier extends FishjamWSNotifier_base {
     private readonly client;
     constructor(config: FishjamConfig, onError: ErrorEventHandler, onClose: CloseEventHandler);
+    /**
+     * Close the underlying WebSocket and stop emitting notifications.
+     */
+    disconnect(): void;
     private dispatchNotification;
     private setupConnection;
 }
@@ -1215,4 +1232,4 @@ declare class QuotaExceededException extends FishjamBaseException {
 declare class UnknownException extends FishjamBaseException {
 }
 
-export { type AgentCallbacks, type AgentEvents, type AgentTrack, type AudioCodecParameters, BadRequestException, type Brand, type ChannelAdded, type ChannelRemoved, type CloseEventHandler, type ErrorEventHandler, type ExpectedAgentEvents, type ExpectedEvents, FishjamAgent, FishjamBaseException, FishjamClient, type FishjamConfig, FishjamNotFoundException, FishjamWSNotifier, ForbiddenException, type IgnoredEvents, type IncomingTrackData, type IncomingTrackImage, InvalidFishjamCredentialsException, MissingFishjamIdException, type MoqAccess, type MoqAccessConfig, type NotificationEvents, type OutgoingTrackData, type Override, type Peer, type PeerAdded, type PeerConnected, type PeerCrashed, type PeerDeleted, type PeerDisconnected, type PeerId, type PeerMetadataUpdated, PeerNotFoundException, type PeerOptions, type PeerOptionsAgent, type PeerOptionsVapi, type PeerOptionsWebRTC, PeerStatus, type PeerType, QuotaExceededException, type Room, type RoomConfig, type RoomCrashed, type RoomCreated, type RoomDeleted, type RoomId, RoomNotFoundException, RoomType, ServerMessage, type ServerNotification, ServiceUnavailableException, type StreamerConnected, type StreamerDisconnected, type StreamerToken, type Track, type TrackAdded, type TrackId, type TrackMetadataUpdated, type TrackRemoved, type TrackType, UnauthorizedException, UnknownException, VideoCodec, type ViewerConnected, type ViewerDisconnected, type ViewerToken, decodeServerNotifications };
+export { type AgentCallbacks, type AgentEvents, type AgentTrack, type AudioCodecParameters, BadRequestException, type Brand, type ChannelAdded, type ChannelRemoved, type CloseEventHandler, type ErrorEventHandler, type ExpectedAgentEvents, type ExpectedEvents, FishjamAgent, FishjamBaseException, FishjamClient, type FishjamConfig, FishjamNotFoundException, FishjamWSNotifier, ForbiddenException, type IgnoredEvents, type IncomingTrackData, type IncomingTrackImage, InvalidFishjamCredentialsException, MissingFishjamIdException, type MoqAccess, type MoqAccessConfig, type NotificationEvents, type OutgoingTrackData, type Override, type Peer, type PeerAdded, type PeerConnected, type PeerCrashed, type PeerDeleted, type PeerDisconnected, type PeerId, type PeerMetadataUpdated, PeerNotFoundException, type PeerOptions, type PeerOptionsAgent, type PeerOptionsVapi, type PeerOptionsWebRTC, PeerStatus, type PeerType, QuotaExceededException, type Room, type RoomConfig, type RoomCrashed, type RoomCreated, type RoomDeleted, type RoomId, RoomNotFoundException, RoomType, ServerMessage, type ServerNotification, ServiceUnavailableException, type StreamerConnected, type StreamerDisconnected, type StreamerToken, type Track, type TrackAdded, type TrackForwarding, type TrackForwardingRemoved, type TrackId, type TrackMetadataUpdated, type TrackRemoved, type TrackType, UnauthorizedException, UnknownException, type VadNotification, type VadStatus, VideoCodec, type ViewerConnected, type ViewerDisconnected, type ViewerToken, decodeServerNotifications };

package/dist/index.d.ts

@@ -840,6 +840,10 @@ type PeerType = PeerType$1 | 'unspecified';
  * with the addition of `'unspecified'` for messages whose track type is not set on the wire.
  */
 type TrackType = TrackType$2 | 'unspecified';
+/**
+ * Voice activity status of a track.
+ */
+type VadStatus = 'speech' | 'silence';
 type Room = {
     id: RoomId;
     peers: Peer[];
@@ -864,14 +868,14 @@ type Track = {
     type: TrackType;
     metadata: string;
 };
-declare const expectedEventsList$1: readonly ["roomCreated", "roomDeleted", "roomCrashed", "peerAdded", "peerDeleted", "peerConnected", "peerDisconnected", "peerMetadataUpdated", "peerCrashed", "streamerConnected", "streamerDisconnected", "viewerConnected", "viewerDisconnected", "trackAdded", "trackRemoved", "trackMetadataUpdated", "channelAdded", "channelRemoved"];
+declare const expectedEventsList$1: readonly ["roomCreated", "roomDeleted", "roomCrashed", "peerAdded", "peerDeleted", "peerConnected", "peerDisconnected", "peerMetadataUpdated", "peerCrashed", "streamerConnected", "streamerDisconnected", "viewerConnected", "viewerDisconnected", "trackAdded", "trackRemoved", "trackMetadataUpdated", "trackForwarding", "trackForwardingRemoved", "vadNotification", "channelAdded", "channelRemoved"];
 type ExpectedEvents = (typeof expectedEventsList$1)[number];
 /**
  * `ServerMessage` oneof members that are intentionally NOT emitted to users.
  * Grouped with a brief rationale so the classification stays reviewable.
  * Mirrors the Python SDK's `IGNORED_NOTIFICATIONS` partition (FCE-3215).
  */
-declare const ignoredEventsList: readonly ["authenticated", "authRequest", "subscribeRequest", "subscribeResponse", "trackForwarding", "trackForwardingRemoved", "vadNotification", "notificationBatch", "streamConnected", "streamDisconnected", "hlsPlayable", "hlsUploaded", "hlsUploadCrashed", "componentCrashed"];
+declare const ignoredEventsList: readonly ["authenticated", "authRequest", "subscribeRequest", "subscribeResponse", "notificationBatch", "streamConnected", "streamDisconnected", "hlsPlayable", "hlsUploaded", "hlsUploadCrashed", "componentCrashed"];
 type IgnoredEvents = (typeof ignoredEventsList)[number];
 /**
  * Field-level overrides applied to every notification payload: branded ID types
@@ -885,6 +889,9 @@ type NotificationOverrides = {
     peerId: PeerId;
     peerType: PeerType;
     track: Track | undefined;
+    audioTrack: Track | undefined;
+    videoTrack: Track | undefined;
+    status: VadStatus;
 };
 /** @inline */
 type Notification<K extends keyof ServerMessage> = Override<NonNullable<ServerMessage[K]>, NotificationOverrides>;
@@ -908,6 +915,9 @@ type Notifications = {
     trackAdded: Notification<'trackAdded'>;
     trackRemoved: Notification<'trackRemoved'>;
     trackMetadataUpdated: Notification<'trackMetadataUpdated'>;
+    trackForwarding: Notification<'trackForwarding'>;
+    trackForwardingRemoved: Notification<'trackForwardingRemoved'>;
+    vadNotification: Notification<'vadNotification'>;
     channelAdded: Notification<'channelAdded'>;
     channelRemoved: Notification<'channelRemoved'>;
 };
@@ -927,6 +937,9 @@ type ViewerDisconnected = Notifications['viewerDisconnected'];
 type TrackAdded = Notifications['trackAdded'];
 type TrackRemoved = Notifications['trackRemoved'];
 type TrackMetadataUpdated = Notifications['trackMetadataUpdated'];
+type TrackForwarding = Notifications['trackForwarding'];
+type TrackForwardingRemoved = Notifications['trackForwardingRemoved'];
+type VadNotification = Notifications['vadNotification'];
 type ChannelAdded = Notifications['channelAdded'];
 type ChannelRemoved = Notifications['channelRemoved'];
 type NotificationEvents = {
@@ -952,6 +965,10 @@ declare const FishjamWSNotifier_base: new () => TypedEventEmitter<NotificationEv
 declare class FishjamWSNotifier extends FishjamWSNotifier_base {
     private readonly client;
     constructor(config: FishjamConfig, onError: ErrorEventHandler, onClose: CloseEventHandler);
+    /**
+     * Close the underlying WebSocket and stop emitting notifications.
+     */
+    disconnect(): void;
     private dispatchNotification;
     private setupConnection;
 }
@@ -1215,4 +1232,4 @@ declare class QuotaExceededException extends FishjamBaseException {
 declare class UnknownException extends FishjamBaseException {
 }
 
-export { type AgentCallbacks, type AgentEvents, type AgentTrack, type AudioCodecParameters, BadRequestException, type Brand, type ChannelAdded, type ChannelRemoved, type CloseEventHandler, type ErrorEventHandler, type ExpectedAgentEvents, type ExpectedEvents, FishjamAgent, FishjamBaseException, FishjamClient, type FishjamConfig, FishjamNotFoundException, FishjamWSNotifier, ForbiddenException, type IgnoredEvents, type IncomingTrackData, type IncomingTrackImage, InvalidFishjamCredentialsException, MissingFishjamIdException, type MoqAccess, type MoqAccessConfig, type NotificationEvents, type OutgoingTrackData, type Override, type Peer, type PeerAdded, type PeerConnected, type PeerCrashed, type PeerDeleted, type PeerDisconnected, type PeerId, type PeerMetadataUpdated, PeerNotFoundException, type PeerOptions, type PeerOptionsAgent, type PeerOptionsVapi, type PeerOptionsWebRTC, PeerStatus, type PeerType, QuotaExceededException, type Room, type RoomConfig, type RoomCrashed, type RoomCreated, type RoomDeleted, type RoomId, RoomNotFoundException, RoomType, ServerMessage, type ServerNotification, ServiceUnavailableException, type StreamerConnected, type StreamerDisconnected, type StreamerToken, type Track, type TrackAdded, type TrackId, type TrackMetadataUpdated, type TrackRemoved, type TrackType, UnauthorizedException, UnknownException, VideoCodec, type ViewerConnected, type ViewerDisconnected, type ViewerToken, decodeServerNotifications };
+export { type AgentCallbacks, type AgentEvents, type AgentTrack, type AudioCodecParameters, BadRequestException, type Brand, type ChannelAdded, type ChannelRemoved, type CloseEventHandler, type ErrorEventHandler, type ExpectedAgentEvents, type ExpectedEvents, FishjamAgent, FishjamBaseException, FishjamClient, type FishjamConfig, FishjamNotFoundException, FishjamWSNotifier, ForbiddenException, type IgnoredEvents, type IncomingTrackData, type IncomingTrackImage, InvalidFishjamCredentialsException, MissingFishjamIdException, type MoqAccess, type MoqAccessConfig, type NotificationEvents, type OutgoingTrackData, type Override, type Peer, type PeerAdded, type PeerConnected, type PeerCrashed, type PeerDeleted, type PeerDisconnected, type PeerId, type PeerMetadataUpdated, PeerNotFoundException, type PeerOptions, type PeerOptionsAgent, type PeerOptionsVapi, type PeerOptionsWebRTC, PeerStatus, type PeerType, QuotaExceededException, type Room, type RoomConfig, type RoomCrashed, type RoomCreated, type RoomDeleted, type RoomId, RoomNotFoundException, RoomType, ServerMessage, type ServerNotification, ServiceUnavailableException, type StreamerConnected, type StreamerDisconnected, type StreamerToken, type Track, type TrackAdded, type TrackForwarding, type TrackForwardingRemoved, type TrackId, type TrackMetadataUpdated, type TrackRemoved, type TrackType, UnauthorizedException, UnknownException, type VadNotification, type VadStatus, VideoCodec, type ViewerConnected, type ViewerDisconnected, type ViewerToken, decodeServerNotifications };

package/dist/index.js

@@ -2041,6 +2041,13 @@ function serverMessage_EventTypeToJSON(object) {
       return "UNRECOGNIZED";
   }
 }
+var ServerMessage_VadNotification_Status = /* @__PURE__ */ ((ServerMessage_VadNotification_Status2) => {
+  ServerMessage_VadNotification_Status2[ServerMessage_VadNotification_Status2["STATUS_UNSPECIFIED"] = 0] = "STATUS_UNSPECIFIED";
+  ServerMessage_VadNotification_Status2[ServerMessage_VadNotification_Status2["STATUS_SILENCE"] = 1] = "STATUS_SILENCE";
+  ServerMessage_VadNotification_Status2[ServerMessage_VadNotification_Status2["STATUS_SPEECH"] = 2] = "STATUS_SPEECH";
+  ServerMessage_VadNotification_Status2[ServerMessage_VadNotification_Status2["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+  return ServerMessage_VadNotification_Status2;
+})(ServerMessage_VadNotification_Status || {});
 function serverMessage_VadNotification_StatusFromJSON(object) {
   switch (object) {
     case 0:
@@ -5916,6 +5923,12 @@ var trackTypeMap = {
   [TrackType.TRACK_TYPE_AUDIO]: "audio",
   [TrackType.UNRECOGNIZED]: "unspecified"
 };
+var vadStatusMap = {
+  [ServerMessage_VadNotification_Status.STATUS_UNSPECIFIED]: "silence",
+  [ServerMessage_VadNotification_Status.STATUS_SILENCE]: "silence",
+  [ServerMessage_VadNotification_Status.STATUS_SPEECH]: "speech",
+  [ServerMessage_VadNotification_Status.UNRECOGNIZED]: "silence"
+};
 var expectedEventsList = [
   "roomCreated",
   "roomDeleted",
@@ -5933,6 +5946,9 @@ var expectedEventsList = [
   "trackAdded",
   "trackRemoved",
   "trackMetadataUpdated",
+  "trackForwarding",
+  "trackForwardingRemoved",
+  "vadNotification",
   "channelAdded",
   "channelRemoved"
 ];
@@ -5955,6 +5971,14 @@ var mapNotification = (event, msg) => {
     const trackMsg = msg;
     return { ...trackMsg, track: mapTrack(trackMsg.track) };
   }
+  if (event === "trackForwarding") {
+    const fwd = msg;
+    return { ...fwd, audioTrack: mapTrack(fwd.audioTrack), videoTrack: mapTrack(fwd.videoTrack) };
+  }
+  if (event === "vadNotification") {
+    const vad = msg;
+    return { ...vad, status: vadStatusMap[vad.status] };
+  }
   return msg;
 };
 var isExpectedEvent = (event) => expectedEventsList.includes(event);
@@ -5982,6 +6006,13 @@ var FishjamWSNotifier = class extends import_events.EventEmitter {
     this.client.onmessage = (message) => this.dispatchNotification(message);
     this.client.onopen = () => this.setupConnection(config.managementToken);
   }
+  /**
+   * Close the underlying WebSocket and stop emitting notifications.
+   */
+  disconnect() {
+    this.removeAllListeners();
+    this.client.close();
+  }
   dispatchNotification(message) {
     try {
       const decodedMessage = ServerMessage.decode(new Uint8Array(message.data));
@@ -6195,7 +6226,7 @@ var mapException = (error, entity) => {
 // package.json
 var package_default = {
   name: "@fishjam-cloud/js-server-sdk",
-  version: "0.28.1",
+  version: "0.29.0-rc.2",
   description: "Fishjam server SDK for JavaScript",
   homepage: "https://github.com/fishjam-cloud/js-server-sdk",
   author: "Fishjam Team",
@@ -6284,7 +6315,8 @@ var package_default = {
     "*.{js,ts,tsx,mjs,cjs}": [
       "eslint --fix --config eslint.config.mjs"
     ]
-  }
+  },
+  stableVersion: "0.28.1"
 };
 
 // src/client.ts

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import {
   package_default
-} from "./chunk-GTNIELH6.mjs";
+} from "./chunk-ZKMES6M4.mjs";
 
 // ../fishjam-openapi/dist/index.js
 import globalAxios2 from "axios";
@@ -1990,6 +1990,13 @@ function serverMessage_EventTypeToJSON(object) {
       return "UNRECOGNIZED";
   }
 }
+var ServerMessage_VadNotification_Status = /* @__PURE__ */ ((ServerMessage_VadNotification_Status2) => {
+  ServerMessage_VadNotification_Status2[ServerMessage_VadNotification_Status2["STATUS_UNSPECIFIED"] = 0] = "STATUS_UNSPECIFIED";
+  ServerMessage_VadNotification_Status2[ServerMessage_VadNotification_Status2["STATUS_SILENCE"] = 1] = "STATUS_SILENCE";
+  ServerMessage_VadNotification_Status2[ServerMessage_VadNotification_Status2["STATUS_SPEECH"] = 2] = "STATUS_SPEECH";
+  ServerMessage_VadNotification_Status2[ServerMessage_VadNotification_Status2["UNRECOGNIZED"] = -1] = "UNRECOGNIZED";
+  return ServerMessage_VadNotification_Status2;
+})(ServerMessage_VadNotification_Status || {});
 function serverMessage_VadNotification_StatusFromJSON(object) {
   switch (object) {
     case 0:
@@ -5865,6 +5872,12 @@ var trackTypeMap = {
   [TrackType.TRACK_TYPE_AUDIO]: "audio",
   [TrackType.UNRECOGNIZED]: "unspecified"
 };
+var vadStatusMap = {
+  [ServerMessage_VadNotification_Status.STATUS_UNSPECIFIED]: "silence",
+  [ServerMessage_VadNotification_Status.STATUS_SILENCE]: "silence",
+  [ServerMessage_VadNotification_Status.STATUS_SPEECH]: "speech",
+  [ServerMessage_VadNotification_Status.UNRECOGNIZED]: "silence"
+};
 var expectedEventsList = [
   "roomCreated",
   "roomDeleted",
@@ -5882,6 +5895,9 @@ var expectedEventsList = [
   "trackAdded",
   "trackRemoved",
   "trackMetadataUpdated",
+  "trackForwarding",
+  "trackForwardingRemoved",
+  "vadNotification",
   "channelAdded",
   "channelRemoved"
 ];
@@ -5904,6 +5920,14 @@ var mapNotification = (event, msg) => {
     const trackMsg = msg;
     return { ...trackMsg, track: mapTrack(trackMsg.track) };
   }
+  if (event === "trackForwarding") {
+    const fwd = msg;
+    return { ...fwd, audioTrack: mapTrack(fwd.audioTrack), videoTrack: mapTrack(fwd.videoTrack) };
+  }
+  if (event === "vadNotification") {
+    const vad = msg;
+    return { ...vad, status: vadStatusMap[vad.status] };
+  }
   return msg;
 };
 var isExpectedEvent = (event) => expectedEventsList.includes(event);
@@ -5931,6 +5955,13 @@ var FishjamWSNotifier = class extends EventEmitter {
     this.client.onmessage = (message) => this.dispatchNotification(message);
     this.client.onopen = () => this.setupConnection(config.managementToken);
   }
+  /**
+   * Close the underlying WebSocket and stop emitting notifications.
+   */
+  disconnect() {
+    this.removeAllListeners();
+    this.client.close();
+  }
   dispatchNotification(message) {
     try {
       const decodedMessage = ServerMessage.decode(new Uint8Array(message.data));

package/dist/integrations/gemini.d.mts

@@ -6,10 +6,37 @@ import { GoogleGenAIOptions, GoogleGenAI } from '@google/genai';
  * This module is a separate entry point (`@fishjam-cloud/js-server-sdk/gemini`),
  * so `@google/genai` is only loaded when the consumer imports this module.
  *
+ * Does not verify the API key against Google — use {@link createClientAndValidate}
+ * or call {@link checkCredentials} afterwards for that.
+ *
  * @param options Configuration for the GoogleGenAI client.
  * @returns A GoogleGenAI instance.
  */
 declare const createClient: (options: GoogleGenAIOptions) => GoogleGenAI;
+/**
+ * Verifies the API key by making a single lightweight authenticated call
+ * (`models.list`). Resolves on success; throws if the call fails — either
+ * because the key was rejected or because the request itself failed (e.g.
+ * network/connectivity). The original error is preserved as `cause`.
+ *
+ * Note: this catches the common cases (invalid / unauthorized / wrong-project /
+ * region-blocked keys). It does not guarantee the key can use a specific Live
+ * native-audio model — such model-specific rejections still surface only via the
+ * `live.connect` session callbacks (`onerror`/`onclose`).
+ *
+ * @param client A GoogleGenAI instance, e.g. from {@link createClient}.
+ */
+declare const checkCredentials: (client: GoogleGenAI) => Promise<void>;
+/**
+ * Creates a GoogleGenAI client and verifies the API key before returning it,
+ * so misconfiguration fails fast.
+ *
+ * Throws if the key is rejected (see {@link checkCredentials}).
+ *
+ * @param options Configuration for the GoogleGenAI client.
+ * @returns A validated GoogleGenAI instance.
+ */
+declare const createClientAndValidate: (options: GoogleGenAIOptions) => Promise<GoogleGenAI>;
 /**
  * Predefined audio settings for the agent's output track,
  * configured for Gemini's 24kHz audio output.
@@ -32,4 +59,4 @@ declare const geminiInputAudioSettings: {
  */
 declare const inputMimeType: "audio/pcm;rate=16000";
 
-export { createClient, geminiInputAudioSettings, geminiOutputAudioSettings, inputMimeType };
+export { checkCredentials, createClient, createClientAndValidate, geminiInputAudioSettings, geminiOutputAudioSettings, inputMimeType };

package/dist/integrations/gemini.d.ts

@@ -6,10 +6,37 @@ import { GoogleGenAIOptions, GoogleGenAI } from '@google/genai';
  * This module is a separate entry point (`@fishjam-cloud/js-server-sdk/gemini`),
  * so `@google/genai` is only loaded when the consumer imports this module.
  *
+ * Does not verify the API key against Google — use {@link createClientAndValidate}
+ * or call {@link checkCredentials} afterwards for that.
+ *
  * @param options Configuration for the GoogleGenAI client.
  * @returns A GoogleGenAI instance.
  */
 declare const createClient: (options: GoogleGenAIOptions) => GoogleGenAI;
+/**
+ * Verifies the API key by making a single lightweight authenticated call
+ * (`models.list`). Resolves on success; throws if the call fails — either
+ * because the key was rejected or because the request itself failed (e.g.
+ * network/connectivity). The original error is preserved as `cause`.
+ *
+ * Note: this catches the common cases (invalid / unauthorized / wrong-project /
+ * region-blocked keys). It does not guarantee the key can use a specific Live
+ * native-audio model — such model-specific rejections still surface only via the
+ * `live.connect` session callbacks (`onerror`/`onclose`).
+ *
+ * @param client A GoogleGenAI instance, e.g. from {@link createClient}.
+ */
+declare const checkCredentials: (client: GoogleGenAI) => Promise<void>;
+/**
+ * Creates a GoogleGenAI client and verifies the API key before returning it,
+ * so misconfiguration fails fast.
+ *
+ * Throws if the key is rejected (see {@link checkCredentials}).
+ *
+ * @param options Configuration for the GoogleGenAI client.
+ * @returns A validated GoogleGenAI instance.
+ */
+declare const createClientAndValidate: (options: GoogleGenAIOptions) => Promise<GoogleGenAI>;
 /**
  * Predefined audio settings for the agent's output track,
  * configured for Gemini's 24kHz audio output.
@@ -32,4 +59,4 @@ declare const geminiInputAudioSettings: {
  */
 declare const inputMimeType: "audio/pcm;rate=16000";
 
-export { createClient, geminiInputAudioSettings, geminiOutputAudioSettings, inputMimeType };
+export { checkCredentials, createClient, createClientAndValidate, geminiInputAudioSettings, geminiOutputAudioSettings, inputMimeType };

package/dist/integrations/gemini.js

@@ -20,7 +20,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/integrations/gemini.ts
 var gemini_exports = {};
 __export(gemini_exports, {
+  checkCredentials: () => checkCredentials,
   createClient: () => createClient,
+  createClientAndValidate: () => createClientAndValidate,
   geminiInputAudioSettings: () => geminiInputAudioSettings,
   geminiOutputAudioSettings: () => geminiOutputAudioSettings,
   inputMimeType: () => inputMimeType
@@ -31,7 +33,7 @@ var import_genai = require("@google/genai");
 // package.json
 var package_default = {
   name: "@fishjam-cloud/js-server-sdk",
-  version: "0.28.1",
+  version: "0.29.0-rc.2",
   description: "Fishjam server SDK for JavaScript",
   homepage: "https://github.com/fishjam-cloud/js-server-sdk",
   author: "Fishjam Team",
@@ -120,7 +122,8 @@ var package_default = {
     "*.{js,ts,tsx,mjs,cjs}": [
       "eslint --fix --config eslint.config.mjs"
     ]
-  }
+  },
+  stableVersion: "0.28.1"
 };
 
 // src/integrations/gemini.ts
@@ -139,6 +142,21 @@ var createClient = (options) => {
   };
   return new import_genai.GoogleGenAI(finalOptions);
 };
+var checkCredentials = async (client) => {
+  try {
+    await client.models.list();
+  } catch (error) {
+    throw new Error(
+      "Could not verify the Gemini API key. The key may be invalid/unauthorized (check the key and that the Gemini API is enabled for its project/region), or the request to Gemini failed (e.g. network connectivity). See the cause for details.",
+      { cause: error }
+    );
+  }
+};
+var createClientAndValidate = async (options) => {
+  const client = createClient(options);
+  await checkCredentials(client);
+  return client;
+};
 var geminiOutputAudioSettings = {
   encoding: "pcm16",
   channels: 1,
@@ -151,7 +169,9 @@ var geminiInputAudioSettings = {
 var inputMimeType = "audio/pcm;rate=16000";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  checkCredentials,
   createClient,
+  createClientAndValidate,
   geminiInputAudioSettings,
   geminiOutputAudioSettings,
   inputMimeType

package/dist/integrations/gemini.mjs

@@ -1,6 +1,6 @@
 import {
   package_default
-} from "../chunk-GTNIELH6.mjs";
+} from "../chunk-ZKMES6M4.mjs";
 
 // src/integrations/gemini.ts
 import { GoogleGenAI } from "@google/genai";
@@ -19,6 +19,21 @@ var createClient = (options) => {
   };
   return new GoogleGenAI(finalOptions);
 };
+var checkCredentials = async (client) => {
+  try {
+    await client.models.list();
+  } catch (error) {
+    throw new Error(
+      "Could not verify the Gemini API key. The key may be invalid/unauthorized (check the key and that the Gemini API is enabled for its project/region), or the request to Gemini failed (e.g. network connectivity). See the cause for details.",
+      { cause: error }
+    );
+  }
+};
+var createClientAndValidate = async (options) => {
+  const client = createClient(options);
+  await checkCredentials(client);
+  return client;
+};
 var geminiOutputAudioSettings = {
   encoding: "pcm16",
   channels: 1,
@@ -30,7 +45,9 @@ var geminiInputAudioSettings = {
 };
 var inputMimeType = "audio/pcm;rate=16000";
 export {
+  checkCredentials,
   createClient,
+  createClientAndValidate,
   geminiInputAudioSettings,
   geminiOutputAudioSettings,
   inputMimeType

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fishjam-cloud/js-server-sdk",
-  "version": "0.28.1",
+  "version": "0.29.0-rc.2",
   "description": "Fishjam server SDK for JavaScript",
   "homepage": "https://github.com/fishjam-cloud/js-server-sdk",
   "author": "Fishjam Team",
@@ -74,8 +74,8 @@
     }
   },
   "devDependencies": {
-    "@fishjam-cloud/fishjam-openapi": "0.28.1",
-    "@fishjam-cloud/fishjam-proto": "0.28.1",
+    "@fishjam-cloud/fishjam-openapi": "0.29.0-rc.2",
+    "@fishjam-cloud/fishjam-proto": "0.29.0-rc.2",
     "@openapitools/openapi-generator-cli": "^2.18.4",
     "@types/node": "^22.13.16",
     "@types/websocket": "^1.0.10",
@@ -89,5 +89,6 @@
     "*.{js,ts,tsx,mjs,cjs}": [
       "eslint --fix --config eslint.config.mjs"
     ]
-  }
+  },
+  "stableVersion": "0.28.1"
 }