@areumtecnologia/wasockets 2.0.0 → 2.3.0

package/lib/VoIP/engine/types.d.mts

@@ -0,0 +1,183 @@
+/**
+ * Shared type definitions for baileys-caller.
+ *
+ * @author ShellTear
+ */
+import type { Readable } from "node:stream";
+
+/** Audio stream configuration reported by the WASM. */
+export type AudioConfig = {
+    sampleRate: number;
+    channels: number;
+    bitsPerSample: number;
+    framesPerChunk: number;
+};
+
+/** Options for placing a call. */
+export type CallOptions = {
+    /** Phone number, digits only (e.g. `"12345678901"`). */
+    to: string;
+    /** Audio source: file path to MP3/WAV, or `"silence"` for an empty uplink. */
+    audioSource?: string;
+    /** Auto-hangup after N ms (default: 120000). */
+    durationMs?: number;
+    /** Place as video call */
+    isVideo?: boolean;
+};
+
+export type VadOptions = {
+    thresholdDbfs?: number;
+    silenceTimeoutMs?: number;
+    speechDebounceFrames?: number;
+    enabled?: boolean;
+};
+
+export type StreamOptions = {
+    format?: "int16" | "float32";
+};
+
+export type RecordOptions = {
+    channels?: 1 | 2;
+    sampleRate?: number;
+    source?: "mixed" | "rx" | "tx";
+};
+
+export type CallRealtimeStats = {
+    callId: string;
+    state: number;
+    talkDurationSeconds: number;
+    rttMs: number | null;
+    packetsSent: number;
+    packetsReceived: number;
+    droppedPackets: number;
+    bytesSent: number;
+    bytesReceived: number;
+    uplinkBps: number;
+    downlinkBps: number;
+    isSpeaking: boolean;
+    audioFeeder: any;
+};
+
+export type CallTelemetry = {
+    callId: string;
+    direction: string;
+    peer: {
+        phoneNumber: string;
+        pnJid: string;
+        lidJid: string;
+    };
+    caller: {
+        pnJid: string | null;
+        lidJid: string | null;
+        displayName: string;
+    };
+    timing: {
+        offerTimestamp: number;
+        ringingTimestamp: number | null;
+        connectedTimestamp: number | null;
+        endedTimestamp: number;
+        timeToRingMs: number | null;
+        timeToAnswerMs: number | null;
+        talkDurationSeconds: number;
+        totalDurationSeconds: number;
+    };
+    status: {
+        finalState: string;
+        endReason: string;
+        answered: boolean;
+    };
+    audioMetrics: {
+        sampleRate: number;
+        channels: number;
+        frameDurationMs: number;
+        samplesPerChunk: number;
+        packetsReceived: number;
+        packetsSent: number;
+        bytesReceived: number;
+        bytesSent: number;
+        voiceActivity: {
+            avgVolumeDbfs: number;
+            peakVolumeDbfs: number;
+            speechFrames: number;
+            silenceFrames: number;
+            speechRatio: number;
+        };
+    };
+    networkMetrics: {
+        transport: string;
+        relayServer: string;
+        iceRttMs: number | null;
+        droppedPackets: number;
+        bytesReceived: number;
+        bytesSent: number;
+    };
+};
+
+/** Events emitted by an `ActiveCall`. */
+export type CallEvents = {
+    ringing: () => void;
+    connected: () => void;
+    /** 16 kHz mono Float32 PCM frame from the remote peer. */
+    audio: (pcm: Float32Array) => void;
+    /** 16 kHz mono Float32 PCM frame sent to the remote peer (uplink). */
+    audio_out: (pcm: Float32Array) => void;
+    "audio:out": (pcm: Float32Array) => void;
+    audio_tx: (pcm: Float32Array) => void;
+    /** Video frame received from remote peer. */
+    video?: (data: any) => void;
+    /** Video frame sent to remote peer. */
+    video_out?: (data: any) => void;
+    "video:out"?: (data: any) => void;
+    /** Voice activity detection: user started speaking */
+    speaking: (event: { volumeDbfs: number; rms: number }) => void;
+    /** Voice activity detection: user stopped speaking */
+    silence: (event: { durationMs: number }) => void;
+    /** Real-time QoS network and throughput stats */
+    stats: (stats: CallRealtimeStats) => void;
+    /** Full structured telemetry report upon call completion */
+    telemetry: (telemetry: CallTelemetry) => void;
+    /** Reason: `"hangup"` | `"timeout"` | `"rejected"` | `"remote_end"` | `"disconnect"` | etc. */
+    ended: (reason: string) => void;
+    error: (err: Error) => void;
+};
+
+/** Top-level SDK configuration. */
+export type VoipSdkConfig = {
+    /** Path to a Baileys multi-file auth state directory. */
+    authDir: string;
+};
+
+/** Mirrors the WhatsApp WASM `CallState` enum. */
+export declare const CallState: {
+    readonly Idle: 0;
+    readonly Calling: 1;
+    readonly PreacceptReceived: 2;
+    readonly ReceivedCall: 3;
+    readonly AcceptSent: 4;
+    readonly AcceptReceived: 5;
+    readonly Active: 6;
+    readonly ActiveElsewhere: 7;
+    readonly Ending: 13;
+};
+export type CallState = (typeof CallState)[keyof typeof CallState];
+
+/** Relay list update payload from WASM call event 156. */
+export type RelayListUpdate = {
+    relay_key: string;
+    relay_tokens: string[];
+    auth_tokens?: string[];
+    enable_edgeray_dtls_active_mode?: boolean;
+    relays: ReadonlyArray<{
+        relay_id: number;
+        relay_name: string;
+        token_id: number;
+        auth_token_id?: number;
+        addresses: ReadonlyArray<{
+            protocol: number;
+            ipv4?: string;
+            ipv6?: string;
+            port?: number;
+            port_v6?: number;
+        }>;
+    }>;
+};

