host-objects

Use JSI HostObjects to bridge C++ audio nodes to JavaScript, exposing native state and behavior directly to the TypeScript API. This architecture allows TS, HostObject, and AudioNode to interact without serialization overhead.

To add a new audio HostObject, follow the three-layer architecture pattern and register getters and setters in the constructor using macro-based registration. This ensures proper property and method exposure for the custom node.

JSI crashes often stem from unsafe cross-thread argument parsing or improper shadow state initialization. You must implement safe argument parsing patterns and ensure shadow state is correctly initialized for JS-to-audio-thread communication.

Handle memory pressure for large buffers by following memory pressure considerations during HostObject creation. Ensure safe destructor cleanup is implemented to prevent leaks when the HostObject is garbage collected.

Yes, you can wire a new node into the context factory using the macro-based registration system. This approach codifies the registration of getters, setters, and methods directly in the HostObject constructor.

Shadow state patterns manage the communication between the JavaScript thread and the native audio thread. They provide a safe mechanism to sync state and behavior between the JSI HostObject layer and the underlying C++ AudioNode.