Node.js 整合

包邊界#

受支援的 npm 名字是 @wa120/ait-native。它帶的是可移植的 JavaScript 和 TypeScript 門面層，並挑出確切的 1.1.1 平臺 Node-API addon。

npm install @wa120/ait-native@1.1.1

這個包不打包也不啟動 ait-server。它的 API 直接載入包自帶的 addon，不拿子程序當繫結的傳輸通道。

直接呼叫 API#

import { NativeRuntime } from "@wa120/ait-native";

const ait = new NativeRuntime();
console.log(ait.bindingInfo());
const status = ait.runCli(["status", "--json"]);
console.log(status);

包裡帶的 ait 命令，在行程內調的是同一個原生繫結。所以 JavaScript API 和這個命令共享同一套已接納的 Rust 行為。

儲存庫工作流程#

Node.js 儲存庫的初始化方式和生成出來的儲存庫說明，跟其他受支援的儲存庫 完全一樣。

npx --no-install ait init
npx --no-install ait status --json

AIT 不會去翻 package.json 來挑測試命令或者判斷框架行為。要驗證 什麼，仍然由儲存庫自己明確說清楚。

平臺包#

按目標平臺拆出來的 addon 包，是鎖定版本的實作依賴，不是單獨的產品。 應用應該依賴頂層那個受支援的包，讓 npm 的常規解析去選出匹配的 addon。