kugelaudio 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to the KugelAudio JavaScript/TypeScript SDK will be document
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.3] - 2024-12-25
+
+### Fixed
+- Fixed WebSocket authentication: now correctly uses `master_key` query param when `isMasterKey: true` is set, instead of always using `api_key`
+- Added both `X-API-Key` header and `Authorization: Bearer` header for HTTP requests
+
 ## [0.1.0] - 2024-12-17
 
 ### Added

package/dist/index.d.mts

@@ -151,10 +151,12 @@ interface StreamCallbacks {
  * KugelAudio client options.
  */
 interface KugelAudioOptions {
-    /** Your KugelAudio API key */
+    /** Your KugelAudio API key or JWT token */
     apiKey: string;
     /** Whether apiKey is a master key (for internal/server-side use). Master keys bypass billing. */
     isMasterKey?: boolean;
+    /** Whether apiKey is a JWT token (for user authentication). Takes precedence over isMasterKey. */
+    isToken?: boolean;
     /** API base URL (default: https://api.kugelaudio.com) */
     apiUrl?: string;
     /** TTS server URL (default: https://eu.kugelaudio.com) */
@@ -277,6 +279,7 @@ declare class TTSResource {
 declare class KugelAudio {
     private _apiKey;
     private _isMasterKey;
+    private _isToken;
     private _apiUrl;
     private _ttsUrl;
     private _timeout;
@@ -291,6 +294,8 @@ declare class KugelAudio {
     get apiKey(): string;
     /** Check if using master key authentication */
     get isMasterKey(): boolean;
+    /** Check if using JWT token authentication */
+    get isToken(): boolean;
     /** Get TTS URL */
     get ttsUrl(): string;
     /**

package/dist/index.d.ts

@@ -151,10 +151,12 @@ interface StreamCallbacks {
  * KugelAudio client options.
  */
 interface KugelAudioOptions {
-    /** Your KugelAudio API key */
+    /** Your KugelAudio API key or JWT token */
     apiKey: string;
     /** Whether apiKey is a master key (for internal/server-side use). Master keys bypass billing. */
     isMasterKey?: boolean;
+    /** Whether apiKey is a JWT token (for user authentication). Takes precedence over isMasterKey. */
+    isToken?: boolean;
     /** API base URL (default: https://api.kugelaudio.com) */
     apiUrl?: string;
     /** TTS server URL (default: https://eu.kugelaudio.com) */
@@ -277,6 +279,7 @@ declare class TTSResource {
 declare class KugelAudio {
     private _apiKey;
     private _isMasterKey;
+    private _isToken;
     private _apiUrl;
     private _ttsUrl;
     private _timeout;
@@ -291,6 +294,8 @@ declare class KugelAudio {
     get apiKey(): string;
     /** Check if using master key authentication */
     get isMasterKey(): boolean;
+    /** Check if using JWT token authentication */
+    get isToken(): boolean;
     /** Get TTS URL */
     get ttsUrl(): string;
     /**

package/dist/index.js

@@ -253,7 +253,14 @@ var TTSResource = class {
    */
   buildWsUrl() {
     const wsUrl = this.client.ttsUrl.replace("https://", "wss://").replace("http://", "ws://");
-    const authParam = this.client.isMasterKey ? "master_key" : "api_key";
+    let authParam;
+    if (this.client.isToken) {
+      authParam = "token";
+    } else if (this.client.isMasterKey) {
+      authParam = "master_key";
+    } else {
+      authParam = "api_key";
+    }
     return `${wsUrl}/ws/tts?${authParam}=${this.client.apiKey}`;
   }
   /**
@@ -492,6 +499,7 @@ var KugelAudio = class {
     }
     this._apiKey = options.apiKey;
     this._isMasterKey = options.isMasterKey || false;
+    this._isToken = options.isToken || false;
     this._apiUrl = (options.apiUrl || DEFAULT_API_URL).replace(/\/$/, "");
     this._ttsUrl = (options.ttsUrl || this._apiUrl).replace(/\/$/, "");
     this._timeout = options.timeout || 6e4;
@@ -507,6 +515,10 @@ var KugelAudio = class {
   get isMasterKey() {
     return this._isMasterKey;
   }
+  /** Check if using JWT token authentication */
+  get isToken() {
+    return this._isToken;
+  }
   /** Get TTS URL */
   get ttsUrl() {
     return this._ttsUrl;

package/dist/index.mjs

@@ -217,7 +217,14 @@ var TTSResource = class {
    */
   buildWsUrl() {
     const wsUrl = this.client.ttsUrl.replace("https://", "wss://").replace("http://", "ws://");
-    const authParam = this.client.isMasterKey ? "master_key" : "api_key";
+    let authParam;
+    if (this.client.isToken) {
+      authParam = "token";
+    } else if (this.client.isMasterKey) {
+      authParam = "master_key";
+    } else {
+      authParam = "api_key";
+    }
     return `${wsUrl}/ws/tts?${authParam}=${this.client.apiKey}`;
   }
   /**
@@ -456,6 +463,7 @@ var KugelAudio = class {
     }
     this._apiKey = options.apiKey;
     this._isMasterKey = options.isMasterKey || false;
+    this._isToken = options.isToken || false;
     this._apiUrl = (options.apiUrl || DEFAULT_API_URL).replace(/\/$/, "");
     this._ttsUrl = (options.ttsUrl || this._apiUrl).replace(/\/$/, "");
     this._timeout = options.timeout || 6e4;
@@ -471,6 +479,10 @@ var KugelAudio = class {
   get isMasterKey() {
     return this._isMasterKey;
   }
+  /** Check if using JWT token authentication */
+  get isToken() {
+    return this._isToken;
+  }
   /** Get TTS URL */
   get ttsUrl() {
     return this._ttsUrl;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kugelaudio",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Official JavaScript/TypeScript SDK for KugelAudio TTS API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/client.ts

@@ -165,8 +165,15 @@ class TTSResource {
     const wsUrl = this.client.ttsUrl
       .replace('https://', 'wss://')
       .replace('http://', 'ws://');
-    // Use master_key param for master keys (bypasses billing), api_key for regular keys
-    const authParam = this.client.isMasterKey ? 'master_key' : 'api_key';
+    // Use token param for JWT tokens, master_key for master keys (bypasses billing), api_key for regular keys
+    let authParam: string;
+    if (this.client.isToken) {
+      authParam = 'token';
+    } else if (this.client.isMasterKey) {
+      authParam = 'master_key';
+    } else {
+      authParam = 'api_key';
+    }
     return `${wsUrl}/ws/tts?${authParam}=${this.client.apiKey}`;
   }
 
@@ -481,6 +488,7 @@ class TTSResource {
 export class KugelAudio {
   private _apiKey: string;
   private _isMasterKey: boolean;
+  private _isToken: boolean;
   private _apiUrl: string;
   private _ttsUrl: string;
   private _timeout: number;
@@ -499,6 +507,7 @@ export class KugelAudio {
 
     this._apiKey = options.apiKey;
     this._isMasterKey = options.isMasterKey || false;
+    this._isToken = options.isToken || false;
     this._apiUrl = (options.apiUrl || DEFAULT_API_URL).replace(/\/$/, '');
     // If ttsUrl not specified, use apiUrl (backend proxies to TTS server)
     this._ttsUrl = (options.ttsUrl || this._apiUrl).replace(/\/$/, '');
@@ -519,6 +528,11 @@ export class KugelAudio {
     return this._isMasterKey;
   }
 
+  /** Check if using JWT token authentication */
+  get isToken(): boolean {
+    return this._isToken;
+  }
+
   /** Get TTS URL */
   get ttsUrl(): string {
     return this._ttsUrl;

package/src/types.ts

@@ -163,10 +163,12 @@ export interface StreamCallbacks {
  * KugelAudio client options.
  */
 export interface KugelAudioOptions {
-  /** Your KugelAudio API key */
+  /** Your KugelAudio API key or JWT token */
   apiKey: string;
   /** Whether apiKey is a master key (for internal/server-side use). Master keys bypass billing. */
   isMasterKey?: boolean;
+  /** Whether apiKey is a JWT token (for user authentication). Takes precedence over isMasterKey. */
+  isToken?: boolean;
   /** API base URL (default: https://api.kugelaudio.com) */
   apiUrl?: string;
   /** TTS server URL (default: https://eu.kugelaudio.com) */