SpacetimeDB

mirror of https://github.com/clockworklabs/SpacetimeDB.git synced 2026-05-06 23:59:43 -04:00

Files

T

History

Luke c7af2d4cd3 Deprecate ReducerContext::identity in favor of database_identity (#4843 )

## Summary
- add `ReducerContext::database_identity()` in Rust bindings
- deprecate `ReducerContext::identity()` and keep it as a compatibility
alias
- update reducer docs example to use `ctx.database_identity()`
- add C# reducer-context equivalent: `DatabaseIdentity` and obsolete
`Identity` alias
- update Rust/C# module test callsites to the new API name
- update C# codegen snapshots for generated `ReducerContext` API output

## Why
Issue #3201 reports user confusion between reducer `ctx.identity()`
(database/module identity) and `ctx.sender`. This change clarifies
naming while preserving compatibility.

## Validation
- `cargo check -p spacetimedb -p module-test` (Passed)
- `dotnet test crates/bindings-csharp/Codegen.Tests/Codegen.Tests.csproj
--nologo` (Passed)
- `dotnet test crates/bindings-csharp/Runtime.Tests/Runtime.Tests.csproj
--nologo` (Failed) pre-existing unrelated failure:
- `Runtime.Tests/JwtClaimsTest.cs(10,23): CS1729: 'JwtClaims' does not
contain a constructor that takes 2 arguments`

## Compatibility
- Rust: `identity()` still works but is deprecated in favor of
`database_identity()`.
- C#: `Identity` still works but is marked `[Obsolete]` in favor of
`DatabaseIdentity`.

Closes #3201

2026-05-04 19:50:39 +00:00

Codegen.csproj

Version bump 2.2.0 (#4916 )

2026-04-30 19:24:41 +00:00

Diag.cs

[C#] Add support for IEnumerable<T> for Views' return types (#4486 )

2026-03-23 23:20:46 +00:00

Module.cs

Deprecate ReducerContext::identity in favor of database_identity (#4843 )

2026-05-04 19:50:39 +00:00

README.md

Add internal docs for C# bindings packages (#2938 )

2026-04-15 14:16:43 +00:00

README.md

⚠️ Internal Project ⚠️

This project is intended for internal use only. It is not stable and may change without notice.

See the C# module library reference for stable, user-facing documentation.

Internal documentation

This project contains Roslyn incremental source generators that augment tables and reducers with static methods for self-describing and registration.

SpacetimeDB modules are compiled to WebAssembly modules that expose a specific interface; see the module ABI reference. This interface is implemented in the generated FFI class; see ../Codegen.Tests/fixtures/server/snapshots/Module#FFI.verified.cs for an example of what this generated code looks like.

The source generators are implemented via several attributes usable in module code:

[SpacetimeDB.Table] - generates code to register this table in the FFI upon startup so that they can be enumerated by the __describe_module__ FFI API. It implies [SpacetimeDB.Type], so you must not specify both attributes on the same struct.
[SpacetimeDB.Reducer] - generates code to register a static function as a SpacetimeDB reducer in the FFI upon startup and creates a wrapper that will parse SATS binary blob into individual arguments and invoke the underlying function for the __call_reducer__ FFI API.