@miosa/sdk 3.2.4 → 3.3.0

package/native/h3-runner/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Native HTTP/3 addon (napi-rs over quinn + h3). See index.js for the
+ * platform-binary loading strategy and README.md for which platforms
+ * actually have a prebuilt binary today.
+ */
+
+export interface NativeH3Response {
+  status: number;
+  headers: Record<string, string>;
+  body: Buffer;
+}
+
+export interface NativeH3TestServer {
+  handle: number;
+  port: number;
+}
+
+export interface NativeH3Module {
+  available: boolean;
+  platformArchKey: () => string;
+
+  /**
+   * Opens one HTTP/3 connection to address:port with TLS SNI serverName.
+   * Returns an opaque handle for h3Request/h3Close. Rejects if the QUIC
+   * handshake (or h3 setup on top of it) doesn't complete within
+   * connectTimeoutMs.
+   */
+  h3Connect: (
+    address: string,
+    serverName: string,
+    port: number,
+    insecure: boolean,
+    connectTimeoutMs: number,
+  ) => Promise<number>;
+
+  h3Request: (
+    handle: number,
+    method: string,
+    authority: string,
+    path: string,
+    headers: Record<string, string>,
+    body: Buffer | undefined,
+  ) => Promise<NativeH3Response>;
+
+  /** No-op on an already-closed or unknown handle. */
+  h3Close: (handle: number) => Promise<void>;
+
+  /** Test-only: starts a throwaway local HTTP/3 server. */
+  h3TestServerStart: (
+    port: number,
+    serverName: string,
+    responseBody: string,
+    maxRequests: number,
+  ) => Promise<NativeH3TestServer>;
+
+  /** Test-only: awaits the server's own count of requests served. */
+  h3TestServerWait: (handle: number) => Promise<number>;
+}
+
+declare const nativeH3Module: NativeH3Module;
+export = nativeH3Module;

package/native/h3-runner/index.js

@@ -0,0 +1,60 @@
+// Loads the platform-specific prebuilt addon, the same way napi-rs's own
+// generated loaders do: try the matching optional package by name first
+// (what a real npm install resolves), then fall back to the binary
+// sitting right next to this file under npm/<platform>-<arch>/ (what this
+// workspace has today, with only darwin-arm64 actually built - see
+// README.md for the platforms CI still needs to produce).
+//
+// Never throws. `require("./index.js")` returns `null` when nothing
+// loadable is found, so callers (Http3Transport) can treat "no native
+// addon for this platform" exactly like "HTTP/3 unavailable" - the same
+// zero-cost fallback to HTTP/2 as every other unavailability reason.
+
+"use strict";
+
+const path = require("node:path");
+
+function platformArchKey() {
+  const platform = process.platform;
+  const arch = process.arch;
+  if (platform === "linux") {
+    // musl vs glibc matters on Linux; napi-rs convention suffixes it.
+    const isMusl = (() => {
+      try {
+        return !!process.report?.getReport()?.header?.glibcVersionRuntime === false;
+      } catch {
+        return false;
+      }
+    })();
+    return `${platform}-${arch}-${isMusl ? "musl" : "gnu"}`;
+  }
+  if (platform === "win32") return `${platform}-${arch}-msvc`;
+  return `${platform}-${arch}`;
+}
+
+function load() {
+  const key = platformArchKey();
+  const attempts = [
+    () => require(`@miosa/h3-runner-${key}`),
+    () => require(path.join(__dirname, "npm", key, `h3-runner-native.${key}.node`)),
+  ];
+
+  for (const attempt of attempts) {
+    try {
+      return attempt();
+    } catch {
+      // try the next strategy
+    }
+  }
+  return null;
+}
+
+const loaded = load();
+if (loaded) {
+  loaded.platformArchKey = platformArchKey;
+  loaded.available = true;
+  module.exports = loaded;
+} else {
+  module.exports = { platformArchKey, available: false };
+}
+

package/native/h3-runner/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "@miosa/h3-runner-native",
+  "version": "0.1.0",
+  "description": "Native HTTP/3 (quinn + h3) client addon for the SOMA runner transport. Not published independently - consumed by @miosa/sdk's runner module via a relative path.",
+  "license": "MIT",
+  "private": true,
+  "main": "index.js",
+  "types": "index.d.ts"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miosa/sdk",
-  "version": "3.2.4",
+  "version": "3.3.0",
   "description": "TypeScript SDK for the MIOSA API - cloud VM desktop infrastructure for AI agents",
   "license": "MIT",
   "author": "MIOSA <hello@miosa.ai>",
@@ -29,18 +29,12 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "native/h3-runner/package.json",
+    "native/h3-runner/index.js",
+    "native/h3-runner/index.d.ts",
+    "native/h3-runner/npm/*/*.node"
   ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "lint": "eslint src --ext .ts",
-    "clean": "rm -rf dist"
-  },
   "devDependencies": {
     "@types/node": "^20.0.0",
     "@types/ws": "^8.18.1",
@@ -63,5 +57,14 @@
   "overrides": {
     "esbuild": "^0.28.1"
   },
-  "packageManager": "pnpm@9.15.9+sha512.68046141893c66fad01c079231128e9afb89ef87e2691d69e4d40eee228988295fd4682181bae55b58418c3a253bde65a505ec7c5f9403ece5cc3cd37dcf2531"
-}
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src --ext .ts",
+    "clean": "rm -rf dist"
+  }
+}