Struct FunctionDefinition 

pub struct FunctionDefinition {
    pub name: String,
    pub trigger: String,
    pub runtime: RuntimeType,
    pub timeout_ms: Option<u64>,
    pub run_as: Option<RunAs>,
    pub when: Vec<TriggerPredicate>,
    pub re_runnable: bool,
    pub retry: Option<RetryConfig>,
}

Definition of a serverless function for deployment and execution.

Fields

name: String

Unique name for this function.

trigger: String

Trigger type and configuration (e.g., “after:mutation:createUser”, “cron:0 * * * *”, “http:GET:/users/:id”).

runtime: RuntimeType

Which runtime executes this function.

timeout_ms: Option<u64>

Optional timeout in milliseconds (overrides defaults).

• For before:mutation triggers: defaults to 500ms
• For other triggers: defaults to 5s

run_as: Option<RunAs>

The authority ceiling this function’s fraiseql_query bridge writes run under (#594). Absent ⇒ fail-closed: the bridge runs under an anonymous identity and RLS/field-authz deny writes. See RunAs and identity() (feature host-live).

when: Vec<TriggerPredicate>

Declarative when predicates (#597) — a conjunction the dispatcher evaluates on the row images before firing an after:mutation/after:capture function. Empty ⇒ always fire (back-compat). See TriggerPredicate.

re_runnable: bool

Fire-and-forget opt-out for durable dispatch.

After-mutation function dispatch is durable by default: a transient failure is retried with backoff and, once retries are exhausted, the invocation is dead-lettered so money- and send-path work is never silently lost. Set re_runnable = true for work that is safe to simply re-run later (e.g. LLM scoring) — such dispatch stays fire-and-forget with no retry or dead-letter overhead. See ADR 0015 for the rationale.

retry: Option<RetryConfig>

Per-function retry policy for durable dispatch.

None uses the server default (overridable via FRAISEQL_FUNCTIONS_RETRY_* environment variables). Ignored when re_runnable is true. Reuses the observer subsystem’s RetryConfig so retry semantics are identical across both subsystems.

Implementations

impl FunctionDefinition

pub fn new(name: &str, trigger: &str, runtime: RuntimeType) -> Self

Create a new function definition.

pub fn with_run_as(self, run_as: RunAs) -> Self

Set the run_as authority ceiling (#594).

pub fn identity(&self, request_id: impl Into<String>) -> SecurityContext

The background SecurityContext this function’s fraiseql_query bridge writes run under (#594).

Built from run_as via SecurityContext::system_job, so a function write is audited as system_job:<function-name> under ActorType::SystemJob — the same envelope a source write carries. Absent run_as yields a fail-closed identity (no roles, no scopes, no tenant → every authz/RLS decision denies). request_id correlates one dispatch (typically its per-dispatch idempotency token).

pub const fn re_runnable(self) -> Self

Mark this function as re-runnable (fire-and-forget) dispatch.

See re_runnable and ADR 0015.

pub const fn with_timeout(self, timeout_ms: u64) -> Self

Set a custom timeout for this function.

pub fn effective_timeout(&self) -> Duration

Get the effective timeout for this function.

pub fn resolve_module_path(&self, module_dir: &Path) -> Option<PathBuf>

The module file this definition resolves to under module_dir, if one is there — RuntimeType::resolve_module_path for the declared runtime and name, the one rule for where code lives (#1325, #1399).

Returns None when no module is present, which the caller reports in its own terms: a compile error, a boot failure, or a harness error.

pub fn module_path_pattern(&self, module_dir: &Path) -> String

The module-file candidates this definition names, rendered for a diagnostic: <module_dir>/<name>.{ext,ext}.

pub fn is_before_mutation(&self) -> bool

Check if this function is a before:mutation trigger.

pub fn is_after_mutation(&self) -> bool

Check if this function is an after:mutation trigger.

pub fn is_after_storage(&self) -> bool

Check if this function is an after:storage trigger.

pub fn is_after_ingest(&self) -> bool

Check if this function is an after:ingest trigger.

pub fn is_cron(&self) -> bool

Check if this function is a cron trigger.

pub fn is_http(&self) -> bool

Check if this function is an HTTP trigger.

Trait Implementations

impl Clone for FunctionDefinition

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FunctionDefinition

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FunctionDefinition

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for FunctionDefinition

impl PartialEq for FunctionDefinition

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for FunctionDefinition

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for FunctionDefinition