@japofc/baileys 2.1.0

package/lib/VoIP/types.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Shared type definitions for the @japofc/baileys VoIP stack.
+ *
+ * @author J.AP
+ */
+/** 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;
+};
+/** 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;
+    /** 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/types.js

@@ -0,0 +1,17 @@
+/**
+ * Shared type definitions for the @japofc/baileys VoIP stack.
+ *
+ * @author J.AP
+ */
+/** 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/wasm-engine.d.ts

@@ -0,0 +1,120 @@
+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;
+    acceptCall: (opts?: { isMicEnabled?: boolean; isCameraEnabled?: boolean }) => void;
+    rejectCall: () => void;
+    rejectCallWithoutCallContext: (opts?: any) => void;
+    startGroupCall: (opts?: any) => any;
+    joinOngoingCall: (opts?: any) => any;
+    inviteToCall: (opts?: any) => any;
+    removeCallParticipant: (peerJid: string) => any;
+    requestPeerMute: (peerJid: string) => any;
+    previewCallLink: (opts?: any) => any;
+    joinCallLink: () => any;
+    resendOfferOnDecryptionFailure: (peerJid: string, callId: string) => void;
+    resendEncRekeyRetry: (peerJid: string, retryCount?: number) => void;
+    checkOngoingCalls: (callIds?: string[], callCreatorJids?: string[]) => void;
+    getCallInfo: () => any;
+    getCallStats: (debug?: boolean) => string;
+    sendReaction: (reaction: string) => boolean;
+    raiseHand: (raised: boolean) => boolean;
+    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;