WebAssembly errors

Version: @ai-coustics/aic-sdk-wasm 0.23.0, Core SDK 0.23.0. API index · WebAssembly quickstart. The binding throws JavaScript Error or RangeError objects. It does not export SDK exception classes, an error-code enum or a structured code property. TypeScript signatures do not list thrown exceptions. Catch errors around construction, initialization, model loading, token renewal and processing, and release already-created handles in finally.

Failure	JavaScript error	Recovery
Processor or VAD parameter outside its accepted range	`RangeError`	Correct the parameter before processing again.
Analysis-window range error propagated by the core	`RangeError`	Check model compatibility; this binding exposes no window-length setting.
Processor or collector not initialized	`Error`	Successfully initialize before passing audio.
Unsupported audio configuration	`Error`	Use a supported sample rate and valid block size.
Audio block does not match initialized configuration	`Error`	Supply the required number of mono samples.
Processing disallowed	`Error`	Resolve session authorization and network requirements; do not retry in a tight processing loop.
Invalid, unsupported or expired credential	`Error`	Obtain a valid credential through your backend.
Unsupported token update	`Error`	Ensure the original and replacement credentials are both JWT-form credentials.
Model type unsupported by the selected class	`Error`	Match enhancement, VAD and analysis models to their respective classes.
Model parsing, allocation or runtime creation failure	`Error`	Check model bytes and runtime compatibility.
Internal processing failure	`Error`	Stop using the stream and retain the error message for diagnosis.

The delegated core also defines voiceprint errors for other interfaces. This package exposes no enrollment or voiceprint methods. Binding misuse, invalid JavaScript types, initialization failures and access after free() can produce JavaScript or WebAssembly errors outside the SDK mapping; do not depend on their exact text or class. A failed updateBearerToken preserves the previous token. A successful call checks local format, not backend acceptance. A failed initialization requires successful reinitialization before submitting more audio. A failed enhancement call does not guarantee the input array is unchanged.

try {
  context.setParameter(ProcessorParameter.EnhancementLevel, requestedLevel);
} catch (error) {
  if (error instanceof RangeError) {
    console.error("Enhancement level must be between 0 and 1.");
  } else {
    throw error;
  }
}

This fragment assumes a live ProcessorContext named context, a numeric requestedLevel and ProcessorParameter imported from the package. See enhancement for the full control API and lifecycle for cleanup.

SDK

API reference

Upgrades

LiveKit

AI tools

Historical migrations