> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ai-coustics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Node.js errors

> Identify thrown errors and rejected promises, then recover with the correct state and inputs.

**Version:** `@ai-coustics/aic-sdk` 0.24.0, Core SDK 0.24.0. [API index](/reference/sdk/api/node/index) · [Node.js quickstart](/reference/sdk/language-bindings/nodejs).

SDK failures become ordinary JavaScript `Error` objects with the SDK message. This package exports no SDK exception subclasses or public error-code enum. Native SDK errors use N-API's generic-failure category; do not import Python/Rust error class names in Node.js. JavaScript argument conversion can also throw before native work is queued.

Synchronous methods and constructors throw. Native work queued by asynchronous methods rejects its promise. Put both construction and `await` inside error handling. Dispose only after outstanding work has settled; never turn a failed operation into a success response or assume an input buffer contains enhanced output.

## Error messages and recovery

| Message or cause                                                 | Recovery                                                                                                                                                                |
| ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Parameter value is outside the acceptable range`                | Use the documented enum/range and finite values. Read model defaults before tuning.                                                                                     |
| `Handle must be initialized`                                     | Successfully initialize the object before processing or buffering.                                                                                                      |
| `Audio configuration (sample_rate, block_size) is not supported` | Use a supported whole-number rate and a positive block size; start with model-optimal geometry.                                                                         |
| `Audio block configuration differs`                              | Match the configured block length or explicitly enable variable blocks.                                                                                                 |
| `Processing is not allowed`                                      | Check credential authorization and usage-reporting failures. Follow [authentication](/models/get-started/authenticate-apps); do not busy-loop retries.                  |
| `License key format is invalid or corrupted`                     | Check the credential was copied correctly, including unintended trailing characters.                                                                                    |
| `License version is not compatible`                              | Match the SDK release to the supported credential or contact support.                                                                                                   |
| `License key has expired`                                        | Renew the credential. For a JWT session, obtain an accepted replacement token.                                                                                          |
| `Updating the token is only supported`                           | Both the original and replacement must be JWT-form credentials. Signed-key sessions cannot be converted through token update.                                           |
| `The model file is invalid or corrupted`                         | Provision a valid complete model file.                                                                                                                                  |
| `The model file version is not compatible`                       | Download a compatible artifact or use the matching SDK.                                                                                                                 |
| `The model type is not supported`                                | Use enhancement/bypass for Processor, dedicated VAD for Vad and analysis for Analyzer.                                                                                  |
| `The file path is invalid`                                       | Supply a valid local path.                                                                                                                                              |
| `The model file cannot be opened`                                | Check file existence and permissions.                                                                                                                                   |
| `Model download error:`                                          | Inspect the attached network, manifest, checksum or filesystem detail; correct the cause before retrying.                                                               |
| `Internal error occurred` / `Unknown error code:`                | Record versions and a minimal reproduction without credentials, then contact support.                                                                                   |
| `The model data is not aligned to 64 bytes`                      | Node has no public raw-buffer model loader; if seen through normal Node factories, report a binding/native integration issue rather than manually aligning a JS buffer. |
| `<Class> has been disposed`                                      | Construct a new object. Disposal cannot be reversed.                                                                                                                    |

Message excerpts describe this release, not stable programmatic error discriminants. Keep secrets out of logs. For deployment recovery and network requirements, see [authentication](/models/get-started/authenticate-apps) and [SDK telemetry](/reference/concepts/sdk-telemetry).

## Reserved export

<span id="node-_setsdkid" />

## `_setSdkId`

```typescript theme={null}
function _setSdkId(id: number): void
```

Reserved internal export for ai-coustics embedding wrappers, not an application configuration API. Sets a telemetry wrapper ID only on the first write in the process; later writes are ignored. Applications should leave this untouched.

## Related

[Node.js API index](/reference/sdk/api/node/index) · [Errors and recovery](/reference/sdk/api/node/errors) · [Stream lifecycle](/reference/concepts/streams-and-state).