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

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.29.0-rc.1",
+  version: "0.29.0",
   description: "Fishjam server SDK for JavaScript",
   homepage: "https://github.com/fishjam-cloud/js-server-sdk",
   author: "Fishjam Team",
@@ -93,9 +95,11 @@ var package_default = {
     outDir: "dist"
   },
   dependencies: {
-    axios: "^1.7.9",
     uuid: "^11.1.0"
   },
+  engines: {
+    node: ">=18"
+  },
   peerDependencies: {
     "@google/genai": "^1.0.0"
   },
@@ -120,8 +124,7 @@ var package_default = {
     "*.{js,ts,tsx,mjs,cjs}": [
       "eslint --fix --config eslint.config.mjs"
     ]
-  },
-  stableVersion: "0.28.1"
+  }
 };
 
 // src/integrations/gemini.ts
@@ -140,6 +143,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,
@@ -152,7 +170,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-VLMRJKOY.mjs";
+} from "../chunk-3EYSX4WM.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.29.0-rc.1",
+  "version": "0.29.0",
   "description": "Fishjam server SDK for JavaScript",
   "homepage": "https://github.com/fishjam-cloud/js-server-sdk",
   "author": "Fishjam Team",
@@ -62,9 +62,11 @@
     "outDir": "dist"
   },
   "dependencies": {
-    "axios": "^1.7.9",
     "uuid": "^11.1.0"
   },
+  "engines": {
+    "node": ">=18"
+  },
   "peerDependencies": {
     "@google/genai": "^1.0.0"
   },
@@ -74,8 +76,8 @@
     }
   },
   "devDependencies": {
-    "@fishjam-cloud/fishjam-openapi": "0.29.0-rc.1",
-    "@fishjam-cloud/fishjam-proto": "0.29.0-rc.1",
+    "@fishjam-cloud/fishjam-openapi": "0.29.0",
+    "@fishjam-cloud/fishjam-proto": "0.29.0",
     "@openapitools/openapi-generator-cli": "^2.18.4",
     "@types/node": "^22.13.16",
     "@types/websocket": "^1.0.10",
@@ -89,6 +91,5 @@
     "*.{js,ts,tsx,mjs,cjs}": [
       "eslint --fix --config eslint.config.mjs"
     ]
-  },
-  "stableVersion": "0.28.1"
+  }
 }