kugelaudio 0.1.11 → 0.1.12

package/dist/index.js

@@ -135,8 +135,26 @@ function createWavBlob(audio, sampleRate) {
   return new Blob([wavBuffer], { type: "audio/wav" });
 }
 
+// src/websocket.ts
+var isBrowser = typeof window !== "undefined" && typeof window.WebSocket !== "undefined";
+function getWebSocket() {
+  if (isBrowser) {
+    return window.WebSocket;
+  }
+  try {
+    const ws = require("ws");
+    return ws;
+  } catch {
+    throw new Error(
+      'WebSocket not available. In Node.js, install the "ws" package: npm install ws'
+    );
+  }
+}
+var WebSocketCompat = getWebSocket();
+
 // src/client.ts
 var DEFAULT_API_URL = "https://api.kugelaudio.com";
+var WebSocketImpl = getWebSocket();
 var ModelsResource = class {
   constructor(client) {
     this.client = client;
@@ -212,6 +230,7 @@ var VoicesResource = class {
 var TTSResource = class {
   constructor(client) {
     this.client = client;
+    // Using any for WebSocket to support both browser WebSocket and ws package
     this.wsConnection = null;
     this.wsUrl = null;
     this.pendingRequests = /* @__PURE__ */ new Map();
@@ -241,7 +260,7 @@ var TTSResource = class {
    * Check if WebSocket connection is established and open.
    */
   isConnected() {
-    return this.wsConnection !== null && this.wsConnection.readyState === WebSocket.OPEN;
+    return this.wsConnection !== null && this.wsConnection.readyState === WebSocketImpl.OPEN;
   }
   /**
    * Generate audio from text with streaming via WebSocket.
@@ -299,7 +318,7 @@ var TTSResource = class {
    */
   async getConnection() {
     const url = this.buildWsUrl();
-    if (this.wsConnection && this.wsUrl === url && this.wsConnection.readyState === WebSocket.OPEN) {
+    if (this.wsConnection && this.wsUrl === url && this.wsConnection.readyState === WebSocketImpl.OPEN) {
       return this.wsConnection;
     }
     if (this.wsConnection) {
@@ -310,7 +329,7 @@ var TTSResource = class {
       this.wsConnection = null;
     }
     return new Promise((resolve, reject) => {
-      const ws = new WebSocket(url);
+      const ws = new WebSocketImpl(url);
       ws.onopen = () => {
         this.wsConnection = ws;
         this.wsUrl = url;
@@ -328,7 +347,8 @@ var TTSResource = class {
   setupMessageHandler(ws) {
     ws.onmessage = (event) => {
       try {
-        const data = JSON.parse(event.data);
+        const messageData = typeof event.data === "string" ? event.data : event.data instanceof Buffer ? event.data.toString() : String(event.data);
+        const data = JSON.parse(messageData);
         const [requestId, pending] = [...this.pendingRequests.entries()][0] || [];
         if (!pending) return;
         if (data.error) {
@@ -431,7 +451,7 @@ var TTSResource = class {
   streamWithoutPooling(options, callbacks) {
     return new Promise((resolve, reject) => {
       const url = this.buildWsUrl();
-      const ws = new WebSocket(url);
+      const ws = new WebSocketImpl(url);
       ws.onopen = () => {
         callbacks.onOpen?.();
         ws.send(JSON.stringify({
@@ -447,7 +467,8 @@ var TTSResource = class {
       };
       ws.onmessage = (event) => {
         try {
-          const data = JSON.parse(event.data);
+          const messageData = typeof event.data === "string" ? event.data : event.data instanceof Buffer ? event.data.toString() : String(event.data);
+          const data = JSON.parse(messageData);
           if (data.error) {
             const error = this.parseError(data.error);
             callbacks.onError?.(error);
@@ -593,12 +614,13 @@ var MultiContextSession = class {
       authParam = "api_key";
     }
     const url = `${wsUrl}/ws/tts/multi?${authParam}=${this.client.apiKey}`;
-    this.ws = new WebSocket(url);
+    this.ws = new WebSocketImpl(url);
     this.ws.onopen = () => {
     };
     this.ws.onmessage = (event) => {
       try {
-        const data = JSON.parse(event.data);
+        const messageData = typeof event.data === "string" ? event.data : event.data instanceof Buffer ? event.data.toString() : String(event.data);
+        const data = JSON.parse(messageData);
         if (data.error) {
           this.callbacks.onError?.(
             new KugelAudioError(data.error),
@@ -662,7 +684,7 @@ var MultiContextSession = class {
    * Create a new context with optional voice settings.
    */
   createContext(contextId, options) {
-    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) {
       throw new KugelAudioError("WebSocket not connected");
     }
     const msg = {
@@ -693,7 +715,7 @@ var MultiContextSession = class {
    * Send text to a specific context.
    */
   send(contextId, text, flush = false) {
-    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) {
       throw new KugelAudioError("WebSocket not connected");
     }
     if (!this.contexts.has(contextId) && !this.isStarted) {
@@ -709,7 +731,7 @@ var MultiContextSession = class {
    * Flush a context's buffer.
    */
   flush(contextId) {
-    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;
+    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) return;
     this.ws.send(JSON.stringify({
       flush: true,
       context_id: contextId
@@ -719,7 +741,7 @@ var MultiContextSession = class {
    * Close a specific context.
    */
   closeContext(contextId) {
-    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;
+    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) return;
     this.ws.send(JSON.stringify({
       close_context: true,
       context_id: contextId
@@ -729,7 +751,7 @@ var MultiContextSession = class {
    * Send keep-alive to reset a context's inactivity timeout.
    */
   keepAlive(contextId) {
-    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;
+    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) return;
     this.ws.send(JSON.stringify({
       text: "",
       context_id: contextId
@@ -739,7 +761,7 @@ var MultiContextSession = class {
    * Close the session and all contexts.
    */
   close() {
-    if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+    if (this.ws && this.ws.readyState === WebSocketImpl.OPEN) {
       this.ws.send(JSON.stringify({ close_socket: true }));
       this.ws.close();
     }
@@ -757,7 +779,7 @@ var MultiContextSession = class {
    * Check if connected.
    */
   get isConnected() {
-    return this.ws !== null && this.ws.readyState === WebSocket.OPEN;
+    return this.ws !== null && this.ws.readyState === WebSocketImpl.OPEN;
   }
 };
 var KugelAudio = class _KugelAudio {

package/dist/index.mjs

@@ -1,3 +1,10 @@
+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');
+});
+
 // src/errors.ts
 var KugelAudioError = class _KugelAudioError extends Error {
   constructor(message, statusCode) {
@@ -99,8 +106,26 @@ function createWavBlob(audio, sampleRate) {
   return new Blob([wavBuffer], { type: "audio/wav" });
 }
 
+// src/websocket.ts
+var isBrowser = typeof window !== "undefined" && typeof window.WebSocket !== "undefined";
+function getWebSocket() {
+  if (isBrowser) {
+    return window.WebSocket;
+  }
+  try {
+    const ws = __require("ws");
+    return ws;
+  } catch {
+    throw new Error(
+      'WebSocket not available. In Node.js, install the "ws" package: npm install ws'
+    );
+  }
+}
+var WebSocketCompat = getWebSocket();
+
 // src/client.ts
 var DEFAULT_API_URL = "https://api.kugelaudio.com";
+var WebSocketImpl = getWebSocket();
 var ModelsResource = class {
   constructor(client) {
     this.client = client;
@@ -176,6 +201,7 @@ var VoicesResource = class {
 var TTSResource = class {
   constructor(client) {
     this.client = client;
+    // Using any for WebSocket to support both browser WebSocket and ws package
     this.wsConnection = null;
     this.wsUrl = null;
     this.pendingRequests = /* @__PURE__ */ new Map();
@@ -205,7 +231,7 @@ var TTSResource = class {
    * Check if WebSocket connection is established and open.
    */
   isConnected() {
-    return this.wsConnection !== null && this.wsConnection.readyState === WebSocket.OPEN;
+    return this.wsConnection !== null && this.wsConnection.readyState === WebSocketImpl.OPEN;
   }
   /**
    * Generate audio from text with streaming via WebSocket.
@@ -263,7 +289,7 @@ var TTSResource = class {
    */
   async getConnection() {
     const url = this.buildWsUrl();
-    if (this.wsConnection && this.wsUrl === url && this.wsConnection.readyState === WebSocket.OPEN) {
+    if (this.wsConnection && this.wsUrl === url && this.wsConnection.readyState === WebSocketImpl.OPEN) {
       return this.wsConnection;
     }
     if (this.wsConnection) {
@@ -274,7 +300,7 @@ var TTSResource = class {
       this.wsConnection = null;
     }
     return new Promise((resolve, reject) => {
-      const ws = new WebSocket(url);
+      const ws = new WebSocketImpl(url);
       ws.onopen = () => {
         this.wsConnection = ws;
         this.wsUrl = url;
@@ -292,7 +318,8 @@ var TTSResource = class {
   setupMessageHandler(ws) {
     ws.onmessage = (event) => {
       try {
-        const data = JSON.parse(event.data);
+        const messageData = typeof event.data === "string" ? event.data : event.data instanceof Buffer ? event.data.toString() : String(event.data);
+        const data = JSON.parse(messageData);
         const [requestId, pending] = [...this.pendingRequests.entries()][0] || [];
         if (!pending) return;
         if (data.error) {
@@ -395,7 +422,7 @@ var TTSResource = class {
   streamWithoutPooling(options, callbacks) {
     return new Promise((resolve, reject) => {
       const url = this.buildWsUrl();
-      const ws = new WebSocket(url);
+      const ws = new WebSocketImpl(url);
       ws.onopen = () => {
         callbacks.onOpen?.();
         ws.send(JSON.stringify({
@@ -411,7 +438,8 @@ var TTSResource = class {
       };
       ws.onmessage = (event) => {
         try {
-          const data = JSON.parse(event.data);
+          const messageData = typeof event.data === "string" ? event.data : event.data instanceof Buffer ? event.data.toString() : String(event.data);
+          const data = JSON.parse(messageData);
           if (data.error) {
             const error = this.parseError(data.error);
             callbacks.onError?.(error);
@@ -557,12 +585,13 @@ var MultiContextSession = class {
       authParam = "api_key";
     }
     const url = `${wsUrl}/ws/tts/multi?${authParam}=${this.client.apiKey}`;
-    this.ws = new WebSocket(url);
+    this.ws = new WebSocketImpl(url);
     this.ws.onopen = () => {
     };
     this.ws.onmessage = (event) => {
       try {
-        const data = JSON.parse(event.data);
+        const messageData = typeof event.data === "string" ? event.data : event.data instanceof Buffer ? event.data.toString() : String(event.data);
+        const data = JSON.parse(messageData);
         if (data.error) {
           this.callbacks.onError?.(
             new KugelAudioError(data.error),
@@ -626,7 +655,7 @@ var MultiContextSession = class {
    * Create a new context with optional voice settings.
    */
   createContext(contextId, options) {
-    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) {
       throw new KugelAudioError("WebSocket not connected");
     }
     const msg = {
@@ -657,7 +686,7 @@ var MultiContextSession = class {
    * Send text to a specific context.
    */
   send(contextId, text, flush = false) {
-    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) {
       throw new KugelAudioError("WebSocket not connected");
     }
     if (!this.contexts.has(contextId) && !this.isStarted) {
@@ -673,7 +702,7 @@ var MultiContextSession = class {
    * Flush a context's buffer.
    */
   flush(contextId) {
-    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;
+    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) return;
     this.ws.send(JSON.stringify({
       flush: true,
       context_id: contextId
@@ -683,7 +712,7 @@ var MultiContextSession = class {
    * Close a specific context.
    */
   closeContext(contextId) {
-    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;
+    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) return;
     this.ws.send(JSON.stringify({
       close_context: true,
       context_id: contextId
@@ -693,7 +722,7 @@ var MultiContextSession = class {
    * Send keep-alive to reset a context's inactivity timeout.
    */
   keepAlive(contextId) {
-    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;
+    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) return;
     this.ws.send(JSON.stringify({
       text: "",
       context_id: contextId
@@ -703,7 +732,7 @@ var MultiContextSession = class {
    * Close the session and all contexts.
    */
   close() {
-    if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+    if (this.ws && this.ws.readyState === WebSocketImpl.OPEN) {
       this.ws.send(JSON.stringify({ close_socket: true }));
       this.ws.close();
     }
@@ -721,7 +750,7 @@ var MultiContextSession = class {
    * Check if connected.
    */
   get isConnected() {
-    return this.ws !== null && this.ws.readyState === WebSocket.OPEN;
+    return this.ws !== null && this.ws.readyState === WebSocketImpl.OPEN;
   }
 };
 var KugelAudio = class _KugelAudio {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kugelaudio",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "Official JavaScript/TypeScript SDK for KugelAudio TTS API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -52,5 +52,9 @@
   },
   "engines": {
     "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "tsx": "^4.21.0",
+    "ws": "^8.18.0"
   }
 }

package/src/client.ts

@@ -19,9 +19,13 @@ import type {
     Voice
 } from './types';
 import { base64ToArrayBuffer } from './utils';
+import { getWebSocket } from './websocket';
 
 const DEFAULT_API_URL = 'https://api.kugelaudio.com';
 
+// Get WebSocket constructor for current environment
+const WebSocketImpl = getWebSocket();
+
 /**
  * Models resource for listing TTS models.
  */
@@ -111,7 +115,8 @@ class VoicesResource {
  * TTS resource for text-to-speech generation.
  */
 class TTSResource {
-  private wsConnection: WebSocket | null = null;
+  // Using any for WebSocket to support both browser WebSocket and ws package
+  private wsConnection: InstanceType<typeof WebSocketImpl> | null = null;
   private wsUrl: string | null = null;
   private pendingRequests: Map<number, {
     callbacks: StreamCallbacks;
@@ -147,7 +152,7 @@ class TTSResource {
    * Check if WebSocket connection is established and open.
    */
   isConnected(): boolean {
-    return this.wsConnection !== null && this.wsConnection.readyState === WebSocket.OPEN;
+    return this.wsConnection !== null && this.wsConnection.readyState === WebSocketImpl.OPEN;
   }
 
   /**
@@ -214,14 +219,14 @@ class TTSResource {
    * Get or create a WebSocket connection for connection pooling.
    * This avoids the ~220ms connect overhead on each request.
    */
-  private async getConnection(): Promise<WebSocket> {
+  private async getConnection(): Promise<InstanceType<typeof WebSocketImpl>> {
     const url = this.buildWsUrl();
 
     // Return existing connection if valid
     if (
       this.wsConnection &&
       this.wsUrl === url &&
-      this.wsConnection.readyState === WebSocket.OPEN
+      this.wsConnection.readyState === WebSocketImpl.OPEN
     ) {
       return this.wsConnection;
     }
@@ -238,7 +243,7 @@ class TTSResource {
 
     // Create new connection
     return new Promise((resolve, reject) => {
-      const ws = new WebSocket(url);
+      const ws = new WebSocketImpl(url);
 
       ws.onopen = () => {
         this.wsConnection = ws;
@@ -256,10 +261,16 @@ class TTSResource {
   /**
    * Setup message handler for pooled connection.
    */
-  private setupMessageHandler(ws: WebSocket): void {
-    ws.onmessage = (event) => {
+  private setupMessageHandler(ws: InstanceType<typeof WebSocketImpl>): void {
+    ws.onmessage = (event: { data: unknown }) => {
       try {
-        const data = JSON.parse(event.data);
+        // Handle both browser (string) and Node.js (Buffer) message formats
+        const messageData = typeof event.data === 'string' 
+          ? event.data 
+          : event.data instanceof Buffer 
+            ? event.data.toString() 
+            : String(event.data);
+        const data = JSON.parse(messageData);
 
         // Get the current pending request (we process one at a time)
         const [requestId, pending] = [...this.pendingRequests.entries()][0] || [];
@@ -389,7 +400,7 @@ class TTSResource {
   ): Promise<void> {
     return new Promise((resolve, reject) => {
       const url = this.buildWsUrl();
-      const ws = new WebSocket(url);
+      const ws = new WebSocketImpl(url);
 
       ws.onopen = () => {
         callbacks.onOpen?.();
@@ -406,9 +417,15 @@ class TTSResource {
         }));
       };
 
-      ws.onmessage = (event) => {
+      ws.onmessage = (event: { data: unknown }) => {
         try {
-          const data = JSON.parse(event.data);
+          // Handle both browser (string) and Node.js (Buffer) message formats
+          const messageData = typeof event.data === 'string' 
+            ? event.data 
+            : event.data instanceof Buffer 
+              ? event.data.toString() 
+              : String(event.data);
+          const data = JSON.parse(messageData);
 
           if (data.error) {
             const error = this.parseError(data.error);
@@ -539,7 +556,7 @@ class TTSResource {
  * Multi-context WebSocket session for concurrent TTS streams.
  */
 class MultiContextSession {
-  private ws: WebSocket | null = null;
+  private ws: InstanceType<typeof WebSocketImpl> | null = null;
   private config: import('./types').MultiContextConfig;
   private callbacks: import('./types').MultiContextCallbacks = {};
   private contexts: Set<string> = new Set();
@@ -580,15 +597,21 @@ class MultiContextSession {
     }
 
     const url = `${wsUrl}/ws/tts/multi?${authParam}=${this.client.apiKey}`;
-    this.ws = new WebSocket(url);
+    this.ws = new WebSocketImpl(url);
 
     this.ws.onopen = () => {
       // Connection established, ready to create contexts
     };
 
-    this.ws.onmessage = (event) => {
+    this.ws.onmessage = (event: { data: unknown }) => {
       try {
-        const data = JSON.parse(event.data);
+        // Handle both browser (string) and Node.js (Buffer) message formats
+        const messageData = typeof event.data === 'string' 
+          ? event.data 
+          : event.data instanceof Buffer 
+            ? event.data.toString() 
+            : String(event.data);
+        const data = JSON.parse(messageData);
 
         if (data.error) {
           this.callbacks.onError?.(
@@ -669,7 +692,7 @@ class MultiContextSession {
       voiceSettings?: import('./types').ContextVoiceSettings;
     }
   ): void {
-    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) {
       throw new KugelAudioError('WebSocket not connected');
     }
 
@@ -708,7 +731,7 @@ class MultiContextSession {
    * Send text to a specific context.
    */
   send(contextId: string, text: string, flush = false): void {
-    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) {
       throw new KugelAudioError('WebSocket not connected');
     }
 
@@ -728,7 +751,7 @@ class MultiContextSession {
    * Flush a context's buffer.
    */
   flush(contextId: string): void {
-    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;
+    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) return;
 
     this.ws.send(JSON.stringify({
       flush: true,
@@ -740,7 +763,7 @@ class MultiContextSession {
    * Close a specific context.
    */
   closeContext(contextId: string): void {
-    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;
+    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) return;
 
     this.ws.send(JSON.stringify({
       close_context: true,
@@ -752,7 +775,7 @@ class MultiContextSession {
    * Send keep-alive to reset a context's inactivity timeout.
    */
   keepAlive(contextId: string): void {
-    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;
+    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) return;
 
     this.ws.send(JSON.stringify({
       text: '',
@@ -764,7 +787,7 @@ class MultiContextSession {
    * Close the session and all contexts.
    */
   close(): void {
-    if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+    if (this.ws && this.ws.readyState === WebSocketImpl.OPEN) {
       this.ws.send(JSON.stringify({ close_socket: true }));
       this.ws.close();
     }
@@ -784,7 +807,7 @@ class MultiContextSession {
    * Check if connected.
    */
   get isConnected(): boolean {
-    return this.ws !== null && this.ws.readyState === WebSocket.OPEN;
+    return this.ws !== null && this.ws.readyState === WebSocketImpl.OPEN;
   }
 }
 

package/src/websocket.ts

@@ -0,0 +1,33 @@
+/**
+ * WebSocket compatibility layer for browser and Node.js environments.
+ */
+
+// Detect environment
+const isBrowser = typeof window !== 'undefined' && typeof window.WebSocket !== 'undefined';
+
+/**
+ * Get the WebSocket constructor for the current environment.
+ * Uses native WebSocket in browsers, ws package in Node.js.
+ */
+export function getWebSocket(): typeof WebSocket {
+    if (isBrowser) {
+        return window.WebSocket;
+    }
+    
+    // Node.js environment - use ws package
+    try {
+        // Dynamic require to avoid bundler issues
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const ws = require('ws');
+        return ws;
+    } catch {
+        throw new Error(
+            'WebSocket not available. In Node.js, install the "ws" package: npm install ws'
+        );
+    }
+}
+
+/**
+ * WebSocket constructor that works in both environments.
+ */
+export const WebSocketCompat = getWebSocket();