Module unit testing

[jsdt]

Description of Changes

Adds unit testing support for SpacetimeDB module code in Rust and TypeScript.

The main work here is adding a test datastore API for use in these unit tests. There are some new feature gates added for this, which are described below.

Module Unit Test APIs

• Adds spacetimedb::test_utils for Rust module tests, including TestContext, TestAuth, reducer transactions, procedure/view contexts, typed queries, test clock/RNG helpers, and HTTP/sleep hooks.
• Adds TypeScript server test utilities under spacetimedb/server/test-utils, with Vitest and WASM runtime helpers.
• Refactors generated/runtime hooks so Rust and TypeScript module code can run against an in-memory test datastore instead of host syscalls.

Portable Datastore

• Adds spacetimedb-test-datastore, a native in-memory datastore wrapper for Rust module tests.
• Adds spacetimedb-portable-datastore, a WASM-compatible in-memory datastore initialized from a module definition.
• Adds spacetimedb-portable-datastore-wasm, a thin wasm-bindgen adapter used by the TypeScript test runtime.
• Splits spacetimedb-datastore behind feature gates so portable builds can avoid server-only dependencies:
  • durability: commitlog, snapshot, durability, and path-dependent code.
  • execution: execution-plan-aware transaction/query behavior.
  • metrics: Prometheus/SpacetimeDB metrics plumbing.
  • portable: minimal datastore surface needed by the portable test datastore.
• Adds wasm32-unknown-unknown guards, including portable time handling where std::time::Instant::now() is unavailable.

Test Datastore ABI

For Rust module tests, look at:

• crates/bindings/src/test_utils.rs
• crates/test-datastore/src/lib.rs
• crates/bindings/src/table.rs

For TypeScript module tests, look at:

• crates/portable-datastore-wasm/src/lib.rs for the wasm-bindgen ABI.
• crates/bindings-typescript/src/server/test-utils/wasm.ts for the TypeScript-side ABI interface.
• crates/bindings-typescript/src/server/test-utils/backend.ts and crates/bindings-typescript/src/server/backend.ts for the DatastoreBackend bridge.

Example Usage

Examples are included in the updated chat templates (though I need to either remove these or replace them with tests that are actually meaningful for the templates):

• Rust: templates/chat-console-rs/spacetimedb/src/lib.rs

  • TestContext::new()
  • with_reducer_tx
  • TestAuth::from_jwt_payload
  • procedure_context
  • run_query
  • mocked procedure HTTP

• TypeScript: templates/chat-react-ts/spacetimedb/src/index.test.ts

  • createModuleTestHarness(spacetime, moduleExports)
  • test.withReducerTx
  • test.procedureContext
  • test.viewContext
  • test.runQuery

For exhaustive coverage, see:

• crates/bindings/tests/test_utils.rs
• crates/bindings-typescript/tests/server_test_utils_wasm.test.ts

Testing

New test coverage added in this branch:

• Rust module unit-test API coverage in crates/bindings/tests/test_utils.rs
• Native test datastore coverage in crates/test-datastore/src/lib.rs
• Portable datastore coverage in crates/portable-datastore/src/lib.rs
• TypeScript/WASM module test harness coverage in crates/bindings-typescript/tests/server_test_utils_wasm.test.ts
• TypeScript WASM adapter coverage in crates/bindings-typescript/tests/server_test_utils_wasm_adapter.test.ts
• Template example tests in:
  • templates/chat-console-rs/spacetimedb/src/lib.rs
  • templates/chat-react-ts/spacetimedb/src/index.test.ts

Adds cargo ci portable-datastore, wired into GitHub Actions as the portable_datastore job. This checks that the portable datastore path stays buildable for wasm32-unknown-unknown without the normal server-only dependency stack, then runs native portable datastore tests.

Rollback safety impact

n/a

This is generally safe to rollback, but it is adding a new API, so rolling it back after a release would break anyone using the new API (which includes its use in some templates).

[Shubham8287]

It looks good, though tests seems to be failing.

[cloutiertyler]

Code owned files look good to me, except for the things I flagged.