feat: JavaScript SDK via napi-rs

.github/actions/setup/action.yml

@@ -1,5 +1,5 @@
 name: Setup
-description: Checkout, install Python, restore cache, and run bin/setup
+description: Checkout, install Python + Node, restore cache, and run bin/setup
 
 inputs:
   cache-prefix:
@@ -13,6 +13,9 @@ runs:
     - uses: actions/setup-python@v5
       with:
         python-version: "3.13"
+    - uses: actions/setup-node@v4
+      with:
+        node-version: "22"
     - uses: actions/cache@v4
       with:
         path: |

Cargo.toml

@@ -5,3 +5,8 @@ members = [
   "src/ascend_tools/ascend-tools-cli",
 ]
 resolver = "3"
+
+[profile.release]
+strip = true
+lto = true
+codegen-units = 1

bin/build

@@ -4,3 +4,4 @@ cd "$(dirname "${BASH_SOURCE[0]}")/.."
 
 bin/build-rs "$@"
 bin/build-py
+bin/build-js

bin/build-js

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -euo pipefail
+cd "$(dirname "${BASH_SOURCE[0]}")/../src/ascend_tools/ascend-tools-js"
+npm run build

bin/check

@@ -5,5 +5,6 @@ cd "$(dirname "${BASH_SOURCE[0]}")/.."
 bin/check-version
 bin/check-rs
 bin/check-py
+bin/check-js
 
 echo "All checks passed!"

bin/check-js

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+set -euo pipefail
+cd "$(dirname "${BASH_SOURCE[0]}")/../src/ascend_tools/ascend-tools-js"
+npm run build
+npm test

bin/preview

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+set -euo pipefail
+cd "$(dirname "${BASH_SOURCE[0]}")/../tests/app"
+
+npm install --silent
+node server.js &
+SERVER_PID=$!
+
+trap "kill $SERVER_PID 2>/dev/null" EXIT
+
+# wait for server to be ready
+for i in {1..20}; do
+  curl -sf http://localhost:3000 >/dev/null 2>&1 && break
+  sleep 0.25
+done
+
+open http://localhost:3000
+echo "Demo app running at http://localhost:3000 (pid $SERVER_PID)"
+echo "Press Ctrl-C to stop."
+wait $SERVER_PID

bin/setup

@@ -12,4 +12,11 @@ if ! command -v uv &>/dev/null; then
     curl -LsSf https://astral.sh/uv/install.sh | sh
 fi
 
+# Install JS dependencies (napi-rs, ava, typescript)
+if command -v npm &>/dev/null; then
+    cd "$(dirname "${BASH_SOURCE[0]}")/../src/ascend_tools/ascend-tools-js"
+    npm install --no-fund --no-audit
+    cd - >/dev/null
+fi
+
 echo "Setup complete!"

src/ascend_tools/ascend-tools-core/Cargo.toml

@@ -14,6 +14,9 @@ readme = "README.md"
 name = "ascend_tools"
 path = "src/lib.rs"
 
+[features]
+jsts = ["dep:napi-derive", "dep:napi"]
+
 [dependencies]
 ureq = { version = "3", features = ["platform-verifier"] }
 serde = { version = "1", features = ["derive"] }
@@ -23,6 +26,8 @@ base64 = "0.22"
 percent-encoding = "2"
 thiserror = "2"
 zeroize = "1"
+napi = { version = "3", default-features = false, features = ["napi9", "serde-json"], optional = true }
+napi-derive = { version = "3", features = ["type-def"], optional = true }
 
 [dev-dependencies]
 mockito = "1"

src/ascend_tools/ascend-tools-core/src/lib.rs

@@ -1,4 +1,8 @@
-#![forbid(unsafe_code)]
+// When jsts feature is enabled, napi-derive macros may generate code with
+// #[allow(unsafe_code)] internally, so we use deny instead of forbid.
+// No unsafe code exists in this crate; all FFI is isolated to ascend-tools-js.
+#![cfg_attr(not(feature = "jsts"), forbid(unsafe_code))]
+#![cfg_attr(feature = "jsts", deny(unsafe_code))]
 
 pub mod auth;
 pub mod client;

src/ascend_tools/ascend-tools-core/src/models.rs

@@ -5,6 +5,7 @@ use serde::{Deserialize, Serialize};
 
 /// The kind of runtime (workspace or deployment).
 #[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
+#[cfg_attr(feature = "jsts", napi_derive::napi(string_enum = "lowercase"))]
 #[serde(rename_all = "lowercase")]
 pub enum RuntimeKind {
     Workspace,
@@ -47,6 +48,7 @@ pub struct Project {
 /// A workspace or deployment. Use the [`Workspace`] or [`Deployment`] type aliases
 /// for clarity when the kind is known.
 #[derive(Debug, Clone, Serialize, Deserialize)]
+#[cfg_attr(feature = "jsts", napi_derive::napi(object))]
 pub struct Runtime {
     pub uuid: String,
     pub id: String,
@@ -109,11 +111,13 @@ impl From<Runtime> for Deployment {
 }
 
 #[derive(Debug, Clone, Serialize, Deserialize)]
+#[cfg_attr(feature = "jsts", napi_derive::napi(object))]
 pub struct Flow {
     pub name: String,
 }
 
 #[derive(Debug, Clone, Serialize, Deserialize)]
+#[cfg_attr(feature = "jsts", napi_derive::napi(object))]
 pub struct FlowRun {
     pub name: String,
     pub flow: String,
@@ -126,13 +130,15 @@ pub struct FlowRun {
 
 /// Wrapper returned by the list flow runs endpoint.
 #[derive(Debug, Clone, Serialize, Deserialize)]
+#[cfg_attr(feature = "jsts", napi_derive::napi(object))]
 pub struct FlowRunList {
     pub items: Vec<FlowRun>,
     #[serde(default)]
     pub truncated: bool,
 }
 
 #[derive(Debug, Clone, Serialize, Deserialize)]
+#[cfg_attr(feature = "jsts", napi_derive::napi(object))]
 pub struct FlowRunTrigger {
     pub event_uuid: String,
     pub event_type: String,

src/ascend_tools/ascend-tools-js/.gitignore

@@ -0,0 +1,6 @@
+target/
+node_modules/
+*.node
+index.js
+index.d.ts
+index.d.cts