docs: consolidate outstanding docs fixes (clockworklabs#5166)

## Summary

Consolidates the outstanding docs PRs opened by `clockwork-labs-bot` /
Docs Gremlin into one reviewable PR:

- clockworklabs#4958
- clockworklabs#5085
- clockworklabs#5089
- clockworklabs#5097
- clockworklabs#5112
- clockworklabs#5114
- clockworklabs#5117
- clockworklabs#5127
- clockworklabs#5138
- clockworklabs#5165
- clockworklabs#5175
- clockworklabs#5222

This combines docs updates for:

- getting-started links
- server-issued auth token reconnect behavior in the Unity tutorial
- C++ module/client language coverage
- Unreal client ticking / `FrameTick` guidance
- C# connection callback signatures and codegen language spelling
- deterministic schedule-table sample time
- client frame ticking troubleshooting
- corrected `spacetime generate` usage for Unreal bindings
- TypeScript framework integration reference updates for SolidJS and
current React query-builder tuple usage

## Validation

- `rg -n '^(<<<<<<<|=======|>>>>>>>)' docs crates skills`
- `git diff --check origin/master...HEAD`
- `pnpm --dir docs typecheck`
- `pnpm --dir docs build`

---------

Co-authored-by: clockwork-labs-bot <clockwork-labs-bot@users.noreply.github.com>
Co-authored-by: rain <rain@rain.local>
Co-authored-by: Tyler Cloutier <cloutiertyler@users.noreply.github.com>

Author: 3 people

crates/cli/src/subcommands/dev.rs

@@ -81,7 +81,7 @@ pub fn cli() -> Command {
             Arg::new("client-lang")
                 .long("client-lang")
                 .value_parser(clap::value_parser!(Language))
-                .help("The programming language for the generated client module bindings (e.g., typescript, csharp, python). If not specified, it will be detected from the project."),
+                .help("The programming language for the generated client module bindings (e.g., typescript, csharp, rust, unrealcpp). If not specified, it will be detected from the project."),
         )
         .arg(common_args::server().help("The nickname, host name or URL of the server to publish to"))
         .arg(common_args::yes())

crates/cli/src/subcommands/generate.rs

@@ -168,7 +168,7 @@ fn get_filtered_generate_configs<'a>(
 pub fn cli() -> clap::Command {
     clap::Command::new("generate")
         .about("Generate client files for a spacetime module.")
-        .override_usage("generate [DATABASE] --lang <LANG> --out-dir <DIR> [--module-path <DIR> | --bin-path <PATH> | --unreal-module-name <MODULE_NAME> | --uproject-dir <DIR> | --include-private]")
+        .override_usage("generate [DATABASE] --lang <LANG> [--module-path <DIR> | --bin-path <PATH> | --js-path <PATH>] [--out-dir <DIR> | --uproject-dir <DIR>] [--unreal-module-name <MODULE_NAME>] [OPTIONS]")
         .arg(
             Arg::new("database")
                 .help("Database name or glob pattern to filter which databases to generate for"),

crates/update/src/cli/self_install.rs

@@ -96,7 +96,7 @@ following line to your shell configuration and open a new shell session:
         eprintln!(
             "\
 The install process is complete; check out our quickstart guide to get started!
-	<https://spacetimedb.com/docs/getting-started>"
+	<https://spacetimedb.com/docs/>"
         );
 
         Ok(ExitCode::SUCCESS)

docs/docs/00100-intro/00100-getting-started/00250-zen-of-spacetimedb.md

@@ -80,7 +80,7 @@ Perfect consistency, always.
 
 ## Everything is Programmable
 
-SpacetimeDB doesn't limit you to declarative rules or configuration files. Your module is real code (Rust, C#, or TypeScript) running inside the database. You have the full power of a procedural, normal programming language at your disposal.
+SpacetimeDB doesn't limit you to declarative rules or configuration files. Your module is real code (Rust, C#, TypeScript, or C++) running inside the database. You have the full power of a procedural, normal programming language at your disposal.
 
 Need custom authorization logic? Write a function. Need to validate complex business rules? Write a function. Need to transform data before storing it? Write a function.
 

docs/docs/00100-intro/00100-getting-started/00300-language-support.md

@@ -6,11 +6,12 @@ slug: /intro/language-support
 
 ## Server Database Modules
 
-SpacetimeDB modules define your database schema and server-side business logic. Modules can be written in three languages:
+SpacetimeDB modules define your database schema and server-side business logic. Modules can be written in four languages:
 
 - **[Rust](../../00200-core-concepts/00100-databases.md)** - High performance, compiled to WebAssembly [(Quickstart)](../00200-quickstarts/00500-rust.md)
 - **[C#](../../00200-core-concepts/00100-databases.md)** - Great for Unity developers, compiled to WebAssembly [(Quickstart)](../00200-quickstarts/00600-c-sharp.md)
 - **[TypeScript](../../00200-core-concepts/00100-databases.md)** - Ideal for web developers, runs on V8 [(Quickstart)](../00200-quickstarts/00400-typescript.md)
+- **[C++](../../00200-core-concepts/00100-databases.md)** - Fits Unreal and C++ workflows, compiled to WebAssembly [(Quickstart)](../00200-quickstarts/00700-cpp.md)
 
 ## Client SDKs
 

docs/docs/00100-intro/00100-getting-started/00500-faq.md

@@ -60,7 +60,7 @@ SpacetimeDB replaces the entire server. Your game state lives in tables, your ga
 
 Firebase and Supabase are Backend-as-a-Service platforms. They give you a database with an API layer on top, but your application logic still runs elsewhere (cloud functions, edge functions, or your own server). Complex business logic is awkward to express as database triggers or serverless functions.
 
-SpacetimeDB lets you write your entire application as a module in a real programming language (Rust, C#, TypeScript) that runs inside the database. You get full transactional guarantees, direct table access, and real-time subscriptions without the cold starts, execution limits, or awkward abstractions of serverless functions.
+SpacetimeDB lets you write your entire application as a module in a real programming language (Rust, C#, TypeScript, or C++) that runs inside the database. You get full transactional guarantees, direct table access, and real-time subscriptions without the cold starts, execution limits, or awkward abstractions of serverless functions.
 
 ### How is SpacetimeDB different from a regular database (PostgreSQL, MySQL)?
 
@@ -149,7 +149,7 @@ SpacetimeDB 2.0 also includes a **type-safe query builder** for client-side subs
 
 1. Install the CLI: `curl -sSf https://install.spacetimedb.com | sh`
 2. Start a local instance: `spacetime start`
-3. Create a project: `spacetime init --lang rust` (or `csharp`, `typescript`)
+3. Create a project: `spacetime init --lang rust` (or `csharp`, `typescript`, `cpp`)
 4. Write your module, publish it: `spacetime publish my-app`
 5. Generate client bindings: `spacetime generate --lang typescript --out-dir src/module_bindings`
 6. Connect from your client using the generated code

docs/docs/00100-intro/00300-tutorials/00300-unity-tutorial/00300-part-2.md

@@ -743,7 +743,21 @@ public class GameManager : MonoBehaviour
     void HandleConnect(DbConnection _conn, Identity identity, string token)
     {
         Debug.Log("Connected.");
+        // Only the WebGL player has the browser WebSocket header limitation.
+        // The Unity Editor uses the normal desktop transport even when the
+        // selected build target is WebGL, so keep the normal behavior there.
+#if UNITY_WEBGL && !UNITY_EDITOR
+        if (AuthToken.Token == "")
+        {
+            // No token was supplied to the connection, so this is the
+            // long-lived server-issued token for the new identity. Save it.
+            // If a token already exists, this connect may have used a
+            // short-lived WebSocket token, which should not overwrite it.
+            AuthToken.SaveToken(token);
+        }
+#else
         AuthToken.SaveToken(token);
+#endif
         LocalIdentity = identity;
 
         OnConnected?.Invoke();
@@ -787,6 +801,8 @@ public class GameManager : MonoBehaviour
 }
 ```
 
+> Unity WebGL needs one extra precaution here. Browser WebSocket APIs cannot set an `Authorization` header, so reconnecting with a saved server-issued token may yield a short-lived WebSocket token in `HandleConnect`. The `#if UNITY_WEBGL` guard keeps the original saved token instead of overwriting it during reconnect.
+
 Here we configure the connection to the database, by passing it some callbacks in addition to providing the `SERVER_URI` and `MODULE_NAME` to the connection. When the client connects, the SpacetimeDB SDK will call the `HandleConnect` method, allowing us to start up the game.
 
 In our `HandleConnect` callback we build a subscription and call `Subscribe`, subscribing to all data in the database. This causes SpacetimeDB to synchronize the state of all your tables with your Unity client's SDK client cache.

docs/docs/00100-intro/00300-tutorials/00300-unity-tutorial/00400-part-3.md

@@ -1351,7 +1351,21 @@ Next lets add some callbacks when rows change in the database. Modify the `Handl
 void HandleConnect(DbConnection conn, Identity identity, string token)
 {
     Debug.Log("Connected.");
+    // Only the WebGL player has the browser WebSocket header limitation.
+    // The Unity Editor uses the normal desktop transport even when the
+    // selected build target is WebGL, so keep the normal behavior there.
+#if UNITY_WEBGL && !UNITY_EDITOR
+    if (AuthToken.Token == "")
+    {
+        // No token was supplied to the connection, so this is the
+        // long-lived server-issued token for the new identity. Save it.
+        // If a token already exists, this connect may have used a
+        // short-lived WebSocket token, which should not overwrite it.
+        AuthToken.SaveToken(token);
+    }
+#else
     AuthToken.SaveToken(token);
+#endif
     LocalIdentity = identity;
 
     conn.Db.Circle.OnInsert += CircleOnInsert;
@@ -1370,6 +1384,8 @@ void HandleConnect(DbConnection conn, Identity identity, string token)
 }
 ```
 
+Keep the same WebGL guard from Part 2 here as well. On Unity WebGL, a reconnect can surface a short-lived WebSocket token in `HandleConnect`, so you should not overwrite an already-saved long-lived server-issued token.
+
 Next add the following implementations for those callbacks to the `GameManager` class.
 
 ```csharp

docs/docs/00200-core-concepts/00100-databases/00500-cheat-sheet.md

@@ -8,7 +8,7 @@ import { CppModuleVersionNotice } from "@site/src/components/CppModuleVersionNot
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-Quick reference for SpacetimeDB module syntax across Rust, C#, and TypeScript.
+Quick reference for SpacetimeDB module syntax across Rust, C#, TypeScript, and C++.
 
 ## Project Setup
 
@@ -600,23 +600,23 @@ SPACETIMEDB_PROCEDURE(std::string, fetch_data, ProcedureContext ctx, std::string
 
 ```typescript
 // Return single row
-export const my_player = spacetimedb.view({ name: 'my_player' }, {}, t.option(player.rowType), ctx => {
+export const my_player = spacetimedb.view({ name: 'my_player', public: true }, t.option(player.rowType), ctx => {
   return ctx.db.player.identity.find(ctx.sender);
 });
 
 // Return potentially multiple rows
-export const top_players = spacetimedb.view({ name: 'top_players' }, {}, t.array(player.rowType), ctx => {
+export const top_players = spacetimedb.view({ name: 'top_players', public: true }, t.array(player.rowType), ctx => {
   return ctx.db.player.score.filter(1000);
 });
 
 // Perform a generic filter using the query builder.
 // Equivalent to `SELECT * FROM player WHERE score < 1000`.
-export const bottom_players = spacetimedb.view({ name: 'bottom_players' }, {}, t.array(player.rowType), ctx => {
+export const bottom_players = spacetimedb.view({ name: 'bottom_players', public: true }, t.array(player.rowType), ctx => {
   return ctx.from.player.where(p => p.score.lt(1000))
 });
 
 // Count rows in a table.
-export const player_count = spacetimedb.anonymousView({ name: 'player_count' }, {}, t.array(t.row('PlayerCount', {
+export const player_count = spacetimedb.anonymousView({ name: 'player_count', public: true }, t.array(t.row('PlayerCount', {
   count: t.u64(),
 })), ctx => {
   return [{ count: ctx.db.player.count() }];

docs/docs/00200-core-concepts/00300-tables.md

@@ -403,7 +403,7 @@ import { table, t } from 'spacetimedb/server';
 
 // Define the shared column schema
 const playerColumns = {
-  identity: t.Identity.primaryKey(),
+  identity: t.identity().primaryKey(),
   playerId: t.i32().unique().autoInc(),
   name: t.string(),
 };