@cloudfort/callum-voice 0.0.3

package/src/VoiceConfig.ts

@@ -0,0 +1,58 @@
+// Copyright Cloudfort. All Rights Reserved.
+
+/**
+ * Configuration for connecting to the voice chat service.
+ */
+export interface VoiceConfig {
+  /** Server address (e.g. "callem.cloudfort.ir"). Do NOT include scheme or port. */
+  server: string;
+
+  /** API key obtained from account registration (vc_live_...) */
+  apiKey: string;
+
+  /** Unique identifier for this peer / user */
+  peerId: string;
+
+  /** Use WSS (TLS) instead of WS. Auto-detected when undefined. */
+  useTls?: boolean;
+
+  /** Audio sample rate in Hz (default 48000) */
+  sampleRate: number;
+
+  /** Automatically reconnect on unexpected disconnect (default true) */
+  autoReconnect: boolean;
+
+  /** Maximum reconnection attempts before giving up (default 5) */
+  maxReconnectAttempts: number;
+
+  /** Delay between reconnection attempts in milliseconds (default 2000) */
+  reconnectDelayMs: number;
+
+  /** Enable platform echo cancellation (default true) */
+  echoCancellation: boolean;
+
+  /** Enable platform noise suppression (default true) */
+  noiseSuppression: boolean;
+
+  /** Enable platform automatic gain control (default true) */
+  autoGainControl: boolean;
+}
+
+/**
+ * Create a VoiceConfig with sensible defaults.
+ */
+export function createVoiceConfig(overrides: Partial<VoiceConfig>): VoiceConfig {
+  return {
+    server: '',
+    apiKey: '',
+    peerId: '',
+    sampleRate: 48000,
+    autoReconnect: true,
+    maxReconnectAttempts: 5,
+    reconnectDelayMs: 2000,
+    echoCancellation: true,
+    noiseSuppression: true,
+    autoGainControl: true,
+    ...overrides,
+  };
+}

package/src/VoiceEventListener.ts

@@ -0,0 +1,66 @@
+// Copyright Cloudfort. All Rights Reserved.
+
+import { VoiceClientState } from './VoiceClientState';
+
+/**
+ * Callback interface for receiving voice client events.
+ *
+ * Implement only the methods you need — all methods have no-op defaults.
+ *
+ * @example
+ * ```ts
+ * const listener: VoiceEventListener = {
+ *   onConnected: () => console.log('Connected!'),
+ *   onPeerSpeaking: (peerId) => console.log(`${peerId} speaking`),
+ * };
+ * ```
+ */
+export interface VoiceEventListener {
+  /** Connection established */
+  onConnected?(): void;
+
+  /** Connection lost */
+  onDisconnected?(): void;
+
+  /** Reconnection attempt in progress */
+  onReconnecting?(attempt: number): void;
+
+  /** Authentication failed */
+  onAuthFailed?(reason: string): void;
+
+  /** Joined a room */
+  onRoomJoined?(roomId: string): void;
+
+  /** Left a room */
+  onRoomLeft?(roomId: string): void;
+
+  /** New peer joined the room */
+  onPeerJoined?(peerId: string): void;
+
+  /** Peer left the room */
+  onPeerLeft?(peerId: string): void;
+
+  /** Peer started speaking */
+  onPeerSpeaking?(peerId: string): void;
+
+  /** Peer stopped speaking */
+  onPeerStopped?(peerId: string): void;
+
+  /** Microphone enabled */
+  onMicEnabled?(): void;
+
+  /** Microphone disabled */
+  onMicDisabled?(): void;
+
+  /** Speaker enabled */
+  onSpeakerEnabled?(): void;
+
+  /** Speaker disabled */
+  onSpeakerDisabled?(): void;
+
+  /** Error occurred */
+  onError?(error: Error): void;
+
+  /** Connection state changed */
+  onStateChanged?(newState: VoiceClientState): void;
+}

package/src/index.ts

@@ -0,0 +1,6 @@
+// Copyright Cloudfort. All Rights Reserved.
+
+export { VoiceClientState } from './VoiceClientState';
+export { VoiceConfig, createVoiceConfig } from './VoiceConfig';
+export { VoiceEventListener } from './VoiceEventListener';
+export { VoiceClient } from './VoiceClient';