feat: port Rust core runtime

.github/workflows/host-packages.yml

@@ -0,0 +1,95 @@
+name: host-packages
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'js/packages/truapi-host-wasm/**'
+      - 'android/**'
+      - 'ios/**'
+      - 'rust/crates/truapi-server/**'
+      - 'rust/crates/truapi-platform/**'
+      - 'rust/crates/truapi-codegen/**'
+      - 'rust/crates/truapi-macros/**'
+      - 'rust/crates/truapi/**'
+  pull_request:
+    paths:
+      - 'js/packages/truapi-host-wasm/**'
+      - 'android/**'
+      - 'ios/**'
+      - 'rust/crates/truapi-server/**'
+      - 'rust/crates/truapi-platform/**'
+      - 'rust/crates/truapi-codegen/**'
+      - 'rust/crates/truapi-macros/**'
+      - 'rust/crates/truapi/**'
+
+jobs:
+  wasm-bundle-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: wasm32-unknown-unknown
+      - uses: actions/setup-node@v4
+        with: { node-version: 22 }
+      - name: Install wasm-pack
+        run: cargo install wasm-pack
+      # Rebuilds the bundle from the current truapi-server source and runs the
+      # truapi-host-wasm node smoke test against those freshly-built artifacts, so a
+      # stale committed bundle cannot pass green. Byte-equality against the
+      # committed bundle is intentionally not asserted: wasm-pack output varies
+      # with the Rust toolchain and wasm-bindgen version, so cross-machine
+      # reproducibility is not achievable. The committed artifacts under
+      # js/packages/truapi-host-wasm/dist/wasm/ serve as a convenience for
+      # consumers that don't run Rust; regenerate locally with `make wasm`
+      # before changing truapi-server source.
+      - name: Rebuild WASM
+        run: make wasm
+      - name: Sanity-check artifact presence
+        run: |
+          test -s js/packages/truapi-host-wasm/dist/wasm/web/truapi_server_bg.wasm
+          test -s js/packages/truapi-host-wasm/dist/wasm/web/truapi_server.js
+          test -s js/packages/truapi-host-wasm/dist/wasm/node/truapi_server_bg.wasm
+          test -s js/packages/truapi-host-wasm/dist/wasm/node/truapi_server.js
+      - name: Build @parity/truapi-host (dep)
+        run: cd js/packages/truapi-host && npm install --no-fund --no-audit && npm run build
+      - name: Build @parity/truapi client (dep)
+        run: cd js/packages/truapi && npm install --no-fund --no-audit && npm run build
+      - name: Test @parity/truapi-host-wasm against the rebuilt bundle
+        run: cd js/packages/truapi-host-wasm && npm install --no-fund --no-audit && npm test
+  host-packages-js-tests:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: 22 }
+      - name: Build @parity/truapi-host (dep)
+        run: cd js/packages/truapi-host && npm install --no-fund --no-audit && npm run build
+      - name: Build @parity/truapi client (dep)
+        run: cd js/packages/truapi && npm install --no-fund --no-audit && npm run build
+      - name: Test @parity/truapi-host-wasm
+        run: cd js/packages/truapi-host-wasm && npm install --no-fund --no-audit && npm test
+  android-assemble:
+    # Smoke-builds the Android library + verifies the Maven publication
+    # can be assembled (writes to maven-local). No release happens here;
+    # distribution is via JitPack, which builds tagged commits per
+    # jitpack.yml and serves the io.parity:truapi-host-android artifact.
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: 17
+      - uses: gradle/actions/setup-gradle@v4
+      - name: Assemble truapi-host-android (release)
+        run: gradle :truapi-host:assembleRelease --no-daemon --stacktrace
+      - name: Build Maven publication into local repo
+        run: gradle :truapi-host:publishReleasePublicationToMavenLocal --no-daemon --stacktrace
+      - name: Sanity-check published artifacts
+        run: |
+          set -eux
+          base="$HOME/.m2/repository/io/parity/truapi-host-android/0.1.0"
+          test -s "$base/truapi-host-android-0.1.0.aar"
+          test -s "$base/truapi-host-android-0.1.0.pom"
+          test -s "$base/truapi-host-android-0.1.0-sources.jar"

