@node-webrtc-rust/bindings 0.7.4 → 0.8.0

package/index.d.ts

@@ -14,6 +14,12 @@ export interface JsIceServer {
 export interface JsRoomOptions {
   maxParticipants?: number
   iceServers?: Array<JsIceServer>
+  noiseSuppression?: JsRoomNoiseSuppression
+}
+/** Per-participant inbound RNNoise toggle for conference mixing. */
+export const enum JsRoomNoiseSuppression {
+  None = 'none',
+  Rnnoise = 'rnnoise'
 }
 /** Participant summary exposed to JavaScript. */
 export interface JsParticipantInfo {
@@ -103,6 +109,44 @@ export interface JsRtcDataChannelInit {
   protocol?: string
   negotiated?: number
 }
+/** Identity quaternion helper for pose setup from TypeScript. */
+export declare function jsQuatIdentity(): JsQuat
+/** Origin position helper for pose setup from TypeScript. */
+export declare function jsVec3Zero(): JsVec3
+/** Named listener-relative placement when positional mixing is off. */
+export const enum JsMixPlacement {
+  Center = 'center',
+  Left = 'left',
+  Right = 'right',
+  Front = 'front',
+  Behind = 'behind',
+  Below = 'below',
+  Above = 'above'
+}
+/** 3D vector for positional mixing. */
+export interface JsVec3 {
+  x: number
+  y: number
+  z: number
+}
+/** Unit quaternion for positional mixing. */
+export interface JsQuat {
+  x: number
+  y: number
+  z: number
+  w: number
+}
+/** World-space pose for a mix participant. */
+export interface JsClientPose {
+  position: JsVec3
+  orientation: JsQuat
+}
+/** Distance attenuation parameters for positional panning. */
+export interface JsDistanceParams {
+  referenceDistance: number
+  maxDistance: number
+  rolloff: number
+}
 /** Init options for {@link RTCPeerConnection.addTransceiver}. */
 export interface JsRtcRtpTransceiverInit {
   direction?: string
@@ -189,6 +233,13 @@ export interface JsTtsConfig {
   apiKey?: string
   postUtteranceSilenceMs?: number
 }
+export const enum JsNoiseSuppressionProvider {
+  None = 'none',
+  Rnnoise = 'rnnoise'
+}
+export interface JsNoiseSuppressionConfig {
+  provider?: JsNoiseSuppressionProvider
+}
 export interface JsVoiceSessionContext {
   sessionId?: string
   traceId?: string
@@ -203,6 +254,7 @@ export interface JsVoiceAgentConfig {
   stt?: JsSttConfig
   tts?: JsTtsConfig
   postUtteranceSilenceMs?: number
+  noiseSuppression?: JsNoiseSuppressionConfig
 }
 export const enum JsSpeechEventType {
   UserSpeakingStart = 'user_speaking_start',
@@ -317,6 +369,44 @@ export declare class JsLocalAudioTrack {
   /** Writes interleaved stereo PCM; encoded to the negotiated RTP codec before send. */
   writeSample(data: Buffer, durationMs: number): Promise<void>
 }
+/** Conference mix graph control handle (poses, groups, mutes, placements). */
+export declare class JsMixGraph {
+  constructor()
+  addInput(participantId: string): void
+  removeInput(participantId: string): void
+  setMixingEnabled(enabled: boolean): void
+  mixingEnabled(): boolean
+  setGlobalMute(target: string, muted: boolean): void
+  isGloballyMuted(target: string): boolean
+  setListenerMute(listener: string, target: string, muted: boolean): void
+  isListenerMuted(listener: string, target: string): boolean
+  setListenerSources(listener: string, sources: Array<string>): void
+  listenerSources(listener: string): Array<string> | null
+  clearListenerRoutes(listener: string): void
+  setPose(participantId: string, pose: JsClientPose): void
+  clearPose(participantId: string): void
+  pose(participantId: string): JsClientPose | null
+  setPositionalEnabled(enabled: boolean): void
+  positionalEnabled(): boolean
+  setDefaultMixPlacement(placement: JsMixPlacement): void
+  defaultMixPlacement(): JsMixPlacement
+  setTtsMixPlacement(placement: JsMixPlacement): void
+  ttsMixPlacement(): JsMixPlacement
+  setTtsPose(participantId: string, pose: JsClientPose): void
+  clearTtsPose(participantId: string): void
+  ttsPose(participantId: string): JsClientPose | null
+  setDistanceParams(params: JsDistanceParams): void
+  distanceParams(): JsDistanceParams
+  setGroupMembers(groupId: string, members: Array<string>): void
+  moveToGroup(participantId: string, groupId: string): void
+  removeFromGroup(participantId: string): void
+  /** Stores the latest 20 ms stereo PCM frame for a participant (3840 bytes @ 48 kHz). */
+  pushFrame(participantId: string, pcm: Buffer): void
+  /** Renders mixed stereo PCM for `listener_id` (3840 bytes; silence when ungrouped or mixing off). */
+  renderOutput(listenerId: string): Buffer
+  /** Pans a TTS frame for `listener_id` using the graph's TTS pose or placement. */
+  panTtsFrame(pcm: Buffer, listenerId: string): Buffer
+}
 /** WebRTC peer connection exposed to JavaScript. */
 export declare class JsPeerConnection {
   constructor(config?: JsRtcConfiguration | undefined | null)
@@ -406,4 +496,7 @@ export declare class JsVoiceAgent {
   setOnSpeechEvent(callback: (...args: any[]) => any): void
   /** Processes one inbound PCM frame (48 kHz stereo) through VAD/STT. */
   processInboundPcm(data: Buffer, durationMs: number): Promise<void>
+  /** When `false`, inbound PCM still runs VAD but skips STT and user speech events. */
+  setSttEnabled(enabled: boolean): Promise<void>
+  sttEnabled(): Promise<boolean>
 }

package/index.js

@@ -310,10 +310,13 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { JsConferenceRoom, JsConferenceServer, JsMuteScope, JsRtcDataChannel, JsMediaStreamTrack, JsMediaStream, JsLocalAudioTrack, JsPeerConnection, JsRtpReceiver, JsRtpSender, JsRtpTransceiver, JsSessionAudioFormat, JsSessionRecorder, JsEventDeliveryMode, JsVadSampleRate, JsSttVendor, JsTtsVendor, JsSpeechEventType, JsVoiceAgent, version } = nativeBinding
+const { JsConferenceRoom, JsConferenceServer, JsMixGraph, JsMixPlacement, JsRoomNoiseSuppression, JsMuteScope, JsRtcDataChannel, JsMediaStreamTrack, JsMediaStream, JsLocalAudioTrack, JsPeerConnection, JsRtpReceiver, JsRtpSender, JsRtpTransceiver, JsSessionAudioFormat, JsSessionRecorder, JsEventDeliveryMode, JsNoiseSuppressionProvider, JsVadSampleRate, JsSttVendor, JsTtsVendor, JsSpeechEventType, JsVoiceAgent, jsQuatIdentity, jsVec3Zero, version } = nativeBinding
 
 module.exports.JsConferenceRoom = JsConferenceRoom
 module.exports.JsConferenceServer = JsConferenceServer
+module.exports.JsMixGraph = JsMixGraph
+module.exports.JsMixPlacement = JsMixPlacement
+module.exports.JsRoomNoiseSuppression = JsRoomNoiseSuppression
 module.exports.JsMuteScope = JsMuteScope
 module.exports.JsRtcDataChannel = JsRtcDataChannel
 module.exports.JsMediaStreamTrack = JsMediaStreamTrack
@@ -326,9 +329,12 @@ module.exports.JsRtpTransceiver = JsRtpTransceiver
 module.exports.JsSessionAudioFormat = JsSessionAudioFormat
 module.exports.JsSessionRecorder = JsSessionRecorder
 module.exports.JsEventDeliveryMode = JsEventDeliveryMode
+module.exports.JsNoiseSuppressionProvider = JsNoiseSuppressionProvider
 module.exports.JsVadSampleRate = JsVadSampleRate
 module.exports.JsSttVendor = JsSttVendor
 module.exports.JsTtsVendor = JsTtsVendor
 module.exports.JsSpeechEventType = JsSpeechEventType
 module.exports.JsVoiceAgent = JsVoiceAgent
+module.exports.jsQuatIdentity = jsQuatIdentity
+module.exports.jsVec3Zero = jsVec3Zero
 module.exports.version = version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@node-webrtc-rust/bindings",
-  "version": "0.7.4",
+  "version": "0.8.0",
   "description": "NAPI-RS native bindings for node-webrtc-rust — WebRTC peer connections, data channels, and conference audio mixing",
   "keywords": [
     "webrtc",
@@ -58,12 +58,12 @@
     "@napi-rs/cli": "^2.18.0"
   },
   "optionalDependencies": {
-    "@node-webrtc-rust/bindings-win32-x64-msvc": "0.7.4",
-    "@node-webrtc-rust/bindings-darwin-x64": "0.7.4",
-    "@node-webrtc-rust/bindings-linux-x64-gnu": "0.7.4",
-    "@node-webrtc-rust/bindings-darwin-arm64": "0.7.4",
-    "@node-webrtc-rust/bindings-linux-arm64-gnu": "0.7.4",
-    "@node-webrtc-rust/bindings-linux-x64-musl": "0.7.4"
+    "@node-webrtc-rust/bindings-win32-x64-msvc": "0.8.0",
+    "@node-webrtc-rust/bindings-darwin-x64": "0.8.0",
+    "@node-webrtc-rust/bindings-linux-x64-gnu": "0.8.0",
+    "@node-webrtc-rust/bindings-darwin-arm64": "0.8.0",
+    "@node-webrtc-rust/bindings-linux-arm64-gnu": "0.8.0",
+    "@node-webrtc-rust/bindings-linux-x64-musl": "0.8.0"
   },
   "engines": {
     "node": ">=18"