kugelaudio 0.2.0 → 0.2.2

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'
+    );
+}