Docs - insert -> try_insert

[bfops]

Description of Changes

Fix a small docs thing that a user noticed in #3970.

API and ABI breaking changes

None

Expected complexity level and risk

1

Testing

• I copy-pasted the new client_connected reducer into a test project and ran spacetime build

[bfops]

/update-llm-benchmarks

[jdetter]

Works for me! Tested with this example:

use spacetimedb::{table, reducer, Table, ReducerContext, Identity, Timestamp, ConnectionId};

#[table(name = sessions)]
pub struct Session {
    #[unique]
    pub connection_id: ConnectionId,
    pub identity: Identity,
    pub connected_at: Timestamp,
}

#[reducer(client_connected)]
pub fn on_connect(ctx: &ReducerContext) -> Result<(), String> {
    log::info!("Client connected: {}", ctx.sender);

    // ctx.connection_id is guaranteed to be Some(...)
    let conn_id = ctx.connection_id.unwrap();

    // Initialize client session
    ctx.db.sessions().try_insert(Session {
        connection_id: conn_id,
        identity: ctx.sender,
        connected_at: ctx.timestamp,
    })?;

    Ok(())
}


#[reducer(client_disconnected)]
pub fn on_disconnect(ctx: &ReducerContext) -> Result<(), String> {
    log::info!("Client disconnected: {}", ctx.sender);

    // ctx.connection_id is guaranteed to be Some(...)
    let conn_id = ctx.connection_id.unwrap();

    // Clean up client session
    ctx.db.sessions().connection_id().delete(&conn_id);

    Ok(())
}

[clockwork-labs-bot]

LLM Benchmark Results (ci-quickfix)

Language	Mode	Category	Tests Passed	Pass %	Task Pass %
Rust	rustdoc_json	basics	20/27	74.1%	75.0%
Rust	rustdoc_json	schema	18/30	60.0%	50.0%
Rust	rustdoc_json	total	38/57	66.7%	63.6%
C#	docs	basics	27/27	100.0%	100.0%
C#	docs	schema	28/34	82.4%	80.0%
C#	docs	total	55/61	90.2%	90.9%

_{Generated at: 2026-01-13T21:47:49.643Z}

[bfops]

/update-llm-benchmark