@ai-coustics/aic-sdk 0.13.0 → 0.15.0

package/README.md

@@ -5,7 +5,7 @@ Node.js wrapper for the ai-coustics Speech Enhancement SDK.
 For comprehensive documentation, visit [docs.ai-coustics.com](https://docs.ai-coustics.com).
 
 > [!NOTE]
-> This SDK requires a license key. Generate your key at [developers.ai-coustics.io](https://developers.ai-coustics.io).
+> This SDK requires a license key. Generate your key at [developers.ai-coustics.com](https://developers.ai-coustics.com).
 
 ## Installation
 
@@ -22,7 +22,7 @@ const { Model, Processor } = require("@ai-coustics/aic-sdk");
 const licenseKey = process.env.AIC_SDK_LICENSE;
 
 // Download and load a model (or download manually at https://artifacts.ai-coustics.io/)
-const modelPath = Model.download("sparrow-xxs-48khz", "./models");
+const modelPath = Model.download("quail-vf-2.0-l-16khz", "./models");
 const model = Model.fromFile(modelPath);
 
 // Get optimal configuration
@@ -64,7 +64,7 @@ const model = Model.fromFile("path/to/model.aicmodel");
 
 #### Download from CDN
 ```javascript
-const modelPath = Model.download("sparrow-xxs-48khz", "./models");
+const modelPath = Model.download("quail-vf-2.0-l-16khz", "./models");
 const model = Model.fromFile(modelPath);
 ```
 
@@ -128,7 +128,6 @@ procCtx.reset();
 
 // Set enhancement parameters
 procCtx.setParameter(ProcessorParameter.EnhancementLevel, 0.8);
-procCtx.setParameter(ProcessorParameter.VoiceGain, 1.5);
 procCtx.setParameter(ProcessorParameter.Bypass, 0.0);
 
 // Get parameter values

package/index.js

@@ -63,21 +63,6 @@ const ProcessorParameter = {
    * Default: 1.0
    */
   EnhancementLevel: native.PROCESSOR_PARAM_ENHANCEMENT_LEVEL,
-
-  /**
-   * Compensates for perceived volume reduction after noise removal.
-   *
-   * Range: 0.1 to 4.0 (linear amplitude multiplier)
-   *   - 0.1: Significant volume reduction (-20 dB)
-   *   - 1.0: No gain change (0 dB, default)
-   *   - 2.0: Double amplitude (+6 dB)
-   *   - 4.0: Maximum boost (+12 dB)
-   *
-   * Formula: Gain (dB) = 20 × log₁₀(value)
-   *
-   * Default: 1.0
-   */
-  VoiceGain: native.PROCESSOR_PARAM_VOICE_GAIN,
 };
 
 /**
@@ -89,16 +74,25 @@ const VadParameter = {
    * Controls for how long the VAD continues to detect speech after the audio signal
    * no longer contains speech.
    *
+   * This affects the stability of speech detected -> not detected transitions.
+   *
    * The VAD reports speech detected if the audio signal contained speech in at least 50%
-   * of the frames processed in the last speech_hold_duration seconds.
+   * of the frames processed in the last `speech_hold_duration * 2` seconds.
    *
-   * This affects the stability of speech detected -> not detected transitions.
+   * For example, if `speech_hold_duration` is set to 0.5 seconds and the VAD stops detecting speech
+   * in the audio signal, the VAD will continue to report speech for 0.5 seconds assuming the
+   * VAD does not detect speech again during that period. If a few frames of speech are detected
+   * during that period, those frames will be included in the 50% calculation, which will extend
+   * the speech detection period until the 50% threshold is no longer met.
    *
-   * Note: The VAD returns a value per processed buffer, so this duration is rounded
-   * to the closest model window length.
+   * NOTE: The VAD returns a value per processed buffer, so this duration is rounded
+   * to the closest model window length. For example, if the model has a processing window
+   * length of 10 ms, the VAD will round up/down to the closest multiple of 10 ms.
+   * Because of this, this parameter may return a different value than the one it was last set to.
+   *
+   * **Range:** 0.0 to 100x model window length (value in seconds)
    *
-   * Range: 0.0 to 20x model window length (value in seconds)
-   * Default: 0.05 (50 ms)
+   * **Default:** 0.03 (30 ms)
    */
   SpeechHoldDuration: native.VAD_PARAM_SPEECH_HOLD_DURATION,
 

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@ai-coustics/aic-sdk",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "Node.js package of ai-coustics SDK",
   "main": "index.js",
   "scripts": {
-    "test": "node examples/basic.js",
+    "test": "node tests/end2end.test.js",
     "build": "cargo build --release && cp target/release/libaic_sdk_node.so index.node 2>/dev/null || cp target/release/libaic_sdk_node.dylib index.node 2>/dev/null || cp target/release/aic_sdk_node.dll index.node 2>/dev/null || true",
     "debug": "cargo build && cp target/debug/libaic_sdk_node.so index.node 2>/dev/null || cp target/debug/libaic_sdk_node.dylib index.node 2>/dev/null || cp target/debug/aic_sdk_node.dll index.node 2>/dev/null || true",
     "version:update": "bash scripts/update-version.sh"
@@ -34,12 +34,12 @@
     "LICENSE"
   ],
   "optionalDependencies": {
-    "@ai-coustics/aic-sdk-darwin-arm64": "0.13.0",
-    "@ai-coustics/aic-sdk-darwin-x64": "0.13.0",
-    "@ai-coustics/aic-sdk-linux-arm64-gnu": "0.13.0",
-    "@ai-coustics/aic-sdk-linux-x64-gnu": "0.13.0",
-    "@ai-coustics/aic-sdk-win32-arm64-msvc": "0.13.0",
-    "@ai-coustics/aic-sdk-win32-x64-msvc": "0.13.0"
+    "@ai-coustics/aic-sdk-darwin-arm64": "0.15.0",
+    "@ai-coustics/aic-sdk-darwin-x64": "0.15.0",
+    "@ai-coustics/aic-sdk-linux-arm64-gnu": "0.15.0",
+    "@ai-coustics/aic-sdk-linux-x64-gnu": "0.15.0",
+    "@ai-coustics/aic-sdk-win32-arm64-msvc": "0.15.0",
+    "@ai-coustics/aic-sdk-win32-x64-msvc": "0.15.0"
   },
   "devDependencies": {
     "@neon-rs/cli": "0.1.82",