kugelaudio 0.1.12 → 0.1.14

package/dist/index.js

@@ -136,25 +136,34 @@ function createWavBlob(audio, sampleRate) {
 }
 
 // src/websocket.ts
-var isBrowser = typeof window !== "undefined" && typeof window.WebSocket !== "undefined";
+var _cachedWs = null;
 function getWebSocket() {
-  if (isBrowser) {
-    return window.WebSocket;
+  if (_cachedWs) return _cachedWs;
+  if (typeof globalThis !== "undefined" && typeof globalThis.WebSocket !== "undefined") {
+    _cachedWs = globalThis.WebSocket;
+    return _cachedWs;
   }
   try {
-    const ws = require("ws");
-    return ws;
+    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'
-    );
   }
+  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();
+function createWs(url) {
+  const WS = getWebSocket();
+  return new WS(url);
+}
+var WS_OPEN = 1;
 var ModelsResource = class {
   constructor(client) {
     this.client = client;
@@ -260,7 +269,7 @@ var TTSResource = class {
    * Check if WebSocket connection is established and open.
    */
   isConnected() {
-    return this.wsConnection !== null && this.wsConnection.readyState === WebSocketImpl.OPEN;
+    return this.wsConnection !== null && this.wsConnection.readyState === WS_OPEN;
   }
   /**
    * Generate audio from text with streaming via WebSocket.
@@ -318,7 +327,7 @@ var TTSResource = class {
    */
   async getConnection() {
     const url = this.buildWsUrl();
-    if (this.wsConnection && this.wsUrl === url && this.wsConnection.readyState === WebSocketImpl.OPEN) {
+    if (this.wsConnection && this.wsUrl === url && this.wsConnection.readyState === WS_OPEN) {
       return this.wsConnection;
     }
     if (this.wsConnection) {
@@ -329,7 +338,7 @@ var TTSResource = class {
       this.wsConnection = null;
     }
     return new Promise((resolve, reject) => {
-      const ws = new WebSocketImpl(url);
+      const ws = createWs(url);
       ws.onopen = () => {
         this.wsConnection = ws;
         this.wsUrl = url;
@@ -451,7 +460,7 @@ var TTSResource = class {
   streamWithoutPooling(options, callbacks) {
     return new Promise((resolve, reject) => {
       const url = this.buildWsUrl();
-      const ws = new WebSocketImpl(url);
+      const ws = createWs(url);
       ws.onopen = () => {
         callbacks.onOpen?.();
         ws.send(JSON.stringify({
@@ -614,7 +623,7 @@ var MultiContextSession = class {
       authParam = "api_key";
     }
     const url = `${wsUrl}/ws/tts/multi?${authParam}=${this.client.apiKey}`;
-    this.ws = new WebSocketImpl(url);
+    this.ws = createWs(url);
     this.ws.onopen = () => {
     };
     this.ws.onmessage = (event) => {
@@ -684,7 +693,7 @@ var MultiContextSession = class {
    * Create a new context with optional voice settings.
    */
   createContext(contextId, options) {
-    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) {
+    if (!this.ws || this.ws.readyState !== WS_OPEN) {
       throw new KugelAudioError("WebSocket not connected");
     }
     const msg = {
@@ -715,7 +724,7 @@ var MultiContextSession = class {
    * Send text to a specific context.
    */
   send(contextId, text, flush = false) {
-    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) {
+    if (!this.ws || this.ws.readyState !== WS_OPEN) {
       throw new KugelAudioError("WebSocket not connected");
     }
     if (!this.contexts.has(contextId) && !this.isStarted) {
@@ -731,7 +740,7 @@ var MultiContextSession = class {
    * Flush a context's buffer.
    */
   flush(contextId) {
-    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) return;
+    if (!this.ws || this.ws.readyState !== WS_OPEN) return;
     this.ws.send(JSON.stringify({
       flush: true,
       context_id: contextId
@@ -741,7 +750,7 @@ var MultiContextSession = class {
    * Close a specific context.
    */
   closeContext(contextId) {
-    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) return;
+    if (!this.ws || this.ws.readyState !== WS_OPEN) return;
     this.ws.send(JSON.stringify({
       close_context: true,
       context_id: contextId
@@ -751,7 +760,7 @@ var MultiContextSession = class {
    * Send keep-alive to reset a context's inactivity timeout.
    */
   keepAlive(contextId) {
-    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) return;
+    if (!this.ws || this.ws.readyState !== WS_OPEN) return;
     this.ws.send(JSON.stringify({
       text: "",
       context_id: contextId
@@ -761,7 +770,7 @@ var MultiContextSession = class {
    * Close the session and all contexts.
    */
   close() {
-    if (this.ws && this.ws.readyState === WebSocketImpl.OPEN) {
+    if (this.ws && this.ws.readyState === WS_OPEN) {
       this.ws.send(JSON.stringify({ close_socket: true }));
       this.ws.close();
     }
@@ -779,7 +788,7 @@ var MultiContextSession = class {
    * Check if connected.
    */
   get isConnected() {
-    return this.ws !== null && this.ws.readyState === WebSocketImpl.OPEN;
+    return this.ws !== null && this.ws.readyState === WS_OPEN;
   }
 };
 var KugelAudio = class _KugelAudio {

package/dist/index.mjs

@@ -107,25 +107,34 @@ function createWavBlob(audio, sampleRate) {
 }
 
 // src/websocket.ts
-var isBrowser = typeof window !== "undefined" && typeof window.WebSocket !== "undefined";
+var _cachedWs = null;
 function getWebSocket() {
-  if (isBrowser) {
-    return window.WebSocket;
+  if (_cachedWs) return _cachedWs;
+  if (typeof globalThis !== "undefined" && typeof globalThis.WebSocket !== "undefined") {
+    _cachedWs = globalThis.WebSocket;
+    return _cachedWs;
   }
   try {
-    const ws = __require("ws");
-    return ws;
+    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'
-    );
   }
+  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();
+function createWs(url) {
+  const WS = getWebSocket();
+  return new WS(url);
+}
+var WS_OPEN = 1;
 var ModelsResource = class {
   constructor(client) {
     this.client = client;
@@ -231,7 +240,7 @@ var TTSResource = class {
    * Check if WebSocket connection is established and open.
    */
   isConnected() {
-    return this.wsConnection !== null && this.wsConnection.readyState === WebSocketImpl.OPEN;
+    return this.wsConnection !== null && this.wsConnection.readyState === WS_OPEN;
   }
   /**
    * Generate audio from text with streaming via WebSocket.
@@ -289,7 +298,7 @@ var TTSResource = class {
    */
   async getConnection() {
     const url = this.buildWsUrl();
-    if (this.wsConnection && this.wsUrl === url && this.wsConnection.readyState === WebSocketImpl.OPEN) {
+    if (this.wsConnection && this.wsUrl === url && this.wsConnection.readyState === WS_OPEN) {
       return this.wsConnection;
     }
     if (this.wsConnection) {
@@ -300,7 +309,7 @@ var TTSResource = class {
       this.wsConnection = null;
     }
     return new Promise((resolve, reject) => {
-      const ws = new WebSocketImpl(url);
+      const ws = createWs(url);
       ws.onopen = () => {
         this.wsConnection = ws;
         this.wsUrl = url;
@@ -422,7 +431,7 @@ var TTSResource = class {
   streamWithoutPooling(options, callbacks) {
     return new Promise((resolve, reject) => {
       const url = this.buildWsUrl();
-      const ws = new WebSocketImpl(url);
+      const ws = createWs(url);
       ws.onopen = () => {
         callbacks.onOpen?.();
         ws.send(JSON.stringify({
@@ -585,7 +594,7 @@ var MultiContextSession = class {
       authParam = "api_key";
     }
     const url = `${wsUrl}/ws/tts/multi?${authParam}=${this.client.apiKey}`;
-    this.ws = new WebSocketImpl(url);
+    this.ws = createWs(url);
     this.ws.onopen = () => {
     };
     this.ws.onmessage = (event) => {
@@ -655,7 +664,7 @@ var MultiContextSession = class {
    * Create a new context with optional voice settings.
    */
   createContext(contextId, options) {
-    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) {
+    if (!this.ws || this.ws.readyState !== WS_OPEN) {
       throw new KugelAudioError("WebSocket not connected");
     }
     const msg = {
@@ -686,7 +695,7 @@ var MultiContextSession = class {
    * Send text to a specific context.
    */
   send(contextId, text, flush = false) {
-    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) {
+    if (!this.ws || this.ws.readyState !== WS_OPEN) {
       throw new KugelAudioError("WebSocket not connected");
     }
     if (!this.contexts.has(contextId) && !this.isStarted) {
@@ -702,7 +711,7 @@ var MultiContextSession = class {
    * Flush a context's buffer.
    */
   flush(contextId) {
-    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) return;
+    if (!this.ws || this.ws.readyState !== WS_OPEN) return;
     this.ws.send(JSON.stringify({
       flush: true,
       context_id: contextId
@@ -712,7 +721,7 @@ var MultiContextSession = class {
    * Close a specific context.
    */
   closeContext(contextId) {
-    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) return;
+    if (!this.ws || this.ws.readyState !== WS_OPEN) return;
     this.ws.send(JSON.stringify({
       close_context: true,
       context_id: contextId
@@ -722,7 +731,7 @@ var MultiContextSession = class {
    * Send keep-alive to reset a context's inactivity timeout.
    */
   keepAlive(contextId) {
-    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) return;
+    if (!this.ws || this.ws.readyState !== WS_OPEN) return;
     this.ws.send(JSON.stringify({
       text: "",
       context_id: contextId
@@ -732,7 +741,7 @@ var MultiContextSession = class {
    * Close the session and all contexts.
    */
   close() {
-    if (this.ws && this.ws.readyState === WebSocketImpl.OPEN) {
+    if (this.ws && this.ws.readyState === WS_OPEN) {
       this.ws.send(JSON.stringify({ close_socket: true }));
       this.ws.close();
     }
@@ -750,7 +759,7 @@ var MultiContextSession = class {
    * Check if connected.
    */
   get isConnected() {
-    return this.ws !== null && this.ws.readyState === WebSocketImpl.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.12",
+  "version": "0.1.14",
   "description": "Official JavaScript/TypeScript SDK for KugelAudio TTS API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/client.ts

@@ -23,8 +23,18 @@ import { getWebSocket } from './websocket';
 
 const DEFAULT_API_URL = 'https://api.kugelaudio.com';
 
-// Get WebSocket constructor for current environment
-const WebSocketImpl = getWebSocket();
+/**
+ * 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.
@@ -116,7 +126,7 @@ class VoicesResource {
  */
 class TTSResource {
   // Using any for WebSocket to support both browser WebSocket and ws package
-  private wsConnection: InstanceType<typeof WebSocketImpl> | null = null;
+  private wsConnection: WebSocket | null = null;
   private wsUrl: string | null = null;
   private pendingRequests: Map<number, {
     callbacks: StreamCallbacks;
@@ -152,7 +162,7 @@ class TTSResource {
    * Check if WebSocket connection is established and open.
    */
   isConnected(): boolean {
-    return this.wsConnection !== null && this.wsConnection.readyState === WebSocketImpl.OPEN;
+    return this.wsConnection !== null && this.wsConnection.readyState === WS_OPEN;
   }
 
   /**
@@ -219,14 +229,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<InstanceType<typeof WebSocketImpl>> {
+  private async getConnection(): Promise<WebSocket> {
     const url = this.buildWsUrl();
 
     // Return existing connection if valid
     if (
       this.wsConnection &&
       this.wsUrl === url &&
-      this.wsConnection.readyState === WebSocketImpl.OPEN
+      this.wsConnection.readyState === WS_OPEN
     ) {
       return this.wsConnection;
     }
@@ -243,7 +253,7 @@ class TTSResource {
 
     // Create new connection
     return new Promise((resolve, reject) => {
-      const ws = new WebSocketImpl(url);
+      const ws = createWs(url);
 
       ws.onopen = () => {
         this.wsConnection = ws;
@@ -261,7 +271,7 @@ class TTSResource {
   /**
    * Setup message handler for pooled connection.
    */
-  private setupMessageHandler(ws: InstanceType<typeof WebSocketImpl>): void {
+  private setupMessageHandler(ws: WebSocket): void {
     ws.onmessage = (event: { data: unknown }) => {
       try {
         // Handle both browser (string) and Node.js (Buffer) message formats
@@ -400,7 +410,7 @@ class TTSResource {
   ): Promise<void> {
     return new Promise((resolve, reject) => {
       const url = this.buildWsUrl();
-      const ws = new WebSocketImpl(url);
+      const ws = createWs(url);
 
       ws.onopen = () => {
         callbacks.onOpen?.();
@@ -556,7 +566,7 @@ class TTSResource {
  * Multi-context WebSocket session for concurrent TTS streams.
  */
 class MultiContextSession {
-  private ws: InstanceType<typeof WebSocketImpl> | null = null;
+  private ws: WebSocket | null = null;
   private config: import('./types').MultiContextConfig;
   private callbacks: import('./types').MultiContextCallbacks = {};
   private contexts: Set<string> = new Set();
@@ -597,7 +607,7 @@ class MultiContextSession {
     }
 
     const url = `${wsUrl}/ws/tts/multi?${authParam}=${this.client.apiKey}`;
-    this.ws = new WebSocketImpl(url);
+    this.ws = createWs(url);
 
     this.ws.onopen = () => {
       // Connection established, ready to create contexts
@@ -692,7 +702,7 @@ class MultiContextSession {
       voiceSettings?: import('./types').ContextVoiceSettings;
     }
   ): void {
-    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) {
+    if (!this.ws || this.ws.readyState !== WS_OPEN) {
       throw new KugelAudioError('WebSocket not connected');
     }
 
@@ -731,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 !== WebSocketImpl.OPEN) {
+    if (!this.ws || this.ws.readyState !== WS_OPEN) {
       throw new KugelAudioError('WebSocket not connected');
     }
 
@@ -751,7 +761,7 @@ class MultiContextSession {
    * Flush a context's buffer.
    */
   flush(contextId: string): void {
-    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) return;
+    if (!this.ws || this.ws.readyState !== WS_OPEN) return;
 
     this.ws.send(JSON.stringify({
       flush: true,
@@ -763,7 +773,7 @@ class MultiContextSession {
    * Close a specific context.
    */
   closeContext(contextId: string): void {
-    if (!this.ws || this.ws.readyState !== WebSocketImpl.OPEN) return;
+    if (!this.ws || this.ws.readyState !== WS_OPEN) return;
 
     this.ws.send(JSON.stringify({
       close_context: true,
@@ -775,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 !== WebSocketImpl.OPEN) return;
+    if (!this.ws || this.ws.readyState !== WS_OPEN) return;
 
     this.ws.send(JSON.stringify({
       text: '',
@@ -787,7 +797,7 @@ class MultiContextSession {
    * Close the session and all contexts.
    */
   close(): void {
-    if (this.ws && this.ws.readyState === WebSocketImpl.OPEN) {
+    if (this.ws && this.ws.readyState === WS_OPEN) {
       this.ws.send(JSON.stringify({ close_socket: true }));
       this.ws.close();
     }
@@ -807,7 +817,7 @@ class MultiContextSession {
    * Check if connected.
    */
   get isConnected(): boolean {
-    return this.ws !== null && this.ws.readyState === WebSocketImpl.OPEN;
+    return this.ws !== null && this.ws.readyState === WS_OPEN;
   }
 }
 

package/src/websocket.ts

@@ -1,33 +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.
  */
 
-// Detect environment
-const isBrowser = typeof window !== 'undefined' && typeof window.WebSocket !== 'undefined';
+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 (isBrowser) {
-        return window.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
+
+    // Node.js environment - use ws package via dynamic require
     try {
-        // Dynamic require to avoid bundler issues
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        const ws = require('ws');
-        return ws;
+        // 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 {
-        throw new Error(
-            'WebSocket not available. In Node.js, install the "ws" package: npm install ws'
-        );
+        // Fall through to error
     }
-}
 
-/**
- * WebSocket constructor that works in both environments.
- */
-export const WebSocketCompat = getWebSocket();
+    throw new Error(
+        'WebSocket not available. In Node.js, install the "ws" package: npm install ws'
+    );
+}