# What changed in sherpa-onnx-node

> 26 changes in sherpa-onnx-node 2 from its official release notes, upgrade guides and advisories: 1 breaking, 1 security, 8 new APIs and options. Each one cited. Sources checked 2026-11-04. HTML: https://unstale.sh/npm/sherpa-onnx-node/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## sherpa-onnx-node 2

### Breaking changes

- Raises ValueError when it cannot encode keywords. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)

### Security

- Fixed a heap overflow for short text when speed is greater than 1. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)

### New APIs and options

- FunASR-Nano prompt options can now be set per stream. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)
- Added GetEmbedding to SpeakerEmbeddingManager. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)
- Offline CTC models now support HLG decoding through the C, CXX, JNI/Kotlin/Java, and WASM APIs. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)
- Added this option to online-websocket-server. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)
- Streaming NeMo transducer models now support hotwords with modified_beam_search. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)
- Added OfflineDiacritization to the Kotlin API. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)
- A Node.js addon is now available for Windows arm64. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)
- The Flutter package now ships arm64 libraries. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)

### Behavior and default changes

- Provider configuration keys are now forwarded to the CUDA execution provider. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)

### Fixes and other changes

- SherpaOnnxCreate* functions catch C++ exceptions and return NULL. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)
- lang2id is derived from the model vocabulary, and the system warns instead of silently falling back to English. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)
- Fixed strings returned to Java for characters outside the BMP. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)
- C++ exceptions are converted to Java exceptions in these constructors. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)
- Fixed word boundaries, out-of-vocabulary words, and Unicode handling. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)
- Fixed decoding by feeding encoder_attention_mask at raw audio length. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)
- NeMo mel features now use NeMo's additive log-zero guard. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)
- Fixed timestamps after filtering special tokens. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)
- Fixed an abort when input contains fewer than 400 samples. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)
- Fixed JSON escaping in online and offline recognition results. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)
- Python methods now check embedding dimensions before releasing the GIL. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)
- Python methods check the embedding size. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)
- The language-agnostic na tag is now accepted. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)
- VAD sample positions were widened to int64_t to fix SIGSEGV on long streams. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)
- Fixed character loss for byte-level BPE tokens. (2.0.0) — [release notes](https://github.com/csukuangfj/sherpa-onnx/blob/HEAD/CHANGELOG.md)