kugelaudio 0.1.11 → 0.1.13

package/dist/index.js

@@ -135,8 +135,35 @@ function createWavBlob(audio, sampleRate) {
   return new Blob([wavBuffer], { type: "audio/wav" });
 }
 
+// src/websocket.ts
+var _cachedWs = null;
+function getWebSocket() {
+  if (_cachedWs) return _cachedWs;
+  if (typeof globalThis !== "undefined" && typeof globalThis.WebSocket !== "undefined") {
+    _cachedWs = globalThis.WebSocket;
+    return _cachedWs;
+  }
+  try {
+    const _require = typeof require !== "undefined" ? require : Function('return typeof require !== "undefined" ? require : undefined')();
+    if (_require) {
+      const ws = _require("ws");
+      _cachedWs = ws.default || ws;
+      return _cachedWs;
+    }
+  } catch {
+  }
+  throw new Error(
+    'WebSocket not available. In Node.js, install the "ws" package: npm install ws'
+  );
+}
+
 // src/client.ts
 var DEFAULT_API_URL = "https://api.kugelaudio.com";
+function createWs(url) {
+  const WS = getWebSocket();
+  return new WS(url);
+}
+var WS_OPEN = 1;
 var ModelsResource = class {
   constructor(client) {
     this.client = client;
@@ -212,6 +239,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 +269,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 === WS_OPEN;
   }
   /**
    * Generate audio from text with streaming via WebSocket.
@@ -299,7 +327,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 === WS_OPEN) {
       return this.wsConnection;
     }
     if (this.wsConnection) {
@@ -310,7 +338,7 @@ var TTSResource = class {
       this.wsConnection = null;
     }
     return new Promise((resolve, reject) => {
-      const ws = new WebSocket(url);
+      const ws = createWs(url);
       ws.onopen = () => {
         this.wsConnection = ws;
         this.wsUrl = url;
@@ -328,7 +356,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 +460,7 @@ var TTSResource = class {
   streamWithoutPooling(options, callbacks) {
     return new Promise((resolve, reject) => {
       const url = this.buildWsUrl();
-      const ws = new WebSocket(url);
+      const ws = createWs(url);
       ws.onopen = () => {
         callbacks.onOpen?.();
         ws.send(JSON.stringify({
@@ -447,7 +476,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 +623,13 @@ var MultiContextSession = class {
       authParam = "api_key";
     }
     const url = `${wsUrl}/ws/tts/multi?${authParam}=${this.client.apiKey}`;
-    this.ws = new WebSocket(url);
+    this.ws = createWs(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 +693,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 !== WS_OPEN) {
       throw new KugelAudioError("WebSocket not connected");
     }
     const msg = {
@@ -693,7 +724,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 !== WS_OPEN) {
       throw new KugelAudioError("WebSocket not connected");
     }
     if (!this.contexts.has(contextId) && !this.isStarted) {
@@ -709,7 +740,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 !== WS_OPEN) return;
     this.ws.send(JSON.stringify({
       flush: true,
       context_id: contextId
@@ -719,7 +750,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 !== WS_OPEN) return;
     this.ws.send(JSON.stringify({
       close_context: true,
       context_id: contextId
@@ -729,7 +760,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 !== WS_OPEN) return;
     this.ws.send(JSON.stringify({
       text: "",
       context_id: contextId
@@ -739,7 +770,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 === WS_OPEN) {
       this.ws.send(JSON.stringify({ close_socket: true }));
       this.ws.close();
     }
@@ -757,7 +788,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 === WS_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,35 @@ function createWavBlob(audio, sampleRate) {
   return new Blob([wavBuffer], { type: "audio/wav" });
 }
 
+// src/websocket.ts
+var _cachedWs = null;
+function getWebSocket() {
+  if (_cachedWs) return _cachedWs;
+  if (typeof globalThis !== "undefined" && typeof globalThis.WebSocket !== "undefined") {
+    _cachedWs = globalThis.WebSocket;
+    return _cachedWs;
+  }
+  try {
+    const _require = typeof __require !== "undefined" ? __require : Function('return typeof require !== "undefined" ? require : undefined')();
+    if (_require) {
+      const ws = _require("ws");
+      _cachedWs = ws.default || ws;
+      return _cachedWs;
+    }
+  } catch {
+  }
+  throw new Error(
+    'WebSocket not available. In Node.js, install the "ws" package: npm install ws'
+  );
+}
+
 // src/client.ts
 var DEFAULT_API_URL = "https://api.kugelaudio.com";
+function createWs(url) {
+  const WS = getWebSocket();
+  return new WS(url);
+}
+var WS_OPEN = 1;
 var ModelsResource = class {
   constructor(client) {
     this.client = client;
@@ -176,6 +210,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 +240,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 === WS_OPEN;
   }
   /**
    * Generate audio from text with streaming via WebSocket.
@@ -263,7 +298,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 === WS_OPEN) {
       return this.wsConnection;
     }
     if (this.wsConnection) {
@@ -274,7 +309,7 @@ var TTSResource = class {
       this.wsConnection = null;
     }
     return new Promise((resolve, reject) => {
-      const ws = new WebSocket(url);
+      const ws = createWs(url);
       ws.onopen = () => {
         this.wsConnection = ws;
         this.wsUrl = url;
@@ -292,7 +327,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 +431,7 @@ var TTSResource = class {
   streamWithoutPooling(options, callbacks) {
     return new Promise((resolve, reject) => {
       const url = this.buildWsUrl();
-      const ws = new WebSocket(url);
+      const ws = createWs(url);
       ws.onopen = () => {
         callbacks.onOpen?.();
         ws.send(JSON.stringify({
@@ -411,7 +447,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 +594,13 @@ var MultiContextSession = class {
       authParam = "api_key";
     }
     const url = `${wsUrl}/ws/tts/multi?${authParam}=${this.client.apiKey}`;
-    this.ws = new WebSocket(url);
+    this.ws = createWs(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 +664,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 !== WS_OPEN) {
       throw new KugelAudioError("WebSocket not connected");
     }
     const msg = {
@@ -657,7 +695,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 !== WS_OPEN) {
       throw new KugelAudioError("WebSocket not connected");
     }
     if (!this.contexts.has(contextId) && !this.isStarted) {
@@ -673,7 +711,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 !== WS_OPEN) return;
     this.ws.send(JSON.stringify({
       flush: true,
       context_id: contextId
@@ -683,7 +721,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 !== WS_OPEN) return;
     this.ws.send(JSON.stringify({
       close_context: true,
       context_id: contextId
@@ -693,7 +731,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 !== WS_OPEN) return;
     this.ws.send(JSON.stringify({
       text: "",
       context_id: contextId
@@ -703,7 +741,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 === WS_OPEN) {
       this.ws.send(JSON.stringify({ close_socket: true }));
       this.ws.close();
     }
@@ -721,7 +759,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 === WS_OPEN;
   }
 };
 var KugelAudio = class _KugelAudio {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kugelaudio",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "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,23 @@ import type {
     Voice
 } from './types';
 import { base64ToArrayBuffer } from './utils';
+import { getWebSocket } from './websocket';
 
 const DEFAULT_API_URL = 'https://api.kugelaudio.com';
 
+/**
+ * Create a new WebSocket instance.
+ * Lazily resolves the constructor to avoid top-level side-effects
+ * that break server-side bundlers (Turbopack/Webpack).
+ */
+function createWs(url: string): WebSocket {
+  const WS = getWebSocket();
+  return new WS(url);
+}
+
+/** WebSocket OPEN readyState constant. */
+const WS_OPEN = 1;
+
 /**
  * Models resource for listing TTS models.
  */
@@ -111,6 +125,7 @@ class VoicesResource {
  * TTS resource for text-to-speech generation.
  */
 class TTSResource {
+  // Using any for WebSocket to support both browser WebSocket and ws package
   private wsConnection: WebSocket | null = null;
   private wsUrl: string | null = null;
   private pendingRequests: Map<number, {
@@ -147,7 +162,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 === WS_OPEN;
   }
 
   /**
@@ -221,7 +236,7 @@ class TTSResource {
     if (
       this.wsConnection &&
       this.wsUrl === url &&
-      this.wsConnection.readyState === WebSocket.OPEN
+      this.wsConnection.readyState === WS_OPEN
     ) {
       return this.wsConnection;
     }
@@ -238,7 +253,7 @@ class TTSResource {
 
     // Create new connection
     return new Promise((resolve, reject) => {
-      const ws = new WebSocket(url);
+      const ws = createWs(url);
 
       ws.onopen = () => {
         this.wsConnection = ws;
@@ -257,9 +272,15 @@ class TTSResource {
    * Setup message handler for pooled connection.
    */
   private setupMessageHandler(ws: WebSocket): void {
-    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);
 
         // Get the current pending request (we process one at a time)
         const [requestId, pending] = [...this.pendingRequests.entries()][0] || [];
@@ -389,7 +410,7 @@ class TTSResource {
   ): Promise<void> {
     return new Promise((resolve, reject) => {
       const url = this.buildWsUrl();
-      const ws = new WebSocket(url);
+      const ws = createWs(url);
 
       ws.onopen = () => {
         callbacks.onOpen?.();
@@ -406,9 +427,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);
@@ -580,15 +607,21 @@ class MultiContextSession {
     }
 
     const url = `${wsUrl}/ws/tts/multi?${authParam}=${this.client.apiKey}`;
-    this.ws = new WebSocket(url);
+    this.ws = createWs(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 +702,7 @@ class MultiContextSession {
       voiceSettings?: import('./types').ContextVoiceSettings;
     }
   ): void {
-    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+    if (!this.ws || this.ws.readyState !== WS_OPEN) {
       throw new KugelAudioError('WebSocket not connected');
     }
 
@@ -708,7 +741,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 !== WS_OPEN) {
       throw new KugelAudioError('WebSocket not connected');
     }
 
@@ -728,7 +761,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 !== WS_OPEN) return;
 
     this.ws.send(JSON.stringify({
       flush: true,
@@ -740,7 +773,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 !== WS_OPEN) return;
 
     this.ws.send(JSON.stringify({
       close_context: true,
@@ -752,7 +785,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 !== WS_OPEN) return;
 
     this.ws.send(JSON.stringify({
       text: '',
@@ -764,7 +797,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 === WS_OPEN) {
       this.ws.send(JSON.stringify({ close_socket: true }));
       this.ws.close();
     }
@@ -784,7 +817,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 === WS_OPEN;
   }
 }
 

package/src/websocket.ts

@@ -0,0 +1,44 @@
+/**
+ * WebSocket compatibility layer for browser and Node.js environments.
+ *
+ * IMPORTANT: WebSocket resolution is lazy to avoid top-level side-effects
+ * that break server-side bundlers (Turbopack / Webpack) when this module
+ * is imported in a Node.js (API route) context.
+ */
+
+let _cachedWs: typeof WebSocket | null = null;
+
+/**
+ * Get the WebSocket constructor for the current environment.
+ * Uses native WebSocket in browsers, ws package in Node.js.
+ * Result is cached after first call.
+ */
+export function getWebSocket(): typeof WebSocket {
+    if (_cachedWs) return _cachedWs;
+
+    // Browser environment
+    if (typeof globalThis !== 'undefined' && typeof (globalThis as any).WebSocket !== 'undefined') {
+        _cachedWs = (globalThis as any).WebSocket;
+        return _cachedWs!;
+    }
+
+    // Node.js environment - use ws package via dynamic require
+    try {
+        // Use Function constructor to hide require from static analysis by bundlers
+        // eslint-disable-next-line no-new-func
+        const _require = typeof require !== 'undefined'
+            ? require
+            : Function('return typeof require !== "undefined" ? require : undefined')();
+        if (_require) {
+            const ws = _require('ws');
+            _cachedWs = ws.default || ws;
+            return _cachedWs!;
+        }
+    } catch {
+        // Fall through to error
+    }
+
+    throw new Error(
+        'WebSocket not available. In Node.js, install the "ws" package: npm install ws'
+    );
+}