Commit Graph

3515 Commits

Author SHA1 Message Date
rain 2724c9aea5 docs: fix TypeScript shared table example 2026-06-26 08:10:31 -04:00
rain 8c7e89727e Merge remote-tracking branch 'origin/master' into bot/docs-audit 2026-06-26 08:08:38 -04:00
joshua-spacetime 41d935bb10 Make keynote bench job reusable (#5433)
# Description of Changes

Makes the keynote benchmark job reusable so that it can be invoked and
run in other CI environments.

# API and ABI breaking changes

N/A

# Expected complexity level and risk

2

# Testing

Refactor. Relies on existing coverage.
2026-06-25 13:52:29 +00:00
rain 408d421046 docs: fix Unreal FAQ links 2026-06-25 08:10:05 -04:00
rain ed140dee34 docs: fix TypeScript codegen table accessor example 2026-06-24 08:10:31 -04:00
rain e083393ebf Merge remote-tracking branch 'origin/master' into bot/docs-audit 2026-06-24 08:08:43 -04:00
joshua-spacetime 796f3da099 Track more snapshot metrics on startup (#5436)
# Description of Changes

Specifically:
- The number of objects read during replay
- The number of bytes read from disk during replay
- The time spent hashing objects during replay

# API and ABI breaking changes

Not considered breaking, but this patch does add a new label to a
pre-existing metric `spacetime_replay_snapshot_read_time_seconds`.

# Expected complexity level and risk

1.5

# Testing

Updates a pre-existing test
2026-06-24 10:00:34 +00:00
joshua-spacetime 963bec1d6f Remove spacetimedb-jsonwebtoken and spacetimedb-jwks dependencies (#5427)
# Description of Changes

Uses `jsonwebtoken v10.4.0` instead. Important changes include:

**1. Token serialization**
Old tokens with `"exp": null` are still accepted, but new no-expiry
tokens now omit `exp` instead of serializing it as `"exp": null`.

**2. OIDC/JWKS validation**
Issuer extraction now uses `jsonwebtoken::dangerous::insecure_decode`
for key discovery only, not validation. And the old `spacetimedb-jwks`
crate required every JWK to have a `kid`, but this patch does not
preserve that limitation.

# API and ABI breaking changes

I don't believe this is considered breaking, but it bears repeating that
new no-expiry tokens now serialize without `exp` instead of `"exp":
null`.

# Expected complexity level and risk

2

# Testing

- [x] Verify a legacy no-expiry token serialized as `"exp": null` still
validates.
- [x] Verify a token with an expired `exp` is still rejected.
- [x] Verify OIDC/JWKS validation works when the JWKS keys omit the
optional `kid` field.
2026-06-23 22:56:59 +00:00
Zeke Foppa 2deba158c3 CI - Close some gaps with GitHub discord notifications (#5056)
# Description of Changes

We currently have discord notifications when PRs merge into master. We
have two problems:
1. These notifications don't run properly for external PRs (due to
missing secrets)
2. We don't get notifications for other pushes to master

This PR fixes those issues by changing the job to run on any push to
master rather than when a PR is closed.

# API and ABI breaking changes

None. CI only.

# Expected complexity level and risk

1

# Testing

I don't think we can test this without merging into master.

---------

Co-authored-by: Zeke Foppa <bfops@users.noreply.github.com>
2026-06-23 19:56:00 +00:00
Kris Jenkins 13a50efc37 Fix one-column prefix scan on a multi-column index (#5428)
# Description of Changes

Fixes #5407.

A one-column prefix scan on a multi-column btree index — e.g.
`filter(1n)` on a
`[u64, string]` index — panicked at runtime with `TypeError:
serializeTerm is
not a function` inside `serializeRange`.

A bare scalar (or bare `Range`) has no `.length`, so in the multi-column
`filter`/`delete` accessor `range.length === numColumns` was `undefined
=== 2`
(falling into the range-scan branch), and inside `serializeRange`:

- `prefix_elems = range.length - 1` → `NaN` (prefix loop skipped),
- `serializeTerm = indexSerializers[range.length - 1]` →
`indexSerializers[NaN]`
  → `undefined`,
- `serializeTerm(writer, term)` → **`TypeError: serializeTerm is not a
function`**.

A bare scalar is the only *type-valid* way to express a one-column
prefix on a
multi-column index — `filter([1n])` is rejected by the generated types
and
`filter([1n, "x"])` is the full key — so there was previously **no**
working way
to do a one-column prefix scan.

The fix normalizes a non-array `range` to a single-element array at the
top of
the multi-column `filter`/`delete` before reading `.length`, so a bare
scalar or
`Range` is treated as a one-column prefix and takes the range-scan
branch
correctly. The full two-column key path is unchanged and still takes the
point-scan branch.

To regression-test the pure-JS index accessor under vitest,
`makeTableView` is
now exported from `src/server/runtime.ts` (it is **not** re-exported
from any
public entry point), the host-injected `spacetime:sys@*` virtual modules
are
stubbed, and aliased in `vitest.config.ts`.

# API and ABI breaking changes

None. `makeTableView` is newly exported from `src/server/runtime.ts` but
is not
re-exported from any public entry point. The host ABI is unchanged.

# Expected complexity level and risk

1 — a one-line input normalization on each of `filter`/`delete`, plus
test-only
scaffolding. No change to the full-key path or the host syscall
arguments.

# Testing

- [x] `npx vitest run tests/index_prefix_filter.test.ts` — bare scalar,
bare
`Range`, full two-column key, and `delete()` all scan without throwing
(4 passed).
- [x] `npx vitest run` — full suite, 223 passed.
- [x] `tsc -p tsconfig.build.json` and `prettier --check` clean.
- [x] Reviewer: confirm the prefix-scan semantics against a real
datastore
  (the unit test uses a stubbed host iterator that yields no rows).
2026-06-23 19:07:11 +00:00
Ludv1gL de4516d0d3 feat: Allow adding unique constraints to existing tables (#4465)
## Summary

Adding `#[unique]` or `#[primary_key]` to an existing column currently
triggers `AutoMigrateError::AddUniqueConstraint`, forcing a full
database clear to apply the schema change. This PR makes it a
non-breaking migration by validating existing data first:

- **If all values are unique**: constraint is added seamlessly
(non-breaking migration)
- **If duplicates exist**: migration fails with a detailed error listing
up to 10 duplicate groups

## Changes

- `auto_migrate.rs`: Replace hard `AddUniqueConstraint` error with
`CheckAddUniqueConstraintValid` precheck + `AddConstraint` migration
step
- `update.rs`: Implement precheck (full table scan, project constrained
columns, count duplicates) and `AddConstraint` step execution
- `relational_db.rs`: Expose `create_constraint()` (counterpart to
existing `drop_constraint()`)
- `traits.rs` / `datastore.rs`: Add `create_constraint_mut_tx` to
`MutTxDatastore` trait
- `mut_tx.rs`: Make `create_constraint` public
- `formatter.rs`: Format the new `AddConstraint` step

## Safety

- **Transaction safety**: Precheck and constraint creation run in the
same `MutTx` — no window for concurrent duplicate inserts
- **Index creation**: `auto_migrate_indexes()` already handles adding
the backing btree index (with `is_unique=true` from the new schema). The
constraint step only adds metadata.
- **Rollback**: If the precheck finds duplicates, the entire migration
aborts before any changes are applied
- **Error quality**: Duplicate error shows table name, column names, and
up to 10 example duplicate values with counts

## Example error output

```
Precheck failed: cannot add unique constraint 'Users_email_key' on table 'Users' column(s) [email]:
3 duplicate group(s) found.
  - String("alice@example.com") appears 2 times
  - String("bob@example.com") appears 3 times
  - String("charlie@example.com") appears 2 times
```

## Test plan

- [x] All 12 `auto_migrate` tests pass
- [x] `cargo check` passes for `spacetimedb-schema` and
`spacetimedb-core`
- [x] Verified the previously-expected `AddUniqueConstraint` error test
is updated
- [x] Manual test: add `#[unique]` to existing column with clean data →
succeeds
- [x] Manual test: add `#[unique]` to existing column with duplicates →
fails with detailed error

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-authored-by: Mazdak Farrokhzad <twingoow@gmail.com>
Co-authored-by: Zeke Foppa <196249+bfops@users.noreply.github.com>
Co-authored-by: clockwork-labs-bot <clockwork-labs-bot@users.noreply.github.com>
2026-06-23 09:17:46 -07:00
joshua-spacetime 544b3d8017 Report module instance memory usage (#5400)
# Description of Changes

In order to be able to suspend databases based on memory usage.

Reports memory usage for wasm linear memory as well as the v8 heap. Also
reports page-level memory for tables.

It does not report memory usage for indexes.

# API and ABI breaking changes

None

# Expected complexity level and risk

1.5

# Testing

Testing added in the private counterpart which handles enforcement of
memory limits.
2026-06-23 15:19:30 +00:00
Jason Larabie 57c845d6a5 Fix Unreal cache desync for overlapping transaction table updates (#5426)
# Description of Changes
- Fixed an Unreal SDK cache bug with overlapping subscriptions on the
same table called out in
[Discord](<https://discordapp.com/channels/1037340874172014652/1507200761900171405>)
from @defohost
- Merged repeated transaction table updates by table name while
preserving all row-set payloads
- Fixes unique-index `Find(...)` returning empty while `Iter()` still
sees the updated row
- Aligned Unreal transaction update handling with the other SDKs
- Applies one accumulated per-table update per transaction instead of
multiple partial passes

# API and ABI breaking changes
- No intended API or ABI breaking changes to released Unreal SDK
behavior

# Expected complexity level and risk

2 - Small transaction update normalization change, risk is preserving
row multiplicity for overlapping
subscriptions

# Testing
What I've done so far:
- [x] Added and ran a throwaway Unreal repro for overlapping identical
subscriptions on one table
- [x] Ran the full `sdk-unreal-test-harness`
- [x] Tested Unreal Blackholio
2026-06-23 14:56:19 +00:00
rain b6b329acd2 docs: fix CLI reset and TypeScript codegen examples 2026-06-23 08:11:15 -04:00
rain 36e070461c Merge remote-tracking branch 'origin/master' into bot/docs-audit 2026-06-23 08:10:20 -04:00
bradleyshep c5317e1052 LLM benchmarks: run weekly LLM benchmarks from website-managed models (#5324)
### Note 1: this requires a website PR to merge
### Note 2: 
I was able to run all workflow smoke tests successfully, including
golden validation and dry-run benchmarks, except for the C# dry-run
benchmark path. C# golden validation passes, but the C# benchmark dry
run still fails intermittently/consistently on the runner despite
several attempts to align its build/publish setup with the known-good
smoketest path.

```
gh workflow run llm-benchmark-periodic.yml `
  --repo ClockworkLabs/SpacetimeDB `
  --ref bradley/fix-validate-goldens-ci `
  -f model_set=explicit `
  -f models="openrouter:openai/gpt-5.4-mini" `
  -f languages=rust,csharp,typescript `
  -f modes=guidelines `
  -f tasks=t_000_empty_reducers `
  -f dry_run=true
```

# Description of Changes

This updates the LLM benchmark automation and runner plumbing.

- Move periodic LLM benchmark and golden validation workflows from
daily/nightly to weekly Monday UTC runs.
- Add manual workflow inputs for benchmark smoke runs:
  - model set: website-managed, local defaults, or explicit models
  - languages, modes, categories, tasks
  - dry-run mode
- Build the local TypeScript SDK before TypeScript benchmark/golden
validation runs.
- Add support for fetching active/available benchmark models from the
website API via `--model-source remote`.
- Keep explicit `--models ...` working for manual/local overrides.
- Add OpenRouter preflight checks before benchmark execution:
  - checks key/account credits when available
  - probes the selected model when credit balance cannot be checked
  - supports `OPENROUTER_ALLOW_UNCHECKED_CREDITS=1` escape hatch
  - supports `OPENROUTER_MIN_CREDITS` / `LLM_MIN_CREDITS`
- Force scheduled benchmark workflow runs through OpenRouter with
`LLM_VENDOR=openrouter`, while preserving direct OpenAI support for
local/manual use.
- Improve benchmark publishing isolation:
  - isolated SpacetimeDB CLI root per publish
  - serialized C# benchmark publish concurrency
  - local NuGet package references for generated C# benchmark projects
  - Windows/PATH handling for TypeScript `pnpm`
- Update default benchmark model routes to current model names/ids.
- Update TypeScript golden answers for current SDK shape.

# API and ABI breaking changes

None.

This adds benchmark-runner/workflow behavior and CLI options, but does
not change SpacetimeDB runtime API or ABI.

# Expected complexity level and risk

3/5

The changes are mostly isolated to the LLM benchmark runner and GitHub
workflows, but the risk is moderate because they touch CI execution
paths, local SDK build assumptions, website-managed model resolution,
OpenRouter routing, and generated module publish behavior across Rust,
C#, and TypeScript.

The most sensitive pieces are:
- GitHub Actions workflow dispatch/manual input behavior.
- Remote model registry parsing from the website.
- C# benchmark publish behavior on the self-hosted runner.

# Testing

- [x] `cargo check -p xtask-llm-benchmark --bin llm_benchmark`
- [x] `cargo test -p xtask-llm-benchmark --bin llm_benchmark`
- [x] `cargo test -p xtask-llm-benchmark
parses_active_available_model_routes`
- [x] Manual GitHub Actions golden validation smoke runs for Rust, C#,
and TypeScript.
- [ ] Run a dry-run periodic benchmark workflow from this branch with
one explicit OpenRouter model, one task, and all languages.
- [ ] Run a website-dispatched dry-run benchmark and verify it sends
`model_set=explicit` plus selected model/task inputs.

---------

Co-authored-by: clockwork-labs-bot <clockwork-labs-bot@clockworklabs.io>
Co-authored-by: clockwork-labs-bot <clockwork-labs-bot@users.noreply.github.com>
2026-06-22 18:11:11 +00:00
Jason Larabie c119aa5dcc Fix Unreal Blackholio tutorial for 2.0 (#5378)
# Description of Changes

Thanks to @lisandroct for calling this miss out, with the update to 2.0
for Unreal I missed cleaning up the Blackholio tutorial from the pinned
1.12 version, this clears that up to work from the latest.

# API and ABI breaking changes

N/A

# Expected complexity level and risk

1 - docs only

# Testing

Double checked all the updated links
2026-06-22 15:16:49 +00:00
clockwork-labs-bot 7b2d64cdf2 docs: consolidate daily docs audit fixes (#5410)
# Description of Changes

- Fix TypeScript connection examples to call `DbConnection.builder()`
without `new` and include `.build()`.
- Document reducer context random APIs across TypeScript, C#, Rust, and
C++.
- Align reducer skill determinism guidance with the documented
context-provided RNG API.
- Consolidates the work from #5403 and #5306 into the single daily docs
audit branch `bot/docs-audit`.

# API and ABI breaking changes

None. Documentation and agent skill guidance only.

# Expected complexity level and risk

1. This is a low-risk docs-only change plus one agent skill wording
update.

# Testing

- [x] `pnpm --dir docs build` passed. Docusaurus emitted the existing
`docusaurus-plugin-llms-txt` warning for `/docs/ask-ai/ask-ai`, then
generated static files successfully.
- [ ] Reviewer can check that the TypeScript connection snippets match
the SDK builder API.
- [ ] Reviewer can check that the reducer context RNG examples match the
supported APIs for each SDK.

---------

Co-authored-by: rain <rain@rain.local>
2026-06-22 14:10:59 +00:00
rain 8adb5fbd99 docs: fix React useSpacetimeDB reference 2026-06-22 08:13:11 -04:00
rain e68cea779d Merge remote-tracking branch 'origin/master' into bot/docs-audit 2026-06-22 08:09:03 -04:00
Ryan a08663c7b9 Version bump 2.7.0 (#5399)
# Description of Changes

<!-- Please describe your change, mention any related tickets, and so on
here. -->

- Bumps version to 2.7.0

# API and ABI breaking changes

<!-- If this is an API or ABI breaking change, please apply the
corresponding GitHub label. -->

None

# Expected complexity level and risk

- 1 - this is just a version bump

<!--
How complicated do you think these changes are? Grade on a scale from 1
to 5,
where 1 is a trivial change, and 5 is a deep-reaching and complex
change.

This complexity rating applies not only to the complexity apparent in
the diff,
but also to its interactions with existing and future code.

If you answered more than a 2, explain what is complex about the PR,
and what other components it interacts with in potentially concerning
ways. -->

# Testing

<!-- Describe any testing you've done, and any testing you'd like your
reviewers to do,
so that you're confident that all the changes work as expected! -->

- [x] Version number is correct (`2.7.0`)
- [x] BSL license file has been updated with the new date and version
number
v2.7.0
2026-06-22 04:08:56 +00:00
rain 473d1364c1 docs: fix init reducer tutorial wording 2026-06-21 13:36:17 -04:00
rain 0ddd2e90e8 Merge remote-tracking branch 'origin/master' into bot/docs-audit 2026-06-21 13:36:17 -04:00
rain ec6ab4965e Merge PR #5419 into daily docs audit 2026-06-20 11:53:44 -04:00
clockwork-labs-bot 353557cede Track outgoing queue disconnects (#5331)
# Description of Changes

Adds a Prometheus counter for client disconnects caused by the outgoing
WebSocket message queue reaching capacity.

The new metric is
`spacetime_client_outgoing_queue_disconnects_total{db=...}`. It
increments only on the `TrySendError::Full` path that kicks a client
after its bounded outgoing queue fills.

# API and ABI breaking changes

None.

# Expected complexity level and risk

1. This is a narrow observability change: one metric definition and one
increment at the existing kick site.

# Testing

- [x] `cargo fmt --all`
- [x] `LC_ALL=en_US.UTF-8 LC_CTYPE=en_US.UTF-8 LANG=en_US.UTF-8 cargo
check -p spacetimedb-core`
- [x] `git diff --check`

Co-authored-by: clockwork-labs-bot <clockwork-labs-bot@users.noreply.github.com>
2026-06-20 13:27:42 +00:00
rain 505d364fe2 docs: fix TypeScript reducer argument examples 2026-06-20 08:15:28 -04:00
Jason Larabie 95e61f415c Unreal SDK query builder (#4810)
# Description of Changes
- Added a client-side query builder for the Unreal SDK
- Added typed query-builder subscriptions for Unreal C++ via
SubscriptionBuilder.AddQuery(...).Subscribe()
- Added generated Blueprint query-builder support with source query
nodes, column nodes, predicates, Where, AddQuery, and Subscribe
- Added Blueprint autocasts at the AddQuery boundary so source-specific
Blueprint queries can connect cleanly into the generic subscription
builder for better devex in Blueprint
- Synced the Unreal query-builder core with the C++ module
implementation
- Updated the copied Unreal core query-builder headers to match the
shared C++
- Moved Unreal-specific literal/type adapters out of the shared core
copy and into Unreal-specific expansion code
- Added Unreal SDK test coverage and documentation for the new
query-builder surface
  - Added new test harnesses to start to match the View/ViewPk tests
- Added documentation for the Unreal query builder
- Refactor generation for modules with more than 255 reducers, required
to get the TestClient back in working order

# API and ABI breaking changes
- No intended API or ABI breaking changes to released Unreal SDK
behavior
- Adds a new public client-side query-builder API to the Unreal SDK for
C++ and Blueprint
  - Raw SQL subscriptions remain available

# Expected complexity level and risk

3 - Adds new query-builder surface with large changes to the code-gen,
the risk here is keeping the C++ module core mirrored to the SDK in the
future

# Testing
What I've done so far:
- [x] Updated and ran the following tests:
  - [x] TestClientEditor
  - [x] TestViewClientEditor
  - [x] TestViewPkClientEditor
- [x] Ran the Unreal harness suites covering the query-builder client
paths
- [x] Verified the generated Unreal query-builder surface in both C++
and Blueprint testing supported fields with a small sample project

Should be done at least once by a reviewer:
- [ ] Re-run the full `sdk-unreal-test-harness` as it's disabled in CI
- [ ] Play with the C++ and Blueprint versions in a small Unreal project

---------

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-19 23:52:02 +00:00
Jason Larabie 47a7794111 Add small module-test* as a compile check for http handlers (#5330)
# Description of Changes

HTTP handlers already have smoketest coverage, but in order to add to
`module-test`s all languages had to have parity as `module-test` has a
check to ensure schemas match.

The existing integration tests using `module-test` load SpacetimeDB in
memory, expanding these tests would require significant and potentially
ugly work to handle hosting for HTTP handlers. Instead, this PR adds
compile-only for each `module-test` with a matching handler + route.

# API and ABI breaking changes

N/A

# Expected complexity level and risk

1 - tiny addition to `module-test` for all languages

# Testing

- [x] `cargo test -p spacetimedb-schema module_test`
- [x] `cargo test -p spacetimedb-testing`
2026-06-19 17:40:34 +00:00
rain 219e88e724 docs: align reducer skill determinism guidance 2026-06-19 12:16:36 -04:00
rain e179d74455 docs: document reducer context random APIs 2026-06-19 12:16:36 -04:00
rain 63f185720b docs: fix TypeScript connection builder examples 2026-06-19 12:16:35 -04:00
Jason Larabie cf73acff92 Add primary keys for C++ procedural views (#5354)
# Description of Changes

Adds primary keys to procedural views in C++. This mirrors the work from
#5111, #5246, and #5327 adding the feature and the docs changes.

# API and ABI breaking changes

None

# Expected complexity level and risk

3

# Testing

- [x] Equivalent tests as were added in #5111 and #5246 for rust,
typescript, and C#
2026-06-18 22:43:51 +00:00
Kilian Strunz d8de4ab980 Allow to use Uuid as literal value in ts Query Builder (#5075)
# Description of Changes

Was forgotten while migrating to the QueryBuilder i suppose.
Closes #5073

Maybe @clockwork-tien could lend a hand again in reviewing? ^^

# API and ABI breaking changes

None
<!-- If this is an API or ABI breaking change, please apply the
corresponding GitHub label. -->

# Expected complexity level and risk

1
<!--
How complicated do you think these changes are? Grade on a scale from 1
to 5,
where 1 is a trivial change, and 5 is a deep-reaching and complex
change.

This complexity rating applies not only to the complexity apparent in
the diff,
but also to its interactions with existing and future code.

If you answered more than a 2, explain what is complex about the PR,
and what other components it interacts with in potentially concerning
ways. -->

# Testing
Works in my project :>
<!-- Describe any testing you've done, and any testing you'd like your
reviewers to do,
so that you're confident that all the changes work as expected! -->

- [x] Type Error goes away when using .eq(uuid)

---------

Co-authored-by: joshua-spacetime <josh@clockworklabs.io>
2026-06-18 19:44:29 +00:00
clockwork-labs-bot e357f5a677 Fix release notification workflow startup (#5394)
# Description of Changes

Fixes the `Release Notifications` workflow startup failure seen in
<https://github.com/clockworklabs/SpacetimeDB/actions/runs/27775721225/workflow>.

The internal announcement job referenced `needs: on-release`, but no
`on-release` job exists in `.github/workflows/tag-release.yml`, so the
workflow failed before scheduling any jobs. This removes the dangling
dependency and gates the internal Discord announcement to real `release`
events so manual `workflow_dispatch` dry runs do not try to send an
internal release announcement using missing release-event fields.

# API and ABI breaking changes

None. This only changes GitHub Actions configuration.

# Expected complexity level and risk

1 - Low complexity. The change is limited to one workflow job
dependency/condition.

# Testing

- [x] Parsed `.github/workflows/tag-release.yml` as YAML.
- [x] Checked that all remaining `needs:` targets in
`.github/workflows/tag-release.yml` refer to existing jobs.
- [x] Ran `git diff --check`.
- [ ] Optional reviewer check: run the workflow manually with the
default dry-run inputs after merge.

---------

Signed-off-by: Zeke Foppa <196249+bfops@users.noreply.github.com>
Co-authored-by: clockwork-labs-bot <clockwork-labs-bot@users.noreply.github.com>
Co-authored-by: Zeke Foppa <196249+bfops@users.noreply.github.com>
2026-06-18 18:36:03 +00:00
Ryan a9629de937 Adds a GitHub automation to send Release Notes to our public Discord (#5383)
# Description of Changes

Creates a new GitHub action that triggers any time a `Release` on the
SpacetimeDB repo changes to the `published` state.
When this triggers, the workflow will take information from that
release, and build a message from it, in the form of:
```
**SpacetimeDB ${RELEASE_TAG}**

View the full release notes:
${RELEASE_URL}

${RELEASE_BODY}
```
And send that message to the SpacetimeDB Public Discord Webhook.

Note: This PR itself does not setup or configure the Discord Webhook,
and relies on the Webhook URL already being available.

# API and ABI breaking changes

No API or ABI changes, this is only related to GitHub tooling.

# Expected complexity level and risk

1 - Low complexity. The only risk is in sending garbage messages to the
Discord URL if this automation is improperly configured.

# Testing

- [X] Ran a local version of similar code to test formatting. No testing
of this GitHub Action has been performed.

---------

Signed-off-by: Ryan <r.ekhoff@clockworklabs.io>
Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
2026-06-18 16:06:30 +00:00
joshua-spacetime 156d515afe Remove Promise.withResolvers and replace with deferred pattern (#5384)
# Description of Changes

Removes all references to `Promise.withResolvers` from the codebase
since it's not supported universally and replaces it with the classic
pre-ES2024 deferred pattern. See #5031 and #5342.

Also adds a lint to avoid re-introducing it in the future.

# API and ABI breaking changes

None

# Expected complexity level and risk

1

# Testing

...
2026-06-18 14:21:12 +00:00
clockwork-labs-bot 1e51e32852 Fast-path no-op merge queue CI (#5381)
# Description of Changes

Adds a merge-queue fast path for CI when the synthetic merge-group
commit has the same tree as the queued PR head.

The new `merge_queue_noop` job parses the PR number from the merge-group
ref, resolves the PR head SHA, and compares that tree to `GITHUB_SHA`.
If there is no diff, the expensive CI jobs are skipped as duplicate
work. Matrix jobs with required per-matrix check names get lightweight
no-op counterparts so branch protection still sees the expected
successful check names.

# API and ABI breaking changes

None.

# Expected complexity level and risk

2. This is limited to GitHub Actions wiring, but it interacts with merge
queue semantics and required check names. The implementation
intentionally falls back to normal CI if it cannot parse the PR number
or resolve the PR head.

# Testing

- [x] Parsed `.github/workflows/ci.yml` with Ruby YAML.
- [x] Ran `git diff --check`.

---------

Signed-off-by: Zeke Foppa <196249+bfops@users.noreply.github.com>
Co-authored-by: clockwork-labs-bot <clockwork-labs-bot@users.noreply.github.com>
Co-authored-by: Zeke Foppa <196249+bfops@users.noreply.github.com>
2026-06-18 00:58:27 +00:00
clockwork-labs-bot f24e9615ec Refactor smoketest publish and subscribe helpers to builder pattern (#5283)
# Description of Changes

Refactors the Rust smoketest helper surface so publish and subscribe
variants use builders instead of parallel helper methods.

- Replaces `publish_module*` helper variants with `Smoketest::publish()`
and fluent options for name, clear, current database, break clients,
stdin, replicas, organization, and source modules.
- Replaces `subscribe_*` / `subscribe_background*` variants with
`Smoketest::subscribe(...).expect_rows(...).confirmed(...).background()`.
- Updates smoketest call sites to the builder APIs.

# API and ABI breaking changes

Internal smoketest helper API change only. No product API or ABI
changes.

# Expected complexity level and risk

2

This touches many smoketest call sites, but the underlying CLI command
behavior remains centralized in the same helper internals.

# Testing
- [x] Existing CI passes

---------

Signed-off-by: Zeke Foppa <196249+bfops@users.noreply.github.com>
Co-authored-by: clockwork-labs-bot <clockwork-labs-bot@users.noreply.github.com>
Co-authored-by: Zeke Foppa <bfops@users.noreply.github.com>
Co-authored-by: Zeke Foppa <196249+bfops@users.noreply.github.com>
2026-06-17 15:16:17 +00:00
joshua-spacetime 1747ca6c3d Use the normal shutdown path for the standalone integration tests (#5350)
# Description of Changes

This is an attempt at fixing a SIGABRT that sometimes happens when
running the standalone integration tests.

It's not clear exactly what causes it, however one thing that may have
contributed to it was that previously the tests did not initiate a clean
shutdown of the database.

Some modules schedule repeating work in `init`, and it's not obvious to
me that in flight operations will exit cleanly if we just drop all of
the database/runtime handles at once.

# API and ABI breaking changes

N/A

# Expected complexity level and risk

1

# Testing

This is a testing fix.
2026-06-17 14:53:12 +00:00
clockwork-tien 695b97827d spacetime init --template without arg prints template list and link to website (#5264)
# Description of Changes
- spacetime init --template without arg prints templates list and link
to website

# Screenshot
<img width="696" height="392" alt="screenshot"
src="https://github.com/user-attachments/assets/98e87537-554b-411b-96ab-3ceb9a6a9d45"
/>

<!-- Please describe your change, mention any related tickets, and so on
here. -->

# API and ABI breaking changes

<!-- If this is an API or ABI breaking change, please apply the
corresponding GitHub label. -->

# Expected complexity level and risk
1

<!--
How complicated do you think these changes are? Grade on a scale from 1
to 5,
where 1 is a trivial change, and 5 is a deep-reaching and complex
change.

This complexity rating applies not only to the complexity apparent in
the diff,
but also to its interactions with existing and future code.

If you answered more than a 2, explain what is complex about the PR,
and what other components it interacts with in potentially concerning
ways. -->

# Testing

<!-- Describe any testing you've done, and any testing you'd like your
reviewers to do,
so that you're confident that all the changes work as expected! -->

- [x] I tested the changes
2026-06-17 10:21:32 +00:00
Kilian Strunz 3ec168d146 [Procedures] Fix Identityand ConnectionId Regression (#5323)
# Description of Changes

Closes #5250

#4636 introduced a regression where the ProcedureContext used to include
the sender and connection_id from the caller while now it is always
empty (which is wrong)

Correct it.

Also fully migrate to `database_identity` which was forgotten about so i
deprecated it for procedures (since they are now stable) and just
changed it for HttpHandlers (because they are still unstable)

@gefjon since you did the lil woopsie (ugh pinging you again lol hope im
not annoying haha)

# API and ABI breaking changes

Breaking the HttpHandler function which is unstable.

Restoring behaviour of 2.3 which got lost with 2.4.
<!-- If this is an API or ABI breaking change, please apply the
corresponding GitHub label. -->

# Expected complexity level and risk

1. Trivial refactoring 
<!--
How complicated do you think these changes are? Grade on a scale from 1
to 5,
where 1 is a trivial change, and 5 is a deep-reaching and complex
change.

This complexity rating applies not only to the complexity apparent in
the diff,
but also to its interactions with existing and future code.

If you answered more than a 2, explain what is complex about the PR,
and what other components it interacts with in potentially concerning
ways. -->

# Testing

<!-- Describe any testing you've done, and any testing you'd like your
reviewers to do,
so that you're confident that all the changes work as expected! -->

- [x] The caller identity is there again for Procedures.

---------

Signed-off-by: Zeke Foppa <196249+bfops@users.noreply.github.com>
Co-authored-by: joshua-spacetime <josh@clockworklabs.io>
Co-authored-by: Zeke Foppa <196249+bfops@users.noreply.github.com>
2026-06-17 04:00:55 +00:00
joshua-spacetime 5ea558ed1b Drop tps threshold in keynote bench (#5360)
# Description of Changes

Reviewing recent benchmark runs, it appears that #5071 probably
regressed TPS by around 3-5%. I don't want to revert that change because
it has implications for replication, and so for now we'll just live with
the slight regression.

# API and ABI breaking changes

None

# Expected complexity level and risk

0

# Testing

N/A
2026-06-17 03:34:17 +00:00
joshua-spacetime b929eb5ef6 Skip bsatn decode proptest (#5361)
# Description of Changes

Attempted to fix this test in #5343, but we're still getting SIGKILLS,
so ignoring for now. This will require more investigation to fix. I've
included what I believe is the reason in the help text and created
[this](#5362) tracker to unskip.

# API and ABI breaking changes

None

# Expected complexity level and risk

0

# Testing

N/A
2026-06-17 02:45:35 +00:00
clockwork-labs-bot f8ccbbed7a Re-land spacetime lock/unlock to prevent accidental database deletion (#4888)
Re-lands #4502 on current `master` after the revert in #4881.

## Summary
- restore `spacetime lock` / `spacetime unlock`
- block deleting locked databases
- restore the database-lock smoketests

## Validation
- `cargo fmt --all --check`
- `cargo check -p spacetimedb-cli -p spacetimedb-client-api -p
spacetimedb-standalone`

---------

Co-authored-by: clockwork-labs-bot <clockwork-labs-bot@users.noreply.github.com>
Co-authored-by: Tyler Cloutier <cloutiertyler@aol.com>
Co-authored-by: Tyler Cloutier <cloutiertyler@users.noreply.github.com>
Co-authored-by: Zeke Foppa <bfops@users.noreply.github.com>
2026-06-17 01:15:05 +00:00
joshua-spacetime fc47257d85 Use SpacetimeDBGuard for SDK test suite (#5340)
# Description of Changes

Use an isolated server process per SDK test instead of a single process
for all of the tests. In addition to reducing the memory footprint of
each test run, this should also allow for more parallelism among the
individual tests.

# API and ABI breaking changes

None

# Expected complexity level and risk

1.5

# Testing

The SDK test suite should continue to work
2026-06-17 00:16:10 +00:00
Kris Jenkins b85f7786d6 Use non-deprecated databaseIdentity accessor in docs reference tables (#5321)
# API and ABI breaking changes

None. Docs-only change.

# Expected complexity level and risk

1 - trivial documentation fix, no code or behaviour change.

# Testing

- [x] Confirmed accessor names against the SDK source:
`database_identity()` (Rust/C++), `databaseIdentity` (TS),
`DatabaseIdentity` (C#); the old forms are marked deprecated/obsolete in
bindings.

# Description of Changes

<!-- Please describe your change, mention any related tickets, and so on
here. -->

The reducer-context cheat-sheet and the "Context Properties Reference"
tables still listed `ctx.identity` / `ctx.identity()` as the accessor
for the module's own identity. That accessor was deprecated in favour of
`databaseIdentity` / `database_identity()` / `DatabaseIdentity`, and the
troubleshooting guide added in c70d00246 (#5142) documented the
deprecation but missed updating these other references — these stray
updates should have landed there. This brings all four language tabs in
line with the non-deprecated accessor.

Co-authored-by: Zeke Foppa <196249+bfops@users.noreply.github.com>
2026-06-16 21:11:15 +00:00
clockwork-labs-bot 59b5d49ba2 Fix Internal Tests paths filter checkout (#5295)
## What changed

Adds an explicit checkout step before `dorny/paths-filter` in the
Internal Tests workflow.

## Why

`dorny/paths-filter@v3` needs a git working tree for `push` events. The
Internal Tests workflow ran it before any checkout, so every `push` run
on `master` failed immediately in `Detect non-docs changes` with:

```text
fatal: not a git repository (or any of the parent directories): .git
```

This only showed up consistently on `master` because those runs are
`push` events. On `pull_request` events, `dorny/paths-filter` can use
the GitHub pull request files API with the PR number, so it does not
need a local checkout for the same file detection path.

Adding checkout gives the action a repository when it handles `push`
events, while leaving PR behavior unchanged.

## Testing

- `git diff --check`
- PR #5295 `Internal Tests` job completed `Checkout` and `Detect
non-docs changes` successfully, then moved on to private dispatch/wait.

---------

Signed-off-by: Zeke Foppa <196249+bfops@users.noreply.github.com>
Co-authored-by: clockwork-labs-bot <clockwork-labs-bot@users.noreply.github.com>
Co-authored-by: Zeke Foppa <196249+bfops@users.noreply.github.com>
2026-06-16 20:14:16 +00:00
John Detter fc2f7614bb Remove unused docker workflow (#5349)
# Description of Changes

<!-- Please describe your change, mention any related tickets, and so on
here. -->

We believe this docker build is completely unused. This docker container
is different than the docker build that we send out for releases which
is the one users actually end up using. This specific docker build used
to be for internal deploys but we have not used it in a very long time
now, probably more than a year or two.

# API and ABI breaking changes

None - this is just a CI change.

<!-- If this is an API or ABI breaking change, please apply the
corresponding GitHub label. -->

# Expected complexity level and risk

1 - just a CI change

<!--
How complicated do you think these changes are? Grade on a scale from 1
to 5,
where 1 is a trivial change, and 5 is a deep-reaching and complex
change.

This complexity rating applies not only to the complexity apparent in
the diff,
but also to its interactions with existing and future code.

If you answered more than a 2, explain what is complex about the PR,
and what other components it interacts with in potentially concerning
ways. -->

# Testing

<!-- Describe any testing you've done, and any testing you'd like your
reviewers to do,
so that you're confident that all the changes work as expected! -->

- Not tested but we sync'd on this in the discord and there were no
objections from the devops team or @joshua-spacetime .

---------

Co-authored-by: Zeke Foppa <196249+bfops@users.noreply.github.com>
2026-06-16 19:57:33 +00:00
John Detter ab280222fa Remove spacetimedb-update test on aarch64 (#5348)
# Description of Changes

<!-- Please describe your change, mention any related tickets, and so on
here. -->

This removes the `spacetimedb-update` check specifically on arm. This
test doesn't have a whole lot of value because we're already covering
Linux + Windows on x86 and then macOS on aarch64. Removing this will
allow us to decom the arm runner.

# API and ABI breaking changes

<!-- If this is an API or ABI breaking change, please apply the
corresponding GitHub label. -->

None - just a CI change

# Expected complexity level and risk

1

<!--
How complicated do you think these changes are? Grade on a scale from 1
to 5,
where 1 is a trivial change, and 5 is a deep-reaching and complex
change.

This complexity rating applies not only to the complexity apparent in
the diff,
but also to its interactions with existing and future code.

If you answered more than a 2, explain what is complex about the PR,
and what other components it interacts with in potentially concerning
ways. -->

# Testing

<!-- Describe any testing you've done, and any testing you'd like your
reviewers to do,
so that you're confident that all the changes work as expected! -->

- I have not tested this but me and Zeke sync'd on this and we think it
makes sense.
2026-06-16 19:18:12 +00:00
Shubham Mishra 77ffdbbe18 Move RelationalDB to spacetimedb-engine crate. (#5113)
# Description of Changes

Moves `RelationalDB` and related database code into a new
`spacetimedb-engine` crate.
The main motivation is to tighten dependency control around the engine
layer and isolate `RelationalDB`
 behind a crate boundary.
  - Majority of this PR is code-motion.
- Removes direct production dependence on `tokio` from
`spacetimedb-engine`.
- Keeps `tokio` only as a dev-dependency for test-only code in
`spacetimedb-engine`.
- This is intended to be a structural refactor only and should not
result in any functional change in
  production.
- Adds a CI check to ensure `spacetimedb-engine` continues to compile in
simulation mode

# API and ABI breaking changes
NA

# Expected complexity level and risk
1.5.

# Testing
Existing tests should be enough.

---------

Co-authored-by: clockwork-labs-bot <clockwork-labs-bot@users.noreply.github.com>
2026-06-16 16:16:13 +00:00