Merge pull request #154 from babblevoice/transcribe-client-and-local-close-normalise

Add channel-client transcribe() + normalise local close() args (3.2.3)

Author: tinpotnick

index.js

@@ -471,6 +471,16 @@ class projectrtp {
       /* ensure we are identicle to the node version of this object */
       chan.openchannel = this.openchannel.bind( this )
 
+      /* The remote (server.js) channel close() takes an options object
+         ({ timeout }); the local Rust napi close() takes an optional reason
+         string and returns a bool. Normalise so callers can hand the same
+         options object to either transport - callmanager calls
+         close( { timeout } ) regardless of whether the channel is local or
+         remote, and the bare object would otherwise fail napi's
+         String conversion. */
+      const napiclose = chan.close.bind( chan )
+      chan.close = ( options ) => napiclose( "string" === typeof options ? options : undefined )
+
       /* Wrap the Rust `createReadStream(opts, cb)` napi method so JS gets a
          standard Node `Readable` — pipeable into fs.createWriteStream,
          WebSocket, fetch bodies, any transform stream, etc.

lib/server.js

@@ -561,6 +561,26 @@ class channel {
     return true
   }
 
+  /**
+  @summary Start live transcription on the channel. The command itself is a no-op
+  at the channel level - it is consumed by the node's pre hook, which binds the
+  token to this channel and taps its audio (getchannel() + createReadStream) to
+  stream speech-to-text.
+  @param { Object } options
+  @param { string } options.token - identifier the audio-tap consumer binds to
+  @param { string } [ options.engine ] - STT engine
+  @param { string } [ options.language ] - BCP-47 hint
+  @param { string } [ options.model ] - engine model override
+  @returns { boolean }
+  */
+  transcribe( options ) {
+    this._write( {
+      "channel": "transcribe",
+      options
+    } )
+    return true
+  }
+
   /**
    * We have received the open confirm message so we should action it
    * @private

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@babblevoice/projectrtp",
-  "version": "3.2.2",
+  "version": "3.2.3",
   "description": "A scalable Node addon RTP server",
   "main": "index.js",
   "directories": {