package/lib/VoIP/engine/types.mjs

@@ -0,0 +1,17 @@
+/**
+ * Shared type definitions for baileys-caller.
+ *
+ * @author ShellTear
+ */
+/** Mirrors the WhatsApp WASM `CallState` enum. */
+export const CallState = {
+    Idle: 0,
+    Calling: 1,
+    PreacceptReceived: 2,
+    ReceivedCall: 3,
+    AcceptSent: 4,
+    AcceptReceived: 5,
+    Active: 6,
+    ActiveElsewhere: 7,
+    Ending: 13,
+};

package/lib/VoIP/engine/wasm-engine.d.mts

@@ -0,0 +1,103 @@
+export type WasmAudioConfig = {
+    sampleRate: number;
+    channels: number;
+    bitsPerSample: number;
+    framesPerChunk: number;
+};
+export type WasmEngineCallbacks = {
+    onSignalingXmpp?: (peerJid: string, callId: string, xmlPayload: Uint8Array) => void;
+    onCallEvent?: (eventType: number, eventData?: string) => void;
+    onVoipReady?: () => void;
+    sendDataToRelay?: (data: Uint8Array, ip: string, port: number) => number;
+    onLog?: (level: string, message: string) => void;
+    onAudioCaptureInit?: (config: WasmAudioConfig) => void;
+    onAudioCaptureStart?: () => void;
+    onAudioCaptureStop?: () => void;
+    onAudioPlaybackInit?: (config: WasmAudioConfig) => void;
+    onAudioPlaybackStart?: () => void;
+    onAudioPlaybackStop?: () => void;
+    onAudioPlaybackData?: (audioData: Float32Array) => void;
+    cryptoHkdf?: (key: Uint8Array, salt: Uint8Array | null, info: Uint8Array, length: number) => Uint8Array;
+    hmacSha256?: (data: Uint8Array, key: Uint8Array) => Uint8Array;
+};
+export type WasmEngineConfig = {
+    resourcesPath?: string;
+    wasmPath?: string;
+    wasmBinary?: Uint8Array;
+    loaderCode?: string;
+    workerModulesCode?: string;
+    loaderModuleName?: string;
+    callbacks?: WasmEngineCallbacks;
+    enableLogs?: boolean;
+    options?: {
+        heartbeatInterval?: number;
+        lobbyTimeout?: number;
+        maxParticipantsScreenShare?: number;
+        maxGroupSizeLongRingtone?: number;
+        logLevel?: number;
+    };
+};
+export declare class WasmEngine {
+    #private;
+    static registerGlobalCallbackListener: (callbackName: string, handler: (data: any) => void) => void;
+    static notifyGlobalCallbackListeners: (callbackName: string, data: any) => void;
+    constructor(config?: WasmEngineConfig);
+    initialize: () => Promise<void>;
+    isInitialized: () => boolean;
+    destroy: () => void;
+    initVoipStack: (selfJid: string, meUserJid: string, selfLid: string) => void;
+    waitForVoipStackReady: () => Promise<void>;
+    isVoipStackReady: () => boolean;
+    startCall: (options: {
+        peerJid: string;
+        peerPn: string;
+        peerList?: string[];
+        callId: string;
+        isVideo: boolean;
+        isLidCall?: boolean;
+        isFromDialer?: boolean;
+        extraData?: Uint8Array;
+    }) => unknown;
+    endCall: (reason?: number, sendTerminate?: boolean) => void;
+    setMute: (muted: boolean) => number;
+    updateNetworkMedium: (networkMedium: number, networkMtu?: number) => void;
+    handleSignalingOffer: (msg: {
+        payload: string;
+        peerPlatform?: number;
+        peerAppVersion?: string;
+        epochId?: string;
+        timestamp?: string;
+        isOffline?: boolean;
+        isOfferNotContact?: boolean;
+        peerJid: string;
+        tcToken?: Uint8Array;
+    }) => void;
+    handleSignalingMessage: (msg: {
+        payload: string;
+        peerPlatform?: string | number;
+        peerAppVersion?: string;
+        epochId?: string;
+        timestamp?: string;
+        isOffline?: boolean;
+        peerJid: string;
+        tcToken?: Uint8Array;
+    }) => void;
+    handleSignalingAck: (msg: {
+        payload: string;
+        ackError?: string;
+        msgType?: string;
+        peerJid?: string;
+        extraData?: Uint8Array;
+    }) => void;
+    handleSignalingReceipt: (msg: {
+        payload: string;
+        peerJid: string;
+        tcToken?: Uint8Array;
+    }) => void;
+    handleOnTransportMessage: (data: Uint8Array, ip: string, port: number) => void;
+    updateIceRtt: (rttMs: number, relayIp: string, relayPort: number) => void;
+    sendAudioData: (data: Float32Array, ptr: number) => void;
+    malloc: (size: number) => number;
+    free: (ptr: number) => void;
+}
+export default WasmEngine;