← Server functions

Server.nullValue

luastra/server
Server.nullValue(): { kind: "null" }

Creates the frozen tagged value used by generated schema-v2 clients to distinguish an explicit null from an omitted optional field.

Before you use it

Add luastra/server to this module's dependencies in luastra.json, then import it with require("luastra/server"). Declare rpc.call in luastra.json and configure a declared backend operation with a deployed trusted handler. Application code should prefer its generated operation function and decoder.

How it fits

Server.nullValue creates a frozen tagged nullable value synchronously and performs no host work.

When to use it

Use the generated Api.nullValue alias when a nullable field must be explicit null. Omit an optional field when it should be absent.

Parameters

No parameters.

Returns

{ kind: "null" } — the exact { kind: "null" } value declared by the SDK contract.

What happens next

A frozen tagged null or non-null value accepted by a generated schema-v2 encoder.

Failures and fixes

Handle transport failure, envelope decode failure, and domain validation failure separately. The static web build does not deploy trusted backend handlers, credentials, or production operations for you.

Availability

Public-source alpha API in 0.5.0-alpha; production backend deployment remains application-owned.

Focused example

local Api = require("app/generated/server-functions")
local cursor = Api.nullValue()

Continue learning

Companions

Server.Nullable

Complete inventory

View all pages in Server functions
← Previous: Server.decodeErrorNext: Server.value →