mirror of https://github.com/clockworklabs/SpacetimeDB.git synced 2026-06-27 00:13:33 -04:00

Files

T

History

Jason Larabie 346e2b2514 Add C++ query builder (#4664 )

# Description of Changes
- Added a query builder for C++ module bindings
  - Added query-builder table/filter/join types
- Added semijoin support with compile-time checks for lookup-table and
indexed-field usage
  - Added support for returning query-builder queries from C++ views
- Hooked query-builder metadata into the C++ table/view macros and V10
module-def path
- Added test coverage for the new C++ query-builder behavior
  - Compile tests for pass/fail cases
  - SQL tests for generated query output
  - Added a C++ test module for view primary key coverage
- **Update:** Switched the core to pass the columns and index-columns
metadata with the table source for better client-side codegen to have
some shared code between server + client.
# API and ABI breaking changes
- No intended API or ABI breaking changes
- Adds a new public query-builder API to the C++ bindings
- C++ views can now return query-builder query types in addition to
materialized row results

# Expected complexity level and risk

3 - Mostly contained to C++ bindings, but it touches macros, view
registration/serialization, and module-def generation, so there are a
few places where the pieces need to stay in sync.

# Testing

I've done end to end testing of I think every type as well as built some
tests to confirm the SQL output.

- [x] Run the C++ query-builder SQL tests
[crates/bindings-cpp/tests/query-builder-compile/run_query_builder_compile_tests.sh]
- [x] Smoke test a generated C++ module using query-builder views

---------

Signed-off-by: Jason Larabie <jason@clockworklabs.io>
Co-authored-by: Ryan <r.ekhoff@clockworklabs.io>
Co-authored-by: Zeke Foppa <196249+bfops@users.noreply.github.com>

2026-06-12 13:02:36 +00:00

src

Add C++ query builder (#4664 )

2026-06-12 13:02:36 +00:00

.gitignore

Add C++ query builder (#4664 )

2026-06-12 13:02:36 +00:00

CMakeLists.txt

Add C++ query builder (#4664 )

2026-06-12 13:02:36 +00:00

compile.bat

Add C++ query builder (#4664 )

2026-06-12 13:02:36 +00:00

README.md

Add C++ query builder (#4664 )

2026-06-12 13:02:36 +00:00

README.md

sdk-test-view-pk-cpp

C++ implementation of the SpacetimeDB query-builder view PK test module. This mirrors the Rust sdk-test-view-pk and C# sdk-test-view-pk-cs modules.

Coverage

query-returning views over base tables
PK-preserving query views
right semijoins from indexed membership tables to player rows

Views

all_view_pk_players
sender_view_pk_players_a
sender_view_pk_players_b

Build

.\modules\sdk-test-view-pk-cpp\compile.bat

The output will be modules/sdk-test-view-pk-cpp/build/lib.wasm.