.gitignore

@@ -11,6 +11,12 @@ lerna-debug.log*
 node_modules
 target
 
+# Gradle (Android workspace at repo root)
+/.gradle/
+/build/
+/android/*/build/
+local.properties
+
 # Editor / OS
 .vscode/*
 !.vscode/extensions.json

CLAUDE.md

@@ -8,17 +8,48 @@ This repo is the single source of truth for the TrUAPI protocol. It vendors `dot
 
 ```
 rust/crates/
-  truapi/                Rust trait + type definitions for protocol versions v0.1 and v0.2
+  truapi/                Rust trait + type definitions for protocol versions v0.1 and v0.2 (canonical)
   truapi-codegen/        rustdoc JSON → TypeScript client + Rust dispatcher
   truapi-macros/         #[wire(id = N)] proc-macro
+  truapi-platform/       Host syscall traits (storage, navigation, consent, ...)
+  truapi-server/         Rust runtime hosts implement; ships as WASM (browser/node) and via UniFFI (iOS/Android)
+  uniffi-bindgen-cli/    Thin CLI wrapper around uniffi::uniffi_bindgen_main()
 js/packages/
-  truapi/         @parity/truapi TS package; generated TS lives under ignored paths
-playground/              Next.js interactive playground; deploys to truapi-playground.dot
-hosts/dotli/             dotli submodule
-docs/                    design docs, RFCs, feature proposals
-scripts/codegen.sh       regenerate the TS client from the Rust crate
+  truapi/                  @parity/truapi TS package; generated TS lives under ignored paths
+  truapi-host/             @parity/truapi-host host-side codegen + dispatcher (no shared core)
+  truapi-host-wasm/        @parity/truapi-host-wasm: WASM-backed host runtime. Subpath entries:
+                           `.` (core Provider + dispatcher + node runtime), `/web` (iframe + Web
+                           Worker), `/electron` (MessagePortMain), `/worker-runtime` (Worker entry).
+                           Pre-built WASM under dist/wasm/{web,node}/
+android/
+  truapi-host/             io.parity:truapi-host-android Maven library (AAR + UniFFI Kotlin bindings)
+ios/
+  truapi-host/             TrUAPIHost Swift Package (sources + UniFFI Swift bindings)
+playground/                Next.js interactive playground; deploys to truapi-playground.dot
+hosts/dotli/               dotli submodule
+docs/                      design docs, RFCs, feature proposals
+scripts/codegen.sh         regenerate the TS client from the Rust crate
 ```
 
+### Crate + binding invariants
+
+- `truapi` is canonical; runtime crates re-export rather than redefine. New
+  syscall traits and host-side runtime types live in `truapi-platform` and
+  `truapi-server`, not in `truapi`. Any additions to `truapi` itself are limited
+  to additive `Display` impls.
+- All types exposed by `truapi-platform` and `truapi-server` come from
+  `truapi::versioned::*` and `truapi::v01::*`. The runtime crates re-export
+  rather than redefine.
+- Pre-built `truapi-server` WASM artifacts are committed under
+  `js/packages/truapi-host-wasm/dist/wasm/{web,node}/`. Regenerate via
+  `make wasm` whenever `rust/crates/truapi-server/` changes. CI rebuilds the
+  bundle as a smoke check; exact byte-identity isn't enforced because
+  wasm-pack output depends on Rust/wasm-bindgen versions.
+- UniFFI bindings under `android/truapi-host/` and `ios/truapi-host/` are generated from the
+  `truapi-server` cdylib via `make uniffi`. The generated Swift modulemap may
+  need a one-time relocation into `Sources/truapi_serverFFI/include/`, the
+  `make uniffi` target prints a reminder.
+
 ## Code style
 
 - Every `pub` Rust item (functions, methods, types, traits, modules, constants) carries a doc comment (`///` or `//!`).