feat: add binary type support for host functions

Adds Uint8Array/Buffer support for host function arguments and returns.

Architecture:
- New hyperlight-js-common crate: shared wire-format constants, binary
  sidecar encode/decode, FnReturn enum, DecodeError type
- Guest extracts Uint8Array from QuickJS VM into binary sidecar
- Host dispatches via register() (typed serde) or register_js() (JS bridge)
- NAPI layer creates native Node.js Buffers via C API (no base64)
- Tagged return format (0x00=JSON, 0x01=binary) for return path

Key changes:
- Single CallHostJsFunction entry point (removed legacy JSON-only path)
- Native Buffer marshalling in NAPI (JsArg/JsReturn types)
- Depth limits on all recursive JSON tree traversals (MAX_JSON_DEPTH=64)
- Trailing data rejection in sidecar decoder
- Typed register() rejects binary args with clear error message
- Comprehensive test coverage (Rust unit + integration + JS vitest)
- Updated README with Binary Data section and wire protocol docs
- Updated CI publish order for new common crate

Signed-off-by: Simon Davies <simongdavies@users.noreply.github.com>

Author: simongdavies

.github/workflows/CreateRelease.yml

@@ -56,6 +56,7 @@ jobs:
 
       - name: Publish hyperlight-js
         run: |
+          cargo publish -p hyperlight-js-common
           cargo publish -p hyperlight-js-runtime
           cargo publish -p hyperlight-js
         env:

Cargo.lock

@@ -1,6 +1,6 @@
 [workspace]
 resolver = "2"
-members = ["src/hyperlight-js", "src/js-host-api", "src/hyperlight-js-runtime"]
+members = ["src/hyperlight-js", "src/js-host-api", "src/hyperlight-js-runtime", "src/hyperlight-js-common"]
 
 [workspace.package]
 version = "0.1.1"
@@ -16,6 +16,7 @@ hyperlight-guest-bin = { git = "https://github.com/hyperlight-dev/hyperlight", r
 hyperlight-guest = { git = "https://github.com/hyperlight-dev/hyperlight", rev = "620339aa95d508e8cbd1d38b4374f09090aade7b" }
 hyperlight-host = { git = "https://github.com/hyperlight-dev/hyperlight", rev = "620339aa95d508e8cbd1d38b4374f09090aade7b", default-features = false, features = ["executable_heap", "init-paging"] }
 hyperlight-js = { version = "0.1.1", path = "src/hyperlight-js" }
+hyperlight-js-common = { version = "0.1.1", path = "src/hyperlight-js-common" }
 hyperlight-js-runtime = { version = "0.1.1", path = "src/hyperlight-js-runtime" }
 
 [profile.dev]

Cargo.toml

@@ -51,7 +51,7 @@ When this job is done, a new [GitHub release](https://github.com/hyperlight-dev/
 
 This release contains the benchmark results and the source code for the release along with automatically generated release notes.
 
-In addition the hyperlight-js crates will be published to crates.io. You can verify this by going to the [hyperlight-js page on crates.io](https://crates.io/crates/hyperlight-js) and checking that the new version is listed.
+In addition the hyperlight-js crates will be published to crates.io in dependency order (`hyperlight-js-common` → `hyperlight-js-runtime` → `hyperlight-js`). You can verify this by going to the [hyperlight-js page on crates.io](https://crates.io/crates/hyperlight-js) and checking that the new version is listed.
 
 ## Patching a release
 

docs/release.md

@@ -0,0 +1,18 @@
+[package]
+name = "hyperlight-js-common"
+version.workspace = true
+edition.workspace = true
+rust-version.workspace = true
+license.workspace = true
+repository.workspace = true
+readme.workspace = true
+description = """
+Shared constants and binary framing utilities for hyperlight-js.
+
+This crate is `no_std`-compatible (with `alloc`) so it can be used by both
+the host-side `hyperlight-js` crate and the guest-side `hyperlight-js-runtime`
+crate (which compiles for `x86_64-hyperlight-none`).
+"""
+
+[dependencies]
+# no_std + alloc only — no std, no serde, no anyhow