Struct ServerFnTestContext 

pub struct ServerFnTestContext { /* private fields */ }

Enhanced test context builder for server function testing.

This builder extends the basic ServerFnTestContext with:

• Authentication/authorization mocking
• HTTP request/response simulation
• Transaction management
• CSRF token handling

Example

let ctx = ServerFnTestContext::new(singleton_scope)
    .with_authenticated_user(TestUser::authenticated("alice"))
    .with_permissions(vec!["read", "write"])
    .with_csrf_token("test-token")
    .build();

Implementations

impl ServerFnTestContext

pub fn new(singleton_scope: Arc<SingletonScope>) -> Self

Create a new server function test context builder.

Arguments

• singleton_scope - The singleton scope for dependency resolution.

pub fn with_database<P: Clone + Send + Sync + 'static>(self, pool: P) -> Self

Add a database connection override to the test context.

Arguments

• pool - The database connection pool (typically from TestContainers)

pub fn with_singleton<T: Clone + Send + Sync + 'static>(self, value: T) -> Self

Add a custom singleton dependency to the test context.

Arguments

• value - The singleton value to register

pub fn with_authenticated_user(self, user: TestUser) -> Self

👎Deprecated since 0.1.0-rc.16:

use .auth().session(&user).done() instead

Set the authenticated user for this test.

This configures the test context to simulate an authenticated user, allowing you to test protected endpoints.

Arguments

• user - The test user to authenticate as

Example

let ctx = ServerFnTestContext::new(singleton)
    .with_authenticated_user(TestUser::admin())
    .build();

pub fn with_permissions<S: Into<String>>(self, permissions: Vec<S>) -> Self

Set permissions for the authenticated user.

This is a convenience method that modifies the test user’s permissions.

Arguments

• permissions - List of permission strings to grant

pub fn with_roles<S: Into<String>>(self, roles: Vec<S>) -> Self

Set roles for the authenticated user.

Arguments

• roles - List of role strings to assign

pub fn with_request(self, request: MockHttpRequest) -> Self

Set a mock HTTP request for the context.

This is useful for testing server functions that access request data like headers, cookies, or body.

Arguments

• request - The mock HTTP request

pub fn with_request_headers(self, headers: HeaderMap) -> Self

Add request headers to the context.

Arguments

• headers - Headers to add

pub fn with_header(self, name: &str, value: &str) -> Self

Add a single request header.

Arguments

• name - Header name
• value - Header value

pub fn with_csrf_token(self, token: &str) -> Self

Set a CSRF token for the request.

This automatically adds the token to both headers and session.

Arguments

• token - The CSRF token string

pub fn with_transaction_mode(self, mode: TransactionMode) -> Self

Set the transaction mode for database operations.

Arguments

• mode - The transaction mode

pub fn with_transaction_rollback(self) -> Self

Enable automatic transaction rollback after the test.

This is a convenience method for with_transaction_mode(TransactionMode::Rollback).

pub fn with_session(self, session: MockSession) -> Self

Set a mock session directly.

Arguments

• session - The mock session

pub fn auth(self) -> ServerFnAuthBuilder

Start building auth configuration for this server_fn test context.

Mirrors crate::client::APIClient::auth() API for consistent developer experience.

Examples

let env = ServerFnTestContext::new(scope.clone())
    .with_database(pool.clone())
    .auth()
        .session(&user)
        .with_staff(true)
    .done()
    .build();

pub fn with_mock_session(self) -> Self

Add a mock session with default configuration.

pub fn build(self) -> ServerFnTestEnv

Build the test environment with all configured options.

Returns a ServerFnTestEnv containing the injection context and any additional test state.

pub fn build_context(self) -> InjectionContext

Build and return just the injection context.

This is a convenience method when you don’t need the full test environment.